Add the data layer with the build-db, fetch-lyrics, and fetch-artists subcommands

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-04 15:12:22 +08:00
parent f9ab79f0c2
commit 8d223177cd
17 changed files with 2320 additions and 9 deletions
@@ -31,6 +31,24 @@ Usage
 Runs a specific tool command, where "command" can be:


+build-db
+--------
+
+Initialize or rebuild the database from the CSV Billboard ranking table, parse songs and its artists, and output song and artist lists for references.  Check ``pop-fem-audit-tools build-db -h`` for complete instructions on its usage.
+
+
+fetch-artists
+-------------
+
+Fetch artist data from Wikidata, for ``build-db`` to merge the fetched data into the database.  Check ``pop-fem-audit-tools fetch-artists -h`` for complete instructions on its usage.
+
+
+fetch-lyrics
+------------
+
+Fetch lyrics, for ``build-db`` to merge the fetched lyrics into the database.  Lyrics are not committed into the repository due to copyright issue.  Check ``pop-fem-audit-tools fetch-lyrics -h`` for complete instructions on its usage.
+
+
 run-llm
 -------