cntimer 0.1.8

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

That's it. Every Python script you run will show this automatically:

────────────────────────────────────────────────────────────
  🕐 Time      1.2 ms        (elapsed: 3.06 s)
  📦 Memory    4 KB          (peak: 197 KB)
────────────────────────────────────────────────────────────

---

How it works

When you pip install cntimer, it 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.

• ✅ Works with VSCode Run button
• ✅ Works in terminal
• ✅ Works on Windows (x86, x64, ARM64), macOS, Linux
• ✅ No imports needed in your code

---

Output explained

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

Time shows pure execution time (perfect for competitive programming).
elapsed shows total wait time including delays.

---

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

Then remove the .pth file:

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

# Windows (run as Administrator)
del "C:\Program Files\Python3xx\Lib\site-packages\cntimer.pth"

---

License

MIT © 2026 tokitahmidtoufa