ynab-cli 0.3.0__py3-none-any.whl

ynab_cli/adapters/ynab/models/month_summary.py

@@ -0,0 +1,145 @@
+import datetime
+from collections.abc import Mapping
+from typing import Any, TypeVar, cast
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+from dateutil.parser import isoparse
+
+from ynab_cli.adapters.ynab.types import UNSET, Unset
+
+T = TypeVar("T", bound="MonthSummary")
+
+
+@_attrs_define
+class MonthSummary:
+    """
+    Attributes:
+        month (datetime.date):
+        income (int): The total amount of transactions categorized to 'Inflow: Ready to Assign' in the month
+        budgeted (int): The total amount budgeted in the month
+        activity (int): The total amount of transactions in the month, excluding those categorized to 'Inflow: Ready to
+            Assign'
+        to_be_budgeted (int): The available amount for 'Ready to Assign'
+        deleted (bool): Whether or not the month has been deleted.  Deleted months will only be included in delta
+            requests.
+        note (Union[None, Unset, str]):
+        age_of_money (Union[None, Unset, int]): The Age of Money as of the month
+    """
+
+    month: datetime.date
+    income: int
+    budgeted: int
+    activity: int
+    to_be_budgeted: int
+    deleted: bool
+    note: None | Unset | str = UNSET
+    age_of_money: None | Unset | int = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        month = self.month.isoformat()
+
+        income = self.income
+
+        budgeted = self.budgeted
+
+        activity = self.activity
+
+        to_be_budgeted = self.to_be_budgeted
+
+        deleted = self.deleted
+
+        note: None | Unset | str
+        if isinstance(self.note, Unset):
+            note = UNSET
+        else:
+            note = self.note
+
+        age_of_money: None | Unset | int
+        if isinstance(self.age_of_money, Unset):
+            age_of_money = UNSET
+        else:
+            age_of_money = self.age_of_money
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "month": month,
+                "income": income,
+                "budgeted": budgeted,
+                "activity": activity,
+                "to_be_budgeted": to_be_budgeted,
+                "deleted": deleted,
+            }
+        )
+        if note is not UNSET:
+            field_dict["note"] = note
+        if age_of_money is not UNSET:
+            field_dict["age_of_money"] = age_of_money
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        month = isoparse(d.pop("month")).date()
+
+        income = d.pop("income")
+
+        budgeted = d.pop("budgeted")
+
+        activity = d.pop("activity")
+
+        to_be_budgeted = d.pop("to_be_budgeted")
+
+        deleted = d.pop("deleted")
+
+        def _parse_note(data: object) -> None | Unset | str:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | Unset | str, data)
+
+        note = _parse_note(d.pop("note", UNSET))
+
+        def _parse_age_of_money(data: object) -> None | Unset | int:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | Unset | int, data)
+
+        age_of_money = _parse_age_of_money(d.pop("age_of_money", UNSET))
+
+        month_summary = cls(
+            month=month,
+            income=income,
+            budgeted=budgeted,
+            activity=activity,
+            to_be_budgeted=to_be_budgeted,
+            deleted=deleted,
+            note=note,
+            age_of_money=age_of_money,
+        )
+
+        month_summary.additional_properties = d
+        return month_summary
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

ynab_cli/adapters/ynab/models/new_transaction.py

@@ -0,0 +1,352 @@
+import datetime
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar, cast
+from uuid import UUID
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+from dateutil.parser import isoparse
+
+from ynab_cli.adapters.ynab.models.transaction_cleared_status import TransactionClearedStatus
+from ynab_cli.adapters.ynab.models.transaction_flag_color_type_1 import TransactionFlagColorType1
+from ynab_cli.adapters.ynab.models.transaction_flag_color_type_2_type_1 import TransactionFlagColorType2Type1
+from ynab_cli.adapters.ynab.models.transaction_flag_color_type_3_type_1 import TransactionFlagColorType3Type1
+from ynab_cli.adapters.ynab.types import UNSET, Unset
+
+if TYPE_CHECKING:
+    from ynab_cli.adapters.ynab.models.save_sub_transaction import SaveSubTransaction
+
+
+T = TypeVar("T", bound="NewTransaction")
+
+
+@_attrs_define
+class NewTransaction:
+    """
+    Attributes:
+        account_id (Union[Unset, UUID]):
+        date (Union[Unset, datetime.date]): The transaction date in ISO format (e.g. 2016-12-01).  Future dates
+            (scheduled transactions) are not permitted.  Split transaction dates cannot be changed and if a different date
+            is supplied it will be ignored.
+        amount (Union[Unset, int]): The transaction amount in milliunits format.  Split transaction amounts cannot be
+            changed and if a different amount is supplied it will be ignored.
+        payee_id (Union[None, UUID, Unset]): The payee for the transaction.  To create a transfer between two accounts,
+            use the account transfer payee pointing to the target account.  Account transfer payees are specified as
+            `transfer_payee_id` on the account resource.
+        payee_name (Union[None, Unset, str]): The payee name.  If a `payee_name` value is provided and `payee_id` has a
+            null value, the `payee_name` value will be used to resolve the payee by either (1) a matching payee rename rule
+            (only if `import_id` is also specified) or (2) a payee with the same name or (3) creation of a new payee.
+        category_id (Union[None, UUID, Unset]): The category for the transaction.  To configure a split transaction, you
+            can specify null for `category_id` and provide a `subtransactions` array as part of the transaction object.  If
+            an existing transaction is a split, the `category_id` cannot be changed.  Credit Card Payment categories are not
+            permitted and will be ignored if supplied.
+        memo (Union[None, Unset, str]):
+        cleared (Union[Unset, TransactionClearedStatus]): The cleared status of the transaction
+        approved (Union[Unset, bool]): Whether or not the transaction is approved.  If not supplied, transaction will be
+            unapproved by default.
+        flag_color (Union[None, TransactionFlagColorType1, TransactionFlagColorType2Type1,
+            TransactionFlagColorType3Type1, Unset]): The transaction flag
+        subtransactions (Union[Unset, list['SaveSubTransaction']]): An array of subtransactions to configure a
+            transaction as a split. Updating `subtransactions` on an existing split transaction is not supported.
+        import_id (Union[None, Unset, str]): If specified, a new transaction will be assigned this `import_id` and
+            considered "imported".  We will also attempt to match this imported transaction to an existing "user-entered"
+            transaction on the same account, with the same amount, and with a date +/-10 days from the imported transaction
+            date.<br><br>Transactions imported through File Based Import or Direct Import (not through the API) are assigned
+            an import_id in the format: 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. For example, a transaction dated
+            2015-12-30 in the amount of -$294.23 USD would have an import_id of 'YNAB:-294230:2015-12-30:1'.  If a second
+            transaction on the same account was imported and had the same date and same amount, its import_id would be
+            'YNAB:-294230:2015-12-30:2'.  Using a consistent format will prevent duplicates through Direct Import and File
+            Based Import.<br><br>If import_id is omitted or specified as null, the transaction will be treated as a "user-
+            entered" transaction. As such, it will be eligible to be matched against transactions later being imported (via
+            DI, FBI, or API).
+    """
+
+    account_id: Unset | UUID = UNSET
+    date: Unset | datetime.date = UNSET
+    amount: Unset | int = UNSET
+    payee_id: None | UUID | Unset = UNSET
+    payee_name: None | Unset | str = UNSET
+    category_id: None | UUID | Unset = UNSET
+    memo: None | Unset | str = UNSET
+    cleared: Unset | TransactionClearedStatus = UNSET
+    approved: Unset | bool = UNSET
+    flag_color: (
+        None | TransactionFlagColorType1 | TransactionFlagColorType2Type1 | TransactionFlagColorType3Type1 | Unset
+    ) = UNSET
+    subtransactions: Unset | list["SaveSubTransaction"] = UNSET
+    import_id: None | Unset | str = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        account_id: Unset | str = UNSET
+        if not isinstance(self.account_id, Unset):
+            account_id = str(self.account_id)
+
+        date: Unset | str = UNSET
+        if not isinstance(self.date, Unset):
+            date = self.date.isoformat()
+
+        amount = self.amount
+
+        payee_id: None | Unset | str
+        if isinstance(self.payee_id, Unset):
+            payee_id = UNSET
+        elif isinstance(self.payee_id, UUID):
+            payee_id = str(self.payee_id)
+        else:
+            payee_id = self.payee_id
+
+        payee_name: None | Unset | str
+        if isinstance(self.payee_name, Unset):
+            payee_name = UNSET
+        else:
+            payee_name = self.payee_name
+
+        category_id: None | Unset | str
+        if isinstance(self.category_id, Unset):
+            category_id = UNSET
+        elif isinstance(self.category_id, UUID):
+            category_id = str(self.category_id)
+        else:
+            category_id = self.category_id
+
+        memo: None | Unset | str
+        if isinstance(self.memo, Unset):
+            memo = UNSET
+        else:
+            memo = self.memo
+
+        cleared: Unset | str = UNSET
+        if not isinstance(self.cleared, Unset):
+            cleared = self.cleared.value
+
+        approved = self.approved
+
+        flag_color: None | Unset | str
+        if isinstance(self.flag_color, Unset):
+            flag_color = UNSET
+        elif isinstance(self.flag_color, TransactionFlagColorType1):
+            flag_color = self.flag_color.value
+        elif isinstance(self.flag_color, TransactionFlagColorType2Type1):
+            flag_color = self.flag_color.value
+        elif isinstance(self.flag_color, TransactionFlagColorType3Type1):
+            flag_color = self.flag_color.value
+        else:
+            flag_color = self.flag_color
+
+        subtransactions: Unset | list[dict[str, Any]] = UNSET
+        if not isinstance(self.subtransactions, Unset):
+            subtransactions = []
+            for subtransactions_item_data in self.subtransactions:
+                subtransactions_item = subtransactions_item_data.to_dict()
+                subtransactions.append(subtransactions_item)
+
+        import_id: None | Unset | str
+        if isinstance(self.import_id, Unset):
+            import_id = UNSET
+        else:
+            import_id = self.import_id
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({})
+        if account_id is not UNSET:
+            field_dict["account_id"] = account_id
+        if date is not UNSET:
+            field_dict["date"] = date
+        if amount is not UNSET:
+            field_dict["amount"] = amount
+        if payee_id is not UNSET:
+            field_dict["payee_id"] = payee_id
+        if payee_name is not UNSET:
+            field_dict["payee_name"] = payee_name
+        if category_id is not UNSET:
+            field_dict["category_id"] = category_id
+        if memo is not UNSET:
+            field_dict["memo"] = memo
+        if cleared is not UNSET:
+            field_dict["cleared"] = cleared
+        if approved is not UNSET:
+            field_dict["approved"] = approved
+        if flag_color is not UNSET:
+            field_dict["flag_color"] = flag_color
+        if subtransactions is not UNSET:
+            field_dict["subtransactions"] = subtransactions
+        if import_id is not UNSET:
+            field_dict["import_id"] = import_id
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ynab_cli.adapters.ynab.models.save_sub_transaction import SaveSubTransaction
+
+        d = dict(src_dict)
+        _account_id = d.pop("account_id", UNSET)
+        account_id: Unset | UUID
+        if isinstance(_account_id, Unset):
+            account_id = UNSET
+        else:
+            account_id = UUID(_account_id)
+
+        _date = d.pop("date", UNSET)
+        date: Unset | datetime.date
+        if isinstance(_date, Unset):
+            date = UNSET
+        else:
+            date = isoparse(_date).date()
+
+        amount = d.pop("amount", UNSET)
+
+        def _parse_payee_id(data: object) -> None | UUID | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                payee_id_type_0 = UUID(data)
+
+                return payee_id_type_0
+            except:  # noqa: E722
+                pass
+            return cast(None | UUID | Unset, data)
+
+        payee_id = _parse_payee_id(d.pop("payee_id", UNSET))
+
+        def _parse_payee_name(data: object) -> None | Unset | str:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | Unset | str, data)
+
+        payee_name = _parse_payee_name(d.pop("payee_name", UNSET))
+
+        def _parse_category_id(data: object) -> None | UUID | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                category_id_type_0 = UUID(data)
+
+                return category_id_type_0
+            except:  # noqa: E722
+                pass
+            return cast(None | UUID | Unset, data)
+
+        category_id = _parse_category_id(d.pop("category_id", UNSET))
+
+        def _parse_memo(data: object) -> None | Unset | str:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | Unset | str, data)
+
+        memo = _parse_memo(d.pop("memo", UNSET))
+
+        _cleared = d.pop("cleared", UNSET)
+        cleared: Unset | TransactionClearedStatus
+        if isinstance(_cleared, Unset):
+            cleared = UNSET
+        else:
+            cleared = TransactionClearedStatus(_cleared)
+
+        approved = d.pop("approved", UNSET)
+
+        def _parse_flag_color(
+            data: object,
+        ) -> None | TransactionFlagColorType1 | TransactionFlagColorType2Type1 | TransactionFlagColorType3Type1 | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                componentsschemas_transaction_flag_color_type_1 = TransactionFlagColorType1(data)
+
+                return componentsschemas_transaction_flag_color_type_1
+            except:  # noqa: E722
+                pass
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                componentsschemas_transaction_flag_color_type_2_type_1 = TransactionFlagColorType2Type1(data)
+
+                return componentsschemas_transaction_flag_color_type_2_type_1
+            except:  # noqa: E722
+                pass
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                componentsschemas_transaction_flag_color_type_3_type_1 = TransactionFlagColorType3Type1(data)
+
+                return componentsschemas_transaction_flag_color_type_3_type_1
+            except:  # noqa: E722
+                pass
+            return cast(
+                None
+                | TransactionFlagColorType1
+                | TransactionFlagColorType2Type1
+                | TransactionFlagColorType3Type1
+                | Unset,
+                data,
+            )
+
+        flag_color = _parse_flag_color(d.pop("flag_color", UNSET))
+
+        subtransactions = []
+        _subtransactions = d.pop("subtransactions", UNSET)
+        for subtransactions_item_data in _subtransactions or []:
+            subtransactions_item = SaveSubTransaction.from_dict(subtransactions_item_data)
+
+            subtransactions.append(subtransactions_item)
+
+        def _parse_import_id(data: object) -> None | Unset | str:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | Unset | str, data)
+
+        import_id = _parse_import_id(d.pop("import_id", UNSET))
+
+        new_transaction = cls(
+            account_id=account_id,
+            date=date,
+            amount=amount,
+            payee_id=payee_id,
+            payee_name=payee_name,
+            category_id=category_id,
+            memo=memo,
+            cleared=cleared,
+            approved=approved,
+            flag_color=flag_color,
+            subtransactions=subtransactions,
+            import_id=import_id,
+        )
+
+        new_transaction.additional_properties = d
+        return new_transaction
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

ynab_cli/adapters/ynab/models/patch_category_wrapper.py

@@ -0,0 +1,65 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ynab_cli.adapters.ynab.models.save_category import SaveCategory
+
+
+T = TypeVar("T", bound="PatchCategoryWrapper")
+
+
+@_attrs_define
+class PatchCategoryWrapper:
+    """
+    Attributes:
+        category (SaveCategory):
+    """
+
+    category: "SaveCategory"
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        category = self.category.to_dict()
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "category": category,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ynab_cli.adapters.ynab.models.save_category import SaveCategory
+
+        d = dict(src_dict)
+        category = SaveCategory.from_dict(d.pop("category"))
+
+        patch_category_wrapper = cls(
+            category=category,
+        )
+
+        patch_category_wrapper.additional_properties = d
+        return patch_category_wrapper
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

ynab_cli/adapters/ynab/models/patch_month_category_wrapper.py

@@ -0,0 +1,65 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ynab_cli.adapters.ynab.models.save_month_category import SaveMonthCategory
+
+
+T = TypeVar("T", bound="PatchMonthCategoryWrapper")
+
+
+@_attrs_define
+class PatchMonthCategoryWrapper:
+    """
+    Attributes:
+        category (SaveMonthCategory):
+    """
+
+    category: "SaveMonthCategory"
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        category = self.category.to_dict()
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "category": category,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ynab_cli.adapters.ynab.models.save_month_category import SaveMonthCategory
+
+        d = dict(src_dict)
+        category = SaveMonthCategory.from_dict(d.pop("category"))
+
+        patch_month_category_wrapper = cls(
+            category=category,
+        )
+
+        patch_month_category_wrapper.additional_properties = d
+        return patch_month_category_wrapper
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

ynab_cli/adapters/ynab/models/patch_payee_wrapper.py

@@ -0,0 +1,65 @@
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+if TYPE_CHECKING:
+    from ynab_cli.adapters.ynab.models.save_payee import SavePayee
+
+
+T = TypeVar("T", bound="PatchPayeeWrapper")
+
+
+@_attrs_define
+class PatchPayeeWrapper:
+    """
+    Attributes:
+        payee (SavePayee):
+    """
+
+    payee: "SavePayee"
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        payee = self.payee.to_dict()
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "payee": payee,
+            }
+        )
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ynab_cli.adapters.ynab.models.save_payee import SavePayee
+
+        d = dict(src_dict)
+        payee = SavePayee.from_dict(d.pop("payee"))
+
+        patch_payee_wrapper = cls(
+            payee=payee,
+        )
+
+        patch_payee_wrapper.additional_properties = d
+        return patch_payee_wrapper
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties