🐍 PyEssential

A growing collection of Python utilities and decorators to simplify common development tasks.

✨ Features

PyEssential aims to be the go-to library for small, reusable tools that you often find yourself writing from scratch.

• Performance: Includes the ready-to-use @timeit decorator for simple function benchmarking.
• Command line: Check your installed version with pyessential --version.
• Code Clarity: Utility functions for common tasks like string manipulation (e.g., casing). (Coming soon!)
• Scalability: Structured for easy addition of new utility groups (e.g., networking, file_io, validation).

🚀 Installation

Requires Python 3.9+

pip install pyessential

To upgrade to the latest release:

pip install --upgrade pyessential

📖 Usage

@timeit

from pyessential.decorators import timeit

@timeit
def slow_function():
    sum(range(1_000_000))

slow_function()

Command line

pyessential --version
python -m pyessential --version   # also works

🛠️ Development

git clone https://github.com/Abhi39054/PyEssential.git
cd PyEssential
pip install -e .
pytest

Releasing

1. Bump the version in pyessential/_version.py.
2. Commit and push to main with pypi release in the commit message:

   git commit -am "chore: bump to 0.1.3 - pypi release"
   git push origin main

3. The CI workflow runs tests, builds the package, publishes to TestPyPI, then waits for approval before publishing to PyPI.

The package version lives in one place: pyessential/_version.py.

🤝 Contributing

Contributions are welcome. See CONTRIBUTING.md.

📄 License

Released under the MIT License.