Python CLI for the library of Roubaix (Médiathèque Roubaix)

---

Releases: https://github.com/tomsquest/mediathequeroubaix.py/releases

Source Code: https://github.com/tomsquest/mediathequeroubaix.py

PyPI: https://pypi.org/project/mediathequeroubaix/

---

Table of Contents

• Features
  • Display your loans
  • Renew your loans
• Usage
  • Running
  • Create an initial, sample configuration
  • Display the current configuration
  • List the loans
  • Renew the loans
• Why I am doing this
• Changelog
• Development
  • Releasing
• Credits

Features

MédiathèqueRoubaix.py is a client for the libray of Roubaix, mediathequederoubaix.fr.

Display your loans

Running mediathequeroubaix loans list will:

1. Get the list of your loans and their due date
2. ...for many cardholders
3. and check the next return date for each of your card

Renew your loans

Running mediathequeroubaix loans renew will:

1. Renew automatically all loans
2. ...for many cardholders
3. and print the new due date of the loans

Usage

Running

With Pipx:

pipx run mediathequederoubaix

With UV:

uvx mediathequederoubaix

If you want to install it globally:

pipx install mediathequeroubaix

Create an initial, sample configuration

config create makes a sample configuration in $HOME/.config/mediathequederoubaix/config.json and display the content of the file.
The configuration is initialized with a sample but fake user.

mediathequeroubaix config create

Display the current configuration

config show displays the current configuration.

mediathequeroubaix config show

List the loans

loans list show the list of loans for the users.

mediathequeroubaix loans list

Renew the loans

loans renew renew the list of loans for the users and display the new loans.

mediathequeroubaix loans renew

Why I am doing this

I created this project to:

1. Learn Functional Programing
2. Learn typed and modern Python
3. Be able to quickly list and renew my loans (especially when you have many cards)

Changelog

See CHANGELOG.md

Development

• Clone this repository
• Install UV
• (Optional) if using direnv, create .envrc with:

uv sync
source .venv/bin/activate

• Testing

pytest

• Check everything in one go

pre-commit run --all-files

• Run the CLI

python src/mediathequeroubaix/main.py

Releasing

1. Commit, tag, publish using the release script:

./bin/release.py 1.2.3

2. Update CHANGELOG.md
3. Create a new release on GitHub

Credits

• Background and color from PrettySnap
• Python project bootstrapped using Wolt template
• Functional library is Returns from DRY-Python
• Tables look great thanks to Textualize's Rich
• CLI screenshot pimped with ShowCode.app