added installation instructions to README

added requests to needed libraries
This commit is contained in:
Michael Clemens 2021-06-02 09:33:25 +02:00
parent 41993577eb
commit 091feae555
3 changed files with 30 additions and 19 deletions

View File

@ -14,28 +14,38 @@ It does the following:
![screenshot](/screenshot.jpg?raw=true "screenshot") ![screenshot](/screenshot.jpg?raw=true "screenshot")
# Dependencies # Installation
qrzlogger needs the following libraries: qrzlogger needs Python 3 and the following libraries:
* xmltodict * xmltodict
* prettytable * prettytable
* colored * colored
* requests
These libraries can be installed with the following command:
```
# sudo pip install xmltodict prettytable colored
```
Furthermore, you need at least the XML subscription from QRZ.com. Furthermore, you need at least the XML subscription from QRZ.com.
# Installation Before installing qrzlogger, please make sure that pip, setuptools and wheel are installed and up-to-date:
* install via pip with "pip3 install qrzlogger" ```
* execute with "qrzlogger" # python3 -m pip install --upgrade pip setuptools wheel
* the application creates a default config file and states its location (_~/.qrzlogger.ini_) ```
* adapt _~/.qrzlogger.ini_ to your needs
Finally, install qrzlogger with pip:
```
# python3 -m pip install qrzlogger
```
# Usage
* execute the application with "qrzlogger"
* qrzlogger creates a default config file and states its location (e.g. _~/.qrzlogger.ini_)
* adapt _~/.qrzlogger.ini_ to your needs. Important setting are:
* station_call: This is your station call (must match with the QRZ.com logbook)
* api_key: Your QRZ.com API key. You find it under "settings" in the QRZ.com logbook'
* qrz_user: Your QRZ.com user name, typically your call sign'
* qrz_pass: Your QRZ.com password (not the API key)'
* execute the application again with "qrzlogger" * execute the application again with "qrzlogger"
# License # License

View File

@ -1,6 +1,6 @@
[metadata] [metadata]
name = qrzlogger name = qrzlogger
version = 0.6 version = 0.6.1
author = Michael Clemens author = Michael Clemens
author_email = qrzlogger@qrz.is author_email = qrzlogger@qrz.is
description = A python application to log QSOs directly to QRZ.com from the command line description = A python application to log QSOs directly to QRZ.com from the command line
@ -24,6 +24,7 @@ install_requires=
xmltodict xmltodict
prettytable prettytable
colored colored
requests
[options.packages.find] [options.packages.find]
where = src where = src

View File

@ -84,10 +84,10 @@ class QRZLogger():
else: else:
config = configparser.ConfigParser() config = configparser.ConfigParser()
config['qrz.com'] = { config['qrz.com'] = {
'station_call': 'MYCALL # Enter here your station call (must match with the QRZ.com logbook)', 'station_call': 'MYCALL',
'api_key': '1234-ABCD-1234-A1B2 # Enter here you API key. You find it under "settings" in the QRZ.com logbook', 'api_key': '1234-ABCD-1234-A1B2',
'qrz_user': 'N0CALL # Enter here you QRZ.com user name, typically your call sign', 'qrz_user': 'MYCALL',
'qrz_pass': 'q1w2e3r4t5z6u7i8o9 # Enter here you QRZ.com password (not the API key)', 'qrz_pass': 'my_secret_password',
'xml_fields': '("call", "band", "mode", "qso_date", "time_on", "rst_sent", "rst_rcvd", "comment")'} 'xml_fields': '("call", "band", "mode", "qso_date", "time_on", "rst_sent", "rst_rcvd", "comment")'}
config['log'] = { config['log'] = {
'log_file': '/tmp/qrzlogger.log'} 'log_file': '/tmp/qrzlogger.log'}
@ -479,7 +479,7 @@ class QRZLogger():
print(" __ _ _ _ __| |___ __ _ __ _ ___ _ _ ") print(" __ _ _ _ __| |___ __ _ __ _ ___ _ _ ")
print(" / _` | '_|_ / / _ \/ _` / _` / -_) '_|") print(" / _` | '_|_ / / _ \/ _` / _` / -_) '_|")
print(" \__, |_| /__|_\___/\__, \__, \___|_| ") print(" \__, |_| /__|_\___/\__, \__, \___|_| ")
print(" |_| DL6MHC |___/|___/ v0.6 " + style.RESET) print(" |_| DL6MHC |___/|___/ v0.6.1 " + style.RESET)