Refactor for Python 3.10 compatibility

[zombyacoff]

Summary by cubic

Set Python 3.10 as the new baseline across the library, CI, and tooling. Removed deprecated Faceit/AsyncFaceit, modernized typing and validators, switched to uv_build, and bumped the package to 0.3.0.

• Refactors

  • Drop Python 3.8/3.9; set requires-python = ">=3.10", update classifiers (incl. 3.15) and README badge.
  • Replace legacy typing with Python 3.10 features (X | Y unions, final, overload, TypeAlias); tighten generics and TYPE_CHECKING usage.
  • Simplify Pydantic validation (use AfterValidator directly); improve timestamp handling.
  • Rename warn_stacklevel to find_user_stacklevel; adjust imports.
  • Remove faceit/faceit.py and the deprecated Faceit/AsyncFaceit exports; clean __all__.
  • Exceptions: keep base API exceptions extensible (remove final on base types).
  • Tooling/CI: set ruff target-version = "py310", mypy python_version = 3.10, ignore docs/*; CI matrix runs on 3.10.0–3.14; run only on push (drop pull_request trigger).
  • Build/publish: migrate to uv_build; use uv build and uv publish.

• Migration

  • Python 3.10+ is required.
  • Replace deprecated entry points:
    • Use SyncDataResource or AsyncDataResource instead of Faceit/AsyncFaceit or Faceit.data().

^{Written for commit b1f2b37. Summary will update on new commits. Review in cubic}

[cubic-dev-ai]

2 issues found across 45 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/faceit/api/pagination.py">

<violation number="1" location="src/faceit/api/pagination.py:53">
P1: Module-level `TypeAlias` assignments use 3.9/3.10-only runtime typing syntax, which breaks imports on supported Python 3.8 environments.</violation>
</file>

<file name="src/faceit/api/data/matches.py">

<violation number="1" location="src/faceit/api/data/matches.py:23">
P1: Dropping `FaceitMatchID._validate` removes the prefix and UUID validation from the after-validator. `FaceitMatchID` itself is a `str` subclass whose constructor performs no validation; only the `_validate` classmethod enforces the expected format.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

P1: Module-level TypeAlias assignments use 3.9/3.10-only runtime typing syntax, which breaks imports on supported Python 3.8 environments.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/faceit/api/pagination.py, line 53:

<comment>Module-level `TypeAlias` assignments use 3.9/3.10-only runtime typing syntax, which breaks imports on supported Python 3.8 environments.</comment>

<file context>
@@ -31,36 +45,31 @@
-_PageType: TypeAlias = typing.Union[ItemPage[typing.Any], RawAPIPageResponse]
-_PageList: TypeAlias = typing.List[_PageType]
-_PageT = typing.TypeVar("_PageT", bound=_PageType)
+_PageType: TypeAlias = RawAPIPageResponse | ItemPage[Any]
+_PageList: TypeAlias = list[_PageType]
+_PageT = TypeVar("_PageT", bound=_PageType)
</file context>

[zombyacoff]

уже не поддерживаем 3.8

[cubic-dev-ai]

Thanks for the feedback! I've saved this as a new learning to improve future reviews.

[cubic-dev-ai]

P1: Dropping FaceitMatchID._validate removes the prefix and UUID validation from the after-validator. FaceitMatchID itself is a str subclass whose constructor performs no validation; only the _validate classmethod enforces the expected format.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/faceit/api/data/matches.py, line 23:

<comment>Dropping `FaceitMatchID._validate` removes the prefix and UUID validation from the after-validator. `FaceitMatchID` itself is a `str` subclass whose constructor performs no validation; only the `_validate` classmethod enforces the expected format.</comment>

<file context>
@@ -19,11 +18,9 @@
 _MatchIDValidated: TypeAlias = Annotated[
-    _MatchID, AfterValidator(FaceitMatchID._validate)
+    _MatchID,
+    AfterValidator(FaceitMatchID),
 ]
 
</file context>

Suggested change

	AfterValidator(FaceitMatchID),
	AfterValidator(FaceitMatchID._validate),

[zombyacoff]

FaceitMatchID have pydantic validation logic

[cubic-dev-ai]

Thanks for the feedback! I've saved this as a new learning to improve future reviews.

[zombyacoff]

review @cubic-dev-ai

[cubic-dev-ai]

review @cubic-dev-ai

@zombyacoff I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

No issues found across 45 files

_{Re-trigger cubic}