Source code for the PTG event scheduling bot
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Doug Hellmann 985dd4bd0b ignore local config file 3 years ago
html Fix bot name in rendered page 3 years ago
ptgbot Shut up now, ptgbot 3 years ago
.gitignore ignore local config file 3 years ago
.gitreview Fix .gitreview to match code repository 3 years ago
LICENSE Initial commit 3 years ago
README.rst Let room operators clean up themselves 3 years ago
config.json.sample Facilitate Ethercalc cells specification 3 years ago
requirements.txt List requests as a requirement 3 years ago
setup.cfg Initial commit 3 years ago
setup.py Initial commit 3 years ago
test-requirements.txt Initial commit 3 years ago
tox.ini Initial commit 3 years ago

README.rst

OpenStack PTG Bot

ptgbot is the bot that PTG room moderators use to surface what's currently happening at the event. Room operators send messages to the bot, like:

#swift now discussing ring balancing

and from that information the bot builds a static webpage with discussion topics currently discussed ("now") and an indicative set of discussion topics coming up next ("next"). It also merges information from the reservable rooms ethercalc in order to produce a single, static, mobile-friendly page.

Room operators commands

You have to have voice in the channel (+v) to send commands to the ptgbot. Commands follow the following format:

#ROOMNAME [now|next] TOPIC

Please note that:

  • There can only be one "now" topic at a time. If multiple topics are discussed at the same time in various corners of the room, they should all be specified in a single "now" command.
  • In order to ensure that information is current, entering a "now" command wipes out any "next" entry for the same room. You might want to refresh those after entering a "now" topic.

Example:

#swift now discussing ring placement
#swift next at 2pm we plan to discuss #glance support
#swift next around 3pm we plan to cover cold storage features
...
#swift now discussing #glance support, come over!
#swift next at 3pm we plan to cover cold storage features

You can also remove all entries related to your room by issuing the following command:

#ROOMNAME clean

Admin commands

You have to ve a channel operator (+o) to use admin commands.

~list

List available room names

~add ROOM [ROOM..]

Add new room name(s)

~del ROOM [ROOM..]

Deletes room name(s)

~clean ROOM [ROOM..]

Removes active entries for specified room(s)

~wipe

Resets the database entirely (removes all defined rooms and entries)

Local testing

Copy config.json.sample to config.json:

cp config.json.sample config.json

Edit config.json contents, for example:

{
"irc_nick": "ptgbot",
"irc_server": "irc.freenode.net",
"irc_port": 6667,
"irc_channel": "#testptg",
"db_filename": "html/ptg.json",
}

In one terminal, run the bot:

tox -evenv -- ptgbot -d config.json

Join that channel and give a command to the bot:

#swift now discussing ring placement

(note, the bot currently only takes commands from Freenode identified users)

In another terminal, start the webserver:

cd html && python -m SimpleHTTPServer

Open the web page in a web browser: http://127.0.0.1:8000/ptg.html