akashic-perflogger 0.1.2__tar.gz

akashic_perflogger-0.1.2/LICENSE

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

akashic_perflogger-0.1.2/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: akashic-perflogger
+Version: 0.1.2
+Summary: Python performance logging library
+Author-email: Akasha Mouginot <akasha.mouginot@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ewigael/perflogger
+Project-URL: Changelog, https://github.com/ewigael/perflogger/blob/main/docs/CHANGELOG.md
+Project-URL: Issues, https://github.com/ewigael/perflogger/issues
+Project-URL: Readme,  https://github.com/ewigael/perflogger/blob/main/README.md
+Keywords: performance,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# perflogger
+
+A performance tracking package for Python devs
+
+## Quick start
+
+##### Use pip
+
+_Pypi package coming soon_
+
+##### Build from sources
+
+```bash
+# Download sources
+git clone https://github.com/ewigael/perflogger
+# Move to sources directory
+cd perflogger
+# Install from sources with pip
+pip install .
+```
+
+## Coming soon:
+
+- ```PerfCounter``` class, to count how many times something happens
+- Writing data to files
+- ```PerfAnalyzer```, a co-project to vizualise and compare recorded data

akashic_perflogger-0.1.2/README.md

@@ -0,0 +1,26 @@
+# perflogger
+
+A performance tracking package for Python devs
+
+## Quick start
+
+##### Use pip
+
+_Pypi package coming soon_
+
+##### Build from sources
+
+```bash
+# Download sources
+git clone https://github.com/ewigael/perflogger
+# Move to sources directory
+cd perflogger
+# Install from sources with pip
+pip install .
+```
+
+## Coming soon:
+
+- ```PerfCounter``` class, to count how many times something happens
+- Writing data to files
+- ```PerfAnalyzer```, a co-project to vizualise and compare recorded data

akashic_perflogger-0.1.2/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "akashic-perflogger"
+version = "0.1.2"
+description = "Python performance logging library"
+authors = [
+    { name = "Akasha Mouginot", email = "akasha.mouginot@protonmail.com" }
+]
+requires-python = ">=3.14"
+readme = "README.md"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+keywords = ["performance", "testing"]
+
+[project.urls]
+Homepage = "https://github.com/ewigael/perflogger"
+Changelog = "https://github.com/ewigael/perflogger/blob/main/docs/CHANGELOG.md"
+Issues = "https://github.com/ewigael/perflogger/issues"
+Readme = " https://github.com/ewigael/perflogger/blob/main/README.md"
+
+[build-system]
+requires = ["setuptools>=80"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

akashic_perflogger-0.1.2/setup.cfg

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

akashic_perflogger-0.1.2/src/akashic_perflogger.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: akashic-perflogger
+Version: 0.1.2
+Summary: Python performance logging library
+Author-email: Akasha Mouginot <akasha.mouginot@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ewigael/perflogger
+Project-URL: Changelog, https://github.com/ewigael/perflogger/blob/main/docs/CHANGELOG.md
+Project-URL: Issues, https://github.com/ewigael/perflogger/issues
+Project-URL: Readme,  https://github.com/ewigael/perflogger/blob/main/README.md
+Keywords: performance,testing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# perflogger
+
+A performance tracking package for Python devs
+
+## Quick start
+
+##### Use pip
+
+_Pypi package coming soon_
+
+##### Build from sources
+
+```bash
+# Download sources
+git clone https://github.com/ewigael/perflogger
+# Move to sources directory
+cd perflogger
+# Install from sources with pip
+pip install .
+```
+
+## Coming soon:
+
+- ```PerfCounter``` class, to count how many times something happens
+- Writing data to files
+- ```PerfAnalyzer```, a co-project to vizualise and compare recorded data

akashic_perflogger-0.1.2/src/akashic_perflogger.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+src/akashic_perflogger.egg-info/PKG-INFO
+src/akashic_perflogger.egg-info/SOURCES.txt
+src/akashic_perflogger.egg-info/dependency_links.txt
+src/akashic_perflogger.egg-info/top_level.txt
+src/perflogger/__init__.py
+src/perflogger/perflogger.py

akashic_perflogger-0.1.2/src/akashic_perflogger.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

akashic_perflogger-0.1.2/src/akashic_perflogger.egg-info/top_level.txt

@@ -0,0 +1 @@
+perflogger

akashic_perflogger-0.1.2/src/perflogger/__init__.py

@@ -0,0 +1,24 @@
+from importlib.metadata import metadata
+
+_metadata = metadata("perflogger")
+
+__package_name__ = _metadata["Name"]
+__version__ = _metadata["Version"]
+__authors__ = _metadata.get_all("Author-email")
+__description__ = _metadata.get("Summary", "")
+
+__urls__ = dict(item.split(", ") for item in _metadata.get_all("Project-URL"))
+
+
+def print_metadata():
+    print(
+        f"{__project_name__} {__version__}\n"
+        f"{__description__}\n"
+        f"Authored by: {__authors__}\n"
+        f"Repository: {__urls__["Repository"]}\n"
+        f"Changelog: {__urls__["Changelog"]}\n"
+        f"Issues: {__urls__["Issues"]}",
+    )
+
+
+from .perflogger import PerfLogger

akashic_perflogger-0.1.2/src/perflogger/perflogger.py

@@ -0,0 +1,125 @@
+import inspect
+import time
+import weakref
+
+
+class PerfLogger:
+
+    _instances = []
+
+    def __init__(self, name=None, tick_func=time.perf_counter, avgs_step=1):
+
+        PerfLogger._instances.append(weakref.ref(self))
+
+        self.name = (
+            name if name is not None else inspect.currentframe().f_back.f_code.co_name
+        )
+        self.tick = tick_func
+        self.avgs_step = avgs_step
+
+        self.tags = []
+        self.tags_data = {}
+        self.avgs = {}
+        self._avgs_counter = None
+
+    @classmethod
+    def get_all_instances(cls):
+        """Return a list of all instances of current class in creation order"""
+        cls._instances[:] = [ref for ref in cls._instances if ref() is not None]
+        return [ref() for ref in cls._instances]
+
+    def start(self):
+        """Clear the tags table and init a start tag"""
+        self.clear()
+        self.tags = [("start", self.tick())]
+
+    def clear(self):
+        """Clear the tags table"""
+        self.tags.clear()
+
+    def add(self, tag_name):
+        """Add a new tag in the tags table as the delta between now and last tag;
+        append that delta to the tags_data table to later compute averages"""
+        now = self.tick()
+        self.tags_data.setdefault(tag_name, []).append(now - self.tags[-1][1])
+        self.tags.append((tag_name, now))
+
+    def _set_averages(self):
+        """Compute averages from stored data"""
+        self.avgs.clear()
+        for name, data in self.tags_data.items():
+            self.avgs[name] = sum(data) / len(data)
+
+    def get_deltas(self):
+        """Return deltas stored in the tags table both in a human readable format and true float"""
+
+        # Black/PEP8 does us dirty here so here's the same code in a more leggible format
+        # return [
+        #     (
+        #         name,
+        #              f"{vs[-1]:.2f}s" if vs[-1] >= 1
+        #         else f"{vs[-1] * 1e3:.2f}ms" if vs[-1] >= 1e-3
+        #         else f"{vs[-1] * 1e6:.2f}μs" if vs[-1] >= 1e-6
+        #         else f"{vs[-1] * 1e9:.2f}ns",
+        #         vs[-1]
+        #     ) for name, vs in self.tags_data.items()
+        # ]
+
+        return [
+            (
+                name,
+                (
+                    f"{vs[-1]:.2f}s"
+                    if vs[-1] >= 1
+                    else (
+                        f"{vs[-1] * 1e3:.2f}ms"
+                        if vs[-1] >= 1e-3
+                        else (
+                            f"{vs[-1] * 1e6:.2f}μs"
+                            if vs[-1] >= 1e-6
+                            else f"{vs[-1] * 1e9:.2f}ns"
+                        )
+                    )
+                ),
+                vs[-1],
+            )
+            for name, vs in self.tags_data.items()
+        ]
+
+    def get_averages(self):
+        if self._avgs_counter is None:
+            self._avgs_counter = self.tick()
+
+        if self.tick() - self._avgs_counter >= self.avgs_step:
+            self._set_averages()
+            self.tags_data.clear()
+            self._avgs_counter = self.tick()
+
+        # Black/PEP8 does us dirty here so here's the same return value in more legible code
+        # return [
+        #     (
+        #         name,
+        #              f"{vs:.2f}s" if vs >= 1
+        #         else f"{vs * 1e3:.2f}ms" if vs >= 1e-3
+        #         else f"{vs * 1e6:.2f}μs" if vs >= 1e-6
+        #         else f"{vs * 1e9:.2f}ns",
+        #         vs
+        #     ) for name, vs in self.avgs.items()
+        # ]
+
+        return [
+            (
+                name,
+                (
+                    f"{vs:.2f}s"
+                    if vs >= 1
+                    else (
+                        f"{vs * 1e3:.2f}ms"
+                        if vs >= 1e-3
+                        else f"{vs * 1e6:.2f}μs" if vs >= 1e-6 else f"{vs * 1e9:.2f}ns"
+                    )
+                ),
+                vs,
+            )
+            for name, vs in self.avgs.items()
+        ]