d4rklogger 0.1.0__tar.gz

d4rklogger-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: d4rklogger
+Version: 0.1.0
+Summary: Simple timezone-aware logging helpers with rotating file output.
+Author: D4rk-TG
+Keywords: logging,logger,timezone
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: colors
+Requires-Dist: colorama>=0.4.6; extra == "colors"
+
+# d4rklogger
+
+Lightweight timezone-aware logger setup with:
+
+- rotating daily log files
+- optional colored console output
+- configurable timezone offset through `TIME_ZONE`
+
+## Install
+
+```bash
+pip install d4rklogger
+```
+
+Optional color support:
+
+```bash
+pip install ".[colors]"
+```
+
+## Usage
+
+```python
+from log import setup_logger
+
+log = setup_logger("app")
+log.info("hello")
+```
+
+Set the timezone offset with an environment variable such as `TIME_ZONE=05:30` or `TIME_ZONE=-04:00`.

d4rklogger-0.1.0/README.md

@@ -0,0 +1,30 @@
+# d4rklogger
+
+Lightweight timezone-aware logger setup with:
+
+- rotating daily log files
+- optional colored console output
+- configurable timezone offset through `TIME_ZONE`
+
+## Install
+
+```bash
+pip install d4rklogger
+```
+
+Optional color support:
+
+```bash
+pip install ".[colors]"
+```
+
+## Usage
+
+```python
+from log import setup_logger
+
+log = setup_logger("app")
+log.info("hello")
+```
+
+Set the timezone offset with an environment variable such as `TIME_ZONE=05:30` or `TIME_ZONE=-04:00`.

d4rklogger-0.1.0/d4rklogger.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: d4rklogger
+Version: 0.1.0
+Summary: Simple timezone-aware logging helpers with rotating file output.
+Author: D4rk-TG
+Keywords: logging,logger,timezone
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: colors
+Requires-Dist: colorama>=0.4.6; extra == "colors"
+
+# d4rklogger
+
+Lightweight timezone-aware logger setup with:
+
+- rotating daily log files
+- optional colored console output
+- configurable timezone offset through `TIME_ZONE`
+
+## Install
+
+```bash
+pip install d4rklogger
+```
+
+Optional color support:
+
+```bash
+pip install ".[colors]"
+```
+
+## Usage
+
+```python
+from log import setup_logger
+
+log = setup_logger("app")
+log.info("hello")
+```
+
+Set the timezone offset with an environment variable such as `TIME_ZONE=05:30` or `TIME_ZONE=-04:00`.

d4rklogger-0.1.0/d4rklogger.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+d4rklogger.egg-info/PKG-INFO
+d4rklogger.egg-info/SOURCES.txt
+d4rklogger.egg-info/dependency_links.txt
+d4rklogger.egg-info/requires.txt
+d4rklogger.egg-info/top_level.txt
+log/__init__.py
+log/_logger.py
+logger/__init__.py
+logger/_logger.py

d4rklogger-0.1.0/d4rklogger.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

d4rklogger-0.1.0/d4rklogger.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[colors]
+colorama>=0.4.6

d4rklogger-0.1.0/d4rklogger.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+log
+logger
+logs

d4rklogger-0.1.0/log/__init__.py

@@ -0,0 +1,8 @@
+from ._logger import TZ, TimeZoneFormatter, get_timezone_offset, setup_logger
+
+__all__ = [
+    "TZ",
+    "TimeZoneFormatter",
+    "get_timezone_offset",
+    "setup_logger",
+]

d4rklogger-0.1.0/log/_logger.py

@@ -0,0 +1,111 @@
+import logging
+import os
+import sys
+
+from datetime import datetime, timedelta, timezone
+from logging.handlers import TimedRotatingFileHandler
+
+try:
+    import colorama
+
+    colorama.init(strip=False, autoreset=True)
+    COLORAMA_AVAILABLE = True
+except ImportError:
+    COLORAMA_AVAILABLE = False
+
+
+def get_timezone_offset(time_zone: str = "00:00") -> timezone:
+    if time_zone:
+        try:
+            hours, minutes = time_zone.split(":")
+            if hours.startswith("-"):
+                return timezone(timedelta(hours=-int(hours), minutes=-int(minutes)))
+            return timezone(timedelta(hours=int(hours), minutes=int(minutes)))
+        except ValueError as exc:
+            raise ValueError(f"Invalid TIME_ZONE format: {time_zone}") from exc
+    return timezone(timedelta(hours=0))
+
+
+TZ = get_timezone_offset(os.getenv("TIME_ZONE", "05:30"))
+
+
+class TimeZoneFormatter(logging.Formatter):
+    def __init__(self, fmt, datefmt=None, use_colors=False):
+        super().__init__(fmt, datefmt)
+        self.use_colors = use_colors
+        self.COLORS = {
+            "TIME": "\033[93m",
+            "NAME": "\033[36m",
+            "FUNC": "\033[34m",
+            "LEVEL": {
+                logging.DEBUG: "\033[37m",
+                logging.INFO: "\033[32m",
+                logging.WARNING: "\033[33m",
+                logging.ERROR: "\033[31m",
+                logging.CRITICAL: "\033[41m",
+            },
+        }
+        self.RESET = "\033[0m"
+
+    def formatTime(self, record, datefmt=None):
+        dt = datetime.fromtimestamp(record.created, tz=timezone.utc)
+        time_zone_time = dt.astimezone(TZ)
+        if datefmt:
+            return time_zone_time.strftime(datefmt)
+        return time_zone_time.strftime("%Y-%m-%d %H:%M:%S %z")
+
+    def format(self, record):
+        if not self.use_colors:
+            return super().format(record)
+
+        time_str = f"{self.COLORS['TIME']}{self.formatTime(record, self.datefmt)}{self.RESET}"
+        name_str = f"{self.COLORS['NAME']}{record.name}{self.RESET}"
+        func_str = f"{self.COLORS['FUNC']}{record.funcName}:{record.lineno}{self.RESET}"
+        level_color = self.COLORS["LEVEL"].get(record.levelno, "")
+        level_str = f"{level_color}{record.levelname}{self.RESET}"
+        msg_str = f"{level_color}{record.getMessage()}{self.RESET}"
+
+        return f"{time_str} - {name_str} - {func_str} - {level_str} - {msg_str}"
+
+
+def setup_logger(name=__name__, log_level=logging.INFO):
+    log_dir = "logs"
+    if not os.path.exists(log_dir):
+        os.makedirs(log_dir)
+
+    logger = logging.getLogger(name)
+    logger.setLevel(log_level)
+
+    if logger.handlers:
+        return logger
+
+    time_zone_now = datetime.now(TZ)
+
+    file_handler = TimedRotatingFileHandler(
+        filename=os.path.join(log_dir, f"log-{time_zone_now.strftime('%Y-%m-%d')}.txt"),
+        when="midnight",
+        interval=1,
+        backupCount=30,
+    )
+    file_handler.setLevel(log_level)
+
+    console_handler = logging.StreamHandler()
+    console_handler.setLevel(log_level)
+    use_colors = sys.stdout.isatty() and COLORAMA_AVAILABLE
+    plain_formatter = TimeZoneFormatter(
+        "%(asctime)s - %(name)s - %(funcName)s:%(lineno)d - %(levelname)s - %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+        use_colors=False,
+    )
+    formatter = TimeZoneFormatter(
+        "%(asctime)s - %(name)s - %(funcName)s:%(lineno)d - %(levelname)s - %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+        use_colors=use_colors,
+    )
+
+    file_handler.setFormatter(plain_formatter)
+    console_handler.setFormatter(formatter)
+    logger.addHandler(file_handler)
+    logger.addHandler(console_handler)
+    logger.propagate = False
+    return logger

d4rklogger-0.1.0/logger/__init__.py

@@ -0,0 +1,8 @@
+from log import TZ, TimeZoneFormatter, get_timezone_offset, setup_logger
+
+__all__ = [
+    "TZ",
+    "TimeZoneFormatter",
+    "get_timezone_offset",
+    "setup_logger",
+]

d4rklogger-0.1.0/logger/_logger.py

@@ -0,0 +1,8 @@
+from log._logger import TZ, TimeZoneFormatter, get_timezone_offset, setup_logger
+
+__all__ = [
+    "TZ",
+    "TimeZoneFormatter",
+    "get_timezone_offset",
+    "setup_logger",
+]

d4rklogger-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "d4rklogger"
+version = "0.1.0"
+description = "Simple timezone-aware logging helpers with rotating file output."
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+  { name = "D4rk-TG" }
+]
+keywords = ["logging", "logger", "timezone"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+  "Topic :: System :: Logging"
+]
+
+[project.optional-dependencies]
+colors = ["colorama>=0.4.6"]
+
+[tool.setuptools]
+include-package-data = false
+
+[tool.setuptools.packages.find]
+include = ["log*", "logger*"]

d4rklogger-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+