| Name | gnucash-asx-fetch JSON |
| Version |
1.6
JSON |
| download |
| home_page | |
| Summary | Utility to fetch and add current ASX prices to one or more gnucash XML files |
| upload_time | 2024-03-13 04:12:09 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.6 |
| license | GPLv3 |
| keywords |
gnucash
finance-quote
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
## GNUCASH-ASX-FETCH
[](https://pypi.org/project/gnucash-asx-fetch/)
[](https://aur.archlinux.org/packages/gnucash-asx-fetch/)
This is a command line utility to fetch and update
[ASX](https://asx.com.au) share prices to one or more
[GnuCash](https://www.gnucash.org/) XML files. It takes multiple path
arguments: one of more GnuCash files, or directories. If a directory is
given then it updates all the GnuCash files in that directory. It can
not update any GnuCash files that are currently open so will generate an
error message for those files. A new price entry is added for each ASX
share existing in the file each time you run it. Open the GnuCash price
database editor for a file to view, edit, or remove the new entries
added.
For example, to update the share prices of all the ASX shares in all the
GnuCash files in the current directory type:
```
$ gnucash-asx-fetch .
```
:warning: This utility overwrites your GnuCash file[s] so be sure to save
copies at least the first time you try using it.
Note it only updates GnuCash XML files, not GnuCash sqlite files. It
silently skips GnuCash backup and log files.
This utility should work on any modern Linux platform and has been
developed against GnuCash v4.4.
See the latest documentation and code at
https://github.com/bulletmark/gnucash-asx-fetch.
## MOTIVATION
GnuCash uses the [Finance::Quote](https://github.com/finance-quote)
module to update share prices but I have found it fragile over the short
time I have been using GnuCash. E.g. At the time I created this utility,
ASX price fetches via [Finance::Quote](https://github.com/finance-quote)
have not worked for more than 3 months as per [this
bug](https://github.com/finance-quote/finance-quote/issues/166).
Fetching prices from [ASX](https://asx.com.au) is actually quite easy
and this utility uses a simple approach. By merely requiring the user to
not have the file open at the time the prices are updated, it can avoid
the awkward interface with
[Finance::Quote](https://github.com/finance-quote) and GnuCash
completely, and merely write directly to the XML file.
If you like this utility then you may be interested in [another
utility](https://github.com/bulletmark/gnucash-select) I created to
facilitate working with multiple GnuCash files.
## USAGE
Type `gnucash-asx-fetch -h` to view the usage summary:
```
usage: gnucash-asx-fetch [-h] [-i] [-q] [-d] path [path ...]
Utility to fetch and add current ASX share prices to one or more gnucash XML
files.
positional arguments:
path directories or files to update
options:
-h, --help show this help message and exit
-i, --ignore-open silently ignore any files currently open
-q, --quiet suppress message output
-d, --dry-run do not update any file[s]
```
## INSTALLATION
Arch Linux users can install [gnucash-asx-fetch from the
AUR](https://aur.archlinux.org/packages/gnucash-asx-fetch/).
Python 3.6 or later is required. Note [gnucash-asx-fetch is on
PyPI](https://pypi.org/project/gnucash-asx-fetch/) so just ensure that
[`pipx`](https://pypa.github.io/pipx/) is installed then type the
following:
```
$ pipx install gnucash-asx-fetch
```
To upgrade:
```
$ pipx upgrade gnucash-asx-fetch
```
## LICENSE
Copyright (C) 2020 Mark Blakeney. This program is distributed under the
terms of the GNU General Public 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 3 of the License, or any later
version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License at <http://www.gnu.org/licenses/> for more details.
Raw data
{
"_id": null,
"home_page": "",
"name": "gnucash-asx-fetch",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "gnucash,finance-quote",
"author": "",
"author_email": "Mark Blakeney <mark.blakeney@bullet-systems.net>",
"download_url": "https://files.pythonhosted.org/packages/12/eb/3546612f447eb03fcc990c2b99a7aea8c37fd60720da6b45353e0a92c3b2/gnucash-asx-fetch-1.6.tar.gz",
"platform": null,
"description": "## GNUCASH-ASX-FETCH\n[](https://pypi.org/project/gnucash-asx-fetch/)\n[](https://aur.archlinux.org/packages/gnucash-asx-fetch/)\n\nThis is a command line utility to fetch and update\n[ASX](https://asx.com.au) share prices to one or more\n[GnuCash](https://www.gnucash.org/) XML files. It takes multiple path\narguments: one of more GnuCash files, or directories. If a directory is\ngiven then it updates all the GnuCash files in that directory. It can\nnot update any GnuCash files that are currently open so will generate an\nerror message for those files. A new price entry is added for each ASX\nshare existing in the file each time you run it. Open the GnuCash price\ndatabase editor for a file to view, edit, or remove the new entries\nadded.\n\nFor example, to update the share prices of all the ASX shares in all the\nGnuCash files in the current directory type:\n\n```\n$ gnucash-asx-fetch .\n```\n\n:warning: This utility overwrites your GnuCash file[s] so be sure to save\ncopies at least the first time you try using it.\n\nNote it only updates GnuCash XML files, not GnuCash sqlite files. It\nsilently skips GnuCash backup and log files.\nThis utility should work on any modern Linux platform and has been\ndeveloped against GnuCash v4.4.\n\nSee the latest documentation and code at\nhttps://github.com/bulletmark/gnucash-asx-fetch.\n\n## MOTIVATION\n\nGnuCash uses the [Finance::Quote](https://github.com/finance-quote)\nmodule to update share prices but I have found it fragile over the short\ntime I have been using GnuCash. E.g. At the time I created this utility,\nASX price fetches via [Finance::Quote](https://github.com/finance-quote)\nhave not worked for more than 3 months as per [this\nbug](https://github.com/finance-quote/finance-quote/issues/166).\n\nFetching prices from [ASX](https://asx.com.au) is actually quite easy\nand this utility uses a simple approach. By merely requiring the user to\nnot have the file open at the time the prices are updated, it can avoid\nthe awkward interface with\n[Finance::Quote](https://github.com/finance-quote) and GnuCash\ncompletely, and merely write directly to the XML file.\n\nIf you like this utility then you may be interested in [another\nutility](https://github.com/bulletmark/gnucash-select) I created to\nfacilitate working with multiple GnuCash files.\n\n## USAGE\n\nType `gnucash-asx-fetch -h` to view the usage summary:\n\n```\nusage: gnucash-asx-fetch [-h] [-i] [-q] [-d] path [path ...]\n\nUtility to fetch and add current ASX share prices to one or more gnucash XML\nfiles.\n\npositional arguments:\n path directories or files to update\n\noptions:\n -h, --help show this help message and exit\n -i, --ignore-open silently ignore any files currently open\n -q, --quiet suppress message output\n -d, --dry-run do not update any file[s]\n```\n\n## INSTALLATION\n\nArch Linux users can install [gnucash-asx-fetch from the\nAUR](https://aur.archlinux.org/packages/gnucash-asx-fetch/).\n\nPython 3.6 or later is required. Note [gnucash-asx-fetch is on\nPyPI](https://pypi.org/project/gnucash-asx-fetch/) so just ensure that\n[`pipx`](https://pypa.github.io/pipx/) is installed then type the\nfollowing:\n\n```\n$ pipx install gnucash-asx-fetch\n```\n\nTo upgrade:\n\n```\n$ pipx upgrade gnucash-asx-fetch\n```\n\n## LICENSE\n\nCopyright (C) 2020 Mark Blakeney. This program is distributed under the\nterms of the GNU General Public License.\nThis program is free software: you can redistribute it and/or modify it\nunder the terms of the GNU General Public License as published by the\nFree Software Foundation, either version 3 of the License, or any later\nversion.\nThis program is distributed in the hope that it will be useful, but\nWITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General\nPublic License at <http://www.gnu.org/licenses/> for more details.\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Utility to fetch and add current ASX prices to one or more gnucash XML files",
"version": "1.6",
"project_urls": {
"Homepage": "https://github.com/bulletmark/gnucash-asx-fetch"
},
"split_keywords": [
"gnucash",
"finance-quote"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2f014619f8a3b48905c35817a169e4d636d7133ab5aaaab2ae9c0600ad9d2586",
"md5": "acc4c2afb3d94d8e15928ef343b582c2",
"sha256": "80ea43340fd87a43db694ff629e45db512e7a9db13b30b2c991f87c958f0cd67"
},
"downloads": -1,
"filename": "gnucash_asx_fetch-1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "acc4c2afb3d94d8e15928ef343b582c2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5184,
"upload_time": "2024-03-13T04:12:08",
"upload_time_iso_8601": "2024-03-13T04:12:08.039449Z",
"url": "https://files.pythonhosted.org/packages/2f/01/4619f8a3b48905c35817a169e4d636d7133ab5aaaab2ae9c0600ad9d2586/gnucash_asx_fetch-1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "12eb3546612f447eb03fcc990c2b99a7aea8c37fd60720da6b45353e0a92c3b2",
"md5": "1600316bd51f488b4164f8af3b9a2e9c",
"sha256": "18d1fa89e0c4a43a677f77fabf6ea0512f340b1a2929048df439fe202f6256df"
},
"downloads": -1,
"filename": "gnucash-asx-fetch-1.6.tar.gz",
"has_sig": false,
"md5_digest": "1600316bd51f488b4164f8af3b9a2e9c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5427,
"upload_time": "2024-03-13T04:12:09",
"upload_time_iso_8601": "2024-03-13T04:12:09.793067Z",
"url": "https://files.pythonhosted.org/packages/12/eb/3546612f447eb03fcc990c2b99a7aea8c37fd60720da6b45353e0a92c3b2/gnucash-asx-fetch-1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-13 04:12:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bulletmark",
"github_project": "gnucash-asx-fetch",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "gnucash-asx-fetch"
}
