Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 (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

Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading