Need help with go-ircevent?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

thoj
430 Stars 99 Forks Other 279 Commits 7 Opened issues

Description

Event based IRC client library in Go (golang)

Services available

!
?

Need anything else?

Contributors list

No Data

Description

Event based irc client library.

Features

  • Event based. Register Callbacks for the events you need to handle.
  • Handles basic irc demands for you
    • Standard CTCP
    • Reconnections on errors
    • Detect stoned servers

Install

$ go get github.com/thoj/go-ircevent

Example

See examples/simple/simple.go and irc_test.go

Events for callbacks

  • 001 Welcome
  • PING
  • CTCP Unknown CTCP
  • CTCP_VERSION Version request (Handled internaly)
  • CTCP_USERINFO
  • CTCP_CLIENTINFO
  • CTCP_TIME
  • CTCP_PING
  • CTCP_ACTION (/me)
  • PRIVMSG
  • MODE
  • JOIN

+Many more

AddCallback Example

ircobj.AddCallback("PRIVMSG", func(event *irc.Event) {
    //event.Message() contains the message
    //event.Nick Contains the sender
    //event.Arguments[0] Contains the channel
});

Please note: Callbacks are run in the main thread. If a callback needs a long time to execute please run it in a new thread.

Example:

    ircobj.AddCallback("PRIVMSG", func(event *irc.Event) {
    go func(event *irc.Event) {
                    //event.Message() contains the message
                    //event.Nick Contains the sender
                    //event.Arguments[0] Contains the channel
    }(event)
    });

Commands

ircobj := irc.IRC("", "") //Create new ircobj
//Set options
ircobj.UseTLS = true //default is false
//ircobj.TLSOptions //set ssl options
ircobj.Password = "[server password]"
//Commands
ircobj.Connect("irc.someserver.com:6667") //Connect to server
ircobj.SendRaw("") //sends string to server. Adds \r\n
ircobj.SendRawf("", ...) //sends formatted string to server.n
ircobj.Join(" [password]") 
ircobj.Nick("newnick") 
ircobj.Privmsg("", "msg") // sends a message to either a certain nick or a channel
ircobj.Privmsgf(, "", ...)
ircobj.Notice("", "msg")
ircobj.Noticef("", "", ...)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.