Load tunebooks from Eskin

.flake8

@@ -1,3 +1,5 @@
 [flake8]
 max-line-length = 100
 ignore = E203,E402,E501,W503,E226
+per-file-ignores =
+  pyabc2/sources/_lzstring.py: E111,E225,E261,E302,E303,E703

.gitignore

@@ -1,6 +1,7 @@
 .vscode
 pyabc2/sources/_*
 !pyabc2/sources/__init__.py
+!pyabc2/sources/_lzstring.py
 poetry.lock
 venv*/
 docs/api/

.pre-commit-config.yaml

@@ -14,12 +14,13 @@ repos:
     rev: '7.0.0'
     hooks:
       - id: isort
+        exclude: ^pyabc2/sources/_lzstring.py
 
   - repo: https://github.com/psf/black-pre-commit-mirror
     rev: '25.12.0'
     hooks:
       - id: black
-        exclude: ^examples/
+        exclude: ^examples/|^pyabc2/sources/_lzstring.py
 
   - repo: https://github.com/PyCQA/flake8
     rev: '7.3.0'

docs/api.rst

@@ -133,3 +133,20 @@ Functions:
    the_session.load
    the_session.load_meta
    the_session.load_url
+
+Eskin ABC Tools
+---------------
+
+.. automodule:: pyabc2.sources.eskin
+
+Functions:
+
+.. currentmodule:: pyabc2.sources
+
+.. autosummary::
+   :toctree: api/
+
+   eskin.load_meta
+   eskin.load_url
+   eskin.abctools_url_to_abc
+   eskin.abc_to_abctools_url

docs/changes.md

@@ -5,6 +5,7 @@
 * Fix loading The Session sets data ({pull}`77`)
 * Fix HTML display of pitch classes with double accidentals ({pull}`76`)
 * Fix Norbeck URL gen for multi-word tune types (e.g., slip jig, set dance)
+* Add initial support for loading Eskin ABC Transcription Tools tunebooks ({pull}`86`)
 
 ## v0.1.0 (2025-07-02)
 

docs/examples/sources.ipynb

@@ -17,7 +17,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from pyabc2.sources import load_example, norbeck, the_session"
+    "from pyabc2.sources import load_example, norbeck, the_session, eskin"
    ]
   },
   {
@@ -360,11 +360,70 @@
     "    )\n",
     ");"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "31",
+   "metadata": {},
+   "source": [
+    "## Eskin\n",
+    "\n",
+    "Michael Eskin has tunebooks available at <https://michaeleskin.com/tunebooks.html>, viewable with his ABC Transcription Tools.\n",
+    "\n",
+    "We can load selected tunebooks from there, e.g. the King Street Sessions:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "32",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "df = eskin.load_meta(\"kss\")\n",
+    "df"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "33",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "df.group.value_counts()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "34",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from pyabc2 import Tune\n",
+    "\n",
+    "Tune(df.query(\"group == 'jigs'\").iloc[0].abc)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "35",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from IPython.display import display, Markdown\n",
+    "\n",
+    "url = \"https://michaeleskin.com/abctools/abctools.html?lzw=BoLgUAKiBiD2BOACCALApogMrAbhg8gGaICyArgM4CWAxmAEogUA2VADogFZUDmYAwiExUAXon4BDePFjNmYEiACcAegAcYTCACM6sAGkQAcTBGAogBFEFs0cQBBIwCFEAHwdG7zgCaI0333dzKxs7Rxo3RCc0DCd7F3MzRBBXMB5-PxVCFR4EpxUaFUDEdN80HgAjRAkAJmJ3Uszs3Id8wuL-F28nMKdAtIy0LJy8gqLIxvKq2olIipimnIxankjOxG7e+zdUoA\"\n",
+    "display(Markdown(f\"<{url}>\"))\n",
+    "eskin.load_url(url)"
+   ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "venv",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },

pyabc2/sources/__init__.py

@@ -84,6 +84,7 @@ def load_url(url: str) -> Tune:
 
     - Norbeck (``norbeck.nu/abc/``)
     - The Session (``thesession.org``)
+    - Eskin ABC Tools (``michaeleskin.com/abctools/``)
 
     See Also
     --------
@@ -92,12 +93,14 @@ def load_url(url: str) -> Tune:
     """
     from urllib.parse import urlsplit
 
-    from . import norbeck, the_session
+    from . import eskin, norbeck, the_session
 
     res = urlsplit(url)
     if res.netloc in norbeck._URL_NETLOCS:
         return norbeck.load_url(url)
     elif res.netloc in the_session._URL_NETLOCS:
         return the_session.load_url(url)
+    elif res.netloc in eskin._URL_NETLOCS:
+        return eskin.load_url(url)
     else:
         raise NotImplementedError(f"loading URL from {res.netloc} not implemented.")