ajera 0.1.3__py3-none-any.whl

ajera/__init__.py

@@ -0,0 +1,5 @@
+from ajera.client import AjeraClient
+
+__all__ = [
+    "AjeraClient",
+]

ajera/cli/__init__.py

@@ -0,0 +1,95 @@
+import logging
+import sys
+
+import click
+import requests
+
+from ajera.cli.commands import (
+    activities,
+    bank_accounts,
+    clients,
+    companies,
+    contacts,
+    departments,
+    employees,
+    invoice_formats,
+    ledger,
+    projects,
+    rate_tables,
+    vendors,
+)
+from ajera.cli.context import ClientContext
+from ajera.cli.group import CommonClickGroup
+
+CLI_DOCS = """
+Deltek Ajera API command-line interface.
+
+Connection settings are read from environment variables:
+
+\b
+- AJERA_API_URL to define the API endpoint.
+- AJERA_API_USERNAME / AJERA_API_PASSWORD for authentication.
+- AJERA_API_HEADERS as a JSON object of extra request headers.
+"""
+
+
+@click.group(
+    cls=CommonClickGroup,
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help=CLI_DOCS,
+)
+@click.option(
+    "--log",
+    is_flag=True,
+    default=False,
+    help="Enable request logging at INFO level.",
+)
+@click.version_option(package_name="ajera", prog_name="ajera")
+@click.pass_context
+def cli(ctx: click.Context, log: bool) -> None:
+    ctx.obj = ClientContext(log=log)
+
+
+# Register all domain-specific command groups.
+# Runtime gating is handled by AJERA_CLI_DISABLE.
+for module in (
+    employees,
+    clients,
+    contacts,
+    vendors,
+    projects,
+    ledger,
+    activities,
+    companies,
+    departments,
+    rate_tables,
+    bank_accounts,
+    invoice_formats,
+):
+    cli.add_command(module.group)
+
+
+def main() -> None:
+    """
+    Console-script entry point.
+
+    Translates expected errors into a non-zero exit with a readable message
+    instead of a traceback.
+    """
+    try:
+        cli(standalone_mode=False)
+    except click.ClickException as exc:
+        exc.show()
+        sys.exit(exc.exit_code)
+    except click.exceptions.Abort:
+        sys.exit(1)
+    except requests.HTTPError as exc:
+        click.echo(f"Error: {exc}", err=True)
+        sys.exit(1)
+    except Exception as exc:  # noqa: BLE001
+        logging.getLogger("ajera").debug("CLI error", exc_info=True)
+        click.echo(f"Error: {exc}", err=True)
+        sys.exit(1)
+
+
+__all__ = ["cli", "main"]

ajera/cli/__main__.py

@@ -0,0 +1,4 @@
+from ajera.cli import main
+
+if __name__ == "__main__":
+    main()

ajera/cli/commands/activities.py

@@ -0,0 +1,31 @@
+import click
+
+from ajera.cli.context import ClientContext
+from ajera.cli.options import status_option
+from ajera.cli.output import render
+
+
+@click.command(name="activities")
+@status_option
+@click.option(
+    "--description-like",
+    "filter_by_description_like",
+    type=str,
+    default=None,
+    help="Filter where the description contains this substring.",
+)
+@click.pass_obj
+def group(
+    ctx: ClientContext,
+    filter_by_status: tuple[str, ...],
+    filter_by_description_like: str | None,
+) -> None:
+    """
+    List activities (active only by default).
+    """
+    render(
+        ctx.client.list_activities(
+            filter_by_status=list(filter_by_status),
+            filter_by_description_like=filter_by_description_like,
+        )
+    )

ajera/cli/commands/bank_accounts.py

@@ -0,0 +1,18 @@
+import click
+
+from ajera.cli.context import ClientContext
+from ajera.cli.options import status_option
+from ajera.cli.output import render
+
+
+@click.command(name="bank-accounts")
+@status_option
+@click.pass_obj
+def group(
+    ctx: ClientContext,
+    filter_by_status: tuple[str, ...],
+) -> None:
+    """
+    List bank accounts (active only by default).
+    """
+    render(ctx.client.list_bank_accounts(filter_by_status=list(filter_by_status)))

ajera/cli/commands/clients.py

@@ -0,0 +1,153 @@
+import click
+
+from ajera.cli.context import ClientContext
+from ajera.cli.group import CommonClickGroup
+from ajera.cli.options import status_option
+from ajera.cli.output import render
+
+
+@click.group(name="clients", cls=CommonClickGroup)
+def group() -> None:
+    """
+    List and inspect clients.
+    """
+
+
+@group.command(name="list")
+@click.option(
+    "--company",
+    "filter_by_company",
+    type=int,
+    multiple=True,
+    help="Filter by company ID (repeatable).",
+)
+@status_option
+@click.option(
+    "--name-like",
+    "filter_by_name_like",
+    type=str,
+    default=None,
+    help="Filter where the client name contains this substring.",
+)
+@click.option(
+    "--name-equals",
+    "filter_by_name_equals",
+    type=str,
+    default=None,
+    help="Filter where the client name equals this value.",
+)
+@click.option(
+    "--client-type",
+    "filter_by_client_type",
+    type=int,
+    multiple=True,
+    help="Filter by client type ID (repeatable).",
+)
+@click.option(
+    "--modified-after",
+    "filter_by_earliest_modified_date",
+    type=str,
+    default=None,
+    help="Earliest modified date (YYYY-MM-DD or ISO 8601).",
+)
+@click.option(
+    "--modified-before",
+    "filter_by_latest_modified_date",
+    type=str,
+    default=None,
+    help="Latest modified date (YYYY-MM-DD or ISO 8601).",
+)
+@click.pass_obj
+def list_(
+    ctx: ClientContext,
+    filter_by_company: tuple[int, ...],
+    filter_by_status: tuple[str, ...],
+    filter_by_name_like: str | None,
+    filter_by_name_equals: str | None,
+    filter_by_client_type: tuple[int, ...],
+    filter_by_earliest_modified_date: str | None,
+    filter_by_latest_modified_date: str | None,
+) -> None:
+    """
+    List clients (active only by default).
+    """
+    render(
+        ctx.client.list_clients(
+            filter_by_company=list(filter_by_company) or None,
+            filter_by_status=list(filter_by_status),
+            filter_by_name_like=filter_by_name_like,
+            filter_by_name_equals=filter_by_name_equals,
+            filter_by_client_type=list(filter_by_client_type) or None,
+            filter_by_earliest_modified_date=filter_by_earliest_modified_date,
+            filter_by_latest_modified_date=filter_by_latest_modified_date,
+        )
+    )
+
+
+@group.command(name="get")
+@click.argument("client_ids", nargs=-1, required=True, type=int)
+@click.pass_obj
+def get(ctx: ClientContext, client_ids: tuple[int, ...]) -> None:
+    """
+    Get one or more clients by ID.
+    """
+    render(ctx.client.get_clients(list(client_ids)))
+
+
+@group.command(name="update")
+@click.argument("client_key", type=int)
+@click.option("--description", default=None, help="New client description (name).")
+@click.option("--account-id", default=None, help="New account ID.")
+@click.option("--email", default=None, help="New email address.")
+@click.option("--website", default=None, help="New website URL.")
+@click.option("--primary-phone", default=None, help="New primary phone number.")
+@click.option("--secondary-phone", default=None, help="New secondary phone number.")
+@click.option("--tertiary-phone", default=None, help="New tertiary phone number.")
+@click.option("--fax", default=None, help="New fax number.")
+@click.option("--notes", default=None, help="New notes.")
+@click.pass_obj
+def update(
+    ctx: ClientContext,
+    client_key: int,
+    description: str | None,
+    account_id: str | None,
+    email: str | None,
+    website: str | None,
+    primary_phone: str | None,
+    secondary_phone: str | None,
+    tertiary_phone: str | None,
+    fax: str | None,
+    notes: str | None,
+) -> None:
+    """
+    Update simple fields on one client.
+
+    Only the options you pass are changed; everything else is left as-is.
+    """
+    render(
+        ctx.client.update_client(
+            client_key,
+            description=description,
+            account_id=account_id,
+            email=email,
+            website=website,
+            primary_phone_number=primary_phone,
+            secondary_phone_number=secondary_phone,
+            tertiary_phone_number=tertiary_phone,
+            fax_number=fax,
+            notes=notes,
+        )
+    )
+
+
+@group.command(name="types")
+@status_option
+@click.pass_obj
+def types(
+    ctx: ClientContext,
+    filter_by_status: tuple[str, ...],
+) -> None:
+    """
+    List client types (active only by default).
+    """
+    render(ctx.client.list_client_types(filter_by_status=list(filter_by_status)))

ajera/cli/commands/companies.py

@@ -0,0 +1,18 @@
+import click
+
+from ajera.cli.context import ClientContext
+from ajera.cli.options import status_option
+from ajera.cli.output import render
+
+
+@click.command(name="companies")
+@status_option
+@click.pass_obj
+def group(
+    ctx: ClientContext,
+    filter_by_status: tuple[str, ...],
+) -> None:
+    """
+    List companies (active only by default).
+    """
+    render(ctx.client.list_companies(filter_by_status=list(filter_by_status)))

ajera/cli/commands/contacts.py

@@ -0,0 +1,153 @@
+import click
+
+from ajera.cli.context import ClientContext
+from ajera.cli.group import CommonClickGroup
+from ajera.cli.options import status_option
+from ajera.cli.output import render
+
+
+@click.group(name="contacts", cls=CommonClickGroup)
+def group() -> None:
+    """
+    List and inspect contacts.
+    """
+
+
+@group.command(name="list")
+@click.option(
+    "--company",
+    "filter_by_company",
+    type=int,
+    multiple=True,
+    help="Filter by company ID (repeatable).",
+)
+@status_option
+@click.option(
+    "--text",
+    "filter_by_text",
+    type=str,
+    default=None,
+    help="Filter where the contact text contains this substring.",
+)
+@click.option(
+    "--contact-type",
+    "filter_by_contact_type",
+    type=int,
+    multiple=True,
+    help="Filter by contact type ID (repeatable).",
+)
+@click.option(
+    "--modified-after",
+    "filter_by_earliest_modified_date",
+    type=str,
+    default=None,
+    help="Earliest modified date (YYYY-MM-DD or ISO 8601).",
+)
+@click.option(
+    "--modified-before",
+    "filter_by_latest_modified_date",
+    type=str,
+    default=None,
+    help="Latest modified date (YYYY-MM-DD or ISO 8601).",
+)
+@click.pass_obj
+def list_(
+    ctx: ClientContext,
+    filter_by_company: tuple[int, ...],
+    filter_by_status: tuple[str, ...],
+    filter_by_text: str | None,
+    filter_by_contact_type: tuple[int, ...],
+    filter_by_earliest_modified_date: str | None,
+    filter_by_latest_modified_date: str | None,
+) -> None:
+    """
+    List contacts (active only by default).
+    """
+    render(
+        ctx.client.list_contacts(
+            filter_by_company=list(filter_by_company) or None,
+            filter_by_status=list(filter_by_status),
+            filter_by_text=filter_by_text,
+            filter_by_contact_type=list(filter_by_contact_type) or None,
+            filter_by_earliest_modified_date=filter_by_earliest_modified_date,
+            filter_by_latest_modified_date=filter_by_latest_modified_date,
+        )
+    )
+
+
+@group.command(name="get")
+@click.argument("contact_ids", nargs=-1, required=True, type=int)
+@click.pass_obj
+def get(ctx: ClientContext, contact_ids: tuple[int, ...]) -> None:
+    """
+    Get one or more contacts by ID.
+    """
+    render(ctx.client.get_contacts(list(contact_ids)))
+
+
+@group.command(name="update")
+@click.argument("contact_key", type=int)
+@click.option("--first-name", default=None, help="New first name.")
+@click.option("--middle-name", default=None, help="New middle name.")
+@click.option("--last-name", default=None, help="New last name.")
+@click.option("--title", default=None, help="New title.")
+@click.option("--company", default=None, help="New company.")
+@click.option("--email", default=None, help="New email address.")
+@click.option("--website", default=None, help="New website URL.")
+@click.option("--primary-phone", default=None, help="New primary phone number.")
+@click.option("--secondary-phone", default=None, help="New secondary phone number.")
+@click.option("--tertiary-phone", default=None, help="New tertiary phone number.")
+@click.option("--fax", default=None, help="New fax number.")
+@click.option("--notes", default=None, help="New notes.")
+@click.pass_obj
+def update(
+    ctx: ClientContext,
+    contact_key: int,
+    first_name: str | None,
+    middle_name: str | None,
+    last_name: str | None,
+    title: str | None,
+    company: str | None,
+    email: str | None,
+    website: str | None,
+    primary_phone: str | None,
+    secondary_phone: str | None,
+    tertiary_phone: str | None,
+    fax: str | None,
+    notes: str | None,
+) -> None:
+    """
+    Update simple fields on one contact.
+
+    Only the options you pass are changed; everything else is left as-is.
+    """
+    render(
+        ctx.client.update_contact(
+            contact_key,
+            first_name=first_name,
+            middle_name=middle_name,
+            last_name=last_name,
+            title=title,
+            company=company,
+            email=email,
+            website=website,
+            primary_phone_number=primary_phone,
+            secondary_phone_number=secondary_phone,
+            tertiary_phone_number=tertiary_phone,
+            fax_number=fax,
+            notes=notes,
+        )
+    )
+
+
+@group.command(name="types")
+@status_option
+@click.pass_obj
+def types(
+    ctx: ClientContext,
+    filter_by_status: tuple[str, ...],
+) -> None:
+    """
+    List contact types (active only by default).
+    """
+    render(ctx.client.list_contact_types(filter_by_status=list(filter_by_status)))

ajera/cli/commands/departments.py

@@ -0,0 +1,18 @@
+import click
+
+from ajera.cli.context import ClientContext
+from ajera.cli.options import status_option
+from ajera.cli.output import render
+
+
+@click.command(name="departments")
+@status_option
+@click.pass_obj
+def group(
+    ctx: ClientContext,
+    filter_by_status: tuple[str, ...],
+) -> None:
+    """
+    List departments (active only by default).
+    """
+    render(ctx.client.list_departments(filter_by_status=list(filter_by_status)))