From 09d2ebdb0b6698c2fdc6c7168fa92923e8218fb4 Mon Sep 17 00:00:00 2001 From: GeiserX <9169332+GeiserX@users.noreply.github.com> Date: Wed, 7 Oct 2026 01:06:58 +0200 Subject: [PATCH 1/2] docs: tell 1.4.x users to move to 1.5.0, and keep the Python 3.9 note true after the yank 1.4.6 and earlier let an archived page make the tool fetch any host and save the response (fixed in #55, released in 1.5.0), but nothing told an existing user to upgrade. The README now says so and how. 1.4.2 to 1.4.6 are about to be yanked from PyPI. On Python 3.9 that turns pip's ResolutionImpossible into "No matching distribution found", so the troubleshooting entry names both errors. --- README.md | 2 +- docs/getting-started.md | 2 +- docs/troubleshooting.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 3b063ed..9625210 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,7 @@ WAYBACK_URL="https://web.archive.org/web/20051231235226/http://www.python.org/" open output/index.html # Linux: xdg-open output/index.html ``` -Needs Python 3.10 or newer (on 3.9, pip stops with `ResolutionImpossible`); `pip install` works too, and the other install paths are in [Getting started](https://geiserx.github.io/Wayback-Archive/getting-started/). That run takes about a minute, ends with a `Download Complete!` block counting the files downloaded, failed and skipped, and opens from disk as the page above: the homepage, its stylesheet and its images are all within the first 50 files. Drop `MAX_FILES` to fetch the whole site. On another site a short run can stop before a stylesheet that is only reached through `@import`, because the crawl fetches files in the order it finds them. There are no flags: every setting is an environment variable, listed in [Configuration](https://geiserx.github.io/Wayback-Archive/configuration/). +Use 1.5.0 or later: in 1.4.6 and earlier an archived page can make the tool fetch any host directly and save the response ([#55](https://github.com/GeiserX/Wayback-Archive/pull/55)), and `pipx upgrade wayback-archive` moves an existing install. Needs Python 3.10 or newer (pip on 3.9 finds no release it can install); `pip install` works too, and the other install paths are in [Getting started](https://geiserx.github.io/Wayback-Archive/getting-started/). That run takes about a minute, ends with a `Download Complete!` block counting the files downloaded, failed and skipped, and opens from disk as the page above: the homepage, its stylesheet and its images are all within the first 50 files. Drop `MAX_FILES` to fetch the whole site. On another site a short run can stop before a stylesheet that is only reached through `@import`, because the crawl fetches files in the order it finds them. There are no flags: every setting is an environment variable, listed in [Configuration](https://geiserx.github.io/Wayback-Archive/configuration/). ## Documentation diff --git a/docs/getting-started.md b/docs/getting-started.md index c072afb..8523eab 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -2,7 +2,7 @@ ## Prerequisites -- Python 3.10 or newer (on 3.9, pip stops with `ResolutionImpossible`) +- Python 3.10 or newer (pip on 3.9 finds no release it can install; see [Troubleshooting](troubleshooting.md#pip-cannot-install-it-python-39)) - pipx or pip ## From PyPI diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index eac2154..efcc95d 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -16,9 +16,9 @@ source .venv/bin/activate pip install wayback-archive ``` -## pip stops with ResolutionImpossible (Python 3.9) +## pip cannot install it (Python 3.9) -Wayback-Archive needs Python 3.10 or newer. On Python 3.9, pip skips 1.5.0, tries 1.4.2 to 1.4.6, finds that the `requests` version they need does not install on 3.9, and stops with `ERROR: ResolutionImpossible`. The `python3` that ships with macOS is 3.9. Install Python 3.10 or newer (for example `brew install python`) and install again with pipx or in a new virtual environment. +Wayback-Archive needs Python 3.10 or newer. On Python 3.9, pip skips 1.5.0 and finds no older release it can use: it stops with `ERROR: ResolutionImpossible` while it can still try 1.4.2 to 1.4.6 (their `requests` does not install on 3.9), and with `ERROR: No matching distribution found for wayback-archive` once those are yanked. The `python3` that ships with macOS is 3.9. Install Python 3.10 or newer (for example `brew install python`) and install again with pipx or in a new virtual environment. ## Port already in use From 0a21232061927dfdb4d8faa0129fb28b051960b0 Mon Sep 17 00:00:00 2001 From: GeiserX <9169332+GeiserX@users.noreply.github.com> Date: Wed, 7 Oct 2026 01:18:48 +0200 Subject: [PATCH 2/2] docs(readme): a pipx install made on Python 3.9 has to be rebuilt to reach 1.5.0 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9625210..c9302ac 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,7 @@ WAYBACK_URL="https://web.archive.org/web/20051231235226/http://www.python.org/" open output/index.html # Linux: xdg-open output/index.html ``` -Use 1.5.0 or later: in 1.4.6 and earlier an archived page can make the tool fetch any host directly and save the response ([#55](https://github.com/GeiserX/Wayback-Archive/pull/55)), and `pipx upgrade wayback-archive` moves an existing install. Needs Python 3.10 or newer (pip on 3.9 finds no release it can install); `pip install` works too, and the other install paths are in [Getting started](https://geiserx.github.io/Wayback-Archive/getting-started/). That run takes about a minute, ends with a `Download Complete!` block counting the files downloaded, failed and skipped, and opens from disk as the page above: the homepage, its stylesheet and its images are all within the first 50 files. Drop `MAX_FILES` to fetch the whole site. On another site a short run can stop before a stylesheet that is only reached through `@import`, because the crawl fetches files in the order it finds them. There are no flags: every setting is an environment variable, listed in [Configuration](https://geiserx.github.io/Wayback-Archive/configuration/). +Use 1.5.0 or later: in 1.4.6 and earlier an archived page can make the tool fetch any host directly and save the response ([#55](https://github.com/GeiserX/Wayback-Archive/pull/55)), and `pipx upgrade wayback-archive` moves an existing install (one made with Python 3.9 needs `pipx reinstall --python python3.10 wayback-archive` instead). Needs Python 3.10 or newer (pip on 3.9 finds no release it can install); `pip install` works too, and the other install paths are in [Getting started](https://geiserx.github.io/Wayback-Archive/getting-started/). That run takes about a minute, ends with a `Download Complete!` block counting the files downloaded, failed and skipped, and opens from disk as the page above: the homepage, its stylesheet and its images are all within the first 50 files. Drop `MAX_FILES` to fetch the whole site. On another site a short run can stop before a stylesheet that is only reached through `@import`, because the crawl fetches files in the order it finds them. There are no flags: every setting is an environment variable, listed in [Configuration](https://geiserx.github.io/Wayback-Archive/configuration/). ## Documentation