Simple notification tool for multi-tasking developers
Project description
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 meerkat.io 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"
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file meerkatio-1.6.tar.gz
.
File metadata
- Download URL: meerkatio-1.6.tar.gz
- Upload date:
- Size: 63.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60e5479dab156790006af21fce883bbfca1150c3f28c4070da8c84033b6ffc7d |
|
MD5 | 802df06eb0210f60bd6d022081152394 |
|
BLAKE2b-256 | 2e45e64f1e1ffc1e1f793fff697a3e59980b9ec6daa648c2d080f34c73224f0c |
File details
Details for the file meerkatio-1.6-py3-none-any.whl
.
File metadata
- Download URL: meerkatio-1.6-py3-none-any.whl
- Upload date:
- Size: 50.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ad3d78c6bb968a026388c73f1adc2738f11ecbf6e550be55ddb8eb4198683c8c |
|
MD5 | d66ae07751703ebbf037ee9734389159 |
|
BLAKE2b-256 | 9b68593d9abafdddb3dfde726bfe9002c30cd82fcd3d087b211fab6c341258c5 |