{"id":13557624,"url":"https://github.com/sdementen/piecash","last_synced_at":"2026-02-27T05:36:27.337Z","repository":{"id":23131263,"uuid":"26486077","full_name":"sdementen/piecash","owner":"sdementen","description":"Pythonic interface to GnuCash SQL documents","archived":false,"fork":false,"pushed_at":"2025-01-05T07:32:10.000Z","size":5175,"stargazers_count":304,"open_issues_count":34,"forks_count":76,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-08T09:16:21.585Z","etag":null,"topics":["bindings","finance","gnucash","piecash","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sdementen.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-11-11T13:27:51.000Z","updated_at":"2025-02-27T17:37:16.000Z","dependencies_parsed_at":"2024-01-14T16:11:09.049Z","dependency_job_id":"a3ec252a-2470-4eda-b527-5d4d2a6df46d","html_url":"https://github.com/sdementen/piecash","commit_stats":{"total_commits":907,"total_committers":27,"mean_commits":"33.592592592592595","dds":"0.13009922822491726","last_synced_commit":"ec30cf469198cccf35f7ba968f889d360cfe1824"},"previous_names":[],"tags_count":64,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdementen%2Fpiecash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdementen%2Fpiecash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdementen%2Fpiecash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdementen%2Fpiecash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdementen","download_url":"https://codeload.github.com/sdementen/piecash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247002136,"owners_count":20867406,"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","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":["bindings","finance","gnucash","piecash","python"],"created_at":"2024-08-01T12:04:27.349Z","updated_at":"2025-10-21T19:33:41.588Z","avatar_url":"https://github.com/sdementen.png","language":"Python","funding_links":[],"categories":["Python","finance"],"sub_categories":[],"readme":"piecash\n=======\n\n.. image:: https://badges.gitter.im/sdementen/piecash.svg\n   :alt: Join the chat at https://gitter.im/sdementen/piecash\n   :target: https://gitter.im/sdementen/piecash?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\n\n.. image:: https://github.com/sdementen/piecash/workflows/CI/badge.svg\n    :target: https://github.com/sdementen/piecash/actions\n\n.. image:: https://readthedocs.org/projects/piecash/badge/?version=master\n    :target: http://piecash.readthedocs.org\n\n.. image:: https://img.shields.io/pypi/v/piecash.svg\n    :target: https://pypi.python.org/pypi/piecash\n\n.. image:: https://img.shields.io/pypi/pyversions/piecash.svg\n    :target: https://pypi.python.org/pypi/piecash/\n\n.. image:: https://img.shields.io/pypi/dd/piecash.svg\n    :target: https://pypi.python.org/pypi/piecash/\n\n.. image:: https://coveralls.io/repos/sdementen/piecash/badge.svg?branch=master\u0026service=github\n    :target: https://coveralls.io/github/sdementen/piecash?branch=master\n\n\nPiecash provides a simple and pythonic interface to GnuCash files stored in SQL (sqlite3, Postgres and MySQL).\n\n:Documentation: http://piecash.readthedocs.org.\n:Gitter: https://gitter.im/sdementen/piecash\n:Github: https://github.com/sdementen/piecash\n:PyPI: https://pypi.python.org/pypi/piecash\n\n\nIt is a pure python package, tested on python 3.6 to 3.9, that can be used as an alternative to:\n\n- the official python bindings (as long as no advanced book modifications and/or engine calculations are needed).\n  This is specially useful on Windows where the official python bindings may be tricky to install or if you want to work with\n  python 3.\n- XML parsing/reading of XML GnuCash files if you prefer python over XML/XLST manipulations.\n\npiecash test suite runs successfully on Windows and Linux on the three supported SQL backends (sqlite3, Postgres and MySQL).\npiecash has also been successfully run on Android (sqlite3 backend) thanks to Kivy buildozer and python-for-android.\n\nIt allows you to:\n\n- open existing GnuCash documents and access all objects within\n- modify objects or add new objects (accounts, transactions, prices, ...)\n- create new GnuCash documents from scratch\n\nScripts are also available to:\n\n- export to ledger-cli format (http://www.ledger-cli.org/)\n- export to QIF format\n- import/export prices (CSV format)\n\nA simple example of a piecash script:\n\n.. code-block:: python\n\n    with open_book(\"example.gnucash\") as book:\n        # get default currency of book\n        print( book.default_currency )  # ==\u003e Commodity\u003cCURRENCY:EUR\u003e\n\n        # iterating over all splits in all books and print the transaction description:\n        for acc in book.accounts:\n            for sp in acc.splits:\n                print(sp.transaction.description)\n\nThe project has reached beta stage.\n\n.. important::\n\n   If you want to work with python 2.7/3.4 and books from gnucash 2.6.x series, you can use piecash 0.19.0.\n   Versions of piecash as of 1.0.0 supports python \u003e=3.6 and books from gnucash 3.0.x series.\n\n.. warning::\n\n   1) Always do a backup of your gnucash file/DB before using piecash.\n   2) Test first your script by opening your file in readonly mode (which is the default mode)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdementen%2Fpiecash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdementen%2Fpiecash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdementen%2Fpiecash/lists"}