Skip to main content

piecash

https://github.com/gorf/piecash-community/actions/workflows/github-actions.yml/badge.svg https://readthedocs.org/projects/piecash/badge/?version=master https://img.shields.io/pypi/v/piecash.svg https://img.shields.io/pypi/pyversions/piecash.svg https://img.shields.io/pypi/dd/piecash.svg

Piecash provides a simple and pythonic interface to GnuCash files stored in SQL (sqlite3, Postgres and MySQL).

Documentation:

http://piecash.readthedocs.org.

Github:

https://github.com/gorf/piecash-community

PyPI:

https://pypi.python.org/pypi/piecash

It is a pure python package, tested on python 3.8 to 3.12, that can be used as an alternative to:

  • the official python bindings (as long as no advanced book modifications and/or engine calculations are needed). This is specially useful on Windows where the official python bindings may be tricky to install or if you want to work with python 3.

  • XML parsing/reading of XML GnuCash files if you prefer python over XML/XLST manipulations.

piecash test suite runs successfully on Windows and Linux on the three supported SQL backends (sqlite3, Postgres and MySQL). piecash has also been successfully run on Android (sqlite3 backend) thanks to Kivy buildozer and python-for-android.

It allows you to:

  • open existing GnuCash documents and access all objects within

  • modify objects or add new objects (accounts, transactions, prices, …)

  • create new GnuCash documents from scratch

Scripts are also available to:

A simple example of a piecash script:

with open_book("example.gnucash") as book:
    # get default currency of book
    print( book.default_currency )  # ==> Commodity<CURRENCY:EUR>

    # iterating over all splits in all books and print the transaction description:
    for acc in book.accounts:
        for sp in acc.splits:
            print(sp.transaction.description)

The project has reached beta stage.

Metadata

Release files for piecash 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for piecash 1.3.0
File Size Uploaded Provenance Actions
piecash-1.3.0.tar.gz 817.2 kB Without provenance Details for piecash-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for piecash 1.3.0
File Interpreter ABI Platform Actions
piecash-1.3.0-py3-none-any.whl Python 3 none any Details for piecash-1.3.0-py3-none-any.whl

Total release size: 897.0 kB

Release files / piecash-1.3.0.tar.gz

Download URL piecash-1.3.0.tar.gz
Size 817.2 kB
Tags Source
SHA-256 checksum
How to use checksums
916c73481c6b0addd3771dd468497ef6989b383b28d064bdae61590552b98490
BLAKE2b-256 checksum
How to use checksums
c8ec7a3bdf190e88c9f7fd86bb01b0012580c4c24515c39be2ee8fcbfc208b61
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Release files / piecash-1.3.0-py3-none-any.whl

Download URL piecash-1.3.0-py3-none-any.whl
Size 79.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
95860decb9a5989ec7d014d509726b5c5e8d372071735f539039bdc93f0229a2
BLAKE2b-256 checksum
How to use checksums
86114d1b9dbe991ca150c5f87e6288e9f858e39cc0f725142d10f692f69ac939
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Security for piecash 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page