{"id":22307976,"url":"https://github.com/akretion/python-cfonb","last_synced_at":"2025-07-29T05:32:22.131Z","repository":{"id":7903324,"uuid":"9284537","full_name":"akretion/python-cfonb","owner":"akretion","description":"Python librairy for reading/writing document enforcing the CFONB norm","archived":false,"fork":false,"pushed_at":"2020-07-10T09:46:38.000Z","size":58,"stargazers_count":2,"open_issues_count":4,"forks_count":16,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-17T09:31:31.135Z","etag":null,"topics":["cfonb"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akretion.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"COPYING.LESSER","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-07T22:46:42.000Z","updated_at":"2023-09-19T15:21:59.000Z","dependencies_parsed_at":"2022-08-29T08:11:15.476Z","dependency_job_id":null,"html_url":"https://github.com/akretion/python-cfonb","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/akretion/python-cfonb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akretion%2Fpython-cfonb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akretion%2Fpython-cfonb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akretion%2Fpython-cfonb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akretion%2Fpython-cfonb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akretion","download_url":"https://codeload.github.com/akretion/python-cfonb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akretion%2Fpython-cfonb/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267633670,"owners_count":24118777,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfonb"],"created_at":"2024-12-03T20:12:42.758Z","updated_at":"2025-07-29T05:32:21.777Z","avatar_url":"https://github.com/akretion.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Python-CFONB\n============\n\nIntroduction\n------------\n\nThe `CFONB \u003chttp://fr.wikipedia.org/wiki/CFONB\u003e`_ format is an old file format\nfor banking interchange, made by the CFONB (Comité français d'organisation et\nde normalisation bancaires). It is still used today to retrieve bank statements\nor make transfer orders. The specifications of the format can be found on the `CFONB website \u003chttp://www.cfonb.org\u003e`_.\n\n`python-cfonb` is a pure Python lib to read or write CFONB files, distributed under the LGPL license:\n\n- import method should read file-like object (with IOString or real plain text file)\n- export method to export Python object in CFO file\n- format checker according bank specification: special char, mandatory fields, etc.\n\nThe first two usecase are : read bank statements, and make transfer orders\n\nStatement Parser\n----------------\n\nYou can read a statement like this::\n\n    \u003e\u003e\u003e from os.path import join\n    \u003e\u003e\u003e statement_file = open(join('cfonb', 'tests', 'bank_statement.cfo'))\n    \u003e\u003e\u003e from cfonb import StatementReader\n    \u003e\u003e\u003e reader = StatementReader()\n    \u003e\u003e\u003e result = reader.parse(statement_file)\n    \u003e\u003e\u003e statement = result[0]\n\nThe statement has a header and a footer, which are both statement rows::\n\n    \u003e\u003e\u003e statement.header\n    \u003ccfonb.parser.common.Row object at ...\u003e\n    \u003e\u003e\u003e statement.footer\n    \u003ccfonb.parser.common.Row object at ...\u003e\n\nA row can be read as a list::\n\n    \u003e\u003e\u003e statement.header.as_list()\n    ['01', '30002', '    ', '00447', ...]\n\nOr as a dict::\n\n    \u003e\u003e\u003e statement.header.as_dict()\n    {'bank_code': '30002', 'nb_of_dec': ' ', '_5': ...}\n\nOr as an object::\n\n    \u003e\u003e\u003e header = statement.header.as_obj()\n    \u003e\u003e\u003e header.bank_code\n    '30002'\n\nThe statement lines between the header and the footer can be iterated::\n\n    \u003e\u003e\u003e # TODO: use an interator, and hide the parse_amount in the object\n    \u003e\u003e\u003e from cfonb.parser.common import parse_amount\n    \u003e\u003e\u003e for line in statement.lines:\n    ...     l = line.as_obj()\n    ...     print parse_amount(l.amount, l.nb_of_dec)\n    -2000.0\n    -1000.0\n    4000.0\n    -3000.0\n\n\nTransfer Writer\n---------------\n\nPrepare the contents::\n\n    \u003e\u003e\u003e from datetime import datetime\n    \u003e\u003e\u003e from cfonb.writer.transfert import Transfert\n    \u003e\u003e\u003e transfert = Transfert()\n    \u003e\u003e\u003e transfert.setEmeteurInfos('2000121','bigbrother','virement de test',503103,2313033,1212,datetime(2011,11,27))\n    \u003ccfonb.writer.transfert.Transfert instance at ...\u003e\n    \u003e\u003e\u003e transfert.add('un test','littlebrother','credit agricole ile de france',50011,6565329000,100,'un peu d\\'argent',6335)\n    \u003ccfonb.writer.transfert.Transfert instance at ...\u003e\n    \u003e\u003e\u003e content = transfert.render()\n\nYou can use a filename with render method::\n\n    \u003e\u003e\u003e transfert.render(filename='./virement.cfonb')\n    \"0302        200012      ...\"\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakretion%2Fpython-cfonb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakretion%2Fpython-cfonb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakretion%2Fpython-cfonb/lists"}