mirror of
				https://github.com/Mikaela/Limnoria.git
				synced 2025-11-04 01:27:21 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			53 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			53 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
EVERYONE:
 | 
						|
---------
 | 
						|
Read LICENSE.  It's a 2-clause BSD license, but you should read it anyway.
 | 
						|
 | 
						|
 | 
						|
USERS:
 | 
						|
------
 | 
						|
First, you gotta have Python 2.3 for this.  That's alright, though,
 | 
						|
because Python 2.3 rocks, and you should have it anyway :)
 | 
						|
 | 
						|
Assuming "python" is in your path and points to Python 2.3 or newer,
 | 
						|
then you need to run this:
 | 
						|
 | 
						|
python setup.py install
 | 
						|
 | 
						|
from the untarred directory to install the source files.  Then just
 | 
						|
run supybot-wizard (it's been installed in your path somewhere) to
 | 
						|
create a script that will run your bot as you answered the questions
 | 
						|
in the wizard.
 | 
						|
 | 
						|
If you have any trouble, feel free to swing by #supybot on
 | 
						|
irc.freenode.net or irc.oftc.net (we have a supybot there relaying, so
 | 
						|
either network works) and ask questions.  We'll be happy to help
 | 
						|
wherever we can.  And by all means, if you find anything hard to
 | 
						|
understand or think you know of a better way to do something, *please*
 | 
						|
post it on Sourceforge.net so we can improve the bot!
 | 
						|
 | 
						|
If you want, try out the included default botscripts.  Just be sure to
 | 
						|
actually add an owner user for yourself with supybot-adduser.  (An
 | 
						|
"owner user" is simply one with the owner capability).
 | 
						|
 | 
						|
WINDOWS USERS:
 | 
						|
--------------
 | 
						|
The wizards (supybot-wizard, supybot-newplugin, and
 | 
						|
supybot-adduser) are all installed to your Python directory's
 | 
						|
\Scripts.  What that *probably* means is that you'll run them like
 | 
						|
this: C:\Python23\python C:\Python23\Scripts\supybot-wizard
 | 
						|
 | 
						|
 | 
						|
DEVELOPERS:
 | 
						|
-----------
 | 
						|
Read OVERVIEW to see what the modules are used for.  Read EXAMPLE to see some
 | 
						|
examples of callbacks and command written for the bot.  Read STYLE if you ever
 | 
						|
wish to contribute.
 | 
						|
 | 
						|
Use PyLint.  It's even better than PyChecker.  A sample .pylintrc file
 | 
						|
is included as tools/pylintrc.  Copy this to ~/.pylintrc and you'll be
 | 
						|
able to check your code with the same stringent guidelines I've found
 | 
						|
useful to check my code. (deja vu? :))
 | 
						|
 | 
						|
If you run the tests on Windows (or on a modem connection), be sure to 
 | 
						|
exclude (test\test.py -e) test\test_Debian.py.  
 |