3
0
mirror of https://github.com/jlu5/PyLink.git synced 2024-12-28 05:32:51 +01:00
Go to file
2015-12-26 16:44:22 -08:00
docs/technical docs: add part of hooks-reference, mention topics and modes in protocol module spec, some more changes 2015-12-26 16:44:22 -08:00
log Make sure log/ exists 2015-07-18 20:13:53 -07:00
plugins Rename PYLINK_CLIENT_OPERED hook -> CLIENT_OPERED 2015-12-26 15:41:22 -08:00
protocols Rename PYLINK_CLIENT_OPERED hook -> CLIENT_OPERED 2015-12-26 15:41:22 -08:00
tests Unbrick the tests 2015-12-26 14:30:14 -08:00
.gitignore .gitignore: ignore .pem files 2015-08-10 20:26:10 -07:00
classes.py classes: log raw hook data for reference 2015-12-26 16:43:40 -08:00
conf.py Document more parts of the core - comments are cool right 2015-12-06 17:40:13 -08:00
config.yml.example Merge branch 'master' into devel 2015-12-24 18:25:39 -08:00
coreplugin.py Rename PYLINK_CLIENT_OPERED hook -> CLIENT_OPERED 2015-12-26 15:41:22 -08:00
kill.sh Add wrapper scripts (start-cpulimit.sh, kill.sh) to assist running PyLink under cpulimit 2015-07-25 16:58:11 -07:00
LICENSE Add a LICENSE: MPL 2.0 2015-06-20 21:10:50 -07:00
log.py Document more parts of the core - comments are cool right 2015-12-06 17:40:13 -08:00
pylink pylink: more consistent logging syntax 2015-12-24 18:08:00 -08:00
README.md README: formatting and minor content update 2015-12-24 19:52:33 -08:00
runtests.py runtests: allow specifying files to test 2015-09-12 22:31:19 -07:00
start-cpulimit.sh start-cpulimit: pass command line options to ./pylink 2015-09-25 20:25:07 -07:00
utils.py Yet another documentation refresh (#113) 2015-12-26 14:45:28 -08:00
world.py Test suite updates (doesn't work yet) 2015-12-24 18:24:42 -08:00

PyLink

PyLink is an extensible, plugin-based IRC services framework written in Python. It aims to be:

  1. a replacement for the now-defunct Janus.

  2. a versatile framework and gateway to IRC.

Support

PyLink is a work in progress and thus may be very unstable! No warranty is provided if this completely wrecks your network and causes widespread rioting amongst your users!

That said, please report any bugs you find to the issue tracker. Pull requests are open if youd like to contribute, though new stuff generally goes to the devel branch.

You can also find support via our IRC channel: #PyLink at irc.overdrivenetworks.com (webchat). Ask your questions and be patient for a response.

Dependencies

  • Python 3.4+
  • PyYAML (pip install pyyaml or apt-get install python3-yaml)
  • For the relay plugin: expiringdict (pip install expiringdict/apt-get install python3-expiringdict)

Supported IRCds

  • InspIRCd 2.0.x - module inspircd
  • charybdis (3.5.x / git master) - module ts6
  • Elemental-IRCd (6.6.x / git master) - module ts6
  • UnrealIRCd 4.x (experimental) - module unreal (NOT Unreal 3.2 or lower)

Setup

  1. Rename config.yml.example to config.yml and configure your instance there. Note that the configuration format isnt finalized yet - this means that your configuration may break in an update!

  2. Run ./pylink from the command line.

  3. Profit???