Metadata-Version: 2.4
Name: cntimer
Version: 0.1.1
Summary: Automatic execution time and memory tracker — works with every Python script, no code changes needed.
Author: cntimer
License: MIT
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: requires-python

# 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

```bash
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

```bash
pip uninstall cntimer
```

Then remove the hook:

```bash
cntimer --uninstall
```

---

## Manual usage (optional)

You can also run it explicitly if you prefer:

```bash
cntimer script.py
```

---

## Re-install hook

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

```bash
cntimer --install
```

---

## License

MIT
