Matt Weller 146c880a6f Merge branch 'master' into modules/fixes		5 年之前
.vscode	d4b8be68b7 add settings.json (for vscode.. sigh)	6 年之前
docs	3d17959380 docs?	9 年之前
modules	146c880a6f Merge branch 'master' into modules/fixes	5 年之前
tests	9e1a6deb9f remove all the crazy config loading logic and positional requirements. replaced with argparse. airquotes bugfix release	9 年之前
.gitignore	ce5c39e898 some cleanup removing creds from code directly (thx SPHT)	8 年之前
.pylintrc	5d1c378b54 small updates, including pylintrc and some better error handling in choose. includes new module (pytz) in requirements.txt	5 年之前
.travis.yml	7e612b701c disable irc notifications	10 年之前
CHANGES	129baeca40 add to changes file	8 年之前
README.md	44c22be66b update readme	5 年之前
Vagrantfile	9273160e85 change vagrantfile to use ubuntu/trusty64	8 年之前
bootstrap.sh	3e44c8e9f9 Automate development environment configuration	10 年之前
bot.py	33bed902bf bot fix - finally remove called to nonexistent ERROR enumeration in logger class, update autoloads	5 年之前
botbrain.py	9db13c2e19 pulled .ftoc and .ctof out into their own modules and removed them from botbrain completely as they seemed more like a module function then a core bot function	5 年之前
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	40ca06cf58 cleanup in db, addition of jury module	7 年之前
event.py	9c33965c09 foo	9 年之前
lite.py	f033372635 add ability to run own CREATE TABLE for sqlite	8 年之前
logger.py	71efa36785 cleanup logger and bot's output to it, add logger output to reflect and snippetutil	9 年之前
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	070c1e86c2 fix testBase and add a test pybotrc (so your local one doesn't fuck up your tests)	9 年之前
pylintrc	33bed902bf bot fix - finally remove called to nonexistent ERROR enumeration in logger class, update autoloads	5 年之前
requirements.txt	5d1c378b54 small updates, including pylintrc and some better error handling in choose. includes new module (pytz) in requirements.txt	5 年之前
run.sh	2b732793c1 fix for youtube v2 api shutdown and an additional kanbo action	9 年之前
setup.sh	0c9bb83b39 add a bit more checking to setup.py, and asking if the user wants to use mysql. also fix the pretty date indenting	8 年之前
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	0c9bb83b39 add a bit more checking to setup.py, and asking if the user wants to use mysql. also fix the pretty date indenting	8 年之前
version.py	b63f1eaa91 ncrement version slightly since we've had some additional functionality added	8 年之前
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 (for network independence!), and configurable.

pybot runs on python 2.7, on both windows and linux. python versions > 3 are in the works.

master branch should be stable. feature branches can be broken at any time.

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

Take care of dependencies. If you don't use MySQL and don't care about certain modules breaking, you don't need anything but python 2.7 and standard libs.

sudo pip install -r requirements.txt

python-dev
libmysqlclient-dev (aka mysql-python in pip)
requests (used in a variety of modules)
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