add offline listening history

README.md

@@ -26,6 +26,7 @@ This is built on top of [`karlicoss/HPI`](https://github.com/karlicoss/HPI). It
 - `my.chess.export`, to track my [chess.com](https://www.chess.com)/[lichess.org](https://lichess.org/) games, using [`chess_export`](https://github.com/seanbreckenridge/chess_export)
 - `my.trakt.export`, providing me a history/my ratings for Movies/TV Show (episodes) using [`traktexport`](https://github.com/seanbreckenridge/traktexport)
 - `my.listenbrainz.export`, exporting my music listening history from [ListenBrainz](https://listenbrainz.org/) (open-source Last.fm) using [`listenbrainz_export`](https://github.com/seanbreckenridge/listenbrainz_export)
+- `my.offline.listens`, for offline music listen history, using [offline_listens](https://github.com/seanbreckenridge/offline_listens)
 - `my.mal.export`, for anime/manga history using [`malexport`](https://github.com/seanbreckenridge/malexport)
 - `my.grouvee.export`, for my video game history/backlog using [`grouvee_export`](https://github.com/seanbreckenridge/grouvee_export)
 - `my.runelite.screenshots`, parses data from the [automatic runelite screenshots](https://github.com/runelite/runelite/wiki/Screenshot)

install

@@ -164,6 +164,7 @@ module_dependencies() {
 	hpi_module my.mail.all || return $?
 	hpi_module my.piazza.scraper || return $?
 	hpi_module my.grouvee.export || return $?
+	hpi_module my.offline.listens || return $?
 	hpi_module my.mal.export || return $?
 	hpi_module my.listenbrainz.export || return $?
 	hpi_module my.skype.gdpr || return $?

my/offline/listens.py

@@ -0,0 +1,45 @@
+"""
+Parses scrobbles from https://github.com/seanbreckenridge/offline_listens
+"""
+
+REQUIRES = ["git+https://github.com/seanbreckenridge/offline_listens"]
+
+# see https://github.com/seanbreckenridge/dotfiles/blob/master/.config/my/my/config/__init__.py for an example
+from my.config import offline as user_config  # type: ignore[attr-defined]
+
+
+from pathlib import Path
+from typing import Iterator, Sequence
+
+from offline_listens.listens import Listen
+from offline_listens.parse import iter_dir, parse_file
+
+from my.core import get_files, Stats, Paths, dataclass
+from my.utils.input_source import InputSource
+
+
+@dataclass
+class config(user_config.listens):
+    # path[s]/glob to the exported data
+    export_path: Paths
+
+
+def inputs() -> Sequence[Path]:
+    return get_files(config.export_path)
+
+
+Results = Iterator[Listen]
+
+
+def history(from_paths: InputSource = inputs) -> Results:
+    for f in from_paths():
+        if f.is_dir():
+            yield from iter_dir(f)
+        else:
+            yield from parse_file(f)
+
+
+def stats() -> Stats:
+    from my.core import stat
+
+    return {**stat(history)}

tests/my/my/config/__init__.py

@@ -176,6 +176,10 @@ class minecraft:
     class advancements:
         export_path: Paths = ""
 
+class offline:
+    class listens:
+        export_path: Paths = ""
+
 
 class time:
     class tz: