miu-logger 0.1.0__tar.gz → 0.1.2__tar.gz

miu_logger-0.1.2/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: miu-logger
+Version: 0.1.2
+Summary: Multiprocessing-safe domain-based logging framework with QueueListener architecture
+Author-email: Bruno Miura <brumiura@gmail.com>
+License-Expression: MIT
+Keywords: logging,multiprocessing,queue,structured-logging,python-logging
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama
+Dynamic: license-file
+
+```python
+repo = LoggingRepository(config)
+queue = repo.get_queue()
+```
+
+**Worker processes:**
+
+```python
+worker_repo = LoggingRepository(config, use_listener=False, queue=queue)
+worker_repo.task.info("Worker started")
+```
+
+All processes log safely to the same listener and files.
+
+---
+
+## Debug Control
+
+Only `.debug()` messages are conditional via `debug_enabled`:
+
+```python
+config.debug_enabled = False
+repo.app.debug("Won't appear")
+repo.app.info("Will appear")
+```
+
+Useful for toggling debug messages in production.
+
+---
+
+## Output Structure
+
+Logs are written in:
+
+```
+logs/
+ ├─ app.log         # domain logs
+ ├─ db.log
+ ├─ redis.log
+ ├─ debug.log       # per-level logs
+ ├─ info.log
+ ├─ warning.log
+ └─ error.log
+```
+
+Console output is **colorized** by level:
+
+* DEBUG → blue
+* INFO → green
+* WARNING → yellow
+* ERROR → red
+
+Files remain clean.
+
+---
+
+## Graceful Shutdown
+
+The repository automatically shuts down on process exit and supports manual shutdown:
+
+```python
+repo.shutdown()
+```
+
+---
+
+## Typical Usage Example
+
+```python
+repo.app.info("Service starting")
+
+try:
+    connect_db()
+except Exception:
+    repo.db.exception("DB connection failed")
+
+repo.redis.debug("Cache size: %d", cache_size)
+```
+
+**Multiprocessing workers:**
+
+```python
+def worker(queue):
+    repo = LoggingRepository(config, use_listener=False, queue=queue)
+    repo.task.info("Worker task started")
+```
+
+---
+
+## Project Structure
+
+```
+miu_logger/
+ ├─ repository.py         # main LoggingRepository
+ ├─ listener.py           # QueueListener and handler setup
+ ├─ logger_factory.py     # logger creation functions
+ ├─ conditional.py        # ConditionalLogger
+ ├─ filters.py            # Logger filters
+ ├─ formatters.py         # ColoredFormatter
+ ├─ config.py             # LogConfig definition
+ └─ stubgen.py            # stub generator for IDE autocomplete
+```
+
+---
+
+## When to Use
+
+* Services with many subsystems
+* Multiprocessing ingestion pipelines
+* Long-running daemons
+* Kubernetes / systemd services
+* Need for clear operational logs
+
+---
+
+## When Not to Use
+
+* Single-file scripts
+* No multiprocessing
+* No domain separation required
+
+Plain `logging` is sufficient in those cases.
+
+---
+
+## License
+
+MIT
+
+---
+
+## Author
+
+**Bruno Miura**

miu_logger-0.1.2/README.md

@@ -0,0 +1,134 @@
+```python
+repo = LoggingRepository(config)
+queue = repo.get_queue()
+```
+
+**Worker processes:**
+
+```python
+worker_repo = LoggingRepository(config, use_listener=False, queue=queue)
+worker_repo.task.info("Worker started")
+```
+
+All processes log safely to the same listener and files.
+
+---
+
+## Debug Control
+
+Only `.debug()` messages are conditional via `debug_enabled`:
+
+```python
+config.debug_enabled = False
+repo.app.debug("Won't appear")
+repo.app.info("Will appear")
+```
+
+Useful for toggling debug messages in production.
+
+---
+
+## Output Structure
+
+Logs are written in:
+
+```
+logs/
+ ├─ app.log         # domain logs
+ ├─ db.log
+ ├─ redis.log
+ ├─ debug.log       # per-level logs
+ ├─ info.log
+ ├─ warning.log
+ └─ error.log
+```
+
+Console output is **colorized** by level:
+
+* DEBUG → blue
+* INFO → green
+* WARNING → yellow
+* ERROR → red
+
+Files remain clean.
+
+---
+
+## Graceful Shutdown
+
+The repository automatically shuts down on process exit and supports manual shutdown:
+
+```python
+repo.shutdown()
+```
+
+---
+
+## Typical Usage Example
+
+```python
+repo.app.info("Service starting")
+
+try:
+    connect_db()
+except Exception:
+    repo.db.exception("DB connection failed")
+
+repo.redis.debug("Cache size: %d", cache_size)
+```
+
+**Multiprocessing workers:**
+
+```python
+def worker(queue):
+    repo = LoggingRepository(config, use_listener=False, queue=queue)
+    repo.task.info("Worker task started")
+```
+
+---
+
+## Project Structure
+
+```
+miu_logger/
+ ├─ repository.py         # main LoggingRepository
+ ├─ listener.py           # QueueListener and handler setup
+ ├─ logger_factory.py     # logger creation functions
+ ├─ conditional.py        # ConditionalLogger
+ ├─ filters.py            # Logger filters
+ ├─ formatters.py         # ColoredFormatter
+ ├─ config.py             # LogConfig definition
+ └─ stubgen.py            # stub generator for IDE autocomplete
+```
+
+---
+
+## When to Use
+
+* Services with many subsystems
+* Multiprocessing ingestion pipelines
+* Long-running daemons
+* Kubernetes / systemd services
+* Need for clear operational logs
+
+---
+
+## When Not to Use
+
+* Single-file scripts
+* No multiprocessing
+* No domain separation required
+
+Plain `logging` is sufficient in those cases.
+
+---
+
+## License
+
+MIT
+
+---
+
+## Author
+
+**Bruno Miura**

miu_logger-0.1.2/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "miu-logger"
+version = "0.1.2"
+description = "Multiprocessing-safe domain-based logging framework with QueueListener architecture"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Bruno Miura", email = "brumiura@gmail.com" }
+]
+keywords = ["logging", "multiprocessing", "queue", "structured-logging", "python-logging"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Operating System :: OS Independent",
+    "Topic :: System :: Logging",
+]
+
+dependencies = [
+    "colorama"
+]
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

miu_logger-0.1.2/src/miu_logger.egg-info/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: miu-logger
+Version: 0.1.2
+Summary: Multiprocessing-safe domain-based logging framework with QueueListener architecture
+Author-email: Bruno Miura <brumiura@gmail.com>
+License-Expression: MIT
+Keywords: logging,multiprocessing,queue,structured-logging,python-logging
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama
+Dynamic: license-file
+
+```python
+repo = LoggingRepository(config)
+queue = repo.get_queue()
+```
+
+**Worker processes:**
+
+```python
+worker_repo = LoggingRepository(config, use_listener=False, queue=queue)
+worker_repo.task.info("Worker started")
+```
+
+All processes log safely to the same listener and files.
+
+---
+
+## Debug Control
+
+Only `.debug()` messages are conditional via `debug_enabled`:
+
+```python
+config.debug_enabled = False
+repo.app.debug("Won't appear")
+repo.app.info("Will appear")
+```
+
+Useful for toggling debug messages in production.
+
+---
+
+## Output Structure
+
+Logs are written in:
+
+```
+logs/
+ ├─ app.log         # domain logs
+ ├─ db.log
+ ├─ redis.log
+ ├─ debug.log       # per-level logs
+ ├─ info.log
+ ├─ warning.log
+ └─ error.log
+```
+
+Console output is **colorized** by level:
+
+* DEBUG → blue
+* INFO → green
+* WARNING → yellow
+* ERROR → red
+
+Files remain clean.
+
+---
+
+## Graceful Shutdown
+
+The repository automatically shuts down on process exit and supports manual shutdown:
+
+```python
+repo.shutdown()
+```
+
+---
+
+## Typical Usage Example
+
+```python
+repo.app.info("Service starting")
+
+try:
+    connect_db()
+except Exception:
+    repo.db.exception("DB connection failed")
+
+repo.redis.debug("Cache size: %d", cache_size)
+```
+
+**Multiprocessing workers:**
+
+```python
+def worker(queue):
+    repo = LoggingRepository(config, use_listener=False, queue=queue)
+    repo.task.info("Worker task started")
+```
+
+---
+
+## Project Structure
+
+```
+miu_logger/
+ ├─ repository.py         # main LoggingRepository
+ ├─ listener.py           # QueueListener and handler setup
+ ├─ logger_factory.py     # logger creation functions
+ ├─ conditional.py        # ConditionalLogger
+ ├─ filters.py            # Logger filters
+ ├─ formatters.py         # ColoredFormatter
+ ├─ config.py             # LogConfig definition
+ └─ stubgen.py            # stub generator for IDE autocomplete
+```
+
+---
+
+## When to Use
+
+* Services with many subsystems
+* Multiprocessing ingestion pipelines
+* Long-running daemons
+* Kubernetes / systemd services
+* Need for clear operational logs
+
+---
+
+## When Not to Use
+
+* Single-file scripts
+* No multiprocessing
+* No domain separation required
+
+Plain `logging` is sufficient in those cases.
+
+---
+
+## License
+
+MIT
+
+---
+
+## Author
+
+**Bruno Miura**

{miu_logger-0.1.0 → miu_logger-0.1.2}/src/miu_logger.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ src/miu_logger/formatters.py
 src/miu_logger/listener.py
 src/miu_logger/logger_factory.py
 src/miu_logger/repository.py
+src/miu_logger/stubgen.py
 src/miu_logger.egg-info/PKG-INFO
 src/miu_logger.egg-info/SOURCES.txt
 src/miu_logger.egg-info/dependency_links.txt

miu_logger-0.1.0/PKG-INFO

@@ -1,10 +0,0 @@
-Metadata-Version: 2.4
-Name: miu-logger
-Version: 0.1.0
-Summary: Multiprocessing-safe structured logging framework
-Author: Bruno Miura
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: colorama
-Dynamic: license-file

miu_logger-0.1.0/pyproject.toml

@@ -1,21 +0,0 @@
-[project]
-name = "miu-logger"
-version = "0.1.0"
-description = "Multiprocessing-safe structured logging framework"
-authors = [{name="Bruno Miura"}]
-requires-python = ">=3.10"
-dependencies = [
-    "colorama",
-]
-readme = "README.md"
-
-[build-system]
-requires = ["setuptools", "wheel"]  
-build-backend = "setuptools.build_meta"
-
-[tool.setuptools]
-package-dir = {"" = "src"}
-
-[tool.setuptools.packages.find]
-where = ["src"]
-

miu_logger-0.1.0/src/miu_logger.egg-info/PKG-INFO

@@ -1,10 +0,0 @@
-Metadata-Version: 2.4
-Name: miu-logger
-Version: 0.1.0
-Summary: Multiprocessing-safe structured logging framework
-Author: Bruno Miura
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: colorama
-Dynamic: license-file