Skip to content

Sdk review updates - #18

Open
dariyaanis wants to merge 11 commits into
mainfrom
sdk-review-updates
Open

dariyaanis wants to merge 11 commits into
mainfrom
sdk-review-updates

Conversation

@dariyaanis

@dariyaanis dariyaanis commented Oct 28, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

This PR applies the SDK review updates as a series of focused commits:

  • point the package metadata documentation link to the SDK README;
  • validate required task parameters locally before sending an API request;
  • clarify CAPTCHA types that do not have a separate proxy task variant;
  • document why the intentionally empty py.typed marker is required;
  • split proxy and proxyless examples into separate sync and async files;
  • add a security policy with private vulnerability reporting instructions;
  • bump the package version from 1.0.4 to 1.0.5.

The existing public API documentation was also reviewed. Public clients, methods, task classes, and exceptions already provide Python docstrings, type annotations, parameter descriptions, return values, raised exceptions, and usage examples.

Validation

  • python -m pytest -q -p no:cacheprovider - 86 passed
  • python -m ruff check . - passed
  • python -m build - sdist and wheel built successfully
  • python -m twine check --strict dist/* - passed

Release

After this PR is merged and the main workflow passes, tag the merge commit as v1.0.5 and push the tag. The existing publish workflow will verify the version, publish the package to PyPI, and create the GitHub release.

dariyaanis and others added 11 commits October 28, 2026 15:34
- reject whitespace-only client_key in both clients
- document ValidationError in solve() and create_task() docstrings and README
- mark every task parameter as Required or Optional in docstrings
- replace em dash in proxy support table with a plain dash
- update README references to renamed example files

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

2 participants