yesod-core
Creation of type-safe, RESTful web applications.
| LTS Haskell 24.17: | 1.6.28.1 | 
| Stackage Nightly 2025-10-31: | 1.6.28.1 | 
| Latest on Hackage: | 1.6.28.1 | 
yesod-core-1.6.28.1@sha256:3d93579f3ec866a94cba55377528e5d2763ac07690f81531fc5eadfd0b2eff28,8594Module documentation for 1.6.28.1
yesod-core
This is the main package for Yesod, providing all core functionality on which other packages can be built. It provides dispatch, handler functions, widgets, etc.
Yesod is well documented on its website.
Changes
ChangeLog for yesod-core
1.6.28.1
- Add type arguments to the sub routes #1866
1.6.28.0
- Allow users to control generation of the resourcesSite :: [ResourceTree String]value. #1881
1.6.27.1
- Set base >= 4.11for less CPP and imports #1876
1.6.27.0
- Build with wai-extra-3.1.17#1861
1.6.26.0
- Always apply jsAttributes to julius script blocks of body #1836
1.6.25.1
- Export the options that were created in 1.6.25.0 #1825
1.6.25.0
- Add an options structure that allows the user to set which instances will be derived for a routes structure. #1819
1.6.24.5
- Support Aeson 2.2 #1818
1.6.24.4
- Fix test-suite compilation error for GHC >= 9.0.1 #1812
1.6.24.3
- Fix subsite-to-subsite dispatch #1805
1.6.24.2
- No star is type #1797
1.6.24.1
- Adapt to removal of ListTfrom transformers-0.6. #1796
1.6.24.0
- Make catching exceptions configurable and set the default back to rethrowing async exceptions. #1772.
1.6.23.1
- Fix typo in creation of the description <meta>tag indefaultLayout. #1766
1.6.23
- Add idempotent versions of setDescription,setDescriptionI. These functions have odd behaviour when called multiple times, so they are now warned against. This can’t be a silent change - if you want to switch to the new functions, make sure your layouts are updated to usepageDescriptionas well aspageTitle. #1765
1.6.22.1
- Remove sometimes failing superfluous test. #1756
1.6.22.0
- Add missing list to documentation for Yesod.Core.Dispatch.warp. #1745
- Add instances for ToContent Void,ToTypedContent Void. #1752
- Handle async exceptions within yesod rather then warp. #1753
- Support template-haskell 2.18 #1754
1.6.21.0
- Export Yesod.Core.Dispatch.defaultGenso that users may reuse it for their ownYesodRunnerEnvs #1734
1.6.20.2
- Fix compatibility with template-haskell 2.17 #1729
1.6.20.1
- Throw an error in breadcrumbsif the trail of breadcrumbs is circular. #1727
1.6.20
- Generate CSRF tokens using a secure entropy source #1726
- Change semantics of yreGenanddefaultGen
1.6.19.0
- Change order of priority in languages#1721
1.6.18.8
- Fix test suite for wai-extra change around vary header
1.6.18.7
- Fix functions generating Open Graph metadata#1709
1.6.18.6
- Update documentation from HandlerTtoHandlerFor#1703
1.6.18.5
Document ErrorResponse #1698
1.6.18.4
- Fixed a bug where mkYesodand other TH functions didn’t work for datatypes with explicitly stated type variables, including the case with typeclass constraints. https://github.com/yesodweb/yesod/pull/1697
1.6.18.3
- Remove mention of an oudated Yesod type (GHandler) from the docs forhandlerToIO. https://github.com/yesodweb/yesod/pull/1695
1.6.18.2
- Recommends .yesodroutesas the file extension for Yesod routes files. #1686
1.6.18.1
- Increase the size of CSRF token
1.6.18
- 
Add functions for setting description and OG meta #1663 
- 
Use DeriveLiftto implement theLiftinstances forResourceTree,Resource,Piece, andDispatch. Among other benefits, this provides implementations ofliftTypedontemplate-haskell-2.16(GHC 8.10) or later. #1664
1.6.17.3
- Support for unliftio-core0.2
1.6.17.2
- Support template-haskell 2.16, build with GHC 8.10 #1657
1.6.17.1
- Remove unnecessary deriving of Typeable
1.6.17
- Adds contentTypeIsJson#1646
1.6.16.1
- Compiles with GHC 8.8.1
1.6.16
- Add jsAttributesHandlerto run arbitrary Handler code before building the attributes map for the script tag generated bywidgetFile#1622
1.6.15
- Move redirectToPostJavaScript form submission from HTML element to<script>tag for CSP reasons #1620
1.6.14
- Introduce JSONResponse. issue #1481 and PR #1592
1.6.13
- Introduce maxContentLengthIO. issue #1588 and PR #1589
1.6.12
- Use at most one valid session cookie per request #1581
1.6.11
- Deprecate insecure JSON parsing functions #1576
1.6.10.1
- Fix test suite compilation for commercialhaskell/stackage#4319
1.6.10
- Adds functions to get and set values in the per-request caches. #1573
1.6.9
- Add sendResponseNoContent#1565
1.6.8.1
- Add missing test file to tarball #1563
1.6.8
- In the route syntax, allow trailing backslashes to indicate line continuation. #1558
1.6.7
- If no matches are found, selectRepchooses first representation regardless of the presence or absence of aContent-Typeheader in the request #1540
- Sets the X-XSS-Protectionheader to1; mode=block#1550
- Add PrimMonadinstances forHandlerForandWidgetForfrom StackOverflow
1.6.6
- defaultErrorHandlerhandles text/plain requests #1522
1.6.5
- Add fileSourceByteString#1503
1.6.4
- Add addContentDispositionFileName#1504
1.6.3
- Add missing export for SubHandlerFor
1.6.2
- Derive a Showinstance forResourceTreeandFlatResource#1492- Some third party packages, like yesod-routes-flowderive their ownShowinstance, and this will break those packages.
 
- Some third party packages, like 
1.6.1
- Add a Semigroup LiteAppinstance, and explicitly define(<>)in the already existingSemigroupinstances forWidgetFor,Head,Body,GWData, andUniqueList.
1.6.0
- Upgrade to conduit 1.3.0
- Switch to MonadUnliftIO
- Drop mwc-randomandblaze-builderdependencies
- Strictify some internal data structures
- Add CIwrapper to first field inHeaderdata constructor #1418
- Internal only change, users of stable API are unaffected: WidgetTholds its data in anIORefso that it is isomorphic toReaderT, avoiding state-loss issues..
- Overhaul of HandlerT/WidgetTto no longer be transformers.
- Fix Haddock comment & simplify implementation for contentTypeTypes#1476
1.4.37.3
- Improve error message when request body is too large #1477
1.4.37.2
- Improve error messages for the CSRF checking functions #1455
1.4.37.1
- Fix documentation on languagesfunction, updategetMessageRenderto use said function. #1457
1.4.37
- Add setWeakEtagfunction in Yesod.Core.Handler module.
1.4.36
- Add replaceOrAddHeaderfunction in Yesod.Core.Handler module. 1416
1.4.35.1
- TH fix for GHC 8.2
1.4.35
- Contexts can be included in generated TH instances. 1365
- Type variables can be included in routes.
1.4.34
- Add WaiSubsiteWithAuth. #1394
1.4.33
- Adds curly brackets to route parser. #1363
1.4.32
- Fix warnings
- Route parsing handles CRLF line endings
- Add ‘getPostParams’ in Yesod.Core.Handler
- Haddock rendering improved.
1.4.31
- Add parseCheckJsonBodyandrequireCheckJsonBody
1.4.30
- Add defaultMessageWidget
1.4.29
- Exports some internals and fix version bounds #1318
1.4.28
- Add ToWidget instances for strict text, lazy text, and text builder #1310
1.4.27
- Added jsAttributes#1308
1.4.26
- Modify languagesso that, if you previously calledsetLanguage, the newly set language will be reflected.
1.4.25
- Add instance of MonadHandler and MonadWidget for ExceptT #1278
1.4.24
- cached and cachedBy will not overwrite global state changes #1268
1.4.23.1
- Don’t allow sending multiple cookies with the same name to the client, in accordance with RFC 6265. This fixes an issue where multiple CSRF tokens were sent to the client. #1258
- Default CSRF tokens to the root path “/”, fixing an issue where multiple tokens were stored in cookies, and using the wrong one led to CSRF errors #1248
1.4.23
- urlParamRenderOverride method for Yesod class #1257
- Add laxSameSiteSessions and strictSameSiteSessions #1226
1.4.22
- Proper handling of impure exceptions within HandlerErrorvalues
1.4.21
- Add support for Encodingfromaeson-0.11#1241
1.4.20.2
- GHC 8 support
1.4.20.1
- Log a warning when a CSRF error occurs #1200
1.4.20
- addMessage,- addMessageI, and- getMessagesfunctions
1.4.19.1
- Allow lines of dashes in route files #1182
1.4.19
- Auth logout not working with defaultCsrfMiddleware #1151
1.4.18.2
- Allow subsites within hierarchical routes #1144
1.4.18
- Add hook to apply arbitrary function to all handlers #1122
1.4.17
- Add getApprootText
1.4.16
- Add guessApprootandguessApprootOr
1.4.15.1
- bugfix neverExpires leaked threads
1.4.15
- mkYesod avoids using reify when it isn’t necessary. This avoids needing to define the site type below the call to mkYesod.
1.4.14
- Add CSRF protection functions and middleware based on HTTP cookies and headers #1017
- Add mkYesodWith, which allows creating sites with polymorphic type parameters #1055
- Do not define the site type below a call to mkYesod (or any variant), as it will be required at splicing time for reification. This was allowed before because reification was not in use. Reification was introduced to allow parametrized types to be used by mkYesod (and variants), with potentially polymorphic variables.
1.4.13
1.4.12
- Don’t show source location for logs that don’t have that information #1027
1.4.11
- Expose stripHandlerTandsubHelper
1.4.10
- Export log formatting #1001
1.4.9.1
- Deal better with multiple cookie headers
1.4.9
- Add simple authentication helpers #962
1.4.8.3
- Use 307 redirect for cleaning paths and non-GET requests #951
1.4.8.2
- Allow blaze-builder 0.4
1.4.8.1
- Bump upper bound on path-pieces
1.4.8
- Add a bunch of Semigroupinstances
1.4.7.3
- Remove defunct reference to SpecialResponse #925
1.4.7
SSL-only session security #894
1.4.6.2
monad-control 1.0
1.4.6
Added the Yesod.Core.Unsafe module.
1.4.5
- envClientSessionBackend
- Add MonadLoggerIOinstances (conditional on monad-logger 0.3.10 being used).
1.4.4.5
Support time 1.5
1.4.4.2
neverExpires uses dates one year in the future (instead of in 2037).
1.4.4.1
Improvements to etag/if-none-match support #868 #869
1.4.4
Add the notModified and setEtag functions.
1.4.3
Switch to mwc-random for token generation.
