refactor!: Adapt to apify-client v3#719
Draft
vdusek wants to merge 1 commit into
Draft
Conversation
github-actions
Bot
added
t-tooling
Codecov Report❌ Patch coverage is Additional details and impacted files@@ Coverage Diff @@
## drop-python-3.10 #719 +/- ##
====================================================
- Coverage 87.05% 86.31% -0.75%
====================================================
Files 48 47 -1
Lines 2943 2849 -94
====================================================
- Hits 2562 2459 -103
- Misses 381 390 +9
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
a45f20c to
4270cb9
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
c26dd9f to
7d6dbb1
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
3 times, most recently
from
3e14e50 to
12a29ae
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
ba4d354 to
e094d6a
Compare
This was referenced Feb 5, 2026
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
4528205 to
9c44f3b
Compare
vdusek
added a commit
to apify/apify-client-python
that referenced
this pull request
Feb 23, 2026
### Summary This is a major refactoring that introduces fully typed Pydantic models throughout the client library. The models are generated from the OpenAPI specifications. All API responses now return typed objects instead of raw dictionaries. This follows up on apify/apify-docs#2182. ### Issues - Closes: #21 - Closes: #481 ### Packages - Add direct dependency on `Pydantic`. - Removes the dependency on `apify-shared`. - Add dev dependency [datamodel-code-generator](https://koxudaxi.github.io/datamodel-code-generator/) for model generation. ### Key changes - Uses [datamodel-code-generator](https://koxudaxi.github.io/datamodel-code-generator/) tool configured via `pyproject.toml` to generate Pydantic models based on the [OpenAPI specs](https://docs.apify.com/api/openapi.json). - Refactors the whole codebase to adopt the new generated models. - All resource clients now return typed Pydantic models (`Actor`, `Task`, `Run`, etc.). - Adds response wrappers for validating and extracting API response data. - Updates list methods to return typed pagination models. - Documentation examples now use typed attribute access. - Updates the SDK to use the new typed client. - See the corresponding PR in `apify/apify-sdk-python` for details - apify/apify-sdk-python#719. - It will be merged later. ### Architecture - Get rid of 3/4/5 levels of inheritance. - Get rid of inline imports because of circular dependencies. - I had to utilize `ClientRegistry` to be able to achieve that (because of resource clients-siblings imports). ### Breaking changes - Client methods now return Pydantic models instead of dicts. - Access patterns change from dict-style (`result['key']`) to attribute-style (`result.key`). ### Test plan - Updated test concurrency to 16 workers. - A lot of new tests were implemented - coverage ~95%. - Unit tests - do not call production API, only for testing utils or other functionality using mocks. - Integration tests - call production API. - Thanks to the new tests, I was able to do a lot of fixes in the OpenAPI specs. ### Next steps - Explore the generation of resource clients using [openapi-python-client](https://github.com/openapi-generators/openapi-python-client). - Fully automate model updates based on changes in [apify-api/openapi](https://github.com/apify/apify-docs/tree/master/apify-api/openapi). - This will be released as part of the Apify client v3.0.
vdusek
changed the title
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
2 times, most recently
from
8057e7c to
05a8aba
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
a5fb9c8 to
fc2dde8
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
fc2dde8 to
e3439b4
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
2 times, most recently
from
7ac5f59 to
2019646
Compare
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
3 times, most recently
from
4a98a06 to
cb9ed09
Compare
Bump apify-client to v3 (>=3.0.0,<4.0.0) and re-use its models, literals, and constants instead of maintaining SDK-side duplicates. - Replace SDK models with apify-client equivalents (e.g. `Run` instead of `ActorRun`) and import pricing models from the client; remove the now redundant `src/apify/_models.py`. - Drop the `apify-shared` dependency and define the few needed constants locally in `_consts.py`. - Adapt `Actor.start`/`call`/`call_task` to the v3 `run_timeout` API and tolerate platform pricing-info env var omissions. - Adapt the Apify storage clients (dataset, key-value store, request queue) to the v3 client surface. - Refresh `uv.lock` (apify-client 3.0.2, drops apify-shared, adds dnspython/email-validator). - Align unit, integration, and e2e tests with the v3 type and model changes. BREAKING CHANGE: requires apify-client v3; SDK-side model and literal duplicates are removed in favor of those exported by apify-client. Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
vdusek
force-pushed
the
adapt-to-apify-client-v3
branch
from
cb9ed09 to
24a6fa8
Compare
vdusek
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
apify-python-clientv3, which introduces fully typed API clients generated from OpenAPI specifications.Issues
RemainingTimeliteral toinherit#697PricingModel#853Testing
apify-python-clientv3.