Spider client (#6)

Add in some HttpClient helpers, mainly.

example/src/main/scala/app/wishingtree/SpiderAppExample.scala

@@ -0,0 +1,55 @@
+package app.wishingtree
+
+import com.sun.net.httpserver.Filter
+import dev.wishingtree.branch.friday.JsonEncoder
+import dev.wishingtree.branch.friday.http.JsonBodyHandler
+import dev.wishingtree.branch.spider.*
+import dev.wishingtree.branch.spider.client.ClientRequest.uri
+import dev.wishingtree.branch.spider.client.{Client, ClientRequest}
+import dev.wishingtree.branch.spider.server.*
+import dev.wishingtree.branch.spider.server.OpaqueSegments.*
+
+import java.net.http.HttpResponse
+
+object SpiderAppExample extends SpiderApp {
+
+  import RequestHandler.given
+
+  val staticFilesPath = Segments.wd / "site" / "book"
+  val files           = FileContext(staticFilesPath)
+
+  case class Person(name: String)
+
+  given Conversion[Person, Array[Byte]] = { person =>
+    summon[JsonEncoder[Person]].encode(person).toJsonString.getBytes
+  }
+
+  val personHandler = new ContextHandler("/") {
+    override val contextRouter: PartialFunction[
+      (HttpVerb, Segments),
+      RequestHandler[Unit, Person]
+    ] = { case HttpVerb.GET -> >> / "person" =>
+      new RequestHandler[Unit, Person] {
+        override def handle(request: Request[Unit]): Response[Person] =
+          Response(Person("Mark"))
+      }
+    }
+  }
+
+  val handlers: ContextHandler = files |+| personHandler
+  ContextHandler.registerHandler(handlers)
+
+  val client = Client.build()
+
+  val request = ClientRequest
+    .build(uri"http://localhost:9000/person")
+
+  val response =
+    client.sendAsync(request, JsonBodyHandler.of[Person])
+
+  response
+    .thenApply { resp =>
+      println(resp.body())
+    }
+
+}

friday/src/main/scala/dev/wishingtree/branch/friday/http/JsonBodyHandler.scala

@@ -0,0 +1,32 @@
+package dev.wishingtree.branch.friday.http
+
+import dev.wishingtree.branch.friday.JsonDecoder
+
+import java.net.http.HttpResponse
+import java.net.http.HttpResponse.{BodyHandler, BodySubscribers}
+import java.nio.charset.Charset
+import scala.util.Try
+
+trait JsonBodyHandler[I] extends BodyHandler[I] {}
+
+object JsonBodyHandler {
+
+  inline def of[I](using JsonDecoder[I]): JsonBodyHandler[Try[I]] =
+    summon[JsonBodyHandler[Try[I]]]
+
+  inline given derived[I](using
+      decoder: JsonDecoder[I]
+  ): JsonBodyHandler[Try[I]] = {
+    new JsonBodyHandler[Try[I]] {
+      override def apply(
+          responseInfo: HttpResponse.ResponseInfo
+      ): HttpResponse.BodySubscriber[Try[I]] = {
+        BodySubscribers.mapping(
+          BodySubscribers.ofString(Charset.defaultCharset()),
+          str => decoder.decode(str)
+        )
+      }
+    }
+  }
+
+}

friday/src/main/scala/dev/wishingtree/branch/friday/http/JsonBodyPublisher.scala

@@ -0,0 +1,16 @@
+package dev.wishingtree.branch.friday.http
+
+import dev.wishingtree.branch.friday.JsonEncoder
+
+import java.net.http.HttpRequest
+import java.net.http.HttpRequest.BodyPublishers
+
+object JsonBodyPublisher {
+
+  inline def of[I](
+      i: I
+  )(using jsonEncoder: JsonEncoder[I]): HttpRequest.BodyPublisher = {
+    BodyPublishers.ofString(jsonEncoder.encode(i).toJsonString)
+  }
+
+}

site/src/SUMMARY.md

@@ -6,4 +6,6 @@
 - [Spider](./spider/index.md)
 - [Piggy](./piggy/index.md)
 - [Friday](./friday/index.md)
-- [Macaroni](./macaroni/index.md)
+- [Macaroni](./macaroni/index.md)
+- [Veil](./veil/index.md)
+- [Blammo](./blammo/index.md)

site/src/blammo/index.md

@@ -0,0 +1,4 @@
+# Blammo
+
+This module contains some helpers around `java.util.logging`. So far, the main thing it has going for it is a
+`JsonFormatter` for some structured logging.

site/src/index.md

@@ -9,18 +9,19 @@ things done quickly! Think of it as the framework for your side-project, not you
 *Branch* is made up of a collection of modules, each focusing on different parts:
 
 - **Lzy** - Lazy Futures or Tiny Effects?
-- **Spider** - A wrapper/framework around the Java HttpServer (I bet you didn't even know there was one!)
+- **Spider** - A wrapper/framework around the Java HttpServer (I bet you didn't even know there was one!), as well as
+  HttpClient helpers.
 - **Piggy** - A SQL framework, probably focused on PostgreSQL.
 - **Friday** - A Json library, because Scala doesn't already have enough.
 - **Macaroni** - Some re-usable helpers and meta-programming utilities.
+- **Veil** - `.env` / (Json based) Config utilities.
+- **Blammo** - It's better than bad, it's (Json) logging!
 
 ... and *more to come*!
 
 A list of other things important to this framework's goals are (but not limited to):
 
-- HTTP Client
-- Configuration
 - Web Sockets
 - Event Bus
-- Forms/Validations
+- Actors, even if it kills me.
 - (HTML) Templating

site/src/veil/index.md

@@ -0,0 +1,11 @@
+# Veil
+
+Veil is a small layer to help with configs and environment variables.
+
+Veil can load a `.env`, `.env.test`, or `.env.prod` file based on the environment variable `SCALA_ENV` being set to
+`DEV`, `TEST`, or `PROD`. Values in this file are loaded into an in-memory map, and you can look up an env variable with
+`Veil.get(key: String): Option[String]`. If it's not present in the in-memory map, it will then search Java's
+`System.getenv()`.
+
+There is also a `Config` type-class that helps with loading json from files/resources, and mapping them to a case
+class (which presumably is used for configuration).

spider/src/main/scala/dev/wishingtree/branch/spider/client/Client.scala

@@ -0,0 +1,15 @@
+package dev.wishingtree.branch.spider.client
+
+import java.net.http.HttpClient
+
+object Client {
+
+  def builder: HttpClient.Builder =
+    HttpClient.newBuilder()
+
+  def build(settings: HttpClient.Builder => HttpClient.Builder*): HttpClient =
+    settings
+      .foldLeft(builder)((b, s) => s(b))
+      .build()
+
+}

spider/src/main/scala/dev/wishingtree/branch/spider/client/ClientRequest.scala

@@ -0,0 +1,32 @@
+package dev.wishingtree.branch.spider.client
+
+import dev.wishingtree.branch.spider.ContentType
+import java.net.URI
+import java.net.http.HttpRequest
+
+object ClientRequest {
+
+  extension (sc: StringContext) {
+    def uri(args: Any*): URI = URI.create(sc.s(args*))
+  }
+
+  extension (rb: HttpRequest.Builder) {
+    def withContentType(contentType: ContentType): HttpRequest.Builder =
+      rb.setHeader("Content-Type", contentType.content)
+  }
+
+  def builder(uri: URI): HttpRequest.Builder =
+    HttpRequest.newBuilder(uri)
+
+  def build(
+      uri: URI,
+      settings: HttpRequest.Builder => HttpRequest.Builder*
+  ): HttpRequest = {
+    settings
+      .foldLeft(
+        builder(uri)
+      )((b, s) => s(b))
+      .build()
+  }
+
+}

spider/src/main/scala/dev/wishingtree/branch/spider/ContextHandler.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/ContextHandler.scala

@@ -1,9 +1,10 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
 
 import com.sun.net.httpserver.*
 import dev.wishingtree.branch.lzy.Lazy
 import dev.wishingtree.branch.lzy.abstractions.Semigroup
-import dev.wishingtree.branch.spider.OpaqueSegments.*
+import dev.wishingtree.branch.spider.HttpVerb
+import dev.wishingtree.branch.spider.server.OpaqueSegments.*
 
 import java.time.{Duration, Instant}
 import scala.jdk.CollectionConverters.*

spider/src/main/scala/dev/wishingtree/branch/spider/FileContext.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/FileContext.scala

@@ -1,5 +1,7 @@
-package dev.wishingtree.branch.spider
-import dev.wishingtree.branch.spider.OpaqueSegments.*
+package dev.wishingtree.branch.spider.server
+
+import OpaqueSegments.*
+import dev.wishingtree.branch.spider.*
 
 import java.io.File
 
@@ -23,7 +25,7 @@ case class FileContext(rootFilePath: Segments, rootPath: String = "/")
   private def defaultExists(path: Segments): Boolean = {
     !path.toSeq.lastOption.exists(_.contains("\\.")) &&
     FileContext.defaultFiles.foldLeft(false) { (b, d) =>
-      val file = new File((rootFilePath / d).toPathString)
+      val file = new File((rootFilePath / path / d).toPathString)
       b || (file.exists() && file.isFile)
     }
   }

spider/src/main/scala/dev/wishingtree/branch/spider/FileHandler.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/FileHandler.scala

@@ -1,8 +1,9 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
 
-import OpaqueSegments.*
-import FileHandler.given
-import RequestHandler.given
+import dev.wishingtree.branch.spider.server.FileHandler.given
+import dev.wishingtree.branch.spider.server.OpaqueSegments.*
+import dev.wishingtree.branch.spider.server.RequestHandler.given
+import dev.wishingtree.branch.spider.server.{Request, RequestHandler, Response}
 
 import java.io.{File, FileInputStream}
 

spider/src/main/scala/dev/wishingtree/branch/spider/OpaqueSegments.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/OpaqueSegments.scala

@@ -1,4 +1,4 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
 
 import java.net.URLEncoder
 import java.nio.file.Path

spider/src/main/scala/dev/wishingtree/branch/spider/Request.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/Request.scala

@@ -1,4 +1,6 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
+
+import dev.wishingtree.branch.spider.server.Request
 
 import java.net.URI
 

spider/src/main/scala/dev/wishingtree/branch/spider/RequestHandler.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/RequestHandler.scala

@@ -1,7 +1,8 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
 
 import com.sun.net.httpserver.HttpExchange
 import dev.wishingtree.branch.lzy.Lazy
+import dev.wishingtree.branch.spider.server.{RequestHandler, Response}
 
 import scala.jdk.CollectionConverters.*
 

spider/src/main/scala/dev/wishingtree/branch/spider/Response.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/Response.scala

@@ -1,4 +1,6 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
+
+import dev.wishingtree.branch.spider.ContentType
 
 case class Response[A](
     body: A,

spider/src/main/scala/dev/wishingtree/branch/spider/HttpApp.scala → spider/src/main/scala/dev/wishingtree/branch/spider/server/SpiderApp.scala

@@ -1,11 +1,11 @@
-package dev.wishingtree.branch.spider
+package dev.wishingtree.branch.spider.server
 
 import com.sun.net.httpserver.{HttpHandler, HttpServer}
 import dev.wishingtree.branch.lzy.LazyRuntime
 
 import java.net.InetSocketAddress
 
-trait HttpApp {
+trait SpiderApp {
 
   val port: Int =
     9000

spider/src/test/scala/dev/wishingtree/branch/spider/HttpFunSuite.scala

@@ -2,8 +2,9 @@ package dev.wishingtree.branch.spider
 
 import com.sun.net.httpserver.HttpServer
 import dev.wishingtree.branch.lzy.LazyRuntime
+import dev.wishingtree.branch.spider.server.OpaqueSegments.*
+import dev.wishingtree.branch.spider.server.{ContextHandler, RequestHandler}
 import munit.FunSuite
-import OpaqueSegments.*
 
 import java.net.InetSocketAddress
 

spider/src/test/scala/dev/wishingtree/branch/spider/PathsSpec.scala

@@ -1,6 +1,6 @@
 package dev.wishingtree.branch.spider
 
-import dev.wishingtree.branch.spider.OpaqueSegments.*
+import dev.wishingtree.branch.spider.server.OpaqueSegments.*
 import munit.FunSuite
 
 class PathsSpec extends FunSuite {

spider/src/test/scala/dev/wishingtree/branch/spider/RequestHandlerSpec.scala

@@ -1,6 +1,12 @@
 package dev.wishingtree.branch.spider
-import dev.wishingtree.branch.spider.OpaqueSegments.*
-import dev.wishingtree.branch.spider.RequestHandler.given
+import dev.wishingtree.branch.spider.server.OpaqueSegments.*
+import dev.wishingtree.branch.spider.server.{
+  ContextHandler,
+  Request,
+  RequestHandler,
+  Response
+}
+import dev.wishingtree.branch.spider.server.RequestHandler.given
 
 import java.net.URI
 import java.net.http.HttpClient.Version