tm-utilities 0.1.0__tar.gz

tm_utilities-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: tm-utilities
+Version: 0.1.0
+Summary: TM Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# TM-Utilities
+
+A lightweight Python logging utility that provides:
+
+* Automatic daily log file creation
+* Monthly log folder organization
+* IST (Indian Standard Time) timestamps
+* Console and file logging simultaneously
+* Simple section separators for cleaner logs
+* Minimal configuration
+
+## Features
+
+✅ Automatic log directory creation
+
+✅ Monthly log organization
+
+✅ Daily log rotation by filename
+
+✅ IST timezone support
+
+✅ Console + file logging
+
+✅ Configurable log levels
+
+✅ Section separators for structured logging
+
+---
+
+## Installation
+
+```bash
+pip install tm-utilities
+```
+
+---
+
+## Quick Start
+
+```python
+from tm_logger import logger
+
+logger.info("Application started")
+logger.warning("This is a warning")
+logger.error("Something went wrong")
+```
+
+### Output
+
+```text
+2026-06-08 14:35:12,451 - INFO - app - main - Application started
+2026-06-08 14:35:12,452 - WARNING - app - main - This is a warning
+2026-06-08 14:35:12,453 - ERROR - app - main - Something went wrong
+```
+
+---
+
+## Custom Logger Configuration
+
+You can create a logger with a custom log directory and log level.
+
+```python
+from tm_logger import setup_logger
+
+logger = setup_logger(
+    log_dir="custom_logs",
+    debug=True
+)
+
+logger.info("Custom logger initialized")
+```
+
+### Parameters
+
+| Parameter | Type            | Description                                                  |
+| --------- | --------------- | ------------------------------------------------------------ |
+| `log_dir` | `str` or `Path` | Directory where logs will be stored                          |
+| `debug`   | `bool`          | Enables DEBUG logging when `True`, INFO logging when `False` |
+
+---
+
+## Log Directory Structure
+
+Logs are automatically organized by month and date.
+
+```text
+logs/
+└── Jun_2026/
+    └── 08-06-2026.log
+```
+
+A new monthly folder is created automatically, and each day receives its own log file.
+
+---
+
+## Default Configuration
+
+The package ships with the following defaults:
+
+```python
+DEBUG = True
+LOG_DIR = Path.cwd() / "logs"
+```
+
+Meaning:
+
+* Logs are stored inside a `logs/` folder in the current working directory.
+* Debug logging is enabled by default.
+
+---
+
+## IST Timezone Support
+
+All timestamps are generated in **Indian Standard Time (IST)**:
+
+```text
+UTC +05:30
+```
+
+This is useful for applications deployed primarily in India without requiring additional timezone configuration.
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Author
+
+TM Utilities
+
+Built for simple, structured Python logging with minimal setup.

tm_utilities-0.1.0/README.md

@@ -0,0 +1,134 @@
+# TM-Utilities
+
+A lightweight Python logging utility that provides:
+
+* Automatic daily log file creation
+* Monthly log folder organization
+* IST (Indian Standard Time) timestamps
+* Console and file logging simultaneously
+* Simple section separators for cleaner logs
+* Minimal configuration
+
+## Features
+
+✅ Automatic log directory creation
+
+✅ Monthly log organization
+
+✅ Daily log rotation by filename
+
+✅ IST timezone support
+
+✅ Console + file logging
+
+✅ Configurable log levels
+
+✅ Section separators for structured logging
+
+---
+
+## Installation
+
+```bash
+pip install tm-utilities
+```
+
+---
+
+## Quick Start
+
+```python
+from tm_logger import logger
+
+logger.info("Application started")
+logger.warning("This is a warning")
+logger.error("Something went wrong")
+```
+
+### Output
+
+```text
+2026-06-08 14:35:12,451 - INFO - app - main - Application started
+2026-06-08 14:35:12,452 - WARNING - app - main - This is a warning
+2026-06-08 14:35:12,453 - ERROR - app - main - Something went wrong
+```
+
+---
+
+## Custom Logger Configuration
+
+You can create a logger with a custom log directory and log level.
+
+```python
+from tm_logger import setup_logger
+
+logger = setup_logger(
+    log_dir="custom_logs",
+    debug=True
+)
+
+logger.info("Custom logger initialized")
+```
+
+### Parameters
+
+| Parameter | Type            | Description                                                  |
+| --------- | --------------- | ------------------------------------------------------------ |
+| `log_dir` | `str` or `Path` | Directory where logs will be stored                          |
+| `debug`   | `bool`          | Enables DEBUG logging when `True`, INFO logging when `False` |
+
+---
+
+## Log Directory Structure
+
+Logs are automatically organized by month and date.
+
+```text
+logs/
+└── Jun_2026/
+    └── 08-06-2026.log
+```
+
+A new monthly folder is created automatically, and each day receives its own log file.
+
+---
+
+## Default Configuration
+
+The package ships with the following defaults:
+
+```python
+DEBUG = True
+LOG_DIR = Path.cwd() / "logs"
+```
+
+Meaning:
+
+* Logs are stored inside a `logs/` folder in the current working directory.
+* Debug logging is enabled by default.
+
+---
+
+## IST Timezone Support
+
+All timestamps are generated in **Indian Standard Time (IST)**:
+
+```text
+UTC +05:30
+```
+
+This is useful for applications deployed primarily in India without requiring additional timezone configuration.
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Author
+
+TM Utilities
+
+Built for simple, structured Python logging with minimal setup.

tm_utilities-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tm-utilities"
+version = "0.1.0"
+description = "TM Utilities"
+readme = "README.md"
+requires-python = ">=3.10"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

tm_utilities-0.1.0/setup.cfg

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

tm_utilities-0.1.0/src/tm_logger/__init__.py

@@ -0,0 +1,3 @@
+from .logger import logger
+
+__all__ = ["logger"]

tm_utilities-0.1.0/src/tm_logger/logger.py

@@ -0,0 +1,76 @@
+import logging
+from pathlib import Path
+from datetime import datetime, timedelta, timezone
+
+
+# Default settings
+DEBUG = True
+LOG_DIR = Path.cwd() / "logs"
+
+
+# Function to create IST timezone
+def ist_time(*args):
+    ist = timezone(timedelta(hours=5, minutes=30))
+    return datetime.now(ist).timetuple()
+
+
+def log_separator(section_name=None, char="*", line_length=50, spacer_lines=2):
+    blank_line = " "
+    separator_line = char * line_length
+
+    for _ in range(spacer_lines):
+        logger.info(blank_line)
+
+    logger.info(separator_line)
+
+    if section_name:
+        logger.info(f"{section_name.center(line_length)}")
+        logger.info(separator_line)
+
+    for _ in range(spacer_lines):
+        logger.info(blank_line)
+
+
+def setup_logger(log_dir=None, debug=None):
+
+    log_dir = Path(log_dir) if log_dir else LOG_DIR
+    debug = DEBUG if debug is None else debug
+
+    # Create logs directory
+    log_dir.mkdir(parents=True, exist_ok=True)
+
+    # Create monthly folder
+    month_folder = datetime.now().strftime("%b_%Y")
+    month_path = log_dir / month_folder
+    month_path.mkdir(parents=True, exist_ok=True)
+
+    # Daily log file
+    log_file = month_path / f"{datetime.now().strftime('%d-%m-%Y')}.log"
+
+    log_level = logging.DEBUG if debug else logging.INFO
+
+    logger = logging.getLogger("tm_logs")
+    logger.setLevel(log_level)
+
+    # Prevent duplicate handlers
+    if not logger.handlers:
+
+        file_handler = logging.FileHandler(log_file, mode="a")
+        console_handler = logging.StreamHandler()
+
+        formatter = logging.Formatter(
+            "%(asctime)s - %(levelname)s - %(module)s - %(funcName)s - %(message)s"
+        )
+        formatter.converter = ist_time
+
+        file_handler.setFormatter(formatter)
+        console_handler.setFormatter(formatter)
+
+        logger.addHandler(file_handler)
+        logger.addHandler(console_handler)
+
+    return logger
+
+
+# Default logger
+logger = setup_logger()

tm_utilities-0.1.0/src/tm_utilities.egg-info/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: tm-utilities
+Version: 0.1.0
+Summary: TM Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# TM-Utilities
+
+A lightweight Python logging utility that provides:
+
+* Automatic daily log file creation
+* Monthly log folder organization
+* IST (Indian Standard Time) timestamps
+* Console and file logging simultaneously
+* Simple section separators for cleaner logs
+* Minimal configuration
+
+## Features
+
+✅ Automatic log directory creation
+
+✅ Monthly log organization
+
+✅ Daily log rotation by filename
+
+✅ IST timezone support
+
+✅ Console + file logging
+
+✅ Configurable log levels
+
+✅ Section separators for structured logging
+
+---
+
+## Installation
+
+```bash
+pip install tm-utilities
+```
+
+---
+
+## Quick Start
+
+```python
+from tm_logger import logger
+
+logger.info("Application started")
+logger.warning("This is a warning")
+logger.error("Something went wrong")
+```
+
+### Output
+
+```text
+2026-06-08 14:35:12,451 - INFO - app - main - Application started
+2026-06-08 14:35:12,452 - WARNING - app - main - This is a warning
+2026-06-08 14:35:12,453 - ERROR - app - main - Something went wrong
+```
+
+---
+
+## Custom Logger Configuration
+
+You can create a logger with a custom log directory and log level.
+
+```python
+from tm_logger import setup_logger
+
+logger = setup_logger(
+    log_dir="custom_logs",
+    debug=True
+)
+
+logger.info("Custom logger initialized")
+```
+
+### Parameters
+
+| Parameter | Type            | Description                                                  |
+| --------- | --------------- | ------------------------------------------------------------ |
+| `log_dir` | `str` or `Path` | Directory where logs will be stored                          |
+| `debug`   | `bool`          | Enables DEBUG logging when `True`, INFO logging when `False` |
+
+---
+
+## Log Directory Structure
+
+Logs are automatically organized by month and date.
+
+```text
+logs/
+└── Jun_2026/
+    └── 08-06-2026.log
+```
+
+A new monthly folder is created automatically, and each day receives its own log file.
+
+---
+
+## Default Configuration
+
+The package ships with the following defaults:
+
+```python
+DEBUG = True
+LOG_DIR = Path.cwd() / "logs"
+```
+
+Meaning:
+
+* Logs are stored inside a `logs/` folder in the current working directory.
+* Debug logging is enabled by default.
+
+---
+
+## IST Timezone Support
+
+All timestamps are generated in **Indian Standard Time (IST)**:
+
+```text
+UTC +05:30
+```
+
+This is useful for applications deployed primarily in India without requiring additional timezone configuration.
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Author
+
+TM Utilities
+
+Built for simple, structured Python logging with minimal setup.

tm_utilities-0.1.0/src/tm_utilities.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/tm_logger/__init__.py
+src/tm_logger/logger.py
+src/tm_utilities.egg-info/PKG-INFO
+src/tm_utilities.egg-info/SOURCES.txt
+src/tm_utilities.egg-info/dependency_links.txt
+src/tm_utilities.egg-info/top_level.txt
+tests/test_logger.py

tm_utilities-0.1.0/src/tm_utilities.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tm_utilities-0.1.0/src/tm_utilities.egg-info/top_level.txt

@@ -0,0 +1 @@
+tm_logger

tm_utilities-0.1.0/tests/test_logger.py

@@ -0,0 +1,5 @@
+from tm_logger.logger import setup_logger
+
+def test_logger_creation():
+    logger = setup_logger()
+    assert logger is not None