epicure-utils 0.0.1

A common utils Python library. Don't write that one little function again!

Latest Version	Downloads	Tests

epicure

epicure | ˈɛpɪkjʊə, ˈɛpɪkjɔː |

noun

a person who takes particular pleasure in fine food and drink.

What?

epicure is a collection of useful python methods and utils I tend to use in my personal projects.

Why?

I like to keep my projects as clean as possible, and I don't like to add dependencies unless strictly necessary. I usually end up writing the same little utils over and over again, so I decided to create a centralized place where I can keep them.

Installation

Plug & Play:

# Install via pipx
pipx install epicure-utils

# Install via pip
pip install epicure-utils

Install for development:

Clone the repository:

git clone https://github.com/dvitto/epicure.git
cd epicure

Install the dependencies and the package:

make install

# or manually:

python -m venv venv
source venv/bin/activate
pip install -e .

System Requirements

Before using epicure, ensure you have the following installed:

• Python >= 3.10

Usage

Once installed you can import the package and use the methods as you would with any other python package.

Simple example:

from epicure.output import colored_print

colored_print("Hello, World!", fg_color="magenta", bg_color="black")

# this will print a "Hello, World!" in your terminal
# foreground color will be magenta and background color will be black (if supported by your terminal)

To see an interactive example of all the things available, run the following command:

python -m demo.demo

Features

• Simple and useful methods for everyday use.
• The package is organized in modules, so you can import only the methods you need.
• Customizable output with colored print.
• Input validation for the classic "yes/no" questions.
• Simple and Mulit-choice questions.
• Interactive multi-choice questions using curses (works on Linux and macOS).
• And more to come...

Known Issues

multi_choice_question_interactive does not work on Windows by default. You need to install the windows-curses package to use it on Windows.

Acknowledgments

• Python community, for the amazing libraries and tools they provide.

Contributing

Contributions are welcome!

If you have a feature request, bug report, or a pull request, please open an issue or submit a PR.

License

epicure is released under GNU GENERAL PUBLIC LICENSE Version 3.