Added furumi_library with furumi database primitives

2026-08-11 18:07:19 +01:00
parent f9a5096aea
commit 02ef0095f5
13 changed files with 5543 additions and 10 deletions
@@ -0,0 +1,21 @@
+# furumi-library
+
+Client-independent persistence foundation for Furumi music players.
+
+The crate owns the shared `library.db` contract: SQLite schema and migrations,
+catalog models and queries, local import and metadata extraction, artwork
+resolution, playlists, likes, listening history, and similarity index storage.
+It contains no UI, playback engine, or application runtime.
+
+During local development clients use a path dependency:
+
+```toml
+furumi-library = { path = "../frid/crates/furumi-library" }
+```
+
+Adjust the relative path to match the position of the client repository. After
+publication, clients can depend on the released crate version instead.
+
+`Library::open(default_db_path()?)` opens the same platform-native Furumi
+library used by every client. Connections use WAL, foreign keys, and a busy
+timeout so independently running clients can safely share the database.