Metadata-Version: 2.1
Name: cookies_utilities
Version: 0.0.2
Summary: Utility functions.
Project-URL: GitHub, https://github.com/CookieBox26/cookies_utilities
Project-URL: Documentation, https://cookies-utilities.readthedocs.io/en/stable/
Author-email: CookieBox26 <cookie-box@cookie-box.info>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Cookie's Utilities

Utility functions and classes.

<!-- - [TestPyPI](https://test.pypi.org/project/cookies-utilities/) -->
<!-- - [PyPI](https://pypi.org/project/cookies-utilities/) -->
- [Documentation (released)](https://cookies-utilities.readthedocs.io/en/stable/)
- [Documentation (main branch HEAD)](https://cookies-utilities.readthedocs.io/en/latest/)

---

### Development Guide

Please execute the following at the root of the repository.

#### Test locally

Please run the following commands.

```
pip install -e .  # install the package in editable mode
python -m unittest discover tests -v  # test
```
If an error occurs, you can fix the code and rerun the tests without having to reinstall the package.

#### Update documentation

If you add a new function or class, please update the documentation accordingly.

```
cd docs
vi source/cookies_utilities.rst  # add a new function or class
./make.bat html  # or 'make html' (not on Windows)
# Please open 'docs/build/html/index.html' in your browser and check the content.
cd ..
```

#### Build the distribution archives

Please run the following commands. More details are [here](https://packaging.python.org/en/latest/tutorials/packaging-projects/#generating-distribution-archives).

```
pip install --upgrade build  # upgrade 'build'
python -m build
```

The following files will be generated.

```
./dist/cookies_utilities-0.0.1.tar.gz
./dist/cookies_utilities-0.0.1-py3-none-any.whl
```

#### Upload the distribution archives to TestPyPI (PyPI)

Please run the following commands. More details are [here](https://packaging.python.org/en/latest/tutorials/packaging-projects/#uploading-the-distribution-archives).

```
pip install --upgrade twine
python -m twine upload --repository testpypi dist/*  # TestPyPI
python -m twine upload dist/*  # PyPI
```

