initial commit

StOptional.java

@@ -0,0 +1,36 @@
+/*
+ * copyright (c) squibid 2024 under the Beerware license.
+ *
+ * If we meet some day, and you think this stuff is worth it, you can buy me a
+ * beer in return.
+ */
+
+import java.util.Optional;
+
+/**
+ * Stop Optionals from being used!
+ * safely reducing optionals back to their original types.
+ */
+public final class StOptional {
+  /**
+   * Reduce any optional down to it's original type
+   *
+   * @param o Optional<T> to reduce to it's original type
+   * @return <T> value of optional in original type or null
+   */
+  public static final <T> T reduce(Optional<T> o) {
+    return nullish(o) ? null : o.get();
+  }
+
+  /**
+   * Checks if Optional<?> is null or empty
+   *
+   * @param o Optional<?> optional to check for null like properties
+   * @return boolean true if null or empty, false otherwise
+   */
+  public static final boolean nullish(Optional<?> o) {
+    if (o == null || o.isEmpty())
+      return true;
+    return false;
+  }
+}

example.java

@@ -0,0 +1,45 @@
+import java.util.Optional;
+
+class Example {
+  public static void main(String[] args) {
+    /* should print Hi */
+    Optional<String> a = Optional.of("Hi");
+    System.out.println(StOptional.reduce(a));
+
+    /* should print null */
+    Optional<String> b = Optional.empty();
+    System.out.println(StOptional.reduce(b));
+
+    /* should print null */
+    Optional<String> c = null;
+    System.out.println(StOptional.reduce(c));
+  }
+}
+
+/**
+ * Stop Optionals from being used!
+ * safely reducing optionals back to their original types.
+ */
+final class StOptional {
+  /**
+   * Reduce any optional down to it's original type
+   *
+   * @param o Optional<?> to reduce
+   * @return <?> value of optional
+   */
+  public static final <T> T reduce(Optional<T> o) {
+    return nullish(o) ? null : o.get();
+  }
+
+  /**
+   * Checks if Optional<?> is null or empty
+   *
+   * @param o Optional<?>
+   * @return boolean true if null or empty, false otherwise
+   */
+  public static final boolean nullish(Optional<?> o) {
+    if (o == null || o.isEmpty())
+      return true;
+    return false;
+  }
+}