speedopy 0.1.0__tar.gz

speedopy-0.1.0/LICENSE

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

speedopy-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: speedopy
+Version: 0.1.0
+Summary: Zero-dependency performance measurement decorators for Python
+Author-email: AayushtheCoder01 <aayushkumarkumar1234@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AayushtheCoder01/speedopy
+Project-URL: Repository, https://github.com/AayushtheCoder01/speedopy
+Project-URL: Issues, https://github.com/AayushtheCoder01/speedopy/issues
+Keywords: performance,profiling,benchmark,decorator,timing,memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: System :: Benchmark
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# speedopy
+
+Zero-dependency performance measurement decorators for Python.
+
+Just import a decorator, slap it on your function, and instantly see metrics printed to the console. No config, no setup, no external packages.
+
+## Install
+
+```bash
+pip install speedopy
+```
+
+## Decorators
+
+| Decorator | What It Measures |
+|---|---|
+| `cpu_time` | CPU processing time (excludes I/O) |
+| `real_time` | Wall-clock time |
+| `memory_usage` | Peak memory allocated (auto-formats B/KB/MB) |
+| `thread_time` | CPU time for the current thread only |
+| `call_count` | Number of times a function has been called |
+| `function_profile` | Full cProfile report (top 10 calls) |
+| `io_time` | I/O wait time (real - cpu) |
+| `gc_stats` | Garbage collections triggered |
+| `object_count` | Net new Python objects created |
+
+## Usage
+
+```python
+from speedopy import cpu_time, memory_usage, io_time
+
+@cpu_time
+@memory_usage
+@io_time
+def process_data():
+    data = [i ** 2 for i in range(1_000_000)]
+    return sum(data)
+
+process_data()
+```
+
+Output:
+```
+[io_time] process_data -> real: 0.182345s, cpu: 0.171875s, io_wait: 0.010470s
+[memory_usage] process_data -> current: 472 B, peak: 8.06 MB
+[cpu_time] process_data -> 0.183291s
+```
+
+## Stack Multiple Decorators
+
+```python
+from speedopy import cpu_time, memory_usage, call_count
+
+@call_count
+@cpu_time
+@memory_usage
+def my_func():
+    return sum(range(500_000))
+
+my_func()  # [call_count] my_func -> called 1 time(s)
+my_func()  # [call_count] my_func -> called 2 time(s)
+```
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## License
+
+MIT

speedopy-0.1.0/README.md

@@ -0,0 +1,71 @@
+# speedopy
+
+Zero-dependency performance measurement decorators for Python.
+
+Just import a decorator, slap it on your function, and instantly see metrics printed to the console. No config, no setup, no external packages.
+
+## Install
+
+```bash
+pip install speedopy
+```
+
+## Decorators
+
+| Decorator | What It Measures |
+|---|---|
+| `cpu_time` | CPU processing time (excludes I/O) |
+| `real_time` | Wall-clock time |
+| `memory_usage` | Peak memory allocated (auto-formats B/KB/MB) |
+| `thread_time` | CPU time for the current thread only |
+| `call_count` | Number of times a function has been called |
+| `function_profile` | Full cProfile report (top 10 calls) |
+| `io_time` | I/O wait time (real - cpu) |
+| `gc_stats` | Garbage collections triggered |
+| `object_count` | Net new Python objects created |
+
+## Usage
+
+```python
+from speedopy import cpu_time, memory_usage, io_time
+
+@cpu_time
+@memory_usage
+@io_time
+def process_data():
+    data = [i ** 2 for i in range(1_000_000)]
+    return sum(data)
+
+process_data()
+```
+
+Output:
+```
+[io_time] process_data -> real: 0.182345s, cpu: 0.171875s, io_wait: 0.010470s
+[memory_usage] process_data -> current: 472 B, peak: 8.06 MB
+[cpu_time] process_data -> 0.183291s
+```
+
+## Stack Multiple Decorators
+
+```python
+from speedopy import cpu_time, memory_usage, call_count
+
+@call_count
+@cpu_time
+@memory_usage
+def my_func():
+    return sum(range(500_000))
+
+my_func()  # [call_count] my_func -> called 1 time(s)
+my_func()  # [call_count] my_func -> called 2 time(s)
+```
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## License
+
+MIT

speedopy-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "speedopy"
+version = "0.1.0"
+description = "Zero-dependency performance measurement decorators for Python"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "AayushtheCoder01", email = "aayushkumarkumar1234@gmail.com"},
+]
+keywords = ["performance", "profiling", "benchmark", "decorator", "timing", "memory"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Topic :: System :: Benchmark",
+]
+
+[project.urls]
+Homepage = "https://github.com/AayushtheCoder01/speedopy"
+Repository = "https://github.com/AayushtheCoder01/speedopy"
+Issues = "https://github.com/AayushtheCoder01/speedopy/issues"
+
+[tool.setuptools.packages.find]
+include = ["speedopy*"]

speedopy-0.1.0/setup.cfg

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

speedopy-0.1.0/speedopy/__init__.py

@@ -0,0 +1,36 @@
+"""
+speedopy — A collection of zero-dependency performance measurement decorators.
+
+Usage:
+    from speedopy import cpu_time, real_time, memory_usage
+
+    @cpu_time
+    def my_function():
+        ...
+"""
+
+__version__ = "0.1.0"
+
+from .decorators import (
+    cpu_time,
+    real_time,
+    memory_usage,
+    thread_time,
+    call_count,
+    function_profile,
+    io_time,
+    gc_stats,
+    object_count,
+)
+
+__all__ = [
+    "cpu_time",
+    "real_time",
+    "memory_usage",
+    "thread_time",
+    "call_count",
+    "function_profile",
+    "io_time",
+    "gc_stats",
+    "object_count",
+]

speedopy-0.1.0/speedopy/decorators.py

@@ -0,0 +1,200 @@
+import time
+import tracemalloc
+import cProfile
+import pstats
+import io
+import gc
+from functools import wraps
+
+
+# ─────────────────────────────────────────────
+# 1. CPU Time
+# ─────────────────────────────────────────────
+def cpu_time(func):
+    """Measures CPU processing time (excludes I/O wait, sleep, etc.)."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        start = time.process_time_ns()
+        result = func(*args, **kwargs)
+        elapsed_ns = time.process_time_ns() - start
+        elapsed = elapsed_ns / 1_000_000_000
+        print(f"[cpu_time] {func.__name__} -> {elapsed:.6f}s")
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 2. Real (Wall-Clock) Time
+# ─────────────────────────────────────────────
+def real_time(func):
+    """Measures wall-clock (real) time including I/O, sleep, etc."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        start = time.perf_counter()
+        result = func(*args, **kwargs)
+        elapsed = time.perf_counter() - start
+        print(f"[real_time] {func.__name__} -> {elapsed:.6f}s")
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 3. Memory Usage
+# ─────────────────────────────────────────────
+def memory_usage(func):
+    """Measures peak memory allocated during function execution."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        tracemalloc.start()
+        result = func(*args, **kwargs)
+        current, peak = tracemalloc.get_traced_memory()
+        tracemalloc.stop()
+
+        # Auto-format to the most readable unit
+        if peak < 1024:
+            peak_str = f"{peak} B"
+        elif peak < 1024 ** 2:
+            peak_str = f"{peak / 1024:.2f} KB"
+        else:
+            peak_str = f"{peak / (1024 ** 2):.2f} MB"
+
+        if current < 1024:
+            curr_str = f"{current} B"
+        elif current < 1024 ** 2:
+            curr_str = f"{current / 1024:.2f} KB"
+        else:
+            curr_str = f"{current / (1024 ** 2):.2f} MB"
+
+        print(f"[memory_usage] {func.__name__} -> current: {curr_str}, peak: {peak_str}")
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 4. Thread Time
+# ─────────────────────────────────────────────
+def thread_time(func):
+    """Measures CPU time consumed by the current thread only."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        start = time.thread_time_ns()
+        result = func(*args, **kwargs)
+        elapsed_ns = time.thread_time_ns() - start
+        elapsed = elapsed_ns / 1_000_000_000
+        print(f"[thread_time] {func.__name__} -> {elapsed:.6f}s")
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 5. Call Count
+# ─────────────────────────────────────────────
+def call_count(func):
+    """Tracks and displays how many times a function has been called."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        wrapper.calls += 1
+        result = func(*args, **kwargs)
+        print(f"[call_count] {func.__name__} -> called {wrapper.calls} time(s)")
+        return result
+    wrapper.calls = 0
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 6. Function Profile (cProfile)
+# ─────────────────────────────────────────────
+def function_profile(func):
+    """Runs cProfile on the function and prints a profiling summary."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        profiler = cProfile.Profile()
+        profiler.enable()
+        result = func(*args, **kwargs)
+        profiler.disable()
+
+        stream = io.StringIO()
+        stats = pstats.Stats(profiler, stream=stream)
+        stats.strip_dirs()
+        stats.sort_stats("cumulative")
+        stats.print_stats(10)  # top 10 entries
+
+        print(f"[function_profile] {func.__name__}:")
+        print(stream.getvalue())
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 7. I/O Time (real − cpu = approximate I/O wait)
+# ─────────────────────────────────────────────
+def io_time(func):
+    """Estimates I/O wait time by computing real_time − cpu_time."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        real_start = time.perf_counter()
+        cpu_start = time.process_time()
+        result = func(*args, **kwargs)
+        real_elapsed = time.perf_counter() - real_start
+        cpu_elapsed = time.process_time() - cpu_start
+        io_elapsed = max(real_elapsed - cpu_elapsed, 0.0)
+        print(
+            f"[io_time] {func.__name__} -> "
+            f"real: {real_elapsed:.6f}s, "
+            f"cpu: {cpu_elapsed:.6f}s, "
+            f"io_wait: {io_elapsed:.6f}s"
+        )
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 8. GC Stats
+# ─────────────────────────────────────────────
+def gc_stats(func):
+    """Reports garbage collection activity during function execution."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        gc.collect()  # clean slate
+        gc.disable()  # temporarily disable auto-GC to measure manually
+        stats_before = gc.get_stats()  # per-generation stats
+
+        gc.enable()
+        result = func(*args, **kwargs)
+        collected = gc.collect()  # force a collection and count
+
+        stats_after = gc.get_stats()
+        collections = sum(
+            stats_after[i]["collections"] - stats_before[i]["collections"]
+            for i in range(len(stats_after))
+        )
+
+        print(
+            f"[gc_stats] {func.__name__} -> "
+            f"collected: {collected} objects, "
+            f"gc runs: {collections}"
+        )
+        return result
+    return wrapper
+
+
+# ─────────────────────────────────────────────
+# 9. Object Count
+# ─────────────────────────────────────────────
+def object_count(func):
+    """Tracks the net number of new Python objects created by the function."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        gc.collect()
+        before = len(gc.get_objects())
+        result = func(*args, **kwargs)
+        gc.collect()
+        after = len(gc.get_objects())
+        net_new = after - before
+        print(
+            f"[object_count] {func.__name__} -> "
+            f"before: {before}, after: {after}, "
+            f"net new: {net_new:+d}"
+        )
+        return result
+    return wrapper

speedopy-0.1.0/speedopy.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: speedopy
+Version: 0.1.0
+Summary: Zero-dependency performance measurement decorators for Python
+Author-email: AayushtheCoder01 <aayushkumarkumar1234@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AayushtheCoder01/speedopy
+Project-URL: Repository, https://github.com/AayushtheCoder01/speedopy
+Project-URL: Issues, https://github.com/AayushtheCoder01/speedopy/issues
+Keywords: performance,profiling,benchmark,decorator,timing,memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: System :: Benchmark
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# speedopy
+
+Zero-dependency performance measurement decorators for Python.
+
+Just import a decorator, slap it on your function, and instantly see metrics printed to the console. No config, no setup, no external packages.
+
+## Install
+
+```bash
+pip install speedopy
+```
+
+## Decorators
+
+| Decorator | What It Measures |
+|---|---|
+| `cpu_time` | CPU processing time (excludes I/O) |
+| `real_time` | Wall-clock time |
+| `memory_usage` | Peak memory allocated (auto-formats B/KB/MB) |
+| `thread_time` | CPU time for the current thread only |
+| `call_count` | Number of times a function has been called |
+| `function_profile` | Full cProfile report (top 10 calls) |
+| `io_time` | I/O wait time (real - cpu) |
+| `gc_stats` | Garbage collections triggered |
+| `object_count` | Net new Python objects created |
+
+## Usage
+
+```python
+from speedopy import cpu_time, memory_usage, io_time
+
+@cpu_time
+@memory_usage
+@io_time
+def process_data():
+    data = [i ** 2 for i in range(1_000_000)]
+    return sum(data)
+
+process_data()
+```
+
+Output:
+```
+[io_time] process_data -> real: 0.182345s, cpu: 0.171875s, io_wait: 0.010470s
+[memory_usage] process_data -> current: 472 B, peak: 8.06 MB
+[cpu_time] process_data -> 0.183291s
+```
+
+## Stack Multiple Decorators
+
+```python
+from speedopy import cpu_time, memory_usage, call_count
+
+@call_count
+@cpu_time
+@memory_usage
+def my_func():
+    return sum(range(500_000))
+
+my_func()  # [call_count] my_func -> called 1 time(s)
+my_func()  # [call_count] my_func -> called 2 time(s)
+```
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## License
+
+MIT

speedopy-0.1.0/speedopy.egg-info/SOURCES.txt

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

speedopy-0.1.0/speedopy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

speedopy-0.1.0/speedopy.egg-info/top_level.txt

@@ -0,0 +1 @@
+speedopy