IRCv3 Parse

A blazingly fast, zero-copy IRC v3 message parser

Documentation

Notice: Each component parses first special character and follows the rule. If you want to use it strictly, use validation of each component.

• Tags: Start with @, separated by ; and followed by a (space)
• Source: Start with :, format name!user@example.com or example.com and followed by a (space)
• Command: No prefix, must be letters or 3-digit number
• Middle Parameters: Start with (space), separated by spaces
• Trailing Parameters: Start with : (space + colon), can contain any text

Installation

[dependencies]
ircv3_parse = "2"

Quick Start

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let message = ircv3_parse::parse("PRIVMSG #channel :Hello everyone!")?;

    assert_eq!("PRIVMSG", message.command().as_str());
    assert_eq!("#channel", message.params().middles.first().unwrap());
    assert_eq!("Hello everyone!", message.params().trailing.as_str());

    Ok(())
}

Features

• serde - Serialization support for all types(deserialization not supported)

no_std Support

Requires an allocator (uses alloc crate for String and Vec).

License

Licensed under either of:

• Apache License, Version 2.0
• MIT license