Skip to content

Latest commit

 

History

History
57 lines (43 loc) · 2.1 KB

README.md

File metadata and controls

57 lines (43 loc) · 2.1 KB

samatra-extras

Samatra with batteries included. Documentation here

The aim of Samatra is to have as few dependencies as possible - if fact it only depends on the servlet-api.jar Samatra-extras adds more dependencies but offers more out of the box. Specifically it depends on

  • Samatra v1.1
  • Jetty 9.4.35.v20201120
  • Async Http Client 2.12.1
  • SLF4J 1.7.30

This provides helpers for:

  • Jetty web server configuration
  • Gzipping
  • Logging
  • AsyncHttpClient to scala Future

Other samatra extra libraries exist which add further dependencies:

  • samatra-extras-xml - XML responses
    • "org.scala-lang.modules" %% "scala-xml" % "1.3.0"
  • samatra-extras-mustache - Mustache responses
    • "com.samskivert" % "jmustache" % "1.15"
  • samatra-extras-statsd - Statsd metrics - web responses and jvm
    • "com.timgroup" % "java-statsd-client" % "3.1.0"
  • samatra-extras-routeprinting - route printing on start-up (integrates nicely with Intellij)
    • "org.javassist" % "javassist" % "3.27.0-GA"
  • samatra-extras-websockets -
    • "com.github.westernsam.samatra" %% "samatra-websockets" % "v1.1"
    • "org.eclipse.jetty.websocket" % "javax-websocket-server-impl" % 9.4.35.v20201120

Supported platforms

  • Scala 2.13.4
  • Jetty 9.4.35.v20201120

How to install

  • sbt:
resolvers += "jitpack" at "https://jitpack.io",
libraryDependencies += "com.github.westernsam" %% "samatra-extras" % "v1.1"

You may also be interested in samatra.g8 which is a giter8 / sbt template for generating new samatra projects.

Licensing

The MIT License (MIT) http://opensource.org/licenses/MIT

Copyright © 2016, 2017 Springer Nature

Maintenance

Submit issues and PR's to this github.

How to use

The easiest way to generate a new stub Samatra-extras project is to use the samatra.g8 template.