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
