asana-api-cli 1.2.0__py3-none-any.whl

asana_api_cli/__init__.py

@@ -0,0 +1,3 @@
+from asana_api_cli.session import AsanaSession
+
+__all__ = ["AsanaSession"]

asana_api_cli/cli/__init__.py

@@ -0,0 +1,140 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+import click
+
+from asana_api_cli.version import version_string
+
+from asana_api_cli.session import runtime
+from asana_api_cli.cli.access_requests import access_requests_group
+from asana_api_cli.cli.allocations import allocations_group
+from asana_api_cli.cli.attachments import attachments_group
+from asana_api_cli.cli.audit_log_api import audit_log_api_group
+from asana_api_cli.cli.batch_api import batch_api_group
+from asana_api_cli.cli.budgets import budgets_group
+from asana_api_cli.cli.custom_field_settings import custom_field_settings_group
+from asana_api_cli.cli.custom_fields import custom_fields_group
+from asana_api_cli.cli.custom_types import custom_types_group
+from asana_api_cli.cli.events import events_group
+from asana_api_cli.cli.exports import exports_group
+from asana_api_cli.cli.goal_relationships import goal_relationships_group
+from asana_api_cli.cli.goals import goals_group
+from asana_api_cli.cli.jobs import jobs_group
+from asana_api_cli.cli.memberships import memberships_group
+from asana_api_cli.cli.organization_exports import organization_exports_group
+from asana_api_cli.cli.portfolio_memberships import portfolio_memberships_group
+from asana_api_cli.cli.portfolios import portfolios_group
+from asana_api_cli.cli.project_briefs import project_briefs_group
+from asana_api_cli.cli.project_memberships import project_memberships_group
+from asana_api_cli.cli.project_portfolio_settings import project_portfolio_settings_group
+from asana_api_cli.cli.project_statuses import project_statuses_group
+from asana_api_cli.cli.project_templates import project_templates_group
+from asana_api_cli.cli.projects import projects_group
+from asana_api_cli.cli.rates import rates_group
+from asana_api_cli.cli.reactions import reactions_group
+from asana_api_cli.cli.roles import roles_group
+from asana_api_cli.cli.rules import rules_group
+from asana_api_cli.cli.sections import sections_group
+from asana_api_cli.cli.status_updates import status_updates_group
+from asana_api_cli.cli.stories import stories_group
+from asana_api_cli.cli.tags import tags_group
+from asana_api_cli.cli.task_templates import task_templates_group
+from asana_api_cli.cli.tasks import tasks_group
+from asana_api_cli.cli.team_memberships import team_memberships_group
+from asana_api_cli.cli.teams import teams_group
+from asana_api_cli.cli.time_periods import time_periods_group
+from asana_api_cli.cli.time_tracking_categories import time_tracking_categories_group
+from asana_api_cli.cli.time_tracking_entries import time_tracking_entries_group
+from asana_api_cli.cli.timesheet_approval_statuses import timesheet_approval_statuses_group
+from asana_api_cli.cli.typeahead import typeahead_group
+from asana_api_cli.cli.user_task_lists import user_task_lists_group
+from asana_api_cli.cli.users import users_group
+from asana_api_cli.cli.webhooks import webhooks_group
+from asana_api_cli.cli.workspace_memberships import workspace_memberships_group
+from asana_api_cli.cli.workspaces import workspaces_group
+
+
+@click.group()
+@click.version_option(version_string(), prog_name="asana-api")
+@click.option("--host", default=None, help="Override API base URL (default: https://app.asana.com/api/1.0)")
+@click.option("--proxy", default=None, help="HTTP/HTTPS proxy URL")
+@click.option("--no-verify-ssl", is_flag=True, default=False, help="Disable TLS certificate verification (insecure)")
+@click.option("--ca-cert", "ca_cert", default=None, type=click.Path(exists=True, dir_okay=False), help="Path to a PEM bundle of trusted CA certificates")
+@click.option("--page-limit", "page_limit", type=int, default=None, help="Default per-page size for paginated endpoints")
+@click.option("--retries", type=int, default=None, help="Number of retries on 429/5xx responses (default: 5)")
+@click.option("--timeout", type=float, default=None, help="Per-request timeout in seconds")
+@click.option("--token-env", "token_env", default=None, help="Environment variable name holding the Asana access token (default: ASANA_ACCESS_TOKEN)")
+@click.option("--temp-dir", "temp_dir", default=None, type=click.Path(file_okay=False), help="Directory for temporary downloads")
+@click.option("--debug", is_flag=True, default=False, help="Print HTTP request/response to stderr for troubleshooting")
+def main(
+    host: str | None,
+    proxy: str | None,
+    no_verify_ssl: bool,
+    ca_cert: str | None,
+    page_limit: int | None,
+    retries: int | None,
+    timeout: float | None,
+    token_env: str | None,
+    temp_dir: str | None,
+    debug: bool,
+) -> None:
+    """Asana API CLI (SDK-backed wrapper)."""
+    runtime.host = host
+    runtime.proxy = proxy
+    runtime.verify_ssl = not no_verify_ssl
+    runtime.ssl_ca_cert = ca_cert
+    runtime.page_limit = page_limit
+    runtime.retries = retries
+    runtime.timeout = timeout
+    if token_env:
+        runtime.token_env = token_env
+    runtime.temp_dir = temp_dir
+    runtime.debug = debug
+
+
+main.add_command(access_requests_group)
+main.add_command(allocations_group)
+main.add_command(attachments_group)
+main.add_command(audit_log_api_group)
+main.add_command(batch_api_group)
+main.add_command(budgets_group)
+main.add_command(custom_field_settings_group)
+main.add_command(custom_fields_group)
+main.add_command(custom_types_group)
+main.add_command(events_group)
+main.add_command(exports_group)
+main.add_command(goal_relationships_group)
+main.add_command(goals_group)
+main.add_command(jobs_group)
+main.add_command(memberships_group)
+main.add_command(organization_exports_group)
+main.add_command(portfolio_memberships_group)
+main.add_command(portfolios_group)
+main.add_command(project_briefs_group)
+main.add_command(project_memberships_group)
+main.add_command(project_portfolio_settings_group)
+main.add_command(project_statuses_group)
+main.add_command(project_templates_group)
+main.add_command(projects_group)
+main.add_command(rates_group)
+main.add_command(reactions_group)
+main.add_command(roles_group)
+main.add_command(rules_group)
+main.add_command(sections_group)
+main.add_command(status_updates_group)
+main.add_command(stories_group)
+main.add_command(tags_group)
+main.add_command(task_templates_group)
+main.add_command(tasks_group)
+main.add_command(team_memberships_group)
+main.add_command(teams_group)
+main.add_command(time_periods_group)
+main.add_command(time_tracking_categories_group)
+main.add_command(time_tracking_entries_group)
+main.add_command(timesheet_approval_statuses_group)
+main.add_command(typeahead_group)
+main.add_command(user_task_lists_group)
+main.add_command(users_group)
+main.add_command(webhooks_group)
+main.add_command(workspace_memberships_group)
+main.add_command(workspaces_group)

asana_api_cli/cli/access_requests.py

@@ -0,0 +1,66 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import AccessRequestsApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("access-requests")
+def access_requests_group() -> None:
+    """AccessRequests commands."""
+
+
+@access_requests_group.command("approve-access-request")
+@click.option("--access-request", required=True, help="Globally unique identifier for the access request. If the method is called asynchronously, returns the request thread.")
+@formatted
+def approve_access_request(access_request: str) -> Any:
+    """Approve an access request"""
+    session = AsanaSession.from_env()
+    api = AccessRequestsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.approve_access_request(access_request)
+
+
+@access_requests_group.command("create-access-request")
+@click.option("--body", required=True, help="If the method is called asynchronously, returns the request thread.")
+@formatted
+def create_access_request(body: str) -> Any:
+    """Create an access request"""
+    parsed_body = resolve_body(body)
+    session = AsanaSession.from_env()
+    api = AccessRequestsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.create_access_request(parsed_body)
+
+
+@access_requests_group.command("get-access-requests")
+@click.option("--target", required=True, help="Globally unique identifier for the target object.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--user", default=None, help="A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.")
+@formatted
+def get_access_requests(target: str, opt_fields: str | None, user: str | None) -> Any:
+    """Get access requests"""
+    session = AsanaSession.from_env()
+    api = AccessRequestsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    if user is not None:
+        opts["user"] = user
+    return api.get_access_requests(target, opts)
+
+
+@access_requests_group.command("reject-access-request")
+@click.option("--access-request", required=True, help="Globally unique identifier for the access request. If the method is called asynchronously, returns the request thread.")
+@formatted
+def reject_access_request(access_request: str) -> Any:
+    """Reject an access request"""
+    session = AsanaSession.from_env()
+    api = AccessRequestsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.reject_access_request(access_request)

asana_api_cli/cli/allocations.py

@@ -0,0 +1,101 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import AllocationsApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("allocations")
+def allocations_group() -> None:
+    """Allocations commands."""
+
+
+@allocations_group.command("create-allocation")
+@click.option("--body", required=True, help="The allocation to create.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def create_allocation(body: str, opt_fields: str | None) -> Any:
+    """Create an allocation"""
+    parsed_body = resolve_body(body)
+    session = AsanaSession.from_env()
+    api = AllocationsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.create_allocation(parsed_body, opts)
+
+
+@allocations_group.command("delete-allocation")
+@click.option("--allocation", required=True, help="Globally unique identifier for the allocation. If the method is called asynchronously, returns the request thread.")
+@formatted
+def delete_allocation(allocation: str) -> Any:
+    """Delete an allocation"""
+    session = AsanaSession.from_env()
+    api = AllocationsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.delete_allocation(allocation)
+
+
+@allocations_group.command("get-allocation")
+@click.option("--allocation", required=True, help="Globally unique identifier for the allocation.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def get_allocation(allocation: str, opt_fields: str | None) -> Any:
+    """Get an allocation"""
+    session = AsanaSession.from_env()
+    api = AllocationsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_allocation(allocation, opts)
+
+
+@allocations_group.command("get-allocations")
+@click.option("--workspace", default=None, help="Workspace GID (falls back to ASANA_DEFAULT_WORKSPACE)")
+@click.option("--assignee", default=None, help="Globally unique identifier for the user or placeholder the allocation is assigned to.")
+@click.option("--limit", type=int, default=None, help="Results per page. The number of objects to return per page. The value must be between 1 and 100.")
+@click.option("--offset", default=None, help="Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not pass...")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--parent", default=None, help="Globally unique identifier for the project to filter allocations by.")
+@click.option("--paginate", is_flag=True, default=False, help="Fetch all pages")
+@formatted
+def get_allocations(workspace: str | None, assignee: str | None, limit: int | None, offset: str | None, opt_fields: str | None, parent: str | None, paginate: bool) -> Any:
+    """Get multiple allocations"""
+    resolved_workspace = resolve_workspace(workspace, required=False)
+    session = AsanaSession.from_env(paginate=paginate)
+    api = AllocationsApi(session.client)
+    opts: dict[str, Any] = {}
+    if assignee is not None:
+        opts["assignee"] = assignee
+    if limit is not None:
+        opts["limit"] = limit
+    if offset is not None:
+        opts["offset"] = offset
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    if parent is not None:
+        opts["parent"] = parent
+    if resolved_workspace is not None:
+        opts["workspace"] = resolved_workspace
+    return api.get_allocations(opts)
+
+
+@allocations_group.command("update-allocation")
+@click.option("--allocation", required=True, help="Globally unique identifier for the allocation.")
+@click.option("--body", required=True, help="The updated fields for the allocation.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def update_allocation(allocation: str, body: str, opt_fields: str | None) -> Any:
+    """Update an allocation"""
+    parsed_body = resolve_body(body)
+    session = AsanaSession.from_env()
+    api = AllocationsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.update_allocation(parsed_body, allocation, opts)

asana_api_cli/cli/attachments.py

@@ -0,0 +1,92 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import AttachmentsApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("attachments")
+def attachments_group() -> None:
+    """Attachments commands."""
+
+
+@attachments_group.command("create-attachment-for-object")
+@click.option("--connect-to-app", type=bool, default=None, help="")
+@click.option("--file", default=None, help="")
+@click.option("--name", default=None, help="")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--parent", default=None, help="")
+@click.option("--resource-subtype", default=None, help="")
+@click.option("--url", default=None, help="")
+@formatted
+def create_attachment_for_object(connect_to_app: bool | None, file: str | None, name: str | None, opt_fields: str | None, parent: str | None, resource_subtype: str | None, url: str | None) -> Any:
+    """Upload an attachment"""
+    session = AsanaSession.from_env()
+    api = AttachmentsApi(session.client)
+    opts: dict[str, Any] = {}
+    if connect_to_app is not None:
+        opts["connect_to_app"] = connect_to_app
+    if file is not None:
+        opts["file"] = file
+    if name is not None:
+        opts["name"] = name
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    if parent is not None:
+        opts["parent"] = parent
+    if resource_subtype is not None:
+        opts["resource_subtype"] = resource_subtype
+    if url is not None:
+        opts["url"] = url
+    return api.create_attachment_for_object(opts)
+
+
+@attachments_group.command("delete-attachment")
+@click.option("--attachment", required=True, help="Globally unique identifier for the attachment. If the method is called asynchronously, returns the request thread.")
+@formatted
+def delete_attachment(attachment: str) -> Any:
+    """Delete an attachment"""
+    session = AsanaSession.from_env()
+    api = AttachmentsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.delete_attachment(attachment)
+
+
+@attachments_group.command("get-attachment")
+@click.option("--attachment", required=True, help="Globally unique identifier for the attachment.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def get_attachment(attachment: str, opt_fields: str | None) -> Any:
+    """Get an attachment"""
+    session = AsanaSession.from_env()
+    api = AttachmentsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_attachment(attachment, opts)
+
+
+@attachments_group.command("get-attachments-for-object")
+@click.option("--parent", required=True, help="Globally unique identifier for object to fetch statuses from. Must be a GID for a `project`, `project_brief`, or `task`.")
+@click.option("--limit", type=int, default=None, help="Results per page. The number of objects to return per page. The value must be between 1 and 100.")
+@click.option("--offset", default=None, help="Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not pass...")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--paginate", is_flag=True, default=False, help="Fetch all pages")
+@formatted
+def get_attachments_for_object(parent: str, limit: int | None, offset: str | None, opt_fields: str | None, paginate: bool) -> Any:
+    """Get attachments from an object"""
+    session = AsanaSession.from_env(paginate=paginate)
+    api = AttachmentsApi(session.client)
+    opts: dict[str, Any] = {}
+    if limit is not None:
+        opts["limit"] = limit
+    if offset is not None:
+        opts["offset"] = offset
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_attachments_for_object(parent, opts)

asana_api_cli/cli/audit_log_api.py

@@ -0,0 +1,52 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import AuditLogAPIApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("audit-log-api")
+def audit_log_api_group() -> None:
+    """AuditLogAPI commands."""
+
+
+@audit_log_api_group.command("get-audit-log-events")
+@click.option("--workspace", default=None, help="Workspace GID (falls back to ASANA_DEFAULT_WORKSPACE)")
+@click.option("--actor-gid", default=None, help="Filter to events triggered by the actor with this ID.")
+@click.option("--actor-type", default=None, help="Filter to events with an actor of this type. This only needs to be included if querying for actor types without an ID. If `actor_gid` is included, this should be excluded.")
+@click.option("--end-at", default=None, help="Filter to events created before this time (exclusive).")
+@click.option("--event-type", default=None, help="Filter to events of this type. Refer to the [supported audit log events](/docs/audit-log-events#supported-audit-log-events) for a full list of values.")
+@click.option("--limit", type=int, default=None, help="Results per page. The number of objects to return per page. The value must be between 1 and 100.")
+@click.option("--offset", default=None, help="Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not pass...")
+@click.option("--resource-gid", default=None, help="Filter to events with this resource ID.")
+@click.option("--start-at", default=None, help="Filter to events created after this time (inclusive).")
+@click.option("--paginate", is_flag=True, default=False, help="Fetch all pages")
+@formatted
+def get_audit_log_events(workspace: str | None, actor_gid: str | None, actor_type: str | None, end_at: str | None, event_type: str | None, limit: int | None, offset: str | None, resource_gid: str | None, start_at: str | None, paginate: bool) -> Any:
+    """Get audit log events"""
+    resolved_workspace = resolve_workspace(workspace, required=True)
+    session = AsanaSession.from_env(paginate=paginate)
+    api = AuditLogAPIApi(session.client)
+    opts: dict[str, Any] = {}
+    if actor_gid is not None:
+        opts["actor_gid"] = actor_gid
+    if actor_type is not None:
+        opts["actor_type"] = actor_type
+    if end_at is not None:
+        opts["end_at"] = end_at
+    if event_type is not None:
+        opts["event_type"] = event_type
+    if limit is not None:
+        opts["limit"] = limit
+    if offset is not None:
+        opts["offset"] = offset
+    if resource_gid is not None:
+        opts["resource_gid"] = resource_gid
+    if start_at is not None:
+        opts["start_at"] = start_at
+    return api.get_audit_log_events(resolved_workspace, opts)

asana_api_cli/cli/batch_api.py

@@ -0,0 +1,30 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import BatchAPIApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("batch-api")
+def batch_api_group() -> None:
+    """BatchAPI commands."""
+
+
+@batch_api_group.command("create-batch-request")
+@click.option("--body", required=True, help="The requests to batch together via the Batch API.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def create_batch_request(body: str, opt_fields: str | None) -> Any:
+    """Submit parallel requests"""
+    parsed_body = resolve_body(body)
+    session = AsanaSession.from_env()
+    api = BatchAPIApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.create_batch_request(parsed_body, opts)

asana_api_cli/cli/budgets.py

@@ -0,0 +1,79 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import BudgetsApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("budgets")
+def budgets_group() -> None:
+    """Budgets commands."""
+
+
+@budgets_group.command("create-budget")
+@click.option("--body", required=True, help="The budget to create. If the method is called asynchronously, returns the request thread.")
+@formatted
+def create_budget(body: str) -> Any:
+    """Create a budget"""
+    parsed_body = resolve_body(body)
+    session = AsanaSession.from_env()
+    api = BudgetsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.create_budget(parsed_body)
+
+
+@budgets_group.command("delete-budget")
+@click.option("--budget", required=True, help="Globally unique identifier for the budget. If the method is called asynchronously, returns the request thread.")
+@formatted
+def delete_budget(budget: str) -> Any:
+    """Delete a budget"""
+    session = AsanaSession.from_env()
+    api = BudgetsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.delete_budget(budget)
+
+
+@budgets_group.command("get-budget")
+@click.option("--budget", required=True, help="Globally unique identifier for the budget.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def get_budget(budget: str, opt_fields: str | None) -> Any:
+    """Get a budget"""
+    session = AsanaSession.from_env()
+    api = BudgetsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_budget(budget, opts)
+
+
+@budgets_group.command("get-budgets")
+@click.option("--parent", required=True, help="Globally unique identifier for the budget's parent object. This currently can only be a `project`. If the method is called asynchronously, returns the request thread.")
+@formatted
+def get_budgets(parent: str) -> Any:
+    """Get all budgets"""
+    session = AsanaSession.from_env()
+    api = BudgetsApi(session.client)
+    opts: dict[str, Any] = {}
+    return api.get_budgets(parent)
+
+
+@budgets_group.command("update-budget")
+@click.option("--budget", required=True, help="Globally unique identifier for the budget.")
+@click.option("--body", required=True, help="The budget to update.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def update_budget(budget: str, body: str, opt_fields: str | None) -> Any:
+    """Update a budget"""
+    parsed_body = resolve_body(body)
+    session = AsanaSession.from_env()
+    api = BudgetsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.update_budget(parsed_body, budget, opts)

asana_api_cli/cli/custom_field_settings.py

@@ -0,0 +1,92 @@
+# This file is auto-generated by tools/codegen.py — do not edit manually.
+from __future__ import annotations
+
+from typing import Any
+
+import click
+from asana import CustomFieldSettingsApi
+
+from asana_api_cli.formatter import formatted
+from asana_api_cli.session import AsanaSession, resolve_body, resolve_workspace
+
+
+@click.group("custom-field-settings")
+def custom_field_settings_group() -> None:
+    """CustomFieldSettings commands."""
+
+
+@custom_field_settings_group.command("get-custom-field-settings-for-goal")
+@click.option("--goal", required=True, help="Globally unique identifier for the goal.")
+@click.option("--limit", type=int, default=None, help="Results per page. The number of objects to return per page. The value must be between 1 and 100.")
+@click.option("--offset", default=None, help="Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not pass...")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--paginate", is_flag=True, default=False, help="Fetch all pages")
+@formatted
+def get_custom_field_settings_for_goal(goal: str, limit: int | None, offset: str | None, opt_fields: str | None, paginate: bool) -> Any:
+    """Get a goal's custom fields"""
+    session = AsanaSession.from_env(paginate=paginate)
+    api = CustomFieldSettingsApi(session.client)
+    opts: dict[str, Any] = {}
+    if limit is not None:
+        opts["limit"] = limit
+    if offset is not None:
+        opts["offset"] = offset
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_custom_field_settings_for_goal(goal, opts)
+
+
+@custom_field_settings_group.command("get-custom-field-settings-for-portfolio")
+@click.option("--portfolio", required=True, help="Globally unique identifier for the portfolio.")
+@click.option("--limit", type=int, default=None, help="Results per page. The number of objects to return per page. The value must be between 1 and 100.")
+@click.option("--offset", default=None, help="Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not pass...")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--paginate", is_flag=True, default=False, help="Fetch all pages")
+@formatted
+def get_custom_field_settings_for_portfolio(portfolio: str, limit: int | None, offset: str | None, opt_fields: str | None, paginate: bool) -> Any:
+    """Get a portfolio's custom fields"""
+    session = AsanaSession.from_env(paginate=paginate)
+    api = CustomFieldSettingsApi(session.client)
+    opts: dict[str, Any] = {}
+    if limit is not None:
+        opts["limit"] = limit
+    if offset is not None:
+        opts["offset"] = offset
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_custom_field_settings_for_portfolio(portfolio, opts)
+
+
+@custom_field_settings_group.command("get-custom-field-settings-for-project")
+@click.option("--project", required=True, help="Globally unique identifier for the project.")
+@click.option("--limit", type=int, default=None, help="Results per page. The number of objects to return per page. The value must be between 1 and 100.")
+@click.option("--offset", default=None, help="Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not pass...")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@click.option("--paginate", is_flag=True, default=False, help="Fetch all pages")
+@formatted
+def get_custom_field_settings_for_project(project: str, limit: int | None, offset: str | None, opt_fields: str | None, paginate: bool) -> Any:
+    """Get a project's custom fields"""
+    session = AsanaSession.from_env(paginate=paginate)
+    api = CustomFieldSettingsApi(session.client)
+    opts: dict[str, Any] = {}
+    if limit is not None:
+        opts["limit"] = limit
+    if offset is not None:
+        opts["offset"] = offset
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_custom_field_settings_for_project(project, opts)
+
+
+@custom_field_settings_group.command("get-custom-field-settings-for-team")
+@click.option("--team", required=True, help="Globally unique identifier for the team.")
+@click.option("--opt-fields", default=None, help="This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to in...")
+@formatted
+def get_custom_field_settings_for_team(team: str, opt_fields: str | None) -> Any:
+    """Get a team's custom fields"""
+    session = AsanaSession.from_env()
+    api = CustomFieldSettingsApi(session.client)
+    opts: dict[str, Any] = {}
+    if opt_fields is not None:
+        opts["opt_fields"] = opt_fields
+    return api.get_custom_field_settings_for_team(team, opts)