ckampfe / http-service-template

a Boot template for building HTTP services in Clojure

http-service

A Boot template for a simple HTTP service

Usage

boot -d boot/new new -t http-service -S -n your-service-name

What you get

• aero for config management
• bidi for routing
• hikari-cp for database connection pooling
• http-kit for HTTP server
• migratus for database migrations
• timbre for logging
• mount for state management
• postgresql drivers by default
• ring-defaults for sane HTTP API handling
• ring-json for automatic JSON serialization/deserialization

clark$> boot -d boot/new new -t http-service -S -n your-example-service
Generating fresh 'boot new' http-service project.
[~/code]
clark$> tree your-example-service
your-example-service
├── build.boot
├── resources
│   ├── config.edn
│   └── dev-config.edn
├── src
│   └── your_example_service
│       ├── config.clj
│       ├── controller.clj
│       ├── core.clj
│       ├── db.clj
│       └── web.clj
└── test
    └── your_example_service
        └── core_test.clj

5 directories, 9 files

TODO

• env-based log levels
• database layer with migration support
• improve config of database migrations

License

Copyright © 2018 Clark Kampfe

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.