on master help sign in
Merge remote-tracking branch 'origin/develop' into use-posix-escape
commitb83026ec7121b004720ee2c4a5a37697b6f5dfc0 authorTom Smalley <tfsmalley@gmail.com> dateTue 5 May 2020, 20:44 (6 years ago) parent43450eb662777e
72 files changed+3549−1716
.github/pull_request_template.md+8 ChangeLog.md+71−1 LICENSE+30 README.md+111−33 all-builds.nix+113 all-tests.nix+145 default.nix+185−177 dep/.gitignore−5 dep/gitignore.nix/default.nix+8 dep/gitignore.nix/github.json+8 dep/reflex-platform/default.nix+7−6 dep/reflex-platform/github.json+4−3 dep/snap-core/default.nix+8 dep/snap-core/github.json+8 guides/app-deploy/README.md+318 guides/app-deploy/assets/android-app.jpg guides/app-deploy/assets/android-confirm-usb-debugging.jpg guides/app-deploy/assets/app-deploy-2.png guides/app-deploy/assets/app-deploy.png guides/app-deploy/assets/ios-deploy-example.png guides/app-deploy/assets/ios-deploy-keychain.png guides/app-deploy/assets/ios-obelisk-app-icon.jpg guides/app-deploy/assets/ios-obelisk-app-open.jpg guides/app-deploy/assets/nano-edit-nixos-configuration.png guides/app-deploy/assets/virtualbox-appliance-import-loading.png guides/app-deploy/assets/virtualbox-appliance-import.png guides/app-deploy/assets/virtualbox-dashboard-nixos.png guides/app-deploy/assets/virtualbox-image-settings-network.png guides/app-deploy/assets/virtualbox-nioxs-after-boot.png guides/app-deploy/assets/xcode-devices.png haskell-overlays/ghcide.nix+34 haskell-overlays/misc-deps.nix+20 haskell-overlays/obelisk.nix+43 haskell-overlays/tighten-ob-exes.nix+32 jobsets.nix−71 lib/asset/serve-snap/src/Obelisk/Asset/Accept.hs+6−6 lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+14−4 lib/backend/src/Obelisk/Backend.hs+119−35 lib/cliapp/obelisk-cliapp.cabal+3−3 lib/cliapp/src/Obelisk/CliApp.hs+2 lib/cliapp/src/Obelisk/CliApp/Demo.hs−52 lib/cliapp/src/Obelisk/CliApp/Logging.hs+11−10 lib/cliapp/src/Obelisk/CliApp/Process.hs+23−3 lib/cliapp/src/Obelisk/CliApp/Spinner.hs−1 lib/command/obelisk-command.cabal+12−12 lib/command/src/Obelisk/Command.hs+168−151 lib/command/src/Obelisk/Command/Deploy.hs+94−75 lib/command/src/Obelisk/Command/Nix.hs+67−26 lib/command/src/Obelisk/Command/Preprocessor.hs+95 lib/command/src/Obelisk/Command/Project.hs+120−53 lib/command/src/Obelisk/Command/Run.hs+430−151 lib/command/src/Obelisk/Command/Thunk.hs+477−299 lib/command/src/Obelisk/Command/Upgrade/Hash.hs−114 lib/command/src/Obelisk/Command/Utils.hs+40−9 lib/command/src/Obelisk/Command/VmBuilder.hs+2−1 lib/executable-config/default.nix+25−18 lib/executable-config/lookup/src-other/Obelisk/ExecutableConfig/Lookup.hs+1−8 lib/frontend/src/Obelisk/Frontend.hs+9−9 lib/frontend/src/Obelisk/Frontend/Cookie.hs+2−1 lib/route/src/Obelisk/Route.hs+75−36 lib/route/src/Obelisk/Route/Frontend.hs+80−16 lib/run/src/Obelisk/Run.hs+11−6 lib/selftest/obelisk-selftest.cabal+3−1 lib/selftest/src/Obelisk/SelfTest.hs+468−220 lib/snap-extras/obelisk-snap-extras.cabal+1−1 lib/snap-extras/src/Obelisk/Snap/Extras.hs+1−1 nixpkgs-overlays/default.nix+15 release.nix+8−95 skeleton/.gitignore+1 skeleton/backend/src/Backend.hs−3 skeleton/frontend/frontend.cabal+1 skeleton/frontend/src/Frontend.hs+12
.github/pull_request_template.mdnew file+8
@@ -0,0 +1,8 @@
1+<!-- Provide a clear overview of your changes. -->
2+
3+I have:
4+
5+ - [ ] Based work on latest `develop` branch
6+ - [ ] Looked for lint in my changes with `hlint .` (lint found code you did not write can be left alone)
7+ - [ ] Run the test suite: `$(nix-build -A selftest --no-out-link)`
8+ - [ ] (Optional) Run CI tests locally: `nix-build release.nix -A build.x86_64-linux --no-out-link` (or `x86_64-darwin` on macOS)
ChangeLog.md+71−1
@@ -1,9 +1,64 @@
11# Revision history for obelisk
22
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.
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.
44
55## Unreleased
66
7+* ([#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`.
8+
9+## v0.8.0.0
10+
11+* ([#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 think wrapper around that.
12+* ([#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.
13+
14+ **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.
15+* ([#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.
16+* ([#705](https://github.com/obsidiansystems/obelisk/pull/705)) Add `Obelisk.Route.packTextEncoder` and generalize `Obelisk.Route.unpackTextEncoder` over any `Data.Text.Lens.IsText`.
17+* ([#712](https://github.com/obsidiansystems/obelisk/pull/712)) Update [`reflex-platform`](https://github.com/reflex-frp/reflex-platform) to version 0.5.3.0.
18+* ([#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 it's own `.obelisk/impl`.
19+* ([#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`.
20+* ([#709](https://github.com/obsidiansystems/obelisk/pull/709)) Fix a bug in obelisk's preprocessor causing it to incorrectly skip files in some circumstances.
21+* ([#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.
22+* ([#714](https://github.com/obsidiansystems/obelisk/pull/714)) Miscellaneous improvements to CLI help and logging.
23+
24+## v0.7.0.1
25+
26+* Fix the version number for `ob` the command-line tool. ([#679](https://github.com/obsidiansystems/obelisk/pull/679))
27+
28+## v0.7.0.0
29+
30+* 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))
31+* Support non-EC2 deployments. ([#658](https://github.com/obsidiansystems/obelisk/pull/658))
32+* Fix `ob deploy test android` to work. ([#645](https://github.com/obsidiansystems/obelisk/pull/645))
33+* 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.)
34+* Add `Obelisk.Backend.runBackendWith` to allow several customizations. ([#668](https://github.com/obsidiansystems/obelisk/pull/668), [#644](https://github.com/obsidiansystems/obelisk/pull/644))
35+* 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))
36+* 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))
37+* Bump reflex-platform to v0.5.2.0. ([#671](https://github.com/obsidiansystems/obelisk/pull/671))
38+
39+## v0.6.0.0 - 2020-02-21
40+
41+* 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))
42+* 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))
43+* 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))
44+* Removed `Obelisk.Backend.mkRouteToUrl` since it is easily written in terms of `Obelisk.Route.renderObeliskRoute`:
45+
46+ mkRouteToUrl validFullEncoder (k :/ v) = renderObeliskRoute validFullEncoder (FullRoute_Frontend (ObeliskRoute_App k) :/ v)
47+
48+* Add `Obelisk.Backend.renderAllJsPath` to expose URL path to `ghcjs/all.js`. ([#545](https://github.com/obsidiansystems/obelisk/pull/545))
49+* 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))
50+
51+## v0.5.0.0 - 2020-02-07
52+
53+* Add `Obelisk.Route.(?/)`, a convenience function for constructing routes nested in `Maybe`. ([#457](https://github.com/obsidiansystems/obelisk/pull/457))
54+* 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))
55+* 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))
56+* `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))
57+* 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))
58+* Improve handling of runtime nix dependencies. This may fix some issues encountered particularly by users on systems other than NixOS.
59+
60+## v0.4.0.0 - 2020-01-10
61+
762* Bump reflex-platform which, notably, bumps nixpkgs to 19.09. ([#585](https://github.com/obsidiansystems/obelisk/pull/585))
863* 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))
964* 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))
@@ -11,9 +66,24 @@ This project's release branch is `master`. This log is written from the perspect
1166* Improve error messaging when a dependency doesn't have the expected `.cabal` or `package.yaml` file. ([#597](https://github.com/obsidiansystems/obelisk/pull/597))
1267* Improve the skeleton in small ways. ([#593](https://github.com/obsidiansystems/obelisk/pull/593), [#589](https://github.com/obsidiansystems/obelisk/pull/589))
1368* Fix `ob` commands to again support running from any subdirectory of an obelisk project ([#591](https://github.com/obsidiansystems/obelisk/pull/591))
69+* Add `reflex-platform-func` argument to Obelisk's `default.nix`. It defaults to it's prior behavior of using the reflex-platform in in `dep`. ([#612](https://github.com/obsidiansystems/obelisk/pull/612))
1470
1571## v0.3.0.0 - 2019-12-20
1672
73+* Change the structure of Obelisk routes to use a designated
74+ `FullRoute` type. This combines frontend and backend routes into one
75+ structure. This is a **breaking** change which requires Obelisk apps
76+ to take specific migrations. They are:
77+ * Rewrite the implementation of `_backend_routeEncoder` in
78+ `Backend` to use `mkFullRouteEncoder` instead of
79+ `handleEncoder`. Specifically, the backend and frontend cases of
80+ the top-level `pathComponentEncoder` become the second and third
81+ arguments of `mkFullRouteEncoder` respectively, while the
82+ missing route becomes the first argument. An example of how to
83+ do this is available in [a reflex-examples
84+ commit](https://github.com/reflex-frp/reflex-examples/commits/28f566c3e7dc615578dc74297b7c620c1f13683e).
85+ * Replace type constructions of `InL` with `FullRoute_Backend` and
86+ `InR` with `FullRoute_Frontend`.
1787* Generalised `pathSegmentEncoder`, added `pathFieldEncoder`.
1888* Added some `Prism`s to the encoder library for manipulating `DSum`s.
1989* Add `ob doc` command, which lists paths to haddock documentation for specified packages.
LICENSEnew file+30
@@ -0,0 +1,30 @@
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+111−33
@@ -1,16 +1,24 @@
11# Obelisk
22
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://tldrlegal.com/license/bsd-3-clause-license-%28revised%29)
5+
6+
37Obelisk provides an easy way to develop and deploy your [Reflex](https://github.com/reflex-frp/reflex) project as web apps and as mobile apps.
48
59- [Installing Obelisk](#installing-obelisk)
610- [Developing an Obelisk project](#developing-an-obelisk-project)
7− - [Hoogle](#hoogle)
811 - [Adding Packages](#adding-packages)
912 - [Adding Package Overrides](#adding-package-overrides)
10− - [Running over https](#running-over-https)
13+ - [Running over HTTPS](#running-over-https)
14+ - [IDE Support](#ide-support)
15+ - [Terminal-based feedback](#terminal-based-feedback)
16+ - [Experimental `ghcide` support](#experimental-ghcide-support)
1117- [Deploying](#deploying)
1218 - [Locally](#locally)
13− - [EC2](#ec2)
19+ - [Default EC2 Deployment](#default-ec2-deployment)
20+ - [Custom Non-EC2 Deployment](#custom-non-ec2-deployment)
21+ - [VirtualBox Deployment](#virtualbox-deployment)
1422 - [From macOS](#from-macos)
1523 - [Deploying an updated version](#deploying-an-updated-version)
1624- [Mobile](#mobile)
@@ -23,14 +31,15 @@ Obelisk provides an easy way to develop and deploy your [Reflex](https://github.
23311. Set up nix caches
2432 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
2533 ```
26− nix.binaryCaches = [ "https://cache.nixos.org/" "https://nixcache.reflex-frp.org" ];
34+ nix.binaryCaches = [ "https://nixcache.reflex-frp.org" ];
2735 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
2836 ```
2937 and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
3038 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)):
3139 ```
32− substituters = https://cache.nixos.org https://nixcache.reflex-frp.org
33− trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
40+ binary-caches = https://cache.nixos.org https://nixcache.reflex-frp.org
41+ binary-cache-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
42+ binary-caches-parallel-connections = 40
3443 ```
3544 * 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)
3645 ```
@@ -51,24 +60,24 @@ Obelisk provides an easy way to develop and deploy your [Reflex](https://github.
5160
5261When developing on obelisk itself you may launch `ghcid` for the corresponding project as follows. For example to launch ghcid for `lib/backend` project:
5362
54−```
63+```bash
5564nix-shell -A obeliskEnvs.obelisk-backend --run "cd lib/backend && ghcid -c 'cabal new-repl'"
5665```
5766
5867Or to launch ghcid for `lib/command` project:
5968
60−```
69+```bash
6170nix-shell -A obeliskEnvs.obelisk-command --run "cd lib/command && ghcid -c 'cabal new-repl'"
6271```
6372
6473To re-install `ob` from source do
65−```
74+```bash
6675nix-env -f /path/to/obelisk -iA command
6776```
6877
6978Note that `ob` will defer to the version found in your project's `.obelisk/impl` directory. To update that version specifically:
7079
71−```shell
80+```bash
7281ob thunk unpack ./.obelisk/impl
7382cd ./.obelisk/impl
7483# apply your changes
@@ -76,7 +85,7 @@ cd ./.obelisk/impl
7685
7786If you want to commit your changes, first push them to your fork of obelisk and then
7887
79−```shell
88+```bash
8089cd /your/project/root
8190ob thunk pack .obelisk/impl
8291git add .obelisk/impl
@@ -96,13 +105,13 @@ access to:
96105
97106To create a new Obelisk project, go to an empty directory and run:
98107
99−```
108+```bash
100109ob init
101110```
102111
103112Obelisk 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:
104113
105−```
114+```bash
106115ob run
107116```
108117
@@ -111,12 +120,6 @@ Firefox will not be able to properly run the development website due to [issue 4
111120
112121Every 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.
113122
114−### Hoogle
115−
116−To enter a nix-shell from which you can run the hoogle command-line client or a hoogle server for your project:
117−
118−`nix-shell -A shells.ghc --arg withHoogle true`
119−
120123### Adding packages
121124
122125In order to add package dependencies, declare them under the build-depends field in the appropriate cabal files (backend, common, and frontend each have their own). The corresponding Nix packages will automatically be selected when building.
@@ -150,11 +153,66 @@ project ./. ({ pkgs, ... }: {
150153
151154For further information see [the Haskell section](https://nixos.org/nixpkgs/manual/#users-guide-to-the-haskell-infrastructure) of nixpkgs Contributors Guide.
152155
153−### Running over https
156+### Adding extra local packages
157+
158+If the standard packages (`frontend`, `backend`, and `common`) are not
159+enough, to add more local Haskell packages, define them with the
160+`packages` parameter. The sources of these packages will be
161+automatically reloaded by `ob run`.
162+
163+```nix
164+# ...
165+project ./. ({ pkgs, ... }: {
166+# ...
167+ packages = {
168+ another = ./another;
169+ };
170+# ...
171+```
172+
173+### Running over HTTPS
174+
175+To run your app locally over HTTPS, update the protocol in `config/common/route` to `https`, and then use `ob run` as normal.
176+
177+Since Obelisk generates a self-signed certificate for running HTTPS, 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.
178+
179+### IDE Support
154180
155−To run your app locally over https, update the protocol in `config/common/route` to `https`, and then use `ob run` as normal.
181+#### Terminal-based feedback
156182
157−Since Obelisk generates a self-signed certificate for running https, 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.
183+Obelisk officially supports terminal-based feedback (akin to [`ghcid`](https://github.com/ndmitchell/ghcid)) in `ob run` and `ob watch`.
184+
185+#### **Experimental** `ghcide` support
186+
187+> **NOTE:** `ghcide` support is strictly **experimental** and **not officially supported**. There is no guarantee that it will work for you or that this support will be maintained over time.
188+
189+To try out the **experimental** [`ghcide`](https://github.com/digital-asset/ghcide) support:
190+
191+ * Install a `ghcide` plugin for your editor.
192+ * Add `__withGhcide = true;` to your Obelisk project's `default.nix` (inside the call to `project`). With this setting, `ob shell` will provide `ghcide` as well.
193+ * Add `hie-bios.sh` to the root of your project:
194+ ```shell
195+ cat > hie-bios.sh <<'EOF'
196+ #!/usr/bin/env bash
197+ source "$HOME/.bash_profile"; # NOTE: Some editors need help finding 'ob' and this assumes that `ob` is made available on your `$PATH` in `.bash_profile`
198+ ob internal export-ghci-configuration > "$HIE_BIOS_OUTPUT"
199+ EOF
200+ chmod +x hie-bios.sh
201+ ```
202+ * **Note:** In some projects you need to use `ob internal export-ghci-configuration --use-relative-paths` in this script instead. This is known to happen when your project contains symlinks to other packages.
203+ * Add `hie.yaml` to the root of your project:
204+ ```shell
205+ echo 'cradle: { bios: { program: hie-bios.sh } }' > hie.yaml
206+ ```
207+ * Test the configuration with `ob shell ghcide`. Assuming your project compiles and works with `ghcide` otherwise, this should succeed.
208+ * Start your editor in a way that it can access the appropriate `ghcide`:
209+ * This can sometimes be achieved with `ob shell 'start my editor'`.
210+ * If you can't easily start your editor in a way that it inherits your shell, you may need to customize how your `ghcide` plugin finds `ghcide` or create a custom `ghcide` replacement script that you install globally. For example, for Visual Studio Code on macOS adding a script called `ghcide` to your `PATH` like the one below will cause `ghcide` from each project's `ob shell` to be used:
211+ ```shell
212+ #!/usr/bin/env bash
213+ source "$HOME/.bash_profile" # NOTE: This assumes that `ob` is made available on your `$PATH` in `.bash_profile`
214+ ob shell "ghcide $@"
215+ ```
158216
159217## Deploying
160218
@@ -162,26 +220,26 @@ Since Obelisk generates a self-signed certificate for running https, the browser
162220
163221Build everything:
164222
165−```
223+```bash
166224nix-build -A exe --no-out-link
167225```
168226
169227Copy the result to a new directory, add configuration, and run!
170228
171−```
229+```bash
172230mkdir test-app
173231ln -s $(nix-build -A exe --no-out-link)/* test-app/
174232cp -r config test-app
175233(cd test-app && ./backend)
176234```
177235
178−### EC2
236+### Default EC2 Deployment
179237
180−In this section we will demonstrate how to deploy your Obelisk app to an Amazon EC2 instance.
238+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)).
181239
182240First create a new EC2 instance:
183241
184−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))
242+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))
1852431. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1862441. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
1872451. Go to "Security Groups", select your instance's security group and under "Inbound" tab add a new rule for HTTP port 80 and 443.
@@ -204,7 +262,7 @@ ob deploy init \
204262 ~/code/myapp-deploy
205263```
206264
207−HTTPS is enabled by default; to disable https, pass `--disable-https` to the `ob deploy init` command above.
265+HTTPS is enabled by default; to disable HTTPS pass `--disable-https` to the `ob deploy init` command above.
208266
209267This 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.
210268
@@ -219,6 +277,26 @@ ob deploy push
219277
220278At 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`.
221279
280+### Custom Non-EC2 Deployment
281+
282+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.
283+
284+`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.
285+
286+The [VirtualBox Deployment](#virtualbox-deployment) section provides an example.
287+
288+#### VirtualBox Deployment
289+
290+Here's a `module.nix` that is configured for deployment to a VirtualBox VM (running NixOS):
291+
292+```nix
293+{ nixosPkgs, ... }: {...}: {
294+ imports = [ (nixosPkgs.path + /nixos/modules/virtualisation/virtualbox-image.nix) ];
295+}
296+```
297+
298+The `{...}:` and following is the [NixOS module](https://nixos.org/nixos/manual/index.html#sec-writing-modules) definition.
299+
222300### From macOS
223301
224302Deploying from macOS requires some extra setup:
@@ -232,7 +310,7 @@ Running `ob deploy push` will give you additional setup instructions.
232310
233311If 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:
234312
235−```
313+```bash
236314cd ~/code/myapp-deploy
237315ob deploy update
238316ob deploy push
@@ -258,14 +336,14 @@ These versions will work out of the box but iOS SDKs prior to 11.3 should also w
258336
259337More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
260338To 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.
261−```
339+```bash
262340open -W Xcode_9.2.xip
263341sudo 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
264342```
265343
266344
267345You can verify that you have correct versions by running
268−```
346+```bash
269347xcodebuild -showsdks
270348```
271349
@@ -291,7 +369,7 @@ Ensure that `bundleIdentifier` matches the App ID of the development profile, or
2913691. Connect the registered iPhone.
2923701. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2933711. Run the deploy command with your Team ID:
294−```
372+```bash
295373result-ios/bin/deploy [TEAM_ID]
296374# or in debug mode via lldb:
297375result-ios/bin/deploy [TEAM_ID] -d
@@ -301,7 +379,7 @@ result-ios/bin/deploy [TEAM_ID] -d
3013791. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
302380Create and download a distribution profile.
3033811. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
304−```
382+```bash
305383result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
306384```
307385
all-builds.nixnew file+113
@@ -0,0 +1,113 @@
1+{ self-args ? {
2+ config.android_sdk.accept_license = true;
3+ iosSdkVersion = "10.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.nixnew file+145
@@ -0,0 +1,145 @@
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+185−177
@@ -2,102 +2,30 @@
22, profiling ? false
33, iosSdkVersion ? "10.2"
44, config ? {}
5+, reflex-platform-func ? import ./dep/reflex-platform
56}:
67let
7− cleanSource = builtins.filterSource (name: _: let baseName = builtins.baseNameOf name; in !(
8− builtins.match "^\\.ghc\\.environment.*" baseName != null ||
9− baseName == "cabal.project.local"
10− ));
8+ reflex-platform = getReflexPlatform { inherit system; };
9+ inherit (reflex-platform) hackGet nixpkgs;
10+ pkgs = nixpkgs;
1111
12− commandRuntimeDeps = pkgs: with pkgs; [
13− coreutils
14− git
15− nix-prefetch-git
16− openssh
17− ];
12+ inherit (import dep/gitignore.nix { inherit (nixpkgs) lib; }) gitignoreSource;
1813
19− getReflexPlatform = sys: import ./dep/reflex-platform {
20− inherit iosSdkVersion config;
21− system = sys;
22− enableLibraryProfiling = profiling;
14+ getReflexPlatform = { system, enableLibraryProfiling ? profiling }: reflex-platform-func {
15+ inherit iosSdkVersion config system enableLibraryProfiling;
2316
2417 nixpkgsOverlays = [
25− (self: super: {
26− obeliskExecutableConfig = import ./lib/executable-config { nixpkgs = pkgs; filterGitSource = cleanSource; };
27− })
18+ (import ./nixpkgs-overlays)
2819 ];
2920
3021 haskellOverlays = [
31−
32− # Fix misc upstream packages
33− (self: super: let
34− pkgs = self.callPackage ({ pkgs }: pkgs) {};
35− haskellLib = pkgs.haskell.lib;
36− in {
37− hnix = haskellLib.dontCheck (haskellLib.doJailbreak (self.callCabal2nix "hnix" (hackGet dep/hnix) {}));
38− hnix-store-core = self.callHackage "hnix-store-core" "0.1.0.0" {};
39−
40− ghcid = self.callCabal2nix "ghcid" (hackGet ./dep/ghcid) {};
41− })
42−
22+ (import ./haskell-overlays/misc-deps.nix { inherit hackGet; })
4323 pkgs.obeliskExecutableConfig.haskellOverlay
44−
45− # Add obelisk packages
46− (self: super: let
47− pkgs = self.callPackage ({ pkgs }: pkgs) {};
48− onLinux = pkg: f: if pkgs.stdenv.isLinux then f pkg else pkg;
49− in {
50− shelly = self.callHackage "shelly" "1.9.0" {};
51−
52− obelisk-executable-config-inject = pkgs.obeliskExecutableConfig.platforms.web.inject self;
53−
54− obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (cleanSource ./lib/asset/manifest) {};
55− obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (cleanSource ./lib/asset/serve-snap) {};
56− obelisk-backend = self.callCabal2nix "obelisk-backend" (cleanSource ./lib/backend) {};
57− obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (cleanSource ./lib/cliapp) {};
58− obelisk-command = haskellLib.overrideCabal (self.callCabal2nix "obelisk-command" (cleanSource ./lib/command) {}) {
59− librarySystemDepends = [
60− pkgs.nix
61− (haskellLib.justStaticExecutables self.ghcid)
62− ];
63− };
64− obelisk-frontend = self.callCabal2nix "obelisk-frontend" (cleanSource ./lib/frontend) {};
65− obelisk-run = onLinux (self.callCabal2nix "obelisk-run" (cleanSource ./lib/run) {}) (pkg:
66− haskellLib.overrideCabal pkg (drv: { librarySystemDepends = [ pkgs.iproute ]; })
67− );
68− obelisk-route = self.callCabal2nix "obelisk-route" (cleanSource ./lib/route) {};
69− obelisk-selftest = self.callCabal2nix "obelisk-selftest" (cleanSource ./lib/selftest) {};
70− obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (cleanSource ./lib/snap-extras) {};
71− tabulation = self.callCabal2nix "tabulation" (cleanSource ./lib/tabulation) {};
72− })
73−
74− (self: super: let
75− pkgs = self.callPackage ({ pkgs }: pkgs) {};
76− haskellLib = pkgs.haskell.lib;
77− in {
78− # Dynamic linking with split objects dramatically increases startup time (about
79− # 0.5 seconds on a decent machine with SSD), so we do `justStaticExecutables`.
80− obelisk-command = haskellLib.overrideCabal
81− (haskellLib.generateOptparseApplicativeCompletion "ob"
82− (haskellLib.justStaticExecutables super.obelisk-command))
83− (drv: {
84− buildTools = (drv.buildTools or []) ++ [ pkgs.buildPackages.makeWrapper ];
85− postFixup = ''
86− ${drv.postFixup or ""}
87− # Make `ob` reference its runtime dependencies.
88− wrapProgram "$out"/bin/ob --prefix PATH : ${pkgs.lib.makeBinPath (commandRuntimeDeps pkgs)}
89− '';
90− });
91− obelisk-selftest = haskellLib.justStaticExecutables super.obelisk-selftest;
92− })
93−
24+ (import ./haskell-overlays/obelisk.nix)
25+ (import ./haskell-overlays/tighten-ob-exes.nix)
9426 ];
9527 };
9628
97− reflex-platform = getReflexPlatform system;
98− inherit (reflex-platform) hackGet nixpkgs;
99− pkgs = nixpkgs;
100−
10129 # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
10230 ghcObelisk = reflex-platform.ghc;
10331
@@ -117,15 +45,14 @@ in rec {
11745 obelisk = ghcObelisk;
11846 obeliskEnvs = pkgs.lib.filterAttrs (k: _: pkgs.lib.strings.hasPrefix "obelisk-" k) ghcObeliskEnvs;
11947 command = ghcObelisk.obelisk-command;
120− shell = pinBuildInputs "obelisk-shell" ([command] ++ commandRuntimeDeps pkgs);
48+ shell = pinBuildInputs "obelisk-shell" ([command] ++ command.commandRuntimeDeps);
12149
12250 selftest = pkgs.writeScript "selftest" ''
123− #!/usr/bin/env bash
51+ #!${pkgs.runtimeShell}
12452 set -euo pipefail
12553
12654 PATH="${command}/bin:$PATH"
127− export OBELISK_IMPL="$(mktemp -d)"
128− git clone file://${pathGit} $OBELISK_IMPL
55+ cd ${./.}
12956 "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
13057 '';
13158 skeleton = pkgs.runCommand "skeleton" {
@@ -149,6 +76,7 @@ in rec {
14976 compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
15077 mkdir $out
15178 cd $out
79+ # TODO profiling + static shouldn't break and need an ad-hoc workaround like that
15280 ln -s "${haskellLib.justStaticExecutables frontend}/bin/frontend.jsexe/all.js" all.unminified.js
15381 ${if optimizationLevel == null then ''
15482 ln -s all.unminified.js all.js
@@ -159,18 +87,28 @@ in rec {
15987 '';
16088
16189 serverModules = {
162− mkBaseEc2 = { hostName, routeHost, enableHttps, adminEmail, ... }: {...}: {
90+ mkBaseEc2 = { nixosPkgs, ... }: {...}: {
16391 imports = [
164− (pkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
92+ (nixosPkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
16593 ];
94+ ec2.hvm = true;
95+ };
96+
97+ mkDefaultNetworking = { adminEmail, enableHttps, hostName, routeHost, ... }: {...}: {
16698 networking = {
16799 inherit hostName;
168100 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
169101 };
102+
103+ # `amazon-image.nix` already sets these but if the user provides their own module then
104+ # forgetting these can cause them to lose access to the server!
105+ # https://github.com/NixOS/nixpkgs/blob/fab05f17d15e4e125def4fd4e708d205b41d8d74/nixos/modules/virtualisation/amazon-image.nix#L133-L136
106+ services.openssh.enable = true;
107+ services.openssh.permitRootLogin = "prohibit-password";
108+
170109 security.acme.certs = if enableHttps then {
171110 "${routeHost}".email = adminEmail;
172111 } else {};
173− ec2.hvm = true;
174112 };
175113
176114 mkObeliskApp =
@@ -227,123 +165,193 @@ in rec {
227165 };
228166 };
229167
168+ inherit mkAssets;
169+
230170 serverExe = backend: frontend: assets: optimizationLevel: version:
231171 pkgs.runCommand "serverExe" {} ''
232172 mkdir $out
233173 set -eux
234− ln -s "${haskellLib.justStaticExecutables backend}"/bin/* $out/
174+ ln -s "${if profiling then backend else haskellLib.justStaticExecutables backend}"/bin/* $out/
235175 ln -s "${mkAssets assets}" $out/static.assets
236176 ln -s ${mkAssets (compressedJs frontend optimizationLevel)} $out/frontend.jsexe.assets
237177 echo ${version} > $out/version
238178 '';
239179
240− server = { exe, hostName, adminEmail, routeHost, enableHttps, version }@args:
180+ server = { exe, hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }@args:
241181 let
242182 nixos = import (pkgs.path + /nixos);
243183 in nixos {
244184 system = "x86_64-linux";
245185 configuration = {
246186 imports = [
247− (serverModules.mkBaseEc2 args)
187+ (module { inherit exe hostName adminEmail routeHost enableHttps version; nixosPkgs = pkgs; })
188+ (serverModules.mkDefaultNetworking args)
248189 (serverModules.mkObeliskApp args)
249190 ];
250191 };
251192 };
252193
253−
254194 # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
255− project = base: projectDefinition:
256− let projectOut = sys: (getReflexPlatform sys).project (args@{ nixpkgs, ... }:
257− let mkProject = { android ? null #TODO: Better error when missing
258− , ios ? null #TODO: Better error when missing
259− , packages ? {}
260− , overrides ? _: _: {}
261− , staticFiles ? base + /static
262− , tools ? _: []
263− , shellToolOverrides ? _: _: {}
264− , withHoogle ? false # Setting this to `true` makes shell reloading far slower
265− , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
266− }:
267− let frontendName = "frontend";
268− backendName = "backend";
269− commonName = "common";
270− staticName = "obelisk-generated-static";
271− staticFilesImpure = if lib.isDerivation staticFiles then staticFiles else toString staticFiles;
272− processedStatic = processAssets { src = staticFiles; };
273− # The packages whose names and roles are defined by this package
274− predefinedPackages = lib.filterAttrs (_: x: x != null) {
275− ${frontendName} = nullIfAbsent (base + "/frontend");
276− ${commonName} = nullIfAbsent (base + "/common");
277− ${backendName} = nullIfAbsent (base + "/backend");
278− };
279− combinedPackages = predefinedPackages // packages;
280− projectOverrides = self: super: {
281− ${staticName} = haskellLib.dontHaddock (self.callCabal2nix staticName processedStatic.haskellManifest {});
282− ${backendName} = haskellLib.addBuildDepend super.${backendName} self.obelisk-run;
283− };
284− totalOverrides = lib.composeExtensions projectOverrides overrides;
285− inherit (lib.strings) hasPrefix;
286− privateConfigDirs = ["config/backend"];
287− injectableConfig = builtins.filterSource (path: _:
288− !(lib.lists.any (x: hasPrefix (toString base + "/" + toString x) (toString path)) privateConfigDirs)
195+ project = base': projectDefinition:
196+ let
197+ projectOut = { system, enableLibraryProfiling ? profiling }: let reflexPlatformProject = (getReflexPlatform { inherit system enableLibraryProfiling; }).project; in reflexPlatformProject (args@{ nixpkgs, ... }:
198+ let
199+ inherit (lib.strings) hasPrefix;
200+ mkProject =
201+ { android ? null #TODO: Better error when missing
202+ , ios ? null #TODO: Better error when missing
203+ , packages ? {}
204+ , overrides ? _: _: {}
205+ , staticFiles ? null
206+ , tools ? _: []
207+ , shellToolOverrides ? _: _: {}
208+ , withHoogle ? false # Setting this to `true` makes shell reloading far slower
209+ , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
210+ , __withGhcide ? false
211+ }:
212+ let
213+ allConfig = nixpkgs.lib.makeExtensible (self: {
214+ base = base';
215+ inherit args;
216+ userSettings = {
217+ inherit android ios packages overrides tools shellToolOverrides withHoogle __closureCompilerOptimizationLevel __withGhcide;
218+ staticFiles = if staticFiles == null then self.base + /static else staticFiles;
219+ };
220+ frontendName = "frontend";
221+ backendName = "backend";
222+ commonName = "common";
223+ staticName = "obelisk-generated-static";
224+ staticFilesImpure = let fs = self.userSettings.staticFiles; in if lib.isDerivation fs then fs else toString fs;
225+ processedStatic = processAssets { src = self.userSettings.staticFiles; };
226+ # The packages whose names and roles are defined by this package
227+ predefinedPackages = lib.filterAttrs (_: x: x != null) {
228+ ${self.frontendName} = nullIfAbsent (self.base + "/frontend");
229+ ${self.commonName} = nullIfAbsent (self.base + "/common");
230+ ${self.backendName} = nullIfAbsent (self.base + "/backend");
231+ };
232+ shellPackages = {};
233+ combinedPackages = self.predefinedPackages // self.userSettings.packages // self.shellPackages;
234+ projectOverrides = self': super': {
235+ ${self.staticName} = haskellLib.dontHaddock (self'.callCabal2nix self.staticName self.processedStatic.haskellManifest {});
236+ ${self.backendName} = haskellLib.addBuildDepend super'.${self.backendName} self'.obelisk-run;
237+ };
238+ totalOverrides = lib.composeExtensions self.projectOverrides self.userSettings.overrides;
239+ privateConfigDirs = ["config/backend"];
240+ injectableConfig = builtins.filterSource (path: _:
241+ !(lib.lists.any (x: hasPrefix (toString self.base + "/" + toString x) (toString path)) self.privateConfigDirs)
242+ );
243+ __androidWithConfig = configPath: {
244+ ${if self.userSettings.android == null then null else self.frontendName} = {
245+ executableName = "frontend";
246+ ${if builtins.pathExists self.userSettings.staticFiles then "assets" else null} =
247+ nixpkgs.obeliskExecutableConfig.platforms.android.inject
248+ (self.injectableConfig configPath)
249+ self.processedStatic.symlinked;
250+ } // self.userSettings.android;
251+ };
252+ __iosWithConfig = configPath: {
253+ ${if self.userSettings.ios == null then null else self.frontendName} = {
254+ executableName = "frontend";
255+ ${if builtins.pathExists self.userSettings.staticFiles then "staticSrc" else null} =
256+ nixpkgs.obeliskExecutableConfig.platforms.ios.inject
257+ (self.injectableConfig configPath)
258+ self.processedStatic.symlinked;
259+ } // self.userSettings.ios;
260+ };
261+
262+ shells-ghc = builtins.attrNames (self.predefinedPackages // self.shellPackages);
263+
264+ shells-ghcjs = [
265+ self.frontendName
266+ self.commonName
267+ ];
268+
269+ shells-ghcSavedSplices = [
270+ self.commonName
271+ self.frontendName
272+ ];
273+
274+ shellToolOverrides = lib.composeExtensions
275+ self.userSettings.shellToolOverrides
276+ (if self.userSettings.__withGhcide
277+ then (import ./haskell-overlays/ghcide.nix)
278+ else (_: _: {})
289279 );
290− __androidWithConfig = configPath: {
291− ${if android == null then null else frontendName} = {
292− executableName = "frontend";
293− ${if builtins.pathExists staticFiles then "assets" else null} =
294− nixpkgs.obeliskExecutableConfig.platforms.android.inject
295− (injectableConfig configPath)
296− processedStatic.symlinked;
297− } // android;
280+
281+ project = reflexPlatformProject ({...}: self.projectConfig);
282+ projectConfig = {
283+ inherit (self) shellToolOverrides;
284+ inherit (self.userSettings) tools withHoogle;
285+ overrides = self.totalOverrides;
286+ packages = self.combinedPackages;
287+ shells = {
288+ ${if self.userSettings.android == null && self.userSettings.ios == null then null else "ghcSavedSplices"} =
289+ lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghcSavedSplices;
290+ ghc = lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghc;
291+ ghcjs = lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghcjs;
298292 };
299− __iosWithConfig = configPath: {
300− ${if ios == null then null else frontendName} = {
301− executableName = "frontend";
302− ${if builtins.pathExists staticFiles then "staticSrc" else null} =
303− nixpkgs.obeliskExecutableConfig.platforms.ios.inject
304− (injectableConfig configPath)
305− processedStatic.symlinked;
306− } // ios;
293+ android = self.__androidWithConfig (self.base + "/config");
294+ ios = self.__iosWithConfig (self.base + "/config");
295+
296+ passthru = {
297+ __unstable__.self = allConfig;
298+ inherit (self)
299+ staticFilesImpure processedStatic
300+ __iosWithConfig __androidWithConfig
301+ ;
302+ inherit (self.userSettings)
303+ android ios overrides packages shellToolOverrides staticFiles tools withHoogle
304+ __closureCompilerOptimizationLevel
305+ ;
307306 };
308− in {
309− inherit shellToolOverrides tools withHoogle;
310− overrides = totalOverrides;
311− packages = combinedPackages;
312− shells = {
313− ${if android == null && ios == null then null else "ghcSavedSplices"} = (lib.filter (x: lib.hasAttr x combinedPackages) [
314− commonName
315− frontendName
316− ]);
317− ghc = (lib.filter (x: lib.hasAttr x combinedPackages) [
318− backendName
319− commonName
320− frontendName
321− ]);
322− ghcjs = lib.filter (x: lib.hasAttr x combinedPackages) [
323− frontendName
324− commonName
325− ];
326307 };
327− android = __androidWithConfig (base + "/config");
328− ios = __iosWithConfig (base + "/config");
329− passthru = { inherit android ios packages overrides tools shellToolOverrides withHoogle staticFiles staticFilesImpure __closureCompilerOptimizationLevel processedStatic __iosWithConfig __androidWithConfig; };
330− };
331− in mkProject (projectDefinition args));
332− serverOn = sys: version: serverExe
333− (projectOut sys).ghc.backend
334− (projectOut system).ghcjs.frontend
335− (projectOut sys).passthru.staticFiles
336− (projectOut sys).passthru.__closureCompilerOptimizationLevel
308+ });
309+ in allConfig;
310+ in (mkProject (projectDefinition args)).projectConfig);
311+ mainProjectOut = projectOut { inherit system; };
312+ serverOn = projectInst: version: serverExe
313+ projectInst.ghc.backend
314+ mainProjectOut.ghcjs.frontend
315+ projectInst.passthru.staticFiles
316+ projectInst.passthru.__closureCompilerOptimizationLevel
337317 version;
338− linuxExe = serverOn "x86_64-linux";
318+ linuxExe = serverOn (projectOut { system = "x86_64-linux"; });
339319 dummyVersion = "Version number is only available for deployments";
340− in projectOut system // {
320+ in mainProjectOut // {
321+ __unstable__.profiledObRun = let
322+ profiled = projectOut { inherit system; enableLibraryProfiling = true; };
323+ exeSource = builtins.toFile "ob-run.hs" ''
324+ module Main where
325+
326+ import Control.Exception
327+ import Reflex.Profiled
328+ import System.Environment
329+
330+ import qualified Obelisk.Run
331+ import qualified Frontend
332+ import qualified Backend
333+
334+ main :: IO ()
335+ main = do
336+ args <- getArgs
337+ let port = read $ args !! 0
338+ assets = args !! 1
339+ profileFile = (args !! 2) <> ".rprof"
340+ Obelisk.Run.run port (Obelisk.Run.runServeAsset assets) Backend.backend Frontend.frontend `finally` writeProfilingData profileFile
341+ '';
342+ in nixpkgs.runCommand "ob-run" {
343+ buildInputs = [ (profiled.ghc.ghcWithPackages (p: [ p.backend p.frontend])) ];
344+ } ''
345+ mkdir -p $out/bin/
346+ ghc -x hs -prof -fno-prof-auto -threaded ${exeSource} -o $out/bin/ob-run
347+ '';
348+
341349 linuxExeConfigurable = linuxExe;
342350 linuxExe = linuxExe dummyVersion;
343− exe = serverOn system dummyVersion;
344− server = args@{ hostName, adminEmail, routeHost, enableHttps, version }:
351+ exe = serverOn mainProjectOut dummyVersion;
352+ server = args@{ hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }:
345353 server (args // { exe = linuxExe version; });
346− obelisk = import (base + "/.obelisk/impl") {};
354+ obelisk = import (base' + "/.obelisk/impl") {};
347355 };
348356 haskellPackageSets = {
349357 inherit (reflex-platform) ghc ghcjs;
dep/.gitignoredeleted−5
@@ -1,5 +0,0 @@
1−*
2−!*/
3−!.gitignore
4−!*/*.json
5−!*/default.nix
dep/gitignore.nix/default.nixnew file+8
@@ -0,0 +1,8 @@
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.jsonnew file+8
@@ -0,0 +1,8 @@
1+{
2+ "owner": "hercules-ci",
3+ "repo": "gitignore.nix",
4+ "branch": "master",
5+ "private": false,
6+ "rev": "7415c4feb127845553943a3856cbc5cb967ee5e0",
7+ "sha256": "1zd1ylgkndbb5szji32ivfhwh04mr1sbgrnvbrqpmfb67g2g3r9i"
8+}
dep/reflex-platform/default.nix+7−6
@@ -1,7 +1,8 @@
11# 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−))
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/reflex-platform/github.json+4−3
@@ -1,7 +1,8 @@
11{
22 "owner": "reflex-frp",
33 "repo": "reflex-platform",
4− "branch": "master",
5− "rev": "72ca177da290dc5311c08683b8d167a205c9322e",
6− "sha256": "06pqml1iqc5fawwsqb7wq77gh5v07bgb92hz8r1hf0ysr0abafcg"
4+ "branch": "release/0.5.3.0",
5+ "private": false,
6+ "rev": "9779ea3b4c87fdc971057c561262696d5e9b1847",
7+ "sha256": "0v87ilal9355xwz8y9m0zh14pm9c0f7pqch0854kkj92ybc5l62q"
78}
dep/snap-core/default.nixnew file+8
@@ -0,0 +1,8 @@
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.jsonnew file+8
@@ -0,0 +1,8 @@
1+{
2+ "owner": "obsidiansystems",
3+ "repo": "snap-core",
4+ "branch": "ts-expose-fileserve-internals",
5+ "private": false,
6+ "rev": "e015fc484e38dd9389c58b277b1884395e553bdf",
7+ "sha256": "1793x1h4lw9vnrii5akhfxx1x9yrgxf3052jf6bs8f1mhaic6mxx"
8+}
guides/app-deploy/README.mdnew file+318
@@ -0,0 +1,318 @@
1+# Obelisk Application Deployment Guide
2+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.
3+
4+> **Note:** To complete this *entire* guide you need access to a macOS machine running the latest OSX release, a Linux machine (can be a VM on that mac) with Nix installed, an iPhone or iPad, and a recent Android device. It also assumes that you have Nix correctly set up and that your system is set up 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.
5+>
6+> 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.
7+
8+## a) Get Obelisk
9+
10+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 it's GitHub repository and start a project that uses that local check out.
11+
12+Open a terminal and run the following:
13+
14+```bash
15+export WORKDIR=~/obelisk-guide
16+mkdir -p "$WORKDIR"
17+```
18+
19+Then let's get Obelisk from GitHub using a specific branch:
20+
21+```bash
22+export OBELISK_BRANCH=develop
23+git clone https://github.com/obsidiansystems/obelisk.git -b "$OBELISK_BRANCH" "$WORKDIR/obelisk"
24+```
25+
26+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.
27+
28+```bash
29+alias ob=$(nix-build "$WORKDIR/obelisk" -A command --no-out-link)/bin/ob
30+```
31+
32+In order to start an Obelisk project, we need initialize it in a new directory. Let's call it `myapp`:
33+
34+```bash
35+mkdir -p "$WORKDIR/myapp"
36+cd "$WORKDIR/myapp"
37+ob init --branch "$OBELISK_BRANCH"
38+```
39+
40+> **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.
41+
42+## b) Run the Obelisk app on localhost
43+
44+Let's test that we can run a server on localhost. This is quite easy:
45+
46+```bash
47+cd "$WORKDIR/myapp"
48+ob run
49+```
50+
51+Now open a browser and point it to http://localhost:8000 (or just click on this link). You should see the following:
52+
53+![](assets/app-deploy.png)
54+
55+## c) Deploy the web app on a remote machine
56+
57+### Import the NixOS VirtualBox appliance
58+Install [VirtualBox](https://www.virtualbox.org/) on your machine.
59+
60+On NixOS, do this by adding the following line to your `/etc/nixos/configuration.nix` before the last line containing `}`:
61+
62+```nix
63+ virtualisation.virtualbox.host.enable = true;
64+```
65+
66+then `sudo nixos-rebuild switch`.
67+
68+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.
69+
70+With the downloaded file, open VirtualBox and import the `.ova` file:
71+
72+![](assets/virtualbox-appliance-import.png)
73+
74+Leave the default settings and finish the import. That will take a few minutes:
75+
76+![](assets/virtualbox-appliance-import-loading.png)
77+
78+You should now see a NixOS machine in the dashboard:
79+
80+![](assets/virtualbox-dashboard-nixos.png)
81+
82+If you are on a network with DHCP on your wireless or network card then select right-click on the "NixOS" image and click "Settings". Go to the "Network" section and make "Attached to:" set to "Bridged Adapter".
83+
84+![](assets/virtualbox-image-settings-network.png)
85+
86+Finally, double-click on the "NixOS" machine and wait for it boot up. If it asks for a password, use `demo`.
87+
88+![](assets/virtualbox-nioxs-after-boot.png)
89+
90+### Configure the virtual machine for SSH
91+
92+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.
93+
94+Change the system configuration using `sudo` to enable SSH access:
95+
96+```bash
97+sudo nano /etc/nixos/configuration.nix
98+```
99+
100+This will ask you to enter your password. Enter `demo`.
101+
102+![](assets/nano-edit-nixos-configuration.png)
103+
104+You need to add the following snippet right before the final line containing `}`.
105+
106+```nix
107+ services.openssh.enable = true;
108+ services.openssh.permitRootLogin = "yes";
109+```
110+
111+Save and close the editor by typing <kbd>Ctrl</kbd>+<kbd>O</kbd>, <kbd>Enter</kbd>, and then <kbd>Ctrl</kbd>+<kbd>X</kbd>.
112+
113+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.
114+
115+To get the virtual machine's IP address go back to the terminal on your *host* machine (not the virtual machine) and run:
116+
117+```bash
118+export VM_ID=$(VBoxManage list runningvms | grep "NixOS" | awk -F'[{}]' '{print $2}')
119+echo "$VM_ID"
120+```
121+
122+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.)
123+
124+Now get the IP address for that machine:
125+
126+```bash
127+export VM_IP=$(VBoxManage guestproperty enumerate "$VM_ID" | grep /V4/IP | awk '{print $4}' | sed 's/,//')
128+echo "$VM_IP"
129+```
130+
131+You should see an IP like `192.168.7.86`.
132+
133+With that you will be able to SSH into that machine from a terminal, using the username `root`.
134+
135+```bash
136+ssh root@$VM_IP echo "Access granted"
137+```
138+
139+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>.
140+
141+> **Note:** If instead you see an error like this
142+>
143+> ```
144+> @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
145+> @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
146+> @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
147+> IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
148+> Someone could be eavesdropping on you right now (man-in-the-middle attack)!
149+> It is also possible that a host key has just been changed.
150+> ```
151+>
152+> you need to remove the old fingerprint for this IP. Run the following:
153+>
154+> ```bash
155+> sed -i "/^$VM_IP /d" ~/.ssh/known_hosts
156+> ```
157+>
158+> and then try the previous `ssh` command again.
159+
160+Now we'll allow access with an SSH key instead of a password. Create a new SSH key with `ssh-keygen`:
161+
162+```bash
163+ssh-keygen -t ed25519 -f "$WORKDIR/obkey" -P ""
164+```
165+
166+Now copy your local SSH key to the server:
167+
168+```bash
169+ssh-copy-id -i "$WORKDIR/obkey.pub" root@$VM_IP
170+```
171+
172+This will ask you for your password again.
173+
174+Now test login with your key instead:
175+
176+```bash
177+ssh -i "$WORKDIR/obkey" root@$VM_IP echo "Access granted"
178+```
179+
180+This should print `Access granted` *without* asking for a password.
181+
182+### Configure the git remote
183+
184+Before the project can be deployed, it needs to be a valid `git` repository.
185+
186+> **Note:** You need `git` installed and configured. You can do that with:
187+>
188+> ```bash
189+> nix-env -i git
190+> git config --global user.name "John Doe"
191+> git config --global user.email johndoe@example.com
192+> ```
193+
194+```bash
195+git init --bare "$WORKDIR/myapp-git-remote"
196+cd "$WORKDIR/myapp"
197+git init
198+git add --all
199+git commit -m "initial commit"
200+git remote add origin "$WORKDIR/myapp-git-remote"
201+git push -u origin master
202+```
203+
204+### Deploy
205+
206+With that, we can come back to the Obelisk app and initialize the deployment:
207+
208+```bash
209+cd "$WORKDIR/myapp"
210+ob deploy init --ssh-key "$WORKDIR/obkey" --admin-email a@a.a --hostname $VM_IP --route https://$VM_IP "$WORKDIR/myappdeploy" --disable-https
211+```
212+
213+Then configure the deployment for VirtualBox:
214+
215+```bash
216+echo '{nixosPkgs, ...}: {...}: { imports = [ (nixosPkgs.path + /nixos/modules/virtualisation/virtualbox-image.nix) ]; }' > "$WORKDIR/myappdeploy/module.nix"
217+```
218+
219+And deploy:
220+
221+```bash
222+cd "$WORKDIR/myappdeploy"
223+ob deploy push -v
224+```
225+
226+Once that is complete, open the webpage with
227+
228+```bash
229+xdg-open http://$VM_IP
230+```
231+
232+If that fails, just get the URL by running
233+
234+```bash
235+echo http://$VM_IP
236+```
237+
238+and copy/paste that URL into your browser navigation input.
239+
240+It should look like this:
241+
242+![](assets/app-deploy-2.png)
243+
244+Congratulations! You have deployed an Obelisk application to a remote server via SSH.
245+
246+## d) Deploy an Android app (Linux host only)
247+
248+> **Note:** This section requires that you be running a Linux *host*.
249+
250+Modify `$WORKDIR/myapp/default.nix` to set `config.android_sdk.accept_license = true;` and then update your app.
251+
252+```bash
253+cd "$WORKDIR/myapp"
254+sed -i 's/# config.android_sdk.accept_license = false;/config.android_sdk.accept_license = true;/g' default.nix
255+git add default.nix
256+git commit -m"Accept license"
257+git push
258+```
259+
260+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.
261+
262+Now update your deployment and deploy to Android:
263+
264+```bash
265+cd "$WORKDIR/myappdeploy"
266+ob deploy update
267+ob deploy test android -v
268+```
269+
270+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:
271+
272+```
273+Is CN=a, OU=b, O=c, L=d, ST=e, C=f correct?
274+ [no]:
275+```
276+
277+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.
278+
279+When connecting your Android device you may be asked to "Allow USB debugging". You need to allow it.
280+![](assets/android-confirm-usb-debugging.jpg)
281+
282+
283+When the deployment is complete opening the app should look something like
284+
285+![](assets/android-app.jpg)
286+
287+Congratulations! You have deployed an Obelisk Android app via USB.
288+
289+## e) Deploy an iOS app (macOS host only)
290+
291+> **Note:** This section requires that you be running a macOS *host*.
292+
293+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.
294+
295+![](assets/xcode-devices.png)
296+
297+Find your `Team ID` at the following URL (Apple Developer Membership details): https://developer.apple.com/account/#/membership/
298+
299+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:
300+
301+```bash
302+cd "$WORKDIR/myappdeploy"
303+ob deploy test ios <TEAM-ID> # Use your Team ID here
304+```
305+
306+![](assets/ios-deploy-keychain.png)
307+
308+![](assets/ios-deploy-example.png)
309+
310+If there are no errors and the last line says `100% Installed Package` you can open the device and look for the Obelisk app:
311+
312+![](assets/ios-obelisk-app-icon.jpg)
313+
314+![](assets/ios-obelisk-app-open.jpg)
315+
316+Congratulations, you have deployed an Obelisk app on an iOS device.
317+
318+You are now ready to create your own multi-platform application using Obelisk!
guides/app-deploy/assets/android-app.jpgnew file

Binary file not shown.

guides/app-deploy/assets/android-confirm-usb-debugging.jpgnew file

Binary file not shown.

guides/app-deploy/assets/app-deploy-2.pngnew file

Binary file not shown.

guides/app-deploy/assets/app-deploy.pngnew file

Binary file not shown.

guides/app-deploy/assets/ios-deploy-example.pngnew file

Binary file not shown.

guides/app-deploy/assets/ios-deploy-keychain.pngnew file

Binary file not shown.

guides/app-deploy/assets/ios-obelisk-app-icon.jpgnew file

Binary file not shown.

guides/app-deploy/assets/ios-obelisk-app-open.jpgnew file

Binary file not shown.

guides/app-deploy/assets/nano-edit-nixos-configuration.pngnew file

Binary file not shown.

guides/app-deploy/assets/virtualbox-appliance-import-loading.pngnew file

Binary file not shown.

guides/app-deploy/assets/virtualbox-appliance-import.pngnew file

Binary file not shown.

guides/app-deploy/assets/virtualbox-dashboard-nixos.pngnew file

Binary file not shown.

guides/app-deploy/assets/virtualbox-image-settings-network.pngnew file

Binary file not shown.

guides/app-deploy/assets/virtualbox-nioxs-after-boot.pngnew file

Binary file not shown.

guides/app-deploy/assets/xcode-devices.pngnew file

Binary file not shown.

haskell-overlays/ghcide.nixnew file+34
@@ -0,0 +1,34 @@
1+self: super:
2+ let
3+ pkgs = self.callPackage ({ pkgs }: pkgs) {};
4+ inherit (pkgs.haskell.lib) dontCheck;
5+ in {
6+ ghcide = pkgs.haskell.lib.justStaticExecutables (dontCheck ((self.override {
7+ overrides = self: super: {
8+ ghc-check = self.callHackageDirect {
9+ pkg = "ghc-check";
10+ ver = "0.1.0.3";
11+ sha256 = "038llbvryk5y27jbdpbshp0zw5lw1j6m7qk7vx1n96ykqdzkh649";
12+ } {};
13+ lsp-test = dontCheck (self.callHackage "lsp-test" "0.6.1.0" {});
14+ haddock-library = dontCheck (self.callHackage "haddock-library" "1.8.0" {});
15+ haskell-lsp = dontCheck (self.callHackage "haskell-lsp" "0.19.0.0" {});
16+ haskell-lsp-types = dontCheck (self.callHackage "haskell-lsp-types" "0.19.0.0" {});
17+ regex-posix = dontCheck (self.callHackage "regex-posix" "0.96.0.0" {});
18+ test-framework = dontCheck (self.callHackage "test-framework" "0.8.2.0" {});
19+ regex-base = dontCheck (self.callHackage "regex-base" "0.94.0.0" {});
20+ regex-tdfa = dontCheck (self.callHackage "regex-tdfa" "1.3.1.0" {});
21+ shake = dontCheck (self.callHackage "shake" "0.18.4" {});
22+ hie-bios = dontCheck (self.callHackageDirect {
23+ pkg = "hie-bios";
24+ ver = "0.4.0";
25+ sha256 = "19lpg9ymd9656cy17vna8wr1hvzfal94gpm2d3xpnw1d5qr37z7x";
26+ } {});
27+ };
28+ }).callCabal2nix "ghcide" (pkgs.fetchFromGitHub {
29+ owner = "digital-asset";
30+ repo = "ghcide";
31+ rev = "v0.1.0";
32+ sha256 = "1kf71iix46hvyxviimrcv7kvsj67hcnnqlpdsmazmlmybf7wbqbb";
33+ }) {}));
34+}
haskell-overlays/misc-deps.nixnew file+20
@@ -0,0 +1,20 @@
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+ hnix = haskellLib.dontCheck (haskellLib.doJailbreak (self.callCabal2nix "hnix" (hackGet ../dep/hnix) {}));
13+ hnix-store-core = self.callHackage "hnix-store-core" "0.1.0.0" {};
14+
15+ ghcid = self.callCabal2nix "ghcid" (hackGet ../dep/ghcid) {};
16+ # Exports more internals
17+ snap-core = haskellLib.dontCheck (self.callCabal2nix "snap-core" (hackGet ../dep/snap-core) {});
18+
19+ shelly = self.callHackage "shelly" "1.9.0" {};
20+}
haskell-overlays/obelisk.nixnew file+43
@@ -0,0 +1,43 @@
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.nix
23+ (haskellLib.justStaticExecutables self.ghcid)
24+ ];
25+ };
26+ obelisk-frontend = self.callCabal2nix "obelisk-frontend" (obeliskCleanSource ../lib/frontend) {};
27+ obelisk-run = onLinux (self.callCabal2nix "obelisk-run" (obeliskCleanSource ../lib/run) {}) (pkg:
28+ haskellLib.overrideCabal pkg (drv: { librarySystemDepends = [ pkgs.iproute ]; })
29+ );
30+ obelisk-route = self.callCabal2nix "obelisk-route" (obeliskCleanSource ../lib/route) {};
31+ obelisk-selftest = haskellLib.overrideCabal (self.callCabal2nix "obelisk-selftest" (obeliskCleanSource ../lib/selftest) {}) {
32+ librarySystemDepends = [
33+ pkgs.cabal-install
34+ pkgs.coreutils
35+ pkgs.git
36+ pkgs.nix
37+ pkgs.nix-prefetch-git
38+ pkgs.rsync
39+ ];
40+ };
41+ obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (obeliskCleanSource ../lib/snap-extras) {};
42+ tabulation = self.callCabal2nix "tabulation" (obeliskCleanSource ../lib/tabulation) {};
43+}
haskell-overlays/tighten-ob-exes.nixnew file+32
@@ -0,0 +1,32 @@
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.nixdeleted−71
@@ -1,71 +0,0 @@
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/serve-snap/src/Obelisk/Asset/Accept.hs+6−6
@@ -136,16 +136,16 @@ qvalue = do
136136 skipMany lws
137137 q0 <|> q1
138138 where q0 = do
139− char '0'
139+ _ <- char '0'
140140 decimals <- option [] $ do
141− char '.'
141+ _ <- char '.'
142142 starRule (Just 0) (Just numAllowedDigits) digit
143143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
144144 q1 = do
145− char '1'
145+ _ <- char '1'
146146 option () $ do
147− char '.'
148− starRule (Just 0) (Just numAllowedDigits) $ char '0'
147+ _ <- char '.'
148+ _ <- starRule (Just 0) (Just numAllowedDigits) $ char '0'
149149 return ()
150150 return $ QValue 1
151151 numAllowedDigits :: Int
@@ -232,7 +232,7 @@ hashRule minNum maxNum element = do
232232lws :: Parser ()
233233lws = do
234234 option () $ cr >> lf
235− starRule (Just 1) Nothing $ sp <|> ht
235+ _ <- starRule (Just 1) Nothing $ sp <|> ht
236236 return ()
237237
238238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+14−4
@@ -12,12 +12,13 @@ import Obelisk.Asset.Accept (Encoding (..), acceptEncodingBody, chooseEncoding,
1212import Obelisk.Snap.Extras
1313
1414import Snap
15− (MonadSnap, getHeader, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
15+ (MonadSnap, getHeader, getRequest, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
1616import Snap.Util.FileServe (defaultMimeTypes, fileType, getSafePath, serveFile)
17+import Snap.Internal.Util.FileServe (checkRangeReq)
1718
1819import Control.Applicative ((<|>))
1920import Control.Exception (handleJust, try, throwIO)
20−import Control.Monad (forM, liftM)
21+import Control.Monad (forM, liftM, unless)
2122import Control.Monad.IO.Class (liftIO)
2223import Control.Monad.Fail (MonadFail)
2324import Data.Attoparsec.ByteString (parseOnly, endOfInput)
@@ -94,8 +95,17 @@ serveAsset' doRedirect base fallback p = do
9495 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
9596 stat <- liftIO $ getFileStatus finalFilename
9697 modifyResponse $ setHeader "Last-Modified" "Thu, 1 Jan 1970 00:00:00 GMT"
97− modifyResponse $ setResponseCode 200 . setContentLength (fromIntegral $ fileSize stat) . setContentType (fileType defaultMimeTypes p)
98− sendFile finalFilename
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
108+ sendFile finalFilename
99109 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
100110 Right "redirect" -> do
101111 mtarget <- liftIO $ getAssetTarget $ base </> p
lib/backend/src/Obelisk/Backend.hs+119−35
@@ -1,3 +1,5 @@
1+{-# LANGUAGE DeriveFunctor #-}
2+{-# LANGUAGE DeriveGeneric #-}
13{-# LANGUAGE FlexibleContexts #-}
24{-# LANGUAGE FlexibleInstances #-}
35{-# LANGUAGE GADTs #-}
@@ -9,25 +11,37 @@
911{-# OPTIONS_GHC -fno-warn-orphans #-}
1012module Obelisk.Backend
1113 ( 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
1230 -- * Re-exports
1331 , Default (def)
1432 , getPageName
1533 , getRouteWith
1634 , runSnapWithCommandLineArgs
35+ , runSnapWithConfig
1736 , serveDefaultObeliskApp
1837 , prettifyOutput
19− , runBackend
2038 , staticRenderContentType
21− , mkRouteToUrl
2239 , getPublicConfigs
2340 ) where
2441
25−import Prelude hiding (id, (.))
26−import Control.Category
2742import Control.Monad
2843import Control.Monad.Except
2944import Control.Monad.Fail (MonadFail)
30−import Control.Categorical.Bifunctor
3145import Data.ByteString (ByteString)
3246import qualified Data.ByteString.Char8 as BSC8
3347import Data.Default (Default (..))
@@ -38,7 +52,7 @@ import qualified Data.Map as Map
3852import Data.Monoid ((<>))
3953import Data.Text (Text)
4054import qualified Data.Text as T
41−import Data.Text.Encoding
55+import GHC.Generics (Generic)
4256import Obelisk.Asset.Serve.Snap (serveAsset)
4357import qualified Obelisk.ExecutableConfig.Lookup as Lookup
4458import Obelisk.Frontend
@@ -54,27 +68,52 @@ import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
5468data Backend backendRoute frontendRoute = Backend
5569 { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
5670 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
57− }
71+ } deriving (Generic)
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)
5880
5981-- | The static assets provided must contain a compiled GHCJS app that corresponds exactly to the Frontend provided
6082data GhcjsApp route = GhcjsApp
6183 { _ghcjsApp_compiled :: !StaticAssets
6284 , _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
63102 }
64103
65104-- | Serve a frontend, which must be the same frontend that Obelisk has built and placed in the default location
66105--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
67106serveDefaultObeliskApp
68107 :: (MonadSnap m, HasCookies m, MonadFail m)
69− => (R appRoute
70− -> Text)
71− -> ([Text]
72− -> m ())
108+ => (R appRoute -> Text)
109+ -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
110+ -> ([Text] -> m ())
73111 -> Frontend (R appRoute)
74112 -> Map Text ByteString
75113 -> R (ObeliskRoute appRoute)
76114 -> m ()
77−serveDefaultObeliskApp urlEnc serveStaticAsset frontend configs = serveObeliskApp urlEnc serveStaticAsset frontendApp configs
115+serveDefaultObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontend =
116+ serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp
78117 where frontendApp = GhcjsApp
79118 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
80119 , _ghcjsApp_value = frontend
@@ -99,17 +138,20 @@ defaultFrontendGhcjsAssets = StaticAssets
99138 , _staticAssets_unprocessed = "frontend.jsexe"
100139 }
101140
102−runSnapWithCommandLineArgs :: MonadIO m => Snap () -> m ()
103−runSnapWithCommandLineArgs a = do
104− -- Get the web server configuration from the command line
105− cmdLineConf <- liftIO $ commandLineConfig defaultConfig
106− let httpConf = cmdLineConf
141+runSnapWithConfig :: MonadIO m => Config Snap a -> Snap () -> m ()
142+runSnapWithConfig conf a = do
143+ let httpConf = conf
107144 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
108145 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
109146 }
110147 -- Start the web server
111148 liftIO $ httpServe httpConf a
112149
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+
113155getPageName :: (MonadSnap m) => m PageName
114156getPageName = do
115157 p <- getsRequest rqPathInfo
@@ -121,19 +163,24 @@ getRouteWith e = do
121163 pageName <- getPageName
122164 return $ tryDecode e pageName
123165
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+
124170serveObeliskApp
125171 :: (MonadSnap m, HasCookies m, MonadFail m)
126172 => (R appRoute -> Text)
173+ -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
127174 -> ([Text] -> m ())
128175 -> GhcjsApp (R appRoute)
129176 -> Map Text ByteString
130177 -> R (ObeliskRoute appRoute)
131178 -> m ()
132−serveObeliskApp urlEnc serveStaticAsset frontendApp config = \case
133− ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
179+serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp config = \case
180+ ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
134181 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
135182 ResourceRoute_Static :=> Identity pathSegments -> serveStaticAsset pathSegments
136− ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp urlEnc frontendApp config $ GhcjsAppRoute_Resource :/ pathSegments
183+ ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_Resource :/ pathSegments
137184 ResourceRoute_JSaddleWarp :=> Identity _ -> do
138185 let msg = "Error: Obelisk.Backend received jsaddle request"
139186 liftIO $ putStrLn $ T.unpack msg
@@ -160,48 +207,85 @@ staticRenderContentType = "text/html; charset=utf-8"
160207serveGhcjsApp
161208 :: (MonadSnap m, HasCookies m, MonadFail m)
162209 => (R appRouteComponent -> Text)
210+ -> GhcjsWidgets (FrontendWidgetT (R appRouteComponent) ())
163211 -> GhcjsApp (R appRouteComponent)
164212 -> Map Text ByteString
165213 -> R (GhcjsAppRoute appRouteComponent)
166214 -> m ()
167−serveGhcjsApp urlEnc app config = \case
215+serveGhcjsApp urlEnc ghcjsWidgets app config = \case
168216 GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
169217 modifyResponse $ setContentType staticRenderContentType
170218 modifyResponse $ setHeader "Cache-Control" "no-store private"
171− writeBS <=< renderGhcjsFrontend urlEnc (appRouteComponent :/ appRouteRest) config $ _ghcjsApp_value app
219+ writeBS <=< renderGhcjsFrontend urlEnc ghcjsWidgets (appRouteComponent :/ appRouteRest) config $ _ghcjsApp_value app
172220 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
173221
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.
174227runBackend :: Backend backendRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
175−runBackend backend frontend = case checkEncoder $ _backend_routeEncoder backend of
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
176237 Left e -> fail $ "backend error:\n" <> T.unpack e
177238 Right validFullEncoder -> do
178239 publicConfigs <- getPublicConfigs
179− _backend_run backend $ \serveRoute -> do
180− runSnapWithCommandLineArgs $ do
240+ _backend_run backend $ \serveRoute ->
241+ runSnap $
181242 getRouteWith validFullEncoder >>= \case
182243 Identity r -> case r of
183244 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
184245 FullRoute_Frontend obeliskRoute :/ a ->
185− serveDefaultObeliskApp (mkRouteToUrl validFullEncoder) (serveStaticAssets defaultStaticAssets) frontend publicConfigs $
246+ serveDefaultObeliskApp routeToUrl (($ allJsUrl) <$> ghcjsWidgets) (serveStaticAssets staticAssets) frontend publicConfigs $
186247 obeliskRoute :/ a
187−
188−mkRouteToUrl :: Encoder Identity parse (R (FullRoute br fr)) PageName -> R fr -> Text
189−mkRouteToUrl validFullEncoder =
190− let pageNameEncoder' :: Encoder Identity (Either Text) PageName PathQuery = pageNameEncoder
191− in \(k :/ v) -> T.pack . uncurry (<>) . encode pageNameEncoder' . encode validFullEncoder $ (FullRoute_Frontend $ ObeliskRoute_App k) :/ v
248+ where
249+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
250+ allJsUrl = renderAllJsPath validFullEncoder
192251
193252renderGhcjsFrontend
194253 :: (MonadSnap m, HasCookies m)
195254 => (route -> Text)
255+ -> GhcjsWidgets (FrontendWidgetT route ())
196256 -> route
197257 -> Map Text ByteString
198258 -> Frontend route
199259 -> m ByteString
200−renderGhcjsFrontend urlEnc route configs f = do
201− let ghcjsPreload = elAttr "link" ("rel" =: "preload" <> "as" =: "script" <> "href" =: "ghcjs/all.js") blank
202− ghcjsScript = elAttr "script" ("language" =: "javascript" <> "src" =: "ghcjs/all.js" <> "defer" =: "defer") blank
260+renderGhcjsFrontend urlEnc ghcjsWidgets route configs f = do
203261 cookies <- askCookies
204− renderFrontendHtml configs cookies urlEnc route f ghcjsPreload ghcjsScript
262+ renderFrontendHtml configs cookies urlEnc route f (_ghcjsWidgets_preload ghcjsWidgets) (_ghcjsWidgets_script ghcjsWidgets)
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+ ]
205289
206290instance HasCookies Snap where
207291 askCookies = map (\c -> (cookieName c, cookieValue c)) <$> getsRequest rqCookies
lib/cliapp/obelisk-cliapp.cabal+3−3
@@ -7,7 +7,8 @@ cabal-version: >=1.2
77library
88 hs-source-dirs: src
99 build-depends:
10− ansi-terminal
10+ aeson
11+ , ansi-terminal
1112 , base
1213 , bytestring
1314 , containers
@@ -17,8 +18,8 @@ library
1718 , logging-effect
1819 , monad-loops
1920 , mtl
20− , shell-escape
2121 , process
22+ , shell-escape
2223 , terminal-size
2324 , text
2425 , time
@@ -26,7 +27,6 @@ library
2627 , utf8-string
2728 exposed-modules:
2829 Obelisk.CliApp
29− Obelisk.CliApp.Demo
3030 other-modules:
3131 Obelisk.CliApp.Logging
3232 Obelisk.CliApp.Process
lib/cliapp/src/Obelisk/CliApp.hs+2
@@ -45,11 +45,13 @@ module Obelisk.CliApp
4545 , readCreateProcessWithExitCode
4646 , readProcessAndLogOutput
4747 , readProcessAndLogStderr
48+ , readProcessJSONAndLogStderr
4849 , reconstructCommand
4950 , setCwd
5051 , setDelegateCtlc
5152 , setEnvOverride
5253 , shell
54+ , waitForProcess
5355 ) where
5456
5557import Control.Monad.Log (Severity (..))
lib/cliapp/src/Obelisk/CliApp/Demo.hsdeleted−52
@@ -1,52 +0,0 @@
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.Fail
8−import Control.Monad.IO.Class
9−import Data.Semigroup ((<>))
10−import qualified Data.Text as T
11−
12−import Control.Monad.Catch (MonadMask)
13−
14−import Obelisk.CliApp
15−
16−cliDemo
17− :: ( MonadIO m, MonadMask m, MonadFail 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+11−10
@@ -39,7 +39,6 @@ import Control.Monad.Log (Severity (..), WithSeverity (..), logMessage, runLoggi
3939import Control.Monad.Loops (iterateUntil)
4040import Control.Monad.Reader (MonadIO, ReaderT (..))
4141import Data.IORef (atomicModifyIORef', newIORef, readIORef, writeIORef)
42−import Data.Maybe
4342import Data.Semigroup ((<>))
4443import Data.Text (Text)
4544import qualified Data.Text as T
@@ -67,7 +66,7 @@ newCliConfig sev noColor noSpinner errorLogExitCode = do
6766 tipDisplayed <- newIORef False
6867 stack <- newIORef ([], [])
6968 textEncoding <- hGetEncoding stdout
70− let theme = if fromMaybe False $ supportsUnicode <$> textEncoding
69+ let theme = if maybe False supportsUnicode textEncoding
7170 then unicodeTheme
7271 else noUnicodeTheme
7372 return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
@@ -133,7 +132,7 @@ handleLog' noColor output = do
133132 hFlush stdout
134133 Output_Overwrite ts -> liftIO $ do
135134 width <- TS.getTerminalWidth
136− T.putStr $ "\r" <> (TS.render (not noColor) width ts)
135+ T.putStr $ "\r" <> TS.render (not noColor) width ts
137136 hFlush stdout
138137 Output_ClearLine -> liftIO $ do
139138 -- Go to the first column and clear the whole line
@@ -179,14 +178,16 @@ withExitFailMessage msg f = f `catch` \(e :: ExitCode) -> do
179178
180179-- | Write log to stdout, with colors (unless `noColor`)
181180writeLog :: (MonadIO m, MonadMask m) => Bool -> Bool -> WithSeverity Text -> m ()
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
181+writeLog withNewLine noColor (WithSeverity severity s) = if T.null s then pure () else write
188182 where
189− putFn = if withNewLine then (T.hPutStrLn h) else (T.hPutStr h)
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
190191 h = if severity <= Error then stderr else stdout
191192 errorColors = [SetColor Foreground Vivid Red]
192193 warningColors = [SetColor Foreground Vivid Yellow]
lib/cliapp/src/Obelisk/CliApp/Process.hs+23−3
@@ -22,11 +22,13 @@ module Obelisk.CliApp.Process
2222 , readCreateProcessWithExitCode
2323 , readProcessAndLogOutput
2424 , readProcessAndLogStderr
25+ , readProcessJSONAndLogStderr
2526 , reconstructCommand
2627 , setCwd
2728 , setDelegateCtlc
2829 , setEnvOverride
2930 , shell
31+ , waitForProcess
3032 ) where
3133
3234import Control.Monad ((<=<), join, void)
@@ -51,9 +53,10 @@ import System.IO (Handle)
5153import System.IO.Streams (InputStream, handleToInputStream)
5254import qualified System.IO.Streams as Streams
5355import System.IO.Streams.Concurrent (concurrentMerge)
54−import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), std_err, std_out, waitForProcess)
56+import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), std_err, std_out)
5557import qualified System.Process as Process
5658import Text.ShellEscape (bytes, bash)
59+import qualified Data.Aeson as Aeson
5760
5861import Control.Monad.Log (Severity (..))
5962import Obelisk.CliApp.Logging (putLog, putLogRaw)
@@ -103,6 +106,19 @@ readProcessAndLogStderr sev process = do
103106 streamToLog =<< liftIO (streamHandle sev err)
104107 liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
105108
109+readProcessJSONAndLogStderr
110+ :: (Aeson.FromJSON a, MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
111+ => Severity -> ProcessSpec -> m a
112+readProcessJSONAndLogStderr sev process = do
113+ (out, _err) <- withProcess process $ \_out err -> do
114+ streamToLog =<< liftIO (streamHandle sev err)
115+ json <- liftIO $ BS.hGetContents out
116+ case Aeson.eitherDecodeStrict json of
117+ Right a -> pure a
118+ Left err -> do
119+ putLog Error $ "Could not decode process output as JSON: " <> T.pack err
120+ throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) 0
121+
106122readCreateProcessWithExitCode
107123 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
108124 => ProcessSpec -> m (ExitCode, String, String)
@@ -130,7 +146,7 @@ readProcessAndLogOutput (sev_out, sev_err) process = do
130146 outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
131147 putLogRaw sev_out outText
132148
133− liftIO (waitForProcess p) >>= \case
149+ waitForProcess p >>= \case
134150 ExitSuccess -> pure outText
135151 ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) code
136152
@@ -205,7 +221,7 @@ withProcess process f = do -- TODO: Use bracket.
205221
206222 f out err -- Pass the handles to the passed function
207223
208− liftIO (waitForProcess p) >>= \case
224+ waitForProcess p >>= \case
209225 ExitSuccess -> return (out, err)
210226 ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) code
211227
@@ -222,6 +238,10 @@ streamToLog stream = fix $ \loop -> do
222238 Nothing -> return ()
223239 Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
224240
241+-- | Wrapper around `System.Process.waitForProcess`
242+waitForProcess :: MonadIO m => ProcessHandle -> m ExitCode
243+waitForProcess = liftIO . Process.waitForProcess
244+
225245-- | Pretty print a 'CmdSpec'
226246reconstructCommand :: Process.CmdSpec -> Text
227247reconstructCommand p = case p of
lib/cliapp/src/Obelisk/CliApp/Spinner.hs−1
@@ -3,7 +3,6 @@
33{-# LANGUAGE MultiParamTypeClasses #-}
44{-# LANGUAGE OverloadedStrings #-}
55{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE TupleSections #-}
76-- | Provides a simple CLI spinner that interoperates cleanly with the rest of the logging output.
87module Obelisk.CliApp.Spinner
98 ( withSpinner
lib/command/obelisk-command.cabal+12−12
@@ -1,5 +1,5 @@
11name: obelisk-command
2−version: 0.3
2+version: 0.8.0.0
33cabal-version: >= 1.8
44build-type: Simple
55
@@ -7,35 +7,35 @@ library
77 hs-source-dirs: src
88 build-depends:
99 aeson
10− , ansi-terminal
11− , Cabal
1210 , aeson-pretty
11+ , ansi-terminal
1312 , base
14− , base16-bytestring
15− , binary
1613 , bytestring
17− , obelisk-cliapp
14+ , Cabal
1815 , containers
1916 , data-default
2017 , directory
2118 , either
2219 , errors
20+ , exceptions
21+ , extra
2322 , filepath
23+ , git
2424 , github
2525 , here
26− , git
2726 , hnix
2827 , hpack
2928 , io-streams
30− , exceptions
31− , logging-effect
3229 , lens
30+ , logging-effect
31+ , megaparsec
3332 , modern-uri
3433 , monad-loops
34+ , monoidal-containers
3535 , mtl
36− , megaparsec
3736 , network
3837 , network-uri
38+ , obelisk-cliapp
3939 , optparse-applicative
4040 , placeholders
4141 , process
@@ -60,8 +60,8 @@ library
6060 Obelisk.Command.Thunk
6161 Obelisk.Command.Utils
6262 Obelisk.Command.VmBuilder
63− -- -fobject-code is so that the StaticPointers extension can work in ghci
64− ghc-options: -Wall -fobject-code
63+ Obelisk.Command.Preprocessor
64+ ghc-options: -Wall
6565
6666executable ob
6767 main-is: src-bin/ob.hs
lib/command/src/Obelisk/Command.hs+168−151
@@ -3,24 +3,19 @@
33{-# LANGUAGE MultiParamTypeClasses #-}
44{-# LANGUAGE OverloadedStrings #-}
55{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE StaticPointers #-}
7−{-# LANGUAGE TypeApplications #-}
6+{-# LANGUAGE TupleSections #-}
87module Obelisk.Command where
98
10−import Control.Monad
11−import Control.Monad.IO.Class (liftIO)
12−import qualified Data.Binary as Binary
9+import Control.Monad.IO.Class (MonadIO, liftIO)
1310import Data.Bool (bool)
14−import qualified Data.ByteString.Base16 as Base16
15−import qualified Data.ByteString.Lazy as LBS
1611import qualified Data.ByteString.UTF8 as BSU
1712import Data.Foldable (for_)
18−import Data.List
19−import Data.Maybe (catMaybes)
13+import Data.List (isInfixOf, isPrefixOf)
14+import Data.List.NonEmpty (NonEmpty, nonEmpty)
15+import qualified Data.List.NonEmpty as NonEmpty
16+import qualified Data.Map as Map
2017import qualified Data.Text as T
21−import Data.Text.Encoding
22−import Data.Text.Encoding.Error (lenientDecode)
23−import GHC.StaticPtr
18+import Data.Traversable (for)
2419import Options.Applicative
2520import Options.Applicative.Help.Pretty (text, (<$$>))
2621import System.Directory
@@ -28,18 +23,17 @@ import System.Environment
2823import System.FilePath
2924import qualified System.Info
3025import System.IO (hIsTerminalDevice, stdout)
31−import Text.ShellEscape (bash)
26+import Text.ShellEscape (Bash, bash)
3227import System.Posix.Process (executeFile)
3328
3429import Obelisk.App
3530import Obelisk.CliApp
36−import Obelisk.CliApp.Demo (cliDemo)
3731import Obelisk.Command.Deploy
3832import Obelisk.Command.Project
3933import Obelisk.Command.Run
4034import Obelisk.Command.Thunk
41−import Obelisk.Command.Utils
4235import qualified Obelisk.Command.VmBuilder as VmBuilder
36+import qualified Obelisk.Command.Preprocessor as Preprocessor
4337
4438
4539data Args = Args
@@ -82,8 +76,8 @@ argsInfo cfg = info (args cfg <**> helper) $ mconcat
8276initSource :: Parser InitSource
8377initSource = foldl1 (<|>)
8478 [ pure InitSource_Default
85− , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH")
86− , InitSource_Symlink <$> strOption (long "symlink" <> action "directory" <> metavar "PATH")
79+ , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH" <> help "Initialize the project using the given BRANCH of Obelisk's official repository")
80+ , 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")
8781 ]
8882
8983initForce :: Parser Bool
@@ -92,59 +86,53 @@ initForce = switch (long "force" <> help "Allow ob init to overwrite files")
9286data ObCommand
9387 = ObCommand_Init InitSource Bool
9488 | ObCommand_Deploy DeployCommand
95− | ObCommand_Run
96− | ObCommand_Thunk ThunkCommand
97− | ObCommand_Repl
98− | ObCommand_Watch
89+ | ObCommand_Run [(FilePath, Interpret)]
90+ | ObCommand_Profile String [String]
91+ | ObCommand_Thunk ThunkOption
92+ | ObCommand_Repl [(FilePath, Interpret)]
93+ | ObCommand_Watch [(FilePath, Interpret)]
9994 | ObCommand_Shell ShellOpts
10095 | ObCommand_Doc String [String] -- shell and list of packages
96+ | ObCommand_Hoogle String Int -- shell and port
10197 | ObCommand_Internal ObInternal
10298 deriving Show
10399
104100data ObInternal
105− = ObInternal_RunStaticIO StaticKey
106− | ObInternal_CLIDemo
101+ -- the preprocessor argument syntax is also handled outside
102+ -- optparse-applicative, but it shouldn't ever conflict with another syntax
103+ = ObInternal_ApplyPackages String String String [String]
104+ | ObInternal_ExportGhciConfig
105+ [(FilePath, Interpret)]
106+ Bool -- ^ Use relative paths
107107 deriving Show
108108
109−inNixShell' :: MonadObelisk m => StaticPtr (ObeliskT IO ()) -> m ()
110−inNixShell' p = withProjectRoot "." $ \root -> do
111− cmd <- liftIO $ fmap (bash . BSU.fromString) <$> mkCmd
112− projectProc root True "ghc" (Just cmd)
113− where
114− mkCmd = do
115− argsCfg <- getArgsConfig
116− myArgs <- getArgs
117− obArgs <- parseCLIArgs argsCfg myArgs
118− progName <- getObeliskExe
119− return $ progName : catMaybes
120− [ Just "--no-handoff"
121− , bool Nothing (Just "--verbose") $ _args_verbose obArgs
122− , Just "internal"
123− , Just "run-static-io"
124− , Just $ encodeStaticKey $ staticKey p
125− ]
126−
127109obCommand :: ArgsConfig -> Parser ObCommand
128110obCommand cfg = hsubparser
129− (mconcat
130− [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
131− , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
132− , command "run" $ info (pure ObCommand_Run) $ progDesc "Run current project in development mode"
133− , command "thunk" $ info (ObCommand_Thunk <$> thunkCommand) $ progDesc "Manipulate thunk directories"
134− , command "repl" $ info (pure ObCommand_Repl) $ progDesc "Open an interactive interpreter"
135− , command "watch" $ info (pure ObCommand_Watch) $ progDesc "Watch current project for errors and warnings"
136− , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies"
137− , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
138− progDesc "List paths to haddock documentation for specified packages"
139− <> footerDoc (Just $
140− text "Hint: To open the documentation you can pipe the output of this command like"
141− <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
142− ])
143− <|> subparser
144− (mconcat
145− [ internal
146− , command "internal" (info (ObCommand_Internal <$> internalCommand) mempty)
147− ])
111+ (mconcat
112+ [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
113+ , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
114+ , command "run" $ info (ObCommand_Run <$> interpretOpts) $ progDesc "Run current project in development mode"
115+ , command "profile" $ info (uncurry ObCommand_Profile <$> profileCommand) $ progDesc "Run current project with profiling enabled"
116+ , command "thunk" $ info (ObCommand_Thunk <$> thunkOption) $ progDesc "Manipulate thunk directories"
117+ , command "repl" $ info (ObCommand_Repl <$> interpretOpts) $ progDesc "Open an interactive interpreter"
118+ , command "watch" $ info (ObCommand_Watch <$> interpretOpts) $ progDesc "Watch current project for errors and warnings"
119+ , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies"
120+ , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
121+ progDesc "List paths to haddock documentation for specified packages"
122+ <> footerDoc (Just $
123+ text "Hint: To open the documentation you can pipe the output of this command like"
124+ <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
125+ , command "hoogle" $ info (ObCommand_Hoogle <$> shellFlags <*> portOpt 8080) $ progDesc "Run a hoogle server locally for your project's dependency tree"
126+ , command "internal" $ info (ObCommand_Internal <$> internalCommand) $ progDesc "Internal Obelisk commands with unstable APIs"
127+ ])
128+
129+internalCommand :: Parser ObInternal
130+internalCommand = hsubparser $ mconcat
131+ [ command "export-ghci-configuration" $ info (ObInternal_ExportGhciConfig <$> interpretOpts <*> useRelativePathsFlag)
132+ $ progDesc "Export the GHCi configuration used by ob run, etc.; useful for IDE integration"
133+ ]
134+ where
135+ useRelativePathsFlag = switch (long "use-relative-paths" <> help "Use relative paths")
148136
149137packageNames :: Parser [String]
150138packageNames = some (strArgument (metavar "PACKAGE-NAME..."))
@@ -159,7 +147,7 @@ deployCommand cfg = hsubparser $ mconcat
159147 where
160148 platformP = hsubparser $ mconcat
161149 [ command "android" $ info (pure (Android, [])) mempty
162− , command "ios" $ info ((,) <$> pure IOS <*> (fmap pure $ strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
150+ , command "ios" $ info ((,) <$> pure IOS <*> fmap pure (strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
163151 ]
164152
165153 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
@@ -181,8 +169,8 @@ deployCommand cfg = hsubparser $ mconcat
181169
182170deployInitOpts :: Parser DeployInitOpts
183171deployInitOpts = DeployInitOpts
184− <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory that it will create")
185− <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an ssh key that it will symlink to")
172+ <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory where the deployment repository will be initialized")
173+ <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an SSH key that will be *copied* to the deployment repository")
186174 <*> some (strOption (long "hostname" <> metavar "HOSTNAME" <> help "hostname of the deployment target"))
187175 <*> strOption (long "route" <> metavar "PUBLICROUTE" <> help "Publicly accessible URL of your app")
188176 <*> strOption (long "admin-email" <> metavar "ADMINEMAIL" <> help "Email address where administrative alerts will be sent")
@@ -199,29 +187,23 @@ data DeployCommand
199187 | DeployCommand_Update
200188 deriving Show
201189
202−data DeployInitOpts = DeployInitOpts
203− { _deployInitOpts_outputDir :: FilePath
204− , _deployInitOpts_sshKey :: FilePath
205− , _deployInitOpts_hostname :: [String]
206− , _deployInitOpts_route :: String
207− , _deployInitOpts_adminEmail :: String
208− , _deployInitOpts_enableHttps :: Bool
209− }
210− deriving Show
211−
212−internalCommand :: Parser ObInternal
213−internalCommand = subparser $ mconcat
214− [ command "run-static-io" $ info (ObInternal_RunStaticIO <$> argument (eitherReader decodeStaticKey) (action "static-key")) mempty
215− , command "clidemo" $ info (pure ObInternal_CLIDemo) mempty
216− ]
217−
218−--TODO: Result should provide normalised path and also original user input for error reporting.
219−thunkDirectoryParser :: Parser FilePath
220−thunkDirectoryParser = fmap (dropTrailingPathSeparator . normalise) . strArgument $ mconcat
221− [ action "directory"
222− , metavar "THUNKDIR"
223− , help "Path to directory containing thunk data"
224− ]
190+profileCommand :: Parser (String, [String])
191+profileCommand = (,)
192+ <$> strOption
193+ ( long "output"
194+ <> short 'o'
195+ <> 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."
196+ <> metavar "PATH"
197+ <> value "profile/%Y-%m-%dT%H:%M:%S"
198+ <> showDefault
199+ )
200+ <*> (words <$> strOption
201+ ( long "rts-flags"
202+ <> help "RTS Flags to pass to the executable."
203+ <> value "-p -hc"
204+ <> metavar "FLAGS"
205+ <> showDefault
206+ ))
225207
226208thunkConfig :: Parser ThunkConfig
227209thunkConfig = ThunkConfig
@@ -241,22 +223,36 @@ thunkPackConfig = ThunkPackConfig
241223 <$> 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.")
242224 <*> thunkConfig
243225
226+data ThunkOption = ThunkOption
227+ { _thunkOption_thunks :: NonEmpty FilePath
228+ , _thunkOption_command :: ThunkCommand
229+ } deriving Show
230+
244231data ThunkCommand
245− = ThunkCommand_Update [FilePath] ThunkUpdateConfig
246− | ThunkCommand_Unpack [FilePath]
247− | ThunkCommand_Pack [FilePath] ThunkPackConfig
232+ = ThunkCommand_Update ThunkUpdateConfig
233+ | ThunkCommand_Unpack
234+ | ThunkCommand_Pack ThunkPackConfig
248235 deriving Show
249236
250−thunkCommand :: Parser ThunkCommand
251−thunkCommand = hsubparser $ mconcat
252− [ command "update" $ info (ThunkCommand_Update <$> some thunkDirectoryParser <*> thunkUpdateConfig) $ progDesc "Update thunk to latest revision available"
253− , command "unpack" $ info (ThunkCommand_Unpack <$> some thunkDirectoryParser) $ progDesc "Unpack thunk into git checkout of revision it points to"
254− , command "pack" $ info (ThunkCommand_Pack <$> some thunkDirectoryParser <*> thunkPackConfig) $ progDesc "Pack git checkout into thunk that points at the current branch's upstream"
237+thunkOption :: Parser ThunkOption
238+thunkOption = hsubparser $ mconcat
239+ [ command "update" $ info (thunkOptionWith $ ThunkCommand_Update <$> thunkUpdateConfig) $ progDesc "Update packed thunk to latest revision available on the tracked branch"
240+ , command "unpack" $ info (thunkOptionWith $ pure ThunkCommand_Unpack) $ progDesc "Unpack thunk into git checkout of revision it points to"
241+ , command "pack" $ info (thunkOptionWith $ ThunkCommand_Pack <$> thunkPackConfig) $ progDesc "Pack git checkout or unpacked thunk into thunk that points at the current branch's upstream"
255242 ]
243+ where
244+ thunkOptionWith f = ThunkOption
245+ <$> ((NonEmpty.:|)
246+ <$> thunkDirArg (metavar "THUNKDIRS..." <> help "Paths to directories containing thunk data")
247+ <*> many (thunkDirArg mempty)
248+ )
249+ <*> f
250+ thunkDirArg opts = fmap (dropTrailingPathSeparator . normalise) $ strArgument $ action "directory" <> opts
256251
257252data ShellOpts
258253 = ShellOpts
259254 { _shellOpts_shell :: String
255+ , _shellOpts_interpretPaths :: [(FilePath, Interpret)]
260256 , _shellOpts_command :: Maybe String
261257 }
262258 deriving Show
@@ -267,19 +263,40 @@ shellFlags =
267263 <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
268264 <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
269265
266+interpretOpts :: Parser [(FilePath, Interpret)]
267+interpretOpts = many
268+ ( (, Interpret_Interpret) <$>
269+ strOption (common <> long "interpret" <> help
270+ "Don't pre-build packages found in DIR when constructing the package database. The default behavior is \
271+ \'--interpret <project-root>', which will load everything which is unpacked into GHCi. \
272+ \ Use --interpret and --no-interpret multiple times to add or remove multiple trees \
273+ \ from the environment. Settings for right-most directories will \
274+ \ override settings for any identical directories given earlier."
275+ )
276+ <|> (, Interpret_NoInterpret) <$>
277+ strOption (common <> long "no-interpret" <> help
278+ "Make packages found in DIR available in the package database (but only when they are used dependencies). \
279+ \ This will build the packages in DIR before loading GHCi. \
280+ \See help for --interpret for how the two options are related."
281+ )
282+ )
283+ where
284+ common = action "directory" <> metavar "DIR"
285+
270286shellOpts :: Parser ShellOpts
271287shellOpts = ShellOpts
272288 <$> shellFlags
289+ <*> interpretOpts
273290 <*> optional (strArgument (metavar "COMMAND"))
274291
292+portOpt :: Int -> Parser Int
293+portOpt dfault = option auto (long "port" <> short 'p' <> help "Port number for server" <> showDefault <> value dfault <> metavar "INT")
294+
275295parserPrefs :: ParserPrefs
276296parserPrefs = defaultPrefs
277297 { prefShowHelpOnEmpty = True
278298 }
279299
280−parseCLIArgs :: ArgsConfig -> [String] -> IO Args
281−parseCLIArgs cfg as = pure as >>= handleParseResult . execParserPure parserPrefs (argsInfo cfg)
282−
283300-- | Create an Obelisk config for the current process.
284301mkObeliskConfig :: IO Obelisk
285302mkObeliskConfig = do
@@ -351,6 +368,9 @@ main' argsCfg = do
351368 liftIO $ executeFile impl False ("--no-handoff" : myArgs) Nothing
352369 case myArgs of
353370 "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
371+ origPath:inPath:outPath:preprocessorName:packagePaths
372+ | preprocessorName == preprocessorIdentifier && any (\c -> c == '.' || c == pathSeparator) origPath ->
373+ ob $ ObCommand_Internal $ ObInternal_ApplyPackages origPath inPath outPath packagePaths
354374 a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
355375 | "--bash-completion" `isPrefixOf` a
356376 && "--no-handoff" `elem` as -> go (a:as)
@@ -361,29 +381,7 @@ ob :: MonadObelisk m => ObCommand -> m ()
361381ob = \case
362382 ObCommand_Init source force -> initProject source force
363383 ObCommand_Deploy dc -> case dc of
364− DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> do
365− let deployDir = _deployInitOpts_outputDir deployOpts
366− r <- liftIO $ canonicalizePath root
367− rootEqualsTarget <- liftIO $ equalFilePath r <$> canonicalizePath deployDir
368− when rootEqualsTarget $
369− failWith $ "Deploy directory " <> T.pack deployDir <> " should not be the same as project root."
370− thunkPtr <- readThunk root >>= \case
371− Left err -> failWith $ case err of
372− ReadThunkError_AmbiguousFiles ->
373− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
374− ReadThunkError_UnrecognizedFiles ->
375− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
376− _ -> "thunk read: " <> T.pack (show err)
377− Right (ThunkData_Packed ptr) -> return ptr
378− Right (ThunkData_Checkout (Just ptr)) -> return ptr
379− Right (ThunkData_Checkout Nothing) ->
380− getThunkPtr False root
381− let sshKeyPath = _deployInitOpts_sshKey deployOpts
382− hostname = _deployInitOpts_hostname deployOpts
383− route = _deployInitOpts_route deployOpts
384− adminEmail = _deployInitOpts_adminEmail deployOpts
385− enableHttps = _deployInitOpts_enableHttps deployOpts
386− deployInit thunkPtr deployDir sshKeyPath hostname route adminEmail enableHttps
384+ DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> deployInit deployOpts root
387385 DeployCommand_Push remoteBuilder -> do
388386 deployPath <- liftIO $ canonicalizePath "."
389387 deployPush deployPath $ case remoteBuilder of
@@ -391,27 +389,39 @@ ob = \case
391389 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
392390 DeployCommand_Update -> deployUpdate "."
393391 DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
394− ObCommand_Run -> inNixShell' $ static run
395− ObCommand_Thunk tc -> case tc of
396− ThunkCommand_Update thunks config -> for_ thunks (updateThunkToLatest config)
397− ThunkCommand_Unpack thunks -> for_ thunks unpackThunk
398− ThunkCommand_Pack thunks config -> for_ thunks (packThunk config)
399− ObCommand_Repl -> runRepl
400− ObCommand_Watch -> inNixShell' $ static runWatch
401− ObCommand_Shell so -> withProjectRoot "." $ \root ->
402− projectProc root False (_shellOpts_shell so) (pure . bash . BSU.fromString <$> _shellOpts_command so)
403− ObCommand_Doc shell' pkgs -> withProjectRoot "." $ \root ->
404− projectShell root False shell' (Just $ haddockCommand pkgs)
392+ ObCommand_Run interpretPathsList -> withInterpretPaths interpretPathsList run
393+ ObCommand_Profile basePath rtsFlags -> profile basePath rtsFlags
394+ ObCommand_Thunk to -> case _thunkOption_command to of
395+ ThunkCommand_Update config -> for_ thunks (updateThunkToLatest config)
396+ ThunkCommand_Unpack -> for_ thunks unpackThunk
397+ ThunkCommand_Pack config -> for_ thunks (packThunk config)
398+ where
399+ thunks = _thunkOption_thunks to
400+ ObCommand_Repl interpretPathsList -> withInterpretPaths interpretPathsList runRepl
401+ ObCommand_Watch interpretPathsList -> withInterpretPaths interpretPathsList runWatch
402+ ObCommand_Shell (ShellOpts shellAttr interpretPathsList cmd) -> withInterpretPaths interpretPathsList $ \root interpretPaths ->
403+ nixShellForInterpretPaths False shellAttr root interpretPaths (pure . bash . BSU.fromString <$> cmd)
404+ ObCommand_Doc shellAttr pkgs -> withProjectRoot "." $ \root ->
405+ nixShellForInterpretPaths True shellAttr root emptyPathTree $ Just [haddockCommand pkgs]
406+ ObCommand_Hoogle shell' port -> withProjectRoot "." $ \root -> do
407+ nixShellWithHoogle root True shell' $ Just $ fmap (bash . BSU.fromString) ["hoogle", "server", "-p", show port, "--local"]
405408 ObCommand_Internal icmd -> case icmd of
406− ObInternal_RunStaticIO k -> liftIO (unsafeLookupStaticPtr @(ObeliskT IO ()) k) >>= \case
407− Nothing -> failWith $ "ObInternal_RunStaticIO: no such StaticKey: " <> T.pack (show k)
408− Just p -> do
409− c <- getObelisk
410− liftIO $ runObelisk c $ deRefStaticPtr p
411− ObInternal_CLIDemo -> cliDemo
412−
413−haddockCommand :: [String] -> String
414−haddockCommand pkgs = unwords
409+ ObInternal_ApplyPackages origPath inPath outPath packagePaths -> do
410+ liftIO $ Preprocessor.applyPackages origPath inPath outPath packagePaths
411+ ObInternal_ExportGhciConfig interpretPathsList useRelativePaths ->
412+ liftIO . putStrLn . unlines =<< withInterpretPaths interpretPathsList (exportGhciConfig useRelativePaths)
413+
414+-- | A helper for the common case that the command you want to run needs the project root and a resolved
415+-- set of interpret paths.
416+withInterpretPaths :: MonadObelisk m => [(FilePath, Interpret)] -> (FilePath -> PathTree Interpret -> m a) -> m a
417+withInterpretPaths interpretPathsList f = withProjectRoot "." $ \root -> do
418+ interpretPaths' <- resolveInterpretPaths $ (root, Interpret_Interpret) : interpretPathsList
419+ case interpretPaths' of
420+ Nothing -> failWith "No paths provided for finding packages"
421+ Just interpretPaths -> f root interpretPaths
422+
423+haddockCommand :: [String] -> Bash
424+haddockCommand pkgs = bash $ BSU.fromString $ unwords
415425 [ "for p in"
416426 , unwords [getHaddockPath p ++ "/index.html" | p <- pkgs]
417427 , "; do echo $p; done"
@@ -423,14 +433,21 @@ haddockCommand pkgs = unwords
423433getArgsConfig :: IO ArgsConfig
424434getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
425435
426−encodeStaticKey :: StaticKey -> String
427−encodeStaticKey = T.unpack . decodeUtf8With lenientDecode . Base16.encode . LBS.toStrict . Binary.encode
428−
429−-- TODO: Use failWith in place of fail to be consistent.
430−decodeStaticKey :: String -> Either String StaticKey
431−decodeStaticKey s = case Base16.decode $ encodeUtf8 $ T.pack s of
432− (b, "") -> case Binary.decodeOrFail $ LBS.fromStrict b of
433− Right ("", _, a) -> pure a
434− Right _ -> fail "decodeStaticKey: Binary.decodeOrFail didn't consume all input"
435− Left (_, _, e) -> fail $ "decodeStaticKey: Binary.decodeOrFail failed: " <> show e
436− _ -> fail $ "decodeStaticKey: could not decode hex string: " <> show s
436+-- | Resolves an ordered list of paths for use with @--interpret@/@--no-interpret@ by coalescing
437+-- paths into a non-ambiguous set of paths. Ambiguity is resolved by choosing right-most paths
438+-- over any preceeding identical paths.
439+--
440+-- For example: @a/b=ON a/b/c=OFF@ and @a/b/c=OFF a/b=ON@ are the same.
441+-- @a/b=ON a/b=OFF@ is reduced to @a/b=OFF@. We prefer right-biased choice to increase
442+-- scriptability.
443+--
444+-- N.B. All the paths in the result will be canonicalized. It's impossible to determine path
445+-- overlap otherwise.
446+resolveInterpretPaths :: MonadIO m => [(FilePath, a)] -> m (Maybe (PathTree a))
447+resolveInterpretPaths ps = do
448+ trees <- liftIO $ for ps $ \(p, a) -> pathToTree a <$> canonicalizePath p
449+ pure $ foldr1 mergeTrees <$> nonEmpty trees
450+ where
451+ -- | Merge two 'PathTree's preferring leaves on the right in as much as they overlap with paths on the left.
452+ mergeTrees :: PathTree a -> PathTree a -> PathTree a
453+ 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+94−75
@@ -1,29 +1,27 @@
1+{-# LANGUAGE DeriveGeneric #-}
12{-# LANGUAGE FlexibleContexts #-}
23{-# LANGUAGE LambdaCase #-}
34{-# LANGUAGE OverloadedStrings #-}
5+{-# LANGUAGE QuasiQuotes #-}
46{-# LANGUAGE ScopedTypeVariables #-}
57{-# LANGUAGE ViewPatterns #-}
6−{-# LANGUAGE DeriveGeneric #-}
78module Obelisk.Command.Deploy where
89
10+import Control.Applicative (liftA2)
911import Control.Lens
1012import Control.Monad
11−import Control.Monad.Catch (Exception (displayException), MonadThrow, throwM, try, bracket_)
12−import Control.Monad.IO.Class (liftIO)
13+import Control.Monad.Catch (Exception (displayException), MonadThrow, bracket, throwM, try)
14+import Control.Monad.IO.Class (MonadIO, liftIO)
1315import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
1416import Data.Bits
1517import qualified Data.ByteString.Lazy as BSL
1618import Data.Default
17−import qualified Data.HashMap.Strict as HM
1819import qualified Data.Map as Map
19−import Data.Text (Text)
2020import qualified Data.Set as Set
21+import Data.String.Here.Interpolated (i)
2122import qualified Data.Text as T
2223import qualified Data.Text.IO as T
2324import GHC.Generics
24−import Nix.Pretty
25−import Nix.String (principledMakeNixStringWithoutContext)
26−import Nix.Value
2725import System.Directory
2826import System.FilePath
2927import System.IO
@@ -41,23 +39,39 @@ import Obelisk.Command.Project
4139import Obelisk.Command.Thunk
4240import Obelisk.Command.Utils
4341
44−deployInit
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'
4563 :: MonadObelisk m
4664 => ThunkPtr
47− -> FilePath
48− -> FilePath
49− -> [String] -- ^ hostnames
50− -> String -- ^ route
51− -> String -- ^ admin email
52− -> Bool -- ^ enable https
65+ -> DeployInitOpts
5366 -> m ()
54−deployInit thunkPtr deployDir sshKeyPath hostnames route adminEmail enableHttps = do
67+deployInit' thunkPtr (DeployInitOpts deployDir sshKeyPath hostnames route adminEmail enableHttps) = do
68+ liftIO $ createDirectoryIfMissing True deployDir
5569 localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
5670 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
5771 False -> failWith $ T.pack $ "ob deploy init: file does not exist: " <> sshKeyPath
5872 True -> pure $ deployDir </> "ssh_key"
5973 callProcessAndLogOutput (Notice, Error) $
60− proc "cp" [sshKeyPath, localKey]
74+ proc cp [sshKeyPath, localKey]
6175 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
6276 return localKey
6377 withSpinner "Validating configuration" $ do
@@ -78,22 +92,30 @@ deployInit thunkPtr deployDir sshKeyPath hostnames route adminEmail enableHttps
7892 , deployDir </> "config" </> "common"
7993 , deployDir </> "config" </> "frontend"
8094 ]
95+
96+ let srcDir = deployDir </> "src"
97+ withSpinner ("Creating source thunk (" <> T.pack (makeRelative deployDir srcDir) <> ")") $ do
98+ createThunk srcDir $ Right thunkPtr
99+ setupObeliskImpl deployDir
100+
81101 withSpinner "Writing deployment configuration" $ do
82102 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
83103 writeDeployConfig deployDir "enable_https" $ show enableHttps
84104 writeDeployConfig deployDir "admin_email" adminEmail
85105 writeDeployConfig deployDir ("config" </> "common" </> "route") route
86− withSpinner "Creating source thunk (./src)" $ liftIO $ do
87− createThunk (deployDir </> "src") thunkPtr
88− setupObeliskImpl deployDir
106+ writeDeployConfig deployDir "module.nix" $
107+ "(import " <> toNixPath (makeRelative deployDir srcDir) <> " {}).obelisk.serverModules.mkBaseEc2"
108+
89109 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
90110 initGit deployDir
91111
92−setupObeliskImpl :: FilePath -> IO ()
93−setupObeliskImpl deployDir = do
94− let implDir = toImplDir deployDir
112+setupObeliskImpl :: MonadIO m => FilePath -> m ()
113+setupObeliskImpl deployDir = liftIO $ do
114+ let
115+ implDir = toImplDir deployDir
116+ goBackUp = foldr (</>) "" $ (".." <$) $ splitPath $ makeRelative deployDir implDir
95117 createDirectoryIfMissing True implDir
96− writeFile (implDir </> "default.nix") "(import ../../src {}).obelisk"
118+ writeFile (implDir </> "default.nix") $ "(import " <> toNixPath (goBackUp </> "src") <> " {}).obelisk"
97119
98120deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
99121deployPush deployPath getNixBuilders = do
@@ -104,14 +126,16 @@ deployPush deployPath getNixBuilders = do
104126 routeHost <- getHostFromRoute enableHttps route
105127 let srcPath = deployPath </> "src"
106128 thunkPtr <- readThunk srcPath >>= \case
107− Right (ThunkData_Packed ptr) -> return ptr
108− Right (ThunkData_Checkout _) -> do
129+ Right (ThunkData_Packed _ ptr) -> return ptr
130+ Right ThunkData_Checkout -> do
109131 checkGitCleanStatus srcPath True >>= \case
110132 True -> packThunk (ThunkPackConfig False (ThunkConfig Nothing)) srcPath
111133 False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
112134 Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
113135 let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
114136 builders <- getNixBuilders
137+ let moduleFile = deployPath </> "module.nix"
138+ moduleFileExists <- liftIO $ doesFileExist moduleFile
115139 buildOutputByHost <- ifor (Map.fromSet (const ()) hosts) $ \host () -> do
116140 --TODO: What does it mean if this returns more or less than 1 line of output?
117141 [result] <- fmap lines $ nixCmd $ NixCmd_Build $ def
@@ -121,13 +145,13 @@ deployPush deployPath getNixBuilders = do
121145 , _target_expr = Nothing
122146 }
123147 & nixBuildConfig_outLink .~ OutLink_None
124− & nixCmdConfig_args .~
148+ & nixCmdConfig_args .~ (
125149 [ strArg "hostName" host
126150 , strArg "adminEmail" adminEmail
127151 , strArg "routeHost" routeHost
128152 , strArg "version" version
129153 , boolArg "enableHttps" enableHttps
130− ]
154+ ] <> [rawArg "module" ("import " <> toNixPath moduleFile) | moduleFileExists ])
131155 & nixCmdConfig_builders .~ builders
132156 pure result
133157 let knownHostsPath = deployPath </> "backend_known_hosts"
@@ -171,20 +195,6 @@ deployPush deployPath getNixBuilders = do
171195deployUpdate :: MonadObelisk m => FilePath -> m ()
172196deployUpdate deployPath = updateThunkToLatest (ThunkUpdateConfig Nothing (ThunkConfig Nothing)) (deployPath </> "src")
173197
174−keytoolToAndroidConfig :: KeytoolConfig -> HM.HashMap Text (NValue t Identity m)
175−keytoolToAndroidConfig conf =
176− let path = nvPath $ _keytoolConfig_keystore conf
177− fromStr = nvStr . principledMakeNixStringWithoutContext . T.pack
178− storepass = fromStr $ _keytoolConfig_storepass conf
179− alias = fromStr $ _keytoolConfig_alias conf
180− keypass = fromStr $ _keytoolConfig_keypass conf
181− in HM.fromList
182− [ ("storeFile", path)
183− , ("storePassword", storepass)
184− , ("keyAlias", alias)
185− , ("keyPassword", keypass)
186− ]
187−
188198data PlatformDeployment = Android | IOS
189199 deriving (Show, Eq)
190200
@@ -199,7 +209,7 @@ deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
199209 configDir = root </> "config"
200210 exists <- liftIO $ doesDirectoryExist srcDir
201211 unless exists $ failWith "ob test should be run inside of a deploy directory"
202− nixBuildTarget <- case platform of
212+ (nixBuildTarget, extraArgs) <- case platform of
203213 Android -> do
204214 let keystorePath = root </> "android_keystore.jks"
205215 keytoolConfPath = root </> "android_keytool_config.json"
@@ -223,43 +233,55 @@ deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
223233 checkKeytoolConfExist <- liftIO $ doesFileExist keytoolConfPath
224234 unless checkKeytoolConfExist $ failWith "Missing android KeytoolConfig"
225235 keytoolConfContents <- liftIO $ BSL.readFile keytoolConfPath
226− liftIO $ print keytoolConfContents
227− releaseKey :: String <- case eitherDecode keytoolConfContents :: Either String KeytoolConfig of
236+ keyArgs <- case eitherDecode keytoolConfContents :: Either String KeytoolConfig of
228237 Left err -> failWith $ T.pack err
229− Right conf -> return $
230− (printNix :: MonadObelisk m => NValue t Identity m -> String) $
231− nvSet (keytoolToAndroidConfig conf) HM.empty
238+ Right conf -> pure
239+ [ "--sign"
240+ , "--store-file", _keytoolConfig_keystore conf
241+ , "--store-password", _keytoolConfig_storepass conf
242+ , "--key-alias", _keytoolConfig_alias conf
243+ , "--key-password", _keytoolConfig_keypass conf
244+ ]
232245 let expr = mconcat
233− [ "with (import ", srcDir, " {});"
234− , "android.frontend.override (drv: { "
235− , "releaseKey = (if builtins.isNull drv.releaseKey then {} else drv.releaseKey) // " <> releaseKey <> "; "
246+ [ "with (import ", toNixPath srcDir, " {});"
247+ , "android.frontend.override (drv: {"
248+ , "isRelease = true;"
236249 , "staticSrc = (passthru.__androidWithConfig ", configDir, ").frontend.staticSrc;"
250+ , "assets = (passthru.__androidWithConfig ", configDir, ").frontend.assets;"
237251 , "})"
238252 ]
239− return $ Target
253+ return (Target
240254 { _target_path = Nothing
241255 , _target_attr = Nothing
242256 , _target_expr = Just expr
243− }
257+ }, keyArgs)
244258 IOS -> do
245259 let expr = mconcat
246− [ "with (import ", srcDir, " {});"
247− , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", configDir, ").frontend.staticSrc; })"
260+ [ "with (import ", toNixPath srcDir, " {});"
261+ , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", toNixPath configDir, ").frontend.staticSrc; })"
248262 ]
249− return $ Target
263+ return (Target
250264 { _target_path = Nothing
251265 , _target_attr = Nothing
252266 , _target_expr = Just expr
253− }
267+ }, [])
254268 result <- nixCmd $ NixCmd_Build $ def
255269 & nixBuildConfig_outLink .~ OutLink_None
256270 & nixCmdConfig_target .~ nixBuildTarget
257− putLog Notice $ T.pack $ "Your recently built android apk can be found at the following path: " <> show result
258− callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") mobileArgs
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]
275+ callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") (mobileArgs ++ extraArgs)
259276 where
260− withEcho showEcho f = do
261− prevEcho <- hGetEcho stdin
262− bracket_ (hSetEcho stdin showEcho) (hSetEcho stdin prevEcho) f
277+ withEcho showEcho f = bracket
278+ (do
279+ prevEcho <- hGetEcho stdin
280+ hSetEcho stdin showEcho
281+ pure prevEcho
282+ )
283+ (hSetEcho stdin)
284+ (const f)
263285
264286data KeytoolConfig = KeytoolConfig
265287 { _keytoolConfig_keystore :: FilePath
@@ -272,19 +294,16 @@ instance FromJSON KeytoolConfig
272294instance ToJSON KeytoolConfig
273295
274296createKeystore :: MonadObelisk m => FilePath -> KeytoolConfig -> m ()
275−createKeystore root config = do
276− let expr = "with (import " <> toImplDir root <> ").reflex-platform.nixpkgs; pkgs.mkShell { buildInputs = [ pkgs.jdk ]; }"
277− callProcessAndLogOutput (Notice,Notice) $ setCwd (Just root) $ proc "nix-shell" ["default.nix", "-E" , expr, "--run" , keytoolCmd]
278− where
279− keytoolCmd = processToShellString "keytool"
280− [ "-genkeypair", "-noprompt"
281− , "-keystore", _keytoolConfig_keystore config
282− , "-keyalg", "RSA", "-keysize", "2048"
283− , "-validity", "1000000"
284− , "-storepass", _keytoolConfig_storepass config
285− , "-alias", _keytoolConfig_alias config
286− , "-keypass", _keytoolConfig_keypass config
287− ]
297+createKeystore root config =
298+ callProcessAndLogOutput (Notice, Notice) $ setCwd (Just root) $ proc jreKeyToolPath
299+ [ "-genkeypair", "-noprompt"
300+ , "-keystore", _keytoolConfig_keystore config
301+ , "-keyalg", "RSA", "-keysize", "2048"
302+ , "-validity", "1000000"
303+ , "-storepass", _keytoolConfig_storepass config
304+ , "-alias", _keytoolConfig_alias config
305+ , "-keypass", _keytoolConfig_keypass config
306+ ]
288307
289308-- | Simplified deployment configuration mechanism. At one point we may revisit this.
290309writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
lib/command/src/Obelisk/Command/Nix.hs+67−26
@@ -9,22 +9,33 @@
99{-# LANGUAGE TemplateHaskell #-}
1010{-# LANGUAGE TypeApplications #-}
1111module Obelisk.Command.Nix
12− ( nixCmd
13− , NixCmd (..)
14− , nixCmdConfig_target
15− , nixCmdConfig_args
16− , nixCmdConfig_builders
12+ ( Arg (..)
1713 , NixBuildConfig (..)
1814 , nixBuildConfig_common
1915 , nixBuildConfig_outLink
16+ , NixCmd (..)
17+ , nixCmdConfig_args
18+ , nixCmdConfig_builders
19+ , nixCmdConfig_target
20+ , NixCommonConfig (..)
2021 , NixInstantiateConfig (..)
2122 , nixInstantiateConfig_eval
22− , NixCommonConfig (..)
23− , Target (..)
23+ , NixShellConfig (..)
24+ , nixShellConfig_common
25+ , nixShellConfig_pure
26+ , nixShellConfig_run
2427 , OutLink (..)
25− , Arg (..)
28+ , Target (..)
29+ , target_attr
30+ , target_expr
31+ , target_path
32+
2633 , boolArg
34+ , nixCmd
35+ , nixCmdProc
36+ , nixCmdProc'
2737 , rawArg
38+ , runNixShellConfig
2839 , strArg
2940 ) where
3041
@@ -62,10 +73,10 @@ data Arg
6273 deriving (Eq, Show)
6374
6475strArg :: String -> String -> Arg
65−strArg k = Arg_Str k
76+strArg = Arg_Str
6677
6778rawArg :: String -> String -> Arg
68−rawArg k = Arg_Expr k
79+rawArg = Arg_Expr
6980
7081boolArg :: String -> Bool -> Arg
7182boolArg k = Arg_Expr k . bool "false" "true"
@@ -85,7 +96,7 @@ makeClassy ''NixCommonConfig
8596instance Default NixCommonConfig where
8697 def = NixCommonConfig def mempty mempty
8798
88−runNixCommonConfig :: NixCommonConfig -> [FilePath]
99+runNixCommonConfig :: NixCommonConfig -> [String]
89100runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
90101 where
91102 path = _target_path $ _nixCmdConfig_target cfg
@@ -123,7 +134,7 @@ instance HasNixCommonConfig NixBuildConfig where
123134instance Default NixBuildConfig where
124135 def = NixBuildConfig def def
125136
126−runNixBuildConfig :: NixBuildConfig -> [FilePath]
137+runNixBuildConfig :: NixBuildConfig -> [String]
127138runNixBuildConfig cfg = mconcat
128139 [ runNixCommonConfig $ cfg ^. nixCommonConfig
129140 , case _nixBuildConfig_outLink cfg of
@@ -144,12 +155,26 @@ instance HasNixCommonConfig NixInstantiateConfig where
144155instance Default NixInstantiateConfig where
145156 def = NixInstantiateConfig def False
146157
147−runNixInstantiateConfig :: NixInstantiateConfig -> [FilePath]
158+runNixInstantiateConfig :: NixInstantiateConfig -> [String]
148159runNixInstantiateConfig cfg = mconcat
149160 [ runNixCommonConfig $ cfg ^. nixCommonConfig
150161 , "--eval" <$ guard (_nixInstantiateConfig_eval cfg)
151162 ]
152163
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+
153178data NixCmd
154179 = NixCmd_Build NixBuildConfig
155180 | NixCmd_Instantiate NixInstantiateConfig
@@ -157,27 +182,43 @@ data NixCmd
157182instance Default NixCmd where
158183 def = NixCmd_Build def
159184
160−nixCmd :: MonadObelisk m => NixCmd -> m FilePath
161−nixCmd cmdCfg = withSpinner' ("Running " <> cmd <> desc) (Just $ const $ "Built " <> desc) $ do
162− output <- readProcessAndLogStderr Debug $ proc (T.unpack cmd) options
163− -- Remove final newline that Nix appends
164− Just (outPath, '\n') <- pure $ T.unsnoc output
165− pure $ T.unpack outPath
185+runNixShellConfig :: NixShellConfig -> [String]
186+runNixShellConfig cfg = mconcat
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)
166198 where
167− (cmd, options, commonCfg) = case cmdCfg of
199+ (cmd, options) = case cmdCfg of
168200 NixCmd_Build cfg' ->
169201 ( "nix-build"
170202 , runNixBuildConfig cfg'
171− , cfg' ^. nixCommonConfig
172203 )
173204 NixCmd_Instantiate cfg' ->
174205 ( "nix-instantiate"
175206 , runNixInstantiateConfig cfg'
176− , cfg' ^. nixCommonConfig
177207 )
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
178220 path = commonCfg ^. nixCmdConfig_target . target_path
179− desc = T.pack $ mconcat $ catMaybes
180− [ (" on " <>) <$> path
181− , (\a -> " [" <> a <> "]") <$> (commonCfg ^. nixCmdConfig_target . target_attr)
221+ desc = concat $ catMaybes
222+ [ (\x -> ["on", T.pack x]) <$> path
223+ , (\a -> ["[" <> T.pack a <> "]"]) <$> (commonCfg ^. nixCmdConfig_target . target_attr)
182224 ]
183−
lib/command/src/Obelisk/Command/Preprocessor.hsnew file+95
@@ -0,0 +1,95 @@
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.List (intersperse, isPrefixOf, sortOn)
9+import Data.Maybe (fromMaybe)
10+import qualified Data.Text.Lazy.Builder as TL
11+import qualified Data.Text.Lazy.Encoding as TL
12+import Distribution.Compiler (CompilerFlavor (..))
13+import Language.Haskell.Extension (Extension (..), Language(..))
14+import System.Directory (canonicalizePath)
15+import System.IO (IOMode (..), hPutStrLn, stderr, withFile)
16+import System.FilePath (hasTrailingPathSeparator, joinPath, splitPath)
17+
18+import Obelisk.Command.Run (CabalPackageInfo (..), parseCabalPackage')
19+
20+applyPackages :: FilePath -> FilePath -> FilePath -> [FilePath] -> IO ()
21+applyPackages origPath inPath outPath packagePaths' = withFile outPath WriteMode $ \outFile -> do
22+ -- This code is intended to be executed via ghci's -pgmF preprocessor option
23+ -- The command line arguments are passed in via ghc, which dictates the first three options and meanings
24+ -- In order for this code to execute, origPath must contain either a '.' character or a '/' character.
25+ -- (This is to avoid the possibility of the command line syntax conflicting with another ob command)
26+ -- We do have control over the remaining arguments, but they must be the same for all files.
27+ -- Thus, the fourth command line argument must be "apply-packages", which has already been handled.
28+ -- We assume all the remaining arguments passed in are paths to cabal or hpack package specifications.
29+ -- Thus we must select among the packagePaths for the file we are going to parse.
30+
31+ origPathCanonical <- canonicalizePath origPath
32+ packagePaths <- traverse canonicalizePath packagePaths'
33+
34+ let takeDirs = takeWhile hasTrailingPathSeparator
35+ packageDirs = sortOn (negate . length . takeDirs) $ map splitPath packagePaths
36+ origDir = splitPath origPathCanonical
37+ matches = [ joinPath d | d <- packageDirs, takeDirs d `isPrefixOf` origDir ]
38+
39+ -- So the first element of matches is going to be the deepest path to a package spec that contains
40+ -- our file as a subdirectory.
41+
42+ case matches of
43+ [] ->
44+ hPutStrLn stderr $ "Error: Unable to find cabal information for " <> origPath <> "; Skipping preprocessor."
45+ packagePath:_ -> do
46+ parseCabalPackage' packagePath >>= \case
47+ Left err ->
48+ hPutStrLn stderr $ "Error: Unable to parse cabal package " <> packagePath <> "; Skipping preprocessor on " <> origPath <> ". Error: " <> show err
49+ Right (_warnings, packageInfo) ->
50+ hPutTextBuilder outFile (generateHeader origPath packageInfo)
51+
52+ BL.readFile inPath >>= BL.hPut outFile
53+
54+ where
55+ hPutTextBuilder h = BU.hPutBuilder h . TL.encodeUtf8Builder . TL.toLazyText
56+
57+
58+ -- I'm pretty sure there's a certain amount of oversimplification in CabalPackageInfo, so I doubt this is fully robust.
59+
60+generateHeader :: FilePath -> CabalPackageInfo -> TL.Builder
61+generateHeader origPath packageInfo =
62+ hsExtensions <> ghcOptions <> lineNumberPragma origPath
63+ where
64+ hsExtensions =
65+ if not (null extList)
66+ then TL.fromText "{-# LANGUAGE "
67+ <> mconcat (intersperse (TL.fromText ", ") extList)
68+ <> TL.fromText " #-}\n"
69+ else mempty
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 _ -> []
80+ UnknownExtension ext -> [TL.fromString ext]
81+
82+ ghcOptions =
83+ if not (null optList)
84+ then TL.fromText "{-# OPTIONS_GHC "
85+ <> mconcat (intersperse (TL.fromText " ") optList)
86+ <> TL.fromText " #-}\n"
87+ else mempty
88+ optList = map TL.fromString
89+ $ filter (not . isPrefixOf "-O")
90+ $ fromMaybe []
91+ $ lookup GHC (_cabalPackageInfo_compilerOptions packageInfo)
92+
93+lineNumberPragma :: FilePath -> TL.Builder
94+lineNumberPragma origPath =
95+ TL.fromText "{-# LINE 1 \"" <> TL.fromString origPath <> TL.fromText "\" #-}\n"
lib/command/src/Obelisk/Command/Project.hs+120−53
@@ -1,31 +1,38 @@
11{-# LANGUAGE FlexibleContexts #-}
22{-# LANGUAGE LambdaCase #-}
33{-# LANGUAGE OverloadedStrings #-}
4−{-# LANGUAGE TemplateHaskell #-}
54module Obelisk.Command.Project
65 ( InitSource (..)
7− , initProject
86 , findProjectObeliskCommand
97 , findProjectRoot
10− , withProjectRoot
11− , inProjectProc
12− , inProjectShell
13− , inImpureProjectShell
14− , projectProc
15− , projectShell
16−
17− , toObeliskDir
8+ , findProjectAssets
9+ , initProject
10+ , nixShellRunConfig
11+ , nixShellRunProc
12+ , nixShellWithHoogle
13+ , nixShellWithoutPkgs
14+ , obeliskDirName
1815 , toImplDir
16+ , toObeliskDir
17+ , withProjectRoot
1918 ) where
2019
2120import Control.Concurrent.MVar (MVar, newMVar, withMVarMasked)
21+import Control.Lens ((.~), (?~), (<&>))
2222import Control.Monad
2323import Control.Monad.IO.Class (liftIO)
2424import Control.Monad.State
25+import qualified Data.Aeson as Json
2526import qualified Data.ByteString.UTF8 as BSU
2627import Data.Bits
27−import Data.Function (on)
28+import qualified Data.ByteString.Lazy as BSL
29+import Data.Default (def)
30+import Data.Function ((&), on)
31+import Data.Map (Map)
32+import Data.Text (Text)
2833import qualified Data.Text as T
34+import Data.Text.Encoding (decodeUtf8, encodeUtf8)
35+import Data.Traversable (for)
2936import System.Directory
3037import System.Environment (lookupEnv)
3138import System.FilePath
@@ -33,16 +40,16 @@ import System.IO.Temp
3340import System.IO.Unsafe (unsafePerformIO)
3441import System.Posix (FileStatus, FileMode, CMode (..), UserID, deviceID, fileID, fileMode, fileOwner, getFileStatus, getRealUserID)
3542import System.Posix.Files
36−import System.Process (waitForProcess)
37−import System.Which (staticWhich)
38−import Text.ShellEscape (Bash, bytes)
43+import Text.ShellEscape (Bash, bytes, bash)
3944
4045import GitHub.Data.GitData (Branch)
4146import GitHub.Data.Name (Name)
4247
4348import Obelisk.App (MonadObelisk)
4449import Obelisk.CliApp
50+import Obelisk.Command.Nix
4551import Obelisk.Command.Thunk
52+import Obelisk.Command.Utils (nixBuildExePath, nixExePath, toNixPath)
4653
4754--TODO: Make this module resilient to random exceptions
4855
@@ -66,9 +73,12 @@ data InitSource
6673 | InitSource_Symlink FilePath
6774 deriving Show
6875
76+obeliskDirName :: FilePath
77+obeliskDirName = ".obelisk"
78+
6979-- | Path to obelisk directory in given path
7080toObeliskDir :: FilePath -> FilePath
71−toObeliskDir p = p </> ".obelisk"
81+toObeliskDir p = p </> obeliskDirName
7282
7383-- | Path to impl file in given path
7484toImplDir :: FilePath -> FilePath
@@ -85,16 +95,22 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
8595 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
8696 skeleton <- withSpinner "Setting up obelisk" $ do
8797 liftIO $ createDirectory obDir
98+ -- Clone the git source and repack it with the init source obelisk
99+ -- The purpose of this is to ensure we use the correct thunk spec.
100+ let cloneAndRepack src = do
101+ putLog Debug $ "Cloning obelisk into " <> T.pack implDir <> " and repacking using itself"
102+ commit <- getLatestRev src
103+ gitCloneForThunkUnpack (thunkSourceToGitSource src) (_thunkRev_commit commit) implDir
104+ callHandoffOb implDir ["thunk", "pack", implDir]
88105 case source of
89− InitSource_Default -> createThunkWithLatest implDir obeliskSource
90− InitSource_Branch branch -> createThunkWithLatest implDir $ obeliskSourceWithBranch branch
106+ InitSource_Default -> cloneAndRepack obeliskSource
107+ InitSource_Branch branch -> cloneAndRepack $ obeliskSourceWithBranch branch
91108 InitSource_Symlink path -> do
92109 let symlinkPath = if isAbsolute path
93110 then path
94111 else ".." </> path
95112 liftIO $ createSymbolicLink symlinkPath implDir
96113 _ <- nixBuildAttrWithCache implDir "command"
97− --TODO: We should probably handoff to the impl here
98114 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
99115
100116 callProcessAndLogOutput (Notice, Error) $
@@ -120,6 +136,24 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
120136 createDirectoryIfMissing False configDir
121137 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
122138
139+callHandoffOb
140+ :: MonadObelisk m
141+ => FilePath -- ^ Directory of the obelisk we want to handoff to
142+ -> [String] -- ^ Arguments to pass to ob
143+ -> m ()
144+callHandoffOb dir args = do
145+ obeliskCommandPkg <- nixCmd $ NixCmd_Build $ def
146+ & nixBuildConfig_outLink .~ OutLink_None
147+ & nixCmdConfig_target .~ Target
148+ { _target_path = Just dir
149+ , _target_attr = Just "command"
150+ , _target_expr = Nothing
151+ }
152+ let impl = obeliskCommandPkg </> "bin" </> "ob"
153+ -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
154+ putLog Debug $ "Running '" <> T.pack (unwords args) <> "' with " <> T.pack impl
155+ callProcessAndLogOutput (Debug, Warning) (proc impl ("--no-handoff" : args))
156+
123157--TODO: Allow the user to ignore our security concerns
124158-- | Find the Obelisk implementation for the project at the given path
125159findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
@@ -175,7 +209,7 @@ findProjectRoot target = do
175209 targetStat <- liftIO $ getFileStatus target
176210 umask <- liftIO getUmask
177211 (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat umask myUid) []
178− return result
212+ return $ makeRelative "." <$> result
179213
180214withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
181215withProjectRoot target f = findProjectRoot target >>= \case
@@ -238,42 +272,75 @@ filePermissionIsSafe s umask = not fileWorldWritable && fileGroupWritable <= uma
238272 fileGroupWritable = fileMode s .&. 0o020 == 0o020
239273 umaskGroupWritable = umask .&. 0o020 == 0
240274
241−inProjectProc :: MonadObelisk m => String -> [Bash] -> m ()
242−inProjectProc shellName command = withProjectRoot "." $ \root ->
243− projectProc root True shellName (Just command)
275+nixShellRunConfig :: MonadObelisk m => FilePath -> Bool -> Maybe [Bash] -> m NixShellConfig
276+nixShellRunConfig root isPure command = do
277+ nixpkgsPath <- fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $
278+ proc nixExePath ["eval", "(import .obelisk/impl {}).nixpkgs.path"]
279+ nixRemote <- liftIO $ lookupEnv "NIX_REMOTE"
280+ pure $ def
281+ & nixShellConfig_pure .~ isPure
282+ & nixShellConfig_common . nixCmdConfig_target .~ (def & target_path .~ Nothing)
283+ & nixShellConfig_run .~ (command <&> \cs -> unwords $ concat
284+ [ ["export", BSU.toString . bytes . bash $ "NIX_PATH=nixpkgs=" <> encodeUtf8 nixpkgsPath, ";"]
285+ , maybe [] (\v -> ["export", BSU.toString . bytes . bash $ "NIX_REMOTE=" <> encodeUtf8 (T.pack v), ";"]) nixRemote
286+ , fmap (BSU.toString . bytes) cs
287+ ])
244288
245−-- | Run a command in the given shell for the current project
246−inProjectShell :: MonadObelisk m => String -> String -> m ()
247−inProjectShell shellName command = withProjectRoot "." $ \root ->
248− projectShell root True shellName (Just command)
289+nixShellRunProc :: NixShellConfig -> ProcessSpec
290+nixShellRunProc cfg = setDelegateCtlc True $ proc "nix-shell" $ runNixShellConfig cfg
249291
250−inImpureProjectShell :: MonadObelisk m => String -> String -> m ()
251−inImpureProjectShell shellName command = withProjectRoot "." $ \root ->
252− projectShell root False shellName (Just command)
292+nixShellWithoutPkgs
293+ :: MonadObelisk m
294+ => FilePath -- ^ Path to project root
295+ -> Bool -- ^ Should this be a pure shell?
296+ -> Bool -- ^ Should we chdir to the package root in the shell?
297+ -> Map Text FilePath -- ^ Package names mapped to their paths
298+ -> String -- ^ Shell attribute to use (e.g. @"ghc"@, @"ghcjs"@, etc.)
299+ -> Maybe [Bash] -- ^ If 'Just' run the given command; otherwise just open the interactive shell
300+ -> m ()
301+nixShellWithoutPkgs root isPure chdirToRoot packageNamesAndPaths shellAttr command = do
302+ packageNamesAndAbsPaths <- liftIO $ for packageNamesAndPaths makeAbsolute
303+ defShellConfig <- nixShellRunConfig root isPure command
304+ let setCwd_ = if chdirToRoot then setCwd (Just root) else id
305+ (_, _, _, ph) <- createProcess_ "nixShellWithoutPkgs" $ setCwd_ $ nixShellRunProc $ defShellConfig
306+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
307+ "{root, pkgs, shell}: ((import root {}).passthru.__unstable__.self.extend (_: _: {\
308+ \shellPackages = builtins.fromJSON pkgs;\
309+ \})).project.shells.${shell}"
310+ & nixShellConfig_common . nixCmdConfig_args .~
311+ [ rawArg "root" $ toNixPath $ if chdirToRoot then "." else root
312+ , strArg "pkgs" (T.unpack $ decodeUtf8 $ BSL.toStrict $ Json.encode packageNamesAndAbsPaths)
313+ , strArg "shell" shellAttr
314+ ]
315+ void $ waitForProcess ph
253316
254−projectProc :: MonadObelisk m => FilePath -> Bool -> String -> Maybe [Bash] -> m ()
255−projectProc root isPure shellName command =
256− projectShell root isPure shellName $ commandToString <$> command
257− where
258− commandToString = unwords . fmap (BSU.toString . bytes)
317+nixShellWithHoogle :: MonadObelisk m => FilePath -> Bool -> String -> Maybe [Bash] -> m ()
318+nixShellWithHoogle root isPure shell' command = do
319+ defShellConfig <- nixShellRunConfig root isPure command
320+ (_, _, _, ph) <- createProcess_ "nixShellWithHoogle" $ setCwd (Just root) $ nixShellRunProc $ defShellConfig
321+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
322+ "{shell}: ((import ./. {}).passthru.__unstable__.self.extend (_: super: {\
323+ \userSettings = super.userSettings // { withHoogle = true; };\
324+ \})).project.shells.${shell}"
325+ & nixShellConfig_common . nixCmdConfig_args .~ [ strArg "shell" shell' ]
326+ void $ waitForProcess ph
259327
260−projectShell :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
261−projectShell root isPure shellName command = do
262− let nixPath = $(staticWhich "nix")
263− nixpkgsPath <- fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $ proc nixPath ["eval", "(import .obelisk/impl {}).nixpkgs.path"]
264− nixRemote <- liftIO $ lookupEnv "NIX_REMOTE"
265− (_, _, _, ph) <- createProcess_ "runNixShellAttr" $ setDelegateCtlc True $ setCwd (Just root) $ proc "nix-shell" $
266− [ "default.nix"] <>
267− ["--pure" | isPure] <>
268− [ "-A"
269− , "shells." <> shellName
270− ] <> case command of
271− Nothing -> []
272− Just c ->
273− -- TODO: Escape nixpkgsPath and nixRemote
274− [ "--run"
275− , "export NIX_PATH=nixpkgs=" <> T.unpack nixpkgsPath <> "; " <>
276− maybe "" (\v -> "export NIX_REMOTE=" <> v <> "; ") nixRemote <>
277− c
328+findProjectAssets :: MonadObelisk m => FilePath -> m Text
329+findProjectAssets root = do
330+ isDerivation <- readProcessAndLogStderr Debug $ setCwd (Just root) $
331+ proc nixExePath
332+ [ "eval"
333+ , "(let a = import ./. {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
334+ , "--raw"
335+ -- `--raw` is not available with old nix-instantiate. It drops quotation
336+ -- marks and trailing newline, so is very convenient for shelling out.
337+ ]
338+ -- Check whether the impure static files are a derivation (and so must be built)
339+ if isDerivation == "1"
340+ then fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $ -- Strip whitespace here because nix-build has no --raw option
341+ proc nixBuildExePath
342+ [ "--no-out-link"
343+ , "-E", "(import ./. {}).passthru.staticFilesImpure"
278344 ]
279− void $ liftIO $ waitForProcess ph
345+ else readProcessAndLogStderr Debug $ setCwd (Just root) $
346+ proc nixExePath ["eval", "-f", ".", "passthru.staticFilesImpure", "--raw"]
lib/command/src/Obelisk/Command/Run.hs+430−151
@@ -1,51 +1,92 @@
1+{-# LANGUAGE DeriveFoldable #-}
2+{-# LANGUAGE DeriveFunctor #-}
3+{-# LANGUAGE DeriveTraversable #-}
14{-# LANGUAGE FlexibleContexts #-}
25{-# LANGUAGE LambdaCase #-}
36{-# LANGUAGE MultiParamTypeClasses #-}
47{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE QuasiQuotes #-}
59{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE TemplateHaskell #-}
710{-# LANGUAGE TupleSections #-}
11+{-# LANGUAGE ViewPatterns #-}
812module Obelisk.Command.Run where
913
10−import Control.Applicative (liftA2)
14+import Control.Arrow ((&&&))
1115import Control.Exception (Exception, bracket)
12−import Control.Monad
16+import Control.Lens (ifor, (.~), (&))
17+import Control.Monad (filterM, unless, void)
1318import Control.Monad.Except (runExceptT, throwError)
1419import Control.Monad.IO.Class (liftIO)
1520import Control.Monad.Reader (MonadIO)
21+import Data.Bifoldable (bifoldr1)
22+import Data.Bifunctor (bimap)
1623import qualified Data.ByteString.UTF8 as BSU
17−import Data.Either
18−import Data.Foldable (for_)
19−import qualified Data.List as L
24+import Data.Coerce (coerce)
25+import Data.Default (def)
26+import Data.Either (partitionEithers)
27+import Data.Foldable (fold, for_, toList)
28+import Data.Functor.Identity (runIdentity)
29+import Data.List.NonEmpty (NonEmpty)
2030import qualified Data.List.NonEmpty as NE
31+import Data.Map (Map)
32+import qualified Data.Map as Map
33+import qualified Data.Map.Monoidal as MMap
2134import Data.Maybe
35+import Data.Set (Set)
36+import qualified Data.Set as Set
37+import Data.String.Here.Interpolated (i)
38+import Data.Text (Text)
2239import qualified Data.Text as T
40+import Data.Time.Clock (getCurrentTime)
41+import Data.Time.Format (formatTime, defaultTimeLocale)
42+import Data.Traversable (for)
43+import Debug.Trace (trace)
2344import Distribution.Compiler (CompilerFlavor(..))
2445import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
2546import Distribution.Parsec.ParseResult (runParseResult)
26−import Distribution.Pretty
47+import qualified Distribution.System as Dist
2748import Distribution.Types.BuildInfo
2849import Distribution.Types.CondTree
2950import Distribution.Types.GenericPackageDescription
3051import Distribution.Types.Library
3152import Distribution.Utils.Generic
53+import qualified Distribution.Parsec.Common as Dist
3254import qualified Hpack.Config as Hpack
3355import qualified Hpack.Render as Hpack
3456import qualified Hpack.Yaml as Hpack
3557import Language.Haskell.Extension
3658import Network.Socket hiding (Debug)
3759import System.Directory
60+import System.Environment (getExecutablePath)
3861import System.FilePath
62+import qualified System.Info
3963import System.IO.Temp (withSystemTempDirectory)
40−import System.Which (staticWhich)
41−import Text.ShellEscape (bash, bytes)
64+import Text.ShellEscape (Bash, bash)
4265
43−import Obelisk.App (MonadObelisk, ObeliskT)
44−import Obelisk.CliApp (Severity (..) , callCommand, failWith, putLog, proc, readProcessAndLogStderr)
45−import Obelisk.Command.Project (inProjectProc, withProjectRoot)
66+import Obelisk.App (MonadObelisk)
67+import Obelisk.CliApp (
68+ Severity (..),
69+ createProcess_,
70+ failWith,
71+ proc,
72+ putLog,
73+ readCreateProcessWithExitCode,
74+ readProcessAndLogStderr,
75+ setCwd,
76+ setDelegateCtlc,
77+ waitForProcess,
78+ withSpinner,
79+ )
80+import Obelisk.Command.Nix
81+import Obelisk.Command.Project (nixShellWithoutPkgs, withProjectRoot, findProjectAssets)
82+import Obelisk.Command.Thunk (attrCacheFileName)
83+import Obelisk.Command.Utils (findExePath, ghcidExePath)
4684
4785data CabalPackageInfo = CabalPackageInfo
48− { _cabalPackageInfo_packageRoot :: FilePath
86+ { _cabalPackageInfo_packageFile :: FilePath
87+ , _cabalPackageInfo_packageName :: T.Text
88+ , _cabalPackageInfo_packageRoot :: FilePath
89+ , _cabalPackageInfo_buildable :: Bool
4990 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
5091 -- ^ List of hs src dirs of the library component
5192 , _cabalPackageInfo_defaultExtensions :: [Extension]
@@ -56,108 +97,257 @@ data CabalPackageInfo = CabalPackageInfo
5697 -- ^ List of compiler-specific options (e.g., the "ghc-options" field of the cabal file)
5798 }
5899
59−-- NOTE: `run` is not polymorphic like the rest because we use StaticPtr to invoke it.
60−run :: ObeliskT IO ()
61−run = do
62− let nixPath = $(staticWhich "nix")
63− nixBuildPath = $(staticWhich "nix-build")
64− pkgs <- getLocalPkgs
100+-- | 'Bool' with a better name for it's purpose.
101+data Interpret = Interpret_Interpret | Interpret_NoInterpret deriving (Eq, Ord, Show)
102+
103+textInterpret :: Interpret -> Text
104+textInterpret = \case
105+ Interpret_Interpret -> "Interpret"
106+ Interpret_NoInterpret -> "NoInterpret"
107+
108+-- | Describe a set of 'FilePath's as a tree to facilitate merging them in a convenient way.
109+data PathTree a = PathTree_Node
110+ (Maybe a) -- An optional leaf at this point in the tree
111+ (Map FilePath (PathTree a)) -- Branches to deeper leaves
112+ deriving (Eq, Ord, Show, Functor, Foldable, Traversable)
113+
114+emptyPathTree :: PathTree a
115+emptyPathTree = PathTree_Node Nothing mempty
116+
117+-- | 2D ASCII drawing of a 'PathTree'. Adapted from Data.Tree.draw.
118+drawPathTree :: (a -> Text) -> PathTree a -> Text
119+drawPathTree showA (PathTree_Node _ ts0) = T.intercalate "\n" $ goForest (Map.toList ts0)
120+ where
121+ annotated ma = maybe id (\a b -> b <> " [" <> showA a <> "]") ma . T.pack
122+ goTree (fp, PathTree_Node ma forest) = annotated ma fp : goForest (Map.toList forest)
123+ goForest [] = []
124+ goForest [tree] = shift "└─ " " " (goTree tree)
125+ goForest (tree:forest) = shift "├─ " "│ " (goTree tree) <> goForest forest
126+ shift first other = zipWith (<>) (first : repeat other)
127+
128+-- | Used to signal to obelisk that it's being invoked as a preprocessor
129+preprocessorIdentifier :: String
130+preprocessorIdentifier = "__preprocessor-apply-packages"
131+
132+profile
133+ :: MonadObelisk m
134+ => String
135+ -> [String]
136+ -> m ()
137+profile profileBasePattern rtsFlags = withProjectRoot "." $ \root -> do
138+ putLog Debug "Using profiled build of project."
139+
140+ outPath <- withSpinner "Building profiled executable" $
141+ fmap (T.unpack . T.strip) $ readProcessAndLogStderr Debug $ setCwd (Just root) $ nixCmdProc $
142+ NixCmd_Build $ def
143+ & nixBuildConfig_outLink .~ OutLink_None
144+ & nixCmdConfig_target .~ Target
145+ { _target_path = Just "."
146+ , _target_attr = Just "__unstable__.profiledObRun"
147+ , _target_expr = Nothing
148+ }
149+ assets <- findProjectAssets root
150+ putLog Debug $ "Assets impurely loaded from: " <> assets
151+ time <- liftIO getCurrentTime
152+ let profileBaseName = formatTime defaultTimeLocale profileBasePattern time
153+ liftIO $ createDirectoryIfMissing True $ takeDirectory $ root </> profileBaseName
154+ putLog Debug $ "Storing profiled data under base name of " <> T.pack (root </> profileBaseName)
155+ freePort <- getFreePort
156+ (_, _, _, ph) <- createProcess_ "runProfExe" $ setCwd (Just root) $ setDelegateCtlc True $ proc (outPath </> "bin" </> "ob-run") $
157+ [ show freePort
158+ , T.unpack assets
159+ , profileBaseName
160+ , "+RTS"
161+ , "-po" <> profileBaseName
162+ ] <> rtsFlags
163+ <> [ "-RTS" ]
164+ void $ waitForProcess ph
165+
166+run :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
167+run root interpretPaths = do
168+ pkgs <- getParsedLocalPkgs root interpretPaths
65169 withGhciScript pkgs $ \dotGhciPath -> do
66− freePort <- getFreePort
67− assets <- withProjectRoot "." $ \root -> do
68− let importableRoot = if "/" `isInfixOf` root
69− then root
70− else "./" <> root
71− isDerivation <- readProcessAndLogStderr Debug $
72− proc nixPath
73− [ "eval"
74− , "-f"
75− , root
76− , "(let a = import " <> importableRoot <> " {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
77− , "--raw"
78− -- `--raw` is not available with old nix-instantiate. It drops quotation
79− -- marks and trailing newline, so is very convenient for shelling out.
80− ]
81− -- Check whether the impure static files are a derivation (and so must be built)
82− if isDerivation == "1"
83− then fmap T.strip $ readProcessAndLogStderr Debug $ -- Strip whitespace here because nix-build has no --raw option
84− proc nixBuildPath
85− [ "--no-out-link"
86− , "-E", "(import " <> importableRoot <> "{}).passthru.staticFilesImpure"
87− ]
88− else readProcessAndLogStderr Debug $
89− proc nixPath ["eval", "-f", root, "passthru.staticFilesImpure", "--raw"]
170+ assets <- findProjectAssets root
90171 putLog Debug $ "Assets impurely loaded from: " <> assets
91− runGhcid dotGhciPath $ Just $ unwords
172+ ghciArgs <- getGhciSessionSettings pkgs root True
173+ freePort <- getFreePort
174+ runGhcid root True (ghciArgs <> mkGhciScriptArg dotGhciPath) pkgs $ Just $ unwords
92175 [ "Obelisk.Run.run"
93176 , show freePort
94− , "(runServeAsset " ++ show assets ++ ")"
177+ , "(Obelisk.Run.runServeAsset " ++ show assets ++ ")"
95178 , "Backend.backend"
96179 , "Frontend.frontend"
97180 ]
98181
99−runRepl :: MonadObelisk m => m ()
100−runRepl = do
101− pkgs <- getLocalPkgs
102− withGhciScript pkgs $ \dotGhciPath -> do
103− runGhciRepl dotGhciPath
182+runRepl :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
183+runRepl root interpretPaths = do
184+ pkgs <- getParsedLocalPkgs root interpretPaths
185+ ghciArgs <- getGhciSessionSettings pkgs "." True
186+ withGhciScript pkgs $ \dotGhciPath ->
187+ runGhciRepl root pkgs (ghciArgs <> mkGhciScriptArg dotGhciPath)
104188
105−runWatch :: MonadObelisk m => m ()
106−runWatch = do
107− pkgs <- getLocalPkgs
108− withGhciScript pkgs $ \dotGhciPath -> runGhcid dotGhciPath Nothing
189+runWatch :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
190+runWatch root interpretPaths = do
191+ pkgs <- getParsedLocalPkgs root interpretPaths
192+ ghciArgs <- getGhciSessionSettings pkgs root True
193+ withGhciScript pkgs $ \dotGhciPath ->
194+ runGhcid root True (ghciArgs <> mkGhciScriptArg dotGhciPath) pkgs Nothing
195+
196+exportGhciConfig :: MonadObelisk m => Bool -> FilePath -> PathTree Interpret -> m [String]
197+exportGhciConfig useRelativePaths root interpretPaths = do
198+ pkgs <- getParsedLocalPkgs root interpretPaths
199+ getGhciSessionSettings pkgs "." useRelativePaths
200+
201+nixShellForInterpretPaths :: MonadObelisk m => Bool -> String -> FilePath -> PathTree Interpret -> Maybe [Bash] -> m ()
202+nixShellForInterpretPaths isPure shell root interpretPaths cmd = do
203+ pkgs <- getParsedLocalPkgs root interpretPaths
204+ nixShellWithoutPkgs root isPure False (packageInfoToNamePathMap pkgs) shell cmd
205+
206+-- | Like 'getLocalPkgs' but also parses them and fails if any of them can't be parsed.
207+getParsedLocalPkgs :: MonadObelisk m => FilePath -> PathTree Interpret -> m (NonEmpty CabalPackageInfo)
208+getParsedLocalPkgs root interpretPaths = parsePackagesOrFail =<< getLocalPkgs root interpretPaths
209+
210+-- | Relative paths to local packages of an obelisk project.
211+--
212+-- These are a combination of the obelisk predefined local packages,
213+-- and any packages that the user has set with the @packages@ argument
214+-- to the Nix @project@ function.
215+getLocalPkgs :: forall m. MonadObelisk m => FilePath -> PathTree Interpret -> m (Set FilePath)
216+getLocalPkgs root interpretPaths = do
217+ putLog Debug $ [i|Finding packages with root ${root} and interpret paths:|] <> "\n" <> drawPathTree textInterpret interpretPaths
218+ obeliskPackagePaths <- runFind ["-L", root, "-name", ".obelisk", "-type", "d"]
219+
220+ -- We do not want to find packages that are embedded inside other obelisk projects, unless that
221+ -- obelisk project is our own.
222+ obeliskPackageExclusions <- liftIO $ fmap Set.fromList $ traverse canonicalizePath $
223+ filter (/= root) $ map takeDirectory obeliskPackagePaths
224+ putLog Debug [i|Excluding obelisk packages: ${T.pack $ unwords $ Set.toList obeliskPackageExclusions}|]
225+ let rootsAndExclusions = calcIntepretFinds "" interpretPaths
226+
227+ fmap fold $ for (MMap.toAscList rootsAndExclusions) $ \(interpretPathRoot, exclusions) ->
228+ let allExclusions = obeliskPackageExclusions <> exclusions <> Set.singleton ("*" </> attrCacheFileName)
229+ in fmap (Set.fromList . map normalise) $ runFind $
230+ ["-L", interpretPathRoot, "(", "-name", "*.cabal", "-o", "-name", Hpack.packageConfig, ")", "-a", "-type", "f"]
231+ <> concat [["-not", "-path", p </> "*"] | p <- toList allExclusions]
232+ where
233+ runFind args = do
234+ (_exitCode, out, err) <- readCreateProcessWithExitCode $ proc findExePath args
235+ putLog Debug $ T.strip $ T.pack err
236+ pure $ map T.unpack $ T.lines $ T.strip $ T.pack out
237+
238+-- | Calculates a set of root 'FilePath's along with each one's corresponding set of exclusions.
239+-- This is used when constructing a set of @find@ commands to run to produce a set of packages
240+-- that matches the user's @--interpret@/@--no-interpret@ settings.
241+calcIntepretFinds :: FilePath -> PathTree Interpret -> MMap.MonoidalMap FilePath (Set FilePath)
242+calcIntepretFinds treeRoot0 tree0 = runIdentity $ go treeRoot0 tree0
243+ where
244+ go treeRoot tree = foldPathTreeFor (== Interpret_Interpret) treeRoot tree $ \parent children -> do
245+ exclusions <- foldPathTreeFor (== Interpret_NoInterpret) parent children $ \parent' children' ->
246+ pure $ Map.singleton parent' children'
247+ deeperFinds <- Map.traverseWithKey go exclusions
248+ pure $ MMap.singleton parent (Map.keysSet exclusions) <> fold (MMap.MonoidalMap deeperFinds)
249+
250+-- | Traverses a 'PathTree' and folds all leaves matching a given predicate.
251+foldPathTreeFor
252+ :: forall m a b. (Applicative m, Monoid b)
253+ => (a -> Bool)
254+ -> FilePath
255+ -> PathTree a
256+ -> (FilePath -> PathTree a -> m b)
257+ -> m b
258+foldPathTreeFor predicate parent children f = case children of
259+ PathTree_Node (Just x) children' | predicate x -> f parent (PathTree_Node Nothing children')
260+ PathTree_Node _ children' -> fmap fold $ flip Map.traverseWithKey children' $ \k children'' ->
261+ foldPathTreeFor predicate (parent </> k) children'' f
109262
110263data GuessPackageFileError = GuessPackageFileError_Ambiguous [FilePath] | GuessPackageFileError_NotFound
111264 deriving (Eq, Ord, Show)
112265instance Exception GuessPackageFileError
113266
267+newtype HPackFilePath = HPackFilePath { unHPackFilePath :: FilePath } deriving (Eq, Ord, Show)
268+newtype CabalFilePath = CabalFilePath { unCabalFilePath :: FilePath } deriving (Eq, Ord, Show)
269+
114270-- | Given a directory, try to guess what the appropriate @.cabal@ or @package.yaml@ file is for the package.
115271guessCabalPackageFile
116− :: MonadIO m
117− => FilePath -- ^ Directory to search for cabal package
118− -> m (Either GuessPackageFileError (Either FilePath FilePath))
119− -- ^ 'Right' 'Left' for hpack package, 'Right' 'Right' for cabal package; 'FilePath' is relative to given directory.
120−guessCabalPackageFile dir = do
121− candidates <- liftIO $
122− filterM (doesFileExist . (dir </>))
123− =<< filter (liftA2 (||) (== Hpack.packageConfig) (".cabal" `L.isSuffixOf`))
124− <$> listDirectory dir
125− pure $ case L.partition (== Hpack.packageConfig) candidates of
126− ([hpack], _) -> Right $ Left hpack
127− ([], [cabal]) -> Right $ Right cabal
128− ([], []) -> Left GuessPackageFileError_NotFound
129− (hpacks, cabals) -> Left $ GuessPackageFileError_Ambiguous $ hpacks <> cabals
130−
131−-- | Relative paths to local packages of an obelisk project
132−-- TODO a way to query this
133−getLocalPkgs :: Applicative f => f [FilePath]
134−getLocalPkgs = pure ["backend", "common", "frontend"]
272+ :: (MonadIO m)
273+ => FilePath -- ^ Directory or path to search for cabal package
274+ -> m (Either GuessPackageFileError (Either CabalFilePath HPackFilePath))
275+guessCabalPackageFile pkg = do
276+ liftIO (doesDirectoryExist pkg) >>= \case
277+ False -> case cabalOrHpackFile pkg of
278+ (Just hpack@(Right _)) -> pure $ Right hpack
279+ (Just cabal@(Left (CabalFilePath cabalFilePath))) -> do
280+ -- If the cabal file has a sibling hpack file, we use that instead
281+ -- since running hpack often generates a sibling cabal file
282+ let possibleHpackSibling = takeDirectory cabalFilePath </> Hpack.packageConfig
283+ hasHpackSibling <- liftIO $ doesFileExist possibleHpackSibling
284+ pure $ Right $ if hasHpackSibling then Right (HPackFilePath possibleHpackSibling) else cabal
285+ Nothing -> pure $ Left GuessPackageFileError_NotFound
286+ True -> do
287+ candidates <- liftIO $
288+ filterM (doesFileExist . either unCabalFilePath unHPackFilePath)
289+ =<< mapMaybe (cabalOrHpackFile . (pkg </>)) <$> listDirectory pkg
290+ pure $ case partitionEithers candidates of
291+ ([hpack], _) -> Right $ Left hpack
292+ ([], [cabal]) -> Right $ Right cabal
293+ ([], []) -> Left GuessPackageFileError_NotFound
294+ (hpacks, cabals) -> Left $ GuessPackageFileError_Ambiguous $ coerce hpacks <> coerce cabals
135295
296+cabalOrHpackFile :: FilePath -> Maybe (Either CabalFilePath HPackFilePath)
297+cabalOrHpackFile = \case
298+ x | takeExtension x == ".cabal" -> Just (Left $ CabalFilePath x)
299+ | takeFileName x == Hpack.packageConfig -> Just (Right $ HPackFilePath x)
300+ | otherwise -> Nothing
301+
302+-- | Parses the cabal package in a given directory.
303+-- This automatically figures out which .cabal file or package.yaml (hpack) file to use in the given directory.
136304parseCabalPackage
137− :: (MonadObelisk m)
138− => FilePath -- ^ package directory
305+ :: MonadObelisk m
306+ => FilePath -- ^ Package directory
139307 -> m (Maybe CabalPackageInfo)
140−parseCabalPackage dir = either ((Nothing <$) . putLog Error) (pure . Just) <=< runExceptT $ do
141− (cabalContents, packageFile) <- guessCabalPackageFile dir >>= \case
142− Left GuessPackageFileError_NotFound -> throwError $ "No .cabal or package.yaml file found in " <> T.pack dir
143− Left (GuessPackageFileError_Ambiguous _) -> throwError $ "Unable to determine which .cabal file to use in " <> T.pack dir
144− Right (Right cabalFileName) -> let file = dir </> cabalFileName in (, file) <$> liftIO (readUTF8File file)
145− Right (Left hpackFileName) -> do
308+parseCabalPackage dir = parseCabalPackage' dir >>= \case
309+ Left err -> Nothing <$ putLog Error err
310+ Right (warnings, pkgInfo) -> do
311+ for_ warnings $ putLog Warning . T.pack . show
312+ pure $ Just pkgInfo
313+
314+-- | Like 'parseCabalPackage' but returns errors and warnings directly so as to avoid 'MonadObelisk'.
315+parseCabalPackage'
316+ :: (MonadIO m)
317+ => FilePath -- ^ Package directory
318+ -> m (Either T.Text ([Dist.PWarning], CabalPackageInfo))
319+parseCabalPackage' pkg = runExceptT $ do
320+ (cabalContents, packageFile, packageName) <- guessCabalPackageFile pkg >>= \case
321+ Left GuessPackageFileError_NotFound -> throwError $ "No .cabal or package.yaml file found in " <> T.pack pkg
322+ Left (GuessPackageFileError_Ambiguous _) -> throwError $ "Unable to determine which .cabal file to use in " <> T.pack pkg
323+ Right (Left (CabalFilePath file)) -> (, file, takeBaseName file) <$> liftIO (readUTF8File file)
324+ Right (Right (HPackFilePath file)) -> do
146325 let
147− file = dir </> hpackFileName
148326 decodeOptions = Hpack.DecodeOptions (Hpack.ProgramName "ob") file Nothing Hpack.decodeYaml
149327 liftIO (Hpack.readPackageConfig decodeOptions) >>= \case
150328 Left err -> throwError $ T.pack $ "Failed to parse " <> file <> ": " <> err
151− Right (Hpack.DecodeResult hpackPackage _ _ _) -> pure (Hpack.renderPackage [] hpackPackage, file)
329+ Right (Hpack.DecodeResult hpackPackage _ _ _) -> pure (Hpack.renderPackage [] hpackPackage, file, Hpack.packageName hpackPackage)
152330
153− let (warnings, result) = runParseResult $ parseGenericPackageDescription $
154− toUTF8BS cabalContents
155− for_ warnings $ putLog Warning . T.pack . show
331+ let
332+ (warnings, result) = runParseResult $ parseGenericPackageDescription $ toUTF8BS cabalContents
333+ osConfVar = case System.Info.os of
334+ "linux" -> Just Dist.Linux
335+ "darwin" -> Just Dist.OSX
336+ _ -> trace "Unrecgonized System.Info.os" Nothing
337+ archConfVar = Just Dist.X86_64 -- TODO: Actually infer this
338+ evalConfVar v = Right $ case v of
339+ OS osVar -> Just osVar == osConfVar
340+ Arch archVar -> Just archVar == archConfVar
341+ Impl GHC _ -> True -- TODO: Actually check version range
342+ _ -> False
156343 case condLibrary <$> result of
157344 Right (Just condLib) -> do
158− let (_, lib) = simplifyCondTree (const $ pure True) condLib
159− pure $ CabalPackageInfo
160− { _cabalPackageInfo_packageRoot = dir
345+ let (_, lib) = simplifyCondTree evalConfVar condLib
346+ pure $ (warnings,) $ CabalPackageInfo
347+ { _cabalPackageInfo_packageName = T.pack packageName
348+ , _cabalPackageInfo_packageFile = packageFile
349+ , _cabalPackageInfo_packageRoot = takeDirectory packageFile
350+ , _cabalPackageInfo_buildable = buildable $ libBuildInfo lib
161351 , _cabalPackageInfo_sourceDirs =
162352 fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
163353 , _cabalPackageInfo_defaultExtensions =
@@ -170,89 +360,144 @@ parseCabalPackage dir = either ((Nothing <$) . putLog Error) (pure . Just) <=< r
170360 Left (_, errors) ->
171361 throwError $ T.pack $ "Failed to parse " <> packageFile <> ":\n" <> unlines (map show errors)
172362
363+parsePackagesOrFail :: (MonadObelisk m, Foldable f) => f FilePath -> m (NE.NonEmpty CabalPackageInfo)
364+parsePackagesOrFail dirs' = do
365+ (pkgDirErrs, packageInfos') <- fmap partitionEithers $ for dirs $ \dir -> do
366+ flip fmap (parseCabalPackage dir) $ \case
367+ Just packageInfo
368+ | _cabalPackageInfo_buildable packageInfo -> Right packageInfo
369+ _ -> Left dir
370+
371+ -- Sort duplicate packages such that we prefer shorter paths, but fall back to alphabetical ordering.
372+ let packagesByName = Map.map (NE.sortBy $ comparing $ \p -> let n = _cabalPackageInfo_packageFile p in (length n, n))
373+ $ Map.fromListWith (<>) [(_cabalPackageInfo_packageName p, p NE.:| []) | p <- packageInfos']
374+ unambiguous <- ifor packagesByName $ \packageName ps -> case ps of
375+ p NE.:| [] -> pure p -- No ambiguity here
376+ p NE.:| _ -> do
377+ let chosenText = " [Chosen] "
378+ prefix p'
379+ | _cabalPackageInfo_packageFile p' == _cabalPackageInfo_packageFile p = chosenText
380+ | otherwise = T.map (const ' ') chosenText
381+ putLog Warning $ T.unlines $
382+ "Packages named '" <> packageName <> "' appear in " <> T.pack (show $ length ps) <> " different locations: "
383+ : map (\p' -> prefix p' <> T.pack (_cabalPackageInfo_packageFile p')) (toList ps)
384+ pure p
385+
386+ packageInfos <- case NE.nonEmpty $ toList unambiguous of
387+ Nothing -> failWith $ T.pack $
388+ "No valid, buildable packages found" <> (if null dirs then "" else " in " <> intercalate ", " dirs)
389+ Just xs -> pure xs
390+
391+ unless (null pkgDirErrs) $
392+ putLog Warning $ T.pack $ "Failed to find buildable packages in " <> intercalate ", " pkgDirErrs
393+
394+ pure packageInfos
395+ where
396+ dirs = toList dirs'
397+
398+packageInfoToNamePathMap :: Foldable f => f CabalPackageInfo -> Map Text FilePath
399+packageInfoToNamePathMap = Map.fromList . map (_cabalPackageInfo_packageName &&& _cabalPackageInfo_packageRoot) . toList
400+
173401-- | Create ghci configuration to load the given packages
174402withGhciScript
175− :: MonadObelisk m
176− => [FilePath] -- ^ List of packages to load into ghci
403+ :: (MonadObelisk m, Foldable f)
404+ => f CabalPackageInfo -- ^ List of packages to load into ghci
177405 -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporary .ghci
178406 -> m ()
179−withGhciScript dirs f = do
180− (pkgDirErrs, packageInfos) <- fmap partitionEithers $ forM dirs $ \dir -> do
181− flip fmap (parseCabalPackage dir) $ \case
182− Nothing -> Left dir
183− Just packageInfo -> Right packageInfo
184−
185− when (null packageInfos) $
186− failWith $ T.pack $ "No valid pkgs found in " <> intercalate ", " dirs
187− unless (null pkgDirErrs) $
188− putLog Warning $ T.pack $ "Failed to find pkgs in " <> intercalate ", " pkgDirErrs
189−
190− let extensions = packageInfos >>= _cabalPackageInfo_defaultExtensions
191− languageFromPkgs = L.nub $ mapMaybe _cabalPackageInfo_defaultLanguage packageInfos
192− -- NOTE when no default-language is present cabal sets Haskell98
193− language = NE.toList $ fromMaybe (Haskell98 NE.:| []) $ NE.nonEmpty languageFromPkgs
194− extensionsLine = if extensions == mempty
195− then ""
196− else ":set " <> unwords (("-X" <>) . prettyShow <$> extensions)
197− ghcOptions = concat $ mapMaybe (\case (GHC, xs) -> Just xs; _ -> Nothing) $
198− packageInfos >>= _cabalPackageInfo_compilerOptions
199− dotGhci = unlines
200− [ ":set -i" <> intercalate ":" (packageInfos >>= rootedSourceDirs)
201− , case ghcOptions of
202− [] -> ""
203− xs -> ":set " <> unwords xs
204− , extensionsLine
205− , ":set " <> unwords (("-X" <>) . prettyShow <$> language)
206− , ":load Backend Frontend"
207− , "import Obelisk.Run"
208− , "import qualified Frontend"
209− , "import qualified Backend"
210− ]
211− warnDifferentLanguages language
407+withGhciScript (toList -> packageInfos) f =
212408 withSystemTempDirectory "ob-ghci" $ \fp -> do
213409 let dotGhciPath = fp </> ".ghci"
214410 liftIO $ writeFile dotGhciPath dotGhci
215411 f dotGhciPath
412+ where
413+ packageNames = Set.fromList $ map _cabalPackageInfo_packageName packageInfos
414+ modulesToLoad = mconcat
415+ [ [ "Obelisk.Run" | "obelisk-run" `Set.member` packageNames ]
416+ , [ "Backend" | "backend" `Set.member` packageNames ]
417+ , [ "Frontend" | "frontend" `Set.member` packageNames ]
418+ ]
419+ dotGhci = unlines
420+ [ if null modulesToLoad then "" else ":load " <> unwords modulesToLoad
421+ , "import qualified Obelisk.Run"
422+ , "import qualified Frontend"
423+ , "import qualified Backend"
424+ ]
425+
426+-- | Builds a list of options to pass to ghci or set in .ghci file that configures
427+-- the preprocessor and source includes.
428+getGhciSessionSettings
429+ :: (MonadObelisk m, Foldable f)
430+ => f CabalPackageInfo -- ^ List of packages to load into ghci
431+ -> FilePath -- ^ All paths will be relative to this path
432+ -> Bool -- ^ Use relative paths
433+ -> m [String]
434+getGhciSessionSettings (toList -> packageInfos) pathBase useRelativePaths = do
435+ -- N.B. ghci settings do NOT support escaping in any way. To minimize the likelihood that
436+ -- paths-with-spaces ruin our day, we first canonicalize everything, and then relativize
437+ -- all paths to 'pathBase'.
438+ selfExe <- liftIO $ canonicalizePath =<< getExecutablePath
439+ canonicalPathBase <- liftIO $ canonicalizePath pathBase
440+
441+ (pkgFiles, pkgSrcPaths :: [NonEmpty FilePath]) <- fmap unzip $ liftIO $ for packageInfos $ \pkg -> do
442+ canonicalSrcDirs <- traverse canonicalizePath $ (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
443+ canonicalPkgFile <- canonicalizePath $ _cabalPackageInfo_packageFile pkg
444+ pure (canonicalPkgFile `relativeTo'` canonicalPathBase, (`relativeTo'` canonicalPathBase) <$> canonicalSrcDirs)
216445
446+ pure
447+ $ baseGhciOptions
448+ <> ["-F", "-pgmF", selfExe, "-optF", preprocessorIdentifier]
449+ <> concatMap (\p -> ["-optF", p]) pkgFiles
450+ <> [ "-i" <> intercalate ":" (concatMap toList pkgSrcPaths) ]
217451 where
218− rootedSourceDirs pkg = NE.toList $
219− (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
452+ relativeTo' = if useRelativePaths then relativeTo else const
220453
221−warnDifferentLanguages :: MonadObelisk m => [Language] -> m ()
222−warnDifferentLanguages (_:_:_) = putLog Warning "Different languages detected across packages which may result in errors when loading the repl"
223−warnDifferentLanguages _ = return ()
454+baseGhciOptions :: [String]
455+baseGhciOptions =
456+ [ "-ignore-dot-ghci"
457+ , "-no-user-package-db"
458+ , "-package-env", "-"
459+ ]
224460
225461-- | Run ghci repl
226462runGhciRepl
227− :: MonadObelisk m
228− => FilePath -- ^ Path to .ghci
463+ :: (MonadObelisk m, Foldable f)
464+ => FilePath -- ^ Path to project root
465+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
466+ -> [String] -- ^ GHCi arguments
229467 -> m ()
230−runGhciRepl dotGhci = inProjectProc "ghc" $ fmap (bash . BSU.fromString) $ "ghci" : makeBaseGhciOptions dotGhci
468+runGhciRepl root (toList -> packages) ghciArgs =
469+ -- NOTE: We do *not* want to use $(staticWhich "ghci") here because we need the
470+ -- ghc that is provided by the shell in the user's project.
471+ nixShellWithoutPkgs root True False (packageInfoToNamePathMap packages) "ghc" $
472+ Just $ fmap (bash . BSU.fromString) $ "ghci" : ghciArgs
231473
232474-- | Run ghcid
233475runGhcid
234− :: MonadObelisk m
235− => FilePath -- ^ Path to .ghci
476+ :: (MonadObelisk m, Foldable f)
477+ => FilePath -- ^ Path to project root
478+ -> Bool -- ^ Should we chdir to root when running this process?
479+ -> [String] -- ^ GHCi arguments
480+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
236481 -> Maybe String -- ^ Optional command to run at every reload
237482 -> m ()
238−runGhcid dotGhci mcmd = callCommand $ unwords $ $(staticWhich "ghcid") : opts
483+runGhcid root chdirToRoot ghciArgs (toList -> packages) mcmd =
484+ nixShellWithoutPkgs root True chdirToRoot (packageInfoToNamePathMap packages) "ghc" $
485+ Just $ fmap (bash . BSU.fromString) $ ghcidExePath : opts
239486 where
240− opts =
241− [ "-W"
242− --TODO: The decision of whether to use -fwarn-redundant-constraints should probably be made by the user
243− , "--command=" <> BSU.toString (bytes $ bash $ BSU.fromString $
244− "ghci -Wall -ignore-dot-ghci -fwarn-redundant-constraints " <> unwords (makeBaseGhciOptions dotGhci))
245− , "--reload=config"
246− , "--outputfile=ghcid-output.txt"
247− ] <> testCmd
248− testCmd = maybeToList (flip fmap mcmd $ \cmd -> "--test='" <> cmd <> "'")
249−
250−makeBaseGhciOptions :: FilePath -> [String]
251−makeBaseGhciOptions dotGhci =
252− [ "-no-user-package-db"
253− , "-package-env -"
254− , "-ghci-script " <> dotGhci
255− ]
487+ opts = concat
488+ [ ["-W"]
489+ , ["--outputfile=ghcid-output.txt"]
490+ , map (\x -> "--reload=" <> x) reloadFiles
491+ , map (\x -> "--restart=" <> x) restartFiles
492+ , maybe [] (\cmd -> ["--test=" <> cmd]) mcmd
493+ , ["--command=" <> unwords ("ghci" : ghciArgs)]
494+ ]
495+ adjustRoot x = if chdirToRoot then makeRelative root x else x
496+ reloadFiles = map adjustRoot [root </> "config"]
497+ restartFiles = map (adjustRoot . _cabalPackageInfo_packageFile) packages
498+
499+mkGhciScriptArg :: FilePath -> [String]
500+mkGhciScriptArg dotGhci = ["-ghci-script", dotGhci]
256501
257502getFreePort :: MonadIO m => m PortNumber
258503getFreePort = liftIO $ withSocketsDo $ do
@@ -263,3 +508,37 @@ getFreePort = liftIO $ withSocketsDo $ do
263508 sock <- socket (addrFamily addr) (addrSocketType addr) (addrProtocol addr)
264509 bind sock (addrAddress addr)
265510 return sock
511+
512+
513+-- | Convert a 'FilePath' into a 'PathTree'.
514+pathToTree :: a -> FilePath -> PathTree a
515+pathToTree a p = go $ splitDirectories p
516+ where
517+ go [] = PathTree_Node (Just a) mempty
518+ go (x : xs) = PathTree_Node Nothing $ Map.singleton x $ go xs
519+
520+-- | Like 'zipWith' but pads with a padding value instead of stopping on the shortest list.
521+zipDefaultWith :: a -> b -> (a -> b -> c) -> [a] -> [b] -> [c]
522+zipDefaultWith _da _db _f [] [] = []
523+zipDefaultWith da db f (a:as) [] = f a db : zipDefaultWith da db f as []
524+zipDefaultWith da db f [] (b:bs) = f da b : zipDefaultWith da db f [] bs
525+zipDefaultWith da db f (a:as) (b:bs) = f a b : zipDefaultWith da db f as bs
526+
527+-- | Makes the first absolute path relative to the second absolute path.
528+--
529+-- Both input paths MUST be absolute.
530+--
531+-- Unlike 'makeRelative' this does not merely strip prefixes. It will introduce
532+-- enough @..@ paths to make the resulting path truly relative in virtually every
533+-- case. The only exception is on Windows when the two paths are on different
534+-- drives. In this case the resulting path may be absolute.
535+relativeTo :: FilePath -> FilePath -> FilePath
536+relativeTo dir base
537+ = bifoldr1 (</>)
538+ $ bimap (collapse . (".." <$) . catMaybes) (collapse . catMaybes)
539+ $ unzip
540+ $ dropWhile (\(a,b) -> a == b)
541+ $ zipDefaultWith Nothing Nothing (,)
542+ (map Just $ splitDirectories base)
543+ (map Just $ splitDirectories dir)
544+ where collapse = foldr (</>) ""
lib/command/src/Obelisk/Command/Thunk.hs+477−299
@@ -5,70 +5,54 @@
55{-# LANGUAGE MultiWayIf #-}
66{-# LANGUAGE OverloadedStrings #-}
77{-# LANGUAGE PatternGuards #-}
8+{-# LANGUAGE QuasiQuotes #-}
89{-# LANGUAGE ScopedTypeVariables #-}
910{-# LANGUAGE TypeApplications #-}
10−module Obelisk.Command.Thunk
11− ( GitHubSource (..)
12− , GitUri (..)
13− , ReadThunkError (..)
14− , ThunkConfig (..)
15− , ThunkData (..)
16− , ThunkPackConfig (..)
17− , ThunkPtr (..)
18− , ThunkRev (..)
19− , ThunkSource (..)
20− , ThunkUpdateConfig (..)
21− , createThunk
22− , createThunkWithLatest
23− , getLatestRev
24− , getThunkGitBranch
25− , getThunkPtr
26− , gitUriToText
27− , nixBuildAttrWithCache
28− , nixBuildThunkAttrWithCache
29− , packThunk
30− , parseGitUri
31− , readThunk
32− , unpackThunk
33− , updateThunk
34− , updateThunkToLatest
35− , uriThunkPtr
36− ) where
11+module Obelisk.Command.Thunk where
3712
3813import Control.Applicative
3914import Control.Exception (displayException, try)
40−import qualified Control.Lens as Lens
41−import Control.Lens.Indexed hiding ((<.>))
15+import Control.Lens (ifor, ifor_, (.~))
4216import Control.Monad
43−import Control.Monad.Catch (handle)
17+import Control.Monad.Extra (findM)
18+import Control.Monad.Catch (MonadCatch, handle)
4419import Control.Monad.Except
4520import Data.Aeson ((.=))
4621import qualified Data.Aeson as Aeson
4722import Data.Aeson.Encode.Pretty
4823import qualified Data.Aeson.Types as Aeson
24+import Data.Bifunctor (first)
4925import qualified Data.ByteString.Lazy as LBS
26+import Data.Containers.ListUtils (nubOrd)
5027import Data.Default
5128import Data.Either.Combinators (fromRight', rightToMaybe)
29+import Data.Foldable (toList)
30+import Data.Function ((&))
31+import Data.Functor ((<&>))
5232import Data.Git.Ref (Ref)
5333import qualified Data.Git.Ref as Ref
5434import qualified Data.List as L
55−import Data.List.NonEmpty (NonEmpty (..))
35+import Data.List.NonEmpty (NonEmpty (..), nonEmpty)
5636import qualified Data.List.NonEmpty as NonEmpty
5737import Data.Map (Map)
5838import qualified Data.Map as Map
5939import Data.Maybe
6040import Data.Set (Set)
6141import qualified Data.Set as Set
42+import Data.String.Here.Interpolated (i)
43+import Data.String.Here.Uninterpolated (here)
6244import Data.Text (Text)
6345import qualified Data.Text as T
6446import Data.Text.Encoding
6547import qualified Data.Text.IO as T
6648import Data.Time.Clock.POSIX (posixSecondsToUTCTime)
49+import Data.Traversable (for)
6750import Data.Yaml (parseMaybe)
6851import GitHub
6952import GitHub.Data.Name
7053import Obelisk.Command.Nix
7154import System.Directory
55+import System.Exit
7256import System.FilePath
7357import System.IO.Error
7458import System.IO.Temp
@@ -81,11 +65,10 @@ import Obelisk.Command.Utils
8165
8266--TODO: Support symlinked thunk data
8367data ThunkData
84− = ThunkData_Packed ThunkPtr
68+ = ThunkData_Packed ThunkSpec ThunkPtr
8569 -- ^ Packed thunk
86− | ThunkData_Checkout (Maybe ThunkPtr)
70+ | ThunkData_Checkout
8771 -- ^ Checked out thunk that was unpacked from this pointer
88− deriving (Show, Eq, Ord)
8972
9073-- | A reference to the exact data that a thunk should translate into
9174data ThunkPtr = ThunkPtr
@@ -111,6 +94,11 @@ data ThunkSource
11194 | ThunkSource_Git GitSource
11295 deriving (Show, Eq, Ord)
11396
97+thunkSourceToGitSource :: ThunkSource -> GitSource
98+thunkSourceToGitSource = \case
99+ ThunkSource_GitHub s -> forgetGithub False s
100+ ThunkSource_Git s -> s
101+
114102data GitHubSource = GitHubSource
115103 { _gitHubSource_owner :: Name Owner
116104 , _gitHubSource_repo :: Name Repo
@@ -119,7 +107,7 @@ data GitHubSource = GitHubSource
119107 }
120108 deriving (Show, Eq, Ord)
121109
122−newtype GitUri = GitUri URI.URI deriving (Eq, Ord, Show)
110+newtype GitUri = GitUri { unGitUri :: URI.URI } deriving (Eq, Ord, Show)
123111
124112gitUriToText :: GitUri -> Text
125113gitUriToText (GitUri uri)
@@ -210,93 +198,117 @@ nixPrefetchGit uri rev fetchSubmodules =
210198
211199--TODO: Pretty print these
212200data ReadThunkError
213− = ReadThunkError_UnrecognizedFiles
214− | ReadThunkError_AmbiguousFiles
215− | ReadThunkError_UnrecognizedLoader Text
216− | ReadThunkError_UnparseablePtr LBS.ByteString
217− deriving (Show)
218−
219−-- | Read a thunk and validate that it is only a thunk, either packed or unpacked.
220−-- If the thunk is packed and additional data is present, fail.
221−readThunk :: MonadObelisk m => FilePath -> m (Either ReadThunkError ThunkData)
222−readThunk thunkDir = do
223− files <- liftIO $ listDirectory thunkDir
224− case ".git" `elem` files of
225− True -> fmap ThunkData_Checkout <$> do
226− let origThunkPath = thunkDir </> ".git" </> "obelisk" </> "orig-thunk"
227− liftIO $ doesDirectoryExist origThunkPath >>= \case
228− True -> fmap Just <$> readPackedThunk origThunkPath
229− False -> return $ return Nothing
230− False -> liftIO $ fmap ThunkData_Packed <$> readPackedThunk thunkDir
231−
232−data ThunkType = ThunkType
233− { _thunkType_loader :: FilePath
234− , _thunkType_json :: FilePath
235− , _thunkType_optional :: Set FilePath
236− , _thunkType_loaderVersions :: NonEmpty Text
237− , _thunkType_parser :: Aeson.Object -> Aeson.Parser ThunkPtr
238− }
239−
240−gitHubThunkType :: ThunkType
241−gitHubThunkType = ThunkType
242− { _thunkType_loader = "default.nix"
243− , _thunkType_json = "github.json"
244− , _thunkType_optional = Set.fromList [".attr-cache"]
245− , _thunkType_loaderVersions = gitHubStandaloneLoaders
246− , _thunkType_parser = parseThunkPtr $ \v ->
247− ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
201+ = ReadThunkError_UnrecognizedThunk
202+ | ReadThunkError_UnrecognizedPaths (NonEmpty FilePath)
203+ | ReadThunkError_MissingPaths (NonEmpty FilePath)
204+ | ReadThunkError_UnparseablePtr FilePath String
205+ | ReadThunkError_FileError IOError
206+ | ReadThunkError_FileDoesNotMatch FilePath Text
207+ | ReadThunkError_UnrecognizedState String
208+ | ReadThunkError_AmbiguousPackedState ThunkPtr ThunkPtr
209+ deriving (Show)
210+
211+unpackedDirName :: FilePath
212+unpackedDirName = "."
213+
214+attrCacheFileName :: FilePath
215+attrCacheFileName = ".attr-cache"
216+
217+-- | Specification for how a file in a thunk version works.
218+data ThunkFileSpec
219+ = ThunkFileSpec_Ptr (LBS.ByteString -> Either String ThunkPtr) -- ^ This file specifies 'ThunkPtr' data
220+ | ThunkFileSpec_FileMatches Text -- ^ This file must match the given content exactly
221+ | ThunkFileSpec_CheckoutIndicator -- ^ Existence of this directory indicates that the thunk is unpacked
222+ | ThunkFileSpec_AttrCache -- ^ This directory is an attribute cache
223+
224+-- | Specification for how a set of files in a thunk version work.
225+data ThunkSpec = ThunkSpec
226+ { _thunkSpec_name :: !Text
227+ , _thunkSpec_files :: !(Map FilePath ThunkFileSpec)
248228 }
249229
250−gitThunkType :: ThunkType
251−gitThunkType = ThunkType
252− { _thunkType_loader = "default.nix"
253− , _thunkType_json = "git.json"
254− , _thunkType_optional = Set.fromList [".attr-cache"]
255− , _thunkType_loaderVersions = plainGitStandaloneLoaders
256− , _thunkType_parser = parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
257− }
258−
259−thunkTypes :: [ThunkType]
260−thunkTypes = [gitThunkType, gitHubThunkType]
261−
262−findThunkType :: [ThunkType] -> FilePath -> IO (Either ReadThunkError ThunkType)
263−findThunkType types thunkDir = do
264− matches <- fmap catMaybes $ forM types $ \thunkType -> do
265− let
266− expectedContents = Set.fromList $ (thunkDir </>) <$>
267− [ _thunkType_loader thunkType
268− , _thunkType_json thunkType
269− ]
270− optionalContents = Set.map (thunkDir </>) (_thunkType_optional thunkType)
271−
272− -- Ensure that there aren't any other files in the thunk
273− -- NB: System.Directory.listDirectory returns the contents without the directory path
274− files <- liftIO $ Set.fromList . fmap (thunkDir </>) <$> listDirectory thunkDir
275− let unexpectedContents = files `Set.difference` (expectedContents `Set.union` optionalContents)
276− missingContents = expectedContents `Set.difference` files
277− pure $ if Set.null unexpectedContents && Set.null missingContents
278− then Just thunkType
279− else Nothing
280−
281− pure $ case matches of
282− [singleMatch] -> Right singleMatch
283− [] -> Left ReadThunkError_UnrecognizedFiles
284− _ -> Left ReadThunkError_AmbiguousFiles
230+thunkSpecTypes :: NonEmpty (NonEmpty ThunkSpec)
231+thunkSpecTypes = gitThunkSpecs :| [gitHubThunkSpecs]
232+
233+-- | Attempts to match a 'ThunkSpec' to a given directory.
234+matchThunkSpecToDir
235+ :: (MonadError ReadThunkError m, MonadIO m, MonadCatch m)
236+ => ThunkSpec -- ^ 'ThunkSpec' to match against the given files/directory
237+ -> FilePath -- ^ Path to directory
238+ -> Set FilePath -- ^ Set of file paths relative to the given directory
239+ -> m ThunkData
240+matchThunkSpecToDir thunkSpec dir dirFiles = do
241+ case nonEmpty (toList $ dirFiles `Set.difference` expectedPaths) of
242+ Just fs -> throwError $ ReadThunkError_UnrecognizedPaths $ (dir </>) <$> fs
243+ Nothing -> pure ()
244+ case nonEmpty (toList $ requiredPaths `Set.difference` dirFiles) of
245+ Just fs -> throwError $ ReadThunkError_MissingPaths $ (dir </>) <$> fs
246+ Nothing -> pure ()
247+ datas <- fmap toList $ flip Map.traverseMaybeWithKey (_thunkSpec_files thunkSpec) $ \expectedPath -> \case
248+ ThunkFileSpec_AttrCache -> Nothing <$ dirMayExist expectedPath
249+ ThunkFileSpec_CheckoutIndicator -> liftIO (doesDirectoryExist (dir </> expectedPath)) <&> \case
250+ False -> Nothing
251+ True -> Just ThunkData_Checkout
252+ ThunkFileSpec_FileMatches expectedContents -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
253+ actualContents <- liftIO (T.readFile $ dir </> expectedPath)
254+ case T.strip expectedContents == T.strip actualContents of
255+ True -> pure Nothing
256+ False -> throwError $ ReadThunkError_FileDoesNotMatch (dir </> expectedPath) expectedContents
257+ ThunkFileSpec_Ptr parser -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
258+ let path = dir </> expectedPath
259+ liftIO (doesFileExist path) >>= \case
260+ False -> pure Nothing
261+ True -> do
262+ actualContents <- liftIO $ LBS.readFile path
263+ case parser actualContents of
264+ Right v -> pure $ Just (ThunkData_Packed thunkSpec v)
265+ Left e -> throwError $ ReadThunkError_UnparseablePtr (dir </> expectedPath) e
266+
267+ case nonEmpty datas of
268+ Nothing -> throwError ReadThunkError_UnrecognizedThunk
269+ Just xs -> fold1WithM xs $ \a b -> either throwError pure (mergeThunkData a b)
270+ where
271+ rootPathsOnly = Set.fromList . mapMaybe takeRootDir . Map.keys
272+ takeRootDir = fmap NonEmpty.head . nonEmpty . splitPath
273+
274+ expectedPaths = rootPathsOnly $ _thunkSpec_files thunkSpec
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}|]
285307
286308-- | Read a thunk and validate that it is exactly a packed thunk.
287309-- If additional data is present, fail.
288−readPackedThunk :: FilePath -> IO (Either ReadThunkError ThunkPtr)
289−readPackedThunk thunkDir = runExceptT $ do
290− thunkType <- ExceptT $ findThunkType thunkTypes thunkDir
291− -- Ensure that we recognize the thunk loader
292− loader <- liftIO $ T.readFile $ thunkDir </> _thunkType_loader thunkType
293− unless (loader `elem` _thunkType_loaderVersions thunkType) $ do
294− throwError $ ReadThunkError_UnrecognizedLoader loader
295−
296− txt <- liftIO $ LBS.readFile $ thunkDir </> _thunkType_json thunkType
297− case parseMaybe (_thunkType_parser thunkType) =<< Aeson.decode txt of
298− Nothing -> throwError $ ReadThunkError_UnparseablePtr txt
299− Just ptr -> return ptr
310+readThunk :: (MonadObelisk m) => FilePath -> m (Either ReadThunkError ThunkData)
311+readThunk = readThunkWith thunkSpecTypes
300312
301313parseThunkPtr :: (Aeson.Object -> Aeson.Parser ThunkSource) -> Aeson.Object -> Aeson.Parser ThunkPtr
302314parseThunkPtr parseSrc v = do
@@ -340,16 +352,18 @@ parseGitSource v = do
340352overwriteThunk :: MonadObelisk m => FilePath -> ThunkPtr -> m ()
341353overwriteThunk target thunk = do
342354 -- Ensure that this directory is a valid thunk (i.e. so we aren't losing any data)
343− Right _ <- readThunk target
355+ readThunk target >>= \case
356+ Left e -> failWith [i|Invalid thunk at ${target}: ${e}|]
357+ Right _ -> pure ()
344358
345359 --TODO: Is there a safer way to do this overwriting?
346− liftIO $ removeDirectoryRecursive target
347− liftIO $ createThunk target thunk
360+ liftIO $ removePathForcibly target
361+ createThunk target $ Right thunk
348362
349−thunkPtrLoader :: ThunkPtr -> Text
350−thunkPtrLoader thunk = case _thunkPtr_source thunk of
351− ThunkSource_GitHub _ -> NonEmpty.head gitHubStandaloneLoaders
352− ThunkSource_Git _ -> NonEmpty.head plainGitStandaloneLoaders
363+thunkPtrToSpec :: ThunkPtr -> ThunkSpec
364+thunkPtrToSpec thunk = case _thunkPtr_source thunk of
365+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
366+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
353367
354368-- It's important that formatting be very consistent here, because
355369-- otherwise when people update thunks, their patches will be messy
@@ -396,35 +410,41 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
396410 , confTrailingNewline = True
397411 }
398412
399−createThunk :: MonadIO m => FilePath -> ThunkPtr -> m ()
400−createThunk target thunk = liftIO $ do
401− createDirectoryIfMissing True (target </> ".attr-cache")
402− T.writeFile (target </> "default.nix") (thunkPtrLoader thunk)
403− let
404− jsonFileName = case _thunkPtr_source thunk of
405− ThunkSource_GitHub _ -> "github"
406− ThunkSource_Git _ -> "git"
407− LBS.writeFile (target </> jsonFileName <.> "json") (encodeThunkPtrData thunk)
413+createThunk :: MonadObelisk m => FilePath -> Either ThunkSpec ThunkPtr -> m ()
414+createThunk target ptrInfo =
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
427+ f fullPath
408428
409429createThunkWithLatest :: MonadObelisk m => FilePath -> ThunkSource -> m ()
410430createThunkWithLatest target s = do
411431 rev <- getLatestRev s
412− createThunk target $ ThunkPtr
432+ createThunk target $ Right $ ThunkPtr
413433 { _thunkPtr_source = s
414434 , _thunkPtr_rev = rev
415435 }
416436
417437updateThunkToLatest :: MonadObelisk m => ThunkUpdateConfig -> FilePath -> m ()
418−updateThunkToLatest (ThunkUpdateConfig mBranch thunkConfig) target = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest") $ do
419− checkThunkDirectory "ob thunk update directory cannot be '.'" target
438+updateThunkToLatest (ThunkUpdateConfig mBranch thunkConfig) target = spinner $ do
439+ checkThunkDirectory target
420440 -- check to see if thunk should be updated to a specific branch or just update it's current branch
421441 case mBranch of
422442 Nothing -> do
423443 (overwrite, ptr) <- readThunk target >>= \case
424− Left err -> failWith $ T.pack $ "thunk update: " <> show err
444+ Left err -> failWith [i|Thunk update: ${err}|]
425445 Right c -> case c of
426− ThunkData_Packed t -> return (target, t)
427− ThunkData_Checkout _ -> failWith "cannot update an unpacked thunk"
446+ ThunkData_Packed _ t -> return (target, t)
447+ ThunkData_Checkout -> failWith "cannot update an unpacked thunk"
428448 let src = _thunkPtr_source ptr
429449 rev <- getLatestRev src
430450 overwriteThunk overwrite $ modifyThunkPtrByConfig thunkConfig $ ThunkPtr
@@ -432,38 +452,36 @@ updateThunkToLatest (ThunkUpdateConfig mBranch thunkConfig) target = withSpinner
432452 , _thunkPtr_rev = rev
433453 }
434454 Just branch -> readThunk target >>= \case
435− Left err -> failWith $ T.pack $ "thunk update: " <> show err
455+ Left err -> failWith [i|Thunk update: ${err}|]
436456 Right c -> case c of
437− ThunkData_Packed t -> case _thunkPtr_source t of
438− ThunkSource_Git tsg -> setThunk thunkConfig target tsg branch
439− ThunkSource_GitHub tsgh -> do
440− let tsg = forgetGithub False tsgh
441− setThunk thunkConfig target tsg branch
442− 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."
457+ ThunkData_Packed _ t -> setThunk thunkConfig target (thunkSourceToGitSource $ _thunkPtr_source t) 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.|]
459+ where
460+ spinner = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest")
443461
444462setThunk :: MonadObelisk m => ThunkConfig -> FilePath -> GitSource -> String -> m ()
445463setThunk thunkConfig target gs branch = do
446− newThunkPtr <- uriThunkPtr (_gitSource_url gs) (Just $ T.pack branch) Nothing
464+ newThunkPtr <- uriThunkPtr (_gitSource_url gs) (_thunkConfig_private thunkConfig) (Just $ T.pack branch) Nothing
447465 overwriteThunk target newThunkPtr
448466 updateThunkToLatest (ThunkUpdateConfig Nothing thunkConfig) target
449467
450468-- | All recognized github standalone loaders, ordered from newest to oldest.
451469-- This tool will only ever produce the newest one when it writes a thunk.
452−gitHubStandaloneLoaders :: NonEmpty Text
453−gitHubStandaloneLoaders =
454− gitHubStandaloneLoaderV4 :|
455− [ gitHubStandaloneLoaderV3
456− , gitHubStandaloneLoaderV2
457− , gitHubStandaloneLoaderV1
470+gitHubThunkSpecs :: NonEmpty ThunkSpec
471+gitHubThunkSpecs =
472+ gitHubThunkSpecV5 :|
473+ [ gitHubThunkSpecV4
474+ , gitHubThunkSpecV3
475+ , gitHubThunkSpecV2
476+ , gitHubThunkSpecV1
458477 ]
459478
460−gitHubStandaloneLoaderV1 :: Text
461−gitHubStandaloneLoaderV1 = T.unlines
462− [ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
463− ]
479+gitHubThunkSpecV1 :: ThunkSpec
480+gitHubThunkSpecV1 = legacyGitHubThunkSpec "github-v1"
481+ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
464482
465−gitHubStandaloneLoaderV2 :: Text
466−gitHubStandaloneLoaderV2 = T.unlines
483+gitHubThunkSpecV2 :: ThunkSpec
484+gitHubThunkSpecV2 = legacyGitHubThunkSpec "github-v2" $ T.unlines
467485 [ "# DO NOT HAND-EDIT THIS FILE" --TODO: Add something about how to get more info on Obelisk, etc.
468486 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
469487 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
@@ -473,8 +491,8 @@ gitHubStandaloneLoaderV2 = T.unlines
473491 , "))"
474492 ]
475493
476−gitHubStandaloneLoaderV3 :: Text
477−gitHubStandaloneLoaderV3 = T.unlines
494+gitHubThunkSpecV3 :: ThunkSpec
495+gitHubThunkSpecV3 = legacyGitHubThunkSpec "github-v3" $ T.unlines
478496 [ "# DO NOT HAND-EDIT THIS FILE"
479497 , "let"
480498 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
@@ -493,8 +511,8 @@ gitHubStandaloneLoaderV3 = T.unlines
493511 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
494512 ]
495513
496−gitHubStandaloneLoaderV4 :: Text
497−gitHubStandaloneLoaderV4 = T.unlines
514+gitHubThunkSpecV4 :: ThunkSpec
515+gitHubThunkSpecV4 = legacyGitHubThunkSpec "github-v4" $ T.unlines
498516 [ "# DO NOT HAND-EDIT THIS FILE"
499517 , "let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:"
500518 , " if !fetchSubmodules && !private then builtins.fetchTarball {"
@@ -505,23 +523,50 @@ gitHubStandaloneLoaderV4 = T.unlines
505523 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
506524 ]
507525
508−plainGitStandaloneLoaders :: NonEmpty Text
509−plainGitStandaloneLoaders =
510− plainGitStandaloneLoaderV3 :|
511− [ plainGitStandaloneLoaderV1
512− , plainGitStandaloneLoaderV2
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
513558 ]
514559
515−plainGitStandaloneLoaderV1 :: Text
516−plainGitStandaloneLoaderV1 = T.unlines
560+gitThunkSpecV1 :: ThunkSpec
561+gitThunkSpecV1 = legacyGitThunkSpec "git-v1" $ T.unlines
517562 [ "# DO NOT HAND-EDIT THIS FILE"
518563 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
519564 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
520565 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
521566 ]
522567
523−plainGitStandaloneLoaderV2 :: Text
524−plainGitStandaloneLoaderV2 = T.unlines
568+gitThunkSpecV2 :: ThunkSpec
569+gitThunkSpecV2 = legacyGitThunkSpec "git-v2" $ T.unlines
525570 [ "# DO NOT HAND-EDIT THIS FILE"
526571 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
527572 , " if builtins.hasAttr \"fetchGit\" builtins"
@@ -530,8 +575,10 @@ plainGitStandaloneLoaderV2 = T.unlines
530575 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
531576 ]
532577
533−plainGitStandaloneLoaderV3 :: Text
534−plainGitStandaloneLoaderV3 = T.unlines
578+-- This loader has a bug because @builtins.fetchGit@ is not given a @ref@
579+-- and will fail to find commits without this because it does shallow clones.
580+gitThunkSpecV3 :: ThunkSpec
581+gitThunkSpecV3 = legacyGitThunkSpec "git-v3" $ T.unlines
535582 [ "# DO NOT HAND-EDIT THIS FILE"
536583 , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
537584 , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
@@ -546,10 +593,69 @@ plainGitStandaloneLoaderV3 = T.unlines
546593 , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
547594 ]
548595
549−thunkFileNames :: [FilePath]
550−thunkFileNames = ["default.nix", "github.json", "git.json"]
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+
613+legacyGitThunkSpec :: Text -> Text -> ThunkSpec
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+
551656
552−--TODO: when checking something out, make a shallow clone
657+parseJsonObject :: (Aeson.Object -> Aeson.Parser a) -> LBS.ByteString -> Either String a
658+parseJsonObject p bytes = Aeson.parseEither p =<< Aeson.eitherDecode bytes
553659
554660-- | Checks a cache directory to see if there is a fresh symlink
555661-- to the result of building an attribute of a thunk.
@@ -557,44 +663,49 @@ thunkFileNames = ["default.nix", "github.json", "git.json"]
557663-- and the result is symlinked into the cache.
558664nixBuildThunkAttrWithCache
559665 :: MonadObelisk m
560− => FilePath
666+ => ThunkSpec
667+ -> FilePath
561668 -- ^ Path to directory containing Thunk
562669 -> String
563670 -- ^ Attribute to build
564− -> m FilePath
671+ -> m (Maybe FilePath)
565672 -- ^ Symlink to cached or built nix output
566673-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
567674-- the caching mechanism will fail as it merely measures the modification
568675-- time of the cache link and the expression to build.
569−nixBuildThunkAttrWithCache thunkDir attr = do
570− --NB: Expects thunkDir to be normalised with no trailing path separator.
571− --This should be guaranteed by the command argument parser.
572− let cacheErrHandler e
573− | isDoesNotExistError e = return Nothing -- expected from a cache miss
574− | otherwise = putLog Error (T.pack $ displayException e) >> return Nothing
575− cacheDir = thunkDir </> ".attr-cache"
576− cachePath = cacheDir </> attr <.> "out"
676+nixBuildThunkAttrWithCache thunkSpec thunkDir attr = do
577677 latestChange <- liftIO $ do
578− createDirectoryIfMissing False cacheDir
579− let getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
580− maximum . catMaybes <$> mapM (getModificationTimeMaybe . (thunkDir </>)) thunkFileNames
581− cacheHit <- handle cacheErrHandler $ do
582− cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
583− return $ if latestChange <= cacheTime
584− then Just cachePath
585− else Nothing
586− case cacheHit of
587− Just c -> return c
588− Nothing -> do
589− putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
590− _ <- nixCmd $ NixCmd_Build $ def
591− Lens.& nixBuildConfig_outLink Lens..~ OutLink_IndirectRoot cachePath
592− Lens.& nixCmdConfig_target Lens..~ Target
593− { _target_path = Just thunkDir
594− , _target_attr = Just attr
595− , _target_expr = Nothing
596− }
597− return cachePath
678+ let
679+ getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
680+ thunkFileNames = Map.keys $ _thunkSpec_files thunkSpec
681+ maximum . catMaybes <$> traverse (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
693+ cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
694+ pure $ if latestChange <= cacheTime
695+ then Just cachePath
696+ else Nothing
697+ case cacheHit of
698+ Just c -> pure c
699+ Nothing -> do
700+ putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
701+ liftIO $ createDirectoryIfMissing True (takeDirectory cachePath)
702+ (cachePath <$) $ nixCmd $ NixCmd_Build $ def
703+ & nixBuildConfig_outLink .~ OutLink_IndirectRoot cachePath
704+ & nixCmdConfig_target .~ Target
705+ { _target_path = Just thunkDir
706+ , _target_attr = Just attr
707+ , _target_expr = Nothing
708+ }
598709
599710-- | Build a nix attribute, and cache the result if possible
600711nixBuildAttrWithCache
@@ -605,13 +716,15 @@ nixBuildAttrWithCache
605716 -- ^ Attribute to build
606717 -> m FilePath
607718 -- ^ Symlink to cached or built nix output
608−nixBuildAttrWithCache exprPath attr = do
609− readThunk exprPath >>= \case
610− -- Only packed thunks are cached. in particular, checkouts are not
611− Right (ThunkData_Packed _) -> nixBuildThunkAttrWithCache exprPath attr
612− _ -> nixCmd $ NixCmd_Build $ def
613− Lens.& nixBuildConfig_outLink Lens..~ OutLink_None
614− Lens.& nixCmdConfig_target Lens..~ Target
719+nixBuildAttrWithCache exprPath attr = readThunk exprPath >>= \case
720+ -- Only packed thunks are cached. In particular, checkouts are not.
721+ Right (ThunkData_Packed spec _) ->
722+ maybe build pure =<< nixBuildThunkAttrWithCache spec exprPath attr
723+ _ -> build
724+ where
725+ build = nixCmd $ NixCmd_Build $ def
726+ & nixBuildConfig_outLink .~ OutLink_None
727+ & nixCmdConfig_target .~ Target
615728 { _target_path = Just exprPath
616729 , _target_attr = Just attr
617730 , _target_expr = Nothing
@@ -632,76 +745,95 @@ updateThunk p f = withSystemTempDirectory "obelisk-thunkptr-" $ \tmpDir -> do
632745 where
633746 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
634747 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
635− Right (ThunkData_Packed _) -> do
748+ Right ThunkData_Packed{} -> do
636749 let tmpThunk = tmpDir </> "thunk"
637750 callProcessAndLogOutput (Notice, Error) $
638− proc "cp" ["-r", "-T", thunkDir, tmpThunk]
751+ proc cp ["-r", "-T", thunkDir, tmpThunk]
639752 return tmpThunk
640753 Right _ -> failWith "Thunk is not packed"
641754 updateThunkFromTmp p' = do
642755 _ <- packThunk' True (ThunkPackConfig False (ThunkConfig Nothing)) p'
643756 callProcessAndLogOutput (Notice, Error) $
644− proc "cp" ["-r", "-T", p', p]
757+ proc cp ["-r", "-T", p', p]
645758
646759finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
647760finalMsg noTrail s = if noTrail then Nothing else Just s
648761
649−unpackThunk :: MonadObelisk m => FilePath -> m ()
650−unpackThunk = unpackThunk' False
651−
652762-- | Check that we are not somewhere inside the thunk directory
653−checkThunkDirectory :: MonadObelisk m => Text -> FilePath -> m ()
654−checkThunkDirectory msg thunkDir = do
763+checkThunkDirectory :: MonadObelisk m => FilePath -> m ()
764+checkThunkDirectory thunkDir = do
655765 currentDir <- liftIO getCurrentDirectory
656766 thunkDir' <- liftIO $ canonicalizePath thunkDir
657− when (thunkDir' `L.isInfixOf` currentDir) $ failWith msg
767+ when (thunkDir' `L.isInfixOf` currentDir) $
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
658778
659779unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
660−unpackThunk' noTrail thunkDir = checkThunkDirectory "Can't pack/unpack from within the thunk directory" thunkDir >> readThunk thunkDir >>= \case
661− Left err -> failWith $ "thunk unpack: " <> T.pack (show err)
780+unpackThunk' noTrail thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
781+ Left err -> failWith [i|Invalid thunk at ${thunkDir}: ${err}|]
662782 --TODO: Overwrite option that rechecks out thunk; force option to do so even if working directory is dirty
663− Right (ThunkData_Checkout _) -> failWith "thunk unpack: thunk is already unpacked"
664− Right (ThunkData_Packed tptr) -> do
783+ Right ThunkData_Checkout -> failWith [i|Thunk at ${thunkDir} is already unpacked|]
784+ Right (ThunkData_Packed _ tptr) -> do
665785 let (thunkParent, thunkName) = splitFileName thunkDir
666− withTempDirectory thunkParent thunkName $ \tmpRepo -> do
667− let obGitDir = tmpRepo </> ".git" </> "obelisk"
668− s = case _thunkPtr_source tptr of
669− ThunkSource_GitHub s' -> forgetGithub False s'
670− ThunkSource_Git s' -> s'
786+ withTempDirectory thunkParent thunkName $ \tmpThunk -> do
787+ let
788+ gitSrc = thunkSourceToGitSource $ _thunkPtr_source tptr
789+ newSpec = case _thunkPtr_source tptr of
790+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
791+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
671792 withSpinner' ("Fetching thunk " <> T.pack thunkName)
672793 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
673− let git = callProcessAndLogOutput (Notice, Notice) . gitProc tmpRepo
674− git $ [ "clone" ]
675− ++ ("--recursive" <$ guard (_gitSource_fetchSubmodules s))
676− ++ [ T.unpack $ gitUriToText $ _gitSource_url s ]
677− ++ do branch <- maybeToList $ _gitSource_branch s
678− [ "--branch", T.unpack $ untagName branch ]
679− git ["reset", "--hard", Ref.toHexString $ _thunkRev_commit $ _thunkPtr_rev tptr]
680− when (_gitSource_fetchSubmodules s) $
681− git ["submodule", "update", "--recursive", "--init"]
682−
683− liftIO $ createDirectory obGitDir
684− callProcessAndLogOutput (Notice, Error) $
685− proc "cp" ["-r", "-T", thunkDir </> ".", obGitDir </> "orig-thunk"]
686− callProcessAndLogOutput (Notice, Error) $
687− proc "rm" ["-r", thunkDir]
688− callProcessAndLogOutput (Notice, Error) $
689− proc "mv" ["-T", tmpRepo, thunkDir]
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
813+ git $ [ "clone" ]
814+ ++ ["--recursive" | _gitSource_fetchSubmodules gitSrc]
815+ ++ [ T.unpack $ gitUriToText $ _gitSource_url gitSrc ]
816+ ++ do branch <- maybeToList $ _gitSource_branch gitSrc
817+ [ "--branch", T.unpack $ untagName branch ]
818+ git ["reset", "--hard", Ref.toHexString commit]
819+ when (_gitSource_fetchSubmodules gitSrc) $
820+ git ["submodule", "update", "--recursive", "--init"]
690821
691822--TODO: add a rollback mode to pack to the original thunk
692823packThunk :: MonadObelisk m => ThunkPackConfig -> FilePath -> m ThunkPtr
693824packThunk = packThunk' False
694825
695826packThunk' :: MonadObelisk m => Bool -> ThunkPackConfig -> FilePath -> m ThunkPtr
696−packThunk' noTrail (ThunkPackConfig force thunkConfig) thunkDir = checkThunkDirectory "Can't pack/unpack from within the thunk directory" thunkDir >> readThunk thunkDir >>= \case
697− Left err -> failWith $ T.pack $ "thunk pack: " <> show err
698− Right (ThunkData_Packed _) -> failWith "pack: thunk is already packed"
699− Right (ThunkData_Checkout _) -> do
700− withSpinner' ("Packing thunk " <> T.pack thunkDir)
701− (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $ do
702− thunkPtr <- modifyThunkPtrByConfig thunkConfig <$> getThunkPtr (not force) thunkDir
703− callProcessAndLogOutput (Debug, Error) $ proc "rm" ["-rf", thunkDir]
704− liftIO $ createThunk thunkDir thunkPtr
827+packThunk' noTrail (ThunkPackConfig force thunkConfig) thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
828+ Right ThunkData_Packed{} -> failWith [i|Thunk at ${thunkDir} is is already packed|]
829+ _ -> withSpinner'
830+ ("Packing thunk " <> T.pack thunkDir)
831+ (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $
832+ do
833+ let checkClean = if force then CheckClean_NoCheck else CheckClean_FullCheck
834+ thunkPtr <- modifyThunkPtrByConfig thunkConfig <$> getThunkPtr checkClean thunkDir (_thunkConfig_private thunkConfig)
835+ liftIO $ removePathForcibly thunkDir
836+ createThunk thunkDir $ Right thunkPtr
705837 pure thunkPtr
706838
707839modifyThunkPtrByConfig :: ThunkConfig -> ThunkPtr -> ThunkPtr
@@ -712,29 +844,43 @@ modifyThunkPtrByConfig (ThunkConfig markPrivate') ptr = case markPrivate' of
712844 ThunkSource_GitHub s -> ThunkSource_GitHub $ s { _gitHubSource_private = markPrivate }
713845 }
714846
715−getThunkPtr :: forall m. MonadObelisk m => Bool -> FilePath -> m ThunkPtr
716−getThunkPtr checkClean thunkDir = do
717− when checkClean $ ensureCleanGitRepo thunkDir True
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
856+getThunkPtr gitCheckClean dir mPrivate = 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
718869 "thunk pack: thunk checkout contains unsaved modifications"
719870
720871 -- Check whether there are any stashes
721− stashOutput <- readGitProcess thunkDir ["stash", "list"]
722− when checkClean $ case T.null stashOutput of
723− False -> do
872+ when checkClean $ do
873+ stashOutput <- readGitProcess thunkDir ["stash", "list"]
874+ unless (T.null stashOutput) $
724875 failWith $ T.unlines $
725876 [ "thunk pack: thunk checkout has stashes"
726877 , "git stash list:"
727878 ] ++ T.lines stashOutput
728− True -> return ()
729879
730− -- Get current branch ``
880+ -- Get current branch
731881 (mCurrentBranch, mCurrentCommit) <- do
732− b <- listToMaybe
733− <$> T.lines
734− <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
735− c <- listToMaybe
736− <$> T.lines
737− <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
882+ b <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
883+ c <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
738884 case b of
739885 (Just "HEAD") -> failWith $ T.unlines
740886 [ "thunk pack: You are in 'detached HEAD' state."
@@ -745,7 +891,7 @@ getThunkPtr checkClean thunkDir = do
745891
746892 -- Get information on all branches and their (optional) designated upstream
747893 -- correspondents
748− (headDump :: [Text]) <- T.lines <$> readGitProcess thunkDir
894+ headDump :: [Text] <- T.lines <$> readGitProcess thunkDir
749895 [ "for-each-ref"
750896 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
751897 , "refs/heads/"
@@ -791,7 +937,7 @@ getThunkPtr checkClean thunkDir = do
791937 ]
792938
793939 -- loosely by https://stackoverflow.com/questions/7773939/show-git-ahead-and-behind-info-for-all-branches-including-remotes
794− stats <- iforM headUpstream $ \branch (upstream, _remote) -> do
940+ stats <- ifor headUpstream $ \branch (upstream, _remote) -> do
795941 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
796942 [ "rev-list", "--left-right"
797943 , T.unpack branch <> "..." <> T.unpack upstream
@@ -815,8 +961,9 @@ getThunkPtr checkClean thunkDir = do
815961 \pushed but this repo's remote tracking branches don't know it.)"
816962 ]
817963
818− -- We assume it's safe to pack the thunk at this point
819− putLog Informational "All changes safe in git remotes. OK to pack thunk."
964+ when checkClean $ do
965+ -- 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."
820967
821968 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
822969
@@ -829,14 +976,12 @@ getThunkPtr checkClean thunkDir = do
829976 remoteUri <- case parseGitUri remoteUri' of
830977 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
831978 Just uri -> pure uri
832− uriThunkPtr remoteUri mCurrentBranch mCurrentCommit
979+ uriThunkPtr remoteUri mPrivate mCurrentBranch mCurrentCommit
833980
834981-- | Get the latest revision available from the given source
835982getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
836983getLatestRev os = do
837− let gitS = case os of
838− ThunkSource_GitHub s -> forgetGithub False s
839− ThunkSource_Git s -> s
984+ let gitS = thunkSourceToGitSource os
840985 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
841986 case os of
842987 ThunkSource_GitHub s -> githubThunkRev s commit
@@ -848,12 +993,12 @@ getLatestRev os = do
848993-- performance. If that doesn't work (e.g. authentication issue), we fall back
849994-- on just doing things the normal way for git repos in general, and save it as
850995-- a regular git thunk.
851−uriThunkPtr :: MonadObelisk m => GitUri -> Maybe Text -> Maybe Text -> m ThunkPtr
852−uriThunkPtr uri mbranch mcommit = do
996+uriThunkPtr :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr
997+uriThunkPtr uri mPrivate mbranch mcommit = do
853998 commit <- case mcommit of
854999 Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
8551000 (Just c) -> return c
856− (src, rev) <- case uriToThunkSource uri mbranch of
1001+ (src, rev) <- uriToThunkSource uri mPrivate mbranch >>= \case
8571002 ThunkSource_GitHub s -> do
8581003 rev <- runExceptT $ githubThunkRev s commit
8591004 case rev of
@@ -876,8 +1021,8 @@ uriThunkPtr uri mbranch mcommit = do
8761021-- If the thunk is a GitHub thunk and fails, we do *not* fall back like with
8771022-- `uriThunkPtr`. Unlike a plain URL, a thunk src explicitly states which method
8781023-- should be employed, and so we respect that.
879−uriToThunkSource :: GitUri -> Maybe Text -> ThunkSource
880−uriToThunkSource (GitUri u)
1024+uriToThunkSource :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> m ThunkSource
1025+uriToThunkSource (GitUri u) mPrivate
8811026 | Right uriAuth <- URI.uriAuthority u
8821027 , Just scheme <- URI.unRText <$> URI.uriScheme u
8831028 , case scheme of
@@ -889,21 +1034,53 @@ uriToThunkSource (GitUri u)
8891034 s -> s `L.elem` [ "git", "https", "http" ] -- "http:" just redirects to "https:"
8901035 && URI.unRText (URI.authHost uriAuth) == "github.com"
8911036 , Just (_, owner :| [repoish]) <- URI.uriPath u
892− = \mbranch -> ThunkSource_GitHub $ GitHubSource
893− { _gitHubSource_owner = N $ URI.unRText owner
894− , _gitHubSource_repo = N $ let
895− repoish' = URI.unRText repoish
896− in fromMaybe repoish' $ T.stripSuffix ".git" repoish'
897− , _gitHubSource_branch = N <$> mbranch
898− , _gitHubSource_private = False -- TODO: Can we try something to infer this?
899− }
1037+ = \mbranch -> do
1038+ isPrivate <- getIsPrivate
1039+ pure $ ThunkSource_GitHub $ GitHubSource
1040+ { _gitHubSource_owner = N $ URI.unRText owner
1041+ , _gitHubSource_repo = N $ let
1042+ repoish' = URI.unRText repoish
1043+ in fromMaybe repoish' $ T.stripSuffix ".git" repoish'
1044+ , _gitHubSource_branch = N <$> mbranch
1045+ , _gitHubSource_private = isPrivate
1046+ }
9001047
901− | otherwise = \mbranch -> ThunkSource_Git $ GitSource
902− { _gitSource_url = GitUri u
903− , _gitSource_branch = N <$> mbranch
904− , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
905− , _gitSource_private = False -- TODO: Can we try something to infer this?
906− }
1048+ | otherwise = \mbranch -> do
1049+ isPrivate <- getIsPrivate
1050+ pure $ ThunkSource_Git $ GitSource
1051+ { _gitSource_url = GitUri u
1052+ , _gitSource_branch = N <$> mbranch
1053+ , _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+ }
9071084
9081085-- Funny signature indicates no effects depend on the optional branch name.
9091086githubThunkRev
@@ -963,6 +1140,7 @@ gitThunkRev s commit = do
9631140--
9641141-- If the branch name is passed in, it is returned exactly as-is. If it is not
9651142-- passed it, the default branch of the repo is used instead.
1143+
9661144gitGetCommitBranch
9671145 :: MonadObelisk m => GitUri -> Maybe Text -> m (Text, CommitId)
9681146gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
lib/command/src/Obelisk/Command/Upgrade/Hash.hsdeleted−114
@@ -1,114 +0,0 @@
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+40−9
@@ -4,33 +4,63 @@
44{-# LANGUAGE ScopedTypeVariables #-}
55{-# LANGUAGE OverloadedStrings #-}
66{-# LANGUAGE PatternGuards #-}
7+{-# LANGUAGE TemplateHaskell #-}
78module Obelisk.Command.Utils where
89
910import Control.Applicative hiding (many)
1011import Control.Monad.Except
1112import Data.Bool (bool)
12−import qualified Text.Megaparsec.Char.Lexer as ML
1313import Data.Bifunctor
1414import Data.Char
1515import Data.Either
16−import Data.Semigroup ((<>))
16+import Data.List (isInfixOf)
1717import Data.Map (Map)
1818import qualified Data.Map as M
1919import Data.Maybe (maybeToList)
20+import Data.Semigroup ((<>))
2021import Data.Text (Text)
2122import qualified Data.Text as T
2223import Data.Void (Void)
23−import System.Directory (canonicalizePath)
24−import System.Environment (getExecutablePath)
2524import System.Exit (ExitCode)
25+import System.Which (staticWhich)
26+import qualified Text.Megaparsec.Char.Lexer as ML
2627import Text.Megaparsec as MP
2728import Text.Megaparsec.Char as MP
2829
2930import Obelisk.App (MonadObelisk)
3031import Obelisk.CliApp
3132
32−getObeliskExe :: IO FilePath
33−getObeliskExe = getExecutablePath >>= canonicalizePath
33+cp :: FilePath
34+cp = $(staticWhich "cp")
35+
36+mvPath :: FilePath
37+mvPath = $(staticWhich "mv")
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+-- | Nix syntax requires relative paths to be prefixed by @./@ or
58+-- @../@. This will make a 'FilePath' that can be embedded in a Nix
59+-- expression.
60+toNixPath :: FilePath -> FilePath
61+toNixPath root | "/" `isInfixOf` root = root
62+ | otherwise = "./" <> root
63+
3464
3565-- Check whether the working directory is clean
3666checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
@@ -76,14 +106,15 @@ isolateGitProc = setEnvOverride (overrides <>)
76106 overrides = M.fromList
77107 [ ("HOME", "/dev/null")
78108 , ("GIT_CONFIG_NOSYSTEM", "1")
79− , ("GIT_TERMINAL_PROMPT", "0")
80− , ("GIT_SSH_COMMAND", "ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no -o GSSAPIAuthentication=no")
109+ , ("GIT_TERMINAL_PROMPT", "0") -- git 2.3+
110+ , ("GIT_ASKPASS", "echo") -- pre git 2.3 to just use empty password
111+ , ("GIT_SSH_COMMAND", "ssh -o PreferredAuthentications password -o PubkeyAuthentication no -o GSSAPIAuthentication no")
81112 ]
82113
83114-- | Recursively copy a directory using `cp -a` -- TODO: Should use -rT instead of -a
84115copyDir :: FilePath -> FilePath -> ProcessSpec
85116copyDir src dest =
86− setCwd (Just src) $ proc "cp" ["-a", ".", dest] -- TODO: This will break if dest is relative since we change cwd
117+ setCwd (Just src) $ proc cp ["-a", ".", dest] -- TODO: This will break if dest is relative since we change cwd
87118
88119readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
89120readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
lib/command/src/Obelisk/Command/VmBuilder.hs+2−1
@@ -21,6 +21,7 @@ import qualified System.Info
2121
2222import Obelisk.App (MonadObelisk, getObeliskUserStateDir)
2323import Obelisk.CliApp
24+import Obelisk.Command.Utils (rmPath)
2425
2526-- | Generate the `--builders` argument string to enable the VM builder after ensuring it is available.
2627getNixBuildersArg :: MonadObelisk m => m String
@@ -95,7 +96,7 @@ setupNixDocker stateDir = withSpinner ("Creating Docker container named " <> con
9596
9697 -- Create new SSH keys for this container
9798 callProcessAndLogOutput (Debug, Error) $
98− proc "rm" ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
99+ proc rmPath ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
99100 callProcessAndLogOutput (Debug, Error) $
100101 proc "ssh-keygen" ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
101102
lib/executable-config/default.nix+25−18
@@ -2,26 +2,33 @@
22# configuration information into a canonical location. It also provides a haskell
33# package that can be used to retrieve the injected configuration on each supported
44# platform.
5−{ nixpkgs
6−, filterGitSource # TODO define this in obelisk
5+{ lib
6+, runCommand
7+, obeliskCleanSource
78}:
8−let injectConfig = config: assets: nixpkgs.runCommand "inject-config" {} (''
9− set -x
10− mkdir -p $out
11− cp --no-preserve=mode -Lr "${assets}" $out/static
12− chmod +w "$out"
13− '' + nixpkgs.lib.optionalString (!(builtins.isNull config)) ''
14− if ! mkdir $out/config; then
15− 2>&1 echo config directory already exists or could not be created
16− exit 1
17− fi
18− cp -a "${config}"/* "$out/config"
19− find "$out/config" -type f -printf '%P\0' >"$out/config.files"
20− '');
21−in with nixpkgs.haskell.lib; {
9+
10+let
11+ injectConfig = config: assets: runCommand "inject-config" {} (''
12+ set -x
13+ mkdir -p $out
14+ cp --no-preserve=mode -Lr "${assets}" $out/static
15+ chmod +w "$out"
16+ '' + lib.optionalString (!(builtins.isNull config)) ''
17+ if ! mkdir $out/config; then
18+ 2>&1 echo config directory already exists or could not be created
19+ exit 1
20+ fi
21+ cp -a "${config}"/* "$out/config"
22+ # Needed for android deployments
23+ find "$out/config" -type f -printf '%P\0' > "$out/config.files"
24+ '');
25+in
26+
27+{
2228 haskellOverlay = self: super: {
23− obelisk-executable-config-lookup = self.callCabal2nix "obelisk-executable-config-lookup" (filterGitSource ./lookup) {};
29+ obelisk-executable-config-lookup = self.callCabal2nix "obelisk-executable-config-lookup" (obeliskCleanSource ./lookup) {};
2430 };
31+
2532 platforms = {
2633 android = {
2734 # Inject the given config directory into an android assets folder
@@ -32,7 +39,7 @@ in with nixpkgs.haskell.lib; {
3239 inject = injectConfig;
3340 };
3441 web = {
35− inject = self: self.callCabal2nix "obelisk-executable-config-inject" (filterGitSource ./inject) {};
42+ inject = self: self.callCabal2nix "obelisk-executable-config-inject" (obeliskCleanSource ./inject) {};
3643 };
3744 };
3845}
lib/executable-config/lookup/src-other/Obelisk/ExecutableConfig/Lookup.hs+1−8
@@ -1,18 +1,11 @@
1−{-# LANGUAGE LambdaCase #-}
21{-# LANGUAGE OverloadedStrings #-}
32module Obelisk.ExecutableConfig.Lookup where
43
54import Data.Map (Map)
6−import qualified Data.Map as Map
75import Data.Text (Text)
8−import qualified Data.Text as T
96import Data.ByteString (ByteString)
10−import qualified Data.ByteString as BS
11−import System.Directory
12−import System.FilePath
13−import Control.Monad
147
15−import Obelisk.Configs.Internal.Directory
8+import Obelisk.Configs.Internal.Directory (getConfigsFromDirectory)
169
1710getConfigs :: IO (Map Text ByteString)
1811getConfigs = getConfigsFromDirectory "config"
lib/frontend/src/Obelisk/Frontend.hs+9−9
@@ -5,6 +5,7 @@
55{-# LANGUAGE LambdaCase #-}
66{-# LANGUAGE MultiParamTypeClasses #-}
77{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE PackageImports #-}
89{-# LANGUAGE RankNTypes #-}
910{-# LANGUAGE RecursiveDo #-}
1011{-# LANGUAGE ScopedTypeVariables #-}
@@ -19,6 +20,7 @@ module Obelisk.Frontend
1920 , renderFrontendHtml
2021 , removeHTMLConfigs
2122 , FrontendMode (..)
23+ , FrontendWidgetT
2224 , module Obelisk.Frontend.Cookie
2325 ) where
2426
@@ -45,7 +47,7 @@ import qualified GHCJS.DOM.History as DOM
4547import qualified GHCJS.DOM.Window as DOM
4648import Language.Javascript.JSaddle (MonadJSM, JSM, jsNull)
4749import GHCJS.DOM (currentDocument)
48−import GHCJS.DOM.Document (getHead)
50+import "ghcjs-dom" GHCJS.DOM.Document (getHead)
4951import GHCJS.DOM.Node (Node, removeChild_)
5052import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
5153import GHCJS.DOM.ParentNode (querySelectorAll)
@@ -180,7 +182,7 @@ runFrontendWithConfigsAndCurrentRoute
180182 -> Frontend (R frontendRoute)
181183 -> JSM ()
182184runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = do
183− let ve = validFullEncoder . hoistParse errorLeft (prismEncoder (rPrism $ _FullRoute_Frontend . _ObeliskRoute_App))
185+ let ve = validFullEncoder . hoistParse errorLeft (reviewEncoder (rPrism $ _FullRoute_Frontend . _ObeliskRoute_App))
184186 errorLeft = \case
185187 Left _ -> error "runFrontend: Unexpected non-app ObeliskRoute reached the frontend. This shouldn't happen."
186188 Right x -> Identity x
@@ -197,7 +199,6 @@ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = d
197199 , PrimMonad m
198200 , MonadSample DomTimeline (Performable m)
199201 , DOM.MonadJSM m
200− , Monad (Performable (Client (HydrationDomBuilderT s DomTimeline m)))
201202 , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
202203 , MonadFix (Performable m)
203204 , MonadFix m
@@ -226,18 +227,17 @@ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = d
226227 then runHydrationWidgetWithHeadAndBody (pure ()) w
227228 else runImmediateWidgetWithHeadAndBody w
228229
230+type FrontendWidgetT r = RoutedT DomTimeline r (SetRouteT DomTimeline r (RouteToUrlT r (ConfigsT (CookiesT (HydratableT (PostBuildT DomTimeline (StaticDomBuilderT DomTimeline (PerformEventT DomTimeline DomHost))))))))
231+
229232renderFrontendHtml
230− :: ( t ~ DomTimeline
231− , MonadIO m
232− , widget ~ RoutedT t r (SetRouteT t r (RouteToUrlT r (ConfigsT (CookiesT (HydratableT (PostBuildT t (StaticDomBuilderT t (PerformEventT t DomHost))))))))
233− )
233+ :: MonadIO m
234234 => Map Text ByteString
235235 -> Cookies
236236 -> (r -> Text)
237237 -> r
238238 -> Frontend r
239− -> widget ()
240− -> widget ()
239+ -> FrontendWidgetT r ()
240+ -> FrontendWidgetT r ()
241241 -> m ByteString
242242renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
243243 --TODO: We should probably have a "NullEventWriterT" or a frozen reflex timeline
lib/frontend/src/Obelisk/Frontend/Cookie.hs+2−1
@@ -6,6 +6,7 @@
66{-# LANGUAGE FlexibleInstances #-}
77{-# LANGUAGE GeneralizedNewtypeDeriving #-}
88{-# LANGUAGE MultiParamTypeClasses #-}
9+{-# LANGUAGE PackageImports #-}
910{-# LANGUAGE RankNTypes #-}
1011{-# LANGUAGE TypeFamilies #-}
1112{-# LANGUAGE UndecidableInstances #-}
@@ -22,7 +23,7 @@ import Data.Text.Encoding (encodeUtf8)
2223import Reflex
2324import Reflex.Host.Class
2425import Reflex.Dom.Core
25−import GHCJS.DOM.Document (getCookie, Document)
26+import "ghcjs-dom" GHCJS.DOM.Document (getCookie, Document)
2627import GHCJS.DOM.Types (MonadJSM)
2728import Web.Cookie
2829
lib/route/src/Obelisk/Route.hs+75−36
@@ -20,10 +20,11 @@
2020{-# LANGUAGE ViewPatterns #-}
2121module Obelisk.Route
2222 ( R
23− , pattern (:/)
2423 , (:.)
25− , pattern (:.)
24+ , (?/)
2625 , hoistR
26+ , pattern (:.)
27+ , pattern (:/)
2728 , PageName
2829 , PathQuery
2930 , Encoder
@@ -49,6 +50,7 @@ module Obelisk.Route
4950 , pathParamEncoder
5051 , pathLiteralEncoder
5152 , singletonListEncoder
53+ , packTextEncoder
5254 , unpackTextEncoder
5355 , prefixTextEncoder
5456 , unsafeTshowEncoder
@@ -59,6 +61,7 @@ module Obelisk.Route
5961 , justEncoder
6062 , nothingEncoder
6163 , isoEncoder
64+ , viewEncoder
6265 , wrappedEncoder
6366 , unwrappedEncoder
6467 , listToNonEmptyEncoder
@@ -67,6 +70,7 @@ module Obelisk.Route
6770 , toListMapEncoder
6871 , shadowEncoder
6972 , prismEncoder
73+ , reviewEncoder
7074 , rPrism
7175 , _R
7276 , obeliskRouteEncoder
@@ -131,6 +135,7 @@ import Control.Lens
131135 , Prism'
132136 , prism'
133137 , re
138+ , review
134139 , view
135140 , Wrapped (..)
136141 )
@@ -158,6 +163,7 @@ import Data.Set (Set)
158163import qualified Data.Set as Set
159164import Data.Some (Some(Some))
160165import Data.Text (Text)
166+import Data.Text.Lens (IsText, packed, unpacked)
161167import qualified Data.Text as T
162168import qualified Data.Text.Encoding as T
163169import Data.Universe
@@ -194,10 +200,16 @@ import Data.Aeson (FromJSON, ToJSON)
194200
195201type R f = DSum f Identity --TODO: Better name
196202
197−{-# COMPLETE (:/) #-}
198−infixr 5 :/
203+-- | Convenience builder for an 'R' using 'Identity' for the functor.
199204pattern (:/) :: f a -> a -> R f
200205pattern a :/ b = a :=> Identity b
206+{-# COMPLETE (:/) #-}
207+infixr 5 :/
208+
209+-- | Like '(:/)' but adds a 'Just' wrapper around the right-hand side.
210+(?/) :: f (Maybe a) -> a -> R f
211+r ?/ a = r :/ Just a
212+infixr 5 ?/
201213
202214mapSome :: (forall a. f a -> g a) -> Some f -> Some g
203215mapSome f (Some a) = Some $ f a
@@ -331,7 +343,7 @@ instance Monad parse => Bifunctor (,) (EncoderImpl parse) (EncoderImpl parse) (E
331343 }
332344
333345instance (Monad parse, Applicative check) => Braided (Encoder check parse) (,) where
334− braid = isoEncoder (iso swap swap)
346+ braid = viewEncoder (iso swap swap)
335347
336348
337349instance (Applicative check, Monad parse) => PFunctor (,) (Encoder check parse) (Encoder check parse) where
@@ -367,11 +379,11 @@ instance (Monad parse, Applicative check) => Bifunctor Either (Encoder check par
367379 bimap f g = Encoder $ liftA2 bimap (unEncoder f) (unEncoder g)
368380
369381instance (Applicative check, Monad parse) => Associative (Encoder check parse) Either where
370− associate = isoEncoder (iso (associate @(->) @Either) disassociate)
371− disassociate = isoEncoder (iso disassociate associate)
382+ associate = viewEncoder (iso (associate @(->) @Either) disassociate)
383+ disassociate = viewEncoder (iso disassociate associate)
372384
373385instance (Monad parse, Applicative check) => Braided (Encoder check parse) Either where
374− braid = isoEncoder (iso swap swap)
386+ braid = viewEncoder (iso swap swap)
375387
376388
377389
@@ -425,17 +437,17 @@ instance (Applicative check, Monad parse) => Monoidal (Encoder check parse) (,)
425437--------------------------------------------------------------------------------
426438
427439-- | Given a valid 'Iso' from lens, construct an 'Encoder'
428−isoEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
429−isoEncoder f = unsafeMkEncoder $ EncoderImpl
440+viewEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
441+viewEncoder f = unsafeMkEncoder $ EncoderImpl
430442 { _encoderImpl_encode = view f
431443 , _encoderImpl_decode = pure . view (from f)
432444 }
433445
434446wrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse (Unwrapped a) a
435−wrappedEncoder = isoEncoder $ from _Wrapped'
447+wrappedEncoder = viewEncoder $ from _Wrapped'
436448
437449unwrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse a (Unwrapped a)
438−unwrappedEncoder = isoEncoder _Wrapped'
450+unwrappedEncoder = viewEncoder $ _Wrapped'
439451
440452maybeToEitherEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a) (Either () a)
441453maybeToEitherEncoder = unsafeMkEncoder $ EncoderImpl
@@ -460,11 +472,11 @@ maybeEncoder f g = shadowEncoder f g . maybeToEitherEncoder
460472
461473-- | Encode a value by simply applying 'Just'
462474justEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a (Maybe a)
463−justEncoder = prismEncoder _Just
475+justEncoder = reviewEncoder _Just
464476
465477-- | Encode () to 'Nothing'.
466478nothingEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse () (Maybe a)
467−nothingEncoder = prismEncoder _Nothing
479+nothingEncoder = reviewEncoder _Nothing
468480
469481someConstEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Const a)) a
470482someConstEncoder = unsafeMkEncoder $ EncoderImpl
@@ -749,11 +761,11 @@ prefixNonemptyTextEncoder p = Encoder $ pure $ EncoderImpl
749761 Just stripped -> pure stripped
750762 }
751763
752−unpackTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse Text String
753−unpackTextEncoder = Encoder $ pure $ EncoderImpl
754− { _encoderImpl_encode = T.unpack
755− , _encoderImpl_decode = pure . T.pack
756− }
764+packTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse String text
765+packTextEncoder = isoEncoder packed
766+
767+unpackTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse text String
768+unpackTextEncoder = isoEncoder unpacked
757769
758770toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
759771toListMapEncoder = Encoder $ pure $ EncoderImpl
@@ -818,12 +830,19 @@ _R variant = dSumGEqPrism variant . iso runIdentity Identity
818830
819831-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
820832-- if the prism doesn't match.
821−prismEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
822−prismEncoder p = unsafeMkEncoder $ EncoderImpl
823− { _encoderImpl_encode = (^. re p)
833+--
834+-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
835+-- (i.e. 'reviewEncoder' is a contravariant functor from the category of prisms to the category of encoders),
836+-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
837+-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
838+-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
839+-- reverse direction. In short @reviewEncoder (f . g) = reviewEncoder g . reviewEncoder f@.
840+reviewEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
841+reviewEncoder p = unsafeMkEncoder $ EncoderImpl
842+ { _encoderImpl_encode = review p
824843 , _encoderImpl_decode = \r -> case r ^? p of
825844 Just a -> pure a
826− Nothing -> throwError "prismEncoder: value is not present in the prism"
845+ Nothing -> throwError "reviewEncoder: value is not present in the prism"
827846 }
828847
829848-- | A URL path and query string, in which trailing slashes don't matter in the path
@@ -1019,17 +1038,6 @@ void1Encoder = Encoder $ pure $ EncoderImpl
10191038instance GShow Void1 where
10201039 gshowsPrec _ = \case {}
10211040
1022−concat <$> mapM deriveRouteComponent
1023− [ ''ResourceRoute
1024− , ''JSaddleWarpRoute
1025− , ''IndexOnlyRoute
1026− ]
1027−
1028−makePrisms ''ObeliskRoute
1029−makePrisms ''FullRoute
1030−deriveGEq ''Void1
1031−deriveGCompare ''Void1
1032−
10331041-- | Given a backend route and a checked route encoder, render the route (path
10341042-- and query string). See 'checkEncoder' for how to produce a checked encoder.
10351043renderBackendRoute
@@ -1062,11 +1070,11 @@ readShowEncoder :: (MonadError Text parse, Read a, Show a, Applicative check) =>
10621070readShowEncoder = singlePathSegmentEncoder . unsafeTshowEncoder
10631071
10641072integralEncoder :: (MonadError Text parse, Applicative check, Integral a) => Encoder check parse a Integer
1065−integralEncoder = prismEncoder (Numeric.Lens.integral)
1073+integralEncoder = reviewEncoder (Numeric.Lens.integral)
10661074
10671075pathSegmentEncoder :: (MonadError Text parse, Applicative check, Cons as as a a) =>
10681076 Encoder check parse (a, (as, b)) (as, b)
1069−pathSegmentEncoder = first (prismEncoder _Cons) . disassociate
1077+pathSegmentEncoder = first (reviewEncoder _Cons) . disassociate
10701078
10711079newtype Decoder check parse b a = Decoder { toEncoder :: Encoder check parse a b }
10721080
@@ -1173,3 +1181,34 @@ byteStringsToPageName p q =
11731181 in decode pageNameEncoder' (T.unpack (T.decodeUtf8 p), T.unpack (T.decodeUtf8 q))
11741182
11751183--TODO: decodeURIComponent as appropriate
1184+
1185+
1186+{-# DEPRECATED isoEncoder "Instead of 'isoEncoder f', use 'viewEncoder f'" #-}
1187+-- | Given a valid 'Iso' from lens, construct an 'Encoder'
1188+isoEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
1189+isoEncoder = viewEncoder
1190+
1191+{-# DEPRECATED prismEncoder "Instead of 'prismEncoder f', use 'reviewEncoder f'" #-}
1192+-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
1193+-- if the prism doesn't match.
1194+--
1195+-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
1196+-- (i.e. 'prismEncoder' is a contravariant functor from the category of prisms to the category of encoders),
1197+-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
1198+-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
1199+-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
1200+-- reverse direction. In short @prismEncoder (f . g) = prismEncoder g . prismEncoder f@.
1201+prismEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
1202+prismEncoder = reviewEncoder
1203+
1204+
1205+concat <$> mapM deriveRouteComponent
1206+ [ ''ResourceRoute
1207+ , ''JSaddleWarpRoute
1208+ , ''IndexOnlyRoute
1209+ ]
1210+
1211+makePrisms ''ObeliskRoute
1212+makePrisms ''FullRoute
1213+deriveGEq ''Void1
1214+deriveGCompare ''Void1
lib/route/src/Obelisk/Route/Frontend.hs+80−16
@@ -7,15 +7,11 @@
77{-# LANGUAGE FlexibleContexts #-}
88{-# LANGUAGE FlexibleInstances #-}
99{-# LANGUAGE GADTs #-}
10−{-# LANGUAGE KindSignatures #-}
1110{-# LANGUAGE LambdaCase #-}
12−{-# LANGUAGE MultiParamTypeClasses #-}
1311{-# LANGUAGE OverloadedStrings #-}
1412{-# LANGUAGE PatternSynonyms #-}
1513{-# LANGUAGE RankNTypes #-}
1614{-# LANGUAGE ScopedTypeVariables #-}
17−{-# LANGUAGE TemplateHaskell #-}
18−{-# LANGUAGE TupleSections #-}
1915{-# LANGUAGE TypeFamilies #-}
2016{-# LANGUAGE TypeOperators #-}
2117{-# LANGUAGE ViewPatterns #-}
@@ -64,7 +60,7 @@ import Prelude hiding ((.), id)
6460import Obelisk.Route
6561
6662import Control.Category (Category (..), (.))
67−import Control.Category.Cartesian
63+import Control.Category.Cartesian ((&&&))
6864import Control.Lens hiding (Bifunctor, bimap, universe, element)
6965import Control.Monad ((<=<))
7066import Control.Monad.Fix
@@ -94,7 +90,9 @@ import Reflex.Dom.Builder.Class
9490import Data.Type.Coercion
9591import Language.Javascript.JSaddle --TODO: Get rid of this - other platforms can also be routed
9692import Reflex.Dom.Core
93+import qualified GHCJS.DOM as DOM
9794import qualified GHCJS.DOM.Types as DOM
95+import qualified GHCJS.DOM.Window as Window
9896import Network.URI
9997import Data.Maybe (fromMaybe)
10098import qualified Data.List as L
@@ -511,59 +509,125 @@ runRouteViewT routeEncoder switchover useHash a = do
511509-- | A link widget that, when clicked, sets the route to the provided route. In non-javascript
512510-- contexts, this widget falls back to using @href@s to control navigation
513511routeLink
514− :: forall t m a route.
512+ :: forall t m a route js.
515513 ( DomBuilder t m
516514 , RouteToUrl route m
517515 , SetRoute t route m
516+ , Prerender js t m
518517 )
519518 => route -- ^ Target route
520519 -> m a -- ^ Child widget
521520 -> m a
522521routeLink r w = do
522+ (e, a) <- routeLinkImpl r w
523+ scrollToTop e
524+ return a
525+
526+-- | Raw implementation of 'routeLink'. Does not scroll to the top of the page on clicks.
527+routeLinkImpl
528+ :: forall t m a route.
529+ ( DomBuilder t m
530+ , RouteToUrl route m
531+ , SetRoute t route m
532+ )
533+ => route -- ^ Target route
534+ -> m a -- ^ Child widget
535+ -> m (Event t (), a)
536+routeLinkImpl r w = do
523537 enc <- askRouteToUrl
524538 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
525539 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
526540 & elementConfig_initialAttributes .~ "href" =: enc r
527541 (e, a) <- element "a" cfg w
528542 setRoute $ r <$ domEvent Click e
529− return a
543+ return (domEvent Click e, a)
544+
545+scrollToTop :: forall m t js. (Prerender js t m, Monad m) => Event t () -> m ()
546+scrollToTop e = prerender_ blank $ performEvent_ $ ffor e $ \_ -> liftJSM $ DOM.currentWindow >>= \case
547+ Nothing -> pure ()
548+ Just win -> Window.scrollTo win 0 0
530549
531550-- | Like 'routeLinkDynAttr' but without custom attributes.
532551dynRouteLink
533− :: forall t m a route.
552+ :: forall t m a route js.
534553 ( DomBuilder t m
535554 , PostBuild t m
536− , RouteToUrl (R route) m
537− , SetRoute t (R route) m
555+ , RouteToUrl route m
556+ , SetRoute t route m
557+ , Prerender js t m
538558 )
539− => Dynamic t (R route) -- ^ Target route
540− -> m a -- ^ Child widget of the @a@ element
559+ => Dynamic t route -- ^ Target route
560+ -> m a -- ^ Child widget
541561 -> m a
542−dynRouteLink = routeLinkDynAttr mempty
562+dynRouteLink r w = do
563+ (e, a) <- dynRouteLinkImpl r w
564+ scrollToTop e
565+ return a
566+
567+-- | Raw implementation of 'dynRouteLink'. Does not scroll to the top of the page on clicks.
568+dynRouteLinkImpl
569+ :: forall t m a route.
570+ ( DomBuilder t m
571+ , PostBuild t m
572+ , RouteToUrl route m
573+ , SetRoute t route m
574+ )
575+ => Dynamic t route -- ^ Target route
576+ -> m a -- ^ Child widget
577+ -> m (Event t (), a)
578+dynRouteLinkImpl dr w = do
579+ enc <- askRouteToUrl
580+ er <- dynamicAttributesToModifyAttributes $ ("href" =:) . enc <$> dr
581+ let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
582+ & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
583+ & elementConfig_modifyAttributes .~ er
584+ (e, a) <- element "a" cfg w
585+ let clk = domEvent Click e
586+ setRoute $ tag (current dr) clk
587+ return (clk, a)
543588
544589-- | An @a@-tag link widget that, when clicked, sets the route to current value of the
545590-- provided dynamic route. In non-JavaScript contexts the value of the dynamic post
546591-- build is used so the link still works like 'routeLink'.
547592routeLinkDynAttr
548− :: forall t m a route.
593+ :: forall t m a route js.
549594 ( DomBuilder t m
550595 , PostBuild t m
551596 , RouteToUrl (R route) m
552597 , SetRoute t (R route) m
598+ , Prerender js t m
553599 )
554600 => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
555601 -> Dynamic t (R route) -- ^ Target route
556602 -> m a -- ^ Child widget of the @a@ element
557603 -> m a
558604routeLinkDynAttr dAttr dr w = do
605+ (e, a) <- routeLinkDynAttrImpl dAttr dr w
606+ scrollToTop e
607+ return a
608+
609+-- | Raw implementation of 'routeLinkDynAttr'. Does not scroll to the top of the page on clicks.
610+routeLinkDynAttrImpl
611+ :: forall t m a route.
612+ ( DomBuilder t m
613+ , PostBuild t m
614+ , RouteToUrl (R route) m
615+ , SetRoute t (R route) m
616+ )
617+ => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
618+ -> Dynamic t (R route) -- ^ Target route
619+ -> m a -- ^ Child widget of the @a@ element
620+ -> m (Event t (), a)
621+routeLinkDynAttrImpl dAttr dr w = do
559622 enc <- askRouteToUrl
560623 er <- dynamicAttributesToModifyAttributes $ zipDynWith (<>) (("href" =:) . enc <$> dr) dAttr
561624 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
562625 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
563626 & elementConfig_modifyAttributes .~ er
564627 (e, a) <- element "a" cfg w
565− setRoute $ tag (current dr) $ domEvent Click e
566− return a
628+ let clk = domEvent Click e
629+ setRoute $ tag (current dr) clk
630+ return (clk, a)
567631
568632-- On ios due to sandboxing when loading the page from a file adapt the
569633-- path to be based on the hash.
lib/run/src/Obelisk/Run.hs+11−6
@@ -79,7 +79,7 @@ import qualified System.Which
7979run
8080 :: Int -- ^ Port to run the backend
8181 -> ([Text] -> Snap ()) -- ^ Static asset handler
82− -> Backend fullRoute frontendRoute -- ^ Backend
82+ -> Backend backendRoute frontendRoute -- ^ Backend
8383 -> Frontend (R frontendRoute) -- ^ Frontend
8484 -> IO ()
8585run port serveStaticAsset backend frontend = do
@@ -90,14 +90,18 @@ run port serveStaticAsset backend frontend = do
9090 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
9191 Right validFullEncoder -> do
9292 publicConfigs <- getPublicConfigs
93− backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $ do
94− _backend_run backend $ \serveRoute -> do
95− runSnapWithCommandLineArgs $ do
93+ backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $
94+ _backend_run backend $ \serveRoute ->
95+ runSnapWithCommandLineArgs $
9696 getRouteWith validFullEncoder >>= \case
9797 Identity r -> case r of
9898 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
9999 FullRoute_Frontend obeliskRoute :/ a ->
100− serveDefaultObeliskApp (mkRouteToUrl validFullEncoder) serveStaticAsset frontend publicConfigs $ obeliskRoute :/ a
100+ serveDefaultObeliskApp appRouteToUrl (($ allJsUrl) <$> defaultGhcjsWidgets) serveStaticAsset frontend publicConfigs $ obeliskRoute :/ a
101+ where
102+ appRouteToUrl (k :/ v) = renderObeliskRoute validFullEncoder (FullRoute_Frontend (ObeliskRoute_App k) :/ v)
103+ allJsUrl = renderAllJsPath validFullEncoder
104+
101105 let conf = defRunConfig { _runConfig_redirectPort = port }
102106 runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
103107
@@ -189,7 +193,8 @@ obeliskApp configs opts frontend validFullEncoder uri backend = do
189193 }
190194 FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
191195 let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
192− html <- renderJsaddleFrontend configs cookies (mkRouteToUrl validFullEncoder) (appRouteComponent :/ appRouteRest) frontend
196+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
197+ html <- renderJsaddleFrontend configs cookies routeToUrl (appRouteComponent :/ appRouteRest) frontend
193198 sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
194199 _ -> backend req sendResponse
195200
lib/selftest/obelisk-selftest.cabal+3−1
@@ -9,6 +9,8 @@ library
99 hs-source-dirs: src
1010 build-depends:
1111 base
12+ , bytestring
13+ , aeson
1214 , containers
1315 , directory
1416 , filepath
@@ -17,9 +19,9 @@ library
1719 , http-types
1820 , HUnit
1921 , network
20− , obelisk-cliapp
2122 , obelisk-executable-config-lookup
2223 , obelisk-run
24+ , which
2325 , process
2426 , shelly >= 1.9.0
2527 , temporary
lib/selftest/src/Obelisk/SelfTest.hs+468−220
@@ -1,40 +1,48 @@
1+{-# LANGUAGE DoAndIfThenElse #-}
12{-# LANGUAGE EmptyCase #-}
23{-# LANGUAGE LambdaCase #-}
34{-# LANGUAGE OverloadedStrings #-}
45{-# LANGUAGE PatternGuards #-}
56{-# LANGUAGE ScopedTypeVariables #-}
7+{-# LANGUAGE TemplateHaskell #-}
8+{-# LANGUAGE TypeApplications #-}
69{-# LANGUAGE ViewPatterns #-}
710module Obelisk.SelfTest where
811
9−import Control.Exception (bracket, throw)
12+import Control.Concurrent (threadDelay)
13+import Control.Exception (bracket, throw, try)
1014import Control.Monad
1115import Control.Monad.IO.Class
16+import qualified Data.Aeson as Aeson
17+import qualified Data.Aeson.Types as Aeson
1218import Data.Bool (bool)
19+import qualified Data.ByteString.Lazy as LBS
20+import Data.Foldable (for_)
1321import Data.Function (fix)
14−import Data.Semigroup (Semigroup, (<>))
22+import qualified Data.Map as Map
23+import Data.Semigroup ((<>))
1524import qualified Data.Set as Set
1625import Data.String
1726import Data.Text (Text)
18−import Data.Void
1927import qualified Data.Text as T
28+import qualified Data.Text.Encoding as T
2029import qualified Data.Text.IO as T
2130import qualified Network.HTTP.Client as HTTP
2231import qualified Network.HTTP.Types as HTTP
2332import qualified Network.Socket as Socket
2433import Shelly
25−import System.Directory (withCurrentDirectory, getDirectoryContents)
34+import System.Directory (getCurrentDirectory, withCurrentDirectory, getDirectoryContents)
2635import System.Environment
2736import System.Exit (ExitCode (..))
28−import System.FilePath (replaceBaseName, takeBaseName)
37+import System.FilePath (addTrailingPathSeparator)
2938import qualified System.Info
30−import System.IO (Handle, hClose)
39+import System.IO (Handle, hClose, hIsEOF, hGetContents)
3140import System.IO.Temp
32−import System.Process (readProcessWithExitCode, CreateProcess(cwd), readCreateProcessWithExitCode, proc)
41+import System.Process (readProcessWithExitCode)
42+import System.Which (staticWhich)
3343import Test.Hspec
3444import Test.HUnit.Base
3545
36−import Obelisk.CliApp hiding (runCli, readCreateProcessWithExitCode)
37−import qualified Obelisk.CliApp as CliApp
3846import Obelisk.ExecutableConfig.Lookup (getConfigs)
3947import Obelisk.Run (getConfigRoute)
4048
@@ -44,24 +52,53 @@ data ObRunState
4452 | ObRunState_BackendStarted
4553 deriving (Eq, Show)
4654
47−doubleQuotes :: (IsString a, Semigroup a) => a -> a
48−doubleQuotes s = "\"" <> s <> "\""
55+cpPath :: FilePath
56+cpPath = $(staticWhich "cp")
57+
58+cabalPath :: FilePath
59+cabalPath = $(staticWhich "cabal")
60+
61+gitPath :: FilePath
62+gitPath = $(staticWhich "git")
63+
64+chownPath :: FilePath
65+chownPath = $(staticWhich "chown")
66+
67+chmodPath :: FilePath
68+chmodPath = $(staticWhich "chmod")
69+
70+whoamiPath :: FilePath
71+whoamiPath = $(staticWhich "whoami")
72+
73+nixInstantiatePath :: FilePath
74+nixInstantiatePath = $(staticWhich "nix-instantiate")
75+
76+nixBuildPath :: FilePath
77+nixBuildPath = $(staticWhich "nix-build")
78+
79+nixPrefetchGitPath :: FilePath
80+nixPrefetchGitPath = $(staticWhich "nix-prefetch-git")
81+
82+lnPath :: FilePath
83+lnPath = $(staticWhich "ln")
84+
85+rmPath :: FilePath
86+rmPath = $(staticWhich "rm")
87+
88+rsyncPath :: FilePath
89+rsyncPath = $(staticWhich "rsync")
90+
91+gitUserConfig :: [Text]
92+gitUserConfig = ["-c", "user.name=Obelisk Selftest", "-c", "user.email=noreply@example.com"]
4993
5094commit :: Text -> Sh ()
51−commit msg = void $ run "git"
52− [ "commit"
95+commit msg = void $ run gitPath $ gitUserConfig <> [ "commit"
5396 , "--no-gpg-sign"
5497 , "--allow-empty"
5598 , "-m"
56− , doubleQuotes msg
99+ , msg
57100 ]
58101
59−-- TODO replace Void and stop using loosely typed synchronous exceptions
60−runCli :: MonadIO m => CliT Void IO a -> m a
61−runCli f = liftIO $ do
62− c <- newCliConfig Notice False False (\case {})
63− CliApp.runCli c f
64−
65102tshow :: Show a => a -> Text
66103tshow = T.pack . show
67104
@@ -69,228 +106,322 @@ tshow = T.pack . show
69106shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
70107shellyOb f obTest = shelly $ f obTest
71108
109+-- Set "ob" in a single place so it can be replaced with a
110+-- link to obelisk in the nix store in the future,
111+-- and avoid PATH hacking before calling this script.
112+ob :: FilePath
113+ob = "ob"
114+
115+augmentWithVerbosity :: (String -> [Text] -> a) -> String -> Bool -> [Text] -> a
116+augmentWithVerbosity runner executable isVerbose args = runner executable $ (if isVerbose then ("-v" :) else id) args
117+
118+isolatedGitShell :: Bool -> FilePath -> (([Text] -> Sh Text) -> Sh a) -> IO a
119+isolatedGitShell isVerbose dir f = shelly $ bool silently verbosely isVerbose $ do
120+ setenv "HOME" "/dev/null"
121+ setenv "GIT_CONFIG_NOSYSTEM" "1"
122+ _ <- git ["init"]
123+ _ <- git ["config", "user.name", "SelfTest"]
124+ _ <- git ["config", "user.email", "self@test"]
125+ f git
126+ where
127+ git args = run gitPath $ ["-C", toTextIgnore dir] <> args
128+
129+-- | Copies a git repo to a new location and "resets" the git history to include
130+-- exactly one commit with all files added. It then restricts writing and reading
131+-- for group and user to make the repo ideal for being a valid git remote for thunks.
132+--
133+-- Using this allows dirty repos to be used as git remotes during the test since 'git clone'ing
134+-- a dirty repo will not include the uncommitted changes.
135+copyForGitRemote :: Bool -> FilePath -> FilePath -> IO ()
136+copyForGitRemote isVerbose origDir copyDir = isolatedGitShell isVerbose copyDir $ \git -> do
137+ run_ rsyncPath
138+ [ "-r", "--no-perms", "--no-owner", "--no-group", "--exclude", ".git"
139+ , toTextIgnore (addTrailingPathSeparator origDir), toTextIgnore copyDir
140+ ]
141+ _ <- git ["add", "--all"]
142+ _ <- git ["commit", "-m", "Copy repo"]
143+ run_ chmodPath ["-R", "u-w,g-rw,o-rw", toTextIgnore copyDir] -- Freeze this state
144+
72145main :: IO ()
73146main = do
74147 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
75148 isVerbose <- elem "-v" <$> getArgs
76149 unless isVerbose $
77150 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
78− let verbosity = bool silently verbosely isVerbose
79− nixBuild args = run "nix-build" ("--no-out-link" : args)
80− obeliskImplRaw <- fromString <$> getEnv "OBELISK_IMPL"
81− let
82− withObeliskImpl f =
83− withSystemTempDirectory "obelisk-impl-copy" $ \(fromString -> obeliskImpl) -> do
84− void . shellyOb verbosity $ chdir obeliskImpl $ do
85− user <- T.strip <$> run "whoami" []
86− run_ "cp" ["-rT", toTextIgnore obeliskImplRaw, toTextIgnore obeliskImpl]
87− run_ "chown" ["-R", user, toTextIgnore obeliskImpl]
88− run_ "chmod" ["-R", "g-rw,o-rw", toTextIgnore obeliskImpl]
89−
90− withSystemTempDirectory "init Cache λ" $ \initCache -> do
91− -- Setup the ob init cache
92− void . shellyOb verbosity $ chdir (fromString initCache) $ do
93− run_ "ob" ["init", "--symlink", toTextIgnore obeliskImpl]
94− run_ "git" ["init"]
95−
96− f obeliskImpl initCache
97151
152+ obeliskImplDirtyReadOnly <- getCurrentDirectory
98153 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
99154
100− withObeliskImpl $ \obeliskImpl initCache ->
101− hspec $ parallel $ do
102− let shelly_ = void . shellyOb verbosity
103−
104− inTmp :: (FilePath -> Sh a) -> IO ()
105− inTmp f = withTmp (chdir <*> f)
106−
107− withTmp f = shelly_ . withSystemTempDirectory "test λ" $ f . fromString
108−
109− inTmpObInit f = inTmp $ \dir -> do
110− run_ "cp" ["-rT", fromString initCache, toTextIgnore dir]
111− f dir
112−
113− assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
114− assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
115−
116− revParseHead = T.strip <$> run "git" ["rev-parse", "HEAD"]
117−
118− commitAll = do
119− run_ "git" ["add", "."]
120− commit "checkpoint"
121− revParseHead
122−
123− thunk = ".obelisk/impl"
124− update = run "ob" ["thunk", "update", thunk] >> commitAll
125− pack = run "ob" ["thunk", "pack", thunk] >> commitAll
126− unpack = run "ob" ["thunk", "unpack", thunk] >> commitAll
127−
128− diff a b = run "git" ["diff", a, b]
129−
130− describe "ob init" $ parallel $ do
131− it "works with default impl" $ inTmp $ \_ -> run "ob" ["init"]
132− it "works with master branch impl" $ inTmp $ \_ -> run "ob" ["init", "--branch", "master"]
133− it "works with symlink" $ inTmp $ \_ -> run "ob" ["init", "--symlink", toTextIgnore obeliskImpl]
134− it "doesn't silently overwrite existing files" $ withSystemTempDirectory "ob-init λ" $ \dir -> do
135− let p force = (System.Process.proc "ob" $ "--no-handoff" : "init" : ["--force"|force]) { cwd = Just dir }
136− (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p False) ""
137− (ExitFailure _, _, _) <- readCreateProcessWithExitCode (p False) ""
138− (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p True) ""
139− pure ()
140−
141− it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
142− void $ errExit False $ run "ob" ["init", "--symlink", "/dev/null"]
143− ls tmp >>= liftIO . assertEqual "" []
144−
145− it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $
146− withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ do
147− configs <- getConfigs
148− return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
149−
150− -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
151− -- when not run by 'nix-build --attr selftest'
152− describe "ob run" $ {- NOT parallel $ -} do
153− it "works in root directory" $ inTmpObInit $ \_ -> testObRunInDir Nothing httpManager
154− it "works in sub directory" $ inTmpObInit $ \_ -> testObRunInDir (Just "frontend") httpManager
155− it "works with differently named cabal files" $ inTmpObInit $ \_ -> do
156− changeCabalPackageName "backend/backend.cabal" "new-backend"
157− testObRunInDir Nothing httpManager
158−
159− describe "obelisk project" $ parallel $ do
160− it "can build obelisk command" $ inTmpObInit $ \_ -> nixBuild ["-A", "command" , toTextIgnore obeliskImpl]
161− it "can build obelisk skeleton" $ inTmpObInit $ \_ -> nixBuild ["-A", "skeleton", toTextIgnore obeliskImpl]
162− it "can build obelisk shell" $ inTmpObInit $ \_ -> nixBuild ["-A", "shell", toTextIgnore obeliskImpl]
163− it "can build everything" $ inTmpObInit $ \_ -> nixBuild [toTextIgnore obeliskImpl]
164−
165− describe "blank initialized project" $ parallel $ do
166−
167− it "can build ghc.backend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghc.backend"]
168− it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghcjs.frontend"]
169−
170− if System.Info.os == "darwin"
171− then it "can build ios" $ inTmpObInit $ \_ -> nixBuild ["-A", "ios.frontend"]
172− else it "can build android after accepting license" $ inTmpObInit $ \dir -> do
173− let defaultNixPath = dir </> ("default.nix" :: FilePath)
174− writefile defaultNixPath
175− =<< T.replace
176− "# config.android_sdk.accept_license = false;"
177− "config.android_sdk.accept_license = true;"
178− <$> readfile defaultNixPath
179− nixBuild ["-A", "android.frontend"]
180−
181− forM_ ["ghc", "ghcjs"] $ \compiler -> do
182− let
183− shellName = "shells." <> compiler
184− inShell cmd' = run "nix-shell" ["default.nix", "-A", fromString shellName, "--run", cmd']
185− it ("can enter " <> shellName) $ inTmpObInit $ \_ -> inShell "exit"
186− it ("can build in " <> shellName) $ inTmpObInit $ \_ -> inShell $ "cabal new-build --" <> fromString compiler <> " all"
187−
188− it "has idempotent thunk update" $ inTmpObInit $ \_ -> do
189− _ <- pack
190− u <- update
191− uu <- update
192− assertRevEQ u uu
193−
194− describe "ob thunk pack/unpack" $ parallel $ do
195− it "has thunk pack and unpack inverses" $ inTmpObInit $ \_ -> do
196−
197− _ <- pack
198− e <- commitAll
199− eu <- unpack
200− eup <- pack
201− eupu <- unpack
202− _ <- pack
203−
204− assertRevEQ e eup
205− assertRevEQ eu eupu
206− assertRevNE e eu
207−
208− it "unpacks the correct branch" $ withTmp $ \dir -> do
209− let branch = "master"
210− run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
211− run_ "ob" ["thunk", "pack", toTextIgnore dir]
212− run_ "ob" ["thunk", "unpack", toTextIgnore dir]
213− branch' <- chdir dir $ run "git" ["rev-parse", "--abbrev-ref", "HEAD"]
214− liftIO $ assertEqual "" branch (T.strip branch')
215−
216− it "can pack and unpack plain git repos" $
217− shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
218− let repo = toTextIgnore $ dir </> ("repo" :: String)
219− run_ "git" ["clone", "https://github.com/haskell/process.git", repo]
220− origHash <- chdir (fromText repo) revParseHead
221−
222− run_ "ob" ["thunk", "pack", repo]
223− packedFiles <- Set.fromList <$> ls (fromText repo)
224− liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
225− ["default.nix", "github.json", ".attr-cache" :: String]
226−
227− run_ "ob" ["thunk", "unpack", repo]
228− chdir (fromText repo) $ do
229− unpackHash <- revParseHead
230− assertRevEQ origHash unpackHash
231−
232− testThunkPack $ fromText repo
233−
234− it "aborts thunk pack when there are uncommitted files" $ inTmpObInit $ \dir -> do
235− testThunkPack (dir </> thunk)
236−
237− describe "ob thunk update --branch" $ parallel $ do
238− it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
239− let branch1 = "master"
240− branch2 = "develop"
241− run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
242− run_ "ob" ["thunk" , "pack", toTextIgnore dir]
243− run_ "ob" ["thunk", "update", toTextIgnore dir, "--branch", branch2]
244−
245− it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
246− let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
247− run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
248− run_ "ob" ["thunk" , "pack", toTextIgnore dir]
249− startingContents <- checkDir dir
250− void $ errExit False $ run "ob" ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
251− checkDir dir >>= liftIO . assertEqual "" startingContents
155+ withSystemTempDirectory "obelisk-repo-git-remote" $ \copyDir -> do
156+ copyForGitRemote isVerbose obeliskImplDirtyReadOnly copyDir
157+ main' isVerbose httpManager copyDir
158+
159+main' :: Bool -> HTTP.Manager -> FilePath -> IO ()
160+main' isVerbose httpManager obeliskRepoReadOnly = withInitCache $ \initCache -> hspec $ parallel $ do
161+ let
162+ inTmpObInit' dirname f = inTmp' dirname $ \dir -> do
163+ run_ cpPath ["-rT", fromString initCache, toTextIgnore dir]
164+ f dir
165+ inTmpObInit = inTmpObInit' defaultTmpDirName
166+
167+ -- To be used in tests that change the obelisk impl directory
168+ inTmpObInitWithImplCopy f = inTmpObInit $ \dir ->
169+ withObeliskImplClean $ \(fromString -> implClean) -> do
170+ run_ rmPath [thunk]
171+ run_ lnPath ["-s", implClean, thunk]
172+ f dir
173+
174+ describe "ob init" $ parallel $ do
175+ it "works with default impl" $ inTmp $ \_ -> runOb ["init"]
176+ it "works with master branch impl" $ inTmp $ \_ -> runOb ["init", "--branch", "master"]
177+ it "works with symlink" $ inTmp $ \_ -> runOb ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
178+ it "doesn't silently overwrite existing files" $ inTmp $ \_ -> do
179+ let p force = errExit False $ do
180+ run_ ob $ "--no-handoff" : "-v" : "init" : ["--force"|force]
181+ (== 0) <$> lastExitCode
182+
183+ True <- p False
184+ False <- p False
185+ True <- p True
186+ pure ()
187+
188+ it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
189+ void $ errExit False $ runOb ["init", "--symlink", "/dev/null"]
190+ ls tmp >>= liftIO . assertEqual "" []
191+
192+ it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $
193+ withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ do
194+ configs <- getConfigs
195+ return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
196+
197+ it "can unpack and repack .obelisk/impl after init with master branch impl" $ inTmp $ \_ -> do
198+ runOb_ ["init", "--branch", "master"]
199+ runOb_ ["thunk", "unpack", ".obelisk/impl"]
200+ runOb_ ["thunk", "pack", ".obelisk/impl"]
201+
202+ -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
203+ -- when not run by 'nix-build --attr selftest'
204+ describe "ob run" $ {- NOT parallel $ -} do
205+ it "works in root directory" $ inTmpObInit $ \_ -> testObRunInDir' Nothing httpManager
206+ it "works in sub directory" $ inTmpObInit $ \_ -> testObRunInDir' (Just "frontend") httpManager
207+
208+ describe "obelisk project" $ parallel $ do
209+ it "can build obelisk command" $ inTmpObInit $ \_ -> nixBuild ["-A", "command" , toTextIgnore obeliskRepoReadOnly]
210+ it "can build obelisk skeleton" $ inTmpObInit $ \_ -> nixBuild ["-A", "skeleton", toTextIgnore obeliskRepoReadOnly]
211+ it "can build obelisk shell" $ inTmpObInit $ \_ -> nixBuild ["-A", "shell", toTextIgnore obeliskRepoReadOnly]
212+ it "can build everything" $ inTmpObInit $ \_ -> nixBuild [toTextIgnore obeliskRepoReadOnly]
213+
214+ describe "blank initialized project" $ parallel $ do
215+
216+ it "can build ghc.backend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghc.backend"]
217+ it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghcjs.frontend"]
218+
219+ if System.Info.os == "darwin"
220+ then it "can build ios" $ inTmpObInit $ \_ -> nixBuild ["-A", "ios.frontend"]
221+ else it "can build android after accepting license" $ inTmpObInit $ \dir -> do
222+ let defaultNixPath = dir </> ("default.nix" :: FilePath)
223+ writefile defaultNixPath
224+ =<< T.replace
225+ "# config.android_sdk.accept_license = false;"
226+ "config.android_sdk.accept_license = true;"
227+ <$> readfile defaultNixPath
228+ nixBuild ["-A", "android.frontend"]
229+
230+ forM_ ["ghc", "ghcjs"] $ \compiler -> do
231+ let
232+ shellName = "shells." <> compiler
233+ inShell cmd' = run_ "nix-shell" ["default.nix", "-A", fromString shellName, "--run", cmd']
234+ it ("can enter " <> shellName) $ inTmpObInit $ \_ -> inShell "exit"
235+ -- NOTE: We override the temporary directory name because cabal has a bug preventing new-build from working
236+ -- in a path that has unicode characters.
237+ it ("can build in " <> shellName) $ inTmpObInit' "test" $ \_ -> inShell $
238+ T.pack cabalPath <> " --version; " <> T.pack cabalPath <> " new-build --" <> T.pack compiler <> " all"
239+
240+ it "has idempotent thunk update" $ inTmpObInitWithImplCopy $ \_ -> do
241+ _ <- pack
242+ u <- update
243+ uu <- update
244+ assertRevEQ u uu
245+
246+ describe "ob thunk pack/unpack" $ parallel $ do
247+ it "has thunk pack and unpack inverses" $ inTmpObInitWithImplCopy $ \_ -> do
248+
249+ _ <- pack
250+ e <- commitAll
251+ eu <- unpack
252+ eup <- pack
253+ eupu <- unpack
254+ _ <- pack
255+
256+ assertRevEQ e eup
257+ assertRevEQ eu eupu
258+ assertRevNE e eu
259+
260+ it "unpacks the correct branch" $ withTmp $ \dir -> do
261+ let branch = "master"
262+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
263+ runOb_ ["thunk", "pack", toTextIgnore dir]
264+ runOb_ ["thunk", "unpack", toTextIgnore dir]
265+ branch' <- run gitPath ["-C", toTextIgnore $ dir </> unpackedDirName, "rev-parse", "--abbrev-ref", "HEAD"]
266+ liftIO $ assertEqual "" branch (T.strip branch')
267+
268+ it "can pack and unpack plain git repos" $
269+ shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
270+ let repo = toTextIgnore $ dir </> ("repo" :: FilePath)
271+ run_ gitPath ["clone", "https://github.com/haskell/process.git", repo]
272+ origHash <- chdir (fromText repo) revParseHead
273+
274+ runOb_ ["thunk", "pack", repo]
275+ packedFiles <- Set.fromList <$> ls (fromText repo)
276+ liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
277+ ["default.nix", "thunk.nix", "github.json" :: FilePath]
278+
279+ runOb_ ["thunk", "unpack", repo]
280+ chdir (fromText repo </> unpackedDirName) $ do
281+ unpackHash <- revParseHead
282+ assertRevEQ origHash unpackHash
283+
284+ testThunkPack' $ fromText repo
285+
286+ it "aborts thunk pack when there are uncommitted files" $ inTmpObInitWithImplCopy $ \dir -> do
287+ testThunkPack' (dir </> thunk)
288+
289+ it "works on legacy git thunks" $ testLegacyGitThunks isVerbose
290+
291+ describe "ob thunk update --branch" $ parallel $ do
292+ it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
293+ let branch1 = "master"
294+ branch2 = "develop"
295+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
296+ runOb_ ["thunk" , "pack", toTextIgnore dir]
297+ runOb_ ["thunk", "update", toTextIgnore dir, "--branch", branch2]
298+
299+ it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
300+ let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
301+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
302+ runOb_ ["thunk" , "pack", toTextIgnore dir]
303+ startingContents <- checkDir dir
304+ void $ errExit False $ runOb ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
305+ checkDir dir >>= liftIO . assertEqual "" startingContents
306+
307+ describe "ob hoogle" $ {- NOT parallel -} do
308+ it "starts a hoogle server on the given port" $ inTmpObInit $ \_ -> do
309+ [p0] <- liftIO $ getFreePorts 1
310+ maskExitSuccess $ runHandle "ob" ["hoogle", "--port", T.pack (show p0)] $ \stdout -> flip fix Nothing $ \loop -> \case
311+ Nothing -> do -- Still waiting for initial signal that the server has started
312+ ln <- liftIO $ T.hGetLine stdout
313+ let search = "Server starting on port " <> T.pack (show p0)
314+ case search `T.isInfixOf` ln of
315+ False -> loop Nothing -- keep waiting
316+ True -> loop $ Just 10
317+ Just (n :: Int) -> do -- Server has started and we have n attempts left
318+ let req uri = liftIO $ try @HTTP.HttpException $ HTTP.parseRequest uri >>= flip HTTP.httpLbs httpManager
319+ req ("http://127.0.0.1:" <> show p0) >>= \case
320+ Right r | HTTP.responseStatus r == HTTP.ok200 -> exit 0
321+ e -> if n <= 0
322+ then errorExit $ "Request to hoogle server failed: " <> T.pack (show e)
323+ else liftIO (threadDelay (1*10^(6 :: Int))) *> loop (Just $ n - 1)
324+ where
325+ verbosity = bool silently verbosely isVerbose
326+ nixBuild args = run nixBuildPath ("--no-out-link" : args)
327+
328+ runOb_ = augmentWithVerbosity run_ ob isVerbose
329+ runOb = augmentWithVerbosity run ob isVerbose
330+ testObRunInDir' = augmentWithVerbosity testObRunInDir ob isVerbose ["run"]
331+ testThunkPack' = augmentWithVerbosity testThunkPack ob isVerbose []
252332
333+ withObeliskImplClean f =
334+ withSystemTempDirectory "obelisk-impl-clean" $ \obeliskImpl -> do
335+ void . shellyOb verbosity $ do
336+ dirtyFiles <- T.strip <$> run gitPath ["-C", toTextIgnore obeliskRepoReadOnly, "diff", "--stat"]
337+ () <- when (dirtyFiles /= "") $ error "SelfTest does not work correctly with dirty obelisk repos as remote"
338+ run_ gitPath ["clone", "file://" <> toTextIgnore obeliskRepoReadOnly, toTextIgnore obeliskImpl]
339+ f obeliskImpl
340+
341+ withInitCache f =
342+ withSystemTempDirectory "init Cache λ" $ \initCache -> do
343+ -- Setup the ob init cache
344+ void . shellyOb verbosity $ chdir initCache $ do
345+ runOb_ ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
346+ run_ gitPath ["init"]
347+
348+ f initCache
349+
350+ shelly_ = void . shellyOb verbosity
351+
352+ defaultTmpDirName = "test λ"
353+
354+ inTmp' :: FilePath -> (FilePath -> Sh a) -> IO ()
355+ inTmp' dirname f = withTmp' dirname (chdir <*> f)
356+ inTmp = inTmp' defaultTmpDirName
357+
358+ withTmp' dirname f = shelly_ . withSystemTempDirectory dirname $ f . fromString
359+ withTmp = withTmp' defaultTmpDirName
360+
361+ assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
362+ assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
363+
364+ revParseHead = T.strip <$> run gitPath ["rev-parse", "HEAD"]
365+
366+ commitAll = do
367+ run_ gitPath ["add", "."]
368+ commit "checkpoint"
369+ revParseHead
370+
371+ thunk = ".obelisk/impl"
372+ update = runOb ["thunk", "update", thunk] *> commitAll
373+ pack = runOb ["thunk", "pack", thunk] *> commitAll
374+ unpack = runOb ["thunk", "unpack", thunk] *> commitAll
375+
376+ diff a b = run gitPath ["diff", a, b]
377+
378+
379+maskExitSuccess :: Sh () -> Sh ()
380+maskExitSuccess = handle_sh (\case ExitSuccess -> pure (); e -> throw e)
253381
254382-- | Run `ob run` in the given directory (maximum of one level deep)
255−testObRunInDir :: Maybe FilePath -> HTTP.Manager -> Sh ()
256−testObRunInDir mdir httpManager = handle_sh (\case ExitSuccess -> pure (); e -> throw e) $ do
383+testObRunInDir :: String -> [Text] -> Maybe FilePath -> HTTP.Manager -> Sh ()
384+testObRunInDir executable extraArgs mdir httpManager = maskExitSuccess $ do
257385 [p0, p1] <- liftIO $ getFreePorts 2
258386 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
259387 writefile "config/common/route" $ uri p0
260− maybe id chdir mdir $ runHandle "ob" ["run", "-v"] $ \stdout -> do
261− firstUri <- handleObRunStdout httpManager stdout
388+ maybe id chdir mdir $ runHandles executable extraArgs [] $ \_stdin stdout stderr -> do
389+ firstUri <- handleObRunStdout httpManager stdout stderr
262390 let newUri = uri p1
263391 when (firstUri == newUri) $ errorExit $
264392 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
265393 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
266− runningUri <- handleObRunStdout httpManager stdout
394+ runningUri <- handleObRunStdout httpManager stdout stderr
267395 if runningUri /= newUri
268396 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
269397 else exit 0
270398
271−testThunkPack :: FilePath -> Sh ()
272−testThunkPack path' = withTempFile (T.unpack $ toTextIgnore path') "test-file" $ \file handle -> do
273− let pack' = readProcessWithExitCode "ob" ["thunk", "pack", T.unpack $ toTextIgnore path'] ""
274− ensureThunkPackFails q = liftIO $ pack' >>= \case
275− (code, out, err)
276− | code == ExitSuccess -> fail "ob thunk pack succeeded when it should have failed"
277− | q `T.isInfixOf` T.pack (out <> err) -> pure ()
278− | otherwise -> fail $ "ob thunk pack failed for an unexpected reason: " <> show out <> "\nstderr: " <> err
279− git = chdir path' . run "git"
399+testThunkPack :: String -> [Text] -> FilePath -> Sh ()
400+testThunkPack executable args path' = withTempFile repoDir "test-file" $ \file handle -> do
401+ let
402+ pack' = readProcessWithExitCode executable (["thunk", "pack", path'] ++ map T.unpack args) ""
403+ ensureThunkPackFails q = liftIO $ pack' >>= \case
404+ (code, out, err)
405+ | code == ExitSuccess -> fail $ "ob thunk pack succeeded when it should have failed with error '" <> show q <> "'"
406+ | q `T.isInfixOf` T.pack (out <> err) -> pure ()
407+ | otherwise -> fail $ "ob thunk pack failed for an unexpected reason, expecting '" <> show q <> "', received: " <> show out <> "\nstderr: " <> err
408+ git = chdir repoDir . run_ gitPath
280409 -- Untracked files
281410 ensureThunkPackFails "Untracked files"
282− void $ git ["add", T.pack file]
411+ git ["add", T.pack file]
283412 -- Uncommitted files (staged)
284413 ensureThunkPackFails "unsaved"
285− chdir path' $ commit "test commit"
414+ chdir repoDir $ commit "test commit"
286415 -- Non-pushed commits in any branch
287416 ensureThunkPackFails "not yet pushed"
288417 -- Uncommitted files (unstaged)
289418 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
290419 ensureThunkPackFails "modified"
291420 -- Existing stashes
292− void $ git ["stash"]
421+ git $ gitUserConfig <> [ "stash" ]
293422 ensureThunkPackFails "has stashes"
423+ where
424+ repoDir = path' </> unpackedDirName
294425
295426-- | Blocks until a non-empty line is available
296427hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
@@ -310,9 +441,12 @@ alterRouteTo uri stdout = do
310441 "Reloading failed: " <> T.pack (show t)
311442
312443-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
313−handleObRunStdout :: HTTP.Manager -> Handle -> Sh Text
314−handleObRunStdout httpManager stdout = flip fix (ObRunState_Init, []) $ \loop (state, msgs) ->
315− liftIO (T.hGetLine stdout) >>= \t -> case state of
444+handleObRunStdout :: HTTP.Manager -> Handle -> Handle -> Sh Text
445+handleObRunStdout httpManager stdout stderr = flip fix (ObRunState_Init, []) $ \loop (state, msgs) -> do
446+ isEOF <- liftIO $ hIsEOF stdout
447+ if isEOF
448+ then handleObRunError msgs
449+ else liftIO (T.hGetLine stdout) >>= \t -> case state of
316450 ObRunState_Init
317451 | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
318452 ObRunState_Startup
@@ -324,8 +458,12 @@ handleObRunStdout httpManager stdout = flip fix (ObRunState_Init, []) $ \loop (s
324458 obRunCheck httpManager stdout uri
325459 pure uri
326460 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
327− _ | "Failed" `T.isPrefixOf` t -> errorExit $ "ob run failed: " <> T.unlines (reverse $ t : msgs)
461+ _ | "Failed" `T.isPrefixOf` t -> handleObRunError (t : msgs)
328462 | otherwise -> loop (state, t : msgs)
463+ where
464+ handleObRunError msgs = do
465+ stderrContent <- liftIO $ hGetContents stderr
466+ errorExit $ "ob run failed: " <> T.unlines (reverse msgs) <> " stderr: " <> T.pack stderrContent
329467
330468-- | Make requests to frontend/backend servers to check they are working properly
331469obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
@@ -334,14 +472,6 @@ obRunCheck httpManager _stdout frontendUri = do
334472 req frontendUri >>= \r -> when (HTTP.responseStatus r /= HTTP.ok200) $ errorExit $
335473 "Request to frontend server failed: " <> T.pack (show r)
336474
337−-- | Rename a cabal file and do a really dumb, brittle search/replace in its content to update the name.
338−changeCabalPackageName :: FilePath -> Text -> Sh ()
339−changeCabalPackageName cabalFile newName = do
340− contents <- readfile cabalFile
341− writefile (replaceBaseName cabalFile (T.unpack newName)) $
342− T.replace (" " <> T.pack (takeBaseName cabalFile)) (" " <> newName) contents -- WARNING: Super brittle
343− rm cabalFile
344−
345475getFreePorts :: Int -> IO [Socket.PortNumber]
346476getFreePorts 0 = pure []
347477getFreePorts n = Socket.withSocketsDo $ do
@@ -352,3 +482,121 @@ getFreePorts n = Socket.withSocketsDo $ do
352482 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
353483 Socket.bind sock (Socket.addrAddress addr)
354484 pure sock
485+
486+testLegacyGitThunks :: Bool -> IO ()
487+testLegacyGitThunks isVerbose = withSystemTempDirectory "test-git-repo" $ \gitDir -> do
488+ isolatedGitShell isVerbose gitDir $ \git -> do
489+ writefile (gitDir </> ("default.nix" :: FilePath)) "{}: \"hello\""
490+ _ <- git ["add", "--all"]
491+ _ <- git ["commit", "-m", "Initial commit"]
492+ rev <- T.strip <$> git ["rev-parse", "HEAD"]
493+ sha256 :: Text
494+ <- either error pure
495+ =<< (Aeson.parseEither (Aeson..: "sha256") <=< Aeson.eitherDecodeStrict . T.encodeUtf8)
496+ <$> run nixPrefetchGitPath [toTextIgnore gitDir]
497+
498+ for_ (legacyGitThunks (GitThunkParams gitDir rev sha256)) $ \mkFiles ->
499+ withSystemTempDirectory "test-thunks" $ \thunkDir -> do
500+ liftIO $ mkFiles thunkDir
501+ run_ "ob" ["thunk", "unpack", toTextIgnore thunkDir]
502+ run_ "ob" ["thunk", "pack", toTextIgnore thunkDir]
503+
504+data GitThunkParams = GitThunkParams
505+ { _gitThunkParams_repo :: !FilePath
506+ , _gitThunkParams_rev :: !Text
507+ , _gitThunkParams_sha256 :: !Text
508+ } deriving Show
509+
510+legacyGitThunks :: GitThunkParams -> [FilePath -> IO ()]
511+legacyGitThunks (GitThunkParams repo' rev sha256) =
512+ [ mkLegacyIO
513+ (T.unlines
514+ [ "# DO NOT HAND-EDIT THIS FILE"
515+ , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
516+ , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
517+ , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
518+ ]
519+ )
520+ (Map.fromList
521+ [ ("url", repo)
522+ , ("rev", rev)
523+ , ("branch", "master")
524+ , ("sha256", sha256)
525+ ]
526+ )
527+ , mkLegacyIO
528+ (T.unlines
529+ [ "# DO NOT HAND-EDIT THIS FILE"
530+ , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
531+ , " if builtins.hasAttr \"fetchGit\" builtins"
532+ , " then builtins.fetchGit ({ inherit url rev; } // (if branch == null then {} else { ref = branch; }))"
533+ , " else abort \"Plain Git repositories are only supported on nix 2.0 or higher.\";"
534+ , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
535+ ]
536+ )
537+ (Map.fromList
538+ [ ("url", repo)
539+ , ("rev", rev)
540+ , ("branch", "master")
541+ , ("sha256", sha256)
542+ ]
543+ )
544+ , mkLegacyIO
545+ (T.unlines
546+ [ "# DO NOT HAND-EDIT THIS FILE"
547+ , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
548+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
549+ , " if firstChar == \"/\" then /. + url"
550+ , " else if firstChar == \".\" then ./. + url"
551+ , " else url;"
552+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
553+ , " url = realUrl; inherit rev;"
554+ , " } else (import <nixpkgs> {}).fetchgit {"
555+ , " url = realUrl; inherit rev sha256;"
556+ , " };"
557+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
558+ ]
559+ )
560+ (Map.fromList
561+ [ ("url", Aeson.String repo)
562+ , ("rev", Aeson.String rev)
563+ , ("branch", Aeson.String "master")
564+ , ("sha256", Aeson.String sha256)
565+ , ("private", Aeson.Bool False)
566+ ]
567+ )
568+ , mkLegacyIO
569+ (T.unlines
570+ [ "# DO NOT HAND-EDIT THIS FILE"
571+ , "let fetch = {url, rev, branch ? 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+ , " ${if branch == null then null else \"ref\"} = branch;"
579+ , " } else (import <nixpkgs> {}).fetchgit {"
580+ , " url = realUrl; inherit rev sha256;"
581+ , " };"
582+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
583+ ]
584+ )
585+ (Map.fromList
586+ [ ("url", Aeson.String repo)
587+ , ("rev", Aeson.String rev)
588+ , ("branch", Aeson.String "master")
589+ , ("sha256", Aeson.String sha256)
590+ , ("private", Aeson.Bool False)
591+ ]
592+ )
593+ ]
594+ where
595+ repo = T.pack repo'
596+ mkLegacyIO :: Aeson.ToJSON v => Text -> Map.Map Text v -> FilePath -> IO ()
597+ mkLegacyIO defaultNix gitJson dir = do
598+ T.writeFile (dir </> ("default.nix" :: FilePath)) defaultNix
599+ LBS.writeFile (dir </> ("git.json" :: FilePath)) (Aeson.encode gitJson)
600+
601+unpackedDirName :: FilePath
602+unpackedDirName = "."
lib/snap-extras/obelisk-snap-extras.cabal+1−1
@@ -1,6 +1,6 @@
11name: obelisk-snap-extras
22version: 0.1
3−synopsys: Extra functionality for Snap that should be considered for upstreaming
3+synopsis: Extra functionality for Snap that should be considered for upstreaming
44license: BSD3
55build-type: Simple
66cabal-version: >=1.2
lib/snap-extras/src/Obelisk/Snap/Extras.hs+1−1
@@ -2,13 +2,13 @@
22module Obelisk.Snap.Extras
33 ( cachePermanently
44 , doNotCache
5+ , ensureSecure
56 , serveFileIfExists
67 , serveFileIfExistsAs
78 ) where
89
910import Control.Monad.IO.Class
1011import Data.ByteString (ByteString)
11−import Data.Monoid
1212import Data.String
1313import Snap.Core
1414import Snap.Util.FileServe
nixpkgs-overlays/default.nixnew file+15
@@ -0,0 +1,15 @@
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+8−95
@@ -1,97 +1,10 @@
1−{ self-args ? {
2− config.android_sdk.accept_license = true;
3− iosSdkVersion = "10.2";
4− }
5−, local-self ? import ./. self-args
1+{
2+ supportedSystems ? [ "x86_64-linux" "x86_64-darwin" ]
63}:
4+rec {
5+ recurseForDerivations = true;
6+ build = import ./all-builds.nix { inherit supportedSystems; };
7+ test = import ./all-tests.nix { inherit supportedSystems; };
78
8−let
9− inherit (local-self.nixpkgs) lib runCommand nix;
10−
11− cacheBuildSystems = [ "x86_64-linux" "x86_64-darwin" ];
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− concatDepends = let
39− extractDeps = x: (x.override {
40− mkDerivation = drv: {
41− out = builtins.concatLists [
42− (drv.buildDepends or [])
43− (drv.libraryHaskellDepends or [])
44− (drv.executableHaskellDepends or [])
45− ];
46− };
47− }).out;
48− in pkgAttrs: builtins.concatLists (map extractDeps (builtins.attrValues pkgAttrs));
49−
50− perPlatform = lib.genAttrs cacheBuildSystems (system: let
51− obelisk = import ./. (self-args // { inherit system; });
52− reflex-platform = obelisk.reflex-platform;
53− ghc = pnameToAttrs
54− obelisk.haskellPackageSets.ghc
55− obeliskPackagesBackend;
56− ghcjs = pnameToAttrs
57− obelisk.haskellPackageSets.ghcjs
58− obeliskPackagesCommon;
59− cachePackages = builtins.concatLists [
60− (builtins.attrValues ghc)
61− (builtins.attrValues ghcjs)
62− (concatDepends ghc)
63− (concatDepends ghcjs)
64− (lib.optional reflex-platform.androidSupport androidSkeleton)
65− (lib.optional reflex-platform.iosSupport iosSkeleton)
66− [ command serverSkeletonExe serverSkeletonShell ]
67− ];
68− command = obelisk.command;
69− skeleton = import ./skeleton { inherit obelisk; };
70− serverSkeletonExe = skeleton.exe;
71− # TODO fix nixpkgs so it doesn't try to run the result of haskell shells as setup hooks.
72− serverSkeletonShell = local-self.nixpkgs.runCommand "shell-safe-for-dep" {} ''
73− touch "$out"
74− echo "return" >> "$out"
75− cat "${skeleton.shells.ghc}" >> "$out"
76− '';
77− androidSkeleton = (import ./skeleton { inherit obelisk; }).android.frontend;
78− iosSkeleton = (import ./skeleton { inherit obelisk; }).ios.frontend;
79− in {
80− inherit
81− command
82− ghc ghcjs
83− serverSkeletonExe
84− serverSkeletonShell
85− ;
86− cache = reflex-platform.pinBuildInputs "obelisk-${system}" cachePackages;
87− } // lib.optionalAttrs reflex-platform.androidSupport {
88− inherit androidSkeleton;
89− } // lib.optionalAttrs reflex-platform.iosSupport {
90− inherit iosSkeleton;
91− });
92−
93− metaCache = local-self.reflex-platform.pinBuildInputs
94− "obelisk-everywhere"
95− (map (a: a.cache) (builtins.attrValues perPlatform));
96−
97−in perPlatform // { inherit metaCache; }
9+ inherit (build) metaCache;
10+}
skeleton/.gitignore+1
@@ -6,3 +6,4 @@ result-ios
66result-exe
77.attr-cache
88ghcid-output.txt
9+profile/
skeleton/backend/src/Backend.hs−3
@@ -1,6 +1,3 @@
1−{-# LANGUAGE FlexibleContexts #-}
2−{-# LANGUAGE RankNTypes #-}
3−{-# LANGUAGE TypeFamilies #-}
41module Backend where
52
63import Common.Route
skeleton/frontend/frontend.cabal+1
@@ -9,6 +9,7 @@ library
99 , common
1010 , obelisk-frontend
1111 , obelisk-route
12+ , jsaddle
1213 , reflex-dom
1314 , obelisk-executable-config-lookup
1415 , obelisk-generated-static
skeleton/frontend/src/Frontend.hs+12
@@ -4,8 +4,10 @@
44
55module Frontend where
66
7+import Control.Monad
78import qualified Data.Text as T
89import qualified Data.Text.Encoding as T
10+import Language.Javascript.JSaddle (eval, liftJSM)
911
1012import Obelisk.Frontend
1113import Obelisk.Configs
@@ -18,6 +20,9 @@ import Common.Api
1820import Common.Route
1921
2022
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.
2126frontend :: Frontend (R FrontendRoute)
2227frontend = Frontend
2328 { _frontend_head = do
@@ -26,6 +31,13 @@ frontend = Frontend
2631 , _frontend_body = do
2732 el "h1" $ text "Welcome to Obelisk!"
2833 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+
2941 elAttr "img" ("src" =: static @"obelisk.jpg") blank
3042 el "div" $ do
3143 exampleConfig <- getConfig "common/example"