eduskit 0.1.4__tar.gz → 0.1.6__tar.gz

{eduskit-0.1.4 → eduskit-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eduskit
-Version: 0.1.4
+Version: 0.1.6
 Summary: Eduskit B-end server SDK for classroom and whiteboard APIs
 Author: Eduskit
 License-Expression: Apache-2.0
@@ -68,7 +68,7 @@ token = sdk.client.auth.issue_token(eduUserId=user["eduUserId"], originId="stu_0
 classroom = sdk.client.classrooms.create(
     name="一年级数学",
     startsAt="2026-08-17T10:00:00.000Z",
-    endsAt="2026-08-17T11:00:00.000Z",
+    durationMinutes=60,
     teacherEduUserId=user["eduUserId"],
 )
 sdk.client.classrooms.start(classroom["classroomId"])
@@ -144,3 +144,25 @@ except EduskitError as e:
 ## 示例
 
 - [examples/classroom_quickstart.py](examples/classroom_quickstart.py)
+
+## Application business APIs
+
+Use the application-credential `client` for user lists and status, classroom queries and updates, courseware libraries, live assets, attendance, entry diagnostics, and activity logs. No console tenant token is required. See [the complete API reference](https://docs.eduskit.com/server-sdk/business-api/). New methods require a matching server-api deployment and a source SDK build.
+
+## Console management
+
+`ConsoleClient` exposes tenant management, authentication, applications, users, classrooms, courseware, live video, diagnostics, dashboards, and billing. Use the console-api URL and a tenant access token. Application-scoped methods require `appId`; app credentials are not sent by this client. This API is available in this source build.
+
+```python
+import os
+from eduskit import Eduskit
+sdk = Eduskit(console_client={
+    "base_url": os.environ["EDU_CONSOLE_URL"],
+    "access_token": os.environ["EDU_TENANT_ACCESS_TOKEN"],
+})
+c = sdk.console_client
+apps = c.apps.list()
+users = c.users.list(os.environ["EDU_APP_ID"], page=1, pageSize=20)
+```
+
+Full API fields and workflows: [Console management](https://docs.eduskit.com/server-sdk/console/).

{eduskit-0.1.4 → eduskit-0.1.6}/README.md

@@ -55,7 +55,7 @@ token = sdk.client.auth.issue_token(eduUserId=user["eduUserId"], originId="stu_0
 classroom = sdk.client.classrooms.create(
     name="一年级数学",
     startsAt="2026-08-17T10:00:00.000Z",
-    endsAt="2026-08-17T11:00:00.000Z",
+    durationMinutes=60,
     teacherEduUserId=user["eduUserId"],
 )
 sdk.client.classrooms.start(classroom["classroomId"])
@@ -131,3 +131,25 @@ except EduskitError as e:
 ## 示例
 
 - [examples/classroom_quickstart.py](examples/classroom_quickstart.py)
+
+## Application business APIs
+
+Use the application-credential `client` for user lists and status, classroom queries and updates, courseware libraries, live assets, attendance, entry diagnostics, and activity logs. No console tenant token is required. See [the complete API reference](https://docs.eduskit.com/server-sdk/business-api/). New methods require a matching server-api deployment and a source SDK build.
+
+## Console management
+
+`ConsoleClient` exposes tenant management, authentication, applications, users, classrooms, courseware, live video, diagnostics, dashboards, and billing. Use the console-api URL and a tenant access token. Application-scoped methods require `appId`; app credentials are not sent by this client. This API is available in this source build.
+
+```python
+import os
+from eduskit import Eduskit
+sdk = Eduskit(console_client={
+    "base_url": os.environ["EDU_CONSOLE_URL"],
+    "access_token": os.environ["EDU_TENANT_ACCESS_TOKEN"],
+})
+c = sdk.console_client
+apps = c.apps.list()
+users = c.users.list(os.environ["EDU_APP_ID"], page=1, pageSize=20)
+```
+
+Full API fields and workflows: [Console management](https://docs.eduskit.com/server-sdk/console/).

{eduskit-0.1.4 → eduskit-0.1.6}/eduskit/__init__.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from typing import Any, Dict, Optional
 
+from .console import ConsoleClient
 from .classroom import ClassroomClient
 from .errors import EduskitError
 from .http import Fetcher, HttpTransport
@@ -9,6 +10,7 @@ from .whiteboard import WhiteboardClient
 
 __all__ = [
     "Eduskit",
+    "ConsoleClient",
     "EduskitError",
     "ClassroomClient",
     "WhiteboardClient",
@@ -21,10 +23,12 @@ class Eduskit:
         *,
         client: Optional[Dict[str, Any]] = None,
         whiteboard_client: Optional[Dict[str, Any]] = None,
+        console_client: Optional[Dict[str, Any]] = None,
         timeout_ms: int = 10_000,
         lang: str = "zh-CN",
         fetch: Optional[Fetcher] = None,
     ) -> None:
+        self._console = ConsoleClient(**{"timeout_ms": timeout_ms, "lang": lang, "fetch": fetch, **console_client}) if console_client is not None else None
         self._client: Optional[ClassroomClient] = None
         self._whiteboard: Optional[WhiteboardClient] = None
         if client:
@@ -75,3 +79,9 @@ class Eduskit:
                 source="whiteboard",
             )
         return self._whiteboard
+
+    @property
+    def console_client(self) -> ConsoleClient:
+        if self._console is None:
+            raise EduskitError("console client is not configured", error_code="SDK_CLIENT_NOT_CONFIGURED", source="console")
+        return self._console

{eduskit-0.1.4 → eduskit-0.1.6}/eduskit/classroom.py

@@ -4,11 +4,12 @@ from urllib.parse import urlencode
 
 from typing import Any
 
+from .classroom_media import LiveVideosApi, ClassroomMediaApi, ServerUsersApi, ServerClassroomsApi, CoursewaresApi, ActivityApi
 from .http import HttpTransport
 from .token import iso_time, sign_hs256
 
 
-class _Users:
+class _Users(ServerUsersApi):
     def __init__(self, http: HttpTransport) -> None:
         self._http = http
 
@@ -110,11 +111,44 @@ class _Coursewares:
         )
 
 
-class _Classrooms:
+class _EntryCode:
+    def __init__(self, http: HttpTransport) -> None:
+        self._http = http
+
+    def list(self, classroom_id: str) -> Any:
+        return self._http.request(
+            "GET",
+            "/v1/classrooms/entry-codes" + "?" + urlencode({"classroomId": classroom_id}),
+        )
+
+    def issue(self, classroom_id: str, **input: Any) -> Any:
+        return self._http.request(
+            "POST",
+            "/v1/classrooms/entry-codes",
+            {**(input or {}), "classroomId": classroom_id},
+        )
+
+    def update(self, classroom_id: str, **input: Any) -> Any:
+        return self._http.request(
+            "POST",
+            "/v1/classrooms/entry-codes/update",
+            {**(input or {}), "classroomId": classroom_id},
+        )
+
+    def revoke(self, classroom_id: str, entry_code_id: str) -> Any:
+        return self._http.request(
+            "POST",
+            "/v1/classrooms/entry-codes/revoke",
+            {"classroomId": classroom_id, "entryCodeId": entry_code_id},
+        )
+
+
+class _Classrooms(ServerClassroomsApi):
     def __init__(self, http: HttpTransport) -> None:
         self.members = _Members(http)
         self.permissions = _Permissions(http)
         self.coursewares = _Coursewares(http)
+        self.entry_code = _EntryCode(http)
         self._http = http
 
     def create(self, **input: Any) -> Any:
@@ -140,12 +174,27 @@ class _App:
 
 class ClassroomClient:
     def __init__(self, http: HttpTransport, *, app_id: str, app_secret: str) -> None:
+        self.coursewares = CoursewaresApi(http)
+        self.activity = ActivityApi(http)
+        self.live_videos = LiveVideosApi(http)
+        self.classroom_media = ClassroomMediaApi(http)
         self.users = _Users(http)
         self.auth = _Auth(app_id, app_secret)
         self.classrooms = _Classrooms(http)
         self.app = _App(http)
         self._http = http
 
+    def upload_file(self, url: str, data: bytes, content_type: str) -> None:
+        """PUT bytes to a signed storage URL without tenant or app credentials."""
+        from .errors import EduskitError
+        from urllib.error import URLError
+        try:
+            status, _, _ = self._http.fetch(url, "PUT", {"Content-Type": content_type}, data, self._http.timeout_ms)
+        except (URLError, OSError) as error:
+            raise EduskitError(str(error), error_code="SDK_NETWORK_ERROR", source="classroom") from error
+        if not 200 <= status < 300:
+            raise EduskitError(f"upload failed (HTTP {status})", status=status, error_code="SDK_UPLOAD_FAILED", source="classroom")
+
     @property
     def last_trace_id(self) -> str:
         return self._http.last_trace_id

eduskit-0.1.6/eduskit/classroom_media.py

@@ -0,0 +1,120 @@
+# Generated by scripts/generate-classroom-media.py.
+from urllib.parse import urlencode
+from typing import Any
+class ClassroomMediaApi:
+    def __init__(self, http):
+        self._http = http
+
+    def list_whiteboard_coursewares(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/whiteboard/coursewares" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def add_whiteboard_courseware(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/classrooms/whiteboard/coursewares", input)
+
+    def get_live_source(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/live-source" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def set_live_source(self, **input: Any) -> Any:
+        return self._http.request("PUT", "/v1/classrooms/live-source", input)
+
+    def issue_live_push_credential(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/classrooms/live-source/push-credential", input)
+
+    def get_live_play_credentials(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/live/play-credentials" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+class LiveVideosApi:
+    def __init__(self, http):
+        self._http = http
+
+    def list(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/live-videos" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def create_upload_url(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/live-videos/upload-url", input)
+
+    def create(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/live-videos", input)
+
+    def remove(self, **input: Any) -> Any:
+        return self._http.request("DELETE", "/v1/live-videos/remove" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+class ServerUsersApi:
+    def __init__(self, http):
+        self._http = http
+
+    def list(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/users" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def search(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/users/search" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def set_status(self, **input: Any) -> Any:
+        return self._http.request("PATCH", "/v1/users/status", input)
+
+class ServerClassroomsApi:
+    def __init__(self, http):
+        self._http = http
+
+    def list(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def get(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/detail" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def update(self, **input: Any) -> Any:
+        return self._http.request("PATCH", "/v1/classrooms/update", input)
+
+    def attendance(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/attendance" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def list_entered_users(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/entered-users" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def list_join_attempts(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/join-attempts" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def get_entered_user_trace(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/entered-users/trace" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+class ActivityApi:
+    def __init__(self, http):
+        self._http = http
+
+    def list(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/activity" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def tracks(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/activity/tracks" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def overview(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/activity/overview" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def detail(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/classrooms/activity/detail" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+class CoursewaresApi:
+    def __init__(self, http):
+        self._http = http
+
+    def list(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/coursewares" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def create_upload_url(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/coursewares/upload-url", input)
+
+    def create(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/coursewares", input)
+
+    def get(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/coursewares/detail" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def get_manifest(self, **input: Any) -> Any:
+        return self._http.request("GET", "/v1/coursewares/manifest" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def remove(self, **input: Any) -> Any:
+        return self._http.request("DELETE", "/v1/coursewares/remove" + '?' + urlencode({k:(str(v).lower() if isinstance(v, bool) else v) for k,v in input.items() if v is not None and v != ''}))
+
+    def retry(self, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/coursewares/retry", input)
+

eduskit-0.1.6/eduskit/console.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+from typing import Any
+from urllib.parse import urlencode
+from .http import HttpTransport, Fetcher
+from .errors import EduskitError
+from .console_api import create_apis
+
+
+class ConsoleClient:
+    """Tenant console management. Access tokens are updated explicitly after refresh."""
+    def __init__(self, *, base_url: str, access_token: str = "", timeout_ms: int = 10_000,
+                 lang: str = "zh-CN", fetch: Fetcher | None = None) -> None:
+        self._http = HttpTransport(base_url=base_url, app_key="", app_secret="", source="console",
+                                   timeout_ms=timeout_ms, lang=lang, fetch=fetch)
+        self._access_token = access_token
+        for name, api in create_apis(self).items():
+            setattr(self, name, api)
+
+    def upload_file(self, url: str, data: bytes, content_type: str) -> None:
+        """PUT bytes to a signed storage URL without tenant or app credentials."""
+        from urllib.error import URLError
+        try:
+            status, _, _ = self._http.fetch(url, "PUT", {"Content-Type": content_type}, data, self._http.timeout_ms)
+        except (URLError, OSError) as error:
+            raise EduskitError(str(error), error_code="SDK_NETWORK_ERROR", source="console") from error
+        if not 200 <= status < 300:
+            raise EduskitError(f"upload failed (HTTP {status})", status=status, error_code="SDK_UPLOAD_FAILED", source="console")
+
+    def set_access_token(self, token: str) -> None:
+        self._access_token = token
+
+    @property
+    def last_trace_id(self) -> str:
+        return self._http.last_trace_id
+
+    def _request(self, method: str, path: str, scope: str, input: dict[str, Any],
+                 app_id: str | None = None, query_keys: list[str] | None = None) -> Any:
+        headers = {}
+        if scope != "public":
+            if not self._access_token.strip():
+                raise EduskitError("tenant access_token is required", error_code="SDK_CONSOLE_TOKEN_REQUIRED", source="console")
+            headers["Authorization"] = "Bearer " + self._access_token
+        if scope == "app":
+            if not app_id or not app_id.strip():
+                raise EduskitError("app_id is required", error_code="SDK_CONSOLE_APP_ID_REQUIRED", source="console")
+            headers["x-app-id"] = app_id
+        query, body = {}, {}
+        for key, value in input.items():
+            in_query = key in query_keys if query_keys is not None else method in ("GET", "DELETE")
+            if in_query:
+                if value is None or value == "":
+                    continue
+                if not isinstance(value, (str, int, float, bool)):
+                    raise EduskitError(f"query field {key} must be scalar", error_code="SDK_QUERY_INVALID", source="console")
+                query[key] = str(value).lower() if isinstance(value, bool) else str(value)
+            else:
+                body[key] = value
+        if query:
+            path += "?" + urlencode(query)
+        return self._http.request(method, path, None if method == "GET" or (method == "DELETE" and query_keys is None) else body, headers)

eduskit-0.1.6/eduskit/console.pyi

@@ -0,0 +1,31 @@
+from typing import Any
+from .http import Fetcher
+from .console_api import (
+    ConsoleAuthApi,
+    ConsoleAppsApi,
+    ConsoleUsersApi,
+    ConsoleClassroomsApi,
+    ConsoleEntryCodesApi,
+    ConsoleActivityApi,
+    ConsoleCoursewaresApi,
+    ConsoleLiveVideosApi,
+    ConsoleDashboardApi,
+    ConsoleBillingApi,
+)
+
+class ConsoleClient:
+    auth: ConsoleAuthApi
+    apps: ConsoleAppsApi
+    users: ConsoleUsersApi
+    classrooms: ConsoleClassroomsApi
+    entry_codes: ConsoleEntryCodesApi
+    activity: ConsoleActivityApi
+    coursewares: ConsoleCoursewaresApi
+    live_videos: ConsoleLiveVideosApi
+    dashboard: ConsoleDashboardApi
+    billing: ConsoleBillingApi
+    def __init__(self, *, base_url: str, access_token: str = "", timeout_ms: int = 10000, lang: str = "zh-CN", fetch: Fetcher | None = None) -> None: ...
+    def set_access_token(self, token: str) -> None: ...
+    @property
+    def last_trace_id(self) -> str: ...
+    def upload_file(self, url: str, data: bytes, content_type: str) -> None: ...

eduskit-0.1.6/eduskit/console_api.py

@@ -0,0 +1,407 @@
+# Generated by scripts/generate-console.py.
+from typing import Any
+class ConsoleAuthApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def methods(self, **input: Any) -> Any:
+        """Available sign-in methods. GET /v1/auth/methods."""
+        return self._transport._request("GET", "/v1/auth/methods", "public", input, None, None)
+
+    def send_sms(self, **input: Any) -> Any:
+        """Send SMS code. POST /v1/auth/sms/send."""
+        return self._transport._request("POST", "/v1/auth/sms/send", "public", input, None, None)
+
+    def verify_sms(self, **input: Any) -> Any:
+        """Sign in with SMS. POST /v1/auth/sms/verify."""
+        return self._transport._request("POST", "/v1/auth/sms/verify", "public", input, None, None)
+
+    def send_email(self, **input: Any) -> Any:
+        """Send email code. POST /v1/auth/email/send."""
+        return self._transport._request("POST", "/v1/auth/email/send", "public", input, None, None)
+
+    def verify_email(self, **input: Any) -> Any:
+        """Sign in with email. POST /v1/auth/email/verify."""
+        return self._transport._request("POST", "/v1/auth/email/verify", "public", input, None, None)
+
+    def google_authorize(self, **input: Any) -> Any:
+        """Google authorization URL. GET /v1/auth/google/authorize."""
+        return self._transport._request("GET", "/v1/auth/google/authorize", "public", input, None, None)
+
+    def google_callback(self, **input: Any) -> Any:
+        """Exchange Google authorization code. POST /v1/auth/google/callback."""
+        return self._transport._request("POST", "/v1/auth/google/callback", "public", input, None, None)
+
+    def google_token(self, **input: Any) -> Any:
+        """Sign in with Google ID token. POST /v1/auth/google/token."""
+        return self._transport._request("POST", "/v1/auth/google/token", "public", input, None, None)
+
+    def wechat_authorize(self, **input: Any) -> Any:
+        """WeChat authorization URL. GET /v1/auth/wechat/authorize."""
+        return self._transport._request("GET", "/v1/auth/wechat/authorize", "public", input, None, None)
+
+    def wechat_callback(self, **input: Any) -> Any:
+        """Exchange WeChat authorization code. POST /v1/auth/wechat/callback."""
+        return self._transport._request("POST", "/v1/auth/wechat/callback", "public", input, None, None)
+
+    def send_wechat_bind_phone(self, **input: Any) -> Any:
+        """Send phone code for WeChat sign-in. POST /v1/auth/wechat/bind-phone/send."""
+        return self._transport._request("POST", "/v1/auth/wechat/bind-phone/send", "public", input, None, None)
+
+    def verify_wechat_bind_phone(self, **input: Any) -> Any:
+        """Verify phone for WeChat sign-in. POST /v1/auth/wechat/bind-phone/verify."""
+        return self._transport._request("POST", "/v1/auth/wechat/bind-phone/verify", "public", input, None, None)
+
+    def send_bind_phone(self, **input: Any) -> Any:
+        """Send phone binding code. POST /v1/auth/phone/bind/send."""
+        return self._transport._request("POST", "/v1/auth/phone/bind/send", "tenant", input, None, None)
+
+    def verify_bind_phone(self, **input: Any) -> Any:
+        """Bind phone to signed-in account. POST /v1/auth/phone/bind/verify."""
+        return self._transport._request("POST", "/v1/auth/phone/bind/verify", "tenant", input, None, None)
+
+    def wechat_bind_authorize(self, **input: Any) -> Any:
+        """WeChat account binding URL. GET /v1/auth/wechat/bind/authorize."""
+        return self._transport._request("GET", "/v1/auth/wechat/bind/authorize", "tenant", input, None, None)
+
+    def wechat_bind_callback(self, **input: Any) -> Any:
+        """Bind WeChat to account. POST /v1/auth/wechat/bind/callback."""
+        return self._transport._request("POST", "/v1/auth/wechat/bind/callback", "tenant", input, None, None)
+
+    def refresh(self, **input: Any) -> Any:
+        """Refresh tenant session. POST /v1/auth/token/refresh."""
+        return self._transport._request("POST", "/v1/auth/token/refresh", "public", input, None, None)
+
+    def logout(self, **input: Any) -> Any:
+        """Revoke tenant session. POST /v1/auth/logout."""
+        return self._transport._request("POST", "/v1/auth/logout", "public", input, None, None)
+
+    def me(self, **input: Any) -> Any:
+        """Current account. GET /v1/auth/me."""
+        return self._transport._request("GET", "/v1/auth/me", "tenant", input, None, None)
+
+class ConsoleAppsApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, **input: Any) -> Any:
+        """List applications. GET /v1/apps."""
+        return self._transport._request("GET", "/v1/apps", "tenant", input, None, None)
+
+    def get(self, **input: Any) -> Any:
+        """Get application. GET /v1/apps/detail."""
+        return self._transport._request("GET", "/v1/apps/detail", "tenant", input, None, None)
+
+    def create(self, **input: Any) -> Any:
+        """Create application. POST /v1/apps."""
+        return self._transport._request("POST", "/v1/apps", "tenant", input, None, None)
+
+    def update_config(self, **input: Any) -> Any:
+        """Replace application configuration. PATCH /v1/apps/config."""
+        return self._transport._request("PATCH", "/v1/apps/config", "tenant", input, None, None)
+
+    def update_webhook(self, **input: Any) -> Any:
+        """Configure webhook and signing secret. PATCH /v1/apps/webhook."""
+        return self._transport._request("PATCH", "/v1/apps/webhook", "tenant", input, None, None)
+
+class ConsoleUsersApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, app_id: str, **input: Any) -> Any:
+        """List users. GET /v1/users."""
+        return self._transport._request("GET", "/v1/users", "app", input, app_id, None)
+
+    def search(self, app_id: str, **input: Any) -> Any:
+        """Search users. GET /v1/users/search."""
+        return self._transport._request("GET", "/v1/users/search", "app", input, app_id, None)
+
+    def create(self, app_id: str, **input: Any) -> Any:
+        """Create user. POST /v1/users."""
+        return self._transport._request("POST", "/v1/users", "app", input, app_id, None)
+
+    def set_status(self, app_id: str, **input: Any) -> Any:
+        """Set user status. PATCH /v1/users/status."""
+        return self._transport._request("PATCH", "/v1/users/status", "app", input, app_id, None)
+
+    def issue_token(self, app_id: str, **input: Any) -> Any:
+        """Issue user token. POST /v1/users/token."""
+        return self._transport._request("POST", "/v1/users/token", "app", input, app_id, None)
+
+class ConsoleClassroomsApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, app_id: str, **input: Any) -> Any:
+        """List classrooms. GET /v1/classrooms."""
+        return self._transport._request("GET", "/v1/classrooms", "app", input, app_id, None)
+
+    def get(self, app_id: str, **input: Any) -> Any:
+        """Get classroom. GET /v1/classrooms/detail."""
+        return self._transport._request("GET", "/v1/classrooms/detail", "app", input, app_id, None)
+
+    def create(self, app_id: str, **input: Any) -> Any:
+        """Create classroom. POST /v1/classrooms."""
+        return self._transport._request("POST", "/v1/classrooms", "app", input, app_id, None)
+
+    def update(self, app_id: str, **input: Any) -> Any:
+        """Update classroom. PATCH /v1/classrooms/update."""
+        return self._transport._request("PATCH", "/v1/classrooms/update", "app", input, app_id, None)
+
+    def start(self, app_id: str, **input: Any) -> Any:
+        """Start classroom. POST /v1/classrooms/start."""
+        return self._transport._request("POST", "/v1/classrooms/start", "app", input, app_id, None)
+
+    def end(self, app_id: str, **input: Any) -> Any:
+        """End classroom. POST /v1/classrooms/end."""
+        return self._transport._request("POST", "/v1/classrooms/end", "app", input, app_id, None)
+
+    def list_members(self, app_id: str, **input: Any) -> Any:
+        """List classroom members. GET /v1/classrooms/members."""
+        return self._transport._request("GET", "/v1/classrooms/members", "app", input, app_id, None)
+
+    def add_member(self, app_id: str, **input: Any) -> Any:
+        """Add classroom member. POST /v1/classrooms/members."""
+        return self._transport._request("POST", "/v1/classrooms/members", "app", input, app_id, None)
+
+    def replace_students(self, app_id: str, **input: Any) -> Any:
+        """Replace student roster. PUT /v1/classrooms/members/students."""
+        return self._transport._request("PUT", "/v1/classrooms/members/students", "app", input, app_id, None)
+
+    def list_coursewares(self, app_id: str, **input: Any) -> Any:
+        """List classroom courseware. GET /v1/classrooms/coursewares."""
+        return self._transport._request("GET", "/v1/classrooms/coursewares", "app", input, app_id, None)
+
+    def bind_coursewares(self, app_id: str, **input: Any) -> Any:
+        """Bind classroom courseware. POST /v1/classrooms/coursewares."""
+        return self._transport._request("POST", "/v1/classrooms/coursewares", "app", input, app_id, None)
+
+    def unbind_coursewares(self, app_id: str, **input: Any) -> Any:
+        """Unbind classroom courseware. DELETE /v1/classrooms/coursewares."""
+        return self._transport._request("DELETE", "/v1/classrooms/coursewares", "app", input, app_id, ['classroomId'])
+
+    def list_whiteboard_coursewares(self, app_id: str, **input: Any) -> Any:
+        """List whiteboard courseware. GET /v1/classrooms/whiteboard/coursewares."""
+        return self._transport._request("GET", "/v1/classrooms/whiteboard/coursewares", "app", input, app_id, None)
+
+    def add_whiteboard_courseware(self, app_id: str, **input: Any) -> Any:
+        """Add courseware to whiteboard. POST /v1/classrooms/whiteboard/coursewares."""
+        return self._transport._request("POST", "/v1/classrooms/whiteboard/coursewares", "app", input, app_id, None)
+
+    def attendance(self, app_id: str, **input: Any) -> Any:
+        """Classroom attendance. GET /v1/classrooms/attendance."""
+        return self._transport._request("GET", "/v1/classrooms/attendance", "app", input, app_id, None)
+
+    def list_entered_users(self, app_id: str, **input: Any) -> Any:
+        """List entered users. GET /v1/classrooms/entered-users."""
+        return self._transport._request("GET", "/v1/classrooms/entered-users", "app", input, app_id, None)
+
+    def list_join_attempts(self, app_id: str, **input: Any) -> Any:
+        """List join attempts. GET /v1/classrooms/join-attempts."""
+        return self._transport._request("GET", "/v1/classrooms/join-attempts", "app", input, app_id, None)
+
+    def get_entered_user_trace(self, app_id: str, **input: Any) -> Any:
+        """Get user entry trace. GET /v1/classrooms/entered-users/trace."""
+        return self._transport._request("GET", "/v1/classrooms/entered-users/trace", "app", input, app_id, None)
+
+    def get_live_source(self, app_id: str, **input: Any) -> Any:
+        """Get live source. GET /v1/classrooms/live-source."""
+        return self._transport._request("GET", "/v1/classrooms/live-source", "app", input, app_id, None)
+
+    def set_live_source(self, app_id: str, **input: Any) -> Any:
+        """Set live source. PUT /v1/classrooms/live-source."""
+        return self._transport._request("PUT", "/v1/classrooms/live-source", "app", input, app_id, None)
+
+    def issue_live_push_credential(self, app_id: str, **input: Any) -> Any:
+        """Issue live push credential. POST /v1/classrooms/live-source/push-credential."""
+        return self._transport._request("POST", "/v1/classrooms/live-source/push-credential", "app", input, app_id, None)
+
+    def get_live_play_credentials(self, app_id: str, **input: Any) -> Any:
+        """Get live playback credentials. GET /v1/classrooms/live/play-credentials."""
+        return self._transport._request("GET", "/v1/classrooms/live/play-credentials", "app", input, app_id, None)
+
+class ConsoleEntryCodesApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, app_id: str, **input: Any) -> Any:
+        """List entry codes and claims. GET /v1/classrooms/entry-codes."""
+        return self._transport._request("GET", "/v1/classrooms/entry-codes", "app", input, app_id, None)
+
+    def issue(self, app_id: str, **input: Any) -> Any:
+        """Issue entry codes. POST /v1/classrooms/entry-codes."""
+        return self._transport._request("POST", "/v1/classrooms/entry-codes", "app", input, app_id, None)
+
+    def update(self, app_id: str, **input: Any) -> Any:
+        """Update or rotate entry code. POST /v1/classrooms/entry-codes/update."""
+        return self._transport._request("POST", "/v1/classrooms/entry-codes/update", "app", input, app_id, None)
+
+    def revoke(self, app_id: str, **input: Any) -> Any:
+        """Revoke entry code. POST /v1/classrooms/entry-codes/revoke."""
+        return self._transport._request("POST", "/v1/classrooms/entry-codes/revoke", "app", input, app_id, None)
+
+class ConsoleActivityApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, app_id: str, **input: Any) -> Any:
+        """List classroom activity. GET /v1/classrooms/activity."""
+        return self._transport._request("GET", "/v1/classrooms/activity", "app", input, app_id, None)
+
+    def tracks(self, app_id: str, **input: Any) -> Any:
+        """Get activity tracks. GET /v1/classrooms/activity/tracks."""
+        return self._transport._request("GET", "/v1/classrooms/activity/tracks", "app", input, app_id, None)
+
+    def overview(self, app_id: str, **input: Any) -> Any:
+        """Get activity overview. GET /v1/classrooms/activity/overview."""
+        return self._transport._request("GET", "/v1/classrooms/activity/overview", "app", input, app_id, None)
+
+    def detail(self, app_id: str, **input: Any) -> Any:
+        """Get activity detail. GET /v1/classrooms/activity/detail."""
+        return self._transport._request("GET", "/v1/classrooms/activity/detail", "app", input, app_id, None)
+
+class ConsoleCoursewaresApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, app_id: str, **input: Any) -> Any:
+        """List courseware library. GET /v1/coursewares."""
+        return self._transport._request("GET", "/v1/coursewares", "app", input, app_id, None)
+
+    def create_upload_url(self, app_id: str, **input: Any) -> Any:
+        """Create courseware upload URL. POST /v1/coursewares/upload-url."""
+        return self._transport._request("POST", "/v1/coursewares/upload-url", "app", input, app_id, None)
+
+    def create(self, app_id: str, **input: Any) -> Any:
+        """Create and convert courseware. POST /v1/coursewares."""
+        return self._transport._request("POST", "/v1/coursewares", "app", input, app_id, None)
+
+    def get(self, app_id: str, **input: Any) -> Any:
+        """Get courseware. GET /v1/coursewares/detail."""
+        return self._transport._request("GET", "/v1/coursewares/detail", "app", input, app_id, None)
+
+    def get_manifest(self, app_id: str, **input: Any) -> Any:
+        """Get courseware manifest. GET /v1/coursewares/manifest."""
+        return self._transport._request("GET", "/v1/coursewares/manifest", "app", input, app_id, None)
+
+    def remove(self, app_id: str, **input: Any) -> Any:
+        """Delete courseware. DELETE /v1/coursewares/remove."""
+        return self._transport._request("DELETE", "/v1/coursewares/remove", "app", input, app_id, None)
+
+    def retry(self, app_id: str, **input: Any) -> Any:
+        """Retry courseware conversion. POST /v1/coursewares/retry."""
+        return self._transport._request("POST", "/v1/coursewares/retry", "app", input, app_id, None)
+
+class ConsoleLiveVideosApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def list(self, app_id: str, **input: Any) -> Any:
+        """List live video assets. GET /v1/live-videos."""
+        return self._transport._request("GET", "/v1/live-videos", "app", input, app_id, None)
+
+    def create_upload_url(self, app_id: str, **input: Any) -> Any:
+        """Create live video upload URL. POST /v1/live-videos/upload-url."""
+        return self._transport._request("POST", "/v1/live-videos/upload-url", "app", input, app_id, None)
+
+    def create(self, app_id: str, **input: Any) -> Any:
+        """Create live video asset. POST /v1/live-videos."""
+        return self._transport._request("POST", "/v1/live-videos", "app", input, app_id, None)
+
+    def remove(self, app_id: str, **input: Any) -> Any:
+        """Delete live video asset. DELETE /v1/live-videos/remove."""
+        return self._transport._request("DELETE", "/v1/live-videos/remove", "app", input, app_id, None)
+
+class ConsoleDashboardApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def overview(self, **input: Any) -> Any:
+        """Overview. GET /v1/dashboard/overview."""
+        return self._transport._request("GET", "/v1/dashboard/overview", "tenant", input, None, None)
+
+    def trends(self, **input: Any) -> Any:
+        """Trends. GET /v1/dashboard/trends."""
+        return self._transport._request("GET", "/v1/dashboard/trends", "tenant", input, None, None)
+
+    def classrooms(self, **input: Any) -> Any:
+        """Classroom statistics. GET /v1/dashboard/classrooms."""
+        return self._transport._request("GET", "/v1/dashboard/classrooms", "tenant", input, None, None)
+
+    def quality(self, **input: Any) -> Any:
+        """Entry quality. GET /v1/dashboard/quality."""
+        return self._transport._request("GET", "/v1/dashboard/quality", "tenant", input, None, None)
+
+    def usage(self, **input: Any) -> Any:
+        """Usage summary. GET /v1/dashboard/usage."""
+        return self._transport._request("GET", "/v1/dashboard/usage", "tenant", input, None, None)
+
+    def issues(self, **input: Any) -> Any:
+        """Courseware issues. GET /v1/dashboard/issues."""
+        return self._transport._request("GET", "/v1/dashboard/issues", "tenant", input, None, None)
+
+class ConsoleBillingApi:
+    def __init__(self, transport):
+        self._transport = transport
+
+    def wallet(self, **input: Any) -> Any:
+        """Wallet balance. GET /v1/billing/wallet."""
+        return self._transport._request("GET", "/v1/billing/wallet", "tenant", input, None, None)
+
+    def entitlements(self, **input: Any) -> Any:
+        """Tenant entitlements. GET /v1/billing/entitlements."""
+        return self._transport._request("GET", "/v1/billing/entitlements", "tenant", input, None, None)
+
+    def list_plans(self, **input: Any) -> Any:
+        """Plan catalog. GET /v1/billing/plans."""
+        return self._transport._request("GET", "/v1/billing/plans", "tenant", input, None, None)
+
+    def list_packages(self, **input: Any) -> Any:
+        """Resource package catalog. GET /v1/billing/packages."""
+        return self._transport._request("GET", "/v1/billing/packages", "tenant", input, None, None)
+
+    def estimate(self, **input: Any) -> Any:
+        """Estimate classroom usage. POST /v1/billing/estimate."""
+        return self._transport._request("POST", "/v1/billing/estimate", "tenant", input, None, None)
+
+    def list_ledger(self, **input: Any) -> Any:
+        """Points ledger. GET /v1/billing/ledger."""
+        return self._transport._request("GET", "/v1/billing/ledger", "tenant", input, None, None)
+
+    def list_usage(self, **input: Any) -> Any:
+        """Usage records. GET /v1/billing/usage."""
+        return self._transport._request("GET", "/v1/billing/usage", "tenant", input, None, None)
+
+    def list_reservations(self, **input: Any) -> Any:
+        """Resource reservations. GET /v1/billing/reservations."""
+        return self._transport._request("GET", "/v1/billing/reservations", "tenant", input, None, None)
+
+    def purchase_plan(self, **input: Any) -> Any:
+        """Purchase plan. POST /v1/billing/plans/purchase."""
+        return self._transport._request("POST", "/v1/billing/plans/purchase", "tenant", input, None, None)
+
+    def purchase_package(self, **input: Any) -> Any:
+        """Purchase resource package. POST /v1/billing/packages/purchase."""
+        return self._transport._request("POST", "/v1/billing/packages/purchase", "tenant", input, None, None)
+
+    def get_auto_recharge(self, **input: Any) -> Any:
+        """Get auto recharge. GET /v1/billing/auto-recharge."""
+        return self._transport._request("GET", "/v1/billing/auto-recharge", "tenant", input, None, None)
+
+    def set_auto_recharge(self, **input: Any) -> Any:
+        """Set auto recharge. POST /v1/billing/auto-recharge."""
+        return self._transport._request("POST", "/v1/billing/auto-recharge", "tenant", input, None, None)
+
+def create_apis(transport):
+    return {
+        "auth": ConsoleAuthApi(transport),
+        "apps": ConsoleAppsApi(transport),
+        "users": ConsoleUsersApi(transport),
+        "classrooms": ConsoleClassroomsApi(transport),
+        "entry_codes": ConsoleEntryCodesApi(transport),
+        "activity": ConsoleActivityApi(transport),
+        "coursewares": ConsoleCoursewaresApi(transport),
+        "live_videos": ConsoleLiveVideosApi(transport),
+        "dashboard": ConsoleDashboardApi(transport),
+        "billing": ConsoleBillingApi(transport),
+    }

{eduskit-0.1.4 → eduskit-0.1.6}/eduskit/http.py

@@ -47,7 +47,7 @@ class HttpTransport:
         self.fetch = fetch or _default_fetch
         self.last_trace_id = ""
 
-    def request(self, method: str, path: str, body: Optional[Any] = None) -> Any:
+    def request(self, method: str, path: str, body: Optional[Any] = None, extra_headers: Optional[dict[str, str]] = None) -> Any:
         trace_id = uuid.uuid4().hex[:16]
         payload = None if body is None else json.dumps(body).encode("utf-8")
         headers = {
@@ -58,6 +58,10 @@ class HttpTransport:
             "x-lang": self.lang,
             "x-trace-id": trace_id,
         }
+        if self.source == "console":
+            headers.pop("x-app-key")
+            headers.pop("x-app-secret")
+        headers.update(extra_headers or {})
         try:
             status, response_headers, raw = self.fetch(
                 f"{self.base_url}{path}",

{eduskit-0.1.4 → eduskit-0.1.6}/eduskit/whiteboard.py

@@ -21,7 +21,7 @@ class _Auth:
         expires_in = input.get("expiresIn", 3600)
         token, expires_at = sign_hs256(self._app_id, self._app_secret, user_id,
             "eduskit", "eduskit-room", expires_in,
-            {"app_id": self._app_id, "room_id": room_id, "role": role, "source": "server_sdk"},
+            {"app_id": self._app_id, "room_id": room_id, "role": role, "source": "server_sdk", "access_generation": None},
             "whiteboard")
         return {"token": token, "appId": self._app_id, "roomId": room_id, "userId": user_id,
                 "role": role, "expiresIn": expires_in, "expiresAt": iso_time(expires_at)}
@@ -93,12 +93,54 @@ class _Files:
         return self._http.request("GET", '/v1/files/convert' + "?" + urlencode({'jobId': job_id}))
 
 
+class _Rooms:
+    def __init__(self, http: HttpTransport) -> None:
+        self._http = http
+
+    def schedule_private_room_writes(self, room_id: str, request_id: str, opens_at: str, closes_at: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/write-window", {"roomId": room_id, "requestId": request_id, "opensAt": opens_at, "closesAt": closes_at})
+
+    def provision_private_room(self, room_id: str, assignment_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private", {"roomId": room_id, "assignmentId": assignment_id})
+
+    def initialize_private_workspace(self, room_id: str, assignment_id: str, source_snapshot_id: str | None) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/initializations", {"roomId": room_id, "assignmentId": assignment_id, "sourceSnapshotId": source_snapshot_id})
+
+    def get_private_workspace_initialization(self, room_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/initializations/query", {"roomId": room_id})
+
+    def change_private_room_grant(self, room_id: str, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/grants", {**input, "roomId": room_id})
+
+    def get_private_room_access(self, room_id: str, user_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/access/query", {"roomId": room_id, "userId": user_id})
+
+    def issue_private_room_token(self, room_id: str, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/token", {**input, "roomId": room_id})
+
+    def seal_private_room(self, room_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/seal", {"roomId": room_id})
+
+    def create_frozen_snapshot(self, room_id: str, snapshot_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/snapshots", {"roomId": room_id, "snapshotId": snapshot_id})
+
+    def get_frozen_snapshot(self, room_id: str, snapshot_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/snapshots/query", {"roomId": room_id, "snapshotId": snapshot_id})
+
+    def get_frozen_snapshot_download(self, room_id: str, snapshot_id: str) -> Any:
+        return self._http.request("POST", "/v1/rooms/private/snapshots/download", {"roomId": room_id, "snapshotId": snapshot_id})
+
+    def attach_courseware(self, room_id: str, **input: Any) -> Any:
+        return self._http.request("POST", "/v1/rooms/coursewares", {**input, "roomId": room_id})
+
+
 class WhiteboardClient:
     def __init__(self, http: HttpTransport, *, app_id: str, app_secret: str) -> None:
         self.auth = _Auth(app_id, app_secret)
         self.recordings = _Recordings(http)
         self.captures = _Captures(http)
         self.files = _Files(http)
+        self.rooms = _Rooms(http)
         self._http = http
 
     @property

{eduskit-0.1.4 → eduskit-0.1.6}/eduskit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eduskit
-Version: 0.1.4
+Version: 0.1.6
 Summary: Eduskit B-end server SDK for classroom and whiteboard APIs
 Author: Eduskit
 License-Expression: Apache-2.0
@@ -68,7 +68,7 @@ token = sdk.client.auth.issue_token(eduUserId=user["eduUserId"], originId="stu_0
 classroom = sdk.client.classrooms.create(
     name="一年级数学",
     startsAt="2026-08-17T10:00:00.000Z",
-    endsAt="2026-08-17T11:00:00.000Z",
+    durationMinutes=60,
     teacherEduUserId=user["eduUserId"],
 )
 sdk.client.classrooms.start(classroom["classroomId"])
@@ -144,3 +144,25 @@ except EduskitError as e:
 ## 示例
 
 - [examples/classroom_quickstart.py](examples/classroom_quickstart.py)
+
+## Application business APIs
+
+Use the application-credential `client` for user lists and status, classroom queries and updates, courseware libraries, live assets, attendance, entry diagnostics, and activity logs. No console tenant token is required. See [the complete API reference](https://docs.eduskit.com/server-sdk/business-api/). New methods require a matching server-api deployment and a source SDK build.
+
+## Console management
+
+`ConsoleClient` exposes tenant management, authentication, applications, users, classrooms, courseware, live video, diagnostics, dashboards, and billing. Use the console-api URL and a tenant access token. Application-scoped methods require `appId`; app credentials are not sent by this client. This API is available in this source build.
+
+```python
+import os
+from eduskit import Eduskit
+sdk = Eduskit(console_client={
+    "base_url": os.environ["EDU_CONSOLE_URL"],
+    "access_token": os.environ["EDU_TENANT_ACCESS_TOKEN"],
+})
+c = sdk.console_client
+apps = c.apps.list()
+users = c.users.list(os.environ["EDU_APP_ID"], page=1, pageSize=20)
+```
+
+Full API fields and workflows: [Console management](https://docs.eduskit.com/server-sdk/console/).

{eduskit-0.1.4 → eduskit-0.1.6}/eduskit.egg-info/SOURCES.txt

@@ -3,6 +3,10 @@ README.md
 pyproject.toml
 eduskit/__init__.py
 eduskit/classroom.py
+eduskit/classroom_media.py
+eduskit/console.py
+eduskit/console.pyi
+eduskit/console_api.py
 eduskit/errors.py
 eduskit/http.py
 eduskit/token.py
@@ -11,4 +15,5 @@ eduskit.egg-info/PKG-INFO
 eduskit.egg-info/SOURCES.txt
 eduskit.egg-info/dependency_links.txt
 eduskit.egg-info/top_level.txt
+tests/test_console.py
 tests/test_eduskit.py

{eduskit-0.1.4 → eduskit-0.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "eduskit"
-version = "0.1.4"
+version = "0.1.6"
 description = "Eduskit B-end server SDK for classroom and whiteboard APIs"
 requires-python = ">=3.9"
 readme = "README.md"

eduskit-0.1.6/tests/test_console.py

@@ -0,0 +1,101 @@
+import json
+import re
+import unittest
+from pathlib import Path
+from urllib.parse import urlsplit, parse_qs
+from eduskit import ConsoleClient, Eduskit, EduskitError
+
+
+def snake(name):
+    return re.sub(r'(?<!^)(?=[A-Z])', '_', name).lower()
+
+
+class ConsoleTests(unittest.TestCase):
+    def test_all_operations(self):
+        ops = json.loads(Path(__file__).with_name('console-contract.json').read_text())
+        active = None
+        count = 0
+        def fetch(url, method, headers, body, timeout):
+            nonlocal count
+            count += 1
+            route = urlsplit(url)
+            self.assertEqual(route.path, active['path'])
+            self.assertEqual(method, active['method'])
+            self.assertEqual(headers.get('Authorization'), None if active['scope'] == 'public' else 'Bearer token')
+            self.assertEqual(headers.get('x-app-id'), 'app_测试' if active['scope'] == 'app' else None)
+            self.assertNotIn('x-app-key', headers)
+            self.assertNotIn('x-app-secret', headers)
+            if active['input'] != 'EmptyInput':
+                if active.get('queryKeys'):
+                    self.assertEqual(parse_qs(route.query)['classroomId'], ['cls_中 &/?'])
+                    self.assertNotIn('classroomId', json.loads(body))
+                elif method in ('GET', 'DELETE'):
+                    query = parse_qs(route.query)
+                    self.assertEqual(query['q'], ['中 &/?'])
+                    self.assertEqual(query['enabled'], ['false'])
+                    self.assertEqual(query['page'], ['0'])
+                    self.assertIsNone(body)
+                else:
+                    self.assertEqual(json.loads(body)['classroomId'], 'cls_中 &/?')
+            return 200, {}, b'{"code":0,"data":[{"ok":true}],"traceId":"trace"}'
+        c = ConsoleClient(base_url='https://console.test', access_token='token', fetch=fetch)
+        for active in ops:
+            group, method = map(snake, active['name'].split('.'))
+            args = ['app_测试'] if active['scope'] == 'app' else []
+            payload = {} if active['input'] == 'EmptyInput' else dict(classroomId='cls_中 &/?', q='中 &/?', enabled=False, page=0, unused=None)
+            self.assertEqual(getattr(getattr(c, group), method)(*args, **payload), [{'ok': True}])
+            self.assertEqual(c.last_trace_id, 'trace')
+        self.assertEqual(count, len(ops))
+
+    def test_guards_errors_and_upload(self):
+        calls = []
+        def fetch(url, method, headers, body, timeout):
+            calls.append(url)
+            if 'storage.test' in url:
+                self.assertEqual(headers, {'Content-Type': 'application/octet-stream'})
+                self.assertEqual(body, b'\x00\xff\x01')
+                return 200, {}, b''
+            self.assertEqual(headers['Authorization'], 'Bearer updated')
+            return 403, {}, b'{"code":403,"errorCode":"APP_NOT_OWNED","traceId":"trace"}'
+        c = ConsoleClient(base_url='https://console.test', fetch=fetch)
+        with self.assertRaises(EduskitError) as error: c.apps.list()
+        self.assertEqual(error.exception.error_code, 'SDK_CONSOLE_TOKEN_REQUIRED')
+        c.set_access_token('updated')
+        with self.assertRaises(EduskitError): c.users.list(' ')
+        self.assertEqual(calls, [])
+        with self.assertRaises(EduskitError) as error: c.apps.list()
+        self.assertEqual(error.exception.source, 'console')
+        self.assertEqual(error.exception.trace_id, 'trace')
+        c.upload_file('https://storage.test/signed', b'\x00\xff\x01', 'application/octet-stream')
+        with self.assertRaises(EduskitError): Eduskit().console_client
+
+    def test_app_media(self):
+        active = None
+        def fetch(url, method, headers, body, timeout):
+            self.assertEqual(urlsplit(url).path, active['path'])
+            self.assertEqual(method, active['method'])
+            self.assertEqual(headers['x-app-key'], 'key')
+            self.assertEqual(headers['x-app-secret'], 'secret')
+            self.assertNotIn('Authorization', headers)
+            if method in ('GET', 'DELETE'):
+                self.assertEqual(parse_qs(urlsplit(url).query)['classroomId'], ['cls_中 &/?'])
+            else: self.assertEqual(json.loads(body)['classroomId'], 'cls_中 &/?')
+            return 200, {}, b'{"code":0,"data":{"ok":true}}'
+        c = Eduskit(client=dict(base_url='https://server.test', app_id='app_1', app_key='key', app_secret='secret'), fetch=fetch).client
+        for active in json.loads(Path(__file__).with_name('media-contract.json').read_text()):
+            group, method = map(snake, active['name'].split('.'))
+            self.assertEqual(getattr(getattr(c, group), method)(classroomId='cls_中 &/?'), {'ok': True})
+
+    def test_business_upload_and_false_query(self):
+        def fetch(url, method, headers, body, timeout):
+            if 'storage.test' in url:
+                self.assertEqual(method, 'PUT')
+                self.assertEqual(headers, {'Content-Type': 'application/pdf'})
+                self.assertEqual(body, b'\x00\xff\x01')
+                return 200, {}, b''
+            self.assertEqual(parse_qs(urlsplit(url).query)['requireOriginId'], ['false'])
+            self.assertNotIn('Authorization', headers)
+            return 200, {}, b'{"code":0,"data":{"items":[]}}'
+        c = Eduskit(client=dict(base_url='https://server.test', app_id='app_1', app_key='key', app_secret='secret'), fetch=fetch).client
+        c.upload_file('https://storage.test/signed', b'\x00\xff\x01', 'application/pdf')
+        c.users.search(requireOriginId=False)

{eduskit-0.1.4 → eduskit-0.1.6}/tests/test_eduskit.py

@@ -1,4 +1,5 @@
 import json
+import base64
 import unittest
 
 from eduskit import Eduskit, EduskitError
@@ -22,6 +23,39 @@ def mock_fetch(body, status=200, headers=None):
 
 
 class EduskitTest(unittest.TestCase):
+    def test_private_room_server_routes(self):
+        fetch, calls = mock_fetch({"code": 0, "data": {"marker": "server-result"}})
+        sdk = Eduskit(whiteboard_client={"base_url": "http://wb.test", "app_id": "app_wb", "app_key": "wk", "app_secret": "ws"}, fetch=fetch)
+        rooms = sdk.whiteboard_client.rooms
+        operations = [
+            lambda: rooms.provision_private_room("room_a", "assignment_a"),
+            lambda: rooms.change_private_room_grant("room_a", userId="student_a", requestId="grant_a", expectedGeneration="9223372036854775806", action="grant", role="participant"),
+            lambda: rooms.get_private_room_access("room_a", "student_a"),
+            lambda: rooms.issue_private_room_token("room_a", userId="student_a", role="participant", expiresIn=600),
+            lambda: rooms.seal_private_room("room_a"),
+            lambda: rooms.create_frozen_snapshot("room_a", "snapshot_a"),
+            lambda: rooms.get_frozen_snapshot("room_a", "snapshot_a"),
+            lambda: rooms.get_frozen_snapshot_download("room_a", "snapshot_a"),
+            lambda: rooms.initialize_private_workspace("room_a", "assignment_a", None),
+            lambda: rooms.initialize_private_workspace("room_a", "assignment_a", "snapshot_a"),
+            lambda: rooms.get_private_workspace_initialization("room_a"),
+            lambda: rooms.schedule_private_room_writes("room_a", "window_a", "2026-10-02T00:00:00.000Z", "2026-10-02T00:10:00.000Z"),
+        ]
+        for operation in operations:
+            self.assertEqual(operation(), {"marker": "server-result"})
+        expected = ["", "/grants", "/access/query", "/token", "/seal", "/snapshots", "/snapshots/query", "/snapshots/download", "/initializations", "/initializations", "/initializations/query", "/write-window"]
+        self.assertEqual([call["url"] for call in calls], ["http://wb.test/v1/rooms/private" + suffix for suffix in expected])
+        for call in calls:
+            self.assertEqual(call["method"], "POST")
+            self.assertEqual(call["body"]["roomId"], "room_a")
+            self.assertEqual(call["headers"]["x-app-key"], "wk")
+        self.assertEqual(calls[1]["body"]["expectedGeneration"], "9223372036854775806")
+        self.assertNotIn("accessGeneration", calls[3]["body"])
+        self.assertEqual(calls[8]["body"], {"roomId": "room_a", "assignmentId": "assignment_a", "sourceSnapshotId": None})
+        self.assertEqual(calls[9]["body"]["sourceSnapshotId"], "snapshot_a")
+        self.assertEqual(calls[10]["body"], {"roomId": "room_a"})
+        self.assertEqual(calls[11]["body"], {"roomId":"room_a", "requestId":"window_a", "opensAt":"2026-10-02T00:00:00.000Z", "closesAt":"2026-10-02T00:10:00.000Z"})
+
     def test_classroom_register(self):
         fetch, calls = mock_fetch(
             {
@@ -56,6 +90,10 @@ class EduskitTest(unittest.TestCase):
         )
         self.assertEqual(token["appId"], "app_wb")
         self.assertEqual(len(token["token"].split(".")), 3)
+        segment = token["token"].split(".")[1]
+        claims = json.loads(base64.urlsafe_b64decode(segment + "=" * (-len(segment) % 4)))
+        self.assertIn("access_generation", claims)
+        self.assertIsNone(claims["access_generation"])
         self.assertEqual(calls, [])
 
     def test_error_envelope(self):