dart-tools 0.6.15__py3-none-any.whl → 0.7.0__py3-none-any.whl

dart/generated/api/doc/update_doc.py

@@ -0,0 +1,188 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.wrapped_doc import WrappedDoc
+from ...models.wrapped_doc_update import WrappedDocUpdate
+from ...types import Response
+
+
+def _get_kwargs(
+    id: str,
+    *,
+    body: WrappedDocUpdate,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "put",
+        "url": f"/docs/{id}",
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[Any, WrappedDoc]]:
+    if response.status_code == 200:
+        response_200 = WrappedDoc.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 400:
+        response_400 = cast(Any, None)
+        return response_400
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[Any, WrappedDoc]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: WrappedDocUpdate,
+) -> Response[Union[Any, WrappedDoc]]:
+    """Update an existing doc
+
+     Update certain properties of an existing doc. This will save the doc in Dart for later access,
+    search, etc. Any properties that are not specified will not be changed.
+
+    Args:
+        id (str):
+        body (WrappedDocUpdate):
+
+    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[Union[Any, WrappedDoc]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: WrappedDocUpdate,
+) -> Optional[Union[Any, WrappedDoc]]:
+    """Update an existing doc
+
+     Update certain properties of an existing doc. This will save the doc in Dart for later access,
+    search, etc. Any properties that are not specified will not be changed.
+
+    Args:
+        id (str):
+        body (WrappedDocUpdate):
+
+    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:
+        Union[Any, WrappedDoc]
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: WrappedDocUpdate,
+) -> Response[Union[Any, WrappedDoc]]:
+    """Update an existing doc
+
+     Update certain properties of an existing doc. This will save the doc in Dart for later access,
+    search, etc. Any properties that are not specified will not be changed.
+
+    Args:
+        id (str):
+        body (WrappedDocUpdate):
+
+    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[Union[Any, WrappedDoc]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: WrappedDocUpdate,
+) -> Optional[Union[Any, WrappedDoc]]:
+    """Update an existing doc
+
+     Update certain properties of an existing doc. This will save the doc in Dart for later access,
+    search, etc. Any properties that are not specified will not be changed.
+
+    Args:
+        id (str):
+        body (WrappedDocUpdate):
+
+    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:
+        Union[Any, WrappedDoc]
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+            body=body,
+        )
+    ).parsed

dart/generated/api/folder/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

dart/generated/api/{webhooks/webhooks_list.py → folder/retrieve_folder.py}

@@ -1,31 +1,20 @@
 from http import HTTPStatus
-from typing import Any, Dict, Optional, Union
+from typing import Any, Optional, Union, cast
 
 import httpx
 
 from ... import errors
 from ...client import AuthenticatedClient, Client
-from ...models.paginated_webhook_list import PaginatedWebhookList
-from ...types import UNSET, Response, Unset
+from ...models.wrapped_folder import WrappedFolder
+from ...types import Response
 
 
 def _get_kwargs(
-    *,
-    limit: Union[Unset, int] = UNSET,
-    offset: Union[Unset, int] = UNSET,
-) -> Dict[str, Any]:
-    params: Dict[str, Any] = {}
-
-    params["limit"] = limit
-
-    params["offset"] = offset
-
-    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
-
-    _kwargs: Dict[str, Any] = {
+    id: str,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
         "method": "get",
-        "url": "/api/v0/webhooks",
-        "params": params,
+        "url": f"/folders/{id}",
     }
 
     return _kwargs
@@ -33,11 +22,14 @@ def _get_kwargs(
 
 def _parse_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Optional[PaginatedWebhookList]:
-    if response.status_code == HTTPStatus.OK:
-        response_200 = PaginatedWebhookList.from_dict(response.json())
+) -> Optional[Union[Any, WrappedFolder]]:
+    if response.status_code == 200:
+        response_200 = WrappedFolder.from_dict(response.json())
 
         return response_200
+    if response.status_code == 400:
+        response_400 = cast(Any, None)
+        return response_400
     if client.raise_on_unexpected_status:
         raise errors.UnexpectedStatus(response.status_code, response.content)
     else:
@@ -46,7 +38,7 @@ def _parse_response(
 
 def _build_response(
     *, client: Union[AuthenticatedClient, Client], response: httpx.Response
-) -> Response[PaginatedWebhookList]:
+) -> Response[Union[Any, WrappedFolder]]:
     return Response(
         status_code=HTTPStatus(response.status_code),
         content=response.content,
@@ -56,27 +48,28 @@ def _build_response(
 
 
 def sync_detailed(
+    id: str,
     *,
-    client: AuthenticatedClient,
-    limit: Union[Unset, int] = UNSET,
-    offset: Union[Unset, int] = UNSET,
-) -> Response[PaginatedWebhookList]:
-    """
+    client: Union[AuthenticatedClient, Client],
+) -> Response[Union[Any, WrappedFolder]]:
+    """Retrieve an existing folder
+
+     Retrieve an existing folder. This will return the folder's information, including the title,
+    description, all docs within it, and others.
+
     Args:
-        limit (Union[Unset, int]):
-        offset (Union[Unset, int]):
+        id (str):
 
     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[PaginatedWebhookList]
+        Response[Union[Any, WrappedFolder]]
     """
 
     kwargs = _get_kwargs(
-        limit=limit,
-        offset=offset,
+        id=id,
     )
 
     response = client.get_httpx_client().request(
@@ -87,53 +80,55 @@ def sync_detailed(
 
 
 def sync(
+    id: str,
     *,
-    client: AuthenticatedClient,
-    limit: Union[Unset, int] = UNSET,
-    offset: Union[Unset, int] = UNSET,
-) -> Optional[PaginatedWebhookList]:
-    """
+    client: Union[AuthenticatedClient, Client],
+) -> Optional[Union[Any, WrappedFolder]]:
+    """Retrieve an existing folder
+
+     Retrieve an existing folder. This will return the folder's information, including the title,
+    description, all docs within it, and others.
+
     Args:
-        limit (Union[Unset, int]):
-        offset (Union[Unset, int]):
+        id (str):
 
     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:
-        PaginatedWebhookList
+        Union[Any, WrappedFolder]
     """
 
     return sync_detailed(
+        id=id,
         client=client,
-        limit=limit,
-        offset=offset,
     ).parsed
 
 
 async def asyncio_detailed(
+    id: str,
     *,
-    client: AuthenticatedClient,
-    limit: Union[Unset, int] = UNSET,
-    offset: Union[Unset, int] = UNSET,
-) -> Response[PaginatedWebhookList]:
-    """
+    client: Union[AuthenticatedClient, Client],
+) -> Response[Union[Any, WrappedFolder]]:
+    """Retrieve an existing folder
+
+     Retrieve an existing folder. This will return the folder's information, including the title,
+    description, all docs within it, and others.
+
     Args:
-        limit (Union[Unset, int]):
-        offset (Union[Unset, int]):
+        id (str):
 
     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[PaginatedWebhookList]
+        Response[Union[Any, WrappedFolder]]
     """
 
     kwargs = _get_kwargs(
-        limit=limit,
-        offset=offset,
+        id=id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -142,28 +137,29 @@ async def asyncio_detailed(
 
 
 async def asyncio(
+    id: str,
     *,
-    client: AuthenticatedClient,
-    limit: Union[Unset, int] = UNSET,
-    offset: Union[Unset, int] = UNSET,
-) -> Optional[PaginatedWebhookList]:
-    """
+    client: Union[AuthenticatedClient, Client],
+) -> Optional[Union[Any, WrappedFolder]]:
+    """Retrieve an existing folder
+
+     Retrieve an existing folder. This will return the folder's information, including the title,
+    description, all docs within it, and others.
+
     Args:
-        limit (Union[Unset, int]):
-        offset (Union[Unset, int]):
+        id (str):
 
     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:
-        PaginatedWebhookList
+        Union[Any, WrappedFolder]
     """
 
     return (
         await asyncio_detailed(
+            id=id,
             client=client,
-            limit=limit,
-            offset=offset,
         )
     ).parsed

dart/generated/api/task/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

dart/generated/api/task/create_task.py

@@ -0,0 +1,172 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.wrapped_task import WrappedTask
+from ...models.wrapped_task_create import WrappedTaskCreate
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: WrappedTaskCreate,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/tasks",
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Optional[WrappedTask]:
+    if response.status_code == 200:
+        response_200 = WrappedTask.from_dict(response.json())
+
+        return response_200
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: Union[AuthenticatedClient, Client], response: httpx.Response) -> Response[WrappedTask]:
+    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: Union[AuthenticatedClient, Client],
+    body: WrappedTaskCreate,
+) -> Response[WrappedTask]:
+    """Create a new task
+
+     Record a new task that the user intends to do. This will save the task in Dart for later access,
+    search, etc. By default the created task will be assigned to the user, with a status of to-do, with
+    no parent, in the Active dartboard. More information can be included in the description.
+
+    Args:
+        body (WrappedTaskCreate):
+
+    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[WrappedTask]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: WrappedTaskCreate,
+) -> Optional[WrappedTask]:
+    """Create a new task
+
+     Record a new task that the user intends to do. This will save the task in Dart for later access,
+    search, etc. By default the created task will be assigned to the user, with a status of to-do, with
+    no parent, in the Active dartboard. More information can be included in the description.
+
+    Args:
+        body (WrappedTaskCreate):
+
+    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:
+        WrappedTask
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: WrappedTaskCreate,
+) -> Response[WrappedTask]:
+    """Create a new task
+
+     Record a new task that the user intends to do. This will save the task in Dart for later access,
+    search, etc. By default the created task will be assigned to the user, with a status of to-do, with
+    no parent, in the Active dartboard. More information can be included in the description.
+
+    Args:
+        body (WrappedTaskCreate):
+
+    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[WrappedTask]
+    """
+
+    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: Union[AuthenticatedClient, Client],
+    body: WrappedTaskCreate,
+) -> Optional[WrappedTask]:
+    """Create a new task
+
+     Record a new task that the user intends to do. This will save the task in Dart for later access,
+    search, etc. By default the created task will be assigned to the user, with a status of to-do, with
+    no parent, in the Active dartboard. More information can be included in the description.
+
+    Args:
+        body (WrappedTaskCreate):
+
+    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:
+        WrappedTask
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+        )
+    ).parsed