Skip to content

Sync README with the current SDK surface (search, formats, keys, register, logs)#6

Merged
gradill22 merged 2 commits into
mainfrom
docs/readme-full-sync
Jul 24, 2026
Merged

Sync README with the current SDK surface (search, formats, keys, register, logs)#6
gradill22 merged 2 commits into
mainfrom
docs/readme-full-sync

Conversation

@gradill22

Copy link
Copy Markdown
Contributor

Brings the README in line with what the client actually exposes today.

Added

  • search(), output formats (format= + .metrics), WellMarked.register(), scoped-key management (create_key/list_keys/revoke_key), get_logs(), and the compliance overrides (allow_domains/deny_patterns/respect_robots).
  • Expanded the error table: insufficient_scope, key_not_found, target_http_error, unsafe_url, idempotency_key_reuse, register_rate_limited, service_unavailable, and the policy codes; noted APIStatusError as the HTTP-status base.

Fixed

  • Pricing table: Free can bulk (up to 5/request) — was shown as ❌.
  • Priority-queue order: Free=Last, Pro=Standard, Growth=High, Enterprise=Highest — was Free=Standard, Pro=High.

Docs-only; no code changes.

The README covered extract/bulk/crawl/webhooks but omitted several
methods the client already ships, and carried two stale facts:

- Add sections for search(), output formats, WellMarked.register(),
  scoped keys (create_key/list_keys/revoke_key), get_logs(), and the
  compliance overrides. Expand the error table (insufficient_scope,
  key_not_found, service_unavailable, register_rate_limited, policy
  and idempotency codes).
- Fix the pricing table: Free CAN bulk (up to 5/request), and the
  priority-queue order is Free=Last, Pro=Standard, Growth=High,
  Enterprise=Highest (was Free=Standard, Pro=High).

Docs only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@gradill22 gradill22 self-assigned this Jul 24, 2026
CI installs ruff unpinned (`ruff>=0.4`/`>=0.6`) and runs `ruff check .`.
A newer ruff release broadened its *default* rule selection to include
pyupgrade / flake8-simplify / isort / ruff-native rules, which turned CI
red on code that was clean at merge time (UP006/UP007/UP035/UP037/UP045,
SIM117/SIM118, I001, RUF012) — none of them E/F errors.

Pin `[tool.ruff.lint] select` to ruff's classic default (E4/E7/E9/F) so
`ruff check` verifies what these repos were written against regardless of
which ruff version CI installs. Adopting the newer rule families is a
deliberate migration for a separate PR.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@gradill22
gradill22 merged commit 0ae6877 into main Jul 24, 2026
6 checks passed
@gradill22
gradill22 deleted the docs/readme-full-sync branch July 24, 2026 00:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant