custom-python-logger 1.0.10__tar.gz → 1.0.11__tar.gz

custom_python_logger-1.0.11/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: custom-python-logger
+Version: 1.0.11
+Summary: A custom logger with color support and additional features.
+Home-page: https://github.com/aviz92/custom-python-logger
+Author: Avi Zaguri
+Author-email: 
+Project-URL: Repository, https://github.com/aviz92/custom-python-logger
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools
+Requires-Dist: wheel
+Requires-Dist: colorlog
+Requires-Dist: pytest
+Requires-Dist: pathlib
+Requires-Dist: PyYAML
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# custom-python-logger
+A powerful and flexible Python logger with colored output, custom log levels, and advanced configuration options. <br>
+Easily integrate structured, readable, and context-rich logging into your Python projects for better debugging and monitoring.
+
+---
+
+## 🚀 Features
+- ✅ **Colored Output**: Beautiful, readable logs in your terminal using `colorlog`.
+- ✅ **Custom Log Levels**: Includes `STEP` (for process steps) and `EXCEPTION` (for exception tracking) in addition to standard levels.
+- ✅ **Flexible Output**: Log to console, file, or both. Supports custom log file paths and automatic log directory creation.
+- ✅ **Contextual Logging**: Add extra fields (like user, environment, etc.) to every log message.
+- ✅ **UTC Support**: Optionally log timestamps in UTC for consistency across environments.
+- ✅ **Pretty Formatting**: Built-in helpers for pretty-printing JSON and YAML data in logs.
+- ✅ **Easy Integration**: Simple API for getting a ready-to-use logger anywhere in your codebase.
+
+---
+
+## 📦 Installation
+```bash
+pip install custom-python-logger
+```
+
+---
+
+### 🔧 Usage
+Here's a quick example of how to use `custom-python-logger` in your project:
+
+```python
+import logging
+from custom_python_logger import get_logger, CustomLoggerAdapter
+
+logger: CustomLoggerAdapter = get_logger(
+    project_name='Logger Project Test',
+    log_level=logging.DEBUG,
+    log_file=True,
+)
+
+logger.debug("This is a debug message.")
+logger.info("This is an info message.")
+logger.step("This is a step message.")
+logger.warning("This is a warning message.")
+
+try:
+    _ = 1 / 0
+except ZeroDivisionError:
+    logger.exception("This is an exception message.")
+
+logger.critical("This is a critical message.")
+```
+
+#### Advanced Usage
+- Log to a file:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True)
+  ```
+- Use UTC timestamps:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True, utc=True)
+  ```
+- Add extra context:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True, utc=True, extra={'user': 'alice'})
+  ```
+- Pretty-print JSON or YAML:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter, json_pretty_format, yaml_pretty_format
+
+  logger = get_logger(project_name='MyApp', utc=True, log_file=True)
+
+  logger.info(json_pretty_format({'foo': 'bar'}))
+  logger.info(yaml_pretty_format({'foo': 'bar'}))
+  ```
+
+---
+
+## 🤝 Contributing
+If you have a helpful tool, pattern, or improvement to suggest:
+Fork the repo <br>
+Create a new branch <br>
+Submit a pull request <br>
+I welcome additions that promote clean, productive, and maintainable development. <br>
+
+---
+
+## 📄 License
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Thanks
+Thanks for exploring this repository! <br>
+Happy coding! <br>

custom_python_logger-1.0.11/README.md

@@ -0,0 +1,98 @@
+# custom-python-logger
+A powerful and flexible Python logger with colored output, custom log levels, and advanced configuration options. <br>
+Easily integrate structured, readable, and context-rich logging into your Python projects for better debugging and monitoring.
+
+---
+
+## 🚀 Features
+- ✅ **Colored Output**: Beautiful, readable logs in your terminal using `colorlog`.
+- ✅ **Custom Log Levels**: Includes `STEP` (for process steps) and `EXCEPTION` (for exception tracking) in addition to standard levels.
+- ✅ **Flexible Output**: Log to console, file, or both. Supports custom log file paths and automatic log directory creation.
+- ✅ **Contextual Logging**: Add extra fields (like user, environment, etc.) to every log message.
+- ✅ **UTC Support**: Optionally log timestamps in UTC for consistency across environments.
+- ✅ **Pretty Formatting**: Built-in helpers for pretty-printing JSON and YAML data in logs.
+- ✅ **Easy Integration**: Simple API for getting a ready-to-use logger anywhere in your codebase.
+
+---
+
+## 📦 Installation
+```bash
+pip install custom-python-logger
+```
+
+---
+
+### 🔧 Usage
+Here's a quick example of how to use `custom-python-logger` in your project:
+
+```python
+import logging
+from custom_python_logger import get_logger, CustomLoggerAdapter
+
+logger: CustomLoggerAdapter = get_logger(
+    project_name='Logger Project Test',
+    log_level=logging.DEBUG,
+    log_file=True,
+)
+
+logger.debug("This is a debug message.")
+logger.info("This is an info message.")
+logger.step("This is a step message.")
+logger.warning("This is a warning message.")
+
+try:
+    _ = 1 / 0
+except ZeroDivisionError:
+    logger.exception("This is an exception message.")
+
+logger.critical("This is a critical message.")
+```
+
+#### Advanced Usage
+- Log to a file:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True)
+  ```
+- Use UTC timestamps:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True, utc=True)
+  ```
+- Add extra context:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True, utc=True, extra={'user': 'alice'})
+  ```
+- Pretty-print JSON or YAML:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter, json_pretty_format, yaml_pretty_format
+
+  logger = get_logger(project_name='MyApp', utc=True, log_file=True)
+
+  logger.info(json_pretty_format({'foo': 'bar'}))
+  logger.info(yaml_pretty_format({'foo': 'bar'}))
+  ```
+
+---
+
+## 🤝 Contributing
+If you have a helpful tool, pattern, or improvement to suggest:
+Fork the repo <br>
+Create a new branch <br>
+Submit a pull request <br>
+I welcome additions that promote clean, productive, and maintainable development. <br>
+
+---
+
+## 📄 License
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Thanks
+Thanks for exploring this repository! <br>
+Happy coding! <br>

{custom_python_logger-1.0.10 → custom_python_logger-1.0.11}/custom_python_logger/usage_example.py

@@ -1,4 +1,5 @@
 import logging
+from custom_python_logger import get_logger
 
 
 class LoggerTest:
@@ -11,11 +12,10 @@ class LoggerTest:
 
 
 def main():
-    from custom_python_logger.logger import get_logger
-
     logger = get_logger(
         project_name='Logger Project Test',
         log_level=logging.DEBUG,
+        log_file=True,
         # extra={'user': 'test_user'}
     )
 

custom_python_logger-1.0.11/custom_python_logger.egg-info/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: custom-python-logger
+Version: 1.0.11
+Summary: A custom logger with color support and additional features.
+Home-page: https://github.com/aviz92/custom-python-logger
+Author: Avi Zaguri
+Author-email: 
+Project-URL: Repository, https://github.com/aviz92/custom-python-logger
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools
+Requires-Dist: wheel
+Requires-Dist: colorlog
+Requires-Dist: pytest
+Requires-Dist: pathlib
+Requires-Dist: PyYAML
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# custom-python-logger
+A powerful and flexible Python logger with colored output, custom log levels, and advanced configuration options. <br>
+Easily integrate structured, readable, and context-rich logging into your Python projects for better debugging and monitoring.
+
+---
+
+## 🚀 Features
+- ✅ **Colored Output**: Beautiful, readable logs in your terminal using `colorlog`.
+- ✅ **Custom Log Levels**: Includes `STEP` (for process steps) and `EXCEPTION` (for exception tracking) in addition to standard levels.
+- ✅ **Flexible Output**: Log to console, file, or both. Supports custom log file paths and automatic log directory creation.
+- ✅ **Contextual Logging**: Add extra fields (like user, environment, etc.) to every log message.
+- ✅ **UTC Support**: Optionally log timestamps in UTC for consistency across environments.
+- ✅ **Pretty Formatting**: Built-in helpers for pretty-printing JSON and YAML data in logs.
+- ✅ **Easy Integration**: Simple API for getting a ready-to-use logger anywhere in your codebase.
+
+---
+
+## 📦 Installation
+```bash
+pip install custom-python-logger
+```
+
+---
+
+### 🔧 Usage
+Here's a quick example of how to use `custom-python-logger` in your project:
+
+```python
+import logging
+from custom_python_logger import get_logger, CustomLoggerAdapter
+
+logger: CustomLoggerAdapter = get_logger(
+    project_name='Logger Project Test',
+    log_level=logging.DEBUG,
+    log_file=True,
+)
+
+logger.debug("This is a debug message.")
+logger.info("This is an info message.")
+logger.step("This is a step message.")
+logger.warning("This is a warning message.")
+
+try:
+    _ = 1 / 0
+except ZeroDivisionError:
+    logger.exception("This is an exception message.")
+
+logger.critical("This is a critical message.")
+```
+
+#### Advanced Usage
+- Log to a file:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True)
+  ```
+- Use UTC timestamps:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True, utc=True)
+  ```
+- Add extra context:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter
+
+  logger = get_logger(project_name='MyApp', log_file=True, utc=True, extra={'user': 'alice'})
+  ```
+- Pretty-print JSON or YAML:
+  ```python
+  from custom_python_logger import get_logger, CustomLoggerAdapter, json_pretty_format, yaml_pretty_format
+
+  logger = get_logger(project_name='MyApp', utc=True, log_file=True)
+
+  logger.info(json_pretty_format({'foo': 'bar'}))
+  logger.info(yaml_pretty_format({'foo': 'bar'}))
+  ```
+
+---
+
+## 🤝 Contributing
+If you have a helpful tool, pattern, or improvement to suggest:
+Fork the repo <br>
+Create a new branch <br>
+Submit a pull request <br>
+I welcome additions that promote clean, productive, and maintainable development. <br>
+
+---
+
+## 📄 License
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Thanks
+Thanks for exploring this repository! <br>
+Happy coding! <br>

{custom_python_logger-1.0.10 → custom_python_logger-1.0.11}/setup.py

@@ -1,6 +1,6 @@
 from setuptools import setup, find_packages
 
-package_version = '1.0.10'
+package_version = '1.0.11'
 
 package_name = 'custom-python-logger'
 package_description = 'A custom logger with color support and additional features.'

custom_python_logger-1.0.10/PKG-INFO

@@ -1,83 +0,0 @@
-Metadata-Version: 2.4
-Name: custom-python-logger
-Version: 1.0.10
-Summary: A custom logger with color support and additional features.
-Home-page: https://github.com/aviz92/custom-python-logger
-Author: Avi Zaguri
-Author-email: 
-Project-URL: Repository, https://github.com/aviz92/custom-python-logger
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: setuptools
-Requires-Dist: wheel
-Requires-Dist: colorlog
-Requires-Dist: pytest
-Requires-Dist: pathlib
-Requires-Dist: PyYAML
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# Custom Logger
-A Python logger with colored output and additional log levels. <br> 
-The logger supports custom log levels like `STEP` and `EXCEPTION` and can be easily integrated into your Python projects.
-
-## Installation
-You can install the package using pip:
-```bash
-pip install custom-python-logger
-```
-
-## Usage
-```python
-import logging
-from custom_python_logger.logger import get_logger, CustomLoggerAdapter
-
-logger: CustomLoggerAdapter = CustomLoggerAdapter(logging.getLogger(__name__))
-
-
-def main():
-    logger.debug("This is a debug message.")
-    logger.info("This is an info message.")
-    logger.step("This is a step message.")
-    logger.warning("This is a warning message.")
-
-    try:
-        _ = 1 / 0
-    except ZeroDivisionError:
-        logger.exception("This is an exception message.")
-
-    logger.critical("This is a critical message.")
-
-
-if __name__ == '__main__':
-    _ = get_logger(
-        project_name='Logger Project Test',
-        log_level=logging.DEBUG,
-        extra={'user': 'test_user'}
-    )
-
-    main()
-```
-
----
-
-## 🤝 Contributing
-If you have a helpful tool, pattern, or improvement to suggest:
-Fork the repo <br>
-Create a new branch <br>
-Submit a pull request <br>
-I welcome additions that promote clean, productive, and maintainable development. <br>
-
----
-
-## 🙏 Thanks
-Thanks for exploring this repository! <br>
-Happy coding! <br>

custom_python_logger-1.0.10/README.md

@@ -1,56 +0,0 @@
-# Custom Logger
-A Python logger with colored output and additional log levels. <br> 
-The logger supports custom log levels like `STEP` and `EXCEPTION` and can be easily integrated into your Python projects.
-
-## Installation
-You can install the package using pip:
-```bash
-pip install custom-python-logger
-```
-
-## Usage
-```python
-import logging
-from custom_python_logger.logger import get_logger, CustomLoggerAdapter
-
-logger: CustomLoggerAdapter = CustomLoggerAdapter(logging.getLogger(__name__))
-
-
-def main():
-    logger.debug("This is a debug message.")
-    logger.info("This is an info message.")
-    logger.step("This is a step message.")
-    logger.warning("This is a warning message.")
-
-    try:
-        _ = 1 / 0
-    except ZeroDivisionError:
-        logger.exception("This is an exception message.")
-
-    logger.critical("This is a critical message.")
-
-
-if __name__ == '__main__':
-    _ = get_logger(
-        project_name='Logger Project Test',
-        log_level=logging.DEBUG,
-        extra={'user': 'test_user'}
-    )
-
-    main()
-```
-
----
-
-## 🤝 Contributing
-If you have a helpful tool, pattern, or improvement to suggest:
-Fork the repo <br>
-Create a new branch <br>
-Submit a pull request <br>
-I welcome additions that promote clean, productive, and maintainable development. <br>
-
----
-
-## 🙏 Thanks
-Thanks for exploring this repository! <br>
-Happy coding! <br>

custom_python_logger-1.0.10/custom_python_logger.egg-info/PKG-INFO

@@ -1,83 +0,0 @@
-Metadata-Version: 2.4
-Name: custom-python-logger
-Version: 1.0.10
-Summary: A custom logger with color support and additional features.
-Home-page: https://github.com/aviz92/custom-python-logger
-Author: Avi Zaguri
-Author-email: 
-Project-URL: Repository, https://github.com/aviz92/custom-python-logger
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: setuptools
-Requires-Dist: wheel
-Requires-Dist: colorlog
-Requires-Dist: pytest
-Requires-Dist: pathlib
-Requires-Dist: PyYAML
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# Custom Logger
-A Python logger with colored output and additional log levels. <br> 
-The logger supports custom log levels like `STEP` and `EXCEPTION` and can be easily integrated into your Python projects.
-
-## Installation
-You can install the package using pip:
-```bash
-pip install custom-python-logger
-```
-
-## Usage
-```python
-import logging
-from custom_python_logger.logger import get_logger, CustomLoggerAdapter
-
-logger: CustomLoggerAdapter = CustomLoggerAdapter(logging.getLogger(__name__))
-
-
-def main():
-    logger.debug("This is a debug message.")
-    logger.info("This is an info message.")
-    logger.step("This is a step message.")
-    logger.warning("This is a warning message.")
-
-    try:
-        _ = 1 / 0
-    except ZeroDivisionError:
-        logger.exception("This is an exception message.")
-
-    logger.critical("This is a critical message.")
-
-
-if __name__ == '__main__':
-    _ = get_logger(
-        project_name='Logger Project Test',
-        log_level=logging.DEBUG,
-        extra={'user': 'test_user'}
-    )
-
-    main()
-```
-
----
-
-## 🤝 Contributing
-If you have a helpful tool, pattern, or improvement to suggest:
-Fork the repo <br>
-Create a new branch <br>
-Submit a pull request <br>
-I welcome additions that promote clean, productive, and maintainable development. <br>
-
----
-
-## 🙏 Thanks
-Thanks for exploring this repository! <br>
-Happy coding! <br>