SLinfra 0.1.2__py3-none-any.whl

infra/__init__.py

@@ -0,0 +1,5 @@
+__version__ = "0.1.2"
+AUTHOR = "MJBM2510"
+
+from infra.state_tracker import StateTracker, Status
+from infra.file_logger import FileLogger

infra/file_logger.py

@@ -0,0 +1,64 @@
+import os
+from datetime import datetime
+
+
+class FileLogger:
+
+    LEVELS = {"DEBUG": 10, "INFO": 20, "WARNING": 30, "ERROR": 40}
+
+    def __init__(self, log_dir="logs", log_file="app.log", level="INFO"):
+        self.level = self.LEVELS.get(level, 20)
+        self.log_dir = log_dir
+        self.log_path = os.path.join(log_dir, log_file)
+
+        self._prepare_environment()
+        self.file = open(self.log_path, "a", encoding="utf-8")
+
+    def _prepare_environment(self):
+        os.makedirs(self.log_dir, exist_ok=True)
+
+        if not os.path.exists(self.log_path):
+            with open(self.log_path, "w", encoding="utf-8") as file:
+                file.write(f"=== Log started at {self._timestamp()} ===\n")
+
+    def _timestamp(self):
+        return datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+    def _write(self, level, message):
+        if self.LEVELS[level] < self.level:
+            return
+
+        line = f"[{self._timestamp()}] [{level}] | {message}"
+        self.file.write(line + "\n")
+        self.file.flush()
+
+    def info(self, message):
+        self._write("INFO", message)
+
+    def warning(self, message):
+        self._write("WARNING", message)
+
+    def error(self, message):
+        self._write("ERROR", message)
+
+    def debug(self, message):
+        self._write("DEBUG", message)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+
+    def close(self):
+        if not self.file.closed:
+            self.file.close()
+
+
+# test
+if __name__ == "__main__":
+    with FileLogger(level="DEBUG") as logger:
+        logger.debug("Debug message")
+        logger.info("Info message")
+        logger.warning("Warning message")
+        logger.error("Error message")

infra/state_tracker.py

@@ -0,0 +1,85 @@
+import os
+import json
+from datetime import datetime
+import threading
+from enum import Enum
+
+
+class Status(Enum):
+    PENDING = "pending"
+    DOWNLOADING = "downloading"
+    DONE = "done"
+    ERROR = "error"
+
+
+class StateTracker:
+
+    def __init__(self, state_file="state.json"):
+        self._lock = threading.RLock()
+        self.state_file = state_file
+        self.state = {}
+        self._load()
+
+    def _load(self):
+        with self._lock:
+            if os.path.exists(self.state_file):
+                try:
+                    with open(self.state_file, "r", encoding="utf-8") as file:
+                        self.state = json.load(file)
+                except Exception:
+                    self.state = {}
+            else:
+                self.state = {}
+
+    def _timestamp(self):
+        return datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+    def save(self):
+        tmp_file = self.state_file + ".tmp"
+
+        with self._lock:
+            with open(tmp_file, "w", encoding="utf-8") as file:
+                json.dump(self.state, file, ensure_ascii=False, indent=4)
+
+            os.replace(tmp_file, self.state_file)
+
+    def set(self, item_id, status, **meta):
+        with self._lock:
+            self.state[item_id] = {
+                "status": status,
+                "updated_at": self._timestamp(),
+                "meta": meta,
+            }
+
+            self.save()
+
+    def get(self, item_id, default=None):
+        with self._lock:
+            return self.state.get(item_id, default)
+
+    def filter_by_status(self, status):
+        with self._lock:
+            return {
+                key: value
+                for key, value in self.state.items()
+                if value.get("status") == status
+            }
+
+    def remove(self, item_id):
+        with self._lock:
+            if item_id in self.state:
+                del self.state[item_id]
+                self.save()
+
+    def exists(self, item_id):
+        with self._lock:
+            return item_id in self.state
+
+    def clear(self):
+        with self._lock:
+            self.state = {}
+            self.save()
+
+    def all(self):
+        with self._lock:
+            return dict(self.state)

slinfra-0.1.2.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: SLinfra
+Version: 0.1.2
+Summary: A lightweight Python utility for file-based logging and persistent state tracking.
+Author-email: MJBM <mohamnarut@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MJBM2510/infra
+Project-URL: Source, https://github.com/MJBM2510/infra
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# infra
+
+A lightweight Python utility for file-based logging and persistent state tracking.
+
+## Overview
+
+- infra is a minimal Python package designed to help small to medium projects:
+- Keep clean and readable logs
+- Persist application state between runs
+- Avoid heavy logging frameworks
+- It is especially useful for scripts, automation tools, and long-running processes.
+
+---
+
+## Features
+
+- Simple file-based logger
+- Persistent state storage (JSON-based)
+- Zero external dependencies
+- Easy to integrate into existing projects
+
+---
+
+## Installation
+
+```bash
+pip install infra
+```
+
+---
+
+## Quick Start
+
+### File Logging
+```python
+from infra.file_logger import FileLogger
+
+logger = FileLogger("app.log")
+
+logger.info("Application started")
+logger.warning("Low memory warning")
+logger.error("Unexpected error occurred")
+```
+
+This will create (or append to) a log file and store timestamped log messages.
+
+### State Tracking
+```python
+from infra.state_tracker import StateTracker
+
+state = StateTracker("state.json")
+
+state["last_run"] = "2026-01-23T14:00"
+state["counter"] = 5
+state.save()
+```
+
+This allows your application to persist important values between executions.
+
+---
+
+## Project Structure
+
+```
+infra/
+├── infra/
+│   ├── __init__.py
+│   ├── file_logger.py
+│   └── state_tracker.py
+├── README.md
+├── LICENSE
+└── pyproject.toml
+```
+
+---
+
+## Design Goals
+
+- Keep the API small and intuitive
+- Prefer simplicity over feature overload
+- Avoid external dependencies
+- Be suitable for educational and practical use
+
+---
+
+## Limitations
+
+- Not thread-safe
+- No log rotation support
+- Designed for small to medium workloads
+
+---
+
+## Roadmap / TODO
+
+- Add unit tests
+- Add log rotation support
+- Improve type hints and documentation
+
+## License
+
+This project is licensed under the MIT License.

slinfra-0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+infra/__init__.py,sha256=36ctFNvJaQXOS93abRTM9JTqpkXBqcuOgxCTYE6xYTM,137
+infra/file_logger.py,sha256=YF9f3CcBcSrn5hmL1zTnHtW0iei2bZcagJ-2qxltyZI,1749
+infra/state_tracker.py,sha256=xZuFWUebWGvwjLY3jUYZ2aEUOVim9LKYq6gFwPugDxA,2184
+slinfra-0.1.2.dist-info/licenses/LICENSE,sha256=oUx8d4ZH7tKK_srnI53jyuKwURFKe22Vd8LhzP4ECP0,1065
+slinfra-0.1.2.dist-info/METADATA,sha256=9o2eSayb8p-o3qqoesqY_5B-A9bfV5QRByIk5k67K-s,2545
+slinfra-0.1.2.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+slinfra-0.1.2.dist-info/top_level.txt,sha256=oUj4TteZGKCvGrRn61_VMWOw-XGJCHm3_ZqbfNLhSE0,6
+slinfra-0.1.2.dist-info/RECORD,,

slinfra-0.1.2.dist-info/WHEEL

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

slinfra-0.1.2.dist-info/licenses/LICENSE

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

slinfra-0.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+infra