mirror of
https://github.com/only-cli/oc.git
synced 2026-09-15 10:40:56 +02:00
3.9 KiB
3.9 KiB
Changelog
Notable changes per release. Releases before 0.4.0 are listed at github.com/only-cli/oc/releases.
0.5.0
Added
- Language documentation shortcuts:
py,mdn,node,ruby,go,rust,java,php,cpp, andts, plus adotnetverb onlearnfor the .NET API browser.searchonpy,node, andrubyranks the docs' own search index locally and onmdnasks the site's API; the sites that only render docs search client-side go through DuckDuckGo with a baked-insite:filter instead. (#25) - Authenticated sessions:
oc loginseeds cookies for a session and every fetch in that session sends them;oc logoutforgets a session early, cookies and saved page both. Cookies live in a per-session jar underOC_HOME, separate from page state, pinned to the exact host they were seeded for, and marked secure by default so they travel over https only (--allow-httpat login opts a plain-http site in). A session lasts an hour unless--expiressays otherwise.--cookie -reads the header from stdin, the form to prefer since an argv secret is visible inpsand kept in shell history. (#4)
Fixed
- Response bodies are bounded at every transport, 25MB decoded, checked
against
Content-Lengthbefore the bytes arrive and counted as they land, so a hostile URL is no longer an unbounded allocation and a decompression bomb stops at the cap. (#27) - Titles, headings, and input names are cut at the render boundary like every
other block, so one hostile page-written scalar can no longer print
unbounded output whatever the budget said. The distilled page keeps the
full values and
--jsonstays the machine-stable view. (#28) - A short page is judged unreadable by evidence, not by length alone: nothing extracted is empty whatever the page weighed, and a short render only fails when the markup behind it was far too big to have carried only that. A status endpoint or a one-line answer now exits 0; script-only shells and consent walls still exit 2. (#29)
0.4.0
Added
- Site shortcuts are dispatched, not just documented.
oc <site> <verb> [args]resolves to a URL and then takes the same pathoc opendoes, so it costs the same and reads the same. A site is named by short name, bare name, or domain (oc hn,oc ycombinator,oc news.ycombinator.com), the last argument absorbs every word after it so a query needs no quoting, andoc siteslists every site with its verbs. Shortcuts come fromclis/*.json, so adding a site is a JSON file and no code. (#19) - Wikipedia shortcuts:
oc wiki article <title>,oc wiki search <query>, andoc wiki lang <code> <title>for the other language editions. Articles are read throughaction=render, which serves the article body without the site chrome, navigation, and edit controls that surround/wiki/<Title>. (#22) - Outbound fetches honor
HTTP_PROXY,HTTPS_PROXY, andNO_PROXY, including the lowercase forms, so oc works in a sandbox whose only route out is a proxy. HTTP and HTTPS proxies are supported and proxy credentials in the URL are sent asProxy-Authorization. (#17) - The MIT
LICENSEfile that the badge andpackage.jsonwere already claiming. (#18)
Changed
- A page that distills to no readable text now fails loud instead of printing an
empty render and exiting 0. It writes one line to stderr and exits 2, which is
distinct from the exit 1 every other failure uses, so a caller can tell "this
page is empty" from "oc could not read this page" and fall back to a browser
only when that is worth doing.
--jsoncarries the same verdict as anemptyfield. (#20) - The SSRF guard runs before a proxy is chosen, so a proxied request cannot be used to reach an address the direct path would have refused. (#17)
Fixed
- GitHub and Reddit shortcut URL templates corrected so their verbs reach the pages they name. (#19)