https://github.com/doronbehar/units-openexchangerates
https://github.com/doronbehar/units-openexchangerates
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/doronbehar/units-openexchangerates
- Owner: doronbehar
- Created: 2018-03-04T19:35:31.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-15T06:38:26.000Z (almost 7 years ago)
- Last Synced: 2025-02-07T04:45:59.705Z (4 months ago)
- Language: Python
- Size: 11.7 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# A [GNU Units][gnu-units] compatible exchange rates currencies updater
If you have ever used [GNU units][gnu-units], you may have enjoyed it's very smooth user interface and command line arguments interpretation. `units` also provides exchange rates currency conversions. It does so by reading the file `currency.units` (usually located in `/usr/share/units/` in most distributions). The `units` program usually is distributed with a python script `units_cur` which updates the file `currency.units` with data from [https://finance.yahoo.com/](https://finance.yahoo.com/)'s free API.
The purpose of this script is to provide an alternative yet compatible currency units updater for GNU units using [https://openexchangerates.org](https://openexchangerates.org) (also free with registration) API. The advantages in using this script over the original `units_cur` are:
- More currencies including digital currencies as well: [https://docs.openexchangerates.org/docs/supported-currencies](https://docs.openexchangerates.org/docs/supported-currencies)
- Faster and more accurate exchange rates using base currencies according to [your choice](https://docs.openexchangerates.org/docs/set-base-currency#default-base-currency).
### Usage
```
usage: units_cur [-h] [-V] -k APIKEY [-a] [filename]
GNU units compatible currencies information updaterinto the specified filename or if no filename is given, the default: '/usr/share/units/currency.units'. The special filename '-' will send the currency data to
stdout.
positional arguments:
filename the file to update
optional arguments:
-h, --help show this help message and exit
-V, --version display units_cur version
-k APIKEY, --apikey APIKEY
API key to use when querying openexchangerates.org
-a, --alternative Add alternative unofficial, black market and digital currenciesas well
```
[gnu-units]: https://gnu.org/software/units