performance-decorator 0.1.0__py3-none-any.whl

performance/__init__.py

@@ -0,0 +1,37 @@
+"""Measure and report function execution time."""
+
+from __future__ import annotations
+
+from functools import wraps
+from time import perf_counter
+from typing import Any, Callable, TypeVar, cast
+
+F = TypeVar("F", bound=Callable[..., Any])
+
+
+def performance(function: F) -> F:
+    """Decorate a function to print and expose its execution time.
+
+    The wrapped function keeps its original return value. Its most recent
+    execution time, in seconds, is available as ``function.last_duration``.
+    A history of all completed calls is available as
+    ``function.execution_times``.
+    """
+
+    @wraps(function)
+    def timed(*args: Any, **kwargs: Any) -> Any:
+        start = perf_counter()
+        try:
+            return function(*args, **kwargs)
+        finally:
+            duration = perf_counter() - start
+            timed.last_duration = duration  # type: ignore[attr-defined]
+            timed.execution_times.append(duration)  # type: ignore[attr-defined]
+            print(f"{function.__name__} took {duration:.6f} seconds")
+
+    timed.last_duration = None  # type: ignore[attr-defined]
+    timed.execution_times = []  # type: ignore[attr-defined]
+    return cast(F, timed)
+
+
+__all__ = ["performance"]

performance_decorator-0.1.0.dist-info/METADATA

@@ -0,0 +1,55 @@
+Metadata-Version: 2.5
+Name: performance-decorator
+Version: 0.1.0
+Summary: A small decorator that measures and reports function execution time.
+Project-URL: Homepage, https://pypi.org/project/performance-decorator/
+Project-URL: Repository, https://github.com/leonardobartolelli/performance-decorator
+Author: Leonardo Bartolelli
+License: MIT
+License-File: LICENSE
+Keywords: decorator,performance,timing
+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 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# performance-decorator
+
+Measure function execution time with a simple decorator.
+
+## Installation
+
+```bash
+pip install performance-decorator
+```
+
+## Usage
+
+```python
+from performance import performance
+
+
+@performance
+def calculate():
+    return sum(range(100_000))
+
+
+result = calculate()
+print(result)
+print(calculate.last_duration)  # elapsed time in seconds
+print(calculate.execution_times)  # duration of every completed call
+```
+
+Each call prints a line such as:
+
+```text
+calculate took 0.002341 seconds
+```
+
+The wrapped function's return value and metadata are preserved. Timing is
+recorded even when the wrapped function raises an exception.

performance_decorator-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+performance/__init__.py,sha256=l_3WA7_1qOArSj-LNwaY3tTE__fi4QAvAAPVKmJabhs,1211
+performance_decorator-0.1.0.dist-info/METADATA,sha256=57dyXzDKcXUPTMG1na3H7pzE6aF0K8IbFvjh_AAFxZg,1480
+performance_decorator-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+performance_decorator-0.1.0.dist-info/licenses/LICENSE,sha256=m9cK8EamhvVjlrznqxp8g3sAOLYJc8tcT5UOioXJK68,1076
+performance_decorator-0.1.0.dist-info/RECORD,,

performance_decorator-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

performance_decorator-0.1.0.dist-info/licenses/LICENSE

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