Sample Clojure web api

This is a sample Clojure web api that will:

Display a swagger page.
Validate or reject http requests based on a schema.
Do an async http request to resolve the client's IP address.
Map the request to a Kafka proto message.
Enqueue and publish that message.
Integration tests, relying on testcontainers.

Requirements

Java 11+
Leiningen 2.9.3+

Installation

$ lein protodeps generate
$ lein uberjar

Usage

$ java -jar sample-donkey-api-0.1.0-standalone.jar

Used libraries

Donkey as the http server.
clj-test-containers for integration tests.
malli for request validation.
reitit for routing requests.
Integrant for state management.
Ketu as the Kafka library.
lein-protodeps to generate java classes from .proto files.

Examples

$ export KAFKA_BROKER=my-broker:9092
$ lein uberjar
$ java -jar target/uberjar/sample-donkey-api-0.1.0-SNAPSHOT-standalone.jar
.. in another terminal session
$ curl --location --request POST 'http://localhost:8080/api/v1.0/stocks/order/AAPL' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "amount_usd": 3.47,
  "request_id": "71dad7da-7926-40d8-9b15-b94a6d46e15a",
  "ip": "35.244.183.10",
  "direction": "buy"
  }'

Testing

lein test - To run all unit tests.
lein test :integration - To run all integration tests.
lein test :all - To run all types of tests.

License

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.

asafch/sample-donkey-api