on fe233ff help sign in
.github/pull_request_template.mddeleted−10
since splitsnapshots
unifiedsplit
@@ -1,10 +0,0 @@
1−<!-- Provide a clear overview of your changes. -->
2−
3−I have:
4−
5− - [ ] Based work on latest `develop` branch
6− - [ ] Followed the [contribution guide](https://github.com/obsidiansystems/obelisk/blob/develop/CONTRIBUTING.md#submitting-changes)
7− - [ ] Looked for lint in my changes with `hlint .` (lint found code you did not write can be left alone)
8− - [ ] Run the test suite: `$(nix-build -A selftest --no-out-link)`
9− - [ ] [Updated the changelog](https://github.com/obsidiansystems/obelisk/blob/develop/CONTRIBUTING.md#in-the-changelog)
10− - [ ] (Optional) Run CI tests locally: `nix-build release.nix -A build.x86_64-linux --no-out-link` (or `x86_64-darwin` on macOS)
.gitignore−1
@@ -2,7 +2,6 @@
2**/.cabal-sandbox
2**/.cabal-sandbox
3**/cabal.sandbox.config
3**/cabal.sandbox.config
4result
4result
5−result-*
6*.o
5*.o
7*.hi
6*.hi
8TAGS
7TAGS
.hlint.yamldeleted−65
@@ -1,65 +0,0 @@
1−# HLint configuration file
2−# https://github.com/ndmitchell/hlint
3−##########################
4−
5−# This file contains a template configuration file, which is typically
6−# placed as .hlint.yaml in the root of your project
7−
8−
9−# Specify additional command line arguments
10−#
11−# - arguments: [--color, --cpp-simple, -XQuasiQuotes]
12−
13−
14−# Control which extensions/flags/modules/functions can be used
15−#
16−# - extensions:
17−# - default: false # all extension are banned by default
18−# - name: [PatternGuards, ViewPatterns] # only these listed extensions can be used
19−# - {name: CPP, within: CrossPlatform} # CPP can only be used in a given module
20−#
21−# - flags:
22−# - {name: -w, within: []} # -w is allowed nowhere
23−#
24−# - modules:
25−# - {name: [Data.Set, Data.HashSet], as: Set} # if you import Data.Set qualified, it must be as 'Set'
26−# - {name: Control.Arrow, within: []} # Certain modules are banned entirely
27−#
28−# - functions:
29−# - {name: unsafePerformIO, within: []} # unsafePerformIO can only appear in no modules
30−
31−
32−# Add custom hints for this project
33−#
34−# Will suggest replacing "wibbleMany [myvar]" with "wibbleOne myvar"
35−# - error: {lhs: "wibbleMany [x]", rhs: wibbleOne x}
36−
37−
38−# Turn on hints that are off by default
39−#
40−# Ban "module X(module X) where", to require a real export list
41−# - warn: {name: Use explicit module export list}
42−#
43−# Replace a $ b $ c with a . b $ c
44−# - group: {name: dollar, enabled: true}
45−#
46−# Generalise map to fmap, ++ to <>
47−# - group: {name: generalise, enabled: true}
48−
49−
50−# Ignore some builtin hints
51−- ignore: {name: Redundant do}
52−- ignore: {name: Redundant flip}
53−- ignore: {name: Use <$>}
54−- ignore: {name: Use camelCase}
55−- ignore: {name: Use if}
56−- ignore: {name: Use unless}
57−# - ignore: {name: Use const, within: SpecialModule} # Only within certain modules
58−
59−
60−# Define some custom infix operators
61−# - fixity: infixr 3 ~^#^~
62−
63−
64−# To generate a suitable file for HLint do:
65−# $ hlint --default > .hlint.yaml
CONTRIBUTING.md−57
@@ -5,10 +5,8 @@ Contributions and issue reports are encouraged and appreciated!
5- [Opening Issues](#opening-issues)
5- [Opening Issues](#opening-issues)
6- [Submitting Changes](#submitting-changes)
6- [Submitting Changes](#submitting-changes)
7 - [Guidelines for Commit Messages](#guidelines-for-commit-messages)
7 - [Guidelines for Commit Messages](#guidelines-for-commit-messages)
8− - [Guidelines for Pull Requests](#guidelines-for-pull-requests)
9 - [Code Quality](#code-quality)
8 - [Code Quality](#code-quality)
10 - [Documentation](#documentation)
9 - [Documentation](#documentation)
11−- [Development Environment](#development-environment)
12
10
13## Opening Issues
11## Opening Issues
14
12
@@ -36,11 +34,6 @@ Commits that update a dependency should include some information about why the d
36#### Body
34#### Body
37For breaking changes, new features, refactors, or other major changes, the body of the commit message should describe the motivation behind the change in greater detail and may include references to the issue tracker. The body shouldn't repeat code/comments from the diff.
35For breaking changes, new features, refactors, or other major changes, the body of the commit message should describe the motivation behind the change in greater detail and may include references to the issue tracker. The body shouldn't repeat code/comments from the diff.
38
36
39−### Guidelines for Pull Requests
40−
41−Wherever possible, pull requests should add a single feature or fix a single bug. Pull requests should not bundle several unrelated changes.
42−
43−
44### Code Quality
37### Code Quality
45
38
46#### Warnings
39#### Warnings
@@ -79,53 +72,3 @@ Add an entry to the changelog when your PR:
79#### In the [Readme](README.md)
72#### In the [Readme](README.md)
80The readme is the first place a lot of people look for information about the repository. Update any parts of the readme that are affected by your PR.
73The readme is the first place a lot of people look for information about the repository. Update any parts of the readme that are affected by your PR.
81
74
82−
83−## Development Environment
84−
85−There are two ways to get live compiler feedback while developing Obelisk libraries. For libraries that are dependencies of the `skeleton` application, the easiest way to get feedback is to
86−
87−```bash
88−cd skeleton
89−ob run
90−```
91−
92−This `ob run` session only loads modules that are dependencies of the skeleton and `obelisk-run`. For example, `obelisk-asset` and `obelisk-route` are used by the skeleton.
93−
94−For other libraries like `obelisk-command` you can use `ghcid`. To launch `ghcid` for `lib/command` you can run
95−
96−```bash
97−nix-shell -A obeliskEnvs.obelisk-command --run "cd lib/command && ghcid"
98−```
99−
100−### Building `ob` for testing
101−
102−To re-install `ob` from source globally you can do
103−
104−```bash
105−nix-env -f /path/to/obelisk -iA command
106−```
107−
108−You can also open a shell with the local version of `ob` available on your `$PATH`:
109−
110−```bash
111−nix run -f /path/to/obelisk command
112−```
113−
114−### Hacking on Obelisk from within an Obelisk project
115−
116−`ob` will defer to the version found in your project's `.obelisk/impl` directory. To work on that version specifically:
117−
118−```bash
119−ob thunk unpack ./.obelisk/impl
120−cd ./.obelisk/impl
121−# apply your changes
122−```
123−
124−If you want to commit your changes, first push them to your fork of obelisk and then
125−
126−```bash
127−cd /your/project/root
128−ob thunk pack .obelisk/impl
129−git add .obelisk/impl
130−git commit -m "Bump obelisk"
131−```
ChangeLog.md+4−129
@@ -1,141 +1,16 @@
1# Revision history for obelisk
1# Revision history for obelisk
2
2
3−This project's release branch is `master`. This log is written from the perspective of the release branch: when changes hit `master`, they are considered released.
3+This project's release branch is `master`. This log is written from the perspective of the release branch: when changes hit `master`, they are considered released, and the date should reflect that release.
4−
5−## v0.9.1.0
6−
7−* [#801](https://github.com/obsidiansystems/obelisk/pull/801): Remove errors and warning for local packages without a library component
8−* [#812](https://github.com/obsidiansystems/obelisk/pull/812): Add support for `NoImplicitPrelude` and other extensions disabled via `No`
9−* Pinned version bumps:
10− * reflex-platform [0.7.0.0](https://github.com/reflex-frp/reflex-platform/releases/tag/v0.7.0.0)
11− * hnix 0.8.0
12−* [#787](https://github.com/obsidiansystems/obelisk/pull/787): Set `immutable` cache control directive when serving content-addressed static assets
13−* Use iOS SDK 13.2
14−
15−
16−## v0.9.0.1
17−
18−* ([#810](https://github.com/obsidiansystems/obelisk/pull/810)) Fix loading of `all.js` in fully compiled web apps.
19−
20−## v0.9.0.0
21−
22−* **(Breaking change)** Backport nixpkgs upgrades to ACME/Let's Encrypt handling so that HTTPS deployments continue to work flawlessly. If your deployment is having trouble renewing [Let's Encrypt](https://letsencrypt.org/) certificates, upgrade to this version.
23− * **IMPORTANT:** In order to use [Let's Encrypt](https://letsencrypt.org/) you must now accept their [terms of service](https://letsencrypt.org/repository/). To do that, add `terms.security.acme.acceptTerms = true;` to the `import ./.obelisk/impl {` section in your `default.nix`. The new skeleton application may serve as an [example](https://github.com/obsidiansystems/obelisk/blob/4759342ab3570888c027d4c58cb5694cb832d624/skeleton/default.nix#L13).
24−* Update reflex-platform dependency to v0.6.0.0
25−* ([#715](https://github.com/obsidiansystems/obelisk/pull/715)) In `Obelisk.Route` deprecate `isoEncoder` and `prismEncoder` in favor of more precisely named `viewEncoder` and `reviewEncoder` (respectively) and improve documentation regarding contravariance of `reviewEncoder`.
26−* ([#739](https://github.com/obsidiansystems/obelisk/pull/739)) Improve `ob shell` by allowing commands to be passed verbatim after a `--` argument. For example, `ob shell 'run command'` can now be written `ob shell -- run command`.
27−* ([#735](https://github.com/obsidiansystems/obelisk/pull/735)) Fix regression causing custom `Prelude`s to break `ob run`/`ob watch`/`ob repl`.
28−* ([#737](https://github.com/obsidiansystems/obelisk/pull/737)) Fix bug causing custom `Prelude`s to break `ob profile`.
29−* ([#752](https://github.com/obsidiansystems/obelisk/pull/752)) Fix the `ob` command-line tool to return non-zero exit code when underlying processes fail.
30−* ([#742](https://github.com/obsidiansystems/obelisk/pull/742), [#57](https://github.com/obsidiansystems/obelisk/pull/57), [#406](https://github.com/obsidiansystems/obelisk/pull/406)) Enable `-dedupe` and `-DGHCJS_BROWSER` in GHCJS builds to make JavaScript output considerably smaller leading to faster load/parse times and faster build times.
31− * **Migration:** New Obelisk projects will automatically benefit from this change, but existing projects need to apply a change similar to [this one](https://github.com/obsidiansystems/obelisk/blob/371cb3302085601c5ec73e9574d51c8b95e3e493/skeleton/frontend/frontend.cabal#L32-L34).
32−* ([#742](https://github.com/obsidiansystems/obelisk/pull/742)) Update `reflex-platform` which includes:
33− * A new version of GHCJS where `-dedupe` is fixed.
34−
35−## v0.8.0.0
36−
37−* ([#674](https://github.com/obsidiansystems/obelisk/pull/674), [#711](https://github.com/obsidiansystems/obelisk/pull/711)) Introduce a new thunk format to support accessing the thunk's source directly when packed. When packed, thunks have an additional file called `thunk.nix` and `default.nix` is now a thin wrapper around that.
38−* ([#665](https://github.com/obsidiansystems/obelisk/pull/665)) Add `--interpret` and `--no-interpret` options to `ob run`/`ob watch`/`ob repl`/`ob shell`. These options allow you to pick which paths will be pre-compiled by `nix` when entering the shell/session and which won't. For example `ob run --no-interpret dep` will ensure that any dependencies found in `./dep` will be built by `nix` before loading the rest of the project into the `ghci` session. The same configuration for `ob shell` will ensure that those packages are built and available in the `ghc` package database inside the shell.
39−
40− **NOTE:** `ob shell`'s default behavior is now different. By default it now behaves like `ob run`/`ob watch`/`ob repl` in that it does *not* pre-build any packages whose `.cabal` or `package.yaml` files are found in the project. To regain the previous behavior, use `ob shell --no-interpret . --interpret backend --interpret common --interpret frontend` from the project root.
41−* ([#695](https://github.com/obsidiansystems/obelisk/pull/695)) `ob deploy init` now requires that your obelisk project be a clean `git` checkout with pushed changes. It has always required that your obelisk project be a `git` repository, but it did not require that your local changes be committed and pushed. This new requirement is added to ensure users don't accidentally create a deployment pointing to an old version of the project.
42−* ([#705](https://github.com/obsidiansystems/obelisk/pull/705)) Add `Obelisk.Route.packTextEncoder` and generalize `Obelisk.Route.unpackTextEncoder` over any `Data.Text.Lens.IsText`.
43−* ([#712](https://github.com/obsidiansystems/obelisk/pull/712)) Update [`reflex-platform`](https://github.com/reflex-frp/reflex-platform) to version 0.5.3.0.
44−* ([#700](https://github.com/obsidiansystems/obelisk/pull/700)) Ensure `ob init` uses the thunk format of the target obelisk rather than the one currently running the init command. If a user had installed a version of obelisk with a new thunk format, a newly initialized skeleton of an older version would not be able to unpack its own `.obelisk/impl`.
45−* ([#693](https://github.com/obsidiansystems/obelisk/pull/693)) Fix a bug where some packages in `.attr-cache` directories would be incorrectly picked up and used instead of the correct ones when using `ob run`/`ob watch`/`ob repl`.
46−* ([#709](https://github.com/obsidiansystems/obelisk/pull/709)) Fix a bug in obelisk's preprocessor causing it to incorrectly skip files in some circumstances.
47−* ([#663](https://github.com/obsidiansystems/obelisk/pull/663)) Add **experimental** support for [`ghcide`](https://github.com/digital-asset/ghcide). See the README for more information.
48−* ([#714](https://github.com/obsidiansystems/obelisk/pull/714)) Miscellaneous improvements to CLI help and logging.
49−
50−## v0.7.0.1
51−
52−* Fix the version number for `ob` the command-line tool. ([#679](https://github.com/obsidiansystems/obelisk/pull/679))
53−
54−## v0.7.0.0
55−
56−* Fully support HTTP [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range) requests on static assets to support Safari. ([#664](https://github.com/obsidiansystems/obelisk/pull/664))
57−* Support non-EC2 deployments. ([#658](https://github.com/obsidiansystems/obelisk/pull/658))
58−* Fix `ob deploy test android` to work. ([#645](https://github.com/obsidiansystems/obelisk/pull/645))
59−* Fix vulnerability where Android deployments would leave signing keys in the nix store which is world readable. ([#645](https://github.com/obsidiansystems/obelisk/pull/645)) (Thanks to [kmicklas](https://github.com/kmicklas) for the report.)
60−* Add `Obelisk.Backend.runBackendWith` to allow several customizations. ([#668](https://github.com/obsidiansystems/obelisk/pull/668), [#644](https://github.com/obsidiansystems/obelisk/pull/644))
61−* Add `ob profile` command to run Obelisk projects with profiling. `ob profile` works like `ob run`, but instead of using `ghci`, it builds an executable that is built with profiling enabled. ([#654](https://github.com/obsidiansystems/obelisk/pull/654))
62−* Obelisk's `default.nix` now exposes `mkAssets` function which is used to construct the assets served by an Obelisk application. ([#651](https://github.com/obsidiansystems/obelisk/pull/651))
63−* Bump reflex-platform to v0.5.2.0. ([#671](https://github.com/obsidiansystems/obelisk/pull/671))
64−
65−## v0.6.0.0 - 2020-02-21
66−
67−* Fix a bug in `Obelisk.Route.Frontend` where `routeLink`, `routeLinkDynAttr`, and `dynRouteLink` would not behave exactly like `<a href="...">` when run by JavaScript. These functions now scroll to the top of the page when the link is clicked. ([#540](https://github.com/obsidiansystems/obelisk/pull/540))
68−* Fix a bug in `ob run`/`ob watch`/`ob repl` where nested Obelisk projects would also be loaded into the session. These are now ignored. ([#652](https://github.com/obsidiansystems/obelisk/pull/652))
69−* Improve behavior of `ob run`/`ob watch`/`ob repl` when multiple packages with the same name are encountered. Obelisk now issues a warning and tells you which one it will use. ([#653](https://github.com/obsidiansystems/obelisk/pull/653))
70−* Removed `Obelisk.Backend.mkRouteToUrl` since it is easily written in terms of `Obelisk.Route.renderObeliskRoute`:
71−
72− mkRouteToUrl validFullEncoder (k :/ v) = renderObeliskRoute validFullEncoder (FullRoute_Frontend (ObeliskRoute_App k) :/ v)
73−
74−* Add `Obelisk.Backend.renderAllJsPath` to expose URL path to `ghcjs/all.js`. ([#545](https://github.com/obsidiansystems/obelisk/pull/545))
75−* Add argument to `serveDefaultObeliskApp`, `serveObeliskApp`, and `serveGhcjsApp` to take the path to `all.js` instead of hard-coding it. ([#545](https://github.com/obsidiansystems/obelisk/pull/545))
76−
77−## v0.5.0.0 - 2020-02-07
78−
79−* Add `Obelisk.Route.(?/)`, a convenience function for constructing routes nested in `Maybe`. ([#457](https://github.com/obsidiansystems/obelisk/pull/457))
80−* Add local unpacked packages to the `ob run`, `ob watch`, and `ob repl` sessions. Any `.cabal` or hpack package inside the current obelisk project will be loaded into the session. For `ob run`/`ob watch` this means the session will automatically reload when you save a source file in any of those packages. For `ob repl` it means that `:r` will reload changes to any of those packages. There are some edge cases where this integration is still rough. Report any issues you encounter. ([#489](https://github.com/obsidiansystems/obelisk/pull/489))
81−* Add `ob hoogle` command to start a local [Hoogle](https://hoogle.haskell.org/) server for the project. ([#628](https://github.com/obsidiansystems/obelisk/pull/628))
82−* `ob thunk pack` will now attempt to automatically detect if the thunk is a private or public repo. To avoid this detection, specify `--private` or `--public` manually. ([#607](https://github.com/obsidiansystems/obelisk/pull/607))
83−* Fix a bug in the plain git thunk loader for thunks marked as 'private' when the revision is not in the default branch. ([#648](https://github.com/obsidiansystems/obelisk/pull/648))
84−* Improve handling of runtime nix dependencies. This may fix some issues encountered particularly by users on systems other than NixOS.
85−
86−## v0.4.0.0 - 2020-01-10
87−
88−* Bump reflex-platform which, notably, bumps nixpkgs to 19.09. ([#585](https://github.com/obsidiansystems/obelisk/pull/585))
89−* Add new thunk loader for Git repositories that supports `file://` Git remotes and supports private repositories via `builtins.fetchGit` for private repositories (when the `git.json` file specifies `"private": true`). ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
90−* Add a new thunk loader for GitHub repositories that uses `builtins.fetchTarball` for public repositories to increase loader performance and uses `fetchFromGitHub` for private repositories (when the `github.json` file specifies `"private": true`). Note that `fetchFromGitHub` requires some Nix configuration for the Nix builder to access the repository. If `ob thunk pack` fails in this case, use `-v` to see Nix's helpful message. ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
91−* Add `--public`/`--private` options to `ob thunk pack` to specify if a repository should be treated as a public or private. ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
92−* Improve error messaging when a dependency doesn't have the expected `.cabal` or `package.yaml` file. ([#597](https://github.com/obsidiansystems/obelisk/pull/597))
93−* Improve the skeleton in small ways. ([#593](https://github.com/obsidiansystems/obelisk/pull/593), [#589](https://github.com/obsidiansystems/obelisk/pull/589))
94−* Fix `ob` commands to again support running from any subdirectory of an obelisk project ([#591](https://github.com/obsidiansystems/obelisk/pull/591))
95−* Add `reflex-platform-func` argument to Obelisk's `default.nix`. It defaults to its prior behavior of using the reflex-platform in in `dep`. ([#612](https://github.com/obsidiansystems/obelisk/pull/612))
96−
97−## v0.3.0.0 - 2019-12-20
98−
99−* Change the structure of Obelisk routes to use a designated
100− `FullRoute` type. This combines frontend and backend routes into one
101− structure. This is a **breaking** change which requires Obelisk apps
102− to take specific migrations. They are:
103− * Rewrite the implementation of `_backend_routeEncoder` in
104− `Backend` to use `mkFullRouteEncoder` instead of
105− `handleEncoder`. Specifically, the backend and frontend cases of
106− the top-level `pathComponentEncoder` become the second and third
107− arguments of `mkFullRouteEncoder` respectively, while the
108− missing route becomes the first argument. An example of how to
109− do this is available in [a reflex-examples
110− commit](https://github.com/reflex-frp/reflex-examples/commits/28f566c3e7dc615578dc74297b7c620c1f13683e).
111− * Replace type constructions of `InL` with `FullRoute_Backend` and
112− `InR` with `FullRoute_Frontend`.
113−* Generalised `pathSegmentEncoder`, added `pathFieldEncoder`.
114−* Added some `Prism`s to the encoder library for manipulating `DSum`s.
115−* Add `ob doc` command, which lists paths to haddock documentation for specified packages.
116−* Bump reflex-platform so that obelisk now uses GHC 8.6.5 and the nixos-19.03 nixpkgs set.
117−* Add support in `obelisk-route` for single parameters in URL paths.
118−* Bump reflex-platform so that obelisk now uses reflex-dom 0.5.2.0.
119−* Use a `--pure` nix shell in `ob run` for parity with `ob repl` and more resilience against "works on my machine".
120−* Pin usages of `<nixpkgs>` in obelisk thunks, etc. to the nixpkgs used by the project's obelisk impl.
121−* Backport ACMEv2 support in obelisk server to regain LetsEncrypt account creation.
122−* Enable HTTPS in `ob run`.
123−* `ob run` now handles `ghci` errors better, and includes a custom `ghcid`
124− version. As a result, you no longer need to have ghcid installed to
125− use `ob run`, as we provide one for you.
126−* `ob` commands now complain less on systems with umasks other than `0022`.
127−* Ignore package environment files in `ob run` and `ob repl`.
128−* Add `Obelisk.Route.Frontend.routeLinkDynAttr`.
129−
130−## v0.2.0.0 - 2019-8-17
131
4
5+## Unreleased
132* Configs become ByteStrings.
6* Configs become ByteStrings.
133* FrontendConfigsT has been changed into ConfigsT and configs are made available via getConfig/getConfigs
7* FrontendConfigsT has been changed into ConfigsT and configs are made available via getConfig/getConfigs
134 * The frontend will still only have access to configs that are placed in config/frontend and config/common, while the backend has access to the entire contents of the config directory via `Obelisk.ExecutableConfig.Lookup.getConfigs`.
8 * The frontend will still only have access to configs that are placed in config/frontend and config/common, while the backend has access to the entire contents of the config directory via `Obelisk.ExecutableConfig.Lookup.getConfigs`.
135* The backend no longer runs in BackendConfigsT.
9* The backend no longer runs in BackendConfigsT.
136* Add tabulation package. See Data.Tabulation for details.
10* Add tabulation package. See Data.Tabulation for details.
137* Add encoders for `DMap`, `HasFields` (cf. Data.Tabulation), and JSON.
11* Add encoders for `DMap`, `HasFields` (cf. Data.Tabulation), and JSON.
138−* Use IP address for nginx proxy pass instead of localhost
12+* Generalised pathSegmentEncoder, added pathFieldEncoder.
13+* Added some Prisms to the encoder library for manipulating DSums (perhaps they should get moved to dependent-sum before release?)
139
14
140## v0.1.1.0 - 2019-05-17
15## v0.1.1.0 - 2019-05-17
141
16
FAQ.md+67−62
@@ -1,70 +1,14 @@
1# Frequently Asked Questions
1# Frequently Asked Questions
2
2
3−1. [How do I declare a new Haskell dependency?](#how-do-i-declare-a-new-haskell-dependency)
4−1. [How do I add or override Haskell dependencies in the package set?](#how-do-i-add-or-override-haskell-dependencies-in-the-package-set)
5−1. [How do I extend my Obelisk application with more local packages?](#how-do-i-extend-my-obelisk-application-with-more-local-packages)
6−1. [How do I use `ob run` over HTTPS?](#how-do-i-use-ob-run-over-https)
7−1. [How do I fix invalid entitlements?](#how-do-i-fix-invalid-entitlements)
3+1. [How do I fix invalid entitlements? ](#how-do-i-fix-invalid-entitlements)
81. [`ob thunk update` or `ob deploy update` fails](#ob-thunk-update-or-ob-deploy-update-fails)
41. [`ob thunk update` or `ob deploy update` fails](#ob-thunk-update-or-ob-deploy-update-fails)
91. [How do I fix `Ambiguous module name` errors?](#how-do-i-fix-ambiguous-module-name-errors)
51. [How do I fix `Ambiguous module name` errors?](#how-do-i-fix-ambiguous-module-name-errors)
10−
6+1. [What does `ob run` actually do?](#what-does-ob-run-actually-do)
11−### How do I declare a new Haskell dependency?
12−
13−Every component of your Obelisk application is a standard [cabal](https://www.haskell.org/cabal/) package. That means declaring new Haskell dependencies simply involves updating the `build-depends` field in the appropriate cabal file (`backend.cabal` for example). By default, Obelisk will use its curated package set to choose which version of each package you get. It's possible that the package you need is not already in the curated set or the curated version isn't the one you want. See [How do I add or override Haskell dependencies in the package set?](#how-do-i-add-or-override-haskell-dependencies-in-the-package-set) for a solution to this.
14−
15−### How do I add or override Haskell dependencies in the package set?
16−
17−To add a Haskell package that doesn't exist in Obelisk's package set or to override the version of a package, use the `overrides` attribute in your project's `default.nix`. For example, to use a specific version of the `aeson` package fetched from GitHub and a specific version of the `waargonaut` package fetched from Hackage, your `default.nix` will look like:
18−
19−```nix
20−# ...
21−project ./. ({ pkgs, ... }: {
22−# ...
23− overrides = self: super: let
24− aesonSrc = pkgs.fetchFromGitHub {
25− owner = "obsidiansystems";
26− repo = "aeson-gadt-th";
27− rev = "ed573c2cccf54d72aa6279026752a3fecf9c1383";
28− sha256 = "08q6rnz7w9pn76jkrafig6f50yd0f77z48rk2z5iyyl2jbhcbhx3";
29− };
30− in
31− {
32− aeson = self.callCabal2nix "aeson" aesonSrc {};
33− waargonaut = self.callHackageDirect {
34− pkg = "waargonaut";
35− ver = "0.8.0.1";
36− sha256 = "1zv28np3k3hg378vqm89v802xr0g8cwk7gy3mr77xrzy5jbgpa39";
37− } {};
38− };
39−# ...
40−```
41−
42−For further information see [the Haskell section](https://nixos.org/nixpkgs/manual/#users-guide-to-the-haskell-infrastructure) of nixpkgs "Contributors Guide".
43−
44−### How do I extend my Obelisk application with more local packages?
45−
46−If the standard packages (`frontend`, `backend`, and `common`) are not enough, you may add more local packages by defining them with the `packages` attribute in your `default.nix`. The sources of these packages will be automatically loaded by `ob run`/`ob repl`/etc.
47−
48−```nix
49−# ...
50−project ./. ({ pkgs, ... }: {
51−# ...
52− packages = {
53− another = ./dep/another;
54− };
55−# ...
56−```
57−
58−### How do I use `ob run` over HTTPS?
59−
60−To run your app locally over HTTPS, update the protocol in `config/common/route` to `https`, and then use `ob run` as normal.
61−
62−Obelisk generates a self-signed certificate for running HTTPS so the browser will issue a warning about using an invalid certificate. On Chrome, you can go to `chrome://flags/#allow-insecure-localhost` to enable invalid certificates for localhost.
63−
64
7
65### How do I fix invalid entitlements?
8### How do I fix invalid entitlements?
66
9
67−You probably did not set `ios.bundleIdentifier` correctly in `default.nix`. When this happens you'll see an error something like this:
10+You probably did not set `ios.bundleIdentifier` correctly in `default.nix`.
11+When this happens you'll see an error something like this:
68
12
69```
13```
702018-11-25 09:34:22.438 ios-deploy[58106:8521046] [ !! ] Error 0xe8008016: The executable was signed with invalid entitlements. AMDeviceSecureInstallApplication(0, device, url, options, install_callback, 0)
142018-11-25 09:34:22.438 ios-deploy[58106:8521046] [ !! ] Error 0xe8008016: The executable was signed with invalid entitlements. AMDeviceSecureInstallApplication(0, device, url, options, install_callback, 0)
@@ -75,7 +19,7 @@ Fixing the value of `ios.bundleIdentifier` should fix the error.
75### `ob thunk update` or `ob deploy update` fails
19### `ob thunk update` or `ob deploy update` fails
76Whenever an `ob` command fails, try re-running it with `-v`.
20Whenever an `ob` command fails, try re-running it with `-v`.
77
21
78−If you're using a private repo, and you get a failure in `nix-prefetch-url`, you may need to unpack and repack the thunk. Here's some example output that shows this issue:
22+If you're using a private repo, and you get a failure in nix-prefetch-url, you may need to unpack and repack the thunk. Here's some example output that shows this issue:
79
23
80```
24```
81Starting Obelisk </nix/store/j8wls8a89xr6s1a47lg6g83gnbdrfd0l-obelisk-command-0.1/bin/.ob-wrapped> args=["deploy","update","-v"] logging-level=Debug
25Starting Obelisk </nix/store/j8wls8a89xr6s1a47lg6g83gnbdrfd0l-obelisk-command-0.1/bin/.ob-wrapped> args=["deploy","update","-v"] logging-level=Debug
@@ -95,7 +39,7 @@ nix-prefetch-url: Failed to determine sha256 hash of URL https://github.com/obsi
95
39
96And here's how you can fix it:
40And here's how you can fix it:
97
41
98−```bash
42+```
99ob thunk unpack $SOME_THUNK
43ob thunk unpack $SOME_THUNK
100ob thunk pack $SOME_THUNK
44ob thunk pack $SOME_THUNK
101```
45```
@@ -115,3 +59,64 @@ error:
115```
59```
116then specify the package you want in the import, e.g:
60then specify the package you want in the import, e.g:
117`import "cryptonite" Crypto.Hash`
61`import "cryptonite" Crypto.Hash`
62+
63+
64+### What does `ob run` actually do?
65+
66+
67+#### Short version:
68+
69+`ob run` starts a [`ghcid`](https://github.com/ndmitchell/ghcid) process which
70+tries to build your project within a carefully crafted `nix-shell` with all the
71+project's dependencies and,
72+
73+* either displays compilation errors/warnings,
74+* or starts the Obelisk server, which serves:
75+ * your backend's route handlers,
76+ * the static assets,
77+ * the [JSaddle](https://github.com/ghcjs/jsaddle) frontend code (while opening its websocket).
78+
79+#### Longer version:
80+
81+Assuming we are in a project created with `ob init`, `ob run` calls (see
82+`lib/command/src/Obelisk/Command.hs`):
83+
84+ nix-shell -A shells.ghc --run 'ob --no-handoff internal run-static-io <real-run-function>'
85+
86+where
87+
88+* `shells.ghc` is defined in `./default.nix` by importing `./.obelisk/impl/default.nix` which
89+ is `default.nix` in the present (Obelisk) repository,
90+* `run-static-io` is a logging-enabled command wrapper
91+ (cf. `runObelisk` in `lib/command/src/Obelisk/App.hs`).
92+
93+In this case, it runs the function `Obelisk.Command.Command.run` (defined in
94+`lib/command/src/Obelisk/Command/Run.hs`).
95+
96+* It creates a GHCi config from a Nix expression which:
97+ * loads three packages: `backend`, `common`, `frontend`,
98+ * obtains a free port number.
99+* Then runs `ghcid`
100+ * with a command that reruns `Obelisk.Run.run` at each restart (option
101+ `--test`).
102+
103+It is defined in `lib/run/src/Obelisk/Run.hs`:
104+
105+* It creates a thread which starts the main backend.
106+ This runs `runSnapWithCommandLineArgs` and passes routes:
107+ * to the backend (result of the `_backend_run` field of your
108+ implementation of the `Backend fullRoute frontendRoute` record),
109+ * or to `serveDefaultObeliskApp` (`lib/backend/src/Obelisk/Backend.hs`) to
110+ serve static assets.
111+* Starts `runWidget`
112+ which itself runs
113+ [runSettingsSocket](https://hackage.haskell.org/package/warp-3.2.26/docs/Network-Wai-Handler-Warp.html#v:runSettingsSocket)
114+ (the *“TCP listen loop”*):
115+ * it binds to TCP socket, and
116+ * creates the HTTP connection manager
117+ ( [`newManager`](https://hackage.haskell.org/package/http-client-0.6.3/docs/Network-HTTP-Client.html#v:newManager))
118+ * calls `obeliskApp` which
119+ * has a route to serve the [JSaddle](https://github.com/ghcjs/jsaddle) frontend,
120+ * runs the frontend (*on* the server), to produce pre-rendered pages,
121+ * starts the JSaddle web-socket,
122+ * “falls back” to proxying the backend (`fallbackProxy`).
LICENSEdeleted−30
@@ -1,30 +0,0 @@
1−Copyright (c) 2020 Obsidian Systems
2−
3−All rights reserved.
4−
5−Redistribution and use in source and binary forms, with or without
6−modification, are permitted provided that the following conditions are met:
7−
8− * Redistributions of source code must retain the above copyright
9− notice, this list of conditions and the following disclaimer.
10−
11− * Redistributions in binary form must reproduce the above
12− copyright notice, this list of conditions and the following
13− disclaimer in the documentation and/or other materials provided
14− with the distribution.
15−
16− * Neither the name of Elliot Cameron nor the names of other
17− contributors may be used to endorse or promote products derived
18− from this software without specific prior written permission.
19−
20−THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21−"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22−LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23−A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24−OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25−SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26−LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27−DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28−THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29−(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30−OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
README.md+92−115
@@ -1,75 +1,63 @@
1# Obelisk
1# Obelisk
2
2
3−[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
3+Obelisk provides an easy way to develop and deploy your [Reflex](https://github.com/reflex-frp/reflex) project as web apps and as mobile apps.
4−[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://github.com/obsidiansystems/obelisk/blob/master/LICENSE)
5
4
6−<p align="center"><img src="docs/obelisk-logo-640.png" width="50%" alt="Obelisk Logo"></p>
7−
8−Functional reactive web and mobile applications, with batteries included. Obelisk's goal is to represent a cohesive, highly-curated set of choices that [Obsidian Systems](https://obsidian.systems/) has made for building these types of applications in a way that is extremely fast but does not compromise on production readiness.
9−
10−- [Overview](#overview)
11− - [Who should consider using it?](#who-should-consider-using-it)
12- [Installing Obelisk](#installing-obelisk)
5- [Installing Obelisk](#installing-obelisk)
13- [Developing an Obelisk project](#developing-an-obelisk-project)
6- [Developing an Obelisk project](#developing-an-obelisk-project)
14− - [IDE Support](#ide-support)
7+ - [Hoogle](#hoogle)
8+ - [Adding Package Overrides](#adding-package-overrides)
15- [Deploying](#deploying)
9- [Deploying](#deploying)
16− - [Default EC2 Deployment](#default-ec2-deployment)
17− - [Custom Non-EC2 Deployment](#custom-non-ec2-deployment)
18− - [VirtualBox Deployment](#virtualbox-deployment)
19 - [Locally](#locally)
10 - [Locally](#locally)
11+ - [EC2](#ec2)
20 - [From macOS](#from-macos)
12 - [From macOS](#from-macos)
21 - [Deploying an updated version](#deploying-an-updated-version)
13 - [Deploying an updated version](#deploying-an-updated-version)
22- [Mobile](#mobile)
14- [Mobile](#mobile)
23 - [iOS](#ios)
15 - [iOS](#ios)
24 - [Android](#android)
16 - [Android](#android)
25−- [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq)
26−- [Contributing](#contributing)
27−
28−## Overview
29−
30−Obelisk allows you to build high-quality web and mobile applications very quickly using [Reflex](https://reflex-frp.org/). In minutes you can go from an empty directory to an interactive application that works on web, iOS, and Android, all sharing the same Haskell codebase! Obelisk's development environment also enables extremely rapid development and feedback. You can take advantage of Haskell's type system across the frontend and backend boundary. This means changes to your backend that would break your frontend are immediately detected during development and vice versa. Obelisk uses Haskell's compiler to give you a complete "TODO list" of what needs to be updated.
31−
32−Obelisk is targeted primarily at Haskell developers who want to build high-quality web and/or mobile applications in Haskell, without the distractions of manually choosing and integrating technology for every piece of the system.
33−
34−### Who should consider using it?
35−
36−Obelisk assumes basic knowledge of [Haskell](https://www.haskell.org/) and [Reflex/Reflex-DOM](https://reflex-frp.org/), web technologies like [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML) and [CSS](https://developer.mozilla.org/en-US/docs/Web/CSS), and a terminal shell like [Bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell)). Knowledge of [Nix](https://nixos.org/) helps but is not strictly necessary.
37−
38
17
39## Installing Obelisk
18## Installing Obelisk
40−
411. [Install Nix](https://nixos.org/nix/).
191. [Install Nix](https://nixos.org/nix/).
42 If you already have Nix installed, make sure you have version 2.0 or higher. To check your current version, run `nix-env --version`.
20 If you already have Nix installed, make sure you have version 2.0 or higher. To check your current version, run `nix-env --version`.
431. Set up nix caches
211. Set up nix caches
44 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
22 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
45− ```nix
23+ ```
46− nix.binaryCaches = [ "https://nixcache.reflex-frp.org" ];
24+ nix.binaryCaches = [ "https://cache.nixos.org/" "https://nixcache.reflex-frp.org" ];
47 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
25 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
48 ```
26 ```
49 and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
27 and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
50− 1. If you are using another operating system or Linux distribution, ensure that these lines are present in your Nix configuration file (`/etc/nix/nix.conf` on most systems; [see full list](https://nixos.org/nix/manual/#sec-conf-file)):
28+ 1. If you are using another operating system or linux distribution, ensure that these lines are present in your Nix configuration file (`/etc/nix/nix.conf` on most systems; [see full list](https://nixos.org/nix/manual/#sec-conf-file)):
51− ```nix
52− binary-caches = https://cache.nixos.org https://nixcache.reflex-frp.org
53− binary-cache-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
54− binary-caches-parallel-connections = 40
55 ```
29 ```
30+ substituters = https://cache.nixos.org https://nixcache.reflex-frp.org
31+ trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
32+ ```
56− * If you're on a Linux distribution other than NixOS, enable sandboxing (see these [issue 172](https://github.com/obsidiansystems/obelisk/issues/172#issuecomment-411507818) or [issue 6](https://github.com/obsidiansystems/obelisk/issues/6) if you run into build problems) by adding the following:
33+ * other Linux: enable sandboxing (see these [issue172](https://github.com/obsidiansystems/obelisk/issues/172#issuecomment-411507818) or [issue6](https://github.com/obsidiansystems/obelisk/issues/6) if you run into build problems)
57− ```nix
34+ ```
58 sandbox = true
35 sandbox = true
59 ```
36 ```
60− * If you're on MacOS, disable sandboxing (there are still some impure dependencies for now) by adding the following:
37+ * MacOS: disable sandboxing (there are still some impure dependencies for now)
61− ```nix
38+ ```
62 sandbox = false
39 sandbox = false
63 ```
40 ```
64 then restart the nix daemon
41 then restart the nix daemon
65− ```bash
42+ ```
66 sudo launchctl stop org.nixos.nix-daemon
43 sudo launchctl stop org.nixos.nix-daemon
67 sudo launchctl start org.nixos.nix-daemon
44 sudo launchctl start org.nixos.nix-daemon
68 ```
45 ```
69−1. Install obelisk:
70− ```bash
71− nix-env -f https://github.com/obsidiansystems/obelisk/archive/master.tar.gz -iA command
46+1. Install obelisk: `nix-env -f https://github.com/obsidiansystems/obelisk/archive/master.tar.gz -iA command`
47+
48+### Contributing to Obelisk
49+
50+When developing on obelisk itself you may launch `ghcid` for the corresponding project as follows. For example to launch ghcid for `lib/backend` project:
51+
52+```
53+nix-shell -A obeliskEnvs.obelisk-backend --run "cd lib/backend && ghcid -c 'cabal new-repl'"
54+```
55+
56+Or to launch ghcid for `lib/command` project:
57+
58+```
59+nix-shell -A obeliskEnvs.obelisk-command --run "cd lib/command && ghcid -c 'cabal new-repl'"
72− ```
60+```
73
61
74### Accessing private repositories
62### Accessing private repositories
75
63
@@ -84,44 +72,84 @@ access to:
84
72
85To create a new Obelisk project, go to an empty directory and run:
73To create a new Obelisk project, go to an empty directory and run:
86
74
87−```bash
75+```
88ob init
76ob init
89```
77```
90
78
91Obelisk leverages ghcid to provide a live-reloading server that handles both frontend and backend. To run your Obelisk app and monitor the source for changes:
79Obelisk leverages ghcid to provide a live-reloading server that handles both frontend and backend. To run your Obelisk app and monitor the source for changes:
92
80
93−```bash
81+```
94ob run
82ob run
95```
83```
96
84
97−Now, with an appropriate browser, go to http://localhost:8000 (or the address/port specified in `config/common/route`) to access your app.
85+Now go to http://localhost:8000 (or the address/port specified in `config/common/route`) to access your app.
98−Firefox will not be able to properly run the development website due to [issue 460](https://github.com/obsidiansystems/obelisk/issues/460). Fortunately, this problem does not occur on a fully built website.
99
86
100Every time you change the Haskell source files in frontend, common or backend, `ob run` will automatically recompile the modified files and reload the server. Furthermore, it will display on screen compilation errors and warnings if any.
87Every time you change the Haskell source files in frontend, common or backend, `ob run` will automatically recompile the modified files and reload the server. Furthermore, it will display on screen compilation errors and warnings if any.
101
88
102−### IDE Support
89+### Hoogle
90+
91+To enter a nix-shell from which you can run the hoogle command-line client or a hoogle server for your project:
92+
93+`nix-shell -A shells.ghc --arg withHoogle true`
103
94
104−Obelisk officially supports terminal-based feedback (akin to [`ghcid`](https://github.com/ndmitchell/ghcid)) in `ob run` and `ob watch`.
95+### Adding package overrides
96+
97+To add a version override to any Haskell package, or to add a Haskell package that doesn't exist in the nixpkgs used by Obelisk, use the `overrides` attribute in your project's `default.nix`. For example, to use a specific version of the `aeson` package, your `default.nix` will look like:
98+
99+```nix
100+# ...
101+project ./. ({ pkgs, ... }: {
102+# ...
103+ overrides = self: super: let
104+ aeson = pkgs.fetchFromGitHub {
105+ owner = "obsidiansystems";
106+ repo = "aeson-gadt-th";
107+ rev = "ed573c2cccf54d72aa6279026752a3fecf9c1383";
108+ sha256 = "08q6rnz7w9pn76jkrafig6f50yd0f77z48rk2z5iyyl2jbhcbhx3";
109+ };
110+ in
111+ {
112+ aeson = self.callCabal2nix "aeson" aeson {};
113+ };
114+# ...
115+```
116+
117+For further information see [the Haskell section](https://nixos.org/nixpkgs/manual/#users-guide-to-the-haskell-infrastructure) of nixpkgs Contributors Guide.
105
118
106## Deploying
119## Deploying
107
120
108−### Default EC2 Deployment
121+### Locally
109
122
123+Build everything:
124+
125+```
126+nix-build -A exe -o result-exe
127+```
128+
129+Run the server:
130+
131+```
132+cd result-exe
133+./backend
134+```
135+
136+### EC2
137+
110−In this section we will demonstrate how to deploy your Obelisk app to an Amazon EC2 instance. Obelisk deployments are configured for EC2 by default (see [Custom Non-EC2 Deployment](#custom-non-ec2-deployment)).
138+In this section we will demonstrate how to deploy your Obelisk app to an Amazon EC2 instance.
111
139
112First create a new EC2 instance:
140First create a new EC2 instance:
113
141
114−1. Launch a NixOS 19.09 EC2 instance (we recommend [this AMI](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#LaunchInstanceWizard:ami=ami-00a8eeaf232a74f84))
142+1. Launch a NixOS 18.09 EC2 instance (we recommend [this AMI](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#LaunchInstanceWizard:ami=ami-009c9c3f1af480ff3))
1151. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1431. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1161. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
1441. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
117−1. Go to "Security Groups", select your instance's security group and under "Inbound" tab add a new rule for HTTP port 80 and HTTPS port 443.
145+1. Go to "Security Groups", select your instance's security group and under "Inbound" tab add a new rule for HTTP port 80 and 443.
118
146
119At this stage your instance should be booting and become accessible shortly. Note down the hostname of your EC2 instance.
147At this stage your instance should be booting and become accessible shortly. Note down the hostname of your EC2 instance.
120
148
121Now go to your Obelisk project directory (`~/code/myapp`), and initialize a deployment config (`~/code/myapp-deploy`):
149Now go to your Obelisk project directory (`~/code/myapp`), and initialize a deployment config (`~/code/myapp-deploy`):
122Your project directory must be "thunkable", i.e. something on which `ob thunk pack` can be called. Usually it will be a git repository whose current revision has been pushed upstream.
150Your project directory must be "thunkable", i.e. something on which `ob thunk pack` can be called. Usually it will be a git repository whose current revision has been pushed upstream.
123
151
124−```bash
152+```
125cd ~/code/myapp
153cd ~/code/myapp
126SERVER=ec2-35-183-22-197.ca-central-1.compute.amazonaws.com
154SERVER=ec2-35-183-22-197.ca-central-1.compute.amazonaws.com
127ROUTE=https://myapp.com # Publicly accessible route to your app
155ROUTE=https://myapp.com # Publicly accessible route to your app
@@ -134,13 +162,11 @@ ob deploy init \
134 ~/code/myapp-deploy
162 ~/code/myapp-deploy
135```
163```
136
164
137−HTTPS is enabled by default; to disable HTTPS pass `--disable-https` to the `ob deploy init` command above.
165+NOTE: HTTPS is enabled by default; to disable https, pass `--disable-https` to the `ob deploy init` command above.
138
166
139−This step will also require that you manually verify the authenticity of the host `$SERVER`. Obelisk will save the fingerprint in a deployment-specific configuration. **Obelisk deployments do *not* rely on the `known_hosts` of your local machine.** This is because, in the event that you need to switch from one deploy machine / bastion host to another, you want to be absolutely sure that you're still connecting to the machines you think you are, even if that deploy machine / bastion host has never connected to them before. Obelisk explicitly avoids a workflow that encourages people to accept host keys without checking them, since that could result in leaking production secrets to anyone who manages to MITM you, e.g. via DNS spoofing or cache poisoning. (Note that an active attack is a circumstance where you may need to quickly switch bastion hosts, e.g. because the attacker has taken one down or you have taken it down in case it was compromised. In this circumstance you might need to deploy to production to fix an exploit or rotate keys, etc.) When you run `ob deploy` later it will rely on the saved verification in this step.
167+Then go to that created deployment configuration directory, and initiate the deployment:
140
168
141−Next, go to the deployment directory that you just initialized and deploy!
142−
143−```bash
169+```
144cd ~/code/myapp-deploy
170cd ~/code/myapp-deploy
145ob deploy push
171ob deploy push
146```
172```
@@ -149,45 +175,6 @@ ob deploy push
149
175
150At this point you are done. Your app will be accessible at `${ROUTE}`. The currently deployed version - the git commit hash of the source repo - can be found at `${ROUTE}/version`.
176At this point you are done. Your app will be accessible at `${ROUTE}`. The currently deployed version - the git commit hash of the source repo - can be found at `${ROUTE}/version`.
151
177
152−### Custom Non-EC2 Deployment
153−
154−By default Obelisk deployments are configured for NixOS machines running on AWS EC2. To provide your own configuration, you need to write a custom `module.nix` in the deployment repository. This still requires that your server is running NixOS.
155−
156−`module.nix` must contain a Nix *function* that produces a [NixOS module function](https://nixos.org/nixos/manual/index.html#sec-writing-modules). The top-level function takes deployment configuration as arguments: `hostName`, `adminEmail`, `routeHost`, `enableHttps`, `version`, `exe`, `nixosPkgs`. Most of these are the values you specified during `ob deploy init` and are stored in the deployment repository. `version` is a `git` hash for the app that you're deploying. `exe` is the Linux build of the app (as seen in [Deploying Locally](#locally)). `nixosPkgs` is the package set used to construct the NixOS VM.
157−
158−The [VirtualBox Deployment](#virtualbox-deployment) section provides an example.
159−
160−#### VirtualBox Deployment
161−
162−Here's a `module.nix` that is configured for deployment to a VirtualBox VM (running NixOS):
163−
164−```nix
165−{ nixosPkgs, ... }: {...}: {
166− imports = [ (nixosPkgs.path + /nixos/modules/virtualisation/virtualbox-image.nix) ];
167−}
168−```
169−
170−The `{...}:` and following is the [NixOS module](https://nixos.org/nixos/manual/index.html#sec-writing-modules) definition.
171−
172−### Locally
173−
174−If you want deploy your application locally or test a production-oriented build you can build and deploy the app as described below.
175−
176−Build the application:
177−
178−```bash
179−nix-build -A exe --no-out-link
180−```
181−
182−Copy the result to a new directory, add configuration, and run!
183−
184−```bash
185−mkdir test-app
186−ln -s $(nix-build -A exe --no-out-link)/* test-app/
187−cp -r config test-app
188−(cd test-app && ./backend)
189−```
190−
191### From macOS
178### From macOS
192
179
193Deploying from macOS requires some extra setup:
180Deploying from macOS requires some extra setup:
@@ -201,7 +188,7 @@ Running `ob deploy push` will give you additional setup instructions.
201
188
202If you'd like to deploy an updated version (with new commits) of your Obelisk app: simply go to the configuration directory, update the source thunk and push:
189If you'd like to deploy an updated version (with new commits) of your Obelisk app: simply go to the configuration directory, update the source thunk and push:
203
190
204−```bash
191+```
205cd ~/code/myapp-deploy
192cd ~/code/myapp-deploy
206ob deploy update
193ob deploy update
207ob deploy push
194ob deploy push
@@ -221,20 +208,20 @@ Your account must also belong to an Apple Developer Team, if you want to access
2211. Click accept to authorize on both the computer and the iPhone.
2081. Click accept to authorize on both the computer and the iPhone.
222
209
223##### Xcode
210##### Xcode
224−Install Xcode 11.2 (contains iOS SDK 13.2) and open it so that it runs its post install tool setup.
211+Install Xcode 8.2 (contains iOS SDK 10.2) and open it so that it runs its post install tool setup.
225
212
226These versions will work out of the box but iOS SDKs prior to 11.3 should also work. You can choose another installed version in `default.nix`
213These versions will work out of the box but iOS SDKs prior to 11.3 should also work. You can choose another installed version in `default.nix`
227
214
228More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
215More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
229To add another SDK to your current Xcode, [download](https://developer.apple.com/download/more/) the corresponding Xcode, extract it and copy its SDK folder next to the installed one, e.g.
216To add another SDK to your current Xcode, [download](https://developer.apple.com/download/more/) the corresponding Xcode, extract it and copy its SDK folder next to the installed one, e.g.
230−```bash
217+```
231open -W Xcode_9.2.xip
218open -W Xcode_9.2.xip
232sudo cp -R Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS11.2.sdk
219sudo cp -R Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS11.2.sdk
233```
220```
234
221
235
222
236You can verify that you have correct versions by running
223You can verify that you have correct versions by running
237−```bash
224+```
238xcodebuild -showsdks
225xcodebuild -showsdks
239```
226```
240
227
@@ -260,7 +247,7 @@ Ensure that `bundleIdentifier` matches the App ID of the development profile, or
2601. Connect the registered iPhone.
2471. Connect the registered iPhone.
2611. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2481. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2621. Run the deploy command with your Team ID:
2491. Run the deploy command with your Team ID:
263−```bash
250+```
264result-ios/bin/deploy [TEAM_ID]
251result-ios/bin/deploy [TEAM_ID]
265# or in debug mode via lldb:
252# or in debug mode via lldb:
266result-ios/bin/deploy [TEAM_ID] -d
253result-ios/bin/deploy [TEAM_ID] -d
@@ -270,7 +257,7 @@ result-ios/bin/deploy [TEAM_ID] -d
2701. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
2571. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
271Create and download a distribution profile.
258Create and download a distribution profile.
2721. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
2591. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
273−```bash
260+```
274result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
261result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
275```
262```
276
263
@@ -303,9 +290,9 @@ This command will accomplish the following:
3031. Build a Signed Android apk for your application
2901. Build a Signed Android apk for your application
3041. Deploy the Signed apk to your connected Android device
2911. Deploy the Signed apk to your connected Android device
305
292
306−In the event that you change your key or keystore password, you will have to update your credentials within the JSON object found in `android_keytool_config.json`.
293+In the event that you change your key or keystore password, you will have to update your credentials within the JSON object found in `android_keytool_config.json`
307
294
308−Additional documentation on Java key stores can be found [here](https://docs.oracle.com/javase/8/docs/technotes/tools/unix/keytool.html).
295+Additional documentation on java key stores can be found [here] (https://docs.oracle.com/javase/8/docs/technotes/tools/unix/keytool.html)
309
296
310This should copy over and install the application on your device (if you see a "*signatures do not match*" error, simply uninstall the previous app from the device before retrying the deploy). The name of the installed application will be what you have specified for `android.displayName` in the `default.nix`.
297This should copy over and install the application on your device (if you see a "*signatures do not match*" error, simply uninstall the previous app from the device before retrying the deploy). The name of the installed application will be what you have specified for `android.displayName` in the `default.nix`.
311
298
@@ -314,13 +301,3 @@ This should copy over and install the application on your device (if you see a
314##### Build a release version
301##### Build a release version
315
302
316After having configured signing for your app, you may proceed to build a release version of the app. This is no different to how you build the non-release version, so consult the section [Android](#android) further above for exact instructions on building and deploying to your device.
303After having configured signing for your app, you may proceed to build a release version of the app. This is no different to how you build the non-release version, so consult the section [Android](#android) further above for exact instructions on building and deploying to your device.
317−
318−
319−## Frequently Asked Questions (FAQ)
320−
321−Refer to [FAQ](FAQ.md).
322−
323−
324−## Contributing
325−
326−Contributions and issue reports are encouraged and appreciated! Refer to the [Contributing](CONTRIBUTING.md) guide for information about getting started.
acme.nixdeleted−430
@@ -1,430 +0,0 @@
1−# Copied from https://github.com/NixOS/nixpkgs-channels/blob/70717a337f7ae4e486ba71a500367cad697e5f09/nixos/modules/security/acme.nix # MODIFIED
2−# Lines marked '# MODIFIED' have been added or modified from the original. # MODIFIED
3−{ config, lib, pkgs, ... }:
4−with lib;
5−let
6−
7− cfg = config.security.acme;
8−
9− certOpts = { name, ... }: {
10− options = {
11− webroot = mkOption {
12− type = types.nullOr types.str;
13− default = null;
14− example = "/var/lib/acme/acme-challenges";
15− description = ''
16− Where the webroot of the HTTP vhost is located.
17− <filename>.well-known/acme-challenge/</filename> directory
18− will be created below the webroot if it doesn't exist.
19− <literal>http://example.org/.well-known/acme-challenge/</literal> must also
20− be available (notice unencrypted HTTP).
21− '';
22− };
23−
24− server = mkOption {
25− type = types.nullOr types.str;
26− default = null;
27− description = ''
28− ACME Directory Resource URI. Defaults to let's encrypt
29− production endpoint,
30− https://acme-v02.api.letsencrypt.org/directory, if unset.
31− '';
32− };
33−
34− domain = mkOption {
35− type = types.str;
36− default = name;
37− description = "Domain to fetch certificate for (defaults to the entry name)";
38− };
39−
40− email = mkOption {
41− type = types.nullOr types.str;
42− default = cfg.email;
43− description = "Contact email address for the CA to be able to reach you.";
44− };
45−
46− user = mkOption {
47− type = types.str;
48− default = "root";
49− description = "User running the ACME client.";
50− };
51−
52− group = mkOption {
53− type = types.str;
54− default = "root";
55− description = "Group running the ACME client.";
56− };
57−
58− allowKeysForGroup = mkOption {
59− type = types.bool;
60− default = false;
61− description = ''
62− Give read permissions to the specified group
63− (<option>security.acme.cert.&lt;name&gt;.group</option>) to read SSL private certificates.
64− '';
65− };
66−
67− postRun = mkOption {
68− type = types.lines;
69− default = "";
70− example = "systemctl reload nginx.service";
71− description = ''
72− Commands to run after new certificates go live. Typically
73− the web server and other servers using certificates need to
74− be reloaded.
75− Executed in the same directory with the new certificate.
76− '';
77− };
78−
79− directory = mkOption {
80− type = types.str;
81− readOnly = true;
82− default = "/var/lib/acme/${name}";
83− description = "Directory where certificate and other state is stored.";
84− };
85−
86− extraDomains = mkOption {
87− type = types.attrsOf (types.nullOr types.str);
88− default = {};
89− example = literalExample ''
90− {
91− "example.org" = null;
92− "mydomain.org" = null;
93− }
94− '';
95− description = ''
96− A list of extra domain names, which are included in the one certificate to be issued.
97− Setting a distinct server root is deprecated and not functional in 20.03+
98− '';
99− };
100−
101− keyType = mkOption {
102− type = types.str;
103− default = "ec256";
104− description = ''
105− Key type to use for private keys.
106− For an up to date list of supported values check the --key-type option
107− at https://go-acme.github.io/lego/usage/cli/#usage.
108− '';
109− };
110−
111− dnsProvider = mkOption {
112− type = types.nullOr types.str;
113− default = null;
114− example = "route53";
115− description = ''
116− DNS Challenge provider. For a list of supported providers, see the "code"
117− field of the DNS providers listed at https://go-acme.github.io/lego/dns/.
118− '';
119− };
120−
121− credentialsFile = mkOption {
122− type = types.path;
123− description = ''
124− Path to an EnvironmentFile for the cert's service containing any required and
125− optional environment variables for your selected dnsProvider.
126− To find out what values you need to set, consult the documentation at
127− https://go-acme.github.io/lego/dns/ for the corresponding dnsProvider.
128− '';
129− example = "/var/src/secrets/example.org-route53-api-token";
130− };
131−
132− dnsPropagationCheck = mkOption {
133− type = types.bool;
134− default = true;
135− description = ''
136− Toggles lego DNS propagation check, which is used alongside DNS-01
137− challenge to ensure the DNS entries required are available.
138− '';
139− };
140− };
141− };
142−
143−in
144−
145−{
146−
147− ###### interface
148− imports = [
149− (mkRemovedOptionModule [ "security" "acme" "production" ] ''
150− Use security.acme.server to define your staging ACME server URL instead.
151− To use the let's encrypt staging server, use security.acme.server =
152− "https://acme-staging-v02.api.letsencrypt.org/directory".
153− ''
154− )
155− # (mkRemovedOptionModule [ "security" "acme" "directory"] "ACME Directory is now hardcoded to /var/lib/acme and its permisisons are managed by systemd. See https://github.com/NixOS/nixpkgs/issues/53852 for more info.") # MODIFIED
156− # (mkRemovedOptionModule [ "security" "acme" "preDelay"] "This option has been removed. If you want to make sure that something executes before certificates are provisioned, add a RequiredBy=acme-\${cert}.service to the service you want to execute before the cert renewal") # MODIFIED
157− # (mkRemovedOptionModule [ "security" "acme" "activationDelay"] "This option has been removed. If you want to make sure that something executes before certificates are provisioned, add a RequiredBy=acme-\${cert}.service to the service you want to execute before the cert renewal") # MODIFIED
158− (mkChangedOptionModule [ "security" "acme" "validMin"] [ "security" "acme" "validMinDays"] (config: config.security.acme.validMin / (24 * 3600)))
159− ];
160− options = {
161− security.acme = {
162−
163− validMinDays = mkOption {
164− type = types.int;
165− default = 30;
166− description = "Minimum remaining validity before renewal in days.";
167− };
168−
169− email = mkOption {
170− type = types.nullOr types.str;
171− default = null;
172− description = "Contact email address for the CA to be able to reach you.";
173− };
174−
175− renewInterval = mkOption {
176− type = types.str;
177− default = "daily";
178− description = ''
179− Systemd calendar expression when to check for renewal. See
180− <citerefentry><refentrytitle>systemd.time</refentrytitle>
181− <manvolnum>7</manvolnum></citerefentry>.
182− '';
183− };
184−
185− server = mkOption {
186− type = types.nullOr types.str;
187− default = null;
188− description = ''
189− ACME Directory Resource URI. Defaults to let's encrypt
190− production endpoint,
191− <literal>https://acme-v02.api.letsencrypt.org/directory</literal>, if unset.
192− '';
193− };
194−
195− preliminarySelfsigned = mkOption {
196− type = types.bool;
197− default = true;
198− description = ''
199− Whether a preliminary self-signed certificate should be generated before
200− doing ACME requests. This can be useful when certificates are required in
201− a webserver, but ACME needs the webserver to make its requests.
202− With preliminary self-signed certificate the webserver can be started and
203− can later reload the correct ACME certificates.
204− '';
205− };
206−
207− acceptTerms = mkOption {
208− type = types.bool;
209− default = false;
210− description = ''
211− Accept the CA's terms of service. The default provier is Let's Encrypt,
212− you can find their ToS at https://letsencrypt.org/repository/
213− '';
214− };
215−
216− certs = mkOption {
217− default = { };
218− type = with types; attrsOf (submodule certOpts);
219− description = ''
220− Attribute set of certificates to get signed and renewed. Creates
221− <literal>acme-''${cert}.{service,timer}</literal> systemd units for
222− each certificate defined here. Other services can add dependencies
223− to those units if they rely on the certificates being present,
224− or trigger restarts of the service if certificates get renewed.
225− '';
226− example = literalExample ''
227− {
228− "example.com" = {
229− webroot = "/var/www/challenges/";
230− email = "foo@example.com";
231− extraDomains = { "www.example.com" = null; "foo.example.com" = null; };
232− };
233− "bar.example.com" = {
234− webroot = "/var/www/challenges/";
235− email = "bar@example.com";
236− };
237− }
238− '';
239− };
240− };
241− };
242−
243− ###### implementation
244− config = mkMerge [
245− (mkIf (cfg.certs != { }) {
246−
247− assertions = let
248− certs = (mapAttrsToList (k: v: v) cfg.certs);
249− in [
250− {
251− assertion = all (certOpts: certOpts.dnsProvider == null || certOpts.webroot == null) certs;
252− message = ''
253− Options `security.acme.certs.<name>.dnsProvider` and
254− `security.acme.certs.<name>.webroot` are mutually exclusive.
255− '';
256− }
257− {
258− assertion = cfg.email != null || all (certOpts: certOpts.email != null) certs;
259− message = ''
260− You must define `security.acme.certs.<name>.email` or
261− `security.acme.email` to register with the CA.
262− '';
263− }
264− {
265− assertion = cfg.acceptTerms;
266− message = ''
267− You must accept the CA's terms of service before using
268− the ACME module by setting `security.acme.acceptTerms`
269− to `true`. For Let's Encrypt's ToS see https://letsencrypt.org/repository/
270− '';
271− }
272− ];
273−
274− systemd.services = let
275− services = concatLists servicesLists;
276− servicesLists = mapAttrsToList certToServices cfg.certs;
277− certToServices = cert: data:
278− let
279− # StateDirectory must be relative, and will be created under /var/lib by systemd
280− lpath = "acme/${cert}";
281− apath = "/var/lib/${lpath}";
282− spath = "/var/lib/acme/.lego/${cert}";
283− fileMode = if data.allowKeysForGroup then "640" else "600";
284− globalOpts = [ "-d" data.domain "--email" data.email "--path" "." "--key-type" data.keyType ]
285− ++ optionals (cfg.acceptTerms) [ "--accept-tos" ]
286− ++ optionals (data.dnsProvider != null && !data.dnsPropagationCheck) [ "--dns.disable-cp" ]
287− ++ concatLists (mapAttrsToList (name: root: [ "-d" name ]) data.extraDomains)
288− ++ (if data.dnsProvider != null then [ "--dns" data.dnsProvider ] else [ "--http" "--http.webroot" data.webroot ])
289− ++ optionals (cfg.server != null || data.server != null) ["--server" (if data.server == null then cfg.server else data.server)];
290− runOpts = escapeShellArgs (globalOpts ++ [ "run" ]);
291− renewOpts = escapeShellArgs (globalOpts ++ [ "renew" "--days" (toString cfg.validMinDays) ]);
292− acmeService = {
293− description = "Renew ACME Certificate for ${cert}";
294− after = [ "network.target" "network-online.target" ];
295− wants = [ "network-online.target" ];
296− wantedBy = mkIf (!config.boot.isContainer) [ "multi-user.target" ];
297− serviceConfig = {
298− Type = "oneshot";
299− User = data.user;
300− Group = data.group;
301− PrivateTmp = true;
302− StateDirectory = "acme/.lego/${cert} acme/.lego/accounts ${lpath}";
303− StateDirectoryMode = if data.allowKeysForGroup then "750" else "700";
304− WorkingDirectory = spath;
305− # Only try loading the credentialsFile if the dns challenge is enabled
306− EnvironmentFile = if data.dnsProvider != null then data.credentialsFile else null;
307− ExecStart = pkgs.writeScript "acme-start" ''
308− #!${pkgs.runtimeShell} -e
309− test -L ${spath}/accounts -o -d ${spath}/accounts || ln -s ../accounts ${spath}/accounts
310− ${pkgs.lego}/bin/lego ${renewOpts} || ${pkgs.lego}/bin/lego ${runOpts}
311− '';
312− ExecStartPost =
313− let
314− keyName = builtins.replaceStrings ["*"] ["_"] data.domain;
315− script = pkgs.writeScript "acme-post-start" ''
316− #!${pkgs.runtimeShell} -e
317− cd ${apath}
318− # Test that existing cert is older than new cert
319− KEY=${spath}/certificates/${keyName}.key
320− KEY_CHANGED=no
321− if [ -e $KEY -a $KEY -nt key.pem ]; then
322− KEY_CHANGED=yes
323− cp -p ${spath}/certificates/${keyName}.key key.pem
324− cp -p ${spath}/certificates/${keyName}.crt fullchain.pem
325− cp -p ${spath}/certificates/${keyName}.issuer.crt chain.pem
326− ln -sf fullchain.pem cert.pem
327− cat key.pem fullchain.pem > full.pem
328− fi
329− chmod ${fileMode} *.pem
330− chown '${data.user}:${data.group}' *.pem
331− if [ "$KEY_CHANGED" = "yes" ]; then
332− : # noop in case postRun is empty
333− ${data.postRun}
334− fi
335− '';
336− in
337− "+${script}";
338− };
339−
340− };
341− selfsignedService = {
342− description = "Create preliminary self-signed certificate for ${cert}";
343− path = [ pkgs.openssl ];
344− script =
345− ''
346− workdir="$(mktemp -d)"
347− # Create CA
348− openssl genrsa -des3 -passout pass:xxxx -out $workdir/ca.pass.key 2048
349− openssl rsa -passin pass:xxxx -in $workdir/ca.pass.key -out $workdir/ca.key
350− openssl req -new -key $workdir/ca.key -out $workdir/ca.csr \
351− -subj "/C=UK/ST=Warwickshire/L=Leamington/O=OrgName/OU=Security Department/CN=example.com"
352− openssl x509 -req -days 1 -in $workdir/ca.csr -signkey $workdir/ca.key -out $workdir/ca.crt
353− # Create key
354− openssl genrsa -des3 -passout pass:xxxx -out $workdir/server.pass.key 2048
355− openssl rsa -passin pass:xxxx -in $workdir/server.pass.key -out $workdir/server.key
356− openssl req -new -key $workdir/server.key -out $workdir/server.csr \
357− -subj "/C=UK/ST=Warwickshire/L=Leamington/O=OrgName/OU=IT Department/CN=example.com"
358− openssl x509 -req -days 1 -in $workdir/server.csr -CA $workdir/ca.crt \
359− -CAkey $workdir/ca.key -CAserial $workdir/ca.srl -CAcreateserial \
360− -out $workdir/server.crt
361− # Copy key to destination
362− cp $workdir/server.key ${apath}/key.pem
363− # Create fullchain.pem (same format as "simp_le ... -f fullchain.pem" creates)
364− cat $workdir/{server.crt,ca.crt} > "${apath}/fullchain.pem"
365− # Create full.pem for e.g. lighttpd
366− cat $workdir/{server.key,server.crt,ca.crt} > "${apath}/full.pem"
367− # Give key acme permissions
368− chown '${data.user}:${data.group}' "${apath}/"{key,fullchain,full}.pem
369− chmod ${fileMode} "${apath}/"{key,fullchain,full}.pem
370− '';
371− serviceConfig = {
372− Type = "oneshot";
373− PrivateTmp = true;
374− StateDirectory = lpath;
375− User = data.user;
376− Group = data.group;
377− };
378− unitConfig = {
379− # Do not create self-signed key when key already exists
380− ConditionPathExists = "!${apath}/key.pem";
381− };
382− };
383− in (
384− [ { name = "acme-${cert}"; value = acmeService; } ]
385− ++ optional cfg.preliminarySelfsigned { name = "acme-selfsigned-${cert}"; value = selfsignedService; }
386− );
387− servicesAttr = listToAttrs services;
388− in
389− servicesAttr;
390−
391− systemd.tmpfiles.rules =
392− map (data: "d ${data.webroot}/.well-known/acme-challenge - ${data.user} ${data.group}") (filter (data: data.webroot != null) (attrValues cfg.certs));
393−
394− systemd.timers = let
395− # Allow systemd to pick a convenient time within the day
396− # to run the check.
397− # This allows the coalescing of multiple timer jobs.
398− # We divide by the number of certificates so that if you
399− # have many certificates, the renewals are distributed over
400− # the course of the day to avoid rate limits.
401− numCerts = length (attrNames cfg.certs);
402− _24hSecs = 60 * 60 * 24;
403− AccuracySec = "${toString (_24hSecs / numCerts)}s";
404− in flip mapAttrs' cfg.certs (cert: data: nameValuePair
405− ("acme-${cert}")
406− ({
407− description = "Renew ACME Certificate for ${cert}";
408− wantedBy = [ "timers.target" ];
409− timerConfig = {
410− OnCalendar = cfg.renewInterval;
411− Unit = "acme-${cert}.service";
412− Persistent = "yes";
413− inherit AccuracySec;
414− # Skew randomly within the day, per https://letsencrypt.org/docs/integration-guide/.
415− RandomizedDelaySec = "24h";
416− };
417− })
418− );
419−
420− systemd.targets.acme-selfsigned-certificates = mkIf cfg.preliminarySelfsigned {};
421− systemd.targets.acme-certificates = {};
422− })
423−
424− ];
425−
426− meta = {
427− maintainers = with lib.maintainers; [ abbradar fpletz globin m1cr0man ];
428− # doc = ./acme.xml; # MODIFIED
429− };
430−}
all-builds.nixdeleted−113
@@ -1,113 +0,0 @@
1−{ self-args ? {
2− config.android_sdk.accept_license = true;
3− iosSdkVersion = "13.2";
4− }
5−, local-self ? import ./. self-args
6−, supportedSystems ? [ builtins.currentSystem ]
7−}:
8−
9−let
10− inherit (local-self.nixpkgs) lib runCommand nix;
11− cacheBuildSystems = supportedSystems;
12−
13− obeliskPackagesCommon = [
14− "obelisk-frontend"
15− "obelisk-route"
16− "obelisk-executable-config-lookup"
17− ];
18−
19− obeliskPackagesBackend = obeliskPackagesCommon ++ [
20− "obelisk-asset-manifest"
21− "obelisk-asset-serve-snap"
22− "obelisk-backend"
23− "obelisk-cliapp"
24− "obelisk-command"
25− "obelisk-executable-config-inject"
26− "obelisk-frontend"
27− "obelisk-run"
28− "obelisk-route"
29− "obelisk-selftest"
30− "obelisk-snap-extras"
31− ];
32−
33− pnameToAttrs = pkgsSet: pnames:
34− lib.listToAttrs (map
35− (name: { inherit name; value = pkgsSet.${name}; })
36− pnames);
37−
38− collect = v:
39− if lib.isDerivation v then [v]
40− else if lib.isAttrs v then lib.concatMap collect (builtins.attrValues v)
41− else if lib.isList v then lib.concatMap collect v
42− else [];
43−
44− perPlatform = lib.genAttrs cacheBuildSystems (system: let
45− reflex-platform = import ./dep/reflex-platform { inherit system; };
46−
47− mkPerProfiling = profiling: let
48− obelisk = import ./. (self-args // { inherit system profiling; });
49− ghc = pnameToAttrs
50− obelisk.haskellPackageSets.ghc
51− obeliskPackagesBackend;
52− ghcjs = pnameToAttrs
53− obelisk.haskellPackageSets.ghcjs
54− obeliskPackagesCommon;
55− command = obelisk.command;
56−
57− withSkeletonOptions = skel: options: (skel.passthru.__unstable__.self.extend (self: super: {
58− userSettings = super.userSettings // options;
59− })).project;
60− rawSkeleton = import ./skeleton { inherit obelisk; };
61− skeleton = withSkeletonOptions rawSkeleton {
62− withHoogle = true; # cache the Hoogle database for the skeleton
63− __withGhcide = true; # cache the ghcide build for the skeleton
64− };
65−
66− serverSkeletonExe = rawSkeleton.exe;
67− # TODO fix nixpkgs so it doesn't try to run the result of haskell shells as setup hooks.
68− serverSkeletonShell = local-self.nixpkgs.runCommand "shell-safe-for-dep" {} ''
69− touch "$out"
70− echo "return" >> "$out"
71− cat "${skeleton.shells.ghc}" >> "$out"
72− '';
73− androidSkeleton = skeleton.android.frontend;
74− iosSkeleton = skeleton.ios.frontend;
75− nameSuffix = if profiling then "profiled" else "unprofiled";
76− packages = {
77− skeletonProfiledObRun = rawSkeleton.__unstable__.profiledObRun;
78− inherit
79− command
80− serverSkeletonShell
81− ghc
82− ;
83− } // lib.optionalAttrs (!profiling) {
84− inherit
85− ghcjs
86− serverSkeletonExe
87− ;
88− } // lib.optionalAttrs reflex-platform.androidSupport {
89− inherit androidSkeleton;
90− } // lib.optionalAttrs reflex-platform.iosSupport {
91− inherit iosSkeleton;
92− };
93− in packages // {
94− cache = reflex-platform.pinBuildInputs
95− "obelisk-${system}-${nameSuffix}"
96− (collect packages);
97− };
98−
99− perProfiling = {
100− profiled = mkPerProfiling true;
101− unprofiled = mkPerProfiling false;
102− };
103− in perProfiling // {
104− cache = reflex-platform.pinBuildInputs
105− "obelisk-${system}"
106− (map (p: p.cache) (builtins.attrValues perProfiling));
107− });
108−
109− metaCache = local-self.reflex-platform.pinBuildInputs
110− "obelisk-everywhere"
111− (map (a: a.cache) (builtins.attrValues perPlatform));
112−
113−in perPlatform // { inherit metaCache; }
all-tests.nixdeleted−145
@@ -1,145 +0,0 @@
1−{
2− supportedSystems ? [ builtins.currentSystem ]
3−}:
4−let
5− nginxRoot = "/run/nginx";
6− obelisk = import ./default.nix {};
7− # Get NixOS a pre-release 20.03 that contains the python based tests and recursive nix
8− pkgs = import (builtins.fetchTarball https://github.com/nixos/nixpkgs/archive/3de5266.tar.gz) {};
9− sshKeys = import (pkgs.path + /nixos/tests/ssh-keys.nix) pkgs;
10− make-test = import (pkgs.path + /nixos/tests/make-test-python.nix);
11− obelisk-everywhere = (import ./all-builds.nix { inherit supportedSystems; }).x86_64-linux.cache;
12− snakeOilPrivateKey = sshKeys.snakeOilPrivateKey.text;
13− snakeOilPublicKey = sshKeys.snakeOilPublicKey;
14−in
15− make-test ({...}: {
16− name = "obelisk";
17− nodes = {
18− githost = {
19− networking.firewall.allowedTCPPorts = [ 22 80 ];
20− services.openssh = {
21− enable = true;
22− };
23− environment.systemPackages = [
24− pkgs.git
25− ];
26− users.users.root.openssh.authorizedKeys.keys = [
27− snakeOilPublicKey
28− ];
29− };
30−
31− client = {
32− imports = [
33− (pkgs.path + /nixos/modules/installer/cd-dvd/channel.nix)
34− ];
35− nix.useSandbox = false;
36− nix.binaryCaches = [];
37− environment.systemPackages = [
38− obelisk.command
39− obelisk.shell
40− obelisk-everywhere
41− pkgs.git
42− ];
43− };
44− };
45−
46− testScript =
47− let
48− privateKeyFile = pkgs.writeText "id_rsa" ''${snakeOilPrivateKey}'';
49− thunkableSample = pkgs.writeText "default.nix" ''
50− let pkgs = import <nixpkgs> {}; in pkgs.git
51− '';
52− invalidThunkableSample = pkgs.writeText "default.nix" ''
53− let pkgs = import <nixpkgs> {}; in pkgtypo.git
54− '';
55− sshConfigFile = pkgs.writeText "ssh_config" ''
56− Host *
57− StrictHostKeyChecking no
58− UserKnownHostsFile=/dev/null
59− ConnectionAttempts=1
60− ConnectTimeout=1
61− IdentityFile=~/.ssh/id_rsa
62− User=root
63− '';
64− in ''
65− start_all()
66−
67− with subtest("obelisk is installed and git is configured"):
68− client.succeed("ob --help")
69− client.succeed('git config --global user.email "you@example.com"')
70− client.succeed('git config --global user.name "Your Name"')
71−
72− githost.wait_for_open_port("22")
73−
74− with subtest("the client can access the server via ssh"):
75− client.succeed("mkdir -p ~/.ssh/")
76− client.succeed(
77− "cp ${privateKeyFile} ~/.ssh/id_rsa"
78− )
79− client.succeed("chmod 600 ~/.ssh/id_rsa")
80− client.wait_until_succeeds(
81− "ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -i ~/.ssh/id_rsa githost true"
82− )
83− client.succeed(
84− "cp ${sshConfigFile} ~/.ssh/config"
85− )
86− client.wait_until_succeeds("ssh githost true")
87−
88− with subtest("a remote bare repo can be started"):
89− githost.succeed("mkdir -p ~/myorg/myapp.git")
90− githost.succeed("cd ~/myorg/myapp.git && git init --bare")
91−
92− with subtest("a git project can be configured with a remote using ssh"):
93− client.succeed("mkdir -p ~/code/myapp")
94− client.succeed("cd ~/code/myapp && git init")
95− client.succeed(
96− "cp ${thunkableSample} ~/code/myapp/default.nix"
97− )
98− client.succeed("cd ~/code/myapp && git add .")
99−
100− client.succeed('cd ~/code/myapp && git commit -m "Initial"')
101− client.succeed(
102− "cd ~/code/myapp && git remote add origin root@githost:/root/myorg/myapp.git"
103− )
104−
105−
106− with subtest("pushing code to the remote"):
107− client.succeed("cd ~/code/myapp && git push -u origin master")
108− client.succeed("cd ~/code/myapp && git status")
109−
110− with subtest("obelisk can pack"):
111− client.succeed("ob -v thunk pack ~/code/myapp")
112− client.succeed("grep -qF 'git.json' ~/code/myapp/thunk.nix")
113− client.succeed("grep -qF 'myorg' ~/code/myapp/git.json")
114− client.succeed("ob -v thunk unpack ~/code/myapp")
115−
116− with subtest("obelisk can set the public / private flag"):
117− client.succeed("ob -v thunk pack ~/code/myapp --private")
118− client.fail("""grep -qF '"private": practice' ~/code/myapp/git.json""")
119− client.succeed("""grep -qF '"private": true' ~/code/myapp/git.json""")
120− client.succeed("nix-build ~/code/myapp")
121− client.succeed("ob -v thunk unpack ~/code/myapp")
122− client.succeed("ob -v thunk pack ~/code/myapp --public")
123− client.succeed("""grep -qF '"private": false' ~/code/myapp/git.json""")
124− client.succeed("nix-build ~/code/myapp")
125− client.succeed("ob -v thunk unpack ~/code/myapp")
126−
127− with subtest("building an invalid thunk fails"):
128− client.succeed("cd ~/code/myapp && git checkout -b bad")
129− client.succeed(
130− "cp ${invalidThunkableSample} ~/code/myapp/default.nix"
131− )
132− client.succeed("cd ~/code/myapp && git add .")
133− client.succeed('cd ~/code/myapp && git commit -m "Bad commit"')
134− client.succeed("cd ~/code/myapp && git push -u origin bad")
135− client.succeed("ob -v thunk pack ~/code/myapp --public")
136− client.fail("nix-build ~/code/myapp")
137− client.succeed("ob -v thunk unpack ~/code/myapp")
138− client.succeed("cd ~/code/myapp && git checkout master")
139−
140− with subtest("obelisk can detect private repos"):
141− client.succeed("ob -v thunk pack ~/code/myapp")
142− client.succeed("""grep -qF '"private": true' ~/code/myapp/git.json""")
143− client.succeed("ob -v thunk unpack ~/code/myapp")
144− '';
145− }) {}
default.nix+244−235
@@ -1,34 +1,114 @@
1{ system ? builtins.currentSystem
1{ system ? builtins.currentSystem
2, profiling ? false
2, profiling ? false
3−, iosSdkVersion ? "13.2"
3+, iosSdkVersion ? "10.2"
4, config ? {}
4, config ? {}
5−, terms ? { # Accepted terms, conditions, and licenses
6− security.acme.acceptTerms = false;
7− }
8−, reflex-platform-func ? import ./dep/reflex-platform
9}:
5}:
10let
6let
11− reflex-platform = getReflexPlatform { inherit system; };
7+ cleanSource = builtins.filterSource (name: _: let baseName = builtins.baseNameOf name; in !(
12− inherit (reflex-platform) hackGet nixpkgs;
8+ builtins.match "^\\.ghc\\.environment.*" baseName != null ||
13− pkgs = nixpkgs;
9+ baseName == "cabal.project.local"
14−
10+ ));
15− inherit (import dep/gitignore.nix { inherit (nixpkgs) lib; }) gitignoreSource;
11+
16−
12+ commandRuntimeDeps = pkgs: with pkgs; [
17− getReflexPlatform = { system, enableLibraryProfiling ? profiling }: reflex-platform-func {
13+ coreutils
14+ git
15+ nix-prefetch-git
16+ openssh
17+ ];
18+
19+ getReflexPlatform = sys: import ./dep/reflex-platform {
18− inherit iosSdkVersion config system enableLibraryProfiling;
20+ inherit iosSdkVersion config;
21+ system = sys;
22+ enableLibraryProfiling = profiling;
19
23
20 nixpkgsOverlays = [
24 nixpkgsOverlays = [
21− (import ./nixpkgs-overlays)
25+ (self: super: {
26+ obeliskExecutableConfig = import ./lib/executable-config { nixpkgs = pkgs; filterGitSource = cleanSource; };
27+ })
22 ];
28 ];
23
29
24 haskellOverlays = [
30 haskellOverlays = [
25− (import ./haskell-overlays/misc-deps.nix { inherit hackGet; })
31+
32+ # Fix misc upstream packages
33+ (self: super: let
34+ pkgs = self.callPackage ({ pkgs }: pkgs) {};
35+ in {
36+ hnix = pkgs.haskell.lib.dontCheck (self.callCabal2nix "hnix" (pkgs.fetchFromGitHub {
37+ owner = "haskell-nix";
38+ repo = "hnix";
39+ rev = "42afdc21da5d9e076eab57eaa42bfdde938192b8";
40+ sha256 = "0psw384dx9bw2dp93xrzw8rd9amvcwgzn64jzzwby7sfspj6k349";
41+ }) {});
42+ })
43+
26 pkgs.obeliskExecutableConfig.haskellOverlay
44 pkgs.obeliskExecutableConfig.haskellOverlay
27− (import ./haskell-overlays/obelisk.nix)
45+
28− (import ./haskell-overlays/tighten-ob-exes.nix)
46+ # Add obelisk packages
47+ (self: super: let
48+ pkgs = self.callPackage ({ pkgs }: pkgs) {};
49+ in {
50+ obelisk-executable-config-inject = pkgs.obeliskExecutableConfig.platforms.web.inject self;
51+
52+ obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (hackGet ./lib/asset + "/manifest") {};
53+ obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (hackGet ./lib/asset + "/serve-snap") {};
54+ obelisk-backend = self.callCabal2nix "obelisk-backend" (cleanSource ./lib/backend) {};
55+ obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (cleanSource ./lib/cliapp) {};
56+ obelisk-command = self.callCabal2nix "obelisk-command" (cleanSource ./lib/command) {};
57+ obelisk-frontend = self.callCabal2nix "obelisk-frontend" (cleanSource ./lib/frontend) {};
58+ obelisk-run = self.callCabal2nix "obelisk-run" (cleanSource ./lib/run) {};
59+ obelisk-route = self.callCabal2nix "obelisk-route" (cleanSource ./lib/route) {};
60+ obelisk-selftest = self.callCabal2nix "obelisk-selftest" (cleanSource ./lib/selftest) {};
61+ obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (cleanSource ./lib/snap-extras) {};
62+ tabulation = self.callCabal2nix "tabulation" (cleanSource ./lib/tabulation) {};
63+ })
64+
65+ (self: super: let
66+ pkgs = self.callPackage ({ pkgs }: pkgs) {};
67+ haskellLib = pkgs.haskell.lib;
68+ #TODO: Upstream
69+ # Modify a Haskell package to add completion scripts for the given
70+ # executable produced by it. These completion scripts will be picked up
71+ # automatically if the resulting derivation is installed, e.g. by
72+ # `nix-env -i`.
73+ addOptparseApplicativeCompletionScripts = exeName: pkg: haskellLib.overrideCabal pkg (drv: {
74+ postInstall = (drv.postInstall or "") + ''
75+ BASH_COMP_DIR="$out/share/bash-completion/completions"
76+ mkdir -p "$BASH_COMP_DIR"
77+ "$out/bin/${exeName}" --bash-completion-script "$out/bin/${exeName}" >"$BASH_COMP_DIR/ob"
78+
79+ ZSH_COMP_DIR="$out/share/zsh/vendor-completions"
80+ mkdir -p "$ZSH_COMP_DIR"
81+ "$out/bin/${exeName}" --zsh-completion-script "$out/bin/${exeName}" >"$ZSH_COMP_DIR/_ob"
82+
83+ FISH_COMP_DIR="$out/share/fish/vendor_completions.d"
84+ mkdir -p "$FISH_COMP_DIR"
85+ "$out/bin/${exeName}" --fish-completion-script "$out/bin/${exeName}" >"$FISH_COMP_DIR/ob.fish"
86+ '';
87+ });
88+ in {
89+ # Dynamic linking with split objects dramatically increases startup time (about
90+ # 0.5 seconds on a decent machine with SSD), so we do `justStaticExecutables`.
91+ obelisk-command = haskellLib.overrideCabal
92+ (addOptparseApplicativeCompletionScripts "ob"
93+ (haskellLib.justStaticExecutables super.obelisk-command))
94+ (drv: {
95+ buildTools = (drv.buildTools or []) ++ [ pkgs.buildPackages.makeWrapper ];
96+ postFixup = ''
97+ ${drv.postFixup or ""}
98+ # Make `ob` reference its runtime dependencies.
99+ wrapProgram "$out"/bin/ob --prefix PATH : ${pkgs.lib.makeBinPath (commandRuntimeDeps pkgs)}
100+ '';
101+ });
102+ obelisk-selftest = haskellLib.justStaticExecutables super.obelisk-selftest;
103+ })
104+
29 ];
105 ];
30 };
106 };
31
107
108+ reflex-platform = getReflexPlatform system;
109+ inherit (reflex-platform) hackGet nixpkgs;
110+ pkgs = nixpkgs;
111+
32 # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
112 # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
33 ghcObelisk = reflex-platform.ghc;
113 ghcObelisk = reflex-platform.ghc;
34
114
@@ -46,18 +126,19 @@ in rec {
46 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
126 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
47 path = reflex-platform.filterGit ./.;
127 path = reflex-platform.filterGit ./.;
48 obelisk = ghcObelisk;
128 obelisk = ghcObelisk;
49− obeliskEnvs = pkgs.lib.filterAttrs (k: _: k == "tabulation" || pkgs.lib.strings.hasPrefix "obelisk-" k) ghcObeliskEnvs; #TODO: use thunkSet https://github.com/reflex-frp/reflex-platform/pull/671
129+ obeliskEnvs = ghcObeliskEnvs;
50 command = ghcObelisk.obelisk-command;
130 command = ghcObelisk.obelisk-command;
51− shell = pinBuildInputs "obelisk-shell" ([command] ++ command.commandRuntimeDeps);
131+ shell = pinBuildInputs "obelisk-shell" ([command] ++ commandRuntimeDeps pkgs) [];
52
132
53 selftest = pkgs.writeScript "selftest" ''
133 selftest = pkgs.writeScript "selftest" ''
54− #!${pkgs.runtimeShell}
134+ #!/usr/bin/env bash
55 set -euo pipefail
135 set -euo pipefail
56
136
57 PATH="${command}/bin:$PATH"
137 PATH="${command}/bin:$PATH"
58− cd ${./.}
138+ export OBELISK_IMPL="${hackGet ./.}"
59 "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
139 "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
60 '';
140 '';
141+ #TODO: Why can't I build ./skeleton directly as a derivation? `nix-build -E ./.` doesn't work
61 skeleton = pkgs.runCommand "skeleton" {
142 skeleton = pkgs.runCommand "skeleton" {
62 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
143 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
63 } ''
144 } ''
@@ -77,47 +158,30 @@ in rec {
77 '';
158 '';
78
159
79 compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
160 compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
80− set -euo pipefail
161+ mkdir $out
162+ cd $out
81− cd '${haskellLib.justStaticExecutables frontend}'
163+ ln -s "${haskellLib.justStaticExecutables frontend}/bin/frontend.jsexe/all.js" all.unminified.js
82− shopt -s globstar
83− for f in **/all.js; do
84− dir="$out/$(basename "$(dirname "$f")")"
85− mkdir -p "$dir"
86− ln -s "$(realpath "$f")" "$dir/all.unminified.js"
87− ${if optimizationLevel == null then ''
164+ ${if optimizationLevel == null then ''
88− ln -s "$dir/all.unminified.js" "$dir/all.js"
165+ ln -s all.unminified.js all.js
89− '' else ''
166+ '' else ''
90− '${pkgs.closurecompiler}/bin/closure-compiler' --externs '${reflex-platform.ghcjsExternsJs}' -O '${optimizationLevel}' --jscomp_warning=checkVars --create_source_map="$dir/all.js.map" --source_map_format=V3 --js_output_file="$dir/all.js" "$dir/all.unminified.js"
167+ ${pkgs.closurecompiler}/bin/closure-compiler --externs "${reflex-platform.ghcjsExternsJs}" -O ${optimizationLevel} --jscomp_warning=checkVars --create_source_map="all.js.map" --source_map_format=V3 --js_output_file="all.js" all.unminified.js
91− echo '//# sourceMappingURL=all.js.map' >> "$dir/all.js"
168+ echo "//# sourceMappingURL=all.js.map" >> all.js
92− ''}
169+ ''}
93− done
94 '';
170 '';
95
171
96 serverModules = {
172 serverModules = {
97− mkBaseEc2 = { nixosPkgs, ... }: {...}: {
173+ mkBaseEc2 = { hostName, routeHost, enableHttps, adminEmail, ... }: {...}: {
98 imports = [
174 imports = [
99− (nixosPkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
175+ (pkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
100 ];
176 ];
101− ec2.hvm = true;
102− };
103−
104− mkDefaultNetworking = { adminEmail, enableHttps, hostName, routeHost, ... }: {...}: {
105 networking = {
177 networking = {
106 inherit hostName;
178 inherit hostName;
107 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
179 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
108 };
180 };
109−
110− # `amazon-image.nix` already sets these but if the user provides their own module then
111− # forgetting these can cause them to lose access to the server!
112− # https://github.com/NixOS/nixpkgs/blob/fab05f17d15e4e125def4fd4e708d205b41d8d74/nixos/modules/virtualisation/amazon-image.nix#L133-L136
113− services.openssh.enable = true;
114− services.openssh.permitRootLogin = "prohibit-password";
115−
116 security.acme.certs = if enableHttps then {
181 security.acme.certs = if enableHttps then {
117 "${routeHost}".email = adminEmail;
182 "${routeHost}".email = adminEmail;
118 } else {};
183 } else {};
119−
184+ ec2.hvm = true;
120− security.acme.${if enableHttps && (terms.security.acme.acceptTerms or false) then "acceptTerms" else null} = true;
121 };
185 };
122
186
123 mkObeliskApp =
187 mkObeliskApp =
@@ -134,16 +198,12 @@ in rec {
134 }: {...}: {
198 }: {...}: {
135 services.nginx = {
199 services.nginx = {
136 enable = true;
200 enable = true;
137− recommendedProxySettings = true;
138 virtualHosts."${routeHost}" = {
201 virtualHosts."${routeHost}" = {
139 enableACME = enableHttps;
202 enableACME = enableHttps;
140 forceSSL = enableHttps;
203 forceSSL = enableHttps;
141 locations.${baseUrl} = {
204 locations.${baseUrl} = {
142− proxyPass = "http://127.0.0.1:" + toString internalPort;
205+ proxyPass = "http://localhost:" + toString internalPort;
143 proxyWebsockets = true;
206 proxyWebsockets = true;
144− extraConfig = ''
145− access_log off;
146− '';
147 };
207 };
148 };
208 };
149 };
209 };
@@ -151,11 +211,10 @@ in rec {
151 wantedBy = [ "multi-user.target" ];
211 wantedBy = [ "multi-user.target" ];
152 after = [ "network.target" ];
212 after = [ "network.target" ];
153 restartIfChanged = true;
213 restartIfChanged = true;
154− path = [ pkgs.gnutar ];
155 script = ''
214 script = ''
156 ln -sft . '${exe}'/*
215 ln -sft . '${exe}'/*
157 mkdir -p log
216 mkdir -p log
158− exec ./backend ${backendArgs} </dev/null
217+ exec ./backend ${backendArgs} >>backend.out 2>>backend.err </dev/null
159 '';
218 '';
160 serviceConfig = {
219 serviceConfig = {
161 User = user;
220 User = user;
@@ -178,213 +237,163 @@ in rec {
178 };
237 };
179 };
238 };
180
239
181− inherit mkAssets;
240+ dockerImage = args@{exe, name}: let
241+ dockerImageSetupScript = nixpkgs.dockerTools.shellScript "dockersetup.sh" ''
242+ set -ex
243+
244+ ${nixpkgs.dockerTools.shadowSetup}
245+ echo 'nobody:x:99:99:Nobody:/:/sbin/nologin' >> /etc/passwd
246+ echo 'nobody:*:17416:0:99999:7:::' >> /etc/shadow
247+ echo 'nobody:x:99:' >> /etc/group
248+ echo 'nobody:::' >> /etc/gshadow
249+
250+ mkdir -p /var/run/backend
251+ ln -sft /var/run/backend '${exe}'/*
252+ ${nixpkgs.findutils}/bin/find /var/run/backend
253+
254+ chown 99:99 /var/run/backend
255+ '';
256+
257+ in nixpkgs.dockerTools.buildImage {
258+ name = name;
259+ contents = [ nixpkgs.iana-etc nixpkgs.cacert ];
260+ runAsRoot = dockerImageSetupScript;
261+ keepContentsDirlinks = true;
262+ config = {
263+
264+ Env = [
265+ ("PATH=" + builtins.concatStringsSep(":")([
266+ "${nixpkgs.stdenv.shellPackage}/bin"
267+ "${nixpkgs.coreutils}/bin"
268+ "/var/run/backend"
269+ ]))
270+ ];
271+ Expose = 8000;
272+ Entrypoint = ["/var/run/backend/backend"];
273+ WorkingDir = "/var/run/backend";
274+ User = "99:99";
275+ };
276+ };
182
277
183 serverExe = backend: frontend: assets: optimizationLevel: version:
278 serverExe = backend: frontend: assets: optimizationLevel: version:
184 pkgs.runCommand "serverExe" {} ''
279 pkgs.runCommand "serverExe" {} ''
185 mkdir $out
280 mkdir $out
186 set -eux
281 set -eux
187− ln -s '${if profiling then backend else haskellLib.justStaticExecutables backend}'/bin/* $out/
282+ ln -s "${haskellLib.justStaticExecutables backend}"/bin/* $out/
188− ln -s '${mkAssets assets}' $out/static.assets
283+ ln -s "${mkAssets assets}" $out/static.assets
189− for d in '${mkAssets (compressedJs frontend optimizationLevel)}'/*/; do
284+ ln -s ${mkAssets (compressedJs frontend optimizationLevel)} $out/frontend.jsexe.assets
190− ln -s "$d" "$out"/"$(basename "$d").assets"
191− done
192 echo ${version} > $out/version
285 echo ${version} > $out/version
193 '';
286 '';
194
287
195− server = { exe, hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }@args:
288+ server = { exe, hostName, adminEmail, routeHost, enableHttps, version }@args:
196 let
289 let
197 nixos = import (pkgs.path + /nixos);
290 nixos = import (pkgs.path + /nixos);
198 in nixos {
291 in nixos {
199 system = "x86_64-linux";
292 system = "x86_64-linux";
200 configuration = {
293 configuration = {
201 imports = [
294 imports = [
202− (module { inherit exe hostName adminEmail routeHost enableHttps version; nixosPkgs = pkgs; })
203− (serverModules.mkDefaultNetworking args)
295+ (serverModules.mkBaseEc2 args)
204 (serverModules.mkObeliskApp args)
296 (serverModules.mkObeliskApp args)
205− ./acme.nix # Backport of ACME upgrades from 20.03
206− ];
207−
208− # Backport of ACME upgrades from 20.03
209− disabledModules = [
210− (pkgs.path + /nixos/modules/security/acme.nix)
211− ];
212− nixpkgs.overlays = [
213− (self: super: {
214− lego = (import (builtins.fetchTarball {
215− url = https://github.com/NixOS/nixpkgs-channels/archive/70717a337f7ae4e486ba71a500367cad697e5f09.tar.gz;
216− sha256 = "1sbmqn7yc5iilqnvy9nvhsa9bx6spfq1kndvvis9031723iyymd1";
217− }) {}).lego;
218− })
219 ];
297 ];
220 };
298 };
221 };
299 };
222
300
223− # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
224− project = base': projectDefinition:
225− let
226− projectOut = { system, enableLibraryProfiling ? profiling }: let reflexPlatformProject = (getReflexPlatform { inherit system enableLibraryProfiling; }).project; in reflexPlatformProject (args@{ nixpkgs, ... }:
227− let
228− inherit (lib.strings) hasPrefix;
229− mkProject =
230− { android ? null #TODO: Better error when missing
231− , ios ? null #TODO: Better error when missing
232− , packages ? {}
233− , overrides ? _: _: {}
234− , staticFiles ? null
235− , tools ? _: []
236− , shellToolOverrides ? _: _: {}
237− , withHoogle ? false # Setting this to `true` makes shell reloading far slower
238− , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
239− , __withGhcide ? false
240− }:
241− let
242− allConfig = nixpkgs.lib.makeExtensible (self: {
243− base = base';
244− inherit args;
245− userSettings = {
246− inherit android ios packages overrides tools shellToolOverrides withHoogle __closureCompilerOptimizationLevel __withGhcide;
247− staticFiles = if staticFiles == null then self.base + /static else staticFiles;
248− };
249− frontendName = "frontend";
250− backendName = "backend";
251− commonName = "common";
252− staticName = "obelisk-generated-static";
253− staticFilesImpure = let fs = self.userSettings.staticFiles; in if lib.isDerivation fs then fs else toString fs;
254− processedStatic = processAssets { src = self.userSettings.staticFiles; };
255− # The packages whose names and roles are defined by this package
256− predefinedPackages = lib.filterAttrs (_: x: x != null) {
257− ${self.frontendName} = nullIfAbsent (self.base + "/frontend");
258− ${self.commonName} = nullIfAbsent (self.base + "/common");
259− ${self.backendName} = nullIfAbsent (self.base + "/backend");
260− };
261− shellPackages = {};
262− combinedPackages = self.predefinedPackages // self.userSettings.packages // self.shellPackages;
263− projectOverrides = self': super': {
264− ${self.staticName} = haskellLib.dontHaddock (self'.callCabal2nix self.staticName self.processedStatic.haskellManifest {});
265− ${self.backendName} = haskellLib.addBuildDepend super'.${self.backendName} self'.obelisk-run;
266− };
267− totalOverrides = lib.composeExtensions self.projectOverrides self.userSettings.overrides;
268− privateConfigDirs = ["config/backend"];
269− injectableConfig = builtins.filterSource (path: _:
270− !(lib.lists.any (x: hasPrefix (toString self.base + "/" + toString x) (toString path)) self.privateConfigDirs)
271− );
272− __androidWithConfig = configPath: {
273− ${if self.userSettings.android == null then null else self.frontendName} = {
274− executableName = "frontend";
275− ${if builtins.pathExists self.userSettings.staticFiles then "assets" else null} =
276− nixpkgs.obeliskExecutableConfig.platforms.android.inject
277− (self.injectableConfig configPath)
278− self.processedStatic.symlinked;
279− } // self.userSettings.android;
280− };
281− __iosWithConfig = configPath: {
282− ${if self.userSettings.ios == null then null else self.frontendName} = {
283− executableName = "frontend";
284− ${if builtins.pathExists self.userSettings.staticFiles then "staticSrc" else null} =
285− nixpkgs.obeliskExecutableConfig.platforms.ios.inject
286− (self.injectableConfig configPath)
287− self.processedStatic.symlinked;
288− } // self.userSettings.ios;
289− };
290−
291− shells-ghc = builtins.attrNames (self.predefinedPackages // self.shellPackages);
292
301
293− shells-ghcjs = [
302+ # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
294− self.frontendName
303+ project = base: projectDefinition:
295− self.commonName
304+ let projectOut = sys: (getReflexPlatform sys).project (args@{ nixpkgs, ... }:
296− ];
305+ let mkProject = { android ? null #TODO: Better error when missing
297−
306+ , ios ? null #TODO: Better error when missing
298− shells-ghcSavedSplices = [
307+ , packages ? {}
299− self.commonName
308+ , overrides ? _: _: {}
300− self.frontendName
309+ , staticFiles ? base + /static
301− ];
310+ , tools ? _: []
302−
311+ , shellToolOverrides ? _: _: {}
303− shellToolOverrides = lib.composeExtensions
312+ , withHoogle ? false # Setting this to `true` makes shell reloading far slower
304− self.userSettings.shellToolOverrides
313+ , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
305− (if self.userSettings.__withGhcide
314+ }:
306− then (import ./haskell-overlays/ghcide.nix)
315+ let frontendName = "frontend";
307− else (_: _: {})
316+ backendName = "backend";
317+ commonName = "common";
318+ staticName = "obelisk-generated-static";
319+ staticFilesImpure = if lib.isDerivation staticFiles then staticFiles else toString staticFiles;
320+ processedStatic = processAssets { src = staticFiles; };
321+ # The packages whose names and roles are defined by this package
322+ predefinedPackages = lib.filterAttrs (_: x: x != null) {
323+ ${frontendName} = nullIfAbsent (base + "/frontend");
324+ ${commonName} = nullIfAbsent (base + "/common");
325+ ${backendName} = nullIfAbsent (base + "/backend");
326+ };
327+ combinedPackages = predefinedPackages // packages;
328+ projectOverrides = self: super: {
329+ ${staticName} = haskellLib.dontHaddock (self.callCabal2nix staticName processedStatic.haskellManifest {});
330+ ${backendName} = haskellLib.addBuildDepend super.${backendName} self.obelisk-run;
331+ };
332+ totalOverrides = lib.composeExtensions projectOverrides overrides;
333+ inherit (lib.strings) hasPrefix;
334+ privateConfigDirs = ["config/backend"];
335+ injectableConfig = builtins.filterSource (path: _:
336+ !(lib.lists.any (x: hasPrefix (toString base + "/" + toString x) (toString path)) privateConfigDirs)
308 );
337 );
309−
338+ __androidWithConfig = configPath: {
310− project = reflexPlatformProject ({...}: self.projectConfig);
339+ ${if android == null then null else frontendName} = {
311− projectConfig = {
340+ executableName = "frontend";
312− inherit (self) shellToolOverrides;
341+ ${if builtins.pathExists staticFiles then "assets" else null} =
313− inherit (self.userSettings) tools withHoogle;
342+ nixpkgs.obeliskExecutableConfig.platforms.android.inject
314− overrides = self.totalOverrides;
343+ (injectableConfig configPath)
315− packages = self.combinedPackages;
344+ processedStatic.symlinked;
316− shells = {
345+ } // android;
317− ${if self.userSettings.android == null && self.userSettings.ios == null then null else "ghcSavedSplices"} =
318− lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghcSavedSplices;
319− ghc = lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghc;
320− ghcjs = lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghcjs;
321 };
346 };
322− android = self.__androidWithConfig (self.base + "/config");
347+ __iosWithConfig = configPath: {
323− ios = self.__iosWithConfig (self.base + "/config");
348+ ${if ios == null then null else frontendName} = {
324−
349+ executableName = "frontend";
325− passthru = {
350+ ${if builtins.pathExists staticFiles then "staticSrc" else null} =
326− __unstable__.self = allConfig;
351+ nixpkgs.obeliskExecutableConfig.platforms.ios.inject
327− inherit (self)
352+ (injectableConfig configPath)
328− staticFilesImpure processedStatic
353+ processedStatic.symlinked;
329− __iosWithConfig __androidWithConfig
354+ } // ios;
330− ;
331− inherit (self.userSettings)
332− android ios overrides packages shellToolOverrides staticFiles tools withHoogle
333− __closureCompilerOptimizationLevel
334− ;
335 };
355 };
356+ in {
357+ inherit shellToolOverrides tools withHoogle;
358+ overrides = totalOverrides;
359+ packages = combinedPackages;
360+ shells = {
361+ ${if android == null && ios == null then null else "ghcSavedSplices"} = (lib.filter (x: lib.hasAttr x combinedPackages) [
362+ commonName
363+ frontendName
364+ ]);
365+ ghc = (lib.filter (x: lib.hasAttr x combinedPackages) [
366+ backendName
367+ commonName
368+ frontendName
369+ ]);
370+ ghcjs = lib.filter (x: lib.hasAttr x combinedPackages) [
371+ frontendName
372+ commonName
373+ ];
336 };
374 };
375+ android = __androidWithConfig (base + "/config");
376+ ios = __iosWithConfig (base + "/config");
377+ passthru = { inherit android ios packages overrides tools shellToolOverrides withHoogle staticFiles staticFilesImpure __closureCompilerOptimizationLevel processedStatic __iosWithConfig __androidWithConfig; };
337− });
378+ };
338− in allConfig;
339− in (mkProject (projectDefinition args)).projectConfig);
379+ in mkProject (projectDefinition args));
340− mainProjectOut = projectOut { inherit system; };
341− serverOn = projectInst: version: serverExe
380+ serverOn = sys: version: serverExe
342− projectInst.ghc.backend
381+ (projectOut sys).ghc.backend
343− mainProjectOut.ghcjs.frontend
382+ (projectOut system).ghcjs.frontend
344− projectInst.passthru.staticFiles
383+ (projectOut sys).passthru.staticFiles
345− projectInst.passthru.__closureCompilerOptimizationLevel
384+ (projectOut sys).passthru.__closureCompilerOptimizationLevel
346 version;
385 version;
347− linuxExe = serverOn (projectOut { system = "x86_64-linux"; });
386+ linuxExe = serverOn "x86_64-linux";
348 dummyVersion = "Version number is only available for deployments";
387 dummyVersion = "Version number is only available for deployments";
349− in mainProjectOut // {
350− __unstable__.profiledObRun = let
351− profiled = projectOut { inherit system; enableLibraryProfiling = true; };
388+ in projectOut system // {
352− exeSource = builtins.toFile "ob-run.hs" ''
353− {-# LANGUAGE NoImplicitPrelude #-}
354− {-# LANGUAGE PackageImports #-}
355− module Main where
356−
357− -- Explicitly import Prelude from base lest there be multiple modules called Prelude
358− import "base" Prelude (IO, (++), read)
359−
360− import "base" Control.Exception (finally)
361− import "reflex" Reflex.Profiled (writeProfilingData)
362− import "base" System.Environment (getArgs)
363−
364− import qualified "obelisk-run" Obelisk.Run
365− import qualified Frontend
366− import qualified Backend
367−
368− main :: IO ()
369− main = do
370− [portStr, assets, profFileName] <- getArgs
371− Obelisk.Run.run (read portStr) (Obelisk.Run.runServeAsset assets) Backend.backend Frontend.frontend
372− `finally` writeProfilingData (profFileName ++ ".rprof")
373− '';
374− in nixpkgs.runCommand "ob-run" {
375− buildInputs = [ (profiled.ghc.ghcWithPackages (p: [p.backend p.frontend])) ];
376− } ''
377− cp ${exeSource} ob-run.hs
378− mkdir -p $out/bin
379− ghc -x hs -prof -fno-prof-auto -threaded ob-run.hs -o $out/bin/ob-run
380− '';
381−
382 linuxExeConfigurable = linuxExe;
389 linuxExeConfigurable = linuxExe;
383 linuxExe = linuxExe dummyVersion;
390 linuxExe = linuxExe dummyVersion;
384− exe = serverOn mainProjectOut dummyVersion;
391+ exe = serverOn system dummyVersion;
385− server = args@{ hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }:
392+ server = args@{ hostName, adminEmail, routeHost, enableHttps, version }:
386 server (args // { exe = linuxExe version; });
393 server (args // { exe = linuxExe version; });
394+ dockerImage = args@{ name, version }:
395+ dockerImage { name = name; exe = linuxExe version; };
387− obelisk = import (base' + "/.obelisk/impl") {};
396+ obelisk = import (base + "/.obelisk/impl") {};
388 };
397 };
389 haskellPackageSets = {
398 haskellPackageSets = {
390 inherit (reflex-platform) ghc ghcjs;
399 inherit (reflex-platform) ghc ghcjs;
dep/.gitignorenew file+4
@@ -0,0 +1,4 @@
1+*
2+!.gitignore
3+!*/*.json
4+!*/default.nix
dep/ghcid/default.nixdeleted−7
@@ -1,7 +0,0 @@
1−# DO NOT HAND-EDIT THIS FILE
2−import ((import <nixpkgs> {}).fetchFromGitHub (
3− let json = builtins.fromJSON (builtins.readFile ./github.json);
4− in { inherit (json) owner repo rev sha256;
5− private = json.private or false;
6− }
7−))
dep/ghcid/github.jsondeleted−7
@@ -1,7 +0,0 @@
1−{
2− "owner": "ndmitchell",
3− "repo": "ghcid",
4− "branch": "master",
5− "rev": "f572318f32b1617f6054248e5888af68222f8e50",
6− "sha256": "1icg3r70lg2kmd9gdc024ih1n9nrja98yav74z9nvykqygvv5w0n"
7−}
dep/gitignore.nix/default.nixdeleted−8
@@ -1,8 +0,0 @@
1−# DO NOT HAND-EDIT THIS FILE
2−let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
3− if !fetchSubmodules && !private then builtins.fetchTarball {
4− url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
5− } else (import <nixpkgs> {}).fetchFromGitHub {
6− inherit owner repo rev sha256 fetchSubmodules private;
7− };
8−in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))
dep/gitignore.nix/github.jsondeleted−8
@@ -1,8 +0,0 @@
1−{
2− "owner": "hercules-ci",
3− "repo": "gitignore.nix",
4− "branch": "master",
5− "private": false,
6− "rev": "7415c4feb127845553943a3856cbc5cb967ee5e0",
7− "sha256": "1zd1ylgkndbb5szji32ivfhwh04mr1sbgrnvbrqpmfb67g2g3r9i"
8−}
dep/hnix/default.nixdeleted−7
@@ -1,7 +0,0 @@
1−# DO NOT HAND-EDIT THIS FILE
2−import ((import <nixpkgs> {}).fetchFromGitHub (
3− let json = builtins.fromJSON (builtins.readFile ./github.json);
4− in { inherit (json) owner repo rev sha256;
5− private = json.private or false;
6− }
7−))
dep/hnix/github.jsondeleted−7
@@ -1,7 +0,0 @@
1−{
2− "owner": "haskell-nix",
3− "repo": "hnix",
4− "branch": "master",
5− "rev": "6c9c7c310c54372b3db0fdf5a0137b395cde1bdb",
6− "sha256": "1i5903b7lxqn2s3jarb14h6wdq8bxiik1hp0xy43w5w1hgvvq0g5"
7−}
dep/reflex-platform/default.nix+6−1
@@ -1,2 +1,7 @@
1# DO NOT HAND-EDIT THIS FILE
1# DO NOT HAND-EDIT THIS FILE
2−import (import ./thunk.nix)
2+import ((import <nixpkgs> {}).fetchFromGitHub (
3+ let json = builtins.fromJSON (builtins.readFile ./github.json);
4+ in { inherit (json) owner repo rev sha256;
5+ private = json.private or false;
6+ }
7+))
dep/reflex-platform/github.json+3−4
@@ -1,8 +1,7 @@
1{
1{
2 "owner": "reflex-frp",
2 "owner": "reflex-frp",
3 "repo": "reflex-platform",
3 "repo": "reflex-platform",
4− "branch": "release/0.7.0.0",
4+ "branch": "cg-bump-reflex-dom",
5− "private": false,
5+ "rev": "b220ba089e2de2110eb22c5388e09d99e4321148",
6− "rev": "27a7851a780ff21472d85f9a02fb84635ef9027a",
6+ "sha256": "0ds6bcw4p9q5x8h39djyqp5sp7wdzr9mmknsyjafn5l199hscppw"
7− "sha256": "1m4zlw91dpjlbdchjyxhvhv3k7lilm0qa17dhhww868xxc27sann"
8}
7}
dep/reflex-platform/thunk.nixdeleted−9
@@ -1,9 +0,0 @@
1−# DO NOT HAND-EDIT THIS FILE
2−let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
3− if !fetchSubmodules && !private then builtins.fetchTarball {
4− url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
5− } else (import <nixpkgs> {}).fetchFromGitHub {
6− inherit owner repo rev sha256 fetchSubmodules private;
7− };
8− json = builtins.fromJSON (builtins.readFile ./github.json);
9−in fetch json
dep/snap-core/default.nixdeleted−8
@@ -1,8 +0,0 @@
1−# DO NOT HAND-EDIT THIS FILE
2−let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
3− if !fetchSubmodules && !private then builtins.fetchTarball {
4− url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
5− } else (import <nixpkgs> {}).fetchFromGitHub {
6− inherit owner repo rev sha256 fetchSubmodules private;
7− };
8−in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))
dep/snap-core/github.jsondeleted−8
@@ -1,8 +0,0 @@
1−{
2− "owner": "obsidiansystems",
3− "repo": "snap-core",
4− "branch": "ts-expose-fileserve-internals",
5− "private": false,
6− "rev": "e015fc484e38dd9389c58b277b1884395e553bdf",
7− "sha256": "1793x1h4lw9vnrii5akhfxx1x9yrgxf3052jf6bs8f1mhaic6mxx"
8−}
docs/obelisk-logo-640.pngdeleted

Binary file not shown.

guides/app-deploy/README.mddeleted−324
@@ -1,324 +0,0 @@
1−# Obelisk Application Deployment Guide
2−
3−This document serves two purposes, the first one is to guide new users that want to deploy Obelisk/Reflex apps and the second one to provide a walk-through for test driving Obelisk releases.
4−
5−> **Note:** This guide can be completed on a Linux host with Nix installed or a macOS host with Nix installed. Each section is labeled regarding which operating system hosts it supports. When going through the guide, start at the beginning and go through all sections that are supported on your host and merely skip sections that are not supported. The sections for iOS deployments require an iPhone or iPad device and the sections for Android deployments require an Android device. This guide assumes that you have Nix correctly set up and that your system is configured to fetch from binary caches instead of building everything on your machine. If you notice any of the commands below takes more than 5 minutes, then caches are not likely enabled.
6−>
7−> Refer to the [Obelisk Installation Documentation](https://github.com/obsidiansystems/obelisk#installing-obelisk) for instructions on configuring the binary caches for any Nix-compatible setup.
8−
9−## a) Get Obelisk (Linux, Mac)
10−
11−There are several ways to install Obelisk, but the one we are going to use here allows us to test a single version of Obelisk in different ways. The approach is to clone Obelisk from its GitHub repository and start a project that uses that local check out.
12−
13−Open a terminal and run the following:
14−
15−```bash
16−export WORKDIR=~/obelisk-guide
17−mkdir -p "$WORKDIR"
18−```
19−
20−Then let's get Obelisk from GitHub using a specific branch:
21−
22−```bash
23−export OBELISK_BRANCH=develop
24−git clone https://github.com/obsidiansystems/obelisk.git -b "$OBELISK_BRANCH" "$WORKDIR/obelisk"
25−```
26−
27−Once you have an Obelisk check out, you can build it using Nix and make a shortcut (alias) for the rest of the terminal session. With this you will be able to type `ob` anywhere as long as you do not close the terminal.
28−
29−```bash
30−alias ob=$(nix-build "$WORKDIR/obelisk" -A command --no-out-link)/bin/ob
31−```
32−
33−In order to start an Obelisk project, we need initialize it in a new directory. Let's call it `myapp`:
34−
35−```bash
36−mkdir -p "$WORKDIR/myapp"
37−cd "$WORKDIR/myapp"
38−ob init --branch "$OBELISK_BRANCH"
39−```
40−
41−> **Note:** If the `--branch` parameter is not used, then Obelisk sets your project up to look at the `master` branch from GitHub. This is quite handy for real life projects but distracting for our test drive since we want to make sure any changes we do to the Obelisk codebase (like testing a pull request) are immediately picked up.
42−
43−## b) Run the Obelisk app on localhost (Linux, Mac)
44−
45−Let's test that we can run a server on localhost. This is quite easy:
46−
47−```bash
48−cd "$WORKDIR/myapp"
49−ob run
50−```
51−
52−Now open a browser and point it to http://localhost:8000 (or just click on this link). You should see the following:
53−
54−![](assets/app-deploy.png)
55−
56−## c) Prepare a VirtualBox deploy target (Linux, Mac)
57−
58−### Import the NixOS VirtualBox appliance
59−
60−Install [VirtualBox](https://www.virtualbox.org/) on your machine.
61−
62−On NixOS, do this by adding the following line to your `/etc/nixos/configuration.nix` before the last line containing `}`:
63−
64−```nix
65− virtualisation.virtualbox.host.enable = true;
66−```
67−
68−then `sudo nixos-rebuild switch`.
69−
70−The NixOS [download page](https://nixos.org/nixos/download.html) has a section called "VirtualBox appliances". Download that as the target system. The author used the 19.09 `.ova` file.
71−
72−With the downloaded file, open VirtualBox and import the `.ova` file:
73−
74−![](assets/virtualbox-appliance-import.png)
75−
76−Leave the default settings and finish the import. That will take a few minutes:
77−
78−![](assets/virtualbox-appliance-import-loading.png)
79−
80−You should now see a NixOS machine in the dashboard:
81−
82−![](assets/virtualbox-dashboard-nixos.png)
83−
84−If you are on a network with DHCP on your wireless or network card then right-click on the "NixOS" image and click "Settings". Go to the "Network" section and make "Attached to:" set to "Bridged Adapter".
85−
86−![](assets/virtualbox-image-settings-network.png)
87−
88−Finally, double-click on the "NixOS" machine and wait for it boot up. If it asks for a password, use `demo`.
89−
90−![](assets/virtualbox-nioxs-after-boot.png)
91−
92−### Configure the virtual machine for SSH
93−
94−Inside the virtual machine open up "Konsole" by clicking on the start menu in the bottom left corner and typing in "Konsole" until you see it as an option in the menu. Then click on it to open it.
95−
96−Change the system configuration using `sudo` to enable SSH access:
97−
98−```bash
99−sudo nano /etc/nixos/configuration.nix
100−```
101−
102−This will ask you to enter your password. Enter `demo`.
103−
104−![](assets/nano-edit-nixos-configuration.png)
105−
106−You need to add the following snippet right before the final line containing `}`.
107−
108−```nix
109− services.openssh.enable = true;
110− services.openssh.permitRootLogin = "yes";
111−```
112−
113−Save and close the editor by typing <kbd>Ctrl</kbd>+<kbd>O</kbd>, <kbd>Enter</kbd>, and then <kbd>Ctrl</kbd>+<kbd>X</kbd>.
114−
115−Now run `sudo nixos-rebuild switch` (if it asks for a password, again use `demo`) and then set the root password using `sudo passwd root`. Pick a simple password like `root`. You'll need to use it again.
116−
117−To get the virtual machine's IP address go back to the terminal on your *host* machine (not the virtual machine) and run:
118−
119−```bash
120−export VM_ID=$(VBoxManage list runningvms | grep "NixOS" | awk -F'[{}]' '{print $2}')
121−echo "$VM_ID"
122−```
123−
124−You should see a single identifier that looks like `388bbbe5-e0a2-4b20-9c76-bbaa5746682e`. If you see anything else then you likely you have multiple NixOS machines running. Stop any other machines and run this command again. (Of course, if you're a power user, just change the `grep` to pick out right VM.)
125−
126−Now get the IP address for that machine:
127−
128−```bash
129−export VM_IP=$(VBoxManage guestproperty enumerate "$VM_ID" | grep /V4/IP | awk '{print $4}' | sed 's/,//')
130−echo "$VM_IP"
131−```
132−
133−You should see an IP like `192.168.7.86`.
134−
135−With that you will be able to SSH into that machine from a terminal, using the username `root`.
136−
137−```bash
138−ssh root@$VM_IP echo "Access granted"
139−```
140−
141−This may ask if you want to trust the fingerprint for this server. Answer `yes`. It will ask you for a password. Enter the one you specified above. You should see `Access granted` printed after you type your password and hit <kbd>Enter</kbd>.
142−
143−> **Note:** If instead you see an error like this
144−>
145−> ```
146−> @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
147−> @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
148−> @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
149−> IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
150−> Someone could be eavesdropping on you right now (man-in-the-middle attack)!
151−> It is also possible that a host key has just been changed.
152−> ```
153−>
154−> you need to remove the old fingerprint for this IP. Run the following:
155−>
156−> ```bash
157−> sed -i "/^$VM_IP /d" ~/.ssh/known_hosts
158−> ```
159−>
160−> and then try the previous `ssh` command again.
161−
162−Now we'll allow access with an SSH key instead of a password. Create a new SSH key with `ssh-keygen`:
163−
164−```bash
165−ssh-keygen -t ed25519 -f "$WORKDIR/obkey" -P ""
166−```
167−
168−Now copy your local SSH key to the server:
169−
170−```bash
171−ssh-copy-id -i "$WORKDIR/obkey.pub" root@$VM_IP
172−```
173−
174−This will ask you for your password again.
175−
176−Now test login with your key instead:
177−
178−```bash
179−ssh -i "$WORKDIR/obkey" root@$VM_IP echo "Access granted"
180−```
181−
182−This should print `Access granted` *without* asking for a password.
183−
184−### Configure the git remote
185−
186−Before the project can be deployed, it needs to be a valid `git` repository.
187−
188−> **Note:** You need `git` installed and configured. You can do that with:
189−>
190−> ```bash
191−> nix-env -i git
192−> git config --global user.name "John Doe"
193−> git config --global user.email johndoe@example.com
194−> ```
195−
196−```bash
197−git init --bare "$WORKDIR/myapp-git-remote"
198−cd "$WORKDIR/myapp"
199−git init
200−git add --all
201−git commit -m "initial commit"
202−git remote add origin "$WORKDIR/myapp-git-remote"
203−git push -u origin master
204−```
205−
206−### Initialize deployment directory
207−
208−With that, we can come back to the Obelisk app and initialize the deployment:
209−
210−```bash
211−cd "$WORKDIR/myapp"
212−ob deploy init --ssh-key "$WORKDIR/obkey" --admin-email a@a.a --hostname $VM_IP --route https://$VM_IP "$WORKDIR/myappdeploy" --disable-https
213−```
214−
215−Then configure the deployment for VirtualBox:
216−
217−```bash
218−echo '{nixosPkgs, ...}: {...}: { imports = [ (nixosPkgs.path + /nixos/modules/virtualisation/virtualbox-image.nix) ]; }' > "$WORKDIR/myappdeploy/module.nix"
219−```
220−
221−## d) Deploy to VirtualBox target (Linux only)
222−
223−> Deploying requires a Linux host in order to build the Linux binaries.
224−
225−Now we can deploy to the VirtualBox VM.
226−
227−```bash
228−cd "$WORKDIR/myappdeploy"
229−ob deploy push -v
230−```
231−
232−Once that is complete, open the webpage with
233−
234−```bash
235−xdg-open http://$VM_IP
236−```
237−
238−If that fails, just get the URL by running
239−
240−```bash
241−echo http://$VM_IP
242−```
243−
244−and copy/paste that URL into your browser navigation input.
245−
246−It should look like this:
247−
248−![](assets/app-deploy-2.png)
249−
250−Congratulations! You have deployed an Obelisk application to a remote server via SSH.
251−
252−## e) Deploy an Android app (Linux only)
253−
254−> **Note:** This section requires that you be running a Linux *host*.
255−
256−Modify `$WORKDIR/myapp/default.nix` to set `config.android_sdk.accept_license = true;` and then update your app.
257−
258−```bash
259−cd "$WORKDIR/myapp"
260−sed -i 's/# config.android_sdk.accept_license = false;/config.android_sdk.accept_license = true;/g' default.nix
261−git add default.nix
262−git commit -m"Accept license"
263−git push
264−```
265−
266−Make sure *USB debugging* is enabled in your Android device ([instructions here](https://developer.android.com/studio/debug/dev-options)) and connect the device using USB. Be sure to confirm any security prompts on the device.
267−
268−Now update your deployment and deploy to Android:
269−
270−```bash
271−cd "$WORKDIR/myappdeploy"
272−ob deploy update
273−ob deploy test android -v
274−```
275−
276−This deployment will ask you to create a password (at least 6 characters long) and then ask you a series of questions. You can pick arbitrary answers. When you are presented with prompt like:
277−
278−```
279−Is CN=a, OU=b, O=c, L=d, ST=e, C=f correct?
280− [no]:
281−```
282−
283−You can enter `yes` to continue. If the deployment fails, try using different USB ports on your computer and running `ob deploy test android -v` again. The USB cable you use can also make a difference.
284−
285−When connecting your Android device you may be asked to "Allow USB debugging". You need to allow it.
286−![](assets/android-confirm-usb-debugging.jpg)
287−
288−
289−When the deployment is complete opening the app should look something like
290−
291−![](assets/android-app.jpg)
292−
293−Congratulations! You have deployed an Obelisk Android app via USB.
294−
295−## f) Deploy an iOS app (Mac only)
296−
297−> **Note:** This section requires that you be running a macOS *host*.
298−
299−Verify that you can see the device from XCode and you have installed a Provisioning profile that links your Apple Developer Id and the Device identifier. The workflow depends on whether or not you are an independent developer or part of an organization and is out of scope for this manual.
300−
301−![](assets/xcode-devices.png)
302−
303−Find your `Team ID` at the following URL (Apple Developer Membership details): https://developer.apple.com/account/#/membership/
304−
305−It will be something like `5B445B3WY1`. With that, you can start the deployment workflow after plugging in an iPhone or iPad via USB and setting it to trust the computer:
306−
307−```bash
308−cd "$WORKDIR/myappdeploy"
309−ob deploy test ios <TEAM-ID> # Use your Team ID here
310−```
311−
312−![](assets/ios-deploy-keychain.png)
313−
314−![](assets/ios-deploy-example.png)
315−
316−If there are no errors and the last line says `100% Installed Package` you can open the device and look for the Obelisk app:
317−
318−![](assets/ios-obelisk-app-icon.jpg)
319−
320−![](assets/ios-obelisk-app-open.jpg)
321−
322−Congratulations, you have deployed an Obelisk app on an iOS device.
323−
324−You are now ready to create your own multi-platform application using Obelisk!
guides/app-deploy/assets/android-app.jpgdeleted

Binary file not shown.

guides/app-deploy/assets/android-confirm-usb-debugging.jpgdeleted

Binary file not shown.

guides/app-deploy/assets/app-deploy-2.pngdeleted

Binary file not shown.

guides/app-deploy/assets/app-deploy.pngdeleted

Binary file not shown.

guides/app-deploy/assets/ios-deploy-example.pngdeleted

Binary file not shown.

guides/app-deploy/assets/ios-deploy-keychain.pngdeleted

Binary file not shown.

guides/app-deploy/assets/ios-obelisk-app-icon.jpgdeleted

Binary file not shown.

guides/app-deploy/assets/ios-obelisk-app-open.jpgdeleted

Binary file not shown.

guides/app-deploy/assets/nano-edit-nixos-configuration.pngdeleted

Binary file not shown.

guides/app-deploy/assets/virtualbox-appliance-import-loading.pngdeleted

Binary file not shown.

guides/app-deploy/assets/virtualbox-appliance-import.pngdeleted

Binary file not shown.

guides/app-deploy/assets/virtualbox-dashboard-nixos.pngdeleted

Binary file not shown.

guides/app-deploy/assets/virtualbox-image-settings-network.pngdeleted

Binary file not shown.

guides/app-deploy/assets/virtualbox-nioxs-after-boot.pngdeleted

Binary file not shown.

guides/app-deploy/assets/xcode-devices.pngdeleted

Binary file not shown.

haskell-overlays/ghcide.nixdeleted−40
@@ -1,40 +0,0 @@
1−self: super:
2−let
3− pkgs = self.callPackage ({ pkgs }: pkgs) { };
4− inherit (pkgs.haskell.lib) dontCheck justStaticExecutables;
5− inherit (pkgs.haskellPackages) callHackageDirect callHackage;
6−
7−in {
8− ghcide = justStaticExecutables (dontCheck (callHackageDirect {
9− pkg = "ghcide";
10− ver = "0.2.0";
11− sha256 = "199l4qzrghhz6wbfkgqdl4gll4wvgpr190kinzhv88idnn9pxm96";
12− } rec {
13− ghc-check = callHackageDirect {
14− pkg = "ghc-check";
15− ver = "0.3.0.1";
16− sha256 = "1dj909m09m24315x51vxvcl28936ahsw4mavbc53danif3wy09ns";
17− } { };
18− lsp-test = dontCheck (callHackage "lsp-test" "0.6.1.0" { });
19− haddock-library = dontCheck (callHackage "haddock-library" "1.8.0" { });
20− haskell-lsp = dontCheck (callHackageDirect {
21− pkg = "haskell-lsp";
22− ver = "0.22.0.0";
23− sha256 = "1q3w46qcvzraxgmw75s7bl0qvb2fvff242r5vfx95sqska566b4m";
24− } { inherit haskell-lsp-types; });
25− haskell-lsp-types = dontCheck (callHackageDirect {
26− pkg = "haskell-lsp-types";
27− ver = "0.22.0.0";
28− sha256 = "1apjclphi2v6ggrdnbc0azxbb1gkfj3x1vkwpc8qd6lsrbyaf0n8";
29− } { });
30− regex-tdfa = dontCheck (callHackage "regex-tdfa" "1.3.1.0" {
31− regex-base = dontCheck (callHackage "regex-base" "0.94.0.0" { });
32− });
33− shake = dontCheck (callHackage "shake" "0.18.4" { });
34− hie-bios = dontCheck (callHackageDirect {
35− pkg = "hie-bios";
36− ver = "0.5.0";
37− sha256 = "116nmpva5jmlgc2dgy8cm5wv6cinhzmga1l0432p305074w720r2";
38− } { });
39− }));
40−}
haskell-overlays/misc-deps.nixdeleted−26
@@ -1,26 +0,0 @@
1−{ hackGet }:
2−
3−# Fix misc upstream packages
4−self: super:
5−
6−let
7− pkgs = self.callPackage ({ pkgs }: pkgs) {};
8− haskellLib = pkgs.haskell.lib;
9−in
10−
11−{
12− regex-base = self.callHackage "regex-base" "0.94.0.0" {};
13− regex-posix = self.callHackage "regex-posix" "0.96.0.0" {};
14− regex-tdfa = self.callHackage "regex-tdfa" "1.3.1.0" {};
15− test-framework = haskellLib.dontCheck (self.callHackage "test-framework" "0.8.2.0" {});
16− hnix = haskellLib.dontCheck (self.callHackage "hnix" "0.8.0" {});
17− hnix-store-core = self.callHackage "hnix-store-core" "0.2.0.0" {};
18−
19− aeson-gadt-th = self.callHackage "aeson-gadt-th" "0.2.4" {};
20−
21− ghcid = self.callCabal2nix "ghcid" (hackGet ../dep/ghcid) {};
22− # Exports more internals
23− snap-core = haskellLib.dontCheck (self.callCabal2nix "snap-core" (hackGet ../dep/snap-core) {});
24−
25− shelly = self.callHackage "shelly" "1.9.0" {};
26−}
haskell-overlays/obelisk.nixdeleted−48
@@ -1,48 +0,0 @@
1−# Add obelisk packages
2−
3−self: super:
4−
5−let
6− pkgs = self.callPackage ({ pkgs }: pkgs) {};
7− inherit (pkgs) obeliskCleanSource;
8− haskellLib = pkgs.haskell.lib;
9− onLinux = pkg: f: if pkgs.stdenv.isLinux then f pkg else pkg;
10−in
11−
12−{
13− obelisk-executable-config-inject = pkgs.obeliskExecutableConfig.platforms.web.inject self;
14−
15− obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (obeliskCleanSource ../lib/asset/manifest) {};
16− obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (obeliskCleanSource ../lib/asset/serve-snap) {};
17− obelisk-backend = self.callCabal2nix "obelisk-backend" (obeliskCleanSource ../lib/backend) {};
18− obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (obeliskCleanSource ../lib/cliapp) {};
19− obelisk-command = haskellLib.overrideCabal (self.callCabal2nix "obelisk-command" (obeliskCleanSource ../lib/command) {}) {
20− librarySystemDepends = [
21− pkgs.jre
22− pkgs.git
23− pkgs.nix
24− pkgs.nix-prefetch-git
25− pkgs.openssh
26− pkgs.rsync
27− pkgs.which
28− (haskellLib.justStaticExecutables self.ghcid)
29− ];
30− };
31− obelisk-frontend = self.callCabal2nix "obelisk-frontend" (obeliskCleanSource ../lib/frontend) {};
32− obelisk-run = onLinux (self.callCabal2nix "obelisk-run" (obeliskCleanSource ../lib/run) {}) (pkg:
33− haskellLib.overrideCabal pkg (drv: { librarySystemDepends = [ pkgs.iproute ]; })
34− );
35− obelisk-route = self.callCabal2nix "obelisk-route" (obeliskCleanSource ../lib/route) {};
36− obelisk-selftest = haskellLib.overrideCabal (self.callCabal2nix "obelisk-selftest" (obeliskCleanSource ../lib/selftest) {}) {
37− librarySystemDepends = [
38− pkgs.cabal-install
39− pkgs.coreutils
40− pkgs.git
41− pkgs.nix
42− pkgs.nix-prefetch-git
43− pkgs.rsync
44− ];
45− };
46− obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (obeliskCleanSource ../lib/snap-extras) {};
47− tabulation = self.callCabal2nix "tabulation" (obeliskCleanSource ../lib/tabulation) {};
48−}
haskell-overlays/tighten-ob-exes.nixdeleted−32
@@ -1,32 +0,0 @@
1−self: super:
2−
3−let
4− pkgs = self.callPackage ({ pkgs }: pkgs) {};
5− haskellLib = pkgs.haskell.lib;
6−
7− commandRuntimeDeps = with pkgs; [
8− coreutils
9− git
10− nix-prefetch-git
11− openssh
12− ];
13−in
14−
15−{
16− # Dynamic linking with split objects dramatically increases startup time (about
17− # 0.5 seconds on a decent machine with SSD), so we do `justStaticExecutables`.
18− obelisk-command = haskellLib.overrideCabal
19− (haskellLib.generateOptparseApplicativeCompletion "ob"
20− (haskellLib.justStaticExecutables super.obelisk-command))
21− (drv: {
22− buildTools = (drv.buildTools or []) ++ [ pkgs.buildPackages.makeWrapper ];
23− postFixup = ''
24− ${drv.postFixup or ""}
25− # Make `ob` reference its runtime dependencies.
26− wrapProgram "$out"/bin/ob --prefix PATH : ${pkgs.lib.makeBinPath commandRuntimeDeps}
27− '';
28− passthru = { inherit commandRuntimeDeps; };
29− });
30−
31− obelisk-selftest = haskellLib.justStaticExecutables super.obelisk-selftest;
32−}
jobsets.nixnew file+71
@@ -0,0 +1,71 @@
1+{ prs }:
2+
3+let
4+ self = import ./. {};
5+ pkgs = self.nixpkgs;
6+ mkFetchGithub = value: {
7+ inherit value;
8+ type = "git";
9+ emailresponsible = false;
10+ };
11+in
12+with pkgs.lib;
13+let
14+ defaults = jobs: {
15+ inherit (jobs) description;
16+ enabled = 1;
17+ hidden = false;
18+ keepnr = 10;
19+ schedulingshares = 100;
20+ checkinterval = 120;
21+ enableemail = false;
22+ emailoverride = "";
23+ nixexprinput = "obelisk";
24+ nixexprpath = "release.nix";
25+ inputs = jobs.inputs // {
26+ nixpkgs = {
27+ type = "git";
28+ value = "https://github.com/NixOS/nixpkgs-channels nixos-unstable";
29+ emailresponsible = false;
30+ };
31+ };
32+ self-args = {
33+ type = "nix";
34+ value = "{ config.android_sdk.accept_license = true; }";
35+ emailresponsible = false;
36+ };
37+ };
38+ branchJobset = branch: defaults {
39+ description = "obelisk-${branch}";
40+ inputs = {
41+ obelisk = {
42+ value = "https://github.com/obsidiansystems/obelisk ${branch}";
43+ type = "git";
44+ emailresponsible = false;
45+ };
46+ };
47+ };
48+ makePr = num: info: {
49+ name = "obelisk-pr-${num}";
50+ value = defaults {
51+ description = "#${num}: ${info.title}";
52+ inputs = {
53+ obelisk = {
54+ #NOTE: This should really use "pull/${num}/merge"; however, GitHub's
55+ #status checks only operate on PR heads. This creates a race
56+ #condition, which can currently only be solved by requiring PRs to be
57+ #up to date before they're merged. See
58+ #https://github.com/isaacs/github/issues/1002
59+ value = "https://github.com/obsidiansystems/obelisk pull/${num}/head";
60+ type = "git";
61+ emailresponsible = false;
62+ };
63+ };
64+ };
65+ };
66+ processedPrs = mapAttrs' makePr (builtins.fromJSON (builtins.readFile prs));
67+ jobsetsAttrs = processedPrs //
68+ genAttrs ["master"] branchJobset;
69+in {
70+ jobsets = pkgs.writeText "spec.json" (builtins.toJSON jobsetsAttrs);
71+}
lib/asset/README.md+20−17
@@ -1,26 +1,29 @@
1−# obelisk-asset
1+## obelisk-asset
2
2
3−[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
3+The 'assets.nix' file contains nix expressions that are a mutually
4−[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://github.com/obsidiansystems/obelisk/blob/master/LICENSE)
5−
6−**Efficiently served, aggressively cached static web resources.**
7−
8−The `assets.nix` file contains nix expressions that are a mutually recursive set of attributes used to create static asset directories with hashable file encodings. This file should be incorporated within your project's `default.nix` file. (See `example/default.nix`, line 2)
4+recursive set of attributes used to create static asset directories
9−
5+with hashable file encodings. This file should be incorporated within
6+your project's 'default.nix' file. (See ./example/default.nix , line 2)
10−```nix
7+```
11−{ assets ? import ./../assets.nix { inherit nixpkgs; } }:
8+{assets ? import ./../assets.nix { inherit nixpkgs; }
9+}:
12```
10```
13
11
14−The `mkAssets` and `mkAssetsWith` functions within `assets.nix` only need to be passed an `encoding("zopfliEncodings", "gzipEncodings", "noEncodings")` and a static directory of your choice as arguments.
12+The 'mkAssets' and 'mkAssetsWith' functions within 'assets.nix' only
15−
13+need to be passed an encoding('zopfliEncodings', 'gzipEncodings',
16−In this example, `mkAssets` is used on a directory that has a `.png` file inside of it. (See `example/default.nix`, line 11)
14+'noEncodings') and a static directory of your choice as arguments.
17
15
18−```nix
16+In this example, 'mkAssets' is used on a directory that has a .png
17+file inside of it. (See ./example/default.nix, line 11)
18+```
19−myAssets = assets.mkAssets ./static;
19+myAssets = assets.mkAssets ./static;
20```
20```
21
21
22−Once you have successfully incorporated `assets.nix` into your project's nix file(s), use `nix-build` to generate a symlink of your `mkAssets` expression. The following command from `example/run-example` (line 3) will generate an immutable symlink that holds hashed static assets.
22+Once you have successfully incorporated 'assets.nix' into your
23−
23+project's nix file(s), use nix-build to generate a symlink of
24+your 'mkAssets' expression. The following command from
25+example/run-example (line 3) will generate an immutable symlink
26+that holds hashed static assets.
24```bash
27```bash
25nix-build -o static.assets -A myAssets
28nix-build -o static.assets -A myAssets
26```
29```
lib/asset/assets.nix+5−28
@@ -20,7 +20,7 @@ zopfliEncodings = file:
20 nixpkgs.stdenv.mkDerivation {
20 nixpkgs.stdenv.mkDerivation {
21 name = "encodings";
21 name = "encodings";
22
22
23− input = mkPath file;
23+ input = file;
24
24
25 builder = builtins.toFile "builder.sh" ''
25 builder = builtins.toFile "builder.sh" ''
26 source "$stdenv/setup"
26 source "$stdenv/setup"
@@ -46,7 +46,7 @@ gzipEncodings = file:
46 nixpkgs.stdenv.mkDerivation {
46 nixpkgs.stdenv.mkDerivation {
47 name = "encodings";
47 name = "encodings";
48
48
49− input = mkPath file;
49+ input = file;
50
50
51 builder = builtins.toFile "builder.sh" ''
51 builder = builtins.toFile "builder.sh" ''
52 source "$stdenv/setup"
52 source "$stdenv/setup"
@@ -70,7 +70,7 @@ noEncodings = file:
70 nixpkgs.stdenv.mkDerivation {
70 nixpkgs.stdenv.mkDerivation {
71 name = "encodings";
71 name = "encodings";
72
72
73− input = mkPath file;
73+ input = file;
74
74
75 builder = builtins.toFile "builder.sh" ''
75 builder = builtins.toFile "builder.sh" ''
76 source "$stdenv/setup"
76 source "$stdenv/setup"
@@ -203,7 +203,7 @@ hashFile = path:
203 nixpkgs.nix
203 nixpkgs.nix
204 ];
204 ];
205 preferLocalBuild = true;
205 preferLocalBuild = true;
206− path = mkPath path;
206+ inherit path;
207 } ''
207 } ''
208 nix-hash --flat --base32 --type sha256 "$path" | tr -d '\n' >"$out"
208 nix-hash --flat --base32 --type sha256 "$path" | tr -d '\n' >"$out"
209 '');
209 '');
@@ -224,30 +224,7 @@ symlink = path: {
224 inherit path;
224 inherit path;
225};
225};
226
226
227−# Tests if a given character (string of length 1) is valid for a derivation path name.
228−# Passing a string of length other than 1 is undefined.
229−# :: Char -> Bool
230−isValidDrvNameChar = c: "a" <= c && c <= "z" || "A" <= c && c <= "Z" || "0" <= c && c <= "9" || c == "+" || c == "-" || c == "_" || c == "?" || c == "=" || c == ".";
231−
232−# Convert a string into a string that could be used in a derivation name.
233−# replacement lets you choose how to replace invalid characters. It may be any length.
234−# If it contains invalid characters then the result will also be invalid.
235−# :: { str :: String, replacement :: String } -> String
236−mkValidDrvName = { str, replacement ? "?" }:
237− let
238− newName = stringAsChars (c: if isValidDrvNameChar c then c else replacement) str;
239− in if builtins.substring 0 1 newName == "." then "_" + newName else newName;
240−
241−# Like builtins.path but always ensures the name is valid.
242−mkPath = path:
243− if builtins.typeOf path == "path" # Don't mess with non-paths
244− then builtins.path {
245− inherit path;
246− name = mkValidDrvName { str = builtins.baseNameOf path; };
247− }
248− else path;
249−
250−# Given an encoding generation function and a file entry resulting from readDirRecursive in the form { name :: String, value: { path :: String } },
227+# Given a encoding generation function and a file entry resulting from readDirRecursive in the form { name :: String, value: { path :: String } },
251# build a DirEntry for dirToPath with the various encodings of the asset for dirToPath to build into a final directory tree.
228# build a DirEntry for dirToPath with the various encodings of the asset for dirToPath to build into a final directory tree.
252mkAsset = encodings: {name, value}:
229mkAsset = encodings: {name, value}:
253 let nameWithHash = "${hashFile value.path}-${name}";
230 let nameWithHash = "${hashFile value.path}-${name}";
lib/asset/manifest/obelisk-asset-manifest.cabal+2−4
@@ -24,7 +24,7 @@ library
24 , template-haskell
24 , template-haskell
25 , text
25 , text
26 , transformers
26 , transformers
27− , unix-compat
27+ , unix
28 , vector
28 , vector
29 exposed-modules:
29 exposed-modules:
30 Obelisk.Asset.Gather
30 Obelisk.Asset.Gather
@@ -33,9 +33,7 @@ library
33 Obelisk.Asset.TH
33 Obelisk.Asset.TH
34
34
35 other-extensions: TemplateHaskell
35 other-extensions: TemplateHaskell
36− ghc-options:
37− -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O2
38− -fno-warn-unused-do-bind -funbox-strict-fields -fprof-auto-calls
36+ ghc-options: -Wall -Werror -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls
39
37
40executable obelisk-asset-manifest-generate
38executable obelisk-asset-manifest-generate
41 hs-source-dirs: src-bin
39 hs-source-dirs: src-bin
lib/asset/manifest/src/Obelisk/Asset/Symlink.hs+1−1
@@ -7,7 +7,7 @@ import Data.Map (Map)
7import qualified Data.Map as Map
7import qualified Data.Map as Map
8import System.Directory
8import System.Directory
9import System.FilePath.Posix
9import System.FilePath.Posix
10−import System.PosixCompat.Files
10+import System.Posix.Files
11
11
12-- | Copy the given hashed files from one location to hashed paths in another
12-- | Copy the given hashed files from one location to hashed paths in another
13-- location, and symlink the unhashed paths to the hashed ones
13-- location, and symlink the unhashed paths to the hashed ones
lib/asset/serve-snap/obelisk-asset-serve-snap.cabal+2−4
@@ -23,12 +23,10 @@ library
23 , obelisk-snap-extras
23 , obelisk-snap-extras
24 , text
24 , text
25 , transformers
25 , transformers
26− , unix-compat
26+ , unix
27 exposed-modules:
27 exposed-modules:
28 Obelisk.Asset.Accept
28 Obelisk.Asset.Accept
29 Obelisk.Asset.Serve.Snap
29 Obelisk.Asset.Serve.Snap
30
30
31 other-extensions: TemplateHaskell
31 other-extensions: TemplateHaskell
32− ghc-options:
33− -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O2
34− -fno-warn-unused-do-bind -funbox-strict-fields -fprof-auto-calls
32+ ghc-options: -Wall -Werror -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls
lib/asset/serve-snap/src/Obelisk/Asset/Accept.hs+6−6
@@ -136,16 +136,16 @@ qvalue = do
136 skipMany lws
136 skipMany lws
137 q0 <|> q1
137 q0 <|> q1
138 where q0 = do
138 where q0 = do
139− _ <- char '0'
139+ char '0'
140 decimals <- option [] $ do
140 decimals <- option [] $ do
141− _ <- char '.'
141+ char '.'
142 starRule (Just 0) (Just numAllowedDigits) digit
142 starRule (Just 0) (Just numAllowedDigits) digit
143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
144 q1 = do
144 q1 = do
145− _ <- char '1'
145+ char '1'
146 option () $ do
146 option () $ do
147− _ <- char '.'
147+ char '.'
148− _ <- starRule (Just 0) (Just numAllowedDigits) $ char '0'
148+ starRule (Just 0) (Just numAllowedDigits) $ char '0'
149 return ()
149 return ()
150 return $ QValue 1
150 return $ QValue 1
151 numAllowedDigits :: Int
151 numAllowedDigits :: Int
@@ -232,7 +232,7 @@ hashRule minNum maxNum element = do
232lws :: Parser ()
232lws :: Parser ()
233lws = do
233lws = do
234 option () $ cr >> lf
234 option () $ cr >> lf
235− _ <- starRule (Just 1) Nothing $ sp <|> ht
235+ starRule (Just 1) Nothing $ sp <|> ht
236 return ()
236 return ()
237
237
238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+11−22
@@ -12,15 +12,13 @@ import Obelisk.Asset.Accept (Encoding (..), acceptEncodingBody, chooseEncoding,
12import Obelisk.Snap.Extras
12import Obelisk.Snap.Extras
13
13
14import Snap
14import Snap
15− (MonadSnap, getHeader, getRequest, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
15+ (MonadSnap, getHeader, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
16import Snap.Util.FileServe (defaultMimeTypes, fileType, getSafePath, serveFile)
16import Snap.Util.FileServe (defaultMimeTypes, fileType, getSafePath, serveFile)
17−import Snap.Internal.Util.FileServe (checkRangeReq)
18
17
19import Control.Applicative ((<|>))
18import Control.Applicative ((<|>))
20import Control.Exception (handleJust, try, throwIO)
19import Control.Exception (handleJust, try, throwIO)
21−import Control.Monad (forM, liftM, unless)
20+import Control.Monad (forM, liftM)
22import Control.Monad.IO.Class (liftIO)
21import Control.Monad.IO.Class (liftIO)
23−import Control.Monad.Fail (MonadFail)
24import Data.Attoparsec.ByteString (parseOnly, endOfInput)
22import Data.Attoparsec.ByteString (parseOnly, endOfInput)
25import Data.ByteString (ByteString)
23import Data.ByteString (ByteString)
26import qualified Data.ByteString as BS
24import qualified Data.ByteString as BS
@@ -31,7 +29,7 @@ import Data.Text.Encoding (decodeUtf8, encodeUtf8)
31import System.Directory (getDirectoryContents)
29import System.Directory (getDirectoryContents)
32import System.FilePath ((</>), splitFileName, takeDirectory)
30import System.FilePath ((</>), splitFileName, takeDirectory)
33import System.IO.Error (isDoesNotExistError)
31import System.IO.Error (isDoesNotExistError)
34−import System.PosixCompat.Files (getFileStatus, fileSize)
32+import System.Posix (getFileStatus, fileSize)
35
33
36-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
34-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
37--
35--
@@ -40,7 +38,7 @@ import System.PosixCompat.Files (getFileStatus, fileSize)
40-- current version of the asset
38-- current version of the asset
41-- (e.g. @0rx5yvkkgkig2pcqf4ngi1l7vh89qqajdzc6aiayaibyhvj0d853-test.png@). Hashed
39-- (e.g. @0rx5yvkkgkig2pcqf4ngi1l7vh89qqajdzc6aiayaibyhvj0d853-test.png@). Hashed
42-- asset names will be sent with permanent caching headers.
40-- asset names will be sent with permanent caching headers.
43−serveAssets :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> m ()
41+serveAssets :: MonadSnap m => FilePath -> FilePath -> m ()
44serveAssets = serveAssets' True
42serveAssets = serveAssets' True
45
43
46-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
44-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
@@ -49,15 +47,15 @@ serveAssets = serveAssets' True
49-- browser for the logical asset name (e.g. @test.png@) but instead the current
47-- browser for the logical asset name (e.g. @test.png@) but instead the current
50-- version of the asset with to point the browser at the unique filename for the
48-- version of the asset with to point the browser at the unique filename for the
51-- current version of the asset.
49-- current version of the asset.
52−serveAssetsInPlace :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> m ()
50+serveAssetsInPlace :: MonadSnap m => FilePath -> FilePath -> m ()
53serveAssetsInPlace = serveAssets' False
51serveAssetsInPlace = serveAssets' False
54
52
55-- | Like 'serveAssets', but only serves a single specified asset
53-- | Like 'serveAssets', but only serves a single specified asset
56−serveAsset :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> FilePath -> m ()
54+serveAsset :: MonadSnap m => FilePath -> FilePath -> FilePath -> m ()
57serveAsset = serveAsset' True
55serveAsset = serveAsset' True
58
56
59-- | Like 'serveAssetsInPlace', but only serves a single specified asset
57-- | Like 'serveAssetsInPlace', but only serves a single specified asset
60−serveAssetInPlace :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> FilePath -> m ()
58+serveAssetInPlace :: MonadSnap m => FilePath -> FilePath -> FilePath -> m ()
61serveAssetInPlace = serveAsset' False
59serveAssetInPlace = serveAsset' False
62
60
63-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
61-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
@@ -65,13 +63,13 @@ serveAssetInPlace = serveAsset' False
65-- For assets generated from @assets.nix@, the @Bool@ argument @doRedirect@ controls whether redirects will be sent to the browser if a request is made for
63-- For assets generated from @assets.nix@, the @Bool@ argument @doRedirect@ controls whether redirects will be sent to the browser if a request is made for
66-- an unhashed asset name, e.g. @test.png@. For @True@, a redirect will be sent, yielding more round trips to the server but better caching behavior if the
64-- an unhashed asset name, e.g. @test.png@. For @True@, a redirect will be sent, yielding more round trips to the server but better caching behavior if the
67-- asset doesn't change often. Conversely for @False@, the asset will be served "in place" but made uncacheable.
65-- asset doesn't change often. Conversely for @False@, the asset will be served "in place" but made uncacheable.
68−serveAssets' :: (MonadSnap m, MonadFail m) => Bool -> FilePath -> FilePath -> m ()
66+serveAssets' :: MonadSnap m => Bool -> FilePath -> FilePath -> m ()
69serveAssets' doRedirect base fallback = do
67serveAssets' doRedirect base fallback = do
70 pRaw <- getSafePath
68 pRaw <- getSafePath
71 serveAsset' doRedirect base fallback $ if "/" `isSuffixOf` pRaw || pRaw == "" then pRaw <> "index.html" else pRaw
69 serveAsset' doRedirect base fallback $ if "/" `isSuffixOf` pRaw || pRaw == "" then pRaw <> "index.html" else pRaw
72
70
73-- | Serve a single static asset from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
71-- | Serve a single static asset from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
74−serveAsset' :: (MonadFail m, MonadSnap m) => Bool -> FilePath -> FilePath -> FilePath -> m ()
72+serveAsset' :: MonadSnap m => Bool -> FilePath -> FilePath -> FilePath -> m ()
75serveAsset' doRedirect base fallback p = do
73serveAsset' doRedirect base fallback p = do
76 assetType <- liftIO $ try $ BS.readFile $ base </> p </> "type"
74 assetType <- liftIO $ try $ BS.readFile $ base </> p </> "type"
77 case assetType of
75 case assetType of
@@ -95,17 +93,8 @@ serveAsset' doRedirect base fallback p = do
95 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
93 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
96 stat <- liftIO $ getFileStatus finalFilename
94 stat <- liftIO $ getFileStatus finalFilename
97 modifyResponse $ setHeader "Last-Modified" "Thu, 1 Jan 1970 00:00:00 GMT"
95 modifyResponse $ setHeader "Last-Modified" "Thu, 1 Jan 1970 00:00:00 GMT"
98− . setHeader "Accept-Ranges" "bytes"
99− . setContentType (fileType defaultMimeTypes p)
100− let size = fromIntegral $ fileSize stat
101− req <- getRequest
102− -- Despite the name, this function actually does all of the work for
103− -- responding to range requests. We only need to handle *none* range
104− -- requests ourselves.
105− wasRange <- checkRangeReq req finalFilename size
106− unless wasRange $ do
107− modifyResponse $ setResponseCode 200 . setContentLength size
96+ modifyResponse $ setResponseCode 200 . setContentLength (fromIntegral $ fileSize stat) . setContentType (fileType defaultMimeTypes p)
108− sendFile finalFilename
97+ sendFile finalFilename
109 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
98 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
110 Right "redirect" -> do
99 Right "redirect" -> do
111 mtarget <- liftIO $ getAssetTarget $ base </> p
100 mtarget <- liftIO $ getAssetTarget $ base </> p
lib/backend/obelisk-backend.cabal+2−2
@@ -21,10 +21,10 @@ library
21 obelisk-frontend,
21 obelisk-frontend,
22 obelisk-route,
22 obelisk-route,
23 obelisk-snap-extras,
23 obelisk-snap-extras,
24− reflex-dom-core,
24+ reflex-dom,
25 snap,
25 snap,
26 snap-server,
26 snap-server,
27 text,
27 text,
28 universe
28 universe
29 exposed-modules: Obelisk.Backend
29 exposed-modules: Obelisk.Backend
30− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
30+ ghc-options: -Wall
lib/backend/src/Obelisk/Backend.hs+41−127
@@ -1,5 +1,3 @@
1−{-# LANGUAGE DeriveFunctor #-}
2−{-# LANGUAGE DeriveGeneric #-}
3{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
4{-# LANGUAGE FlexibleInstances #-}
2{-# LANGUAGE FlexibleInstances #-}
5{-# LANGUAGE GADTs #-}
3{-# LANGUAGE GADTs #-}
@@ -11,37 +9,24 @@
11{-# OPTIONS_GHC -fno-warn-orphans #-}
9{-# OPTIONS_GHC -fno-warn-orphans #-}
12module Obelisk.Backend
10module Obelisk.Backend
13 ( Backend (..)
11 ( Backend (..)
14− , BackendConfig (..)
15− , defaultBackendConfig
16− , StaticAssets (..)
17− , defaultStaticAssets
18− -- * Running a backend
19− , runBackend
20− , runBackendWith
21− -- * Configuration of backend
22− , GhcjsWidgets(..)
23− , defaultGhcjsWidgets
24− -- * all.js script loading functions
25− , deferredGhcjsScript
26− , delayedGhcjsScript
27− -- * all.js preload functions
28− , preloadGhcjs
29− , renderAllJsPath
30 -- * Re-exports
12 -- * Re-exports
31 , Default (def)
13 , Default (def)
32 , getPageName
14 , getPageName
33 , getRouteWith
15 , getRouteWith
34 , runSnapWithCommandLineArgs
16 , runSnapWithCommandLineArgs
35− , runSnapWithConfig
36 , serveDefaultObeliskApp
17 , serveDefaultObeliskApp
37 , prettifyOutput
18 , prettifyOutput
19+ , runBackend
38 , staticRenderContentType
20 , staticRenderContentType
21+ , mkRouteToUrl
39 , getPublicConfigs
22 , getPublicConfigs
40 ) where
23 ) where
41
24
25+import Prelude hiding (id, (.))
26+import Control.Category
42import Control.Monad
27import Control.Monad
43import Control.Monad.Except
28import Control.Monad.Except
44−import Control.Monad.Fail (MonadFail)
29+import Control.Categorical.Bifunctor
45import Data.ByteString (ByteString)
30import Data.ByteString (ByteString)
46import qualified Data.ByteString.Char8 as BSC8
31import qualified Data.ByteString.Char8 as BSC8
47import Data.Default (Default (..))
32import Data.Default (Default (..))
@@ -52,68 +37,43 @@ import qualified Data.Map as Map
52import Data.Monoid ((<>))
37import Data.Monoid ((<>))
53import Data.Text (Text)
38import Data.Text (Text)
54import qualified Data.Text as T
39import qualified Data.Text as T
55−import GHC.Generics (Generic)
40+import Data.Text.Encoding
56import Obelisk.Asset.Serve.Snap (serveAsset)
41import Obelisk.Asset.Serve.Snap (serveAsset)
57import qualified Obelisk.ExecutableConfig.Lookup as Lookup
42import qualified Obelisk.ExecutableConfig.Lookup as Lookup
58import Obelisk.Frontend
43import Obelisk.Frontend
59import Obelisk.Route
44import Obelisk.Route
60import Obelisk.Snap.Extras (doNotCache, serveFileIfExistsAs)
45import Obelisk.Snap.Extras (doNotCache, serveFileIfExistsAs)
61−import Reflex.Dom.Core
46+import Reflex.Dom
62import Snap (MonadSnap, Snap, commandLineConfig, defaultConfig, getsRequest, httpServe, modifyResponse
47import Snap (MonadSnap, Snap, commandLineConfig, defaultConfig, getsRequest, httpServe, modifyResponse
63 , rqPathInfo, rqQueryString, setContentType, writeBS, writeText
48 , rqPathInfo, rqQueryString, setContentType, writeBS, writeText
64− , rqCookies, Cookie(..) , setHeader)
49+ , rqCookies, Cookie(..))
65import Snap.Internal.Http.Server.Config (Config (accessLog, errorLog), ConfigLog (ConfigIoLog))
50import Snap.Internal.Http.Server.Config (Config (accessLog, errorLog), ConfigLog (ConfigIoLog))
66import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
51import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
67
52
68data Backend backendRoute frontendRoute = Backend
53data Backend backendRoute frontendRoute = Backend
69 { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
54 { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
70 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
55 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
71− } deriving (Generic)
56+ }
72−
73−data BackendConfig frontendRoute = BackendConfig
74− { _backendConfig_runSnap :: !(Snap () -> IO ()) -- ^ Function to run the snap server
75− , _backendConfig_staticAssets :: !StaticAssets -- ^ Static assets
76− , _backendConfig_ghcjsWidgets :: !(GhcjsWidgets (Text -> FrontendWidgetT (R frontendRoute) ()))
77− -- ^ Given the URL of all.js, return the widgets which are responsible for
78− -- loading the script.
79− } deriving (Generic)
80
57
81-- | The static assets provided must contain a compiled GHCJS app that corresponds exactly to the Frontend provided
58-- | The static assets provided must contain a compiled GHCJS app that corresponds exactly to the Frontend provided
82data GhcjsApp route = GhcjsApp
59data GhcjsApp route = GhcjsApp
83 { _ghcjsApp_compiled :: !StaticAssets
60 { _ghcjsApp_compiled :: !StaticAssets
84 , _ghcjsApp_value :: !(Frontend route)
61 , _ghcjsApp_value :: !(Frontend route)
85− } deriving (Generic)
86−
87−-- | Widgets used to load all.js on the frontend
88−data GhcjsWidgets a = GhcjsWidgets
89− { _ghcjsWidgets_preload :: a
90− -- ^ A preload widget, placed in the document head
91− , _ghcjsWidgets_script :: a
92− -- ^ A script widget, placed in the document body
93− } deriving (Functor, Generic)
94−
95−
96−-- | Given the URL of all.js, return the widgets which are responsible for
97−-- loading the script. Defaults to 'preloadGhcjs' and 'deferredGhcjsScript'.
98−defaultGhcjsWidgets :: GhcjsWidgets (Text -> FrontendWidgetT r ())
99−defaultGhcjsWidgets = GhcjsWidgets
100− { _ghcjsWidgets_preload = preloadGhcjs
101− , _ghcjsWidgets_script = deferredGhcjsScript
102 }
62 }
103
63
104-- | Serve a frontend, which must be the same frontend that Obelisk has built and placed in the default location
64-- | Serve a frontend, which must be the same frontend that Obelisk has built and placed in the default location
105--TODO: The frontend should be provided together with the asset paths so that this isn't so easily breakable; that will probably make this function obsolete
65--TODO: The frontend should be provided together with the asset paths so that this isn't so easily breakable; that will probably make this function obsolete
106serveDefaultObeliskApp
66serveDefaultObeliskApp
107− :: (MonadSnap m, HasCookies m, MonadFail m)
67+ :: (MonadSnap m, HasCookies m)
108− => (R appRoute -> Text)
68+ => (R appRoute
109− -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
69+ -> Text)
110− -> ([Text] -> m ())
70+ -> ([Text]
71+ -> m ())
111 -> Frontend (R appRoute)
72 -> Frontend (R appRoute)
112 -> Map Text ByteString
73 -> Map Text ByteString
113 -> R (ObeliskRoute appRoute)
74 -> R (ObeliskRoute appRoute)
114 -> m ()
75 -> m ()
115−serveDefaultObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontend =
76+serveDefaultObeliskApp urlEnc serveStaticAsset frontend configs = serveObeliskApp urlEnc serveStaticAsset frontendApp configs
116− serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp
117 where frontendApp = GhcjsApp
77 where frontendApp = GhcjsApp
118 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
78 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
119 , _ghcjsApp_value = frontend
79 , _ghcjsApp_value = frontend
@@ -138,20 +98,17 @@ defaultFrontendGhcjsAssets = StaticAssets
138 , _staticAssets_unprocessed = "frontend.jsexe"
98 , _staticAssets_unprocessed = "frontend.jsexe"
139 }
99 }
140
100
141−runSnapWithConfig :: MonadIO m => Config Snap a -> Snap () -> m ()
101+runSnapWithCommandLineArgs :: MonadIO m => Snap () -> m ()
142−runSnapWithConfig conf a = do
102+runSnapWithCommandLineArgs a = do
103+ -- Get the web server configuration from the command line
104+ cmdLineConf <- liftIO $ commandLineConfig defaultConfig
143− let httpConf = conf
105+ let httpConf = cmdLineConf
144 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
106 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
145 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
107 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
146 }
108 }
147 -- Start the web server
109 -- Start the web server
148 liftIO $ httpServe httpConf a
110 liftIO $ httpServe httpConf a
149
111
150−-- Get the web server configuration from the command line
151−runSnapWithCommandLineArgs :: MonadIO m => Snap () -> m ()
152−runSnapWithCommandLineArgs s = liftIO (commandLineConfig defaultConfig) >>= \c ->
153− runSnapWithConfig c s
154−
155getPageName :: (MonadSnap m) => m PageName
112getPageName :: (MonadSnap m) => m PageName
156getPageName = do
113getPageName = do
157 p <- getsRequest rqPathInfo
114 p <- getsRequest rqPathInfo
@@ -163,31 +120,26 @@ getRouteWith e = do
163 pageName <- getPageName
120 pageName <- getPageName
164 return $ tryDecode e pageName
121 return $ tryDecode e pageName
165
122
166−renderAllJsPath :: Encoder Identity Identity (R (FullRoute a b)) PageName -> Text
167−renderAllJsPath validFullEncoder =
168− renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_Resource ResourceRoute_Ghcjs) :/ ["all.js"]
169−
170serveObeliskApp
123serveObeliskApp
171− :: (MonadSnap m, HasCookies m, MonadFail m)
124+ :: (MonadSnap m, HasCookies m)
172 => (R appRoute -> Text)
125 => (R appRoute -> Text)
173− -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
174 -> ([Text] -> m ())
126 -> ([Text] -> m ())
175 -> GhcjsApp (R appRoute)
127 -> GhcjsApp (R appRoute)
176 -> Map Text ByteString
128 -> Map Text ByteString
177 -> R (ObeliskRoute appRoute)
129 -> R (ObeliskRoute appRoute)
178 -> m ()
130 -> m ()
179−serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp config = \case
131+serveObeliskApp urlEnc serveStaticAsset frontendApp config = \case
180− ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
132+ ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
181 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
133 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
182 ResourceRoute_Static :=> Identity pathSegments -> serveStaticAsset pathSegments
134 ResourceRoute_Static :=> Identity pathSegments -> serveStaticAsset pathSegments
183− ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_Resource :/ pathSegments
135+ ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp urlEnc frontendApp config $ GhcjsAppRoute_Resource :/ pathSegments
184 ResourceRoute_JSaddleWarp :=> Identity _ -> do
136 ResourceRoute_JSaddleWarp :=> Identity _ -> do
185 let msg = "Error: Obelisk.Backend received jsaddle request"
137 let msg = "Error: Obelisk.Backend received jsaddle request"
186 liftIO $ putStrLn $ T.unpack msg
138 liftIO $ putStrLn $ T.unpack msg
187 writeText msg
139 writeText msg
188 ResourceRoute_Version :=> Identity () -> doNotCache >> serveFileIfExistsAs "text/plain" "version"
140 ResourceRoute_Version :=> Identity () -> doNotCache >> serveFileIfExistsAs "text/plain" "version"
189
141
190−serveStaticAssets :: (MonadSnap m, MonadFail m) => StaticAssets -> [Text] -> m ()
142+serveStaticAssets :: MonadSnap m => StaticAssets -> [Text] -> m ()
191serveStaticAssets assets pathSegments = serveAsset (_staticAssets_processed assets) (_staticAssets_unprocessed assets) $ T.unpack $ T.intercalate "/" pathSegments
143serveStaticAssets assets pathSegments = serveAsset (_staticAssets_processed assets) (_staticAssets_unprocessed assets) $ T.unpack $ T.intercalate "/" pathSegments
192
144
193data StaticAssets = StaticAssets
145data StaticAssets = StaticAssets
@@ -205,87 +157,49 @@ staticRenderContentType = "text/html; charset=utf-8"
205
157
206--TODO: Don't assume we're being served at "/"
158--TODO: Don't assume we're being served at "/"
207serveGhcjsApp
159serveGhcjsApp
208− :: (MonadSnap m, HasCookies m, MonadFail m)
160+ :: (MonadSnap m, HasCookies m)
209 => (R appRouteComponent -> Text)
161 => (R appRouteComponent -> Text)
210− -> GhcjsWidgets (FrontendWidgetT (R appRouteComponent) ())
211 -> GhcjsApp (R appRouteComponent)
162 -> GhcjsApp (R appRouteComponent)
212 -> Map Text ByteString
163 -> Map Text ByteString
213 -> R (GhcjsAppRoute appRouteComponent)
164 -> R (GhcjsAppRoute appRouteComponent)
214 -> m ()
165 -> m ()
215−serveGhcjsApp urlEnc ghcjsWidgets app config = \case
166+serveGhcjsApp urlEnc app config = \case
216 GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
167 GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
217 modifyResponse $ setContentType staticRenderContentType
168 modifyResponse $ setContentType staticRenderContentType
218− modifyResponse $ setHeader "Cache-Control" "no-store private"
219− writeBS <=< renderGhcjsFrontend urlEnc ghcjsWidgets (appRouteComponent :/ appRouteRest) config $ _ghcjsApp_value app
169+ writeBS <=< renderGhcjsFrontend urlEnc (appRouteComponent :/ appRouteRest) config $ _ghcjsApp_value app
220 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
170 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
221
171
222−-- | Default obelisk backend configuration.
223−defaultBackendConfig :: BackendConfig frontendRoute
224−defaultBackendConfig = BackendConfig runSnapWithCommandLineArgs defaultStaticAssets defaultGhcjsWidgets
225−
226−-- | Run an obelisk backend with the default configuration.
227runBackend :: Backend backendRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
172runBackend :: Backend backendRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
228−runBackend = runBackendWith defaultBackendConfig
229−
230−-- | Run an obelisk backend with the given configuration.
231−runBackendWith
232− :: BackendConfig frontendRoute
233− -> Backend backendRoute frontendRoute
234− -> Frontend (R frontendRoute)
235− -> IO ()
236−runBackendWith (BackendConfig runSnap staticAssets ghcjsWidgets) backend frontend = case checkEncoder $ _backend_routeEncoder backend of
173+runBackend backend frontend = case checkEncoder $ _backend_routeEncoder backend of
237 Left e -> fail $ "backend error:\n" <> T.unpack e
174 Left e -> fail $ "backend error:\n" <> T.unpack e
238 Right validFullEncoder -> do
175 Right validFullEncoder -> do
239 publicConfigs <- getPublicConfigs
176 publicConfigs <- getPublicConfigs
240− _backend_run backend $ \serveRoute ->
177+ _backend_run backend $ \serveRoute -> do
241− runSnap $
178+ runSnapWithCommandLineArgs $ do
242 getRouteWith validFullEncoder >>= \case
179 getRouteWith validFullEncoder >>= \case
243 Identity r -> case r of
180 Identity r -> case r of
244 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
181 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
245 FullRoute_Frontend obeliskRoute :/ a ->
182 FullRoute_Frontend obeliskRoute :/ a ->
246− serveDefaultObeliskApp routeToUrl (($ allJsUrl) <$> ghcjsWidgets) (serveStaticAssets staticAssets) frontend publicConfigs $
183+ serveDefaultObeliskApp (mkRouteToUrl validFullEncoder) (serveStaticAssets defaultStaticAssets) frontend publicConfigs $
247 obeliskRoute :/ a
184 obeliskRoute :/ a
248− where
185+
186+mkRouteToUrl :: Encoder Identity parse (R (FullRoute br fr)) PageName -> R fr -> Text
187+mkRouteToUrl validFullEncoder =
188+ let pageNameEncoder' :: Encoder Identity (Either Text) PageName PathQuery = pageNameEncoder
249− routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
189+ in \(k :/ v) -> T.pack . uncurry (<>) . encode pageNameEncoder' . encode validFullEncoder $ (FullRoute_Frontend $ ObeliskRoute_App k) :/ v
250− allJsUrl = renderAllJsPath validFullEncoder
251
190
252renderGhcjsFrontend
191renderGhcjsFrontend
253 :: (MonadSnap m, HasCookies m)
192 :: (MonadSnap m, HasCookies m)
254 => (route -> Text)
193 => (route -> Text)
255− -> GhcjsWidgets (FrontendWidgetT route ())
256 -> route
194 -> route
257 -> Map Text ByteString
195 -> Map Text ByteString
258 -> Frontend route
196 -> Frontend route
259 -> m ByteString
197 -> m ByteString
260−renderGhcjsFrontend urlEnc ghcjsWidgets route configs f = do
198+renderGhcjsFrontend urlEnc route configs f = do
199+ let ghcjsPreload = elAttr "link" ("rel" =: "preload" <> "as" =: "script" <> "href" =: "ghcjs/all.js") blank
200+ ghcjsScript = elAttr "script" ("language" =: "javascript" <> "src" =: "ghcjs/all.js" <> "defer" =: "defer") blank
261 cookies <- askCookies
201 cookies <- askCookies
262− renderFrontendHtml configs cookies urlEnc route f (_ghcjsWidgets_preload ghcjsWidgets) (_ghcjsWidgets_script ghcjsWidgets)
202+ renderFrontendHtml configs cookies urlEnc route f ghcjsPreload ghcjsScript
263−
264−-- | Preload all.js in a link tag.
265−-- This is the default preload method.
266−preloadGhcjs :: Text -> FrontendWidgetT r ()
267−preloadGhcjs allJsUrl = elAttr "link" ("rel" =: "preload" <> "as" =: "script" <> "href" =: allJsUrl) blank
268−
269−-- | Load the script from the given URL in a deferred script tag.
270−-- This is the default method.
271−deferredGhcjsScript :: Text -> FrontendWidgetT r ()
272−deferredGhcjsScript allJsUrl = elAttr "script" ("type" =: "text/javascript" <> "src" =: allJsUrl <> "defer" =: "defer") blank
273−
274−-- | An all.js script which is loaded after waiting for some time to pass. This
275−-- is useful to ensure any CSS animations on the page can play smoothly before
276−-- blocking the UI thread by running all.js.
277−delayedGhcjsScript
278− :: Int -- ^ The number of milliseconds to delay loading by
279− -> Text -- ^ URL to GHCJS app JavaScript
280− -> FrontendWidgetT r ()
281−delayedGhcjsScript n allJsUrl = elAttr "script" ("type" =: "text/javascript") $ text $ T.unlines
282− [ "setTimeout(function() {"
283− , " var all_js_script = document.createElement('script');"
284− , " all_js_script.type = 'text/javascript';"
285− , " all_js_script.src = '" <> allJsUrl <> "';"
286− , " document.body.appendChild(all_js_script);"
287− , "}, " <> T.pack (show n) <> ");"
288− ]
289
203
290instance HasCookies Snap where
204instance HasCookies Snap where
291 askCookies = map (\c -> (cookieName c, cookieValue c)) <$> getsRequest rqCookies
205 askCookies = map (\c -> (cookieName c, cookieValue c)) <$> getsRequest rqCookies
lib/cliapp/obelisk-cliapp.cabal+3−6
@@ -7,11 +7,9 @@ cabal-version: >=1.2
7library
7library
8 hs-source-dirs: src
8 hs-source-dirs: src
9 build-depends:
9 build-depends:
10− aeson
11− , ansi-terminal
10+ ansi-terminal
12 , base
11 , base
13 , bytestring
12 , bytestring
14− , containers
15 , exceptions
13 , exceptions
16 , io-streams
14 , io-streams
17 , lens
15 , lens
@@ -19,14 +17,13 @@ library
19 , monad-loops
17 , monad-loops
20 , mtl
18 , mtl
21 , process
19 , process
22− , shell-escape
23 , terminal-size
20 , terminal-size
24 , text
21 , text
25 , time
22 , time
26 , transformers
23 , transformers
27− , utf8-string
28 exposed-modules:
24 exposed-modules:
29 Obelisk.CliApp
25 Obelisk.CliApp
26+ Obelisk.CliApp.Demo
30 other-modules:
27 other-modules:
31 Obelisk.CliApp.Logging
28 Obelisk.CliApp.Logging
32 Obelisk.CliApp.Process
29 Obelisk.CliApp.Process
@@ -34,4 +31,4 @@ library
34 Obelisk.CliApp.TerminalString
31 Obelisk.CliApp.TerminalString
35 Obelisk.CliApp.Theme
32 Obelisk.CliApp.Theme
36 Obelisk.CliApp.Types
33 Obelisk.CliApp.Types
37− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
34+ ghc-options: -Wall -fobject-code
lib/cliapp/src/Obelisk/CliApp.hs+6−18
@@ -33,28 +33,16 @@ module Obelisk.CliApp
33 , Severity (..)
33 , Severity (..)
34
34
35 -- .Process
35 -- .Process
36− , AsProcessFailure (..)
37 , ProcessFailure (..)
36 , ProcessFailure (..)
38− , ProcessSpec (..)
37+ , AsProcessFailure (..)
39− , callCommand
38+ , readProcessAndLogStderr
40− , callProcess
39+ , readProcessAndLogOutput
40+ , readCreateProcessWithExitCode
41 , callProcessAndLogOutput
41 , callProcessAndLogOutput
42− , createProcess
43 , createProcess_
42 , createProcess_
44− , exitCodeToException
43+ , callProcess
45− , overCreateProcess
44+ , callCommand
46− , proc
47− , readCreateProcessWithExitCode
48− , readProcessAndLogOutput
49− , readProcessAndLogStderr
50− , readProcessJSONAndLogStderr
51 , reconstructCommand
45 , reconstructCommand
52− , runProcess_
53− , setCwd
54− , setDelegateCtlc
55− , setEnvOverride
56− , shell
57− , waitForProcess
58 ) where
46 ) where
59
47
60import Control.Monad.Log (Severity (..))
48import Control.Monad.Log (Severity (..))
lib/cliapp/src/Obelisk/CliApp/Demo.hsnew file+52
@@ -0,0 +1,52 @@
1+{-# LANGUAGE FlexibleContexts #-}
2+{-# LANGUAGE OverloadedStrings #-}
3+{-# LANGUAGE ScopedTypeVariables #-}
4+module Obelisk.CliApp.Demo where
5+
6+import Control.Concurrent (threadDelay)
7+import Control.Monad.IO.Class
8+import Data.Semigroup ((<>))
9+import qualified Data.Text as T
10+import System.Process (proc)
11+
12+import Control.Monad.Catch (MonadMask)
13+
14+import Obelisk.CliApp
15+
16+cliDemo
17+ :: ( MonadIO m, MonadMask m
18+ , CliLog m, HasCliConfig e m, CliThrow e m, AsProcessFailure e, AsUnstructuredError e)
19+ => m ()
20+cliDemo = withSpinner "CLI Demo" $ do
21+ putLog Notice "This demo will showcase the CLI library functionality"
22+ _ <- withSpinner' "Searching long for something" (Just $ \c -> "Discovered " <> T.pack (show c) <> " objects") $ do
23+ delay
24+ withSpinner "Nested task" $ do
25+ delay
26+ putLog Notice "In nested task"
27+ -- This is a 'no trail' spinner that won't leave a trail (even its sub spinners)
28+ withSpinnerNoTrail "In between, doing something temporary" $ do
29+ withSpinner "Runnning something deep inside" $ do
30+ delay
31+ putLog Notice "You can still log from inside no-trail spinners"
32+ delay
33+ delay
34+ putLog Error "Top nested task finished"
35+ delay
36+ putLog Error "Some user error while spinning"
37+ delay
38+ putLog Notice "This is some info mesage"
39+ putLog Warning "And now a warning as well"
40+ delay
41+ return (42 :: Integer)
42+ putLog Notice "Now we start a 2nd spinner, run a couple of process, the last of which fails:"
43+ withSpinner "Looking around" $ do
44+ delay
45+ output <- readProcessAndLogStderr Notice $ proc "ls" ["-l", "/"]
46+ putLog Notice $ "Output was: " <> output
47+ delay
48+ callProcessAndLogOutput (Notice, Error) $ proc "ls" ["-l", "/does-not-exist"]
49+ delay
50+ failWith "Something dangerous happened"
51+ where
52+ delay = liftIO $ threadDelay 1000000
lib/cliapp/src/Obelisk/CliApp/Logging.hs+12−13
@@ -39,6 +39,7 @@ import Control.Monad.Log (Severity (..), WithSeverity (..), logMessage, runLoggi
39import Control.Monad.Loops (iterateUntil)
39import Control.Monad.Loops (iterateUntil)
40import Control.Monad.Reader (MonadIO, ReaderT (..))
40import Control.Monad.Reader (MonadIO, ReaderT (..))
41import Data.IORef (atomicModifyIORef', newIORef, readIORef, writeIORef)
41import Data.IORef (atomicModifyIORef', newIORef, readIORef, writeIORef)
42+import Data.Maybe
42import Data.Semigroup ((<>))
43import Data.Semigroup ((<>))
43import Data.Text (Text)
44import Data.Text (Text)
44import qualified Data.Text as T
45import qualified Data.Text as T
@@ -66,7 +67,7 @@ newCliConfig sev noColor noSpinner errorLogExitCode = do
66 tipDisplayed <- newIORef False
67 tipDisplayed <- newIORef False
67 stack <- newIORef ([], [])
68 stack <- newIORef ([], [])
68 textEncoding <- hGetEncoding stdout
69 textEncoding <- hGetEncoding stdout
69− let theme = if maybe False supportsUnicode textEncoding
70+ let theme = if fromMaybe False $ supportsUnicode <$> textEncoding
70 then unicodeTheme
71 then unicodeTheme
71 else noUnicodeTheme
72 else noUnicodeTheme
72 return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
73 return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
@@ -132,7 +133,7 @@ handleLog' noColor output = do
132 hFlush stdout
133 hFlush stdout
133 Output_Overwrite ts -> liftIO $ do
134 Output_Overwrite ts -> liftIO $ do
134 width <- TS.getTerminalWidth
135 width <- TS.getTerminalWidth
135− T.putStr $ "\r" <> TS.render (not noColor) width ts
136+ T.putStr $ "\r" <> (TS.render (not noColor) width ts)
136 hFlush stdout
137 hFlush stdout
137 Output_ClearLine -> liftIO $ do
138 Output_ClearLine -> liftIO $ do
138 -- Go to the first column and clear the whole line
139 -- Go to the first column and clear the whole line
@@ -160,7 +161,7 @@ failWith :: (CliThrow e m, AsUnstructuredError e) => Text -> m a
160failWith = throwError . review asUnstructuredError
161failWith = throwError . review asUnstructuredError
161
162
162errorToWarning
163errorToWarning
163− :: (HasCliConfig e m, CliLog m)
164+ :: (HasCliConfig e m, CliThrow e m, CliLog m)
164 => e -> m ()
165 => e -> m ()
165errorToWarning e = do
166errorToWarning e = do
166 c <- getCliConfig
167 c <- getCliConfig
@@ -177,17 +178,15 @@ withExitFailMessage msg f = f `catch` \(e :: ExitCode) -> do
177 throwM e
178 throwM e
178
179
179-- | Write log to stdout, with colors (unless `noColor`)
180-- | Write log to stdout, with colors (unless `noColor`)
180−writeLog :: (MonadIO m) => Bool -> Bool -> WithSeverity Text -> m ()
181+writeLog :: (MonadIO m, MonadMask m) => Bool -> Bool -> WithSeverity Text -> m ()
181−writeLog withNewLine noColor (WithSeverity severity s) = if T.null s then pure () else write
182+writeLog withNewLine noColor (WithSeverity severity s)
183+ | noColor && severity <= Warning = liftIO $ putFn $ T.pack (show severity) <> ": " <> s
184+ | not noColor && severity <= Error = TS.putStrWithSGR errorColors h withNewLine s
185+ | not noColor && severity <= Warning = TS.putStrWithSGR warningColors h withNewLine s
186+ | not noColor && severity >= Debug = TS.putStrWithSGR debugColors h withNewLine s
187+ | otherwise = liftIO $ putFn s
182 where
188 where
183− write
184− | noColor && severity <= Warning = liftIO $ putFn $ T.pack (show severity) <> ": " <> s
185− | not noColor && severity <= Error = TS.putStrWithSGR errorColors h withNewLine s
186− | not noColor && severity <= Warning = TS.putStrWithSGR warningColors h withNewLine s
187− | not noColor && severity >= Debug = TS.putStrWithSGR debugColors h withNewLine s
188− | otherwise = liftIO $ putFn s
189−
190− putFn = if withNewLine then T.hPutStrLn h else T.hPutStr h
189+ putFn = if withNewLine then (T.hPutStrLn h) else (T.hPutStr h)
191 h = if severity <= Error then stderr else stdout
190 h = if severity <= Error then stderr else stdout
192 errorColors = [SetColor Foreground Vivid Red]
191 errorColors = [SetColor Foreground Vivid Red]
193 warningColors = [SetColor Foreground Vivid Yellow]
192 warningColors = [SetColor Foreground Vivid Yellow]
lib/cliapp/src/Obelisk/CliApp/Process.hs+52−139
@@ -1,6 +1,7 @@
1{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
4+{-# LANGUAGE MultiWayIf #-}
4{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE ScopedTypeVariables #-}
6{-# LANGUAGE ScopedTypeVariables #-}
6{-# LANGUAGE TupleSections #-}
7{-# LANGUAGE TupleSections #-}
@@ -8,86 +9,44 @@
8-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
9-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
9-- and is thus spinner friendly.
10-- and is thus spinner friendly.
10module Obelisk.CliApp.Process
11module Obelisk.CliApp.Process
12+ ( ProcessFailure (..)
11− ( AsProcessFailure (..)
13+ , AsProcessFailure (..)
12− , ProcessFailure (..)
14+ , readProcessAndLogStderr
13− , ProcessSpec (..)
15+ , readProcessAndLogOutput
14− , callCommand
16+ , readCreateProcessWithExitCode
15− , callProcess
16 , callProcessAndLogOutput
17 , callProcessAndLogOutput
17 , createProcess
18 , createProcess
18 , createProcess_
19 , createProcess_
19− , exitCodeToException
20+ , callProcess
20− , overCreateProcess
21+ , callCommand
21− , proc
22− , readCreateProcessWithExitCode
23− , readProcessAndLogOutput
24− , readProcessAndLogStderr
25− , readProcessJSONAndLogStderr
26 , reconstructCommand
22 , reconstructCommand
27− , runProcess_
28− , setCwd
29− , setDelegateCtlc
30− , setEnvOverride
31− , shell
32− , waitForProcess
33 ) where
23 ) where
34
24
35import Control.Monad ((<=<), join, void)
25import Control.Monad ((<=<), join, void)
36−import Control.Monad.Catch (MonadMask, bracketOnError)
37import Control.Monad.Except (throwError)
26import Control.Monad.Except (throwError)
38−import Control.Monad.Fail
39import Control.Monad.IO.Class (MonadIO, liftIO)
27import Control.Monad.IO.Class (MonadIO, liftIO)
40import Control.Lens (Prism', review)
28import Control.Lens (Prism', review)
41import qualified Data.ByteString as BS
29import qualified Data.ByteString as BS
42import qualified Data.ByteString.Char8 as BSC
30import qualified Data.ByteString.Char8 as BSC
43−import qualified Data.ByteString.UTF8 as BSU
44import Data.Function (fix)
31import Data.Function (fix)
45−import Data.Map (Map)
46−import qualified Data.Map as Map
47import Data.Monoid ((<>))
32import Data.Monoid ((<>))
48import Data.Text (Text)
33import Data.Text (Text)
49import qualified Data.Text as T
34import qualified Data.Text as T
50import qualified Data.Text.Encoding as T
35import qualified Data.Text.Encoding as T
51import Data.Text.Encoding.Error (lenientDecode)
36import Data.Text.Encoding.Error (lenientDecode)
52−import System.Environment (getEnvironment)
53import System.Exit (ExitCode (..))
37import System.Exit (ExitCode (..))
54import System.IO (Handle)
38import System.IO (Handle)
55import System.IO.Streams (InputStream, handleToInputStream)
39import System.IO.Streams (InputStream, handleToInputStream)
56import qualified System.IO.Streams as Streams
40import qualified System.IO.Streams as Streams
57import System.IO.Streams.Concurrent (concurrentMerge)
41import System.IO.Streams.Concurrent (concurrentMerge)
58−import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), std_err, std_out)
42+import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), cmdspec, std_err, std_out,
43+ waitForProcess)
59import qualified System.Process as Process
44import qualified System.Process as Process
60−import Text.ShellEscape (bash, bytes)
61−import qualified Data.Aeson as Aeson
62
45
63import Control.Monad.Log (Severity (..))
46import Control.Monad.Log (Severity (..))
64import Obelisk.CliApp.Logging (putLog, putLogRaw)
47import Obelisk.CliApp.Logging (putLog, putLogRaw)
65import Obelisk.CliApp.Types (CliLog, CliThrow)
48import Obelisk.CliApp.Types (CliLog, CliThrow)
66
49
67−data ProcessSpec = ProcessSpec
68− { _processSpec_createProcess :: !CreateProcess
69− , _processSpec_overrideEnv :: !(Maybe (Map String String -> Map String String))
70− }
71−
72−proc :: FilePath -> [String] -> ProcessSpec
73−proc cmd args = ProcessSpec (Process.proc cmd args) Nothing
74−
75−shell :: String -> ProcessSpec
76−shell cmd = ProcessSpec (Process.shell cmd) Nothing
77−
78−setEnvOverride :: (Map String String -> Map String String) -> ProcessSpec -> ProcessSpec
79−setEnvOverride f p = p { _processSpec_overrideEnv = Just f }
80−
81−overCreateProcess :: (CreateProcess -> CreateProcess) -> ProcessSpec -> ProcessSpec
82−overCreateProcess f (ProcessSpec p x) = ProcessSpec (f p) x
83−
84−setDelegateCtlc :: Bool -> ProcessSpec -> ProcessSpec
85−setDelegateCtlc b = overCreateProcess (\p -> p { Process.delegate_ctlc = b })
86−
87−setCwd :: Maybe FilePath -> ProcessSpec -> ProcessSpec
88−setCwd fp = overCreateProcess (\p -> p { Process.cwd = fp })
89−
90−
91-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
50-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
92data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
51data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
93 deriving Show
52 deriving Show
@@ -101,56 +60,44 @@ instance AsProcessFailure ProcessFailure where
101 asProcessFailure = id
60 asProcessFailure = id
102
61
103readProcessAndLogStderr
62readProcessAndLogStderr
104− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
63+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
105− => Severity -> ProcessSpec -> m Text
64+ => Severity -> CreateProcess -> m Text
106readProcessAndLogStderr sev process = do
65readProcessAndLogStderr sev process = do
107 (out, _err) <- withProcess process $ \_out err -> do
66 (out, _err) <- withProcess process $ \_out err -> do
108 streamToLog =<< liftIO (streamHandle sev err)
67 streamToLog =<< liftIO (streamHandle sev err)
109 liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
68 liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
110
69
111−readProcessJSONAndLogStderr
112− :: (Aeson.FromJSON a, MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
113− => Severity -> ProcessSpec -> m a
114−readProcessJSONAndLogStderr sev process = do
115− (out, _err) <- withProcess process $ \_out err -> do
116− streamToLog =<< liftIO (streamHandle sev err)
117− json <- liftIO $ BS.hGetContents out
118− case Aeson.eitherDecodeStrict json of
119− Right a -> pure a
120− Left err -> do
121− putLog Error $ "Could not decode process output as JSON: " <> T.pack err
122− throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) 0
123−
124readCreateProcessWithExitCode
70readCreateProcessWithExitCode
125− :: (MonadIO m, CliLog m)
71+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
126− => ProcessSpec -> m (ExitCode, String, String)
72+ => CreateProcess -> m (ExitCode, String, String)
127−readCreateProcessWithExitCode procSpec = do
73+readCreateProcessWithExitCode process = do
128− process <- mkCreateProcess procSpec
129− putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
74+ putLog Debug $ "Creating process: " <> reconstructCommand (cmdspec process)
130 liftIO $ Process.readCreateProcessWithExitCode process ""
75 liftIO $ Process.readCreateProcessWithExitCode process ""
131
76
132-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
77-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
133-- with the corresponding severity.
78-- with the corresponding severity.
134--
79--
135−-- Usually this function is called as `readProcessAndLogOutput (Debug, Error)`. However
80+-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
136-- some processes are known to spit out diagnostic or informative messages in stderr, in
81-- some processes are known to spit out diagnostic or informative messages in stderr, in
137-- which case it is advisable to call it with a non-Error severity for stderr, like
82-- which case it is advisable to call it with a non-Error severity for stderr, like
138−-- `readProcessAndLogOutput (Debug, Debug)`.
83+-- `callProcessAndLogOutput (Debug, Debug)`.
139readProcessAndLogOutput
84readProcessAndLogOutput
140− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
85+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
141− => (Severity, Severity) -> ProcessSpec -> m Text
86+ => (Severity, Severity) -> CreateProcess -> m Text
142readProcessAndLogOutput (sev_out, sev_err) process = do
87readProcessAndLogOutput (sev_out, sev_err) process = do
143− (_, Just out, Just err, p) <- createProcess $ overCreateProcess
88+ (_, Just out, Just err, p) <- createProcess $ process
144− (\p -> p { std_out = CreatePipe , std_err = CreatePipe }) process
89+ { std_out = CreatePipe , std_err = CreatePipe }
145
90
146 -- TODO interleave stdout and stderr in log correctly
91 -- TODO interleave stdout and stderr in log correctly
147 streamToLog =<< liftIO (streamHandle sev_err err)
92 streamToLog =<< liftIO (streamHandle sev_err err)
148 outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
93 outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
149 putLogRaw sev_out outText
94 putLogRaw sev_out outText
150
95
151− outText <$ (exitCodeToException process =<< waitForProcess p)
96+ liftIO (waitForProcess p) >>= \case
97+ ExitSuccess -> pure outText
98+ ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (cmdspec process) code
152
99
153−-- | Like 'System.Process.callProcess' but logs the combined output (stdout and stderr)
100+-- | Like `System.Process.callProcess` but logs the combined output (stdout and stderr)
154-- with the corresponding severity.
101-- with the corresponding severity.
155--
102--
156-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
103-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
@@ -158,8 +105,9 @@ readProcessAndLogOutput (sev_out, sev_err) process = do
158-- which case it is advisable to call it with a non-Error severity for stderr, like
105-- which case it is advisable to call it with a non-Error severity for stderr, like
159-- `callProcessAndLogOutput (Debug, Debug)`.
106-- `callProcessAndLogOutput (Debug, Debug)`.
160callProcessAndLogOutput
107callProcessAndLogOutput
108+
161− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
109+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
162− => (Severity, Severity) -> ProcessSpec -> m ()
110+ => (Severity, Severity) -> CreateProcess -> m ()
163callProcessAndLogOutput (sev_out, sev_err) process =
111callProcessAndLogOutput (sev_out, sev_err) process =
164 void $ withProcess process $ \out err -> do
112 void $ withProcess process $ \out err -> do
165 stream <- liftIO $ join $ combineStream
113 stream <- liftIO $ join $ combineStream
@@ -169,30 +117,21 @@ callProcessAndLogOutput (sev_out, sev_err) process =
169 where
117 where
170 combineStream s1 s2 = concurrentMerge [s1, s2]
118 combineStream s1 s2 = concurrentMerge [s1, s2]
171
119
172−-- | Like 'System.Process.createProcess' but also logs (debug) the process being run
120+-- | Like `System.Process.createProcess` but also logs (debug) the process being run
173createProcess
121createProcess
174 :: (MonadIO m, CliLog m)
122 :: (MonadIO m, CliLog m)
175− => ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
123+ => CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
176−createProcess procSpec = do
124+createProcess p = do
177− p <- mkCreateProcess procSpec
178− putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
125+ putLog Debug $ "Creating process: " <> reconstructCommand (cmdspec p)
179 liftIO $ Process.createProcess p
126 liftIO $ Process.createProcess p
180
127
181-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
128-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
182createProcess_
129createProcess_
183 :: (MonadIO m, CliLog m)
130 :: (MonadIO m, CliLog m)
184− => String -> ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
131+ => String -> CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
185−createProcess_ name procSpec = do
132+createProcess_ name p = do
186− p <- mkCreateProcess procSpec
187− putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructProcSpec procSpec
133+ putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructCommand (cmdspec p)
188− liftIO $ Process.createProcess_ name p
134+ liftIO $ Process.createProcess p
189−
190−mkCreateProcess :: MonadIO m => ProcessSpec -> m Process.CreateProcess
191−mkCreateProcess (ProcessSpec p override') = case override' of
192− Nothing -> pure p
193− Just override -> do
194− procEnv <- Map.fromList <$> maybe (liftIO getEnvironment) pure (Process.env p)
195− pure $ p { Process.env = Just $ Map.toAscList (override procEnv) }
196
135
197-- | Like `System.Process.callProcess` but also logs (debug) the process being run
136-- | Like `System.Process.callProcess` but also logs (debug) the process being run
198callProcess
137callProcess
@@ -211,30 +150,18 @@ callCommand cmd = do
211 liftIO $ Process.callCommand cmd
150 liftIO $ Process.callCommand cmd
212
151
213withProcess
152withProcess
214− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
153+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
215− => ProcessSpec -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
154+ => CreateProcess -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
216−withProcess process f =
155+withProcess process f = do -- TODO: Use bracket.
217− bracketOnError
156+ -- FIXME: Using `withCreateProcess` here leads to something operating illegally on closed handles.
218− (createProcess $ overCreateProcess
157+ (_, Just out, Just err, p) <- createProcess $ process
219− (\x -> x { std_out = CreatePipe , std_err = CreatePipe }) process
158+ { std_out = CreatePipe , std_err = CreatePipe }
220− )
159+
221− (liftIO . Process.cleanupProcess)
160+ f out err -- Pass the handles to the passed function
222− (\case
223− (_, Just out, Just err, p) -> do
224− f out err
225− (out, err) <$ (exitCodeToException process =<< waitForProcess p)
226− _ -> error "withProcess: createProcess did not provide handles for CreatePipe as expected"
227− )
228
161
229−-- | Runs a process to completion failing if it does not exit cleanly.
162+ liftIO (waitForProcess p) >>= \case
230−runProcess_
163+ ExitSuccess -> return (out, err)
231− :: (MonadIO m, CliLog m, CliThrow e m, MonadMask m, AsProcessFailure e)
164+ ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (cmdspec process) code
232− => ProcessSpec -> m ()
233−runProcess_ process =
234− bracketOnError
235− (createProcess process)
236− (liftIO . Process.cleanupProcess)
237− (\(_, _, _, ph) -> exitCodeToException process =<< waitForProcess ph)
238
165
239-- Create an input stream from the file handle, associating each item with the given severity.
166-- Create an input stream from the file handle, associating each item with the given severity.
240streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
167streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
@@ -249,24 +176,10 @@ streamToLog stream = fix $ \loop -> do
249 Nothing -> return ()
176 Nothing -> return ()
250 Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
177 Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
251
178
252−-- | Wrapper around `System.Process.waitForProcess`
253−waitForProcess :: MonadIO m => ProcessHandle -> m ExitCode
254−waitForProcess = liftIO . Process.waitForProcess
255−
256−-- | Converts an 'ExitCode' to an exception when it's non-zero.
257−exitCodeToException :: (CliThrow e m, AsProcessFailure e) => ProcessSpec -> ExitCode -> m ()
258−exitCodeToException spec = \case
259− ExitSuccess -> pure ()
260− ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess spec) code
261−
262-- | Pretty print a 'CmdSpec'
179-- | Pretty print a 'CmdSpec'
263reconstructCommand :: Process.CmdSpec -> Text
180reconstructCommand :: Process.CmdSpec -> Text
264−reconstructCommand p = case p of
265− Process.ShellCommand str -> T.pack str
181+reconstructCommand (Process.ShellCommand str) = T.pack str
266− Process.RawCommand c as -> processToShellString c as
182+reconstructCommand (Process.RawCommand c as) = processToShellString c as
267 where
183 where
268− processToShellString cmd args = T.pack $ unwords $
184+ processToShellString cmd args = T.unwords $ map quoteAndEscape (cmd : args)
269− map (BSU.toString . bytes . bash . BSU.fromString) (cmd : args)
185+ quoteAndEscape x = "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
270−
271−reconstructProcSpec :: ProcessSpec -> Text
272−reconstructProcSpec = reconstructCommand . Process.cmdspec . _processSpec_createProcess
lib/cliapp/src/Obelisk/CliApp/Spinner.hs+1
@@ -3,6 +3,7 @@
3{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
4{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
6+{-# LANGUAGE TupleSections #-}
6-- | Provides a simple CLI spinner that interoperates cleanly with the rest of the logging output.
7-- | Provides a simple CLI spinner that interoperates cleanly with the rest of the logging output.
7module Obelisk.CliApp.Spinner
8module Obelisk.CliApp.Spinner
8 ( withSpinner
9 ( withSpinner
lib/cliapp/src/Obelisk/CliApp/Types.hs+3−7
@@ -6,14 +6,12 @@
6{-# LANGUAGE GeneralizedNewtypeDeriving #-}
6{-# LANGUAGE GeneralizedNewtypeDeriving #-}
7{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE OverloadedStrings #-}
9−{-# LANGUAGE StandaloneDeriving #-}
10{-# LANGUAGE UndecidableInstances #-}
9{-# LANGUAGE UndecidableInstances #-}
11module Obelisk.CliApp.Types where
10module Obelisk.CliApp.Types where
12
11
13import Control.Concurrent.MVar (MVar)
12import Control.Concurrent.MVar (MVar)
14import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
13import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
15−import Control.Monad.Fail (MonadFail)
16−import Control.Monad.Log (LoggingT(..), MonadLog, Severity (..), WithSeverity (..), logMessage)
14+import Control.Monad.Log (LoggingT, MonadLog, Severity (..), WithSeverity (..), logMessage)
17import Control.Monad.Reader (MonadIO, ReaderT (..), MonadReader (..), ask, mapReaderT)
15import Control.Monad.Reader (MonadIO, ReaderT (..), MonadReader (..), ask, mapReaderT)
18import Control.Monad.Writer (WriterT)
16import Control.Monad.Writer (WriterT)
19import Control.Monad.State (StateT)
17import Control.Monad.State (StateT)
@@ -47,11 +45,9 @@ type CliThrow e m = MonadError e m
47putLog :: CliLog m => Severity -> Text -> m ()
45putLog :: CliLog m => Severity -> Text -> m ()
48putLog sev = logMessage . Output_Log . WithSeverity sev
46putLog sev = logMessage . Output_Log . WithSeverity sev
49
47
50−deriving instance MonadFail m => MonadFail (LoggingT Output m)
51−
52newtype DieT e m a = DieT { unDieT :: ReaderT (e -> (Text, Int)) (LoggingT Output m) a }
48newtype DieT e m a = DieT { unDieT :: ReaderT (e -> (Text, Int)) (LoggingT Output m) a }
53 deriving
49 deriving
54− ( Functor, Applicative, Monad, MonadIO, MonadFail
50+ ( Functor, Applicative, Monad, MonadIO
55 , MonadThrow, MonadCatch, MonadMask
51 , MonadThrow, MonadCatch, MonadMask
56 , MonadLog Output
52 , MonadLog Output
57 )
53 )
@@ -118,7 +114,7 @@ newtype CliT e m a = CliT
118 { unCliT :: ReaderT (CliConfig e) (DieT e m) a
114 { unCliT :: ReaderT (CliConfig e) (DieT e m) a
119 }
115 }
120 deriving
116 deriving
121− ( Functor, Applicative, Monad, MonadIO, MonadFail
117+ ( Functor, Applicative, Monad, MonadIO
122 , MonadThrow, MonadCatch, MonadMask
118 , MonadThrow, MonadCatch, MonadMask
123 , MonadLog Output -- CliLog
119 , MonadLog Output -- CliLog
124 , MonadError e -- CliThrow
120 , MonadError e -- CliThrow
lib/command/obelisk-command.cabal+14−17
@@ -1,5 +1,5 @@
1name: obelisk-command
1name: obelisk-command
2−version: 0.9.0.1
2+version: 0.1
3cabal-version: >= 1.8
3cabal-version: >= 1.8
4build-type: Simple
4build-type: Simple
5
5
@@ -7,48 +7,45 @@ library
7 hs-source-dirs: src
7 hs-source-dirs: src
8 build-depends:
8 build-depends:
9 aeson
9 aeson
10− , aeson-pretty
11 , ansi-terminal
10 , ansi-terminal
11+ , Cabal
12+ , aeson-pretty
12 , base
13 , base
14+ , base16-bytestring
15+ , binary
13 , bytestring
16 , bytestring
14− , Cabal
17+ , obelisk-cliapp
15 , containers
18 , containers
16 , data-default
19 , data-default
17 , directory
20 , directory
18 , either
21 , either
19 , errors
22 , errors
20− , exceptions
21− , extra
22 , filepath
23 , filepath
23− , git
24 , github
24 , github
25 , here
25 , here
26+ , hit
26 , hnix
27 , hnix
27 , hpack
28 , hpack
28 , io-streams
29 , io-streams
29− , lens
30+ , exceptions
30 , logging-effect
31 , logging-effect
31− , megaparsec
32+ , lens
32 , modern-uri
33 , modern-uri
33 , monad-loops
34 , monad-loops
34− , monoidal-containers
35 , mtl
35 , mtl
36+ , megaparsec
36 , network
37 , network
37 , network-uri
38 , network-uri
38− , obelisk-cliapp
39 , optparse-applicative
39 , optparse-applicative
40 , placeholders
40 , placeholders
41 , process
41 , process
42− , shell-escape
43 , temporary
42 , temporary
44 , terminal-size
43 , terminal-size
45 , text
44 , text
46 , time
45 , time
47 , transformers
46 , transformers
48− , unix-compat
47+ , unix
49 , unordered-containers
48 , unordered-containers
50− , utf8-string
51− , which
52 , yaml
49 , yaml
53 exposed-modules:
50 exposed-modules:
54 Obelisk.App
51 Obelisk.App
@@ -60,10 +57,10 @@ library
60 Obelisk.Command.Thunk
57 Obelisk.Command.Thunk
61 Obelisk.Command.Utils
58 Obelisk.Command.Utils
62 Obelisk.Command.VmBuilder
59 Obelisk.Command.VmBuilder
63− Obelisk.Command.Preprocessor
60+ -- -fobject-code is so that the StaticPointers extension can work in ghci
64− ghc-options: -Wall
61+ ghc-options: -Wall -fobject-code
65
62
66executable ob
63executable ob
67 main-is: src-bin/ob.hs
64 main-is: src-bin/ob.hs
68 build-depends: base, obelisk-command
65 build-depends: base, obelisk-command
69− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -threaded
66+ ghc-options: -Wall -O2 -threaded
lib/command/src/Obelisk/App.hs+2−5
@@ -12,7 +12,6 @@ module Obelisk.App where
12
12
13import Control.Lens
13import Control.Lens
14import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
14import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
15−import Control.Monad.Fail (MonadFail)
16import Control.Monad.Reader (MonadIO, ReaderT (..), ask, runReaderT)
15import Control.Monad.Reader (MonadIO, ReaderT (..), ask, runReaderT)
17import Control.Monad.Writer (WriterT)
16import Control.Monad.Writer (WriterT)
18import Control.Monad.State (StateT)
17import Control.Monad.State (StateT)
@@ -62,11 +61,10 @@ newtype ObeliskT m a = ObeliskT
62 { unObeliskT :: ReaderT Obelisk (CliT ObeliskError m) a
61 { unObeliskT :: ReaderT Obelisk (CliT ObeliskError m) a
63 }
62 }
64 deriving
63 deriving
65− ( Functor, Applicative, Monad, MonadIO, MonadThrow, MonadCatch, MonadMask, MonadFail
64+ ( Functor, Applicative, Monad, MonadIO, MonadThrow, MonadCatch, MonadMask
66 , MonadLog Output -- CliLog
65 , MonadLog Output -- CliLog
67 , MonadError ObeliskError -- CliThrow ObeliskError
66 , MonadError ObeliskError -- CliThrow ObeliskError
68− , HasCliConfig ObeliskError
67+ , HasCliConfig ObeliskError)
69− )
70
68
71instance MonadTrans ObeliskT where
69instance MonadTrans ObeliskT where
72 lift = ObeliskT . lift . lift
70 lift = ObeliskT . lift . lift
@@ -106,7 +104,6 @@ type MonadInfallibleObelisk m =
106type MonadObelisk m =
104type MonadObelisk m =
107 ( MonadInfallibleObelisk m
105 ( MonadInfallibleObelisk m
108 , CliThrow ObeliskError m
106 , CliThrow ObeliskError m
109− , MonadFail m
110 )
107 )
111
108
112getObeliskUserStateDir :: IO FilePath
109getObeliskUserStateDir :: IO FilePath
lib/command/src/Obelisk/Command.hs+155−192
@@ -3,18 +3,22 @@
3{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
4{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE TupleSections #-}
6+{-# LANGUAGE StaticPointers #-}
7+{-# LANGUAGE TypeApplications #-}
7module Obelisk.Command where
8module Obelisk.Command where
8
9
9−import Control.Monad.IO.Class (MonadIO, liftIO)
10+import Control.Monad
11+import Control.Monad.IO.Class (liftIO)
12+import qualified Data.Binary as Binary
10import Data.Bool (bool)
13import Data.Bool (bool)
11−import Data.Foldable (for_)
14+import qualified Data.ByteString.Base16 as Base16
12−import Data.List (isInfixOf, isPrefixOf)
15+import qualified Data.ByteString.Lazy as LBS
13−import Data.List.NonEmpty (NonEmpty, nonEmpty)
14−import qualified Data.List.NonEmpty as NonEmpty
16+import Data.List
15−import qualified Data.Map as Map
17+import Data.Maybe (catMaybes)
16import qualified Data.Text as T
18import qualified Data.Text as T
17−import Data.Traversable (for)
19+import Data.Text.Encoding
20+import Data.Text.Encoding.Error (lenientDecode)
21+import GHC.StaticPtr
18import Options.Applicative
22import Options.Applicative
19import Options.Applicative.Help.Pretty (text, (<$$>))
23import Options.Applicative.Help.Pretty (text, (<$$>))
20import System.Directory
24import System.Directory
@@ -22,16 +26,17 @@ import System.Environment
22import System.FilePath
26import System.FilePath
23import qualified System.Info
27import qualified System.Info
24import System.IO (hIsTerminalDevice, stdout)
28import System.IO (hIsTerminalDevice, stdout)
25−import System.Process (rawSystem)
29+import System.Posix.Process (executeFile)
26
30
27import Obelisk.App
31import Obelisk.App
28import Obelisk.CliApp
32import Obelisk.CliApp
33+import Obelisk.CliApp.Demo (cliDemo)
29import Obelisk.Command.Deploy
34import Obelisk.Command.Deploy
30import Obelisk.Command.Project
35import Obelisk.Command.Project
31import Obelisk.Command.Run
36import Obelisk.Command.Run
32import Obelisk.Command.Thunk
37import Obelisk.Command.Thunk
38+import Obelisk.Command.Utils
33import qualified Obelisk.Command.VmBuilder as VmBuilder
39import qualified Obelisk.Command.VmBuilder as VmBuilder
34−import qualified Obelisk.Command.Preprocessor as Preprocessor
35
40
36
41
37data Args = Args
42data Args = Args
@@ -74,8 +79,8 @@ argsInfo cfg = info (args cfg <**> helper) $ mconcat
74initSource :: Parser InitSource
79initSource :: Parser InitSource
75initSource = foldl1 (<|>)
80initSource = foldl1 (<|>)
76 [ pure InitSource_Default
81 [ pure InitSource_Default
77− , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH" <> help "Initialize the project using the given BRANCH of Obelisk's official repository")
82+ , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH")
78− , InitSource_Symlink <$> strOption (long "symlink" <> action "directory" <> metavar "PATH" <> help "(Use with caution) Initialize the project using the copy of Obelisk found at the given PATH")
83+ , InitSource_Symlink <$> strOption (long "symlink" <> action "directory" <> metavar "PATH")
79 ]
84 ]
80
85
81initForce :: Parser Bool
86initForce :: Parser Bool
@@ -84,53 +89,59 @@ initForce = switch (long "force" <> help "Allow ob init to overwrite files")
84data ObCommand
89data ObCommand
85 = ObCommand_Init InitSource Bool
90 = ObCommand_Init InitSource Bool
86 | ObCommand_Deploy DeployCommand
91 | ObCommand_Deploy DeployCommand
87− | ObCommand_Run [(FilePath, Interpret)]
92+ | ObCommand_Run
88− | ObCommand_Profile String [String]
89− | ObCommand_Thunk ThunkOption
93+ | ObCommand_Thunk ThunkCommand
90− | ObCommand_Repl [(FilePath, Interpret)]
94+ | ObCommand_Repl
91− | ObCommand_Watch [(FilePath, Interpret)]
95+ | ObCommand_Watch
92 | ObCommand_Shell ShellOpts
96 | ObCommand_Shell ShellOpts
93 | ObCommand_Doc String [String] -- shell and list of packages
97 | ObCommand_Doc String [String] -- shell and list of packages
94− | ObCommand_Hoogle String Int -- shell and port
95 | ObCommand_Internal ObInternal
98 | ObCommand_Internal ObInternal
96 deriving Show
99 deriving Show
97
100
98data ObInternal
101data ObInternal
99− -- the preprocessor argument syntax is also handled outside
102+ = ObInternal_RunStaticIO StaticKey
100− -- optparse-applicative, but it shouldn't ever conflict with another syntax
103+ | ObInternal_CLIDemo
101− = ObInternal_ApplyPackages String String String [String]
102− | ObInternal_ExportGhciConfig
103− [(FilePath, Interpret)]
104− Bool -- ^ Use relative paths
105 deriving Show
104 deriving Show
106
105
106+inNixShell' :: MonadObelisk m => StaticPtr (ObeliskT IO ()) -> m ()
107+inNixShell' p = withProjectRoot "." $ \root -> do
108+ cmd <- liftIO $ unwords <$> mkCmd -- TODO: shell escape instead of unwords
109+ projectShell root False "ghc" (Just cmd)
110+ where
111+ mkCmd = do
112+ argsCfg <- getArgsConfig
113+ myArgs <- getArgs
114+ obArgs <- parseCLIArgs argsCfg myArgs
115+ progName <- getObeliskExe
116+ return $ progName : catMaybes
117+ [ Just "--no-handoff"
118+ , bool Nothing (Just "--verbose") $ _args_verbose obArgs
119+ , Just "internal"
120+ , Just "run-static-io"
121+ , Just $ encodeStaticKey $ staticKey p
122+ ]
123+
107obCommand :: ArgsConfig -> Parser ObCommand
124obCommand :: ArgsConfig -> Parser ObCommand
108obCommand cfg = hsubparser
125obCommand cfg = hsubparser
109− (mconcat
126+ (mconcat
110− [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
127+ [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
111− , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
128+ , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
112− , command "run" $ info (ObCommand_Run <$> interpretOpts) $ progDesc "Run current project in development mode"
129+ , command "run" $ info (pure ObCommand_Run) $ progDesc "Run current project in development mode"
113− , command "profile" $ info (uncurry ObCommand_Profile <$> profileCommand) $ progDesc "Run current project with profiling enabled"
114− , command "thunk" $ info (ObCommand_Thunk <$> thunkOption) $ progDesc "Manipulate thunk directories"
130+ , command "thunk" $ info (ObCommand_Thunk <$> thunkCommand) $ progDesc "Manipulate thunk directories"
115− , command "repl" $ info (ObCommand_Repl <$> interpretOpts) $ progDesc "Open an interactive interpreter"
131+ , command "repl" $ info (pure ObCommand_Repl) $ progDesc "Open an interactive interpreter"
116− , command "watch" $ info (ObCommand_Watch <$> interpretOpts) $ progDesc "Watch current project for errors and warnings"
132+ , command "watch" $ info (pure ObCommand_Watch) $ progDesc "Watch current project for errors and warnings"
117− , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies or run a command in such a shell. E.g. ob shell -- ghc-pkg list"
133+ , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies"
118− , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
134+ , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
119− progDesc "List paths to haddock documentation for specified packages"
135+ progDesc "List paths to haddock documentation for specified packages"
120− <> footerDoc (Just $
136+ <> footerDoc (Just $
121− text "Hint: To open the documentation you can pipe the output of this command like"
137+ text "Hint: To open the documentation you can pipe the output of this command like"
122− <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
138+ <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
123− , command "hoogle" $ info (ObCommand_Hoogle <$> shellFlags <*> portOpt 8080) $ progDesc "Run a hoogle server locally for your project's dependency tree"
139+ ])
140+ <|> subparser
141+ (mconcat
142+ [ internal
124− , command "internal" $ info (ObCommand_Internal <$> internalCommand) $ progDesc "Internal Obelisk commands with unstable APIs"
143+ , command "internal" (info (ObCommand_Internal <$> internalCommand) mempty)
125− ])
126−
127−internalCommand :: Parser ObInternal
128−internalCommand = hsubparser $ mconcat
129− [ command "export-ghci-configuration" $ info (ObInternal_ExportGhciConfig <$> interpretOpts <*> useRelativePathsFlag)
130− $ progDesc "Export the GHCi configuration used by ob run, etc.; useful for IDE integration"
131− ]
144+ ])
132− where
133− useRelativePathsFlag = switch (long "use-relative-paths" <> help "Use relative paths")
134
145
135packageNames :: Parser [String]
146packageNames :: Parser [String]
136packageNames = some (strArgument (metavar "PACKAGE-NAME..."))
147packageNames = some (strArgument (metavar "PACKAGE-NAME..."))
@@ -145,7 +156,7 @@ deployCommand cfg = hsubparser $ mconcat
145 where
156 where
146 platformP = hsubparser $ mconcat
157 platformP = hsubparser $ mconcat
147 [ command "android" $ info (pure (Android, [])) mempty
158 [ command "android" $ info (pure (Android, [])) mempty
148− , command "ios" $ info ((,) <$> pure IOS <*> fmap pure (strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
159+ , command "ios" $ info ((,) <$> pure IOS <*> (fmap pure $ strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
149 ]
160 ]
150
161
151 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
162 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
@@ -167,8 +178,8 @@ deployCommand cfg = hsubparser $ mconcat
167
178
168deployInitOpts :: Parser DeployInitOpts
179deployInitOpts :: Parser DeployInitOpts
169deployInitOpts = DeployInitOpts
180deployInitOpts = DeployInitOpts
170− <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory where the deployment repository will be initialized")
181+ <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory that it will create")
171− <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an SSH key that will be *copied* to the deployment repository")
182+ <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an ssh key that it will symlink to")
172 <*> some (strOption (long "hostname" <> metavar "HOSTNAME" <> help "hostname of the deployment target"))
183 <*> some (strOption (long "hostname" <> metavar "HOSTNAME" <> help "hostname of the deployment target"))
173 <*> strOption (long "route" <> metavar "PUBLICROUTE" <> help "Publicly accessible URL of your app")
184 <*> strOption (long "route" <> metavar "PUBLICROUTE" <> help "Publicly accessible URL of your app")
174 <*> strOption (long "admin-email" <> metavar "ADMINEMAIL" <> help "Email address where administrative alerts will be sent")
185 <*> strOption (long "admin-email" <> metavar "ADMINEMAIL" <> help "Email address where administrative alerts will be sent")
@@ -185,72 +196,49 @@ data DeployCommand
185 | DeployCommand_Update
196 | DeployCommand_Update
186 deriving Show
197 deriving Show
187
198
188−profileCommand :: Parser (String, [String])
199+data DeployInitOpts = DeployInitOpts
189−profileCommand = (,)
200+ { _deployInitOpts_outputDir :: FilePath
190− <$> strOption
201+ , _deployInitOpts_sshKey :: FilePath
191− ( long "output"
202+ , _deployInitOpts_hostname :: [String]
192− <> short 'o'
203+ , _deployInitOpts_route :: String
193− <> help "Base output to use for profiling output. Suffixes are added to this based on the profiling type. Defaults to a timestamped path in the profile/ directory in the project's root."
204+ , _deployInitOpts_adminEmail :: String
194− <> metavar "PATH"
205+ , _deployInitOpts_enableHttps :: Bool
195− <> value "profile/%Y-%m-%dT%H:%M:%S"
206+ }
196− <> showDefault
197− )
198− <*> (words <$> strOption
199− ( long "rts-flags"
200− <> help "RTS Flags to pass to the executable."
201− <> value "-p -hc"
202− <> metavar "FLAGS"
203− <> showDefault
204− ))
205−
206−thunkConfig :: Parser ThunkConfig
207−thunkConfig = ThunkConfig
208− <$>
209− ( flag' (Just True) (long "private" <> help "Mark thunks as pointing to a private repository")
210− <|> flag' (Just False) (long "public" <> help "Mark thunks as pointing to a public repository")
211− <|> pure Nothing
212− )
213−
214−thunkUpdateConfig :: Parser ThunkUpdateConfig
215−thunkUpdateConfig = ThunkUpdateConfig
216− <$> optional (strOption (long "branch" <> metavar "BRANCH" <> help "Use the given branch when looking for the latest revision"))
217− <*> thunkConfig
218−
219−thunkPackConfig :: Parser ThunkPackConfig
220−thunkPackConfig = ThunkPackConfig
221− <$> switch (long "force" <> short 'f' <> help "Force packing thunks even if there are branches not pushed upstream, uncommitted changes, stashes. This will cause changes that have not been pushed upstream to be lost; use with care.")
222− <*> thunkConfig
223−
224−data ThunkOption = ThunkOption
225− { _thunkOption_thunks :: NonEmpty FilePath
226− , _thunkOption_command :: ThunkCommand
227− } deriving Show
207+ deriving Show
208+
209+internalCommand :: Parser ObInternal
210+internalCommand = subparser $ mconcat
211+ [ command "run-static-io" $ info (ObInternal_RunStaticIO <$> argument (eitherReader decodeStaticKey) (action "static-key")) mempty
212+ , command "clidemo" $ info (pure ObInternal_CLIDemo) mempty
213+ ]
214+
215+--TODO: Result should provide normalised path and also original user input for error reporting.
216+thunkDirectoryParser :: Parser FilePath
217+thunkDirectoryParser = fmap (dropTrailingPathSeparator . normalise) . strArgument $ mconcat
218+ [ action "directory"
219+ , metavar "THUNKDIR"
220+ , help "Path to directory containing thunk data"
221+ ]
228
222
229data ThunkCommand
223data ThunkCommand
230− = ThunkCommand_Update ThunkUpdateConfig
224+ = ThunkCommand_Update [FilePath] (Maybe String)
231− | ThunkCommand_Unpack
225+ | ThunkCommand_Unpack [FilePath]
232− | ThunkCommand_Pack ThunkPackConfig
226+ | ThunkCommand_Pack [FilePath] Bool
233 deriving Show
227 deriving Show
234
228
235−thunkOption :: Parser ThunkOption
229+forceFlag :: Parser Bool
230+forceFlag = switch $ long "force" <> short 'f' <> help "Force packing thunks even if there are branches not pushed upstream, uncommitted changes, stashes. This will cause changes that have not been pushed upstream to be lost; use with care."
231+
232+thunkCommand :: Parser ThunkCommand
236−thunkOption = hsubparser $ mconcat
233+thunkCommand = hsubparser $ mconcat
237− [ command "update" $ info (thunkOptionWith $ ThunkCommand_Update <$> thunkUpdateConfig) $ progDesc "Update packed thunk to latest revision available on the tracked branch"
234+ [ command "update" $ info (ThunkCommand_Update <$> some thunkDirectoryParser <*> optional (strOption (long "branch" <> metavar "BRANCH"))) $ progDesc "Update thunk to latest revision available"
238− , command "unpack" $ info (thunkOptionWith $ pure ThunkCommand_Unpack) $ progDesc "Unpack thunk into git checkout of revision it points to"
235+ , command "unpack" $ info (ThunkCommand_Unpack <$> some thunkDirectoryParser) $ progDesc "Unpack thunk into git checkout of revision it points to"
239− , command "pack" $ info (thunkOptionWith $ ThunkCommand_Pack <$> thunkPackConfig) $ progDesc "Pack git checkout or unpacked thunk into thunk that points at the current branch's upstream"
236+ , command "pack" $ info (ThunkCommand_Pack <$> some thunkDirectoryParser <*> forceFlag) $ progDesc "Pack git checkout into thunk that points at the current branch's upstream"
240 ]
237 ]
241− where
242− thunkOptionWith f = ThunkOption
243− <$> ((NonEmpty.:|)
244− <$> thunkDirArg (metavar "THUNKDIRS..." <> help "Paths to directories containing thunk data")
245− <*> many (thunkDirArg mempty)
246− )
247− <*> f
248− thunkDirArg opts = fmap (dropTrailingPathSeparator . normalise) $ strArgument $ action "directory" <> opts
249
238
250data ShellOpts
239data ShellOpts
251 = ShellOpts
240 = ShellOpts
252 { _shellOpts_shell :: String
241 { _shellOpts_shell :: String
253− , _shellOpts_interpretPaths :: [(FilePath, Interpret)]
254 , _shellOpts_command :: Maybe String
242 , _shellOpts_command :: Maybe String
255 }
243 }
256 deriving Show
244 deriving Show
@@ -261,50 +249,25 @@ shellFlags =
261 <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
249 <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
262 <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
250 <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
263
251
264−interpretOpts :: Parser [(FilePath, Interpret)]
265−interpretOpts = many
266− ( (, Interpret_Interpret) <$>
267− strOption (common <> long "interpret" <> help
268− "Don't pre-build packages found in DIR when constructing the package database. The default behavior is \
269− \'--interpret <project-root>', which will load everything which is unpacked into GHCi. \
270− \ Use --interpret and --no-interpret multiple times to add or remove multiple trees \
271− \ from the environment. Settings for right-most directories will \
272− \ override settings for any identical directories given earlier."
273− )
274− <|> (, Interpret_NoInterpret) <$>
275− strOption (common <> long "no-interpret" <> help
276− "Make packages found in DIR available in the package database (but only when they are used dependencies). \
277− \ This will build the packages in DIR before loading GHCi. \
278− \See help for --interpret for how the two options are related."
279− )
280− )
281− where
282− common = action "directory" <> metavar "DIR"
283−
284shellOpts :: Parser ShellOpts
252shellOpts :: Parser ShellOpts
285shellOpts = ShellOpts
253shellOpts = ShellOpts
286 <$> shellFlags
254 <$> shellFlags
287− <*> interpretOpts
288− -- This funny construction is used to support optparse-applicative's @--@ parsing.
289− -- All arguments after @--@ are left unparsed and instead provided to the last positional parser
290− -- which must therefore be 'many' in order to consume the rest of the input.
291− <*> ((\xs -> if null xs then Nothing else Just $ unwords xs) <$> many (strArgument (metavar "COMMAND")))
255+ <*> optional (strArgument (metavar "COMMAND"))
292−
293−portOpt :: Int -> Parser Int
294−portOpt dfault = option auto (long "port" <> short 'p' <> help "Port number for server" <> showDefault <> value dfault <> metavar "INT")
295
256
296parserPrefs :: ParserPrefs
257parserPrefs :: ParserPrefs
297parserPrefs = defaultPrefs
258parserPrefs = defaultPrefs
298 { prefShowHelpOnEmpty = True
259 { prefShowHelpOnEmpty = True
299 }
260 }
300
261
262+parseCLIArgs :: ArgsConfig -> [String] -> IO Args
263+parseCLIArgs cfg as = pure as >>= handleParseResult . execParserPure parserPrefs (argsInfo cfg)
264+
301-- | Create an Obelisk config for the current process.
265-- | Create an Obelisk config for the current process.
302mkObeliskConfig :: IO Obelisk
266mkObeliskConfig :: IO Obelisk
303mkObeliskConfig = do
267mkObeliskConfig = do
304 cliArgs <- getArgs
268 cliArgs <- getArgs
305 -- This function should not use argument parser (full argument parsing happens post handoff)
269 -- This function should not use argument parser (full argument parsing happens post handoff)
306− -- TODO: See if we can use the argument parser with a subset of the parsers to get logging level out.
307− let logLevel = toLogLevel $ any (`elem` ["-v", "--verbose"]) cliArgs
270+ let logLevel = toLogLevel $ "-v" `elem` cliArgs
308 notInteractive <- not <$> isInteractiveTerm
271 notInteractive <- not <$> isInteractiveTerm
309 cliConf <- newCliConfig logLevel notInteractive notInteractive $ \case
272 cliConf <- newCliConfig logLevel notInteractive notInteractive $ \case
310 ObeliskError_ProcessError (ProcessFailure p code) ann ->
273 ObeliskError_ProcessError (ProcessFailure p code) ann ->
@@ -366,13 +329,9 @@ main' argsCfg = do
366 Just impl -> do
329 Just impl -> do
367 -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
330 -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
368 putLog Debug $ "Handing off to " <> T.pack impl
331 putLog Debug $ "Handing off to " <> T.pack impl
369− _ <- liftIO $ rawSystem impl ("--no-handoff" : myArgs)
332+ liftIO $ executeFile impl False ("--no-handoff" : myArgs) Nothing
370− return ()
371 case myArgs of
333 case myArgs of
372 "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
334 "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
373− origPath:inPath:outPath:preprocessorName:packagePaths
374− | preprocessorName == preprocessorIdentifier && any (\c -> c == '.' || c == pathSeparator) origPath ->
375− ob $ ObCommand_Internal $ ObInternal_ApplyPackages origPath inPath outPath packagePaths
376 a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
335 a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
377 | "--bash-completion" `isPrefixOf` a
336 | "--bash-completion" `isPrefixOf` a
378 && "--no-handoff" `elem` as -> go (a:as)
337 && "--no-handoff" `elem` as -> go (a:as)
@@ -383,7 +342,29 @@ ob :: MonadObelisk m => ObCommand -> m ()
383ob = \case
342ob = \case
384 ObCommand_Init source force -> initProject source force
343 ObCommand_Init source force -> initProject source force
385 ObCommand_Deploy dc -> case dc of
344 ObCommand_Deploy dc -> case dc of
386− DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> deployInit deployOpts root
345+ DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> do
346+ let deployDir = _deployInitOpts_outputDir deployOpts
347+ r <- liftIO $ canonicalizePath root
348+ rootEqualsTarget <- liftIO $ equalFilePath r <$> canonicalizePath deployDir
349+ when rootEqualsTarget $
350+ failWith $ "Deploy directory " <> T.pack deployDir <> " should not be the same as project root."
351+ thunkPtr <- readThunk root >>= \case
352+ Left err -> failWith $ case err of
353+ ReadThunkError_AmbiguousFiles ->
354+ "Project root " <> T.pack r <> " is not a git repository or valid thunk"
355+ ReadThunkError_UnrecognizedFiles ->
356+ "Project root " <> T.pack r <> " is not a git repository or valid thunk"
357+ _ -> "thunk read: " <> T.pack (show err)
358+ Right (ThunkData_Packed ptr) -> return ptr
359+ Right (ThunkData_Checkout (Just ptr)) -> return ptr
360+ Right (ThunkData_Checkout Nothing) ->
361+ getThunkPtr False root
362+ let sshKeyPath = _deployInitOpts_sshKey deployOpts
363+ hostname = _deployInitOpts_hostname deployOpts
364+ route = _deployInitOpts_route deployOpts
365+ adminEmail = _deployInitOpts_adminEmail deployOpts
366+ enableHttps = _deployInitOpts_enableHttps deployOpts
367+ deployInit thunkPtr deployDir sshKeyPath hostname route adminEmail enableHttps
387 DeployCommand_Push remoteBuilder -> do
368 DeployCommand_Push remoteBuilder -> do
388 deployPath <- liftIO $ canonicalizePath "."
369 deployPath <- liftIO $ canonicalizePath "."
389 deployPush deployPath $ case remoteBuilder of
370 deployPush deployPath $ case remoteBuilder of
@@ -391,36 +372,25 @@ ob = \case
391 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
372 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
392 DeployCommand_Update -> deployUpdate "."
373 DeployCommand_Update -> deployUpdate "."
393 DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
374 DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
394− ObCommand_Run interpretPathsList -> withInterpretPaths interpretPathsList run
375+ ObCommand_Run -> inNixShell' $ static run
395− ObCommand_Profile basePath rtsFlags -> profile basePath rtsFlags
376+ -- inNixShell ($(mkClosure 'ghcidAction) ())
396− ObCommand_Thunk to -> case _thunkOption_command to of
377+ ObCommand_Thunk tc -> case tc of
397− ThunkCommand_Update config -> for_ thunks (updateThunkToLatest config)
378+ ThunkCommand_Update thunks mBranch -> mapM_ ((flip updateThunkToLatest) mBranch) thunks
398− ThunkCommand_Unpack -> for_ thunks unpackThunk
379+ ThunkCommand_Unpack thunks -> mapM_ unpackThunk thunks
399− ThunkCommand_Pack config -> for_ thunks (packThunk config)
380+ ThunkCommand_Pack thunks force -> forM_ thunks (packThunk force)
400− where
401− thunks = _thunkOption_thunks to
402− ObCommand_Repl interpretPathsList -> withInterpretPaths interpretPathsList runRepl
381+ ObCommand_Repl -> runRepl
403− ObCommand_Watch interpretPathsList -> withInterpretPaths interpretPathsList runWatch
382+ ObCommand_Watch -> inNixShell' $ static runWatch
404− ObCommand_Shell (ShellOpts shellAttr interpretPathsList cmd) -> withInterpretPaths interpretPathsList $ \root interpretPaths ->
383+ ObCommand_Shell so -> withProjectRoot "." $ \root ->
405− nixShellForInterpretPaths False shellAttr root interpretPaths cmd -- N.B. We do NOT bash escape here; we want to run the command as-is
384+ projectShell root False (_shellOpts_shell so) (_shellOpts_command so)
406− ObCommand_Doc shellAttr pkgs -> withInterpretPaths [] $ \root interpretPaths ->
385+ ObCommand_Doc shell pkgs -> withProjectRoot "." $ \root ->
407− nixShellForInterpretPaths True shellAttr root interpretPaths $ Just $ haddockCommand pkgs
386+ projectShell root False shell (Just $ haddockCommand pkgs)
408− ObCommand_Hoogle shell' port -> withProjectRoot "." $ \root -> do
409− nixShellWithHoogle root True shell' $ Just $ "hoogle server -p" <> show port <> " --local"
410 ObCommand_Internal icmd -> case icmd of
387 ObCommand_Internal icmd -> case icmd of
411− ObInternal_ApplyPackages origPath inPath outPath packagePaths -> do
388+ ObInternal_RunStaticIO k -> liftIO (unsafeLookupStaticPtr @(ObeliskT IO ()) k) >>= \case
412− liftIO $ Preprocessor.applyPackages origPath inPath outPath packagePaths
389+ Nothing -> failWith $ "ObInternal_RunStaticIO: no such StaticKey: " <> T.pack (show k)
413− ObInternal_ExportGhciConfig interpretPathsList useRelativePaths ->
390+ Just p -> do
414− liftIO . putStrLn . unlines =<< withInterpretPaths interpretPathsList (exportGhciConfig useRelativePaths)
391+ c <- getObelisk
415−
392+ liftIO $ runObelisk c $ deRefStaticPtr p
416−-- | A helper for the common case that the command you want to run needs the project root and a resolved
393+ ObInternal_CLIDemo -> cliDemo
417−-- set of interpret paths.
418−withInterpretPaths :: MonadObelisk m => [(FilePath, Interpret)] -> (FilePath -> PathTree Interpret -> m a) -> m a
419−withInterpretPaths interpretPathsList f = withProjectRoot "." $ \root -> do
420− interpretPaths' <- resolveInterpretPaths $ (root, Interpret_Interpret) : interpretPathsList
421− case interpretPaths' of
422− Nothing -> failWith "No paths provided for finding packages"
423− Just interpretPaths -> f root interpretPaths
424
394
425haddockCommand :: [String] -> String
395haddockCommand :: [String] -> String
426haddockCommand pkgs = unwords
396haddockCommand pkgs = unwords
@@ -435,21 +405,14 @@ haddockCommand pkgs = unwords
435getArgsConfig :: IO ArgsConfig
405getArgsConfig :: IO ArgsConfig
436getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
406getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
437
407
438−-- | Resolves an ordered list of paths for use with @--interpret@/@--no-interpret@ by coalescing
408+encodeStaticKey :: StaticKey -> String
439−-- paths into a non-ambiguous set of paths. Ambiguity is resolved by choosing right-most paths
409+encodeStaticKey = T.unpack . decodeUtf8With lenientDecode . Base16.encode . LBS.toStrict . Binary.encode
440−-- over any preceeding identical paths.
410+
441−--
411+-- TODO: Use failWith in place of fail to be consistent.
442−-- For example: @a/b=ON a/b/c=OFF@ and @a/b/c=OFF a/b=ON@ are the same.
412+decodeStaticKey :: String -> Either String StaticKey
443−-- @a/b=ON a/b=OFF@ is reduced to @a/b=OFF@. We prefer right-biased choice to increase
413+decodeStaticKey s = case Base16.decode $ encodeUtf8 $ T.pack s of
444−-- scriptability.
414+ (b, "") -> case Binary.decodeOrFail $ LBS.fromStrict b of
445−--
415+ Right ("", _, a) -> pure a
446−-- N.B. All the paths in the result will be canonicalized. It's impossible to determine path
416+ Right _ -> fail "decodeStaticKey: Binary.decodeOrFail didn't consume all input"
447−-- overlap otherwise.
417+ Left (_, _, e) -> fail $ "decodeStaticKey: Binary.decodeOrFail failed: " <> show e
448−resolveInterpretPaths :: MonadIO m => [(FilePath, a)] -> m (Maybe (PathTree a))
418+ _ -> fail $ "decodeStaticKey: could not decode hex string: " <> show s
449−resolveInterpretPaths ps = do
450− trees <- liftIO $ for ps $ \(p, a) -> pathToTree a <$> canonicalizePath p
451− pure $ foldr1 mergeTrees <$> nonEmpty trees
452− where
453− -- | Merge two 'PathTree's preferring leaves on the right in as much as they overlap with paths on the left.
454− mergeTrees :: PathTree a -> PathTree a -> PathTree a
455− mergeTrees (PathTree_Node ax x) (PathTree_Node ay y) = PathTree_Node (ay <|> ax) $ Map.unionWith mergeTrees x y
lib/command/src/Obelisk/Command/Deploy.hs+102−120
@@ -1,77 +1,64 @@
1−{-# LANGUAGE DeriveGeneric #-}
2{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
3{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE LambdaCase #-}
4{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE OverloadedStrings #-}
5−{-# LANGUAGE QuasiQuotes #-}
6{-# LANGUAGE ScopedTypeVariables #-}
4{-# LANGUAGE ScopedTypeVariables #-}
7{-# LANGUAGE ViewPatterns #-}
5{-# LANGUAGE ViewPatterns #-}
6+{-# LANGUAGE DeriveGeneric #-}
7+{-# LANGUAGE TypeApplications #-}
8module Obelisk.Command.Deploy where
8module Obelisk.Command.Deploy where
9
9
10−import Control.Applicative (liftA2)
11import Control.Lens
10import Control.Lens
12import Control.Monad
11import Control.Monad
13−import Control.Monad.Catch (Exception (displayException), MonadThrow, bracket, throwM, try)
12+import Control.Monad.Catch (Exception (displayException), MonadThrow, throwM, try, bracket_)
14−import Control.Monad.IO.Class (MonadIO, liftIO)
13+import Control.Monad.IO.Class (liftIO)
15import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
14import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
16import Data.Bits
15import Data.Bits
17import qualified Data.ByteString.Lazy as BSL
16import qualified Data.ByteString.Lazy as BSL
18import Data.Default
17import Data.Default
18+import qualified Data.HashMap.Strict as HM
19import qualified Data.Map as Map
19import qualified Data.Map as Map
20+import Data.Text (Text)
20import qualified Data.Set as Set
21import qualified Data.Set as Set
21−import Data.String.Here.Interpolated (i)
22import qualified Data.Text as T
22import qualified Data.Text as T
23import qualified Data.Text.IO as T
23import qualified Data.Text.IO as T
24import GHC.Generics
24import GHC.Generics
25+import Nix.Convert
26+import Nix.Pretty
27+import Nix.Value
25import System.Directory
28import System.Directory
29+import System.Environment (getEnvironment)
26import System.FilePath
30import System.FilePath
27import System.IO
31import System.IO
28−import System.PosixCompat.Files
32+import System.Posix.Files
33+import System.Process (delegate_ctlc, env, proc, cwd)
29import Text.URI (URI)
34import Text.URI (URI)
30import qualified Text.URI as URI
35import qualified Text.URI as URI
31import Text.URI.Lens
36import Text.URI.Lens
32
37
33import Obelisk.App (MonadObelisk)
38import Obelisk.App (MonadObelisk)
34−import Obelisk.CliApp (
35− Severity (..), callProcessAndLogOutput, failWith, proc, putLog,
39+import Obelisk.CliApp (Severity (..), callProcessAndLogOutput, failWith, putLog, withSpinner)
36− setCwd, setDelegateCtlc, setEnvOverride, withSpinner)
37import Obelisk.Command.Nix
40import Obelisk.Command.Nix
38import Obelisk.Command.Project
41import Obelisk.Command.Project
39import Obelisk.Command.Thunk
42import Obelisk.Command.Thunk
40import Obelisk.Command.Utils
43import Obelisk.Command.Utils
41
44
42−data DeployInitOpts = DeployInitOpts
43− { _deployInitOpts_outputDir :: FilePath
44− , _deployInitOpts_sshKey :: FilePath
45− , _deployInitOpts_hostname :: [String]
46− , _deployInitOpts_route :: String
47− , _deployInitOpts_adminEmail :: String
48− , _deployInitOpts_enableHttps :: Bool
49− } deriving Show
50−
51−deployInit :: MonadObelisk m => DeployInitOpts -> FilePath -> m ()
52−deployInit deployOpts root = do
53− let deployDir = _deployInitOpts_outputDir deployOpts
54− rootEqualsTarget <- liftIO $ liftA2 equalFilePath (canonicalizePath root) (canonicalizePath deployDir)
55− when rootEqualsTarget $
56− failWith [i|Deploy directory ${deployDir} should not be the same as project root.|]
57− thunkPtr <- readThunk root >>= \case
58− Right (ThunkData_Packed _ ptr) -> return ptr
59− _ -> getThunkPtr CheckClean_NotIgnored root Nothing
60− deployInit' thunkPtr deployOpts
61−
62−deployInit'
45+deployInit
63 :: MonadObelisk m
46 :: MonadObelisk m
64 => ThunkPtr
47 => ThunkPtr
65− -> DeployInitOpts
48+ -> FilePath
49+ -> FilePath
50+ -> [String] -- ^ hostnames
51+ -> String -- ^ route
52+ -> String -- ^ admin email
53+ -> Bool -- ^ enable https
66 -> m ()
54 -> m ()
67−deployInit' thunkPtr (DeployInitOpts deployDir sshKeyPath hostnames route adminEmail enableHttps) = do
55+deployInit thunkPtr deployDir sshKeyPath hostnames route adminEmail enableHttps = do
68− liftIO $ createDirectoryIfMissing True deployDir
69 localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
56 localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
70 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
57 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
71 False -> failWith $ T.pack $ "ob deploy init: file does not exist: " <> sshKeyPath
58 False -> failWith $ T.pack $ "ob deploy init: file does not exist: " <> sshKeyPath
72 True -> pure $ deployDir </> "ssh_key"
59 True -> pure $ deployDir </> "ssh_key"
73 callProcessAndLogOutput (Notice, Error) $
60 callProcessAndLogOutput (Notice, Error) $
74− proc cp [sshKeyPath, localKey]
61+ proc "cp" [sshKeyPath, localKey]
75 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
62 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
76 return localKey
63 return localKey
77 withSpinner "Validating configuration" $ do
64 withSpinner "Validating configuration" $ do
@@ -85,36 +72,29 @@ deployInit' thunkPtr (DeployInitOpts deployDir sshKeyPath hostnames route adminE
85 --accidentally create a production deployment that uses development
72 --accidentally create a production deployment that uses development
86 --credentials to connect to some resources. This could result in, e.g.,
73 --credentials to connect to some resources. This could result in, e.g.,
87 --production data backed up to a dev environment.
74 --production data backed up to a dev environment.
88− withSpinner "Creating project configuration directories" $ liftIO $ do
75+ withSpinner "Creating project configuration directories" $ do
89− mapM_ (createDirectoryIfMissing True)
76+ callProcessAndLogOutput (Notice, Error) $
77+ proc "mkdir" [ "-p"
90− [ deployDir </> "config" </> "backend"
78+ , deployDir </> "config" </> "backend"
91− , deployDir </> "config" </> "common"
79+ , deployDir </> "config" </> "common"
92− , deployDir </> "config" </> "frontend"
80+ , deployDir </> "config" </> "frontend"
93− ]
81+ ]
94−
95− let srcDir = deployDir </> "src"
96− withSpinner ("Creating source thunk (" <> T.pack (makeRelative deployDir srcDir) <> ")") $ do
97− createThunk srcDir $ Right thunkPtr
98− setupObeliskImpl deployDir
99−
100 withSpinner "Writing deployment configuration" $ do
82 withSpinner "Writing deployment configuration" $ do
101 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
83 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
102 writeDeployConfig deployDir "enable_https" $ show enableHttps
84 writeDeployConfig deployDir "enable_https" $ show enableHttps
103 writeDeployConfig deployDir "admin_email" adminEmail
85 writeDeployConfig deployDir "admin_email" adminEmail
104− writeDeployConfig deployDir ("config" </> "common" </> "route") route
86+ writeDeployConfig deployDir ("config" </> "common" </> "route") $ route
105− writeDeployConfig deployDir "module.nix" $
87+ withSpinner "Creating source thunk (./src)" $ liftIO $ do
106− "(import " <> toNixPath (makeRelative deployDir srcDir) <> " {}).obelisk.serverModules.mkBaseEc2"
88+ createThunk (deployDir </> "src") thunkPtr
107−
89+ setupObeliskImpl deployDir
108 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
90 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
109 initGit deployDir
91 initGit deployDir
110
92
111−setupObeliskImpl :: MonadIO m => FilePath -> m ()
93+setupObeliskImpl :: FilePath -> IO ()
112−setupObeliskImpl deployDir = liftIO $ do
94+setupObeliskImpl deployDir = do
113− let
114− implDir = toImplDir deployDir
95+ let implDir = toImplDir deployDir
115− goBackUp = foldr (</>) "" $ (".." <$) $ splitPath $ makeRelative deployDir implDir
116 createDirectoryIfMissing True implDir
96 createDirectoryIfMissing True implDir
117− writeFile (implDir </> "default.nix") $ "(import " <> toNixPath (goBackUp </> "src") <> " {}).obelisk"
97+ writeFile (implDir </> "default.nix") "(import ../../src {}).obelisk"
118
98
119deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
99deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
120deployPush deployPath getNixBuilders = do
100deployPush deployPath getNixBuilders = do
@@ -125,16 +105,14 @@ deployPush deployPath getNixBuilders = do
125 routeHost <- getHostFromRoute enableHttps route
105 routeHost <- getHostFromRoute enableHttps route
126 let srcPath = deployPath </> "src"
106 let srcPath = deployPath </> "src"
127 thunkPtr <- readThunk srcPath >>= \case
107 thunkPtr <- readThunk srcPath >>= \case
128− Right (ThunkData_Packed _ ptr) -> return ptr
108+ Right (ThunkData_Packed ptr) -> return ptr
129− Right ThunkData_Checkout -> do
109+ Right (ThunkData_Checkout _) -> do
130 checkGitCleanStatus srcPath True >>= \case
110 checkGitCleanStatus srcPath True >>= \case
131− True -> packThunk (ThunkPackConfig False (ThunkConfig Nothing)) srcPath
111+ True -> packThunk False srcPath
132 False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
112 False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
133 Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
113 Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
134 let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
114 let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
135 builders <- getNixBuilders
115 builders <- getNixBuilders
136− let moduleFile = deployPath </> "module.nix"
137− moduleFileExists <- liftIO $ doesFileExist moduleFile
138 buildOutputByHost <- ifor (Map.fromSet (const ()) hosts) $ \host () -> do
116 buildOutputByHost <- ifor (Map.fromSet (const ()) hosts) $ \host () -> do
139 --TODO: What does it mean if this returns more or less than 1 line of output?
117 --TODO: What does it mean if this returns more or less than 1 line of output?
140 [result] <- fmap lines $ nixCmd $ NixCmd_Build $ def
118 [result] <- fmap lines $ nixCmd $ NixCmd_Build $ def
@@ -144,13 +122,13 @@ deployPush deployPath getNixBuilders = do
144 , _target_expr = Nothing
122 , _target_expr = Nothing
145 }
123 }
146 & nixBuildConfig_outLink .~ OutLink_None
124 & nixBuildConfig_outLink .~ OutLink_None
147− & nixCmdConfig_args .~ (
125+ & nixCmdConfig_args .~
148 [ strArg "hostName" host
126 [ strArg "hostName" host
149 , strArg "adminEmail" adminEmail
127 , strArg "adminEmail" adminEmail
150 , strArg "routeHost" routeHost
128 , strArg "routeHost" routeHost
151 , strArg "version" version
129 , strArg "version" version
152 , boolArg "enableHttps" enableHttps
130 , boolArg "enableHttps" enableHttps
153− ] <> [rawArg "module" ("import " <> toNixPath moduleFile) | moduleFileExists ])
131+ ]
154 & nixCmdConfig_builders .~ builders
132 & nixCmdConfig_builders .~ builders
155 pure result
133 pure result
156 let knownHostsPath = deployPath </> "backend_known_hosts"
134 let knownHostsPath = deployPath </> "backend_known_hosts"
@@ -161,8 +139,8 @@ deployPush deployPath getNixBuilders = do
161 "nix-copy-closure" ["-v", "--to", "--use-substitutes", "root@" <> host, "--gzip", outputPath]
139 "nix-copy-closure" ["-v", "--to", "--use-substitutes", "root@" <> host, "--gzip", outputPath]
162 withSpinner "Uploading config" $ ifor_ buildOutputByHost $ \host _ -> do
140 withSpinner "Uploading config" $ ifor_ buildOutputByHost $ \host _ -> do
163 callProcessAndLogOutput (Notice, Warning) $
141 callProcessAndLogOutput (Notice, Warning) $
164− proc rsyncPath
142+ proc "rsync"
165− [ "-e " <> sshPath <> " " <> unwords sshOpts
143+ [ "-e ssh " <> unwords sshOpts
166 , "-qarvz"
144 , "-qarvz"
167 , deployPath </> "config"
145 , deployPath </> "config"
168 , "root@" <> host <> ":/var/lib/backend"
146 , "root@" <> host <> ":/var/lib/backend"
@@ -170,10 +148,9 @@ deployPush deployPath getNixBuilders = do
170 --TODO: Create GC root so we're sure our closure won't go away during this time period
148 --TODO: Create GC root so we're sure our closure won't go away during this time period
171 withSpinner "Switching to new configuration" $ ifor_ buildOutputByHost $ \host outputPath -> do
149 withSpinner "Switching to new configuration" $ ifor_ buildOutputByHost $ \host outputPath -> do
172 callProcessAndLogOutput (Notice, Warning) $
150 callProcessAndLogOutput (Notice, Warning) $
173− proc sshPath $ sshOpts <>
151+ proc "ssh" $ sshOpts <>
174 [ "root@" <> host
152 [ "root@" <> host
175 , unwords
153 , unwords
176− -- Note that we don't want to $(staticWhich "nix-env") here, because this is executing on a remote machine
177 [ "nix-env -p /nix/var/nix/profiles/system --set " <> outputPath
154 [ "nix-env -p /nix/var/nix/profiles/system --set " <> outputPath
178 , "&&"
155 , "&&"
179 , "/nix/var/nix/profiles/system/bin/switch-to-configuration switch"
156 , "/nix/var/nix/profiles/system/bin/switch-to-configuration switch"
@@ -181,19 +158,33 @@ deployPush deployPath getNixBuilders = do
181 ]
158 ]
182 isClean <- checkGitCleanStatus deployPath True
159 isClean <- checkGitCleanStatus deployPath True
183 when (not isClean) $ do
160 when (not isClean) $ do
184− withSpinner "Committing changes to Git" $ do
161+ withSpinner "Commiting changes to Git" $ do
185− callProcessAndLogOutput (Debug, Error) $
162+ callProcessAndLogOutput (Debug, Error) $ proc "git"
186− gitProc deployPath ["add", "."]
163+ ["-C", deployPath, "add", "."]
187− callProcessAndLogOutput (Debug, Error) $
164+ callProcessAndLogOutput (Debug, Error) $ proc "git"
188− gitProc deployPath ["commit", "-m", "New deployment"]
165+ ["-C", deployPath, "commit", "-m", "New deployment"]
189 putLog Notice $ "Deployed => " <> T.pack route
166 putLog Notice $ "Deployed => " <> T.pack route
190 where
167 where
191 callProcess' envMap cmd args = do
168 callProcess' envMap cmd args = do
192− let p = setEnvOverride (envMap <>) $ setDelegateCtlc True $ proc cmd args
169+ processEnv <- Map.toList . (envMap <>) . Map.fromList <$> liftIO getEnvironment
170+ let p = (proc cmd args) { delegate_ctlc = True, env = Just processEnv }
193 callProcessAndLogOutput (Notice, Notice) p
171 callProcessAndLogOutput (Notice, Notice) p
194
172
195deployUpdate :: MonadObelisk m => FilePath -> m ()
173deployUpdate :: MonadObelisk m => FilePath -> m ()
196−deployUpdate deployPath = updateThunkToLatest (ThunkUpdateConfig Nothing (ThunkConfig Nothing)) (deployPath </> "src")
174+deployUpdate deployPath = updateThunkToLatest (deployPath </> "src") Nothing
175+
176+keytoolToAndroidConfig :: KeytoolConfig -> HM.HashMap Text (NValueNF Identity)
177+keytoolToAndroidConfig conf = runIdentity $ do
178+ path <- toValue $ Path $ _keytoolConfig_keystore conf
179+ storepass <- toValue $ T.pack $ _keytoolConfig_storepass conf
180+ alias <- toValue $ T.pack $ _keytoolConfig_alias conf
181+ keypass <- toValue $ T.pack $ _keytoolConfig_keypass conf
182+ return $ HM.fromList
183+ [ ("storeFile", path)
184+ , ("storePassword", storepass)
185+ , ("keyAlias", alias)
186+ , ("keyPassword", keypass)
187+ ]
197
188
198data PlatformDeployment = Android | IOS
189data PlatformDeployment = Android | IOS
199 deriving (Show, Eq)
190 deriving (Show, Eq)
@@ -203,13 +194,13 @@ renderPlatformDeployment = \case
203 Android -> "android"
194 Android -> "android"
204 IOS -> "ios"
195 IOS -> "ios"
205
196
206−deployMobile :: forall m. MonadObelisk m => PlatformDeployment -> [String] -> m ()
197+deployMobile :: MonadObelisk m => PlatformDeployment -> [String] -> m ()
207deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
198deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
208 let srcDir = root </> "src"
199 let srcDir = root </> "src"
209 configDir = root </> "config"
200 configDir = root </> "config"
210 exists <- liftIO $ doesDirectoryExist srcDir
201 exists <- liftIO $ doesDirectoryExist srcDir
211 unless exists $ failWith "ob test should be run inside of a deploy directory"
202 unless exists $ failWith "ob test should be run inside of a deploy directory"
212− (nixBuildTarget, extraArgs) <- case platform of
203+ nixBuildTarget <- case platform of
213 Android -> do
204 Android -> do
214 let keystorePath = root </> "android_keystore.jks"
205 let keystorePath = root </> "android_keystore.jks"
215 keytoolConfPath = root </> "android_keytool_config.json"
206 keytoolConfPath = root </> "android_keytool_config.json"
@@ -228,60 +219,48 @@ deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
228 , _keytoolConfig_storepass = keyStorePassword
219 , _keytoolConfig_storepass = keyStorePassword
229 , _keytoolConfig_keypass = keyStorePassword
220 , _keytoolConfig_keypass = keyStorePassword
230 }
221 }
231− createKeystore root keyToolConf
222+ createKeystore root $ keyToolConf
232 liftIO $ BSL.writeFile keytoolConfPath $ encode keyToolConf
223 liftIO $ BSL.writeFile keytoolConfPath $ encode keyToolConf
233 checkKeytoolConfExist <- liftIO $ doesFileExist keytoolConfPath
224 checkKeytoolConfExist <- liftIO $ doesFileExist keytoolConfPath
234 unless checkKeytoolConfExist $ failWith "Missing android KeytoolConfig"
225 unless checkKeytoolConfExist $ failWith "Missing android KeytoolConfig"
235 keytoolConfContents <- liftIO $ BSL.readFile keytoolConfPath
226 keytoolConfContents <- liftIO $ BSL.readFile keytoolConfPath
227+ liftIO $ putStrLn $ show keytoolConfContents
236− keyArgs <- case eitherDecode keytoolConfContents :: Either String KeytoolConfig of
228+ releaseKey <- case eitherDecode keytoolConfContents of
237 Left err -> failWith $ T.pack err
229 Left err -> failWith $ T.pack err
238− Right conf -> pure
230+ Right conf -> do
239− [ "--sign"
231+ let nvset = toValue @(HM.HashMap Text (NValueNF Identity)) @Identity @(NValueNF Identity) $ keytoolToAndroidConfig conf
240− , "--store-file", _keytoolConfig_keystore conf
232+ return $ printNix $ runIdentity nvset
241− , "--store-password", _keytoolConfig_storepass conf
242− , "--key-alias", _keytoolConfig_alias conf
243− , "--key-password", _keytoolConfig_keypass conf
244− ]
245 let expr = mconcat
233 let expr = mconcat
246− [ "with (import ", toNixPath srcDir, " {});"
234+ [ "with (import ", srcDir, " {});"
247− , "android.frontend.override (drv: {"
235+ , "android.frontend.override (drv: { "
248− , "isRelease = true;"
236+ , "releaseKey = (if builtins.isNull drv.releaseKey then {} else drv.releaseKey) // " <> releaseKey <> "; "
249 , "staticSrc = (passthru.__androidWithConfig ", configDir, ").frontend.staticSrc;"
237 , "staticSrc = (passthru.__androidWithConfig ", configDir, ").frontend.staticSrc;"
250− , "assets = (passthru.__androidWithConfig ", configDir, ").frontend.assets;"
251 , "})"
238 , "})"
252 ]
239 ]
253− return (Target
240+ return $ Target
254 { _target_path = Nothing
241 { _target_path = Nothing
255 , _target_attr = Nothing
242 , _target_attr = Nothing
256 , _target_expr = Just expr
243 , _target_expr = Just expr
257− }, keyArgs)
244+ }
258 IOS -> do
245 IOS -> do
259 let expr = mconcat
246 let expr = mconcat
260− [ "with (import ", toNixPath srcDir, " {});"
247+ [ "with (import ", srcDir, " {});"
261− , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", toNixPath configDir, ").frontend.staticSrc; })"
248+ , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", configDir, ").frontend.staticSrc; })"
262 ]
249 ]
263− return (Target
250+ return $ Target
264 { _target_path = Nothing
251 { _target_path = Nothing
265 , _target_attr = Nothing
252 , _target_attr = Nothing
266 , _target_expr = Just expr
253 , _target_expr = Just expr
267− }, [])
254+ }
268 result <- nixCmd $ NixCmd_Build $ def
255 result <- nixCmd $ NixCmd_Build $ def
269 & nixBuildConfig_outLink .~ OutLink_None
256 & nixBuildConfig_outLink .~ OutLink_None
270 & nixCmdConfig_target .~ nixBuildTarget
257 & nixCmdConfig_target .~ nixBuildTarget
271− let mobileArtifact = case platform of
272− IOS -> "iOS App"
273− Android -> "Android APK"
274− putLog Notice $ T.pack $ unwords ["Your recently built", mobileArtifact, "can be found at the following path:", show result]
258+ putLog Notice $ T.pack $ "Your recently built android apk can be found at the following path: " <> (show result)
275− callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") (mobileArgs ++ extraArgs)
259+ callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") mobileArgs
276 where
260 where
277− withEcho showEcho f = bracket
261+ withEcho showEcho f = do
278− (do
279− prevEcho <- hGetEcho stdin
262+ prevEcho <- hGetEcho stdin
280− hSetEcho stdin showEcho
263+ bracket_ (hSetEcho stdin showEcho) (hSetEcho stdin prevEcho) f
281− pure prevEcho
282− )
283− (hSetEcho stdin)
284− (const f)
285
264
286data KeytoolConfig = KeytoolConfig
265data KeytoolConfig = KeytoolConfig
287 { _keytoolConfig_keystore :: FilePath
266 { _keytoolConfig_keystore :: FilePath
@@ -294,16 +273,19 @@ instance FromJSON KeytoolConfig
294instance ToJSON KeytoolConfig
273instance ToJSON KeytoolConfig
295
274
296createKeystore :: MonadObelisk m => FilePath -> KeytoolConfig -> m ()
275createKeystore :: MonadObelisk m => FilePath -> KeytoolConfig -> m ()
297−createKeystore root config =
276+createKeystore root config = do
277+ let expr = "with (import " <> toImplDir root <> ").reflex-platform.nixpkgs; pkgs.mkShell { buildInputs = [ pkgs.jdk ]; }"
298− callProcessAndLogOutput (Notice, Notice) $ setCwd (Just root) $ proc jreKeyToolPath
278+ callProcessAndLogOutput (Notice,Notice) $ (proc "nix-shell" ["-E" , expr, "--run" , keytoolCmd]) { cwd = Just root }
279+ where
280+ keytoolCmd = processToShellString "keytool"
299− [ "-genkeypair", "-noprompt"
281+ [ "-genkeypair", "-noprompt"
300− , "-keystore", _keytoolConfig_keystore config
282+ , "-keystore", _keytoolConfig_keystore config
301− , "-keyalg", "RSA", "-keysize", "2048"
283+ , "-keyalg", "RSA", "-keysize", "2048"
302− , "-validity", "1000000"
284+ , "-validity", "1000000000"
303− , "-storepass", _keytoolConfig_storepass config
285+ , "-storepass", _keytoolConfig_storepass config
304− , "-alias", _keytoolConfig_alias config
286+ , "-alias", _keytoolConfig_alias config
305− , "-keypass", _keytoolConfig_keypass config
287+ , "-keypass", _keytoolConfig_keypass config
306− ]
288+ ]
307
289
308-- | Simplified deployment configuration mechanism. At one point we may revisit this.
290-- | Simplified deployment configuration mechanism. At one point we may revisit this.
309writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
291writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
@@ -315,7 +297,7 @@ readDeployConfig deployDir fname = liftIO $ do
315
297
316verifyHostKey :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
298verifyHostKey :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
317verifyHostKey knownHostsPath keyPath hostName =
299verifyHostKey knownHostsPath keyPath hostName =
318− callProcessAndLogOutput (Notice, Warning) $ proc sshPath $
300+ callProcessAndLogOutput (Notice, Warning) $ proc "ssh" $
319 sshArgs knownHostsPath keyPath True <>
301 sshArgs knownHostsPath keyPath True <>
320 [ "root@" <> hostName
302 [ "root@" <> hostName
321 , "-o", "NumberOfPasswordPrompts=0"
303 , "-o", "NumberOfPasswordPrompts=0"
lib/command/src/Obelisk/Command/Nix.hs+27−67
@@ -9,33 +9,22 @@
9{-# LANGUAGE TemplateHaskell #-}
9{-# LANGUAGE TemplateHaskell #-}
10{-# LANGUAGE TypeApplications #-}
10{-# LANGUAGE TypeApplications #-}
11module Obelisk.Command.Nix
11module Obelisk.Command.Nix
12− ( Arg (..)
12+ ( nixCmd
13− , NixBuildConfig (..)
14− , nixBuildConfig_common
15− , nixBuildConfig_outLink
16 , NixCmd (..)
13 , NixCmd (..)
14+ , nixCmdConfig_target
17 , nixCmdConfig_args
15 , nixCmdConfig_args
18 , nixCmdConfig_builders
16 , nixCmdConfig_builders
19− , nixCmdConfig_target
17+ , NixBuildConfig (..)
20− , NixCommonConfig (..)
18+ , nixBuildConfig_common
19+ , nixBuildConfig_outLink
21 , NixInstantiateConfig (..)
20 , NixInstantiateConfig (..)
22 , nixInstantiateConfig_eval
21 , nixInstantiateConfig_eval
23− , NixShellConfig (..)
22+ , NixCommonConfig (..)
24− , nixShellConfig_common
25− , nixShellConfig_pure
26− , nixShellConfig_run
27− , OutLink (..)
28 , Target (..)
23 , Target (..)
29− , target_attr
24+ , OutLink (..)
30− , target_expr
25+ , Arg (..)
31− , target_path
32−
33 , boolArg
26 , boolArg
34− , nixCmd
35− , nixCmdProc
36− , nixCmdProc'
37 , rawArg
27 , rawArg
38− , runNixShellConfig
39 , strArg
28 , strArg
40 ) where
29 ) where
41
30
@@ -48,6 +37,7 @@ import Data.List (intercalate)
48import Data.Maybe
37import Data.Maybe
49import Data.Monoid ((<>))
38import Data.Monoid ((<>))
50import qualified Data.Text as T
39import qualified Data.Text as T
40+import System.Process (proc)
51
41
52import Obelisk.App (MonadObelisk)
42import Obelisk.App (MonadObelisk)
53import Obelisk.CliApp
43import Obelisk.CliApp
@@ -73,10 +63,10 @@ data Arg
73 deriving (Eq, Show)
63 deriving (Eq, Show)
74
64
75strArg :: String -> String -> Arg
65strArg :: String -> String -> Arg
76−strArg = Arg_Str
66+strArg k = Arg_Str k
77
67
78rawArg :: String -> String -> Arg
68rawArg :: String -> String -> Arg
79−rawArg = Arg_Expr
69+rawArg k = Arg_Expr k
80
70
81boolArg :: String -> Bool -> Arg
71boolArg :: String -> Bool -> Arg
82boolArg k = Arg_Expr k . bool "false" "true"
72boolArg k = Arg_Expr k . bool "false" "true"
@@ -96,7 +86,7 @@ makeClassy ''NixCommonConfig
96instance Default NixCommonConfig where
86instance Default NixCommonConfig where
97 def = NixCommonConfig def mempty mempty
87 def = NixCommonConfig def mempty mempty
98
88
99−runNixCommonConfig :: NixCommonConfig -> [String]
89+runNixCommonConfig :: NixCommonConfig -> [FilePath]
100runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
90runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
101 where
91 where
102 path = _target_path $ _nixCmdConfig_target cfg
92 path = _target_path $ _nixCmdConfig_target cfg
@@ -134,7 +124,7 @@ instance HasNixCommonConfig NixBuildConfig where
134instance Default NixBuildConfig where
124instance Default NixBuildConfig where
135 def = NixBuildConfig def def
125 def = NixBuildConfig def def
136
126
137−runNixBuildConfig :: NixBuildConfig -> [String]
127+runNixBuildConfig :: NixBuildConfig -> [FilePath]
138runNixBuildConfig cfg = mconcat
128runNixBuildConfig cfg = mconcat
139 [ runNixCommonConfig $ cfg ^. nixCommonConfig
129 [ runNixCommonConfig $ cfg ^. nixCommonConfig
140 , case _nixBuildConfig_outLink cfg of
130 , case _nixBuildConfig_outLink cfg of
@@ -155,26 +145,12 @@ instance HasNixCommonConfig NixInstantiateConfig where
155instance Default NixInstantiateConfig where
145instance Default NixInstantiateConfig where
156 def = NixInstantiateConfig def False
146 def = NixInstantiateConfig def False
157
147
158−runNixInstantiateConfig :: NixInstantiateConfig -> [String]
148+runNixInstantiateConfig :: NixInstantiateConfig -> [FilePath]
159runNixInstantiateConfig cfg = mconcat
149runNixInstantiateConfig cfg = mconcat
160 [ runNixCommonConfig $ cfg ^. nixCommonConfig
150 [ runNixCommonConfig $ cfg ^. nixCommonConfig
161 , "--eval" <$ guard (_nixInstantiateConfig_eval cfg)
151 , "--eval" <$ guard (_nixInstantiateConfig_eval cfg)
162 ]
152 ]
163
153
164−data NixShellConfig = NixShellConfig
165− { _nixShellConfig_common :: NixCommonConfig
166− , _nixShellConfig_pure :: Bool
167− , _nixShellConfig_run :: Maybe String
168− }
169−
170−makeLenses ''NixShellConfig
171−
172−instance HasNixCommonConfig NixShellConfig where
173− nixCommonConfig = nixShellConfig_common
174−
175−instance Default NixShellConfig where
176− def = NixShellConfig def False Nothing
177−
178data NixCmd
154data NixCmd
179 = NixCmd_Build NixBuildConfig
155 = NixCmd_Build NixBuildConfig
180 | NixCmd_Instantiate NixInstantiateConfig
156 | NixCmd_Instantiate NixInstantiateConfig
@@ -182,43 +158,27 @@ data NixCmd
182instance Default NixCmd where
158instance Default NixCmd where
183 def = NixCmd_Build def
159 def = NixCmd_Build def
184
160
185−runNixShellConfig :: NixShellConfig -> [String]
161+nixCmd :: MonadObelisk m => NixCmd -> m FilePath
186−runNixShellConfig cfg = mconcat
162+nixCmd cmdCfg = withSpinner' ("Running " <> cmd <> desc) (Just $ const $ "Built " <> desc) $ do
187− [ runNixCommonConfig $ cfg ^. nixCommonConfig
188− , [ "--pure" | cfg ^. nixShellConfig_pure ]
189− ] ++ mconcat [
190− ["--run", run] | run <- maybeToList $ cfg ^. nixShellConfig_run
191− ]
192−
193−nixCmdProc :: NixCmd -> ProcessSpec
194−nixCmdProc = fst . nixCmdProc'
195−
196−nixCmdProc' :: NixCmd -> (ProcessSpec, T.Text)
197−nixCmdProc' cmdCfg = (proc (T.unpack cmd) options, cmd)
163+ output <- readProcessAndLogStderr Debug $ proc (T.unpack cmd) $ options
164+ -- Remove final newline that Nix appends
165+ Just (outPath, '\n') <- pure $ T.unsnoc output
166+ pure $ T.unpack outPath
198 where
167 where
199− (cmd, options) = case cmdCfg of
168+ (cmd, options, commonCfg) = case cmdCfg of
200 NixCmd_Build cfg' ->
169 NixCmd_Build cfg' ->
201 ( "nix-build"
170 ( "nix-build"
202 , runNixBuildConfig cfg'
171 , runNixBuildConfig cfg'
172+ , cfg' ^. nixCommonConfig
203 )
173 )
204 NixCmd_Instantiate cfg' ->
174 NixCmd_Instantiate cfg' ->
205 ( "nix-instantiate"
175 ( "nix-instantiate"
206 , runNixInstantiateConfig cfg'
176 , runNixInstantiateConfig cfg'
177+ , cfg' ^. nixCommonConfig
207 )
178 )
208−
209−nixCmd :: MonadObelisk m => NixCmd -> m FilePath
210−nixCmd cmdCfg = withSpinner' (T.unwords $ "Running" : cmd : desc) (Just $ const $ T.unwords $ "Built" : desc) $ do
211− output <- readProcessAndLogStderr Debug cmdProc
212− -- Remove final newline that Nix appends
213− Just (outPath, '\n') <- pure $ T.unsnoc output
214− pure $ T.unpack outPath
215− where
216− (cmdProc, cmd) = nixCmdProc' cmdCfg
217− commonCfg = case cmdCfg of
218− NixCmd_Build cfg' -> cfg' ^. nixCommonConfig
219− NixCmd_Instantiate cfg' -> cfg' ^. nixCommonConfig
220 path = commonCfg ^. nixCmdConfig_target . target_path
179 path = commonCfg ^. nixCmdConfig_target . target_path
221− desc = concat $ catMaybes
180+ desc = T.pack $ mconcat $ catMaybes
222− [ (\x -> ["on", T.pack x]) <$> path
181+ [ (" on " <>) <$> path
223− , (\a -> ["[" <> T.pack a <> "]"]) <$> (commonCfg ^. nixCmdConfig_target . target_attr)
182+ , (\a -> " [" <> a <> "]") <$> (commonCfg ^. nixCmdConfig_target . target_attr)
224 ]
183 ]
184+
lib/command/src/Obelisk/Command/Preprocessor.hsdeleted−100
@@ -1,100 +0,0 @@
1−{-# LANGUAGE LambdaCase #-}
2−{-# LANGUAGE OverloadedStrings #-}
3−
4−module Obelisk.Command.Preprocessor where
5−
6−import qualified Data.ByteString.Lazy as BL
7−import qualified Data.ByteString.Lazy.Builder as BU
8−import Data.Foldable (for_)
9−import Data.List (intersperse, isPrefixOf, sortOn)
10−import Data.Maybe (fromMaybe)
11−import qualified Data.Text.Lazy.Builder as TL
12−import qualified Data.Text.Lazy.Encoding as TL
13−import Distribution.Compiler (CompilerFlavor (..))
14−import Language.Haskell.Extension (Extension (..), Language(..))
15−import System.Directory (canonicalizePath)
16−import System.IO (IOMode (..), hPutStrLn, stderr, withFile)
17−import System.FilePath (hasTrailingPathSeparator, joinPath, splitPath)
18−
19−import Obelisk.Command.Run (CabalPackageInfo (..), parseCabalPackage')
20−
21−-- | This code is intended to be executed via ghci's -pgmF preprocessor option.
22−-- The command line arguments are passed in via ghc, which dictates the first three options and meanings
23−-- In order for this code to execute, origPath must contain either a '.' character or a '/' character.
24−-- (This is to avoid the possibility of the command line syntax conflicting with another ob command)
25−-- We do have control over the remaining arguments, but they must be the same for all files.
26−-- Thus, the fourth command line argument must be "apply-packages", which has already been handled.
27−-- We assume all the remaining arguments passed in are paths to cabal or hpack package specifications.
28−-- Thus we must select among the packagePaths for the file we are going to parse.
29−applyPackages :: FilePath -> FilePath -> FilePath -> [FilePath] -> IO ()
30−applyPackages origPath inPath outPath packagePaths' = do
31− origPathCanonical <- canonicalizePath origPath
32− packagePaths <- traverse canonicalizePath packagePaths'
33−
34− let
35− takeDirs = takeWhile hasTrailingPathSeparator
36− packageDirs = sortOn (negate . length . takeDirs) $ map splitPath packagePaths
37− origDir = splitPath origPathCanonical
38− matches = [ joinPath d | d <- packageDirs, takeDirs d `isPrefixOf` origDir ]
39−
40− -- The first element of matches is going to be the deepest path to a package spec that contains
41− -- our file as a subdirectory.
42− packageInfo' <- case matches of
43− [] -> do
44− hPutStrLn stderr $ "Error: Unable to find cabal information for " <> origPath <> "; Skipping preprocessor."
45− pure Nothing
46− packagePath:_ -> parseCabalPackage' packagePath >>= \case
47− Left err -> do
48− hPutStrLn stderr $ "Error: Unable to parse cabal package " <> packagePath <> "; Skipping preprocessor on " <> origPath <> ". Error: " <> show err
49− pure Nothing
50− Right (Just (_, packageInfo)) -> pure $ Just packageInfo
51− Right Nothing -> pure Nothing
52−
53− writeOutput packageInfo' inPath outPath
54−
55−writeOutput :: Maybe CabalPackageInfo -> FilePath -> FilePath -> IO ()
56−writeOutput packageInfo' origPath outPath = withFile outPath WriteMode $ \hOut -> do
57− for_ packageInfo' $ \packageInfo -> hPutTextBuilder hOut (generateHeader origPath packageInfo)
58− BL.readFile origPath >>= BL.hPut hOut
59− where
60− hPutTextBuilder h = BU.hPutBuilder h . TL.encodeUtf8Builder . TL.toLazyText
61−
62−generateHeader :: FilePath -> CabalPackageInfo -> TL.Builder
63−generateHeader origPath packageInfo =
64− hsExtensions <> ghcOptions <> lineNumberPragma origPath
65− where
66− hsExtensions =
67− if null extList
68− then mempty
69− else pragma $ TL.fromText "LANGUAGE " <> mconcat (intersperse (TL.fromText ", ") extList)
70− extList = addDefaultLanguage $ concatMap showExt $ _cabalPackageInfo_defaultExtensions packageInfo
71− addDefaultLanguage =
72− case _cabalPackageInfo_defaultLanguage packageInfo of
73− Nothing -> id
74− Just x -> case x of
75− UnknownLanguage ext -> (TL.fromString ext :)
76− ext -> (TL.fromString (show ext) :)
77− showExt = \case
78− EnableExtension ext -> [TL.fromString (show ext)]
79− DisableExtension ext -> ["No" <> TL.fromString (show ext)]
80− UnknownExtension ext -> [TL.fromString ext]
81−
82− ghcOptions =
83− if null optList
84− then mempty
85− else pragma $
86− TL.fromText "OPTIONS_GHC " <> mconcat (intersperse (TL.fromText " ") (map TL.fromString optList))
87− ghcOptList
88− = filter (not . isPrefixOf "-O")
89− $ fromMaybe []
90− $ lookup GHC (_cabalPackageInfo_compilerOptions packageInfo)
91− optList = _cabalPackageInfo_cppOptions packageInfo <> ghcOptList
92−
93−lineNumberPragma :: FilePath -> TL.Builder
94−lineNumberPragma origPath = pragma $ TL.fromText "LINE 1 " <> quoted '"' (TL.fromString origPath)
95−
96−pragma :: TL.Builder -> TL.Builder
97−pragma x = TL.fromText "{-# " <> x <> TL.fromText " #-}\n"
98−
99−quoted :: Char -> TL.Builder -> TL.Builder
100−quoted char x = TL.singleton char <> x <> TL.singleton char
lib/command/src/Obelisk/Command/Project.hs+67−202
@@ -3,56 +3,37 @@
3{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE OverloadedStrings #-}
4module Obelisk.Command.Project
4module Obelisk.Command.Project
5 ( InitSource (..)
5 ( InitSource (..)
6+ , initProject
6 , findProjectObeliskCommand
7 , findProjectObeliskCommand
7 , findProjectRoot
8 , findProjectRoot
8− , findProjectAssets
9− , initProject
10− , nixShellRunConfig
11− , nixShellRunProc
12− , nixShellWithHoogle
13− , nixShellWithoutPkgs
14− , obeliskDirName
15− , toImplDir
16− , toObeliskDir
17 , withProjectRoot
9 , withProjectRoot
18− , bashEscape
10+ , inProjectShell
11+ , inImpureProjectShell
12+ , projectShell
13+
14+ , toObeliskDir
15+ , toImplDir
19 ) where
16 ) where
20
17
21−import Control.Concurrent.MVar (MVar, newMVar, withMVarMasked)
22−import Control.Lens ((.~), (?~), (<&>))
23import Control.Monad
18import Control.Monad
24import Control.Monad.IO.Class (liftIO)
19import Control.Monad.IO.Class (liftIO)
25import Control.Monad.State
20import Control.Monad.State
26−import qualified Data.Aeson as Json
27−import qualified Data.ByteString.UTF8 as BSU
28import Data.Bits
21import Data.Bits
29−import qualified Data.ByteString.Lazy as BSL
30−import Data.Default (def)
31−import Data.Function ((&), on)
22+import Data.Function (on)
32−import Data.Map (Map)
33−import Data.Text (Text)
34import qualified Data.Text as T
23import qualified Data.Text as T
35−import Data.Text.Encoding (decodeUtf8, encodeUtf8)
36−import Data.Traversable (for)
37import System.Directory
24import System.Directory
38−import System.Environment (lookupEnv)
39import System.FilePath
25import System.FilePath
40import System.IO.Temp
26import System.IO.Temp
41−import System.IO.Unsafe (unsafePerformIO)
27+import System.Posix (FileStatus, UserID, deviceID, fileID, fileMode, fileOwner, getFileStatus, getRealUserID)
42−import System.PosixCompat.Files
28+import System.Posix.Files
43−import System.PosixCompat.Types
29+import System.Process (CreateProcess, cwd, proc, waitForProcess, delegate_ctlc)
44−import System.PosixCompat.User
45−import Text.ShellEscape (bash, bytes)
46
30
47import GitHub.Data.GitData (Branch)
31import GitHub.Data.GitData (Branch)
48import GitHub.Data.Name (Name)
32import GitHub.Data.Name (Name)
49
33
50import Obelisk.App (MonadObelisk)
34import Obelisk.App (MonadObelisk)
51import Obelisk.CliApp
35import Obelisk.CliApp
52−import Obelisk.Command.Nix
53import Obelisk.Command.Thunk
36import Obelisk.Command.Thunk
54−import Obelisk.Command.Utils (nixBuildExePath, nixExePath, toNixPath, cp, nixShellPath)
55−
56--TODO: Make this module resilient to random exceptions
37--TODO: Make this module resilient to random exceptions
57
38
58--TODO: Don't hardcode this
39--TODO: Don't hardcode this
@@ -66,21 +47,17 @@ obeliskSourceWithBranch branch = ThunkSource_GitHub $ GitHubSource
66 { _gitHubSource_owner = "obsidiansystems"
47 { _gitHubSource_owner = "obsidiansystems"
67 , _gitHubSource_repo = "obelisk"
48 , _gitHubSource_repo = "obelisk"
68 , _gitHubSource_branch = Just branch
49 , _gitHubSource_branch = Just branch
69− , _gitHubSource_private = False
70 }
50 }
71
51
72data InitSource
52data InitSource
73− = InitSource_Default
53+ = InitSource_Default
74− | InitSource_Branch (Name Branch)
54+ | InitSource_Branch (Name Branch)
75− | InitSource_Symlink FilePath
55+ | InitSource_Symlink FilePath
76− deriving Show
56+ deriving Show
77−
78−obeliskDirName :: FilePath
79−obeliskDirName = ".obelisk"
80
57
81-- | Path to obelisk directory in given path
58-- | Path to obelisk directory in given path
82toObeliskDir :: FilePath -> FilePath
59toObeliskDir :: FilePath -> FilePath
83−toObeliskDir p = p </> obeliskDirName
60+toObeliskDir p = p </> ".obelisk"
84
61
85-- | Path to impl file in given path
62-- | Path to impl file in given path
86toImplDir :: FilePath -> FilePath
63toImplDir :: FilePath -> FilePath
@@ -97,26 +74,20 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
97 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
74 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
98 skeleton <- withSpinner "Setting up obelisk" $ do
75 skeleton <- withSpinner "Setting up obelisk" $ do
99 liftIO $ createDirectory obDir
76 liftIO $ createDirectory obDir
100− -- Clone the git source and repack it with the init source obelisk
101− -- The purpose of this is to ensure we use the correct thunk spec.
102− let cloneAndRepack src = do
103− putLog Debug $ "Cloning obelisk into " <> T.pack implDir <> " and repacking using itself"
104− commit <- getLatestRev src
105− gitCloneForThunkUnpack (thunkSourceToGitSource src) (_thunkRev_commit commit) implDir
106− callHandoffOb implDir ["thunk", "pack", implDir]
107 case source of
77 case source of
108− InitSource_Default -> cloneAndRepack obeliskSource
78+ InitSource_Default -> createThunkWithLatest implDir obeliskSource
109− InitSource_Branch branch -> cloneAndRepack $ obeliskSourceWithBranch branch
79+ InitSource_Branch branch -> createThunkWithLatest implDir $ obeliskSourceWithBranch branch
110 InitSource_Symlink path -> do
80 InitSource_Symlink path -> do
111 let symlinkPath = if isAbsolute path
81 let symlinkPath = if isAbsolute path
112 then path
82 then path
113 else ".." </> path
83 else ".." </> path
114 liftIO $ createSymbolicLink symlinkPath implDir
84 liftIO $ createSymbolicLink symlinkPath implDir
115 _ <- nixBuildAttrWithCache implDir "command"
85 _ <- nixBuildAttrWithCache implDir "command"
86+ --TODO: We should probably handoff to the impl here
116 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
87 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
117
88
118 callProcessAndLogOutput (Notice, Error) $
89 callProcessAndLogOutput (Notice, Error) $
119− proc cp
90+ proc "cp"
120 [ "-r"
91 [ "-r"
121 , "--preserve=links"
92 , "--preserve=links"
122 , obDir
93 , obDir
@@ -126,7 +97,7 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
126
97
127 withSpinner "Copying project skeleton" $ do
98 withSpinner "Copying project skeleton" $ do
128 callProcessAndLogOutput (Notice, Error) $
99 callProcessAndLogOutput (Notice, Error) $
129− proc cp
100+ proc "cp"
130 [ "-r"
101 [ "-r"
131 , "--no-preserve=mode"
102 , "--no-preserve=mode"
132 , "-T"
103 , "-T"
@@ -137,46 +108,21 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
137 let configDir = "config"
108 let configDir = "config"
138 createDirectoryIfMissing False configDir
109 createDirectoryIfMissing False configDir
139 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
110 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
140− putLog Notice $ T.intercalate "\n"
141− [ "An obelisk project has been successfully initialized. Next steps:"
142− , " 'ob run': Start a development server"
143− , " 'ob watch': Watch for changes without starting a server"
144− , " 'ob repl': Load your project into GHCi"
145− ]
146−
147−callHandoffOb
148− :: MonadObelisk m
149− => FilePath -- ^ Directory of the obelisk we want to handoff to
150− -> [String] -- ^ Arguments to pass to ob
151− -> m ()
152−callHandoffOb dir args = do
153− obeliskCommandPkg <- nixCmd $ NixCmd_Build $ def
154− & nixBuildConfig_outLink .~ OutLink_None
155− & nixCmdConfig_target .~ Target
156− { _target_path = Just dir
157− , _target_attr = Just "command"
158− , _target_expr = Nothing
159− }
160− let impl = obeliskCommandPkg </> "bin" </> "ob"
161− -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
162− putLog Debug $ "Running '" <> T.pack (unwords args) <> "' with " <> T.pack impl
163− callProcessAndLogOutput (Debug, Warning) (proc impl ("--no-handoff" : args))
164
111
165--TODO: Allow the user to ignore our security concerns
112--TODO: Allow the user to ignore our security concerns
166-- | Find the Obelisk implementation for the project at the given path
113-- | Find the Obelisk implementation for the project at the given path
167findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
114findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
168findProjectObeliskCommand target = do
115findProjectObeliskCommand target = do
169 myUid <- liftIO getRealUserID
116 myUid <- liftIO getRealUserID
170− processUmask <- liftIO getUmask
171 targetStat <- liftIO $ getFileStatus target
117 targetStat <- liftIO $ getFileStatus target
172− (result, insecurePaths) <- flip runStateT [] $ walkToProjectRoot target targetStat processUmask myUid >>= \case
118+ (result, insecurePaths) <- flip runStateT [] $ walkToProjectRoot target targetStat myUid >>= \case
173 Nothing -> pure Nothing
119 Nothing -> pure Nothing
174 Just projectRoot -> liftIO (doesDirectoryExist $ toImplDir projectRoot) >>= \case
120 Just projectRoot -> liftIO (doesDirectoryExist $ toImplDir projectRoot) >>= \case
175 False -> do
121 False -> do
176 putLog Warning $ "Found obelisk directory in " <> T.pack projectRoot <> " but the implementation (impl) file is missing"
122 putLog Warning $ "Found obelisk directory in " <> T.pack projectRoot <> " but the implementation (impl) file is missing"
177 pure Nothing
123 pure Nothing
178 True -> do
124 True -> do
179− walkToImplDir projectRoot myUid processUmask -- For security check
125+ walkToImplDir projectRoot myUid -- For security check
180 return $ Just projectRoot
126 return $ Just projectRoot
181 case (result, insecurePaths) of
127 case (result, insecurePaths) of
182 (Just projDir, []) -> do
128 (Just projDir, []) -> do
@@ -187,37 +133,17 @@ findProjectObeliskCommand target = do
187 putLog Error $ T.unlines
133 putLog Error $ T.unlines
188 [ "Error: Found a project at " <> T.pack (normalise projDir) <> ", but had to traverse one or more insecure directories to get there:"
134 [ "Error: Found a project at " <> T.pack (normalise projDir) <> ", but had to traverse one or more insecure directories to get there:"
189 , T.unlines $ fmap (T.pack . normalise) insecurePaths
135 , T.unlines $ fmap (T.pack . normalise) insecurePaths
190− , "Please ensure that all of these directories are owned by you, not world-writable, and no more group-writable than permitted by your umask."
136+ , "Please ensure that all of these directories are owned by you and are not writable by anyone else."
191 ]
137 ]
192 return Nothing
138 return Nothing
193
139
194−-- | Get the umask for the Obelisk process.
195−--
196−-- Because of
197−-- http://man7.org/linux/man-pages/man2/umask.2.html#NOTES we have to set the
198−-- umask to read it. We are using 'withMVarMasked' to guarantee that setting and
199−-- reading isn't interrupted by any exception or interleaved with another thread.
200−getUmask :: IO FileMode
201−getUmask = withMVarMasked globalUmaskLock $ \() -> do
202− initialMask <- setFileCreationMask safeUmask
203− void (setFileCreationMask initialMask)
204− pure initialMask
205− where
206− safeUmask :: FileMode
207− safeUmask = CMode 0o22
208−
209−{-# NOINLINE globalUmaskLock #-}
210−globalUmaskLock :: MVar ()
211−globalUmaskLock = unsafePerformIO (newMVar ())
212−
213-- | Get the FilePath to the containing project directory, if there is one
140-- | Get the FilePath to the containing project directory, if there is one
214findProjectRoot :: MonadObelisk m => FilePath -> m (Maybe FilePath)
141findProjectRoot :: MonadObelisk m => FilePath -> m (Maybe FilePath)
215findProjectRoot target = do
142findProjectRoot target = do
216 myUid <- liftIO getRealUserID
143 myUid <- liftIO getRealUserID
217 targetStat <- liftIO $ getFileStatus target
144 targetStat <- liftIO $ getFileStatus target
218− umask <- liftIO getUmask
219− (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat umask myUid) []
145+ (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat myUid) []
220− return $ makeRelative "." <$> result
146+ return result
221
147
222withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
148withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
223withProjectRoot target f = findProjectRoot target >>= \case
149withProjectRoot target f = findProjectRoot target >>= \case
@@ -229,15 +155,15 @@ withProjectRoot target f = findProjectRoot target >>= \case
229-- traversed in the process. Return the project root directory, if found.
155-- traversed in the process. Return the project root directory, if found.
230walkToProjectRoot
156walkToProjectRoot
231 :: (MonadState [FilePath] m, MonadIO m)
157 :: (MonadState [FilePath] m, MonadIO m)
232− => FilePath -> FileStatus -> FileMode -> UserID -> m (Maybe FilePath)
158+ => FilePath -> FileStatus -> UserID -> m (Maybe FilePath)
233−walkToProjectRoot this thisStat desiredUmask myUid = liftIO (doesDirectoryExist this) >>= \case
159+walkToProjectRoot this thisStat myUid = liftIO (doesDirectoryExist this) >>= \case
234 -- It's not a directory, so it can't be a project
160 -- It's not a directory, so it can't be a project
235 False -> do
161 False -> do
236 let dir = takeDirectory this
162 let dir = takeDirectory this
237 dirStat <- liftIO $ getFileStatus dir
163 dirStat <- liftIO $ getFileStatus dir
238− walkToProjectRoot dir dirStat desiredUmask myUid
164+ walkToProjectRoot dir dirStat myUid
239 True -> do
165 True -> do
240− when (not $ isWellOwnedAndWellPermissioned thisStat myUid desiredUmask) $ modify (this:)
166+ when (not $ isWritableOnlyBy thisStat myUid) $ modify (this:)
241 liftIO (doesDirectoryExist $ toObeliskDir this) >>= \case
167 liftIO (doesDirectoryExist $ toObeliskDir this) >>= \case
242 True -> return $ Just this
168 True -> return $ Just this
243 False -> do
169 False -> do
@@ -247,109 +173,48 @@ walkToProjectRoot this thisStat desiredUmask myUid = liftIO (doesDirectoryExist
247 isSameFileAs = (==) `on` fileIdentity
173 isSameFileAs = (==) `on` fileIdentity
248 if thisStat `isSameFileAs` nextStat
174 if thisStat `isSameFileAs` nextStat
249 then return Nothing -- Found a cycle; probably hit root directory
175 then return Nothing -- Found a cycle; probably hit root directory
250− else walkToProjectRoot next nextStat desiredUmask myUid
176+ else walkToProjectRoot next nextStat myUid
251
177
252-- | Walk from the given project root directory to its Obelisk implementation
178-- | Walk from the given project root directory to its Obelisk implementation
253-- directory, accumulating potentially insecure directories that were traversed
179-- directory, accumulating potentially insecure directories that were traversed
254-- in the process.
180-- in the process.
255−walkToImplDir :: (MonadState [FilePath] m, MonadIO m) => FilePath -> UserID -> FileMode -> m ()
181+walkToImplDir :: (MonadState [FilePath] m, MonadIO m) => FilePath -> UserID -> m ()
256−walkToImplDir projectRoot myUid umask = do
182+walkToImplDir projectRoot myUid = do
257 let obDir = toObeliskDir projectRoot
183 let obDir = toObeliskDir projectRoot
258 obDirStat <- liftIO $ getFileStatus obDir
184 obDirStat <- liftIO $ getFileStatus obDir
259− when (not $ isWellOwnedAndWellPermissioned obDirStat myUid umask) $ modify (obDir:)
185+ when (not $ isWritableOnlyBy obDirStat myUid) $ modify (obDir:)
260 let implThunk = obDir </> "impl"
186 let implThunk = obDir </> "impl"
261 implThunkStat <- liftIO $ getFileStatus implThunk
187 implThunkStat <- liftIO $ getFileStatus implThunk
262− when (not $ isWellOwnedAndWellPermissioned implThunkStat myUid umask) $ modify (implThunk:)
188+ when (not $ isWritableOnlyBy implThunkStat myUid) $ modify (implThunk:)
263−
189+
190+--TODO: Is there a better way to ask if anyone else can write things?
191+--E.g. what about ACLs?
264−-- | Check to see if directory is writable by a user whose User ID matches the
192+-- | Check to see if directory is only writable by a user whose User ID matches the second argument provided
265−-- second argument provided, and if the fact that other people can write to that
266−-- directory is in accordance with the umask of the system, passed as the third
267−-- argument.
268−isWellOwnedAndWellPermissioned :: FileStatus -> UserID -> FileMode -> Bool
193+isWritableOnlyBy :: FileStatus -> UserID -> Bool
269−isWellOwnedAndWellPermissioned s uid umask = isOwnedBy s uid && filePermissionIsSafe s umask
270−
271−isOwnedBy :: FileStatus -> UserID -> Bool
272−isOwnedBy s uid = fileOwner s == uid
194+isWritableOnlyBy s uid = fileOwner s == uid && fileMode s .&. 0o22 == 0
273−
195+
274−-- | Check to see if a directory respect the umask, but check explicitly that
196+-- | Run a command in the given shell for the current project
275−-- it's not world writable in any case.
197+inProjectShell :: MonadObelisk m => String -> String -> m ()
276−filePermissionIsSafe :: FileStatus -> FileMode -> Bool
198+inProjectShell shellName command = withProjectRoot "." $ \root ->
277−filePermissionIsSafe s umask = not fileWorldWritable && fileGroupWritable <= umaskGroupWritable
199+ projectShell root True shellName (Just command)
278− where
200+
279− fileWorldWritable = fileMode s .&. 0o002 == 0o002
201+inImpureProjectShell :: MonadObelisk m => String -> String -> m ()
280− fileGroupWritable = fileMode s .&. 0o020 == 0o020
202+inImpureProjectShell shellName command = withProjectRoot "." $ \root ->
281− umaskGroupWritable = umask .&. 0o020 == 0
203+ projectShell root False shellName (Just command)
282−
204+
283−nixShellRunConfig :: MonadObelisk m => FilePath -> Bool -> Maybe String -> m NixShellConfig
205+projectShell :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
284−nixShellRunConfig root isPure command = do
206+projectShell root isPure shellName command = do
285− nixpkgsPath <- fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $
207+ (_, _, _, ph) <- createProcess_ "runNixShellAttr" $ setCtlc $ setCwd (Just root) $ proc "nix-shell" $
286− proc nixExePath ["eval", "(import .obelisk/impl {}).nixpkgs.path"]
208+ [ "--pure" | isPure ] <>
287− nixRemote <- liftIO $ lookupEnv "NIX_REMOTE"
209+ [ "-A"
288− pure $ def
210+ , "shells." <> shellName
289− & nixShellConfig_pure .~ isPure
211+ ] <> case command of
290− & nixShellConfig_common . nixCmdConfig_target .~ (def & target_path .~ Nothing)
212+ Nothing -> []
291− & nixShellConfig_run .~ (command <&> \cs -> unwords $ concat
213+ Just c -> ["--run", c]
292− [ ["export", BSU.toString . bytes . bash $ "NIX_PATH=nixpkgs=" <> encodeUtf8 nixpkgsPath, ";"]
214+ void $ liftIO $ waitForProcess ph
293− , maybe [] (\v -> ["export", BSU.toString . bytes . bash $ "NIX_REMOTE=" <> encodeUtf8 (T.pack v), ";"]) nixRemote
215+
294− , [cs]
216+setCtlc :: CreateProcess -> CreateProcess
295− ])
217+setCtlc cfg = cfg { delegate_ctlc = True }
296−
218+
297−bashEscape :: String -> String
219+setCwd :: Maybe FilePath -> CreateProcess -> CreateProcess
298−bashEscape = BSU.toString . bytes . bash . BSU.fromString
220+setCwd fp cfg = cfg { cwd = fp }
299−
300−nixShellRunProc :: NixShellConfig -> ProcessSpec
301−nixShellRunProc cfg = setDelegateCtlc True $ proc nixShellPath $ runNixShellConfig cfg
302−
303−nixShellWithoutPkgs
304− :: MonadObelisk m
305− => FilePath -- ^ Path to project root
306− -> Bool -- ^ Should this be a pure shell?
307− -> Bool -- ^ Should we chdir to the package root in the shell?
308− -> Map Text FilePath -- ^ Package names mapped to their paths
309− -> String -- ^ Shell attribute to use (e.g. @"ghc"@, @"ghcjs"@, etc.)
310− -> Maybe String -- ^ If 'Just' run the given command; otherwise just open the interactive shell
311− -> m ()
312−nixShellWithoutPkgs root isPure chdirToRoot packageNamesAndPaths shellAttr command = do
313− packageNamesAndAbsPaths <- liftIO $ for packageNamesAndPaths makeAbsolute
314− defShellConfig <- nixShellRunConfig root isPure command
315− let setCwd_ = if chdirToRoot then setCwd (Just root) else id
316− runProcess_ $ setCwd_ $ nixShellRunProc $ defShellConfig
317− & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
318− "{root, pkgs, shell}: ((import root {}).passthru.__unstable__.self.extend (_: _: {\
319− \shellPackages = builtins.fromJSON pkgs;\
320− \})).project.shells.${shell}"
321− & nixShellConfig_common . nixCmdConfig_args .~
322− [ rawArg "root" $ toNixPath $ if chdirToRoot then "." else root
323− , strArg "pkgs" (T.unpack $ decodeUtf8 $ BSL.toStrict $ Json.encode packageNamesAndAbsPaths)
324− , strArg "shell" shellAttr
325− ]
326−
327−nixShellWithHoogle :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
328−nixShellWithHoogle root isPure shell' command = do
329− defShellConfig <- nixShellRunConfig root isPure command
330− runProcess_ $ setCwd (Just root) $ nixShellRunProc $ defShellConfig
331− & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
332− "{shell}: ((import ./. {}).passthru.__unstable__.self.extend (_: super: {\
333− \userSettings = super.userSettings // { withHoogle = true; };\
334− \})).project.shells.${shell}"
335− & nixShellConfig_common . nixCmdConfig_args .~ [ strArg "shell" shell' ]
336−
337−findProjectAssets :: MonadObelisk m => FilePath -> m Text
338−findProjectAssets root = do
339− isDerivation <- readProcessAndLogStderr Debug $ setCwd (Just root) $
340− proc nixExePath
341− [ "eval"
342− , "(let a = import ./. {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
343− , "--raw"
344− -- `--raw` is not available with old nix-instantiate. It drops quotation
345− -- marks and trailing newline, so is very convenient for shelling out.
346− ]
347− -- Check whether the impure static files are a derivation (and so must be built)
348− if isDerivation == "1"
349− then fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $ -- Strip whitespace here because nix-build has no --raw option
350− proc nixBuildExePath
351− [ "--no-out-link"
352− , "-E", "(import ./. {}).passthru.staticFilesImpure"
353− ]
354− else readProcessAndLogStderr Debug $ setCwd (Just root) $
355− proc nixExePath ["eval", "-f", ".", "passthru.staticFilesImpure", "--raw"]
lib/command/src/Obelisk/Command/Run.hs+171−492
@@ -1,554 +1,233 @@
1−{-# LANGUAGE DeriveFoldable #-}
2−{-# LANGUAGE DeriveFunctor #-}
3−{-# LANGUAGE DeriveTraversable #-}
4{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
5{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE LambdaCase #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
8−{-# LANGUAGE QuasiQuotes #-}
9{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
10−{-# LANGUAGE TupleSections #-}
11−{-# LANGUAGE ViewPatterns #-}
12module Obelisk.Command.Run where
6module Obelisk.Command.Run where
13
7
14−import Control.Arrow ((&&&))
8+import Control.Exception (bracket)
15−import Control.Exception (Exception, bracket)
16−import Control.Lens (ifor, (.~), (&))
9+import Control.Monad
17−import Control.Monad (filterM)
18−import Control.Monad.Except (runExceptT, throwError)
19import Control.Monad.IO.Class (liftIO)
10import Control.Monad.IO.Class (liftIO)
20import Control.Monad.Reader (MonadIO)
11import Control.Monad.Reader (MonadIO)
21−import Data.Bifoldable (bifoldr1)
12+import Data.Either
22−import Data.Bifunctor (bimap)
13+import qualified Data.List as L
23−import Data.Coerce (coerce)
24−import Data.Default (def)
25−import Data.Either (partitionEithers)
26−import Data.Foldable (fold, for_, toList)
27−import Data.Functor.Identity (runIdentity)
28−import Data.List (intercalate)
29−import Data.List.NonEmpty (NonEmpty)
30import qualified Data.List.NonEmpty as NE
14import qualified Data.List.NonEmpty as NE
31−import Data.Map (Map)
15+import Data.Maybe
32−import qualified Data.Map as Map
33−import qualified Data.Map.Monoidal as MMap
34−import Data.Maybe (catMaybes, fromMaybe, mapMaybe)
35−import Data.Ord (comparing)
36−import Data.Set (Set)
37−import qualified Data.Set as Set
38−import Data.String.Here.Interpolated (i)
39−import Data.Text (Text)
40import qualified Data.Text as T
16import qualified Data.Text as T
41−import Data.Time.Clock (getCurrentTime)
42−import Data.Time.Format (formatTime, defaultTimeLocale)
43−import Data.Traversable (for)
44−import Debug.Trace (trace)
45−import Distribution.Compiler (CompilerFlavor(..))
46import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
17import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
47import Distribution.Parsec.ParseResult (runParseResult)
18import Distribution.Parsec.ParseResult (runParseResult)
48−import qualified Distribution.System as Dist
19+import Distribution.Pretty
49−import Distribution.Types.BuildInfo (buildable, cppOptions, defaultExtensions, defaultLanguage, hsSourceDirs, options)
20+import Distribution.Types.BuildInfo
50−import Distribution.Types.CondTree (simplifyCondTree)
21+import Distribution.Types.CondTree
51−import Distribution.Types.GenericPackageDescription (ConfVar (Arch, Impl, OS), condLibrary)
22+import Distribution.Types.GenericPackageDescription
52−import Distribution.Types.Library (libBuildInfo)
23+import Distribution.Types.Library
53−import Distribution.Utils.Generic (toUTF8BS, readUTF8File)
24+import Distribution.Utils.Generic
54−import qualified Distribution.Parsec.Common as Dist
55−import qualified Hpack.Config as Hpack
25+import Hpack.Config
56−import qualified Hpack.Render as Hpack
26+import Hpack.Render
57−import qualified Hpack.Yaml as Hpack
27+import Hpack.Yaml
58−import Language.Haskell.Extension (Extension, Language)
28+import Language.Haskell.Extension
59−import qualified Network.Socket as Socket
29+import Network.Socket hiding (Debug)
60import System.Directory
30import System.Directory
61−import System.Environment (getExecutablePath)
62import System.FilePath
31import System.FilePath
63−import qualified System.Info
32+import System.Process (proc)
64import System.IO.Temp (withSystemTempDirectory)
33import System.IO.Temp (withSystemTempDirectory)
34+import Data.ByteString (ByteString)
65
35
66−import Obelisk.App (MonadObelisk)
36+import Obelisk.App (MonadObelisk, ObeliskT)
67−import Obelisk.CliApp (
37+import Obelisk.CliApp
68− Severity (..),
38+ ( CliT (..), HasCliConfig, Severity (..)
69− failWith,
39+ , callCommand, failWith, getCliConfig, putLog
70− proc,
71− putLog,
72− readCreateProcessWithExitCode,
73− readProcessAndLogStderr,
40+ , readProcessAndLogStderr, runCli)
74− runProcess_,
75− setCwd,
76− setDelegateCtlc,
77− withSpinner,
78− )
79−import Obelisk.Command.Nix
80−import Obelisk.Command.Project (nixShellWithoutPkgs, withProjectRoot, findProjectAssets, bashEscape)
41+import Obelisk.Command.Project (inProjectShell, withProjectRoot)
81−import Obelisk.Command.Thunk (attrCacheFileName)
82−import Obelisk.Command.Utils (findExePath, ghcidExePath)
83
42
84data CabalPackageInfo = CabalPackageInfo
43data CabalPackageInfo = CabalPackageInfo
85− { _cabalPackageInfo_packageFile :: FilePath
86− , _cabalPackageInfo_packageName :: T.Text
87− , _cabalPackageInfo_packageRoot :: FilePath
44+ { _cabalPackageInfo_packageRoot :: FilePath
88− , _cabalPackageInfo_buildable :: Bool
89 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
45 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
90 -- ^ List of hs src dirs of the library component
46 -- ^ List of hs src dirs of the library component
91 , _cabalPackageInfo_defaultExtensions :: [Extension]
47 , _cabalPackageInfo_defaultExtensions :: [Extension]
92 -- ^ List of globally enable extensions of the library component
48 -- ^ List of globally enable extensions of the library component
93 , _cabalPackageInfo_defaultLanguage :: Maybe Language
49 , _cabalPackageInfo_defaultLanguage :: Maybe Language
94 -- ^ List of globally set languages of the library component
50 -- ^ List of globally set languages of the library component
95− , _cabalPackageInfo_compilerOptions :: [(CompilerFlavor, [String])]
96− -- ^ List of compiler-specific options (e.g., the "ghc-options" field of the cabal file)
97− , _cabalPackageInfo_cppOptions :: [String]
98− -- ^ List of CPP (C Preprocessor) options (e.g. the "cpp-options" field of the cabal file)
99 }
51 }
100
52
101−-- | 'Bool' with a better name for its purpose.
53+-- NOTE: `run` is not polymorphic like the rest because we use StaticPtr to invoke it.
102−data Interpret = Interpret_Interpret | Interpret_NoInterpret deriving (Eq, Ord, Show)
54+run :: ObeliskT IO ()
103−
55+run = do
104−textInterpret :: Interpret -> Text
56+ pkgs <- getLocalPkgs
105−textInterpret = \case
57+ withGhciScript pkgs $ \dotGhciPath -> do
106− Interpret_Interpret -> "Interpret"
58+ freePort <- getFreePort
107− Interpret_NoInterpret -> "NoInterpret"
59+ assets <- withProjectRoot "." $ \root -> do
108−
60+ let importableRoot = if "/" `isInfixOf` root
109−-- | Describe a set of 'FilePath's as a tree to facilitate merging them in a convenient way.
61+ then root
110−data PathTree a = PathTree_Node
62+ else "./" <> root
111− (Maybe a) -- An optional leaf at this point in the tree
63+ isDerivation <- readProcessAndLogStderr Debug $
112− (Map FilePath (PathTree a)) -- Branches to deeper leaves
64+ proc "nix"
113− deriving (Eq, Ord, Show, Functor, Foldable, Traversable)
65+ [ "eval"
114−
66+ , "-f"
115−-- | 2D ASCII drawing of a 'PathTree'. Adapted from Data.Tree.draw.
67+ , root
116−drawPathTree :: (a -> Text) -> PathTree a -> Text
68+ , "(let a = import " <> importableRoot <> " {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
117−drawPathTree showA (PathTree_Node _ ts0) = T.intercalate "\n" $ goForest (Map.toList ts0)
69+ , "--raw"
118− where
70+ -- `--raw` is not available with old nix-instantiate. It drops quotation
119− annotated ma = maybe id (\a b -> b <> " [" <> showA a <> "]") ma . T.pack
71+ -- marks and trailing newline, so is very convenient for shelling out.
120− goTree (fp, PathTree_Node ma forest) = annotated ma fp : goForest (Map.toList forest)
72+ ]
121− goForest [] = []
73+ -- Check whether the impure static files are a derivation (and so must be built)
122− goForest [tree] = shift "└─ " " " (goTree tree)
74+ if isDerivation == "1"
123− goForest (tree:forest) = shift "├─ " "│ " (goTree tree) <> goForest forest
124− shift first other = zipWith (<>) (first : repeat other)
125−
126−-- | Used to signal to obelisk that it's being invoked as a preprocessor
127−preprocessorIdentifier :: String
128−preprocessorIdentifier = "__preprocessor-apply-packages"
129−
130−profile
131− :: MonadObelisk m
132− => String
133− -> [String]
134− -> m ()
135−profile profileBasePattern rtsFlags = withProjectRoot "." $ \root -> do
136− putLog Debug "Using profiled build of project."
137−
138− outPath <- withSpinner "Building profiled executable" $
139− fmap (T.unpack . T.strip) $ readProcessAndLogStderr Debug $ setCwd (Just root) $ nixCmdProc $
75+ then fmap T.strip $ readProcessAndLogStderr Debug $ -- Strip whitespace here because nix-build has no --raw option
140− NixCmd_Build $ def
76+ proc "nix-build" ["-E", "(import " <> importableRoot <> "{}).passthru.staticFilesImpure"]
141− & nixBuildConfig_outLink .~ OutLink_None
77+ else readProcessAndLogStderr Debug $
142− & nixCmdConfig_target .~ Target
78+ proc "nix" ["eval", "-f", root, "passthru.staticFilesImpure", "--raw"]
143− { _target_path = Just "."
144− , _target_attr = Just "__unstable__.profiledObRun"
145− , _target_expr = Nothing
146− }
147− assets <- findProjectAssets root
148− putLog Debug $ "Assets impurely loaded from: " <> assets
149− time <- liftIO getCurrentTime
150− let profileBaseName = formatTime defaultTimeLocale profileBasePattern time
151− liftIO $ createDirectoryIfMissing True $ takeDirectory $ root </> profileBaseName
152− putLog Debug $ "Storing profiled data under base name of " <> T.pack (root </> profileBaseName)
153− freePort <- getFreePort
154− runProcess_ $ setCwd (Just root) $ setDelegateCtlc True $ proc (outPath </> "bin" </> "ob-run") $
155− [ show freePort
156− , T.unpack assets
157− , profileBaseName
158− , "+RTS"
159− , "-po" <> profileBaseName
160− ] <> rtsFlags
161− <> [ "-RTS" ]
162−
163−run :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
164−run root interpretPaths = do
165− pkgs <- getParsedLocalPkgs root interpretPaths
166− assets <- findProjectAssets root
167− putLog Debug $ "Assets impurely loaded from: " <> assets
79+ putLog Debug $ "Assets impurely loaded from: " <> assets
168− ghciArgs <- getGhciSessionSettings pkgs root True
169− freePort <- getFreePort
170− withGhciScriptArgs pkgs $ \dotGhciArgs -> do
171− runGhcid root True (ghciArgs <> dotGhciArgs) pkgs $ Just $ unwords
80+ runGhcid dotGhciPath $ Just $ unwords
172 [ "Obelisk.Run.run"
81 [ "Obelisk.Run.run"
173 , show freePort
82 , show freePort
174− , "(Obelisk.Run.runServeAsset " ++ show assets ++ ")"
83+ , "(runServeAsset " ++ show assets ++ ")"
175 , "Backend.backend"
84 , "Backend.backend"
176 , "Frontend.frontend"
85 , "Frontend.frontend"
177 ]
86 ]
178
87
179−runRepl :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
88+runRepl :: MonadObelisk m => m ()
180−runRepl root interpretPaths = do
89+runRepl = do
181− pkgs <- getParsedLocalPkgs root interpretPaths
90+ pkgs <- getLocalPkgs
182− ghciArgs <- getGhciSessionSettings pkgs "." True
91+ withGhciScript pkgs $ \dotGhciPath -> do
183− withGhciScriptArgs pkgs $ \dotGhciArgs ->
92+ runGhciRepl dotGhciPath
184− runGhciRepl root pkgs (ghciArgs <> dotGhciArgs)
185−
186−runWatch :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
187−runWatch root interpretPaths = do
188− pkgs <- getParsedLocalPkgs root interpretPaths
189− ghciArgs <- getGhciSessionSettings pkgs root True
190− withGhciScriptArgs pkgs $ \dotGhciArgs ->
191− runGhcid root True (ghciArgs <> dotGhciArgs) pkgs Nothing
192−
193−exportGhciConfig :: MonadObelisk m => Bool -> FilePath -> PathTree Interpret -> m [String]
194−exportGhciConfig useRelativePaths root interpretPaths = do
195− pkgs <- getParsedLocalPkgs root interpretPaths
196− getGhciSessionSettings pkgs "." useRelativePaths
197−
198−nixShellForInterpretPaths :: MonadObelisk m => Bool -> String -> FilePath -> PathTree Interpret -> Maybe String -> m ()
199−nixShellForInterpretPaths isPure shell root interpretPaths cmd = do
200− pkgs <- getParsedLocalPkgs root interpretPaths
201− nixShellWithoutPkgs root isPure False (packageInfoToNamePathMap pkgs) shell cmd
202
93
203−-- | Like 'getLocalPkgs' but also parses them and fails if any of them can't be parsed.
94+runWatch :: MonadObelisk m => m ()
204−getParsedLocalPkgs :: MonadObelisk m => FilePath -> PathTree Interpret -> m (NonEmpty CabalPackageInfo)
95+runWatch = do
205−getParsedLocalPkgs root interpretPaths = parsePackagesOrFail =<< getLocalPkgs root interpretPaths
96+ pkgs <- getLocalPkgs
97+ withGhciScript pkgs $ \dotGhciPath -> runGhcid dotGhciPath Nothing
206
98
207−-- | Relative paths to local packages of an obelisk project.
99+-- | Relative paths to local packages of an obelisk project
208−--
100+-- TODO a way to query this
209−-- These are a combination of the obelisk predefined local packages,
101+getLocalPkgs :: Applicative f => f [FilePath]
210−-- and any packages that the user has set with the @packages@ argument
102+getLocalPkgs = pure ["backend", "common", "frontend"]
211−-- to the Nix @project@ function.
212−getLocalPkgs :: forall m. MonadObelisk m => FilePath -> PathTree Interpret -> m (Set FilePath)
213−getLocalPkgs root interpretPaths = do
214− putLog Debug $ [i|Finding packages with root ${root} and interpret paths:|] <> "\n" <> drawPathTree textInterpret interpretPaths
215− obeliskPackagePaths <- runFind ["-L", root, "-name", ".obelisk", "-type", "d"]
216
103
217− -- We do not want to find packages that are embedded inside other obelisk projects, unless that
218− -- obelisk project is our own.
219− obeliskPackageExclusions <- liftIO $ fmap Set.fromList $ traverse canonicalizePath $
220− filter (/= root) $ map takeDirectory obeliskPackagePaths
221− putLog Debug [i|Excluding obelisk packages: ${T.pack $ unwords $ Set.toList obeliskPackageExclusions}|]
222− let rootsAndExclusions = calcIntepretFinds "" interpretPaths
223−
224− fmap fold $ for (MMap.toAscList rootsAndExclusions) $ \(interpretPathRoot, exclusions) ->
225− let allExclusions = obeliskPackageExclusions <> exclusions <> Set.singleton ("*" </> attrCacheFileName)
226− in fmap (Set.fromList . map normalise) $ runFind $
227− ["-L", interpretPathRoot, "(", "-name", "*.cabal", "-o", "-name", Hpack.packageConfig, ")", "-a", "-type", "f"]
228− <> concat [["-not", "-path", p </> "*"] | p <- toList allExclusions]
229− where
230− runFind args = do
231− (_exitCode, out, err) <- readCreateProcessWithExitCode $ proc findExePath args
232− putLog Debug $ T.strip $ T.pack err
233− pure $ map T.unpack $ T.lines $ T.strip $ T.pack out
234−
235−-- | Calculates a set of root 'FilePath's along with each one's corresponding set of exclusions.
236−-- This is used when constructing a set of @find@ commands to run to produce a set of packages
237−-- that matches the user's @--interpret@/@--no-interpret@ settings.
238−calcIntepretFinds :: FilePath -> PathTree Interpret -> MMap.MonoidalMap FilePath (Set FilePath)
239−calcIntepretFinds treeRoot0 tree0 = runIdentity $ go treeRoot0 tree0
240− where
241− go treeRoot tree = foldPathTreeFor (== Interpret_Interpret) treeRoot tree $ \parent children -> do
242− exclusions <- foldPathTreeFor (== Interpret_NoInterpret) parent children $ \parent' children' ->
243− pure $ Map.singleton parent' children'
244− deeperFinds <- Map.traverseWithKey go exclusions
245− pure $ MMap.singleton parent (Map.keysSet exclusions) <> fold (MMap.MonoidalMap deeperFinds)
246−
247−-- | Traverses a 'PathTree' and folds all leaves matching a given predicate.
248−foldPathTreeFor
249− :: forall m a b. (Applicative m, Monoid b)
250− => (a -> Bool)
251− -> FilePath
252− -> PathTree a
253− -> (FilePath -> PathTree a -> m b)
254− -> m b
255−foldPathTreeFor predicate parent children f = case children of
256− PathTree_Node (Just x) children' | predicate x -> f parent (PathTree_Node Nothing children')
257− PathTree_Node _ children' -> fmap fold $ flip Map.traverseWithKey children' $ \k children'' ->
258− foldPathTreeFor predicate (parent </> k) children'' f
259−
260−data GuessPackageFileError = GuessPackageFileError_Ambiguous [FilePath] | GuessPackageFileError_NotFound
261− deriving (Eq, Ord, Show)
262−instance Exception GuessPackageFileError
263−
264−newtype HPackFilePath = HPackFilePath { unHPackFilePath :: FilePath } deriving (Eq, Ord, Show)
265−newtype CabalFilePath = CabalFilePath { unCabalFilePath :: FilePath } deriving (Eq, Ord, Show)
266−
267−-- | Given a directory, try to guess what the appropriate @.cabal@ or @package.yaml@ file is for the package.
268−guessCabalPackageFile
269− :: (MonadIO m)
270− => FilePath -- ^ Directory or path to search for cabal package
271− -> m (Either GuessPackageFileError (Either CabalFilePath HPackFilePath))
272−guessCabalPackageFile pkg = do
273− liftIO (doesDirectoryExist pkg) >>= \case
274− False -> case cabalOrHpackFile pkg of
275− (Just hpack@(Right _)) -> pure $ Right hpack
276− (Just cabal@(Left (CabalFilePath cabalFilePath))) -> do
277− -- If the cabal file has a sibling hpack file, we use that instead
278− -- since running hpack often generates a sibling cabal file
279− let possibleHpackSibling = takeDirectory cabalFilePath </> Hpack.packageConfig
280− hasHpackSibling <- liftIO $ doesFileExist possibleHpackSibling
281− pure $ Right $ if hasHpackSibling then Right (HPackFilePath possibleHpackSibling) else cabal
282− Nothing -> pure $ Left GuessPackageFileError_NotFound
283− True -> do
284− candidates <- liftIO $
285− filterM (doesFileExist . either unCabalFilePath unHPackFilePath)
286− =<< mapMaybe (cabalOrHpackFile . (pkg </>)) <$> listDirectory pkg
287− pure $ case partitionEithers candidates of
288− ([hpack], _) -> Right $ Left hpack
289− ([], [cabal]) -> Right $ Right cabal
290− ([], []) -> Left GuessPackageFileError_NotFound
291− (hpacks, cabals) -> Left $ GuessPackageFileError_Ambiguous $ coerce hpacks <> coerce cabals
292−
293−cabalOrHpackFile :: FilePath -> Maybe (Either CabalFilePath HPackFilePath)
294−cabalOrHpackFile = \case
295− x | takeExtension x == ".cabal" -> Just (Left $ CabalFilePath x)
296− | takeFileName x == Hpack.packageConfig -> Just (Right $ HPackFilePath x)
297− | otherwise -> Nothing
298−
299−-- | Parses the cabal package in a given directory.
300−-- This automatically figures out which .cabal file or package.yaml (hpack) file to use in the given directory.
301parseCabalPackage
104parseCabalPackage
302− :: MonadObelisk m
105+ :: (MonadObelisk m)
303− => FilePath -- ^ Package directory
106+ => FilePath -- ^ package directory
304 -> m (Maybe CabalPackageInfo)
107 -> m (Maybe CabalPackageInfo)
305−parseCabalPackage dir = parseCabalPackage' dir >>= \case
108+parseCabalPackage dir = do
306− Left err -> Nothing <$ putLog Error err
109+ let cabalFp = dir </> (takeBaseName dir <> ".cabal")
307− Right (Just (warnings, pkgInfo)) -> do
110+ hpackFp = dir </> "package.yaml"
308− for_ warnings $ putLog Warning . T.pack . show
111+ hasCabal <- liftIO $ doesFileExist cabalFp
309− pure $ Just pkgInfo
112+ hasHpack <- liftIO $ doesFileExist hpackFp
310− Right Nothing -> pure Nothing
113+
311−
114+ mCabalContents <- if hasCabal
312−-- | Like 'parseCabalPackage' but returns errors and warnings directly so as to avoid 'MonadObelisk'.
115+ then Just <$> liftIO (readUTF8File cabalFp)
313−parseCabalPackage'
116+ else if hasHpack
314− :: (MonadIO m)
117+ then do
315− => FilePath -- ^ Package directory
316− -> m (Either T.Text (Maybe ([Dist.PWarning], CabalPackageInfo)))
317−parseCabalPackage' pkg = runExceptT $ do
318− (cabalContents, packageFile, packageName) <- guessCabalPackageFile pkg >>= \case
319− Left GuessPackageFileError_NotFound -> throwError $ "No .cabal or package.yaml file found in " <> T.pack pkg
320− Left (GuessPackageFileError_Ambiguous _) -> throwError $ "Unable to determine which .cabal file to use in " <> T.pack pkg
321− Right (Left (CabalFilePath file)) -> (, file, takeBaseName file) <$> liftIO (readUTF8File file)
322− Right (Right (HPackFilePath file)) -> do
323− let
324− decodeOptions = Hpack.DecodeOptions (Hpack.ProgramName "ob") file Nothing Hpack.decodeYaml
118+ let decodeOptions = DecodeOptions hpackFp Nothing decodeYaml
325− liftIO (Hpack.readPackageConfig decodeOptions) >>= \case
119+ liftIO (readPackageConfig decodeOptions) >>= \case
120+ Left err -> do
326− Left err -> throwError $ T.pack $ "Failed to parse " <> file <> ": " <> err
121+ putLog Error $ T.pack $ "Failed to parse " <> hpackFp <> ": " <> err
122+ return Nothing
327− Right (Hpack.DecodeResult hpackPackage _ _ _) -> pure (Hpack.renderPackage [] hpackPackage, file, Hpack.packageName hpackPackage)
123+ Right (DecodeResult hpackPackage _ _) -> do
328−
124+ return $ Just $ renderPackage [] hpackPackage
329− let
125+ else return Nothing
126+
127+ fmap join $ forM mCabalContents $ \cabalContents -> do
330− (warnings, result) = runParseResult $ parseGenericPackageDescription $ toUTF8BS cabalContents
128+ let (warnings, result) = runParseResult $ parseGenericPackageDescription $
331− osConfVar = case System.Info.os of
129+ toUTF8BS $ cabalContents
332− "linux" -> Just Dist.Linux
130+ mapM_ (putLog Warning) $ fmap (T.pack . show) warnings
333− "darwin" -> Just Dist.OSX
131+ case result of
334− _ -> trace "Unrecgonized System.Info.os" Nothing
132+ Right gpkg -> do
335− archConfVar = Just Dist.X86_64 -- TODO: Actually infer this
133+ return $ do
336− evalConfVar v = Right $ case v of
134+ (_, lib) <- simplifyCondTree (const $ pure True) <$> condLibrary gpkg
337− OS osVar -> Just osVar == osConfVar
338− Arch archVar -> Just archVar == archConfVar
339− Impl GHC _ -> True -- TODO: Actually check version range
340− _ -> False
341− case condLibrary <$> result of
342− Right (Just condLib) -> do
343− let (_, lib) = simplifyCondTree evalConfVar condLib
344− pure $ Just $ (warnings,) $ CabalPackageInfo
135+ pure $ CabalPackageInfo
345− { _cabalPackageInfo_packageName = T.pack packageName
346− , _cabalPackageInfo_packageFile = packageFile
347− , _cabalPackageInfo_packageRoot = takeDirectory packageFile
136+ { _cabalPackageInfo_packageRoot = takeDirectory cabalFp
348− , _cabalPackageInfo_buildable = buildable $ libBuildInfo lib
349− , _cabalPackageInfo_sourceDirs =
137+ , _cabalPackageInfo_sourceDirs =
350− fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
138+ fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
351− , _cabalPackageInfo_defaultExtensions =
139+ , _cabalPackageInfo_defaultExtensions =
352− defaultExtensions $ libBuildInfo lib
140+ defaultExtensions $ libBuildInfo lib
353− , _cabalPackageInfo_defaultLanguage =
141+ , _cabalPackageInfo_defaultLanguage =
354− defaultLanguage $ libBuildInfo lib
142+ defaultLanguage $ libBuildInfo lib
355− , _cabalPackageInfo_compilerOptions = options $ libBuildInfo lib
356− , _cabalPackageInfo_cppOptions = cppOptions $ libBuildInfo lib
357− }
143+ }
358− Right Nothing -> pure Nothing
359− Left (_, errors) ->
144+ Left (_, errors) -> do
360− throwError $ T.pack $ "Failed to parse " <> packageFile <> ":\n" <> unlines (map show errors)
145+ putLog Error $ T.pack $ "Failed to parse " <> cabalFp <> ":"
361−
146+ mapM_ (putLog Error) $ fmap (T.pack . show) errors
362−parsePackagesOrFail :: (MonadObelisk m, Foldable f) => f FilePath -> m (NE.NonEmpty CabalPackageInfo)
147+ return Nothing
363−parsePackagesOrFail dirs' = do
148+
364− packageInfos' <- fmap catMaybes $ for dirs $ \dir -> do
149+withUTF8FileContentsM :: (MonadIO m, HasCliConfig e m) => FilePath -> (ByteString -> CliT e IO a) -> m a
365− flip fmap (parseCabalPackage dir) $ \case
150+withUTF8FileContentsM fp f = do
366− Just packageInfo
151+ c <- getCliConfig
367− | _cabalPackageInfo_buildable packageInfo -> Just packageInfo
152+ liftIO $ withUTF8FileContents fp $ runCli c . f . toUTF8BS
368− _ -> Nothing
369−
370− -- Sort duplicate packages such that we prefer shorter paths, but fall back to alphabetical ordering.
371− let packagesByName = Map.map (NE.sortBy $ comparing $ \p -> let n = _cabalPackageInfo_packageFile p in (length n, n))
372− $ Map.fromListWith (<>) [(_cabalPackageInfo_packageName p, p NE.:| []) | p <- packageInfos']
373− unambiguous <- ifor packagesByName $ \packageName ps -> case ps of
374− p NE.:| [] -> pure p -- No ambiguity here
375− p NE.:| _ -> do
376− let chosenText = " [Chosen] "
377− prefix p'
378− | _cabalPackageInfo_packageFile p' == _cabalPackageInfo_packageFile p = chosenText
379− | otherwise = T.map (const ' ') chosenText
380− putLog Warning $ T.unlines $
381− "Packages named '" <> packageName <> "' appear in " <> T.pack (show $ length ps) <> " different locations: "
382− : map (\p' -> prefix p' <> T.pack (_cabalPackageInfo_packageFile p')) (toList ps)
383− pure p
384−
385− packageInfos <- case NE.nonEmpty $ toList unambiguous of
386− Nothing -> failWith $ T.pack $
387− "No valid, buildable packages found" <> (if null dirs then "" else " in " <> intercalate ", " dirs)
388− Just xs -> pure xs
389−
390− pure packageInfos
391− where
392− dirs = toList dirs'
393−
394−packageInfoToNamePathMap :: Foldable f => f CabalPackageInfo -> Map Text FilePath
395−packageInfoToNamePathMap = Map.fromList . map (_cabalPackageInfo_packageName &&& _cabalPackageInfo_packageRoot) . toList
396−
397−-- Like 'withGhciScript' but provides the precise ghci arguments to add to a ghci session
398−withGhciScriptArgs
399− :: (MonadObelisk m, Foldable f)
400− => f CabalPackageInfo -- ^ List of packages to load into ghci
401− -> ([String] -> m ()) -- ^ Action to run with the extra ghci arguments
402− -> m ()
403−withGhciScriptArgs packageInfos f = withGhciScript loadPreludeManually packageInfos $ \fp -> f ["-XNoImplicitPrelude", "-ghci-script", fp]
404− where
405− -- These lines must be first and allow the session to support a custom Prelude when @-XNoImplicitPrelude@
406− -- is passed to the ghci session.
407− loadPreludeManually =
408− [ ":add Prelude" -- @:add@ is used because it's less noisy when there is no custom Prelude
409− , ":set -XImplicitPrelude" -- Turn the default setting on
410− ]
411
153
412-- | Create ghci configuration to load the given packages
154-- | Create ghci configuration to load the given packages
413withGhciScript
155withGhciScript
414− :: (MonadObelisk m, Foldable f)
156+ :: MonadObelisk m
415− => [String] -- ^ Commands to prefix to file
416− -> f CabalPackageInfo -- ^ List of packages to load into ghci
157+ => [FilePath] -- ^ List of packages to load into ghci
417− -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporary .ghci
158+ -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporory .ghci
418 -> m ()
159 -> m ()
419−withGhciScript preCommands (toList -> packageInfos) f =
160+withGhciScript pkgs f = do
161+ (pkgDirErrs, packageInfos) <- fmap partitionEithers $ forM pkgs $ \pkg -> do
162+ flip fmap (parseCabalPackage pkg) $ \case
163+ Nothing -> Left pkg
164+ Just packageInfo -> Right packageInfo
165+
166+ when (null packageInfos) $
167+ failWith $ T.pack $ "No valid pkgs found in " <> intercalate ", " pkgs
168+ unless (null pkgDirErrs) $
169+ putLog Warning $ T.pack $ "Failed to find pkgs in " <> intercalate ", " pkgDirErrs
170+
171+ let extensions = packageInfos >>= _cabalPackageInfo_defaultExtensions
172+ languageFromPkgs = L.nub $ mapMaybe _cabalPackageInfo_defaultLanguage packageInfos
173+ -- NOTE when no default-language is present cabal sets Haskell98
174+ language = NE.toList $ fromMaybe (Haskell98 NE.:| []) $ NE.nonEmpty languageFromPkgs
175+ extensionsLine = if extensions == mempty
176+ then ""
177+ else ":set " <> intercalate " " ((("-X" <>) . prettyShow) <$> extensions)
178+ dotGhci = unlines $
179+ [ ":set -i" <> intercalate ":" (packageInfos >>= rootedSourceDirs)
180+ , extensionsLine
181+ , ":set " <> intercalate " " (("-X" <>) . prettyShow <$> language)
182+ , ":load Backend Frontend"
183+ , "import Obelisk.Run"
184+ , "import qualified Frontend"
185+ , "import qualified Backend"
186+ ]
187+ warnDifferentLanguages language
420 withSystemTempDirectory "ob-ghci" $ \fp -> do
188 withSystemTempDirectory "ob-ghci" $ \fp -> do
421 let dotGhciPath = fp </> ".ghci"
189 let dotGhciPath = fp </> ".ghci"
422 liftIO $ writeFile dotGhciPath dotGhci
190 liftIO $ writeFile dotGhciPath dotGhci
423 f dotGhciPath
191 f dotGhciPath
424− where
425− packageNames = Set.fromList $ map _cabalPackageInfo_packageName packageInfos
426− modulesToLoad = mconcat
427− [ [ "Obelisk.Run" | "obelisk-run" `Set.member` packageNames ]
428− , [ "Backend" | "backend" `Set.member` packageNames ]
429− , [ "Frontend" | "frontend" `Set.member` packageNames ]
430− ]
431− dotGhci = unlines $
432− preCommands <>
433− [ if null modulesToLoad then "" else ":load " <> unwords modulesToLoad
434− , "import qualified Obelisk.Run"
435− , "import qualified Frontend"
436− , "import qualified Backend"
437− ]
438−
439−-- | Builds a list of options to pass to ghci or set in .ghci file that configures
440−-- the preprocessor and source includes.
441−getGhciSessionSettings
442− :: (MonadObelisk m, Foldable f)
443− => f CabalPackageInfo -- ^ List of packages to load into ghci
444− -> FilePath -- ^ All paths will be relative to this path
445− -> Bool -- ^ Use relative paths
446− -> m [String]
447−getGhciSessionSettings (toList -> packageInfos) pathBase useRelativePaths = do
448− -- N.B. ghci settings do NOT support escaping in any way. To minimize the likelihood that
449− -- paths-with-spaces ruin our day, we first canonicalize everything, and then relativize
450− -- all paths to 'pathBase'.
451− selfExe <- liftIO $ canonicalizePath =<< getExecutablePath
452− canonicalPathBase <- liftIO $ canonicalizePath pathBase
453−
454− (pkgFiles, pkgSrcPaths :: [NonEmpty FilePath]) <- fmap unzip $ liftIO $ for packageInfos $ \pkg -> do
455− canonicalSrcDirs <- traverse canonicalizePath $ (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
456− canonicalPkgFile <- canonicalizePath $ _cabalPackageInfo_packageFile pkg
457− pure (canonicalPkgFile `relativeTo'` canonicalPathBase, (`relativeTo'` canonicalPathBase) <$> canonicalSrcDirs)
458
192
459− pure
460− $ baseGhciOptions
461− <> ["-F", "-pgmF", selfExe, "-optF", preprocessorIdentifier]
462− <> concatMap (\p -> ["-optF", p]) pkgFiles
463− <> [ "-i" <> intercalate ":" (concatMap toList pkgSrcPaths) ]
464 where
193 where
465− relativeTo' = if useRelativePaths then relativeTo else const
194+ rootedSourceDirs pkg = NE.toList $
195+ (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
466
196
467−baseGhciOptions :: [String]
197+warnDifferentLanguages :: MonadObelisk m => [Language] -> m ()
468−baseGhciOptions =
198+warnDifferentLanguages (_:_:_) = putLog Warning "Different languages detected across packages which may result in errors when loading the repl"
469− [ "-ignore-dot-ghci"
199+warnDifferentLanguages _ = return ()
470− , "-no-user-package-db"
471− , "-package-env", "-"
472− ]
473
200
474-- | Run ghci repl
201-- | Run ghci repl
475runGhciRepl
202runGhciRepl
476− :: (MonadObelisk m, Foldable f)
203+ :: MonadObelisk m
477− => FilePath -- ^ Path to project root
204+ => FilePath -- ^ Path to .ghci
478− -> f CabalPackageInfo -- ^ Packages to keep unbuilt
479− -> [String] -- ^ GHCi arguments
480 -> m ()
205 -> m ()
481−runGhciRepl root (toList -> packages) ghciArgs =
206+runGhciRepl dotGhci = inProjectShell "ghc" $ unwords $ "ghci" : ["-no-user-package-db", "-ghci-script", dotGhci]
482− -- NOTE: We do *not* want to use $(staticWhich "ghci") here because we need the
483− -- ghc that is provided by the shell in the user's project.
484− nixShellWithoutPkgs root True False (packageInfoToNamePathMap packages) "ghc" $
485− Just $ unwords $ fmap bashEscape $ "ghci" : ghciArgs
486
207
487-- | Run ghcid
208-- | Run ghcid
488runGhcid
209runGhcid
489− :: (MonadObelisk m, Foldable f)
210+ :: MonadObelisk m
490− => FilePath -- ^ Path to project root
211+ => FilePath -- ^ Path to .ghci
491− -> Bool -- ^ Should we chdir to root when running this process?
492− -> [String] -- ^ GHCi arguments
493− -> f CabalPackageInfo -- ^ Packages to keep unbuilt
494 -> Maybe String -- ^ Optional command to run at every reload
212 -> Maybe String -- ^ Optional command to run at every reload
495 -> m ()
213 -> m ()
496−runGhcid root chdirToRoot ghciArgs (toList -> packages) mcmd =
214+runGhcid dotGhci mcmd = callCommand $ unwords $ "ghcid" : opts
497− nixShellWithoutPkgs root True chdirToRoot (packageInfoToNamePathMap packages) "ghc" $
498− Just $ unwords $ fmap bashEscape $ ghcidExePath : opts
499 where
215 where
500− opts = concat
216+ opts =
501− [ ["-W"]
217+ [ "-W"
218+ --TODO: The decision of whether to use -fwarn-redundant-constraints should probably be made by the user
219+ , "--command='ghci -Wall -ignore-dot-ghci -fwarn-redundant-constraints -no-user-package-db -ghci-script " <> dotGhci <> "' "
220+ , "--reload=config"
502− , ["--outputfile=ghcid-output.txt"]
221+ , "--outputfile=ghcid-output.txt"
503− , map (\x -> "--reload=" <> x) reloadFiles
222+ ] <> testCmd
504− , map (\x -> "--restart=" <> x) restartFiles
223+ testCmd = maybeToList (flip fmap mcmd $ \cmd -> "--test='" <> cmd <> "'")
505− , maybe [] (\cmd -> ["--test=" <> cmd]) mcmd
224+
506− , ["--command=" <> unwords ("ghci" : ghciArgs)]
507− ]
508− adjustRoot x = if chdirToRoot then makeRelative root x else x
509− reloadFiles = map adjustRoot [root </> "config"]
510− restartFiles = map (adjustRoot . _cabalPackageInfo_packageFile) packages
511−
512−getFreePort :: MonadIO m => m Socket.PortNumber
225+getFreePort :: MonadIO m => m PortNumber
513−getFreePort = liftIO $ Socket.withSocketsDo $ do
226+getFreePort = liftIO $ withSocketsDo $ do
514− addr:_ <- Socket.getAddrInfo (Just Socket.defaultHints) (Just "127.0.0.1") (Just "0")
227+ addr:_ <- getAddrInfo (Just defaultHints) (Just "127.0.0.1") (Just "0")
515− bracket (open addr) Socket.close Socket.socketPort
228+ bracket (open addr) close socketPort
516 where
229 where
517 open addr = do
230 open addr = do
518− sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
231+ sock <- socket (addrFamily addr) (addrSocketType addr) (addrProtocol addr)
519− Socket.bind sock (Socket.addrAddress addr)
232+ bind sock (addrAddress addr)
520 return sock
233 return sock
521−
522−
523−-- | Convert a 'FilePath' into a 'PathTree'.
524−pathToTree :: a -> FilePath -> PathTree a
525−pathToTree a p = go $ splitDirectories p
526− where
527− go [] = PathTree_Node (Just a) mempty
528− go (x : xs) = PathTree_Node Nothing $ Map.singleton x $ go xs
529−
530−-- | Like 'zipWith' but pads with a padding value instead of stopping on the shortest list.
531−zipDefaultWith :: a -> b -> (a -> b -> c) -> [a] -> [b] -> [c]
532−zipDefaultWith _da _db _f [] [] = []
533−zipDefaultWith da db f (a:as) [] = f a db : zipDefaultWith da db f as []
534−zipDefaultWith da db f [] (b:bs) = f da b : zipDefaultWith da db f [] bs
535−zipDefaultWith da db f (a:as) (b:bs) = f a b : zipDefaultWith da db f as bs
536−
537−-- | Makes the first absolute path relative to the second absolute path.
538−--
539−-- Both input paths MUST be absolute.
540−--
541−-- Unlike 'makeRelative' this does not merely strip prefixes. It will introduce
542−-- enough @..@ paths to make the resulting path truly relative in virtually every
543−-- case. The only exception is on Windows when the two paths are on different
544−-- drives. In this case the resulting path may be absolute.
545−relativeTo :: FilePath -> FilePath -> FilePath
546−relativeTo dir base
547− = bifoldr1 (</>)
548− $ bimap (collapse . (".." <$) . catMaybes) (collapse . catMaybes)
549− $ unzip
550− $ dropWhile (\(a,b) -> a == b)
551− $ zipDefaultWith Nothing Nothing (,)
552− (map Just $ splitDirectories base)
553− (map Just $ splitDirectories dir)
554− where collapse = foldr (</>) ""
lib/command/src/Obelisk/Command/Thunk.hs+359−615
@@ -5,59 +5,71 @@
5{-# LANGUAGE MultiWayIf #-}
5{-# LANGUAGE MultiWayIf #-}
6{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE PatternGuards #-}
7{-# LANGUAGE PatternGuards #-}
8−{-# LANGUAGE QuasiQuotes #-}
9{-# LANGUAGE ScopedTypeVariables #-}
8{-# LANGUAGE ScopedTypeVariables #-}
10{-# LANGUAGE TypeApplications #-}
9{-# LANGUAGE TypeApplications #-}
11−module Obelisk.Command.Thunk where
10+module Obelisk.Command.Thunk
11+ ( ThunkPtr (..)
12+ , ThunkRev (..)
13+ , ThunkSource (..)
14+ , ThunkData (..)
15+ , ReadThunkError (..)
16+ , GitHubSource (..)
17+ , getThunkGitBranch
18+ , getLatestRev
19+ , updateThunkToLatest
20+ , createThunk
21+ , createThunkWithLatest
22+ , nixBuildAttrWithCache
23+ , nixBuildThunkAttrWithCache
24+ , unpackThunk
25+ , packThunk
26+ , readThunk
27+ , updateThunk
28+ , getThunkPtr
29+ , parseGitUri
30+ , uriThunkPtr
31+ ) where
12
32
13import Control.Applicative
33import Control.Applicative
14import Control.Exception (displayException, try)
34import Control.Exception (displayException, try)
15−import Control.Lens (ifor, ifor_, (.~))
35+import qualified Control.Lens as Lens
36+import Control.Lens.Indexed hiding ((<.>))
16import Control.Monad
37import Control.Monad
17−import Control.Monad.Extra (findM)
38+import Control.Monad.Catch (handle)
18−import Control.Monad.Catch (MonadCatch, handle)
19import Control.Monad.Except
39import Control.Monad.Except
20import Data.Aeson ((.=))
40import Data.Aeson ((.=))
21import qualified Data.Aeson as Aeson
41import qualified Data.Aeson as Aeson
22import Data.Aeson.Encode.Pretty
42import Data.Aeson.Encode.Pretty
23import qualified Data.Aeson.Types as Aeson
43import qualified Data.Aeson.Types as Aeson
24−import Data.Bifunctor (first)
25import qualified Data.ByteString.Lazy as LBS
44import qualified Data.ByteString.Lazy as LBS
26−import Data.Containers.ListUtils (nubOrd)
27import Data.Default
45import Data.Default
28import Data.Either.Combinators (fromRight', rightToMaybe)
46import Data.Either.Combinators (fromRight', rightToMaybe)
29−import Data.Foldable (toList)
30−import Data.Function ((&))
31−import Data.Functor ((<&>))
32import Data.Git.Ref (Ref)
47import Data.Git.Ref (Ref)
33import qualified Data.Git.Ref as Ref
48import qualified Data.Git.Ref as Ref
34import qualified Data.List as L
49import qualified Data.List as L
35−import Data.List.NonEmpty (NonEmpty (..), nonEmpty)
50+import Data.List.NonEmpty (NonEmpty (..))
36import qualified Data.List.NonEmpty as NonEmpty
51import qualified Data.List.NonEmpty as NonEmpty
37import Data.Map (Map)
52import Data.Map (Map)
38import qualified Data.Map as Map
53import qualified Data.Map as Map
39import Data.Maybe
54import Data.Maybe
40import Data.Set (Set)
55import Data.Set (Set)
41import qualified Data.Set as Set
56import qualified Data.Set as Set
42−import Data.String.Here.Interpolated (i)
43−import Data.String.Here.Uninterpolated (here)
44import Data.Text (Text)
57import Data.Text (Text)
45import qualified Data.Text as T
58import qualified Data.Text as T
46import Data.Text.Encoding
59import Data.Text.Encoding
47import qualified Data.Text.IO as T
60import qualified Data.Text.IO as T
48import Data.Time.Clock.POSIX (posixSecondsToUTCTime)
61import Data.Time.Clock.POSIX (posixSecondsToUTCTime)
49−import Data.Traversable (for)
50import Data.Yaml (parseMaybe)
62import Data.Yaml (parseMaybe)
51import GitHub
63import GitHub
52import GitHub.Data.Name
64import GitHub.Data.Name
53import Obelisk.Command.Nix
65import Obelisk.Command.Nix
54import System.Directory
66import System.Directory
55−import System.Exit
56import System.FilePath
67import System.FilePath
57import System.IO.Error
68import System.IO.Error
58import System.IO.Temp
69import System.IO.Temp
59−import System.PosixCompat.Files (getSymbolicLinkStatus, modificationTime)
70+import System.Posix (getSymbolicLinkStatus, modificationTime)
60−import qualified Text.URI as URI
71+import System.Process (proc)
72+import Text.URI
61
73
62import Obelisk.App (MonadObelisk)
74import Obelisk.App (MonadObelisk)
63import Obelisk.CliApp
75import Obelisk.CliApp
@@ -65,10 +77,11 @@ import Obelisk.Command.Utils
65
77
66--TODO: Support symlinked thunk data
78--TODO: Support symlinked thunk data
67data ThunkData
79data ThunkData
68− = ThunkData_Packed ThunkSpec ThunkPtr
80+ = ThunkData_Packed ThunkPtr
69 -- ^ Packed thunk
81 -- ^ Packed thunk
70− | ThunkData_Checkout
82+ | ThunkData_Checkout (Maybe ThunkPtr)
71 -- ^ Checked out thunk that was unpacked from this pointer
83 -- ^ Checked out thunk that was unpacked from this pointer
84+ deriving (Show, Eq, Ord)
72
85
73-- | A reference to the exact data that a thunk should translate into
86-- | A reference to the exact data that a thunk should translate into
74data ThunkPtr = ThunkPtr
87data ThunkPtr = ThunkPtr
@@ -81,7 +94,7 @@ type NixSha256 = Text --TODO: Use a smart constructor and make this actually ver
81
94
82-- | A specific revision of data; it may be available from multiple sources
95-- | A specific revision of data; it may be available from multiple sources
83data ThunkRev = ThunkRev
96data ThunkRev = ThunkRev
84− { _thunkRev_commit :: Ref Ref.SHA1
97+ { _thunkRev_commit :: Ref
85 , _thunkRev_nixSha256 :: NixSha256
98 , _thunkRev_nixSha256 :: NixSha256
86 }
99 }
87 deriving (Show, Eq, Ord)
100 deriving (Show, Eq, Ord)
@@ -94,72 +107,41 @@ data ThunkSource
94 | ThunkSource_Git GitSource
107 | ThunkSource_Git GitSource
95 deriving (Show, Eq, Ord)
108 deriving (Show, Eq, Ord)
96
109
97−thunkSourceToGitSource :: ThunkSource -> GitSource
98−thunkSourceToGitSource = \case
99− ThunkSource_GitHub s -> forgetGithub False s
100− ThunkSource_Git s -> s
101−
102data GitHubSource = GitHubSource
110data GitHubSource = GitHubSource
103 { _gitHubSource_owner :: Name Owner
111 { _gitHubSource_owner :: Name Owner
104 , _gitHubSource_repo :: Name Repo
112 , _gitHubSource_repo :: Name Repo
105 , _gitHubSource_branch :: Maybe (Name Branch)
113 , _gitHubSource_branch :: Maybe (Name Branch)
106− , _gitHubSource_private :: Bool
107 }
114 }
108 deriving (Show, Eq, Ord)
115 deriving (Show, Eq, Ord)
109
116
110−newtype GitUri = GitUri { unGitUri :: URI.URI } deriving (Eq, Ord, Show)
111−
112−gitUriToText :: GitUri -> Text
113−gitUriToText (GitUri uri)
114− | (T.toLower . URI.unRText <$> URI.uriScheme uri) == Just "file"
115− , Just (_, path) <- URI.uriPath uri
116− = "/" <> T.intercalate "/" (map URI.unRText $ NonEmpty.toList path)
117− | otherwise = URI.render uri
118−
119data GitSource = GitSource
117data GitSource = GitSource
120− { _gitSource_url :: GitUri
118+ { _gitSource_url :: URI
121 , _gitSource_branch :: Maybe (Name Branch)
119 , _gitSource_branch :: Maybe (Name Branch)
122 , _gitSource_fetchSubmodules :: Bool
120 , _gitSource_fetchSubmodules :: Bool
123− , _gitSource_private :: Bool
124 }
121 }
125 deriving (Show, Eq, Ord)
122 deriving (Show, Eq, Ord)
126
123
127−newtype ThunkConfig = ThunkConfig
128− { _thunkConfig_private :: Maybe Bool
129− } deriving Show
130−
131−data ThunkUpdateConfig = ThunkUpdateConfig
132− { _thunkUpdateConfig_branch :: Maybe String
133− , _thunkUpdateConfig_config :: ThunkConfig
134− } deriving Show
135−
136−data ThunkPackConfig = ThunkPackConfig
137− { _thunkPackConfig_force :: Bool
138− , _thunkPackConfig_config :: ThunkConfig
139− } deriving Show
140−
141-- | Convert a GitHub source to a regular Git source. Assumes no submodules.
124-- | Convert a GitHub source to a regular Git source. Assumes no submodules.
142forgetGithub :: Bool -> GitHubSource -> GitSource
125forgetGithub :: Bool -> GitHubSource -> GitSource
143forgetGithub useSsh s = GitSource
126forgetGithub useSsh s = GitSource
144− { _gitSource_url = GitUri $ URI.URI
127+ { _gitSource_url = URI
145− { URI.uriScheme = Just $ fromRight' $ URI.mkScheme $ if useSsh then "ssh" else "https"
128+ { uriScheme = Just $ fromRight' $ mkScheme $ if useSsh then "ssh" else "https"
146− , URI.uriAuthority = Right $ URI.Authority
129+ , uriAuthority = Right $ Authority
147− { URI.authUserInfo = URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
130+ { authUserInfo = UserInfo (fromRight' $ mkUsername "git") Nothing
148 <$ guard useSsh
131 <$ guard useSsh
149− , URI.authHost = fromRight' $ URI.mkHost "github.com"
132+ , authHost = fromRight' $ mkHost "github.com"
150− , URI.authPort = Nothing
133+ , authPort = Nothing
151 }
134 }
152− , URI.uriPath = Just ( False
135+ , uriPath = Just ( False
153− , fromRight' . URI.mkPathPiece <$>
136+ , fromRight' . mkPathPiece <$>
154 untagName (_gitHubSource_owner s)
137 untagName (_gitHubSource_owner s)
155 :| [ untagName (_gitHubSource_repo s) <> ".git" ]
138 :| [ untagName (_gitHubSource_repo s) <> ".git" ]
156 )
139 )
157− , URI.uriQuery = []
140+ , uriQuery = []
158− , URI.uriFragment = Nothing
141+ , uriFragment = Nothing
159 }
142 }
160 , _gitSource_branch = _gitHubSource_branch s
143 , _gitSource_branch = _gitHubSource_branch s
161 , _gitSource_fetchSubmodules = False
144 , _gitSource_fetchSubmodules = False
162− , _gitSource_private = _gitHubSource_private s
163 }
145 }
164
146
165getThunkGitBranch :: ThunkPtr -> Maybe Text
147getThunkGitBranch :: ThunkPtr -> Maybe Text
@@ -167,26 +149,26 @@ getThunkGitBranch (ThunkPtr _ src) = fmap untagName $ case src of
167 ThunkSource_GitHub s -> _gitHubSource_branch s
149 ThunkSource_GitHub s -> _gitHubSource_branch s
168 ThunkSource_Git s -> _gitSource_branch s
150 ThunkSource_Git s -> _gitSource_branch s
169
151
170−commitNameToRef :: Name Commit -> Ref Ref.SHA1
152+commitNameToRef :: Name Commit -> Ref
171commitNameToRef (N c) = Ref.fromHex $ encodeUtf8 c
153commitNameToRef (N c) = Ref.fromHex $ encodeUtf8 c
172
154
173-- TODO: Use spinner here.
155-- TODO: Use spinner here.
174getNixSha256ForUriUnpacked
156getNixSha256ForUriUnpacked
175 :: MonadObelisk m
157 :: MonadObelisk m
176− => GitUri
158+ => URI
177 -> m NixSha256
159 -> m NixSha256
178getNixSha256ForUriUnpacked uri =
160getNixSha256ForUriUnpacked uri =
179− withExitFailMessage ("nix-prefetch-url: Failed to determine sha256 hash of URL " <> gitUriToText uri) $ do
161+ withExitFailMessage ("nix-prefetch-url: Failed to determine sha256 hash of URL " <> render uri) $ do
180 [hash] <- fmap T.lines $ readProcessAndLogOutput (Debug, Debug) $
162 [hash] <- fmap T.lines $ readProcessAndLogOutput (Debug, Debug) $
181− proc nixPrefetchUrlPath ["--unpack", "--type", "sha256", T.unpack $ gitUriToText uri]
163+ proc "nix-prefetch-url" ["--unpack" , "--type" , "sha256" , T.unpack $ render uri]
182 pure hash
164 pure hash
183
165
184−nixPrefetchGit :: MonadObelisk m => GitUri -> Text -> Bool -> m NixSha256
166+nixPrefetchGit :: MonadObelisk m => URI -> Text -> Bool -> m NixSha256
185nixPrefetchGit uri rev fetchSubmodules =
167nixPrefetchGit uri rev fetchSubmodules =
186− withExitFailMessage ("nix-prefetch-git: Failed to determine sha256 hash of Git repo " <> gitUriToText uri <> " at " <> rev) $ do
168+ withExitFailMessage ("nix-prefetch-git: Failed to determine sha256 hash of Git repo " <> render uri <> " at " <> rev) $ do
187 out <- readProcessAndLogStderr Debug $
169 out <- readProcessAndLogStderr Debug $
188− proc nixPrefetchGitPath $ filter (/="")
170+ proc "nix-prefetch-git" $ filter (/="")
189− [ "--url", T.unpack $ gitUriToText uri
171+ [ "--url", T.unpack $ render uri
190 , "--rev", T.unpack rev
172 , "--rev", T.unpack rev
191 , if fetchSubmodules then "--fetch-submodules" else ""
173 , if fetchSubmodules then "--fetch-submodules" else ""
192 , "--quiet"
174 , "--quiet"
@@ -198,117 +180,93 @@ nixPrefetchGit uri rev fetchSubmodules =
198
180
199--TODO: Pretty print these
181--TODO: Pretty print these
200data ReadThunkError
182data ReadThunkError
201− = ReadThunkError_UnrecognizedThunk
183+ = ReadThunkError_UnrecognizedFiles
202− | ReadThunkError_UnrecognizedPaths (NonEmpty FilePath)
184+ | ReadThunkError_AmbiguousFiles
203− | ReadThunkError_MissingPaths (NonEmpty FilePath)
185+ | ReadThunkError_UnrecognizedLoader Text
204− | ReadThunkError_UnparseablePtr FilePath String
186+ | ReadThunkError_UnparseablePtr LBS.ByteString
205− | ReadThunkError_FileError IOError
206− | ReadThunkError_FileDoesNotMatch FilePath Text
207− | ReadThunkError_UnrecognizedState String
208− | ReadThunkError_AmbiguousPackedState ThunkPtr ThunkPtr
209− deriving (Show)
187+ deriving (Show)
210−
188+
211−unpackedDirName :: FilePath
189+-- | Read a thunk and validate that it is only a thunk, either packed or unpacked.
212−unpackedDirName = "."
190+-- If the thunk is packed and additional data is present, fail.
213−
191+readThunk :: MonadObelisk m => FilePath -> m (Either ReadThunkError ThunkData)
214−attrCacheFileName :: FilePath
192+readThunk thunkDir = do
215−attrCacheFileName = ".attr-cache"
193+ files <- liftIO $ listDirectory thunkDir
216−
194+ case ".git" `elem` files of
217−-- | Specification for how a file in a thunk version works.
195+ True -> fmap ThunkData_Checkout <$> do
218−data ThunkFileSpec
196+ let origThunkPath = thunkDir </> ".git" </> "obelisk" </> "orig-thunk"
219− = ThunkFileSpec_Ptr (LBS.ByteString -> Either String ThunkPtr) -- ^ This file specifies 'ThunkPtr' data
197+ liftIO $ doesDirectoryExist origThunkPath >>= \case
220− | ThunkFileSpec_FileMatches Text -- ^ This file must match the given content exactly
198+ True -> fmap Just <$> readPackedThunk origThunkPath
221− | ThunkFileSpec_CheckoutIndicator -- ^ Existence of this directory indicates that the thunk is unpacked
199+ False -> return $ return Nothing
222− | ThunkFileSpec_AttrCache -- ^ This directory is an attribute cache
200+ False -> liftIO $ fmap ThunkData_Packed <$> readPackedThunk thunkDir
223−
201+
224−-- | Specification for how a set of files in a thunk version work.
202+data ThunkType = ThunkType
225−data ThunkSpec = ThunkSpec
203+ { _thunkType_loader :: FilePath
226− { _thunkSpec_name :: !Text
204+ , _thunkType_json :: FilePath
227− , _thunkSpec_files :: !(Map FilePath ThunkFileSpec)
205+ , _thunkType_optional :: Set FilePath
206+ , _thunkType_loaderVersions :: NonEmpty Text
207+ , _thunkType_parser :: Aeson.Object -> Aeson.Parser ThunkPtr
228 }
208 }
229
209
230−thunkSpecTypes :: NonEmpty (NonEmpty ThunkSpec)
210+gitHubThunkType :: ThunkType
231−thunkSpecTypes = gitThunkSpecs :| [gitHubThunkSpecs]
211+gitHubThunkType = ThunkType
232−
212+ { _thunkType_loader = "default.nix"
233−-- | Attempts to match a 'ThunkSpec' to a given directory.
213+ , _thunkType_json = "github.json"
234−matchThunkSpecToDir
214+ , _thunkType_optional = Set.fromList [".attr-cache"]
235− :: (MonadError ReadThunkError m, MonadIO m, MonadCatch m)
215+ , _thunkType_loaderVersions = gitHubStandaloneLoaders
236− => ThunkSpec -- ^ 'ThunkSpec' to match against the given files/directory
216+ , _thunkType_parser = parseThunkPtr $ \v ->
237− -> FilePath -- ^ Path to directory
217+ ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
238− -> Set FilePath -- ^ Set of file paths relative to the given directory
218+ }
239− -> m ThunkData
219+
240−matchThunkSpecToDir thunkSpec dir dirFiles = do
220+gitThunkType :: ThunkType
241− case nonEmpty (toList $ dirFiles `Set.difference` expectedPaths) of
221+gitThunkType = ThunkType
242− Just fs -> throwError $ ReadThunkError_UnrecognizedPaths $ (dir </>) <$> fs
222+ { _thunkType_loader = "default.nix"
243− Nothing -> pure ()
223+ , _thunkType_json = "git.json"
244− case nonEmpty (toList $ requiredPaths `Set.difference` dirFiles) of
224+ , _thunkType_optional = Set.fromList [".attr-cache"]
245− Just fs -> throwError $ ReadThunkError_MissingPaths $ (dir </>) <$> fs
225+ , _thunkType_loaderVersions = plainGitStandaloneLoaders
246− Nothing -> pure ()
226+ , _thunkType_parser = parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
247− datas <- fmap toList $ flip Map.traverseMaybeWithKey (_thunkSpec_files thunkSpec) $ \expectedPath -> \case
227+ }
248− ThunkFileSpec_AttrCache -> Nothing <$ dirMayExist expectedPath
228+
249− ThunkFileSpec_CheckoutIndicator -> liftIO (doesDirectoryExist (dir </> expectedPath)) <&> \case
229+thunkTypes :: [ThunkType]
250− False -> Nothing
230+thunkTypes = [gitThunkType, gitHubThunkType]
251− True -> Just ThunkData_Checkout
231+
252− ThunkFileSpec_FileMatches expectedContents -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
232+findThunkType :: [ThunkType] -> FilePath -> IO (Either ReadThunkError ThunkType)
253− actualContents <- liftIO (T.readFile $ dir </> expectedPath)
233+findThunkType types thunkDir = do
254− case T.strip expectedContents == T.strip actualContents of
234+ matches <- fmap catMaybes $ forM types $ \thunkType -> do
255− True -> pure Nothing
235+ let
256− False -> throwError $ ReadThunkError_FileDoesNotMatch (dir </> expectedPath) expectedContents
236+ expectedContents = Set.fromList $ (thunkDir </>) <$>
257− ThunkFileSpec_Ptr parser -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
237+ [ _thunkType_loader thunkType
258− let path = dir </> expectedPath
238+ , _thunkType_json thunkType
259− liftIO (doesFileExist path) >>= \case
239+ ]
260− False -> pure Nothing
240+ optionalContents = Set.map (thunkDir </>) (_thunkType_optional thunkType)
261− True -> do
241+
262− actualContents <- liftIO $ LBS.readFile path
242+ -- Ensure that there aren't any other files in the thunk
263− case parser actualContents of
243+ -- NB: System.Directory.listDirectory returns the contents without the directory path
264− Right v -> pure $ Just (ThunkData_Packed thunkSpec v)
244+ files <- liftIO $ Set.fromList . fmap (thunkDir </>) <$> listDirectory thunkDir
265− Left e -> throwError $ ReadThunkError_UnparseablePtr (dir </> expectedPath) e
245+ let unexpectedContents = files `Set.difference` (expectedContents `Set.union` optionalContents)
266−
246+ missingContents = expectedContents `Set.difference` files
267− case nonEmpty datas of
247+ pure $ if Set.null unexpectedContents && Set.null missingContents
268− Nothing -> throwError ReadThunkError_UnrecognizedThunk
248+ then Just thunkType
269− Just xs -> fold1WithM xs $ \a b -> either throwError pure (mergeThunkData a b)
249+ else Nothing
270− where
250+
271− rootPathsOnly = Set.fromList . mapMaybe takeRootDir . Map.keys
251+ pure $ case matches of
272− takeRootDir = fmap NonEmpty.head . nonEmpty . splitPath
252+ [singleMatch] -> Right singleMatch
273−
253+ [] -> Left ReadThunkError_UnrecognizedFiles
274− expectedPaths = rootPathsOnly $ _thunkSpec_files thunkSpec
254+ _ -> Left ReadThunkError_AmbiguousFiles
275−
276− requiredPaths = rootPathsOnly $ Map.filter isRequiredFileSpec $ _thunkSpec_files thunkSpec
277− isRequiredFileSpec = \case
278− ThunkFileSpec_FileMatches _ -> True
279− _ -> False
280−
281− dirMayExist expectedPath = liftIO (doesFileExist (dir </> expectedPath)) >>= \case
282− True -> throwError $ ReadThunkError_UnrecognizedPaths $ expectedPath :| []
283− False -> pure ()
284−
285− -- Combine 'ThunkData' from different files, preferring "Checkout" over "Packed"
286− mergeThunkData ThunkData_Checkout ThunkData_Checkout = Right ThunkData_Checkout
287− mergeThunkData ThunkData_Checkout ThunkData_Packed{} = Left bothPackedAndUnpacked
288− mergeThunkData ThunkData_Packed{} ThunkData_Checkout = Left bothPackedAndUnpacked
289− mergeThunkData a@(ThunkData_Packed _ ptrA) (ThunkData_Packed _ ptrB) =
290− if ptrA == ptrB then Right a else Left $ ReadThunkError_AmbiguousPackedState ptrA ptrB
291−
292− bothPackedAndUnpacked = ReadThunkError_UnrecognizedState "Both packed data and checkout present"
293−
294− fold1WithM (x :| xs) f = foldM f x xs
295−
296−readThunkWith
297− :: (MonadObelisk m)
298− => NonEmpty (NonEmpty ThunkSpec) -> FilePath -> m (Either ReadThunkError ThunkData)
299−readThunkWith specTypes dir = do
300− dirFiles <- Set.fromList <$> liftIO (listDirectory dir)
301− let specs = concatMap toList $ toList $ NonEmpty.transpose specTypes -- Interleave spec types so we try each one in a "fair" ordering
302− flip fix specs $ \loop -> \case
303− [] -> pure $ Left ReadThunkError_UnrecognizedThunk
304− spec:rest -> runExceptT (matchThunkSpecToDir spec dir dirFiles) >>= \case
305− Left e -> putLog Debug [i|Thunk specification ${_thunkSpec_name spec} did not match ${dir}: ${e}|] *> loop rest
306− x@(Right _) -> x <$ putLog Debug [i|Thunk specification ${_thunkSpec_name spec} matched ${dir}|]
307
255
308-- | Read a thunk and validate that it is exactly a packed thunk.
256-- | Read a thunk and validate that it is exactly a packed thunk.
309-- If additional data is present, fail.
257-- If additional data is present, fail.
310−readThunk :: (MonadObelisk m) => FilePath -> m (Either ReadThunkError ThunkData)
258+readPackedThunk :: FilePath -> IO (Either ReadThunkError ThunkPtr)
311−readThunk = readThunkWith thunkSpecTypes
259+readPackedThunk thunkDir = runExceptT $ do
260+ thunkType <- ExceptT $ findThunkType thunkTypes thunkDir
261+ -- Ensure that we recognize the thunk loader
262+ loader <- liftIO $ T.readFile $ thunkDir </> _thunkType_loader thunkType
263+ unless (loader `elem` _thunkType_loaderVersions thunkType) $ do
264+ throwError $ ReadThunkError_UnrecognizedLoader loader
265+
266+ txt <- liftIO $ LBS.readFile $ thunkDir </> _thunkType_json thunkType
267+ case parseMaybe (_thunkType_parser thunkType) =<< Aeson.decode txt of
268+ Nothing -> throwError $ ReadThunkError_UnparseablePtr txt
269+ Just ptr -> return ptr
312
270
313parseThunkPtr :: (Aeson.Object -> Aeson.Parser ThunkSource) -> Aeson.Object -> Aeson.Parser ThunkPtr
271parseThunkPtr :: (Aeson.Object -> Aeson.Parser ThunkSource) -> Aeson.Object -> Aeson.Parser ThunkPtr
314parseThunkPtr parseSrc v = do
272parseThunkPtr parseSrc v = do
@@ -328,12 +286,10 @@ parseGitHubSource v = do
328 owner <- v Aeson..: "owner"
286 owner <- v Aeson..: "owner"
329 repo <- v Aeson..: "repo"
287 repo <- v Aeson..: "repo"
330 branch <- v Aeson..:! "branch"
288 branch <- v Aeson..:! "branch"
331− private <- v Aeson..:? "private"
332 pure $ GitHubSource
289 pure $ GitHubSource
333 { _gitHubSource_owner = owner
290 { _gitHubSource_owner = owner
334 , _gitHubSource_repo = repo
291 , _gitHubSource_repo = repo
335 , _gitHubSource_branch = branch
292 , _gitHubSource_branch = branch
336− , _gitHubSource_private = fromMaybe False private
337 }
293 }
338
294
339parseGitSource :: Aeson.Object -> Aeson.Parser GitSource
295parseGitSource :: Aeson.Object -> Aeson.Parser GitSource
@@ -341,29 +297,25 @@ parseGitSource v = do
341 Just url <- parseGitUri <$> v Aeson..: "url"
297 Just url <- parseGitUri <$> v Aeson..: "url"
342 branch <- v Aeson..:! "branch"
298 branch <- v Aeson..:! "branch"
343 fetchSubmodules <- v Aeson..:! "fetchSubmodules"
299 fetchSubmodules <- v Aeson..:! "fetchSubmodules"
344− private <- v Aeson..:? "private"
345 pure $ GitSource
300 pure $ GitSource
346 { _gitSource_url = url
301 { _gitSource_url = url
347 , _gitSource_branch = branch
302 , _gitSource_branch = branch
348 , _gitSource_fetchSubmodules = fromMaybe False fetchSubmodules
303 , _gitSource_fetchSubmodules = fromMaybe False fetchSubmodules
349− , _gitSource_private = fromMaybe False private
350 }
304 }
351
305
352overwriteThunk :: MonadObelisk m => FilePath -> ThunkPtr -> m ()
306overwriteThunk :: MonadObelisk m => FilePath -> ThunkPtr -> m ()
353overwriteThunk target thunk = do
307overwriteThunk target thunk = do
354 -- Ensure that this directory is a valid thunk (i.e. so we aren't losing any data)
308 -- Ensure that this directory is a valid thunk (i.e. so we aren't losing any data)
355− readThunk target >>= \case
309+ Right _ <- readThunk target
356− Left e -> failWith [i|Invalid thunk at ${target}: ${e}|]
357− Right _ -> pure ()
358
310
359 --TODO: Is there a safer way to do this overwriting?
311 --TODO: Is there a safer way to do this overwriting?
360− liftIO $ removePathForcibly target
312+ liftIO $ removeDirectoryRecursive target
361− createThunk target $ Right thunk
313+ liftIO $ createThunk target thunk
362
314
363−thunkPtrToSpec :: ThunkPtr -> ThunkSpec
315+thunkPtrLoader :: ThunkPtr -> Text
364−thunkPtrToSpec thunk = case _thunkPtr_source thunk of
316+thunkPtrLoader thunk = case _thunkPtr_source thunk of
365− ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
317+ ThunkSource_GitHub _ -> NonEmpty.head gitHubStandaloneLoaders
366− ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
318+ ThunkSource_Git _ -> NonEmpty.head plainGitStandaloneLoaders
367
319
368-- It's important that formatting be very consistent here, because
320-- It's important that formatting be very consistent here, because
369-- otherwise when people update thunks, their patches will be messy
321-- otherwise when people update thunks, their patches will be messy
@@ -375,15 +327,13 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
375 , ("branch" .=) <$> _gitHubSource_branch s
327 , ("branch" .=) <$> _gitHubSource_branch s
376 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
328 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
377 , Just $ "sha256" .= _thunkRev_nixSha256 rev
329 , Just $ "sha256" .= _thunkRev_nixSha256 rev
378− , Just $ "private" .= _gitHubSource_private s
379 ]
330 ]
380 ThunkSource_Git s -> encodePretty' plainGitCfg $ Aeson.object $ catMaybes
331 ThunkSource_Git s -> encodePretty' plainGitCfg $ Aeson.object $ catMaybes
381− [ Just $ "url" .= gitUriToText (_gitSource_url s)
332+ [ Just $ "url" .= render (_gitSource_url s)
382 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
333 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
383 , ("branch" .=) <$> _gitSource_branch s
334 , ("branch" .=) <$> _gitSource_branch s
384 , Just $ "sha256" .= _thunkRev_nixSha256 rev
335 , Just $ "sha256" .= _thunkRev_nixSha256 rev
385 , Just $ "fetchSubmodules" .= _gitSource_fetchSubmodules s
336 , Just $ "fetchSubmodules" .= _gitSource_fetchSubmodules s
386− , Just $ "private" .= _gitSource_private s
387 ]
337 ]
388 where
338 where
389 githubCfg = defConfig
339 githubCfg = defConfig
@@ -404,84 +354,78 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
404 [ "url"
354 [ "url"
405 , "rev"
355 , "rev"
406 , "sha256"
356 , "sha256"
407− , "private"
408 , "fetchSubmodules"
357 , "fetchSubmodules"
409 ] <> compare
358 ] <> compare
410 , confTrailingNewline = True
359 , confTrailingNewline = True
411 }
360 }
412
361
413−createThunk :: MonadObelisk m => FilePath -> Either ThunkSpec ThunkPtr -> m ()
362+createThunk :: MonadIO m => FilePath -> ThunkPtr -> m ()
414−createThunk target ptrInfo =
363+createThunk target thunk = liftIO $ do
415− ifor_ (_thunkSpec_files spec) $ \path -> \case
416− ThunkFileSpec_FileMatches content -> withReadyPath path $ \p -> liftIO $ T.writeFile p content
417− ThunkFileSpec_Ptr _ -> case ptrInfo of
418− Left _ -> pure () -- We can't write the ptr without it
419− Right ptr -> withReadyPath path $ \p -> liftIO $ LBS.writeFile p (encodeThunkPtrData ptr)
420− _ -> pure ()
421− where
422− spec = either id thunkPtrToSpec ptrInfo
423− withReadyPath path f = do
424− let fullPath = target </> path
425− putLog Debug $ "Writing thunk file " <> T.pack fullPath
426− liftIO $ createDirectoryIfMissing True $ takeDirectory fullPath
364+ createDirectoryIfMissing True (target </> ".attr-cache")
427− f fullPath
365+ T.writeFile (target </> "default.nix") (thunkPtrLoader thunk)
366+ let
367+ jsonFileName = case _thunkPtr_source thunk of
368+ ThunkSource_GitHub _ -> "github"
369+ ThunkSource_Git _ -> "git"
370+ LBS.writeFile (target </> jsonFileName <.> "json") (encodeThunkPtrData thunk)
428
371
429createThunkWithLatest :: MonadObelisk m => FilePath -> ThunkSource -> m ()
372createThunkWithLatest :: MonadObelisk m => FilePath -> ThunkSource -> m ()
430createThunkWithLatest target s = do
373createThunkWithLatest target s = do
431 rev <- getLatestRev s
374 rev <- getLatestRev s
432− createThunk target $ Right $ ThunkPtr
375+ createThunk target $ ThunkPtr
433 { _thunkPtr_source = s
376 { _thunkPtr_source = s
434 , _thunkPtr_rev = rev
377 , _thunkPtr_rev = rev
435 }
378 }
436
379
437−updateThunkToLatest :: MonadObelisk m => ThunkUpdateConfig -> FilePath -> m ()
380+updateThunkToLatest :: MonadObelisk m => FilePath -> Maybe String -> m ()
438−updateThunkToLatest (ThunkUpdateConfig mBranch thunkConfig) target = spinner $ do
381+updateThunkToLatest target mBranch = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest") $ do
439− checkThunkDirectory target
382+ checkThunkDirectory "ob thunk update directory cannot be '.'" target
440 -- check to see if thunk should be updated to a specific branch or just update it's current branch
383 -- check to see if thunk should be updated to a specific branch or just update it's current branch
441 case mBranch of
384 case mBranch of
442 Nothing -> do
385 Nothing -> do
443 (overwrite, ptr) <- readThunk target >>= \case
386 (overwrite, ptr) <- readThunk target >>= \case
444− Left err -> failWith [i|Thunk update: ${err}|]
387+ Left err -> failWith $ T.pack $ "thunk update: " <> show err
445 Right c -> case c of
388 Right c -> case c of
446− ThunkData_Packed _ t -> return (target, t)
389+ ThunkData_Packed t -> return (target, t)
447− ThunkData_Checkout -> failWith "cannot update an unpacked thunk"
390+ ThunkData_Checkout _ -> failWith "cannot update an unpacked thunk"
448 let src = _thunkPtr_source ptr
391 let src = _thunkPtr_source ptr
449 rev <- getLatestRev src
392 rev <- getLatestRev src
450− overwriteThunk overwrite $ modifyThunkPtrByConfig thunkConfig $ ThunkPtr
393+ overwriteThunk overwrite $ ThunkPtr
451 { _thunkPtr_source = src
394 { _thunkPtr_source = src
452 , _thunkPtr_rev = rev
395 , _thunkPtr_rev = rev
453 }
396 }
454 Just branch -> readThunk target >>= \case
397 Just branch -> readThunk target >>= \case
455− Left err -> failWith [i|Thunk update: ${err}|]
398+ Left err -> failWith $ T.pack $ "thunk update: " <> show err
456 Right c -> case c of
399 Right c -> case c of
457− ThunkData_Packed _ t -> setThunk thunkConfig target (thunkSourceToGitSource $ _thunkPtr_source t) branch
400+ ThunkData_Packed t -> case _thunkPtr_source t of
401+ ThunkSource_Git tsg -> setThunk target tsg branch
402+ ThunkSource_GitHub tsgh -> do
403+ let tsg = forgetGithub False tsgh
404+ setThunk target tsg branch
458− ThunkData_Checkout -> failWith [i|Thunk located at ${target} is unpacked. Use 'ob thunk pack' on the desired directory and then try 'ob thunk update' again.|]
405+ ThunkData_Checkout _ -> failWith $ T.pack $ "thunk located at " <> (show target) <> " is unpacked. Use ob thunk pack on the desired directory and then try ob thunk update again."
459− where
406+
460− spinner = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest")
461−
462−setThunk :: MonadObelisk m => ThunkConfig -> FilePath -> GitSource -> String -> m ()
407+setThunk :: MonadObelisk m => FilePath -> GitSource -> String -> m ()
463−setThunk thunkConfig target gs branch = do
408+setThunk target gs branch = do
464− newThunkPtr <- uriThunkPtr (_gitSource_url gs) (_thunkConfig_private thunkConfig) (Just $ T.pack branch) Nothing
409+ newThunkPtr <- uriThunkPtr (_gitSource_url gs) (Just $ T.pack branch) Nothing
465 overwriteThunk target newThunkPtr
410 overwriteThunk target newThunkPtr
466− updateThunkToLatest (ThunkUpdateConfig Nothing thunkConfig) target
411+ updateThunkToLatest target Nothing
467
412
468-- | All recognized github standalone loaders, ordered from newest to oldest.
413-- | All recognized github standalone loaders, ordered from newest to oldest.
469-- This tool will only ever produce the newest one when it writes a thunk.
414-- This tool will only ever produce the newest one when it writes a thunk.
470−gitHubThunkSpecs :: NonEmpty ThunkSpec
415+gitHubStandaloneLoaders :: NonEmpty Text
471−gitHubThunkSpecs =
416+gitHubStandaloneLoaders =
472− gitHubThunkSpecV5 :|
417+ gitHubStandaloneLoaderV2 :|
473− [ gitHubThunkSpecV4
418+ [ gitHubStandaloneLoaderV3
474− , gitHubThunkSpecV3
419+ , gitHubStandaloneLoaderV1
475− , gitHubThunkSpecV2
476− , gitHubThunkSpecV1
477 ]
420 ]
478
421
479−gitHubThunkSpecV1 :: ThunkSpec
422+gitHubStandaloneLoaderV1 :: Text
480−gitHubThunkSpecV1 = legacyGitHubThunkSpec "github-v1"
423+gitHubStandaloneLoaderV1 = T.unlines
481− "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
424+ [ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
425+ ]
482
426
483−gitHubThunkSpecV2 :: ThunkSpec
427+gitHubStandaloneLoaderV2 :: Text
484−gitHubThunkSpecV2 = legacyGitHubThunkSpec "github-v2" $ T.unlines
428+gitHubStandaloneLoaderV2 = T.unlines
485 [ "# DO NOT HAND-EDIT THIS FILE" --TODO: Add something about how to get more info on Obelisk, etc.
429 [ "# DO NOT HAND-EDIT THIS FILE" --TODO: Add something about how to get more info on Obelisk, etc.
486 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
430 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
487 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
431 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
@@ -491,8 +435,8 @@ gitHubThunkSpecV2 = legacyGitHubThunkSpec "github-v2" $ T.unlines
491 , "))"
435 , "))"
492 ]
436 ]
493
437
494−gitHubThunkSpecV3 :: ThunkSpec
438+gitHubStandaloneLoaderV3 :: Text
495−gitHubThunkSpecV3 = legacyGitHubThunkSpec "github-v3" $ T.unlines
439+gitHubStandaloneLoaderV3 = T.unlines
496 [ "# DO NOT HAND-EDIT THIS FILE"
440 [ "# DO NOT HAND-EDIT THIS FILE"
497 , "let"
441 , "let"
498 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
442 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
@@ -511,62 +455,22 @@ gitHubThunkSpecV3 = legacyGitHubThunkSpec "github-v3" $ T.unlines
511 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
455 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
512 ]
456 ]
513
457
514−gitHubThunkSpecV4 :: ThunkSpec
458+plainGitStandaloneLoaders :: NonEmpty Text
515−gitHubThunkSpecV4 = legacyGitHubThunkSpec "github-v4" $ T.unlines
459+plainGitStandaloneLoaders =
516− [ "# DO NOT HAND-EDIT THIS FILE"
460+ plainGitStandaloneLoaderV1 :|
517− , "let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:"
461+ [ plainGitStandaloneLoaderV2
518− , " if !fetchSubmodules && !private then builtins.fetchTarball {"
519− , " url = \"https://github.com/${owner}/${repo}/archive/${rev}.tar.gz\"; inherit sha256;"
520− , " } else (import <nixpkgs> {}).fetchFromGitHub {"
521− , " inherit owner repo rev sha256 fetchSubmodules private;"
522− , " };"
523− , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
524− ]
525−
526−legacyGitHubThunkSpec :: Text -> Text -> ThunkSpec
527−legacyGitHubThunkSpec name loader = ThunkSpec name $ Map.fromList
528− [ ("default.nix", ThunkFileSpec_FileMatches $ T.strip loader)
529− , ("github.json" , ThunkFileSpec_Ptr parseGitHubJsonBytes)
530− , (attrCacheFileName, ThunkFileSpec_AttrCache)
531− , (".git", ThunkFileSpec_CheckoutIndicator)
532− ]
533−
534−gitHubThunkSpecV5 :: ThunkSpec
535−gitHubThunkSpecV5 = mkThunkSpec "github-v5" "github.json" parseGitHubJsonBytes [here|
536−# DO NOT HAND-EDIT THIS FILE
537−let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
538− if !fetchSubmodules && !private then builtins.fetchTarball {
539− url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
540− } else (import <nixpkgs> {}).fetchFromGitHub {
541− inherit owner repo rev sha256 fetchSubmodules private;
542− };
543− json = builtins.fromJSON (builtins.readFile ./github.json);
544−in fetch json
545−|]
546−
547−parseGitHubJsonBytes :: LBS.ByteString -> Either String ThunkPtr
548−parseGitHubJsonBytes = parseJsonObject $ parseThunkPtr $ \v ->
549− ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
550−
551−gitThunkSpecs :: NonEmpty ThunkSpec
552−gitThunkSpecs =
553− gitThunkSpecV5 :|
554− [ gitThunkSpecV4
555− , gitThunkSpecV3
556− , gitThunkSpecV2
557− , gitThunkSpecV1
558 ]
462 ]
559
463
560−gitThunkSpecV1 :: ThunkSpec
464+plainGitStandaloneLoaderV1 :: Text
561−gitThunkSpecV1 = legacyGitThunkSpec "git-v1" $ T.unlines
465+plainGitStandaloneLoaderV1 = T.unlines
562 [ "# DO NOT HAND-EDIT THIS FILE"
466 [ "# DO NOT HAND-EDIT THIS FILE"
563 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
467 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
564 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
468 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
565 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
469 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
566 ]
470 ]
567
471
568−gitThunkSpecV2 :: ThunkSpec
472+plainGitStandaloneLoaderV2 :: Text
569−gitThunkSpecV2 = legacyGitThunkSpec "git-v2" $ T.unlines
473+plainGitStandaloneLoaderV2 = T.unlines
570 [ "# DO NOT HAND-EDIT THIS FILE"
474 [ "# DO NOT HAND-EDIT THIS FILE"
571 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
475 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
572 , " if builtins.hasAttr \"fetchGit\" builtins"
476 , " if builtins.hasAttr \"fetchGit\" builtins"
@@ -575,87 +479,10 @@ gitThunkSpecV2 = legacyGitThunkSpec "git-v2" $ T.unlines
575 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
479 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
576 ]
480 ]
577
481
578−-- This loader has a bug because @builtins.fetchGit@ is not given a @ref@
482+thunkFileNames :: [FilePath]
579−-- and will fail to find commits without this because it does shallow clones.
483+thunkFileNames = ["default.nix", "github.json", "git.json"]
580−gitThunkSpecV3 :: ThunkSpec
581−gitThunkSpecV3 = legacyGitThunkSpec "git-v3" $ T.unlines
582− [ "# DO NOT HAND-EDIT THIS FILE"
583− , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
584− , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
585− , " if firstChar == \"/\" then /. + url"
586− , " else if firstChar == \".\" then ./. + url"
587− , " else url;"
588− , " in if !fetchSubmodules && private then builtins.fetchGit {"
589− , " url = realUrl; inherit rev;"
590− , " } else (import <nixpkgs> {}).fetchgit {"
591− , " url = realUrl; inherit rev sha256;"
592− , " };"
593− , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
594− ]
595−
596−gitThunkSpecV4 :: ThunkSpec
597−gitThunkSpecV4 = legacyGitThunkSpec "git-v4" $ T.unlines
598− [ "# DO NOT HAND-EDIT THIS FILE"
599− , "let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
600− , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
601− , " if firstChar == \"/\" then /. + url"
602− , " else if firstChar == \".\" then ./. + url"
603− , " else url;"
604− , " in if !fetchSubmodules && private then builtins.fetchGit {"
605− , " url = realUrl; inherit rev;"
606− , " ${if branch == null then null else \"ref\"} = branch;"
607− , " } else (import <nixpkgs> {}).fetchgit {"
608− , " url = realUrl; inherit rev sha256;"
609− , " };"
610− , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
611− ]
612
484
613−legacyGitThunkSpec :: Text -> Text -> ThunkSpec
485+--TODO: when checking something out, make a shallow clone
614−legacyGitThunkSpec name loader = ThunkSpec name $ Map.fromList
615− [ ("default.nix", ThunkFileSpec_FileMatches $ T.strip loader)
616− , ("git.json" , ThunkFileSpec_Ptr parseGitJsonBytes)
617− , (attrCacheFileName, ThunkFileSpec_AttrCache)
618− , (".git", ThunkFileSpec_CheckoutIndicator)
619− ]
620−
621−gitThunkSpecV5 :: ThunkSpec
622−gitThunkSpecV5 = mkThunkSpec "git-v5" "git.json" parseGitJsonBytes [here|
623−# DO NOT HAND-EDIT THIS FILE
624−let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:
625− let realUrl = let firstChar = builtins.substring 0 1 url; in
626− if firstChar == "/" then /. + url
627− else if firstChar == "." then ./. + url
628− else url;
629− in if !fetchSubmodules && private then builtins.fetchGit {
630− url = realUrl; inherit rev;
631− ${if branch == null then null else "ref"} = branch;
632− } else (import <nixpkgs> {}).fetchgit {
633− url = realUrl; inherit rev sha256;
634− };
635− json = builtins.fromJSON (builtins.readFile ./git.json);
636−in fetch json
637−|]
638−
639−parseGitJsonBytes :: LBS.ByteString -> Either String ThunkPtr
640−parseGitJsonBytes = parseJsonObject $ parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
641−
642−mkThunkSpec :: Text -> FilePath -> (LBS.ByteString -> Either String ThunkPtr) -> Text -> ThunkSpec
643−mkThunkSpec name jsonFileName parser srcNix = ThunkSpec name $ Map.fromList
644− [ ("default.nix", ThunkFileSpec_FileMatches defaultNixViaSrc)
645− , ("thunk.nix", ThunkFileSpec_FileMatches srcNix)
646− , (jsonFileName, ThunkFileSpec_Ptr parser)
647− , (attrCacheFileName, ThunkFileSpec_AttrCache)
648− , (normalise $ unpackedDirName </> ".git", ThunkFileSpec_CheckoutIndicator)
649− ]
650− where
651− defaultNixViaSrc = [here|
652−# DO NOT HAND-EDIT THIS FILE
653−import (import ./thunk.nix)
654−|]
655−
656−
657−parseJsonObject :: (Aeson.Object -> Aeson.Parser a) -> LBS.ByteString -> Either String a
658−parseJsonObject p bytes = Aeson.parseEither p =<< Aeson.eitherDecode bytes
659
486
660-- | Checks a cache directory to see if there is a fresh symlink
487-- | Checks a cache directory to see if there is a fresh symlink
661-- to the result of building an attribute of a thunk.
488-- to the result of building an attribute of a thunk.
@@ -663,49 +490,44 @@ parseJsonObject p bytes = Aeson.parseEither p =<< Aeson.eitherDecode bytes
663-- and the result is symlinked into the cache.
490-- and the result is symlinked into the cache.
664nixBuildThunkAttrWithCache
491nixBuildThunkAttrWithCache
665 :: MonadObelisk m
492 :: MonadObelisk m
666− => ThunkSpec
667− -> FilePath
493+ => FilePath
668 -- ^ Path to directory containing Thunk
494 -- ^ Path to directory containing Thunk
669 -> String
495 -> String
670 -- ^ Attribute to build
496 -- ^ Attribute to build
671− -> m (Maybe FilePath)
497+ -> m FilePath
672 -- ^ Symlink to cached or built nix output
498 -- ^ Symlink to cached or built nix output
673-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
499-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
674-- the caching mechanism will fail as it merely measures the modification
500-- the caching mechanism will fail as it merely measures the modification
675-- time of the cache link and the expression to build.
501-- time of the cache link and the expression to build.
676−nixBuildThunkAttrWithCache thunkSpec thunkDir attr = do
502+nixBuildThunkAttrWithCache thunkDir attr = do
503+ --NB: Expects thunkDir to be normalised with no trailing path separator.
504+ --This should be guaranteed by the command argument parser.
505+ let cacheErrHandler e
506+ | isDoesNotExistError e = return Nothing -- expected from a cache miss
507+ | otherwise = putLog Error (T.pack $ displayException e) >> return Nothing
508+ cacheDir = thunkDir </> ".attr-cache"
509+ cachePath = cacheDir </> attr <.> "out"
677 latestChange <- liftIO $ do
510 latestChange <- liftIO $ do
678− let
511+ createDirectoryIfMissing False cacheDir
679− getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
512+ let getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
680− thunkFileNames = Map.keys $ _thunkSpec_files thunkSpec
681− maximum . catMaybes <$> traverse (getModificationTimeMaybe . (thunkDir </>)) thunkFileNames
513+ maximum . catMaybes <$> mapM (getModificationTimeMaybe . (thunkDir </>)) thunkFileNames
682−
683− let cachePaths' = nonEmpty $ Map.keys $ Map.filter (\case ThunkFileSpec_AttrCache -> True; _ -> False) $
684− _thunkSpec_files thunkSpec
685− for cachePaths' $ \cachePaths ->
686− fmap NonEmpty.head $ for cachePaths $ \cacheDir -> do
687− let
688− cachePath = thunkDir </> cacheDir </> attr <.> "out"
689− cacheErrHandler e
690− | isDoesNotExistError e = pure Nothing -- expected from a cache miss
691− | otherwise = Nothing <$ putLog Error (T.pack $ displayException e)
692− cacheHit <- handle cacheErrHandler $ do
514+ cacheHit <- handle cacheErrHandler $ do
693− cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
515+ cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
694− pure $ if latestChange <= cacheTime
516+ return $ if latestChange <= cacheTime
695− then Just cachePath
517+ then Just cachePath
696− else Nothing
518+ else Nothing
697− case cacheHit of
519+ case cacheHit of
698− Just c -> pure c
520+ Just c -> return c
699− Nothing -> do
521+ Nothing -> do
700− putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
522+ putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
701− liftIO $ createDirectoryIfMissing True (takeDirectory cachePath)
702− (cachePath <$) $ nixCmd $ NixCmd_Build $ def
523+ _ <- nixCmd $ NixCmd_Build$ def
703− & nixBuildConfig_outLink .~ OutLink_IndirectRoot cachePath
524+ Lens.& nixBuildConfig_outLink Lens..~ OutLink_IndirectRoot cachePath
704− & nixCmdConfig_target .~ Target
525+ Lens.& nixCmdConfig_target Lens..~ Target
705− { _target_path = Just thunkDir
526+ { _target_path = Just thunkDir
706− , _target_attr = Just attr
527+ , _target_attr = Just attr
707− , _target_expr = Nothing
528+ , _target_expr = Nothing
708− }
529+ }
530+ return cachePath
709
531
710-- | Build a nix attribute, and cache the result if possible
532-- | Build a nix attribute, and cache the result if possible
711nixBuildAttrWithCache
533nixBuildAttrWithCache
@@ -716,15 +538,13 @@ nixBuildAttrWithCache
716 -- ^ Attribute to build
538 -- ^ Attribute to build
717 -> m FilePath
539 -> m FilePath
718 -- ^ Symlink to cached or built nix output
540 -- ^ Symlink to cached or built nix output
719−nixBuildAttrWithCache exprPath attr = readThunk exprPath >>= \case
541+nixBuildAttrWithCache exprPath attr = do
542+ readThunk exprPath >>= \case
720− -- Only packed thunks are cached. In particular, checkouts are not.
543+ -- Only packed thunks are cached. in particular, checkouts are not
721− Right (ThunkData_Packed spec _) ->
722− maybe build pure =<< nixBuildThunkAttrWithCache spec exprPath attr
544+ Right (ThunkData_Packed _) -> nixBuildThunkAttrWithCache exprPath attr
723− _ -> build
724− where
725− build = nixCmd $ NixCmd_Build $ def
545+ _ -> nixCmd $ NixCmd_Build $ def
726− & nixBuildConfig_outLink .~ OutLink_None
546+ Lens.& nixBuildConfig_outLink Lens..~ OutLink_None
727− & nixCmdConfig_target .~ Target
547+ Lens.& nixCmdConfig_target Lens..~ Target
728 { _target_path = Just exprPath
548 { _target_path = Just exprPath
729 , _target_attr = Just attr
549 , _target_attr = Just attr
730 , _target_expr = Nothing
550 , _target_expr = Nothing
@@ -745,144 +565,103 @@ updateThunk p f = withSystemTempDirectory "obelisk-thunkptr-" $ \tmpDir -> do
745 where
565 where
746 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
566 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
747 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
567 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
748− Right ThunkData_Packed{} -> do
568+ Right (ThunkData_Packed _) -> do
749 let tmpThunk = tmpDir </> "thunk"
569 let tmpThunk = tmpDir </> "thunk"
750 callProcessAndLogOutput (Notice, Error) $
570 callProcessAndLogOutput (Notice, Error) $
751− proc cp ["-r", "-T", thunkDir, tmpThunk]
571+ proc "cp" ["-r", "-T", thunkDir, tmpThunk]
752 return tmpThunk
572 return tmpThunk
753− Right _ -> failWith "Thunk is not packed"
573+ Right _ -> failWith $ "Thunk is not packed"
754 updateThunkFromTmp p' = do
574 updateThunkFromTmp p' = do
755− _ <- packThunk' True (ThunkPackConfig False (ThunkConfig Nothing)) p'
575+ _ <- packThunk' True False p'
756 callProcessAndLogOutput (Notice, Error) $
576 callProcessAndLogOutput (Notice, Error) $
757− proc cp ["-r", "-T", p', p]
577+ proc "cp" ["-r", "-T", p', p]
758
578
759finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
579finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
760finalMsg noTrail s = if noTrail then Nothing else Just s
580finalMsg noTrail s = if noTrail then Nothing else Just s
761
581
582+unpackThunk :: MonadObelisk m => FilePath -> m ()
583+unpackThunk = unpackThunk' False
584+
762-- | Check that we are not somewhere inside the thunk directory
585-- | Check that we are not somewhere inside the thunk directory
763−checkThunkDirectory :: MonadObelisk m => FilePath -> m ()
586+checkThunkDirectory :: MonadObelisk m => Text -> FilePath -> m ()
764−checkThunkDirectory thunkDir = do
587+checkThunkDirectory msg thunkDir = do
765 currentDir <- liftIO getCurrentDirectory
588 currentDir <- liftIO getCurrentDirectory
766 thunkDir' <- liftIO $ canonicalizePath thunkDir
589 thunkDir' <- liftIO $ canonicalizePath thunkDir
767− when (thunkDir' `L.isInfixOf` currentDir) $
590+ when (thunkDir' `L.isInfixOf` currentDir) $ failWith msg
768− failWith [i|Can't perform thunk operations from within the thunk directory: ${thunkDir}|]
769−
770− -- Don't let thunk commands work when directly given an unpacked repo
771− when (takeFileName thunkDir == unpackedDirName) $
772− readThunk (takeDirectory thunkDir) >>= \case
773− Right _ -> failWith [i|Refusing to perform thunk operation on ${thunkDir} because it is a thunk's unpacked source|]
774− Left _ -> pure ()
775−
776−unpackThunk :: MonadObelisk m => FilePath -> m ()
777−unpackThunk = unpackThunk' False
778
591
779unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
592unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
780−unpackThunk' noTrail thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
593+unpackThunk' noTrail thunkDir = checkThunkDirectory "Can't pack/unpack from within the thunk directory" thunkDir >> readThunk thunkDir >>= \case
781− Left err -> failWith [i|Invalid thunk at ${thunkDir}: ${err}|]
594+ Left err -> failWith $ "thunk unpack: " <> T.pack (show err)
782 --TODO: Overwrite option that rechecks out thunk; force option to do so even if working directory is dirty
595 --TODO: Overwrite option that rechecks out thunk; force option to do so even if working directory is dirty
783− Right ThunkData_Checkout -> failWith [i|Thunk at ${thunkDir} is already unpacked|]
596+ Right (ThunkData_Checkout _) -> failWith "thunk unpack: thunk is already unpacked"
784− Right (ThunkData_Packed _ tptr) -> do
597+ Right (ThunkData_Packed tptr) -> do
785 let (thunkParent, thunkName) = splitFileName thunkDir
598 let (thunkParent, thunkName) = splitFileName thunkDir
786− withTempDirectory thunkParent thunkName $ \tmpThunk -> do
599+ withTempDirectory thunkParent thunkName $ \tmpRepo -> do
787− let
600+ let obGitDir = tmpRepo </> ".git" </> "obelisk"
788− gitSrc = thunkSourceToGitSource $ _thunkPtr_source tptr
789− newSpec = case _thunkPtr_source tptr of
601+ s = case _thunkPtr_source tptr of
790− ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
602+ ThunkSource_GitHub s' -> forgetGithub False s'
791− ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
603+ ThunkSource_Git s' -> s'
792 withSpinner' ("Fetching thunk " <> T.pack thunkName)
604 withSpinner' ("Fetching thunk " <> T.pack thunkName)
793 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
605 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
794− let unpackedPath = tmpThunk </> unpackedDirName
795− gitCloneForThunkUnpack gitSrc (_thunkRev_commit $ _thunkPtr_rev tptr) unpackedPath
796−
797− let normalizeMore = dropTrailingPathSeparator . normalise
798− when (normalizeMore unpackedPath /= normalizeMore tmpThunk) $ -- Only write meta data if the checkout is not inplace
799− createThunk tmpThunk $ Left newSpec
800−
801− liftIO $ do
802− removePathForcibly thunkDir
803− renameDirectory tmpThunk thunkDir
804−
805−gitCloneForThunkUnpack
806− :: MonadObelisk m
807− => GitSource -- ^ Git source to use
808− -> Ref hash -- ^ Commit hash to reset to
809− -> FilePath -- ^ Directory to clone into
810− -> m ()
811−gitCloneForThunkUnpack gitSrc commit dir = do
812− let git = callProcessAndLogOutput (Notice, Notice) . gitProc dir
606+ let git = callProcessAndLogOutput (Notice, Notice) . gitProc tmpRepo
813− git $ [ "clone" ]
607+ git $ [ "clone" ]
814− ++ ["--recursive" | _gitSource_fetchSubmodules gitSrc]
608+ ++ ("--recursive" <$ guard (_gitSource_fetchSubmodules s))
815− ++ [ T.unpack $ gitUriToText $ _gitSource_url gitSrc ]
609+ ++ [ T.unpack $ render $ _gitSource_url s ]
816− ++ do branch <- maybeToList $ _gitSource_branch gitSrc
610+ ++ do branch <- maybeToList $ _gitSource_branch s
817− [ "--branch", T.unpack $ untagName branch ]
611+ [ "--branch", T.unpack $ untagName branch ]
818− git ["reset", "--hard", Ref.toHexString commit]
612+ git ["reset", "--hard", Ref.toHexString $ _thunkRev_commit $ _thunkPtr_rev tptr]
819− when (_gitSource_fetchSubmodules gitSrc) $
613+ when (_gitSource_fetchSubmodules s) $
820− git ["submodule", "update", "--recursive", "--init"]
614+ git ["submodule", "update", "--recursive", "--init"]
615+
616+ liftIO $ createDirectory obGitDir
617+ callProcessAndLogOutput (Notice, Error) $
618+ proc "cp" ["-r", "-T", thunkDir </> ".", obGitDir </> "orig-thunk"]
619+ callProcessAndLogOutput (Notice, Error) $
620+ proc "rm" ["-r", thunkDir]
621+ callProcessAndLogOutput (Notice, Error) $
622+ proc "mv" ["-T", tmpRepo, thunkDir]
821
623
822--TODO: add a rollback mode to pack to the original thunk
624--TODO: add a rollback mode to pack to the original thunk
823−packThunk :: MonadObelisk m => ThunkPackConfig -> FilePath -> m ThunkPtr
625+packThunk :: MonadObelisk m => Bool -> FilePath -> m ThunkPtr
824packThunk = packThunk' False
626packThunk = packThunk' False
825
627
826−packThunk' :: MonadObelisk m => Bool -> ThunkPackConfig -> FilePath -> m ThunkPtr
628+packThunk' :: MonadObelisk m => Bool -> Bool -> FilePath -> m ThunkPtr
827−packThunk' noTrail (ThunkPackConfig force thunkConfig) thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
629+packThunk' noTrail force thunkDir = checkThunkDirectory "Can't pack/unpack from within the thunk directory" thunkDir >> readThunk thunkDir >>= \case
630+ Left err -> failWith $ T.pack $ "thunk pack: " <> show err
828− Right ThunkData_Packed{} -> failWith [i|Thunk at ${thunkDir} is is already packed|]
631+ Right (ThunkData_Packed _) -> failWith "pack: thunk is already packed"
829− _ -> withSpinner'
632+ Right (ThunkData_Checkout _) -> do
830− ("Packing thunk " <> T.pack thunkDir)
633+ withSpinner' ("Packing thunk " <> T.pack thunkDir)
831− (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $
634+ (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $ do
832− do
635+ thunkPtr <- getThunkPtr (not force) thunkDir
833− let checkClean = if force then CheckClean_NoCheck else CheckClean_FullCheck
636+ callProcessAndLogOutput (Debug, Error) $ proc "rm" ["-rf", thunkDir]
834− thunkPtr <- modifyThunkPtrByConfig thunkConfig <$> getThunkPtr checkClean thunkDir (_thunkConfig_private thunkConfig)
835− liftIO $ removePathForcibly thunkDir
836− createThunk thunkDir $ Right thunkPtr
637+ liftIO $ createThunk thunkDir thunkPtr
837 pure thunkPtr
638 pure thunkPtr
838
639
839−modifyThunkPtrByConfig :: ThunkConfig -> ThunkPtr -> ThunkPtr
840−modifyThunkPtrByConfig (ThunkConfig markPrivate') ptr = case markPrivate' of
841− Nothing -> ptr
842− Just markPrivate -> ptr { _thunkPtr_source = case _thunkPtr_source ptr of
843− ThunkSource_Git s -> ThunkSource_Git $ s { _gitSource_private = markPrivate }
844− ThunkSource_GitHub s -> ThunkSource_GitHub $ s { _gitHubSource_private = markPrivate }
845− }
846−
847−data CheckClean
848− = CheckClean_FullCheck
849− -- ^ Check that the repo is clean, including .gitignored files
850− | CheckClean_NotIgnored
851− -- ^ Check that the repo is clean, not including .gitignored files
852− | CheckClean_NoCheck
853− -- ^ Don't check that the repo is clean
854−
855−getThunkPtr :: forall m. MonadObelisk m => CheckClean -> FilePath -> Maybe Bool -> m ThunkPtr
640+getThunkPtr :: forall m. MonadObelisk m => Bool -> FilePath -> m ThunkPtr
856−getThunkPtr gitCheckClean dir mPrivate = do
641+getThunkPtr checkClean thunkDir = do
857− let repoLocations = nubOrd $ map (first normalise)
858− [(".git", "."), (unpackedDirName </> ".git", unpackedDirName)]
859− repoLocation' <- liftIO $ flip findM repoLocations $ doesDirectoryExist . (dir </>) . fst
860− thunkDir <- case repoLocation' of
861− Nothing -> failWith [i|Can't find an unpacked thunk in ${dir}|]
862− Just (_, path) -> pure $ normalise $ dir </> path
863−
864− let (checkClean, checkIgnored) = case gitCheckClean of
865− CheckClean_FullCheck -> (True, True)
866− CheckClean_NotIgnored -> (True, False)
867− CheckClean_NoCheck -> (False, False)
868− when checkClean $ ensureCleanGitRepo thunkDir checkIgnored
642+ when checkClean $ ensureCleanGitRepo thunkDir True $
869 "thunk pack: thunk checkout contains unsaved modifications"
643 "thunk pack: thunk checkout contains unsaved modifications"
870
644
871 -- Check whether there are any stashes
645 -- Check whether there are any stashes
872− when checkClean $ do
873− stashOutput <- readGitProcess thunkDir ["stash", "list"]
646+ stashOutput <- readGitProcess thunkDir ["stash", "list"]
874− unless (T.null stashOutput) $
647+ when checkClean $ case T.null stashOutput of
648+ False -> do
875 failWith $ T.unlines $
649 failWith $ T.unlines $
876 [ "thunk pack: thunk checkout has stashes"
650 [ "thunk pack: thunk checkout has stashes"
877 , "git stash list:"
651 , "git stash list:"
878 ] ++ T.lines stashOutput
652 ] ++ T.lines stashOutput
653+ True -> return ()
879
654
880− -- Get current branch
655+ -- Get current branch ``
881 (mCurrentBranch, mCurrentCommit) <- do
656 (mCurrentBranch, mCurrentCommit) <- do
657+ b <- listToMaybe
658+ <$> T.lines
882− b <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
659+ <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
660+ c <- listToMaybe
661+ <$> T.lines
883− c <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
662+ <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
884 case b of
663 case b of
885− (Just "HEAD") -> failWith $ T.unlines
664+ (Just "HEAD") -> failWith $ T.unlines $
886 [ "thunk pack: You are in 'detached HEAD' state."
665 [ "thunk pack: You are in 'detached HEAD' state."
887 , "If you want to pack at the current ref \
666 , "If you want to pack at the current ref \
888 \then please create a new branch with 'git checkout -b <new-branch-name>' and push this upstream."
667 \then please create a new branch with 'git checkout -b <new-branch-name>' and push this upstream."
@@ -891,7 +670,7 @@ getThunkPtr gitCheckClean dir mPrivate = do
891
670
892 -- Get information on all branches and their (optional) designated upstream
671 -- Get information on all branches and their (optional) designated upstream
893 -- correspondents
672 -- correspondents
894− headDump :: [Text] <- T.lines <$> readGitProcess thunkDir
673+ (headDump :: [Text]) <- T.lines <$> readGitProcess thunkDir
895 [ "for-each-ref"
674 [ "for-each-ref"
896 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
675 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
897 , "refs/heads/"
676 , "refs/heads/"
@@ -937,7 +716,7 @@ getThunkPtr gitCheckClean dir mPrivate = do
937 ]
716 ]
938
717
939 -- loosely by https://stackoverflow.com/questions/7773939/show-git-ahead-and-behind-info-for-all-branches-including-remotes
718 -- loosely by https://stackoverflow.com/questions/7773939/show-git-ahead-and-behind-info-for-all-branches-including-remotes
940− stats <- ifor headUpstream $ \branch (upstream, _remote) -> do
719+ stats <- iforM headUpstream $ \branch (upstream, _remote) -> do
941 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
720 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
942 [ "rev-list", "--left-right"
721 [ "rev-list", "--left-right"
943 , T.unpack branch <> "..." <> T.unpack upstream
722 , T.unpack branch <> "..." <> T.unpack upstream
@@ -954,16 +733,15 @@ getThunkPtr gitCheckClean dir mPrivate = do
954 [ "thunk pack: Certain branches in the thunk have commits not yet pushed upstream:"
733 [ "thunk pack: Certain branches in the thunk have commits not yet pushed upstream:"
955 , ""
734 , ""
956 ] ++
735 ] ++
957− flip map (Map.toList nonGood) (\(branch, (upstream, (ahead, behind))) -> mconcat
736+ (flip map (Map.toList nonGood) $ \(branch, (upstream, (ahead, behind))) -> mconcat
958 [" ", branch, " ahead: ", T.pack (show ahead), " behind: ", T.pack (show behind), " remote branch ", upstream]) ++
737 [" ", branch, " ahead: ", T.pack (show ahead), " behind: ", T.pack (show behind), " remote branch ", upstream]) ++
959 [ ""
738 [ ""
960 , "Please push these upstream and try again. (Or just fetch, if they are somehow \
739 , "Please push these upstream and try again. (Or just fetch, if they are somehow \
961 \pushed but this repo's remote tracking branches don't know it.)"
740 \pushed but this repo's remote tracking branches don't know it.)"
962 ]
741 ]
963
742
964− when checkClean $ do
965− -- We assume it's safe to pack the thunk at this point
743+ -- We assume it's safe to pack the thunk at this point
966− putLog Informational "All changes safe in git remotes. OK to pack thunk."
744+ putLog Informational $ "All changes safe in git remotes. OK to pack thunk."
967
745
968 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
746 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
969
747
@@ -976,12 +754,14 @@ getThunkPtr gitCheckClean dir mPrivate = do
976 remoteUri <- case parseGitUri remoteUri' of
754 remoteUri <- case parseGitUri remoteUri' of
977 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
755 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
978 Just uri -> pure uri
756 Just uri -> pure uri
979− uriThunkPtr remoteUri mPrivate mCurrentBranch mCurrentCommit
757+ uriThunkPtr remoteUri mCurrentBranch mCurrentCommit
980
758
981-- | Get the latest revision available from the given source
759-- | Get the latest revision available from the given source
982getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
760getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
983getLatestRev os = do
761getLatestRev os = do
984− let gitS = thunkSourceToGitSource os
762+ let gitS = case os of
763+ ThunkSource_GitHub s -> forgetGithub False s
764+ ThunkSource_Git s -> s
985 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
765 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
986 case os of
766 case os of
987 ThunkSource_GitHub s -> githubThunkRev s commit
767 ThunkSource_GitHub s -> githubThunkRev s commit
@@ -993,18 +773,18 @@ getLatestRev os = do
993-- performance. If that doesn't work (e.g. authentication issue), we fall back
773-- performance. If that doesn't work (e.g. authentication issue), we fall back
994-- on just doing things the normal way for git repos in general, and save it as
774-- on just doing things the normal way for git repos in general, and save it as
995-- a regular git thunk.
775-- a regular git thunk.
996−uriThunkPtr :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr
776+uriThunkPtr :: MonadObelisk m => URI -> Maybe Text -> Maybe Text -> m ThunkPtr
997−uriThunkPtr uri mPrivate mbranch mcommit = do
777+uriThunkPtr uri mbranch mcommit = do
998 commit <- case mcommit of
778 commit <- case mcommit of
999 Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
779 Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
1000 (Just c) -> return c
780 (Just c) -> return c
1001− (src, rev) <- uriToThunkSource uri mPrivate mbranch >>= \case
781+ (src, rev) <- case uriToThunkSource uri mbranch of
1002 ThunkSource_GitHub s -> do
782 ThunkSource_GitHub s -> do
1003 rev <- runExceptT $ githubThunkRev s commit
783 rev <- runExceptT $ githubThunkRev s commit
1004 case rev of
784 case rev of
1005 Right r -> pure (ThunkSource_GitHub s, r)
785 Right r -> pure (ThunkSource_GitHub s, r)
1006 Left e -> do
786 Left e -> do
1007− putLog Warning "\
787+ putLog Warning $ "\
1008\Failed to fetch archive from GitHub. This is probably a private repo. \
788\Failed to fetch archive from GitHub. This is probably a private repo. \
1009\Falling back on normal fetchgit. Original failure:"
789\Falling back on normal fetchgit. Original failure:"
1010 errorToWarning e
790 errorToWarning e
@@ -1021,66 +801,34 @@ uriThunkPtr uri mPrivate mbranch mcommit = do
1021-- If the thunk is a GitHub thunk and fails, we do *not* fall back like with
801-- If the thunk is a GitHub thunk and fails, we do *not* fall back like with
1022-- `uriThunkPtr`. Unlike a plain URL, a thunk src explicitly states which method
802-- `uriThunkPtr`. Unlike a plain URL, a thunk src explicitly states which method
1023-- should be employed, and so we respect that.
803-- should be employed, and so we respect that.
1024−uriToThunkSource :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> m ThunkSource
804+uriToThunkSource :: URI -> Maybe Text -> ThunkSource
1025−uriToThunkSource (GitUri u) mPrivate
805+uriToThunkSource u
1026− | Right uriAuth <- URI.uriAuthority u
806+ | Right uriAuth <- uriAuthority u
1027− , Just scheme <- URI.unRText <$> URI.uriScheme u
807+ , Just scheme <- unRText <$> uriScheme u
1028 , case scheme of
808 , case scheme of
1029− "ssh" -> uriAuth == URI.Authority
809+ "ssh" -> uriAuth == Authority
1030− { URI.authUserInfo = Just $ URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
810+ { authUserInfo = Just $ UserInfo (fromRight' $ mkUsername "git") Nothing
1031− , URI.authHost = fromRight' $ URI.mkHost "github.com"
811+ , authHost = fromRight' $ mkHost "github.com"
1032− , URI.authPort = Nothing
812+ , authPort = Nothing
1033 }
813 }
1034 s -> s `L.elem` [ "git", "https", "http" ] -- "http:" just redirects to "https:"
814 s -> s `L.elem` [ "git", "https", "http" ] -- "http:" just redirects to "https:"
1035− && URI.unRText (URI.authHost uriAuth) == "github.com"
815+ && unRText (authHost uriAuth) == "github.com"
1036− , Just (_, owner :| [repoish]) <- URI.uriPath u
816+ , Just (_, owner :| [repoish]) <- uriPath u
1037− = \mbranch -> do
1038− isPrivate <- getIsPrivate
1039− pure $ ThunkSource_GitHub $ GitHubSource
817+ = \mbranch -> ThunkSource_GitHub $ GitHubSource
1040− { _gitHubSource_owner = N $ URI.unRText owner
818+ { _gitHubSource_owner = N $ unRText owner
1041− , _gitHubSource_repo = N $ let
819+ , _gitHubSource_repo = N $ let
1042− repoish' = URI.unRText repoish
820+ repoish' = unRText repoish
1043− in fromMaybe repoish' $ T.stripSuffix ".git" repoish'
821+ in case T.stripSuffix ".git" repoish' of
822+ Just repo -> repo
823+ Nothing -> repoish'
1044− , _gitHubSource_branch = N <$> mbranch
824+ , _gitHubSource_branch = N <$> mbranch
1045− , _gitHubSource_private = isPrivate
1046− }
825+ }
1047
826
1048− | otherwise = \mbranch -> do
1049− isPrivate <- getIsPrivate
1050− pure $ ThunkSource_Git $ GitSource
827+ | otherwise = \mbranch -> ThunkSource_Git $ GitSource
1051− { _gitSource_url = GitUri u
828+ { _gitSource_url = u
1052− , _gitSource_branch = N <$> mbranch
829+ , _gitSource_branch = N <$> mbranch
1053− , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
830+ , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
1054− , _gitSource_private = isPrivate
1055− }
1056− where
1057− getIsPrivate = maybe (guessGitRepoIsPrivate $ GitUri u) pure mPrivate
1058−
1059−guessGitRepoIsPrivate :: MonadObelisk m => GitUri -> m Bool
1060−guessGitRepoIsPrivate uri = flip fix urisToTry $ \loop -> \case
1061− [] -> pure True
1062− uriAttempt:xs -> do
1063− result <- readCreateProcessWithExitCode $
1064− isolateGitProc $
1065− gitProcNoRepo
1066− [ "ls-remote"
1067− , "--quiet"
1068− , "--exit-code"
1069− , "--symref"
1070− , T.unpack $ gitUriToText uriAttempt
1071− ]
1072− case result of
1073− (ExitSuccess, _, _) -> pure False -- Must be a public repo
1074− _ -> loop xs
1075− where
1076− urisToTry = nubOrd $
1077− -- Include the original URI if it isn't using SSH because SSH will certainly fail.
1078− [uri | fmap URI.unRText (URI.uriScheme (unGitUri uri)) /= Just "ssh"] <>
1079− [changeScheme "https" uri, changeScheme "http" uri]
1080− changeScheme scheme (GitUri u) = GitUri $ u
1081− { URI.uriScheme = URI.mkScheme scheme
1082− , URI.uriAuthority = (\x -> x { URI.authUserInfo = Nothing }) <$> URI.uriAuthority u
1083− }
831+ }
1084
832
1085-- Funny signature indicates no effects depend on the optional branch name.
833-- Funny signature indicates no effects depend on the optional branch name.
1086githubThunkRev
834githubThunkRev
@@ -1092,19 +840,19 @@ githubThunkRev
1092githubThunkRev s commit = do
840githubThunkRev s commit = do
1093 owner <- forcePP $ _gitHubSource_owner s
841 owner <- forcePP $ _gitHubSource_owner s
1094 repo <- forcePP $ _gitHubSource_repo s
842 repo <- forcePP $ _gitHubSource_repo s
1095− revTarball <- URI.mkPathPiece $ commit <> ".tar.gz"
843+ revTarball <- mkPathPiece $ commit <> ".tar.gz"
1096− let archiveUri = GitUri $ URI.URI
844+ let archiveUri = URI
1097− { URI.uriScheme = Just $ fromRight' $ URI.mkScheme "https"
845+ { uriScheme = Just $ fromRight' $ mkScheme "https"
1098− , URI.uriAuthority = Right $ URI.Authority
846+ , uriAuthority = Right $ Authority
1099− { URI.authUserInfo = Nothing
847+ { authUserInfo = Nothing
1100− , URI.authHost = fromRight' $ URI.mkHost "github.com"
848+ , authHost = fromRight' $ mkHost "github.com"
1101− , URI.authPort = Nothing
849+ , authPort = Nothing
1102 }
850 }
1103− , URI.uriPath = Just ( False
851+ , uriPath = Just ( False
1104− , owner :| [ repo, fromRight' $ URI.mkPathPiece "archive", revTarball ]
852+ , owner :| [ repo, fromRight' $ mkPathPiece "archive", revTarball ]
1105 )
853 )
1106− , URI.uriQuery = []
854+ , uriQuery = []
1107− , URI.uriFragment = Nothing
855+ , uriFragment = Nothing
1108 }
856 }
1109 hash <- getNixSha256ForUriUnpacked archiveUri
857 hash <- getNixSha256ForUriUnpacked archiveUri
1110 putLog Debug $ "Nix sha256 is " <> hash
858 putLog Debug $ "Nix sha256 is " <> hash
@@ -1113,8 +861,8 @@ githubThunkRev s commit = do
1113 , _thunkRev_nixSha256 = hash
861 , _thunkRev_nixSha256 = hash
1114 }
862 }
1115 where
863 where
1116− forcePP :: Name entity -> m (URI.RText 'URI.PathPiece)
864+ forcePP :: Name entity -> m (RText 'PathPiece)
1117− forcePP = URI.mkPathPiece . untagName
865+ forcePP = mkPathPiece . untagName
1118
866
1119gitThunkRev
867gitThunkRev
1120 :: MonadObelisk m
868 :: MonadObelisk m
@@ -1123,11 +871,11 @@ gitThunkRev
1123 -> m ThunkRev
871 -> m ThunkRev
1124gitThunkRev s commit = do
872gitThunkRev s commit = do
1125 let u = _gitSource_url s
873 let u = _gitSource_url s
1126− protocols = ["file", "https", "ssh", "git"]
874+ protocols = ["https", "ssh", "git"]
1127− scheme = maybe "file" URI.unRText $ URI.uriScheme $ (\(GitUri x) -> x) u
875+ Just scheme <- pure $ unRText <$> uriScheme u
1128 unless (T.toLower scheme `elem` protocols) $
876 unless (T.toLower scheme `elem` protocols) $
1129 failWith $ "obelisk currently only supports "
877 failWith $ "obelisk currently only supports "
1130− <> T.intercalate ", " protocols <> " protocols for plain Git remotes"
878+ <> T.intercalate ", " protocols <> " protocols for non-GitHub remotes"
1131 hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
879 hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
1132 putLog Informational $ "Nix sha256 is " <> hash
880 putLog Informational $ "Nix sha256 is " <> hash
1133 pure $ ThunkRev
881 pure $ ThunkRev
@@ -1140,12 +888,11 @@ gitThunkRev s commit = do
1140--
888--
1141-- If the branch name is passed in, it is returned exactly as-is. If it is not
889-- If the branch name is passed in, it is returned exactly as-is. If it is not
1142-- passed it, the default branch of the repo is used instead.
890-- passed it, the default branch of the repo is used instead.
1143−
1144gitGetCommitBranch
891gitGetCommitBranch
1145− :: MonadObelisk m => GitUri -> Maybe Text -> m (Text, CommitId)
892+ :: MonadObelisk m => URI -> Maybe Text -> m (Text, CommitId)
1146gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
893gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
1147 (_, bothMaps) <- gitLsRemote
894 (_, bothMaps) <- gitLsRemote
1148− (T.unpack $ gitUriToText uri)
895+ (T.unpack $ render uri)
1149 (GitRef_Branch <$> mbranch)
896 (GitRef_Branch <$> mbranch)
1150 Nothing
897 Nothing
1151 branch <- case mbranch of
898 branch <- case mbranch of
@@ -1161,21 +908,18 @@ gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote "
1161 pure (branch, commit)
908 pure (branch, commit)
1162 where
909 where
1163 rethrowE = either failWith pure
910 rethrowE = either failWith pure
1164− uriMsg = gitUriToText uri
911+ uriMsg = render uri
1165−
1166−parseGitUri :: Text -> Maybe GitUri
1167−parseGitUri x = GitUri <$> (parseFileURI x <|> parseAbsoluteURI x <|> parseSshShorthand x)
1168
912
1169−parseFileURI :: Text -> Maybe URI.URI
913+parseGitUri :: Text -> Maybe URI
1170−parseFileURI uri = if "/" `T.isPrefixOf` uri then parseAbsoluteURI ("file://" <> uri) else Nothing
914+parseGitUri x = parseAbsoluteURI x <|> parseSshShorthand x
1171
915
1172−parseAbsoluteURI :: Text -> Maybe URI.URI
916+parseAbsoluteURI :: Text -> Maybe URI
1173parseAbsoluteURI uri = do
917parseAbsoluteURI uri = do
1174− parsedUri <- URI.mkURI uri
918+ parsedUri <- mkURI uri
1175− guard $ URI.isPathAbsolute parsedUri
919+ guard $ isPathAbsolute parsedUri
1176− pure parsedUri
920+ pure $ parsedUri
1177
921
1178−parseSshShorthand :: Text -> Maybe URI.URI
922+parseSshShorthand :: Text -> Maybe URI
1179parseSshShorthand uri = do
923parseSshShorthand uri = do
1180 -- This is what git does to check that the remote
924 -- This is what git does to check that the remote
1181 -- is not a local file path when parsing shorthand.
925 -- is not a local file path when parsing shorthand.
@@ -1188,4 +932,4 @@ parseSshShorthand uri = do
1188 -- This check is used to disambiguate a filepath containing a colon from shorthand
932 -- This check is used to disambiguate a filepath containing a colon from shorthand
1189 guard $ isNothing (T.findIndex (=='/') authAndHostname)
933 guard $ isNothing (T.findIndex (=='/') authAndHostname)
1190 && not (T.null colonAndPath)
934 && not (T.null colonAndPath)
1191− URI.mkURI properUri
935+ mkURI properUri
lib/command/src/Obelisk/Command/Upgrade/Hash.hsnew file+114
@@ -0,0 +1,114 @@
1+{-# LANGUAGE FlexibleContexts #-}
2+{-# LANGUAGE LambdaCase #-}
3+{-# LANGUAGE OverloadedStrings #-}
4+{-# LANGUAGE ScopedTypeVariables #-}
5+{-# LANGUAGE TupleSections #-}
6+-- | Hash a git repo or arbitrary directory using nix-hash.
7+module Obelisk.Command.Upgrade.Hash
8+ ( getDirectoryHash
9+ , getHashAtGitRevision
10+ ) where
11+
12+import Control.Monad (forM, forM_)
13+import Control.Monad.IO.Class (liftIO)
14+import Data.Bool (bool)
15+import Data.Maybe (catMaybes)
16+import Data.Semigroup ((<>))
17+import Data.Text (Text)
18+import qualified Data.Text as T
19+import System.Directory
20+import System.FilePath
21+import System.IO.Temp
22+import System.Process (cwd, proc)
23+
24+import Obelisk.App (MonadObelisk)
25+import Obelisk.CliApp
26+import Obelisk.Command.Utils
27+
28+import Obelisk.Migration
29+
30+-- | Get the unique hash of the given directory
31+--
32+-- Excludes the following before computing the hash:
33+-- * the specified top-level files/ directories.
34+-- * .git directory
35+-- * untracked Git files
36+-- * ignored Git files
37+-- * empty directories
38+--
39+-- Uses the same predictive algorithm as that of Nix (`nix-hash`).
40+--
41+-- This function will do a full copy of the directory to a temporary location before
42+-- computing the hash. Because it will be deleting the files in exclude list, and
43+-- other files if the directory is a git repo, which needs to be done as `nix-hash`
44+-- doesn't support taking an excludes list.
45+getDirectoryHash :: MonadObelisk m => [FilePath] -> FilePath -> m Hash
46+getDirectoryHash excludes dir = withSystemTempDirectory "obelisk-hash-" $ \tmpDir -> do
47+ withSpinnerNoTrail (T.pack $ "Copying " <> dir <> " to " <> tmpDir) $ do
48+ runProc $ copyDir dir tmpDir
49+ getDirectoryHashDestructive excludes tmpDir
50+
51+getDirectoryHashDestructive :: MonadObelisk m => [FilePath] -> FilePath -> m Hash
52+getDirectoryHashDestructive excludes dir = do
53+ liftIO (doesDirectoryExist $ dir </> ".git") >>= \case
54+ True -> do
55+ tidyUpGitWorkingCopy dir
56+ withSpinnerNoTrail "Removing .git directory" $
57+ liftIO $ removePathForcibly $ dir </> ".git"
58+ False -> pure ()
59+ withSpinnerNoTrail "Removing excluded paths" $ do
60+ forM_ (fmap (dir </>) excludes) $
61+ liftIO . removePathForcibly
62+ nixHash dir
63+
64+getHashAtGitRevision :: MonadObelisk m => [Text] -> [FilePath] -> FilePath -> m [Hash]
65+getHashAtGitRevision revs excludes dir = withSystemTempDirectory "obelisk-hashrev-" $ \tmpDir -> do
66+ withSpinnerNoTrail (T.pack $ "Copying " <> dir <> " to " <> tmpDir) $ do
67+ runProc $ copyDir dir tmpDir
68+ tidyUpGitWorkingCopy tmpDir
69+ -- Discard changes to tracked files
70+ runProcSilently $ gitProc tmpDir ["reset", "--hard"]
71+ forM revs $ \rev -> do
72+ runProcSilently $ gitProc tmpDir ["checkout", T.unpack rev]
73+ -- Checking out an arbitrary revision can leave untracked files (from
74+ -- previous revison) around, so tidy them up.
75+ tidyUpGitWorkingCopy tmpDir
76+ withFilesStashed tmpDir (excludes <> [".git"]) $
77+ nixHash tmpDir
78+ where
79+ withFilesStashed base fs m = withSystemTempDirectory "obelisk-hashrev-stash-" $ \stashDir -> do
80+ existingPaths <- fmap catMaybes $ forM fs $ \p -> do
81+ liftIO (doesPathExist $ base </> p) >>= pure . bool Nothing (Just p)
82+ forM_ existingPaths $ \p ->
83+ liftIO $ renamePath (base </> p) (stashDir </> p)
84+ result <- m
85+ forM_ existingPaths $ \p ->
86+ liftIO $ renamePath (stashDir </> p) (base </> p)
87+ return result
88+
89+nixHash :: MonadObelisk m => FilePath -> m Hash
90+nixHash dir = withSpinnerNoTrail "Running `nix-hash`" $
91+ readProc $ proc "nix-hash" [dir]
92+
93+-- | Clean up the following files in the git working copy
94+--
95+-- * Paths ignored by .gitignore, and still present
96+-- * Untracked files (not added to git index)
97+-- * Any empty directories (these are not tracked by git)
98+--
99+-- Note that this leaves modified (staged or unstaged) files as they are.
100+tidyUpGitWorkingCopy :: MonadObelisk m => FilePath -> m ()
101+tidyUpGitWorkingCopy dir = withSpinnerNoTrail "Tidying up git working copy" $ do
102+ ignored <- gitLsFiles dir ["--ignored", "--exclude-standard", "--others"]
103+ untracked <- gitLsFiles dir ["--exclude-standard", "--others"]
104+ putLog Debug $ "Ignored: " <> T.pack (show $ length ignored) <> " files."
105+ putLog Debug $ "Untracked files:\n" <> T.unlines untracked
106+ withSpinnerNoTrail "Removing untracked and ignored files" $ do
107+ forM_ (fmap ((dir </>) . T.unpack) $ ignored <> untracked) $
108+ liftIO . removePathForcibly
109+ -- Empty directories won't be included in these lists. Git doesn't track them
110+ -- So we must delete these separately.
111+ runProc $ proc "find" [dir, "-depth", "-empty", "-type", "d", "-delete"]
112+ where
113+ gitLsFiles pwd opts = fmap T.lines $ readProc $
114+ (proc "git" $ ["ls-files", "."] <> opts) { cwd = Just pwd }
lib/command/src/Obelisk/Command/Utils.hs+20−92
@@ -4,95 +4,34 @@
4{-# LANGUAGE ScopedTypeVariables #-}
4{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE PatternGuards #-}
6{-# LANGUAGE PatternGuards #-}
7−{-# LANGUAGE TemplateHaskell #-}
8module Obelisk.Command.Utils where
7module Obelisk.Command.Utils where
9
8
10import Control.Applicative hiding (many)
9import Control.Applicative hiding (many)
11import Control.Monad.Except
10import Control.Monad.Except
12import Data.Bool (bool)
11import Data.Bool (bool)
12+import qualified Text.Megaparsec.Char.Lexer as ML
13import Data.Bifunctor
13import Data.Bifunctor
14import Data.Char
14import Data.Char
15import Data.Either
15import Data.Either
16−import Data.List (isInfixOf)
16+import Data.Semigroup ((<>))
17import Data.Map (Map)
17import Data.Map (Map)
18import qualified Data.Map as M
18import qualified Data.Map as M
19import Data.Maybe (maybeToList)
19import Data.Maybe (maybeToList)
20−import Data.Semigroup ((<>))
21import Data.Text (Text)
20import Data.Text (Text)
22import qualified Data.Text as T
21import qualified Data.Text as T
23import Data.Void (Void)
22import Data.Void (Void)
23+import System.Directory (canonicalizePath)
24+import System.Environment (getExecutablePath)
24import System.Exit (ExitCode)
25import System.Exit (ExitCode)
25−import System.Which (staticWhich)
26+import qualified System.Process as P
26−import qualified Text.Megaparsec.Char.Lexer as ML
27import Text.Megaparsec as MP
27import Text.Megaparsec as MP
28import Text.Megaparsec.Char as MP
28import Text.Megaparsec.Char as MP
29
29
30import Obelisk.App (MonadObelisk)
30import Obelisk.App (MonadObelisk)
31import Obelisk.CliApp
31import Obelisk.CliApp
32
32
33−cp :: FilePath
34−cp = $(staticWhich "cp")
35−
36−mvPath :: FilePath
33+getObeliskExe :: IO FilePath
37−mvPath = $(staticWhich "mv")
34+getObeliskExe = getExecutablePath >>= canonicalizePath
38−
39−rmPath :: FilePath
40−rmPath = $(staticWhich "rm")
41−
42−ghcidExePath :: FilePath
43−ghcidExePath = $(staticWhich "ghcid")
44−
45−findExePath :: FilePath
46−findExePath = $(staticWhich "find")
47−
48−nixExePath :: FilePath
49−nixExePath = $(staticWhich "nix")
50−
51−nixBuildExePath :: FilePath
52−nixBuildExePath = $(staticWhich "nix-build")
53−
54−jreKeyToolPath :: FilePath
55−jreKeyToolPath = $(staticWhich "keytool")
56−
57−nixPrefetchGitPath :: FilePath
58−nixPrefetchGitPath = $(staticWhich "nix-prefetch-git")
59−
60−nixPrefetchUrlPath :: FilePath
61−nixPrefetchUrlPath = $(staticWhich "nix-prefetch-url")
62−
63−nixShellPath :: FilePath
64−nixShellPath = $(staticWhich "nix-shell")
65−
66−rsyncPath :: FilePath
67−rsyncPath = $(staticWhich "rsync")
68−
69−sshPath :: FilePath
70−sshPath = $(staticWhich "ssh")
71−
72−gitPath :: FilePath
73−gitPath = $(staticWhich "git")
74−
75−whichPath :: FilePath
76−whichPath = $(staticWhich "which")
77−
78−sshKeygenPath :: FilePath
79−sshKeygenPath = $(staticWhich "ssh-keygen")
80−
81−-- $(staticWhich "docker") was intentionally omitted, at least for now
82−-- One concern is that I don't know how particular docker is about having the
83−-- CLI exe match the version of the docker daemon, which is largely outside of
84−-- the control of obelisk-command.
85−-- TODO: Investigate the tradeoffs associated with this choice
86−dockerPath :: FilePath
87−dockerPath = "docker"
88−
89−-- | Nix syntax requires relative paths to be prefixed by @./@ or
90−-- @../@. This will make a 'FilePath' that can be embedded in a Nix
91−-- expression.
92−toNixPath :: FilePath -> FilePath
93−toNixPath root | "/" `isInfixOf` root = root
94− | otherwise = "./" <> root
95−
96
35
97-- Check whether the working directory is clean
36-- Check whether the working directory is clean
98checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
37checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
@@ -122,31 +61,20 @@ initGit repo = do
122 git ["add", "."]
61 git ["add", "."]
123 git ["commit", "-m", "Initial commit."]
62 git ["commit", "-m", "Initial commit."]
124
63
125−gitProcNoRepo :: [String] -> ProcessSpec
64+gitProcNoRepo :: [String] -> P.CreateProcess
126−gitProcNoRepo args = setEnvOverride (M.singleton "GIT_TERMINAL_PROMPT" "0" <>) $ proc gitPath args
65+gitProcNoRepo = P.proc "git"
127
66
128−gitProc :: FilePath -> [String] -> ProcessSpec
67+gitProc :: FilePath -> [String] -> P.CreateProcess
129gitProc repo = gitProcNoRepo . runGitInDir
68gitProc repo = gitProcNoRepo . runGitInDir
130 where
69 where
131 runGitInDir args' = case filter (not . null) args' of
70 runGitInDir args' = case filter (not . null) args' of
132 args@("clone":_) -> args <> [repo]
71 args@("clone":_) -> args <> [repo]
133 args -> ["-C", repo] <> args
72 args -> ["-C", repo] <> args
134
73
135−isolateGitProc :: ProcessSpec -> ProcessSpec
136−isolateGitProc = setEnvOverride (overrides <>)
137− where
138− overrides = M.fromList
139− [ ("HOME", "/dev/null")
140− , ("GIT_CONFIG_NOSYSTEM", "1")
141− , ("GIT_TERMINAL_PROMPT", "0") -- git 2.3+
142− , ("GIT_ASKPASS", "echo") -- pre git 2.3 to just use empty password
143− , ("GIT_SSH_COMMAND", "ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no -o GSSAPIAuthentication=no")
144− ]
145−
146−-- | Recursively copy a directory using `cp -a` -- TODO: Should use -rT instead of -a
74+-- | Recursively copy a directory using `cp -a`
147−copyDir :: FilePath -> FilePath -> ProcessSpec
75+copyDir :: FilePath -> FilePath -> P.CreateProcess
148copyDir src dest =
76copyDir src dest =
149− setCwd (Just src) $ proc cp ["-a", ".", dest] -- TODO: This will break if dest is relative since we change cwd
77+ (P.proc "cp" ["-a", ".", dest]) { P.cwd = Just src }
150
78
151readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
79readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
152readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
80readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
@@ -159,15 +87,15 @@ processToShellString cmd args = unwords $ map quoteAndEscape (cmd : args)
159 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
87 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
160
88
161-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
89-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
162−runProc :: MonadObelisk m => ProcessSpec -> m ()
90+runProc :: MonadObelisk m => P.CreateProcess -> m ()
163runProc = callProcessAndLogOutput (Notice, Error)
91runProc = callProcessAndLogOutput (Notice, Error)
164
92
165-- | Like runProc, but all output goes to Debug logging level
93-- | Like runProc, but all output goes to Debug logging level
166−runProcSilently :: MonadObelisk m => ProcessSpec -> m ()
94+runProcSilently :: MonadObelisk m => P.CreateProcess -> m ()
167runProcSilently = callProcessAndLogOutput (Debug, Debug)
95runProcSilently = callProcessAndLogOutput (Debug, Debug)
168
96
169-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
97-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
170−readProc :: MonadObelisk m => ProcessSpec -> m Text
98+readProc :: MonadObelisk m => P.CreateProcess -> m Text
171readProc = readProcessAndLogOutput (Debug, Error)
99readProc = readProcessAndLogOutput (Debug, Error)
172
100
173tshow :: Show a => a -> Text
101tshow :: Show a => a -> Text
@@ -201,13 +129,13 @@ gitLsRemote repository mRef mBranch = do
201 (exitCode, out, _err) <- case mBranch of
129 (exitCode, out, _err) <- case mBranch of
202 Nothing -> readCreateProcessWithExitCode $ gitProcNoRepo $
130 Nothing -> readCreateProcessWithExitCode $ gitProcNoRepo $
203 ["ls-remote", "--exit-code", "--symref", repository]
131 ["ls-remote", "--exit-code", "--symref", repository]
204− ++ maybeToList (T.unpack . showGitRef <$> mRef)
132+ ++ (maybeToList $ T.unpack . showGitRef <$> mRef)
205− Just branchName -> readCreateProcessWithExitCode $ gitProcNoRepo
133+ Just branchName -> readCreateProcessWithExitCode $ gitProcNoRepo $
206 ["ls-remote", "--exit-code", repository, branchName]
134 ["ls-remote", "--exit-code", repository, branchName]
207 let t = T.pack out
135 let t = T.pack out
208 maps <- case MP.runParser parseLsRemote "" t of
136 maps <- case MP.runParser parseLsRemote "" t of
209− Left err -> failWith $ T.pack $ MP.errorBundlePretty err
137+ Left err -> failWith $ T.pack $ MP.parseErrorPretty' t err
210− Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers table
138+ Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers $ table
211 putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
139 putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
212 pure (exitCode, maps)
140 pure (exitCode, maps)
213
141
lib/command/src/Obelisk/Command/VmBuilder.hs+10−11
@@ -18,10 +18,10 @@ import System.Directory (createDirectoryIfMissing)
18import System.Exit (ExitCode(..))
18import System.Exit (ExitCode(..))
19import System.FilePath ((<.>), (</>))
19import System.FilePath ((<.>), (</>))
20import qualified System.Info
20import qualified System.Info
21+import System.Process (proc)
21
22
22import Obelisk.App (MonadObelisk, getObeliskUserStateDir)
23import Obelisk.App (MonadObelisk, getObeliskUserStateDir)
23import Obelisk.CliApp
24import Obelisk.CliApp
24−import Obelisk.Command.Utils (rmPath, whichPath, sshKeygenPath, nixBuildExePath, dockerPath)
25
25
26-- | Generate the `--builders` argument string to enable the VM builder after ensuring it is available.
26-- | Generate the `--builders` argument string to enable the VM builder after ensuring it is available.
27getNixBuildersArg :: MonadObelisk m => m String
27getNixBuildersArg :: MonadObelisk m => m String
@@ -35,7 +35,7 @@ getNixBuildersArg = do
35
35
36checkForNixDarwin :: MonadObelisk m => String -> m ()
36checkForNixDarwin :: MonadObelisk m => String -> m ()
37checkForNixDarwin sshIdFile = do
37checkForNixDarwin sshIdFile = do
38− (exitCode, _, _) <- readCreateProcessWithExitCode $ proc whichPath ["darwin-rebuild"]
38+ (exitCode, _, _) <- readCreateProcessWithExitCode $ proc "which" ["darwin-rebuild"]
39 unless (exitCode == ExitSuccess) $ failWith $ T.intercalate "\n"
39 unless (exitCode == ExitSuccess) $ failWith $ T.intercalate "\n"
40 [ "Deployments from macOS require nix-darwin to be installed."
40 [ "Deployments from macOS require nix-darwin to be installed."
41 , "Follow the installation instructions here: https://github.com/LnL7/nix-darwin"
41 , "Follow the installation instructions here: https://github.com/LnL7/nix-darwin"
@@ -67,7 +67,7 @@ containerExists :: MonadObelisk m => FilePath -> m Bool
67containerExists stateDir = handle (\(_ :: IOError) -> failWith needDockerMsg) $ do
67containerExists stateDir = handle (\(_ :: IOError) -> failWith needDockerMsg) $ do
68 containerNames <- fmap (map T.strip . T.lines) $
68 containerNames <- fmap (map T.strip . T.lines) $
69 readProcessAndLogStderr Error $
69 readProcessAndLogStderr Error $
70− proc dockerPath ["container", "list", "--all", "--format", "{{.Names}}"]
70+ proc "docker" ["container", "list", "--all", "--format", "{{.Names}}"]
71 let exists = containerName `elem` containerNames
71 let exists = containerName `elem` containerNames
72 when exists $ testLinuxBuild stateDir
72 when exists $ testLinuxBuild stateDir
73 pure exists
73 pure exists
@@ -85,7 +85,7 @@ containerSshPort = 2222
85startContainer :: MonadObelisk m => m ()
85startContainer :: MonadObelisk m => m ()
86startContainer = withSpinner "Starting VM builder" $
86startContainer = withSpinner "Starting VM builder" $
87 callProcessAndLogOutput (Debug, Debug) $
87 callProcessAndLogOutput (Debug, Debug) $
88− proc dockerPath ["start", containerName]
88+ proc "docker" ["start", containerName]
89
89
90-- | Creates the Docker container; assumes it does not exist.
90-- | Creates the Docker container; assumes it does not exist.
91setupNixDocker :: MonadObelisk m => FilePath -> m ()
91setupNixDocker :: MonadObelisk m => FilePath -> m ()
@@ -96,14 +96,14 @@ setupNixDocker stateDir = withSpinner ("Creating Docker container named " <> con
96
96
97 -- Create new SSH keys for this container
97 -- Create new SSH keys for this container
98 callProcessAndLogOutput (Debug, Error) $
98 callProcessAndLogOutput (Debug, Error) $
99− proc rmPath ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
99+ proc "rm" ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
100 callProcessAndLogOutput (Debug, Error) $
100 callProcessAndLogOutput (Debug, Error) $
101− proc sshKeygenPath ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
101+ proc "ssh-keygen" ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
102
102
103 -- Build the docker container (which uses the SSH keys in the 'ssh' folder)
103 -- Build the docker container (which uses the SSH keys in the 'ssh' folder)
104 containerId <- fmap T.strip $ readProcessAndLogStderr Error $
104 containerId <- fmap T.strip $ readProcessAndLogStderr Error $
105− proc dockerPath ["build", stateDir, "--quiet"]
105+ proc "docker" ["build", stateDir, "--quiet"]
106− callProcessAndLogOutput (Debug, Error) $ proc dockerPath
106+ callProcessAndLogOutput (Debug, Error) $ proc "docker"
107 [ "run"
107 [ "run"
108 , "--restart", "always"
108 , "--restart", "always"
109 , "--detach"
109 , "--detach"
@@ -155,9 +155,8 @@ testLinuxBuild :: MonadObelisk m => FilePath -> m ()
155testLinuxBuild stateDir
155testLinuxBuild stateDir
156 | System.Info.os == "linux" = failWith "Using the docker builder is not necessary on linux."
156 | System.Info.os == "linux" = failWith "Using the docker builder is not necessary on linux."
157 | otherwise = do
157 | otherwise = do
158− (exitCode, _stdout, stderr) <- readCreateProcessWithExitCode $ proc nixBuildExePath
158+ (exitCode, _stdout, stderr) <- readCreateProcessWithExitCode $ proc "nix-build"
159− [ "--no-out-link"
160− , "-E", "(import <nixpkgs> { system = \"x86_64-linux\"; }).writeText \"test\" builtins.currentTime"
159+ [ "-E", "(import <nixpkgs> { system = \"x86_64-linux\"; }).writeText \"test\" builtins.currentTime"
161 , "--builders", nixBuildersArgString stateDir
160 , "--builders", nixBuildersArgString stateDir
162 ]
161 ]
163 unless (exitCode == ExitSuccess) $ do
162 unless (exitCode == ExitSuccess) $ do
lib/executable-config/default.nix+19−37
@@ -2,44 +2,26 @@
2# configuration information into a canonical location. It also provides a haskell
2# configuration information into a canonical location. It also provides a haskell
3# package that can be used to retrieve the injected configuration on each supported
3# package that can be used to retrieve the injected configuration on each supported
4# platform.
4# platform.
5−{ lib
5+{ nixpkgs
6−, runCommand
6+, filterGitSource # TODO define this in obelisk
7−, obeliskCleanSource
8}:
7}:
9−
10−let
11− injectConfig = config: assets: runCommand "inject-config" {} (''
8+let injectConfig = config: assets: nixpkgs.runCommand "inject-config" {} (''
12− set -x
9+ set -x
13− mkdir -p $out
10+ mkdir -p $out
14− cp --no-preserve=mode -Lr "${assets}" $out/static
11+ cp --no-preserve=mode -Lr "${assets}" $out/static
15− chmod +w "$out"
12+ chmod +w "$out"
16− '' + lib.optionalString (!(builtins.isNull config)) ''
13+ '' + nixpkgs.lib.optionalString (!(builtins.isNull config)) ''
17− if ! mkdir $out/config; then
14+ if ! mkdir $out/config; then
18− 2>&1 echo config directory already exists or could not be created
15+ 2>&1 echo config directory already exists or could not be created
19− exit 1
16+ exit 1
20− fi
17+ fi
21− cp -a "${config}"/* "$out/config"
18+ cp -a "${config}"/* "$out/config"
22− # Needed for android deployments
23− find "$out/config" -type f -printf '%P\0' > "$out/config.files"
19+ find "$out/config" -type f -printf '%P\0' >"$out/config.files"
24− '');
20+ '');
25−in
21+in with nixpkgs.haskell.lib; {
26−
27−{
28− haskellOverlay = self: super:
22+ haskellOverlay = self: super: {
29− let
23+ obelisk-executable-config-lookup = self.callPackage (filterGitSource ./lookup) {};
30− pkgs = self.callPackage ({pkgs}: pkgs) {};
31− in {
32− obelisk-executable-config-lookup = pkgs.haskell.lib.overrideCabal
33− (self.callCabal2nix "obelisk-executable-config-lookup" (obeliskCleanSource ./lookup) {})
34− (drv: {
35− # Hack until https://github.com/NixOS/cabal2nix/pull/432 lands
36− libraryHaskellDepends = (drv.libraryHaskellDepends or [])
37− ++ pkgs.stdenv.lib.optionals (with pkgs.stdenv.hostPlatform; isAndroid && is32bit) [
38− self.android-activity
39− ];
40− });
41 };
24 };
42−
43 platforms = {
25 platforms = {
44 android = {
26 android = {
45 # Inject the given config directory into an android assets folder
27 # Inject the given config directory into an android assets folder
@@ -50,7 +32,7 @@ in
50 inject = injectConfig;
32 inject = injectConfig;
51 };
33 };
52 web = {
34 web = {
53− inject = self: self.callCabal2nix "obelisk-executable-config-inject" (obeliskCleanSource ./inject) {};
35+ inject = self: self.callCabal2nix "obelisk-executable-config-inject" (filterGitSource ./inject) {};
54 };
36 };
55 };
37 };
56}
38}
lib/executable-config/inject/obelisk-executable-config-inject.cabal+1−1
@@ -15,4 +15,4 @@ library
15 text
15 text
16
16
17 exposed-modules: Obelisk.ExecutableConfig.Inject
17 exposed-modules: Obelisk.ExecutableConfig.Inject
18− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
18+ ghc-options: -Wall
lib/executable-config/lookup/default.nixnew file+26
@@ -0,0 +1,26 @@
1+{ hostPlatform, ghc
2+, mkDerivation, base, base64-bytestring, bytestring, filepath, stdenv, text, transformers
3+, transformers-base, ref-tf, primitive, monad-control, reflex, reflex-dom
4+, jsaddle
5+, android-activity ? null, jsaddle-wkwebview ? null, ghcjs-dom ? null
6+}:
7+let isAndroid = hostPlatform.libc == "bionic";
8+ isIOS = hostPlatform.isDarwin && hostPlatform.isAarch64;
9+ isGhcjs = ghc.isGhcjs or false;
10+in mkDerivation {
11+ pname = "obelisk-executable-config-lookup";
12+ version = "0.1";
13+ src = ./.;
14+ libraryHaskellDepends = [
15+ base bytestring filepath text transformers transformers-base ref-tf primitive monad-control reflex reflex-dom jsaddle
16+ ] ++ (if isAndroid then [
17+ android-activity
18+ ] else if isIOS then [
19+ jsaddle-wkwebview
20+ ] else if isGhcjs then [
21+ ghcjs-dom
22+ ] else [
23+ ]);
24+ license = stdenv.lib.licenses.bsd3;
25+}
26+
lib/executable-config/lookup/obelisk-executable-config-lookup.cabal+8−11
@@ -27,22 +27,19 @@ library
27 build-depends: directory
27 build-depends: directory
28
28
29 build-depends:
29 build-depends:
30− base,
30+ base,
31 base64-bytestring,
31 base64-bytestring,
32 bytestring,
32 bytestring,
33 containers,
33 containers,
34− exceptions,
35 filepath,
34 filepath,
36− jsaddle,
37− mmorph,
38− monad-control,
39− mtl,
40− primitive,
41− ref-tf,
42− reflex-dom-core,
43− reflex,
44 text,
35 text,
36+ transformers,
45 transformers-base,
37 transformers-base,
46− transformers
38+ ref-tf,
39+ primitive,
40+ monad-control,
41+ reflex,
42+ reflex-dom,
43+ jsaddle
47
44
48 ghc-options: -Wall
45 ghc-options: -Wall
lib/executable-config/lookup/src-ghcjs/Obelisk/ExecutableConfig/Lookup.hs+8−17
@@ -15,37 +15,28 @@ import GHCJS.DOM.Document (getHead)
15import GHCJS.DOM.DOMStringMap (get)
15import GHCJS.DOM.DOMStringMap (get)
16import GHCJS.DOM.Element (getInnerHTML)
16import GHCJS.DOM.Element (getInnerHTML)
17import GHCJS.DOM.HTMLElement (HTMLElement(HTMLElement), getDataset)
17import GHCJS.DOM.HTMLElement (HTMLElement(HTMLElement), getDataset)
18−import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
18+import GHCJS.DOM.NodeList (item, getLength)
19import GHCJS.DOM.ParentNode (querySelectorAll)
19import GHCJS.DOM.ParentNode (querySelectorAll)
20−import GHCJS.DOM.Types (MonadJSM, Node(Node), castTo)
20+import GHCJS.DOM.Types (Node(Node), castTo)
21
21
22getConfigs :: IO (Map Text ByteString)
22getConfigs :: IO (Map Text ByteString)
23getConfigs = do
23getConfigs = do
24 Just doc <- currentDocument
24 Just doc <- currentDocument
25 Just hd <- getHead doc
25 Just hd <- getHead doc
26− nodes <- nodeListNodes =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
26+ nodes <- collToList =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
27 fmap Map.fromList $ for nodes $ \node -> do
27 fmap Map.fromList $ for nodes $ \node -> do
28 e <- castTo HTMLElement node >>= \case
28 e <- castTo HTMLElement node >>= \case
29 Nothing -> error "Found node with data attribute obelisk-executable-config-inject-key that is not an HTMLElement."
29 Nothing -> error "Found node with data attribute obelisk-executable-config-inject-key that is not an HTMLElement."
30 Just htmlE -> return htmlE
30 Just htmlE -> return htmlE
31 dataset <- getDataset e
31 dataset <- getDataset e
32 (,)
32 (,)
33− -- the key is camelCased: https://html.spec.whatwg.org/multipage/dom.html#dom-dataset
33+ <$> get dataset ("obelisk-executable-config-inject-key" :: Text)
34− <$> get dataset ("obeliskExecutableConfigInjectKey" :: Text)
35 <*> (fmap decodeOrFail (getInnerHTML e))
34 <*> (fmap decodeOrFail (getInnerHTML e))
36 where
35 where
36+ collToList es = do
37+ len <- getLength es
38+ list <- traverse (item es) $ if len == 0 then [] else [0..len-1]
39+ pure $ catMaybes list
37 decodeOrFail x = case B64.decode (T.encodeUtf8 x) of
40 decodeOrFail x = case B64.decode (T.encodeUtf8 x) of
38 Left e -> error ("Obelisk.ExecutableConfig.Lookup.getConfigs: error when decoding base64: " ++ e)
41 Left e -> error ("Obelisk.ExecutableConfig.Lookup.getConfigs: error when decoding base64: " ++ e)
39 Right x' -> x'
42 Right x' -> x'
40−
41−-- | Collect all nodes in the node list.
42−--
43−-- TODO: this and the version in obelisk-frontend should be
44−-- upstreamed to jsaddle.
45−nodeListNodes :: (IsNodeList l, MonadJSM m) => l -> m [Node]
46−nodeListNodes es = do
47− len <- getLength es
48− -- Warning! len is unsigned. If the NodeList is empty, we must avoid
49− -- accidentally traversing over [0..maxBound::Word]
50− nodes <- traverse (item es) $ if len == 0 then [] else [0..len-1]
51− pure $ catMaybes nodes
lib/executable-config/lookup/src-other/Obelisk/ExecutableConfig/Lookup.hs+8−1
@@ -1,11 +1,18 @@
1+{-# LANGUAGE LambdaCase #-}
1{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
2module Obelisk.ExecutableConfig.Lookup where
3module Obelisk.ExecutableConfig.Lookup where
3
4
4import Data.Map (Map)
5import Data.Map (Map)
6+import qualified Data.Map as Map
5import Data.Text (Text)
7import Data.Text (Text)
8+import qualified Data.Text as T
6import Data.ByteString (ByteString)
9import Data.ByteString (ByteString)
10+import qualified Data.ByteString as BS
11+import System.Directory
12+import System.FilePath
13+import Control.Monad
7
14
8−import Obelisk.Configs.Internal.Directory (getConfigsFromDirectory)
15+import Obelisk.Configs.Internal.Directory
9
16
10getConfigs :: IO (Map Text ByteString)
17getConfigs :: IO (Map Text ByteString)
11getConfigs = getConfigsFromDirectory "config"
18getConfigs = getConfigsFromDirectory "config"
lib/executable-config/lookup/src/Obelisk/Configs.hs+12−32
@@ -15,41 +15,26 @@ module Obelisk.Configs
15 , ConfigsT
15 , ConfigsT
16 , runConfigsT
16 , runConfigsT
17 , mapConfigsT
17 , mapConfigsT
18− , getTextConfig
19 ) where
18 ) where
20
19
21−import Control.Applicative (Alternative)
20+import Control.Applicative
22−import Control.Monad (MonadPlus)
21+import Control.Monad
23−import Control.Monad.Base (MonadBase)
22+import Control.Monad.Base
24−import Control.Monad.Catch (MonadThrow)
25−import Control.Monad.Fail (MonadFail)
26−import Control.Monad.Fix (MonadFix)
23+import Control.Monad.Fix
27−import Control.Monad.IO.Class (MonadIO)
28−import Control.Monad.Morph (MFunctor)
29−import Control.Monad.Primitive (PrimMonad, PrimState, primitive)
24+import Control.Monad.Primitive
30−import Control.Monad.Ref (MonadRef)
25+import Control.Monad.Ref
26+import Control.Monad.IO.Class
31−import Control.Monad.Trans (MonadTrans, lift)
27+import Control.Monad.Trans.Class
32−import Control.Monad.Trans.Control (MonadBaseControl)
28+import Control.Monad.Trans.Control
33−import Control.Monad.Trans.Reader (ReaderT (..), ask, mapReaderT)
29+import Control.Monad.Trans.Reader
34−import Control.Monad.Trans.State (StateT)
35−import qualified Control.Monad.Trans.State.Strict as Strict
36import Data.ByteString (ByteString)
30import Data.ByteString (ByteString)
37import Data.Map (Map)
31import Data.Map (Map)
38import qualified Data.Map as Map
32import qualified Data.Map as Map
39import Data.Text (Text)
33import Data.Text (Text)
40import qualified Data.Text.Encoding as T
34import qualified Data.Text.Encoding as T
41import Reflex
35import Reflex
42−import Reflex.Host.Class (MonadReflexCreateTrigger)
36+import Reflex.Host.Class
43−import Reflex.Dom.Core
37+import Reflex.Dom
44− ( DomBuilder
45− , DomRenderHook
46− , HasDocument
47− , HasJS
48− , HasJSContext
49− , Prerender (Client)
50− , StaticDomBuilderT
51− , prerender
52− )
53#ifndef ghcjs_HOST_OS
38#ifndef ghcjs_HOST_OS
54import Language.Javascript.JSaddle (MonadJSM)
39import Language.Javascript.JSaddle (MonadJSM)
55#endif
40#endif
@@ -76,8 +61,6 @@ instance HasConfigs m => HasConfigs (PostBuildT t m)
76instance HasConfigs m => HasConfigs (QueryT t q m)
61instance HasConfigs m => HasConfigs (QueryT t q m)
77instance HasConfigs m => HasConfigs (ReaderT r m)
62instance HasConfigs m => HasConfigs (ReaderT r m)
78instance HasConfigs m => HasConfigs (RequesterT t request response m)
63instance HasConfigs m => HasConfigs (RequesterT t request response m)
79−instance HasConfigs m => HasConfigs (StateT w m)
80−instance HasConfigs m => HasConfigs (Strict.StateT w m)
81instance HasConfigs m => HasConfigs (StaticDomBuilderT t m)
64instance HasConfigs m => HasConfigs (StaticDomBuilderT t m)
82instance HasConfigs m => HasConfigs (TriggerEventT t m)
65instance HasConfigs m => HasConfigs (TriggerEventT t m)
83
66
@@ -88,15 +71,12 @@ newtype ConfigsT m a = ConfigsT { unConfigsT :: ReaderT (Map Text ByteString) m
88 , Monad
71 , Monad
89 , MonadPlus
72 , MonadPlus
90 , Alternative
73 , Alternative
91− , MonadFail
92 , MonadFix
74 , MonadFix
93− , MonadThrow
94 , MonadIO
75 , MonadIO
95 , MonadBase m'
76 , MonadBase m'
96 , MonadBaseControl m'
77 , MonadBaseControl m'
97 , MonadRef
78 , MonadRef
98 , MonadTrans
79 , MonadTrans
99− , MFunctor
100 , DomBuilder t
80 , DomBuilder t
101 , MonadHold t
81 , MonadHold t
102 , MonadReflexCreateTrigger t
82 , MonadReflexCreateTrigger t
lib/frontend/obelisk-frontend.cabal+1−1
@@ -26,4 +26,4 @@ library
26 exposed-modules:
26 exposed-modules:
27 Obelisk.Frontend
27 Obelisk.Frontend
28 Obelisk.Frontend.Cookie
28 Obelisk.Frontend.Cookie
29− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
29+ ghc-options: -Wall
lib/frontend/src/Obelisk/Frontend.hs+19−26
@@ -5,7 +5,6 @@
5{-# LANGUAGE LambdaCase #-}
5{-# LANGUAGE LambdaCase #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE OverloadedStrings #-}
8−{-# LANGUAGE PackageImports #-}
9{-# LANGUAGE RankNTypes #-}
8{-# LANGUAGE RankNTypes #-}
10{-# LANGUAGE RecursiveDo #-}
9{-# LANGUAGE RecursiveDo #-}
11{-# LANGUAGE ScopedTypeVariables #-}
10{-# LANGUAGE ScopedTypeVariables #-}
@@ -20,7 +19,6 @@ module Obelisk.Frontend
20 , renderFrontendHtml
19 , renderFrontendHtml
21 , removeHTMLConfigs
20 , removeHTMLConfigs
22 , FrontendMode (..)
21 , FrontendMode (..)
23− , FrontendWidgetT
24 , module Obelisk.Frontend.Cookie
22 , module Obelisk.Frontend.Cookie
25 ) where
23 ) where
26
24
@@ -45,11 +43,11 @@ import qualified GHCJS.DOM as DOM
45import qualified GHCJS.DOM.Types as DOM
43import qualified GHCJS.DOM.Types as DOM
46import qualified GHCJS.DOM.History as DOM
44import qualified GHCJS.DOM.History as DOM
47import qualified GHCJS.DOM.Window as DOM
45import qualified GHCJS.DOM.Window as DOM
48−import Language.Javascript.JSaddle (MonadJSM, JSM, jsNull)
46+import Language.Javascript.JSaddle (JSM, jsNull)
49import GHCJS.DOM (currentDocument)
47import GHCJS.DOM (currentDocument)
50−import "ghcjs-dom" GHCJS.DOM.Document (getHead)
48+import GHCJS.DOM.Document (getHead)
51−import GHCJS.DOM.Node (Node, removeChild_)
49+import GHCJS.DOM.Node (removeChild_)
52−import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
50+import GHCJS.DOM.NodeList (item, getLength)
53import GHCJS.DOM.ParentNode (querySelectorAll)
51import GHCJS.DOM.ParentNode (querySelectorAll)
54import Obelisk.Frontend.Cookie
52import Obelisk.Frontend.Cookie
55import Obelisk.Route.Frontend
53import Obelisk.Route.Frontend
@@ -108,20 +106,13 @@ removeHTMLConfigs :: JSM ()
108removeHTMLConfigs = void $ runMaybeT $ do
106removeHTMLConfigs = void $ runMaybeT $ do
109 doc <- MaybeT currentDocument
107 doc <- MaybeT currentDocument
110 hd <- MaybeT $ getHead doc
108 hd <- MaybeT $ getHead doc
111− es <- nodeListNodes =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
109+ es <- collToList =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
112 for_ es $ removeChild_ hd
110 for_ es $ removeChild_ hd
113−
111+ where
114−-- | Collect all nodes in the node list.
112+ collToList es = do
115−--
116−-- TODO: this and the version in exe-config/ghcjs/lookup should be
117−-- upstreamed to jsaddle.
118−nodeListNodes :: (IsNodeList l, MonadJSM m) => l -> m [Node]
119−nodeListNodes es = do
120− len <- getLength es
113+ len <- getLength es
121− -- Warning! len is unsigned. If the NodeList is empty, we must avoid
114+ lst <- traverse (item es) $ take (fromIntegral len) $ [0..] -- fun with unsigned types ...
122− -- accidentally traversing over [0..maxBound::Word]
123− nodes <- traverse (item es) $ if len == 0 then [] else [0..len-1]
124− pure $ catMaybes nodes
115+ pure $ catMaybes lst
125
116
126setInitialRoute :: Bool -> JSM ()
117setInitialRoute :: Bool -> JSM ()
127setInitialRoute useHash = do
118setInitialRoute useHash = do
@@ -182,7 +173,7 @@ runFrontendWithConfigsAndCurrentRoute
182 -> Frontend (R frontendRoute)
173 -> Frontend (R frontendRoute)
183 -> JSM ()
174 -> JSM ()
184runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = do
175runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = do
185− let ve = validFullEncoder . hoistParse errorLeft (reviewEncoder (rPrism $ _FullRoute_Frontend . _ObeliskRoute_App))
176+ let ve = validFullEncoder . hoistParse errorLeft (prismEncoder (rPrism $ _FullRoute_Frontend . _ObeliskRoute_App))
186 errorLeft = \case
177 errorLeft = \case
187 Left _ -> error "runFrontend: Unexpected non-app ObeliskRoute reached the frontend. This shouldn't happen."
178 Left _ -> error "runFrontend: Unexpected non-app ObeliskRoute reached the frontend. This shouldn't happen."
188 Right x -> Identity x
179 Right x -> Identity x
@@ -199,6 +190,7 @@ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = d
199 , PrimMonad m
190 , PrimMonad m
200 , MonadSample DomTimeline (Performable m)
191 , MonadSample DomTimeline (Performable m)
201 , DOM.MonadJSM m
192 , DOM.MonadJSM m
193+ , Monad (Performable (Client (HydrationDomBuilderT s DomTimeline m)))
202 , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
194 , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
203 , MonadFix (Performable m)
195 , MonadFix (Performable m)
204 , MonadFix m
196 , MonadFix m
@@ -227,21 +219,22 @@ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = d
227 then runHydrationWidgetWithHeadAndBody (pure ()) w
219 then runHydrationWidgetWithHeadAndBody (pure ()) w
228 else runImmediateWidgetWithHeadAndBody w
220 else runImmediateWidgetWithHeadAndBody w
229
221
230−type FrontendWidgetT r = RoutedT DomTimeline r (SetRouteT DomTimeline r (RouteToUrlT r (ConfigsT (CookiesT (HydratableT (PostBuildT DomTimeline (StaticDomBuilderT DomTimeline (PerformEventT DomTimeline DomHost))))))))
231−
232renderFrontendHtml
222renderFrontendHtml
223+ :: ( t ~ DomTimeline
233− :: MonadIO m
224+ , MonadIO m
225+ , widget ~ RoutedT t r (SetRouteT t r (RouteToUrlT r (ConfigsT (CookiesT (PostBuildT t (StaticDomBuilderT t (PerformEventT t DomHost)))))))
226+ )
234 => Map Text ByteString
227 => Map Text ByteString
235 -> Cookies
228 -> Cookies
236 -> (r -> Text)
229 -> (r -> Text)
237 -> r
230 -> r
238 -> Frontend r
231 -> Frontend r
239− -> FrontendWidgetT r ()
232+ -> widget ()
240− -> FrontendWidgetT r ()
233+ -> widget ()
241 -> m ByteString
234 -> m ByteString
242renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
235renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
243 --TODO: We should probably have a "NullEventWriterT" or a frozen reflex timeline
236 --TODO: We should probably have a "NullEventWriterT" or a frozen reflex timeline
244− html <- fmap snd $ liftIO $ renderStatic $ runHydratableT $ fmap fst $ runCookiesT cookies $ runConfigsT configs $ flip runRouteToUrlT urlEnc $ runSetRouteT $ flip runRoutedT (pure route) $
237+ html <- fmap snd $ liftIO $ renderStatic $ fmap fst $ runCookiesT cookies $ runConfigsT configs $ flip runRouteToUrlT urlEnc $ runSetRouteT $ flip runRoutedT (pure route) $
245 el "html" $ do
238 el "html" $ do
246 el "head" $ do
239 el "head" $ do
247 baseTag
240 baseTag
lib/frontend/src/Obelisk/Frontend/Cookie.hs+1−2
@@ -6,7 +6,6 @@
6{-# LANGUAGE FlexibleInstances #-}
6{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE GeneralizedNewtypeDeriving #-}
7{-# LANGUAGE GeneralizedNewtypeDeriving #-}
8{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE MultiParamTypeClasses #-}
9−{-# LANGUAGE PackageImports #-}
10{-# LANGUAGE RankNTypes #-}
9{-# LANGUAGE RankNTypes #-}
11{-# LANGUAGE TypeFamilies #-}
10{-# LANGUAGE TypeFamilies #-}
12{-# LANGUAGE UndecidableInstances #-}
11{-# LANGUAGE UndecidableInstances #-}
@@ -23,7 +22,7 @@ import Data.Text.Encoding (encodeUtf8)
23import Reflex
22import Reflex
24import Reflex.Host.Class
23import Reflex.Host.Class
25import Reflex.Dom.Core
24import Reflex.Dom.Core
26−import "ghcjs-dom" GHCJS.DOM.Document (getCookie, Document)
25+import GHCJS.DOM.Document (getCookie, Document)
27import GHCJS.DOM.Types (MonadJSM)
26import GHCJS.DOM.Types (MonadJSM)
28import Web.Cookie
27import Web.Cookie
29
28
lib/route/README.mddeleted−6
@@ -1,6 +0,0 @@
1−# obelisk-route
2−
3−[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
4−[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://github.com/obsidiansystems/obelisk/blob/master/LICENSE)
5−
6−Robust URL management for single-page apps.
lib/route/obelisk-route.cabal+1−2
@@ -20,7 +20,6 @@ library
20 http-types,
20 http-types,
21 jsaddle,
21 jsaddle,
22 lens,
22 lens,
23− mmorph,
24 monad-control,
23 monad-control,
25 mtl,
24 mtl,
26 network-uri,
25 network-uri,
@@ -39,4 +38,4 @@ library
39 exposed-modules: Obelisk.Route
38 exposed-modules: Obelisk.Route
40 Obelisk.Route.TH
39 Obelisk.Route.TH
41 Obelisk.Route.Frontend
40 Obelisk.Route.Frontend
42− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
41+ ghc-options: -Wall -fwarn-redundant-constraints
lib/route/src/Obelisk/Route.hs+65−166
@@ -1,4 +1,3 @@
1−{-# LANGUAGE CPP #-}
2{-# LANGUAGE ApplicativeDo #-}
1{-# LANGUAGE ApplicativeDo #-}
3{-# LANGUAGE ConstraintKinds #-}
2{-# LANGUAGE ConstraintKinds #-}
4{-# LANGUAGE EmptyCase #-}
3{-# LANGUAGE EmptyCase #-}
@@ -6,6 +5,7 @@
6{-# LANGUAGE FlexibleContexts #-}
5{-# LANGUAGE FlexibleContexts #-}
7{-# LANGUAGE FlexibleInstances #-}
6{-# LANGUAGE FlexibleInstances #-}
8{-# LANGUAGE GADTs #-}
7{-# LANGUAGE GADTs #-}
8+{-# LANGUAGE KindSignatures #-}
9{-# LANGUAGE LambdaCase #-}
9{-# LANGUAGE LambdaCase #-}
10{-# LANGUAGE MultiParamTypeClasses #-}
10{-# LANGUAGE MultiParamTypeClasses #-}
11{-# LANGUAGE OverloadedStrings #-}
11{-# LANGUAGE OverloadedStrings #-}
@@ -20,11 +20,8 @@
20{-# LANGUAGE ViewPatterns #-}
20{-# LANGUAGE ViewPatterns #-}
21module Obelisk.Route
21module Obelisk.Route
22 ( R
22 ( R
23− , (:.)
24− , (?/)
25− , hoistR
26− , pattern (:.)
27 , pattern (:/)
23 , pattern (:/)
24+ , hoistR
28 , PageName
25 , PageName
29 , PathQuery
26 , PathQuery
30 , Encoder
27 , Encoder
@@ -46,11 +43,7 @@ module Obelisk.Route
46 , checkEnum1EncoderFunc
43 , checkEnum1EncoderFunc
47 , unitEncoder
44 , unitEncoder
48 , pathOnlyEncoder
45 , pathOnlyEncoder
49− , addPathSegmentEncoder
50− , pathParamEncoder
51− , pathLiteralEncoder
52 , singletonListEncoder
46 , singletonListEncoder
53− , packTextEncoder
54 , unpackTextEncoder
47 , unpackTextEncoder
55 , prefixTextEncoder
48 , prefixTextEncoder
56 , unsafeTshowEncoder
49 , unsafeTshowEncoder
@@ -61,7 +54,6 @@ module Obelisk.Route
61 , justEncoder
54 , justEncoder
62 , nothingEncoder
55 , nothingEncoder
63 , isoEncoder
56 , isoEncoder
64− , viewEncoder
65 , wrappedEncoder
57 , wrappedEncoder
66 , unwrappedEncoder
58 , unwrappedEncoder
67 , listToNonEmptyEncoder
59 , listToNonEmptyEncoder
@@ -70,7 +62,6 @@ module Obelisk.Route
70 , toListMapEncoder
62 , toListMapEncoder
71 , shadowEncoder
63 , shadowEncoder
72 , prismEncoder
64 , prismEncoder
73− , reviewEncoder
74 , rPrism
65 , rPrism
75 , _R
66 , _R
76 , obeliskRouteEncoder
67 , obeliskRouteEncoder
@@ -135,24 +126,20 @@ import Control.Lens
135 , Prism'
126 , Prism'
136 , prism'
127 , prism'
137 , re
128 , re
138− , review
139 , view
129 , view
140 , Wrapped (..)
130 , Wrapped (..)
141 )
131 )
142import Control.Monad.Except
132import Control.Monad.Except
133+import Control.Monad.Writer (execWriter, tell)
143import qualified Control.Monad.State.Strict as State
134import qualified Control.Monad.State.Strict as State
144import Control.Monad.Trans (lift)
135import Control.Monad.Trans (lift)
145−import Control.Monad.Writer (execWriter, tell)
146−import Data.Aeson (FromJSON, ToJSON)
147−import qualified Data.Aeson as Aeson
148import qualified Data.ByteString as BS
136import qualified Data.ByteString as BS
149import qualified Data.ByteString.Lazy as BSL
137import qualified Data.ByteString.Lazy as BSL
138+import Data.Dependent.Sum (DSum (..))
150import Data.Dependent.Map (DMap)
139import Data.Dependent.Map (DMap)
151import qualified Data.Dependent.Map as DMap
140import qualified Data.Dependent.Map as DMap
152−import Data.Dependent.Sum (DSum (..))
153import Data.Either.Validation (Validation (..))
141import Data.Either.Validation (Validation (..))
154import Data.Foldable
142import Data.Foldable
155−import Data.Functor (($>))
156import Data.Functor.Sum
143import Data.Functor.Sum
157import Data.GADT.Compare
144import Data.GADT.Compare
158import Data.GADT.Compare.TH
145import Data.GADT.Compare.TH
@@ -165,18 +152,18 @@ import Data.Monoid ((<>))
165import Data.Set (Set)
152import Data.Set (Set)
166import qualified Data.Set as Set
153import qualified Data.Set as Set
167import Data.Some (Some(Some))
154import Data.Some (Some(Some))
168−import Data.Tabulation
169import Data.Text (Text)
155import Data.Text (Text)
170import qualified Data.Text as T
156import qualified Data.Text as T
171import qualified Data.Text.Encoding as T
157import qualified Data.Text.Encoding as T
172−import Data.Text.Lens (IsText, packed, unpacked)
173−import Data.Type.Equality
174import Data.Universe
158import Data.Universe
175import Data.Universe.Some
159import Data.Universe.Some
176import Network.HTTP.Types.URI
160import Network.HTTP.Types.URI
177import qualified Numeric.Lens
161import qualified Numeric.Lens
178import Obelisk.Route.TH
162import Obelisk.Route.TH
179import Text.Read (readMaybe)
163import Text.Read (readMaybe)
164+import Data.Tabulation
165+import qualified Data.Aeson as Aeson
166+import Data.Aeson (FromJSON, ToJSON)
180
167
181-- Design goals:
168-- Design goals:
182-- No start-up time on the frontend (not yet met)
169-- No start-up time on the frontend (not yet met)
@@ -202,16 +189,10 @@ import Text.Read (readMaybe)
202
189
203type R f = DSum f Identity --TODO: Better name
190type R f = DSum f Identity --TODO: Better name
204
191
205−-- | Convenience builder for an 'R' using 'Identity' for the functor.
206−pattern (:/) :: f a -> a -> R f
207−pattern a :/ b = a :=> Identity b
208{-# COMPLETE (:/) #-}
192{-# COMPLETE (:/) #-}
209infixr 5 :/
193infixr 5 :/
210−
211−-- | Like '(:/)' but adds a 'Just' wrapper around the right-hand side.
212−(?/) :: f (Maybe a) -> a -> R f
194+pattern (:/) :: f a -> a -> R f
213−r ?/ a = r :/ Just a
195+pattern a :/ b = a :=> Identity b
214−infixr 5 ?/
215
196
216mapSome :: (forall a. f a -> g a) -> Some f -> Some g
197mapSome :: (forall a. f a -> g a) -> Some f -> Some g
217mapSome f (Some a) = Some $ f a
198mapSome f (Some a) = Some $ f a
@@ -219,60 +200,6 @@ mapSome f (Some a) = Some $ f a
219hoistR :: (forall x. f x -> g x) -> R f -> R g
200hoistR :: (forall x. f x -> g x) -> R f -> R g
220hoistR f (x :=> Identity y) = f x :/ y
201hoistR f (x :=> Identity y) = f x :/ y
221
202
222−--------------------------------------------------------------------------------
223−-- Dealing with pairs (i.e. non-dependently-typed subroutes/paths)
224−--------------------------------------------------------------------------------
225−
226−infixr 5 :.
227−type (:.) = (,)
228−
229−#ifdef __GLASGOW_HASKELL__
230−#if __GLASGOW_HASKELL__ >= 810
231−{-# COMPLETE (:.) #-}
232−#else
233−{-# WARNING (:.)
234− [ "Use of this pattern in GHC < 8.10 will result in spurious non-exhaustive warnings at every use site."
235− , "We cannot provide a COMPLETE pragma to silence these due to a GHC bug: https://gitlab.haskell.org/ghc/ghc/issues/17729."
236− , "The bug hides incompleteness warnings for all two tuples when the COMPLETE pattern is in scope."
237− , "Instead, you should use (,) directly until you can switch to GHC >= 8.10, where the COMPLETE pragma is reinstated."
238− ]
239− #-}
240−#endif
241−#endif
242−pattern (:.) :: a -> b -> a :. b
243−pattern a :. b = (a, b)
244−
245−addPathSegmentEncoder
246− :: ( Applicative check
247− , MonadError Text parse
248− )
249− => Encoder check parse (Text, PageName) PageName
250−addPathSegmentEncoder = unsafeMkEncoder $ EncoderImpl
251− { _encoderImpl_encode = \(ph, (pt, q)) -> (ph : pt, q)
252− , _encoderImpl_decode = \(p, q) -> case p of
253− [] -> throwError "Expected a path segment"
254− ph : pt -> pure (ph, (pt, q))
255− }
256−
257−pathParamEncoder
258− :: forall check parse item rest.
259− ( Applicative check
260− , MonadError Text parse
261− )
262− => Encoder check parse item Text
263− -> Encoder check parse rest PageName
264− -> Encoder check parse (item :. rest) PageName
265−pathParamEncoder itemUnchecked restUnchecked = addPathSegmentEncoder . bimap itemUnchecked restUnchecked
266−
267−pathLiteralEncoder
268− :: ( Applicative check
269− , MonadError Text parse
270− )
271− => Text
272− -> Encoder check parse a PageName
273− -> Encoder check parse a PageName
274−pathLiteralEncoder t e = addPathSegmentEncoder . bimap (unitEncoder t) e . coidl
275−
276--------------------------------------------------------------------------------
203--------------------------------------------------------------------------------
277-- Encoder fundamentals
204-- Encoder fundamentals
278--------------------------------------------------------------------------------
205--------------------------------------------------------------------------------
@@ -304,13 +231,13 @@ decode e x = runIdentity (tryDecode e x)
304-- | Once an 'Encoder' has been checked, so that its check monad has become 'Identity', even if the same is not true of the
231-- | Once an 'Encoder' has been checked, so that its check monad has become 'Identity', even if the same is not true of the
305-- parse monad, we may still attempt to decode with it in its parse monad.
232-- parse monad, we may still attempt to decode with it in its parse monad.
306tryDecode :: Encoder Identity parse decoded encoded -> encoded -> parse decoded
233tryDecode :: Encoder Identity parse decoded encoded -> encoded -> parse decoded
307−tryDecode (Encoder (Identity impl)) = _encoderImpl_decode impl
234+tryDecode (Encoder (Identity impl)) x = _encoderImpl_decode impl x
308
235
309−-- | Similar to 'decode', once an encoder has been checked so that its check monad is Identity, it
236+-- | Similar to 'decode' above, once an encoder has been checked so that its check monad is Identity, it
310-- can be used to actually encode by using this. Note that while there's no constraint on the parse monad here,
237-- can be used to actually encode by using this. Note that while there's no constraint on the parse monad here,
311-- one should usually be applying decode and encode to the same 'Encoder'
238-- one should usually be applying decode and encode to the same 'Encoder'
312encode :: Encoder Identity parse decoded encoded -> decoded -> encoded
239encode :: Encoder Identity parse decoded encoded -> decoded -> encoded
313−encode (Encoder (Identity impl)) = _encoderImpl_encode impl
240+encode (Encoder (Identity impl)) x = _encoderImpl_encode impl x
314
241
315-- | This is a primitive used to build encoders which can't fail to check. It should not be used unless one is
242-- | This is a primitive used to build encoders which can't fail to check. It should not be used unless one is
316-- reasonably certain that the law given for 'EncoderImpl' above holds.
243-- reasonably certain that the law given for 'EncoderImpl' above holds.
@@ -357,7 +284,7 @@ instance Monad parse => Bifunctor (,) (EncoderImpl parse) (EncoderImpl parse) (E
357 }
284 }
358
285
359instance (Monad parse, Applicative check) => Braided (Encoder check parse) (,) where
286instance (Monad parse, Applicative check) => Braided (Encoder check parse) (,) where
360− braid = viewEncoder (iso swap swap)
287+ braid = isoEncoder (iso swap swap)
361
288
362
289
363instance (Applicative check, Monad parse) => PFunctor (,) (Encoder check parse) (Encoder check parse) where
290instance (Applicative check, Monad parse) => PFunctor (,) (Encoder check parse) (Encoder check parse) where
@@ -393,11 +320,11 @@ instance (Monad parse, Applicative check) => Bifunctor Either (Encoder check par
393 bimap f g = Encoder $ liftA2 bimap (unEncoder f) (unEncoder g)
320 bimap f g = Encoder $ liftA2 bimap (unEncoder f) (unEncoder g)
394
321
395instance (Applicative check, Monad parse) => Associative (Encoder check parse) Either where
322instance (Applicative check, Monad parse) => Associative (Encoder check parse) Either where
396− associate = viewEncoder (iso (associate @(->) @Either) disassociate)
323+ associate = isoEncoder (iso (associate @(->) @Either) disassociate)
397− disassociate = viewEncoder (iso disassociate associate)
324+ disassociate = isoEncoder (iso disassociate associate)
398
325
399instance (Monad parse, Applicative check) => Braided (Encoder check parse) Either where
326instance (Monad parse, Applicative check) => Braided (Encoder check parse) Either where
400− braid = viewEncoder (iso swap swap)
327+ braid = isoEncoder (iso swap swap)
401
328
402
329
403
330
@@ -451,17 +378,17 @@ instance (Applicative check, Monad parse) => Monoidal (Encoder check parse) (,)
451--------------------------------------------------------------------------------
378--------------------------------------------------------------------------------
452
379
453-- | Given a valid 'Iso' from lens, construct an 'Encoder'
380-- | Given a valid 'Iso' from lens, construct an 'Encoder'
454−viewEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
381+isoEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
455−viewEncoder f = unsafeMkEncoder $ EncoderImpl
382+isoEncoder f = unsafeMkEncoder $ EncoderImpl
456 { _encoderImpl_encode = view f
383 { _encoderImpl_encode = view f
457 , _encoderImpl_decode = pure . view (from f)
384 , _encoderImpl_decode = pure . view (from f)
458 }
385 }
459
386
460wrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse (Unwrapped a) a
387wrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse (Unwrapped a) a
461−wrappedEncoder = viewEncoder $ from _Wrapped'
388+wrappedEncoder = isoEncoder $ from _Wrapped'
462
389
463unwrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse a (Unwrapped a)
390unwrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse a (Unwrapped a)
464−unwrappedEncoder = viewEncoder $ _Wrapped'
391+unwrappedEncoder = isoEncoder _Wrapped'
465
392
466maybeToEitherEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a) (Either () a)
393maybeToEitherEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a) (Either () a)
467maybeToEitherEncoder = unsafeMkEncoder $ EncoderImpl
394maybeToEitherEncoder = unsafeMkEncoder $ EncoderImpl
@@ -486,11 +413,11 @@ maybeEncoder f g = shadowEncoder f g . maybeToEitherEncoder
486
413
487-- | Encode a value by simply applying 'Just'
414-- | Encode a value by simply applying 'Just'
488justEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a (Maybe a)
415justEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a (Maybe a)
489−justEncoder = reviewEncoder _Just
416+justEncoder = prismEncoder _Just
490
417
491-- | Encode () to 'Nothing'.
418-- | Encode () to 'Nothing'.
492nothingEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse () (Maybe a)
419nothingEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse () (Maybe a)
493−nothingEncoder = reviewEncoder _Nothing
420+nothingEncoder = prismEncoder _Nothing
494
421
495someConstEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Const a)) a
422someConstEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Const a)) a
496someConstEncoder = unsafeMkEncoder $ EncoderImpl
423someConstEncoder = unsafeMkEncoder $ EncoderImpl
@@ -555,11 +482,11 @@ pathComponentEncoder f = Encoder $ do
555 unEncoder (pathComponentEncoderImpl (enum1Encoder (extractPathSegment . f)) f')
482 unEncoder (pathComponentEncoderImpl (enum1Encoder (extractPathSegment . f)) f')
556
483
557pathComponentEncoderImpl :: forall check parse p. (Monad check, Monad parse)
484pathComponentEncoderImpl :: forall check parse p. (Monad check, Monad parse)
558− => Encoder check parse (Some p) (Maybe Text)
485+ => (Encoder check parse (Some p) (Maybe Text))
559 -> (forall a. p a -> Encoder Identity parse a PageName)
486 -> (forall a. p a -> Encoder Identity parse a PageName)
560 -> Encoder check parse (R p) PageName
487 -> Encoder check parse (R p) PageName
561−pathComponentEncoderImpl =
488+pathComponentEncoderImpl this rest =
562− chainEncoder (lensEncoder (\(_, b) a -> (a, b)) Prelude.fst consEncoder)
489+ chainEncoder (lensEncoder (\(_, b) a -> (a, b)) Prelude.fst consEncoder) this rest
563
490
564--NOTE: Naming convention in this module is to always talk about things in the *encoding* direction, never in the *decoding* direction
491--NOTE: Naming convention in this module is to always talk about things in the *encoding* direction, never in the *decoding* direction
565
492
@@ -578,9 +505,8 @@ chainEncoder cons this rest = Encoder $ do
578 pure $ EncoderImpl
505 pure $ EncoderImpl
579 { _encoderImpl_decode = \v -> do
506 { _encoderImpl_decode = \v -> do
580 (here, following) <- _encoderImpl_decode consValid v
507 (here, following) <- _encoderImpl_decode consValid v
581− _encoderImpl_decode thisValid here >>= \case
508+ Some r <- _encoderImpl_decode thisValid here
582− Some r ->
583− (r :/) <$> _encoderImpl_decode (runIdentity . unEncoder $ rest r) following
509+ (r :/) <$> _encoderImpl_decode (runIdentity . unEncoder $ rest r) following
584 , _encoderImpl_encode = \(r :/ s) ->
510 , _encoderImpl_encode = \(r :/ s) ->
585 _encoderImpl_encode consValid
511 _encoderImpl_encode consValid
586 ( _encoderImpl_encode thisValid $ Some r
512 ( _encoderImpl_encode thisValid $ Some r
@@ -775,11 +701,11 @@ prefixNonemptyTextEncoder p = Encoder $ pure $ EncoderImpl
775 Just stripped -> pure stripped
701 Just stripped -> pure stripped
776 }
702 }
777
703
778−packTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse String text
704+unpackTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse Text String
779−packTextEncoder = isoEncoder packed
705+unpackTextEncoder = Encoder $ pure $ EncoderImpl
780−
706+ { _encoderImpl_encode = T.unpack
781−unpackTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse text String
707+ , _encoderImpl_decode = pure . T.pack
782−unpackTextEncoder = isoEncoder unpacked
708+ }
783
709
784toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
710toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
785toListMapEncoder = Encoder $ pure $ EncoderImpl
711toListMapEncoder = Encoder $ pure $ EncoderImpl
@@ -815,7 +741,7 @@ rPrism
815 :: forall f f'
741 :: forall f f'
816 . (forall a. Prism' (f a) (f' a))
742 . (forall a. Prism' (f a) (f' a))
817 -> Prism' (R f) (R f')
743 -> Prism' (R f) (R f')
818−rPrism = dSumPrism
744+rPrism p = dSumPrism p
819
745
820dSumPrism'
746dSumPrism'
821 :: forall f g a
747 :: forall f g a
@@ -827,7 +753,7 @@ dSumGEqPrism
827 :: GEq f
753 :: GEq f
828 => f a
754 => f a
829 -> Prism' (DSum f g) (g a)
755 -> Prism' (DSum f g) (g a)
830−dSumGEqPrism variant = dSumPrism' $ prism' (\Refl -> variant) (geq variant)
756+dSumGEqPrism variant = dSumPrism' $ prism' (\Refl -> variant) (\x -> geq variant x)
831
757
832-- | Given a 'tag :: f a', make a prism for 'R f'. This generalizes the usual
758-- | Given a 'tag :: f a', make a prism for 'R f'. This generalizes the usual
833-- prisms for a sum type (the ones that 'mkPrisms' would make), just as 'R'
759-- prisms for a sum type (the ones that 'mkPrisms' would make), just as 'R'
@@ -844,19 +770,12 @@ _R variant = dSumGEqPrism variant . iso runIdentity Identity
844
770
845-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
771-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
846-- if the prism doesn't match.
772-- if the prism doesn't match.
847−--
848−-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
849−-- (i.e. 'reviewEncoder' is a contravariant functor from the category of prisms to the category of encoders),
850−-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
851−-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
852−-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
853−-- reverse direction. In short @reviewEncoder (f . g) = reviewEncoder g . reviewEncoder f@.
854−reviewEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
773+prismEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
855−reviewEncoder p = unsafeMkEncoder $ EncoderImpl
774+prismEncoder p = unsafeMkEncoder $ EncoderImpl
856− { _encoderImpl_encode = review p
775+ { _encoderImpl_encode = (^. re p)
857 , _encoderImpl_decode = \r -> case r ^? p of
776 , _encoderImpl_decode = \r -> case r ^? p of
858 Just a -> pure a
777 Just a -> pure a
859− Nothing -> throwError "reviewEncoder: value is not present in the prism"
778+ Nothing -> throwError "prismEncoder: value is not present in the prism"
860 }
779 }
861
780
862-- | A URL path and query string, in which trailing slashes don't matter in the path
781-- | A URL path and query string, in which trailing slashes don't matter in the path
@@ -914,7 +833,7 @@ instance (GCompare br, GCompare fr) => GCompare (FullRoute br fr) where
914 gcompare (FullRoute_Frontend x) (FullRoute_Frontend y) = gcompare x y
833 gcompare (FullRoute_Frontend x) (FullRoute_Frontend y) = gcompare x y
915
834
916instance (UniverseSome br, UniverseSome fr) => UniverseSome (FullRoute br fr) where
835instance (UniverseSome br, UniverseSome fr) => UniverseSome (FullRoute br fr) where
917− universeSome = [Some (FullRoute_Backend x) | Some x <- universeSome]
836+ universeSome = [Some (FullRoute_Backend x) | Some x <- universeSome]
918 ++ [Some (FullRoute_Frontend x) | Some x <- universeSome]
837 ++ [Some (FullRoute_Frontend x) | Some x <- universeSome]
919
838
920-- | Build the typical top level application route encoder from a route for handling 404's,
839-- | Build the typical top level application route encoder from a route for handling 404's,
@@ -994,9 +913,9 @@ obeliskRouteSegment r appRouteSegment = case r of
994-- be combined with other such segment encoders before 'pathComponentEncoder' turns it into a proper 'Encoder'.
913-- be combined with other such segment encoders before 'pathComponentEncoder' turns it into a proper 'Encoder'.
995resourceRouteSegment :: (MonadError Text check, MonadError Text parse) => ResourceRoute a -> SegmentResult check parse a
914resourceRouteSegment :: (MonadError Text check, MonadError Text parse) => ResourceRoute a -> SegmentResult check parse a
996resourceRouteSegment = \case
915resourceRouteSegment = \case
997− ResourceRoute_Static -> PathSegment "static" pathOnlyEncoderIgnoringQuery
916+ ResourceRoute_Static -> PathSegment "static" $ pathOnlyEncoderIgnoringQuery
998− ResourceRoute_Ghcjs -> PathSegment "ghcjs" pathOnlyEncoder
917+ ResourceRoute_Ghcjs -> PathSegment "ghcjs" $ pathOnlyEncoder
999− ResourceRoute_JSaddleWarp -> PathSegment "jsaddle" jsaddleWarpRouteEncoder
918+ ResourceRoute_JSaddleWarp -> PathSegment "jsaddle" $ jsaddleWarpRouteEncoder
1000 ResourceRoute_Version -> PathSegment "version" $ unitEncoder mempty
919 ResourceRoute_Version -> PathSegment "version" $ unitEncoder mempty
1001
920
1002data JSaddleWarpRoute :: * -> * where
921data JSaddleWarpRoute :: * -> * where
@@ -1008,7 +927,7 @@ jsaddleWarpRouteEncoder :: (MonadError Text check, MonadError Text parse) => Enc
1008jsaddleWarpRouteEncoder = pathComponentEncoder $ \case
927jsaddleWarpRouteEncoder = pathComponentEncoder $ \case
1009 JSaddleWarpRoute_JavaScript -> PathSegment "jsaddle.js" $ unitEncoder mempty
928 JSaddleWarpRoute_JavaScript -> PathSegment "jsaddle.js" $ unitEncoder mempty
1010 JSaddleWarpRoute_WebSocket -> PathEnd $ unitEncoder mempty
929 JSaddleWarpRoute_WebSocket -> PathEnd $ unitEncoder mempty
1011− JSaddleWarpRoute_Sync -> PathSegment "sync" pathOnlyEncoder
930+ JSaddleWarpRoute_Sync -> PathSegment "sync" $ pathOnlyEncoder
1012
931
1013instance GShow appRoute => GShow (ObeliskRoute appRoute) where
932instance GShow appRoute => GShow (ObeliskRoute appRoute) where
1014 gshowsPrec prec = \case
933 gshowsPrec prec = \case
@@ -1039,8 +958,8 @@ someSumEncoder = Encoder $ pure $ EncoderImpl
1039
958
1040data Void1 :: * -> * where {}
959data Void1 :: * -> * where {}
1041
960
1042−instance UniverseSome Void1 where
961+instance Universe (Some Void1) where
1043− universeSome = []
962+ universe = []
1044
963
1045void1Encoder :: (Applicative check, MonadError Text parse) => Encoder check parse (Some Void1) a
964void1Encoder :: (Applicative check, MonadError Text parse) => Encoder check parse (Some Void1) a
1046void1Encoder = Encoder $ pure $ EncoderImpl
965void1Encoder = Encoder $ pure $ EncoderImpl
@@ -1052,6 +971,17 @@ void1Encoder = Encoder $ pure $ EncoderImpl
1052instance GShow Void1 where
971instance GShow Void1 where
1053 gshowsPrec _ = \case {}
972 gshowsPrec _ = \case {}
1054
973
974+concat <$> mapM deriveRouteComponent
975+ [ ''ResourceRoute
976+ , ''JSaddleWarpRoute
977+ , ''IndexOnlyRoute
978+ ]
979+
980+makePrisms ''ObeliskRoute
981+makePrisms ''FullRoute
982+deriveGEq ''Void1
983+deriveGCompare ''Void1
984+
1055-- | Given a backend route and a checked route encoder, render the route (path
985-- | Given a backend route and a checked route encoder, render the route (path
1056-- and query string). See 'checkEncoder' for how to produce a checked encoder.
986-- and query string). See 'checkEncoder' for how to produce a checked encoder.
1057renderBackendRoute
987renderBackendRoute
@@ -1084,11 +1014,11 @@ readShowEncoder :: (MonadError Text parse, Read a, Show a, Applicative check) =>
1084readShowEncoder = singlePathSegmentEncoder . unsafeTshowEncoder
1014readShowEncoder = singlePathSegmentEncoder . unsafeTshowEncoder
1085
1015
1086integralEncoder :: (MonadError Text parse, Applicative check, Integral a) => Encoder check parse a Integer
1016integralEncoder :: (MonadError Text parse, Applicative check, Integral a) => Encoder check parse a Integer
1087−integralEncoder = reviewEncoder Numeric.Lens.integral
1017+integralEncoder = prismEncoder (Numeric.Lens.integral)
1088
1018
1089pathSegmentEncoder :: (MonadError Text parse, Applicative check, Cons as as a a) =>
1019pathSegmentEncoder :: (MonadError Text parse, Applicative check, Cons as as a a) =>
1090 Encoder check parse (a, (as, b)) (as, b)
1020 Encoder check parse (a, (as, b)) (as, b)
1091−pathSegmentEncoder = first (reviewEncoder _Cons) . disassociate
1021+pathSegmentEncoder = first (prismEncoder _Cons) . disassociate
1092
1022
1093newtype Decoder check parse b a = Decoder { toEncoder :: Encoder check parse a b }
1023newtype Decoder check parse b a = Decoder { toEncoder :: Encoder check parse a b }
1094
1024
@@ -1116,12 +1046,12 @@ dmapEncoder keyEncoder' valueEncoderFor = unsafeEncoder $ do
1116 , encode (toEncoder (DMap.findWithDefault (error . keyError $ gshow k') k' valueDecoders)) v'
1046 , encode (toEncoder (DMap.findWithDefault (error . keyError $ gshow k') k' valueDecoders)) v'
1117 )
1047 )
1118 , _encoderImpl_decode = \m -> fmap DMap.fromList . forM (Map.toList m) $ \(k,v) -> do
1048 , _encoderImpl_decode = \m -> fmap DMap.fromList . forM (Map.toList m) $ \(k,v) -> do
1119− tryDecode keyEncoder k >>= \case
1049+ Some (k' :: k' t) <- tryDecode keyEncoder k
1120− Some (k' :: k' t) -> case DMap.lookup k' valueDecoders of
1050+ case DMap.lookup k' valueDecoders of
1121− Nothing -> throwError . T.pack . keyError $ gshow k'
1051+ Nothing -> throwError . T.pack . keyError $ gshow k'
1122− Just (Decoder e) -> do
1052+ Just (Decoder e) -> do
1123− v' <- tryDecode e v
1053+ v' <- tryDecode e v
1124− return (k' :=> Identity v')
1054+ return (k' :=> Identity v')
1125 }
1055 }
1126
1056
1127fieldMapEncoder :: forall check parse r.
1057fieldMapEncoder :: forall check parse r.
@@ -1159,7 +1089,7 @@ pathFieldEncoder fieldEncoder = unsafeEncoder $ do
1159 fieldEncoderPure f = toEncoder (DMap.findWithDefault (error "bad") f fieldEncoderPureMap)
1089 fieldEncoderPure f = toEncoder (DMap.findWithDefault (error "bad") f fieldEncoderPureMap)
1160 pure $ EncoderImpl
1090 pure $ EncoderImpl
1161 { _encoderImpl_encode = \(x, rest) -> execWriter $ do
1091 { _encoderImpl_encode = \(x, rest) -> execWriter $ do
1162− _ <- traverseWithField (\f x_i -> tell (pure $ encode (fieldEncoderPure f) x_i) $> x_i) x
1092+ _ <- traverseWithField (\f x_i -> tell (pure $ encode (fieldEncoderPure f) x_i) *> pure x_i) x
1163 tell rest
1093 tell rest
1164 , _encoderImpl_decode = State.runStateT $ tabulateFieldsA $ \f -> State.get >>= \case
1094 , _encoderImpl_decode = State.runStateT $ tabulateFieldsA $ \f -> State.get >>= \case
1165 [] -> throwError $ T.pack "not enough path components"
1095 [] -> throwError $ T.pack "not enough path components"
@@ -1195,34 +1125,3 @@ byteStringsToPageName p q =
1195 in decode pageNameEncoder' (T.unpack (T.decodeUtf8 p), T.unpack (T.decodeUtf8 q))
1125 in decode pageNameEncoder' (T.unpack (T.decodeUtf8 p), T.unpack (T.decodeUtf8 q))
1196
1126
1197--TODO: decodeURIComponent as appropriate
1127--TODO: decodeURIComponent as appropriate
1198−
1199−
1200−{-# DEPRECATED isoEncoder "Instead of 'isoEncoder f', use 'viewEncoder f'" #-}
1201−-- | Given a valid 'Iso' from lens, construct an 'Encoder'
1202−isoEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
1203−isoEncoder = viewEncoder
1204−
1205−{-# DEPRECATED prismEncoder "Instead of 'prismEncoder f', use 'reviewEncoder f'" #-}
1206−-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
1207−-- if the prism doesn't match.
1208−--
1209−-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
1210−-- (i.e. 'prismEncoder' is a contravariant functor from the category of prisms to the category of encoders),
1211−-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
1212−-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
1213−-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
1214−-- reverse direction. In short @prismEncoder (f . g) = prismEncoder g . prismEncoder f@.
1215−prismEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
1216−prismEncoder = reviewEncoder
1217−
1218−
1219−concat <$> mapM deriveRouteComponent
1220− [ ''ResourceRoute
1221− , ''JSaddleWarpRoute
1222− , ''IndexOnlyRoute
1223− ]
1224−
1225−makePrisms ''ObeliskRoute
1226−makePrisms ''FullRoute
1227−deriveGEq ''Void1
1228−deriveGCompare ''Void1
lib/route/src/Obelisk/Route/Frontend.hs+46−150
@@ -1,24 +1,28 @@
1−{-# LANGUAGE CPP #-}
2{-# LANGUAGE ApplicativeDo #-}
1{-# LANGUAGE ApplicativeDo #-}
2+{-# LANGUAGE CPP #-}
3+{-# LANGUAGE RecursiveDo #-}
4+{-# LANGUAGE StandaloneDeriving #-}
3{-# LANGUAGE ConstraintKinds #-}
5{-# LANGUAGE ConstraintKinds #-}
4−{-# LANGUAGE DataKinds #-}
5{-# LANGUAGE DefaultSignatures #-}
6{-# LANGUAGE DefaultSignatures #-}
6{-# LANGUAGE FlexibleContexts #-}
7{-# LANGUAGE FlexibleContexts #-}
7{-# LANGUAGE FlexibleInstances #-}
8{-# LANGUAGE FlexibleInstances #-}
8−{-# LANGUAGE FunctionalDependencies #-}
9{-# LANGUAGE GADTs #-}
9{-# LANGUAGE GADTs #-}
10−{-# LANGUAGE GeneralizedNewtypeDeriving #-}
10+{-# LANGUAGE KindSignatures #-}
11{-# LANGUAGE LambdaCase #-}
11{-# LANGUAGE LambdaCase #-}
12+{-# LANGUAGE MultiParamTypeClasses #-}
12{-# LANGUAGE OverloadedStrings #-}
13{-# LANGUAGE OverloadedStrings #-}
13{-# LANGUAGE PatternSynonyms #-}
14{-# LANGUAGE PatternSynonyms #-}
14{-# LANGUAGE RankNTypes #-}
15{-# LANGUAGE RankNTypes #-}
15−{-# LANGUAGE RecursiveDo #-}
16{-# LANGUAGE ScopedTypeVariables #-}
16{-# LANGUAGE ScopedTypeVariables #-}
17−{-# LANGUAGE StandaloneDeriving #-}
17+{-# LANGUAGE TemplateHaskell #-}
18+{-# LANGUAGE TupleSections #-}
18{-# LANGUAGE TypeFamilies #-}
19{-# LANGUAGE TypeFamilies #-}
19{-# LANGUAGE TypeOperators #-}
20{-# LANGUAGE TypeOperators #-}
20−{-# LANGUAGE UndecidableInstances #-}
21{-# LANGUAGE ViewPatterns #-}
21{-# LANGUAGE ViewPatterns #-}
22+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
23+{-# LANGUAGE UndecidableInstances #-}
24+{-# LANGUAGE DataKinds #-}
25+{-# LANGUAGE FunctionalDependencies #-}
22
26
23module Obelisk.Route.Frontend
27module Obelisk.Route.Frontend
24 ( module Obelisk.Route
28 ( module Obelisk.Route
@@ -31,8 +35,6 @@ module Obelisk.Route.Frontend
31 , mapRoutedT
35 , mapRoutedT
32 , subRoute
36 , subRoute
33 , subRoute_
37 , subRoute_
34− , subPairRoute
35− , subPairRoute_
36 , maybeRoute
38 , maybeRoute
37 , maybeRoute_
39 , maybeRoute_
38 , maybeRouted
40 , maybeRouted
@@ -49,7 +51,6 @@ module Obelisk.Route.Frontend
49 , runRouteToUrlT
51 , runRouteToUrlT
50 , mapRouteToUrlT
52 , mapRouteToUrlT
51 , routeLink
53 , routeLink
52− , routeLinkDynAttr
53 , dynRouteLink
54 , dynRouteLink
54 , adaptedUriPath
55 , adaptedUriPath
55 , setAdaptedUriPath
56 , setAdaptedUriPath
@@ -57,42 +58,45 @@ module Obelisk.Route.Frontend
57
58
58import Prelude hiding ((.), id)
59import Prelude hiding ((.), id)
59
60
61+import Obelisk.Route
62+
60import Control.Category (Category (..), (.))
63import Control.Category (Category (..), (.))
61−import Control.Category.Cartesian ((&&&))
64+import Control.Category.Cartesian
62import Control.Lens hiding (Bifunctor, bimap, universe, element)
65import Control.Lens hiding (Bifunctor, bimap, universe, element)
63import Control.Monad ((<=<))
66import Control.Monad ((<=<))
64import Control.Monad.Fix
67import Control.Monad.Fix
65−import Control.Monad.Morph
66import Control.Monad.Primitive
68import Control.Monad.Primitive
67import Control.Monad.Reader
69import Control.Monad.Reader
68import Control.Monad.Ref
70import Control.Monad.Ref
69import Control.Monad.Trans.Control
71import Control.Monad.Trans.Control
70import Data.Coerce
72import Data.Coerce
71import Data.Dependent.Sum (DSum (..))
73import Data.Dependent.Sum (DSum (..))
72−import Data.Functor.Compose
73−import Data.Functor.Misc
74import Data.GADT.Compare
74import Data.GADT.Compare
75−import qualified Data.List as L
76−import Data.Map (Map)
77−import Data.Maybe (fromMaybe)
78import Data.Monoid
75import Data.Monoid
79import Data.Proxy
76import Data.Proxy
80import Data.Text (Text)
77import Data.Text (Text)
81import qualified Data.Text as T
78import qualified Data.Text as T
82−import Data.Type.Coercion
79+import Data.Functor.Compose
83−import qualified GHCJS.DOM as DOM
84−import qualified GHCJS.DOM.Types as DOM
85−import qualified GHCJS.DOM.Window as Window
86−import Language.Javascript.JSaddle (MonadJSM, jsNull, liftJSM) --TODO: Get rid of this - other platforms can also be routed
87−import Network.URI
88import Reflex.Class
80import Reflex.Class
81+import Reflex.Host.Class
82+import Reflex.PostBuild.Class
83+import Reflex.TriggerEvent.Class
84+import Reflex.PerformEvent.Class
85+import Reflex.EventWriter.Class
86+import Reflex.EventWriter.Base
87+import Reflex.Dynamic
89import Reflex.Dom.Builder.Class
88import Reflex.Dom.Builder.Class
89+import Data.Type.Coercion
90+import Language.Javascript.JSaddle --TODO: Get rid of this - other platforms can also be routed
90import Reflex.Dom.Core
91import Reflex.Dom.Core
91−import Reflex.Host.Class
92+import qualified GHCJS.DOM.Types as DOM
93+import Network.URI
94+import Data.Maybe (fromMaybe)
95+import qualified Data.List as L
96+
92import Unsafe.Coerce
97import Unsafe.Coerce
93
98
94import Obelisk.Configs
99import Obelisk.Configs
95−import Obelisk.Route
96
100
97infixr 5 :~
101infixr 5 :~
98pattern (:~) :: Reflex t => f a -> Dynamic t a -> DSum f (Compose (Dynamic t) Identity)
102pattern (:~) :: Reflex t => f a -> Dynamic t a -> DSum f (Compose (Dynamic t) Identity)
@@ -109,23 +113,7 @@ instance Monad m => Routed t r (RoutedT t r m) where
109instance (Monad m, Routed t r m) => Routed t r (ReaderT r' m)
113instance (Monad m, Routed t r m) => Routed t r (ReaderT r' m)
110
114
111newtype RoutedT t r m a = RoutedT { unRoutedT :: ReaderT (Dynamic t r) m a }
115newtype RoutedT t r m a = RoutedT { unRoutedT :: ReaderT (Dynamic t r) m a }
112− deriving
116+ deriving (Functor, Applicative, Monad, MonadFix, MonadTrans, NotReady t, MonadHold t, MonadSample t, PostBuild t, TriggerEvent t, MonadIO, MonadReflexCreateTrigger t, HasDocument, DomRenderHook t)
113− ( Functor
114− , Applicative
115− , Monad
116− , MonadFix
117− , MonadTrans
118− , MFunctor
119− , NotReady t
120− , MonadHold t
121− , MonadSample t
122− , PostBuild t
123− , TriggerEvent t
124− , MonadIO
125− , MonadReflexCreateTrigger t
126− , HasDocument
127− , DomRenderHook t
128− )
129
117
130instance MonadReader r' m => MonadReader r' (RoutedT t r m) where
118instance MonadReader r' m => MonadReader r' (RoutedT t r m) where
131 ask = lift ask
119 ask = lift ask
@@ -201,10 +189,6 @@ instance (Monad m, RouteToUrl r m) => RouteToUrl r (EventWriterT t w m)
201
189
202instance (Monad m, SetRoute t r m) => SetRoute t r (EventWriterT t w m)
190instance (Monad m, SetRoute t r m) => SetRoute t r (EventWriterT t w m)
203
191
204−instance (Monad m, RouteToUrl r m) => RouteToUrl r (DynamicWriterT t w m)
205−
206−instance (Monad m, SetRoute t r m) => SetRoute t r (DynamicWriterT t w m)
207−
208runRoutedT :: RoutedT t r m a -> Dynamic t r -> m a
192runRoutedT :: RoutedT t r m a -> Dynamic t r -> m a
209runRoutedT = runReaderT . unRoutedT
193runRoutedT = runReaderT . unRoutedT
210
194
@@ -218,18 +202,10 @@ subRoute_ :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r
218subRoute_ f = factorRouted $ strictDynWidget_ $ \(c :=> r') -> do
202subRoute_ f = factorRouted $ strictDynWidget_ $ \(c :=> r') -> do
219 runRoutedT (f c) r'
203 runRoutedT (f c) r'
220
204
221−-- | Like 'subRoute_', but with a pair rather than an R
222−subPairRoute_ :: (MonadFix m, MonadHold t m, Eq a, Adjustable t m) => (a -> RoutedT t b m ()) -> RoutedT t (a, b) m ()
223−subPairRoute_ f = withRoutedT (fmap (\(a, b) -> Const2 a :/ b)) $ subRoute_ (\(Const2 a) -> f a)
224−
225subRoute :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r a -> RoutedT t a m b) -> RoutedT t (R r) m (Dynamic t b)
205subRoute :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r a -> RoutedT t a m b) -> RoutedT t (R r) m (Dynamic t b)
226subRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
206subRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
227 runRoutedT (f c) r'
207 runRoutedT (f c) r'
228
208
229−-- | Like 'subRoute_', but with a pair rather than an R
230−subPairRoute :: (MonadFix m, MonadHold t m, Eq a, Adjustable t m) => (a -> RoutedT t b m c) -> RoutedT t (a, b) m (Dynamic t c)
231−subPairRoute f = withRoutedT (fmap (\(a, b) -> Const2 a :/ b)) $ subRoute (\(Const2 a) -> f a)
232−
233maybeRoute_ :: (MonadFix m, MonadHold t m, Adjustable t m) => m () -> RoutedT t r m () -> RoutedT t (Maybe r) m ()
209maybeRoute_ :: (MonadFix m, MonadHold t m, Adjustable t m) => m () -> RoutedT t r m () -> RoutedT t (Maybe r) m ()
234maybeRoute_ n j = maybeRouted $ strictDynWidget_ $ \case
210maybeRoute_ n j = maybeRouted $ strictDynWidget_ $ \case
235 Nothing -> n
211 Nothing -> n
@@ -269,7 +245,7 @@ dynamicIdentityCoercion = unsafeCoerce (Coercion :: Coercion (Identity ()) ()) -
269factorRouted :: (Reflex t, MonadFix m, MonadHold t m, GEq f) => RoutedT t (DSum f (Dynamic t)) m a -> RoutedT t (DSum f Identity) m a
245factorRouted :: (Reflex t, MonadFix m, MonadHold t m, GEq f) => RoutedT t (DSum f (Dynamic t)) m a -> RoutedT t (DSum f Identity) m a
270factorRouted r = RoutedT $ ReaderT $ \d -> do
246factorRouted r = RoutedT $ ReaderT $ \d -> do
271 d' <- factorDyn d
247 d' <- factorDyn d
272− runRoutedT r $ coerceWith (dynamicCoercion $ dsumValueCoercion dynamicIdentityCoercion) d'
248+ runRoutedT r $ (coerceWith (dynamicCoercion $ dsumValueCoercion dynamicIdentityCoercion) d')
273
249
274maybeRouted :: (Reflex t, MonadFix m, MonadHold t m) => RoutedT t (Maybe (Dynamic t a)) m b -> RoutedT t (Maybe a) m b
250maybeRouted :: (Reflex t, MonadFix m, MonadHold t m) => RoutedT t (Maybe (Dynamic t a)) m b -> RoutedT t (Maybe a) m b
275maybeRouted r = RoutedT $ ReaderT $ \d -> do
251maybeRouted r = RoutedT $ ReaderT $ \d -> do
@@ -477,7 +453,7 @@ runRouteViewT
477 , MonadJSM (Performable m)
453 , MonadJSM (Performable m)
478 , MonadFix m
454 , MonadFix m
479 )
455 )
480− => Encoder Identity Identity r PageName
456+ => (Encoder Identity Identity r PageName)
481 --TODO: Get rid of the switchover and useHash arguments
457 --TODO: Get rid of the switchover and useHash arguments
482 -- useHash can probably be baked into the encoder
458 -- useHash can probably be baked into the encoder
483 -> Event t () -- ^ Switchover event, nothing is done until this event fires. Used to prevent incorrect DOM expectations at hydration switchover time
459 -> Event t () -- ^ Switchover event, nothing is done until this event fires. Used to prevent incorrect DOM expectations at hydration switchover time
@@ -522,125 +498,45 @@ runRouteViewT routeEncoder switchover useHash a = do
522-- | A link widget that, when clicked, sets the route to the provided route. In non-javascript
498-- | A link widget that, when clicked, sets the route to the provided route. In non-javascript
523-- contexts, this widget falls back to using @href@s to control navigation
499-- contexts, this widget falls back to using @href@s to control navigation
524routeLink
500routeLink
525− :: forall t m a route js.
501+ :: forall t m a route.
526 ( DomBuilder t m
502 ( DomBuilder t m
527− , RouteToUrl route m
503+ , RouteToUrl (R route) m
528− , SetRoute t route m
504+ , SetRoute t (R route) m
529− , Prerender js t m
530 )
505 )
531− => route -- ^ Target route
506+ => R route -- ^ Target route
532 -> m a -- ^ Child widget
507 -> m a -- ^ Child widget
533 -> m a
508 -> m a
534routeLink r w = do
509routeLink r w = do
535− (e, a) <- routeLinkImpl r w
536− scrollToTop e
537− return a
538−
539−-- | Raw implementation of 'routeLink'. Does not scroll to the top of the page on clicks.
540−routeLinkImpl
541− :: forall t m a route.
542− ( DomBuilder t m
543− , RouteToUrl route m
544− , SetRoute t route m
545− )
546− => route -- ^ Target route
547− -> m a -- ^ Child widget
548− -> m (Event t (), a)
549−routeLinkImpl r w = do
550 enc <- askRouteToUrl
510 enc <- askRouteToUrl
551 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
511 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
552 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
512 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
553 & elementConfig_initialAttributes .~ "href" =: enc r
513 & elementConfig_initialAttributes .~ "href" =: enc r
554 (e, a) <- element "a" cfg w
514 (e, a) <- element "a" cfg w
555 setRoute $ r <$ domEvent Click e
515 setRoute $ r <$ domEvent Click e
556− return (domEvent Click e, a)
557−
558−scrollToTop :: forall m t js. (Prerender js t m, Monad m) => Event t () -> m ()
559−scrollToTop e = prerender_ blank $ performEvent_ $ ffor e $ \_ -> liftJSM $ DOM.currentWindow >>= \case
560− Nothing -> pure ()
561− Just win -> Window.scrollTo win 0 0
562−
563−-- | Like 'routeLinkDynAttr' but without custom attributes.
564−dynRouteLink
565− :: forall t m a route js.
566− ( DomBuilder t m
567− , PostBuild t m
568− , RouteToUrl route m
569− , SetRoute t route m
570− , Prerender js t m
571− )
572− => Dynamic t route -- ^ Target route
573− -> m a -- ^ Child widget
574− -> m a
575−dynRouteLink r w = do
576− (e, a) <- dynRouteLinkImpl r w
577− scrollToTop e
578 return a
516 return a
579
517
580−-- | Raw implementation of 'dynRouteLink'. Does not scroll to the top of the page on clicks.
581−dynRouteLinkImpl
582− :: forall t m a route.
583− ( DomBuilder t m
584− , PostBuild t m
585− , RouteToUrl route m
586− , SetRoute t route m
587− )
588− => Dynamic t route -- ^ Target route
589− -> m a -- ^ Child widget
590− -> m (Event t (), a)
591−dynRouteLinkImpl dr w = do
592− enc <- askRouteToUrl
593− er <- dynamicAttributesToModifyAttributes $ ("href" =:) . enc <$> dr
594− let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
595− & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
596− & elementConfig_modifyAttributes .~ er
597− (e, a) <- element "a" cfg w
598− let clk = domEvent Click e
599− setRoute $ tag (current dr) clk
600− return (clk, a)
601−
602−-- | An @a@-tag link widget that, when clicked, sets the route to current value of the
518+-- | A link widget that, when clicked, sets the route to current value of the
603−-- provided dynamic route. In non-JavaScript contexts the value of the dynamic post
519+-- provided dynamic route. In non-javascript contexts the value of the dynamic post
604-- build is used so the link still works like 'routeLink'.
520-- build is used so the link still works like 'routeLink'.
605−routeLinkDynAttr
521+dynRouteLink
606− :: forall t m a route js.
607− ( DomBuilder t m
608− , PostBuild t m
609− , RouteToUrl (R route) m
610− , SetRoute t (R route) m
611− , Prerender js t m
612− )
613− => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
614− -> Dynamic t (R route) -- ^ Target route
615− -> m a -- ^ Child widget of the @a@ element
616− -> m a
617−routeLinkDynAttr dAttr dr w = do
618− (e, a) <- routeLinkDynAttrImpl dAttr dr w
619− scrollToTop e
620− return a
621−
622−-- | Raw implementation of 'routeLinkDynAttr'. Does not scroll to the top of the page on clicks.
623−routeLinkDynAttrImpl
624 :: forall t m a route.
522 :: forall t m a route.
625 ( DomBuilder t m
523 ( DomBuilder t m
626 , PostBuild t m
524 , PostBuild t m
627 , RouteToUrl (R route) m
525 , RouteToUrl (R route) m
628 , SetRoute t (R route) m
526 , SetRoute t (R route) m
629 )
527 )
630− => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
631− -> Dynamic t (R route) -- ^ Target route
528+ => Dynamic t (R route) -- ^ Target route
632− -> m a -- ^ Child widget of the @a@ element
529+ -> m a -- ^ Child widget
633− -> m (Event t (), a)
530+ -> m a
634−routeLinkDynAttrImpl dAttr dr w = do
531+dynRouteLink dr w = do
635 enc <- askRouteToUrl
532 enc <- askRouteToUrl
636− er <- dynamicAttributesToModifyAttributes $ zipDynWith (<>) (("href" =:) . enc <$> dr) dAttr
533+ er <- dynamicAttributesToModifyAttributes $ ("href" =:) . enc <$> dr
637 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
534 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
638 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
535 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
639 & elementConfig_modifyAttributes .~ er
536 & elementConfig_modifyAttributes .~ er
640 (e, a) <- element "a" cfg w
537 (e, a) <- element "a" cfg w
641− let clk = domEvent Click e
642− setRoute $ tag (current dr) clk
538+ setRoute $ tag (current dr) $ domEvent Click e
643− return (clk, a)
539+ return a
644
540
645-- On ios due to sandboxing when loading the page from a file adapt the
541-- On ios due to sandboxing when loading the page from a file adapt the
646-- path to be based on the hash.
542-- path to be based on the hash.
lib/run/obelisk-run.cabal+2−9
@@ -15,7 +15,6 @@ library
15 , dependent-sum
15 , dependent-sum
16 , dependent-sum-template
16 , dependent-sum-template
17 , ghcjs-dom
17 , ghcjs-dom
18− , HsOpenSSL
19 , http-client
18 , http-client
20 , http-reverse-proxy
19 , http-reverse-proxy
21 , http-types
20 , http-types
@@ -33,21 +32,15 @@ library
33 , process
32 , process
34 , ref-tf
33 , ref-tf
35 , reflex
34 , reflex
36− , reflex-dom-core
35+ , reflex-dom
37 , snap-core
36 , snap-core
38 , streaming-commons
37 , streaming-commons
39 , text
38 , text
40− , time
41 , universe
39 , universe
42− , utf8-string
43 , wai
40 , wai
44 , wai-websockets
41 , wai-websockets
45 , warp
42 , warp
46− , warp-tls
47 , websockets
43 , websockets
48 exposed-modules:
44 exposed-modules:
49 Obelisk.Run
45 Obelisk.Run
50− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
46+ ghc-options: -Wall -fwarn-redundant-constraints
51− if os(linux)
52− cpp-options: -DIPROUTE_SUPPORTED
53− build-depends: which
lib/run/src/Obelisk/Run.hs+19−67
@@ -1,8 +1,3 @@
1−{-# LANGUAGE CPP #-}
2−#if defined(IPROUTE_SUPPORTED)
3−{-# LANGUAGE TemplateHaskell #-}
4−#endif
5−
6{-# LANGUAGE ConstraintKinds #-}
1{-# LANGUAGE ConstraintKinds #-}
7{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE FlexibleContexts #-}
8{-# LANGUAGE FlexibleInstances #-}
3{-# LANGUAGE FlexibleInstances #-}
@@ -28,7 +23,6 @@ import Data.ByteString (ByteString)
28import qualified Data.ByteString as BS
23import qualified Data.ByteString as BS
29import qualified Data.ByteString.Char8 as BSC
24import qualified Data.ByteString.Char8 as BSC
30import qualified Data.ByteString.Lazy.Char8 as BSLC
25import qualified Data.ByteString.Lazy.Char8 as BSLC
31−import qualified Data.ByteString.UTF8 as BSUTF8
32import Data.Functor.Identity
26import Data.Functor.Identity
33import Data.List (uncons)
27import Data.List (uncons)
34import Data.Map (Map)
28import Data.Map (Map)
@@ -40,7 +34,6 @@ import Data.String (fromString)
40import Data.Text (Text)
34import Data.Text (Text)
41import qualified Data.Text as T
35import qualified Data.Text as T
42import qualified Data.Text.Encoding as T
36import qualified Data.Text.Encoding as T
43−import Data.Time.Clock (getCurrentTime, addUTCTime)
44import Language.Javascript.JSaddle.Run (syncPoint)
37import Language.Javascript.JSaddle.Run (syncPoint)
45import Language.Javascript.JSaddle.WebSockets
38import Language.Javascript.JSaddle.WebSockets
46import Network.HTTP.Client (Manager, defaultManagerSettings, newManager)
39import Network.HTTP.Client (Manager, defaultManagerSettings, newManager)
@@ -50,7 +43,6 @@ import Network.Socket
50import Network.Wai (Application)
43import Network.Wai (Application)
51import qualified Network.Wai as W
44import qualified Network.Wai as W
52import Network.Wai.Handler.Warp
45import Network.Wai.Handler.Warp
53−import Network.Wai.Handler.WarpTLS
54import Network.Wai.Handler.Warp.Internal (settingsHost, settingsPort)
46import Network.Wai.Handler.Warp.Internal (settingsHost, settingsPort)
55import Network.WebSockets (ConnectionOptions)
47import Network.WebSockets (ConnectionOptions)
56import Network.WebSockets.Connection (defaultConnectionOptions)
48import Network.WebSockets.Connection (defaultConnectionOptions)
@@ -58,28 +50,21 @@ import qualified Obelisk.Asset.Serve.Snap as Snap
58import Obelisk.Backend
50import Obelisk.Backend
59import Obelisk.Frontend
51import Obelisk.Frontend
60import Obelisk.Route.Frontend
52import Obelisk.Route.Frontend
61−import qualified OpenSSL.PEM as PEM
62−import qualified OpenSSL.RSA as RSA
63−import qualified OpenSSL.X509 as X509
64−import qualified OpenSSL.X509.Request as X509Request
65import Reflex.Dom.Core
53import Reflex.Dom.Core
66import Snap.Core (Snap)
54import Snap.Core (Snap)
67import System.Environment
55import System.Environment
68import System.IO
56import System.IO
69import System.Process
57import System.Process
58+import System.Exit (ExitCode(..))
70import Text.URI (URI)
59import Text.URI (URI)
71import qualified Text.URI as URI
60import qualified Text.URI as URI
72import Text.URI.Lens
61import Text.URI.Lens
73import Web.Cookie
62import Web.Cookie
74
63
75−#if defined(IPROUTE_SUPPORTED)
76−import qualified System.Which
77−#endif
78−
79run
64run
80 :: Int -- ^ Port to run the backend
65 :: Int -- ^ Port to run the backend
81 -> ([Text] -> Snap ()) -- ^ Static asset handler
66 -> ([Text] -> Snap ()) -- ^ Static asset handler
82− -> Backend backendRoute frontendRoute -- ^ Backend
67+ -> Backend fullRoute frontendRoute -- ^ Backend
83 -> Frontend (R frontendRoute) -- ^ Frontend
68 -> Frontend (R frontendRoute) -- ^ Frontend
84 -> IO ()
69 -> IO ()
85run port serveStaticAsset backend frontend = do
70run port serveStaticAsset backend frontend = do
@@ -90,18 +75,14 @@ run port serveStaticAsset backend frontend = do
90 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
75 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
91 Right validFullEncoder -> do
76 Right validFullEncoder -> do
92 publicConfigs <- getPublicConfigs
77 publicConfigs <- getPublicConfigs
93− backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $
78+ backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $ do
94− _backend_run backend $ \serveRoute ->
79+ _backend_run backend $ \serveRoute -> do
95− runSnapWithCommandLineArgs $
80+ runSnapWithCommandLineArgs $ do
96 getRouteWith validFullEncoder >>= \case
81 getRouteWith validFullEncoder >>= \case
97 Identity r -> case r of
82 Identity r -> case r of
98 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
83 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
99 FullRoute_Frontend obeliskRoute :/ a ->
84 FullRoute_Frontend obeliskRoute :/ a ->
100− serveDefaultObeliskApp appRouteToUrl (($ allJsUrl) <$> defaultGhcjsWidgets) serveStaticAsset frontend publicConfigs $ obeliskRoute :/ a
85+ serveDefaultObeliskApp (mkRouteToUrl validFullEncoder) serveStaticAsset frontend publicConfigs $ obeliskRoute :/ a
101− where
102− appRouteToUrl (k :/ v) = renderObeliskRoute validFullEncoder (FullRoute_Frontend (ObeliskRoute_App k) :/ v)
103− allJsUrl = renderAllJsPath validFullEncoder
104−
105 let conf = defRunConfig { _runConfig_redirectPort = port }
86 let conf = defRunConfig { _runConfig_redirectPort = port }
106 runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
87 runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
107
88
@@ -111,7 +92,7 @@ runServeAsset rootPath = Snap.serveAsset "" rootPath . T.unpack . T.intercalate
111
92
112getConfigRoute :: Map Text ByteString -> Either Text URI
93getConfigRoute :: Map Text ByteString -> Either Text URI
113getConfigRoute configs = case Map.lookup "common/route" configs of
94getConfigRoute configs = case Map.lookup "common/route" configs of
114− Just r ->
95+ Just r ->
115 let stripped = T.strip (T.decodeUtf8 r)
96 let stripped = T.strip (T.decodeUtf8 r)
116 in case URI.mkURI stripped of
97 in case URI.mkURI stripped of
117 Just route -> Right route
98 Just route -> Right route
@@ -132,36 +113,13 @@ runWidget conf configs frontend validFullEncoder = do
132 beforeMainLoop = do
113 beforeMainLoop = do
133 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
114 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
134 settings = setBeforeMainLoop beforeMainLoop (setPort port (setTimeout 3600 defaultSettings))
115 settings = setBeforeMainLoop beforeMainLoop (setPort port (setTimeout 3600 defaultSettings))
135− -- Providing TLS here will also incidentally provide it to proxied requests to the backend.
136− prepareRunner = case uri ^? uriScheme . _Just . unRText of
137− Just "https" -> do
138− -- Generate a private key and self-signed certificate for TLS
139− privateKey <- RSA.generateRSAKey' 2048 3
140−
141− certRequest <- X509Request.newX509Req
142− _ <- X509Request.setPublicKey certRequest privateKey
143− _ <- X509Request.signX509Req certRequest privateKey Nothing
144−
145− cert <- X509.newX509 >>= X509Request.makeX509FromReq certRequest
146− _ <- X509.setPublicKey cert privateKey
147− timenow <- getCurrentTime
148− _ <- X509.setNotBefore cert $ addUTCTime (-1) timenow
149− _ <- X509.setNotAfter cert $ addUTCTime (365 * 24 * 60 * 60) timenow
150− _ <- X509.signX509 cert privateKey Nothing
151−
152− certByteString <- BSUTF8.fromString <$> PEM.writeX509 cert
153− privateKeyByteString <- BSUTF8.fromString <$> PEM.writePKCS8PrivateKey privateKey Nothing
154−
155− return $ runTLSSocket (tlsSettingsMemory certByteString privateKeyByteString)
156− _ -> return runSettingsSocket
157− runner <- prepareRunner
158 bracket
116 bracket
159 (bindPortTCPRetry settings (logPortBindErr port) (_runConfig_retryTimeout conf))
117 (bindPortTCPRetry settings (logPortBindErr port) (_runConfig_retryTimeout conf))
160 close
118 close
161 (\skt -> do
119 (\skt -> do
162 man <- newManager defaultManagerSettings
120 man <- newManager defaultManagerSettings
163 app <- obeliskApp configs defaultConnectionOptions frontend validFullEncoder uri $ fallbackProxy redirectHost redirectPort man
121 app <- obeliskApp configs defaultConnectionOptions frontend validFullEncoder uri $ fallbackProxy redirectHost redirectPort man
164− runner settings skt app)
122+ runSettingsSocket settings skt app)
165
123
166obeliskApp
124obeliskApp
167 :: forall frontendRoute backendRoute
125 :: forall frontendRoute backendRoute
@@ -193,8 +151,7 @@ obeliskApp configs opts frontend validFullEncoder uri backend = do
193 }
151 }
194 FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
152 FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
195 let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
153 let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
196− routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
197− html <- renderJsaddleFrontend configs cookies routeToUrl (appRouteComponent :/ appRouteRest) frontend
154+ html <- renderJsaddleFrontend configs cookies (mkRouteToUrl validFullEncoder) (appRouteComponent :/ appRouteRest) frontend
198 sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
155 sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
199 _ -> backend req sendResponse
156 _ -> backend req sendResponse
200
157
@@ -225,22 +182,17 @@ logPortBindErr p e = getProcessIdForPort p >>= \case
225 Nothing -> putStrLn $ "runWidget: " <> show e
182 Nothing -> putStrLn $ "runWidget: " <> show e
226 Just pid -> putStrLn $ unwords [ "Port", show p, "is being used by process ID", show pid <> ".", "Please kill that process or change the port in config/common/route."]
183 Just pid -> putStrLn $ unwords [ "Port", show p, "is being used by process ID", show pid <> ".", "Please kill that process or change the port in config/common/route."]
227
184
228−ssPath :: Maybe String
229−ssPath =
230−#if defined(IPROUTE_SUPPORTED)
231− Just $(System.Which.staticWhich "ss")
232−#else
233− Nothing
234−#endif
235−
236getProcessIdForPort :: Int -> IO (Maybe Int)
185getProcessIdForPort :: Int -> IO (Maybe Int)
237−getProcessIdForPort port = case ssPath of
186+getProcessIdForPort port = do
238− Just ss -> do
187+ -- First check if 'ss' is available
188+ (c, _, _) <- readProcessWithExitCode "which" ["ss"] mempty
189+ case c of
190+ ExitSuccess -> do
239− xs <- lines <$> readProcess ss ["-lptn", "sport = " <> show port] mempty
191+ xs <- lines <$> readProcess "ss" ["-lptn", "sport = " <> show port] mempty
240− case uncons xs of
192+ case uncons xs of
241− Just (_, x:_) -> return $ A.maybeResult $ A.parse parseSsPid $ BSC.pack x
193+ Just (_, x:_) -> return $ A.maybeResult $ A.parse parseSsPid $ BSC.pack x
242− _ -> return Nothing
194+ _ -> return Nothing
243− _ -> return Nothing
195+ _ -> return Nothing
244
196
245parseSsPid :: A.Parser Int
197parseSsPid :: A.Parser Int
246parseSsPid = do
198parseSsPid = do
lib/selftest/obelisk-selftest.cabal+3−6
@@ -9,21 +9,18 @@ library
9 hs-source-dirs: src
9 hs-source-dirs: src
10 build-depends:
10 build-depends:
11 base
11 base
12− , bytestring
13− , aeson
14 , containers
12 , containers
15 , directory
13 , directory
16− , filepath
17 , hspec
14 , hspec
18 , http-client
15 , http-client
19 , http-types
16 , http-types
20 , HUnit
17 , HUnit
21− , network
18+ , obelisk-cliapp
22 , obelisk-executable-config-lookup
19 , obelisk-executable-config-lookup
23 , obelisk-run
20 , obelisk-run
24− , which
25 , process
21 , process
22+ , network
26− , shelly >= 1.9.0
23+ , shelly
27 , temporary
24 , temporary
28 , text
25 , text
29 exposed-modules:
26 exposed-modules:
lib/selftest/src/Obelisk/SelfTest.hs+198−497
@@ -1,49 +1,39 @@
1−{-# LANGUAGE DoAndIfThenElse #-}
2{-# LANGUAGE EmptyCase #-}
1{-# LANGUAGE EmptyCase #-}
3{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE LambdaCase #-}
4{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE PatternGuards #-}
4{-# LANGUAGE PatternGuards #-}
6{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
7−{-# LANGUAGE TemplateHaskell #-}
8{-# LANGUAGE TypeApplications #-}
6{-# LANGUAGE TypeApplications #-}
9−{-# LANGUAGE ViewPatterns #-}
10module Obelisk.SelfTest where
7module Obelisk.SelfTest where
11
8
12−import Control.Concurrent (threadDelay)
13−import Control.Exception (bracket, throw, try)
9+import Control.Exception (bracket, throw)
14import Control.Monad
10import Control.Monad
15import Control.Monad.IO.Class
11import Control.Monad.IO.Class
16−import qualified Data.Aeson as Aeson
17−import qualified Data.Aeson.Types as Aeson
18import Data.Bool (bool)
12import Data.Bool (bool)
19−import qualified Data.ByteString.Lazy as LBS
20−import Data.Foldable (for_)
21import Data.Function (fix)
13import Data.Function (fix)
22−import Data.List (isInfixOf)
14+import Data.Semigroup (Semigroup, (<>))
23−import qualified Data.Map as Map
24−import Data.Semigroup ((<>))
25import qualified Data.Set as Set
15import qualified Data.Set as Set
26import Data.String
16import Data.String
27import Data.Text (Text)
17import Data.Text (Text)
18+import Data.Void
28import qualified Data.Text as T
19import qualified Data.Text as T
29−import qualified Data.Text.Encoding as T
30import qualified Data.Text.IO as T
20import qualified Data.Text.IO as T
31import qualified Network.HTTP.Client as HTTP
21import qualified Network.HTTP.Client as HTTP
32import qualified Network.HTTP.Types as HTTP
22import qualified Network.HTTP.Types as HTTP
33import qualified Network.Socket as Socket
23import qualified Network.Socket as Socket
34import Shelly
24import Shelly
35−import System.Directory (getCurrentDirectory, withCurrentDirectory, getDirectoryContents)
25+import System.Directory (withCurrentDirectory, getDirectoryContents)
36import System.Environment
26import System.Environment
37import System.Exit (ExitCode (..))
27import System.Exit (ExitCode (..))
38−import System.FilePath (addTrailingPathSeparator)
28+import System.Info
39−import qualified System.Info
40−import System.IO (Handle, hClose, hIsEOF, hGetContents)
29+import System.IO (Handle, hClose)
41import System.IO.Temp
30import System.IO.Temp
42−import System.Process (readProcessWithExitCode)
31+import System.Process (readProcessWithExitCode, CreateProcess(cwd), readCreateProcessWithExitCode, proc)
43−import System.Which (staticWhich)
44import Test.Hspec
32import Test.Hspec
45import Test.HUnit.Base
33import Test.HUnit.Base
46
34
35+import Obelisk.CliApp hiding (runCli, readCreateProcessWithExitCode)
36+import qualified Obelisk.CliApp as CliApp
47import Obelisk.ExecutableConfig.Lookup (getConfigs)
37import Obelisk.ExecutableConfig.Lookup (getConfigs)
48import Obelisk.Run (getConfigRoute)
38import Obelisk.Run (getConfigRoute)
49
39
@@ -53,53 +43,24 @@ data ObRunState
53 | ObRunState_BackendStarted
43 | ObRunState_BackendStarted
54 deriving (Eq, Show)
44 deriving (Eq, Show)
55
45
56−cpPath :: FilePath
46+doubleQuotes :: (IsString a, Semigroup a) => a -> a
57−cpPath = $(staticWhich "cp")
47+doubleQuotes s = "\"" <> s <> "\""
58−
59−cabalPath :: FilePath
60−cabalPath = $(staticWhich "cabal")
61−
62−gitPath :: FilePath
63−gitPath = $(staticWhich "git")
64−
65−chownPath :: FilePath
66−chownPath = $(staticWhich "chown")
67−
68−chmodPath :: FilePath
69−chmodPath = $(staticWhich "chmod")
70−
71−whoamiPath :: FilePath
72−whoamiPath = $(staticWhich "whoami")
73−
74−nixInstantiatePath :: FilePath
75−nixInstantiatePath = $(staticWhich "nix-instantiate")
76−
77−nixBuildPath :: FilePath
78−nixBuildPath = $(staticWhich "nix-build")
79−
80−nixPrefetchGitPath :: FilePath
81−nixPrefetchGitPath = $(staticWhich "nix-prefetch-git")
82−
83−lnPath :: FilePath
84−lnPath = $(staticWhich "ln")
85−
86−rmPath :: FilePath
87−rmPath = $(staticWhich "rm")
88−
89−rsyncPath :: FilePath
90−rsyncPath = $(staticWhich "rsync")
91−
92−gitUserConfig :: [Text]
93−gitUserConfig = ["-c", "user.name=Obelisk Selftest", "-c", "user.email=noreply@example.com"]
94
48
95commit :: Text -> Sh ()
49commit :: Text -> Sh ()
96−commit msg = void $ run gitPath $ gitUserConfig <> [ "commit"
50+commit msg = void $ run "git"
51+ [ "commit"
97 , "--no-gpg-sign"
52 , "--no-gpg-sign"
98 , "--allow-empty"
53 , "--allow-empty"
99 , "-m"
54 , "-m"
100− , msg
55+ , doubleQuotes msg
101 ]
56 ]
102
57
58+-- TODO replace Void and stop using loosely typed synchronous exceptions
59+runCli :: MonadIO m => CliT Void IO a -> m a
60+runCli f = liftIO $ do
61+ c <- newCliConfig Notice False False (\case {})
62+ CliApp.runCli c f
63+
103tshow :: Show a => a -> Text
64tshow :: Show a => a -> Text
104tshow = T.pack . show
65tshow = T.pack . show
105
66
@@ -107,345 +68,210 @@ tshow = T.pack . show
107shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
68shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
108shellyOb f obTest = shelly $ f obTest
69shellyOb f obTest = shelly $ f obTest
109
70
110−-- Set "ob" in a single place so it can be replaced with a
111−-- link to obelisk in the nix store in the future,
112−-- and avoid PATH hacking before calling this script.
113−ob :: FilePath
114−ob = "ob"
115−
116−augmentWithVerbosity :: (String -> [Text] -> a) -> String -> Bool -> [Text] -> a
117−augmentWithVerbosity runner executable isVerbose args = runner executable $ (if isVerbose then ("-v" :) else id) args
118−
119−isolatedGitShell :: Bool -> FilePath -> (([Text] -> Sh Text) -> Sh a) -> IO a
120−isolatedGitShell isVerbose dir f = shelly $ bool silently verbosely isVerbose $ do
121− setenv "HOME" "/dev/null"
122− setenv "GIT_CONFIG_NOSYSTEM" "1"
123− _ <- git ["init"]
124− _ <- git ["config", "user.name", "SelfTest"]
125− _ <- git ["config", "user.email", "self@test"]
126− f git
127− where
128− git args = run gitPath $ ["-C", toTextIgnore dir] <> args
129−
130−-- | Copies a git repo to a new location and "resets" the git history to include
131−-- exactly one commit with all files added. It then restricts writing and reading
132−-- for group and user to make the repo ideal for being a valid git remote for thunks.
133−--
134−-- Using this allows dirty repos to be used as git remotes during the test since 'git clone'ing
135−-- a dirty repo will not include the uncommitted changes.
136−copyForGitRemote :: Bool -> FilePath -> FilePath -> IO ()
137−copyForGitRemote isVerbose origDir copyDir = isolatedGitShell isVerbose copyDir $ \git -> do
138− run_ rsyncPath
139− [ "-r", "--no-perms", "--no-owner", "--no-group", "--exclude", ".git"
140− , toTextIgnore (addTrailingPathSeparator origDir), toTextIgnore copyDir
141− ]
142− _ <- git ["add", "--all"]
143− _ <- git ["commit", "-m", "Copy repo"]
144− run_ chmodPath ["-R", "u-w,g-rw,o-rw", toTextIgnore copyDir] -- Freeze this state
145−
146main :: IO ()
71main :: IO ()
147main = do
72main = do
148 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
73 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
149− isVerbose <- elem "-v" <$> getArgs
74+ isVerbose <- (elem "-v") <$> getArgs
150 unless isVerbose $
75 unless isVerbose $
151 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
76 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
152−
77+ let verbosity = bool silently verbosely isVerbose
153− obeliskImplDirtyReadOnly <- getCurrentDirectory
78+ obeliskImpl <- fromString <$> getEnv "OBELISK_IMPL"
154 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
79 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
80+ [p0, p1, p2, p3] <- liftIO $ getFreePorts 4
81+ withSystemTempDirectory "initCache" $ \initCache -> do
82+ -- Setup the ob init cache
83+ void . shellyOb verbosity $ chdir (fromString initCache) $ do
84+ run_ "ob" ["init"]
85+ run_ "git" ["init"]
86+ hspec $ parallel $ do
87+ let shelly_ = void . shellyOb verbosity
88+
89+ inTmp :: (Shelly.FilePath -> Sh a) -> IO ()
90+ inTmp f = withTmp (chdir <*> f)
91+
92+ withTmp f = shelly_ . withSystemTempDirectory "test" $ f . fromString
93+
94+ inTmpObInit f = inTmp $ \dir -> do
95+ run_ "cp" ["-a", fromString $ initCache <> "/.", toTextIgnore dir]
96+ f dir
97+
98+ assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
99+ assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
100+
101+ revParseHead = T.strip <$> run "git" ["rev-parse", "HEAD"]
102+
103+ commitAll = do
104+ run_ "git" ["add", "."]
105+ commit "checkpoint"
106+ revParseHead
107+
108+ thunk = ".obelisk/impl"
109+ update = run "ob" ["thunk", "update", thunk] >> commitAll
110+ pack = run "ob" ["thunk", "pack", thunk] >> commitAll
111+ unpack = run "ob" ["thunk", "unpack", thunk] >> commitAll
112+
113+ diff a b = run "git" ["diff", a, b]
114+
115+ describe "ob init" $ parallel $ do
116+ it "works with default impl" $ inTmp $ \_ -> run "ob" ["init"]
117+ it "works with master branch impl" $ inTmp $ \_ -> run "ob" ["init", "--branch", "master"]
118+ it "works with symlink" $ inTmp $ \_ -> run "ob" ["init", "--symlink", obeliskImpl]
119+ it "doesn't silently overwrite existing files" $ withSystemTempDirectory "ob-init" $ \dir -> do
120+ let p force = (proc "ob" $ "--no-handoff" : "init" : if force then ["--force"] else []) { cwd = Just dir }
121+ (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p False) ""
122+ (ExitFailure _, _, _) <- readCreateProcessWithExitCode (p False) ""
123+ (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p True) ""
124+ pure ()
125+
126+ it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
127+ void $ errExit False $ run "ob" ["init", "--symlink", "/dev/null"]
128+ ls tmp >>= liftIO . assertEqual "" []
129+
130+ it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $ do
131+ configs <- getConfigs
132+ withCurrentDirectory (T.unpack $ toTextIgnore tmp) $
133+ return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
134+
135+ -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
136+ -- when not run by 'nix-build --attr selftest'
137+ describe "ob run" $ parallel $ do
138+ it "works in root directory" $ inTmpObInit $ \_ -> do
139+ testObRunInDir p0 p1 Nothing httpManager
140+ it "works in sub directory" $ inTmpObInit $ \_ -> do
141+ testObRunInDir p2 p3 (Just "frontend") httpManager
142+
143+ describe "obelisk project" $ parallel $ do
144+ it "can build obelisk command" $ inTmpObInit $ \_ -> run "nix-build" ["-A", "command" , obeliskImpl]
145+ it "can build obelisk skeleton" $ inTmpObInit $ \_ -> run "nix-build" ["-A", "skeleton", obeliskImpl]
146+ it "can build obelisk shell" $ inTmpObInit $ \_ -> run "nix-build" ["-A", "shell", obeliskImpl]
147+ -- See https://github.com/obsidiansystems/obelisk/issues/101
148+ -- it "can build everything" $ shelly_ $ run "nix-build" [obeliskImpl]
149+
150+ describe "blank initialized project" $ parallel $ do
151+
152+ it "can build ghc.backend" $ inTmpObInit $ \_ -> do
153+ run "nix-build" ["--no-out-link", "-A", "ghc.backend"]
154+ it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> do
155+ run "nix-build" ["--no-out-link", "-A", "ghcjs.frontend"]
156+
157+ if os == "darwin"
158+ then it "can build ios" $ inTmpObInit $ \_ -> run "nix-build" ["--no-out-link", "-A", "ios.frontend" ]
159+ else it "can build android" $ inTmpObInit $ \_ -> run "nix-build" ["--no-out-link", "-A", "android.frontend"]
160+
161+ forM_ ["ghc", "ghcjs"] $ \compiler -> do
162+ let
163+ shell = "shells." <> compiler
164+ inShell cmd' = run "nix-shell" ["-A", fromString shell, "--run", cmd']
165+ it ("can enter " <> shell) $ inTmpObInit $ \_ -> inShell "exit"
166+ it ("can build in " <> shell) $ inTmpObInit $ \_ -> inShell $ "cabal new-build --" <> fromString compiler <> " all"
167+
168+ it "can build reflex project" $ inTmpObInit $ \_ -> do
169+ run "nix-build" []
170+
171+ it "has idempotent thunk update" $ inTmpObInit $ \_ -> do
172+ u <- update
173+ uu <- update
174+ assertRevEQ u uu
175+
176+ describe "ob thunk pack/unpack" $ parallel $ do
177+ it "has thunk pack and unpack inverses" $ inTmpObInit $ \_ -> do
178+
179+ e <- commitAll
180+ eu <- unpack
181+ eup <- pack
182+ eupu <- unpack
183+ _ <- pack
184+
185+ assertRevEQ e eup
186+ assertRevEQ eu eupu
187+ assertRevNE e eu
188+
189+ it "unpacks the correct branch" $ withTmp $ \dir -> do
190+ let branch = "master"
191+ run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
192+ run_ "ob" ["thunk", "pack", toTextIgnore dir]
193+ run_ "ob" ["thunk", "unpack", toTextIgnore dir]
194+ branch' <- chdir dir $ run "git" ["rev-parse", "--abbrev-ref", "HEAD"]
195+ liftIO $ assertEqual "" branch (T.strip branch')
196+
197+ it "can pack and unpack plain git repos" $ do
198+ shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
199+ let repo = toTextIgnore $ dir </> ("repo" :: String)
200+ run_ "git" ["clone", "https://github.com/haskell/process.git", repo]
201+ origHash <- chdir (fromText repo) revParseHead
202+
203+ run_ "ob" ["thunk", "pack", repo]
204+ packedFiles <- Set.fromList <$> ls (fromText repo)
205+ liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
206+ ["default.nix", "github.json", ".attr-cache" :: String]
207+
208+ run_ "ob" ["thunk", "unpack", repo]
209+ chdir (fromText repo) $ do
210+ unpackHash <- revParseHead
211+ assertRevEQ origHash unpackHash
212+
213+ testThunkPack $ fromText repo
214+
215+ it "aborts thunk pack when there are uncommitted files" $ inTmpObInit $ \dir -> do
216+ void $ unpack
217+ testThunkPack (dir </> thunk)
218+
219+ describe "ob thunk update --branch" $ parallel $ do
220+ it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
221+ let branch1 = "master"
222+ branch2 = "develop"
223+ run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
224+ run_ "ob" ["thunk" , "pack", toTextIgnore dir]
225+ run_ "ob" ["thunk", "update", toTextIgnore dir, "--branch", branch2]
226+
227+ it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
228+ let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
229+ run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
230+ run_ "ob" ["thunk" , "pack", toTextIgnore dir]
231+ startingContents <- checkDir dir
232+ void $ errExit False $ run "ob" ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
233+ checkDir dir >>= liftIO . assertEqual "" startingContents
155
234
156− withSystemTempDirectory "obelisk-repo-git-remote" $ \copyDir -> do
157− copyForGitRemote isVerbose obeliskImplDirtyReadOnly copyDir
158− main' isVerbose httpManager copyDir
159−
160−main' :: Bool -> HTTP.Manager -> FilePath -> IO ()
161−main' isVerbose httpManager obeliskRepoReadOnly = withInitCache $ \initCache -> hspec $ parallel $ do
162− let
163− inTmpObInit' dirname f = inTmp' dirname $ \dir -> do
164− run_ cpPath ["-rT", fromString initCache, toTextIgnore dir]
165− f dir
166− inTmpObInit = inTmpObInit' defaultTmpDirName
167−
168− -- To be used in tests that change the obelisk impl directory
169− inTmpObInitWithImplCopy f = inTmpObInit $ \dir ->
170− withObeliskImplClean $ \(fromString -> implClean) -> do
171− run_ rmPath [thunk]
172− run_ lnPath ["-s", implClean, thunk]
173− f dir
174−
175− describe "ob init" $ parallel $ do
176− it "works with default impl" $ inTmp $ \_ -> runOb ["init"]
177− it "works with master branch impl" $ inTmp $ \_ -> runOb ["init", "--branch", "master"]
178− it "works with symlink" $ inTmp $ \_ -> runOb ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
179− it "doesn't silently overwrite existing files" $ inTmp $ \_ -> do
180− let p force = errExit False $ do
181− run_ ob $ "--no-handoff" : "-v" : "init" : ["--force"|force]
182− (== 0) <$> lastExitCode
183−
184− True <- p False
185− False <- p False
186− True <- p True
187− pure ()
188−
189− it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
190− void $ errExit False $ runOb ["init", "--symlink", "/dev/null"]
191− ls tmp >>= liftIO . assertEqual "" []
192−
193− it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $
194− withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ do
195− configs <- getConfigs
196− return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
197−
198− it "can unpack and repack .obelisk/impl after init with master branch impl" $ inTmp $ \_ -> do
199− runOb_ ["init", "--branch", "master"]
200− runOb_ ["thunk", "unpack", ".obelisk/impl"]
201− runOb_ ["thunk", "pack", ".obelisk/impl"]
202−
203− -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
204− -- when not run by 'nix-build --attr selftest'
205− describe "ob run" $ {- NOT parallel $ -} do
206− it "works in root directory" $ inTmpObInit $ \_ -> testObRunInDir' Nothing httpManager
207− it "works in sub directory" $ inTmpObInit $ \_ -> testObRunInDir' (Just "frontend") httpManager
208−
209− describe "ob repl" $ do
210− it "accepts stdin commands" $ inTmpObInit $ \_ -> do
211− setStdin "print 3\n:q"
212− output <- runOb ["repl"]
213− liftIO $ assertBool "" $
214− [ "*Obelisk.Run Obelisk.Run Frontend Backend> 3"
215− , "*Obelisk.Run Obelisk.Run Frontend Backend> Leaving GHCi."
216− ] `isInfixOf` T.lines (T.strip output)
217− it "works with custom Prelude" $ inTmpObInit $ \_ -> do
218− writefile "common/src/Prelude.hs"
219− "{-# LANGUAGE PackageImports #-} module Prelude (module X) where import \"base\" Prelude as X"
220− setStdin ":q"
221− output <- runOb ["repl"]
222− liftIO $ assertBool "" $
223− "*Obelisk.Run Obelisk.Run Frontend Backend> Leaving GHCi." `T.isInfixOf` output
224−
225− describe "obelisk project" $ parallel $ do
226− it "can build obelisk command" $ inTmpObInit $ \_ -> nixBuild ["-A", "command" , toTextIgnore obeliskRepoReadOnly]
227− it "can build obelisk skeleton" $ inTmpObInit $ \_ -> nixBuild ["-A", "skeleton", toTextIgnore obeliskRepoReadOnly]
228− it "can build obelisk shell" $ inTmpObInit $ \_ -> nixBuild ["-A", "shell", toTextIgnore obeliskRepoReadOnly]
229− it "can build everything" $ inTmpObInit $ \_ -> nixBuild [toTextIgnore obeliskRepoReadOnly]
230−
231− describe "blank initialized project" $ parallel $ do
232−
233− it "can build ghc.backend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghc.backend"]
234− it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghcjs.frontend"]
235−
236− if System.Info.os == "darwin"
237− then it "can build ios" $ inTmpObInit $ \_ -> nixBuild ["-A", "ios.frontend"]
238− else it "can build android after accepting license" $ inTmpObInit $ \dir -> do
239− let defaultNixPath = dir </> ("default.nix" :: FilePath)
240− writefile defaultNixPath
241− =<< T.replace
242− "# config.android_sdk.accept_license = false;"
243− "config.android_sdk.accept_license = true;"
244− <$> readfile defaultNixPath
245− nixBuild ["-A", "android.frontend"]
246−
247− forM_ ["ghc", "ghcjs"] $ \compiler -> do
248− let
249− shellName = "shells." <> compiler
250− inShell cmd' = run_ "nix-shell" ["default.nix", "-A", fromString shellName, "--run", cmd']
251− it ("can enter " <> shellName) $ inTmpObInit $ \_ -> inShell "exit"
252− -- NOTE: We override the temporary directory name because cabal has a bug preventing new-build from working
253− -- in a path that has unicode characters.
254− it ("can build in " <> shellName) $ inTmpObInit' "test" $ \_ -> inShell $
255− T.pack cabalPath <> " --version; " <> T.pack cabalPath <> " new-build --" <> T.pack compiler <> " all"
256−
257− it "has idempotent thunk update" $ inTmpObInitWithImplCopy $ \_ -> do
258− _ <- pack
259− u <- update
260− uu <- update
261− assertRevEQ u uu
262−
263− it "can run 'ob doc'" $ inTmpObInit $ \_ -> runOb_ ["doc", "reflex"]
264−
265− describe "ob thunk pack/unpack" $ parallel $ do
266− it "has thunk pack and unpack inverses" $ inTmpObInitWithImplCopy $ \_ -> do
267−
268− _ <- pack
269− e <- commitAll
270− eu <- unpack
271− eup <- pack
272− eupu <- unpack
273− _ <- pack
274−
275− assertRevEQ e eup
276− assertRevEQ eu eupu
277− assertRevNE e eu
278−
279− it "unpacks the correct branch" $ withTmp $ \dir -> do
280− let branch = "master"
281− run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
282− runOb_ ["thunk", "pack", toTextIgnore dir]
283− runOb_ ["thunk", "unpack", toTextIgnore dir]
284− branch' <- run gitPath ["-C", toTextIgnore $ dir </> unpackedDirName, "rev-parse", "--abbrev-ref", "HEAD"]
285− liftIO $ assertEqual "" branch (T.strip branch')
286−
287− it "can pack and unpack plain git repos" $
288− shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
289− let repo = toTextIgnore $ dir </> ("repo" :: FilePath)
290− run_ gitPath ["clone", "https://github.com/haskell/process.git", repo]
291− origHash <- chdir (fromText repo) revParseHead
292−
293− runOb_ ["thunk", "pack", repo]
294− packedFiles <- Set.fromList <$> ls (fromText repo)
295− liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
296− ["default.nix", "thunk.nix", "github.json" :: FilePath]
297−
298− runOb_ ["thunk", "unpack", repo]
299− chdir (fromText repo </> unpackedDirName) $ do
300− unpackHash <- revParseHead
301− assertRevEQ origHash unpackHash
302−
303− testThunkPack' $ fromText repo
304−
305− it "aborts thunk pack when there are uncommitted files" $ inTmpObInitWithImplCopy $ \dir -> do
306− testThunkPack' (dir </> thunk)
307−
308− it "works on legacy git thunks" $ testLegacyGitThunks isVerbose
309−
310− describe "ob thunk update --branch" $ parallel $ do
311− it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
312− let branch1 = "master"
313− branch2 = "develop"
314− run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
315− runOb_ ["thunk" , "pack", toTextIgnore dir]
316− runOb_ ["thunk", "update", toTextIgnore dir, "--branch", branch2]
317−
318− it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
319− let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
320− run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
321− runOb_ ["thunk" , "pack", toTextIgnore dir]
322− startingContents <- checkDir dir
323− void $ errExit False $ runOb ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
324− checkDir dir >>= liftIO . assertEqual "" startingContents
325−
326− describe "ob shell" $ parallel $ do
327− it "works with --" $ inTmpObInit $ \_ -> do
328− output <- runOb ["shell", "--", "ghc-pkg", "list"]
329− liftIO $ assertBool "Unexpected output from ob shell" $ ("Cabal-" `T.isInfixOf` output) && ("ghc-" `T.isInfixOf` output)
330−
331− describe "ob hoogle" $ {- NOT parallel -} do
332− it "starts a hoogle server on the given port" $ inTmpObInit $ \_ -> do
333− [p0] <- liftIO $ getFreePorts 1
334− maskExitSuccess $ runHandle "ob" ["hoogle", "--port", T.pack (show p0)] $ \stdout -> flip fix Nothing $ \loop -> \case
335− Nothing -> do -- Still waiting for initial signal that the server has started
336− ln <- liftIO $ T.hGetLine stdout
337− let search = "Server starting on port " <> T.pack (show p0)
338− case search `T.isInfixOf` ln of
339− False -> loop Nothing -- keep waiting
340− True -> loop $ Just 10
341− Just (n :: Int) -> do -- Server has started and we have n attempts left
342− let req uri = liftIO $ try @HTTP.HttpException $ HTTP.parseRequest uri >>= flip HTTP.httpLbs httpManager
343− req ("http://127.0.0.1:" <> show p0) >>= \case
344− Right r | HTTP.responseStatus r == HTTP.ok200 -> exit 0
345− e -> if n <= 0
346− then errorExit $ "Request to hoogle server failed: " <> T.pack (show e)
347− else liftIO (threadDelay (1*10^(6 :: Int))) *> loop (Just $ n - 1)
348− where
349− verbosity = bool silently verbosely isVerbose
350− nixBuild args = run nixBuildPath ("--no-out-link" : args)
351−
352− runOb_ = augmentWithVerbosity run_ ob isVerbose
353− runOb = augmentWithVerbosity run ob isVerbose
354− testObRunInDir' = augmentWithVerbosity testObRunInDir ob isVerbose ["run"]
355− testThunkPack' = augmentWithVerbosity testThunkPack ob isVerbose []
356−
357− withObeliskImplClean f =
358− withSystemTempDirectory "obelisk-impl-clean" $ \obeliskImpl -> do
359− void . shellyOb verbosity $ do
360− dirtyFiles <- T.strip <$> run gitPath ["-C", toTextIgnore obeliskRepoReadOnly, "diff", "--stat"]
361− () <- when (dirtyFiles /= "") $ error "SelfTest does not work correctly with dirty obelisk repos as remote"
362− run_ gitPath ["clone", "file://" <> toTextIgnore obeliskRepoReadOnly, toTextIgnore obeliskImpl]
363− f obeliskImpl
364−
365− withInitCache f =
366− withSystemTempDirectory "init Cache λ" $ \initCache -> do
367− -- Setup the ob init cache
368− void . shellyOb verbosity $ chdir initCache $ do
369− runOb_ ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
370− run_ gitPath ["init"]
371−
372− f initCache
373−
374− shelly_ = void . shellyOb verbosity
375−
376− defaultTmpDirName = "test λ"
377−
378− inTmp' :: FilePath -> (FilePath -> Sh a) -> IO ()
379− inTmp' dirname f = withTmp' dirname (chdir <*> f)
380− inTmp = inTmp' defaultTmpDirName
381−
382− withTmp' dirname f = shelly_ . withSystemTempDirectory dirname $ f . fromString
383− withTmp = withTmp' defaultTmpDirName
384−
385− assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
386− assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
387−
388− revParseHead = T.strip <$> run gitPath ["rev-parse", "HEAD"]
389−
390− commitAll = do
391− run_ gitPath ["add", "."]
392− commit "checkpoint"
393− revParseHead
394−
395− thunk = ".obelisk/impl"
396− update = runOb ["thunk", "update", thunk] *> commitAll
397− pack = runOb ["thunk", "pack", thunk] *> commitAll
398− unpack = runOb ["thunk", "unpack", thunk] *> commitAll
399−
400− diff a b = run gitPath ["diff", a, b]
401−
402−
403−maskExitSuccess :: Sh () -> Sh ()
404−maskExitSuccess = handle_sh (\case ExitSuccess -> pure (); e -> throw e)
405
235
406-- | Run `ob run` in the given directory (maximum of one level deep)
236-- | Run `ob run` in the given directory (maximum of one level deep)
407−testObRunInDir :: String -> [Text] -> Maybe FilePath -> HTTP.Manager -> Sh ()
237+testObRunInDir :: Socket.PortNumber -> Socket.PortNumber -> Maybe Shelly.FilePath -> HTTP.Manager -> Sh ()
408−testObRunInDir executable extraArgs mdir httpManager = maskExitSuccess $ do
238+testObRunInDir p0 p1 mdir httpManager = handle_sh (\case ExitSuccess -> pure (); e -> throw e) $ do
409− [p0, p1] <- liftIO $ getFreePorts 2
410 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
239 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
411 writefile "config/common/route" $ uri p0
240 writefile "config/common/route" $ uri p0
412− maybe id chdir mdir $ runHandles executable extraArgs [] $ \_stdin stdout stderr -> do
241+ maybe id chdir mdir $ runHandle "ob" ["run"] $ \stdout -> do
413− firstUri <- handleObRunStdout httpManager stdout stderr
242+ firstUri <- handleObRunStdout httpManager stdout
414 let newUri = uri p1
243 let newUri = uri p1
415 when (firstUri == newUri) $ errorExit $
244 when (firstUri == newUri) $ errorExit $
416 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
245 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
417 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
246 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
418− runningUri <- handleObRunStdout httpManager stdout stderr
247+ runningUri <- handleObRunStdout httpManager stdout
419 if runningUri /= newUri
248 if runningUri /= newUri
420 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
249 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
421 else exit 0
250 else exit 0
422
251
423−testThunkPack :: String -> [Text] -> FilePath -> Sh ()
252+testThunkPack :: Shelly.FilePath -> Sh ()
424−testThunkPack executable args path' = withTempFile repoDir "test-file" $ \file handle -> do
253+testThunkPack path' = withTempFile (T.unpack $ toTextIgnore path') "test-file" $ \file handle -> do
425− let
426− pack' = readProcessWithExitCode executable (["thunk", "pack", path'] ++ map T.unpack args) ""
254+ let pack' = readProcessWithExitCode "ob" ["thunk", "pack", T.unpack $ toTextIgnore path'] ""
427− ensureThunkPackFails q = liftIO $ pack' >>= \case
255+ ensureThunkPackFails q = liftIO $ pack' >>= \case
428− (code, out, err)
256+ (code, out, err)
429− | code == ExitSuccess -> fail $ "ob thunk pack succeeded when it should have failed with error '" <> show q <> "'"
257+ | code == ExitSuccess -> fail "ob thunk pack succeeded when it should have failed"
430− | q `T.isInfixOf` T.pack (out <> err) -> pure ()
258+ | q `T.isInfixOf` T.pack (out <> err) -> pure ()
431− | otherwise -> fail $ "ob thunk pack failed for an unexpected reason, expecting '" <> show q <> "', received: " <> show out <> "\nstderr: " <> err
259+ | otherwise -> fail $ "ob thunk pack failed for an unexpected reason: " <> show out <> "\nstderr: " <> err
432− git = chdir repoDir . run_ gitPath
260+ git = chdir path' . run "git"
433 -- Untracked files
261 -- Untracked files
434 ensureThunkPackFails "Untracked files"
262 ensureThunkPackFails "Untracked files"
435− git ["add", T.pack file]
263+ void $ git ["add", T.pack file]
436 -- Uncommitted files (staged)
264 -- Uncommitted files (staged)
437 ensureThunkPackFails "unsaved"
265 ensureThunkPackFails "unsaved"
438− chdir repoDir $ commit "test commit"
266+ chdir path' $ commit "test commit"
439 -- Non-pushed commits in any branch
267 -- Non-pushed commits in any branch
440 ensureThunkPackFails "not yet pushed"
268 ensureThunkPackFails "not yet pushed"
441 -- Uncommitted files (unstaged)
269 -- Uncommitted files (unstaged)
442 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
270 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
443 ensureThunkPackFails "modified"
271 ensureThunkPackFails "modified"
444 -- Existing stashes
272 -- Existing stashes
445− git $ gitUserConfig <> [ "stash" ]
273+ void $ git ["stash"]
446 ensureThunkPackFails "has stashes"
274 ensureThunkPackFails "has stashes"
447− where
448− repoDir = path' </> unpackedDirName
449
275
450-- | Blocks until a non-empty line is available
276-- | Blocks until a non-empty line is available
451hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
277hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
@@ -465,12 +291,9 @@ alterRouteTo uri stdout = do
465 "Reloading failed: " <> T.pack (show t)
291 "Reloading failed: " <> T.pack (show t)
466
292
467-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
293-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
468−handleObRunStdout :: HTTP.Manager -> Handle -> Handle -> Sh Text
294+handleObRunStdout :: HTTP.Manager -> Handle -> Sh Text
469−handleObRunStdout httpManager stdout stderr = flip fix (ObRunState_Init, []) $ \loop (state, msgs) -> do
295+handleObRunStdout httpManager stdout = flip fix (ObRunState_Init, []) $ \loop (state, msgs) -> do
470− isEOF <- liftIO $ hIsEOF stdout
471− if isEOF
472− then handleObRunError msgs
473− else liftIO (T.hGetLine stdout) >>= \t -> case state of
296+ liftIO (T.hGetLine stdout) >>= \t -> case state of
474 ObRunState_Init
297 ObRunState_Init
475 | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
298 | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
476 ObRunState_Startup
299 ObRunState_Startup
@@ -482,12 +305,8 @@ handleObRunStdout httpManager stdout stderr = flip fix (ObRunState_Init, []) $ \
482 obRunCheck httpManager stdout uri
305 obRunCheck httpManager stdout uri
483 pure uri
306 pure uri
484 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
307 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
485− _ | "Failed" `T.isPrefixOf` t -> handleObRunError (t : msgs)
308+ _ | "Failed" `T.isPrefixOf` t -> errorExit $ "ob run failed: " <> T.unlines (reverse $ t : msgs)
486 | otherwise -> loop (state, t : msgs)
309 | otherwise -> loop (state, t : msgs)
487− where
488− handleObRunError msgs = do
489− stderrContent <- liftIO $ hGetContents stderr
490− errorExit $ "ob run failed: " <> T.unlines (reverse msgs) <> " stderr: " <> T.pack stderrContent
491
310
492-- | Make requests to frontend/backend servers to check they are working properly
311-- | Make requests to frontend/backend servers to check they are working properly
493obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
312obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
@@ -506,121 +325,3 @@ getFreePorts n = Socket.withSocketsDo $ do
506 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
325 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
507 Socket.bind sock (Socket.addrAddress addr)
326 Socket.bind sock (Socket.addrAddress addr)
508 pure sock
327 pure sock
509−
510−testLegacyGitThunks :: Bool -> IO ()
511−testLegacyGitThunks isVerbose = withSystemTempDirectory "test-git-repo" $ \gitDir -> do
512− isolatedGitShell isVerbose gitDir $ \git -> do
513− writefile (gitDir </> ("default.nix" :: FilePath)) "{}: \"hello\""
514− _ <- git ["add", "--all"]
515− _ <- git ["commit", "-m", "Initial commit"]
516− rev <- T.strip <$> git ["rev-parse", "HEAD"]
517− sha256 :: Text
518− <- either error pure
519− =<< (Aeson.parseEither (Aeson..: "sha256") <=< Aeson.eitherDecodeStrict . T.encodeUtf8)
520− <$> run nixPrefetchGitPath [toTextIgnore gitDir]
521−
522− for_ (legacyGitThunks (GitThunkParams gitDir rev sha256)) $ \mkFiles ->
523− withSystemTempDirectory "test-thunks" $ \thunkDir -> do
524− liftIO $ mkFiles thunkDir
525− run_ "ob" ["thunk", "unpack", toTextIgnore thunkDir]
526− run_ "ob" ["thunk", "pack", toTextIgnore thunkDir]
527−
528−data GitThunkParams = GitThunkParams
529− { _gitThunkParams_repo :: !FilePath
530− , _gitThunkParams_rev :: !Text
531− , _gitThunkParams_sha256 :: !Text
532− } deriving Show
533−
534−legacyGitThunks :: GitThunkParams -> [FilePath -> IO ()]
535−legacyGitThunks (GitThunkParams repo' rev sha256) =
536− [ mkLegacyIO
537− (T.unlines
538− [ "# DO NOT HAND-EDIT THIS FILE"
539− , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
540− , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
541− , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
542− ]
543− )
544− (Map.fromList
545− [ ("url", repo)
546− , ("rev", rev)
547− , ("branch", "master")
548− , ("sha256", sha256)
549− ]
550− )
551− , mkLegacyIO
552− (T.unlines
553− [ "# DO NOT HAND-EDIT THIS FILE"
554− , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
555− , " if builtins.hasAttr \"fetchGit\" builtins"
556− , " then builtins.fetchGit ({ inherit url rev; } // (if branch == null then {} else { ref = branch; }))"
557− , " else abort \"Plain Git repositories are only supported on nix 2.0 or higher.\";"
558− , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
559− ]
560− )
561− (Map.fromList
562− [ ("url", repo)
563− , ("rev", rev)
564− , ("branch", "master")
565− , ("sha256", sha256)
566− ]
567− )
568− , mkLegacyIO
569− (T.unlines
570− [ "# DO NOT HAND-EDIT THIS FILE"
571− , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
572− , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
573− , " if firstChar == \"/\" then /. + url"
574− , " else if firstChar == \".\" then ./. + url"
575− , " else url;"
576− , " in if !fetchSubmodules && private then builtins.fetchGit {"
577− , " url = realUrl; inherit rev;"
578− , " } else (import <nixpkgs> {}).fetchgit {"
579− , " url = realUrl; inherit rev sha256;"
580− , " };"
581− , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
582− ]
583− )
584− (Map.fromList
585− [ ("url", Aeson.String repo)
586− , ("rev", Aeson.String rev)
587− , ("branch", Aeson.String "master")
588− , ("sha256", Aeson.String sha256)
589− , ("private", Aeson.Bool False)
590− ]
591− )
592− , mkLegacyIO
593− (T.unlines
594− [ "# DO NOT HAND-EDIT THIS FILE"
595− , "let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
596− , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
597− , " if firstChar == \"/\" then /. + url"
598− , " else if firstChar == \".\" then ./. + url"
599− , " else url;"
600− , " in if !fetchSubmodules && private then builtins.fetchGit {"
601− , " url = realUrl; inherit rev;"
602− , " ${if branch == null then null else \"ref\"} = branch;"
603− , " } else (import <nixpkgs> {}).fetchgit {"
604− , " url = realUrl; inherit rev sha256;"
605− , " };"
606− , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
607− ]
608− )
609− (Map.fromList
610− [ ("url", Aeson.String repo)
611− , ("rev", Aeson.String rev)
612− , ("branch", Aeson.String "master")
613− , ("sha256", Aeson.String sha256)
614− , ("private", Aeson.Bool False)
615− ]
616− )
617− ]
618− where
619− repo = T.pack repo'
620− mkLegacyIO :: Aeson.ToJSON v => Text -> Map.Map Text v -> FilePath -> IO ()
621− mkLegacyIO defaultNix gitJson dir = do
622− T.writeFile (dir </> ("default.nix" :: FilePath)) defaultNix
623− LBS.writeFile (dir </> ("git.json" :: FilePath)) (Aeson.encode gitJson)
624−
625−unpackedDirName :: FilePath
626−unpackedDirName = "."
lib/snap-extras/obelisk-snap-extras.cabal+3−2
@@ -1,6 +1,6 @@
1name: obelisk-snap-extras
1name: obelisk-snap-extras
2version: 0.1
2version: 0.1
3−synopsis: Extra functionality for Snap that should be considered for upstreaming
3+synopsys: Extra functionality for Snap that should be considered for upstreaming
4license: BSD3
4license: BSD3
5build-type: Simple
5build-type: Simple
6cabal-version: >=1.2
6cabal-version: >=1.2
@@ -12,9 +12,10 @@ library
12 , base
12 , base
13 , bytestring
13 , bytestring
14 , snap-core
14 , snap-core
15+ , unix
15 , directory
16 , directory
16 , filepath
17 , filepath
17 , text
18 , text
18 exposed-modules:
19 exposed-modules:
19 Obelisk.Snap.Extras
20 Obelisk.Snap.Extras
20− ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
21+ ghc-options: -Wall
lib/snap-extras/src/Obelisk/Snap/Extras.hs+2−2
@@ -2,13 +2,13 @@
2module Obelisk.Snap.Extras
2module Obelisk.Snap.Extras
3 ( cachePermanently
3 ( cachePermanently
4 , doNotCache
4 , doNotCache
5− , ensureSecure
6 , serveFileIfExists
5 , serveFileIfExists
7 , serveFileIfExistsAs
6 , serveFileIfExistsAs
8 ) where
7 ) where
9
8
10import Control.Monad.IO.Class
9import Control.Monad.IO.Class
11import Data.ByteString (ByteString)
10import Data.ByteString (ByteString)
11+import Data.Monoid
12import Data.String
12import Data.String
13import Snap.Core
13import Snap.Core
14import Snap.Util.FileServe
14import Snap.Util.FileServe
@@ -17,7 +17,7 @@ import System.Directory
17-- | Set response header for "permanent" caching
17-- | Set response header for "permanent" caching
18cachePermanently :: MonadSnap m => m ()
18cachePermanently :: MonadSnap m => m ()
19cachePermanently = do
19cachePermanently = do
20− modifyResponse $ setHeader "Cache-Control" "public, max-age=315360000, immutable"
20+ modifyResponse $ setHeader "Cache-Control" "public, max-age=315360000"
21 modifyResponse $ setHeader "Expires" "Tue, 01 Feb 2050 00:00:00 GMT" --TODO: This should be set to "approximately one year from the time the response is sent"
21 modifyResponse $ setHeader "Expires" "Tue, 01 Feb 2050 00:00:00 GMT" --TODO: This should be set to "approximately one year from the time the response is sent"
22
22
23-- | Set response header to not cache
23-- | Set response header to not cache
lib/tabulation/src/Data/Tabulation.hs+1−1
@@ -8,7 +8,7 @@ import Control.Lens
8-- | This is a class for record types whose fields can be enumerated by an associated GADT. It's closely related to the concept of a representable functor, except without the functor part, and the fields are not all the same type.
8-- | This is a class for record types whose fields can be enumerated by an associated GADT. It's closely related to the concept of a representable functor, except without the functor part, and the fields are not all the same type.
9class HasFields a where
9class HasFields a where
10 type Field a :: * -> *
10 type Field a :: * -> *
11−
11+
12 fieldLens :: Field a x -> Lens' a x
12 fieldLens :: Field a x -> Lens' a x
13 tabulateFieldsA :: Applicative f => (forall x. Field a x -> f x) -> f a
13 tabulateFieldsA :: Applicative f => (forall x. Field a x -> f x) -> f a
14
14
nixpkgs-overlays/default.nixdeleted−15
@@ -1,15 +0,0 @@
1−self: super:
2−
3−let
4− inherit (self) lib;
5− inherit (import ../dep/gitignore.nix { inherit lib; }) gitignoreSource;
6−in {
7− obeliskCleanSource = src:
8− # WARNING: The order of application here seems to matter a great deal to
9− # how quickly `ghcid` is able to reload changes. As a rule of thumb,
10− # always apply `gitignoreSource` first.
11− # See https://github.com/obsidiansystems/obelisk/pull/666 and related.
12− lib.cleanSource (gitignoreSource src);
13−
14− obeliskExecutableConfig = self.callPackage ../lib/executable-config {};
15−}
release.nix+89−8
@@ -1,10 +1,91 @@
1−{
1+{ self-args ? {}
2− supportedSystems ? [ "x86_64-linux" "x86_64-darwin" ]
2+, local-self ? import ./. self-args
3}:
3}:
4−rec {
5− recurseForDerivations = true;
6− build = import ./all-builds.nix { inherit supportedSystems; };
7− test = import ./all-tests.nix { inherit supportedSystems; };
8
4
9− inherit (build) metaCache;
5+let
10−}
6+ inherit (local-self.nixpkgs) lib runCommand nix;
7+
8+ cacheBuildSystems = [ "x86_64-linux" "x86_64-darwin" ];
9+
10+ obeliskPackagesCommon = [
11+ "obelisk-frontend"
12+ "obelisk-route"
13+ "obelisk-executable-config-lookup"
14+ ];
15+
16+ obeliskPackagesBackend = obeliskPackagesCommon ++ [
17+ "obelisk-asset-manifest"
18+ "obelisk-asset-serve-snap"
19+ "obelisk-backend"
20+ "obelisk-cliapp"
21+ "obelisk-command"
22+ "obelisk-executable-config-inject"
23+ "obelisk-frontend"
24+ "obelisk-run"
25+ "obelisk-route"
26+ "obelisk-selftest"
27+ "obelisk-snap-extras"
28+ ];
29+
30+ pnameToAttrs = pkgsSet: pnames:
31+ lib.listToAttrs (map
32+ (name: { inherit name; value = pkgsSet.${name}; })
33+ pnames);
34+
35+ concatDepends = let
36+ extractDeps = x: (x.override {
37+ mkDerivation = drv: {
38+ out = builtins.concatLists [
39+ (drv.buildDepends or [])
40+ (drv.libraryHaskellDepends or [])
41+ (drv.executableHaskellDepends or [])
42+ ];
43+ };
44+ }).out;
45+ in pkgAttrs: builtins.concatLists (map extractDeps (builtins.attrValues pkgAttrs));
46+
47+ perPlatform = lib.genAttrs cacheBuildSystems (system: let
48+ obelisk = import ./. { inherit system; };
49+ reflex-platform = obelisk.reflex-platform;
50+ ghc = pnameToAttrs
51+ obelisk.haskellPackageSets.ghc
52+ obeliskPackagesBackend;
53+ ghcjs = pnameToAttrs
54+ obelisk.haskellPackageSets.ghcjs
55+ obeliskPackagesCommon;
56+ cachePackages = builtins.concatLists [
57+ (builtins.attrValues ghc)
58+ (builtins.attrValues ghcjs)
59+ (concatDepends ghc)
60+ (concatDepends ghcjs)
61+ ];
62+ command = local-self.command;
63+ serverExeSkeleton = (import ./skeleton { obelisk = local-self; }).exe;
64+ androidObelisk = import ./. (self-args // {
65+ config.android_sdk.accept_license = true;
66+ });
67+ androidSkeleton = (import ./skeleton { obelisk = androidObelisk; }).android.frontend;
68+ iosObelisk = import ./. (self-args // {
69+ system = "x86_64-darwin";
70+ iosSdkVersion = "10.2";
71+ });
72+ iosSkeleton = (import ./skeleton { obelisk = iosObelisk; }).ios.frontend;
73+ in {
74+ inherit
75+ command
76+ ghc ghcjs
77+ serverExeSkeleton
78+ iosSkeleton
79+ androidSkeleton;
80+ cache = reflex-platform.pinBuildInputs
81+ "obelisk-${system}"
82+ cachePackages
83+ [command serverExeSkeleton iosSkeleton androidSkeleton];
84+ });
85+
86+ metaCache = local-self.pinBuildInputs
87+ "obelisk-everywhere"
88+ (map (a: a.cache) (builtins.attrValues perPlatform))
89+ [];
90+
91+in perPlatform // { inherit metaCache; }
scripts/ghcid-this-libnew file+4
@@ -0,0 +1,4 @@
1+#!/usr/bin/env bash
2+set -euo pipefail
3+
4+nix-shell -E "with (import ../.. {}); reflex-platform.workOn haskellPackageSets.ghc haskellPackageSets.ghc.obelisk-$(basename $PWD)" --run "cabal configure ; ghcid -c'cabal repl'"
skeleton/.gitignore+5−13
@@ -1,15 +1,7 @@
1+dist-newstyle
2+result
3+result-android
4+result-ios
5+result-exe
1.attr-cache
6.attr-cache
2−.cabal-sandbox
3−*.hi
4−*.o
5−cabal.project.local
6−cabal.sandbox.config
7−ctags
8−dist-newstyle/
9−dist/
10ghcid-output.txt
7ghcid-output.txt
11−profile/
12−result
13−result-*
14−tags
15−TAGS
skeleton/backend/backend.cabal+1−2
@@ -14,12 +14,11 @@ library
14 , obelisk-route
14 , obelisk-route
15 exposed-modules:
15 exposed-modules:
16 Backend
16 Backend
17− ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
17+ ghc-options: -Wall
18
18
19executable backend
19executable backend
20 main-is: main.hs
20 main-is: main.hs
21 hs-source-dirs: src-bin
21 hs-source-dirs: src-bin
22− ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -threaded -fno-show-valid-hole-fits
23 if impl(ghcjs)
22 if impl(ghcjs)
24 buildable: False
23 buildable: False
25 build-depends: base
24 build-depends: base
skeleton/backend/src/Backend.hs+5
@@ -1,3 +1,8 @@
1+{-# LANGUAGE EmptyCase #-}
2+{-# LANGUAGE FlexibleContexts #-}
3+{-# LANGUAGE LambdaCase #-}
4+{-# LANGUAGE RankNTypes #-}
5+{-# LANGUAGE TypeFamilies #-}
1module Backend where
6module Backend where
2
7
3import Common.Route
8import Common.Route
skeleton/cabal.project−1
@@ -1,3 +1,2 @@
1optional-packages:
1optional-packages:
2 *
2 *
3−write-ghc-environment-files: never
skeleton/common/common.cabal+3−1
@@ -9,7 +9,9 @@ library
9 , obelisk-route
9 , obelisk-route
10 , mtl
10 , mtl
11 , text
11 , text
12+ default-extensions:
13+ TypeFamilies
14+ PolyKinds
12 exposed-modules:
15 exposed-modules:
13 Common.Api
16 Common.Api
14 Common.Route
17 Common.Route
15− ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
skeleton/common/src/Common/Route.hs+6−5
@@ -1,14 +1,15 @@
1{-# LANGUAGE EmptyCase #-}
1{-# LANGUAGE EmptyCase #-}
2{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE FlexibleContexts #-}
3−{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE GADTs #-}
3{-# LANGUAGE GADTs #-}
5−{-# LANGUAGE KindSignatures #-}
6{-# LANGUAGE LambdaCase #-}
4{-# LANGUAGE LambdaCase #-}
7−{-# LANGUAGE MultiParamTypeClasses #-}
8−{-# LANGUAGE OverloadedStrings #-}
9{-# LANGUAGE RankNTypes #-}
5{-# LANGUAGE RankNTypes #-}
10{-# LANGUAGE TemplateHaskell #-}
6{-# LANGUAGE TemplateHaskell #-}
11−{-# LANGUAGE TypeFamilies #-}
7+{-# LANGUAGE KindSignatures #-}
8+{-# LANGUAGE EmptyCase #-}
9+{-# LANGUAGE MultiParamTypeClasses #-}
10+{-# LANGUAGE FlexibleInstances #-}
11+{-# LANGUAGE OverloadedStrings #-}
12+
12module Common.Route where
13module Common.Route where
13
14
14{- -- You will probably want these imports for composing Encoders.
15{- -- You will probably want these imports for composing Encoders.
skeleton/default.nix+7−14
@@ -1,17 +1,10 @@
1+{ obelisk ? import ./.obelisk/impl {
1−{ system ? builtins.currentSystem
2+ system = builtins.currentSystem;
2−, obelisk ? import ./.obelisk/impl {
3− inherit system;
4− iosSdkVersion = "13.2";
3+ iosSdkVersion = "10.2";
5−
6− # You must accept the Android Software Development Kit License Agreement at
4+ # You must accept the Android Software Development Kit License Agreement at
7− # https://developer.android.com/studio/terms in order to build Android apps.
5+ # https://developer.android.com/studio/terms in order to build Android apps.
8− # Uncomment and set this to `true` to indicate your acceptance:
6+ # Uncomment and set this to `true` to indicate your acceptance:
9− # config.android_sdk.accept_license = false;
7+ # config.android_sdk.accept_license = false;
10−
11− # In order to use Let's Encrypt for HTTPS deployments you must accept
12− # their terms of service at https://letsencrypt.org/repository/.
13− # Uncomment and set this to `true` to indicate your acceptance:
14− # terms.security.acme.acceptTerms = false;
15 }
8 }
16}:
9}:
17with obelisk;
10with obelisk;
skeleton/frontend/frontend.cabal+4−7
@@ -9,14 +9,13 @@ library
9 , common
9 , common
10 , obelisk-frontend
10 , obelisk-frontend
11 , obelisk-route
11 , obelisk-route
12− , jsaddle
13 , reflex-dom
12 , reflex-dom
14 , obelisk-executable-config-lookup
13 , obelisk-executable-config-lookup
15 , obelisk-generated-static
14 , obelisk-generated-static
16 , text
15 , text
17 exposed-modules:
16 exposed-modules:
18 Frontend
17 Frontend
19− ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
18+ ghc-options: -Wall
20
19
21executable frontend
20executable frontend
22 main-is: main.hs
21 main-is: main.hs
@@ -28,9 +27,7 @@ executable frontend
28 , reflex-dom
27 , reflex-dom
29 , obelisk-generated-static
28 , obelisk-generated-static
30 , frontend
29 , frontend
31− ghc-options: -threaded -O -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -fno-show-valid-hole-fits
30+ --TODO: Make these ghc-options optional
32− if impl(ghcjs)
31+ ghc-options: -threaded
33− ghc-options: -dedupe
34− cpp-options: -DGHCJS_BROWSER
35 if os(darwin)
32 if os(darwin)
36− ghc-options: -dynamic
33+ ghc-options: -dynamic
skeleton/frontend/src/Frontend.hs+5−23
@@ -1,48 +1,30 @@
1{-# LANGUAGE DataKinds #-}
1{-# LANGUAGE DataKinds #-}
2{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE TypeApplications #-}
3{-# LANGUAGE TypeApplications #-}
4−
5module Frontend where
4module Frontend where
6
5
7−import Control.Monad
8import qualified Data.Text as T
6import qualified Data.Text as T
9import qualified Data.Text.Encoding as T
7import qualified Data.Text.Encoding as T
10−import Language.Javascript.JSaddle (eval, liftJSM)
11−
12import Obelisk.Frontend
8import Obelisk.Frontend
13import Obelisk.Configs
9import Obelisk.Configs
14import Obelisk.Route
10import Obelisk.Route
15−import Obelisk.Generated.Static
16−
17import Reflex.Dom.Core
11import Reflex.Dom.Core
18
12
19import Common.Api
13import Common.Api
20import Common.Route
14import Common.Route
15+import Obelisk.Generated.Static
21
16
22−
23−-- This runs in a monad that can be run on the client or the server.
24−-- To run code in a pure client or pure server context, use one of the
25−-- `prerender` functions.
26frontend :: Frontend (R FrontendRoute)
17frontend :: Frontend (R FrontendRoute)
27frontend = Frontend
18frontend = Frontend
28− { _frontend_head = do
29− el "title" $ text "Obelisk Minimal Example"
19+ { _frontend_head = el "title" $ text "Obelisk Minimal Example"
30− elAttr "link" ("href" =: static @"main.css" <> "type" =: "text/css" <> "rel" =: "stylesheet") blank
31 , _frontend_body = do
20 , _frontend_body = do
32− el "h1" $ text "Welcome to Obelisk!"
21+ text "Welcome to Obelisk!"
33 el "p" $ text $ T.pack commonStuff
22 el "p" $ text $ T.pack commonStuff
34−
35− -- `prerender` and `prerender_` let you choose a widget to run on the server
36− -- during prerendering and a different widget to run on the client with
37− -- JavaScript. The following will generate a `blank` widget on the server and
38− -- print "Hello, World!" on the client.
39− prerender_ blank $ liftJSM $ void $ eval ("console.log('Hello, World!')" :: T.Text)
40−
41 elAttr "img" ("src" =: static @"obelisk.jpg") blank
23 elAttr "img" ("src" =: static @"obelisk.jpg") blank
42 el "div" $ do
24 el "div" $ do
43− exampleConfig <- getConfig "common/example"
25+ exampleConfig <- getConfig "common/example"
44 case exampleConfig of
26 case exampleConfig of
45 Nothing -> text "No config file found in config/common/example"
27 Nothing -> text "No config file found in config/common/example"
46− Just s -> text $ T.decodeUtf8 s
28+ Just s -> text (T.decodeUtf8 s)
47 return ()
29 return ()
48 }
30 }
skeleton/static/main.cssdeleted−3
@@ -1,3 +0,0 @@
1−p {
2− color: red;
3−}