dart-tools 0.8.5__tar.gz → 0.8.7__tar.gz

{dart_tools-0.8.5 → dart_tools-0.8.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dart-tools
-Version: 0.8.5
+Version: 0.8.7
 Summary: The Dart CLI and Python Library
 Author-email: Dart <software@dartai.com>
 License: MIT License
@@ -72,17 +72,12 @@ Dynamic: license-file
 
 [Dart](https://dartai.com?nr=1) is Project Management powered by AI.
 
-`dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
+`dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python. It implements client functions to the [Dart Public API](https://app.dartai.com/api/v0/public/docs/).
 
 - [Installation](#installation)
   - [Naming conflicts](#naming-conflicts)
 - [Using the CLI](#using-the-cli)
 - [Using the Python Library](#using-the-python-library)
-- [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
-  - [Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.](#navigate-to-the-directory-containing-your-lambda_functionpy-source-file-in-this-example-the-directory-is-named-my_function)
-  - [Create a Deployment Package](#create-a-deployment-package)
-  - [Zip the contents of the `package` directory along with your `lambda_function.py`](#zip-the-contents-of-the-package-directory-along-with-your-lambda_functionpy)
-  - [Deploy the Lambda function](#deploy-the-lambda-function)
 - [Help and Resources](#help-and-resources)
 - [Contributing](#contributing)
 - [License](#license)
@@ -147,43 +142,6 @@ new_task = create_task(
 update_task(new_task.id, status_title="Done")
 ```
 
-## Using the Python Library in AWS Lambda Functions
-
-To use the `dart-tools` Python library in an AWS Lambda function, you need to package the library with your Lambda deployment package (see more details at [Working with .zip file archives for Python Lambda functions](https://docs.aws.amazon.com/lambda/latest/dg/python-package.html)). Follow these steps:
-
-### Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
-
-  ```sh
-  cd my_function
-  ```
-
-### Create a Deployment Package
-
-  Use Docker to create a deployment package that includes the `dart-tools` library. Run the following commands in your terminal, ensuring that the `RUNTIME_PYTHON_VERSION` and `RUNTIME_ARCHITECTURE` environment variables match the runtime settings of your Lambda function:
-
-  ```sh
-  export RUNTIME_PYTHON_VERSION=3.12
-  export RUNTIME_ARCHITECTURE=x86_64
-  docker run --rm --volume ${PWD}:/app --entrypoint /bin/bash public.ecr.aws/lambda/python:${RUNTIME_PYTHON_VERSION}-${RUNTIME_ARCHITECTURE} -c "pip install --target /app/package dart-tools"
-  ```
-
-  This command installs the `dart-tools` library into a directory named `package` in your current working directory.
-
-### Zip the contents of the `package` directory along with your `lambda_function.py`
-
-  ```sh
-  cd package
-  zip -r ../my_deployment_package.zip .
-  cd ..
-  zip -r my_deployment_package.zip lambda_function.py
-  ```
-
-### Deploy the Lambda function
-
-  Upload the `my_deployment_package.zip` file to AWS Lambda using the AWS Management Console or the AWS CLI.
-
-By following these steps, you can use the `dart-tools` Python library within your AWS Lambda functions.
-
 ## Help and Resources
 
 - [Homepage](https://dartai.com/?nr=1)
@@ -194,12 +152,10 @@ By following these steps, you can use the `dart-tools` Python library within you
 - [Chat on Discord](https://discord.gg/RExv8jEkSh)
 - Email us at [support@dartai.com](mailto:support@dartai.com)
 
-
 ## Contributing
 
 Contributions are welcome! Please open an issue or submit a pull request.
 
-
 ## License
 
 This project is licensed under [the MIT License](LICENSE).

{dart_tools-0.8.5 → dart_tools-0.8.7}/README.md

@@ -9,17 +9,12 @@
 
 [Dart](https://dartai.com?nr=1) is Project Management powered by AI.
 
-`dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
+`dart-tools` is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python. It implements client functions to the [Dart Public API](https://app.dartai.com/api/v0/public/docs/).
 
 - [Installation](#installation)
   - [Naming conflicts](#naming-conflicts)
 - [Using the CLI](#using-the-cli)
 - [Using the Python Library](#using-the-python-library)
-- [Using the Python Library in AWS Lambda Functions](#using-the-python-library-in-aws-lambda-functions)
-  - [Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.](#navigate-to-the-directory-containing-your-lambda_functionpy-source-file-in-this-example-the-directory-is-named-my_function)
-  - [Create a Deployment Package](#create-a-deployment-package)
-  - [Zip the contents of the `package` directory along with your `lambda_function.py`](#zip-the-contents-of-the-package-directory-along-with-your-lambda_functionpy)
-  - [Deploy the Lambda function](#deploy-the-lambda-function)
 - [Help and Resources](#help-and-resources)
 - [Contributing](#contributing)
 - [License](#license)
@@ -84,43 +79,6 @@ new_task = create_task(
 update_task(new_task.id, status_title="Done")
 ```
 
-## Using the Python Library in AWS Lambda Functions
-
-To use the `dart-tools` Python library in an AWS Lambda function, you need to package the library with your Lambda deployment package (see more details at [Working with .zip file archives for Python Lambda functions](https://docs.aws.amazon.com/lambda/latest/dg/python-package.html)). Follow these steps:
-
-### Navigate to the directory containing your `lambda_function.py` source file. In this example, the directory is named `my_function`.
-
-  ```sh
-  cd my_function
-  ```
-
-### Create a Deployment Package
-
-  Use Docker to create a deployment package that includes the `dart-tools` library. Run the following commands in your terminal, ensuring that the `RUNTIME_PYTHON_VERSION` and `RUNTIME_ARCHITECTURE` environment variables match the runtime settings of your Lambda function:
-
-  ```sh
-  export RUNTIME_PYTHON_VERSION=3.12
-  export RUNTIME_ARCHITECTURE=x86_64
-  docker run --rm --volume ${PWD}:/app --entrypoint /bin/bash public.ecr.aws/lambda/python:${RUNTIME_PYTHON_VERSION}-${RUNTIME_ARCHITECTURE} -c "pip install --target /app/package dart-tools"
-  ```
-
-  This command installs the `dart-tools` library into a directory named `package` in your current working directory.
-
-### Zip the contents of the `package` directory along with your `lambda_function.py`
-
-  ```sh
-  cd package
-  zip -r ../my_deployment_package.zip .
-  cd ..
-  zip -r my_deployment_package.zip lambda_function.py
-  ```
-
-### Deploy the Lambda function
-
-  Upload the `my_deployment_package.zip` file to AWS Lambda using the AWS Management Console or the AWS CLI.
-
-By following these steps, you can use the `dart-tools` Python library within your AWS Lambda functions.
-
 ## Help and Resources
 
 - [Homepage](https://dartai.com/?nr=1)
@@ -131,12 +89,10 @@ By following these steps, you can use the `dart-tools` Python library within you
 - [Chat on Discord](https://discord.gg/RExv8jEkSh)
 - Email us at [support@dartai.com](mailto:support@dartai.com)
 
-
 ## Contributing
 
 Contributions are welcome! Please open an issue or submit a pull request.
 
-
 ## License
 
 This project is licensed under [the MIT License](LICENSE).

{dart_tools-0.8.5 → dart_tools-0.8.7}/dart/dart.py

@@ -85,6 +85,7 @@ _ROOT_PUBLIC_API_URL_FRAG = f"{_ROOT_PRIVATE_API_URL_FRAG}/public"
 _COPY_BRANCH_URL_FRAG = "/vcs/copy-branch-link"
 
 _AUTH_TOKEN_ENVVAR_KEY = "DART_TOKEN"
+_HOST_ENVVAR_KEY = "DART_HOST"
 _CONFIG_FPATH = platformdirs.user_config_path(_APP)
 _CLIENT_ID_KEY = "clientId"
 _HOST_KEY = "host"
@@ -105,6 +106,8 @@ _DEFAULT_DARTBOARD = "General/Active"
 
 _VERSION = version(_APP)
 _AUTH_TOKEN_ENVVAR = os.environ.get(_AUTH_TOKEN_ENVVAR_KEY)
+_HOST_ENVVAR = os.environ.get(_HOST_ENVVAR_KEY)
+_DEFAULT_HOST = _HOST_ENVVAR or _PROD_HOST
 
 
 def _get_help_text(fn: Callable) -> str:
@@ -221,7 +224,7 @@ class _Config:
                 pass
         self._content = {
             _CLIENT_ID_KEY: _make_id(),
-            _HOST_KEY: _PROD_HOST,
+            _HOST_KEY: _DEFAULT_HOST,
             _HOSTS_KEY: {},
         } | self._content
         self._content[_HOSTS_KEY] = defaultdict(dict, self._content[_HOSTS_KEY])

{dart_tools-0.8.5 → dart_tools-0.8.7}/dart/generated/api/__init__.py

@@ -8,5 +8,5 @@ from .doc import create_doc, delete_doc, get_doc, list_docs, update_doc
 from .folder import get_folder
 from .help_center_article import list_help_center_articles
 from .skill import retrieve_skill_by_title
-from .task import create_task, delete_task, get_task, list_tasks, update_task
+from .task import add_task_time_tracking, create_task, delete_task, get_task, list_tasks, move_task, update_task
 from .view import get_view

dart_tools-0.8.7/dart/generated/api/task/add_task_time_tracking.py

@@ -0,0 +1,190 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.task_time_tracking_create import TaskTimeTrackingCreate
+from ...models.wrapped_task import WrappedTask
+from ...types import Response
+
+
+def _get_kwargs(
+    id: str,
+    *,
+    body: TaskTimeTrackingCreate,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/tasks/{id}/time-tracking".format(
+            id=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, WrappedTask]]:
+    if response.status_code == 200:
+        response_200 = WrappedTask.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, 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(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskTimeTrackingCreate,
+) -> Response[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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, WrappedTask]]
+    """
+
+    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: TaskTimeTrackingCreate,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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, WrappedTask]
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskTimeTrackingCreate,
+) -> Response[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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, WrappedTask]]
+    """
+
+    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: TaskTimeTrackingCreate,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Add a time tracking entry to a task
+
+     Record an additional time tracking entry on a task and return the updated task with refreshed time
+    tracking.
+
+    Args:
+        id (str):
+        body (TaskTimeTrackingCreate):
+
+    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, WrappedTask]
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+            body=body,
+        )
+    ).parsed

dart_tools-0.8.7/dart/generated/api/task/move_task.py

@@ -0,0 +1,190 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union, cast
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.task_move import TaskMove
+from ...models.wrapped_task import WrappedTask
+from ...types import Response
+
+
+def _get_kwargs(
+    id: str,
+    *,
+    body: TaskMove,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/tasks/{id}/move".format(
+            id=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, WrappedTask]]:
+    if response.status_code == 200:
+        response_200 = WrappedTask.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, 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(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskMove,
+) -> Response[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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, WrappedTask]]
+    """
+
+    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: TaskMove,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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, WrappedTask]
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: str,
+    *,
+    client: Union[AuthenticatedClient, Client],
+    body: TaskMove,
+) -> Response[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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, WrappedTask]]
+    """
+
+    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: TaskMove,
+) -> Optional[Union[Any, WrappedTask]]:
+    """Move a task within its dartboard
+
+     Move a task to a specific position within results sorted by the order field. Use afterTaskId to
+    place the task after a specific task, or beforeTaskId to place it before one.
+
+    Args:
+        id (str):
+        body (TaskMove):
+
+    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, WrappedTask]
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+            body=body,
+        )
+    ).parsed

{dart_tools-0.8.5 → dart_tools-0.8.7}/dart/generated/models/__init__.py

@@ -16,13 +16,27 @@ from .list_comments_o_item import ListCommentsOItem
 from .list_docs_o_item import ListDocsOItem
 from .list_tasks_o_item import ListTasksOItem
 from .paginated_comment_list import PaginatedCommentList
+from .paginated_comment_list_meta_type_0 import PaginatedCommentListMetaType0
+from .paginated_comment_list_meta_type_0_applied_default_filters import (
+    PaginatedCommentListMetaType0AppliedDefaultFilters,
+)
 from .paginated_concise_doc_list import PaginatedConciseDocList
+from .paginated_concise_doc_list_meta_type_0 import PaginatedConciseDocListMetaType0
+from .paginated_concise_doc_list_meta_type_0_applied_default_filters import (
+    PaginatedConciseDocListMetaType0AppliedDefaultFilters,
+)
 from .paginated_concise_task_list import PaginatedConciseTaskList
+from .paginated_concise_task_list_meta_type_0 import PaginatedConciseTaskListMetaType0
+from .paginated_concise_task_list_meta_type_0_applied_default_filters import (
+    PaginatedConciseTaskListMetaType0AppliedDefaultFilters,
+)
 from .priority import Priority
 from .skill import Skill
 from .task import Task
 from .task_create import TaskCreate
+from .task_move import TaskMove
 from .task_relationships_type_0 import TaskRelationshipsType0
+from .task_time_tracking_create import TaskTimeTrackingCreate
 from .task_update import TaskUpdate
 from .time_tracking_entry import TimeTrackingEntry
 from .user import User
@@ -89,13 +103,21 @@ __all__ = (
     "ListDocsOItem",
     "ListTasksOItem",
     "PaginatedCommentList",
+    "PaginatedCommentListMetaType0",
+    "PaginatedCommentListMetaType0AppliedDefaultFilters",
     "PaginatedConciseDocList",
+    "PaginatedConciseDocListMetaType0",
+    "PaginatedConciseDocListMetaType0AppliedDefaultFilters",
     "PaginatedConciseTaskList",
+    "PaginatedConciseTaskListMetaType0",
+    "PaginatedConciseTaskListMetaType0AppliedDefaultFilters",
     "Priority",
     "Skill",
     "Task",
     "TaskCreate",
+    "TaskMove",
     "TaskRelationshipsType0",
+    "TaskTimeTrackingCreate",
     "TaskUpdate",
     "TimeTrackingEntry",
     "User",