dj-logging 1.0.0__py3-none-any.whl

dj_logging-1.0.0.dist-info/AUTHORS.md

@@ -0,0 +1,10 @@
+## Authors
+
+- **Aryan Niknezhad**
+  - GitHub: [ARYAN-NIKNEZHAD](https://github.com/ARYAN-NIKNEZHAD)
+  - Email: aryan513966@gmail.com
+
+
+- **Mehrshad Mirshekary**
+  - GitHub: [MEHRSHAD-MIRSHEKARY](https://github.com/MEHRSHAD-MIRSHEKARY)
+  - Email: mehrshad_mirshekary@email.com

dj_logging-1.0.0.dist-info/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 django_logging
+
+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.

dj_logging-1.0.0.dist-info/METADATA

@@ -0,0 +1,331 @@
+Metadata-Version: 2.1
+Name: dj-logging
+Version: 1.0.0
+Summary: A package for logging in django applications
+Home-page: https://github.com/ARYAN-NIKNEZHAD/django_logging
+License: MIT
+Keywords: django_logging,django,logging
+Author: ARYAN-NIKNEZHAD
+Author-email: aryan513966@gmail.com
+Requires-Python: >=3.8,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: django (>=4.2,<5.0) ; python_version >= "3.8" and python_version < "3.10"
+Requires-Dist: django (>=4.2,<5.3) ; python_version >= "3.10"
+Project-URL: Documentation, https://django_logging.readthedocs.io
+Project-URL: Issues, https://github.com/ARYAN-NIKNEZHAD/django_logging/issues
+Project-URL: Repository, https://github.com/ARYAN-NIKNEZHAD/django_logging
+Project-URL: Source Code, https://github.com/ARYAN-NIKNEZHAD/django_logging
+Description-Content-Type: text/markdown
+
+# Django Logging
+
+The [`django_logging`](https://github.com/ARYAN-NIKNEZHAD/django_logging) is a Django package designed to extend and enhance Python’s built-in logging capabilities. By providing customizable configurations and advanced features, it offers developers a comprehensive logging solution tailored specifically for Django applications.
+
+![License](https://img.shields.io/github/license/ARYAN-NIKNEZHAD/django_logging)
+![PyPI release](https://img.shields.io/pypi/v/django_logging)
+![Supported Python versions](https://img.shields.io/pypi/pyversions/django_logging)
+![Supported Django versions](https://img.shields.io/pypi/djversions/django_logging)
+![Documentation](https://img.shields.io/readthedocs/django_logging)
+![Last Commit](https://img.shields.io/github/last-commit/ARYAN-NIKNEZHAD/django_logging)
+![Languages](https://img.shields.io/github/languages/top/ARYAN-NIKNEZHAD/django_logging)
+![CI Workflow](https://github.com/ARYAN-NIKNEZHAD/django_logging/actions/workflows/ci.yml/badge.svg)
+![Open Issues](https://img.shields.io/github/issues/ARYAN-NIKNEZHAD/django_logging)
+[![codecov](https://codecov.io/gh/ARYAN-NIKNEZHAD/django_logging/branch/main/graph/badge.svg)](https://codecov.io/gh/ARYAN-NIKNEZHAD/django_logging)
+
+
+## Project Detail
+
+- Language: Python > 3.8
+- Framework: Django > 4.2
+
+
+## Documentation
+
+The documentation is organized into the following sections:
+
+- [Quick Start](#quick-start)
+- [Usage](#usage)
+- [Settings](#settings)
+- [Available Format Options](#available-format-options)
+- [Required Email Settings](#required-email-settings)
+
+
+## Quick Start
+
+Getting started with `django_logging` is simple. Follow these steps to get up and running quickly:
+
+1. **Install the Package**
+
+first, Install `django_logging` via pip:
+
+```shell
+$ pip install django_logging
+```
+
+2. **Add to Installed Apps**
+
+Add `django_logging` to your `INSTALLED_APPS` in your Django settings file:
+
+```python
+INSTALLED_APPS = [
+    ...
+    'django_logging',
+    ...
+]
+```
+
+
+3. **Run Your Server**
+
+Start your Django Development server to verify the installation:
+```shell
+python manage.py runserver
+```
+
+when the server starts, you'll see an initialization message like this in your *console*:
+```shell
+INFO | 'datetime' | django_logging | Logging initialized with the following configurations:
+Log File levels: ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'].
+Log files are being written to: logs.
+Console output level: DEBUG.
+Colorize console: True.
+Log date format: %Y-%m-%d %H:%M:%S.
+Email notifier enabled: False.
+```
+By default, django_logging will log each level to its own file:
+- DEBUG : `logs/debug.log`
+- INFO : `logs/info.log`
+- WARNING : `logs/warning.log`
+- ERROR : `logs/error.log`
+- CRITICAL : `logs/critical.log`
+
+In addition, logs will be displayed in ***colorized*** mode in the `console`, making it easier to distinguish between different log levels.
+
+That's it! `django_logging` is ready to use. For further customization, refer to the [Settings](#settings) section
+
+
+## Usage
+Once `django_logging` is installed and added to your INSTALLED_APPS, you can start using it right away. The package provides several features to customize and enhance logging in your Django project. Below is a guide on how to use the various features provided by `django_logging`.
+
+1. **Basic Logging Usage**
+
+At its core, `django_logging` is built on top of Python’s built-in logging module. This means you can use the standard logging module to log messages across your Django project. Here’s a basic example of logging usage:
+```python
+import logging
+
+logger = logging.getLogger(__name__)
+
+logger.debug("This is a debug message")
+logger.info("This is an info message")
+logger.warning("This is a warning message")
+logger.error("This is an error message")
+logger.critical("This is a critical message")
+```
+These logs will be handled according to the configurations set up by `django_logging`, using either the default settings or any custom settings you've provided.
+
+2. **Request Logging Middleware**
+
+To log the detail of each request to the server and capture information such as the request path, user, IP address, and user agent, add `django_logging.middleware.RequestLogMiddleware` to your MIDDLEWARE setting:
+
+```python
+MIDDLEWARE = [
+    ...
+    'django_logging.middleware.RequestLogMiddleware',
+    ...
+]
+```
+
+This middleware will log th request details at info level, here is an example with default format:
+```shell
+INFO | 'datetime' | django_logging | Request Info: (request_path: /example-path, user: example_user,
+IP: 192.168.1.1, user_agent: Mozilla/5.0)
+
+```
+
+3. **Context Manager**
+
+You can use the `config_setup` context manager to temporarily apply `django_logging` configurations within a specific block of code.
+Example usage:
+```python
+from django_logging.utils.context_manager import config_setup
+import logging
+
+logger = logging.getLogger(__name__)
+
+def foo():
+  logger.info("This log will use the configuration set in the context manager!")
+
+with config_setup():
+    """ Your logging configuration changes here"""
+    foo()
+
+# the logging configuration will restore to what it was before, in here outside of with block
+```
+- Note: `AUTO_INITIALIZATION_ENABLE` must be set to `False` in the settings to use the context manager. If `AUTO_INITIALIZATION_ENABLE` is `True`, attempting to use the context manager will raise a `ValueError` with the message:
+```
+"You must set 'AUTO_INITIALIZATION_ENABLE' to False in DJANGO_LOGGING in your settings to use the context manager."
+```
+
+4. **Log and Notify Utility**
+
+To send specific logs as email, use the `log_and_notify_admin` function. Ensure that the `ENABLE` option in `LOG_EMAIL_NOTIFIER` is set to `True` in your settings:
+```python
+from django_logging.utils.log_email_notifier.log_and_notify import log_and_notify_admin
+import logging
+
+logger = logging.getLogger(__name__)
+
+log_and_notify_admin(logger, logging.INFO, "This is a log message")
+```
+You can also include additional request information (`ip_address` and `browser_type`) in the email by passing an `extra` dictionary:
+```python
+from django_logging.utils.log_email_notifier.log_and_notify import log_and_notify_admin
+import logging
+
+logger = logging.getLogger(__name__)
+
+def some_view(request):
+    log_and_notify_admin(
+        logger,
+        logging.INFO,
+        "This is a log message",
+        extra={"request": request}
+    )
+```
+
+- Note: To use the email notifier, `LOG_EMAIL_NOTIFIER["ENABLE"]` must be set to `True`. If it is not enabled, calling `log_and_notify_admin` will raise a `ValueError`:
+```shell
+"Email notifier is disabled. Please set the 'ENABLE' option to True in the 'LOG_EMAIL_NOTIFIER' in DJANGO_LOGGING in your settings to activate email notifications."
+```
+
+Additionally, ensure that all [Required Email Settings](#required-email-settings) are configured in your Django settings file.
+
+5. **Send Logs Command**
+
+To send the entire log directory to a specified email address, use the `send_logs` management command:
+```shell
+python manage.py send_logs example@domain.com
+```
+This command will attach the log directory and send a zip file to the provided email address.
+
+## Settings
+
+By default, `django_logging` uses a built-in configuration that requires no additional setup. However, you can customize the logging settings by adding the `DJANGO_LOGGING` dictionary configuration to your Django `settings` file.
+
+Example configuration:
+```python
+DJANGO_LOGGING = {
+    "AUTO_INITIALIZATION_ENABLE": True,
+    "INITIALIZATION_MESSAGE_ENABLE": True,
+    "LOG_FILE_LEVELS": ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],
+    "LOG_DIR": "logs",
+    "LOG_FILE_FORMATS": {
+        "DEBUG": 1,
+        "INFO": 1,
+        "WARNING": 1,
+        "ERROR": 1,
+        "CRITICAL": 1,
+    },
+    "LOG_CONSOLE_LEVEL": "DEBUG",
+    "LOG_CONSOLE_FORMAT": 1,
+    "LOG_CONSOLE_COLORIZE": True,
+    "LOG_DATE_FORMAT": "%Y-%m-%d %H:%M:%S",
+    "LOG_EMAIL_NOTIFIER": {
+        "ENABLE": False,
+        "NOTIFY_ERROR": False,
+        "NOTIFY_CRITICAL": False,
+        "LOG_FORMAT": 1,
+        "USE_TEMPLATE": True
+    }
+}
+```
+
+Here's a breakdown of the available configuration options:
+- `AUTO_INITIALIZATION_ENABLE`: Accepts `bool`. Enables automatic initialization of logging configurations. Defaults to `True`.
+- `INITIALIZATION_MESSAGE_ENABLE`: Accepts bool. Enables logging of the initialization message. Defaults to `True`.
+- `LOG_FILE_LEVELS`: Accepts a list of valid log levels (a list of `str` where each value must be one of the valid levels). Defines the log levels for file logging. Defaults to `['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']`.
+- `LOG_DIR`: Accepts `str` like `"path/to/logs"` or a path using functions like `os.path.join()`. Specifies the directory where log files will be stored. Defaults to `"logs"`.
+- `LOG_FILE_FORMATS`: Accepts log levels as keys and format options as values. The format option can be an `int` chosen from predefined options or a user-defined format `str`. Defines the format for log files. Defaults to `1` for all levels.
+  - **Note**: See the [Available Format Options](#available-format-options) below for available formats.
+- `LOG_CONSOLE_LEVEL`: Accepts `str` that is a valid log level. Specifies the log level for console output. Defaults to `'DEBUG'`.
+- `LOG_CONSOLE_FORMAT`: Accepts the same options as `LOG_FILE_FORMATS`. Defines the format for console output. Defaults to `1`.
+- `LOG_CONSOLE_COLORIZE`: Accepts `bool`. Determines whether to colorize console output. Defaults to `True`.
+- `LOG_DATE_FORMAT`: Accepts `str` that is a valid datetime format. Specifies the date format for log messages. Defaults to `'%Y-%m-%d %H:%M:%S'`.
+- `LOG_EMAIL_NOTIFIER`: Is a dictionary where:
+  - `ENABLE`: Accepts `bool`. Determines whether the email notifier is enabled. Defaults to `False`.
+  - `NOTIFY_ERROR`: Accepts `bool`. Determines whether to notify on error logs. Defaults to `False`.
+  - `NOTIFY_CRITICAL`: Accepts `bool`. Determines whether to notify on critical logs. Defaults to `False`.
+  - `LOG_FORMAT`: Accepts the same options as other log formats (`int` or `str`). Defines the format for log messages sent via email. Defaults to `1`.
+  - `USE_TEMPLATE`: Accepts `bool`. Determines whether the email includes an HTML template. Defaults to `True`.
+
+## Available Format Options
+
+The `django_logging` package provides predefined log format options that you can use in configuration. Below are the available format options:
+
+```python
+FORMAT_OPTIONS = {
+    1: "%(levelname)s | %(asctime)s | %(module)s | %(message)s",
+    2: "%(levelname)s | %(asctime)s | %(message)s",
+    3: "%(levelname)s | %(message)s",
+    4: "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    5: "%(levelname)s | %(message)s | [in %(pathname)s:%(lineno)d]",
+    6: "%(asctime)s | %(levelname)s | %(message)s",
+    7: "%(levelname)s | %(asctime)s | in %(module)s: %(message)s",
+    8: "%(levelname)s | %(message)s | [%(filename)s:%(lineno)d]",
+    9: "[%(asctime)s] | %(levelname)s | in %(module)s: %(message)s",
+    10: "%(asctime)s | %(processName)s | %(name)s | %(levelname)s | %(message)s",
+    11: "%(asctime)s | %(threadName)s | %(name)s | %(levelname)s | %(message)s",
+    12: "%(levelname)s | [%(asctime)s] | (%(filename)s:%(lineno)d) | %(message)s",
+    13: "%(levelname)s | [%(asctime)s] | {%(name)s} | (%(filename)s:%(lineno)d): %(message)s",
+}
+```
+
+You can reference these formats by their corresponding integer keys in your logging configuration settings.
+
+## Required Email Settings
+
+To use the email notifier, the following email settings must be configured in your `settings.py`:
+- `EMAIL_HOST`: The host to use for sending emails.
+- `EMAIL_PORT`: The port to use for the email server.
+- `EMAIL_HOST_USER`: The username to use for the email server.
+- `EMAIL_HOST_PASSWORD`: The password to use for the email server.
+- `EMAIL_USE_TLS`: Whether to use a TLS (secure) connection when talking to the email server.
+- `DEFAULT_FROM_EMAIL`: The default email address to use for sending emails.
+- `ADMIN_EMAIL`: The email address where log notifications will be sent. This is the recipient address used by the email notifier to deliver the logs.
+
+Example Email Settings:
+```python
+EMAIL_HOST = 'smtp.example.com'
+EMAIL_PORT = 587
+EMAIL_HOST_USER = 'your-email@example.com'
+EMAIL_HOST_PASSWORD = 'your-password'
+EMAIL_USE_TLS = True
+DEFAULT_FROM_EMAIL = 'your-email@example.com'
+ADMIN_EMAIL = 'admin@example.com'
+```
+
+These settings ensure that the email notifier is correctly configured to send log notifications to the specified `ADMIN_EMAIL` address.
+
+## Conclusion
+
+Thank you for using `django_logging`. We hope this package enhances your Django application's logging capabilities. For more detailed documentation, customization options, and updates, please refer to the official documentation on [Read the Docs](https://django_logging.readthedocs.io/). If you have any questions or issues, feel free to open an issue on our [GitHub repository](https://github.com/ARYAN-NIKNEZHAD/django_logging).
+
+Happy logging!
+

dj_logging-1.0.0.dist-info/RECORD

@@ -0,0 +1,78 @@
+django_logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/apps.py,sha256=71Du0kx6GLFq7cxalFYeT3wQKbzcMUAiX8xep29S5XA,1179
+django_logging/constants/__init__.py,sha256=O-Rctwl8KJOJkcxkz8uuYmPbZZdsnI6bPAMfFUmFU_0,238
+django_logging/constants/ansi_colors.py,sha256=29Tmx0282lM3B3L1ojy0U6mI6y6X46lm2YnZxHKvOfg,1295
+django_logging/constants/config_types.py,sha256=8EPl1g92JHWTtOkjkogUunuSaKUUXCJeMCWCF5fOz5Q,683
+django_logging/constants/date_format_directives.py,sha256=tF_tbIH2NvfLfZAjSsPB69nk4Q__03d-Inm3H5rEBr4,254
+django_logging/constants/default_settings.py,sha256=iL7h2ynPU4fWTgG5rNdNaRfDTs6mTJL7lHHDKLtiawU,1558
+django_logging/constants/log_format_options.py,sha256=W5RO_xRccybkT1-XzWHdV1xmYdGoiK9JW8N7U5eN3Fk,918
+django_logging/constants/log_format_specifiers.py,sha256=SJQGCsVf2u0YN5-DBWTF22k7aSxcxigKck0q_YZYY_w,294
+django_logging/constants/required_email_settings.py,sha256=FWtY7UK4iFOsQiFKFfq_DtmcGGKME2aY-ByyImZOVAM,222
+django_logging/filters/__init__.py,sha256=J_StGmF-RlzH0Cv08BafX-KKNzSZ7LyV1VoHEhJTxFA,50
+django_logging/filters/log_level_filter.py,sha256=QA1RoYsRY9amMUteO_EhpG6Y2W04vCqaH0N9HE3JWpE,1203
+django_logging/formatters/__init__.py,sha256=odNYHr1NMK1mWPYYqmVINq_mJNGlljGhItbGs0DzajM,49
+django_logging/formatters/colored_formatter.py,sha256=y7onn8CmnCMpwaylXD9Y6JU37qOy8aCUS94qeldSZrg,776
+django_logging/handlers/__init__.py,sha256=hgfcch6k4xZaKF0oyM_hv_9M4cN0DT21119EpTMPKPU,41
+django_logging/handlers/email_handler.py,sha256=nAT6NA0UJ_l8mge0GqN3Tsn-0_eH5SVWvredI_x26HM,1866
+django_logging/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/management/commands/send_logs.py,sha256=2cf0KwBRbYeH9mNXoPLa7HMO_F5xLfeZxCbnAd-cyBE,3870
+django_logging/middleware/__init__.py,sha256=ShYaGaAeEcAs2N1s6ZMWlrrQUkrQeHF4BXWv5eGLzfs,54
+django_logging/middleware/request_middleware.py,sha256=YeVcIgPFMmw3_eQgme3M5TXlSN1CW8zXQ7eqs3bjnS4,2717
+django_logging/settings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/settings/checks.py,sha256=TjeZRWIQemMpE0Ih5Yjw_hYNHZ0avffjPZ5Uzvi_u4g,6136
+django_logging/settings/conf.py,sha256=fxVXrJD6SbQ0Rv03Q8jd1lmW1yhdZxBjxXdvEvogSjo,7764
+django_logging/templates/email_notifier_template.html,sha256=SAROoNCVhvE89taye_evBCJmvl3zeFXe5rz40FkuHCU,2994
+django_logging/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/commands/test_send_logs.py,sha256=zKJn-raA5e2g62BjYmuwf_tEiwtakBcUFaFSTWVEAbI,8157
+django_logging/tests/conftest.py,sha256=BJQ4uQkqaMZ-ac4QS2FQs4fAyLFvlvAa89XWk-kZ60M,560
+django_logging/tests/constants.py,sha256=evfW-Jns06uBqdzKiD_8b9LwcEOZhm9kiyCrHhBiNKA,82
+django_logging/tests/filters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/filters/test_log_level_filter.py,sha256=-dwQckqub5U9jqS0-ywicVu98Ja_0q8Nv00gHupQnW4,2665
+django_logging/tests/fixtures/__init__.py,sha256=VA8Z75x3x7l4Uh4C1gUGKoN351uuLOaVE9jX453xCC8,670
+django_logging/tests/fixtures/colored_formatter_fixture.py,sha256=PP8-N-iWNGZA7tlzisOiCgW0gTSi2VYz-jaHUI5GUu4,418
+django_logging/tests/fixtures/conf_fixture.py,sha256=EzHn736Ip-jfGR4v2VWxCkPjmYwpFIExb14_j8e_BkE,1470
+django_logging/tests/fixtures/email_handler_fixture.py,sha256=0j7na46GEJJWR8Qj7lbPfr84-5kXtxcftPfVXWfNz-E,315
+django_logging/tests/fixtures/email_notifier_fixture.py,sha256=grGLgl9P-EgVUnBZLaI4AFXo0Cy3_3wN94fvmkUXw7o,2249
+django_logging/tests/fixtures/email_settings_fixture.py,sha256=E4dt6KwegGZqMzYSnQmkWe_0MvSnvk4D86zD0HpjrYE,774
+django_logging/tests/fixtures/log_and_notify_fixture.py,sha256=KOxuNtJ3nTG1D35wmBMJoDCQb1VANj_NN8aSSAstXu4,797
+django_logging/tests/fixtures/log_record_fixture.py,sha256=Xk-XPJiX-eFH0l_5EpwVYFlZXln4NmNH8tFusLnS5CE,920
+django_logging/tests/fixtures/logger_fixture.py,sha256=YsG_0ApmJ3Mzh-UxC9iOt9xq-yIrbO1WHeKsc0_EQv0,641
+django_logging/tests/fixtures/request_middleware_fixture.py,sha256=TqNVkONgDw3R3pc9PTsTUR9WTNbvZ0x3tS28TSc-1q4,1356
+django_logging/tests/fixtures/settings_fixture.py,sha256=zl2U59V5j23pbaz18-MGLbcQoZyulremo3hftQ-zesg,1806
+django_logging/tests/fixtures/setup_django.py,sha256=lWTdw3Z26pkCZ47blAOQKs-0_5ltyhZJCvjvyxsWwaU,1888
+django_logging/tests/formatters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/formatters/test_colored_formatter.py,sha256=8el8lwRFNlOpESVCa-MIoJsGtyMND5UzMg-aoolp84Q,4953
+django_logging/tests/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/handlers/test_email_handler.py,sha256=OxIYVuexHQHJOxMadbMGnX7tF7DP9NBTQRoqFADYC0I,7464
+django_logging/tests/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/middleware/test_request_middleware.py,sha256=HTfrB58mNx8hKyx57aZraPqHdo3Lo146Lz5DnNOwqsQ,5381
+django_logging/tests/settings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/settings/test_checks.py,sha256=j4iGxYyBGttJ7AY4Txl2dp-B75jwF4Oz9w-p2dD2hQw,10737
+django_logging/tests/settings/test_conf.py,sha256=6orD2mysCiONJfcZXU-TdaFVW7uDRHZy-Xwrlhx5rNQ,7074
+django_logging/tests/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/utils/test_context_manager.py,sha256=4gpV6KP_dEAmF-mx0LMe-7HzG7M1rPFb-wfciD6fFl0,7393
+django_logging/tests/utils/test_email_notifier.py,sha256=TSy2yaCRNSWBdMaD39I6m70dD9Kb_LBksAr-bBQ_l0c,4692
+django_logging/tests/utils/test_get_conf.py,sha256=6oY00W4krqLkji4gNV4sWJp8peXKAjKmAUp2ugdesdk,6307
+django_logging/tests/utils/test_log_and_notify.py,sha256=eH8EqPD3uttj1Jx7nkHEpoenGgUSFMbk4-8QjkHfiLM,9730
+django_logging/tests/utils/test_set_conf.py,sha256=gRnLi-_By9VC7aJ4avx4bZO3VkiYU_HBRt-0z8s2bMI,8226
+django_logging/tests/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/tests/validators/test_config_validators.py,sha256=OpeELcyhMXBxFpZkUaG35GkgmJ2Ybea2ABXmsTlhnX4,13278
+django_logging/tests/validators/test_email_settings_validator.py,sha256=NCD4Y9K68vosVqDvVZyWI71b8vOr1hs6GbXylyxWna8,6580
+django_logging/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/utils/console_colorizer.py,sha256=-68jAjzsbbVVeA_Gk3X0_-eQks9-eDe-SpuwaJJUNF4,1578
+django_logging/utils/context_manager.py,sha256=Ilusmtg5Bjz4zRHYqUk4sxdhzefdPf6Xr1VePo1lgGk,2082
+django_logging/utils/get_conf.py,sha256=iHQAz18Ob73A_jg3bN2zsx6fDHUnovma8HxONoOnca0,3979
+django_logging/utils/log_email_notifier/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/utils/log_email_notifier/log_and_notify.py,sha256=YbHxkIdNjgQB8N_vqcKfePZCFw_3KOxPOF9MgzJeEn4,2598
+django_logging/utils/log_email_notifier/notifier.py,sha256=EBhRpfkA3NdRYsLpOCclCNfUuVpfzhTVOcBp7A7SQQU,1508
+django_logging/utils/set_conf.py,sha256=O0ddESxhTzFa8UD3aoWAt5HekuwG-FRu2dIe7Tpq218,5208
+django_logging/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+django_logging/validators/config_validators.py,sha256=9Znn3ct4cOmlJLbaKhM-MhIoh3lLn1qY73GFwDKr9C8,8683
+django_logging/validators/email_settings_validator.py,sha256=OMHuHP97bDTLw-844tP-e10UlWRmHQAKLGQu89IB-x8,1251
+dj_logging-1.0.0.dist-info/AUTHORS.md,sha256=UQJEI-INeq2wSS91y05pDZSTOCTAFQ9yhofJAdO9ujM,286
+dj_logging-1.0.0.dist-info/LICENCE,sha256=fdk9QuyX4YpYn2mVlyHMxthtBCcBJTdnUtMAipNQxKU,1092
+dj_logging-1.0.0.dist-info/METADATA,sha256=twnr_-45beKq8H7gBq5r6SgAUj4xkdu4gboY7HFvtow,14686
+dj_logging-1.0.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+dj_logging-1.0.0.dist-info/RECORD,,

dj_logging-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.9.0
+Root-Is-Purelib: true
+Tag: py3-none-any

django_logging/apps.py

@@ -0,0 +1,32 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class DjangoLoggingConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "django_logging"
+    verbose_name = _("Django Logging")
+
+    def ready(self) -> None:
+        """This method is called when the Django application is ready.
+
+        The `ready` method is used to perform application-specific
+        startup tasks. In this case, it performs the following actions:
+
+        1. Imports necessary modules for checks, configuration retrieval,
+           and logging setup.
+        2. Retrieves the logging configuration from settings using `get_config`.
+        3. Sets up the logging configuration using the retrieved configs.
+
+        This ensures that the logging configuration is correctly set up
+        when the application starts.
+
+        """
+        from django_logging.settings import checks
+        from django_logging.utils.get_conf import get_config
+        from django_logging.utils.set_conf import set_config
+
+        conf = get_config()
+
+        # Set the logging configuration
+        set_config(**conf)

django_logging/constants/__init__.py

@@ -0,0 +1,4 @@
+from .date_format_directives import VALID_DIRECTIVES
+from .default_settings import DefaultConsoleSettings, DefaultLoggingSettings
+from .log_format_options import FORMAT_OPTIONS
+from .log_format_specifiers import LOG_FORMAT_SPECIFIERS

django_logging/constants/ansi_colors.py

@@ -0,0 +1,42 @@
+from dataclasses import dataclass
+
+
+# pylint: disable=too-many-instance-attributes
+@dataclass(frozen=True)
+class AnsiColors:
+    BLACK: str = "\033[0;30m"
+    RED: str = "\033[0;31m"
+    GREEN: str = "\033[0;32m"
+    YELLOW: str = "\033[0;33m"
+    BLUE: str = "\033[0;34m"
+    MAGENTA: str = "\033[0;35m"
+    CYAN: str = "\033[0;36m"
+    GRAY: str = "\033[0;37m"
+    WHITE: str = "\033[0;38m"
+    RESET: str = "\033[0m"
+    BRIGHT_BLACK: str = "\033[0;90m"
+    BRIGHT_RED: str = "\033[0;91m"
+    BRIGHT_GREEN: str = "\033[0;92m"
+    BRIGHT_YELLOW: str = "\033[0;93m"
+    BRIGHT_BLUE: str = "\033[0;94m"
+    BRIGHT_MAGENTA: str = "\033[0;95m"
+    BRIGHT_CYAN: str = "\033[0;96m"
+    BRIGHT_WHITE: str = "\033[0;97m"
+    BLACK_BACKGROUND: str = "\033[40m"
+    RED_BACKGROUND: str = "\033[41m"
+    GREEN_BACKGROUND: str = "\033[42m"
+    YELLOW_BACKGROUND: str = "\033[43m"
+    BLUE_BACKGROUND: str = "\033[44m"
+    MAGENTA_BACKGROUND: str = "\033[45m"
+    CYAN_BACKGROUND: str = "\033[46m"
+    WHITE_BACKGROUND: str = "\033[47m"
+
+
+# Mapping log levels to ANSI colors
+LOG_LEVEL_COLORS = {
+    "DEBUG": AnsiColors.BLUE,
+    "INFO": AnsiColors.GREEN,
+    "WARNING": AnsiColors.YELLOW,
+    "ERROR": AnsiColors.RED,
+    "CRITICAL": AnsiColors.RED_BACKGROUND,
+}

django_logging/constants/config_types.py

@@ -0,0 +1,27 @@
+from typing import List, Literal, TypedDict, Union
+
+FormatOption = Union[int, str]
+
+
+class LogEmailNotifierType(TypedDict, total=False):
+    ENABLE: bool
+    NOTIFY_ERROR: bool
+    NOTIFY_CRITICAL: bool
+    LOG_FORMAT: FormatOption
+    USE_TEMPLATE: bool
+
+
+class LogFileFormatsType(TypedDict, total=False):
+    DEBUG: FormatOption
+    INFO: FormatOption
+    WARNING: FormatOption
+    ERROR: FormatOption
+    CRITICAL: FormatOption
+
+
+# Type Aliases for other configurations
+LogLevel = Literal["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"]
+LogDir = str
+LogLevels = List[LogLevel]
+NotifierLogLevels = List[Literal["ERROR", "CRITICAL"]]
+LogDateFormat = str

django_logging/constants/date_format_directives.py

@@ -0,0 +1,22 @@
+from typing import Set
+
+VALID_DIRECTIVES: Set = {
+    "%Y",
+    "%m",
+    "%d",
+    "%H",
+    "%M",
+    "%S",
+    "%a",
+    "%A",
+    "%b",
+    "%B",
+    "%p",
+    "%I",
+    "%j",
+    "%U",
+    "%W",
+    "%c",
+    "%x",
+    "%X",
+}

django_logging/constants/default_settings.py

@@ -0,0 +1,56 @@
+import os
+from dataclasses import dataclass, field
+from typing import cast
+
+from django_logging.constants.config_types import (
+    FormatOption,
+    LogDateFormat,
+    LogDir,
+    LogEmailNotifierType,
+    LogFileFormatsType,
+    LogLevel,
+    LogLevels,
+)
+
+
+@dataclass(frozen=True)
+class DefaultLoggingSettings:
+    log_dir: LogDir = field(default_factory=lambda: os.path.join(os.getcwd(), "logs"))
+    log_levels: LogLevels = field(
+        default_factory=lambda: ["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"]
+    )
+    log_date_format: LogDateFormat = "%Y-%m-%d %H:%M:%S"
+    auto_initialization_enable: bool = True
+    initialization_message_enable: bool = True
+    log_file_formats: LogFileFormatsType = field(
+        default_factory=lambda: cast(
+            LogFileFormatsType,
+            {
+                "DEBUG": 1,
+                "INFO": 1,
+                "WARNING": 1,
+                "ERROR": 1,
+                "CRITICAL": 1,
+            },
+        )
+    )
+
+    log_email_notifier: LogEmailNotifierType = field(
+        default_factory=lambda: cast(
+            LogEmailNotifierType,
+            {
+                "ENABLE": False,
+                "NOTIFY_ERROR": False,
+                "NOTIFY_CRITICAL": False,
+                "LOG_FORMAT": 1,
+                "USE_TEMPLATE": True,
+            },
+        )
+    )
+
+
+@dataclass
+class DefaultConsoleSettings:
+    log_console_level: LogLevel = "DEBUG"
+    log_console_format: FormatOption = 1
+    log_console_colorize: bool = True

django_logging/constants/log_format_options.py

@@ -0,0 +1,15 @@
+FORMAT_OPTIONS = {
+    1: "%(levelname)s | %(asctime)s | %(module)s | %(message)s",
+    2: "%(levelname)s | %(asctime)s | %(message)s",
+    3: "%(levelname)s | %(message)s",
+    4: "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    5: "%(levelname)s | %(message)s | [in %(pathname)s:%(lineno)d]",
+    6: "%(asctime)s | %(levelname)s | %(message)s",
+    7: "%(levelname)s | %(asctime)s | in %(module)s: %(message)s",
+    8: "%(levelname)s | %(message)s | [%(filename)s:%(lineno)d]",
+    9: "[%(asctime)s] | %(levelname)s | in %(module)s: %(message)s",
+    10: "%(asctime)s | %(processName)s | %(name)s | %(levelname)s | %(message)s",
+    11: "%(asctime)s | %(threadName)s | %(name)s | %(levelname)s | %(message)s",
+    12: "%(levelname)s | [%(asctime)s] | (%(filename)s:%(lineno)d) | %(message)s",
+    13: "%(levelname)s | [%(asctime)s] | {%(name)s} | (%(filename)s:%(lineno)d): %(message)s",
+}