A library to parse MT940 files and returns smart Python collections for statistics and manipulation.
Project description
mt940 - A library to parse MT940 files and returns smart Python collections for statistics and manipulation.
Links
- Documentation
- Bug reports
- Package homepage
- My blog
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('mt940_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('mt940_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('mt940_tests/jejik/abnamro.sta')
print(json.dumps(transactions, indent=4, cls=mt940.JSONEncoder))
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 mt940_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 |
|
Source |
|
Documentation |
|
Changelog |
|
API |
|
Issues/roadmap |
|
Travis |
|
Test coverage |
|
Pypi |
|
Ohloh |
|
License |
BSD. |
git repo |
|
install dev |
|
tests |
|
Changelog
v4.18.0 renamed tests to mt940_tests to fix #78 v4.18.0
v4.16.0 improved non-swift support for banks using different standards. Fixes #74 v4.16.0
v4.15.0 Including tests in package v4.15.0
v4.13.2 Fixed python 3 tests v4.13.2
v4.13.1 fixed windows bug when directly passing data. Fixes #68 v4.13.1
v4.13.0 Improved entry date handling and added workaround for banks using too much whitespace v4.13.0
v4.12.2 Relaxed regexes for Fiducia/Volksbank Ortenau thanks to @jahir v4.12.2
v4.11.0 Fixes #56: Transaction details parsing error if content is unfortunately wrapped v4.11.0
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mt-940-4.18.0.tar.gz.
File metadata
- Download URL: mt-940-4.18.0.tar.gz
- Upload date:
- Size: 64.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: Python-urllib/3.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e5b6469e9bc64522125efae1de0e557f76884c961f122028098533d6f2a98f23 |
|
| MD5 | 193567bf4131fd685107d146f9e32167 |
|
| BLAKE2b-256 | d0411bad4c6c8dcf78b8bd997ccc597b4e349ac8afdc71f0e5f4a7fa73cdae0e |
File details
Details for the file mt_940-4.18.0-py2.py3-none-any.whl.
File metadata
- Download URL: mt_940-4.18.0-py2.py3-none-any.whl
- Upload date:
- Size: 278.9 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: Python-urllib/3.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b782e62bb3740bb15ca45771d4a27d0242a7980be595096bfc01bb4ed7479639 |
|
| MD5 | 14f06fb1e57f7cb29dc980f1f3d7386e |
|
| BLAKE2b-256 | a941942b7b29740c14a4579019038f4ce5ecbc6e81cd4a427ef944272b65b6a1 |
