Prefect tasks and subflows for interacting with Slack
Project description
prefect-slack
Welcome!
prefect-slack
is a collections of prebuilt Prefect tasks that can be used to quickly construct Prefect flows.
Getting Started
Python setup
Requires an installation of Python 3.7+
We recommend using a Python virtual environment manager such as pipenv, conda or virtualenv.
These tasks are designed to work with Prefect 2.0. For more information about how to use Prefect, please refer to the Prefect documentation.
Installation
Install prefect-slack
pip install prefect-slack
Slack setup
In order to use tasks in the collection, you'll first need to create an Slack app and install it in your Slack workspace. You can create a Slack app by navigating to the apps page for your Slack account and selecting 'Create New App'.
For tasks that require a Bot user OAuth token, you can get a token for your app by navigating to your apps OAuth & Permissions page.
For tasks that require and Webhook URL, you get generate new Webhook URLs by navigating to you apps Incoming Webhooks page.
Slack's Basic app setup guide provides additional details on setting up a Slack app.
Write and run a flow
from prefect import flow
from prefect.context import get_run_context
from prefect_slack import SlackCredentials
from prefect_slack.messages import send_chat_message
@flow
def example_send_message_flow():
context = get_run_context()
# Run other tasks and subflows here
token = "xoxb-your-bot-token-here"
send_chat_message(
slack_credentials=SlackCredentials(token),
channel="#prefect",
text=f"Flow run {context.flow_run.name} completed :tada:"
)
example_send_message_flow()
Resources
If you encounter and bugs while using prefect-slack
, feel free to open an issue in the prefect-slack repository.
If you have any questions or issues while using prefect-slack
, you can find help in either the Prefect Discourse forum or the Prefect Slack community
Development
If you'd like to install a version of prefect-slack
for development, first clone the repository and then perform an editable install with pip
:
git clone https://github.com/PrefectHQ/prefect-slack.git
cd prefect-slack/
pip install -e ".[dev]"
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
Hashes for prefect_slack-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e9653b1ab8889030ef9cd39db68b190511b195a15c0edbdd16e3913b1cc6249 |
|
MD5 | 1a90abc43c067ab988f4d03d1161ad66 |
|
BLAKE2b-256 | e584352f0fd9e2927734624a4654aed25177b008f22b43cd59865f45c769e596 |