Expand description
A MediaWiki Bot framework
mwbot
provides a batteries-included framework for building bots
for MediaWiki wikis. The goal is to provide a high-level API on top
of the mwapi and
parsoid crates.
Configuration
Create a mwbot.toml
file with the following structure:
api_url = "https://en.wikipedia.org/w/api.php"
rest_url = "https://en.wikipedia.org/api/rest_v1"
[auth]
username = "Example"
oauth2_token = "[...]"
See the documentation for how to get an OAuth 2 token. Using an owner-only consumer is the easiest way to do so.
You can alternatively use a BotPassword with:
[auth]
username = "Example"
password = "[...]"
Using Bot::from_default_config()
will look in the current directory
for mwbot.toml
before looking in the user’s config directory. A
custom path can be specified by using Bot::from_config(...)
.
Contributing
mwbot
is the flagship crate of the mwbot-rs
project.
We’re always looking for new contributors, please reach out
if you’re interested!
Re-exports
pub use parsoid;
Modules
Structs
Main bot class
Build a
mwbot::Bot
instance programmaticallyA
Page
represents a wiki page on a specific wiki (Bot
). You can get
metadata about a page, its contents (in HTML or wikitext) and edit the
page.Extra options for saving pages
Enums
Error class for config and setup
Primary error class