swiftlib 1.0.0__py3-none-any.whl

swiftlib/__init__.py

@@ -0,0 +1,23 @@
+"""
+swiftlib — Python library for SWIFT MT and ISO 20022 message parsing and generation.
+"""
+
+from swiftlib.exceptions import (
+    FieldFormatError,
+    GenerationError,
+    ParseError,
+    SwiftLibError,
+    UnsupportedMessageType,
+    ValidationError,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    "__version__",
+    "SwiftLibError",
+    "ParseError",
+    "ValidationError",
+    "GenerationError",
+    "UnsupportedMessageType",
+    "FieldFormatError",
+]

swiftlib/converters/__init__.py

@@ -0,0 +1,18 @@
+"""
+swiftlib.converters — MT ↔ ISO 20022 message converters.
+"""
+
+from swiftlib.converters.iso_to_mt import Pacs008ToMT103Converter, Pain001ToMT103Converter
+from swiftlib.converters.mt_to_iso import (
+    MT103ToPacs008Converter,
+    MT103ToPain001Converter,
+    MT940ToCamt053Converter,
+)
+
+__all__ = [
+    "MT103ToPain001Converter",
+    "MT103ToPacs008Converter",
+    "MT940ToCamt053Converter",
+    "Pain001ToMT103Converter",
+    "Pacs008ToMT103Converter",
+]

swiftlib/converters/iso_to_mt.py

@@ -0,0 +1,129 @@
+"""
+swiftlib.converters.iso_to_mt — Convert ISO 20022 messages to SWIFT MT.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+__all__ = [
+    "Pain001ToMT103Converter",
+    "Pacs008ToMT103Converter",
+]
+
+
+class Pain001ToMT103Converter:
+    """Convert a pain.001 :class:`~swiftlib.iso20022.messages.pain001.Pain001` to a list of MT103 messages."""
+
+    def convert(self, pain001: "Pain001") -> "list[MT103]":  # noqa: F821
+        from swiftlib.mt.messages.mt103 import MT103Builder
+
+        result = []
+        for pi in pain001.payment_information:
+            for tx in pi.credit_transfer_transactions:
+                builder = MT103Builder()
+
+                # Transaction reference
+                ref = tx.payment_id.end_to_end_id or tx.payment_id.instruction_id or "NOTPROVIDED"
+                builder.transaction_reference(ref[:16])
+
+                # Bank operation code
+                builder.bank_operation_code("CRED")
+
+                # Value date + currency + amount
+                from swiftlib.iso20022.messages.pain001 import InstructedAmount
+                if isinstance(tx.amount, InstructedAmount):
+                    ccy = tx.amount.currency
+                    amount = tx.amount.amount
+                else:
+                    ccy = tx.amount.currency_of_transfer
+                    amount = tx.amount.amount
+
+                builder.value_date_currency_amount(pi.requested_execution_date, ccy, amount)
+
+                # Ordering customer (debtor)
+                dbtr = pi.debtor
+                dbtr_acct = pi.debtor_account
+                acct_id = dbtr_acct.iban or dbtr_acct.other_id or "NOTPROVIDED"
+                builder.ordering_customer(
+                    account=acct_id,
+                    name=dbtr.name[:35],
+                    address=[],
+                )
+
+                # Account with institution (creditor agent)
+                if tx.creditor_agent is not None:
+                    bic = tx.creditor_agent.financial_institution.bic
+                    if bic:
+                        builder.account_with_institution("A", bic)
+
+                # Beneficiary (creditor)
+                cdtr = tx.creditor
+                cdtr_acct = tx.creditor_account
+                cdtr_acct_id = cdtr_acct.iban or cdtr_acct.other_id or "NOTPROVIDED"
+                builder.beneficiary(
+                    account=cdtr_acct_id,
+                    name=cdtr.name[:35],
+                    address=[],
+                )
+
+                # Remittance information
+                if tx.remittance_info is not None:
+                    for ustrd in tx.remittance_info.unstructured:
+                        builder.remittance_info(ustrd[:140])
+                        break  # only one :70: allowed
+
+                # Charges
+                charge_map = {"DEBT": "OUR", "CRED": "BEN", "SHAR": "SHA", "SLEV": "SHA"}
+                builder.charges(charge_map.get(tx.charge_bearer, "SHA"))
+
+                result.append(builder.build())
+
+        return result
+
+
+class Pacs008ToMT103Converter:
+    """Convert a pacs.008 :class:`~swiftlib.iso20022.messages.pacs008.FIToFICreditTransfer` to a list of MT103 messages."""
+
+    def convert(self, pacs008: "FIToFICreditTransfer") -> "list[MT103]":  # noqa: F821
+        from swiftlib.mt.messages.mt103 import MT103Builder
+
+        result = []
+        for tx in pacs008.credit_transfer_transaction_information:
+            builder = MT103Builder()
+
+            ref = tx.payment_id.end_to_end_id or tx.payment_id.transaction_id or "NOTPROVIDED"
+            builder.transaction_reference(ref[:16])
+            builder.bank_operation_code("CRED")
+
+            ccy = tx.interbank_settlement_amount.currency
+            amount = tx.interbank_settlement_amount.amount
+            builder.value_date_currency_amount(tx.interbank_settlement_date, ccy, amount)
+
+            # Debtor
+            dbtr_acct_id = tx.debtor_account.iban or tx.debtor_account.other_id or "NOTPROVIDED"
+            builder.ordering_customer(account=dbtr_acct_id, name=tx.debtor.name[:35])
+
+            # Debtor agent
+            if tx.debtor_agent.financial_institution.bic:
+                builder.ordering_institution("A", tx.debtor_agent.financial_institution.bic)
+
+            # Creditor agent
+            if tx.creditor_agent.financial_institution.bic:
+                builder.account_with_institution("A", tx.creditor_agent.financial_institution.bic)
+
+            # Creditor
+            cdtr_acct_id = tx.creditor_account.iban or tx.creditor_account.other_id or "NOTPROVIDED"
+            builder.beneficiary(account=cdtr_acct_id, name=tx.creditor.name[:35])
+
+            if tx.remittance_info:
+                for ustrd in tx.remittance_info.unstructured:
+                    builder.remittance_info(ustrd[:140])
+                    break
+
+            charge_map = {"DEBT": "OUR", "CRED": "BEN", "SHAR": "SHA", "SLEV": "SHA"}
+            builder.charges(charge_map.get(tx.charge_bearer, "SHA"))
+
+            result.append(builder.build())
+
+        return result

swiftlib/converters/mt_to_iso.py

@@ -0,0 +1,337 @@
+"""
+swiftlib.converters.mt_to_iso — Convert SWIFT MT messages to ISO 20022.
+"""
+
+from __future__ import annotations
+
+import re
+from datetime import date, datetime
+from decimal import Decimal
+
+from swiftlib.exceptions import GenerationError
+
+__all__ = [
+    "MT103ToPain001Converter",
+    "MT103ToPacs008Converter",
+    "MT940ToCamt053Converter",
+]
+
+
+def _parse_party_field(swift_party: str) -> tuple[str | None, str, list[str]]:
+    """Parse a SWIFT party field (e.g., :50K: or :59:) into (account, name, address)."""
+    lines = swift_party.strip().split("\n")
+    account: str | None = None
+    name: str = ""
+    address: list[str] = []
+
+    if not lines:
+        return account, name, address
+
+    first = lines[0]
+    if first.startswith("/"):
+        account = first[1:].strip()
+        if len(lines) > 1:
+            name = lines[1]
+            address = lines[2:]
+    else:
+        name = first
+        address = lines[1:]
+
+    return account, name, address
+
+
+class MT103ToPain001Converter:
+    """Convert an :class:`~swiftlib.mt.messages.mt103.MT103` to a :class:`~swiftlib.iso20022.messages.pain001.Pain001`."""
+
+    def convert(self, mt103: "MT103") -> "Pain001":  # noqa: F821
+        from swiftlib.iso20022.messages.pain001 import (
+            AccountIdentification,
+            BranchAndFinancialInstitutionIdentification,
+            CreditTransferTransaction,
+            FinancialInstitutionIdentification,
+            GroupHeader,
+            InstructedAmount,
+            Pain001,
+            Party,
+            PaymentIdentification,
+            PaymentInformation,
+            RemittanceInformation,
+        )
+
+        msg_id = mt103.transaction_reference or f"MT103-{id(mt103)}"
+        now = datetime.now()
+
+        init_pty = Party(name=mt103.sender[:35] if mt103.sender else "UNKNOWN")
+        gh = GroupHeader(
+            message_id=msg_id,
+            creation_datetime=now,
+            number_of_transactions=1,
+            control_sum=mt103.amount or Decimal("0"),
+            initiating_party=init_pty,
+        )
+
+        # Ordering customer (debtor)
+        ord_cust_raw = mt103.ordering_customer
+        oc_account, oc_name, oc_address = _parse_party_field(ord_cust_raw)
+        debtor = self._map_party(ord_cust_raw)
+        debtor_account = AccountIdentification(iban=oc_account)
+
+        # Ordering institution (debtor agent)
+        dbtr_agt_bic: str | None = None
+        for tag in ("52A", "52D"):
+            v = mt103.get_field_value(tag)
+            if v:
+                # BIC is typically the last line or the whole value
+                lines = v.strip().split("\n")
+                dbtr_agt_bic = lines[-1].strip()
+                break
+        debtor_agent = BranchAndFinancialInstitutionIdentification(
+            financial_institution=FinancialInstitutionIdentification(bic=dbtr_agt_bic)
+        )
+
+        # Account with institution (creditor agent)
+        cdtr_agt_bic: str | None = None
+        for tag in ("57A", "57D"):
+            v = mt103.get_field_value(tag)
+            if v:
+                lines = v.strip().split("\n")
+                cdtr_agt_bic = lines[-1].strip()
+                break
+        creditor_agent = BranchAndFinancialInstitutionIdentification(
+            financial_institution=FinancialInstitutionIdentification(bic=cdtr_agt_bic)
+        )
+
+        # Beneficiary (creditor)
+        bene_raw = mt103.beneficiary
+        bene_account, bene_name, bene_address = _parse_party_field(bene_raw)
+        creditor = self._map_party(bene_raw)
+        creditor_account = AccountIdentification(iban=bene_account)
+
+        # Amount
+        amount = self._map_amount(mt103)
+
+        # Remittance
+        rmt_info: RemittanceInformation | None = None
+        rmt_raw = mt103.remittance_info
+        if rmt_raw:
+            rmt_info = RemittanceInformation(unstructured=[rmt_raw])
+
+        pmt_id = PaymentIdentification(
+            instruction_id=msg_id,
+            end_to_end_id=msg_id,
+        )
+
+        charge_bearer_map = {"OUR": "DEBT", "BEN": "CRED", "SHA": "SHAR"}
+        charge_bearer = charge_bearer_map.get(mt103.charges, "SLEV")
+
+        tx = CreditTransferTransaction(
+            payment_id=pmt_id,
+            amount=amount,
+            charge_bearer=charge_bearer,
+            creditor_agent=creditor_agent,
+            creditor=creditor,
+            creditor_account=creditor_account,
+            remittance_info=rmt_info,
+        )
+
+        exec_date = mt103.value_date or date.today()
+
+        pi = PaymentInformation(
+            payment_info_id=f"{msg_id}-001",
+            payment_method="TRF",
+            batch_booking=False,
+            number_of_transactions=1,
+            control_sum=mt103.amount or Decimal("0"),
+            payment_type_info=None,
+            requested_execution_date=exec_date,
+            debtor=debtor,
+            debtor_account=debtor_account,
+            debtor_agent=debtor_agent,
+            credit_transfer_transactions=[tx],
+        )
+
+        return Pain001(group_header=gh, payment_information=[pi])
+
+    def _map_party(self, swift_party: str) -> "Party":  # noqa: F821
+        from swiftlib.iso20022.messages.pain001 import Party, PostalAddress
+        account, name, address = _parse_party_field(swift_party)
+        postal: PostalAddress | None = None
+        if address:
+            postal = PostalAddress(address_lines=address)
+        return Party(name=name or "", postal_address=postal)
+
+    def _map_amount(self, mt103: "MT103") -> "InstructedAmount":  # noqa: F821
+        from swiftlib.iso20022.messages.pain001 import InstructedAmount
+        return InstructedAmount(
+            currency=mt103.currency or "",
+            amount=mt103.amount or Decimal("0"),
+        )
+
+
+class MT103ToPacs008Converter:
+    """Convert an MT103 to a pacs.008 :class:`~swiftlib.iso20022.messages.pacs008.FIToFICreditTransfer`."""
+
+    def convert(self, mt103: "MT103") -> "FIToFICreditTransfer":  # noqa: F821
+        from swiftlib.iso20022.messages.pacs008 import (
+            CreditTransferTransactionInfo,
+            FIToFICreditTransfer,
+            GroupHeader,
+            InterBankSettlementAmount,
+            SettlementInstruction,
+        )
+        from swiftlib.iso20022.messages.pain001 import (
+            AccountIdentification,
+            BranchAndFinancialInstitutionIdentification,
+            FinancialInstitutionIdentification,
+            Party,
+            PaymentIdentification,
+            RemittanceInformation,
+        )
+
+        now = datetime.now()
+        msg_id = mt103.transaction_reference or f"PACS008-{id(mt103)}"
+
+        gh = GroupHeader(
+            message_id=msg_id,
+            creation_datetime=now,
+            number_of_transactions=1,
+            settlement_information=SettlementInstruction(settlement_method="INDA"),
+        )
+
+        iba = InterBankSettlementAmount(
+            currency=mt103.currency or "",
+            amount=mt103.amount or Decimal("0"),
+        )
+
+        # Parties
+        ord_raw = mt103.ordering_customer
+        oc_account, oc_name, _ = _parse_party_field(ord_raw)
+        debtor = Party(name=oc_name or "")
+        debtor_account = AccountIdentification(iban=oc_account)
+
+        bene_raw = mt103.beneficiary
+        bene_account, bene_name, _ = _parse_party_field(bene_raw)
+        creditor = Party(name=bene_name or "")
+        creditor_account = AccountIdentification(iban=bene_account)
+
+        def _get_bic(tags: list[str]) -> str | None:
+            for tag in tags:
+                v = mt103.get_field_value(tag)
+                if v:
+                    return v.strip().split("\n")[-1].strip()
+            return None
+
+        dbtr_agt = BranchAndFinancialInstitutionIdentification(
+            financial_institution=FinancialInstitutionIdentification(
+                bic=_get_bic(["52A", "52D"])
+            )
+        )
+        cdtr_agt = BranchAndFinancialInstitutionIdentification(
+            financial_institution=FinancialInstitutionIdentification(
+                bic=_get_bic(["57A", "57D"])
+            )
+        )
+
+        rmt_info: RemittanceInformation | None = None
+        if mt103.remittance_info:
+            rmt_info = RemittanceInformation(unstructured=[mt103.remittance_info])
+
+        charge_bearer_map = {"OUR": "DEBT", "BEN": "CRED", "SHA": "SHAR"}
+
+        tx = CreditTransferTransactionInfo(
+            payment_id=PaymentIdentification(
+                instruction_id=msg_id,
+                end_to_end_id=msg_id,
+                transaction_id=msg_id,
+            ),
+            interbank_settlement_amount=iba,
+            interbank_settlement_date=mt103.value_date or date.today(),
+            charge_bearer=charge_bearer_map.get(mt103.charges, "SLEV"),
+            instructing_agent=None,
+            instructed_agent=None,
+            debtor=debtor,
+            debtor_account=debtor_account,
+            debtor_agent=dbtr_agt,
+            creditor_agent=cdtr_agt,
+            creditor=creditor,
+            creditor_account=creditor_account,
+            remittance_info=rmt_info,
+        )
+
+        return FIToFICreditTransfer(
+            group_header=gh, credit_transfer_transaction_information=[tx]
+        )
+
+
+class MT940ToCamt053Converter:
+    """Convert an MT940 to a camt.053 :class:`~swiftlib.iso20022.messages.camt053.Camt053`."""
+
+    def convert(self, mt940: "MT940") -> "Camt053":  # noqa: F821
+        from swiftlib.iso20022.messages.camt053 import (
+            Balance,
+            CashAccount,
+            Camt053,
+            GroupHeader053,
+            ReportEntry,
+            Statement,
+        )
+
+        now = datetime.now()
+        msg_id = mt940.transaction_reference or f"CAMT053-{id(mt940)}"
+
+        gh = GroupHeader053(message_id=msg_id, creation_datetime=now)
+
+        acct_raw = mt940.account
+        acct = CashAccount(
+            iban=acct_raw if acct_raw.startswith("LT") or re.match(r"[A-Z]{2}\d{2}", acct_raw) else None,
+            other_id=acct_raw if not (acct_raw.startswith("LT") or re.match(r"[A-Z]{2}\d{2}", acct_raw)) else None,
+        )
+
+        balances: list[Balance] = []
+        opening = mt940.opening_balance
+        if opening is not None:
+            dc = "DBIT" if opening.debit_credit == "D" else "CRDT"
+            balances.append(Balance(
+                type_code="OPBD",
+                amount=opening.amount,
+                currency=opening.currency,
+                credit_debit_indicator=dc,
+                date=opening.date,
+            ))
+
+        closing = mt940.closing_balance
+        if closing is not None:
+            dc = "DBIT" if closing.debit_credit == "D" else "CRDT"
+            balances.append(Balance(
+                type_code="CLBD",
+                amount=closing.amount,
+                currency=closing.currency,
+                credit_debit_indicator=dc,
+                date=closing.date,
+            ))
+
+        entries = [self._map_statement_line(line) for line in mt940.statement_lines]
+
+        stmt = Statement(
+            identification=msg_id,
+            creation_datetime=now,
+            account=acct,
+            balance=balances,
+            transactions=entries,
+        )
+
+        return Camt053(group_header=gh, statements=[stmt])
+
+    def _map_statement_line(self, line: "StatementLine") -> "ReportEntry":  # noqa: F821
+        from swiftlib.iso20022.messages.camt053 import ReportEntry
+        dc_indicator = "DBIT" if "D" in line.debit_credit_mark else "CRDT"
+        return ReportEntry(
+            amount=line.amount,
+            currency="",  # MT940 doesn't carry currency in field 61 directly
+            credit_debit_indicator=dc_indicator,
+            status="BOOK",
+            booking_date=line.value_date,
+            value_date=line.value_date,
+            account_servicer_ref=line.account_servicing_ref,
+            entry_reference=line.reference,
+        )

swiftlib/core/__init__.py

@@ -0,0 +1,28 @@
+"""
+swiftlib.core — core building blocks: fields, blocks, messages.
+"""
+
+from swiftlib.core.field import Field, FieldDefinition, FieldType, parse_format
+from swiftlib.core.block import (
+    Block1,
+    Block2Input,
+    Block2Output,
+    Block3,
+    Block4,
+    Block5,
+)
+from swiftlib.core.message import SwiftMessage
+
+__all__ = [
+    "Field",
+    "FieldDefinition",
+    "FieldType",
+    "parse_format",
+    "Block1",
+    "Block2Input",
+    "Block2Output",
+    "Block3",
+    "Block4",
+    "Block5",
+    "SwiftMessage",
+]