Struct async_circe::Client

pub struct Client { /* fields omitted */ }

An IRC client

Implementations

impl Client

pub async fn new(config: Config) -> Result<Self, Error>

Creates a new client with a given Config.

Example

let mut client = Client::new(config).await?;

Errors

Returns error if the client could not connect to the host.

Panics

Panics if the client can’t connect to the given host.

pub async fn identify(&mut self) -> Result<(), Error>

Identify user and joins the in the Config specified channels.

Example

client.identify().await?;

Errors

Returns error if the client could not write to the stream.

pub async fn read(&mut self) -> Result<Option<Command>, Error>

Read data coming from the IRC as a commands::Command.

Example

loop {
   if let Some(ref command) = client.read().await? {
       if let commands::Command::PRIVMSG(nick, channel, message) = command {
           println!("{} in {}: {}", nick, channel, message);
       }
   }
}

Errors

Returns IO errors from the TcpStream.

pub async fn admin(&mut self, target: &str) -> Result<(), Error>

Request information about the admin of a given server.

Example

client.admin("libera.chat").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn away(&mut self, message: &str) -> Result<(), Error>

Set the status of the client.

Example

client.away("afk").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn invite(
    &mut self,
    username: &str,
    channel: &str
) -> Result<(), Error>

Invite someone to a channel.

Example

client.invite("liblemonirc", "#async-circe").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn join(&mut self, channel: &str) -> Result<(), Error>

Join a channel.

Example

client.join("#chaos").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn list(
    &mut self,
    channel: Option<&str>,
    server: Option<&str>
) -> Result<(), Error>

List available channels on an IRC, or users in a channel.

Example

client.list(None, None).await?;

Errors

Returns IO errors from the TcpStream.

pub async fn mode(
    &mut self,
    target: &str,
    mode: Option<&str>
) -> Result<(), Error>

Set the mode for a user.

Example

client.mode("test", Some("+B")).await?;

Errors

Returns IO errors from the TcpStream.

pub async fn names(
    &mut self,
    channel: &str,
    server: Option<&str>
) -> Result<(), Error>

Get all the people online in channels.

Example

client.names("#chaos,#async-circe", None).await?;

Errors

Returns IO errors from the TcpStream.

pub async fn nick(&mut self, nickname: &str) -> Result<(), Error>

Change your nickname on a server.

Example

client.nick("Not async-circe").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn oper(
    &mut self,
    username: &str,
    password: &str
) -> Result<(), Error>

Authentificate as an operator on a server.

Example

client.oper("username", "password").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn part(&mut self, channel: &str) -> Result<(), Error>

Leave a channel.

Example

client.part("#chaos").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn ping(
    &mut self,
    server1: &str,
    server2: Option<&str>
) -> Result<(), Error>

Tests the presence of a connection to a server.

Example

client.ping("libera.chat", None).await?;

Errors

Returns IO errors from the TcpStream.

pub async fn privmsg(
    &mut self,
    channel: &str,
    message: &str
) -> Result<(), Error>

Send a message to a channel.

Example

client.privmsg("#chaos", "Hello").await?;

Errors

Returns IO errors from the TcpStream.

pub async fn quit(&mut self, message: Option<&str>) -> Result<(), Error>

Leave the IRC server you are connected to.

Example

client.quit(None).await?;

Errors

Returns IO errors from the TcpStream.

pub async fn topic(
    &mut self,
    channel: &str,
    topic: Option<&str>
) -> Result<(), Error>

Get the topic of a channel.

Example

client.topic("#chaos", None).await?;

Set the topic of a channel.

Example

client.topic("#chaos", Some("CHAOS")).await?;

Errors

Returns IO errors from the TcpStream.