tekuila

Interface for querying your ISP download quota.

"Have you had to much to download?"

Versions

Works with python 2.7, 3.4, 3.5

Pull your ISP Quota and act on it.

Supported ISPs:

• TekSavvy
• Start.ca

To avoid using command line flags create a config file at:

~/.tekuila

Place the following variables within the config file:

API=<your API KEY from https://myaccount.teksavvy.com/ApiKey/ApiKeyManagement>
CAP=<your cap in GB>
WARN_RATIO=<ratio % to warn in 0.1 increments up to 1.0>

Installation

To install, run the following:

pip install tekuila

Or, if you wish to install the latest from source:

git clone https://github.com/mikeodr/tekuila
cd tekuila
python setup.py install

API Usage

ReadTheDocs.

Console Usage

Console command help:

tekuila -h
usage: tekuila [-h] [-c CONFIG] [--cap CAP] [--api API] [--warn WARN] [-v]
               [-s] [--version]

Check TekSavvy Cap

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Alternative config file
  --cap CAP             Your cap in GB, causes nonzero return code if exceeded
  --api API             API Key
  --warn WARN           Warn ratio against data cap, causes nonzero return
                        code if exceeded, in range 0.1 to 1.0
  -v, --verbose         Show output, don't just use return code
  -s, --startca         Use StartCA instead of TekSavvy API
  --version             show program's version number and exit

Pull Requests and Issues

Pull requests very much welcome. Check that it complies with pep8, please make sure the documentation builds.

Please use elementary commits vs big commits and try and have your commit messages be detailed. See Tim Pope's excellent Guide.

License

GPLv2