Add Discord project and notes about Spring Boot

buildSrc/src/main/kotlin/dev.jacksonbailey.wheel.java-common-conventions.gradle.kts

@@ -45,6 +45,15 @@ publishing {
     publications {
         create<MavenPublication>("mavenJava") {
             from(components["java"])
+            // TODO Look more into this https://docs.gradle.org/8.8/userguide/publishing_maven.html#publishing_maven:resolved_dependencies
+            versionMapping {
+                usage("java-api") {
+                    fromResolutionOf("runtimeClasspath")
+                }
+                usage("java-runtime") {
+                    fromResolutionResult()
+                }
+            }
         }
     }
 }

discord/README.md

@@ -0,0 +1,52 @@
+# Discord "server-as-code"
+
+I was thinking recently that Discord servers must have some JSON config representing the entire
+config of the server, but it seems like they don't. I thought to myself that it would be nice to
+be able to set them up like infrastructure in [Terraform][1]. Thus, this project was born. I put
+the title in quotes because "server-as-code" sounds like some sort of "serverless" thing (like
+[Lambda][2]), but I mean it in the way Discord uses the term. Which is essentially to refer to a
+group of chat rooms. If you know Discord, then you know what a server refers to and I'm not going to
+waste my time explaining it lol. That said, I do know that the Discord API calls them "guilds" so
+things will probably get a little confusing. (Especially considering [Guilds][3] are a new feature).
+
+## Notes
+
+I am going to use Spring Boot's [Dependency Management Plugin][4] instead of trying to use the
+platform project (`:platform`) in this project. I am doing this because:
+
+1. Many examples of Spring Boot use this plugin so it's easier to follow along.
+2. I think I may have really messed something up with the platform project. When I bring it in with
+   `implementation(...)` instead of `api(...)` it is also bringing in all the dependencies. I
+   vaguely remember this being a problem with the Vexilum project, but it didn't actually break
+   anything, but now it's causing problems with logback and the simple-slf4j loggers both being on
+   the path.
+3. The entire reason I even made the `:platform` project here was because I wanted to see what
+   Gradle's own dependency management tools were like in comparison to the plugin Spring Boot
+   offers, but it's really only been a hassle and led to me doing even more wacky things. (For
+   example, see the mess of `if (requested.id.id == ...)` to try and do this with plugins.) It also
+   looks like Gradle may have added more ways to do version catalogs since I originally looked into
+   it. I'd like to start over from scratch with it, but I don't want to waste time troubleshooting
+   that and lose my muse to work on this project.
+
+## Look into
+
+To reproduce the error below, remove the `versionMapping` section in `java-common-conventions`
+plugin. I blindly followed what a link in the error told me without understanding.
+
+```
+* What went wrong:
+Execution failed for task ':discord:generateMetadataFileForMavenJavaPublication'.
+> Invalid publication 'mavenJava':
+    - Publication only contains dependencies and/or constraints without a version. You should add
+      minimal version information, publish resolved versions (For more on this, please refer to
+      https://docs.gradle.org/8.8/userguide/publishing_maven.html#publishing_maven:resolved_dependencies
+      in the Gradle documentation.) or reference a platform (For more platforms, please refer to
+      https://docs.gradle.org/8.8/userguide/platforms.html in the Gradle documentation.). Disable
+      this check by adding 'dependencies-without-versions' to the suppressed validations of the
+      :discord:generateMetadataFileForMavenJavaPublication task.
+```
+
+[1]: https://www.terraform.io/
+[2]: https://aws.amazon.com/lambda/
+[3]: https://support.discord.com/hc/en-us/articles/23187611406999-Guilds-FAQ
+[4]: https://docs.spring.io/dependency-management-plugin/docs/current/reference/html/

discord/build.gradle.kts

@@ -0,0 +1,29 @@
+plugins {
+    id("dev.jacksonbailey.wheel.java-application-conventions")
+    id("dev.jacksonbailey.wheel.shut-up-javadoc")
+    id("io.spring.dependency-management") version "1.1.5"
+    id("org.springframework.boot") version "3.3.0"
+}
+
+// Even though this is just for one project, it might be nice to extract it out somewhere later
+dependencyManagement {
+    imports {
+        mavenBom("org.springframework.boot:spring-boot-dependencies:3.3.0")
+    }
+    dependencies {
+        dependency("org.jetbrains:annotations:24.1.0")
+    }
+}
+
+dependencies {
+    compileOnly("org.jetbrains:annotations")
+    implementation("org.springframework.boot:spring-boot")
+    implementation("org.springframework.boot:spring-boot-autoconfigure")
+    implementation("org.springframework.boot:spring-boot-starter")
+    implementation("org.springframework:spring-context")
+    testImplementation("org.junit.jupiter:junit-jupiter")
+    testImplementation("org.junit.jupiter:junit-jupiter-api")
+    testImplementation("org.springframework.boot:spring-boot-starter-test")
+    testImplementation("org.springframework.boot:spring-boot-test")
+    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
+}

discord/gradle.properties

@@ -0,0 +1,2 @@
+licenseName=AGPL-3.0-or-later
+licenseUrl=https://www.gnu.org/licenses/agpl-3.0.txt

discord/src/main/java/dev/jacksonbailey/wheel/discord/Main.java

@@ -0,0 +1,13 @@
+package dev.jacksonbailey.wheel.discord;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class Main {
+
+  public static void main(String[] args) {
+    SpringApplication.run(Main.class, args);
+  }
+
+}

discord/src/test/java/dev/jacksonbailey/wheel/discord/MainTest.java

@@ -0,0 +1,12 @@
+package dev.jacksonbailey.wheel.discord;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class MainTest {
+
+  @Test
+  void contextLoads() {}
+
+}

settings.gradle.kts

@@ -2,6 +2,7 @@ rootProject.name = "wheel"
 
 include(
     "collections",
+    "discord",
     "platform",
     "vexillum",
     "vexillum:vexillum-api",