object MinimalApplication extends cask.MainRoutes{
@cask.get("/")
def hello() = {
"Hello World!"
}
@cask.post("/do-thing")
def doThing(request: cask.Request) = {
request.text().reverse
}
initialize()
}
Cask is a simple Scala web framework inspired by Python's Flask project. It aims to bring simplicity, flexibility and ease-of-use to Scala webservers, avoiding cryptic DSLs or complicated asynchrony. Cask makes it easy to set up a website, backend server, or REST API using Scala
If you use Cask and like it, you will probably enjoy the following book by the Author:
Hands-on Scala has uses Requests-Scala extensively throughout the book, and has the entirety of Chapter 14: Simple Web and API Servers dedicated to the library. Hands-on Scala is a great way to level up your skills in Scala in general and Cask in particular.
Cask is profiled using the JProfiler Java Profiler, courtesy of EJ Technologies
- 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
-
Add
cask.QueryParams
type to allow route methods to take arbitrary query parameters, addcask.RemainingPathSegments
as replacement forsubpath = true
#108 #109 #110
- Update
org.xerial:sqlite-jdbc
library in examples to version3.41.2.1
to
support Apple Silicon @staticResources
and@staticFiles
decorators now automatically infer content 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 Cask
actorContext
explicitly passed into every Routes case class
- Add support for
geny.Writable#httpContentType
andgeny.Writable#contentLength
- Add endpoints for
delete
andpatch
- Allow arbitrary HTTP methods
- Bump uPickle, Requests versions
- Add
SameSite
cookie attribute - Fix bug in default parameters of cask routes
- Extract
cask-actor
into its own repo and artifact, https://github.com/lihaoyi/castor
- Separate
cask-actor
into a separate artifact, documented separately as Cask 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 -
Allow
cask.decorators.compress
to be used as acask.Routes
orcask.Main
decorator without crashing on websocket responses -
Allow decorators to be defined and used for non-
cask.Response
results
- Fix crashes in
cask.WebsocketClientImpl
- Provide a simple cross-platform builtin websocket client in
cask.WsClient
- Make
Routes#log
implicit
- Cross-publish
cask.util
for Scala.js
- Embed
concurrent.ExecutionContext.global
incask.Routes
by default, to be overriden if necessary
- Internal refactoring to clean up routing logic
- Standardize on a basic
cask.Logger
interface - Create a simple actor-based API for handling websockets in
cask.WsHandler
andcask.WsActor
cask.Response
is now covariant
- Use standard
./mill
bootstrap script
- Support for Scala 2.13.0