ring VS clojure-polylith-realworld-example-app

* HTTP: Ring is the de facto way to manage HTTP request (see https://github.com/ring-clojure/ring/wiki/Concepts). Jetty and Aleph are common web servers (and https://github.com/clj-commons/aleph) that implement Ring interface.

https://youtu.be/LcpbBth7FaQ (really cool live coding session with REPL-driven development for a ring web app)

> In the HTTP handlers it makes sense that you don't have return values, because: What would you do with that value exactly?

I think that approach used by clojure's ring shows an elegant way to represent http responses https://github.com/ring-clojure/ring/wiki/Concepts#responses. They are essentially structs with the following fields:

status := number

headers := map of string->string

body := stream | string | seq | inputstream

Request handlers are handed a request struct that is similar. The handler is a function that maps a request to a response (it doesn't actually write to streams itself).

I like this style for an http library for a couple of reasons:

1. HTTP resources can be viewed as functions whose domain is the request, and range is the response. Having the abstraction match that makes for really nice code.

While you won't find your Spring here, you will find that many of those web libraries will tend to use or produce Hiccup, return Ring maps or maybe have pipelines built using interceptors. Composing libraries together is usually not that hard, but it does require you to leave the comfort zone of the framework's abstractions to try to understand what is actually happening e.g. when someone makes an HTTP request and something is returned and displayed in the browser.

On that note, are you able to support everything required by the ring spec?

You can check out my example project in Clojure with using Ring.

It uses already mentioned ring api (https://github.com/ring-clojure/ring/wiki).

I've tried to pair down to the simplest example which shows the issue, and raised it here as I couldn't see one you'd already created or similar: https://github.com/ring-clojure/ring/issues/436 This is so that I have something to link to/follow from our side, hope you don't mind, and many thanks for the diagnosis!

I tried looking into Polylith a few months ago, when I first discovered it. I recall the feeling of experiencing information overload. Though, I am not a Clojure expert either, so that probably compounded my issue.

I believe it would be beneficial to supply more example projects. I found [one](https://github.com/furkan3ayraktar/clojure-polylith-realworl...), however, it uses SQLite. Maybe an example which uses Postgres, and Redis for caching would be more real-world?

One question I have, how are ENV variable driven configurations handled? For example, if I need a `DATABASE_URL` etc. I recently ran into an [issue](https://discord.com/channels/313110246643990528/313110246643...) in my own Clojure web service attempt where I could not use `def` to define the individual variables since they are evaluated at Uberjar build time. I eventually converted it to a `defn` but then it gets evaluated every time it's used.

If you want to jump straight into some code, then head over to the Polylith RealWorld example app.

You can check out my example project in Clojure with using Ring.

Haven't looked at it myself but I am aware of https://github.com/furkan3ayraktar/clojure-polylith-realworld-example-app