The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

pwb - a shell interface to your MediaWiki::Bot

SYNOPSIS

pwb [ --norc ] [ --verbose --debug ]

DESCRIPTION

pwb (which stands for PerlWikiBot) is the default entrance to MediaWiki::Bot::Shell, which provides a shell interface to your MediaWiki::Bot (a Perl framework for writing bots to interface with MediaWiki wikis).

See MediaWiki::Bot::Shell, or run help in the shell, for information on the available commands.

OPTIONS

--verbose, --debug

Sets the verbosity level. Currently, only on or off, but in the future, providing this option once will give only error messages, while giving it twice will provide more detailed non-error output.

--norc

Skips reading ~/.perlwikibot-shell.rc, and prompts for the same data instead.

FILES

~/.perlwikibot-shell.rc holds login details. The format is simple:

    username = My username          # Your username
    password = totallysecure        # You guessed it!
    host     = meta.wikimedia.org   # Where to log in
    do_sul   = no                   # Whether to do SUL login (takes a bit longer)

By specifying protocol, host, and path, you can use the secure server:

    ...
    protocol = https
    host     = secure.wikimedia.org
    path     = wikipedia/meta/w
    do_sul   = no                   # No need for SUL when using the secure server

If the --norc option is used, or the file doesn't exist or isn't readable, the user will be prompted for this information.

SEE ALSO

MediaWiki::Bot::Shell, MediaWiki::Bot and the admin plugin.

BUGS

Yes.

AUTHOR

Mike.lifeguard <mike.lifeguard@gmail.com>

COPYING

Copyright (C) 2010 by Mike.lifeguard.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.