Add ChannelMembershipAdjustment interface

CHANGELOG

 
  * Added SourcedEvent interface for events that have a user source attached
  * Added ChannelJoinFailed event
+ * Added ChannelMembershipAdjustment interface for events that concern
+   users joining/leaving channels
 
 v0.10.3
 

src/main/kotlin/com/dmdirc/ktirc/events/Events.kt

 
 }
 
+/**
+ * Interface implemented by events that describe a change to a channel's membership.
+ */
+interface ChannelMembershipAdjustment {
+    /** The nickname of a user that has joined the channel. */
+    val addedUser: String?
+    /** The nickname of a user who has left the channel. */
+    val removedUser: String?
+    /** The nicknames of all users in the channel, to replace any existing values. */
+    val replacedUsers: Array<String>?
+}
+
 /**
  * Interface implemented by events that come from a particular user.
  */
 class PingReceived(metadata: EventMetadata, val nonce: ByteArray) : IrcEvent(metadata)
 
 /** Raised when a user joins a channel. */
-class ChannelJoined(metadata: EventMetadata, override val user: User, channel: String) : TargetedEvent(metadata, channel), SourcedEvent
+class ChannelJoined(metadata: EventMetadata, override val user: User, channel: String)
+    : TargetedEvent(metadata, channel), SourcedEvent, ChannelMembershipAdjustment {
+    override val addedUser = user.nickname
+    override val removedUser: String? = null
+    override val replacedUsers: Array<String>? = null
+}
 
 /** Raised when an attempt to join a channel fails. */
 class ChannelJoinFailed(metadata: EventMetadata, channel: String, val reason: JoinError) : TargetedEvent(metadata, channel) {
 }
 
 /** Raised when a user leaves a channel. */
-class ChannelParted(metadata: EventMetadata, override val user: User, channel: String, val reason: String = "") : TargetedEvent(metadata, channel), SourcedEvent
+class ChannelParted(metadata: EventMetadata, override val user: User, channel: String, val reason: String = "")
+    : TargetedEvent(metadata, channel), SourcedEvent, ChannelMembershipAdjustment {
+    override val addedUser: String? = null
+    override val removedUser = user.nickname
+    override val replacedUsers: Array<String>? = null
+}
 
 /** Raised when a [victim] is kicked from a channel. */
-class ChannelUserKicked(metadata: EventMetadata, override val user: User, channel: String, val victim: String, val reason: String = "") : TargetedEvent(metadata, channel), SourcedEvent
+class ChannelUserKicked(metadata: EventMetadata, override val user: User, channel: String, val victim: String, val reason: String = "")
+    : TargetedEvent(metadata, channel), SourcedEvent, ChannelMembershipAdjustment {
+    override val addedUser: String? = null
+    override val removedUser = victim
+    override val replacedUsers: Array<String>? = null
+}
 
 /** Raised when a user quits, and is in a channel. */
-class ChannelQuit(metadata: EventMetadata, override val user: User, channel: String, val reason: String = "") : TargetedEvent(metadata, channel), SourcedEvent
+class ChannelQuit(metadata: EventMetadata, override val user: User, channel: String, val reason: String = "")
+    : TargetedEvent(metadata, channel), SourcedEvent, ChannelMembershipAdjustment {
+    override val addedUser: String? = null
+    override val removedUser = user.nickname
+    override val replacedUsers: Array<String>? = null
+}
 
 /** Raised when a user changes nickname, and is in a channel. */
-class ChannelNickChanged(metadata: EventMetadata, override val user: User, channel: String, val newNick: String) : TargetedEvent(metadata, channel), SourcedEvent
+class ChannelNickChanged(metadata: EventMetadata, override val user: User, channel: String, val newNick: String)
+    : TargetedEvent(metadata, channel), SourcedEvent, ChannelMembershipAdjustment {
+    override val addedUser = newNick
+    override val removedUser = user.nickname
+    override val replacedUsers: Array<String>? = null
+}
 
 /** Raised when a batch of the channel's member list has been received. More batches may follow. */
 class ChannelNamesReceived(metadata: EventMetadata, channel: String, val names: List<String>) : TargetedEvent(metadata, channel)
 
 /** Raised when the entirety of the channel's member list has been received. */
-class ChannelNamesFinished(metadata: EventMetadata, channel: String) : TargetedEvent(metadata, channel)
+class ChannelNamesFinished(metadata: EventMetadata, channel: String) : TargetedEvent(metadata, channel), ChannelMembershipAdjustment {
+    override val addedUser: String? = null
+    override val removedUser: String? = null
+    override var replacedUsers: Array<String>? = null
+        internal set
+}
 
 /** Raised when a channel topic is discovered (not changed). Usually followed by [ChannelTopicMetadataDiscovered] if the [topic] is non-null. */
 class ChannelTopicDiscovered(metadata: EventMetadata, channel: String, val topic: String?) : TargetedEvent(metadata, channel)
  *
  * If this happens before {ServerReady], the nickname must be changed for registration to continue.
  */
-class NicknameChangeFailed(metadata: EventMetadata, val cause: NicknameChangeError): IrcEvent(metadata) {
+class NicknameChangeFailed(metadata: EventMetadata, val cause: NicknameChangeError) : IrcEvent(metadata) {
     /** Reasons a nick change may fail. */
     enum class NicknameChangeError {
         /** The nickname is not allowed by the server. */

src/main/kotlin/com/dmdirc/ktirc/events/handlers/ChannelStateHandler.kt

         client.channelState[event.target]?.let {
             it.receivingUserList = false
             log.finest { "Finished receiving names in ${event.target}. Users: ${it.users.toList()}" }
+            event.replacedUsers = it.users.map(ChannelUser::nickname).toTypedArray()
             if (client.behaviour.requestModesOnJoin && !it.modesDiscovered) {
                 client.sendModeRequest(it.name)
             }

src/test/kotlin/com/dmdirc/ktirc/events/EventsTest.kt

+package com.dmdirc.ktirc.events
+
+import com.dmdirc.ktirc.TestConstants
+import com.dmdirc.ktirc.model.User
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Assertions.assertNull
+import org.junit.jupiter.api.Test
+
+internal class EventsTest {
+
+    @Test
+    fun `channel joined event implements membership changed correctly`() {
+        val event = ChannelJoined(EventMetadata(TestConstants.time), User("acidBurn"), "#thegibson")
+        assertEquals("acidBurn", event.addedUser)
+        assertNull(event.removedUser)
+        assertNull(event.replacedUsers)
+    }
+
+    @Test
+    fun `channel parted event implements membership changed correctly`() {
+        val event = ChannelParted(EventMetadata(TestConstants.time), User("acidBurn"), "#thegibson")
+        assertNull(event.addedUser)
+        assertEquals("acidBurn", event.removedUser)
+        assertNull(event.replacedUsers)
+    }
+
+    @Test
+    fun `channel kicked event implements membership changed correctly`() {
+        val event = ChannelUserKicked(EventMetadata(TestConstants.time), User("acidBurn"), "#thegibson", "zeroCool")
+        assertNull(event.addedUser)
+        assertEquals("zeroCool", event.removedUser)
+        assertNull(event.replacedUsers)
+    }
+
+    @Test
+    fun `channel quit event implements membership changed correctly`() {
+        val event = ChannelQuit(EventMetadata(TestConstants.time), User("acidBurn"), "#thegibson")
+        assertNull(event.addedUser)
+        assertEquals("acidBurn", event.removedUser)
+        assertNull(event.replacedUsers)
+    }
+
+    @Test
+    fun `channel nick change implements membership changed correctly`() {
+        val event = ChannelNickChanged(EventMetadata(TestConstants.time), User("zeroCool"), "#thegibson", "crashOverride")
+        assertEquals("crashOverride", event.addedUser)
+        assertEquals("zeroCool", event.removedUser)
+        assertNull(event.replacedUsers)
+    }
+
+}

src/test/kotlin/com/dmdirc/ktirc/events/handlers/ChannelStateHandlerTest.kt

         assertNotNull(channel.users["thePlague"])
     }
 
+    @Test
+    fun `updates replacedUsers property of names finished event`() {
+        val channel = ChannelState("#thegibson") { CaseMapping.Rfc }
+        fakeChannelState += channel
+
+        val event = ChannelNamesFinished(EventMetadata(TestConstants.time), "#thegibson")
+        handler.processEvent(ircClient, ChannelNamesReceived(EventMetadata(TestConstants.time), "#thegibson", listOf("zeroCool")))
+        handler.processEvent(ircClient, event)
+
+        assertEquals(1, event.replacedUsers?.size)
+        assertEquals("zeroCool", event.replacedUsers?.get(0))
+    }
+
     @Test
     fun `adds users with mode prefixes`() {
         val channel = ChannelState("#thegibson") { CaseMapping.Rfc }