Docs: add troubleshooting for Simple API JSON mirroring by vani2009 · Pull Request #2145 · pypa/bandersnatch

vani2009 · 2026-02-06T11:08:44Z

Adds a troubleshooting section describing common JSON vs HTML Simple API
issues when mirroring from another mirror.

Includes:

Content-Type mismatch error explanation
How to verify JSON endpoint
Clarifies no automatic fallback behavior

This should help users debugging chained mirror setups.

codecov · 2026-02-06T11:11:39Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.84%. Comparing base (4d020e8) to head (9926175).
⚠️ Report is 478 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2145      +/-   ##
==========================================
+ Coverage   79.69%   88.84%   +9.14%     
==========================================
  Files          31       34       +3     
  Lines        4324     4015     -309     
  Branches      780      396     -384     
==========================================
+ Hits         3446     3567     +121     
+ Misses        721      312     -409     
+ Partials      157      136      -21

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

cooperlees

Please apply changes suggested on #2144 and probably close that one

cooperlees · 2026-02-10T19:34:02Z

docs/mirror_from_mirror_simple_api.rst

Suggested change

implements the Simple Repository API (PEP 503). This allows you to create

implements the Simple Repository API (PEP 503 + 691). This allows you to create

docs/mirror_from_mirror_simple_api.rst

Bumps [s3path](https://github.com/liormizr/s3path) from 0.6.4 to 0.6.5. - [Release notes](https://github.com/liormizr/s3path/releases) - [Commits](liormizr/s3path@0.6.4...0.6.5) --- updated-dependencies: - dependency-name: s3path dependency-version: 0.6.5 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Bumps [packaging](https://github.com/pypa/packaging) from 25.0 to 26.0. - [Release notes](https://github.com/pypa/packaging/releases) - [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst) - [Commits](pypa/packaging@25.0...26.0) --- updated-dependencies: - dependency-name: packaging dependency-version: '26.0' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Cooper Lees <me@cooperlees.com>

Bumps [coverage](https://github.com/coveragepy/coveragepy) from 7.13.2 to 7.13.3. - [Release notes](https://github.com/coveragepy/coveragepy/releases) - [Changelog](https://github.com/coveragepy/coveragepy/blob/main/CHANGES.rst) - [Commits](coveragepy/coveragepy@7.13.2...7.13.3) --- updated-dependencies: - dependency-name: coverage dependency-version: 7.13.3 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Cooper Lees <me@cooperlees.com>

Bumps [setuptools](https://github.com/pypa/setuptools) from 80.10.2 to 82.0.0. - [Release notes](https://github.com/pypa/setuptools/releases) - [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst) - [Commits](pypa/setuptools@v80.10.2...v82.0.0) --- updated-dependencies: - dependency-name: setuptools dependency-version: 82.0.0 dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Cooper Lees <me@cooperlees.com>

* Build(deps): Bump boto3 from 1.42.40 to 1.42.44 Bumps [boto3](https://github.com/boto/boto3) from 1.42.40 to 1.42.44. - [Release notes](https://github.com/boto/boto3/releases) - [Commits](boto/boto3@1.42.40...1.42.44) --- updated-dependencies: - dependency-name: boto3 dependency-version: 1.42.44 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> * Update botocore version to 1.42.44 --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Cooper Lees <me@cooperlees.com>

…ents, and fail-fast behavior

vani2009 · 2026-02-11T10:23:11Z

pre-commit.ci autofix

for more information, see https://pre-commit.ci

vani2009 · 2026-02-11T11:01:18Z

pre-commit.ci autofix

for more information, see https://pre-commit.ci

cooperlees

Just little cleanup then I'll merge this! Thanks for all your work.

cooperlees · 2026-02-11T20:33:12Z

changelog.d/docs-simple-api-json-troubleshooting.rst

Can we delete this file please, we don't use this.

CHANGES.md

vani2009 · 2026-02-12T08:02:26Z

pre-commit.ci autofix

vani2009 · 2026-02-12T08:05:42Z

Thanks! I’ve removed the unused changelog.d file and moved the entry under Unreleased in CHANGES.md. All requested changes should now be addressed.

cooperlees

I hate to do this, but can you remove the newsfragments files please.

vani2009 · 2026-02-12T20:25:41Z

pre-commit.ci autofix

for more information, see https://pre-commit.ci

cooperlees

Thanks for working through all the reviews! Appreciate it.

vani2009 · 2026-02-12T20:28:54Z

Thank you for the review and guidance — really appreciate it!

Docs: add troubleshooting for Simple API JSON mirroring

90cf304

cooperlees mentioned this pull request Feb 10, 2026

Docs: add guide for mirroring from another Simple API mirror #2144

Closed

cooperlees requested changes Feb 10, 2026

View reviewed changes

dependabot bot and others added 9 commits February 11, 2026 15:19

Docs: add missing changelog fragment

d26afef

Docs: address review — correct master URL, add PEP 691, JSON requirem…

225578f

…ents, and fail-fast behavior

Docs: link mirror-from-mirror Simple API guide in main index

1aba8aa

Docs: finalize review — fix PEP wording and add HTML fallback note

c606549

pre-commit-ci bot and others added 5 commits February 11, 2026 10:23

[pre-commit.ci] auto fixes from pre-commit.com hooks

3d63490

for more information, see https://pre-commit.ci

Docs: add changelog fragment for mirror-from-mirror JSON docs

d513a78

Add changelog entry for docs: Simple API JSON troubleshooting

a669327

Add CHANGES.md entry for PR pypa#2145

55f4dec

Merge branch 'main' into docs/simple-api-json-troubleshooting

c6413bb

[pre-commit.ci] auto fixes from pre-commit.com hooks

ada90b7

for more information, see https://pre-commit.ci

vani2009 requested a review from cooperlees February 11, 2026 11:06

cooperlees requested changes Feb 11, 2026

View reviewed changes

Move changelog entry to Unreleased and remove unused changelog.d file

9c884b4

vani2009 force-pushed the docs/simple-api-json-troubleshooting branch from c582e79 to 9c884b4 Compare February 12, 2026 08:00

cooperlees requested changes Feb 12, 2026

View reviewed changes

chore: remove newsfragments files per review

b819516

vani2009 force-pushed the docs/simple-api-json-troubleshooting branch from 54024b8 to b819516 Compare February 12, 2026 20:23

[pre-commit.ci] auto fixes from pre-commit.com hooks

9926175

for more information, see https://pre-commit.ci

cooperlees approved these changes Feb 12, 2026

View reviewed changes

cooperlees merged commit 53280f8 into pypa:main Feb 12, 2026
15 of 16 checks passed

vani2009 deleted the docs/simple-api-json-troubleshooting branch February 12, 2026 20:31

	implements the Simple Repository API (PEP 503). This allows you to create
	implements the Simple Repository API (PEP 503 + 691). This allows you to create

Conversation

vani2009 commented Feb 6, 2026

Uh oh!

codecov bot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

cooperlees left a comment

Choose a reason for hiding this comment

Uh oh!

cooperlees Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vani2009 commented Feb 11, 2026

Uh oh!

vani2009 commented Feb 11, 2026

Uh oh!

cooperlees left a comment

Choose a reason for hiding this comment

Uh oh!

cooperlees Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vani2009 commented Feb 12, 2026

Uh oh!

vani2009 commented Feb 12, 2026

Uh oh!

cooperlees left a comment

Choose a reason for hiding this comment

Uh oh!

vani2009 commented Feb 12, 2026

Uh oh!

cooperlees left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vani2009 commented Feb 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Comments

codecov bot commented Feb 6, 2026 •

edited

Loading