Package: endid
Endid Python and Command-line clientNOTE: This package is effectively archived because the Endid.app service has now become a
native GitHub / Slack integration allowing you to monitor GitHub Actions in Slack with
zero YAML to manage! SeeEndid.appfor the latest details.Command-line utility and Python client for calling theEndid Slack appto announce that a task has ended!Endid.app is a simpler more flexible webhook - an informal Slack integration for developers and data scientists.Find yourself constantly checking terminals, notebooks, or web apps waiting to see if your dev tasks have finished?Endid supplies a single token for any Slack channel. You can use Endid's simple API or command-line utility to let you know when any process has completed.You can mute notifications temporarily right within Slack.InstallationTo install both Python and Command-line clients:pip install endidEndid will install no other dependencies at all.UsageBoth clients store last-used tokens and messages on your system, so subsequently calling the bare-bones client with no token will still reach Slack.Once Endid is installed in Slack, go to any channel (or message history with Endid app bot) and type/endid. You will receive a token such as 7c710a188f874520be1f7ab7815c6cd1 which you would use in the examples below.Command LineSupply the token as an argument so a simple message ('Your task has ended!') appears in the Slack channel:endid -t 7c710a188f874520be1f7ab7815c6cd1Next time, just call endid to reuse the same token and Slack channel:endidSupply a custom message (to the saved channel/token):endid -t 7c710a188f874520be1f7ab7815c6cd1 -m 'Here is a message'For more command-line options runendid -hFrom Python codeFrom your Python code, for example in a Jupyter notebook:import endid
endid.call(token='7c710a188f874520be1f7ab7815c6cd1')To use the same token as last time (whether from Python or Command-line):import endid
endid.call()Extra arguments:message- a custom message to display in the Slack channel.status- a status for the event OK | WARN | FAIL | NONE.name- any string to act as an identifier for the event source.writeprefs- whether to write token/message to the preferences file so they can become defaults next time (default=True)readprefs- whether to read token/message from the preferences file (default=True)printoutput- whether to print any success or error messages to the screen (default=False)The call function returns anOKresponse from the API if everything goes to plan, and error messages if not.GitHub ActionsWe have a ready-madeGitHub Actionto easily send a Slack message via Endid.The great thing is being able to mute notifications right from the Slack channel if they get a bit much, or
to avoid disturbing colleagues while you develop your workflows.Installation TroubleshootingThe installation instructions assume you havepipon your system. This is usually the case for modern Windows and Mac.
If not, you caninstall pipfirst.Alternatively, downloadthis file, rename it toendidand place it somewhere in your path. Make it executable too.If you are using virtualenvs for Python development,pip install endidmay attempt to install it inside your active virtualenv - which will work fine as long as the virtualenv is active. To install 'globally'deactivatethe virtualenv first. If you then get a complaint that pip 'could not find an activated virtualenv', first set the
environment variable PIP_REQUIRE_VIRTUALENV=false.Please do not hesitate to raise aGitHub Issueon this repo, or contactsupport@endid.appto
resolve installation or usage issues on your system.