---
id: python-simple-logger
version: "2.0.19"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# python-simple-logger — A simple logger for python

License: permissive · Maintenance: active · Downloads: 77.9K/mo

## What it is and what it does

python-simple-logger wraps Python's standard logging to provide a simpler interface for console and file logging with convenience features like duplicate filtering, sensitive data masking, and colored output. It exposes a get_logger() factory function that returns a logger configured for your use case, with optional parameters to control output level, filename, and behavior like automatic masking of passwords, tokens, and API keys.

The package depends on colorlog for terminal coloring and requires Python >=3.9. It is actively maintained with a recent release, but has minimal community engagement, suggesting it may be a specialized tool rather than a widely-used standard. The high install friction (source-only distribution) means installation requires compilation or a working build environment.

Use it for:

- Add colored, deduplicated logging to CLI tools or scripts without boilerplate configuration.
- Automatically redact passwords, tokens, and API keys from logs to prevent accidental credential exposure.
- Force colored output in containerized or CI/CD environments where TTY detection fails.
- Log to both console and file simultaneously with a single logger instance.
- Quickly prototype logging in small Python projects without learning the logging module deeply.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a simple logger for console and file output with built-in support for filtering duplicate logs, masking sensitive data, and colored output.

Yes, with conditions. The package solves real problems (duplicate filtering, credential masking, colored output) and is actively maintained with no known vulnerabilities. However, high install friction and minimal adoption suggest it is best suited for small projects or teams already familiar with it. For production systems or teams standardizing on logging, consider whether the convenience features justify the dependency.

## Install

pip install python-simple-logger
uv add python-simple-logger
poetry add python-simple-logger

## Installing python-simple-logger

Before you install: High install friction due to a single source distribution format. Maintenance is active with a recent release dated 2026-02-26, though the package has minimal adoption and zero repository stars, suggesting limited community validation.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install python-simple-logger

from simple_logger.logger import get_logger
import logging

logger = get_logger(name=__name__, level=logging.DEBUG, filename="my-log.log")
logger.info("This is INFO log")

Requires Python >=3.9; depends on colorlog for colored output support.

Verify before relying:

- Whether the 'success' log level is a standard logging extension or custom implementation.
- Performance characteristics when masking sensitive data in high-volume logging scenarios.
- Compatibility with structured logging frameworks or JSON output formats.
- Actual adoption and real-world usage patterns beyond download statistics.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: active
- Downloads: 77.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python logging library, console file logger, duplicate log filter, sensitive data masking, colored log output, simple python logger, log filtering, logging, cli-tools, credential-masking

[View on SkillFed](https://skillfed.io/packages/python-simple-logger) · [View on PyPI](https://pypi.org/project/python-simple-logger/)