performance-decorator 0.1.0__tar.gz

performance_decorator-0.1.0/.idea/.gitignore

@@ -0,0 +1,10 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Ignored default folder with query files
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

performance_decorator-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

performance_decorator-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/performance-decorator.iml" filepath="$PROJECT_DIR$/.idea/performance-decorator.iml" />
+    </modules>
+  </component>
+</project>

performance_decorator-0.1.0/.idea/performance-decorator.iml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module external.system.id="pyproject.toml" type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src" />
+    </content>
+    <orderEntry type="jdk" jdkName="/usr/local/bin/python3" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="PackageRequirementsSettings" />
+  <component name="PyDocumentationSettings" />
+  <component name="ReSTService" />
+  <component name="TestRunnerService" />
+</module>

performance_decorator-0.1.0/.idea/workspace.xml

@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="ALL" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="a9c99927-fb94-4f3f-8e4b-995b99955790" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 8,
+  "fromUser": false
+}]]></component>
+  <component name="ProjectId" id="3JjLVvuwa1hUIO8ATBa2u3hImgU" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "codeWithMe.voiceChat.enabledByDefault": "false",
+    "copilot.chat.legacySessionMetadata.migrated": "true",
+    "last_opened_file_path": "/Users/leonardobartolelli/Desktop/Projects/Performance Decorator Library",
+    "python.packages.toolwindow.project.migrated.to.right.top.v2": "true"
+  }
+}]]></component>
+  <component name="RunManager">
+    <configuration default="true" type="PythonConfigurationType" factoryName="Python">
+      <module name="performance-decorator" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="" />
+      <option name="IS_MODULE_SDK" value="false" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="RUN_TOOL" value="" />
+      <option name="SCRIPT_NAME" value="" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="main" type="PythonConfigurationType" factoryName="Python" nameIsGenerated="true">
+      <module name="performance-decorator" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="false" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="RUN_TOOL" value="" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-python-sdk-eff1e8def5f5-5bd6d13a2a75-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-262.10315.174" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="a9c99927-fb94-4f3f-8e4b-995b99955790" name="Changes" comment="" />
+      <created>1790169557781</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1790169557781</updated>
+      <workItem from="1790169558793" duration="326000" />
+    </task>
+    <servers />
+  </component>
+</project>

performance_decorator-0.1.0/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.

performance_decorator-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,35 @@
+# 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/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "performance-decorator"
+version = "0.1.0"
+description = "A small decorator that measures and reports function execution time."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name = "Leonardo Bartolelli" },
+]
+keywords = ["decorator", "performance", "timing"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.8",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/performance-decorator/"
+Repository = "https://github.com/leonardobartolelli/performance-decorator"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/performance"]

performance_decorator-0.1.0/src/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/tests/test_performance.py

@@ -0,0 +1,27 @@
+from performance import performance
+
+
+def test_performance_preserves_result_and_records_duration(capsys):
+    @performance
+    def add(left, right):
+        return left + right
+
+    assert add(2, 3) == 5
+    assert add.last_duration is not None
+    assert add.last_duration >= 0
+    assert len(add.execution_times) == 1
+    assert "add took " in capsys.readouterr().out
+
+
+def test_performance_records_duration_when_function_raises():
+    @performance
+    def fail():
+        raise ValueError("failed")
+
+    try:
+        fail()
+    except ValueError:
+        pass
+
+    assert fail.last_duration is not None
+    assert len(fail.execution_times) == 1