apify 2.7.1b3__tar.gz → 2.7.2__tar.gz

{apify-2.7.1b3 → apify-2.7.2}/.github/workflows/pre_release.yaml

@@ -32,26 +32,26 @@ jobs:
     name: Lint check
     uses: apify/workflows/.github/workflows/python_lint_check.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   type_check:
     name: Type check
     uses: apify/workflows/.github/workflows/python_type_check.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   unit_tests:
     name: Unit tests
     uses: apify/workflows/.github/workflows/python_unit_tests.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   integration_tests:
     name: Integration tests
     uses: apify/workflows/.github/workflows/python_integration_tests.yaml@main
     secrets: inherit
     with:
-      python-versions: '["3.10", "3.13"]'
+      python-versions: '["3.9", "3.13"]'
 
   update_changelog:
     name: Update changelog

{apify-2.7.1b3 → apify-2.7.2}/.github/workflows/release.yaml

@@ -43,26 +43,26 @@ jobs:
     name: Lint check
     uses: apify/workflows/.github/workflows/python_lint_check.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   type_check:
     name: Type check
     uses: apify/workflows/.github/workflows/python_type_check.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   unit_tests:
     name: Unit tests
     uses: apify/workflows/.github/workflows/python_unit_tests.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   integration_tests:
     name: Integration tests
     uses: apify/workflows/.github/workflows/python_integration_tests.yaml@main
     secrets: inherit
     with:
-      python-versions: '["3.10", "3.13"]'
+      python-versions: '["3.9", "3.13"]'
 
   update_changelog:
     name: Update changelog

{apify-2.7.1b3 → apify-2.7.2}/.github/workflows/run_code_checks.yaml

@@ -11,19 +11,19 @@ jobs:
     name: Lint check
     uses: apify/workflows/.github/workflows/python_lint_check.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   type_check:
     name: Type check
     uses: apify/workflows/.github/workflows/python_type_check.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   unit_tests:
     name: Unit tests
     uses: apify/workflows/.github/workflows/python_unit_tests.yaml@main
     with:
-      python-versions: '["3.10", "3.11", "3.12", "3.13"]'
+      python-versions: '["3.9", "3.10", "3.11", "3.12", "3.13"]'
 
   docs_check:
     name: Docs check
@@ -35,4 +35,4 @@ jobs:
     uses: apify/workflows/.github/workflows/python_integration_tests.yaml@main
     secrets: inherit
     with:
-      python-versions: '["3.10", "3.13"]'
+      python-versions: '["3.9", "3.13"]'

{apify-2.7.1b3 → apify-2.7.2}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.7.2](https://github.com/apify/apify-sdk-python/releases/tag/v2.7.2) (2025-07-30)
+
+### 🐛 Bug Fixes
+
+- Restrict apify-shared and apify-client versions (#523) ([581ebae](https://github.com/apify/apify-sdk-python/commit/581ebae5752a984a34cbabc02c49945ae392db00))
+
+
+## [2.7.1](https://github.com/apify/apify-sdk-python/releases/tag/v2.7.1) (2025-07-24)
+
+### 🐛 Bug Fixes
+
+- Add back support for Python 3.9.
+
+
 ## [2.7.0](https://github.com/apify/apify-sdk-python/releases/tag/v2.7.0) (2025-07-14)
 
 ### 🚀 Features
@@ -9,11 +23,6 @@ All notable changes to this project will be documented in this file.
 - Expose `logger` argument on `Actor.call` to control log redirection from started Actor run ([#487](https://github.com/apify/apify-sdk-python/pull/487)) ([aa6fa47](https://github.com/apify/apify-sdk-python/commit/aa6fa4750ea1bc7909be1191c0d276a2046930c2)) by [@Pijukatel](https://github.com/Pijukatel)
 - **crypto:** Decrypt secret objects ([#482](https://github.com/apify/apify-sdk-python/pull/482)) ([ce9daf7](https://github.com/apify/apify-sdk-python/commit/ce9daf7381212b8dc194e8a643e5ca0dedbc0078)) by [@MFori](https://github.com/MFori)
 
-### 🐛 Bug Fixes
-
-- Sync `@docusaurus` theme version [internal] ([#500](https://github.com/apify/apify-sdk-python/pull/500)) ([a7485e7](https://github.com/apify/apify-sdk-python/commit/a7485e7d2276fde464ce862573d5b95e7d4d836a)) by [@katzino](https://github.com/katzino)
-- Tagline overlap ([#501](https://github.com/apify/apify-sdk-python/pull/501)) ([bae8340](https://github.com/apify/apify-sdk-python/commit/bae8340c46fea756ea35ea4d591da84c09d478e2)) by [@katzino](https://github.com/katzino)
-
 
 ## [2.6.0](https://github.com/apify/apify-sdk-python/releases/tag/v2.6.0) (2025-06-09)
 

{apify-2.7.1b3 → apify-2.7.2}/CONTRIBUTING.md

@@ -4,7 +4,7 @@ Here you'll find a contributing guide to get started with development.
 
 ## Environment
 
-For local development, it is required to have Python 3.10 (or a later version) installed.
+For local development, it is required to have Python 3.9 (or a later version) installed.
 
 We use [uv](https://docs.astral.sh/uv/) for project management. Install it and set up your IDE accordingly.
 

{apify-2.7.1b3 → apify-2.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apify
-Version: 2.7.1b3
+Version: 2.7.2
 Summary: Apify SDK for Python
 Project-URL: Apify Homepage, https://apify.com
 Project-URL: Changelog, https://docs.apify.com/sdk/python/docs/changelog
@@ -219,14 +219,15 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: >=3.10
-Requires-Dist: apify-client>=1.11.0
-Requires-Dist: apify-shared>=1.3.0
+Requires-Python: >=3.9
+Requires-Dist: apify-client<2.0.0
+Requires-Dist: apify-shared<2.0.0
 Requires-Dist: crawlee~=0.6.0
 Requires-Dist: cryptography>=42.0.0
 Requires-Dist: httpx>=0.27.0

{apify-2.7.1b3 → apify-2.7.2}/docs/01_overview/02_running_actors_locally.mdx

@@ -11,7 +11,7 @@ In this page, you'll learn how to create and run Apify Actors locally on your co
 
 ## Requirements
 
-The Apify SDK requires Python version 3.10 or above to run Python Actors locally.
+The Apify SDK requires Python version 3.9 or above to run Python Actors locally.
 
 ## Creating your first Actor
 

{apify-2.7.1b3 → apify-2.7.2}/docs/03_concepts/10_logging.mdx

@@ -7,8 +7,6 @@ import CodeBlock from '@theme/CodeBlock';
 
 import LogConfigExample from '!!raw-loader!./code/10_log_config.py';
 import LoggerUsageExample from '!!raw-loader!./code/10_logger_usage.py';
-import RedirectLog from '!!raw-loader!./code/10_redirect_log.py';
-import RedirectLogExistingRun from '!!raw-loader!./code/10_redirect_log_existing_run.py';
 
 The Apify SDK is logging useful information through the [`logging`](https://docs.python.org/3/library/logging.html) module from Python's standard library, into the logger with the name `apify`.
 
@@ -84,31 +82,3 @@ Result:
 </pre>
 
 <!-- markdownlint-enable no-inline-html -->
-
-## Redirect logs from other Actor runs
-
-In some situations, one Actor is going to start one or more other Actors and wait for them to finish and produce some results. In such cases, you might want to redirect the logs and status messages of the started Actors runs back to the parent Actor run, so that you can see the progress of the started Actors' runs in the parent Actor's logs. This guide will show possibilities on how to do it.
-
-### Redirecting logs from Actor.call
-
-Typical use case for log redirection is to call another Actor using the [`Actor.call`](../../reference/class/Actor#call) method. This method has an optional `logger` argument, which is by default set to the `default` literal. This means that the logs of the called Actor will be automatically redirected to the parent Actor's logs with default formatting and filtering. If you set the `logger` argument to `None`, then no log redirection happens. The third option is to pass your own `Logger` instance with the possibility to define your own formatter, filter, and handler. Below you can see those three possible ways of log redirection when starting another Actor run through [`Actor.call`](../../reference/class/Actor#call).
-
-<CodeBlock className="language-python">
-    {RedirectLog}
-</CodeBlock>
-
-Each default redirect logger log entry will have a specific format. After the timestamp, it will contain cyan colored text that will contain the redirect information - the other actor's name and the run ID. The rest of the log message will be printed in the same manner as the parent Actor's logger is configured.
-
-The log redirection can be deep, meaning that if the other actor also starts another actor and is redirecting logs from it, then in the top-level Actor, you can see it as well. See the following example screenshot of the Apify log console when one actor recursively starts itself (there are 2 levels of recursion in the example).
-
-![Console with redirected logs](/img/guides/redirected_logs_example.webp 'Example of console with redirected logs from recursively started actor.')
-
-### Redirecting logs from already running Actor run
-
-In some cases, you might want to connect to an already running Actor run and redirect its logs to your current Actor run. This can be done using the [ApifyClient](../../reference/class/Actor#apify_client) and getting the streamed log from a specific Actor run. You can then use it as a context manager, and the log redirection will be active in the context, or you can control the log redirection manually by explicitly calling `start` and `stop` methods.
-
-You can further decide whether you want to redirect just new logs of the ongoing Actor run, or if you also want to redirect historical logs from that Actor's run, so all logs it has produced since it was started. Both options are shown in the example code below.
-
-<CodeBlock className="language-python">
-    {RedirectLogExistingRun}
-</CodeBlock>

{apify-2.7.1b3 → apify-2.7.2}/pyproject.toml

@@ -4,18 +4,19 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apify"
-version = "2.7.1b3"
+version = "2.7.2"
 description = "Apify SDK for Python"
 authors = [{ name = "Apify Technologies s.r.o.", email = "support@apify.com" }]
 license = { file = "LICENSE" }
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.9"
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -34,8 +35,8 @@ keywords = [
     "scraping",
 ]
 dependencies = [
-    "apify-client>=1.11.0",
-    "apify-shared>=1.3.0",
+    "apify-client<2.0.0",
+    "apify-shared<2.0.0",
     "crawlee~=0.6.0",
     "cryptography>=42.0.0",
     "httpx>=0.27.0",
@@ -64,11 +65,11 @@ scrapy = ["scrapy>=2.11.0"]
 dev = [
     "build~=1.2.0",
     "dycw-pytest-only>=2.1.1",
-    "griffe~=1.8.0",
-    "mypy~=1.17.0",
+    "griffe~=1.7.0",
+    "mypy~=1.16.0",
     "pre-commit~=4.2.0",
     "pydoc-markdown~=4.8.0",
-    "pytest-asyncio~=1.1.0",
+    "pytest-asyncio~=1.0.0",
     "pytest-cov~=6.2.0",
     "pytest-timeout>=2.4.0",
     "pytest-xdist~=3.8.0",
@@ -187,7 +188,7 @@ asyncio_mode = "auto"
 timeout = 1200
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.9"
 plugins = ["pydantic.mypy"]
 files = ["src", "tests", "docs", "website"]
 check_untyped_defs = true
@@ -214,7 +215,7 @@ module = [
 ignore_missing_imports = true
 
 [tool.basedpyright]
-pythonVersion = "3.10"
+pythonVersion = "3.9"
 typeCheckingMode = "standard"
 include = ["src", "tests", "docs", "website"]
 

{apify-2.7.1b3 → apify-2.7.2}/src/apify/_actor.py

@@ -5,7 +5,7 @@ import os
 import sys
 from contextlib import suppress
 from datetime import datetime, timedelta, timezone
-from typing import TYPE_CHECKING, Any, Literal, TypeVar, cast, overload
+from typing import TYPE_CHECKING, Any, Callable, Literal, TypeVar, cast, overload
 
 from lazy_object_proxy import Proxy
 from more_itertools import flatten
@@ -13,7 +13,7 @@ from pydantic import AliasChoices
 
 from apify_client import ApifyClientAsync
 from apify_shared.consts import ActorEnvVars, ActorExitCodes, ApifyEnvVars
-from apify_shared.utils import maybe_extract_enum_member_value
+from apify_shared.utils import ignore_docs, maybe_extract_enum_member_value
 from crawlee import service_locator
 from crawlee.events import (
     Event,
@@ -39,7 +39,6 @@ from apify.storages import Dataset, KeyValueStore, RequestQueue
 
 if TYPE_CHECKING:
     import logging
-    from collections.abc import Callable
     from types import TracebackType
 
     from typing_extensions import Self
@@ -54,46 +53,9 @@ MainReturnType = TypeVar('MainReturnType')
 
 
 @docs_name('Actor')
-@docs_group('Actor')
+@docs_group('Classes')
 class _ActorType:
-    """The core class for building Actors on the Apify platform.
-
-    Actors are serverless programs running in the cloud that can perform anything from simple actions
-    (such as filling out a web form or sending an email) to complex operations (such as crawling an
-    entire website or removing duplicates from a large dataset). They are packaged as Docker containers
-    which accept well-defined JSON input, perform an action, and optionally produce well-defined output.
-
-    ### References
-
-    - Apify platform documentation: https://docs.apify.com/platform/actors
-    - Actor whitepaper: https://whitepaper.actor/
-
-    ### Usage
-
-    ```python
-    import asyncio
-
-    import httpx
-    from apify import Actor
-    from bs4 import BeautifulSoup
-
-
-    async def main() -> None:
-        async with Actor:
-            actor_input = await Actor.get_input()
-            async with httpx.AsyncClient() as client:
-                response = await client.get(actor_input['url'])
-            soup = BeautifulSoup(response.content, 'html.parser')
-            data = {
-                'url': actor_input['url'],
-                'title': soup.title.string if soup.title else None,
-            }
-            await Actor.push_data(data)
-
-    if __name__ == '__main__':
-        asyncio.run(main())
-    ```
-    """
+    """The class of `Actor`. Only make a new instance if you're absolutely sure you need to."""
 
     _is_rebooting = False
     _is_any_instance_initialized = False
@@ -145,6 +107,7 @@ class _ActorType:
 
         self._is_initialized = False
 
+    @ignore_docs
     async def __aenter__(self) -> Self:
         """Initialize the Actor.
 
@@ -156,6 +119,7 @@ class _ActorType:
         await self.init()
         return self
 
+    @ignore_docs
     async def __aexit__(
         self,
         _exc_type: type[BaseException] | None,

{apify-2.7.1b3 → apify-2.7.2}/src/apify/_charging.py

@@ -4,10 +4,11 @@ import math
 from dataclasses import dataclass
 from datetime import datetime, timezone
 from decimal import Decimal
-from typing import TYPE_CHECKING, Protocol
+from typing import TYPE_CHECKING, Protocol, Union
 
 from pydantic import TypeAdapter
 
+from apify_shared.utils import ignore_docs
 from crawlee._utils.context import ensure_context
 
 from apify._models import ActorRun, PricingModel
@@ -22,21 +23,13 @@ if TYPE_CHECKING:
 
     from apify._configuration import Configuration
 
-run_validator = TypeAdapter[ActorRun | None](ActorRun | None)
 
+run_validator: TypeAdapter[ActorRun | None] = TypeAdapter(Union[ActorRun, None])
 
-@docs_group('Charging')
-class ChargingManager(Protocol):
-    """Provides fine-grained access to pay-per-event functionality.
-
-    The ChargingManager allows you to charge for specific events in your Actor when using
-    the pay-per-event pricing model. This enables precise cost control and transparent
-    billing for different operations within your Actor.
 
-    ### References
-
-    - Apify platform documentation: https://docs.apify.com/platform/actors/publishing/monetize
-    """
+@docs_group('Interfaces')
+class ChargingManager(Protocol):
+    """Provides fine-grained access to pay-per-event functionality."""
 
     async def charge(self, event_name: str, count: int = 1) -> ChargeResult:
         """Charge for a specified number of events - sub-operations of the Actor.
@@ -65,7 +58,7 @@ class ChargingManager(Protocol):
         """
 
 
-@docs_group('Charging')
+@docs_group('Data structures')
 @dataclass(frozen=True)
 class ChargeResult:
     """Result of the `ChargingManager.charge` method."""
@@ -80,7 +73,7 @@ class ChargeResult:
     """How many events of each known type can still be charged within the limit."""
 
 
-@docs_group('Charging')
+@docs_group('Data structures')
 @dataclass
 class ActorPricingInfo:
     """Result of the `ChargingManager.get_pricing_info` method."""
@@ -98,6 +91,7 @@ class ActorPricingInfo:
     """Price of every known event type."""
 
 
+@ignore_docs
 class ChargingManagerImplementation(ChargingManager):
     """Implementation of the `ChargingManager` Protocol - this is only meant to be instantiated internally."""
 

{apify-2.7.1b3 → apify-2.7.2}/src/apify/_configuration.py

@@ -25,7 +25,7 @@ def _transform_to_list(value: Any) -> list[str] | None:
     return value if isinstance(value, list) else str(value).split(',')
 
 
-@docs_group('Configuration')
+@docs_group('Classes')
 class Configuration(CrawleeConfiguration):
     """A class for specifying the configuration of an Actor.
 

{apify-2.7.1b3 → apify-2.7.2}/src/apify/_crypto.py

@@ -12,6 +12,7 @@ from cryptography.hazmat.primitives import hashes, serialization
 from cryptography.hazmat.primitives.asymmetric import padding, rsa
 from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
 
+from apify_shared.utils import ignore_docs
 from crawlee._utils.crypto import crypto_random_object_id
 
 from apify._consts import ENCRYPTED_INPUT_VALUE_REGEXP, ENCRYPTED_JSON_VALUE_PREFIX, ENCRYPTED_STRING_VALUE_PREFIX
@@ -21,6 +22,7 @@ ENCRYPTION_IV_LENGTH = 16
 ENCRYPTION_AUTH_TAG_LENGTH = 16
 
 
+@ignore_docs
 def public_encrypt(value: str, *, public_key: rsa.RSAPublicKey) -> dict:
     """Encrypts the given value using AES cipher and the password for encryption using the public key.
 
@@ -64,6 +66,7 @@ def public_encrypt(value: str, *, public_key: rsa.RSAPublicKey) -> dict:
     }
 
 
+@ignore_docs
 def private_decrypt(
     encrypted_password: str,
     encrypted_value: str,
@@ -115,6 +118,7 @@ def private_decrypt(
     return decipher_bytes.decode('utf-8')
 
 
+@ignore_docs
 def load_private_key(private_key_file_base64: str, private_key_password: str) -> rsa.RSAPrivateKey:
     private_key = serialization.load_pem_private_key(
         base64.b64decode(private_key_file_base64.encode('utf-8')),
@@ -134,6 +138,7 @@ def _load_public_key(public_key_file_base64: str) -> rsa.RSAPublicKey:
     return public_key
 
 
+@ignore_docs
 def decrypt_input_secrets(private_key: rsa.RSAPrivateKey, input_data: Any) -> Any:
     """Decrypt input secrets."""
     if not isinstance(input_data, dict):
@@ -175,6 +180,7 @@ def encode_base62(num: int) -> str:
     return res
 
 
+@ignore_docs
 def create_hmac_signature(secret_key: str, message: str) -> str:
     """Generate an HMAC signature and encodes it using Base62. Base62 encoding reduces the signature length.
 

{apify-2.7.1b3 → apify-2.7.2}/src/apify/_models.py

@@ -13,10 +13,10 @@ from crawlee._utils.urls import validate_http_url
 from apify._utils import docs_group
 
 if TYPE_CHECKING:
-    from typing import TypeAlias
+    from typing_extensions import TypeAlias
 
 
-@docs_group('Actor')
+@docs_group('Data structures')
 class Webhook(BaseModel):
     __model_config__ = ConfigDict(populate_by_name=True)
 
@@ -35,14 +35,14 @@ class Webhook(BaseModel):
     ] = None
 
 
-@docs_group('Actor')
+@docs_group('Data structures')
 class ActorRunMeta(BaseModel):
     __model_config__ = ConfigDict(populate_by_name=True)
 
     origin: Annotated[MetaOrigin, Field()]
 
 
-@docs_group('Actor')
+@docs_group('Data structures')
 class ActorRunStats(BaseModel):
     __model_config__ = ConfigDict(populate_by_name=True)
 
@@ -63,7 +63,7 @@ class ActorRunStats(BaseModel):
     compute_units: Annotated[float, Field(alias='computeUnits')]
 
 
-@docs_group('Actor')
+@docs_group('Data structures')
 class ActorRunOptions(BaseModel):
     __model_config__ = ConfigDict(populate_by_name=True)
 
@@ -74,7 +74,7 @@ class ActorRunOptions(BaseModel):
     max_total_charge_usd: Annotated[Decimal | None, Field(alias='maxTotalChargeUsd')] = None
 
 
-@docs_group('Actor')
+@docs_group('Data structures')
 class ActorRunUsage(BaseModel):
     __model_config__ = ConfigDict(populate_by_name=True)
 
@@ -92,7 +92,7 @@ class ActorRunUsage(BaseModel):
     proxy_serps: Annotated[float | None, Field(alias='PROXY_SERPS')] = None
 
 
-@docs_group('Actor')
+@docs_group('Data structures')
 class ActorRun(BaseModel):
     __model_config__ = ConfigDict(populate_by_name=True)
 

{apify-2.7.1b3 → apify-2.7.2}/src/apify/_platform_event_manager.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import asyncio
 from datetime import datetime
-from typing import TYPE_CHECKING, Annotated, Any, Literal
+from typing import TYPE_CHECKING, Annotated, Any, Literal, Union
 
 import websockets.asyncio.client
 from pydantic import BaseModel, Discriminator, Field, TypeAdapter
@@ -27,10 +27,17 @@ if TYPE_CHECKING:
 
     from apify._configuration import Configuration
 
+
 __all__ = ['EventManager', 'LocalEventManager', 'PlatformEventManager']
 
 
-@docs_group('Event data')
+@docs_group('Data structures')
+class PersistStateEvent(BaseModel):
+    name: Literal[Event.PERSIST_STATE]
+    data: Annotated[EventPersistStateData, Field(default_factory=lambda: EventPersistStateData(is_migrating=False))]
+
+
+@docs_group('Data structures')
 class SystemInfoEventData(BaseModel):
     mem_avg_bytes: Annotated[float, Field(alias='memAvgBytes')]
     mem_current_bytes: Annotated[float, Field(alias='memCurrentBytes')]
@@ -57,37 +64,31 @@ class SystemInfoEventData(BaseModel):
         )
 
 
-@docs_group('Events')
-class PersistStateEvent(BaseModel):
-    name: Literal[Event.PERSIST_STATE]
-    data: Annotated[EventPersistStateData, Field(default_factory=lambda: EventPersistStateData(is_migrating=False))]
-
-
-@docs_group('Events')
+@docs_group('Data structures')
 class SystemInfoEvent(BaseModel):
     name: Literal[Event.SYSTEM_INFO]
     data: SystemInfoEventData
 
 
-@docs_group('Events')
+@docs_group('Data structures')
 class MigratingEvent(BaseModel):
     name: Literal[Event.MIGRATING]
     data: Annotated[EventMigratingData, Field(default_factory=EventMigratingData)]
 
 
-@docs_group('Events')
+@docs_group('Data structures')
 class AbortingEvent(BaseModel):
     name: Literal[Event.ABORTING]
     data: Annotated[EventAbortingData, Field(default_factory=EventAbortingData)]
 
 
-@docs_group('Events')
+@docs_group('Data structures')
 class ExitEvent(BaseModel):
     name: Literal[Event.EXIT]
     data: Annotated[EventExitData, Field(default_factory=EventExitData)]
 
 
-@docs_group('Events')
+@docs_group('Data structures')
 class EventWithoutData(BaseModel):
     name: Literal[
         Event.SESSION_RETIRED,
@@ -100,26 +101,41 @@ class EventWithoutData(BaseModel):
     data: Any = None
 
 
-@docs_group('Events')
+@docs_group('Data structures')
 class DeprecatedEvent(BaseModel):
     name: Literal['cpuInfo']
     data: Annotated[dict[str, Any], Field(default_factory=dict)]
 
 
-@docs_group('Events')
+@docs_group('Data structures')
 class UnknownEvent(BaseModel):
     name: str
     data: Annotated[dict[str, Any], Field(default_factory=dict)]
 
 
-EventMessage = PersistStateEvent | SystemInfoEvent | MigratingEvent | AbortingEvent | ExitEvent | EventWithoutData
-
-event_data_adapter = TypeAdapter[EventMessage | DeprecatedEvent | UnknownEvent](
-    Annotated[EventMessage, Discriminator('name')] | DeprecatedEvent | UnknownEvent
+EventMessage = Union[
+    PersistStateEvent,
+    SystemInfoEvent,
+    MigratingEvent,
+    AbortingEvent,
+    ExitEvent,
+    EventWithoutData,
+]
+
+
+event_data_adapter: TypeAdapter[EventMessage | DeprecatedEvent | UnknownEvent] = TypeAdapter(
+    Union[
+        Annotated[
+            EventMessage,
+            Discriminator('name'),
+        ],
+        DeprecatedEvent,
+        UnknownEvent,
+    ]
 )
 
 
-@docs_group('Event managers')
+@docs_group('Classes')
 class PlatformEventManager(EventManager):
     """A class for managing Actor events.