Ei kuvausta http://bits.zero9f9.com/pybot

Matt Weller 404d77b957 Merge branch 'master' into time_event		10 vuotta sitten
docs	7e5e679bb3 remove battlelog/bf3 doc stuff	10 vuotta sitten
modules	f1b69ecf7a make ready the dogs of war or something	10 vuotta sitten
tests	0ca55f360c misc. core fixes. includes:	10 vuotta sitten
.gitignore	f1b69ecf7a make ready the dogs of war or something	10 vuotta sitten
.travis.yml	89ebddf21e remove python 2.6 so it stops failing in steamapi	10 vuotta sitten
CHANGES	b8d6ed8666 v0.7.0	10 vuotta sitten
Makefile	1f032a41ad remove all teh old bf3 stuff	10 vuotta sitten
README.md	00aa19a83f add documentation link in readme	10 vuotta sitten
Vagrantfile	3e44c8e9f9 Automate development environment configuration	10 vuotta sitten
bootstrap.sh	3e44c8e9f9 Automate development environment configuration	10 vuotta sitten
bot.py	404d77b957 Merge branch 'master' into time_event	10 vuotta sitten
botbrain.py	1f032a41ad remove all teh old bf3 stuff	10 vuotta sitten
conf.py	faa14939f3 sphinx is ignoring my order to exclude :(	10 vuotta sitten
conferror.py	9945b98ebd create dev branch. work on confman, which is currently correctly parsing ~/.pybotrc and setting internal variables. add some try excepts on connecting to the socket	11 vuotta sitten
confman.py	74aa05bdf1 more docs\!	10 vuotta sitten
db.py	74aa05bdf1 more docs\!	10 vuotta sitten
event.py	8ca809afa7 fix some code formatting in event.py and remove extraneous debugging print in bot	10 vuotta sitten
index.rst	e2315aac1d add source link in index.rst	10 vuotta sitten
logger.py	fce0cceb5c fix python being mad that i didn't indent my comments	10 vuotta sitten
mysql_dump	85fac2f4d4 fix debug log output in bot.py, fix poor programming in nicklist (still not fully functional), fix mysql_dump missing a few tables.	10 vuotta sitten
pybotrc	109adb5804 initial commit of succeeding tests for confman and bot initialization	10 vuotta sitten
requirements.txt	b9f8754210 add triggering by user to event, add module to post to twitter upon certain events	10 vuotta sitten
setup.sh	3d1a70facb add setup.sh and modify README to tell people to use it	10 vuotta sitten
stats.py	5951643a37 begin work on stats, i guess, and fix a few typos in webwriter. remove extraneous print from botbrain, too	11 vuotta sitten
util.py	fce0cceb5c fix python being mad that i didn't indent my comments	10 vuotta sitten
version.py	76e6271954 centralize version string to version.py	10 vuotta sitten
webwriter.py	74aa05bdf1 more docs\!	10 vuotta sitten

ReadTheDocs documentation

pybot is a python irc bot. he is a project.

he is modular, extensible, multi-threaded, and configurable.

pybot runs on python 2.6 and 2.7 (though steamapi does not work with 2.6, the core bot does). python versions > 3 are in the works.

10-second TL;DR:

Local Development

modify pybotrc with your channels and passwords.
run sudo ./bootstrap.sh to install pybot dependencies such as mysql.
run ./setup.sh. It will check for module dependencies and create a mysql_init file.
./bot.py pybotrc
rejoice.
for debugging purposes, ./bot.py -d.

Vagrant Development

If you have Vagrant locally installed and configured, you can set up pybot by invoking vagrant up. Your development environment will be configured, and you can skip step 1 and 2 above. After that, SSH into your VM and do steps 3 through 5 to finish things off.

Environment Dependencies

pybot requires mysqldb. It's probably in your package manager. It will run without it, it'll just throw lots of exceptions. SQLite integration and no-db (pickle) support are in the works.

Automagic

Run ./bootstrap.sh and wait for your system to be configured. Mysql will be installed with a default password of 'root', which you'll definitely want to change.

Run ./setup.sh and follow the prompts. It will create a mysql_init file, which you can then run against mysql with mysql -p < mysql_init. This will create your database and add a user with full privileges on that database. Your bot will run as this user.

Put that information into the pybotrc. If you do not run ./setup.sh you will have to perform the step below.

Manual

Add a mysql user for pybot with permissions to update, insert, and delete from the created tables. Logged into mysql: grant all on <dbname>.* to '<username>' identified by '<password>';

Run the included mysql_dump file (as root, mysql -p <pybot's database name> < mysql_dump). Set his dbpass in the config file (pybotrc) to the password you've given him. Copy that config file to the home folder of whatever user will be running the bot. (~user/.pybotrc) As that user, ./bot.py.

Images & Explanation

Here pybot is connected to two networks at once. They are held entirely separately. Modules loaded on one are independent of modules loaded on another. If one server goes down, the other connections to other networks are unaffected.

This project uses smiley's steamapi for its steam integration, and PRAW (python reddit API wrapper) for the redditinfo module.

README.md