wiki-postbot/README.md

2.7 KiB

wiki-postbot

Bot to crosspost from chat clients and microblogs using an extended wikilink syntax to the (media)wiki.

eg. say Hey what up i'm [[wikilinkin]] in slack, and embed that message with a backlink on the wikilinkin page.

Sorry for the extremely crappy docs and code structure y'all, this was supposed to be an internal tool for like 5 different projects, so i have done nothing yet to make it readable or reusable. the best way to understand this package for now would probably be to work backwards from the script entrypoints (see https://git.jon-e.net/jonny/wiki-postbot/src/branch/main/pyproject.toml#L11 ).

this is not a model directed project, since it hasn't been intended to outlive the immediate circumstances each time, but it ends up doing so anyway.

discord entrypoint is this: https://git.jon-e.net/jonny/wiki-postbot/src/branch/main/wiki_postbot/clients/discord.py

main thing it does is transcribe messages onto wiki pages, this is the parser for those: https://git.jon-e.net/jonny/wiki-postbot/src/branch/main/wiki_postbot/patterns/wikilink.py

it was designed to have a little microsyntax for selecting n-back post ranges and handling semantic wikilinks contextually but i haven't been able to implement that on the client side yet.

wiki interface is here: https://git.jon-e.net/jonny/wiki-postbot/src/branch/main/wiki_postbot/interfaces/mediawiki.py

specifically incoming from discord here: b4fd7c2080/wiki_postbot/interfaces/mediawiki.py (L164)

so ideally that would, yno, have a data model that it juices things into, so i'm going to work those scraps into an n-to-m bridger that i was experimenting with a lil service version of here: https://git.jon-e.net/jonny/chatbridge

Mediawiki

https://www.mediawiki.org/wiki/Manual:Creating_a_bot

  • Go to Special:BotPasswords
  • Permissions
    • Edit existing pages
    • Create, edit, and move pages
  • save to mediawiki_creds.json like
{
	"user": "Jonny@wikibot",
	"password": "<THE BOT PASSWORD>"
}

Slack

Using the python-slack-sdk https://slack.dev/python-slack-sdk/

Make App

https://slack.dev/python-slack-sdk/socket-mode/index.html