xdfetch 0.1.0__tar.gz → 0.2.0__tar.gz

{xdfetch-0.1.0 → xdfetch-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: xdfetch
-Version: 0.1.0
+Version: 0.2.0
 Summary: Download crossword puzzles and convert them to .xd
 Project-URL: Homepage, https://github.com/century-arcade/xdfetch
 Project-URL: Repository, https://github.com/century-arcade/xdfetch
@@ -170,6 +170,10 @@ if any fetch ended in `error`; a `missing` is not an error.
 | Condé Nast puzzle record | The New Yorker |
 | Washington Post games JSON | The Washington Post |
 | Daily Princetonian crossword API | The Daily Princetonian |
+| Amuse Labs (PuzzleMe) puzzle JSON, unscrambled from the player page | the LA Times, the Atlantic, Newsday, Vox, many others |
+| Crossword Compiler as JSON (xml2js) | King Features, on GameDistribution's feeds |
+| PZLR crossword level | The Wall Street Journal |
+| Puzzmo's xd dialect, in its GraphQL answers | Puzzmo, the Boston Globe |
 
 Other packages can add formats; see "Adding to xdfetch from another package" below.
 
@@ -180,7 +184,12 @@ The series xdfetch knows how to fetch are rows of
 `publisher.series`: `nytimes.daily`, `nytimes.mini`, `nytimes.midi`, `newyorker.daily`,
 `newyorker.mini`, `universal.daily`, `universal.sunday`, `usatoday.daily`,
 `washingtonpost.sunday`, `arkadium.mini`, `arkadium.two-minute-mini`,
-`brendanemmettquigley.blog`, `dailyprincetonian.daily`, `dailyprincetonian.mini`.
+`brendanemmettquigley.blog`, `dailyprincetonian.daily`, `dailyprincetonian.mini`,
+`latimes.daily`, `latimes.midi`, `atlantic.daily`, `newsday.daily`, `dailybeast.daily`,
+`crosswordclub.daily`, `crosswordclub.themed`, `vox.daily`, `vulture.daily`,
+`walrus.weekly`, `defector.weekly`, `kingfeatures.thomas-joseph`,
+`kingfeatures.eugene-sheffer`, `kingfeatures.premier-sunday`, `wsj.daily`,
+`bostonglobe.sunday`, `bostonglobe.mini`, `puzzmo.daily`, `puzzmo.mini`, `puzzmo.big`.
 `xdfetch list` prints them all.
 
 A row's columns, of which only `id` and `adapter` are required:
@@ -188,7 +197,7 @@ A row's columns, of which only `id` and `adapter` are required:
 | Column | Meaning | Blank means |
 |---|---|---|
 | `id` | the series' id | |
-| `adapter` | which adapter fetches it: `url`, `page`, `nyt`, `conde`, `princetonian`, or one a package adds | |
+| `adapter` | which adapter fetches it: `url`, `page`, `nyt`, `conde`, `princetonian`, `amuse`, `gamedist`, `puzzlr`, `puzzmo`, or one a package adds | |
 | `params` | the adapter's parameters, as `key=value` pairs separated by spaces (quote a value that holds spaces) | none |
 | `days` | the days a puzzle runs: `daily`, `mon-sat`, `sun`, `mon,thu` | daily |
 | `since` | the first date to expect a puzzle, `YYYY-MM-DD` | any date |
@@ -206,6 +215,27 @@ optional `filename` param names the file to keep it under. `page` fetches a date
 (`page`, also with strftime fields) and then every file it links whose address matches
 the `link` regex.
 
+The `amuse` adapter fetches from an Amuse Labs (PuzzleMe) player: `host` is the player's
+base address and `set` the series on it. The puzzle id for a date comes from an `id`
+strftime template when the id encodes the date; or, with `page`, from the player embedded
+in the outlet's own page for the date (`fallback` names an undated page to try when that
+one is missing); else from the player's date picker, which lists only recent puzzles.
+Its converter reads `editor`, `title_drop`, `copyright=year`, `publish_offset` and
+`date_title=weekday` from the
+row too; `xdfetch/adapters/amuse.py` and `xdfetch/convert/amuse.py` describe them all.
+
+Three more fetch from platforms that also carry several outlets' puzzles:
+
+- `gamedist`, GameDistribution's crossword feeds (King Features' puzzles): `feed` is the
+  feed's slug. The rows also set how the puzzle is written: `author` (a fixed byline),
+  `dash` and `endash` (what to write for an em or en dash in a clue) and `quotes=repair`
+  (a space after a clue's opening quote mark removed, unbalanced quote marks noted).
+- `puzzlr`, PZLR: `tenant` is the publisher's slug, and `offset` the days added to the
+  date asked for to get the date PZLR files the puzzle under. `copyright` is written when
+  the puzzle carries none.
+- `puzzmo`, Puzzmo: `team` and `queue` name a publisher's queue, or `finder` names one of
+  Puzzmo's own series (`crossword`, `crossword/mini`, `crossword/big`).
+
 Adapters return each file as the outlet served it; converting is a separate step.
 
 ## Adding to xdfetch from another package

{xdfetch-0.1.0 → xdfetch-0.2.0}/README.md

@@ -145,6 +145,10 @@ if any fetch ended in `error`; a `missing` is not an error.
 | Condé Nast puzzle record | The New Yorker |
 | Washington Post games JSON | The Washington Post |
 | Daily Princetonian crossword API | The Daily Princetonian |
+| Amuse Labs (PuzzleMe) puzzle JSON, unscrambled from the player page | the LA Times, the Atlantic, Newsday, Vox, many others |
+| Crossword Compiler as JSON (xml2js) | King Features, on GameDistribution's feeds |
+| PZLR crossword level | The Wall Street Journal |
+| Puzzmo's xd dialect, in its GraphQL answers | Puzzmo, the Boston Globe |
 
 Other packages can add formats; see "Adding to xdfetch from another package" below.
 
@@ -155,7 +159,12 @@ The series xdfetch knows how to fetch are rows of
 `publisher.series`: `nytimes.daily`, `nytimes.mini`, `nytimes.midi`, `newyorker.daily`,
 `newyorker.mini`, `universal.daily`, `universal.sunday`, `usatoday.daily`,
 `washingtonpost.sunday`, `arkadium.mini`, `arkadium.two-minute-mini`,
-`brendanemmettquigley.blog`, `dailyprincetonian.daily`, `dailyprincetonian.mini`.
+`brendanemmettquigley.blog`, `dailyprincetonian.daily`, `dailyprincetonian.mini`,
+`latimes.daily`, `latimes.midi`, `atlantic.daily`, `newsday.daily`, `dailybeast.daily`,
+`crosswordclub.daily`, `crosswordclub.themed`, `vox.daily`, `vulture.daily`,
+`walrus.weekly`, `defector.weekly`, `kingfeatures.thomas-joseph`,
+`kingfeatures.eugene-sheffer`, `kingfeatures.premier-sunday`, `wsj.daily`,
+`bostonglobe.sunday`, `bostonglobe.mini`, `puzzmo.daily`, `puzzmo.mini`, `puzzmo.big`.
 `xdfetch list` prints them all.
 
 A row's columns, of which only `id` and `adapter` are required:
@@ -163,7 +172,7 @@ A row's columns, of which only `id` and `adapter` are required:
 | Column | Meaning | Blank means |
 |---|---|---|
 | `id` | the series' id | |
-| `adapter` | which adapter fetches it: `url`, `page`, `nyt`, `conde`, `princetonian`, or one a package adds | |
+| `adapter` | which adapter fetches it: `url`, `page`, `nyt`, `conde`, `princetonian`, `amuse`, `gamedist`, `puzzlr`, `puzzmo`, or one a package adds | |
 | `params` | the adapter's parameters, as `key=value` pairs separated by spaces (quote a value that holds spaces) | none |
 | `days` | the days a puzzle runs: `daily`, `mon-sat`, `sun`, `mon,thu` | daily |
 | `since` | the first date to expect a puzzle, `YYYY-MM-DD` | any date |
@@ -181,6 +190,27 @@ optional `filename` param names the file to keep it under. `page` fetches a date
 (`page`, also with strftime fields) and then every file it links whose address matches
 the `link` regex.
 
+The `amuse` adapter fetches from an Amuse Labs (PuzzleMe) player: `host` is the player's
+base address and `set` the series on it. The puzzle id for a date comes from an `id`
+strftime template when the id encodes the date; or, with `page`, from the player embedded
+in the outlet's own page for the date (`fallback` names an undated page to try when that
+one is missing); else from the player's date picker, which lists only recent puzzles.
+Its converter reads `editor`, `title_drop`, `copyright=year`, `publish_offset` and
+`date_title=weekday` from the
+row too; `xdfetch/adapters/amuse.py` and `xdfetch/convert/amuse.py` describe them all.
+
+Three more fetch from platforms that also carry several outlets' puzzles:
+
+- `gamedist`, GameDistribution's crossword feeds (King Features' puzzles): `feed` is the
+  feed's slug. The rows also set how the puzzle is written: `author` (a fixed byline),
+  `dash` and `endash` (what to write for an em or en dash in a clue) and `quotes=repair`
+  (a space after a clue's opening quote mark removed, unbalanced quote marks noted).
+- `puzzlr`, PZLR: `tenant` is the publisher's slug, and `offset` the days added to the
+  date asked for to get the date PZLR files the puzzle under. `copyright` is written when
+  the puzzle carries none.
+- `puzzmo`, Puzzmo: `team` and `queue` name a publisher's queue, or `finder` names one of
+  Puzzmo's own series (`crossword`, `crossword/mini`, `crossword/big`).
+
 Adapters return each file as the outlet served it; converting is a separate step.
 
 ## Adding to xdfetch from another package

{xdfetch-0.1.0 → xdfetch-0.2.0}/tests/synthetic.py

@@ -20,6 +20,7 @@ FOUR, a 4x4 with blocks in two corners:
 
 from __future__ import annotations
 
+import datetime as dt
 import json
 import struct
 
@@ -327,6 +328,66 @@ Made up for the tests.
 """
 )
 
+# --- Amuse Labs (PuzzleMe) player JSON, as the amuse adapter keeps it ---
+
+
+def amuse_ms(day: dt.date) -> int:
+    """publishTime for noon UTC on the day, in milliseconds."""
+    return int(dt.datetime(day.year, day.month, day.day, 12, 0, tzinfo=dt.UTC).timestamp() * 1000)
+
+
+def amuse() -> dict:
+    """FIVE as the player's JSON: box is by column (box[x][y]), "\\x00" a block."""
+    box = [["\x00" if FIVE[r][c] == "#" else five_value(r, c) for r in range(5)] for c in range(5)]
+    words = [
+        ("<i>Male</i> duck, with &quot;quotes&quot;", True, 1, 0, 0),
+        ("Fossil resin — café colour", True, 4, 0, 2),
+        ("Handbills", True, 5, 0, 4),
+        ("Small fairy-tale miner", False, 1, 0, 0),
+        ("Monastery", False, 2, 2, 0),
+        ("Mistakes…", False, 3, 4, 0),
+    ]
+    return {
+        "title": "Bird Words",
+        "subtitle": "",
+        "description": "Made up for the tests.",
+        "author": "Ann Setter & Bo Builder / Ed. Cy Editor",
+        "copyright": "© 2026 Example Syndicate",
+        "id": "tca261028",
+        "puzzleType": "CROSSWORD",
+        "unlinkGridAndClues": False,
+        "publishTime": amuse_ms(dt.date(2026, 10, 28)),
+        "publishTimeZone": "America/New_York",
+        "w": 5,
+        "h": 5,
+        "box": box,
+        "cellInfos": [{"x": FIVE_CIRCLE[1], "y": FIVE_CIRCLE[0], "isCircled": True, "rightWall": False}],
+        "placedWords": [
+            {"x": x, "y": y, "acrossNotDown": across, "clueNum": str(n), "nBoxes": 5, "clue": {"clue": text}}
+            for text, across, n, x, y in words
+        ],
+    }
+
+
+AMUSE_XD = (
+    """\
+Title: Bird Words
+Author: Ann Setter and Bo Builder
+Editor: Cy Editor
+Copyright: © 2026 Example Syndicate
+Date: 2026-10-28
+Special: circle
+Rebus: 1=RS
+
+
+"""
+    + FIVE_XD_GRID_AND_CLUES
+    + """
+
+Made up for the tests.
+"""
+)
+
 # --- The Daily Princetonian (FOUR, with the A of SAGE circled) ---
 
 AUTHOR_1 = "00000000-0000-4000-8000-0000000000a1"

{xdfetch-0.1.0 → xdfetch-0.2.0}/tests/test_adapters.py

@@ -61,7 +61,17 @@ def test_fetch_returns_bytes_in_hand_without_a_request(registry, http):
 
 
 def test_builtins():
-    assert set(adapters.ADAPTERS) == {"url", "nyt", "conde", "page", "princetonian"}
+    assert set(adapters.ADAPTERS) == {
+        "url",
+        "nyt",
+        "conde",
+        "page",
+        "princetonian",
+        "amuse",
+        "gamedist",
+        "puzzlr",
+        "puzzmo",
+    }
     assert adapters.get("url") is adapters.ADAPTERS["url"]