ynab-cli 0.3.0__py3-none-any.whl

ynab_cli/adapters/ynab/api/transactions/import_transactions.py

@@ -0,0 +1,183 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ynab_cli.adapters.ynab import errors
+from ynab_cli.adapters.ynab.client import AuthenticatedClient, Client
+from ynab_cli.adapters.ynab.models.error_response import ErrorResponse
+from ynab_cli.adapters.ynab.models.transactions_import_response import TransactionsImportResponse
+from ynab_cli.adapters.ynab.types import Response
+
+
+def _get_kwargs(
+    budget_id: str,
+) -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": f"/budgets/{budget_id}/transactions/import",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ErrorResponse | TransactionsImportResponse | None:
+    if response.status_code == 200:
+        response_200 = TransactionsImportResponse.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 201:
+        response_201 = TransactionsImportResponse.from_dict(response.json())
+
+        return response_201
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatusError(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[ErrorResponse | TransactionsImportResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[ErrorResponse | TransactionsImportResponse]:
+    r"""Import transactions
+
+     Imports available transactions on all linked accounts for the given budget.  Linked accounts allow
+    transactions to be imported directly from a specified financial institution and this endpoint
+    initiates that import.  Sending a request to this endpoint is the equivalent of clicking \"Import\"
+    on each account in the web application or tapping the \"New Transactions\" banner in the mobile
+    applications.  The response for this endpoint contains the transaction ids that have been imported.
+
+    Args:
+        budget_id (str):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionsImportResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        budget_id=budget_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> ErrorResponse | TransactionsImportResponse | None:
+    r"""Import transactions
+
+     Imports available transactions on all linked accounts for the given budget.  Linked accounts allow
+    transactions to be imported directly from a specified financial institution and this endpoint
+    initiates that import.  Sending a request to this endpoint is the equivalent of clicking \"Import\"
+    on each account in the web application or tapping the \"New Transactions\" banner in the mobile
+    applications.  The response for this endpoint contains the transaction ids that have been imported.
+
+    Args:
+        budget_id (str):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionsImportResponse]
+    """
+
+    return sync_detailed(
+        budget_id=budget_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[ErrorResponse | TransactionsImportResponse]:
+    r"""Import transactions
+
+     Imports available transactions on all linked accounts for the given budget.  Linked accounts allow
+    transactions to be imported directly from a specified financial institution and this endpoint
+    initiates that import.  Sending a request to this endpoint is the equivalent of clicking \"Import\"
+    on each account in the web application or tapping the \"New Transactions\" banner in the mobile
+    applications.  The response for this endpoint contains the transaction ids that have been imported.
+
+    Args:
+        budget_id (str):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionsImportResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        budget_id=budget_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+) -> ErrorResponse | TransactionsImportResponse | None:
+    r"""Import transactions
+
+     Imports available transactions on all linked accounts for the given budget.  Linked accounts allow
+    transactions to be imported directly from a specified financial institution and this endpoint
+    initiates that import.  Sending a request to this endpoint is the equivalent of clicking \"Import\"
+    on each account in the web application or tapping the \"New Transactions\" banner in the mobile
+    applications.  The response for this endpoint contains the transaction ids that have been imported.
+
+    Args:
+        budget_id (str):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionsImportResponse]
+    """
+
+    return (
+        await asyncio_detailed(
+            budget_id=budget_id,
+            client=client,
+        )
+    ).parsed

ynab_cli/adapters/ynab/api/transactions/update_transaction.py

@@ -0,0 +1,199 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ynab_cli.adapters.ynab import errors
+from ynab_cli.adapters.ynab.client import AuthenticatedClient, Client
+from ynab_cli.adapters.ynab.models.error_response import ErrorResponse
+from ynab_cli.adapters.ynab.models.put_transaction_wrapper import PutTransactionWrapper
+from ynab_cli.adapters.ynab.models.transaction_response import TransactionResponse
+from ynab_cli.adapters.ynab.types import Response
+
+
+def _get_kwargs(
+    budget_id: str,
+    transaction_id: str,
+    *,
+    body: PutTransactionWrapper,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "put",
+        "url": f"/budgets/{budget_id}/transactions/{transaction_id}",
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> ErrorResponse | TransactionResponse | None:
+    if response.status_code == 200:
+        response_200 = TransactionResponse.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatusError(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[ErrorResponse | TransactionResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    budget_id: str,
+    transaction_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PutTransactionWrapper,
+) -> Response[ErrorResponse | TransactionResponse]:
+    """Updates an existing transaction
+
+     Updates a single transaction
+
+    Args:
+        budget_id (str):
+        transaction_id (str):
+        body (PutTransactionWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        budget_id=budget_id,
+        transaction_id=transaction_id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    budget_id: str,
+    transaction_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PutTransactionWrapper,
+) -> ErrorResponse | TransactionResponse | None:
+    """Updates an existing transaction
+
+     Updates a single transaction
+
+    Args:
+        budget_id (str):
+        transaction_id (str):
+        body (PutTransactionWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionResponse]
+    """
+
+    return sync_detailed(
+        budget_id=budget_id,
+        transaction_id=transaction_id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    budget_id: str,
+    transaction_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PutTransactionWrapper,
+) -> Response[ErrorResponse | TransactionResponse]:
+    """Updates an existing transaction
+
+     Updates a single transaction
+
+    Args:
+        budget_id (str):
+        transaction_id (str):
+        body (PutTransactionWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionResponse]]
+    """
+
+    kwargs = _get_kwargs(
+        budget_id=budget_id,
+        transaction_id=transaction_id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    budget_id: str,
+    transaction_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PutTransactionWrapper,
+) -> ErrorResponse | TransactionResponse | None:
+    """Updates an existing transaction
+
+     Updates a single transaction
+
+    Args:
+        budget_id (str):
+        transaction_id (str):
+        body (PutTransactionWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse, TransactionResponse]
+    """
+
+    return (
+        await asyncio_detailed(
+            budget_id=budget_id,
+            transaction_id=transaction_id,
+            client=client,
+            body=body,
+        )
+    ).parsed

ynab_cli/adapters/ynab/api/transactions/update_transactions.py

@@ -0,0 +1,177 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ynab_cli.adapters.ynab import errors
+from ynab_cli.adapters.ynab.client import AuthenticatedClient, Client
+from ynab_cli.adapters.ynab.models.error_response import ErrorResponse
+from ynab_cli.adapters.ynab.models.patch_transactions_wrapper import PatchTransactionsWrapper
+from ynab_cli.adapters.ynab.types import Response
+
+
+def _get_kwargs(
+    budget_id: str,
+    *,
+    body: PatchTransactionsWrapper,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "patch",
+        "url": f"/budgets/{budget_id}/transactions",
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> ErrorResponse | None:
+    if response.status_code == 400:
+        response_400 = ErrorResponse.from_dict(response.json())
+
+        return response_400
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatusError(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[ErrorResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PatchTransactionsWrapper,
+) -> Response[ErrorResponse]:
+    """Update multiple transactions
+
+     Updates multiple transactions, by `id` or `import_id`.
+
+    Args:
+        budget_id (str):
+        body (PatchTransactionsWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse]
+    """
+
+    kwargs = _get_kwargs(
+        budget_id=budget_id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PatchTransactionsWrapper,
+) -> ErrorResponse | None:
+    """Update multiple transactions
+
+     Updates multiple transactions, by `id` or `import_id`.
+
+    Args:
+        budget_id (str):
+        body (PatchTransactionsWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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:
+        ErrorResponse
+    """
+
+    return sync_detailed(
+        budget_id=budget_id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PatchTransactionsWrapper,
+) -> Response[ErrorResponse]:
+    """Update multiple transactions
+
+     Updates multiple transactions, by `id` or `import_id`.
+
+    Args:
+        budget_id (str):
+        body (PatchTransactionsWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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[ErrorResponse]
+    """
+
+    kwargs = _get_kwargs(
+        budget_id=budget_id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    budget_id: str,
+    *,
+    client: AuthenticatedClient | Client,
+    body: PatchTransactionsWrapper,
+) -> ErrorResponse | None:
+    """Update multiple transactions
+
+     Updates multiple transactions, by `id` or `import_id`.
+
+    Args:
+        budget_id (str):
+        body (PatchTransactionsWrapper):
+
+    Raises:
+        errors.UnexpectedStatusError: 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:
+        ErrorResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            budget_id=budget_id,
+            client=client,
+            body=body,
+        )
+    ).parsed

ynab_cli/adapters/ynab/api/user/__init__.py

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

ynab_cli/adapters/ynab/api/user/get_user.py

@@ -0,0 +1,130 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ynab_cli.adapters.ynab import errors
+from ynab_cli.adapters.ynab.client import AuthenticatedClient, Client
+from ynab_cli.adapters.ynab.models.user_response import UserResponse
+from ynab_cli.adapters.ynab.types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/user",
+    }
+
+    return _kwargs
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> UserResponse | None:
+    if response.status_code == 200:
+        response_200 = UserResponse.from_dict(response.json())
+
+        return response_200
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatusError(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[UserResponse]:
+    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: AuthenticatedClient | Client,
+) -> Response[UserResponse]:
+    """User info
+
+     Returns authenticated user information
+
+    Raises:
+        errors.UnexpectedStatusError: 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[UserResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+) -> UserResponse | None:
+    """User info
+
+     Returns authenticated user information
+
+    Raises:
+        errors.UnexpectedStatusError: 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:
+        UserResponse
+    """
+
+    return sync_detailed(
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[UserResponse]:
+    """User info
+
+     Returns authenticated user information
+
+    Raises:
+        errors.UnexpectedStatusError: 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[UserResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+) -> UserResponse | None:
+    """User info
+
+     Returns authenticated user information
+
+    Raises:
+        errors.UnexpectedStatusError: 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:
+        UserResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+        )
+    ).parsed