Skip to content

A Internet Relay Chat (IRC) protocol implementation for SwiftNIO

License

Notifications You must be signed in to change notification settings

SwiftNIOExtras/swift-nio-irc

Repository files navigation

SwiftNIO IRC

Swift5 iOS macOS tuxOS

SwiftNIO-IRC is a Internet Relay Chat protocol implementation for SwiftNIO.

This module contains just the protocol implementation. We also provide:

To get started with this, pull swift-nio-irc-server - a module to rule them all and in the darkness bind them.

NIOIRC is a SwiftNIO port of the Noze.io miniirc example from 2016.

Importing the module using Swift Package Manager

An example Package.swift importing the necessary modules:

// swift-tools-version:5.0

import PackageDescription

let package = Package(
    name: "IRCTests",
    dependencies: [
        .package(url: "https://github.com/SwiftNIOExtras/swift-nio-irc.git",
                 from: "0.6.0")
    ],
    targets: [
        .target(name: "MyProtocolTool",
                dependencies: [ "NIOIRC" ])
    ]
)

Using the SwiftNIO IRC protocol handler

The IRC protocol is implemented as a regular ChannelHandler, similar to NIOHTTP1. It takes incoming ByteBuffer data, parses that, and emits IRCMessage items. Same the other way around, the user writes IRCReply objects, and the handler renders such into ByteBuffers.

To add the IRC handler to a NIO Channel pipeline:

import NIOIRC

bootstrap.channelInitializer { channel in
    channel.pipeline
        .add(handler: IRCChannelHandler())
        .then { ... }
}

Who

Brought to you by ZeeZide. We like feedback, GitHub stars, cool contract work, presumably any form of praise you can think of.

About

A Internet Relay Chat (IRC) protocol implementation for SwiftNIO

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages