prismalog 0.1.0__py3-none-any.whl

prismalog-0.1.0.dist-info/METADATA

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: prismalog
+Version: 0.1.0
+Summary: High-performance colored, multi-process logging library for Python
+Author-email: Alexey Obukhov <alexey.obukhov@hotmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/vertok/prismalog
+Project-URL: Documentation, https://prismalog.readthedocs.io/
+Project-URL: Issues, https://github.com/vertok/prismalog/issues
+Project-URL: Changelog, https://github.com/vertok/prismalog/blob/main/CHANGELOG.md
+Keywords: logging,colored,high-performance,multiprocessing
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: yaml
+Requires-Dist: PyYAML>=6.0.1; extra == "yaml"
+Provides-Extra: dev
+Requires-Dist: black>=22.6.0; extra == "dev"
+Requires-Dist: pylint>=2.14.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: build>=0.8.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
+Requires-Dist: PyYAML>=6.0.2; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=8.3.5; extra == "test"
+Requires-Dist: pytest-cov>=3.0.0; extra == "test"
+Requires-Dist: pytest-html>=3.2.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.1.0; extra == "test"
+Requires-Dist: coverage>=7.6.1; extra == "test"
+Requires-Dist: nltk>=3.9.1; extra == "test"
+Requires-Dist: PyYAML>=6.0.2; extra == "test"
+Provides-Extra: doc
+Requires-Dist: sphinx>=4.5.0; extra == "doc"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints>=1.18.0; extra == "doc"
+Requires-Dist: sphinx-design>=0.5.0; extra == "doc"
+Provides-Extra: ci
+Requires-Dist: anybadge>=1.10.0; extra == "ci"
+Provides-Extra: all
+Requires-Dist: black>=22.6.0; extra == "all"
+Requires-Dist: pylint>=2.14.0; extra == "all"
+Requires-Dist: mypy>=1.0.0; extra == "all"
+Requires-Dist: isort>=5.10.0; extra == "all"
+Requires-Dist: build>=0.8.0; extra == "all"
+Requires-Dist: twine>=4.0.0; extra == "all"
+Requires-Dist: flake8>=5.0.0; extra == "all"
+Requires-Dist: pre-commit>=3.5.0; extra == "all"
+Requires-Dist: PyYAML>=6.0.2; extra == "all"
+Requires-Dist: pytest>=8.3.5; extra == "all"
+Requires-Dist: pytest-cov>=3.0.0; extra == "all"
+Requires-Dist: pytest-html>=3.2.0; extra == "all"
+Requires-Dist: pytest-timeout>=2.1.0; extra == "all"
+Requires-Dist: coverage>=7.6.1; extra == "all"
+Requires-Dist: nltk>=3.9.1; extra == "all"
+Requires-Dist: sphinx>=4.5.0; extra == "all"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "all"
+Requires-Dist: sphinx-autodoc-typehints>=1.18.0; extra == "all"
+Requires-Dist: sphinx-design>=0.5.0; extra == "all"
+Requires-Dist: anybadge>=1.10.0; extra == "all"
+Dynamic: license-file
+
+# prismalog
+
+A robust, multi-process safe logging system for Python applications that integrates perfectly with the psy-supabase package.
+
+[![PyPI version](https://img.shields.io/pypi/v/prismalog.svg)](https://pypi.org/project/prismalog/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/prismalog.svg)](https://pypi.org/project/prismalog/)
+[![Coverage Python 3.8](https://vertok.github.io/prismalog/badges/coverage-py3.8.svg)](https://vertok.github.io/prismalog/htmlcov/index.html)
+[![Pylint Python 3.8](https://vertok.github.io/prismalog/badges/pylint-py3.8.svg)](https://vertok.github.io/prismalog/reports/html/3.8/reports/pylint/pylint-py3.8.html)
+[![Coverage Python 3.10](https://vertok.github.io/prismalog/badges/coverage-py3.10.svg)](https://vertok.github.io/prismalog/htmlcov/index.html)
+[![Pylint Python 3.10](https://vertok.github.io/prismalog/badges/pylint-py3.10.svg)](https://vertok.github.io/prismalog/reports/html/3.10/reports/pylint/pylint-py3.10.html)
+[![Coverage Python 3.11](https://vertok.github.io/prismalog/badges/coverage-py3.11.svg)](https://vertok.github.io/prismalog/htmlcov/index.html)
+[![Pylint Python 3.11](https://vertok.github.io/prismalog/badges/pylint-py3.11.svg)](https://vertok.github.io/prismalog/reports/html/3.11/reports/pylint/pylint-py3.11.html)
+
+## Features
+
+- ⚛️ Zero-dependency core
+- 🚀 High performance
+- 🎨 Colored console output
+- 📁 Automatic log file rotation
+- 🔄 Multi-process safe logging
+- 🧵 Multithreading-safe logging
+- ⚙️ YAML-based configuration
+- 🔇 Control for verbose third-party libraries
+- 🧪 Testing support
+
+## Performance Characteristics
+
+prismalog was designed for high-performance applications. My testing shows:
+
+- **Overhead per log call**: ~0.15ms (typical)
+- **Memory impact**: Minimal (~0.3MB for 10,000 messages)
+- **Throughput**: Capable of handling 20,000+ messages per second
+- **Multi-process/Multi-threading safety**: No measurable performance penalty compared to single-process
+
+## Performance Notes
+
+While prismalog achieves excellent performance characteristics, it's important to note that the primary bottleneck is filesystem I/O when writing to log files. This limitation is inherent to disk-based logging systems:
+
+- File locking mechanisms required for multi-process safety introduce some overhead
+- Synchronous writes to ensure log integrity can impact throughput during high-volume logging events
+- Storage device speed directly impacts maximum sustainable throughput
+
+For applications with extreme logging requirements, consider:
+- Using an asynchronous logging configuration
+- Implementing log batching for high-volume events
+- Configuring separate log files for different components to distribute I/O load
+
+The current performance metrics were achieved with standard SSD hardware. With specialized I/O optimization or enterprise-grade storage systems, significantly higher throughput is achievable.
+
+## Quick Start
+
+```python
+from prismalog import get_logger, LoggingConfig
+
+# Initialize with configuration file
+LoggingConfig.initialize(config_file="config.yaml")
+
+# Get a logger
+logger = get_logger("my_module")
+logger.info("Application started")
+```
+
+## Command-Line Integration
+
+Any application using prismalog automatically supports these command-line arguments:
+
+```bash
+--log-config PATH          # Path to logging configuration file
+--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
+                           # Set the default logging level
+--log-dir PATH             # Directory where log files will be stored
+```
+
+## Usage
+
+```python
+from prismalog.log import get_logger, LoggingConfig
+
+# Initialize logging (with command-line support)
+LoggingConfig.initialize(use_cli_args=True)
+
+# Get logger and use it
+logger = get_logger("my_app")
+logger.info("Application started")
+```
+
+## Dependencies
+
+prismalog is designed to work with **zero external dependencies** for core functionality. It relies solely on the Python standard library, making it lightweight and easy to integrate into any project.
+
+### Optional Dependencies
+
+- **YAML Configuration**: If YAML config files needed, install with `pip install prismalog[yaml]`
+- **Development**: For running tests and examples, install with `pip install prismalog[dev]`
+
+### Installation Options
+
+```bash
+# Prepare before installation (recommended)
+python -m venv .venv
+source source .venv/bin/activate
+
+# Basic installation - no external dependencies
+pip install -e .
+
+# With documentation support
+pip install prismalog[doc]
+
+# For development and testing
+pip install prismalog[dev]
+
+# With all optional features
+pip install prismalog[all]

prismalog-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+prismalog/__init__.py,sha256=Hr3ZNOGJLb8YvDTxViYuNUOKTlKridjFVmubnoCk1c4,998
+prismalog/argparser.py,sha256=M6WVCFvqtTKwxKZ89EtTKuo9jN0Egh785o0sj82WD_0,7105
+prismalog/config.py,sha256=V5g5YjEZEqznJPUUQdWeeQgiU5R3gm21oONHRhv0gC4,29596
+prismalog/log.py,sha256=b-zlMs2Y-KI7RuGO8KxFKFuAI0QMN6AiH6sM5vGZNE8,34573
+prismalog/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+prismalog-0.1.0.dist-info/licenses/LICENSE,sha256=A1PgraGM1LCUsPVtfZk1lOVRM1TrxvGqfleCPm0hKKk,1071
+prismalog-0.1.0.dist-info/METADATA,sha256=FOOAHtX1MW4nDojHKB8-qxQtwx_a9c376FFzlpJ52v8,7725
+prismalog-0.1.0.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
+prismalog-0.1.0.dist-info/top_level.txt,sha256=k65xN7XJxN3Z3UOJTQpDUkQnmRDv763tkgVneLrEesU,10
+prismalog-0.1.0.dist-info/RECORD,,

prismalog-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (78.1.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

prismalog-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alexey Obukhov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

prismalog-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+prismalog