go-ircevent

Event based IRC client library in Go (golang)

Go to file

Thomas Jager be3afcc796 Merge branch 'master' of git://github.com/lye/cleanirc Conflicts: irc.go irc_callback.go irc_struct.go Merge Interesting changes from fork		2012-11-06 00:38:20 +01:00
src/irc	Merge back fork. Update readme.	2012-11-05 23:39:38 +01:00
irc_callback.go	Merge branch 'master' of git://github.com/lye/cleanirc	2012-11-06 00:38:20 +01:00
irc_struct.go	Merge branch 'master' of git://github.com/lye/cleanirc	2012-11-06 00:38:20 +01:00
irc_test.go	go get not working quite as i thought	2012-11-05 23:46:47 +01:00
irc.go	Merge branch 'master' of git://github.com/lye/cleanirc	2012-11-06 00:38:20 +01:00
LICENSE	LICENSE, Same as go itself.	2009-11-18 16:03:14 +01:00
README.markdown	Cleanup old files	2012-11-05 23:41:04 +01:00

README.markdown

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 test/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
PRIVMSG
MODE
JOIN

+Many more

AddCallback Example

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

Commands

irc.IRC("<nick>", "<user>") //Create new ircobj
ircobj.Password = "[server password]"
ircobj.Connect("irc.someserver.com:6667") //Connect to server
ircobj.Sendraw("<string>") //sends string to server. Adds \r\n
ircobj.Join("#channel [password]") 
ircobj.Privmsg("#channel", "msg")
ircobj.Privmsg("nickname", "msg")
ircobj.Notice("<nickname | #channel>", "msg")