Skip to content

fyysikkokilta/vaalilakanabot

Repository files navigation

Vaalilakanabot

Telegram-botti, joka vaalien aikaan ylläpitää listausta ehdolle asettuneista henkilöistä ja ilmoittaa uusista postauksista killan Discourse-pohjaisella keskustelufoorumilla Φrumilla.

Ominaisuudet

  • Ilmoittaa chatteissa, joihin botti on lisätty, aina kun fiirumille on tullut uusi postaus
  • Botin admin-käyttäjä voi ylläpitää sähköistä vaalilakanaa
  • Jauhistelu

Käyttöönotto

  • asenna python-telegram-bot-kirjasto (versio >=12) ja muut tarvittavat kirjastot
  • lisää Bot Fatherilta saatava VAALILAKANABOT_TOKEN ympäristönmuuttujaksi käyttöjärjestelmään.
  • täydennä ADMIN_CHAT_ID koodiin (halutun ryhmän id:n saa esimerkiksi lisäämällä botin @RawDataBot haluttuun ryhmään)
  • Päivitä TOPIC_LIST_URL ja QUESTION_LIST_URL -muuttujat koodiin. Katso Discoursen dokumentaatio oikeanlaisen URL:n asettamiseksi.
  • $ python vaalilakanabot2019.py
  • lisää botti relevantteihin keskusteluryhmiin

Running the bot with Docker

  • create copies of the example_*.json files with such names that the "example_" part is removed.
  • create bot.env according to the example file bot.env.example
  • start the bot using provided update-deployment.sh script

Komennot

Botti tukee seuraavia komentoja:

  • /start Rekisteröi ryhmän botin tiedotuskanavaksi ja ryhmää saa botilta ilmoituksia.
  • /jauhis Näytää vaaliaiheisen kuvan.
  • /jauh Näytää vaaliaiheisen kuvan.
  • /lauh Näytää vaaliaiheisen kuvan.
  • /mauh Näytää vaaliaiheisen kuvan.
  • /lakana Näytää vaalien ehdokastilanteen.

Admin-chatissa seuraavat komennot ovat käytössä:

  • /lisaa Lisää ehdokkaan vaalilakanaan.
  • /lisaa_fiirumi Lisää ehdokkaan fiirumipostauksen vaalilakanaan.
  • /poista Poistaa ehdokkaan lakanasta.
  • /valittu Merkitsee vaalilakanassa ehdokkaan valituksi virkaan.
  • /tiedota Julkaisee uuden merkinnän vaalilakanassa.

Lisätietoa

Lisää telegram-boteista voi lukea esimerkiksi Kvantti I/19 s.22-25.

Botin tekivät Einari Tuukkanen ja Uula Ollila.