mt-940

A library to parse MT940 files and returns smart Python collections for statistics and manipulation.

These details have not been verified by PyPI

Project links

Homepage

Project description

mt940 - A library to parse MT940 files and returns smart Python collections for statistics and manipulation.

Install

To install the latest release:

pip install mt-940

Or if pip is not available:

easy_install mt-940

To install the latest development release:

git clone --branch develop https://github.com/WoLpH/mt940.git mt940
cd ./mt940
virtualenv .env
source .env/bin/activate
pip install -e .

To run the tests you can use the py.test command or just run tox to test everything in all supported python versions.

Usage

Basic parsing:

import mt940
import pprint

transactions = mt940.parse('tests/jejik/abnamro.sta')

print 'Transactions:'
print transactions
pprint.pprint(transactions.data)

print
for transaction in transactions:
    print 'Transaction: ', transaction
    pprint.pprint(transaction.data)

Set opening / closing balance information on each transaction:

import mt940
import pprint

mt940.tags.BalanceBase.scope = mt940.models.Transaction

# The currency has to be set manually when setting the BalanceBase scope to Transaction.
transactions = mt940.models.Transactions(processors=dict(
    pre_statement=[
        mt940.processors.add_currency_pre_processor('EUR'),
    ],
))

with open('tests/jejik/abnamro.sta') as f:
    data = f.read()

transactions.parse(data)

for transaction in transactions:
    print 'Transaction: ', transaction
    pprint.pprint(transaction.data)

Simple json encoding:

import json
import mt940

transactions = mt940.parse('tests/jejik/abnamro.sta')

def default(value):
    if isinstance(value, mt940.models.Transactions):
        data = value.data.copy()
        data['transactions'] = value.transactions
        return data

    elif hasattr(value, 'data'):
        return value.data

print(json.dumps(transactions, default=default, indent=4))

Contributing

Help is greatly appreciated, just please remember to clone the development branch and to run tox before creating pull requests.

Travis tests for flake8 support and test coverage so it’s always good to check those before creating a pull request.

Development branch: https://github.com/WoLpH/mt940/tree/develop

To run the tests:

pip install -r tests/requirements.txt
py.test

Or to run the tests on all available Python versions:

pip install tox
tox

Info

Python support	Python 2.7, >= 3.3
Blog	http://wol.ph/
Source	https://github.com/WoLpH/mt940
Documentation	http://mt940.rtfd.org
Changelog	http://mt940.readthedocs.org/en/latest/history.html
API	http://mt940.readthedocs.org/en/latest/modules.html
Issues/roadmap	https://github.com/WoLpH/mt940/issues
Travis	http://travis-ci.org/WoLpH/mt940
Test coverage	https://coveralls.io/r/WoLpH/mt940
Pypi	https://pypi-hypernode.com/pypi/mt-940
Ohloh	https://www.ohloh.net/p/mt-940
License	BSD.
git repo	`$ git clone https://github.com/WoLpH/mt940.git`
install dev	`$ git clone https://github.com/WoLpH/mt940.git mt940 $ cd ./mt940 $ virtualenv .env $ source .env/bin/activate $ pip install -e .`
tests	`$ py.test`

Changelog

v4.12.1 modernized setup.py and reformatted pypi readme v4.12.1

v4.10.0 Fixed overzealous whitespace trimming thanks to @FelixSchwarz and added :61: support for Sberbank thanks to @csfulop v4.10.0

v4.9.0 Fixed #47 and #48 thanks to @sbi v4.9.0

v4.8.1 removed debug statement thanks to @robfech v4.8.1

v4.8.0 Added German transaction details parsing (#30, thanks to @sweh) and fixed february 29th support (#45, thanks to @fHachenberg) v4.8.0

v4.7 Fixed #42 thanks to @cluck. NS records are now parsed correctly v4.7

v4.6 Fixed #42 thanks to @cluck. NS records are now parsed correctly v4.6

v4.5 fixed wrong repetitions cound in TransactionDetails (fixes #37) v4.5

v4.4 Added support for mBank Collect and fixed MT942 support thanks to @sq9mev v4.4

v4.3 Added mt942 support thanks to @bumi

v4.2 Added single input agnostic parse method. Thanks to @philippeowagner

v4.1 Added NS (non-swift) support. Fixes #23

v4.0 Added support for many more MT940 variants

v3.2 Added support for intermediate/final closing/opening balance

v3.1 Fixed #12. Previously matched tags in the middle of the line

v3.0 Added Python 3 support

v2.0 Version 2.0 with 100% test coverage and better docs

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

4.30.0

Apr 13, 2023

4.29.0

Mar 27, 2023

4.28.0

Jan 12, 2023

4.27.0

Nov 28, 2022

4.26.0

May 14, 2022

4.25.0

May 14, 2022

4.23.0

Jun 25, 2020

4.21.0

Mar 19, 2020

4.20.0

Mar 7, 2020

4.19.0

Nov 8, 2019

4.18.0

Oct 6, 2019

4.17.0

May 31, 2019

4.16.0

May 27, 2019

4.15.0

Mar 20, 2019

4.14.0

Mar 6, 2019

4.13.2

Feb 17, 2019

4.13.1

Feb 11, 2019

4.13.0

Jan 10, 2019

4.12.2

Jun 26, 2018

This version

4.12.1

May 11, 2018

4.12.0

May 11, 2018

4.11.0

Mar 14, 2018

4.10.0

Dec 26, 2017

4.9.0

Oct 30, 2017

4.8.1

Sep 12, 2017

4.8.0

Sep 7, 2017

4.7

May 24, 2017

4.6

Mar 28, 2017

4.5

Feb 25, 2017

4.4

Jan 26, 2017

4.3

Nov 26, 2016

4.2

Aug 12, 2016

4.1

Jun 26, 2016

4.0

Apr 28, 2016

3.2

Aug 15, 2015

3.1

Aug 12, 2015

3.0

Jul 11, 2015

2.2

May 25, 2015

2.1

May 24, 2015

2.0

May 21, 2015

1.4

Apr 28, 2015

1.3

Apr 24, 2015

1.2

Mar 29, 2015

1.1

Mar 4, 2015

1.0

Apr 9, 2014

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mt-940-4.12.1.tar.gz (20.4 kB view details)

Uploaded May 11, 2018 Source

Built Distribution

mt_940-4.12.1-py2.py3-none-any.whl (20.7 kB view details)

Uploaded May 11, 2018 Python 2 Python 3

File details

Details for the file mt-940-4.12.1.tar.gz.

File metadata

Download URL: mt-940-4.12.1.tar.gz
Upload date: May 11, 2018
Size: 20.4 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for mt-940-4.12.1.tar.gz
Algorithm	Hash digest
SHA256	`6994d59379b77230c0c14fb061a88bf9f72d93be833c955858fb05160fe6f8c2`
MD5	`9388d855687f40d89052e0b9288b1ec9`
BLAKE2b-256	`d1bc16292c6822240b5004ad9583aa3d95143043c63becff08d03c282f5881bc`

See more details on using hashes here.

File details

Details for the file mt_940-4.12.1-py2.py3-none-any.whl.

File metadata

Download URL: mt_940-4.12.1-py2.py3-none-any.whl
Upload date: May 11, 2018
Size: 20.7 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No

File hashes

Hashes for mt_940-4.12.1-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`a7a6b4ba78a9b449d2726678e1f10d0b16490cad42b1c44b759fd3cc8914aca8`
MD5	`421da1082f9d4767c28e455c53dfa2b4`
BLAKE2b-256	`4e47fd1e308511d0e7cf2b457a941b399a0faa3a346b2d0aa733cf485688204f`