cntimer 0.1.6

Automatic execution time and memory tracker for Python scripts — works with VSCode, terminal, and every Python runner automatically.

cntimer ⏱

Automatic execution time and memory tracker for Python scripts.

No code changes. No config. Just pip install cntimer — every script you run will automatically show timing and memory at the end, whether you use VSCode, terminal, or any Python runner.

---

Install

pip install cntimer

Then run it once to activate auto-tracking:

cntimer your_script.py

From that point on, every plain python your_script.py will show this automatically:

────────────────────────────────────────────────────────────
  🕐 Time      1.52 s        (cpu: 1.44 s)
  📦 Memory    31.2 MB       (peak: 62.4 MB)
────────────────────────────────────────────────────────────

✅ Works in base Python, virtual environments (venv), conda, and pipx — no extra steps needed.

---

How it works

cntimer places a cntimer.pth file into your Python's site-packages directory. Python automatically reads all .pth files on every startup — which is what makes tracking work with zero code changes.

The first time you run cntimer script.py, it silently installs this hook into the active environment (base Python or venv). After that, every python script.py is tracked automatically.

When you uninstall with pip uninstall cntimer, the .pth hook removes itself automatically on the next Python startup — no orphaned files, no errors.

• ✅ Works with VSCode Run button
• ✅ Works in terminal
• ✅ Works in virtual environments (venv, conda, pipx)
• ✅ Works on Windows (x86, x64, ARM64), macOS, Linux
• ✅ No imports needed in your code
• ✅ Cleans up after itself on uninstall

---

Output explained

Field	Meaning
🕐 Time	Total wall-clock time (how long you waited)
cpu	CPU time — excludes sleep, I/O, network wait
📦 Memory	Memory still in use when script finished
peak	Highest memory used at any point during execution

If Time is much bigger than cpu, your script spent time waiting (file I/O, network, sleep).
If they're close, your script is CPU-bound (pure computation).

---

Manual install (if auto-install failed)

Find your site-packages path:

# Mac / Linux
python3 -c "import site; print(site.getsitepackages()[0])"

# Windows
python -c "import site; print(site.getsitepackages()[0])"

Then copy the file:

macOS

cp cntimer.pth $(python3 -c "import site; print(site.getsitepackages()[0])")/cntimer.pth

Linux

sudo cp cntimer.pth $(python3 -c "import site; print(site.getsitepackages()[0])")/cntimer.pth

Windows 64-bit / ARM64 — run Command Prompt as Administrator

copy cntimer.pth "C:\Program Files\Python3xx\Lib\site-packages\cntimer.pth"

Windows 32-bit — run Command Prompt as Administrator

copy cntimer.pth "C:\Program Files (x86)\Python3xx\Lib\site-packages\cntimer.pth"

Replace 3xx with your Python version (e.g. 312 for Python 3.12).

---

Uninstall

pip uninstall cntimer

The .pth hook removes itself automatically on the next Python startup. No manual cleanup needed.

---

License

MIT © 2026 tokitahmidtoufa