Skip to content

docs: Remove stale client_class arg from SqlClientMixin docstring#2022

Merged
vdusek merged 1 commit into
apify:masterfrom
anxkhn:docs/prune-safely-open-client-class-arg
Jul 6, 2026
Merged

docs: Remove stale client_class arg from SqlClientMixin docstring#2022
vdusek merged 1 commit into
apify:masterfrom
anxkhn:docs/prune-safely-open-client-class-arg

Conversation

@anxkhn

@anxkhn anxkhn commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

SqlClientMixin._safely_open (src/crawlee/storage_clients/_sql/_client_mixin.py)
had a Google-style Args block that documented a client_class parameter which is
not part of the method signature. The method's keyword-only parameters are id,
name, alias, storage_client, metadata_model, and extra_metadata_fields,
so the client_class line was stale documentation for an argument that does not
exist.

This removes that single line so the documented arguments match the actual
signature, consistent with the sibling _open method whose Args block already
matches its signature. No code behavior changes.

Issues

  • None. Self-identified documentation fix; no tracked issue.

Testing

  • Docstring-only change, so no runtime test is added (matches how comparable
    doc fixes are handled here).
  • uv run poe lint (ruff format check + ruff check): clean.
  • uv run poe type-check (ty): no new diagnostics from this change; the only
    diagnostics are pre-existing unresolved-import warnings for the optional,
    uninstalled pydantic_ai dependency, and none reference the touched file.
  • uv run pytest tests/unit/storage_clients/_sql/: 34 passed (these exercise the
    _safely_open open paths for dataset / KVS / request-queue / storage clients).

Checklist

  • CI passed

…cstring

The `_safely_open` Args block documented a `client_class` parameter that is
not part of the method signature. Remove the stale line so the documented
arguments match the actual signature (id, name, alias, storage_client,
metadata_model, extra_metadata_fields), consistent with the sibling `_open`
method's docstring.
@vdusek vdusek changed the title docs: drop stale client_class arg from SqlClientMixin._safely_open docstring docs: Remove stale client_class arg from SqlClientMixin docstring Jul 6, 2026
@vdusek vdusek merged commit 58aa9ad into apify:master Jul 6, 2026
35 checks passed
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.

3 participants