42api 0.1.0__tar.gz → 0.1.2__tar.gz

{42api-0.1.0 → 42api-0.1.2}/.github/workflows/ci.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v4
 

42api-0.1.2/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/42api/
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Re-run checks before publishing
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+          uv run python scripts/unasync_generate.py --check
+          uv run mypy
+          uv run pytest
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always

{42api-0.1.0 → 42api-0.1.2}/.gitignore

@@ -218,4 +218,7 @@ __marimo__/
 # Streamlit
 .streamlit/secrets.toml
 
-assets/
+assets/
+
+# agent
+.claude

{42api-0.1.0 → 42api-0.1.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: 42api
-Version: 0.1.0
+Version: 0.1.2
 Summary: Object-oriented Python client for the 42 School API (api.intra.42.fr)
 Project-URL: Homepage, https://github.com/Shadowaker/42api
 Author-email: Dan <danyridolfo98@gmail.com>
 License: MIT
 License-File: LICENSE
-Keywords: 42,42school,api,client,intra
+Keywords: 42,42school,42staff,api,client,intra,intra42
 Classifier: Development Status :: 3 - Alpha
 Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
@@ -17,6 +17,7 @@ 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: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -54,7 +55,7 @@ with Client(client_id="...", client_secret="...") as client:
     user = client.users.get("jdoe")
     print(user.login, user.email)
 
-    for user in client.users.filter(campus_id=1).sort("-level"):
+    for user in client.users.filter(primary_campus_id=1).sort("-pool_year"):
         print(user.login)
 ```
 
@@ -68,7 +69,7 @@ from intra42 import AsyncClient
 async def main() -> None:
     async with AsyncClient(client_id="...", client_secret="...") as client:
         user = await client.users.get("jdoe")
-        async for user in client.users.filter(campus_id=1).sort("-level"):
+        async for user in client.users.filter(primary_campus_id=1).sort("-pool_year"):
             print(user.login)
 
 
@@ -107,10 +108,12 @@ and `NetworkError` (connection/timeout failures).
 
 ## Status
 
-Early-stage: currently covers `users`, `campuses`, `campus_users`,
-`events`, and `locations` (including its `graph` analytics endpoint). More
-resources are added incrementally on top of the same client/model/
-query-builder pattern.
+Early-stage: currently covers `users`, `accreditations`, `campuses`,
+`campus_users`, `cursus`, `events`, `exams`, `locations`, `projects`, and
+`projects_users` (`exams`, `locations`, and `projects_users` each include
+their `graph` analytics endpoint). More resources are added incrementally
+on top of the same client/model/query-builder pattern.
+The api with restricted access are not implemented currently.
 
 ## Development
 

{42api-0.1.0 → 42api-0.1.2}/README.md

@@ -29,7 +29,7 @@ with Client(client_id="...", client_secret="...") as client:
     user = client.users.get("jdoe")
     print(user.login, user.email)
 
-    for user in client.users.filter(campus_id=1).sort("-level"):
+    for user in client.users.filter(primary_campus_id=1).sort("-pool_year"):
         print(user.login)
 ```
 
@@ -43,7 +43,7 @@ from intra42 import AsyncClient
 async def main() -> None:
     async with AsyncClient(client_id="...", client_secret="...") as client:
         user = await client.users.get("jdoe")
-        async for user in client.users.filter(campus_id=1).sort("-level"):
+        async for user in client.users.filter(primary_campus_id=1).sort("-pool_year"):
             print(user.login)
 
 
@@ -82,10 +82,12 @@ and `NetworkError` (connection/timeout failures).
 
 ## Status
 
-Early-stage: currently covers `users`, `campuses`, `campus_users`,
-`events`, and `locations` (including its `graph` analytics endpoint). More
-resources are added incrementally on top of the same client/model/
-query-builder pattern.
+Early-stage: currently covers `users`, `accreditations`, `campuses`,
+`campus_users`, `cursus`, `events`, `exams`, `locations`, `projects`, and
+`projects_users` (`exams`, `locations`, and `projects_users` each include
+their `graph` analytics endpoint). More resources are added incrementally
+on top of the same client/model/query-builder pattern.
+The api with restricted access are not implemented currently.
 
 ## Development
 

{42api-0.1.0 → 42api-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "42api"
-version = "0.1.0"
+version = "0.1.2"
 description = "Object-oriented Python client for the 42 School API (api.intra.42.fr)"
 readme = "README.md"
 license = { text = "MIT" }
@@ -18,10 +18,11 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Typing :: Typed",
     "Framework :: AsyncIO",
 ]
-keywords = ["42", "42school", "api", "client", "intra"]
+keywords = ["42", "42school", "api", "client", "intra", "intra42", "42staff"]
 
 [project.urls]
 Homepage = "https://github.com/Shadowaker/42api"

{42api-0.1.0 → 42api-0.1.2}/src/intra42/__init__.py

@@ -4,7 +4,7 @@
 
     with Client(client_id, client_secret) as client:
         user = client.users.get("jdoe")
-        for user in client.users.filter(campus_id=1).sort("-level"):
+        for user in client.users.filter(primary_campus_id=1).sort("-pool_year"):
             ...
 
 An async client with the same interface is available as ``AsyncClient``.
@@ -25,10 +25,15 @@ from .exceptions import (
     ServerError,
     ValidationError,
 )
+from .models.accreditation import Accreditation
 from .models.campus import Campus
 from .models.campus_user import CampusUser
+from .models.cursus import Cursus
 from .models.event import Event
+from .models.exam import Exam
 from .models.location import Location
+from .models.project import Project
+from .models.project_user import ProjectUser
 from .models.user import User
 
 __all__ = [
@@ -36,10 +41,15 @@ __all__ = [
     "Client",
     "ClientConfig",
     "User",
+    "Accreditation",
     "Campus",
     "CampusUser",
+    "Cursus",
     "Event",
+    "Exam",
     "Location",
+    "Project",
+    "ProjectUser",
     "FortyTwoAPIError",
     "AuthenticationError",
     "PermissionDeniedError",
@@ -50,4 +60,4 @@ __all__ = [
     "NetworkError",
 ]
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{42api-0.1.0 → 42api-0.1.2}/src/intra42/_async/client.py

@@ -12,10 +12,15 @@ from .._auth import TokenManager
 from .._config import DEFAULT_BASE_URL, ClientConfig
 from .._rate_limit import RateLimiter
 from ..exceptions import NetworkError, raise_for_status
+from .resources.accreditations import AsyncAccreditationsResource
 from .resources.campus_users import AsyncCampusUsersResource
 from .resources.campuses import AsyncCampusesResource
+from .resources.cursus import AsyncCursusResource
 from .resources.events import AsyncEventsResource
+from .resources.exams import AsyncExamsResource
 from .resources.locations import AsyncLocationsResource
+from .resources.projects import AsyncProjectsResource
+from .resources.projects_users import AsyncProjectUsersResource
 from .resources.users import AsyncUsersResource
 
 
@@ -57,10 +62,15 @@ class AsyncClient:
         )
 
         self.users = AsyncUsersResource(self)
+        self.accreditations = AsyncAccreditationsResource(self)
         self.campuses = AsyncCampusesResource(self)
         self.campus_users = AsyncCampusUsersResource(self)
+        self.cursus = AsyncCursusResource(self)
         self.events = AsyncEventsResource(self)
+        self.exams = AsyncExamsResource(self)
         self.locations = AsyncLocationsResource(self)
+        self.projects = AsyncProjectsResource(self)
+        self.projects_users = AsyncProjectUsersResource(self)
 
     @property
     def base_url(self) -> str:

42api-0.1.2/src/intra42/_async/resources/accreditations.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from ...models.accreditation import Accreditation
+from .base import AsyncResource
+
+
+class AsyncAccreditationsResource(AsyncResource[Accreditation]):
+    path = "/accreditations"
+    model = Accreditation
+
+    def _bind_relations(self, instance: Accreditation) -> None:
+        # Referenced in the users apidoc page: GET /accreditations/:id/users.
+        instance._bind_relation(
+            "users",
+            lambda: self._client.users._queryset(f"/accreditations/{instance.id}/users"),
+        )

42api-0.1.2/src/intra42/_async/resources/cursus.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from ...models.cursus import Cursus
+from .base import AsyncResource
+
+
+class AsyncCursusResource(AsyncResource[Cursus]):
+    path = "/cursus"
+    model = Cursus
+
+    def _bind_relations(self, instance: Cursus) -> None:
+        instance._bind_relation(
+            "users",
+            lambda: self._client.users._queryset(f"/cursus/{instance.id}/users"),
+        )
+        instance._bind_relation(
+            "events",
+            lambda: self._client.events._queryset(f"/cursus/{instance.id}/events"),
+        )
+        instance._bind_relation(
+            "projects",
+            lambda: self._client.projects._queryset(f"/cursus/{instance.id}/projects"),
+        )

42api-0.1.2/src/intra42/_async/resources/exams.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from ...models.exam import Exam
+from .base import AsyncResource
+
+
+class AsyncExamsResource(AsyncResource[Exam]):
+    path = "/exams"
+    model = Exam
+
+    async def graph(
+        self, *, field: str | None = None, interval: str | None = None
+    ) -> dict[str, int]:
+        """Grouped temporal counts (``GET /exams/graph...``)."""
+        path = "/exams/graph"
+        if interval is not None and field is None:
+            field = "created_at"
+        if field is not None:
+            path += f"/on/{field}"
+            if interval is not None:
+                path += f"/by/{interval}"
+        response = await self._client.request("GET", path)
+        return response.json()

42api-0.1.2/src/intra42/_async/resources/projects.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from ...models.project import Project
+from .base import AsyncResource
+
+
+class AsyncProjectsResource(AsyncResource[Project]):
+    path = "/projects"
+    model = Project
+
+    def _bind_relations(self, instance: Project) -> None:
+        # Referenced in the projects_users apidoc page:
+        # GET /projects/:id/projects_users.
+        instance._bind_relation(
+            "projects_users",
+            lambda: self._client.projects_users._queryset(
+                f"/projects/{instance.id}/projects_users"
+            ),
+        )

42api-0.1.2/src/intra42/_async/resources/projects_users.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from ...models.project_user import ProjectUser
+from .base import AsyncResource
+
+
+class AsyncProjectUsersResource(AsyncResource[ProjectUser]):
+    path = "/projects_users"
+    model = ProjectUser
+
+    async def graph(
+        self, *, field: str | None = None, interval: str | None = None
+    ) -> dict[str, int]:
+        path = "/projects_users/graph"
+        if interval is not None and field is None:
+            field = "created_at"
+        if field is not None:
+            path += f"/on/{field}"
+            if interval is not None:
+                path += f"/by/{interval}"
+        response = await self._client.request("GET", path)
+        return response.json()

{42api-0.1.0 → 42api-0.1.2}/src/intra42/_async/resources/users.py

@@ -21,3 +21,7 @@ class AsyncUsersResource(AsyncResource[User]):
             "locations",
             lambda: self._client.locations._queryset(f"/users/{instance.id}/locations"),
         )
+        instance._bind_relation(
+            "projects_users",
+            lambda: self._client.projects_users._queryset(f"/users/{instance.id}/projects_users"),
+        )

{42api-0.1.0 → 42api-0.1.2}/src/intra42/_sync/client.py

@@ -18,10 +18,15 @@ from .._auth import TokenManager
 from .._config import DEFAULT_BASE_URL, ClientConfig
 from .._rate_limit import RateLimiter
 from ..exceptions import NetworkError, raise_for_status
+from .resources.accreditations import AccreditationsResource
 from .resources.campus_users import CampusUsersResource
 from .resources.campuses import CampusesResource
+from .resources.cursus import CursusResource
 from .resources.events import EventsResource
+from .resources.exams import ExamsResource
 from .resources.locations import LocationsResource
+from .resources.projects import ProjectsResource
+from .resources.projects_users import ProjectUsersResource
 from .resources.users import UsersResource
 
 
@@ -63,10 +68,15 @@ class Client:
         )
 
         self.users = UsersResource(self)
+        self.accreditations = AccreditationsResource(self)
         self.campuses = CampusesResource(self)
         self.campus_users = CampusUsersResource(self)
+        self.cursus = CursusResource(self)
         self.events = EventsResource(self)
+        self.exams = ExamsResource(self)
         self.locations = LocationsResource(self)
+        self.projects = ProjectsResource(self)
+        self.projects_users = ProjectUsersResource(self)
 
     @property
     def base_url(self) -> str:

42api-0.1.2/src/intra42/_sync/resources/accreditations.py

@@ -0,0 +1,22 @@
+# GENERATED FILE — DO NOT EDIT BY HAND.
+#
+# Generated from the corresponding module under intra42._async by
+# scripts/unasync_generate.py (via the `unasync` library). Edit the
+# async source and re-run that script instead.
+
+from __future__ import annotations
+
+from ...models.accreditation import Accreditation
+from .base import Resource
+
+
+class AccreditationsResource(Resource[Accreditation]):
+    path = "/accreditations"
+    model = Accreditation
+
+    def _bind_relations(self, instance: Accreditation) -> None:
+        # Referenced in the users apidoc page: GET /accreditations/:id/users.
+        instance._bind_relation(
+            "users",
+            lambda: self._client.users._queryset(f"/accreditations/{instance.id}/users"),
+        )

42api-0.1.2/src/intra42/_sync/resources/cursus.py

@@ -0,0 +1,29 @@
+# GENERATED FILE — DO NOT EDIT BY HAND.
+#
+# Generated from the corresponding module under intra42._async by
+# scripts/unasync_generate.py (via the `unasync` library). Edit the
+# async source and re-run that script instead.
+
+from __future__ import annotations
+
+from ...models.cursus import Cursus
+from .base import Resource
+
+
+class CursusResource(Resource[Cursus]):
+    path = "/cursus"
+    model = Cursus
+
+    def _bind_relations(self, instance: Cursus) -> None:
+        instance._bind_relation(
+            "users",
+            lambda: self._client.users._queryset(f"/cursus/{instance.id}/users"),
+        )
+        instance._bind_relation(
+            "events",
+            lambda: self._client.events._queryset(f"/cursus/{instance.id}/events"),
+        )
+        instance._bind_relation(
+            "projects",
+            lambda: self._client.projects._queryset(f"/cursus/{instance.id}/projects"),
+        )

42api-0.1.2/src/intra42/_sync/resources/exams.py

@@ -0,0 +1,27 @@
+# GENERATED FILE — DO NOT EDIT BY HAND.
+#
+# Generated from the corresponding module under intra42._async by
+# scripts/unasync_generate.py (via the `unasync` library). Edit the
+# async source and re-run that script instead.
+
+from __future__ import annotations
+
+from ...models.exam import Exam
+from .base import Resource
+
+
+class ExamsResource(Resource[Exam]):
+    path = "/exams"
+    model = Exam
+
+    def graph(self, *, field: str | None = None, interval: str | None = None) -> dict[str, int]:
+        """Grouped temporal counts (``GET /exams/graph...``)."""
+        path = "/exams/graph"
+        if interval is not None and field is None:
+            field = "created_at"
+        if field is not None:
+            path += f"/on/{field}"
+            if interval is not None:
+                path += f"/by/{interval}"
+        response = self._client.request("GET", path)
+        return response.json()

42api-0.1.2/src/intra42/_sync/resources/projects.py

@@ -0,0 +1,25 @@
+# GENERATED FILE — DO NOT EDIT BY HAND.
+#
+# Generated from the corresponding module under intra42._async by
+# scripts/unasync_generate.py (via the `unasync` library). Edit the
+# async source and re-run that script instead.
+
+from __future__ import annotations
+
+from ...models.project import Project
+from .base import Resource
+
+
+class ProjectsResource(Resource[Project]):
+    path = "/projects"
+    model = Project
+
+    def _bind_relations(self, instance: Project) -> None:
+        # Referenced in the projects_users apidoc page:
+        # GET /projects/:id/projects_users.
+        instance._bind_relation(
+            "projects_users",
+            lambda: self._client.projects_users._queryset(
+                f"/projects/{instance.id}/projects_users"
+            ),
+        )

42api-0.1.2/src/intra42/_sync/resources/projects_users.py

@@ -0,0 +1,26 @@
+# GENERATED FILE — DO NOT EDIT BY HAND.
+#
+# Generated from the corresponding module under intra42._async by
+# scripts/unasync_generate.py (via the `unasync` library). Edit the
+# async source and re-run that script instead.
+
+from __future__ import annotations
+
+from ...models.project_user import ProjectUser
+from .base import Resource
+
+
+class ProjectUsersResource(Resource[ProjectUser]):
+    path = "/projects_users"
+    model = ProjectUser
+
+    def graph(self, *, field: str | None = None, interval: str | None = None) -> dict[str, int]:
+        path = "/projects_users/graph"
+        if interval is not None and field is None:
+            field = "created_at"
+        if field is not None:
+            path += f"/on/{field}"
+            if interval is not None:
+                path += f"/by/{interval}"
+        response = self._client.request("GET", path)
+        return response.json()

{42api-0.1.0 → 42api-0.1.2}/src/intra42/_sync/resources/users.py

@@ -27,3 +27,7 @@ class UsersResource(Resource[User]):
             "locations",
             lambda: self._client.locations._queryset(f"/users/{instance.id}/locations"),
         )
+        instance._bind_relation(
+            "projects_users",
+            lambda: self._client.projects_users._queryset(f"/users/{instance.id}/projects_users"),
+        )

42api-0.1.2/src/intra42/models/accreditation.py

@@ -0,0 +1,29 @@
+"""The ``Accreditation`` resource."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import TYPE_CHECKING
+
+from .base import FortyTwoModel
+
+if TYPE_CHECKING:
+    from .._async.query import AsyncQuerySet
+    from .._sync.query import QuerySet
+    from .user import User
+
+
+class Accreditation(FortyTwoModel):
+    id: int
+    name: str | None = None
+    user_id: int | None = None
+    cursus_id: int | None = None
+    difficulty: int | None = None
+    validated: bool | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+
+    @property
+    def users(self) -> AsyncQuerySet[User] | QuerySet[User]:
+        """Users holding this accreditation (``GET /accreditations/{id}/users``)."""
+        return self._relation("users")

42api-0.1.2/src/intra42/models/cursus.py

@@ -0,0 +1,41 @@
+"""The ``Cursus`` resource (a curriculum/track, e.g. "42", "Piscine C")."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import TYPE_CHECKING
+
+from .base import FortyTwoModel
+
+if TYPE_CHECKING:
+    from .._async.query import AsyncQuerySet
+    from .._sync.query import QuerySet
+    from .event import Event
+    from .project import Project
+    from .user import User
+
+
+class Cursus(FortyTwoModel):
+    id: int
+    name: str | None = None
+    slug: str | None = None
+    kind: str | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+    restricted: bool | None = None
+    is_subscriptable: bool | None = None
+
+    @property
+    def users(self) -> AsyncQuerySet[User] | QuerySet[User]:
+        """Users enrolled in this cursus (``GET /cursus/{id}/users``)."""
+        return self._relation("users")
+
+    @property
+    def events(self) -> AsyncQuerySet[Event] | QuerySet[Event]:
+        """Events for this cursus (``GET /cursus/{id}/events``)."""
+        return self._relation("events")
+
+    @property
+    def projects(self) -> AsyncQuerySet[Project] | QuerySet[Project]:
+        """Projects belonging to this cursus (``GET /cursus/{id}/projects``)."""
+        return self._relation("projects")

42api-0.1.2/src/intra42/models/exam.py

@@ -0,0 +1,32 @@
+"""The ``Exam`` resource."""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from .base import FortyTwoModel
+from .campus import Campus
+from .cursus import Cursus
+from .project import Project
+
+
+class Exam(FortyTwoModel):
+    id: int
+    name: str | None = None
+    ip_range: str | None = None
+    begin_at: datetime | None = None
+    end_at: datetime | None = None
+    location: str | None = None
+    max_people: int | None = None
+    nbr_subscribers: int | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+    campus_id: int | None = None
+    campus: Campus | None = None
+    cursus: list[Cursus] | None = None
+    projects: list[Project] | None = None
+    visible: bool | None = None
+    validated: bool | None = None
+    validated_at: datetime | None = None
+    validator_id: int | None = None
+    prohibition_of_cancellation: int | None = None