Matt Weller 95ebc2a2e4 add functionality to replace printout urls with imgur mirrors in qdb submissions		10 年之前
docs	a9c3442525 rename functions intended to be used by class callers from with underscores to without, so sphinx docs catches them	10 年之前
modules	95ebc2a2e4 add functionality to replace printout urls with imgur mirrors in qdb submissions	10 年之前
tests	0ca55f360c misc. core fixes. includes:	10 年之前
.gitignore	5c323a799f add *.db to gitignore	10 年之前
.travis.yml	7e612b701c disable irc notifications	10 年之前
CHANGES	5341af6dbd update CHANGES and version.py	10 年之前
Makefile	5341af6dbd update CHANGES and version.py	10 年之前
README.md	08928f9bb8 fix up readme a tiny bit	10 年之前
Vagrantfile	3e44c8e9f9 Automate development environment configuration	10 年之前
bootstrap.sh	3e44c8e9f9 Automate development environment configuration	10 年之前
bot.py	0ad4715e34 small bugfixes	10 年之前
botbrain.py	a9c3442525 rename functions intended to be used by class callers from with underscores to without, so sphinx docs catches them	10 年之前
conf.py	a9c3442525 rename functions intended to be used by class callers from with underscores to without, so sphinx docs catches them	10 年之前
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 年之前
confman.py	b4c0a16948 fix bug where bot would try to connect to __pybot_conf and fail to pull values for that network from teh conf	10 年之前
db.py	c77c2af3c1 works on windows 7 (obviously with python installed) with minimal changes. huh. cool.	10 年之前
event.py	3e9b72bade grumble	10 年之前
index.rst	e2315aac1d add source link in index.rst	10 年之前
lite.py	a9c3442525 rename functions intended to be used by class callers from with underscores to without, so sphinx docs catches them	10 年之前
logger.py	97c100bc01 add permission (ish) check to logger.py	10 年之前
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 年之前
pybotrc	24cef71530 add sqlite functionality. fixes #3, after a long, long time	10 年之前
requirements.txt	95ebc2a2e4 add functionality to replace printout urls with imgur mirrors in qdb submissions	10 年之前
setup.sh	3d1a70facb add setup.sh and modify README to tell people to use it	10 年之前
stats.py	5951643a37 begin work on stats, i guess, and fix a few typos in webwriter. remove extraneous print from botbrain, too	11 年之前
ubuntu.sh	f6de3aaa5e rollback import changes and re-add ubuntu.sh script	10 年之前
util.py	065e982eab working on reload function for snippets	10 年之前
version.py	5341af6dbd update CHANGES and version.py	10 年之前
webwriter.py	24cef71530 add sqlite functionality. fixes #3, after a long, long time	10 年之前

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, on both windows and linux. python versions > 3 are in the works.

(Now probably more than) 10-second TL;DR:

Take care of dependencies. If you don't use MySQL and don't care about twitter posting or reddit info, you don't need anything but python 2.6 or 2.7 and standard libs.

libmysqlclient-dev (aka mysql-python in pip)
requests
praw (for reddit info module)
mysql-python (if you do use mysql)
sphinx (for docs)
python-twitter (twitterposter)

Local Development (with sqlite3)

Copy pybotrc to the user who will run the bot (you can probably do cp pybotrc ~/.pybotrc)
Modify ~/.pybotrc with your network, owner, and nickname.
./bot.py
laugh at mysql guys.
continue laughing.
for debugging purposes, ./bot.py -d.

Local Development (with MySQL)

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. mysql -p < mysql_init
./bot.py pybotrc
rejoice.
for debugging purposes, ./bot.py -d.

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.

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.

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.

README.md