Metadata-Version: 2.1
Name: prestige-irc
Version: 0.0.1
Summary: A simple API for IRC networks
Home-page: https://github.com/avahe-kellenberger/prestige_irc
Author: Avahe Kellenberger
Author-email: avahe@protonmail.ch
License: UNKNOWN
Description: # prestige_irc
        
        This module is a simple API for IRC networks.
        
        ## Installation
        
        Clone this repository into your repo, and install `setup.py`:
        
        ```python
        git clone https://github.com/avahe-kellenberger/prestige_irc.git
        cd prestige_irc
        python setup.py install
        ```
        You should now be able to import modules, e.g. `from prestige_irc.commands import Commands`
        
        ## Creating a connection
        
        Initialize a connection to an IRC network by creating a new `IRCConnection`, and invoking the `connect` function.
        
        ```python
        irc_connection = IRCConnection("YourBotsNick")
        irc_connection.connect(ip_address="irc.freenode.net")
        ```
        
        ## Listeners:
        
        Add message listeners to the `IRCConnection` object.
        
        ```python
        def receive(msg):
            if msg.command == Commands.PRIVMSG:
                print(msg.text)
        
        listener = MessageListener(message_filter=lambda msg: True, receive=receive)
        irc_connection.add_listener(listener)
        ```
        
        Attach a listener for server messages, and add filters for said message objects.
        Filters are invoked by `irc.MessageListener#accept`, which is automatically called when an `IRCConnection` receieves a message.
        When this method returns true, `irc.MessageListener#receive` is invoked.
        
        See the code documentation for details.
        
        ## Sending Messages:
        
        Most commands are supported by the API by default, and are placed in `IRCConnection`.
        Commands are prefixed with `cmd_`, such as `cmd_privmsg`, `cmd_join`, and `cmd_kick`.
        
        These preset commands will handle the message formatting that the IRC server requires, with documentation reflecting the RFC.
        Commands that are not yet supported by default can be sent manually with `IRCConnection.send_command` and/or `IRCConnection.send`. 
          
        ## Speculative Updates:
          In the future, this module may support every RFC specified IRC command, but it's not likely. 
          This is a side project for personal use and probably will not be extended in functionality 
          once it meets my requirements.
         
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
