dart-tools 0.8.4__tar.gz → 0.8.6__tar.gz

dart_tools-0.8.6/.env.example

@@ -0,0 +1 @@
+DART_TOKEN=''  # your authentication token from https://app.dartai.com/?settings=account

dart_tools-0.8.6/.gitattributes

@@ -0,0 +1,2 @@
+**/generated/** linguist-generated=true
+**/uv.lock linguist-generated=true

dart_tools-0.8.6/.gitignore

@@ -0,0 +1,129 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/

{dart_tools-0.8.4 → dart_tools-0.8.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dart-tools
-Version: 0.8.4
+Version: 0.8.6
 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.4 → dart_tools-0.8.6}/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.6/admin/README.md

@@ -0,0 +1,44 @@
+# Admin functionality
+
+- [Admin functionality](#admin-functionality)
+  - [Local setup](#local-setup)
+  - [Test with a different Python version](#test-with-a-different-python-version)
+  - [Sync API](#sync-api)
+  - [Deploy setup](#deploy-setup)
+  - [Deploy](#deploy)
+  - [Dependency updating](#dependency-updating)
+
+## Local setup
+
+1. Run `uv sync` to install the dependencies
+2. Run `cp -n .env.example .env` to copy the example environment file and then fill out all needed variables
+3. Run with `uv run dart [args ...]`
+
+## Test with a different Python version
+
+1. Choose the version with `uv venv --python 3.x`
+2. Run `uv sync`
+
+## Sync API
+
+1. Run `uv sync` as needed
+2. Run `make api`
+
+## Deploy setup
+
+1. Get an existing PyPI token or [make a new one](https://pypi.org/manage/account/token/)
+2. Set the `UV_PUBLISH_TOKEN` environment variable, for example, by running `export UV_PUBLISH_TOKEN=<PyPI token>`
+
+## Deploy
+
+1. Bump the version in `pyproject.toml`
+2. Run `uv sync`
+3. Run `make deploy`
+4. Commit and push all local changes to GitHub, then open and merge a PR there
+
+## Dependency updating
+
+1. Manually bump versions in `pyproject.toml`
+   1. Bump the dependencies in `dependencies` to be `>=` the lowest functional minor version
+   2. Bump the dependencies in `[dependency-groups]` to be `==` the latest patch version
+2. Run `make req-up-all`

dart_tools-0.8.6/admin/make-api.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# -*- coding: utf-8 -*-
+
+set -e
+
+if [ -f .env ]; then
+    export $(grep -v '^#' .env | xargs)
+fi
+
+DART_API_SCHEMA_URL="${DART_HOST:-https://app.dartai.com}/api/v0/public/schema/"
+GENERATED_PATH=$(pwd | sed 's:/admin$::')/dart/generated
+
+uv run openapi-python-client generate --url $DART_API_SCHEMA_URL --output-path $GENERATED_PATH --overwrite --meta none
+
+# Optimize API import paths
+api_dir="$GENERATED_PATH/api"
+init_file="$api_dir/__init__.py"
+
+find "$api_dir" -type f -name "*.py" ! -name "__init__.py" | while read -r file; do
+    service=$(basename "$(dirname "$file")")
+    method=$(basename "$file" .py)
+    echo "from .$service import $method" >> "$init_file"
+done
+
+# Patch generated files to fix naming issues
+echo "Patching generated files..."
+if [ -f "$GENERATED_PATH/models/list_comments_o_item.py" ]; then
+    sed -i '' 's/VALUE_0 = "-published_at"/PUBLISHED_AT_DESC = "-published_at"/' "$GENERATED_PATH/models/list_comments_o_item.py"
+    echo "Fixed VALUE_0 enum key in list_comments_o_item.py"
+fi

dart_tools-0.8.6/admin/make-deploy.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# -*- coding: utf-8 -*-
+
+set -e
+
+rm -rf dist
+uv build
+uv publish

dart_tools-0.8.6/admin/make-lambda-layer.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# -*- coding: utf-8 -*-
+
+set -e
+
+rm -rf layer.zip || true
+
+cat << 'EOF' > Dockerfile
+FROM public.ecr.aws/lambda/python:3.12
+RUN dnf install -y gcc zip
+WORKDIR /layer
+RUN pip install dart-tools -t python/lib/python3.12/site-packages
+RUN zip -r layer.zip python/
+ENTRYPOINT []
+CMD ["sleep", "1"]
+EOF
+
+docker build --no-cache --platform linux/amd64 -t layer-builder .
+docker create --name layer layer-builder
+docker cp layer:/layer/layer.zip ./layer.zip
+docker rm layer
+
+rm Dockerfile

{dart_tools-0.8.4 → dart_tools-0.8.6}/dart/dart.py

@@ -60,7 +60,7 @@ _PROG = "dart"
 
 _PROD_HOST = "https://app.dartai.com"
 _STAG_HOST = "https://stag.dartai.com"
-_DEV_HOST = "http://localhost:5173"
+_DEV_HOST = "http://localhost:5100"
 _HOST_MAP = {"prod": _PROD_HOST, "stag": _STAG_HOST, "dev": _DEV_HOST}
 
 # Service commands
@@ -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.4 → dart_tools-0.8.6}/dart/generated/api/doc/list_docs.py

@@ -12,11 +12,13 @@ from ...types import UNSET, Response, Unset
 
 def _get_kwargs(
     *,
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -25,6 +27,8 @@ def _get_kwargs(
 ) -> dict[str, Any]:
     params: dict[str, Any] = {}
 
+    params["editor"] = editor
+
     params["folder"] = folder
 
     params["folder_id"] = folder_id
@@ -35,6 +39,8 @@ def _get_kwargs(
 
     params["limit"] = limit
 
+    params["no_defaults"] = no_defaults
+
     json_o: Union[Unset, list[str]] = UNSET
     if not isinstance(o, Unset):
         json_o = []
@@ -90,11 +96,13 @@ def _build_response(
 def sync_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -105,11 +113,13 @@ def sync_detailed(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -125,11 +135,13 @@ def sync_detailed(
     """
 
     kwargs = _get_kwargs(
+        editor=editor,
         folder=folder,
         folder_id=folder_id,
         ids=ids,
         in_trash=in_trash,
         limit=limit,
+        no_defaults=no_defaults,
         o=o,
         offset=offset,
         s=s,
@@ -147,11 +159,13 @@ def sync_detailed(
 def sync(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -162,11 +176,13 @@ def sync(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -183,11 +199,13 @@ def sync(
 
     return sync_detailed(
         client=client,
+        editor=editor,
         folder=folder,
         folder_id=folder_id,
         ids=ids,
         in_trash=in_trash,
         limit=limit,
+        no_defaults=no_defaults,
         o=o,
         offset=offset,
         s=s,
@@ -199,11 +217,13 @@ def sync(
 async def asyncio_detailed(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -214,11 +234,13 @@ async def asyncio_detailed(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -234,11 +256,13 @@ async def asyncio_detailed(
     """
 
     kwargs = _get_kwargs(
+        editor=editor,
         folder=folder,
         folder_id=folder_id,
         ids=ids,
         in_trash=in_trash,
         limit=limit,
+        no_defaults=no_defaults,
         o=o,
         offset=offset,
         s=s,
@@ -254,11 +278,13 @@ async def asyncio_detailed(
 async def asyncio(
     *,
     client: Union[AuthenticatedClient, Client],
+    editor: Union[Unset, str] = UNSET,
     folder: Union[Unset, str] = UNSET,
     folder_id: Union[Unset, str] = UNSET,
     ids: Union[Unset, str] = UNSET,
     in_trash: Union[Unset, bool] = UNSET,
     limit: Union[Unset, int] = UNSET,
+    no_defaults: Union[Unset, bool] = False,
     o: Union[Unset, list[ListDocsOItem]] = UNSET,
     offset: Union[Unset, int] = UNSET,
     s: Union[Unset, str] = UNSET,
@@ -269,11 +295,13 @@ async def asyncio(
     full-text search. Sort by creation/update date or title. Supports pagination.
 
     Args:
+        editor (Union[Unset, str]):
         folder (Union[Unset, str]):
         folder_id (Union[Unset, str]):
         ids (Union[Unset, str]):
         in_trash (Union[Unset, bool]):
         limit (Union[Unset, int]):
+        no_defaults (Union[Unset, bool]):  Default: False.
         o (Union[Unset, list[ListDocsOItem]]):
         offset (Union[Unset, int]):
         s (Union[Unset, str]):
@@ -291,11 +319,13 @@ async def asyncio(
     return (
         await asyncio_detailed(
             client=client,
+            editor=editor,
             folder=folder,
             folder_id=folder_id,
             ids=ids,
             in_trash=in_trash,
             limit=limit,
+            no_defaults=no_defaults,
             o=o,
             offset=offset,
             s=s,