bai2 0.2.0

Requirements

Only python 3.4+ supported.

Installation

At the moment, the only way to install the library is from github

pip install git+https://github.com/ministryofjustice/bai2.git

Usage

To use bai2 in a project

>>> from bai2 import bai2

>>> # parse from a file
>>> with open(<file-path>) as f:
>>>     bai2_file = bai2.parse_from_file(f)

>>> # parse from a string
>>> bai2_file = bai2.parse_from_string(<bai2_as_string>)

>>> # parse from lines
>>> bai2_file = bai2.parse_from_lines(<bai2_as_lines>)

The parse_from_* methods return a bai2.models.Bai2File object which can be used to inspect the parsed data.

To write a BAI2 file:

>>> from bai2 import bai2
>>> from bai2 import models

>>> bai2_file = models.Bai2File()
>>> bai2_file.header.sender_id = 'EGBANK'

>>> bai2_file.children.append(models.Group())

>>> transactions = [models.TransactionDetail(amount=100)]
>>> bai2_file.children[0].children.append(models.Account(children=transactions))

>>> # write to string
>>> output = bai2.write(bai2_file)

Models

Models structure:

Bai2File
    Bai2FileHeader
    Group
        GroupHeader
        Account
            AccountIdentifier
            TransactionDetail
            AccountTrailer
        GroupTrailer
    Bai2FileTrailer

Section models define a header, a trailer and a list of children whilst single models define properties matching the bai2 fields.

Each Model has a rows property with the original rows from the BAI2 file.

Exceptions

The parse method might raise 3 exceptions:

1. ParsingException: when the file contains an error and the library can’t interpret the data

2. NotSupportedYetException: when the library doesn’t support the feature yet

3. IntegrityException: when the control totals or the number of objects reported in the trailers don’t match the ones in the file.

Incongruences

We’ve noticed that different banks implement the specs in slightly different ways and the parse method might therefore raise an ParsingException. It is expected to work correctly with files produced by NatWest, RBS, and JP Morgan.

We don’t know yet how to deal with these cases as we don’t have access to many bai2 files so we can’t test it as we would like.

Please let me know if this happens to you.

Copyright

Copyright © 2015 HM Government (Ministry of Justice Digital Services). See LICENSE for further details.

History

0.1.0 (2015-08-06)

• WIP