logab 0.0.0__tar.gz

logab-0.0.0/LICENSE

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

logab-0.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include logab *.py

logab-0.0.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: logab
+Version: 0.0.0
+Summary: A lightweight Python package for logging with auto-balance (ab) formatting.
+Author-email: Nam Kha Nguyen <namkha1032@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Nam Kha Nguyen
+        
+        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.
+Project-URL: Homepage, https://github.com/namkha1032/logab
+Project-URL: Repository, https://github.com/namkha1032/logab
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# logab
+A lightweight Python package for better formatting.
+## Install
+```
+pip install logab
+```
+## Usage
+```
+pip install logab
+```
+## Demo
+![Alt Text](demo.gif)

logab-0.0.0/README.md

@@ -0,0 +1,12 @@
+# logab
+A lightweight Python package for better formatting.
+## Install
+```
+pip install logab
+```
+## Usage
+```
+pip install logab
+```
+## Demo
+![Alt Text](demo.gif)

logab-0.0.0/logab/__init__.py

@@ -0,0 +1 @@
+from .log_utils import log_init, log_wrap

logab-0.0.0/logab/log_utils.py

@@ -0,0 +1,167 @@
+import logging
+import os
+import shutil
+import time
+import traceback
+from contextlib import contextmanager
+
+
+def log_init():
+    logger = logging.getLogger(__name__)
+    return logger
+    
+class NKFormatter(logging.Formatter):
+    attr_tup = [('process', 3), ('asctime', 23), ('levelname', 4), ('funcName', 8), ('pathname', 4), ('lineno', 2)]
+    max_lengths = {key:val for key, val in attr_tup}
+    def __init__(self, log_file):
+        self.log_file = log_file
+        super().__init__()
+    def pad(self, string, length, idx):
+        return string.ljust(length) if idx != 4 else string.rjust(length)
+    def rewrite_log(self):
+        bak_path = f"{self.log_file}.bak"
+        with open (bak_path, mode='w', encoding='utf-8') as file_backup:
+            bak_path = file_backup.name
+            with open (self.log_file, 'r', encoding='utf-8') as file_log:
+                for idx, line in enumerate(file_log):
+                    line = line.strip()
+                    if idx == 1:
+                        hor_line = self.draw_horizontal_line()
+                        file_backup.write(f"{hor_line}\n")
+                    else:
+                        attr_list =line.split("|")
+                        newline_arr = []
+                        for attr_idx, attr in enumerate(attr_list[:-1]):
+                            if attr_idx == 4:
+                                lo_li_arr = attr.strip().split(":")
+                                new_li = lo_li_arr[0].rjust(self.max_lengths[self.attr_tup[4][0]])
+                                new_lo = lo_li_arr[1].ljust(self.max_lengths[self.attr_tup[5][0]])
+                                newline_arr.append(f"{new_li}:{new_lo}")
+                            else:
+                                attr = attr.strip()
+                                attr = attr.ljust(self.max_lengths[self.attr_tup[attr_idx][0]] + (1 if idx == 0 and attr_idx == 2 else 0))
+                                newline_arr.append(attr)
+                        newline_arr.append(attr_list[-1].strip())
+                        file_backup.write(f"{' | '.join(newline_arr)}\n")
+                        
+                        
+        try:
+            shutil.copyfile(bak_path, self.log_file)
+            os.remove(bak_path)
+        except Exception as e:
+            pass
+        pass
+    
+    @classmethod
+    def draw_horizontal_line(cls, placement="+"):
+        length = sum(cls.max_lengths.values()) + 3*6 + 7
+        hor_arr = ['-'*(cls.max_lengths[item[0]] + (1 if item[0] == 'levelname' else 0)) for item in cls.attr_tup]
+        hor_arr[4] = hor_arr[4] + hor_arr[5] + '-'
+        hor_arr.pop()
+        hor_arr.append('-'*40)
+        hor_line = f'-{placement}-'.join(hor_arr)
+        return hor_line
+        
+        
+        
+        
+    def format(self, record):
+        rewrite = False
+        abs_path = record.pathname
+        rel_path = os.path.relpath(abs_path, start=os.getcwd())
+        lib_name = "logab"
+        # rel_path = rel_path.replace("/", " / ")
+        record.pathname = rel_path if record.module != "log_utils" else lib_name
+        record.lineno = record.lineno if record.pathname != lib_name else 0
+        
+        # Debug level emoji
+        level_emoji = {
+            "DEBUG": "🟢",
+            "INFO": "🔵",
+            "WARNING": "🟡",
+            "ERROR": "🔴",
+            "CRITICAL": "🟣"
+        }
+        record.levelname = f"{level_emoji[record.levelname]} {record.levelname.lower()}"
+        # Calculating max length
+        for field in self.max_lengths:
+            newlen = len(str(getattr(record, field, ''))) 
+            # + (1 if field == 'levelname' else 0)
+            if self.max_lengths[field] < newlen:
+                rewrite = True
+                self.max_lengths[field] = max(self.max_lengths[field], newlen)
+        if rewrite:
+            self.rewrite_log()
+        
+        self._style._fmt = (
+            f'%(process){self.max_lengths["process"]}d | '
+            f'%(asctime){self.max_lengths["asctime"]}s | '
+            f'%(levelname)-{self.max_lengths["levelname"]}s | '
+            f'%(funcName)-{self.max_lengths["funcName"]}s | '
+            f'%(pathname){self.max_lengths["pathname"]}s:%(lineno)-{self.max_lengths["lineno"]}d | '
+            f'%(message)s'
+        )
+        
+        return super().format(record)
+
+
+def format_seconds(seconds):
+    if seconds <= 0:
+        return "0 seconds"
+    
+    units = [
+        ("day", 86400),    # 24 * 60 * 60
+        ("hour", 3600),    # 60 * 60
+        ("minute", 60),
+        ("second", 1)
+    ]
+    
+    result = []
+    remaining = float(seconds)
+    
+    for unit_name, unit_seconds in units[:-1]:
+        if remaining >= unit_seconds:
+            value = int(remaining // unit_seconds)
+            remaining = remaining % unit_seconds
+            result.append(f"{value} {unit_name}{'s' if value > 1 else ''}")
+    
+    if remaining > 0 or not result: 
+        if remaining.is_integer():
+            result.append(f"{int(remaining)} second{'s' if remaining != 1 else ''}")
+        else:
+            result.append(f"{remaining:.4f} seconds".rstrip('0').rstrip('.'))
+    
+    return " ".join(result)
+
+@contextmanager
+def log_wrap(log_file='./app.log', log_level="notset"):
+    log_level=getattr(logging, log_level.upper(), logging.NOTSET)
+    handler = logging.FileHandler(log_file, mode='a', encoding='utf-8')
+    formatter = NKFormatter(log_file)
+    handler.setFormatter(formatter)
+    root_logger = logging.getLogger()
+    root_logger.setLevel(log_level)
+    root_logger.addHandler(handler)
+    with open (log_file, 'w', encoding='utf-8') as file:
+        newstr = """PID | Time | Level | Function | File:No | Message\n."""
+        file.write(newstr)
+    start_time = time.time()
+    root_logger.info("Program starts...")
+    try:
+        yield
+    except Exception as e:
+        tb = traceback.format_exc()
+        root_logger.error(e)
+        with open(log_file, 'a', encoding='utf-8') as file:
+            hor_line = formatter.draw_horizontal_line(placement='+')
+            file.write(f"{hor_line}\n")
+            file.write(tb)
+            
+        exit()
+    finally:
+        hor_line = formatter.draw_horizontal_line(placement='+')
+        with open(log_file, 'a', encoding='utf-8') as file:
+            file.write(f"{hor_line}\n")
+        end_time = time.time()
+        root_logger.info(f"Execution time {format_seconds(end_time-start_time)}")
+

logab-0.0.0/logab.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: logab
+Version: 0.0.0
+Summary: A lightweight Python package for logging with auto-balance (ab) formatting.
+Author-email: Nam Kha Nguyen <namkha1032@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Nam Kha Nguyen
+        
+        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.
+Project-URL: Homepage, https://github.com/namkha1032/logab
+Project-URL: Repository, https://github.com/namkha1032/logab
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# logab
+A lightweight Python package for better formatting.
+## Install
+```
+pip install logab
+```
+## Usage
+```
+pip install logab
+```
+## Demo
+![Alt Text](demo.gif)

logab-0.0.0/logab.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+logab/__init__.py
+logab/log_utils.py
+logab.egg-info/PKG-INFO
+logab.egg-info/SOURCES.txt
+logab.egg-info/dependency_links.txt
+logab.egg-info/top_level.txt

logab-0.0.0/logab.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

logab-0.0.0/logab.egg-info/top_level.txt

@@ -0,0 +1 @@
+logab

logab-0.0.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "logab" 
+version = "0.0.0"
+description = "A lightweight Python package for logging with auto-balance (ab) formatting."
+readme = "README.md"
+authors = [
+    { name = "Nam Kha Nguyen", email = "namkha1032@gmail.com" }
+]
+license = { file = "LICENSE" }
+requires-python = ">=3.8"
+
+[project.urls]
+Homepage = "https://github.com/namkha1032/logab"
+Repository = "https://github.com/namkha1032/logab"
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["logab"]

logab-0.0.0/setup.cfg

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