Scotty-0.20 released

ocramz · October 2, 2023, 10:01pm

Announcing the latest release of scotty !

This release includes a few bug fixes, new features (WAI applications nested under endpoints! cookie support!) as well as a big refactoring of the ActionT type and the overall exception system as well as a bunch of new tests. Overall the library should be easier to build upon and evolve going forward.

Full changelog:

0.20 [2023.10.02]

Drop support for GHC < 8.10 and modernise the CI pipeline (haskell-ci: drop GHCs older than 8.10 and modernise the workflow by fumieval · Pull Request #300 · scotty-web/scotty · GitHub).
Adds a new nested handler that allows you to place an entire WAI Application under a Scotty route (Nested WAI Applications under Scotty Routes by sordina · Pull Request #233 · scotty-web/scotty · GitHub).
Disambiguate request parameters (Ambiguous params, differentiate Capture, Query String and Form Data · Issue #204 · scotty-web/scotty · GitHub). Adjust the Env type to have three [Param] fields instead of one, add captureParam, formParam, queryParam and the associated captureParams, formParams, queryParams. Add deprecation notices to param and params.
Add Scotty.Cookie module (https://github.com/scotty-web/scotty/pull/293).
Change body parsing behaviour such that calls to next don’t result in POST request bodies disappearing (Request body is preserved across 'next' calls #147 by ocramz · Pull Request #308 · scotty-web/scotty · GitHub).
Rewrite ActionT using the “ReaderT pattern” (Refactor ActionT to use ReaderT pattern by ocramz · Pull Request #314 · scotty-web/scotty · GitHub) https://www.fpcomplete.com/blog/readert-design-pattern/

Thank you to all contributors who supported and grew this wonderful little web framework throughout the years.

int-index · October 3, 2023, 8:15am

Nice. I use scotty in a hobby project and will try out the new version as soon as it makes it into nixpkgs.

RyanGlScott · October 3, 2023, 10:52am

I owe @ocramz a huge debt of gratitude for becoming a scotty co-maintainer and working through the enormous backlog of GitHub issues. This release wouldn’t have been possible without the huge amount of work that @ocramz put into the project. Thanks!

mpilgrem · October 3, 2023, 12:52pm

Prompted by the recent discussion here about convenience and templates, I thought I would mention that Stack’s ‘central’ templates include two that are Scotty-related:

scotty-hello-world. Currently, Stack will work out that the templated package works with snapshot nightly-2023-10-04 (GHC 9.6.3). With other snapshots, you will need to specify scotty-0.20.1 as an extra dep; and
scotty-hspec-wai. Stack will work out that it works with lts-12.14 (GHC 9.4.7).

ocramz · October 3, 2023, 1:27pm

Annnd a quick bugfix release because CI didn’t catch everything everything (thank you @RyanGlScott for flagging issues)

0.20.1 [2023.10.03]

remove dependencies on ‘base-compat’ and ‘base-compat-batteries’ (#318)
re-add MonadFail (ActionT m) instance (#325)
re-add MonadError (ActionT m) instance, but the error type is now specialized to ‘StatusError’ (#325)
raise lower bound on base ( > 4.14 ) to reflect support for GHC >= 8.10 (#325).

ocramz · October 4, 2023, 12:48pm

@RyanGlScott thank you for the kind words! I’m happy to help as I have some bandwidth for open source these days In turn, I would thank @fumieval for his thoughtful shepherding of the PR, he was instrumental in minimizing breakage and ensuring a consistent interface.

Kleidukos · October 4, 2023, 12:50pm

@ocramz sorry to chime in after the patch release but it seems you’ve forgot to update the list of supported GHC versions: @hackage/scotty

If your CI setup is adequate, you can use https://github.com/Kleidukos/get-tested to keep the cabal metadata and the CI in sync.

ocramz · October 4, 2023, 12:53pm

@Kleidukos thanks for the tip, but the cabal file is up to date… https://hackage.haskell.org/package/scotty-0.20/src/scotty.cabal maybe it’s formatted in the wrong way?

Kleidukos · October 4, 2023, 12:54pm

Nope, you’re alright

Kleidukos · October 4, 2023, 1:19pm

All is good now

ocramz · October 4, 2023, 1:25pm

what was the matter?

piq9117 · October 6, 2023, 9:41pm

Thanks for maintaining scotty!

Maybe a bit related. I’m learning about htmx and so I’m translating their examples in to haskell with blaze-htmx. Then I chose scotty to serve it. GitHub - piq9117/htmx-examples

ocramz · October 7, 2023, 1:55pm

@int-index how long does it usually take for NixPkgs to pull from upstream? I see it’s still pointing to 0.12.1

int-index · October 8, 2023, 10:23am

Judging by the git history, it’s about 3 to 4 weeks. The last updates are dated Oct 4, Sep 14, Aug 17, Jun 28, Jun 7.

ocramz · December 28, 2023, 5:06pm

Hi @int-index , I just checked and nixpkgs is still building 0.12 . Hydra - nixpkgs:trunk:haskellPackages.scotty.x86_64-linux Is there a way to nudge it to fetch the latest version ?

int-index · December 28, 2023, 6:29pm

@cdepillabout Do you happen to know when nixpkgs will move on from Stackage LTS 21.* to the 22.* series?

cdepillabout · December 29, 2023, 4:19am

We don’t have any specific timeline, but it may happen in the PR after haskellPackages: update stackage and hackage by ncfavier · Pull Request #272097 · NixOS/nixpkgs · GitHub.

The Haskell maintainers in Nixpkgs have been quite busy lately, so I’m not sure when exactly we’ll start the process.

I’d welcome you to join us in https://matrix.to/#/#haskell:nixos.org if you want to help with the move to LTS 22. It is sometimes quite a lot of work to transition to a newer compiler.

ocramz · December 29, 2023, 7:43am

Ah thanks @cdepillabout now I get it. I actually don’t even use Nix but was mainly curious about what makes it tick.