faceit 0.3.0__tar.gz → 0.3.2__tar.gz

{faceit-0.3.0 → faceit-0.3.2}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: faceit
-Version: 0.3.0
+Version: 0.3.2
 Summary: The Python wrapper for the FACEIT API
 Keywords: api,faceit,wrapper
 Author: zombyacoff
 Author-email: zombyacoff <zombyacoff@gmail.com>
 License-Expression: Apache-2.0
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
@@ -22,9 +21,9 @@ Requires-Dist: pydantic>=2.13.0
 Requires-Dist: tenacity>=8.5.0
 Requires-Dist: python-decouple>=3.8 ; extra == 'env'
 Requires-Python: >=3.10
-Project-URL: Bug Tracker, https://github.com/zombyacoff/faceit-python/issues
-Project-URL: Releases, https://github.com/zombyacoff/faceit-python/releases
 Project-URL: Repository, https://github.com/zombyacoff/faceit-python
+Project-URL: Releases, https://github.com/zombyacoff/faceit-python/releases
+Project-URL: Bug Tracker, https://github.com/zombyacoff/faceit-python/issues
 Provides-Extra: env
 Description-Content-Type: text/markdown
 
@@ -115,7 +114,8 @@ See additional usage examples in the [examples/](examples/) directory.
 
 You can provide your API key directly in the constructor or let the library automatically load it from your environment.
 
-- **Automatic:** Set the `FACEIT_API_KEY` environment variable. _(Requires `faceit[env]` or manual [python-decouple](https://github.com/HBNetwork/python-decouple) installation)_.
+- **Automatic:** Set the `FACEIT_API_KEY` environment variable.  
+    Requires `faceit[env]` extra dependency or manual [python-decouple](https://github.com/HBNetwork/python-decouple) installation.
 - **Manual:** Pass the key string directly: `SyncDataResource("YOUR_API_KEY")`.
 - **Custom Variable:** To use a different environment variable name, pass an instance of `FromEnv`: `SyncDataResource(FromEnv("SECRET"))`
 

{faceit-0.3.0 → faceit-0.3.2}/README.md

@@ -85,7 +85,8 @@ See additional usage examples in the [examples/](examples/) directory.
 
 You can provide your API key directly in the constructor or let the library automatically load it from your environment.
 
-- **Automatic:** Set the `FACEIT_API_KEY` environment variable. _(Requires `faceit[env]` or manual [python-decouple](https://github.com/HBNetwork/python-decouple) installation)_.
+- **Automatic:** Set the `FACEIT_API_KEY` environment variable.  
+    Requires `faceit[env]` extra dependency or manual [python-decouple](https://github.com/HBNetwork/python-decouple) installation.
 - **Manual:** Pass the key string directly: `SyncDataResource("YOUR_API_KEY")`.
 - **Custom Variable:** To use a different environment variable name, pass an instance of `FromEnv`: `SyncDataResource(FromEnv("SECRET"))`
 

faceit-0.3.2/pyproject.toml

@@ -0,0 +1,168 @@
+[build-system]
+requires = ["uv_build>=0.11.14,<0.12.0"]
+build-backend = "uv_build"
+
+[project]
+name = "faceit"
+version = "0.3.2"
+description = "The Python wrapper for the FACEIT API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "Apache-2.0"
+authors = [
+    { name = "zombyacoff", email = "zombyacoff@gmail.com" },
+]
+keywords = ["api", "faceit", "wrapper"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.28.0",
+    "pydantic>=2.13.0",
+    "tenacity>=8.5.0",
+]
+
+[project.optional-dependencies]
+env = ["python-decouple>=3.8"]
+
+[project.urls]
+"Repository" = "https://github.com/zombyacoff/faceit-python"
+"Releases" = "https://github.com/zombyacoff/faceit-python/releases"
+"Bug Tracker" = "https://github.com/zombyacoff/faceit-python/issues"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.0.0",
+    "pre-commit>=4.6.0",
+    "pytest>=9.0.0",
+    "pytest-asyncio>=1.3.0",
+    # TODO
+    #   Achieve 100% test coverage !!!
+    # "pytest-cov>=7.1.0",
+    "ruff>=0.15.17",
+]
+
+[tool.mypy]
+exclude = [
+    "^docs/",
+    "^local/",
+    "^tests/",
+]
+python_version = "3.10"
+strict = true
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+module = "decouple.*"
+follow_untyped_imports = true
+ignore_missing_imports = true
+
+[tool.pytest]
+asyncio_mode = "auto"
+markers = [
+    "e2e: End-to-end tests that interact with the real FACEIT API"
+]
+
+[tool.ruff]
+line-length = 88
+preview = true
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "ANN401",  # Dynamically typed expressions (`Any`) are disallowed
+    "B024",    # Abstract base class without abstract methods
+    "COM812",  # Trailing comma formatting conflict
+    "CPY001",  # Missing copyright notice
+    "D",       # pydocstyle docstring violations
+    "DOC",     # pydoclint docstring validation violations
+    "E501",    # Line too long
+    "FIX002",  # TODO comment detected
+    "PLR0904", # Too many public methods
+    "PLR0913", # Too many function arguments
+    "RUF003",  # Ambiguous Unicode character in comment
+    "S101",    # Use of assert detected
+    "SLF001",  # Private member accessed outside class
+    "TD",      # flake8-todos violations
+]
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+required-imports = ["from __future__ import annotations"]
+
+[tool.ruff.lint.flake8-bugbear]
+extend-immutable-calls = [
+    "faceit.http.client.env",
+    "faceit.api.pagination.pages",
+]
+
+[tool.ruff.lint.flake8-import-conventions]
+banned-from = [
+    "asyncio", "decouple", "httpx", "inspect", "json", "logging",
+    "math", "os", "random", "re", "reprlib", "tenacity", "warnings",
+]
+
+[tool.ruff.lint.pep8-naming]
+ignore-names = [
+    "env", "pages",
+]
+
+[tool.ruff.lint.pylint]
+allow-dunder-method-names = [
+    "__get_pydantic_core_schema__",
+]
+
+[tool.ruff.lint.flake8-type-checking]
+runtime-evaluated-base-classes = ["pydantic.BaseModel", "faceit.models.base.BaseModel"]
+runtime-evaluated-decorators = ["pydantic.validate_call"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = [
+    "I002",    # Missing required import
+    "RUF067",  # Code is present in `__init__.py`
+]
+"docs/*" = ["ALL"]
+"examples/*" = [
+    "ICN003",  # Import a member from the module instead of importing the member directly
+    "INP001",  # Missing `__init__.py` file in a package directory
+    "PLR0914", # Too many local variables
+    "PLR2004", # Magic value used in a comparison
+    "T201",    # `print()` statement detected
+]
+"exceptions.py" = [
+    "E302",    # Expected 2 blank lines before top-level definitions
+    "E305",    # Expected 2 blank lines after a class or function definition
+]
+"scripts/*" = [
+    "INP001",  # Missing `__init__.py` file in a package directory
+    "T201",    # `print()` statement detected
+]
+"!**/conftest.py" = [
+    "RUF076",  # Avoid using `autouse=True` in `pytest.fixture` decorators
+]
+"tests/*" = [
+    "PLC1901", # Compare to empty string (e.g., `x == ""` instead of `not x`)
+    "PLC2701", # Import of a private name from an external module
+    "PLR0917", # Too many positional arguments
+    "PLR2004", # Magic value used in a comparison
+    "PLR6301", # Method could be a function, class method, or static method (doesn't use `self`)
+    "PLW0717", # `try` contains too many statements
+    "PT011",   # `pytest.raises()` is too broad, set the `match` parameter
+    "PT030",   # `pytest.warns()` is too broad, set the `match` parameter
+]
+"types.py" = [
+    "E302",    # Expected 2 blank lines before top-level definitions
+    "F401",    # Imported but unused
+    "ICN003",  # Import a member from the module instead of importing the member directly
+    "PYI018",  # Unused private `TypeVar`, `ParamSpec`, or `TypeVarTuple` declaration
+]

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/__init__.py

@@ -10,7 +10,6 @@ from importlib.metadata import PackageNotFoundError, version
 from .api import (
     AsyncDataResource as AsyncDataResource,
     AsyncPageIterator as AsyncPageIterator,
-    MaxItems as MaxItems,
     SyncDataResource as SyncDataResource,
     SyncPageIterator as SyncPageIterator,
     TimestampPaginationConfig as TimestampPaginationConfig,

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/__init__.py

@@ -4,7 +4,6 @@ from .data import (
 )
 from .pagination import (
     AsyncPageIterator as AsyncPageIterator,
-    MaxItems as MaxItems,
     SyncPageIterator as SyncPageIterator,
     TimestampPaginationConfig as TimestampPaginationConfig,
     pages as pages,

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/aggregator.py

@@ -4,12 +4,13 @@ from abc import ABC
 from functools import cached_property
 from typing import TYPE_CHECKING, Any, Generic, TypeVar, get_args
 
-from typing_extensions import Never, Self
-
 from faceit.http import AsyncClient, FromEnv, SyncClient
 from faceit.types import ClientT, Raw, ValidUUID
+from faceit.utils import representation
 
 if TYPE_CHECKING:
+    from typing_extensions import Never, Self
+
     from faceit.api.base import BaseResource
     from faceit.http.client import BaseAPIClient
 
@@ -17,6 +18,7 @@ if TYPE_CHECKING:
     _AggregatorT = TypeVar("_AggregatorT", bound="BaseResources[Any]")
 
 
+@representation("client")
 class BaseResources(ABC, Generic[ClientT]):
     __slots__ = ("_client",)
 
@@ -35,12 +37,8 @@ class BaseResources(ABC, Generic[ClientT]):
         if auth is not None and client is not None:
             msg = f"Provide either {secret_type!r} or 'client', not both"
             raise ValueError(msg)
-        self._client = (
-            self._client_cls(
-                FromEnv(f"FACEIT_{secret_type.upper()}") if auth is None else auth
-            )
-            if client is None
-            else client
+        self._client = client or self._client_cls(
+            FromEnv(f"FACEIT_{secret_type.upper()}") if auth is None else auth
         )
 
     @property

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/base.py

@@ -28,7 +28,7 @@ from faceit.types import (
     RawAPIPageResponse,
     RawAPIResponse,
 )
-from faceit.utils import find_user_stacklevel
+from faceit.utils import find_user_stacklevel, representation
 
 if TYPE_CHECKING:
     from collections.abc import Mapping
@@ -40,7 +40,7 @@ _logger = logging.getLogger(__name__)
 # Temporary placeholder type for unimplemented models.
 # Serves as a stub during development and should be replaced with
 # concrete models as implementation progresses.
-ModelPlaceholder: None = None
+ModelPlaceholder = None
 
 
 @final
@@ -50,7 +50,7 @@ class RequestPayload(TypedDict):
 
 
 @final
-@dataclass(eq=False, frozen=True)
+@dataclass(eq=False, frozen=True, kw_only=True)
 class MappedValidatorConfig(Generic[_T, ModelT]):
     validator_map: Mapping[_T, type[ModelT]]
     key_name: str = "key"
@@ -60,12 +60,9 @@ class MappedValidatorConfig(Generic[_T, ModelT]):
 # TODO: Refactor the base resource class if/when support for resources
 # other than Data is required, since the current implementation is
 # too Data-centric.
+@representation("_raw", "_strict_validation")
 class BaseResource(ABC, Generic[ClientT]):
-    __slots__ = (
-        "_client",
-        "_raw",
-        "_strict_validation",
-    )
+    __slots__ = ("_client", "_raw", "_strict_validation")
 
     if TYPE_CHECKING:
         PATH: ClassVar[Endpoint]
@@ -102,10 +99,6 @@ class BaseResource(ABC, Generic[ClientT]):
         cls.PATH = Endpoint(resource_path)
         super().__init_subclass__(**kwargs)
 
-    @property
-    def is_raw(self) -> bool:
-        return self._raw
-
     @property
     def strict_validation_enabled(self) -> bool:
         return self._strict_validation
@@ -178,7 +171,7 @@ class BaseResource(ABC, Generic[ClientT]):
             return validator.model_validate(response)
         except ValidationError:
             _logger.exception("Validation failed for %s", validator.__name__)
-            if self.strict_validation_enabled:
+            if self._strict_validation:
                 raise
             warnings.warn(
                 "Validation failed but strict mode disabled. Raw response returned.",

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/data/championships.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from abc import ABC
-from collections.abc import Sequence  # noqa: TC003
+from collections.abc import Sequence
 from typing import Annotated, Generic, TypeAlias, final, overload
 
 from pydantic import AfterValidator, Field, validate_call

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/data/games.py

@@ -8,12 +8,11 @@ from pydantic import Field, validate_call
 from faceit.api.base import BaseResource, ModelPlaceholder
 from faceit.api.pagination import (
     AsyncPageIterator,
-    MaxItems,
     MaxItemsType,
     SyncPageIterator,
 )
 from faceit.http import AsyncClient, SyncClient
-from faceit.models import ItemPage  # noqa: TC001
+from faceit.models import ItemPage
 from faceit.types import (
     APIResponseFormatT,
     ClientT,
@@ -71,16 +70,16 @@ class SyncGames(BaseGames[SyncClient], Generic[APIResponseFormatT]):
 
     @overload
     def all_items(
-        self: SyncGames[Raw], max_items: MaxItemsType = MaxItems.SAFE
+        self: SyncGames[Raw], max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem]: ...
 
     @overload
     def all_items(
-        self: SyncGames[Model], max_items: MaxItemsType = MaxItems.SAFE
+        self: SyncGames[Model], max_items: MaxItemsType = "safe"
     ) -> ItemPage[ModelNotImplemented]: ...
 
     def all_items(
-        self, max_items: MaxItemsType = MaxItems.SAFE
+        self, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[ModelNotImplemented]:
         iterator = SyncPageIterator(self.items, max_items=max_items)
         return iterator.collect()
@@ -124,16 +123,16 @@ class AsyncGames(BaseGames[AsyncClient], Generic[APIResponseFormatT]):
 
     @overload
     async def all_items(
-        self: AsyncGames[Raw], max_items: MaxItemsType = MaxItems.SAFE
+        self: AsyncGames[Raw], max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem]: ...
 
     @overload
     async def all_items(
-        self: AsyncGames[Model], max_items: MaxItemsType = MaxItems.SAFE
+        self: AsyncGames[Model], max_items: MaxItemsType = "safe"
     ) -> ItemPage[ModelNotImplemented]: ...
 
     async def all_items(
-        self, max_items: MaxItemsType = MaxItems.SAFE
+        self, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[ModelNotImplemented]:
         iterator = AsyncPageIterator(self.items, max_items=max_items)
         return await iterator.collect()

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/data/helpers.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from contextlib import suppress
 from typing import Any
 

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/data/leagues.py

@@ -18,7 +18,7 @@ from faceit.types import (
 )
 from faceit.utils import create_uuid_validator
 
-from .players import PlayerID, PlayerIDValidated  # noqa: TC001
+from .players import PlayerID, PlayerIDValidated
 
 _LeagueID: TypeAlias = ValidUUID
 _LeagueIDValidated: TypeAlias = Annotated[
@@ -106,15 +106,13 @@ class SyncLeagues(BaseLeagues[SyncClient], Generic[APIResponseFormatT]):
         season_id: _SeasonID,
         player_id: PlayerIDValidated,
     ) -> RawAPIItem | ModelNotImplemented:
-        # fmt: off
         return self._validate_response(
             self._client.get(
                 self.__class__.PATH / str(matchmaking_id) / "seasons" / str(season_id) / "players" / str(player_id),
                 expect_item=True,
             ),
             ModelPlaceholder,
-        )
-        # fmt: on
+        )  # fmt: skip
 
 
 @final
@@ -187,12 +185,10 @@ class AsyncLeagues(BaseLeagues[AsyncClient], Generic[APIResponseFormatT]):
         season_id: _SeasonID,
         player_id: PlayerIDValidated,
     ) -> RawAPIItem | ModelNotImplemented:
-        # fmt: off
         return self._validate_response(
             await self._client.get(
                 self.__class__.PATH / str(matchmaking_id) / "seasons" / str(season_id) / "players" / str(player_id),
                 expect_item=True,
             ),
             ModelPlaceholder,
-        )
-        # fmt: on
+        )  # fmt: skip

{faceit-0.3.0 → faceit-0.3.2}/src/faceit/api/data/players.py

@@ -23,7 +23,6 @@ from faceit.api.base import (
 )
 from faceit.api.pagination import (
     AsyncPageIterator,
-    MaxItems,
     MaxItemsType,
     SyncPageIterator,
     TimestampPaginationConfig,
@@ -43,7 +42,7 @@ from faceit.models import (
     Player,
     Tournament,
 )
-from faceit.models.custom_types import NotStrictTimestampMs  # noqa: TC001
+from faceit.models.custom_types import NotStrictTimestampMs
 from faceit.models.players.general import AnyPlayerStats
 from faceit.models.players.match import AbstractMatchPlayerStats
 from faceit.types import (
@@ -231,18 +230,18 @@ class SyncPlayers(BasePlayers[SyncClient], Generic[APIResponseFormatT]):
     def all_bans(
         self: SyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     def all_bans(
         self: SyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[BanEntry]: ...
 
     def all_bans(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[BanEntry]:
         iterator = SyncPageIterator(self.bans, player_id, max_items=max_items)
         return iterator.collect()
@@ -474,18 +473,18 @@ class SyncPlayers(BasePlayers[SyncClient], Generic[APIResponseFormatT]):
     def all_hubs(
         self: SyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     def all_hubs(
         self: SyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[Hub]: ...
 
     def all_hubs(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[Hub]:
         iterator = SyncPageIterator(self.hubs, player_id, max_items=max_items)
         return iterator.collect()
@@ -557,18 +556,18 @@ class SyncPlayers(BasePlayers[SyncClient], Generic[APIResponseFormatT]):
     def all_teams(
         self: SyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     def all_teams(
         self: SyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[GeneralTeam]: ...
 
     def all_teams(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[GeneralTeam]:
         iterator = SyncPageIterator(self.teams, player_id, max_items=max_items)
         return iterator.collect()
@@ -612,18 +611,18 @@ class SyncPlayers(BasePlayers[SyncClient], Generic[APIResponseFormatT]):
     def all_tournaments(
         self: SyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     def all_tournaments(
         self: SyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[Tournament]: ...
 
     def all_tournaments(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[Tournament]:
         iterator = SyncPageIterator(self.tournaments, player_id, max_items=max_items)
         return iterator.collect()
@@ -710,18 +709,18 @@ class AsyncPlayers(BasePlayers[AsyncClient], Generic[APIResponseFormatT]):
     async def all_bans(
         self: AsyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     async def all_bans(
         self: AsyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[BanEntry]: ...
 
     async def all_bans(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[BanEntry]:
         iterator = AsyncPageIterator(self.bans, player_id, max_items=max_items)
         return await iterator.collect()
@@ -950,18 +949,18 @@ class AsyncPlayers(BasePlayers[AsyncClient], Generic[APIResponseFormatT]):
     async def all_hubs(
         self: AsyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     async def all_hubs(
         self: AsyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[Hub]: ...
 
     async def all_hubs(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[Hub]:
         iterator = AsyncPageIterator(self.hubs, player_id, max_items=max_items)
         return await iterator.collect()
@@ -1033,18 +1032,18 @@ class AsyncPlayers(BasePlayers[AsyncClient], Generic[APIResponseFormatT]):
     async def all_teams(
         self: AsyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     async def all_teams(
         self: AsyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[GeneralTeam]: ...
 
     async def all_teams(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[GeneralTeam]:
         iterator = AsyncPageIterator(self.teams, player_id, max_items=max_items)
         return await iterator.collect()
@@ -1088,18 +1087,18 @@ class AsyncPlayers(BasePlayers[AsyncClient], Generic[APIResponseFormatT]):
     async def all_tournaments(
         self: AsyncPlayers[Raw],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> list[RawAPIItem]: ...
 
     @overload
     async def all_tournaments(
         self: AsyncPlayers[Model],
         player_id: PlayerID,
-        max_items: MaxItemsType = MaxItems.SAFE,
+        max_items: MaxItemsType = "safe",
     ) -> ItemPage[Tournament]: ...
 
     async def all_tournaments(
-        self, player_id: PlayerID, max_items: MaxItemsType = MaxItems.SAFE
+        self, player_id: PlayerID, max_items: MaxItemsType = "safe"
     ) -> list[RawAPIItem] | ItemPage[Tournament]:
         iterator = AsyncPageIterator(self.tournaments, player_id, max_items=max_items)
         return await iterator.collect()