Initial commit

.gitignore

@@ -0,0 +1,2 @@
+*.secret
+log.txt

Readme.md

@@ -0,0 +1,41 @@
+# Roboto por esperanta vortaro
+
+("_Robot for an Esperanto dictionary_")
+
+This is a Mastodon bot that posts entries from a [English-Esparanto dictionary](http://www.gutenberg.org/ebooks/16967). It is hosted [@vortaro@botsin.space](https://botsin.space/@vortaro), and uses the [Mastodon.py](https://github.com/halcy/Mastodon.py) Python wrapper.
+
+This is my first bot for either Twitter or Mastodon, and my first python program in a long time. It's not perfect, but it works.
+
+## Source
+
+The bot takes its wordlist from the utf-8 version of the above-linked dictionary, editing out the section headings and other elements that do not fit the pattern "<English> = <Esperanto>.", e.g:
+
+> Bed (river) = kuŝujo.
+
+A handful of words I'd rather not have appear are removed, along with the first entry which for posterity reads:
+
+> A = indefinite article, not used in Esperanto.
+
+This is a very important feature of the language! It just doesn't fit the formulae I use.
+
+## Usage
+
+Obviuosly you're more likely to use this to make your own bot, but supposing you were going to deploy an exact copy this is what you would do:
+
+1. Make an account on [botsin.space](https://botsin.space), or another Mastodon instance. Mark it as a bot and do all the other profile things.
+2. Under Settings->Development create a new application, give it a name etc, leave the permissions as they are, and submit.
+3. Clone this repository onto whatever computer you want to run the app.
+    * If the account you made is not on botsin.space, edit `bot.py` to change the `api_base_url` to the URL of your instance.
+4. Using pip, download the Mastodon.py API interface. For example, `pip3 install --user Mastodon.py`.
+5. Back on the website, find the application you created under Settings->Development->Your Applications, and copy its access token into a file named `vortaro.secret` in the same directory as `bot.py` _etc_.
+6. Run your app with `python3 bot.py`, or equivalent. If all is successful it will print to `stdout` as well as tooting.
+
+## cron
+
+I run the bot via `cron`. Remember: if you have a line like
+
+```
+0 * * * * /usr/bin/python3 /home/petra/vortaro/bot.py
+```
+
+in your crontab, it's not going to run the bot in the right directory to find the files it needs; instead it will fail silently. Personally I use a wrapper script that `cd`s into the directory.

bot.py

@@ -0,0 +1,44 @@
+#! /usr/bin/python3
+import random
+from mastodon import Mastodon
+
+dformats = [
+		"English: \'{}.\'\nEsperanto: \'{}\'",
+		"English: \'{}.\'\nEsperanto: \'{}\'",
+		"English: \'{}.\'\nEsperanto: \'{}\'",
+		"English: \'{}.\'\nEsperanto: \'{}\'",
+		"English: \'{}.\'\nEsperanto: \'{}\'",
+		"Instead of \'{}\', try saying \'{}\'",
+		"The Esperanto for \'{}\' is \'{}\'",
+		"The Esperanto for \'{}\' is \'{}\'",
+		"The Esperanto for \'{}\' is \'{}\'",
+		"{} = {}",
+		"{} = {}",
+		"Esperanto: \'{1}\'\nEnglish: \'{0}.\'"
+	]
+
+with open("wl.txt", encoding="utf-8-sig") as f:
+    content = f.readlines()
+
+wl = [x.strip() for x in content]
+
+l = len(wl)
+dl = len(dformats)
+r = random.randint(0, l - 1)
+dr = random.randint(0, dl - 1)
+
+wpair = wl[r].split(" = ")
+eng = wpair[0]
+esp = wpair[1].capitalize()
+
+fstr = dformats[dr]
+tstr = fstr.format(eng, esp)
+print(tstr)
+
+
+mastodon = Mastodon(
+    access_token = "vortaro.secret",
+    api_base_url = "https://botsin.space"
+)
+
+mastodon.toot(tstr)