acadfetch 0.3.0__tar.gz → 0.3.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. {acadfetch-0.3.0/acadfetch.egg-info → acadfetch-0.3.1}/PKG-INFO +7 -2
  2. {acadfetch-0.3.0 → acadfetch-0.3.1}/README.md +6 -1
  3. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/consts.py +1 -1
  4. {acadfetch-0.3.0 → acadfetch-0.3.1/acadfetch.egg-info}/PKG-INFO +7 -2
  5. {acadfetch-0.3.0 → acadfetch-0.3.1}/pyproject.toml +1 -1
  6. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_json.py +20 -0
  7. {acadfetch-0.3.0 → acadfetch-0.3.1}/LICENSE +0 -0
  8. {acadfetch-0.3.0 → acadfetch-0.3.1}/MANIFEST.in +0 -0
  9. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/__init__.py +0 -0
  10. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/__main__.py +0 -0
  11. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/atomic.py +0 -0
  12. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/auth.py +0 -0
  13. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/cli.py +0 -0
  14. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/client.py +0 -0
  15. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/downloader.py +0 -0
  16. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/errors.py +0 -0
  17. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/manifest.py +0 -0
  18. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/naming.py +0 -0
  19. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/progress.py +0 -0
  20. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/py.typed +0 -0
  21. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/ratelimit.py +0 -0
  22. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/remote.py +0 -0
  23. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/__init__.py +0 -0
  24. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/arxiv.py +0 -0
  25. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/base.py +0 -0
  26. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/direct.py +0 -0
  27. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/doi.py +0 -0
  28. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/registry.py +0 -0
  29. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/removed.py +0 -0
  30. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/sources/zenodo.py +0 -0
  31. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/units.py +0 -0
  32. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/urls.py +0 -0
  33. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch/verify.py +0 -0
  34. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch.egg-info/SOURCES.txt +0 -0
  35. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch.egg-info/dependency_links.txt +0 -0
  36. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch.egg-info/entry_points.txt +0 -0
  37. {acadfetch-0.3.0 → acadfetch-0.3.1}/acadfetch.egg-info/top_level.txt +0 -0
  38. {acadfetch-0.3.0 → acadfetch-0.3.1}/setup.cfg +0 -0
  39. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/conftest.py +0 -0
  40. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/fixtures/README.md +0 -0
  41. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/fixtures/figshare_403_block.html +0 -0
  42. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/fixtures/figshare_403_forbidden.json +0 -0
  43. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/fixtures/figshare_article.json +0 -0
  44. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/fixtures/figshare_file.pdf +0 -0
  45. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_atomic.py +0 -0
  46. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_auth.py +0 -0
  47. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_checksum.py +0 -0
  48. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_cli.py +0 -0
  49. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_client.py +0 -0
  50. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_control_names.py +0 -0
  51. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_disk.py +0 -0
  52. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_downloader.py +0 -0
  53. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_identity.py +0 -0
  54. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_isolation.py +0 -0
  55. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_manifest.py +0 -0
  56. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_naming.py +0 -0
  57. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_naming_race.py +0 -0
  58. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_packaging.py +0 -0
  59. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_progress.py +0 -0
  60. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_ratelimit.py +0 -0
  61. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_redirect.py +0 -0
  62. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_remote.py +0 -0
  63. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_removed.py +0 -0
  64. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_sources.py +0 -0
  65. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_urls.py +0 -0
  66. {acadfetch-0.3.0 → acadfetch-0.3.1}/tests/test_verify.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: acadfetch
3
- Version: 0.3.0
3
+ Version: 0.3.1
4
4
  Summary: Resumable, rate-limited, checksum-verified bulk downloads from academic data repositories
5
5
  Author: young-ski
6
6
  License-Expression: MIT
@@ -143,7 +143,8 @@ acadfetch fetch zenodo:123456 --json | jq -r '.files[] | select(.state=="failed"
143
143
  ```
144
144
 
145
145
  Exit codes are unchanged, and a failure before any transfer still produces a
146
- document with `error` set. `report` is the document's schema version (now `2`):
146
+ document with `error` set. `report` is the document's schema version (now `2`, field reference in
147
+ [docs/json-report.md](docs/json-report.md)):
147
148
  fields are added, never removed or given a new meaning, and `state` may gain
148
149
  values — treat an unknown one as non-terminal. `verify --json` reports per-file
149
150
  `MISMATCH` rows the same way, and its `summary` counts `skipped` rows
@@ -291,6 +292,10 @@ honest way to test this code path.
291
292
 
292
293
  ## Getting involved
293
294
 
295
+ A nightly job downloads three fixed public records and verifies them, so a
296
+ rotted adapter opens an issue before a user reports one. It never blocks a
297
+ merge; the next good night closes the issue.
298
+
294
299
  - **Stuck on something** → [docs/troubleshooting.md](docs/troubleshooting.md) first; it is short and indexed by symptom
295
300
  - **Usage questions** → [Discussions](https://github.com/young-ski/acadfetch/discussions)
296
301
  - **Bugs** → the bug template; say whether `verify` reports `MISMATCH`
@@ -112,7 +112,8 @@ acadfetch fetch zenodo:123456 --json | jq -r '.files[] | select(.state=="failed"
112
112
  ```
113
113
 
114
114
  Exit codes are unchanged, and a failure before any transfer still produces a
115
- document with `error` set. `report` is the document's schema version (now `2`):
115
+ document with `error` set. `report` is the document's schema version (now `2`, field reference in
116
+ [docs/json-report.md](docs/json-report.md)):
116
117
  fields are added, never removed or given a new meaning, and `state` may gain
117
118
  values — treat an unknown one as non-terminal. `verify --json` reports per-file
118
119
  `MISMATCH` rows the same way, and its `summary` counts `skipped` rows
@@ -260,6 +261,10 @@ honest way to test this code path.
260
261
 
261
262
  ## Getting involved
262
263
 
264
+ A nightly job downloads three fixed public records and verifies them, so a
265
+ rotted adapter opens an issue before a user reports one. It never blocks a
266
+ merge; the next good night closes the issue.
267
+
263
268
  - **Stuck on something** → [docs/troubleshooting.md](docs/troubleshooting.md) first; it is short and indexed by symptom
264
269
  - **Usage questions** → [Discussions](https://github.com/young-ski/acadfetch/discussions)
265
270
  - **Bugs** → the bug template; say whether `verify` reports `MISMATCH`
@@ -1,6 +1,6 @@
1
1
  """Package-wide constants and version."""
2
2
 
3
- __version__ = "0.3.0"
3
+ __version__ = "0.3.1"
4
4
 
5
5
  USER_AGENT = f"acadfetch/{__version__} (+https://github.com/young-ski/acadfetch)"
6
6
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: acadfetch
3
- Version: 0.3.0
3
+ Version: 0.3.1
4
4
  Summary: Resumable, rate-limited, checksum-verified bulk downloads from academic data repositories
5
5
  Author: young-ski
6
6
  License-Expression: MIT
@@ -143,7 +143,8 @@ acadfetch fetch zenodo:123456 --json | jq -r '.files[] | select(.state=="failed"
143
143
  ```
144
144
 
145
145
  Exit codes are unchanged, and a failure before any transfer still produces a
146
- document with `error` set. `report` is the document's schema version (now `2`):
146
+ document with `error` set. `report` is the document's schema version (now `2`, field reference in
147
+ [docs/json-report.md](docs/json-report.md)):
147
148
  fields are added, never removed or given a new meaning, and `state` may gain
148
149
  values — treat an unknown one as non-terminal. `verify --json` reports per-file
149
150
  `MISMATCH` rows the same way, and its `summary` counts `skipped` rows
@@ -291,6 +292,10 @@ honest way to test this code path.
291
292
 
292
293
  ## Getting involved
293
294
 
295
+ A nightly job downloads three fixed public records and verifies them, so a
296
+ rotted adapter opens an issue before a user reports one. It never blocks a
297
+ merge; the next good night closes the issue.
298
+
294
299
  - **Stuck on something** → [docs/troubleshooting.md](docs/troubleshooting.md) first; it is short and indexed by symptom
295
300
  - **Usage questions** → [Discussions](https://github.com/young-ski/acadfetch/discussions)
296
301
  - **Bugs** → the bug template; say whether `verify` reports `MISMATCH`
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "acadfetch"
7
- version = "0.3.0"
7
+ version = "0.3.1"
8
8
  description = "Resumable, rate-limited, checksum-verified bulk downloads from academic data repositories"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -273,3 +273,23 @@ def test_the_default_directory_drops_the_query(server, monkeypatch, capsys, tmp_
273
273
  slug = Path(json.loads(out)["out"]).name
274
274
  assert slug.startswith("direct-127.0.0.1-") and slug.endswith("-a.bin")
275
275
  assert "SECRET" not in slug
276
+
277
+
278
+ def test_every_report_field_is_in_the_contract(served, capsys, tmp_path):
279
+ """A field added to the document without a line in the contract fails here."""
280
+ docs = Path("docs/json-report.md").read_text("utf-8")
281
+
282
+ _, out, _ = _run(capsys, "fetch", "zenodo:1", "--json", "-o", tmp_path)
283
+ fetch_doc = json.loads(out)
284
+ for key in fetch_doc:
285
+ assert f"`{key}`" in docs, f"fetch field {key!r} is undocumented"
286
+ for key in fetch_doc["files"][0]:
287
+ assert f"`{key}`" in docs, f"file field {key!r} is undocumented"
288
+
289
+ manifest_path = tmp_path / "manifest.json"
290
+ _, vout, _ = _run(capsys, "verify", manifest_path, "--json")
291
+ verify_doc = json.loads(vout)
292
+ for key in verify_doc:
293
+ assert f"`{key}`" in docs, f"verify field {key!r} is undocumented"
294
+ for value in ("escaped", "malformed", "remote_match", "remote_unavailable"):
295
+ assert value in docs, f"{value!r} is undocumented"
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes