v0.15.0 (Beta 18.10.2021)

[mpscholten]

A new IHP release with new features and many bug fixes. This release also includes the Stripe Integration and Docker support for IHP Pro and IHP Business users 🚀

Major Changes

• 💰 Payments with Stripe:
  This version finally ships one of the most requested features, the Stripe Integration. With the new Stripe Integration you can easily deal with payments and subscriptions in your projects. If you ever wanted to build as SaaS with Haskell, today is the best day to start! 💻
  Learn how to integration Stripe in the Documentation

• 📦 Docker Support:
  Thanks to the new docker integration it's now easier than ever to ship your IHP apps into production!
  Learn how to deploy with Docker

• 🕸️ SEO Improvements:
  You can now dynamically manage meta tags like <meta property="og:description" content="dynamic content"/> in your IHP apps
  Learn how to manage OG meta tags

• 🌐 HTML in Validation Error Messages:
  You can now use attachFailureHtml if you want to write a custom validation logic that uses HTML in it's error message:

  post
      |> attachFailureHtml #title [hsx|Invalid value. <a href="https://example.com/docs">Check the documentation</a>|]
      -- Link will work as expected, as it's HSX

  Learn more about HTML validation errors in the documentation

• 🔍 Documentation Search:
  There's now a new Agolia-based Search in the IHP Documentation
  Search for Something
  

• 🎨 New Design for the API Reference:
  Our haddock-based API reference now has a custom CSS that gives it a stunning new look!
  Check out the API Reference
  TODO: ADD PICTURE

• 💽 Auto-generated Migrations:
  The Schema Designer now keeps track of your changes. Whenever you generate a new migration from the Web-based Code Generator or the new-migration CLI command, it will prefill the .sql file with the steps needed to migrate.

• 🧰 Tooling Updates:
  We've updated several packages available in your IHP development environment:

  GHC: 8.10.5 -> 8.10.7
  Haskell Language Server: 1.1.0.0 -> 1.4.0.0
  

• 🧪 Testing Improvements:
  Test modules now are run in their own separate database. On test start IHP will create a new database and import the Application/Schema.sql. After test completion the database is deleted.

  In previous IHP versions tests used the development database by default.

  Here's an example of how controllers tests can now look like:

  module Test.Controller.PostsSpec where
  
  import Network.HTTP.Types.Status
  
  import IHP.Prelude
  import IHP.QueryBuilder (query)
  import IHP.Test.Mocking
  import IHP.Fetch
  
  import IHP.FrameworkConfig
  import IHP.HaskellSupport
  import Test.Hspec
  import Config
  
  import Generated.Types
  import Web.Routes
  import Web.Types
  import Web.Controller.Posts ()
  import Web.FrontController ()
  import Network.Wai
  import IHP.ControllerPrelude
  
  tests :: Spec
  tests = aroundAll (withIHPApp WebApplication config) do
          describe "PostsController" $ do
              it "has no existing posts" $ withContext do
                  count <- query @Post
                      |> fetchCount
                  count `shouldBe` 0
  
              it "calling NewPostAction will render a new form" $ withContext do
                  mockActionStatus NewPostAction `shouldReturn` status200
  
              it "creates a new post" $ withParams [("title", "Post title"), ("body", "Body of post")] do
                  response <- callAction CreatePostAction
  
                  let (Just location) = (lookup "Location" (responseHeaders response))
                  location `shouldBe` "http://localhost:8000/Posts"
  
                  -- Only one post should exist.
                  count <- query @Post |> fetchCount
                  count `shouldBe` 1
  
                  -- Fetch the new post.
                  post <- query @Post |> fetchOne
  
                  get #title post `shouldBe` "Post title"
                  get #body post `shouldBe` "Body of post"
  
              it "can show posts" $ withContext do
                  post <- newRecord @Post
                      |> set #title "Lorem Ipsum"
                      |> set #body "**Mark down**"
                      |> createRecord
  
                  response <- callAction ShowPostAction { postId = get #id post }
  
                  response `responseStatusShouldBe` status200
                  response `responseBodyShouldContain` "Lorem Ipsum"
  
                  -- For debugging purposes you could do the following, to
                  -- see the HTML printed out on the terminal.
                  body <- responseBody response
                  putStrLn (cs body)

  Inside the test you can use withUser to call an action as a logged in user:

  -- Create a user for our test case
  user <- newRecord @User
      |> set #email "[email protected]"
      |> createRecord
  
  -- Log into the user and then call CreatePostAction
  response <- withUser user do
      callAction CreatePostAction

Other Changes

• Added note on GitPod to install docs
• Export Control.Monad.Fail.fail from IHP.Prelude
• Use IHP logger instead of directly printing to output in the dev server
• Fix bug regarding order of fields in data editor
• Replaced setProcessLimits with custom ulimits in start script: The setProcessLimits was not working as expected
• Reduce memory usage by IHP dev server
• Add an example of the BlazeHTML equivalent of HSX
• potential mod for create form actions to helpers.js so that it is the same with and without Turbolinks on Left branch from failed form submission.
• Modified codegen to include app.js in ihp boilerplate static
• remove some unneeded/wrong rounded corners
• add matchesRegex validator
• add isSlug validator
• add missing INLINABLEs
• Fixed queryOr causing strange type errors in complex Queries.
• Fixed generated jobs not having run_at column
• Improved error handling when database state is messed up
• Simplified layout of pagination to get rid of the horizontal scrollbar.
• Added documentation for running IHP dev tooling on hosts other than localhost
• Fixed live reloading not working if the dev server is not running on localhost
• Support https urls in live reloading
• Fixed hardcoded localhost url in devtool navigation
• Reference new gitpod ihp template in the docs
• Fixed outdated documentation on the request context
• Added documentation on how to customize the page title
• Added documentation on layout variables
• Added documentation on how to deal with multi records in a single form
• add setMaybe which ignores updates on Nothing
• The Config/client_session_key.aes can now be set via the IHP_SESSION_SECRET env var
• Improved cross compiling support of IHP (needed for the docker integration)
• Added missing attributes to HSX: frameborder, allow, allowfullscreen
• Added example projects section
• Update OAuth documentation
• Fixed fill not able to deal with certain JSON bodies
• Added a onlyAllowMethods function to filter for specific methods when building custom routing parsers
• Re-export some more IHP apis
• Added new validationResult and validationResultMaybe form helpers to render validation errors with custom form fields
• Added Table record instance: This new instance will be used for further simplifications of the database APIs
• Use explicit list of columns in SELECT queries instead of using SELECT *: This avoids issues when the database schema is being migrated
• Show database outdated error screen if column is missing exception is thrown
• Added notes on how to order with collectionFetchRelated
• Replaced nub with nubOrd/nubInt which are more efficient
• Fixed redirectTo not working in controllers where no view is imported
• Don't use scientific notation in input fields with float / double values
• Added documentation on how to render a many to many index view
• Support ENABLE ROW LEVEL SECURITY statements in Schema.sql
• Changed submit button default text from 'Create CamelCase' to 'Create Camel Case'
• Improved docs for fetchRelated
• Parse a larger set of CREATE FUNCTION statements
• added support for CREATE POLICY statements
• Add note about multiple nested resources
• Added renderJsonWithStatusCode
• Fixed livereloading.js still using :8002, even though it's :8001 now
• All function names in the Documentation now link to the API Reference
• Fixed parenthese not correctly applied in SQL Compiler.
• Added help icon in dev tools
• create filterWherePast and filterWhereFuture functions
• Fixed makefile sometimes returning a successful exit code even though compilation failed
• Add example how to link to Jobs
• Expand docs on Raw SQL Queries
• Cleaned up redundant constraints and unused imports
• Attempt to fix Testing docs
• Add local with MailHog instructions
• Added cache busting to the IHP Dev server
• Show IHP version in help menu
• Added upgrade to IHP Pro button
• Added more examples: chat and blog
• Add missing case for Job renderStatus
• Added notes on hoogle
• Add paramListOrNothing function
• Do not read global packages in run-script
• Fixed Data Editor turning NULL values into empty strings when editing a row
• Improve error message when JSON view is not implemented
• Evaluate initial auto refresh response to HNF to fix unexpected behaviour when there's an error in the response
• Added support for CREATE SEQUENCE statements
• Added maxConcurrency option for throttling job worker concurrency
• Fixed Nothing in test output
• Use ByteString's in the Session API instead of inefficent haskell String's
• Simplified duplicate session vault handling logic
• Removed session helper functions: Most of the removed functions haven't been used in real world applications. So let's get rid of them.
• Configure asset version using FrameworkConfig: The previous approach evaluated two env vars on every web request which is not efficient

Migration

• NixConfig
• Validation Messages
• Application/Migration/unmigrated-changes.sql on .gitignore
• cbfee68
• Invalidates Session Cookies

Pull Requests

• Specify Web/Types.hs by @dharmatech in Specify Web/Types.hs #1058
• Export Control.Monad.Fail.fail from IHP.Prelude by @mpscholten in Export Control.Monad.Fail.fail from IHP.Prelude #1059
• Add note regarding the fromLabel @"companyId" bug by @dharmatech in Add note regarding the fromLabel @"companyId" bug #1060
• Fix bug regarding order of fields in data editor by @joshua-obritsch in Fix bug regarding order of fields in data editor #1061
• Import cleanup by @mpscholten in Import cleanup #1062
• Link to BlazeHtml by @dharmatech in Link to BlazeHtml #1063
• Fix typo by @dharmatech in Fix typo #1065
• Add an example of the BlazeHTML equivalent of HSX by @dharmatech in Add an example of the BlazeHTML equivalent of HSX #1064
• potential mod for create form actions to helpers.js by @Montmorency in potential mod for create form actions to helpers.js  #1066
• Fix typo (it's -> its) by @dharmatech in Fix typo (it's -> its) #1067
• fix a couple of it's -> its by @hendi in fix a couple of it's -> its #1072
• remove some unneeded/wrong rounded corners by @hendi in remove some unneeded/wrong rounded corners #1073
• add matchesRegex validator by @hendi in add matchesRegex validator #1074
• Slug validator by @hendi in Slug validator #1076
• Typo on ContentType in CanSelect form docs. by @Montmorency in Typo on ContentType in CanSelect form docs. #1078
• Fixed queryOr causing strange type errors in complex Queries. by @mpscholten in Fixed queryOr causing strange type errors in complex Queries. #1081
• Codegen app.js by @Montmorency in Codegen app.js #1079
• Simplified layout of pagination to get rid of the horizontal scrollba… by @mpscholten in Simplified layout of pagination to get rid of the horizontal scrollba… #1082
• add setIfJust which ignores updates on Nothing by @hendi in add setIfJust which ignores updates on Nothing #1088
• Update OAuth documentation by @GarrisonJ in Update OAuth documentation #1090
• Added support for using HTML inside validation error messages by @mpscholten in Added support for using HTML inside validation error messages #1094
• Add note about multiple nested resources by @amitaibu in Add note about multiple nested resources #1101
• More multiple Include docs by @amitaibu in More multiple Include docs #1102
• Add missing src on <script> tag in docs by @amitaibu in Add missing src on <script> tag in docs #1105
• fix upgrade.md for 0.13.0 -> 0.13.1 by @CSchank in fix upgrade.md for 0.13.0 -> 0.13.1 #1106
• link api docs in guide by @jeyj0 in link api docs in guide #1104
• DataSync by @mpscholten in DataSync #1103
• create filterWherePast and filterWhereFuture functions by @jeyj0 in create filterWherePast and filterWhereFuture functions #1107
• Fix typo in make file by @amitaibu in Fix typo in make file #1111
• Add example how to link to Jobs by @amitaibu in Add example how to link to Jobs #1119
• Fix typo: paramaters->parameters by @stianlagstad in Fix typo: paramaters->parameters #1118
• Fix docs about Retrieving All Error Messages by @amitaibu in Fix docs about Retrieving All Error Messages #1117
• Expand docs on Raw SQL Queries by @amitaibu in Expand docs on Raw SQL Queries #1124
• Add missing case for Job renderStatus by @amitaibu in Add missing case for Job renderStatus #1131
• Add local mail testing with MailHog instructions by @amitaibu in Add local mail testing with MailHog instructions #1127
• Doc for Type errors in build/Generated/Types.hs by @amitaibu in Doc for Type errors in build/Generated/Types.hs #1132
• Add paramListOrNothing function by @amitaibu in Add paramListOrNothing function #1130
• Fix wrong dir in docs by @amitaibu in Fix wrong dir in docs #1133
• run-script Do not read global packages by @s0kil in run-script Do not read global packages #1135
• Improve error message when JSON view is not implemented by @amitaibu in Improve error message when JSON view is not implemented #1139
• Updated to a recent nixpkgs version and updated ghc to 8.10.7 by @mpscholten in Updated to a recent nixpkgs version and updated ghc to 8.10.7 #1138
• Added auto-migration based on operation tracking approach by @mpscholten in Added auto-migration based on operation tracking approach #1136
• Refactored request/response mocking to use runActionWithNewContext. by @mpscholten in Refactored request/response mocking to use runActionWithNewContext. #1141
• Added maxConcurrency option for throttling job worker concurrency by @mpscholten in Added maxConcurrency option for throttling job worker concurrency #1144
• Add docs about Jobs concurrency by @amitaibu in Add docs about Jobs concurrency #1148
• Improved testing functionality by @mpscholten in Improved testing functionality #1146
• Session refactoring by @mpscholten in Session refactoring #1149
• Fix Testing docs by @amitaibu in Fix Testing docs #1126
• Upgrade tests docs by @amitaibu in Upgrade tests docs #1150

New Contributors

• @amitaibu made their first contribution in Add note about multiple nested resources #1101 🎉

Full Changelog: v0.14.0...v0.15.0

Feature Voting

Help decide what's coming next to IHP by using the Feature Voting!

Updating

See the UPGRADE.md for upgrade instructions.

If you have any problems with updating, let us know on the IHP forum.

📧 To stay in the loop, subscribe to the IHP release emails. Or follow digitally induced on twitter.

---

This discussion was created from the release v0.15.0 (Beta 18.10.2021).