slacktory 1.0.5

Simple Slack interface

Slacktory

A decorator which is called using:

@slacktory.watch('the text to watch for')

...that watches a specified Slack channel for new Slack message posts whose ['text'] value is equivalent to the provided string argument

Requires Python 3.7

Installation

pip install slacktory

For this decorator to work, you must first create a Slack App

Then create a local_settings.py file in your project's root directory with the following content:

name = '<your Slack channel name>'
channel = '<your Slack channel id>'
token = '<your Slack API token>'
webhook = '<your Slack channel webhook>'

---

All of the above information can be obtained when setting up your Slack App

Usage example

>>> import slacktory
>>> @slacktory.watch('do the thing') # the decorator 
>>> def the_thing():

        # do something here...

In the above example, the_thing() will be called once the @slacktory.watch decorator has detected the text 'do the thing' in a new Slack message in the Slack channel (specified in local_settings.py).

Release History

• 1.0.0
  • first release
• 1.0.1
  • minor README changes
• 1.0.2
  • minor README changes
• 1.0.3
  • use nonlocal variables to remove the need for a recursive call on decorated function
  • remove polling, add while True
• 1.0.4
  • Add try/except with error message for import local_settings
  • Add license copy
• 1.0.5
  • add exception handling

Meta

James Coleman – [e-mail]

Distributed under the MIT license. See LICENSE for more information.

gitlab.com/jamescoleman/slacktory

Contributing

1. Fork it (https://gitlab.com/j9mes/slacktory/forks/new)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request