Modeling iiab-glue.db to enable mapping of books.id (metadata.db) and media.id (xklb-metadata.db)

[deldesir]

This pull request introduces the glue_db.py module to model the iiab-glue.db database, facilitating the mapping between books.id in metadata.db and media.id in xklb-metadata.db.

Key Changes:

• New Module glue_db.py: Implements the GlueDB class and MediaBooksMapping schema to handle database creation, session management, and the mapping between media_id and book_id.

  • Database Initialization: Constructs and initializes the iiab-glue.db file if it does not exist.
  • Session Management: Manages database sessions using SQLAlchemy, ensuring efficient and thread-safe interactions.

• Tested on Ubuntu 24.04

[holta]

Very related:

• PR Begin to establish 1:1 mapping between media_id (xklb-metadata.db) <-> Calibre-Web's book_id (metadata.db) #255
• PR Create xb_utils.py [to query/manipulate xklb-metadata.db (schema in xb.py) + iiab-glue.db (schema in glue-db.py)] #256

Perhaps less related:

• PR Query captions/subtitles [e.g. video transcripts] from xklb-metadata.db #244

[deldesir]

How to test

• Pull the PR following How do I test a pull request (PR) ? instructions.
• The test that validates PR #263 also validates this PR.

To further test, note the number in the URL for the video played from within Calibre-Web (i.e for http://<IIAB_URL>/books/read/31/mp4, the video ID is 31), note also the title of the video and note the media ID associated with it in iiab-glue.db. This media ID can be verified inspecting xklb-metadata.db for its correctness. To do so datasette to review the extraction with datasette /library/calibre-web/xklb-metadata.db -h 0.0.0.0 -p <PORT_NUMBER>. Look for the ID row in media table and compare the title from the actual video with the record under media.title.