harvard-lil/lefttoright

Provides a suggested order for members of a channel doing a virtual standup

LeftToRight

Provides a suggested order for members of a channel doing a virtual standup. It grabs a list of members in the channel from which the slash command was called, and returns them in a randomized list, sometimes after having applied some fun text transformations.

You'll need a slackbot with the following scopes/permissions added:

channels:read
chat:write
commands
users:read

In your environment (shell, etc.) you'll need these variables set:

export LTR_SLACK_API_TOKEN='xoxb-[etc.]' # your slack bot API token which slack uses to validate requests coming from your app
export LTR_LOCAL_TOKEN='somerandomsecret' # your locally set token which this app uses to validate requests coming from slack

You'll also need:

• to invite your bot to any private channel you'd want to use it from
• a slash command set up to point to the public URL of wherever you've got it deployed, plus your locally-set app token passed to the token argument. For example, if you had your token set to yay and app being served from http://deployed.wow/ltr/, this would yield a successful query: http://deployed.wow/ltr/?token=yay

In the command itself, you can specify a transformation by passing leet, shifted, nicknames, or one of the other functions registered in transformations.py — or no transformation by passing normal. Without specifying, the command follows the default behavior of choosing a random transformation half the time.

If you're doing development on this application, use poetry to manage Python packages, but make sure to run

poetry export -o requirements.txt

for deployment purposes, if there are any changes to poetry.lock.

If you want to add transformations, you can put them in transformations.py and decorate them with @register.

The few doctests present so far can be exercised by running poetry run pytest.