Ledger helpers (ledgerhelpers)
============================
This is a collection of small single-purpose programs to aid your accounting
with [Ledger](https://github.com/ledger/ledger) (ledger-cli). Think of it
as the batteries that were never included with Ledger.
Why should you use them? Because:
* All the ledgerhelpers have been designed with fast data entry in mind,
and they will remember or evoke existing data as needed, to help you minimize
typing and other drudgery.
* They all have launcher icons in your desktop environment -- this makes it
very easy to add icons or shortcuts for them, so you can run them on the spot.
This package also contains a library with common functions that you can use
in your project to make it easier to develop software compatible with Ledger.
What can you do with these programs
-----------------------------------
* Enter transactions easily with
[addtrans](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/addtrans).
* Update your price quotes with
[updateprices](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/updateprices).
* Record multi-currency ATM withdrawals with
[withdraw-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/withdraw-cli).
* Record FIFO stock or commodity sales with
[sellstock-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/sellstock-cli).
* Interactively clear transactions with
[cleartrans-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/cleartrans-cli).
* Keep your ledger chronologically sorted with
[sorttrans-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/sorttrans-cli).
Usage and manuals
-----------------
* [How to add transactions with `addtrans`](doc/addtrans.md)
See also individual [manual pages](man/) in NROFF format.
How to download and install
---------------------------
Here are instructions to install the very latest iteration of ledgerhelpers:
If you are on a Linux system and want to install it as an RPM package:
* Obtain the package with `git clone https://github.com/Rudd-O/ledgerhelpers`
* Change to the directory `cd ledgerhelpers`
* Create a source package with `python3 -m build --sdist`
* Create a source RPM with `rpmbuild --define "_srcrpmdir ./" --define "_sourcedir dist/" -bs *.spec`
* You may need to install some dependencies at this point. The process will tell you.
* Create an installable RPM with `rpmbuild --rebuild --nodeps --define "_rpmdir ./" *.src.rpm`
* You may need to install some dependencies at this point. The process will tell you.
* Install the package with `sudo rpm -Uvh noarch/*.noarch.rpm`
In other circumstances or Linux systems:
* Obtain the package with `git clone https://github.com/Rudd-O/ledgerhelpers`
* Change to the directory `cd ledgerhelpers`
* Create the source package directly with `python3 -m build --sdist`
* Install the package (to your user directory `~/.local`) with `pip3 install dist/*.tar.gz`
* This will install a number of dependencies for you. Your system should already
have the GTK+ 3 library and the Python GObject introspection library.
The programs in `bin/` can generally run from the source directory, provided
that the PYTHONPATH points to the `src/` folder inside the source directory,
but you still need to install the right dependencies, such as GTK+ 3 or later,
and the Python GObject introspection library.
License
-------
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
See [full license terms](LICENSE.txt).
Raw data
{
"_id": null,
"home_page": "https://github.com/Rudd-O/ledgerhelpers",
"name": "ledgerhelpers",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Manuel Amador (Rudd-O)",
"author_email": "rudd-o@rudd-o.com",
"download_url": "https://files.pythonhosted.org/packages/72/09/8ae009ed187fc66a69c40975dfb34fa39885acc18b5955549ab0cd78cfa9/ledgerhelpers-0.3.10.tar.gz",
"platform": null,
"description": "Ledger helpers (ledgerhelpers)\n============================\n\nThis is a collection of small single-purpose programs to aid your accounting\nwith [Ledger](https://github.com/ledger/ledger) (ledger-cli). Think of it\nas the batteries that were never included with Ledger.\n\nWhy should you use them? Because:\n\n\n* All the ledgerhelpers have been designed with fast data entry in mind,\n and they will remember or evoke existing data as needed, to help you minimize\n typing and other drudgery.\n* They all have launcher icons in your desktop environment -- this makes it\n very easy to add icons or shortcuts for them, so you can run them on the spot.\n\nThis package also contains a library with common functions that you can use\nin your project to make it easier to develop software compatible with Ledger.\n\nWhat can you do with these programs\n-----------------------------------\n\n* Enter transactions easily with\n [addtrans](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/addtrans).\n* Update your price quotes with\n [updateprices](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/updateprices).\n* Record multi-currency ATM withdrawals with\n [withdraw-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/withdraw-cli).\n* Record FIFO stock or commodity sales with\n [sellstock-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/sellstock-cli).\n* Interactively clear transactions with\n [cleartrans-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/cleartrans-cli).\n* Keep your ledger chronologically sorted with\n [sorttrans-cli](https://github.com/Rudd-O/ledgerhelpers/blob/master/bin/sorttrans-cli).\n\nUsage and manuals\n-----------------\n\n* [How to add transactions with `addtrans`](doc/addtrans.md)\n\nSee also individual [manual pages](man/) in NROFF format.\n\nHow to download and install\n---------------------------\n\nHere are instructions to install the very latest iteration of ledgerhelpers:\n\nIf you are on a Linux system and want to install it as an RPM package:\n\n* Obtain the package with `git clone https://github.com/Rudd-O/ledgerhelpers`\n* Change to the directory `cd ledgerhelpers`\n* Create a source package with `python3 -m build --sdist`\n* Create a source RPM with `rpmbuild --define \"_srcrpmdir ./\" --define \"_sourcedir dist/\" -bs *.spec`\n * You may need to install some dependencies at this point. The process will tell you.\n* Create an installable RPM with `rpmbuild --rebuild --nodeps --define \"_rpmdir ./\" *.src.rpm`\n * You may need to install some dependencies at this point. The process will tell you.\n* Install the package with `sudo rpm -Uvh noarch/*.noarch.rpm`\n\nIn other circumstances or Linux systems:\n\n* Obtain the package with `git clone https://github.com/Rudd-O/ledgerhelpers`\n* Change to the directory `cd ledgerhelpers`\n* Create the source package directly with `python3 -m build --sdist`\n* Install the package (to your user directory `~/.local`) with `pip3 install dist/*.tar.gz`\n * This will install a number of dependencies for you. Your system should already\n have the GTK+ 3 library and the Python GObject introspection library.\n\nThe programs in `bin/` can generally run from the source directory, provided\nthat the PYTHONPATH points to the `src/` folder inside the source directory,\nbut you still need to install the right dependencies, such as GTK+ 3 or later,\nand the Python GObject introspection library.\n\nLicense\n-------\n\nThis program is free software; you can redistribute it and/or modify it under\nthe terms of the GNU General Public License as published by the Free Software\nFoundation; either version 2 of the License, or (at your option) any later\nversion.\n\nSee [full license terms](LICENSE.txt).\n",
"bugtrack_url": null,
"license": "GPLv2+",
"summary": "A collection of helper programs and a helper library for Ledger (ledger-cli)",
"version": "0.3.10",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "4c24ff2b6ae36797d3716eb7c7831569",
"sha256": "8ad383f5aa07804704cc2a1f6748c3b311862c0f717068beaeaa24f51b48218f"
},
"downloads": -1,
"filename": "ledgerhelpers-0.3.10.tar.gz",
"has_sig": false,
"md5_digest": "4c24ff2b6ae36797d3716eb7c7831569",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 186566,
"upload_time": "2022-12-02T10:37:00",
"upload_time_iso_8601": "2022-12-02T10:37:00.561559Z",
"url": "https://files.pythonhosted.org/packages/72/09/8ae009ed187fc66a69c40975dfb34fa39885acc18b5955549ab0cd78cfa9/ledgerhelpers-0.3.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-02 10:37:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "Rudd-O",
"github_project": "ledgerhelpers",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "ledgerhelpers"
}
JSON
