skillforge-client 0.4.0__tar.gz → 0.6.0__tar.gz

{skillforge_client-0.4.0 → skillforge_client-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: skillforge-client
-Version: 0.4.0
+Version: 0.6.0
 Summary: Official Python client for the Skillforge API.
 Keywords: skillforge,api,client,openapi
 Author: Leon Weimann
@@ -15,7 +15,7 @@ Requires-Dist: attrs>=22.2.0
 Requires-Python: >=3.11
 Project-URL: Repository, https://github.com/Nachhilfe-Leon-Weimann/skillforge
 Project-URL: Issues, https://github.com/Nachhilfe-Leon-Weimann/skillforge/issues
-Project-URL: OpenAPI contract, https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.4.0/openapi.json
+Project-URL: OpenAPI contract, https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.6.0/openapi.json
 Description-Content-Type: text/markdown
 
 # Skillforge Python Client
@@ -77,7 +77,7 @@ Generated request and response models are available from `skillforge_client.mode
 
 ## Versioning and source
 
-Client versions follow Skillforge releases. This package was generated from the [`openapi.json`](https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.4.0/openapi.json) contract for Skillforge v0.4.0; generated source is not maintained by hand.
+Client versions follow Skillforge releases. This package was generated from the [`openapi.json`](https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.6.0/openapi.json) contract for Skillforge v0.6.0; generated source is not maintained by hand.
 
 - [Skillforge repository](https://github.com/Nachhilfe-Leon-Weimann/skillforge)
 - [Issue tracker](https://github.com/Nachhilfe-Leon-Weimann/skillforge/issues)

{skillforge_client-0.4.0 → skillforge_client-0.6.0}/README.md

@@ -57,7 +57,7 @@ Generated request and response models are available from `skillforge_client.mode
 
 ## Versioning and source
 
-Client versions follow Skillforge releases. This package was generated from the [`openapi.json`](https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.4.0/openapi.json) contract for Skillforge v0.4.0; generated source is not maintained by hand.
+Client versions follow Skillforge releases. This package was generated from the [`openapi.json`](https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.6.0/openapi.json) contract for Skillforge v0.6.0; generated source is not maintained by hand.
 
 - [Skillforge repository](https://github.com/Nachhilfe-Leon-Weimann/skillforge)
 - [Issue tracker](https://github.com/Nachhilfe-Leon-Weimann/skillforge/issues)

{skillforge_client-0.4.0 → skillforge_client-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "skillforge-client"
-version = "0.4.0"
+version = "0.6.0"
 description = "Official Python client for the Skillforge API."
 requires-python = ">=3.11"
 readme = "README.md"
@@ -29,7 +29,7 @@ email = "coding@leonweimann.de"
 [project.urls]
 Repository = "https://github.com/Nachhilfe-Leon-Weimann/skillforge"
 Issues = "https://github.com/Nachhilfe-Leon-Weimann/skillforge/issues"
-"OpenAPI contract" = "https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.4.0/openapi.json"
+"OpenAPI contract" = "https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.6.0/openapi.json"
 
 [tool.uv.build-backend]
 module-name = "skillforge_client"

{skillforge_client-0.4.0 → skillforge_client-0.6.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "skillforge-client"
-version = "0.4.0"
+version = "0.6.0"
 description = "Official Python client for the Skillforge API."
 authors = [{ name = "Leon Weimann", email = "coding@leonweimann.de" }]
 requires-python = ">=3.11"
@@ -21,7 +21,7 @@ dependencies = [
 [project.urls]
 Repository = "https://github.com/Nachhilfe-Leon-Weimann/skillforge"
 Issues = "https://github.com/Nachhilfe-Leon-Weimann/skillforge/issues"
-"OpenAPI contract" = "https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.4.0/openapi.json"
+"OpenAPI contract" = "https://github.com/Nachhilfe-Leon-Weimann/skillforge/blob/v0.6.0/openapi.json"
 
 [tool.uv.build-backend]
 module-name = "skillforge_client"

skillforge_client-0.4.0/skillforge_client/api/bot/bot_add_user_to_group.py → skillforge_client-0.6.0/skillforge_client/api/auth/auth_add_user_role.py

@@ -1,26 +1,28 @@
 from http import HTTPStatus
 from typing import Any
 from urllib.parse import quote
+from uuid import UUID
 
 import httpx
 
 from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.error_response import ErrorResponse
-from ...models.group_membership_response import GroupMembershipResponse
+from ...models.user_account_detail import UserAccountDetail
+from ...models.user_account_role_name import UserAccountRoleName
 from ...types import Response
 
 
 def _get_kwargs(
-    discord_id: int,
-    group_key: str,
+    user_id: UUID,
+    role: UserAccountRoleName,
 ) -> dict[str, Any]:
 
     _kwargs: dict[str, Any] = {
         "method": "put",
-        "url": "/api/v1/bot/users/{discord_id}/groups/{group_key}".format(
-            discord_id=quote(str(discord_id), safe=""),
-            group_key=quote(str(group_key), safe=""),
+        "url": "/api/v1/auth/users/{user_id}/roles/{role}".format(
+            user_id=quote(str(user_id), safe=""),
+            role=quote(str(role), safe=""),
         ),
     }
 
@@ -29,9 +31,9 @@ def _get_kwargs(
 
 def _parse_response(
     *, client: AuthenticatedClient | Client, response: httpx.Response
-) -> ErrorResponse | GroupMembershipResponse | None:
+) -> ErrorResponse | UserAccountDetail | None:
     if response.status_code == 200:
-        response_200 = GroupMembershipResponse.from_dict(response.json())
+        response_200 = UserAccountDetail.from_dict(response.json())
 
         return response_200
 
@@ -63,7 +65,7 @@ def _parse_response(
 
 def _build_response(
     *, client: AuthenticatedClient | Client, response: httpx.Response
-) -> Response[ErrorResponse | GroupMembershipResponse]:
+) -> Response[ErrorResponse | UserAccountDetail]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -73,30 +75,30 @@ def _build_response(
 
 
 def sync_detailed(
-    discord_id: int,
-    group_key: str,
+    user_id: UUID,
+    role: UserAccountRoleName,
     *,
     client: AuthenticatedClient,
-) -> Response[ErrorResponse | GroupMembershipResponse]:
-    """Add User To Group Endpoint
+) -> Response[ErrorResponse | UserAccountDetail]:
+    """Add User Role
 
-     Add a Discord user to a permission group. Idempotent on (user, group).
+     Give the account a stored role. Idempotent: a role it already holds changes nothing.
 
     Args:
-        discord_id (int):
-        group_key (str):
+        user_id (UUID): ID of the user account.
+        role (UserAccountRoleName):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[ErrorResponse | GroupMembershipResponse]
+        Response[ErrorResponse | UserAccountDetail]
     """
 
     kwargs = _get_kwargs(
-        discord_id=discord_id,
-        group_key=group_key,
+        user_id=user_id,
+        role=role,
     )
 
     response = client.get_httpx_client().request(
@@ -107,59 +109,59 @@ def sync_detailed(
 
 
 def sync(
-    discord_id: int,
-    group_key: str,
+    user_id: UUID,
+    role: UserAccountRoleName,
     *,
     client: AuthenticatedClient,
-) -> ErrorResponse | GroupMembershipResponse | None:
-    """Add User To Group Endpoint
+) -> ErrorResponse | UserAccountDetail | None:
+    """Add User Role
 
-     Add a Discord user to a permission group. Idempotent on (user, group).
+     Give the account a stored role. Idempotent: a role it already holds changes nothing.
 
     Args:
-        discord_id (int):
-        group_key (str):
+        user_id (UUID): ID of the user account.
+        role (UserAccountRoleName):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        ErrorResponse | GroupMembershipResponse
+        ErrorResponse | UserAccountDetail
     """
 
     return sync_detailed(
-        discord_id=discord_id,
-        group_key=group_key,
+        user_id=user_id,
+        role=role,
         client=client,
     ).parsed
 
 
 async def asyncio_detailed(
-    discord_id: int,
-    group_key: str,
+    user_id: UUID,
+    role: UserAccountRoleName,
     *,
     client: AuthenticatedClient,
-) -> Response[ErrorResponse | GroupMembershipResponse]:
-    """Add User To Group Endpoint
+) -> Response[ErrorResponse | UserAccountDetail]:
+    """Add User Role
 
-     Add a Discord user to a permission group. Idempotent on (user, group).
+     Give the account a stored role. Idempotent: a role it already holds changes nothing.
 
     Args:
-        discord_id (int):
-        group_key (str):
+        user_id (UUID): ID of the user account.
+        role (UserAccountRoleName):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        Response[ErrorResponse | GroupMembershipResponse]
+        Response[ErrorResponse | UserAccountDetail]
     """
 
     kwargs = _get_kwargs(
-        discord_id=discord_id,
-        group_key=group_key,
+        user_id=user_id,
+        role=role,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -168,31 +170,31 @@ async def asyncio_detailed(
 
 
 async def asyncio(
-    discord_id: int,
-    group_key: str,
+    user_id: UUID,
+    role: UserAccountRoleName,
     *,
     client: AuthenticatedClient,
-) -> ErrorResponse | GroupMembershipResponse | None:
-    """Add User To Group Endpoint
+) -> ErrorResponse | UserAccountDetail | None:
+    """Add User Role
 
-     Add a Discord user to a permission group. Idempotent on (user, group).
+     Give the account a stored role. Idempotent: a role it already holds changes nothing.
 
     Args:
-        discord_id (int):
-        group_key (str):
+        user_id (UUID): ID of the user account.
+        role (UserAccountRoleName):
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
         httpx.TimeoutException: If the request takes longer than Client.timeout.
 
     Returns:
-        ErrorResponse | GroupMembershipResponse
+        ErrorResponse | UserAccountDetail
     """
 
     return (
         await asyncio_detailed(
-            discord_id=discord_id,
-            group_key=group_key,
+            user_id=user_id,
+            role=role,
             client=client,
         )
     ).parsed

skillforge_client-0.6.0/skillforge_client/api/auth/auth_create_token.py

@@ -0,0 +1,271 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.access_token_response import AccessTokenResponse
+from ...models.body_auth_create_token import BodyAuthCreateToken
+from ...models.error_response import ErrorResponse
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: BodyAuthCreateToken,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/api/v1/auth/token",
+    }
+
+    _kwargs["data"] = body.to_dict()
+    headers["Content-Type"] = "application/x-www-form-urlencoded"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AccessTokenResponse | ErrorResponse | None:
+    if response.status_code == 200:
+        response_200 = AccessTokenResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+
+    if response.status_code == 401:
+        response_401 = ErrorResponse.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 422:
+        response_422 = ErrorResponse.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AccessTokenResponse | ErrorResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: BodyAuthCreateToken,
+) -> Response[AccessTokenResponse | ErrorResponse]:
+    r"""Create Token
+
+     Issue an access token.
+
+    The client authenticates for every grant, with HTTP Basic or `client_id` / `client_secret` in the
+    form.
+    `client_credentials` issues a token of the client's own. `password` logs a person in and opens a
+    session;
+    `refresh_token` renews it and replaces its refresh token. Both need `auth:users:login` granted to
+    the client
+    in `application` mode. Every failure of the person's credentials or refresh token is the same
+    `invalid_grant`.
+
+    `urn:skillforge:params:oauth:grant-type:discord-user` exchanges the Discord user in
+    `discord_user_id` - the one
+    who sent a command, never one named in it - for a token of the person party it is actively linked
+    to. It needs
+    `auth:users:exchange` granted to the client in `application` mode. The token carries `amr:
+    [\"discord\"]` and at
+    most `crm:read`, `crm:read:own` and `crm:write`, within the client's `delegated` grants and the
+    person's roles.
+    No refresh token and no session: exchange again when it expires. No active link, no account and a
+    disabled
+    account are the same `invalid_grant`. Swagger UI's Authorize dialog cannot use this grant; try it
+    with curl.
+
+    Args:
+        body (BodyAuthCreateToken):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AccessTokenResponse | ErrorResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    body: BodyAuthCreateToken,
+) -> AccessTokenResponse | ErrorResponse | None:
+    r"""Create Token
+
+     Issue an access token.
+
+    The client authenticates for every grant, with HTTP Basic or `client_id` / `client_secret` in the
+    form.
+    `client_credentials` issues a token of the client's own. `password` logs a person in and opens a
+    session;
+    `refresh_token` renews it and replaces its refresh token. Both need `auth:users:login` granted to
+    the client
+    in `application` mode. Every failure of the person's credentials or refresh token is the same
+    `invalid_grant`.
+
+    `urn:skillforge:params:oauth:grant-type:discord-user` exchanges the Discord user in
+    `discord_user_id` - the one
+    who sent a command, never one named in it - for a token of the person party it is actively linked
+    to. It needs
+    `auth:users:exchange` granted to the client in `application` mode. The token carries `amr:
+    [\"discord\"]` and at
+    most `crm:read`, `crm:read:own` and `crm:write`, within the client's `delegated` grants and the
+    person's roles.
+    No refresh token and no session: exchange again when it expires. No active link, no account and a
+    disabled
+    account are the same `invalid_grant`. Swagger UI's Authorize dialog cannot use this grant; try it
+    with curl.
+
+    Args:
+        body (BodyAuthCreateToken):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AccessTokenResponse | ErrorResponse
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    body: BodyAuthCreateToken,
+) -> Response[AccessTokenResponse | ErrorResponse]:
+    r"""Create Token
+
+     Issue an access token.
+
+    The client authenticates for every grant, with HTTP Basic or `client_id` / `client_secret` in the
+    form.
+    `client_credentials` issues a token of the client's own. `password` logs a person in and opens a
+    session;
+    `refresh_token` renews it and replaces its refresh token. Both need `auth:users:login` granted to
+    the client
+    in `application` mode. Every failure of the person's credentials or refresh token is the same
+    `invalid_grant`.
+
+    `urn:skillforge:params:oauth:grant-type:discord-user` exchanges the Discord user in
+    `discord_user_id` - the one
+    who sent a command, never one named in it - for a token of the person party it is actively linked
+    to. It needs
+    `auth:users:exchange` granted to the client in `application` mode. The token carries `amr:
+    [\"discord\"]` and at
+    most `crm:read`, `crm:read:own` and `crm:write`, within the client's `delegated` grants and the
+    person's roles.
+    No refresh token and no session: exchange again when it expires. No active link, no account and a
+    disabled
+    account are the same `invalid_grant`. Swagger UI's Authorize dialog cannot use this grant; try it
+    with curl.
+
+    Args:
+        body (BodyAuthCreateToken):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AccessTokenResponse | ErrorResponse]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    body: BodyAuthCreateToken,
+) -> AccessTokenResponse | ErrorResponse | None:
+    r"""Create Token
+
+     Issue an access token.
+
+    The client authenticates for every grant, with HTTP Basic or `client_id` / `client_secret` in the
+    form.
+    `client_credentials` issues a token of the client's own. `password` logs a person in and opens a
+    session;
+    `refresh_token` renews it and replaces its refresh token. Both need `auth:users:login` granted to
+    the client
+    in `application` mode. Every failure of the person's credentials or refresh token is the same
+    `invalid_grant`.
+
+    `urn:skillforge:params:oauth:grant-type:discord-user` exchanges the Discord user in
+    `discord_user_id` - the one
+    who sent a command, never one named in it - for a token of the person party it is actively linked
+    to. It needs
+    `auth:users:exchange` granted to the client in `application` mode. The token carries `amr:
+    [\"discord\"]` and at
+    most `crm:read`, `crm:read:own` and `crm:write`, within the client's `delegated` grants and the
+    person's roles.
+    No refresh token and no session: exchange again when it expires. No active link, no account and a
+    disabled
+    account are the same `invalid_grant`. Swagger UI's Authorize dialog cannot use this grant; try it
+    with curl.
+
+    Args:
+        body (BodyAuthCreateToken):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AccessTokenResponse | ErrorResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed