ofxstatement-nordigen 0.2.2__tar.gz

ofxstatement_nordigen-0.2.2/MANIFEST.in

@@ -0,0 +1 @@
+include README.rst

ofxstatement_nordigen-0.2.2/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: ofxstatement-nordigen
+Version: 0.2.2
+Summary: ofxstatement plugin for Nordigen bank statements
+Author-email: Jimmy Stammers <jimmy.stammers@gmail.com>
+Project-URL: Homepage, https://github.com/jstammers/ofxstatement-nordigen/
+Keywords: ofx,banking,statement,plugin,ofxstatement
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Natural Language :: English
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Requires-Python: >=3.12
+Description-Content-Type: text/x-rst
+Requires-Dist: ofxstatement
+Requires-Dist: pydantic
+Requires-Dist: requests
+Requires-Dist: requests-cache
+Requires-Dist: wheel>=0.45.1
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ofxstatement-nordigen
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A plugin for `ofxstatement`_ to parse transaction data from GoCardless (previously known as Nordigen).
+
+`ofxstatement`_ is a tool to convert proprietary bank statement to OFX format,
+suitable for importing to GnuCash. Plugin for ofxstatement parses a
+particular proprietary bank statement format and produces common data
+structure, that is then formatted into an OFX file.
+
+.. _ofxstatement: https://github.com/kedder/ofxstatement
+
+
+Installation
+================
+
+To install the plugin, you can use `pip`_:
+
+.. _pip: https://pypi.org/project/pip/
+
+.. code-block:: shell
+
+    pip install ofxstatement-nordigen
+
+or, if you want to install it in editable mode (for development), use:
+
+.. code-block:: shell
+
+    pip install -e ./
+
+To verify that the plugin is installed correctly, you can run:
+
+.. code-block:: shell
+
+    ofxstatement --list-plugins
+
+This should list the ``nordigen`` plugin among other plugins.
+
+Usage
+================
+
+To use the plugin, you can run the ``ofxstatement`` command with the ``--plugin`` option:
+
+.. code-block:: shell
+
+    ofxstatement convert -t nordigen <input_file> <output_file>
+
+Replace ``<input_file>`` with the path to your input file and ``<output_file>`` with the desired output file name.
+
+The input file should be a JSON of transactions from GoCardless that has the schema defined `here`_.
+
+.. _here: https://developer.gocardless.com/bank-account-data/transactions
+
+The output file will be an OFX file that can be imported into GnuCash or other financial software.
+
+Configuration
+================
+
+Configuration can be edited using the ``ofxstatement edit-config`` command.
+The following parameters are available:
+
+- ``account_id``: The account ID to use for the transactions. This is required.
+- ``currency``: The currency to use for the account. If not specified, the currency will be determined from the transactions.
+
+After you are done
+==================
+
+After your plugin is ready, feel free to open an issue on `ofxstatement`_
+project to include your plugin in "known plugin list". That would hopefully
+make life of other clients of your bank easier.

ofxstatement_nordigen-0.2.2/README.rst

@@ -0,0 +1,71 @@
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ofxstatement-nordigen
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A plugin for `ofxstatement`_ to parse transaction data from GoCardless (previously known as Nordigen).
+
+`ofxstatement`_ is a tool to convert proprietary bank statement to OFX format,
+suitable for importing to GnuCash. Plugin for ofxstatement parses a
+particular proprietary bank statement format and produces common data
+structure, that is then formatted into an OFX file.
+
+.. _ofxstatement: https://github.com/kedder/ofxstatement
+
+
+Installation
+================
+
+To install the plugin, you can use `pip`_:
+
+.. _pip: https://pypi.org/project/pip/
+
+.. code-block:: shell
+
+    pip install ofxstatement-nordigen
+
+or, if you want to install it in editable mode (for development), use:
+
+.. code-block:: shell
+
+    pip install -e ./
+
+To verify that the plugin is installed correctly, you can run:
+
+.. code-block:: shell
+
+    ofxstatement --list-plugins
+
+This should list the ``nordigen`` plugin among other plugins.
+
+Usage
+================
+
+To use the plugin, you can run the ``ofxstatement`` command with the ``--plugin`` option:
+
+.. code-block:: shell
+
+    ofxstatement convert -t nordigen <input_file> <output_file>
+
+Replace ``<input_file>`` with the path to your input file and ``<output_file>`` with the desired output file name.
+
+The input file should be a JSON of transactions from GoCardless that has the schema defined `here`_.
+
+.. _here: https://developer.gocardless.com/bank-account-data/transactions
+
+The output file will be an OFX file that can be imported into GnuCash or other financial software.
+
+Configuration
+================
+
+Configuration can be edited using the ``ofxstatement edit-config`` command.
+The following parameters are available:
+
+- ``account_id``: The account ID to use for the transactions. This is required.
+- ``currency``: The currency to use for the account. If not specified, the currency will be determined from the transactions.
+
+After you are done
+==================
+
+After your plugin is ready, feel free to open an issue on `ofxstatement`_
+project to include your plugin in "known plugin list". That would hopefully
+make life of other clients of your bank easier.

ofxstatement_nordigen-0.2.2/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ofxstatement-nordigen"
+version = "0.2.2"
+authors = [
+  { name="Jimmy Stammers", email="jimmy.stammers@gmail.com" },
+]
+description = "ofxstatement plugin for Nordigen bank statements"
+readme = "README.rst"
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Natural Language :: English",
+    "Topic :: Office/Business :: Financial :: Accounting",
+    "Topic :: Utilities",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+]
+keywords = ["ofx", "banking", "statement", "plugin", "ofxstatement"]
+dependencies = [
+  "ofxstatement",
+  "pydantic",
+  "requests",
+  "requests-cache",
+  "wheel>=0.45.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/jstammers/ofxstatement-nordigen/"
+
+[project.entry-points."ofxstatement"]
+nordigen = "ofxstatement_nordigen.plugin:NordigenPlugin"
+
+[dependency-groups]
+dev = [
+    "black>=25.11.0",
+    "build>=1.4.0",
+    "exceptiongroup>=1.3.1",
+    "mypy>=1.19.1",
+    "pytest>=8.4.2",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.14.11",
+    "tomli>=2.4.0",
+]

ofxstatement_nordigen-0.2.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen/plugin.py

@@ -0,0 +1,93 @@
+import json
+from typing import Iterable, Optional
+from datetime import datetime
+from ofxstatement.plugin import Plugin
+from ofxstatement.parser import StatementParser
+from ofxstatement.statement import Statement, StatementLine
+
+from ofxstatement_nordigen.schemas import NordigenTransactionModel
+
+
+class NordigenPlugin(Plugin):
+    """Retrieves Nordigen transactions and converts them to OFX format."""
+
+    def get_parser(self, filename: str) -> "NordigenParser":
+        default_ccy = self.settings.get("currency")
+        account_id = self.settings.get("account")
+        return NordigenParser(filename, default_ccy, account_id)
+
+
+class NordigenParser(StatementParser[str]):
+    def __init__(
+        self,
+        filename: str,
+        currency: Optional[str] = None,
+        account_id: Optional[str] = None,
+    ) -> None:
+        super().__init__()
+        if not filename.endswith(".json"):
+            raise ValueError("Only JSON files are supported")
+        self.filename = filename
+        self.currency = currency
+        self.account_id = account_id
+
+    def parse(self) -> Statement:
+        """Main entry point for parsers
+
+        super() implementation will call to split_records and parse_record to
+        process the file.
+        """
+        with open(self.filename, "r"):
+            statement = super().parse()
+            dates = [
+                line.date for line in statement.lines if isinstance(line.date, datetime)
+            ]
+            if len(dates) > 0:
+                statement.start_date = min(dates)
+                statement.end_date = max(dates)
+            statement.account_id = self.account_id
+            statement.currency = self.currency or statement.currency
+            return statement
+
+    def split_records(self) -> Iterable[str]:
+        """Return iterable object consisting of a line per transaction"""
+        data = json.load(open(self.filename, "r"))
+        transactions = data.get("transactions", {})
+        booked_transactions = transactions.get("booked", [])
+        return [json.dumps(transaction) for transaction in booked_transactions]
+
+    def parse_record(self, line: str) -> StatementLine:
+        """Parse given transaction line and return StatementLine object"""
+
+        # TODO: Infer transaction type from transaction data
+        statement = StatementLine()
+        transaction = json.loads(line)
+        transaction_data = NordigenTransactionModel(**transaction)
+        statement.id = (
+            transaction_data.transactionId or transaction_data.internalTransactionId
+        )
+        # Use bookingDateTime if available, otherwise convert bookingDate to datetime
+        if transaction_data.bookingDateTime:
+            statement.date = transaction_data.bookingDateTime
+        elif transaction_data.bookingDate:
+            statement.date = datetime.combine(
+                transaction_data.bookingDate, datetime.min.time()
+            )
+        statement.amount = transaction_data.transactionAmount.amount
+        # Handle different types of remittance information
+        if transaction_data.remittanceInformationUnstructured:
+            statement.memo = transaction_data.remittanceInformationUnstructured
+        elif transaction_data.remittanceInformationUnstructuredArray:
+            statement.memo = " ".join(
+                transaction_data.remittanceInformationUnstructuredArray
+            )
+        statement.payee = transaction_data.creditorName or transaction_data.debtorName
+        statement.date_user = transaction_data.valueDateTime
+        statement.check_no = transaction_data.checkId
+        statement.refnum = transaction_data.internalTransactionId
+        statement.currency = transaction_data.transactionAmount.currency
+        if transaction_data.currencyExchange and hasattr(
+            transaction_data.currencyExchange, "sourceCurrency"
+        ):
+            statement.orig_currency = transaction_data.currencyExchange.sourceCurrency
+        return statement

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen/schemas.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import datetime
+from ofxstatement.statement import Currency
+from decimal import Decimal
+from typing import List, Optional
+
+from pydantic import BaseModel, field_validator, ConfigDict
+from pydantic.alias_generators import to_snake
+
+
+class Amount(BaseModel):
+    amount: Decimal
+    currency: Currency
+
+    @field_validator("currency", mode="before")
+    def validate_currency(cls, value):
+        if isinstance(value, str):
+            return Currency(value)
+        return value
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+
+class Account(BaseModel):
+    bban: Optional[str] = None
+
+
+class ReportExchangeRate(BaseModel):
+    sourceCurrency: Optional[Currency] = None
+    targetCurrency: Optional[Currency] = None
+    unitCurrency: Optional[Currency] = None
+    exchangeRate: Optional[float] = None
+    quotationDate: Optional[datetime.date] = None
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    @field_validator("sourceCurrency", "targetCurrency", "unitCurrency", mode="before")
+    def validate_currency(cls, value):
+        if isinstance(value, str):
+            return Currency(value)
+        return value
+
+
+class CurrencyExchangeAmex(BaseModel):
+    """
+    Context: Issue #11
+
+    Temporary Fix:
+    This addresses the lack of normalization of American Express data to the GoCardless specification.
+
+    Note: This class should be removed once the normalization process is completed.
+    """
+
+    sourceCurrency: Optional[Currency] = None
+    targetCurrency: Optional[Currency] = None
+    unitCurrency: Optional[Currency] = None
+    exchangeRate: Optional[float] = None
+    instructedAmount: Optional[Amount] = None
+
+    @field_validator("sourceCurrency", "targetCurrency", "unitCurrency", mode="before")
+    def validate_currency(cls, value):
+        if isinstance(value, str):
+            return Currency(value)
+        return value
+
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+
+class NordigenTransactionModel(BaseModel):
+    """
+    Nordigen data transaction model.
+    """
+
+    balanceAfterTransaction: Optional[float] = None
+    bankTransactionCode: Optional[str] = None
+    bookingDate: Optional[datetime.date] = None
+    bookingDateTime: Optional[datetime.datetime] = None
+    checkId: Optional[str] = None
+    creditorAccount: Optional[Account] = None
+    creditorAgent: Optional[str] = None
+    creditorId: Optional[str] = None
+    creditorName: Optional[str] = None
+    currencyExchange: Optional[List[ReportExchangeRate] | CurrencyExchangeAmex] = None
+    debtorAccount: Optional[Account] = None
+    debtorAgent: Optional[str] = None
+    debtorName: Optional[str] = None
+    endToEndId: Optional[str] = None
+    entryReference: Optional[str] = None
+    internalTransactionId: Optional[str] = None
+    mandateId: Optional[str] = None
+    merchantCategoryCode: Optional[str] = None
+    proprietaryBankTransactionCode: Optional[str] = None
+    purposeCode: Optional[str] = None
+    remittanceInformationStructured: Optional[str] = None
+    remittanceInformationStructuredArray: Optional[List[str]] = None
+    remittanceInformationUnstructured: Optional[str] = None
+    remittanceInformationUnstructuredArray: Optional[List[str]] = None
+    transactionAmount: Amount
+    transactionId: Optional[str] = None
+    ultimateCreditor: Optional[str] = None
+    ultimateDebtor: Optional[str] = None
+    valueDate: Optional[datetime.date] = None
+    valueDateTime: Optional[datetime.datetime] = None
+
+    # class Config:
+    #     alias_generator = to_snake
+
+    model_config = ConfigDict(
+        arbitrary_types_allowed=True, alias_generator=to_snake, populate_by_name=True
+    )

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen.egg-info/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: ofxstatement-nordigen
+Version: 0.2.2
+Summary: ofxstatement plugin for Nordigen bank statements
+Author-email: Jimmy Stammers <jimmy.stammers@gmail.com>
+Project-URL: Homepage, https://github.com/jstammers/ofxstatement-nordigen/
+Keywords: ofx,banking,statement,plugin,ofxstatement
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Natural Language :: English
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Requires-Python: >=3.12
+Description-Content-Type: text/x-rst
+Requires-Dist: ofxstatement
+Requires-Dist: pydantic
+Requires-Dist: requests
+Requires-Dist: requests-cache
+Requires-Dist: wheel>=0.45.1
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ofxstatement-nordigen
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A plugin for `ofxstatement`_ to parse transaction data from GoCardless (previously known as Nordigen).
+
+`ofxstatement`_ is a tool to convert proprietary bank statement to OFX format,
+suitable for importing to GnuCash. Plugin for ofxstatement parses a
+particular proprietary bank statement format and produces common data
+structure, that is then formatted into an OFX file.
+
+.. _ofxstatement: https://github.com/kedder/ofxstatement
+
+
+Installation
+================
+
+To install the plugin, you can use `pip`_:
+
+.. _pip: https://pypi.org/project/pip/
+
+.. code-block:: shell
+
+    pip install ofxstatement-nordigen
+
+or, if you want to install it in editable mode (for development), use:
+
+.. code-block:: shell
+
+    pip install -e ./
+
+To verify that the plugin is installed correctly, you can run:
+
+.. code-block:: shell
+
+    ofxstatement --list-plugins
+
+This should list the ``nordigen`` plugin among other plugins.
+
+Usage
+================
+
+To use the plugin, you can run the ``ofxstatement`` command with the ``--plugin`` option:
+
+.. code-block:: shell
+
+    ofxstatement convert -t nordigen <input_file> <output_file>
+
+Replace ``<input_file>`` with the path to your input file and ``<output_file>`` with the desired output file name.
+
+The input file should be a JSON of transactions from GoCardless that has the schema defined `here`_.
+
+.. _here: https://developer.gocardless.com/bank-account-data/transactions
+
+The output file will be an OFX file that can be imported into GnuCash or other financial software.
+
+Configuration
+================
+
+Configuration can be edited using the ``ofxstatement edit-config`` command.
+The following parameters are available:
+
+- ``account_id``: The account ID to use for the transactions. This is required.
+- ``currency``: The currency to use for the account. If not specified, the currency will be determined from the transactions.
+
+After you are done
+==================
+
+After your plugin is ready, feel free to open an issue on `ofxstatement`_
+project to include your plugin in "known plugin list". That would hopefully
+make life of other clients of your bank easier.

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+MANIFEST.in
+README.rst
+pyproject.toml
+src/ofxstatement_nordigen/__init__.py
+src/ofxstatement_nordigen/plugin.py
+src/ofxstatement_nordigen/schemas.py
+src/ofxstatement_nordigen.egg-info/PKG-INFO
+src/ofxstatement_nordigen.egg-info/SOURCES.txt
+src/ofxstatement_nordigen.egg-info/dependency_links.txt
+src/ofxstatement_nordigen.egg-info/entry_points.txt
+src/ofxstatement_nordigen.egg-info/requires.txt
+src/ofxstatement_nordigen.egg-info/top_level.txt
+tests/test_CAISSEDEPARGNE_ILE_DE_FRANCE_CEPAFRPP751.py
+tests/test_banquepopulaire_rives_de_paris.py
+tests/test_sample.py
+tests/test_schemas.py

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[ofxstatement]
+nordigen = ofxstatement_nordigen.plugin:NordigenPlugin

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen.egg-info/requires.txt

@@ -0,0 +1,5 @@
+ofxstatement
+pydantic
+requests
+requests-cache
+wheel>=0.45.1

ofxstatement_nordigen-0.2.2/src/ofxstatement_nordigen.egg-info/top_level.txt

@@ -0,0 +1 @@
+ofxstatement_nordigen

ofxstatement_nordigen-0.2.2/tests/test_CAISSEDEPARGNE_ILE_DE_FRANCE_CEPAFRPP751.py

@@ -0,0 +1,48 @@
+import os
+import json
+import pytest
+from datetime import datetime, date
+from decimal import Decimal
+
+from ofxstatement.ui import UI
+from ofxstatement import ofx
+from ofxstatement.statement import StatementLine, Currency
+
+from ofxstatement_nordigen.plugin import NordigenPlugin, NordigenParser
+from ofxstatement_nordigen.schemas import NordigenTransactionModel
+
+
+@pytest.mark.parametrize("filename", ["CAISSEDEPARGNE_ILE_DE_FRANCE_CEPAFRPP751.json"])
+def test_CAISSEDEPARGNE_ILE_DE_FRANCE(filename: str) -> None:
+    """Test parsing the CAISSEDEPARGNE_ILE_DE_FRANCE_CEPAFRPP751.json file."""
+    here = os.path.dirname(__file__)
+    sample_filename = os.path.join(here, "data", filename)
+    expected_filename = sample_filename.replace(".json", ".ofx")
+
+    parser = NordigenParser(sample_filename)
+    statement = parser.parse()
+
+    # Verify the statement properties
+    assert len(statement.lines) == 1
+
+    # Verify the transaction details
+    transaction = statement.lines[0]
+    assert transaction.id == "6666666"
+
+    assert (
+        transaction.date is not None
+    )  # Fix for mypy: Check that date is not None before accessing date() method
+    assert transaction.date.date() == date(2025, 5, 13)
+
+    assert transaction.amount == Decimal("-1")
+
+    assert (
+        transaction.currency is not None
+    )  # Fix for mypy: Check that currency is not None before accessing symbol attribute
+    assert transaction.currency.symbol == "EUR"
+
+    # Check if the memo contains the combined information from remittanceInformationUnstructuredArray
+    assert (
+        transaction.memo is not None
+    )  # Fix for mypy: Check that memo is not None before using 'in' operator
+    assert "PRLV assurance" in transaction.memo

ofxstatement_nordigen-0.2.2/tests/test_banquepopulaire_rives_de_paris.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+
+import os
+import json
+import pytest
+from datetime import datetime, date
+from decimal import Decimal
+
+from ofxstatement.ui import UI
+from ofxstatement import ofx
+from ofxstatement.statement import StatementLine, Currency
+
+from ofxstatement_nordigen.plugin import NordigenPlugin, NordigenParser
+from ofxstatement_nordigen.schemas import NordigenTransactionModel
+
+
+@pytest.mark.parametrize(
+    "filename", ["BANQUEPOPULAIRE_RIVES_DE_PARIS_CCBPFRPPMTG.json"]
+)
+def test_banquepopulaire_rives_de_paris(filename: str) -> None:
+    """Test parsing the BANQUEPOPULAIRE_RIVES_DE_PARIS_CCBPFRPPMTG.json file."""
+    here = os.path.dirname(__file__)
+    sample_filename = os.path.join(here, "data", filename)
+    expected_filename = sample_filename.replace(".json", ".ofx")
+
+    parser = NordigenParser(sample_filename)
+    statement = parser.parse()
+
+    # Verify the statement properties
+    assert len(statement.lines) == 1
+
+    # Verify the transaction details
+    transaction = statement.lines[0]
+    assert transaction.id == "202500400015"
+
+    # Fix for mypy: Check that date is not None before accessing date() method
+    assert transaction.date is not None
+    assert transaction.date.date() == date(2025, 5, 2)
+
+    assert transaction.amount == Decimal("-8.43")
+
+    # Fix for mypy: Check that currency is not None before accessing symbol attribute
+    assert transaction.currency is not None
+    assert transaction.currency.symbol == "EUR"
+
+    assert transaction.refnum == "YYYYYYYYYYYYYY"
+
+    # Check if the memo contains the combined information from remittanceInformationUnstructuredArray
+    # Fix for mypy: Check that memo is not None before using 'in' operator
+    assert transaction.memo is not None
+    assert "CB****2222" in transaction.memo
+    assert "Food Restaurant" in transaction.memo
+
+    # Compare with expected OFX output
+    expected = open(expected_filename, "r").read()
+    writer = ofx.OfxWriter(statement)
+    result = writer.toxml(pretty=True)
+
+    # Get everything between the <STMTTRN> and </STMTTRN> tags ignoring \r characters
+    result = result[
+        result.index("<STMTTRN>") : result.index("</STMTTRN>") + len("</STMTTRN>")
+    ].replace("\r", "")
+    expected = expected[
+        expected.index("<STMTTRN>") : expected.index("</STMTTRN>") + len("</STMTTRN>")
+    ].replace("\r", "")
+
+    assert result == expected

ofxstatement_nordigen-0.2.2/tests/test_sample.py

@@ -0,0 +1,61 @@
+import os
+import pytest
+from ofxstatement.ui import UI
+
+from ofxstatement_nordigen.plugin import NordigenPlugin, NordigenParser
+from ofxstatement import ofx
+
+
+def test_config_sets_account_and_currency() -> None:
+    """Test that account and currency are set correctly when provided in config."""
+    # Create a plugin with specific account and currency settings
+    settings = {"account": "test-account-123", "currency": "EUR"}
+    plugin = NordigenPlugin(UI(), settings)
+
+    here = os.path.dirname(__file__)
+    sample_filename = os.path.join(here, "sample-statement.json")
+    parser = plugin.get_parser(sample_filename)
+
+    assert parser.account_id == settings["account"]
+    assert parser.currency == settings["currency"]
+
+    statement = parser.parse()
+    assert statement.account_id == settings["account"]
+    assert statement.currency == settings["currency"]
+
+
+def test_sample() -> None:
+    plugin = NordigenPlugin(UI(), {})
+    here = os.path.dirname(__file__)
+    for filename in os.listdir(here):
+        if filename.endswith(".json"):
+            sample_filename = os.path.join(here, filename)
+            parser = plugin.get_parser(sample_filename)
+            statement = parser.parse()
+            assert len(statement.lines) > 0
+            assert statement.start_date is not None
+            assert statement.end_date is not None
+
+
+@pytest.mark.parametrize("filename", ["test_date.json", "test_snake_case.json"])
+def test_parse_record(filename: str) -> None:
+    here = os.path.dirname(__file__)
+    sample_filename = os.path.join(here, "data", filename)
+    expected_filename = sample_filename.replace(".json", ".ofx")
+
+    parser = NordigenParser(sample_filename)
+    statement = parser.parse()
+
+    expected = open(expected_filename, "r").read()
+    writer = ofx.OfxWriter(statement)
+    result = writer.toxml(pretty=True)
+
+    # Get everything between the <STMTTRN> and </STMTTRN> tags ignoring \r characters
+    result = result[
+        result.index("<STMTTRN>") : result.index("</STMTTRN>") + len("</STMTTRN>")
+    ].replace("\r", "")
+    expected = expected[
+        expected.index("<STMTTRN>") : expected.index("</STMTTRN>") + len("</STMTTRN>")
+    ].replace("\r", "")
+
+    assert result == expected

ofxstatement_nordigen-0.2.2/tests/test_schemas.py

@@ -0,0 +1,68 @@
+import pytest
+
+from ofxstatement_nordigen.schemas import NordigenTransactionModel
+
+
+@pytest.mark.parametrize(
+    "data",
+    [
+        {
+            "transactionId": "123456789",
+            "transactionAmount": {"amount": 100.0, "currency": "EUR"},
+            "valueDate": "2023-10-01",
+            "valueDateTime": "2023-10-01T12:00:00Z",
+            "remittanceInformationStructured": "Payment for invoice #12345",
+        },
+        {
+            "transactionId": "987654321",
+            "entryReference": "REF123456",
+            "bookingDate": "2025-03-31",
+            "bookingDateTime": "2025-03-31T00:00:00+00:00",
+            "transactionAmount": {"amount": "-1521.00", "currency": "GBP"},
+            "remittanceInformationUnstructured": "Payment for invoice #67890",
+            "additionalInformation": "Payment received",
+            "proprietaryBankTransactionCode": "BP",
+            "internalTransactionId": "INT123456",
+        },
+        {
+            "transactionId": "anonymized_transaction_id",
+            "entryReference": "anonymized_entry_reference",
+            "bookingDate": "2025-04-05",
+            "valueDate": "2025-04-05",
+            "bookingDateTime": "2025-04-05T00:00:00+00:00",
+            "valueDateTime": "2025-04-05T00:00:00+00:00",
+            "transactionAmount": {"amount": "0.00", "currency": "XXX"},
+            "currencyExchange": [{"sourceCurrency": "XXX", "exchangeRate": "0.0"}],
+            "remittanceInformationUnstructured": "anonymized_remittance_information",
+            "additionalInformation": "anonymized_additional_information",
+            "additionalDataStructured": {
+                "CardSchemeName": "anonymized_card_scheme",
+                "Name": "anonymized_name",
+                "Identification": "anonymized_identification",
+            },
+            "internalTransactionId": "anonymized_internal_transaction_id",
+        },
+        {
+            "transactionId": "anonymized_transaction_id",
+            "bookingDate": "2025-04-05",
+            "bookingDateTime": "2025-05-05T07:20:42.19Z",
+            "transactionAmount": {"amount": "-100.0000", "currency": "GBP"},
+            "currencyExchange": [
+                {
+                    "quotationDate": "2025-04-05",
+                    "sourceCurrency": "AUD",
+                    "exchangeRate": "2.04501",
+                    "unitCurrency": "GBP",
+                    "targetCurrency": "GBP",
+                }
+            ],
+            "remittanceInformationUnstructured": "anonymized_remittance_information",
+            "proprietaryBankTransactionCode": "anonymized_code",
+            "internalTransactionId": "anonymized_internal_transaction_id",
+        },
+    ],
+)
+def test_go_cardless_transaction_model(data):
+    validated = NordigenTransactionModel(**data)
+    print(validated)
+    assert validated is not None