MeerkatIO Documentation
Introduction
Welcome to the MeerkatIO documentation. MeerkatIO is a powerful command line interface (CLI) and Python module designed to help developers step away from their computer while their code is running.
Meerkat Python SDK
Installation
# PyPi
$ pip3 install meerkatio
Authenticating
After creating an account at MeerkatIO you will be given a unique token which can be used to authenticate with the SDK. Your Meerkat token can either be set in your environment with the MEERKAT_TOKEN environmental variable or in the ~/.meerkat file in your user’s home directory. No authentication is required to use the free Ping feature of MeerkatIO.
# Environment
$ export MEERKAT_TOKEN=token
# Cache File
$ echo "token" > ~/.meerkat
Code Example
import meerkat
# Ping when script gets to checkpoint
meerkat.ping()
# Send a confirmation a function has run
output = build_model()
meerkat.email(f"""
Send a multi-line email with the output of a function:
{output}
""")
# Send SMS message when the script is finished
%sms "Script completed!"
Jupyter Notebook Example
%load_ext meerkat
# Ping when cell hits a debug checkpoint
%ping
# Send a confirmation that a cell has run
output = build_model()
%email f"""
Send a multi-line email with the output of a function:
{output}
"""
# Send SMS message when the cell reaches the end
%sms "Cell completed!"
MeerkatIO CLI Tool
Installation
# PyPi
$ pip3 install meerkatio
Authenticating
After creating an account at MeerkatIO you can use the same account credentials to authenticate the CLI, giving you access to the full suite of MeerkatIO services. No authentication is required to use the free Ping feature of MeerkatIO.
$ meerkat login
CLI Examples
All users have access to the ping alert feature which will generate a sound when the below command is run.
$ meerkat ping
$ meerkat email "Bash script output: $1"
$ meerkat sms "Bash script complete"
Here is an example of how to use Meerkat with any script running from a terminal in order to ping youself when the script is finished running.
$ make build && meerkat email "Build succeeded" || meerkat sms "Build failed"
1 maintainer
Metadata
1 maintainer
Release files for meerkatio 1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| meerkatio-1.8.tar.gz | 63.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| meerkatio-1.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 112.7 kB
Release files / meerkatio-1.8.tar.gz
| Download URL | meerkatio-1.8.tar.gz |
|---|---|
| Size | 63.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1885ddf27c1274bca4d88d86071e937e9c0ad7f6d8b773d42e0a559fbb333793
|
|
BLAKE2b-256 checksum How to use checksums |
e5fd261dc958ee6d8a3e53b051c78ad8edcf248e7d4658a3e2c110f3ffe869e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.4
|
Release files / meerkatio-1.8-py3-none-any.whl
| Download URL | meerkatio-1.8-py3-none-any.whl |
|---|---|
| Size | 49.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
169f42decf729f026de94180483669de0ed484cc11939886c7b7d8d0e51c6791
|
|
BLAKE2b-256 checksum How to use checksums |
417f90cddb647cf723ce06cd57a4301e2bbb67bd9529b90d739282de37feab19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.4
|
