You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chris Smith d7edf4f25d 0.2.0 5 years ago
gradle/wrapper Upgrade to Gradle 5.1.1, fix new deprecations 5 years ago
src README 5 years ago
.gitignore Make gradlew executable 5 years ago
CHANGELOG 0.2.0 5 years ago
LICENCE Licence 5 years ago
README.md README 5 years ago
build.gradle.kts 0.2.0 5 years ago
gradlew Make gradlew executable 5 years ago
gradlew.bat Initial import, various supporting classes. 5 years ago

README.md

KtIrc

Download

KtIrc is a Kotlin JVM library for connecting to and interacting with IRC servers. It is still in an early stage of development.

Setup

KtIrc is published to JCenter, so adding it to a gradle build is as simple as:

repositories {
    jcenter()
}

dependencies {
    implementation("com.dmdirc:ktirc:<VERSION>")
}

Usage

The main interface for interacting with KtIrc is the IrcClientImpl class. A simple bot might look like:

val client = IrcClientImpl(Server("my.server.com", 6667), Profile("nick", "realName", "userName"))
client.onEvent { event ->
    when (event) {
        is ServerWelcome ->
            client.send(joinMessage("#ktirc"))
        is MessageReceived ->
            if (event.message == "!test")
                client.send(privmsgMessage(event.target, "Test successful!"))
    }
}
client.connect()

Contributing

Contributing is welcomed and encouraged! Please try to add unit tests for new features, and maintain a code style consistent with the existing code.

Licence

The code in this repository is released under the MIT licence. See the LICENCE file for more info.