cntimer 0.1.1

Automatic execution time and memory tracker — works with every Python script, no code changes needed.

cntimer ⏱

Automatic execution time and memory tracker for Python scripts.

No code changes. No config. Just install and every script you run will show timing and memory at the end — automatically.

---

Install

pip install cntimer

That's it. From now on, every time you run a Python script (in VSCode, terminal, anywhere), you'll see:

────────────────────────────────────────────
  📄 stress_test.py
────────────────────────────────────────────
  ⏱  Time      3.821s
  📦 Memory    284.50MB
  🔺 Peak      412.18MB
────────────────────────────────────────────

---

How it works

When you pip install cntimer, it automatically places a sitecustomize.py file in your Python's site-packages directory. Python loads this file on every startup, before your script runs — which is what makes the tracking completely automatic.

No imports. No decorators. No wrappers.

---

Uninstall

pip uninstall cntimer

Then remove the hook:

cntimer --uninstall

---

Manual usage (optional)

You can also run it explicitly if you prefer:

cntimer script.py

---

Re-install hook

If you ever need to re-install the hook (e.g. after switching Python versions):

cntimer --install

---

License

MIT