miu-logger 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

miu_logger-0.1.2.dist-info/METADATA

@@ -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.dist-info → miu_logger-0.1.2.dist-info}/RECORD

@@ -6,8 +6,9 @@ miu_logger/formatters.py,sha256=JshOwo4B0mT241ElCAs6nN-_IF_SgcZwmDt7k7tibuo,675
 miu_logger/listener.py,sha256=ZBw8i-f-pouPdnuw-DXEKS4ZvWIHoUtiAPMzsIomj4g,3301
 miu_logger/logger_factory.py,sha256=MhNaP73J9RbhmmVR6simqkZRCel2g6rPImRlijYAQXI,319
 miu_logger/repository.py,sha256=XQPkJjuYzUKNiNUmPSxRd2CygdKThB_PHIyq0WTFkic,2288
-miu_logger-0.1.0.dist-info/licenses/LICENSE,sha256=jLLem0QFpsFv7Lkgp7I7FeN4DIdgCKIxzklfdkkesWg,1075
-miu_logger-0.1.0.dist-info/METADATA,sha256=QlWdb9LomoTwTDmsy3EG4OUrpMyNFeV11nVD0ArB9yE,265
-miu_logger-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-miu_logger-0.1.0.dist-info/top_level.txt,sha256=70Nuj1YRYLMkqiRZv1pPZPhi_VystPGqm1nC3s-uHz4,11
-miu_logger-0.1.0.dist-info/RECORD,,
+miu_logger/stubgen.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+miu_logger-0.1.2.dist-info/licenses/LICENSE,sha256=jLLem0QFpsFv7Lkgp7I7FeN4DIdgCKIxzklfdkkesWg,1075
+miu_logger-0.1.2.dist-info/METADATA,sha256=vhE6IfN689deA2fA2tH71SUoGpZcndqYAcy-dk6kk5k,2915
+miu_logger-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+miu_logger-0.1.2.dist-info/top_level.txt,sha256=70Nuj1YRYLMkqiRZv1pPZPhi_VystPGqm1nC3s-uHz4,11
+miu_logger-0.1.2.dist-info/RECORD,,

miu_logger-0.1.0.dist-info/METADATA

@@ -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