Add convenience static getters for modes

Author: mbax

src/main/java/org/kitteh/irc/client/library/element/mode/ChannelMode.java

@@ -24,6 +24,9 @@
 package org.kitteh.irc.client.library.element.mode;
 
 import org.checkerframework.checker.nullness.qual.NonNull;
+import org.kitteh.irc.client.library.Client;
+
+import java.util.Optional;
 
 /**
  * A channel mode.
@@ -83,4 +86,15 @@ public boolean isParameterRequiredOnSetting() {
      * @return type
      */
     @NonNull Type getType();
+
+    /**
+     * Gets a channel mode by character for a given client.
+     *
+     * @param client client
+     * @param mode   mode to get
+     * @return the mode, if present
+     */
+    public static @NonNull Optional<ChannelMode> get(@NonNull Client client, char mode) {
+        return client.getServerInfo().getChannelModes().stream().filter(m -> m.getChar() == mode).findFirst();
+    }
 }

src/main/java/org/kitteh/irc/client/library/element/mode/ChannelUserMode.java

@@ -24,6 +24,9 @@
 package org.kitteh.irc.client.library.element.mode;
 
 import org.checkerframework.checker.nullness.qual.NonNull;
+import org.kitteh.irc.client.library.Client;
+
+import java.util.Optional;
 
 /**
  * Describes a channel mode that a user can have, such as op.
@@ -40,4 +43,15 @@ public interface ChannelUserMode extends ChannelMode {
     default @NonNull Type getType() {
         return Type.B_PARAMETER_ALWAYS;
     }
+
+    /**
+     * Gets a channel user mode by character for a given client.
+     *
+     * @param client client
+     * @param mode   mode to get
+     * @return the mode, if present
+     */
+    public static @NonNull Optional<ChannelUserMode> get(@NonNull Client client, char mode) {
+        return client.getServerInfo().getChannelUserModes().stream().filter(m -> m.getChar() == mode).findFirst();
+    }
 }

src/main/java/org/kitteh/irc/client/library/element/mode/UserMode.java

@@ -23,8 +23,23 @@
  */
 package org.kitteh.irc.client.library.element.mode;
 
+import org.checkerframework.checker.nullness.qual.NonNull;
+import org.kitteh.irc.client.library.Client;
+
+import java.util.Optional;
+
 /**
  * A user mode.
  */
 public interface UserMode extends Mode {
+    /**
+     * Gets a user mode by character for a given client.
+     *
+     * @param client client
+     * @param mode   mode to get
+     * @return the mode, if present
+     */
+    public static @NonNull Optional<UserMode> get(@NonNull Client client, char mode) {
+        return client.getServerInfo().getUserModes().stream().filter(m -> m.getChar() == mode).findFirst();
+    }
 }