kotsu-cli 0.1.0__py3-none-any.whl

money_cli/dominio/parcelas.py

@@ -0,0 +1,52 @@
+"""Geração de parcelas (D2, D8, D11, D17). Puro: o grupo vem de fora."""
+
+from __future__ import annotations
+
+import calendar
+import datetime as dt
+
+from money_cli.dominio.linha import LinhaInterpretada
+from money_cli.dominio.mes import Mes
+from money_cli.dominio.tipos import NovoLancamento, Parcela
+
+
+def data_da_parcela(primeira: dt.date, indice: int) -> dt.date:
+    """Data da parcela `indice` (0 = primeira): mesmo dia, `indice` meses depois.
+
+    Dia que o mês não tem vira o último dia do mês (31/01 -> 28/02).
+    """
+    mes = Mes.de(primeira).somar(indice)
+    ultimo = calendar.monthrange(mes.ano, mes.mes)[1]
+    return dt.date(mes.ano, mes.mes, min(primeira.day, ultimo))
+
+
+def gerar(
+    linha: LinhaInterpretada,
+    conta_id: int,
+    categoria_id: int | None,
+    grupo: str | None,
+) -> list[NovoLancamento]:
+    """Transforma a linha em lançamentos: um, ou um por parcela em meses seguidos.
+
+    O valor digitado é o de cada parcela (D11). `grupo` é obrigatório se há parcelas.
+    """
+    if linha.parcelas == 1:
+        return [
+            NovoLancamento(
+                linha.data, linha.descricao, linha.valor, linha.tipo, conta_id, categoria_id
+            )
+        ]
+    if not grupo:
+        raise ValueError("parcelas precisam de um grupo")
+    return [
+        NovoLancamento(
+            data_da_parcela(linha.data, i),
+            linha.descricao,
+            linha.valor,
+            linha.tipo,
+            conta_id,
+            categoria_id,
+            Parcela(grupo, i + 1, linha.parcelas),
+        )
+        for i in range(linha.parcelas)
+    ]

money_cli/dominio/recorrencia.py

@@ -0,0 +1,20 @@
+"""Datas de lançamentos recorrentes (D36). Puro: sem banco."""
+
+from __future__ import annotations
+
+import calendar
+import datetime as dt
+
+from money_cli.dominio.mes import Mes
+
+
+def data_no_mes(dia: int, mes: Mes) -> dt.date:
+    """O `dia` no mês; dia que o mês não tem vira o último (31 -> 28/02)."""
+    ultimo = calendar.monthrange(mes.ano, mes.mes)[1]
+    return dt.date(mes.ano, mes.mes, min(dia, ultimo))
+
+
+def meses_a_gerar(gerada_ate: Mes, ate: Mes) -> list[Mes]:
+    """Meses depois de `gerada_ate` até `ate`, inclusive. Vazio se já está gerado."""
+    quantos = (ate.ano * 12 + ate.mes) - (gerada_ate.ano * 12 + gerada_ate.mes)
+    return [gerada_ate.somar(i) for i in range(1, quantos + 1)]

money_cli/dominio/tipos.py

@@ -0,0 +1,95 @@
+"""Tipos do domínio. Dinheiro é sempre em centavos inteiros (BRL)."""
+
+from __future__ import annotations
+
+import datetime as dt
+from dataclasses import dataclass
+from enum import StrEnum
+
+
+class Tipo(StrEnum):
+    RECEITA = "receita"
+    DESPESA = "despesa"
+
+
+class Alcance(StrEnum):
+    """Resposta a "só esta ou todas?" ao mexer numa parcela (D12). Padrão: todas."""
+
+    SO_ESTA = "so_esta"
+    TODAS = "todas"
+    PROXIMAS = "proximas"  # recorrente: este mês e os seguintes (D36)
+
+
+@dataclass(frozen=True, slots=True)
+class Conta:
+    """Etiqueta colorida (D9): não acumula saldo entre meses."""
+
+    id: int
+    nome: str
+    cor: str
+
+
+@dataclass(frozen=True, slots=True)
+class Categoria:
+    id: int
+    nome: str
+    recorrente: bool = False  # lançamentos nela se repetem todo mês (D36)
+
+
+@dataclass(frozen=True, slots=True)
+class Parcela:
+    """Posição de um lançamento dentro de uma compra parcelada (D2, D8)."""
+
+    grupo: str
+    numero: int
+    total: int
+
+    def __post_init__(self) -> None:
+        if not 1 <= self.numero <= self.total:
+            raise ValueError(f"parcela {self.numero}/{self.total} inválida")
+
+    @property
+    def rotulo(self) -> str:
+        return f"{self.numero}/{self.total}"
+
+
+@dataclass(frozen=True, slots=True)
+class NovoLancamento:
+    """Lançamento ainda não salvo. `valor` é positivo; o sinal vem de `tipo`.
+
+    Todo lançamento tem conta (D21); categoria é opcional.
+    """
+
+    data: dt.date
+    descricao: str
+    valor: int
+    tipo: Tipo
+    conta_id: int
+    categoria_id: int | None = None
+    parcela: Parcela | None = None
+    grupo_recorrencia: str | None = None  # série mensal sem fim (D36)
+
+    def __post_init__(self) -> None:
+        if not isinstance(self.valor, int) or isinstance(self.valor, bool):
+            raise TypeError("valor deve ser int em centavos")
+        if self.valor <= 0:
+            raise ValueError("valor deve ser positivo; o tipo diz se é receita ou despesa")
+        if not isinstance(self.conta_id, int) or isinstance(self.conta_id, bool):
+            raise ValueError("todo lançamento precisa de uma conta")
+
+
+@dataclass(frozen=True, slots=True)
+class Lancamento:
+    id: int
+    data: dt.date
+    descricao: str
+    valor: int
+    tipo: Tipo
+    conta_id: int
+    categoria_id: int | None
+    parcela: Parcela | None
+    grupo_recorrencia: str | None = None
+
+    @property
+    def valor_com_sinal(self) -> int:
+        return self.valor if self.tipo is Tipo.RECEITA else -self.valor

money_cli/dominio/totais.py

@@ -0,0 +1,17 @@
+"""Totais do mês. Nunca gravados: o armazenamento calcula e entrega aqui."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True, slots=True)
+class TotaisMes:
+    receitas: int = 0
+    despesas: int = 0
+    quantidade: int = 0  # lançamentos do mês (ou do filtro)
+
+    @property
+    def saldo(self) -> int:
+        """Receitas menos despesas do mês (D8)."""
+        return self.receitas - self.despesas

money_cli/tela/__init__.py

@@ -0,0 +1 @@
+"""Camada de tela: app Textual, cores e atalhos. Nenhuma regra financeira aqui."""