Repository files navigation

objectMinimalApplicationextends cask.MainRoutes{@cask.get("/")defhello()= {"Hello World!"  }@cask.post("/do-thing")defdoThing(request: cask.Request)= {    request.text().reverse  }  initialize()}

Cask is a simple Scala web framework inspired by Python'sFlask project. It aims to bring simplicity,flexibility and ease-of-use to Scala webservers, avoiding cryptic DSLs orcomplicated asynchrony. Cask makes it easy to set up a website, backend server,or REST API using Scala

• Documentation

If you use Cask and like it, you will probably enjoy the following book by the Author:

• Hands-on Scala Programming

Hands-on Scala has uses Requests-Scala extensively throughout the book, and hasthe entirety ofChapter 14: Simple Web and API Servers dedicated tothe library.Hands-on Scala is a great way to level up your skills in Scalain general and Cask in particular.

Cask is profiled using theJProfiler Java Profiler,courtesy of EJ Technologies

• Update examples to build with Mill 1.x
• Example zips are now hosted on Maven Central rather than Github Releases

• Add a helper method to create a dedicated virtual thread scheduler.#164

• Support for Java21/Loom Virtual Threads#161, seeRunning Cask with Virtual Threads

• Fix path traversal issue when serving static files#157
• Fix form submissions with empty file fields throwing exceptions#150
• Add CI testing for Java 17 and 21#156

• Allow overlap between static routes and wildcards#134

• Introduce@postJsonCached to allow reference to the original body payload in@postJson#123

• Properly decode URL parameters when passed as path segments or query params#114

• Preserve leading slash when resolving static paths#111

• Addcask.QueryParams type to allow route methods to take arbitrary query parameters,addcask.RemainingPathSegments as replacement forsubpath = true#108#109#110

• Updateorg.xerial:sqlite-jdbc library in examples to version3.41.2.1 to
  support Apple Silicon
• @staticResources and@staticFiles decorators now automatically infercontent types based on file extension

• Update uPickle to 3.0.0
• Update Geny to 1.0.0
• Update Scala 3 to 3.2.2
• Update Scala.js to 1.13.0
• Update SourceCode to 0.3.0
• Update PPrint to 0.8.1
• Update Castor to 0.3.0

• Fix error reporting for invalid routes#70

• Bump uPickle to 1.6.0

• Publish Cask for Scala 2.12 again

• Improve handling on 404/405 responses with unsupported methods(#52)

• Fix example project zips

• Update Castor to 0.1.8
• Add@cask.options decorator

• Build for Scala 3.0.0

• Return 405 for unsupported HTTP methods
• Upgrade Scala versions to 2.13.5 and 3.0.0-RC3

• Add support for Scala 3.0.0-RC2

• Upgrade undertow
• Add support for Scala 3.0.0-M2

• Fix published examples

• Add support for Dotty (to be Scala 3)

• Bump Mill version to 0.8.0

• Make CaskactorContext explicitly passed into every Routes case class

• Add support forgeny.Writable#httpContentType andgeny.Writable#contentLength

• Add endpoints fordelete andpatch
• Allow arbitrary HTTP methods

• Bump uPickle, Requests versions

• AddSameSite cookie attribute
• Fix bug in default parameters of cask routes

• Extractcask-actor into its own repo and artifact,https://github.com/lihaoyi/castor

• Separatecask-actor into a separate artifact, documented separately asCask Actors

• Support for Scala 2.13.2

• Mismatched decorator types applied to a single method is now a compile error

• staticFiles andstaticResources now allows you to specify response headers

• Allowcask.decorators.compress to be used as acask.Routes orcask.Maindecorator without crashing on websocket responses

• Allow decorators to be defined and used for non-cask.Response results

• Fix crashes incask.WebsocketClientImpl

• Provide a simple cross-platform builtin websocket client incask.WsClient

• MakeRoutes#log implicit

• Cross-publishcask.util for Scala.js

• Embedconcurrent.ExecutionContext.global incask.Routes by default, to beoverriden if necessary

• Internal refactoring to clean up routing logic

• Standardize on a basiccask.Logger interface
• Create a simple actor-based API for handling websockets incask.WsHandlerandcask.WsActor

• cask.Response is now covariant

• Use standard./mill bootstrap script

• Support for Scala 2.13.0