Skip to main content

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 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(output)

# Send Slack message to document model performance
perf = get_model_performance(output)
meerkat.slack(perf)

# Send SMS message when the script is finished
meerkat.sms("Script completed!")

Jupyter Notebook Example

import meerkat

# Ping when cell hits a debug checkpoint
%ping

# Send a confirmation that a cell has run
output = build_model()
%email output

# Send Slack message to document model performance
perf = get_model_performance(output)
%slack perf

# 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 "Firmware build completed."
$ meerkat slack "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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meerkatio-1.11.tar.gz (63.4 kB view hashes)

Uploaded Source

Built Distribution

meerkatio-1.11-py3-none-any.whl (49.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page