dlf4p 1.1.0__py3-none-any.whl

dlf4p/__init__.py

@@ -0,0 +1,23 @@
+"""Dexoron Logging Framework (dlf-py)."""
+
+from .logger import (
+    setup,
+    debug,
+    info,
+    success,
+    warning,
+    error,
+    fatal,
+)
+
+__all__ = [
+    "setup",
+    "debug",
+    "info",
+    "success",
+    "warning",
+    "error",
+    "fatal",
+]
+
+__version__ = "1.1.0"

dlf4p/logger.py

@@ -0,0 +1,73 @@
+from datetime import datetime
+
+red = "\033[31m"
+green = "\033[32m"
+yellow = "\033[33m"
+reset = "\033[0m"
+bold_red = "\033[1;31m"
+
+useTime = True
+useColor = True
+simpleLog = False
+LOG_FILENAME = None
+def logFile(msg):
+    return None
+
+def get_time():
+    return datetime.now().strftime("%H:%M:%S")
+def get_data():
+    return datetime.now().strftime("%d.%m.%Y")
+
+def setup(time=True, color=True, simple=False, file_logging=False):
+    global useTime, useColor, simpleLog, logFile, LOG_FILENAME
+    useTime = time
+    useColor = color
+    simpleLog = simple
+    if file_logging:
+        LOG_FILENAME = f"logger-{get_data()}-{get_time()}.log"
+        def logFile(msg):
+            with open(LOG_FILENAME, "a") as log_handle:
+                log_handle.write(msg + "\n")
+    else:
+        def logFile(msg):
+            return None
+
+def _print(level, prefix, content, color=None):
+    base_msg = ""
+
+    if useTime:
+        base_msg += f"[{get_time()}] "
+
+    if simpleLog or not prefix:
+        base_msg += f"[{level}]"
+    else:
+        base_msg += f"[{prefix}/{level}]"
+
+    base_msg += f": {str(content)}"
+
+    if useColor and color:
+        console_msg = f"{color}{base_msg}{reset}"
+    else:
+        console_msg = base_msg
+
+    print(console_msg)
+    logFile(base_msg)
+
+
+def debug(content, prefix=None):
+    _print("DEBUG", prefix, content)
+
+def info(content, prefix=None):
+    _print("INFO", prefix, content)
+
+def success(content, prefix=None):
+    _print("SUCCESS", prefix, content, green)
+
+def warning(content, prefix=None):
+    _print("WARNING", prefix, content, yellow)
+
+def error(content, prefix=None):
+    _print("ERROR", prefix, content, red)
+
+def fatal(content, prefix=None):
+    _print("FATAL", prefix, content, bold_red)

dlf4p-1.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dexoron (Bezotechestvo Vladimir) [main@dexoron.su]
+
+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.

dlf4p-1.1.0.dist-info/METADATA

@@ -0,0 +1,129 @@
+Metadata-Version: 2.1
+Name: dlf4p
+Version: 1.1.0
+Summary: Dexoron Logging Framework for Python
+Home-page: https://gitlab.com/dexoron/dlf-py
+Author: Dexoron
+Author-email: main@dexoron.su
+License: UNKNOWN
+Project-URL: Homepage, https://dexoron.su
+Project-URL: Repository, https://gitlab.com/dexoron/dlf-py
+Keywords: logging logger dlf dexoron
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# dlf4p — Dexoron Logging Framework for Python
+
+`dlf4p` is a lightweight and convenient logger for Python inspired by **SLF4J**.
+It provides a simple API for logging messages with support for log levels, colored console output, timestamps, and file logging.
+
+The project is being developed as part of the **DLF (Dexoron Logging Framework)** family, with plans for implementations in other programming languages.
+
+---
+
+## Features
+
+* Log levels: `DEBUG`, `INFO`, `SUCCESS`, `WARNING`, `ERROR`, `FATAL`
+* Colored console output
+* Timestamp support
+* Prefix support (e.g., module or component name)
+* File logging
+* Simple configuration via `setup()`
+* Lightweight and with no external dependencies
+
+---
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install dlf4p
+```
+
+---
+
+## Quick Start
+
+```python
+import dlf4p an dlf 
+
+dlf.setup(time=True, color=True, simple=False, file_logging=True)
+
+dlf.info("Application started", "Main")
+dlf.success("Server successfully started", "Server")
+dlf.warning("Slow response", "API")
+dlf.error("Database connection error", "Database")
+dlf.fatal("Critical error", "System")
+```
+
+Example console output:
+
+```
+[12:30:10] [Main/INFO]: Application started
+[12:30:11] [Server/SUCCESS]: Server successfully started
+[12:30:12] [API/WARNING]: Slow response
+[12:30:13] [Database/ERROR]: Database connection error
+[12:30:14] [System/FATAL]: Critical error
+```
+
+> Logs are saved to a file without ANSI color codes.
+
+---
+
+## Configuration
+
+The `setup()` function is used to configure the logger:
+
+```python
+dlf.setup(
+    time=True,        # show timestamp
+    color=True,       # enable colored output
+    simple=False,     # simplified log format (without prefixes)
+    file_logging=True # enable file logging
+)
+```
+
+### Parameters:
+
+* `time` — enable or disable timestamps
+* `color` — enable or disable colors
+* `simple` — disable prefixes
+* `file_logging` — enable writing logs to a file
+
+---
+
+## Philosophy
+
+`dlf4p` is inspired by **SLF4J (Simple Logging Facade for Java)** and aims to:
+
+* provide a simple and unified logging interface
+* remain minimalistic
+* have no external dependencies
+* be easily extensible to other programming languages
+
+---
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for details.
+
+---
+
+## Author
+
+**Dexoron**
+
+GitLab: [https://gitlab.com/dexoron](https://gitlab.com/dexoron)
+GitHub: [https://github.com/dexoron](https://github.com/dexoron)
+Website: [https://dexoron.su](https://dexoron.su)
+
+---
+
+> dlf4p — a simple logger today, a full logging framework tomorrow.
+

dlf4p-1.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+dlf4p/__init__.py,sha256=JL2q1W0LbWP4p2oq8MwabPfoVRHei-qS9hDKgsWVq4M,279
+dlf4p/logger.py,sha256=pAKjruizJiFb76w2nrDGteSNhJb7E_yZw7GqXPt56ug,1732
+dlf4p-1.1.0.dist-info/LICENSE,sha256=oLue9bkNUZzdzvNbFJBY_2VoUU1WymJIL3WcQDwkOdw,1107
+dlf4p-1.1.0.dist-info/METADATA,sha256=hd9ics3l0otVW3eBNPi8zhoImoFwvG830zzazttA5j4,3165
+dlf4p-1.1.0.dist-info/WHEEL,sha256=hPN0AlP2dZM_3ZJZWP4WooepkmU9wzjGgCLCeFjkHLA,92
+dlf4p-1.1.0.dist-info/top_level.txt,sha256=eKKdvmTDaFeM6QvC1FxHhXdRpthceJ2zqPnvk2rMRfg,6
+dlf4p-1.1.0.dist-info/RECORD,,

dlf4p-1.1.0.dist-info/WHEEL

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

dlf4p-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dlf4p