Skip to content

seantis/libres

Repository files navigation

Libres

Libres is a reservations management library to reserve things like tables at a restaurant or tickets at an event. It works with Python 3.8+ and requires Postgresql 9.1+.

Documentation | Source | Bugs

This library is at an experimental stage and not yet suitable for production

Tests Coverage Release

Run the Example

Go to examples/flask and install the requirements:

cd examples/flask
pip install -r requirements.txt

Run the example:

python run.py

Open http://localhost:5000 and click around.

Run the Tests

Install tox and run it:

pip install tox
tox

Limit the tests to a specific python version:

tox -e py27

Conventions

Libres follows PEP8 as close as possible. To test for it run:

tox -e pep8

Libres uses Semantic Versioning

Build the Docs

Go to docs and install the requirements:

cd docs
pip install -r requirements.txt

Build the docs:

make html

Open the docs:

open build/html/index.html

Making a new Release

Make sure all changes are in the HISTORY.rst, then bump the version:

bump2version major|minor|patch
git push && git push --tags

After this, create a new release on Github.