cntimer 0.1.0__tar.gz

cntimer-0.1.0/LICENSE

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

cntimer-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: cntimer
+Version: 0.1.0
+Summary: Run Python scripts and see execution time + memory usage in your terminal
+Author: Tokit Ahmid Toufa
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/cntimer
+Project-URL: Bug Tracker, https://github.com/yourusername/cntimer/issues
+Keywords: timer,memory,performance,terminal,runner,stats,profiler,cli
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cntimer ⏱️
+
+Run any Python script and instantly see **execution time + memory usage** in your terminal.
+
+```bash
+pip install cntimer
+```
+
+## Usage
+
+```bash
+cntimer myscript.py
+```
+
+Output:
+```
+hello world
+
+────────────────────────────────────────────────────────────
+  🕐 Time      21.4 ms       (cpu: 20.9 ms)
+  📦 Memory    96 KB         (peak: 19.0 MB)
+────────────────────────────────────────────────────────────
+```
+
+Pass arguments to your script too:
+
+```bash
+cntimer myscript.py arg1 arg2
+```
+
+## What the stats mean
+
+| Stat | Meaning |
+|------|---------|
+| **Time** | Total real-world clock time |
+| **cpu** | Actual CPU processing time (excludes I/O wait) |
+| **Memory** | Memory in use when the script finished |
+| **peak** | Maximum memory used during the entire run |
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies — uses only the standard library ✅
+
+## License
+
+MIT

cntimer-0.1.0/README.md

@@ -0,0 +1,47 @@
+# cntimer ⏱️
+
+Run any Python script and instantly see **execution time + memory usage** in your terminal.
+
+```bash
+pip install cntimer
+```
+
+## Usage
+
+```bash
+cntimer myscript.py
+```
+
+Output:
+```
+hello world
+
+────────────────────────────────────────────────────────────
+  🕐 Time      21.4 ms       (cpu: 20.9 ms)
+  📦 Memory    96 KB         (peak: 19.0 MB)
+────────────────────────────────────────────────────────────
+```
+
+Pass arguments to your script too:
+
+```bash
+cntimer myscript.py arg1 arg2
+```
+
+## What the stats mean
+
+| Stat | Meaning |
+|------|---------|
+| **Time** | Total real-world clock time |
+| **cpu** | Actual CPU processing time (excludes I/O wait) |
+| **Memory** | Memory in use when the script finished |
+| **peak** | Maximum memory used during the entire run |
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies — uses only the standard library ✅
+
+## License
+
+MIT

cntimer-0.1.0/cntimer/__init__.py

@@ -0,0 +1,7 @@
+"""
+cntimer — Run Python scripts and see execution time + memory usage.
+"""
+
+__version__ = "0.1.0"
+
+from .runner import run

cntimer-0.1.0/cntimer/runner.py

@@ -0,0 +1,96 @@
+import subprocess
+import sys
+import time
+import os
+
+
+def _format_time(seconds: float) -> str:
+    if seconds < 1:
+        return f"{seconds * 1000:.1f} ms"
+    return f"{seconds:.3f} s"
+
+
+def _format_memory(bytes_val: int) -> str:
+    if bytes_val < 1024:
+        return f"{bytes_val} B"
+    elif bytes_val < 1024 * 1024:
+        return f"{bytes_val / 1024:.1f} KB"
+    else:
+        return f"{bytes_val / (1024 * 1024):.1f} MB"
+
+
+def _print_stats(wall_time: float, cpu_time: float, mem_current: int, mem_peak: int) -> None:
+    sep = "─" * 60
+    time_str = _format_time(wall_time)
+    cpu_str  = _format_time(cpu_time)
+    mem_str  = _format_memory(mem_current)
+    peak_str = _format_memory(mem_peak)
+
+    RESET  = "\033[0m"
+    YELLOW = "\033[93m"
+    BLUE   = "\033[94m"
+    DIM    = "\033[2m"
+
+    print(f"\n{DIM}{sep}{RESET}")
+    print(f"  {BLUE}🕐 Time    {RESET}{YELLOW}{time_str:<12}{RESET}  {DIM}(cpu: {cpu_str}){RESET}")
+    print(f"  {BLUE}📦 Memory  {RESET}{YELLOW}{mem_str:<12}{RESET}  {DIM}(peak: {peak_str}){RESET}")
+    print(f"{DIM}{sep}{RESET}\n")
+
+
+def run() -> None:
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        prog="cntimer",
+        description="Run a Python script and display execution time + memory usage."
+    )
+    parser.add_argument("script", help="Path to the Python script to run")
+    parser.add_argument("args", nargs=argparse.REMAINDER, help="Arguments to pass to the script")
+    args = parser.parse_args()
+
+    script = args.script
+    script_args = args.args
+
+    if not os.path.exists(script):
+        print(f"❌  File not found: {script}", file=sys.stderr)
+        sys.exit(1)
+
+    wrapper = (
+        "import tracemalloc, runpy, sys\n"
+        "tracemalloc.start()\n"
+        "try:\n"
+        "    runpy.run_path(sys.argv[1], run_name='__main__')\n"
+        "except SystemExit:\n"
+        "    pass\n"
+        "current, peak = tracemalloc.get_traced_memory()\n"
+        "tracemalloc.stop()\n"
+        "with open('/tmp/_cntimer_mem.txt', 'w') as f:\n"
+        "    f.write(f'{current},{peak}')\n"
+    )
+
+    start_wall = time.perf_counter()
+    start_cpu  = time.process_time()
+
+    result = subprocess.run(
+        [sys.executable, "-c", wrapper, script] + script_args,
+        text=True
+    )
+
+    end_wall = time.perf_counter()
+    end_cpu  = time.process_time()
+
+    wall_time = end_wall - start_wall
+    cpu_time  = end_cpu  - start_cpu
+
+    mem_current, mem_peak = 0, 0
+    try:
+        with open("/tmp/_cntimer_mem.txt", "r") as f:
+            parts = f.read().strip().split(",")
+            mem_current = int(parts[0])
+            mem_peak    = int(parts[1])
+        os.remove("/tmp/_cntimer_mem.txt")
+    except Exception:
+        pass
+
+    _print_stats(wall_time, cpu_time, mem_current, mem_peak)
+    sys.exit(result.returncode)

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

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: cntimer
+Version: 0.1.0
+Summary: Run Python scripts and see execution time + memory usage in your terminal
+Author: Tokit Ahmid Toufa
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/cntimer
+Project-URL: Bug Tracker, https://github.com/yourusername/cntimer/issues
+Keywords: timer,memory,performance,terminal,runner,stats,profiler,cli
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cntimer ⏱️
+
+Run any Python script and instantly see **execution time + memory usage** in your terminal.
+
+```bash
+pip install cntimer
+```
+
+## Usage
+
+```bash
+cntimer myscript.py
+```
+
+Output:
+```
+hello world
+
+────────────────────────────────────────────────────────────
+  🕐 Time      21.4 ms       (cpu: 20.9 ms)
+  📦 Memory    96 KB         (peak: 19.0 MB)
+────────────────────────────────────────────────────────────
+```
+
+Pass arguments to your script too:
+
+```bash
+cntimer myscript.py arg1 arg2
+```
+
+## What the stats mean
+
+| Stat | Meaning |
+|------|---------|
+| **Time** | Total real-world clock time |
+| **cpu** | Actual CPU processing time (excludes I/O wait) |
+| **Memory** | Memory in use when the script finished |
+| **peak** | Maximum memory used during the entire run |
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies — uses only the standard library ✅
+
+## License
+
+MIT

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

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+cntimer/__init__.py
+cntimer/runner.py
+cntimer.egg-info/PKG-INFO
+cntimer.egg-info/SOURCES.txt
+cntimer.egg-info/dependency_links.txt
+cntimer.egg-info/entry_points.txt
+cntimer.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

cntimer-0.1.0/cntimer.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cntimer = cntimer.runner:run

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

@@ -0,0 +1 @@
+cntimer

cntimer-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cntimer"
+version = "0.1.0"
+description = "Run Python scripts and see execution time + memory usage in your terminal"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Tokit Ahmid Toufa" }
+]
+keywords = ["timer", "memory", "performance", "terminal", "runner", "stats", "profiler", "cli"]
+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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+    "Environment :: Console",
+]
+requires-python = ">=3.8"
+dependencies = []
+
+[project.scripts]
+cntimer = "cntimer.runner:run"
+
+[project.urls]
+Homepage = "https://github.com/yourusername/cntimer"
+"Bug Tracker" = "https://github.com/yourusername/cntimer/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["cntimer*"]

cntimer-0.1.0/setup.cfg

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