girc is a flexible IRC library for Go

Features

• Focuses on simplicity, yet tries to still be flexible
• Only requires standard packages
• Event based triggering/responses
• Documentation is mostly on par
• At this time, expect breaking changes to occur frequently.

TODO

• User and Channel should support methods which return events:
  • User.Reply(), User.Replyf()
  • User.Message(), User.Messagef()
  • User.Who(), etc
• implement CTCP callbacks. something like CTCP_VERSION, etc
• ensure types User and Channel don't have any unexported fields, and that when they are given publically, it's not a pointer to internal state
• track with NAMES as well? would require rewrite of user existance logic, could also help track user modes
• write more function-specific examples as the api becomes much more stable
• would be cool to track things like SERVERNAME, VERSION, UMODES, CMODES, etc. also see Config.DisableCapTracking. e.g. here
• client should support ping tracking (sending PING's to the server)
  • with this, we can potentially find lag. Client.Lag() would be useful
• users need to be exposed in state somehow (other than GetChannels())
• User.Age()? (FirstActive()?) (time since first seen)
• MODE tracking on a per-channel basis
• Client.AddTmpCallback() for one time use callbacks?

Installing

$ go get -u github.com/lrstanley/girc

Examples

See the examples within the documentation for real-world usecases.

Contributing

Below are a few guidelines if you would like to contribute. Keep the code clean, standardized, and much of the quality should match Golang's standard library and common idioms.

• Always test using the latest Go version.
• Always use gofmt before committing anything.
• Always have proper documentation before committing.
• Keep the same whitespacing, documentation, and newline format as the rest of the project.
• Only use 3rd party libraries if necessary. If only a small portion of the library is needed, simply rewrite it within the library to prevent useless imports.
• Also see golang/go/wiki/CodeReviewComments

License

The MIT License (MIT); Copyright (c) Liam Stanley <me@liamstanley.io>