You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
IHP is a modern batteries-included haskell web framework, built on top of Haskell and Nix. Blazing fast, secure, easy to refactor and the best developer experience with everything you need - from prototype to production.
This release brings some large improvements to the dev environment by integrating devenv.sh, adds native GPT4 support through ihp-openai and much more.
Major Changes
devenv.sh x IHP:
IHP projects now use devenv.sh. devenv is a wrapper around nix flakes that provides fast, declarative, reproducable and composable development environments. It supercedes the previous .envrc approach. Especially projects with lots of dependencies are much faster to open with devenv.
ihp-openai:
The new ihp-openai package adds an easy way to integrate GPT3 and GPT4 to your Haskell web apps. The library is extracted from a production app at digitally induced. Compared to existing haskell libs this library is a streaming API (so works great with IHP AutoRefresh and IHP DataSync), works with the latest Chat API, and has smart retry on error without throwing away tokens. Also it's battle tested in real world production use cases.
moduleWeb.Controller.QuestionswhereimportWeb.Controller.PreludeimportWeb.View.Questions.IndeximportWeb.View.Questions.NewimportWeb.View.Questions.EditimportWeb.View.Questions.ShowimportqualifiedIHP.OpenAIasGPTinstanceControllerQuestionsControllerwhere
action QuestionsAction= autoRefresh do
questions <- query @Question|> orderByDesc #createdAt
|> fetch
render IndexView { .. }
action NewQuestionAction=dolet question = newRecord
|> set #question "What makes haskell so great?"
render NewView { .. }
action CreateQuestionAction=dolet question = newRecord @Question
question
|> fill @'["question"]
|> validateField #question nonEmpty
|> ifValid \caseLeft question -> render NewView { .. }
Right question ->do
question <- question |> createRecord
setSuccessMessage "Question created"
fillAnswer question
redirectTo QuestionsAction
action DeleteQuestionAction { questionId } =do
question <- fetch questionId
deleteRecord question
setSuccessMessage "Question deleted"
redirectTo QuestionsActionfillAnswer:: (?modelContext::ModelContext) =>Question->IO (Async())
fillAnswer question =do-- Put your OpenAI secret key below:let secretKey ="sk-XXXXXXXX"-- This should be done with an IHP job worker instead of async
async doGPT.streamCompletion secretKey (buildCompletionRequest question) (clearAnswer question) (appendToken question)
pure()buildCompletionRequest::Question->GPT.CompletionRequest
buildCompletionRequest Question { question } =-- Here you can adjust the parameters of the requestGPT.newCompletionRequest
{ GPT.maxTokens =512
, GPT.prompt = [trimming|
Question: ${question}
Answer:
|] }
--| Sets the answer field back to an empty stringclearAnswer:: (?modelContext::ModelContext) =>Question->IO()
clearAnswer question =do
sqlExec "UPDATE questions SET answer = '' WHERE id = ?" (Only question.id)
pure()--| Stores a couple of newly received characters to the databaseappendToken:: (?modelContext::ModelContext) =>Question->Text->IO()
appendToken question token =do
sqlExec "UPDATE questions SET answer = answer || ? WHERE id = ?" (token, question.id)
pure()
Bildschirmaufnahme.2023-04-17.um.23.48.41.mov
onlyWhere, onlyWhereReferences and onlyWhereReferencesMaybe:
In IHP code bases you often write filter functions such as these:
getUserPosts user posts =filter (\p -> p.userId == user.id) posts
This can be written in a shorter way using onlyWhere:
getUserPosts user posts =
posts |> onlyWhere #userId user.id
Because the userId field is an Id, we can use onlyWhereReferences to make it even shorter:
getUserPosts user posts =
posts |> onlyWhereReferences #userId user
If the Id field is nullable, we need to use onlyWhereReferencesMaybe:
getUserTasks user tasks =
tasks |> onlyWhereReferences #optionalUserId user
GHC 9.2.4 -> 9.4.4
We've moved to a newer GHC version 👍
Initalizers
You can now run code on the start up of your IHP app using an initializer. For that you can call addInitializer from your project's Config.hs.
The following example will print a hello world message on startup:
This is especially useful when using IHP's Row level security helpers. If your app is calling ensureAuthenticatedRoleExists from the FrontController, you can now move that to the app startup to reduce latency of your application:
Faster Initial Startup for large IHP Apps:
The Generated.Types module is a module generated by IHP based on your project's Schema.sql. The module is now splitted into multiple sub modules, one for each table in your Schema.sql. This makes the initial startup of your app faster, as the individual sub modules can now be loaded in parallel by the compiler.
Static Files Changes:
IHP is now using the more actively maintained wai-app-static instead of wai-middleware-static for serving files from the static/ directory.
The old wai-middleware-static had some issues, particular related to leaking file handles. Also wai-app-static has better cache handling for our dev mode.
You might see some changes related to caching of your app's static files:
files in static/vendor/ previously had more aggressive caching rules, this is not supported anymore.
files in dev mode are now cached with maxage=0 instead of Cache-Control: nocache
application assets are now cached forever. As long as you're using IHP's asssetPath helper, this will not cause any issues.
Additionally the routing priority has changed to save some syscall overhead for every request:
Previously:
GET /test.txt
Does file exists static/test.txt?
=> If yes: return file
=> If no: run IHP router to check for an action matching /test.txt
Now:
GET /test.txt
Run IHP router to check for an action matching /test.txt
Is there an action matching this?
=> If yes: Run IHP action
=> If no: Try to serve file static/test.txt?
.env Files:
Next to the .envrc, you can now save secrets outside your project repository by putting them into the .env file.
The .env is not committed to the repo, so all secrets are safe against being accidentally leaked.
HSX Comments:
You can now write Haskell comments inside HSX expressions:
render MyView { .. } = [hsx|
<div>
{- This is a comment and will not render to the output -}
</div>
|]
HSX Doctype:
HTML Doctypes are now supported in HSX. Previously you had to write them by using the underlying blaze-html library:
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
IHP is a modern batteries-included haskell web framework, built on top of Haskell and Nix. Blazing fast, secure, easy to refactor and the best developer experience with everything you need - from prototype to production.
This release brings some large improvements to the dev environment by integrating devenv.sh, adds native GPT4 support through ihp-openai and much more.
Major Changes
devenv.sh x IHP:
IHP projects now use devenv.sh. devenv is a wrapper around nix flakes that provides fast, declarative, reproducable and composable development environments. It supercedes the previous
.envrc
approach. Especially projects with lots of dependencies are much faster to open with devenv.ihp-openai:
The new
ihp-openai
package adds an easy way to integrate GPT3 and GPT4 to your Haskell web apps. The library is extracted from a production app at digitally induced. Compared to existing haskell libs this library is a streaming API (so works great with IHP AutoRefresh and IHP DataSync), works with the latest Chat API, and has smart retry on error without throwing away tokens. Also it's battle tested in real world production use cases.The package can be found in the IHP repo and a demo project can be found on GitHub as well.
Example:
Bildschirmaufnahme.2023-04-17.um.23.48.41.mov
onlyWhere
,onlyWhereReferences
andonlyWhereReferencesMaybe
:In IHP code bases you often write filter functions such as these:
This can be written in a shorter way using
onlyWhere
:Because the
userId
field is an Id, we can useonlyWhereReferences
to make it even shorter:If the Id field is nullable, we need to use
onlyWhereReferencesMaybe
:GHC 9.2.4 -> 9.4.4
We've moved to a newer GHC version 👍
Initalizers
You can now run code on the start up of your IHP app using an initializer. For that you can call
addInitializer
from your project'sConfig.hs
.The following example will print a hello world message on startup:
This is especially useful when using IHP's Row level security helpers. If your app is calling
ensureAuthenticatedRoleExists
from theFrontController
, you can now move that to the app startup to reduce latency of your application:Multiple Record Forms
You can now use
nestedFormFor
to make nested forms with the IHP form helpers. This helps solve more complex form use cases.Here's a code example:
You can find a demo app here.
Faster Initial Startup for large IHP Apps:
The
Generated.Types
module is a module generated by IHP based on your project'sSchema.sql
. The module is now splitted into multiple sub modules, one for each table in yourSchema.sql
. This makes the initial startup of your app faster, as the individual sub modules can now be loaded in parallel by the compiler.Static Files Changes:
IHP is now using the more actively maintained
wai-app-static
instead ofwai-middleware-static
for serving files from thestatic/
directory.The old
wai-middleware-static
had some issues, particular related to leaking file handles. Alsowai-app-static
has better cache handling for our dev mode.You might see some changes related to caching of your app's static files:
static/vendor/
previously had more aggressive caching rules, this is not supported anymore.maxage=0
instead ofCache-Control: nocache
asssetPath
helper, this will not cause any issues.Additionally the routing priority has changed to save some syscall overhead for every request:
Previously:
Now:
.env
Files:Next to the
.envrc
, you can now save secrets outside your project repository by putting them into the.env
file.The
.env
is not committed to the repo, so all secrets are safe against being accidentally leaked.HSX Comments:
You can now write Haskell comments inside HSX expressions:
HSX Doctype:
HTML Doctypes are now supported in HSX. Previously you had to write them by using the underlying blaze-html library:
Minor Changes
accessDeniedWhen
Notable Documentation Changes
Full Changelog: v1.0.0...v1.1.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 (right at the bottom of the page). Or follow digitally induced on twitter.
This discussion was created from the release v1.1.0.
Beta Was this translation helpful? Give feedback.
All reactions