Stockholm-Library

Unofficial SDK for interacting with Stockholm Library

Currently the project is in very early development and very little functionality can be used. But if you are eager to get stuff going, please consider helping out by contributing!

Usage

Connecting

The simplest way to connect with the client is through credentials.

from stockholm_library import Client

client = Client()
success: bool = client.login(
    user="8705061234",
    pin="1234"
)
print(success)  # True

Fetching loaned books

loans = client.get_loans()

for loan in loans:
    print(loan)  # {id: 123456, book: ...}

Below is the structure of a Loan object:

{
    "id": 123456,
    "book": models.Book(
        "id": 129716,
        "title": "Liftarens guide till galaxen",
        "author": "Douglas Adams"
    ),
    "borrowed_from": "Telefonplans bibliotek",
    "borrowed_date": datetime.date(2022, 3, 5),
    "due_date": datetime.date(2022, 4, 3),
    "can_re_borrow": True
}

Beware that not all loans have an ID at every given moment. If it's not possible to re-borrow a book it won't yield an ID.

Contributing

Contributions are always welcome!

To contribute, please take the following steps:

1. Fork the repo
2. Add your change
3. Make a pull request with a short description of the change you're proposing.

Authors

• @vonNiklasson