Hell notes

0readme.md

0. CoreFn Expr: https://github.com/purescript/purescript/blob/ee0b3d391151bcd5f56de4563208dcf657cccc8c/src/Language/PureScript/CoreFn/Expr.hs
1. CoreFn Module: https://github.com/purescript/purescript/blob/ee0b3d391151bcd5f56de4563208dcf657cccc8c/src/Language/PureScript/CoreFn/Module.hs
2. https://github.com/purescript/purescript/blob/ee0b3d391151bcd5f56de4563208dcf657cccc8c/src/Language/PureScript/Make.hs

0reasons.md

Reasons to do this

Docker 7e6569bbc29b brossa $ scripts/upload-product.sh localhost artificial/simple
scripts/upload-product.sh localhost artificial/simple
scripts/upload-product.sh: line 18: $3: unbound variable

example-small.purs

#!/bin/hell
hell 2022-01-01:0

import Hell
import Git https://hell-shell.org/git@sha256:4bac27393bdd9777ce02453256c5577cd02275510b2227f473d03f533924f877

main = do
  root <- Git.toplevel
  let dir = root <> "/brossa/"
  Hell.runDir dir "hpack" []?
  Hell.runArgs dir "cabal" ["build"]

example.purs

#!/bin/hell
hell 2022-01-01:0
-- must come before any other line apart from shebangs (if any)
-- must be exactly the major version
-- minor version of the binary is allowed to be newer than the one specified in file

-- must be imported explicitly, because it can be omitted too. 
import Hell
import Git https://hell-shell.org/git@sha256:4bac27393bdd9777ce02453256c5577cd02275510b2227f473d03f533924f877

-- must be specified when there's a shebang
main = do
  root <- Git.toplevel
  let dir = root <> "/brossa/"
  Hell.runDir dir "hpack" []?
  Hell.runArgs dir "cabal" ["build"]

Git.purs

hell 2022-01-01:0

module Git (toplevel) where

import Hell

toplevel = readArgs "git" ["rev-parse", "--show-toplevel"]

imports.purs

-- modules are qualified by default, no implicit imports allowed!

-- local
import Foo.Bar 

-- local, verified
import sha256:sdf87sdfn9sd87fsdfn Foo.Bar

-- remote
import https://foo.bar/bob Foo.Bar

-- remote, verified
import sha256:sdf87sdfn9sd87fsdfn https://foo.bar/bob Foo.Bar