add neo parser

update node & actual

.gitignore

@@ -1,5 +1,6 @@
 node_modules/**
-__pycache__/**
+**/__pycache__/**
 cache/**
 config.py
 run.sh
+.debug-data

.pre-commit-config.yaml

@@ -1,14 +1,14 @@
 # .pre-commit-config.yaml
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.5  # Check for the latest version
+    rev: v0.15.12  # Check for the latest version
     hooks:
       - id: ruff
         args: ["check", "--select", "I", "--fix"]
       - id: ruff-format
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0  # Check for the latest version
+    rev: v6.0.0  # Check for the latest version
     hooks:
       - id: check-yaml
       - id: end-of-file-fixer
@@ -16,6 +16,6 @@ repos:
       - id: requirements-txt-fixer
 
   - repo: https://github.com/PyCQA/flake8
-    rev: 6.0.0  # Check for the latest version
+    rev: 7.3.0  # Check for the latest version
     hooks:
       - id: flake8

Dockerfile

@@ -1,27 +1,34 @@
+FROM python:3-alpine AS pybuilder
+
+COPY . .
+RUN apk add py3-uv
+RUN uv build
+
 # Use an official Node.js runtime as a base
-FROM node:20-alpine
+FROM node:25-alpine AS runtime
 
 # Create app directory
 WORKDIR /app
 
-RUN apk add python3 py3-pip
+RUN apk add python3 py3-pip py3-uv
+# RUN pip install uv
 
 # Copy package.json and install dependencies
 COPY package*.json ./
 RUN npm install --omit=dev
 
-# Copy requirements.txt and install dependencies
-COPY requirements.txt ./
-RUN pip3 install --no-cache-dir --break-system-packages -r requirements.txt
+# Copy wheel from builder and install
+COPY --from=pybuilder dist/*.whl /app/dist/
+RUN uv pip install --system --break-system-packages /app/dist/*.whl
+RUN rm -r /app/dist/
 
 # Copy the rest of the app
-COPY . .
+COPY cli.js .
 
 # Make the script executable
 RUN chmod +x cli.js
-RUN chmod +x watcher.py
 
 # Make ephemeral cache directory
 RUN mkdir ./cache
 
-ENTRYPOINT /app/watcher.py
+ENTRYPOINT actual-imap-poll

README.md

@@ -14,6 +14,7 @@ To run this project using Docker, you need to configure the following environmen
 | `IMAP_PORT`       | The port number for the IMAP server.                                                    | `143`                                  |
 | `IMAP_USER`       | The username for authenticating with the IMAP server.                                   | `user@example.com`                     |
 | `IMAP_PASS`       | The password for authenticating with the IMAP server.                                   | `yourpassword`                         |
+| `IMAP_MAILBOX`    | The IMAP mailbox to check for transaction e-mails                                       | `INBOX`                                |
 | `IMAP_STARTTLS`   | Whether to use TLS for the IMAP connection (`true` or `false`).                         | `true`                                 |
 | `IMAP_INTERVAL`   | The interval (in seconds) between polling the IMAP server.                              | `300`                                  |
 | `ACTUAL_SERVER`   | The URL to the Actual Budget instance to submit transactions to                         | `https://demo.actualbudget.org`        |
@@ -28,6 +29,7 @@ The parsers to execute and their parameters are defined in a Python source file
 Each parser instance will generally require the account UUID to link the transactions to, which can be obtained from the end of the URL while viewing the account in Actual.
 
 ### Example config.py
+
 ```python config.py
 from parsers import RogersBankParser, MBNAParser
 from uuid import UUID

actual_imap_poll/__init__.py

@@ -0,0 +1,6 @@
+from .watcher import main
+
+__all__ = ["main"]
+
+if __name__ == "__main__":
+    main()

actual_imap_poll/model.py

@@ -1,5 +1,5 @@
+import datetime
 from dataclasses import dataclass
-from datetime import date
 from decimal import Decimal
 from uuid import UUID
 
@@ -12,7 +12,7 @@ class Transaction:
     """
 
     account: UUID
-    date: date
+    date: datetime.date
     amount: Decimal  # Note: decimal dollars, JS shim will convert to cents as described in the API
     payee: str  # imported_payee in API
     notes: str

actual_imap_poll/parsers.py

@@ -0,0 +1,350 @@
+import re
+from abc import ABC, abstractmethod
+from collections.abc import Sequence
+from datetime import date, datetime
+from decimal import Decimal
+from email.message import EmailMessage, Message
+from logging import debug, info, warning
+from typing import Any, Optional
+from uuid import UUID
+
+from bs4 import BeautifulSoup
+
+from .model import Transaction
+
+
+def parse_email_time(s: str) -> datetime:
+    return datetime.strptime(s, "%a, %d %b %Y %H:%M:%S %z")
+
+
+class TransactionParser(ABC):
+    @abstractmethod
+    def match(self, msg: Message) -> bool:
+        """
+        Determines if the given email message matches the criteria for this parser.
+
+        Args:
+            msg (Message): The email message to evaluate.
+
+        Returns:
+            bool: True if the message matches the parser's criteria, False otherwise.
+        """
+        pass
+
+    @abstractmethod
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        """
+        Extracts transaction details from the given email message.
+
+        Args:
+            msg (EmailMessage): The email message to parse.
+
+        Returns:
+            Transaction: A Transaction object containing the extracted details.
+
+        Raises:
+            TransactionParsingFailed: If the message cannot be parsed successfully.
+        """
+        pass
+
+    @staticmethod
+    def get_content(
+        msg: EmailMessage, preferencelist: Sequence[str] = ("html", "plain")
+    ) -> Any:
+        body = msg.get_body(preferencelist=preferencelist)
+        if body is None:
+            raise TransactionParsingFailed("No body of message found")
+        content = body.get_content()
+        if content is None:
+            raise TransactionParsingFailed("No content of message found")
+        return content
+
+    @staticmethod
+    def strip_html(msg: EmailMessage) -> str:
+        body = msg.get_body(preferencelist=("html", "plain"))
+        if body is None:
+            raise TransactionParsingFailed("No HTML body of message found")
+        content = body.get_content()
+        if content is None:
+            raise TransactionParsingFailed("No content of message found")
+
+        soup = BeautifulSoup(content, "html.parser")
+        return soup.get_text()
+
+
+class TransactionParsingFailed(Exception):
+    pass
+
+
+class RogersBankParser(TransactionParser):
+    EXTRACT_RE = re.compile(
+        r"\$([0-9,]+\.\d{2}) on ((Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) [0-9]{2}, [0-9]{4}) on your credit card ending in ([0-9]{4}). Details: ([^.]+)"  # noqa: E501
+    )
+
+    def __init__(self, account_id: UUID):
+        self.account_id = account_id
+
+    def match(self, msg: Message) -> bool:
+        return (
+            msg["From"] == "Rogers Bank <onlineservices@RogersBank.com>"
+            and msg["Subject"] == "Purchase amount alert"
+        )
+
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        content = self.strip_html(msg)
+        matches = self.EXTRACT_RE.search(content)
+        if matches is None:
+            raise TransactionParsingFailed("No matches for extraction RE")
+        amount = Decimal(matches[1].replace(",", "")) * -1
+
+        date_raw = matches[2]
+        payee = matches[5]
+
+        if "CashBack" in payee:
+            amount = amount * -1
+
+        date = datetime.strptime(date_raw, "%b %d, %Y").date()
+        return Transaction(
+            account=self.account_id,
+            date=date,
+            amount=amount,
+            payee=payee,
+            notes="(via email)",
+            imported_id=msg["Message-ID"],
+        )
+
+
+class MBNAParser(TransactionParser):
+    EXTRACT_RE = re.compile(
+        r"A purchase of \$([0-9,]+\.\d{2}) from ([^<]+) was made at (\d{1,2}:\d{2} (AM|PM)) UTC on (\d{4}-\d{2}-\d{2})"  # noqa: E501
+    )
+
+    def __init__(self, account_id: UUID):
+        self.account_id = account_id
+
+    def match(self, msg: Message) -> bool:
+        return (
+            msg["From"] == "MBNA Notifications <noreply@mbna.ca>"
+            and msg["Subject"] == "MBNA - Transaction Alert"
+        )
+
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        content = self.get_content(msg)
+        matches = self.EXTRACT_RE.search(content)
+        if matches is None:
+            raise TransactionParsingFailed("No matches for extraction RE")
+        amount = Decimal(matches[1].replace(",", "")) * -1
+        payee = matches[2]
+        date_raw = matches[5]
+        return Transaction(
+            account=self.account_id,
+            date=date.fromisoformat(date_raw),
+            amount=amount,
+            payee=payee,
+            notes="via email",
+            imported_id=msg["Message-ID"],
+        )
+
+
+class BMOParser(TransactionParser):
+    EXTRACT_RE = re.compile(
+        r"There was a (withdrawal|deposit).*Amount:\s*\$([0-9,]+\.\d{2}).*Account:\s*Ending in ([0-9]+)",  # noqa: E501
+        flags=re.DOTALL,
+    )
+
+    def __init__(self, account_map: dict[int, UUID]):
+        self._account_map = account_map
+
+    def match(self, msg: Message) -> bool:
+        return msg["From"] == "bmoalerts@bmo.com"
+
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        content = self.strip_html(msg)
+        matches = self.EXTRACT_RE.search(content)
+        if matches is None:
+            raise TransactionParsingFailed("No matches for extraction RE")
+
+        amount = Decimal(matches[2].replace(",", ""))
+        if matches[1] == "withdrawal":
+            amount = amount * -1
+        date = parse_email_time(msg["Date"]).date()
+        account_ref = int(matches[3])
+        if account_ref not in self._account_map:
+            warning("Account %s not in account map, skipping transaction", account_ref)
+            return None
+        account_id = self._account_map[account_ref]
+        return Transaction(
+            account=account_id,
+            date=date,
+            amount=amount,
+            payee="",
+            notes="via email",
+            imported_id=msg["Message-ID"],
+        )
+
+
+class CIBCParser(TransactionParser):
+    PAYMENT_EXTRACT_RE = re.compile(
+        r"recently received a \$([0-9,]+\.\d{2}) payment to your [^<]+ ending in (\d{4})",
+        flags=re.MULTILINE,
+    )
+
+    PURCHASE_EXTRACT_RE = re.compile(
+        r"made a purchase with your CIBC.*ending in (?P<account>\d{4}) for \$(?P<amount>\d+\.\d{2}) at (?P<payee>.*?).<br",  # noqa: E501
+        re.MULTILINE,
+    )
+
+    def __init__(self, account_map: dict[int, UUID]):
+        self._account_map = account_map
+
+    def match(self, msg: Message) -> bool:
+        return msg["From"] == "CIBC Banking <Mailbox.noreply@cibc.com>"
+
+    def extract_payment(self, msg: EmailMessage):
+        content = self.get_content(msg)
+
+        matches = self.PAYMENT_EXTRACT_RE.search(content)
+        if matches is None:
+            raise TransactionParsingFailed("no matches for extraction RE")
+
+        amount = Decimal(matches[1].replace(",", ""))
+        account_ref = int(matches[2])
+        date = parse_email_time(msg["Date"]).date()
+
+        if account_ref not in self._account_map:
+            warning("Account %s not in account map, skipping transaction", account_ref)
+            return None
+        account_id = self._account_map[account_ref]
+
+        return Transaction(
+            account=account_id,
+            date=date,
+            amount=amount,
+            payee="",
+            notes="via email",
+            imported_id=msg["Message-ID"],
+        )
+
+    def extract_purchase(self, msg: EmailMessage) -> Optional[Transaction]:
+        content = self.get_content(msg)
+
+        matches = self.PURCHASE_EXTRACT_RE.search(content)
+        if matches is None:
+            raise TransactionParsingFailed("no matches for extraction RE")
+
+        amount = Decimal(matches["amount"].replace(",", "")) * -1
+        date = parse_email_time(msg["Date"]).date()
+        account_ref = int(matches["account"])
+
+        if account_ref not in self._account_map:
+            warning("Account %s not in account map, skipping transaction", account_ref)
+            return None
+        account_id = self._account_map[account_ref]
+
+        return Transaction(
+            account=account_id,
+            date=date,
+            amount=amount,
+            payee=matches["payee"],
+            notes="via email",
+            imported_id=msg["Message-ID"],
+        )
+
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        match msg["Subject"]:
+            case "New payment to your credit card":
+                return self.extract_payment(msg)
+            case "New purchase on your credit card":
+                return self.extract_purchase(msg)
+        return None
+
+
+class ScotiaBankParser(TransactionParser):
+    PAYMENT_EXTRACT_RE = re.compile(
+        r"There was an authorization (?P<card>without the credit card present )?for \$(?P<amount>[0-9]+\.[0-9]{2}) at (?P<payee>.+) on account (?P<account>[0-9*]+) at\s+(?P<time>[0-9]{1,2}:[0-9]{2} (am|pm))",  # noqa: E501
+        re.MULTILINE,
+    )
+
+    def __init__(self, account_map: dict[str, UUID]):
+        self._account_map = account_map
+
+    def match(self, msg: Message) -> bool:
+        return msg["From"] == "Scotia InfoAlerts <infoalerts@scotiabank.com>"
+
+    def extract_transaction(self, msg: EmailMessage) -> Optional[Transaction]:
+        content = self.get_content(msg)
+
+        matches = self.PAYMENT_EXTRACT_RE.search(content)
+        if matches is None:
+            raise TransactionParsingFailed("no matches for extraction RE")
+
+        amount = Decimal(matches["amount"].replace(",", "")) * -1
+        date = parse_email_time(msg["Date"]).date()
+
+        if matches["account"] not in self._account_map:
+            warning(
+                "Account %s not in account map, skipping transaction",
+                matches["account"],
+            )
+            return None
+        account_id = self._account_map[matches["account"]]
+
+        return Transaction(
+            account=account_id,
+            date=date,
+            amount=amount,
+            payee=matches["payee"],
+            notes="without card (via email)"
+            if matches.group("card") is not None
+            else "with card (via email)",
+            imported_id=msg["Message-ID"],
+        )
+
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        match msg["Subject"]:
+            case (
+                "Authorization on your credit account"
+                | "Authorization without credit card present"
+            ):
+                return self.extract_transaction(msg)
+        info("Subject `%s` didn't match any extractors", msg["Subject"])
+        return None
+
+
+class NeoFinancialParser(TransactionParser):
+    PURCHASE_EXTRACT_RE = re.compile(
+        r"your purchase of \$(?P<amount>[0-9]+\.[0-9]{2}) at (?P<payee>.+) on (?P<date>(January|February|March|April|May|June|July|August|September|October|November|December) \d{1,2}(st|nd|rd|th)?, \d{4})",  # noqa: E501
+        re.MULTILINE,
+    )
+
+    def __init__(self, account_id: UUID):
+        self.account_id = account_id
+
+    def match(self, msg: Message) -> bool:
+        return msg["From"] == "Neo Financial <info@neofinancial.com>" and msg[
+            "Subject"
+        ].startswith("You earned")
+
+    def extract_purchase(self, msg: EmailMessage) -> Optional[Transaction]:
+        content = self.get_content(msg, preferencelist=["plain"])
+        matches = self.PURCHASE_EXTRACT_RE.search(content)
+        if matches is None:
+            debug(f"No match on\n\n{content}")
+            raise TransactionParsingFailed("no matches for purchase extraction RE")
+
+        amount = Decimal(matches["amount"].replace(",", "")) * -1
+        # Use date from email header, it seems to match the body and includes TZ info
+        date = parse_email_time(msg["Date"]).date()
+        return Transaction(
+            account=self.account_id,
+            date=date,
+            amount=amount,
+            payee=matches["payee"],
+            notes="via email",
+            imported_id=msg["Message-ID"],
+        )
+
+    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
+        if msg["Subject"].startswith("You earned"):
+            return self.extract_purchase(msg)
+        return None

actual_imap_poll/watcher.py

@@ -1,17 +1,20 @@
 #!/usr/bin/env python
 import asyncio
 import email.policy
+import importlib.metadata
 import importlib.util
 import logging
 import os
 import ssl
-from dataclasses import dataclass
 from imaplib import IMAP4
 from logging import debug, error, info, warning
 from os import getenv
 
-from model import Transaction
-from parsers import TransactionParsingFailed
+from pydantic import Field, SecretStr
+from pydantic_settings import BaseSettings
+
+from .model import Transaction
+from .parsers import TransactionParsingFailed
 
 CONFIG_PATH = getenv("CONFIG_PATH", "/data/config.py")
 ACTUAL_PATH = "./cli.js"
@@ -33,27 +36,16 @@ def load_config_module(path: str):
     return config
 
 
-@dataclass
-class AppConfig:
-    @staticmethod
-    def from_environ() -> "AppConfig":
-        return AppConfig(
-            imap_server=os.environ["IMAP_SERVER"],
-            imap_port=int(getenv("IMAP_PORT", 143)),
-            imap_user=os.environ["IMAP_USER"],
-            imap_pass=os.environ["IMAP_PASS"],
-            imap_mailbox=getenv("IMAP_MAILBOX", "INBOX"),
-            imap_interval=int(getenv("IMAP_INTERVAL", 300)),
-            imap_starttls=bool(getenv("IMAP_STARTTLS", True)),
-        )
-
+class AppConfig(BaseSettings):
     imap_server: str
     imap_user: str
-    imap_pass: str
-    imap_port: int = 143
-    imap_mailbox: str = "INBOX"
-    imap_interval: int = 300
-    imap_starttls: bool = True
+    imap_pass: SecretStr
+    imap_port: int = Field(default=143)
+    imap_mailbox: str = Field(default="INBOX")
+    imap_interval: int = Field(default=300)
+    imap_starttls: bool = Field(default=True)
+
+    model_config = {"env_prefix": ""}
 
 
 class App:
@@ -114,7 +106,7 @@ class App:
             if self._config.imap_starttls:
                 context = ssl.create_default_context()
                 M.starttls(context)
-            M.login(self._config.imap_user, self._config.imap_pass)
+            M.login(self._config.imap_user, self._config.imap_pass.get_secret_value())
             M.select(self._config.imap_mailbox)
             _status, m_set = M.search(None, "UNSEEN")
 
@@ -136,8 +128,13 @@ class App:
             await self.poll_imap()
 
 
-if __name__ == "__main__":
+def main():
     logging.basicConfig(level=getenv("LOG_LEVEL", "INFO"))
-    app_config = AppConfig.from_environ()
+    logging.info(
+        "actual-imap-parser %s starting up",
+        importlib.metadata.version("actual-imap-poll"),
+    )
+    app_config = AppConfig()
+    logging.debug("Config: %s", app_config)
     app = App(app_config, CONFIG_PATH)
     asyncio.run(app.run())

package.json

@@ -14,7 +14,7 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "@actual-app/api": "^25.4.0",
+    "@actual-app/api": "^26.5.2",
     "yargs": "^17.7.2"
   }
 }

parsers.py

@@ -1,224 +0,0 @@
-import re
-from abc import ABC, abstractmethod
-from datetime import date, datetime
-from decimal import Decimal
-from email.message import EmailMessage, Message
-from logging import info
-from typing import Optional
-from uuid import UUID
-
-from bs4 import BeautifulSoup
-
-from model import Transaction
-
-
-def parse_email_time(s: str) -> datetime:
-    return datetime.strptime(s, "%a, %d %b %Y %H:%M:%S %z")
-
-
-class TransactionParser(ABC):
-    @abstractmethod
-    def match(self, msg: Message) -> bool:
-        """
-        Determines if the given email message matches the criteria for this parser.
-
-        Args:
-            msg (Message): The email message to evaluate.
-
-        Returns:
-            bool: True if the message matches the parser's criteria, False otherwise.
-        """
-        pass
-
-    @abstractmethod
-    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
-        """
-        Extracts transaction details from the given email message.
-
-        Args:
-            msg (EmailMessage): The email message to parse.
-
-        Returns:
-            Transaction: A Transaction object containing the extracted details.
-
-        Raises:
-            TransactionParsingFailed: If the message cannot be parsed successfully.
-        """
-        pass
-
-
-class TransactionParsingFailed(Exception):
-    pass
-
-
-class RogersBankParser(TransactionParser):
-    EXTRACT_RE = re.compile(
-        r"Attempt of \$([0-9,]+\.\d{2}) was made on ([A-z]{3} \d{1,2}, \d{4})[^<]*at ([^<]+) in ([^<]+)."  # noqa: E501
-    )
-
-    def __init__(self, account_id: UUID):
-        self.account_id = account_id
-
-    def match(self, msg: Message) -> bool:
-        return (
-            msg["From"] == "Rogers Bank <onlineservices@RogersBank.com>"
-            and msg["Subject"] == "Purchase amount alert"
-        )
-
-    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
-        body = msg.get_body()
-        if body is None:
-            raise TransactionParsingFailed("No body of message found")
-        content = body.get_content()
-        if content is None:
-            raise TransactionParsingFailed("No content of message found")
-        matches = self.EXTRACT_RE.search(content)
-        if matches is None:
-            raise TransactionParsingFailed("No matches for extraction RE")
-        amount = Decimal(matches[1].replace(",", "")) * -1
-
-        date_raw = matches[2]
-        payee = matches[3]
-        location = matches[4]
-
-        if "Rebate" == location and "CashBack" in payee:
-            amount = amount * -1
-
-        date = datetime.strptime(date_raw, "%b %d, %Y").date()
-        return Transaction(
-            account=self.account_id,
-            date=date,
-            amount=amount,
-            payee=payee,
-            notes=f"in {location} (via email)",
-            imported_id=msg["Message-ID"],
-        )
-
-
-class MBNAParser(TransactionParser):
-    EXTRACT_RE = re.compile(
-        r"A purchase of \$([0-9,]+\.\d{2}) from ([^<]+) was made at (\d{1,2}:\d{2} (AM|PM)) UTC on (\d{4}-\d{2}-\d{2})"  # noqa: E501
-    )
-
-    def __init__(self, account_id: UUID):
-        self.account_id = account_id
-
-    def match(self, msg: Message) -> bool:
-        return (
-            msg["From"] == "MBNA Notifications <noreply@mbna.ca>"
-            and msg["Subject"] == "MBNA - Transaction Alert"
-        )
-
-    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
-        body = msg.get_body(preferencelist=("html", "plain"))
-        if body is None:
-            raise TransactionParsingFailed("No body of message found")
-        content = body.get_content()
-        if content is None:
-            raise TransactionParsingFailed("No content of message found")
-        matches = self.EXTRACT_RE.search(content)
-        if matches is None:
-            raise TransactionParsingFailed("No matches for extraction RE")
-        amount = Decimal(matches[1].replace(",", "")) * -1
-        payee = matches[2]
-        date_raw = matches[5]
-        return Transaction(
-            account=self.account_id,
-            date=date.fromisoformat(date_raw),
-            amount=amount,
-            payee=payee,
-            notes="via email",
-            imported_id=msg["Message-ID"],
-        )
-
-
-class BMOParser(TransactionParser):
-    EXTRACT_RE = re.compile(
-        r"We want to let you know that a (withdrawal|deposit) of\s+\$([0-9,]+\.\d{2})\s+has been made (?:to|from) your account ending\s+in\s+(\d{3})",  # noqa: E501
-        flags=re.MULTILINE,
-    )
-
-    def __init__(self, account_map: dict[int, UUID]):
-        self._account_map = account_map
-
-    def match(self, msg: Message) -> bool:
-        return msg["From"] == "bmoalerts@bmo.com"
-
-    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
-        body = msg.get_body(preferencelist=("html", "plain"))
-        if body is None:
-            raise TransactionParsingFailed("No body of message found")
-        content = body.get_content()
-        if content is None:
-            raise TransactionParsingFailed("No content of message found")
-        soup = BeautifulSoup(content, "html.parser")
-        matches = self.EXTRACT_RE.search(soup.get_text())
-        if matches is None:
-            raise TransactionParsingFailed("No matches for extraction RE")
-
-        amount = Decimal(matches[2].replace(",", ""))
-        if matches[1] == "withdrawal":
-            amount = amount * -1
-        date = parse_email_time(msg["Date"]).date()
-        account_ref = int(matches[3])
-        if account_ref not in self._account_map:
-            info("Account %s not in account map", account_ref)
-            return None
-        account_id = self._account_map[account_ref]
-        return Transaction(
-            account=account_id,
-            date=date,
-            amount=amount,
-            payee="",
-            notes="via email",
-            imported_id=msg["Message-ID"],
-        )
-
-
-class CIBCParser(TransactionParser):
-    PAYMENT_EXTRACT_RE = re.compile(
-        r"recently received a \$([0-9,]+\.\d{2}) payment to your [^<]+ ending in (\d{4})",
-        flags=re.MULTILINE,
-    )
-
-    def __init__(self, account_map: dict[int, UUID]):
-        self._account_map = account_map
-
-    def match(self, msg: Message) -> bool:
-        return msg["From"] == "CIBC Banking <mailbox.noreply@cibc.com>"
-
-    def extract_payment(self, msg: EmailMessage):
-        body = msg.get_body(preferencelist=("html", "plain"))
-        if body is None:
-            raise TransactionParsingFailed("No body of message found")
-        content = body.get_content()
-        if content is None:
-            raise TransactionParsingFailed("No content of message found")
-
-        matches = self.PAYMENT_EXTRACT_RE.search(content)
-        if matches is None:
-            raise TransactionParsingFailed("no matches for extraction RE")
-
-        amount = Decimal(matches[1].replace(",", ""))
-        account_ref = int(matches[2])
-        date = parse_email_time(msg["Date"]).date()
-
-        if account_ref not in self._account_map:
-            info("Account %s not in account map", account_ref)
-            return None
-        account_id = self._account_map[account_ref]
-
-        return Transaction(
-            account=account_id,
-            date=date,
-            amount=amount,
-            payee="",
-            notes="via email",
-            imported_id=msg["Message-ID"],
-        )
-
-    def extract(self, msg: EmailMessage) -> Optional[Transaction]:
-        match msg["Subject"]:
-            case "New payment to your credit card":
-                return self.extract_payment(msg)
-        return None

pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "actual-imap-poll"
+version = "0.2.0"
+description = "Poll an IMAP mailbox looking for transactions to submit to Actual Budget"
+authors = [
+    {name = "Keenan Tims",email = "ktims@gotroot.ca"}
+]
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "beautifulsoup4 (>=4.14.2,<5.0.0)",
+    "pydantic>=2.12.4",
+    "pydantic-settings>=2.12.0",
+]
+
+[project.scripts]
+actual-imap-poll = "actual_imap_poll:main"
+
+[tool.uv.build-backend]
+module-name = "actual_imap_poll"
+module-root = ""
+
+[build-system]
+requires = ["uv_build>=0.9.11,<0.10.0"]
+build-backend = "uv_build"

requirements.txt

@@ -1 +0,0 @@
-beautifulsoup4

uv.lock

@@ -0,0 +1,181 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "actual-imap-poll"
+version = "0.1.1"
+source = { editable = "." }
+dependencies = [
+    { name = "beautifulsoup4" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "beautifulsoup4", specifier = ">=4.14.2,<5.0.0" },
+    { name = "pydantic", specifier = ">=2.12.4" },
+    { name = "pydantic-settings", specifier = ">=2.12.0" },
+]
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "beautifulsoup4"
+version = "4.14.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "soupsieve" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/77/e9/df2358efd7659577435e2177bfa69cba6c33216681af51a707193dec162a/beautifulsoup4-4.14.2.tar.gz", hash = "sha256:2a98ab9f944a11acee9cc848508ec28d9228abfd522ef0fad6a02a72e0ded69e", size = 625822, upload-time = "2025-09-29T10:05:42.613Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/fe/3aed5d0be4d404d12d36ab97e2f1791424d9ca39c2f754a6285d59a3b01d/beautifulsoup4-4.14.2-py3-none-any.whl", hash = "sha256:5ef6fa3a8cbece8488d66985560f97ed091e22bbc4e9c2338508a9d5de6d4515", size = 106392, upload-time = "2025-09-29T10:05:43.771Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.12.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/ad/a17bc283d7d81837c061c49e3eaa27a45991759a1b7eae1031921c6bd924/pydantic-2.12.4.tar.gz", hash = "sha256:0f8cb9555000a4b5b617f66bfd2566264c4984b27589d3b845685983e8ea85ac", size = 821038, upload-time = "2025-11-05T10:50:08.59Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/82/2f/e68750da9b04856e2a7ec56fc6f034a5a79775e9b9a81882252789873798/pydantic-2.12.4-py3-none-any.whl", hash = "sha256:92d3d202a745d46f9be6df459ac5a064fdaa3c1c4cd8adcfa332ccf3c05f871e", size = 463400, upload-time = "2025-11-05T10:50:06.732Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.41.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
+    { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
+    { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
+    { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
+    { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
+    { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
+    { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
+    { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
+    { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
+    { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
+    { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
+    { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" },
+    { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" },
+    { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" },
+    { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" },
+    { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" },
+    { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" },
+    { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" },
+    { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" },
+    { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
+]
+
+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f0/26/19cadc79a718c5edbec86fd4919a6b6d3f681039a2f6d66d14be94e75fb9/python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6", size = 44221, upload-time = "2025-10-26T15:12:10.434Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
+]
+
+[[package]]
+name = "soupsieve"
+version = "2.8"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6d/e6/21ccce3262dd4889aa3332e5a119a3491a95e8f60939870a3a035aabac0d/soupsieve-2.8.tar.gz", hash = "sha256:e2dd4a40a628cb5f28f6d4b0db8800b8f581b65bb380b97de22ba5ca8d72572f", size = 103472, upload-time = "2025-08-27T15:39:51.78Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/a0/bb38d3b76b8cae341dad93a2dd83ab7462e6dbcdd84d43f54ee60a8dc167/soupsieve-2.8-py3-none-any.whl", hash = "sha256:0cc76456a30e20f5d7f2e14a98a4ae2ee4e5abdc7c5ea0aafe795f344bc7984c", size = 36679, upload-time = "2025-08-27T15:39:50.179Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]