3
0
mirror of https://github.com/jlu5/PyLink.git synced 2024-11-24 03:29:28 +01:00
Go to file
James Lu 994eaef12c unreal: forcibly SETHOST to the desired vHost in spawnClient
This prevents real host / IP address leaks, since the "virt host" specified in UID doesn't seem to be respected by the IRCd (real host is shown instead). Workaround for #136.
2015-11-26 22:34:15 -08:00
docs/technical coreplugin: sanity check: make sure irc.connected is set after 2 seconds & mention how setting this is neccessary in docs 2015-11-15 21:50:23 -08:00
log Make sure log/ exists 2015-07-18 20:13:53 -07:00
plugins relay: remove cloak from whitelisted umodes, send modes to spawnClient as a set (prevents duplicates) 2015-11-22 13:08:31 -08:00
protocols unreal: forcibly SETHOST to the desired vHost in spawnClient 2015-11-26 22:34:15 -08:00
tests world: rename command_hooks=>hooks, bot_commands=>commands 2015-09-27 10:53:25 -07:00
.gitignore .gitignore: ignore .pem files 2015-08-10 20:26:10 -07:00
classes.py classes: log offending hook data when a hook function errors 2015-11-08 10:56:09 -08:00
conf.py Don't crash when REHASH loads a config file that's invalid 2015-11-11 18:55:51 -08:00
config.yml.example Irc: require autoconnect value to be >= 1 2015-10-02 23:21:40 -07:00
coreplugin.py coreplugin: sanity check: make sure irc.connected is set after 2 seconds & mention how setting this is neccessary in docs 2015-11-15 21:50:23 -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 Support loading different config files from the command line 2015-08-03 19:27:19 -07:00
pylink core: Replace imp (deprecated) with importlib, reword some docs & remove unneeded imports 2015-11-22 20:14:47 -08:00
README.md README: mention (experimental) UnrealIRCd 4.0 support 2015-11-15 21:17:22 -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 core: Replace imp (deprecated) with importlib, reword some docs & remove unneeded imports 2015-11-22 20:14:47 -08:00
world.py core: Replace imp (deprecated) with importlib, reword some docs & remove unneeded imports 2015-11-22 20:14:47 -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.

Usage

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: note that master is bugfix only; new stuff goes to the devel branch.

You can also find support via our IRC channel: #PyLink at irc.overdrive.pw (webchat). Ask your question and be patient.

Dependencies

Dependencies currently include:

  • Python 3.4+
  • PyYAML (pip install pyyaml or apt-get install python3-yaml)
  • For the relay plugin only: 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???