33 lines
1.5 KiB
Markdown
33 lines
1.5 KiB
Markdown
# irc [](https://travis-ci.org/aatxe/irc) [](https://crates.io/crates/irc) #
|
|
A thread-safe IRC library in Rust. The client portion is compliant with
|
|
[RFC 2812](http://tools.ietf.org/html/rfc2812), [IRCv3.1](http://ircv3.net/irc/3.1.html),
|
|
[IRCv3.2](http://ircv3.net/irc/3.2.html), and includes some additional, common features. The server
|
|
portion is still a work in progress. You can find up-to-date, ready-to-use documentation online
|
|
[here](http://aatxe.github.io/irc/irc/). The documentation is generated with the default features.
|
|
These are, however, strictly optional and can be disabled accordingly.
|
|
|
|
## Getting Started ##
|
|
|
|
To start using this library with cargo, you can simply add `irc = "*"` to your dependencies to your
|
|
Cargo.toml file. You'll likely want to take a look at some of the examples, as well as the
|
|
documentation. You'll also be able to find a small template to get a feel for the library.
|
|
|
|
## Getting Started with Bots ##
|
|
|
|
```rust
|
|
extern crate irc;
|
|
|
|
use irc::client::prelude::*;
|
|
|
|
fn main() {
|
|
let server = IrcServer::new("config.json").unwrap();
|
|
server.identify().unwrap();
|
|
for message in server.iter() {
|
|
// Do message processing.
|
|
}
|
|
}
|
|
```
|
|
|
|
## Contributing ##
|
|
Contributions to this library would be immensely appreciated. It should be noted that as this is a
|
|
public domain project, any contributions will thus be released into the public domain as well.
|