docs: raw fetch --html record and kb/CONTRACT.md path budget follow the folder accept (#112)
Files changed: - CHANGES.md - VERSION - kb/CONTRACT.md - tools/CONTRACT.md - tools/chemenu/commands/raw_cmd.py Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
1 parent
59c06e5ddc
commit
100ace846e
5 files changed
+21
-8
No files matched your search
+2
-2
@@ -1415,14 +1415,14 @@ Capture a web page the user names into `incoming/`: the HTML as received plus a
|
||||
- 1 The URL is not `http`/`https` (also after a redirect), or neither or both of `<url>` and `--html` were given
|
||||
- 1 A target file already exists in `incoming/`
|
||||
- 1 The server answered with an HTTP error, could not be reached, took longer than 30 s, or sent more than 25 MiB
|
||||
- 1 raw fetch --html: `--url` is missing, the file is not under `incoming/` or does not exist, or `incoming/<stem>.md` already exists
|
||||
- 1 raw fetch --html: `--url` is missing, the file is not directly in `incoming/` or does not exist, or `incoming/<stem>.md` already exists
|
||||
|
||||
**ON FAILURE**
|
||||
|
||||
- The URL is not `http`/`https` (also after a redirect), or neither or both of `<url>` and `--html` were given -> Fix the call and retry once. A local file is dropped into `incoming/` by hand, not fetched
|
||||
- A target file already exists in `incoming/` -> Nothing was written or overwritten. Accept or remove what is there, or pass `--name <stem>`, then retry once
|
||||
- The server answered with an HTTP error, could not be reached, took longer than 30 s, or sent more than 25 MiB -> Nothing was written. An HTTP 4xx is not fixed by retrying - check the URL with the user; for a paywall or login, save the page in a browser and use `--html`. An unreachable host or a timeout may be retried once
|
||||
- raw fetch --html: `--url` is missing, the file is not under `incoming/` or does not exist, or `incoming/<stem>.md` already exists -> Fix the named argument and retry once - nothing was written
|
||||
- raw fetch --html: `--url` is missing, the file is not directly in `incoming/` or does not exist, or `incoming/<stem>.md` already exists -> Fix the named argument and retry once - nothing was written. A saved page inside a subdirectory of `incoming/` is moved up into `incoming/` first
|
||||
|
||||
**NEVER**
|
||||
|
||||
|
||||
@@ -1229,9 +1229,10 @@ def _fetch_html_file(html: Path, source_url: Optional[str]) -> None:
|
||||
),
|
||||
cli_contract.Failure(
|
||||
label="raw fetch --html",
|
||||
cause="`--url` is missing, the file is not under `incoming/` or does not exist, or "
|
||||
"`incoming/<stem>.md` already exists",
|
||||
reaction="Fix the named argument and retry once - nothing was written",
|
||||
cause="`--url` is missing, the file is not directly in `incoming/` or does not "
|
||||
"exist, or `incoming/<stem>.md` already exists",
|
||||
reaction="Fix the named argument and retry once - nothing was written. A saved page "
|
||||
"inside a subdirectory of `incoming/` is moved up into `incoming/` first",
|
||||
),
|
||||
),
|
||||
examples=(
|
||||
|
||||
Reference in new issue
Block a user