on master help sign in
Merge branch 'develop' into fix-contravariant-prismEncoder
4062d03Elliot Cameron
.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)
.gitignore+1
@@ -2,6 +2,7 @@
2**/.cabal-sandbox
2**/.cabal-sandbox
3**/cabal.sandbox.config
3**/cabal.sandbox.config
4result
4result
5+result-*
5*.o
6*.o
6*.hi
7*.hi
7TAGS
8TAGS
.hlint.yamlnew file+65
@@ -0,0 +1,65 @@
1+# HLint configuration file
2+# https://github.com/ndmitchell/hlint
3+##########################
4+
5+# This file contains a template configuration file, which is typically
6+# placed as .hlint.yaml in the root of your project
7+
8+
9+# Specify additional command line arguments
10+#
11+# - arguments: [--color, --cpp-simple, -XQuasiQuotes]
12+
13+
14+# Control which extensions/flags/modules/functions can be used
15+#
16+# - extensions:
17+# - default: false # all extension are banned by default
18+# - name: [PatternGuards, ViewPatterns] # only these listed extensions can be used
19+# - {name: CPP, within: CrossPlatform} # CPP can only be used in a given module
20+#
21+# - flags:
22+# - {name: -w, within: []} # -w is allowed nowhere
23+#
24+# - modules:
25+# - {name: [Data.Set, Data.HashSet], as: Set} # if you import Data.Set qualified, it must be as 'Set'
26+# - {name: Control.Arrow, within: []} # Certain modules are banned entirely
27+#
28+# - functions:
29+# - {name: unsafePerformIO, within: []} # unsafePerformIO can only appear in no modules
30+
31+
32+# Add custom hints for this project
33+#
34+# Will suggest replacing "wibbleMany [myvar]" with "wibbleOne myvar"
35+# - error: {lhs: "wibbleMany [x]", rhs: wibbleOne x}
36+
37+
38+# Turn on hints that are off by default
39+#
40+# Ban "module X(module X) where", to require a real export list
41+# - warn: {name: Use explicit module export list}
42+#
43+# Replace a $ b $ c with a . b $ c
44+# - group: {name: dollar, enabled: true}
45+#
46+# Generalise map to fmap, ++ to <>
47+# - group: {name: generalise, enabled: true}
48+
49+
50+# Ignore some builtin hints
51+- ignore: {name: Redundant do}
52+- ignore: {name: Redundant flip}
53+- ignore: {name: Use <$>}
54+- ignore: {name: Use camelCase}
55+- ignore: {name: Use if}
56+- ignore: {name: Use unless}
57+# - ignore: {name: Use const, within: SpecialModule} # Only within certain modules
58+
59+
60+# Define some custom infix operators
61+# - fixity: infixr 3 ~^#^~
62+
63+
64+# To generate a suitable file for HLint do:
65+# $ hlint --default > .hlint.yaml
ChangeLog.md+77−1
@@ -1,9 +1,85 @@
1# Revision history for obelisk
1# Revision history for obelisk
2
2
3−This project's release branch is `master`. This log is written from the perspective of the release branch: when changes hit `master`, they are considered released, 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.
4+
5+## v0.8.0.0
6+
7+* ([#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.
8+* ([#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.
9+
10+ **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.
11+* ([#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.
12+* ([#705](https://github.com/obsidiansystems/obelisk/pull/705)) Add `Obelisk.Route.packTextEncoder` and generalize `Obelisk.Route.unpackTextEncoder` over any `Data.Text.Lens.IsText`.
13+* ([#712](https://github.com/obsidiansystems/obelisk/pull/712)) Update [`reflex-platform`](https://github.com/reflex-frp/reflex-platform) to version 0.5.3.0.
14+* ([#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`.
15+* ([#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`.
16+* ([#709](https://github.com/obsidiansystems/obelisk/pull/709)) Fix a bug in obelisk's preprocessor causing it to incorrectly skip files in some circumstances.
17+* ([#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.
18+* ([#714](https://github.com/obsidiansystems/obelisk/pull/714)) Miscellaneous improvements to CLI help and logging.
19+
20+## v0.7.0.1
21+
22+* Fix the version number for `ob` the command-line tool. ([#679](https://github.com/obsidiansystems/obelisk/pull/679))
23+
24+## v0.7.0.0
25+
26+* 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))
27+* Support non-EC2 deployments. ([#658](https://github.com/obsidiansystems/obelisk/pull/658))
28+* Fix `ob deploy test android` to work. ([#645](https://github.com/obsidiansystems/obelisk/pull/645))
29+* 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.)
30+* Add `Obelisk.Backend.runBackendWith` to allow several customizations. ([#668](https://github.com/obsidiansystems/obelisk/pull/668), [#644](https://github.com/obsidiansystems/obelisk/pull/644))
31+* 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))
32+* 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))
33+* Bump reflex-platform to v0.5.2.0. ([#671](https://github.com/obsidiansystems/obelisk/pull/671))
34+
35+## v0.6.0.0 - 2020-02-21
36+
37+* 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))
38+* 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))
39+* 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))
40+* Removed `Obelisk.Backend.mkRouteToUrl` since it is easily written in terms of `Obelisk.Route.renderObeliskRoute`:
41+
42+ mkRouteToUrl validFullEncoder (k :/ v) = renderObeliskRoute validFullEncoder (FullRoute_Frontend (ObeliskRoute_App k) :/ v)
43+
44+* Add `Obelisk.Backend.renderAllJsPath` to expose URL path to `ghcjs/all.js`. ([#545](https://github.com/obsidiansystems/obelisk/pull/545))
45+* 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))
46+
47+## v0.5.0.0 - 2020-02-07
48+
49+* Add `Obelisk.Route.(?/)`, a convenience function for constructing routes nested in `Maybe`. ([#457](https://github.com/obsidiansystems/obelisk/pull/457))
50+* 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))
51+* 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))
52+* `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))
53+* 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))
54+* Improve handling of runtime nix dependencies. This may fix some issues encountered particularly by users on systems other than NixOS.
55+
56+## v0.4.0.0 - 2020-01-10
57+
58+* Bump reflex-platform which, notably, bumps nixpkgs to 19.09. ([#585](https://github.com/obsidiansystems/obelisk/pull/585))
59+* 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))
60+* 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))
61+* Add `--public`/`--private` options to `ob thunk pack` to specify if a repository should be treated as a public or private. ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
62+* Improve error messaging when a dependency doesn't have the expected `.cabal` or `package.yaml` file. ([#597](https://github.com/obsidiansystems/obelisk/pull/597))
63+* Improve the skeleton in small ways. ([#593](https://github.com/obsidiansystems/obelisk/pull/593), [#589](https://github.com/obsidiansystems/obelisk/pull/589))
64+* Fix `ob` commands to again support running from any subdirectory of an obelisk project ([#591](https://github.com/obsidiansystems/obelisk/pull/591))
65+* 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))
4
66
5## v0.3.0.0 - 2019-12-20
67## v0.3.0.0 - 2019-12-20
6
68
69+* Change the structure of Obelisk routes to use a designated
70+ `FullRoute` type. This combines frontend and backend routes into one
71+ structure. This is a **breaking** change which requires Obelisk apps
72+ to take specific migrations. They are:
73+ * Rewrite the implementation of `_backend_routeEncoder` in
74+ `Backend` to use `mkFullRouteEncoder` instead of
75+ `handleEncoder`. Specifically, the backend and frontend cases of
76+ the top-level `pathComponentEncoder` become the second and third
77+ arguments of `mkFullRouteEncoder` respectively, while the
78+ missing route becomes the first argument. An example of how to
79+ do this is available in [a reflex-examples
80+ commit](https://github.com/reflex-frp/reflex-examples/commits/28f566c3e7dc615578dc74297b7c620c1f13683e).
81+ * Replace type constructions of `InL` with `FullRoute_Backend` and
82+ `InR` with `FullRoute_Frontend`.
7* Generalised `pathSegmentEncoder`, added `pathFieldEncoder`.
83* Generalised `pathSegmentEncoder`, added `pathFieldEncoder`.
8* Added some `Prism`s to the encoder library for manipulating `DSum`s.
84* Added some `Prism`s to the encoder library for manipulating `DSum`s.
9* Add `ob doc` command, which lists paths to haddock documentation for specified packages.
85* 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 @@
1# Obelisk
1# Obelisk
2
2
3+[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
4+[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://tldrlegal.com/license/bsd-3-clause-license-%28revised%29)
5+
6+
3Obelisk provides an easy way to develop and deploy your [Reflex](https://github.com/reflex-frp/reflex) project as web apps and as mobile apps.
7Obelisk provides an easy way to develop and deploy your [Reflex](https://github.com/reflex-frp/reflex) project as web apps and as mobile apps.
4
8
5- [Installing Obelisk](#installing-obelisk)
9- [Installing Obelisk](#installing-obelisk)
6- [Developing an Obelisk project](#developing-an-obelisk-project)
10- [Developing an Obelisk project](#developing-an-obelisk-project)
7− - [Hoogle](#hoogle)
8 - [Adding Packages](#adding-packages)
11 - [Adding Packages](#adding-packages)
9 - [Adding Package Overrides](#adding-package-overrides)
12 - [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)
11- [Deploying](#deploying)
17- [Deploying](#deploying)
12 - [Locally](#locally)
18 - [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)
14 - [From macOS](#from-macos)
22 - [From macOS](#from-macos)
15 - [Deploying an updated version](#deploying-an-updated-version)
23 - [Deploying an updated version](#deploying-an-updated-version)
16- [Mobile](#mobile)
24- [Mobile](#mobile)
@@ -23,14 +31,15 @@ Obelisk provides an easy way to develop and deploy your [Reflex](https://github.
231. Set up nix caches
311. Set up nix caches
24 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
32 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
25 ```
33 ```
26− nix.binaryCaches = [ "https://cache.nixos.org/" "https://nixcache.reflex-frp.org" ];
34+ nix.binaryCaches = [ "https://nixcache.reflex-frp.org" ];
27 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
35 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
28 ```
36 ```
29 and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
37 and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
30 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)):
38 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)):
31 ```
39 ```
32− substituters = https://cache.nixos.org https://nixcache.reflex-frp.org
40+ binary-caches = https://cache.nixos.org https://nixcache.reflex-frp.org
33− trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
41+ binary-cache-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
42+ binary-caches-parallel-connections = 40
34 ```
43 ```
35 * 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)
44 * 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)
36 ```
45 ```
@@ -51,24 +60,24 @@ Obelisk provides an easy way to develop and deploy your [Reflex](https://github.
51
60
52When developing on obelisk itself you may launch `ghcid` for the corresponding project as follows. For example to launch ghcid for `lib/backend` project:
61When developing on obelisk itself you may launch `ghcid` for the corresponding project as follows. For example to launch ghcid for `lib/backend` project:
53
62
54−```
63+```bash
55nix-shell -A obeliskEnvs.obelisk-backend --run "cd lib/backend && ghcid -c 'cabal new-repl'"
64nix-shell -A obeliskEnvs.obelisk-backend --run "cd lib/backend && ghcid -c 'cabal new-repl'"
56```
65```
57
66
58Or to launch ghcid for `lib/command` project:
67Or to launch ghcid for `lib/command` project:
59
68
60−```
69+```bash
61nix-shell -A obeliskEnvs.obelisk-command --run "cd lib/command && ghcid -c 'cabal new-repl'"
70nix-shell -A obeliskEnvs.obelisk-command --run "cd lib/command && ghcid -c 'cabal new-repl'"
62```
71```
63
72
64To re-install `ob` from source do
73To re-install `ob` from source do
65−```
74+```bash
66nix-env -f /path/to/obelisk -iA command
75nix-env -f /path/to/obelisk -iA command
67```
76```
68
77
69Note that `ob` will defer to the version found in your project's `.obelisk/impl` directory. To update that version specifically:
78Note that `ob` will defer to the version found in your project's `.obelisk/impl` directory. To update that version specifically:
70
79
71−```shell
80+```bash
72ob thunk unpack ./.obelisk/impl
81ob thunk unpack ./.obelisk/impl
73cd ./.obelisk/impl
82cd ./.obelisk/impl
74# apply your changes
83# apply your changes
@@ -76,7 +85,7 @@ cd ./.obelisk/impl
76
85
77If you want to commit your changes, first push them to your fork of obelisk and then
86If you want to commit your changes, first push them to your fork of obelisk and then
78
87
79−```shell
88+```bash
80cd /your/project/root
89cd /your/project/root
81ob thunk pack .obelisk/impl
90ob thunk pack .obelisk/impl
82git add .obelisk/impl
91git add .obelisk/impl
@@ -96,13 +105,13 @@ access to:
96
105
97To create a new Obelisk project, go to an empty directory and run:
106To create a new Obelisk project, go to an empty directory and run:
98
107
99−```
108+```bash
100ob init
109ob init
101```
110```
102
111
103Obelisk 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:
112Obelisk 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:
104
113
105−```
114+```bash
106ob run
115ob run
107```
116```
108
117
@@ -111,12 +120,6 @@ Firefox will not be able to properly run the development website due to [issue 4
111
120
112Every 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.
121Every 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.
113
122
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−
120### Adding packages
123### Adding packages
121
124
122In 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.
125In 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, ... }: {
150
153
151For further information see [the Haskell section](https://nixos.org/nixpkgs/manual/#users-guide-to-the-haskell-infrastructure) of nixpkgs Contributors Guide.
154For further information see [the Haskell section](https://nixos.org/nixpkgs/manual/#users-guide-to-the-haskell-infrastructure) of nixpkgs Contributors Guide.
152
155
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+
153−### Running over https
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
154
180
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
156
182
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+ ```
158
216
159## Deploying
217## Deploying
160
218
@@ -162,26 +220,26 @@ Since Obelisk generates a self-signed certificate for running https, the browser
162
220
163Build everything:
221Build everything:
164
222
165−```
223+```bash
166nix-build -A exe --no-out-link
224nix-build -A exe --no-out-link
167```
225```
168
226
169Copy the result to a new directory, add configuration, and run!
227Copy the result to a new directory, add configuration, and run!
170
228
171−```
229+```bash
172mkdir test-app
230mkdir test-app
173ln -s $(nix-build -A exe --no-out-link)/* test-app/
231ln -s $(nix-build -A exe --no-out-link)/* test-app/
174cp -r config test-app
232cp -r config test-app
175(cd test-app && ./backend)
233(cd test-app && ./backend)
176```
234```
177
235
178−### EC2
236+### Default EC2 Deployment
179
237
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)).
181
239
182First create a new EC2 instance:
240First create a new EC2 instance:
183
241
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))
1851. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
2431. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1861. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
2441. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
1871. Go to "Security Groups", select your instance's security group and under "Inbound" tab add a new rule for HTTP port 80 and 443.
2451. 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 \
204 ~/code/myapp-deploy
262 ~/code/myapp-deploy
205```
263```
206
264
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.
208
266
209This 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.
267This 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.
210
268
@@ -219,6 +277,26 @@ ob deploy push
219
277
220At 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`.
278At 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`.
221
279
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+
222### From macOS
300### From macOS
223
301
224Deploying from macOS requires some extra setup:
302Deploying from macOS requires some extra setup:
@@ -232,7 +310,7 @@ Running `ob deploy push` will give you additional setup instructions.
232
310
233If 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:
311If 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:
234
312
235−```
313+```bash
236cd ~/code/myapp-deploy
314cd ~/code/myapp-deploy
237ob deploy update
315ob deploy update
238ob deploy push
316ob deploy push
@@ -258,14 +336,14 @@ These versions will work out of the box but iOS SDKs prior to 11.3 should also w
258
336
259More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
337More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
260To 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.
338To 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
262open -W Xcode_9.2.xip
340open -W Xcode_9.2.xip
263sudo 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
341sudo 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
264```
342```
265
343
266
344
267You can verify that you have correct versions by running
345You can verify that you have correct versions by running
268−```
346+```bash
269xcodebuild -showsdks
347xcodebuild -showsdks
270```
348```
271
349
@@ -291,7 +369,7 @@ Ensure that `bundleIdentifier` matches the App ID of the development profile, or
2911. Connect the registered iPhone.
3691. Connect the registered iPhone.
2921. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
3701. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2931. Run the deploy command with your Team ID:
3711. Run the deploy command with your Team ID:
294−```
372+```bash
295result-ios/bin/deploy [TEAM_ID]
373result-ios/bin/deploy [TEAM_ID]
296# or in debug mode via lldb:
374# or in debug mode via lldb:
297result-ios/bin/deploy [TEAM_ID] -d
375result-ios/bin/deploy [TEAM_ID] -d
@@ -301,7 +379,7 @@ result-ios/bin/deploy [TEAM_ID] -d
3011. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
3791. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
302Create and download a distribution profile.
380Create and download a distribution profile.
3031. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
3811. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
304−```
382+```bash
305result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
383result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
306```
384```
307
385
acme.nixdeleted−397
@@ -1,397 +0,0 @@
1−### COPIED FROM
2−### https://github.com/NixOS/nixpkgs/blob/1d36ad6d16dbf1d3937f899a087a4360332eb141/nixos/modules/security/acme.nix
3−###
4−### to support new plugins in simp_le for ACMEv2 support.
5−### Changed lines are marked with a comment: ### CHANGED
6−
7−{ config, lib, pkgs, ... }:
8−
9−with lib;
10−
11−let
12−
13− cfg = config.security.acme;
14−
15− certOpts = { name, ... }: {
16− options = {
17− webroot = mkOption {
18− type = types.str;
19− example = "/var/lib/acme/acme-challenges";
20− description = ''
21− Where the webroot of the HTTP vhost is located.
22− <filename>.well-known/acme-challenge/</filename> directory
23− will be created below the webroot if it doesn't exist.
24− <literal>http://example.org/.well-known/acme-challenge/</literal> must also
25− be available (notice unencrypted HTTP).
26− '';
27− };
28−
29− domain = mkOption {
30− type = types.str;
31− default = name;
32− description = "Domain to fetch certificate for (defaults to the entry name)";
33− };
34−
35− email = mkOption {
36− type = types.nullOr types.str;
37− default = null;
38− description = "Contact email address for the CA to be able to reach you.";
39− };
40−
41− user = mkOption {
42− type = types.str;
43− default = "root";
44− description = "User running the ACME client.";
45− };
46−
47− group = mkOption {
48− type = types.str;
49− default = "root";
50− description = "Group running the ACME client.";
51− };
52−
53− allowKeysForGroup = mkOption {
54− type = types.bool;
55− default = false;
56− description = ''
57− Give read permissions to the specified group
58− (<option>security.acme.cert.&lt;name&gt;.group</option>) to read SSL private certificates.
59− '';
60− };
61−
62− postRun = mkOption {
63− type = types.lines;
64− default = "";
65− example = "systemctl reload nginx.service";
66− description = ''
67− Commands to run after new certificates go live. Typically
68− the web server and other servers using certificates need to
69− be reloaded.
70−
71− Executed in the same directory with the new certificate.
72− '';
73− };
74−
75− plugins = mkOption {
76− type = types.listOf (types.enum [
77− "cert.der" "cert.pem" "chain.pem" "external.sh"
78− "fullchain.pem" "full.pem" "key.der" "key.pem" "account_key.json" "account_reg.json" ### CHANGED
79− ]);
80− default = [ "fullchain.pem" "full.pem" "key.pem" "account_key.json" "account_reg.json" ]; ### CHANGED
81− description = ''
82− Plugins to enable. With default settings simp_le will
83− store public certificate bundle in <filename>fullchain.pem</filename>,
84− private key in <filename>key.pem</filename> and those two previous
85− files combined in <filename>full.pem</filename> in its state directory.
86− '';
87− };
88−
89− activationDelay = mkOption {
90− type = types.nullOr types.str;
91− default = null;
92− description = ''
93− Systemd time span expression to delay copying new certificates to main
94− state directory. See <citerefentry><refentrytitle>systemd.time</refentrytitle>
95− <manvolnum>7</manvolnum></citerefentry>.
96− '';
97− };
98−
99− preDelay = mkOption {
100− type = types.lines;
101− default = "";
102− description = ''
103− Commands to run after certificates are re-issued but before they are
104− activated. Typically the new certificate is published to DNS.
105−
106− Executed in the same directory with the new certificate.
107− '';
108− };
109−
110− extraDomains = mkOption {
111− type = types.attrsOf (types.nullOr types.str);
112− default = {};
113− example = literalExample ''
114− {
115− "example.org" = "/srv/http/nginx";
116− "mydomain.org" = null;
117− }
118− '';
119− description = ''
120− A list of extra domain names, which are included in the one certificate to be issued, with their
121− own server roots if needed.
122− '';
123− };
124− };
125− };
126−
127−in
128−
129−{
130−
131− ###### interface
132−
133− options = {
134− security.acme = {
135− directory = mkOption {
136− default = "/var/lib/acme";
137− type = types.str;
138− description = ''
139− Directory where certs and other state will be stored by default.
140− '';
141− };
142−
143− validMin = mkOption {
144− type = types.int;
145− default = 30 * 24 * 3600;
146− description = "Minimum remaining validity before renewal in seconds.";
147− };
148−
149− renewInterval = mkOption {
150− type = types.str;
151− default = "weekly";
152− description = ''
153− Systemd calendar expression when to check for renewal. See
154− <citerefentry><refentrytitle>systemd.time</refentrytitle>
155− <manvolnum>7</manvolnum></citerefentry>.
156− '';
157− };
158−
159− preliminarySelfsigned = mkOption {
160− type = types.bool;
161− default = true;
162− description = ''
163− Whether a preliminary self-signed certificate should be generated before
164− doing ACME requests. This can be useful when certificates are required in
165− a webserver, but ACME needs the webserver to make its requests.
166−
167− With preliminary self-signed certificate the webserver can be started and
168− can later reload the correct ACME certificates.
169− '';
170− };
171−
172− production = mkOption {
173− type = types.bool;
174− default = true;
175− description = ''
176− If set to true, use Let's Encrypt's production environment
177− instead of the staging environment. The main benefit of the
178− staging environment is to get much higher rate limits.
179−
180− See
181− <literal>https://letsencrypt.org/docs/staging-environment</literal>
182− for more detail.
183− '';
184− };
185−
186− certs = mkOption {
187− default = { };
188− type = with types; attrsOf (submodule certOpts);
189− description = ''
190− Attribute set of certificates to get signed and renewed.
191− '';
192− example = literalExample ''
193− {
194− "example.com" = {
195− webroot = "/var/www/challenges/";
196− email = "foo@example.com";
197− extraDomains = { "www.example.com" = null; "foo.example.com" = "/var/www/foo/"; };
198− };
199− "bar.example.com" = {
200− webroot = "/var/www/challenges/";
201− email = "bar@example.com";
202− };
203− }
204− '';
205− };
206− };
207− };
208−
209− ###### implementation
210− config = mkMerge [
211− (mkIf (cfg.certs != { }) {
212−
213− systemd.services = let
214− services = concatLists servicesLists;
215− servicesLists = mapAttrsToList certToServices cfg.certs;
216− certToServices = cert: data:
217− let
218− cpath = lpath + optionalString (data.activationDelay != null) ".staging";
219− lpath = "${cfg.directory}/${cert}";
220− rights = if data.allowKeysForGroup then "750" else "700";
221− cmdline = [ "-v" "-d" data.domain "--default_root" data.webroot "--valid_min" cfg.validMin ]
222− ++ optionals (data.email != null) [ "--email" data.email ]
223− ++ concatMap (p: [ "-f" p ]) data.plugins
224− ++ concatLists (mapAttrsToList (name: root: [ "-d" (if root == null then name else "${name}:${root}")]) data.extraDomains)
225− ++ optionals (!cfg.production) ["--server" "https://acme-staging.api.letsencrypt.org/directory"];
226− acmeService = {
227− description = "Renew ACME Certificate for ${cert}";
228− after = [ "network.target" "network-online.target" ];
229− wants = [ "network-online.target" ];
230− serviceConfig = {
231− Type = "oneshot";
232− SuccessExitStatus = [ "0" "1" ];
233− PermissionsStartOnly = true;
234− User = data.user;
235− Group = data.group;
236− PrivateTmp = true;
237− };
238− path = with pkgs; [ simp_le systemd ];
239− preStart = ''
240− mkdir -p '${cfg.directory}'
241− chown 'root:root' '${cfg.directory}'
242− chmod 755 '${cfg.directory}'
243− if [ ! -d '${cpath}' ]; then
244− mkdir '${cpath}'
245− fi
246− chmod ${rights} '${cpath}'
247− chown -R '${data.user}:${data.group}' '${cpath}'
248− mkdir -p '${data.webroot}/.well-known/acme-challenge'
249− chown -R '${data.user}:${data.group}' '${data.webroot}/.well-known/acme-challenge'
250− '';
251− script = ''
252− cd '${cpath}'
253− set +e
254− simp_le ${escapeShellArgs cmdline}
255− EXITCODE=$?
256− set -e
257− echo "$EXITCODE" > /tmp/lastExitCode
258− exit "$EXITCODE"
259− '';
260− postStop = ''
261− cd '${cpath}'
262−
263− if [ -e /tmp/lastExitCode ] && [ "$(cat /tmp/lastExitCode)" = "0" ]; then
264− ${if data.activationDelay != null then ''
265−
266− ${data.preDelay}
267−
268− if [ -d '${lpath}' ]; then
269− systemd-run --no-block --on-active='${data.activationDelay}' --unit acme-setlive-${cert}.service
270− else
271− systemctl --wait start acme-setlive-${cert}.service
272− fi
273− '' else data.postRun}
274−
275− # noop ensuring that the "if" block is non-empty even if
276− # activationDelay == null and postRun == ""
277− true
278− fi
279− '';
280−
281− before = [ "acme-certificates.target" ];
282− wantedBy = [ "acme-certificates.target" ];
283− };
284− delayService = {
285− description = "Set certificate for ${cert} live";
286− path = with pkgs; [ rsync ];
287− serviceConfig = {
288− Type = "oneshot";
289− };
290− script = ''
291− rsync -a --delete-after '${cpath}/' '${lpath}'
292− '';
293− postStop = data.postRun;
294− };
295− selfsignedService = {
296− description = "Create preliminary self-signed certificate for ${cert}";
297− path = [ pkgs.openssl ];
298− preStart = ''
299− if [ ! -d '${cpath}' ]
300− then
301− mkdir -p '${cpath}'
302− chmod ${rights} '${cpath}'
303− chown '${data.user}:${data.group}' '${cpath}'
304− fi
305− '';
306− script =
307− ''
308− workdir="$(mktemp -d)"
309−
310− # Create CA
311− openssl genrsa -des3 -passout pass:xxxx -out $workdir/ca.pass.key 2048
312− openssl rsa -passin pass:xxxx -in $workdir/ca.pass.key -out $workdir/ca.key
313− openssl req -new -key $workdir/ca.key -out $workdir/ca.csr \
314− -subj "/C=UK/ST=Warwickshire/L=Leamington/O=OrgName/OU=Security Department/CN=example.com"
315− openssl x509 -req -days 1 -in $workdir/ca.csr -signkey $workdir/ca.key -out $workdir/ca.crt
316−
317− # Create key
318− openssl genrsa -des3 -passout pass:xxxx -out $workdir/server.pass.key 2048
319− openssl rsa -passin pass:xxxx -in $workdir/server.pass.key -out $workdir/server.key
320− openssl req -new -key $workdir/server.key -out $workdir/server.csr \
321− -subj "/C=UK/ST=Warwickshire/L=Leamington/O=OrgName/OU=IT Department/CN=example.com"
322− openssl x509 -req -days 1 -in $workdir/server.csr -CA $workdir/ca.crt \
323− -CAkey $workdir/ca.key -CAserial $workdir/ca.srl -CAcreateserial \
324− -out $workdir/server.crt
325−
326− # Copy key to destination
327− cp $workdir/server.key ${cpath}/key.pem
328−
329− # Create fullchain.pem (same format as "simp_le ... -f fullchain.pem" creates)
330− cat $workdir/{server.crt,ca.crt} > "${cpath}/fullchain.pem"
331−
332− # Create full.pem for e.g. lighttpd
333− cat $workdir/{server.key,server.crt,ca.crt} > "${cpath}/full.pem"
334−
335− # Give key acme permissions
336− chown '${data.user}:${data.group}' "${cpath}/"{key,fullchain,full}.pem
337− chmod ${rights} "${cpath}/"{key,fullchain,full}.pem
338− '';
339− serviceConfig = {
340− Type = "oneshot";
341− PermissionsStartOnly = true;
342− PrivateTmp = true;
343− User = data.user;
344− Group = data.group;
345− };
346− unitConfig = {
347− # Do not create self-signed key when key already exists
348− ConditionPathExists = "!${cpath}/key.pem";
349− };
350− before = [
351− "acme-selfsigned-certificates.target"
352− ];
353− wantedBy = [
354− "acme-selfsigned-certificates.target"
355− ];
356− };
357− in (
358− [ { name = "acme-${cert}"; value = acmeService; } ]
359− ++ optional cfg.preliminarySelfsigned { name = "acme-selfsigned-${cert}"; value = selfsignedService; }
360− ++ optional (data.activationDelay != null) { name = "acme-setlive-${cert}"; value = delayService; }
361− );
362− servicesAttr = listToAttrs services;
363− injectServiceDep = {
364− after = [ "acme-selfsigned-certificates.target" ];
365− wants = [ "acme-selfsigned-certificates.target" "acme-certificates.target" ];
366− };
367− in
368− servicesAttr //
369− (if config.services.nginx.enable then { nginx = injectServiceDep; } else {}) //
370− (if config.services.lighttpd.enable then { lighttpd = injectServiceDep; } else {});
371−
372− systemd.timers = flip mapAttrs' cfg.certs (cert: data: nameValuePair
373− ("acme-${cert}")
374− ({
375− description = "Renew ACME Certificate for ${cert}";
376− wantedBy = [ "timers.target" ];
377− timerConfig = {
378− OnCalendar = cfg.renewInterval;
379− Unit = "acme-${cert}.service";
380− Persistent = "yes";
381− AccuracySec = "5m";
382− RandomizedDelaySec = "1h";
383− };
384− })
385− );
386−
387− systemd.targets."acme-selfsigned-certificates" = mkIf cfg.preliminarySelfsigned {};
388− systemd.targets."acme-certificates" = {};
389− })
390−
391− ];
392−
393− meta = {
394− maintainers = with lib.maintainers; [ abbradar fpletz globin ];
395− #doc = ./acme.xml; ### CHANGED
396− };
397−}
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+186−190
@@ -2,103 +2,30 @@
2, profiling ? false
2, profiling ? false
3, iosSdkVersion ? "10.2"
3, iosSdkVersion ? "10.2"
4, config ? {}
4, config ? {}
5+, reflex-platform-func ? import ./dep/reflex-platform
5}:
6}:
6let
7let
7− cleanSource = builtins.filterSource (name: _: let baseName = builtins.baseNameOf name; in !(
8+ reflex-platform = getReflexPlatform { inherit system; };
8− builtins.match "^\\.ghc\\.environment.*" baseName != null ||
9+ inherit (reflex-platform) hackGet nixpkgs;
9− baseName == "cabal.project.local"
10+ pkgs = nixpkgs;
10− ));
11
11
12− commandRuntimeDeps = pkgs: with pkgs; [
12+ inherit (import dep/gitignore.nix { inherit (nixpkgs) lib; }) gitignoreSource;
13− coreutils
14− git
15− nix-prefetch-git
16− openssh
17− ];
18
13
19− getReflexPlatform = sys: import ./dep/reflex-platform {
14+ getReflexPlatform = { system, enableLibraryProfiling ? profiling }: reflex-platform-func {
20− inherit iosSdkVersion config;
15+ inherit iosSdkVersion config system enableLibraryProfiling;
21− system = sys;
22− enableLibraryProfiling = profiling;
23
16
24 nixpkgsOverlays = [
17 nixpkgsOverlays = [
25− (self: super: {
18+ (import ./nixpkgs-overlays)
26− obeliskExecutableConfig = import ./lib/executable-config { nixpkgs = pkgs; filterGitSource = cleanSource; };
27− })
28 ];
19 ];
29
20
30 haskellOverlays = [
21 haskellOverlays = [
31−
22+ (import ./haskell-overlays/misc-deps.nix { inherit hackGet; })
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.overrideCabal (self.callHackage "hnix" "0.6.1" { these = self.these_0_8; }) (_: {
38− jailbreak = true;
39− doCheck = false;
40− });
41− hnix-store-core = self.callHackage "hnix-store-core" "0.1.0.0" {};
42−
43− ghcid = self.callCabal2nix "ghcid" (hackGet ./dep/ghcid) {};
44− })
45−
46 pkgs.obeliskExecutableConfig.haskellOverlay
23 pkgs.obeliskExecutableConfig.haskellOverlay
47−
24+ (import ./haskell-overlays/obelisk.nix)
48− # Add obelisk packages
25+ (import ./haskell-overlays/tighten-ob-exes.nix)
49− (self: super: let
50− pkgs = self.callPackage ({ pkgs }: pkgs) {};
51− onLinux = pkg: f: if pkgs.stdenv.isLinux then f pkg else pkg;
52− in {
53− obelisk-executable-config-inject = pkgs.obeliskExecutableConfig.platforms.web.inject self;
54−
55− obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (cleanSource ./lib/asset/manifest) {};
56− obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (cleanSource ./lib/asset/serve-snap) {};
57− obelisk-backend = self.callCabal2nix "obelisk-backend" (cleanSource ./lib/backend) {};
58− obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (cleanSource ./lib/cliapp) {};
59− obelisk-command = haskellLib.overrideCabal (self.callCabal2nix "obelisk-command" (cleanSource ./lib/command) {}) {
60− librarySystemDepends = [
61− pkgs.nix
62− (haskellLib.justStaticExecutables self.ghcid)
63− ];
64− };
65− obelisk-frontend = self.callCabal2nix "obelisk-frontend" (cleanSource ./lib/frontend) {};
66− obelisk-run = onLinux (self.callCabal2nix "obelisk-run" (cleanSource ./lib/run) {}) (pkg:
67− haskellLib.overrideCabal pkg (drv: { librarySystemDepends = [ pkgs.iproute ]; })
68− );
69− obelisk-route = self.callCabal2nix "obelisk-route" (cleanSource ./lib/route) {};
70− obelisk-selftest = self.callCabal2nix "obelisk-selftest" (cleanSource ./lib/selftest) {};
71− obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (cleanSource ./lib/snap-extras) {};
72− tabulation = self.callCabal2nix "tabulation" (cleanSource ./lib/tabulation) {};
73− })
74−
75− (self: super: let
76− pkgs = self.callPackage ({ pkgs }: pkgs) {};
77− haskellLib = pkgs.haskell.lib;
78− in {
79− # Dynamic linking with split objects dramatically increases startup time (about
80− # 0.5 seconds on a decent machine with SSD), so we do `justStaticExecutables`.
81− obelisk-command = haskellLib.overrideCabal
82− (haskellLib.generateOptparseApplicativeCompletion "ob"
83− (haskellLib.justStaticExecutables super.obelisk-command))
84− (drv: {
85− buildTools = (drv.buildTools or []) ++ [ pkgs.buildPackages.makeWrapper ];
86− postFixup = ''
87− ${drv.postFixup or ""}
88− # Make `ob` reference its runtime dependencies.
89− wrapProgram "$out"/bin/ob --prefix PATH : ${pkgs.lib.makeBinPath (commandRuntimeDeps pkgs)}
90− '';
91− });
92− obelisk-selftest = haskellLib.justStaticExecutables super.obelisk-selftest;
93− })
94−
95 ];
26 ];
96 };
27 };
97
28
98− reflex-platform = getReflexPlatform system;
99− inherit (reflex-platform) hackGet nixpkgs;
100− pkgs = nixpkgs;
101−
102 # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
29 # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
103 ghcObelisk = reflex-platform.ghc;
30 ghcObelisk = reflex-platform.ghc;
104
31
@@ -116,19 +43,18 @@ in rec {
116 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
43 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
117 path = reflex-platform.filterGit ./.;
44 path = reflex-platform.filterGit ./.;
118 obelisk = ghcObelisk;
45 obelisk = ghcObelisk;
119− obeliskEnvs = ghcObeliskEnvs;
46+ obeliskEnvs = pkgs.lib.filterAttrs (k: _: pkgs.lib.strings.hasPrefix "obelisk-" k) ghcObeliskEnvs;
120 command = ghcObelisk.obelisk-command;
47 command = ghcObelisk.obelisk-command;
121− shell = pinBuildInputs "obelisk-shell" ([command] ++ commandRuntimeDeps pkgs);
48+ shell = pinBuildInputs "obelisk-shell" ([command] ++ command.commandRuntimeDeps);
122
49
123 selftest = pkgs.writeScript "selftest" ''
50 selftest = pkgs.writeScript "selftest" ''
124− #!/usr/bin/env bash
51+ #!${pkgs.runtimeShell}
125 set -euo pipefail
52 set -euo pipefail
126
53
127 PATH="${command}/bin:$PATH"
54 PATH="${command}/bin:$PATH"
128− export OBELISK_IMPL="${hackGet ./.}"
55+ cd ${./.}
129 "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
56 "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
130 '';
57 '';
131− #TODO: Why can't I build ./skeleton directly as a derivation? `nix-build -E ./.` doesn't work
132 skeleton = pkgs.runCommand "skeleton" {
58 skeleton = pkgs.runCommand "skeleton" {
133 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
59 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
134 } ''
60 } ''
@@ -150,6 +76,7 @@ in rec {
150 compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
76 compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
151 mkdir $out
77 mkdir $out
152 cd $out
78 cd $out
79+ # TODO profiling + static shouldn't break and need an ad-hoc workaround like that
153 ln -s "${haskellLib.justStaticExecutables frontend}/bin/frontend.jsexe/all.js" all.unminified.js
80 ln -s "${haskellLib.justStaticExecutables frontend}/bin/frontend.jsexe/all.js" all.unminified.js
154 ${if optimizationLevel == null then ''
81 ${if optimizationLevel == null then ''
155 ln -s all.unminified.js all.js
82 ln -s all.unminified.js all.js
@@ -160,18 +87,28 @@ in rec {
160 '';
87 '';
161
88
162 serverModules = {
89 serverModules = {
163− mkBaseEc2 = { hostName, routeHost, enableHttps, adminEmail, ... }: {...}: {
90+ mkBaseEc2 = { nixosPkgs, ... }: {...}: {
164 imports = [
91 imports = [
165− (pkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
92+ (nixosPkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
166 ];
93 ];
94+ ec2.hvm = true;
95+ };
96+
97+ mkDefaultNetworking = { adminEmail, enableHttps, hostName, routeHost, ... }: {...}: {
167 networking = {
98 networking = {
168 inherit hostName;
99 inherit hostName;
169 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
100 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
170 };
101 };
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+
171 security.acme.certs = if enableHttps then {
109 security.acme.certs = if enableHttps then {
172 "${routeHost}".email = adminEmail;
110 "${routeHost}".email = adminEmail;
173 } else {};
111 } else {};
174− ec2.hvm = true;
175 };
112 };
176
113
177 mkObeliskApp =
114 mkObeliskApp =
@@ -228,134 +165,193 @@ in rec {
228 };
165 };
229 };
166 };
230
167
168+ inherit mkAssets;
169+
231 serverExe = backend: frontend: assets: optimizationLevel: version:
170 serverExe = backend: frontend: assets: optimizationLevel: version:
232 pkgs.runCommand "serverExe" {} ''
171 pkgs.runCommand "serverExe" {} ''
233 mkdir $out
172 mkdir $out
234 set -eux
173 set -eux
235− ln -s "${haskellLib.justStaticExecutables backend}"/bin/* $out/
174+ ln -s "${if profiling then backend else haskellLib.justStaticExecutables backend}"/bin/* $out/
236 ln -s "${mkAssets assets}" $out/static.assets
175 ln -s "${mkAssets assets}" $out/static.assets
237 ln -s ${mkAssets (compressedJs frontend optimizationLevel)} $out/frontend.jsexe.assets
176 ln -s ${mkAssets (compressedJs frontend optimizationLevel)} $out/frontend.jsexe.assets
238 echo ${version} > $out/version
177 echo ${version} > $out/version
239 '';
178 '';
240
179
241− server = { exe, hostName, adminEmail, routeHost, enableHttps, version }@args:
180+ server = { exe, hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }@args:
242 let
181 let
243 nixos = import (pkgs.path + /nixos);
182 nixos = import (pkgs.path + /nixos);
244 in nixos {
183 in nixos {
245 system = "x86_64-linux";
184 system = "x86_64-linux";
246 configuration = {
185 configuration = {
247 imports = [
186 imports = [
187+ (module { inherit exe hostName adminEmail routeHost enableHttps version; nixosPkgs = pkgs; })
248− (serverModules.mkBaseEc2 args)
188+ (serverModules.mkDefaultNetworking args)
249 (serverModules.mkObeliskApp args)
189 (serverModules.mkObeliskApp args)
250− ./acme.nix
251− ];
252− disabledModules = [
253− (pkgs.path + /nixos/modules/security/acme.nix)
254− ];
255− nixpkgs.overlays = [
256− (self: super: let
257− nixos1909 = import (hackGet ./dep/nixpkgs-19.09) {};
258− in {
259− inherit (nixos1909) simp_le;
260− })
261 ];
190 ];
262 };
191 };
263 };
192 };
264
193
265−
266 # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
194 # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
267− project = base: projectDefinition:
195+ project = base': projectDefinition:
196+ let
268− let projectOut = sys: (getReflexPlatform sys).project (args@{ nixpkgs, ... }:
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 =
269− let mkProject = { android ? null #TODO: Better error when missing
201+ { android ? null #TODO: Better error when missing
270− , ios ? null #TODO: Better error when missing
202+ , ios ? null #TODO: Better error when missing
271− , packages ? {}
203+ , packages ? {}
272− , overrides ? _: _: {}
204+ , overrides ? _: _: {}
273− , staticFiles ? base + /static
205+ , staticFiles ? null
274− , tools ? _: []
206+ , tools ? _: []
275− , shellToolOverrides ? _: _: {}
207+ , shellToolOverrides ? _: _: {}
276− , withHoogle ? false # Setting this to `true` makes shell reloading far slower
208+ , withHoogle ? false # Setting this to `true` makes shell reloading far slower
277− , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
209+ , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
210+ , __withGhcide ? false
278− }:
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+ };
279− let frontendName = "frontend";
220+ frontendName = "frontend";
280− backendName = "backend";
221+ backendName = "backend";
281− commonName = "common";
222+ commonName = "common";
282− staticName = "obelisk-generated-static";
223+ staticName = "obelisk-generated-static";
283− staticFilesImpure = if lib.isDerivation staticFiles then staticFiles else toString staticFiles;
224+ staticFilesImpure = let fs = self.userSettings.staticFiles; in if lib.isDerivation fs then fs else toString fs;
284− processedStatic = processAssets { src = staticFiles; };
225+ processedStatic = processAssets { src = self.userSettings.staticFiles; };
285− # The packages whose names and roles are defined by this package
226+ # The packages whose names and roles are defined by this package
286− predefinedPackages = lib.filterAttrs (_: x: x != null) {
227+ predefinedPackages = lib.filterAttrs (_: x: x != null) {
287− ${frontendName} = nullIfAbsent (base + "/frontend");
228+ ${self.frontendName} = nullIfAbsent (self.base + "/frontend");
288− ${commonName} = nullIfAbsent (base + "/common");
229+ ${self.commonName} = nullIfAbsent (self.base + "/common");
289− ${backendName} = nullIfAbsent (base + "/backend");
230+ ${self.backendName} = nullIfAbsent (self.base + "/backend");
290− };
231+ };
232+ shellPackages = {};
291− combinedPackages = predefinedPackages // packages;
233+ combinedPackages = self.predefinedPackages // self.userSettings.packages // self.shellPackages;
292− projectOverrides = self: super: {
234+ projectOverrides = self': super': {
293− ${staticName} = haskellLib.dontHaddock (self.callCabal2nix staticName processedStatic.haskellManifest {});
235+ ${self.staticName} = haskellLib.dontHaddock (self'.callCabal2nix self.staticName self.processedStatic.haskellManifest {});
294− ${backendName} = haskellLib.addBuildDepend super.${backendName} self.obelisk-run;
236+ ${self.backendName} = haskellLib.addBuildDepend super'.${self.backendName} self'.obelisk-run;
295− };
237+ };
296− totalOverrides = lib.composeExtensions projectOverrides overrides;
238+ totalOverrides = lib.composeExtensions self.projectOverrides self.userSettings.overrides;
297− inherit (lib.strings) hasPrefix;
298− privateConfigDirs = ["config/backend"];
239+ privateConfigDirs = ["config/backend"];
299− injectableConfig = builtins.filterSource (path: _:
240+ injectableConfig = builtins.filterSource (path: _:
300− !(lib.lists.any (x: hasPrefix (toString base + "/" + toString x) (toString path)) privateConfigDirs)
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 (_: _: {})
301 );
279 );
302− __androidWithConfig = configPath: {
280+
303− ${if android == null then null else frontendName} = {
281+ project = reflexPlatformProject ({...}: self.projectConfig);
304− executableName = "frontend";
282+ projectConfig = {
305− ${if builtins.pathExists staticFiles then "assets" else null} =
283+ inherit (self) shellToolOverrides;
306− nixpkgs.obeliskExecutableConfig.platforms.android.inject
284+ inherit (self.userSettings) tools withHoogle;
307− (injectableConfig configPath)
285+ overrides = self.totalOverrides;
308− processedStatic.symlinked;
286+ packages = self.combinedPackages;
309− } // android;
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;
310 };
292 };
311− __iosWithConfig = configPath: {
293+ android = self.__androidWithConfig (self.base + "/config");
312− ${if ios == null then null else frontendName} = {
294+ ios = self.__iosWithConfig (self.base + "/config");
313− executableName = "frontend";
295+
314− ${if builtins.pathExists staticFiles then "staticSrc" else null} =
296+ passthru = {
315− nixpkgs.obeliskExecutableConfig.platforms.ios.inject
297+ __unstable__.self = allConfig;
316− (injectableConfig configPath)
298+ inherit (self)
317− processedStatic.symlinked;
299+ staticFilesImpure processedStatic
318− } // ios;
300+ __iosWithConfig __androidWithConfig
301+ ;
302+ inherit (self.userSettings)
303+ android ios overrides packages shellToolOverrides staticFiles tools withHoogle
304+ __closureCompilerOptimizationLevel
305+ ;
319 };
306 };
320− in {
321− inherit shellToolOverrides tools withHoogle;
322− overrides = totalOverrides;
323− packages = combinedPackages;
324− shells = {
325− ${if android == null && ios == null then null else "ghcSavedSplices"} = (lib.filter (x: lib.hasAttr x combinedPackages) [
326− commonName
327− frontendName
328− ]);
329− ghc = (lib.filter (x: lib.hasAttr x combinedPackages) [
330− backendName
331− commonName
332− frontendName
333− ]);
334− ghcjs = lib.filter (x: lib.hasAttr x combinedPackages) [
335− frontendName
336− commonName
337− ];
338 };
307 };
339− android = __androidWithConfig (base + "/config");
340− ios = __iosWithConfig (base + "/config");
341− passthru = { inherit android ios packages overrides tools shellToolOverrides withHoogle staticFiles staticFilesImpure __closureCompilerOptimizationLevel processedStatic __iosWithConfig __androidWithConfig; };
342− };
308+ });
309+ in allConfig;
343− in mkProject (projectDefinition args));
310+ in (mkProject (projectDefinition args)).projectConfig);
311+ mainProjectOut = projectOut { inherit system; };
344− serverOn = sys: version: serverExe
312+ serverOn = projectInst: version: serverExe
345− (projectOut sys).ghc.backend
313+ projectInst.ghc.backend
346− (projectOut system).ghcjs.frontend
314+ mainProjectOut.ghcjs.frontend
347− (projectOut sys).passthru.staticFiles
315+ projectInst.passthru.staticFiles
348− (projectOut sys).passthru.__closureCompilerOptimizationLevel
316+ projectInst.passthru.__closureCompilerOptimizationLevel
349 version;
317 version;
350− linuxExe = serverOn "x86_64-linux";
318+ linuxExe = serverOn (projectOut { system = "x86_64-linux"; });
351 dummyVersion = "Version number is only available for deployments";
319 dummyVersion = "Version number is only available for deployments";
320+ in mainProjectOut // {
321+ __unstable__.profiledObRun = let
352− in projectOut system // {
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+
353 linuxExeConfigurable = linuxExe;
349 linuxExeConfigurable = linuxExe;
354 linuxExe = linuxExe dummyVersion;
350 linuxExe = linuxExe dummyVersion;
355− exe = serverOn system dummyVersion;
351+ exe = serverOn mainProjectOut dummyVersion;
356− server = args@{ hostName, adminEmail, routeHost, enableHttps, version }:
352+ server = args@{ hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }:
357 server (args // { exe = linuxExe version; });
353 server (args // { exe = linuxExe version; });
358− obelisk = import (base + "/.obelisk/impl") {};
354+ obelisk = import (base' + "/.obelisk/impl") {};
359 };
355 };
360 haskellPackageSets = {
356 haskellPackageSets = {
361 inherit (reflex-platform) ghc ghcjs;
357 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/nixpkgs-19.09/default.nix → dep/hnix/default.nixrenamed

The content is the same.

dep/hnix/github.jsonnew file+7
@@ -0,0 +1,7 @@
1+{
2+ "owner": "haskell-nix",
3+ "repo": "hnix",
4+ "branch": "master",
5+ "rev": "6c9c7c310c54372b3db0fdf5a0137b395cde1bdb",
6+ "sha256": "1i5903b7lxqn2s3jarb14h6wdq8bxiik1hp0xy43w5w1hgvvq0g5"
7+}
dep/nixpkgs-19.09/github.jsondeleted−7
@@ -1,7 +0,0 @@
1−{
2− "owner": "nixos",
3− "repo": "nixpkgs-channels",
4− "branch": "nixos-19.09",
5− "rev": "ca9f709fd0b8535261234e6eb5d2020aaf1a2c61",
6− "sha256": "0z1qgmzx9dwbvwxf16f9m30y8lqy4zv4phl0mcyv7grfhj3s1abw"
7−}
dep/reflex-platform/default.nix+7−6
@@ -1,7 +1,8 @@
1# DO NOT HAND-EDIT THIS FILE
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;
2−import ((import <nixpkgs> {}).fetchFromGitHub (
5+ } else (import <nixpkgs> {}).fetchFromGitHub {
6+ inherit owner repo rev sha256 fetchSubmodules private;
7+ };
3− let json = builtins.fromJSON (builtins.readFile ./github.json);
8+in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))
4− in { inherit (json) owner repo rev sha256;
5− private = json.private or false;
6− }
7−))
dep/reflex-platform/github.json+4−3
@@ -1,7 +1,8 @@
1{
1{
2 "owner": "reflex-frp",
2 "owner": "reflex-frp",
3 "repo": "reflex-platform",
3 "repo": "reflex-platform",
4− "branch": "develop",
4+ "branch": "release/0.5.3.0",
5− "rev": "aa8a9d1ac3d41ad51fbe04e575d4350da65cf3db",
5+ "private": false,
6− "sha256": "0hffy5rcfy6ay06ww3cxykqzp024jfcdg6w1yrmnf0h80sjfgdcm"
6+ "rev": "9779ea3b4c87fdc971057c561262696d5e9b1847",
7+ "sha256": "0v87ilal9355xwz8y9m0zh14pm9c0f7pqch0854kkj92ybc5l62q"
7}
8}
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
136 skipMany lws
136 skipMany lws
137 q0 <|> q1
137 q0 <|> q1
138 where q0 = do
138 where q0 = do
139− char '0'
139+ _ <- char '0'
140 decimals <- option [] $ do
140 decimals <- option [] $ do
141− char '.'
141+ _ <- char '.'
142 starRule (Just 0) (Just numAllowedDigits) digit
142 starRule (Just 0) (Just numAllowedDigits) digit
143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
144 q1 = do
144 q1 = do
145− char '1'
145+ _ <- char '1'
146 option () $ do
146 option () $ do
147− char '.'
147+ _ <- char '.'
148− starRule (Just 0) (Just numAllowedDigits) $ char '0'
148+ _ <- starRule (Just 0) (Just numAllowedDigits) $ char '0'
149 return ()
149 return ()
150 return $ QValue 1
150 return $ QValue 1
151 numAllowedDigits :: Int
151 numAllowedDigits :: Int
@@ -232,7 +232,7 @@ hashRule minNum maxNum element = do
232lws :: Parser ()
232lws :: Parser ()
233lws = do
233lws = do
234 option () $ cr >> lf
234 option () $ cr >> lf
235− starRule (Just 1) Nothing $ sp <|> ht
235+ _ <- starRule (Just 1) Nothing $ sp <|> ht
236 return ()
236 return ()
237
237
238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+14−4
@@ -12,12 +12,13 @@ import Obelisk.Asset.Accept (Encoding (..), acceptEncodingBody, chooseEncoding,
12import Obelisk.Snap.Extras
12import Obelisk.Snap.Extras
13
13
14import Snap
14import Snap
15− (MonadSnap, getHeader, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
15+ (MonadSnap, getHeader, getRequest, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
16import Snap.Util.FileServe (defaultMimeTypes, fileType, getSafePath, serveFile)
16import Snap.Util.FileServe (defaultMimeTypes, fileType, getSafePath, serveFile)
17+import Snap.Internal.Util.FileServe (checkRangeReq)
17
18
18import Control.Applicative ((<|>))
19import Control.Applicative ((<|>))
19import Control.Exception (handleJust, try, throwIO)
20import Control.Exception (handleJust, try, throwIO)
20−import Control.Monad (forM, liftM)
21+import Control.Monad (forM, liftM, unless)
21import Control.Monad.IO.Class (liftIO)
22import Control.Monad.IO.Class (liftIO)
22import Control.Monad.Fail (MonadFail)
23import Control.Monad.Fail (MonadFail)
23import Data.Attoparsec.ByteString (parseOnly, endOfInput)
24import Data.Attoparsec.ByteString (parseOnly, endOfInput)
@@ -94,8 +95,17 @@ serveAsset' doRedirect base fallback p = do
94 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
95 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
95 stat <- liftIO $ getFileStatus finalFilename
96 stat <- liftIO $ getFileStatus finalFilename
96 modifyResponse $ setHeader "Last-Modified" "Thu, 1 Jan 1970 00:00:00 GMT"
97 modifyResponse $ setHeader "Last-Modified" "Thu, 1 Jan 1970 00:00:00 GMT"
98+ . setHeader "Accept-Ranges" "bytes"
97− modifyResponse $ setResponseCode 200 . setContentLength (fromIntegral $ fileSize stat) . setContentType (fileType defaultMimeTypes p)
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
98− sendFile finalFilename
108+ sendFile finalFilename
99 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
109 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
100 Right "redirect" -> do
110 Right "redirect" -> do
101 mtarget <- liftIO $ getAssetTarget $ base </> p
111 mtarget <- liftIO $ getAssetTarget $ base </> p
lib/backend/src/Obelisk/Backend.hs+119−35
@@ -1,3 +1,5 @@
1+{-# LANGUAGE DeriveFunctor #-}
2+{-# LANGUAGE DeriveGeneric #-}
1{-# LANGUAGE FlexibleContexts #-}
3{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE FlexibleInstances #-}
3{-# LANGUAGE GADTs #-}
5{-# LANGUAGE GADTs #-}
@@ -9,25 +11,37 @@
9{-# OPTIONS_GHC -fno-warn-orphans #-}
11{-# OPTIONS_GHC -fno-warn-orphans #-}
10module Obelisk.Backend
12module Obelisk.Backend
11 ( Backend (..)
13 ( 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
12 -- * Re-exports
30 -- * Re-exports
13 , Default (def)
31 , Default (def)
14 , getPageName
32 , getPageName
15 , getRouteWith
33 , getRouteWith
16 , runSnapWithCommandLineArgs
34 , runSnapWithCommandLineArgs
35+ , runSnapWithConfig
17 , serveDefaultObeliskApp
36 , serveDefaultObeliskApp
18 , prettifyOutput
37 , prettifyOutput
19− , runBackend
20 , staticRenderContentType
38 , staticRenderContentType
21− , mkRouteToUrl
22 , getPublicConfigs
39 , getPublicConfigs
23 ) where
40 ) where
24
41
25−import Prelude hiding (id, (.))
26−import Control.Category
27import Control.Monad
42import Control.Monad
28import Control.Monad.Except
43import Control.Monad.Except
29import Control.Monad.Fail (MonadFail)
44import Control.Monad.Fail (MonadFail)
30−import Control.Categorical.Bifunctor
31import Data.ByteString (ByteString)
45import Data.ByteString (ByteString)
32import qualified Data.ByteString.Char8 as BSC8
46import qualified Data.ByteString.Char8 as BSC8
33import Data.Default (Default (..))
47import Data.Default (Default (..))
@@ -38,7 +52,7 @@ import qualified Data.Map as Map
38import Data.Monoid ((<>))
52import Data.Monoid ((<>))
39import Data.Text (Text)
53import Data.Text (Text)
40import qualified Data.Text as T
54import qualified Data.Text as T
41−import Data.Text.Encoding
55+import GHC.Generics (Generic)
42import Obelisk.Asset.Serve.Snap (serveAsset)
56import Obelisk.Asset.Serve.Snap (serveAsset)
43import qualified Obelisk.ExecutableConfig.Lookup as Lookup
57import qualified Obelisk.ExecutableConfig.Lookup as Lookup
44import Obelisk.Frontend
58import Obelisk.Frontend
@@ -54,27 +68,52 @@ import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
54data Backend backendRoute frontendRoute = Backend
68data Backend backendRoute frontendRoute = Backend
55 { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
69 { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
56 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
70 , _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)
58
80
59-- | The static assets provided must contain a compiled GHCJS app that corresponds exactly to the Frontend provided
81-- | The static assets provided must contain a compiled GHCJS app that corresponds exactly to the Frontend provided
60data GhcjsApp route = GhcjsApp
82data GhcjsApp route = GhcjsApp
61 { _ghcjsApp_compiled :: !StaticAssets
83 { _ghcjsApp_compiled :: !StaticAssets
62 , _ghcjsApp_value :: !(Frontend route)
84 , _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
63 }
102 }
64
103
65-- | Serve a frontend, which must be the same frontend that Obelisk has built and placed in the default location
104-- | Serve a frontend, which must be the same frontend that Obelisk has built and placed in the default location
66--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
105--TODO: The frontend should be provided together with the asset paths so that this isn't so easily breakable; that will probably make this function obsolete
67serveDefaultObeliskApp
106serveDefaultObeliskApp
68 :: (MonadSnap m, HasCookies m, MonadFail m)
107 :: (MonadSnap m, HasCookies m, MonadFail m)
69− => (R appRoute
108+ => (R appRoute -> Text)
70− -> Text)
109+ -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
71− -> ([Text]
110+ -> ([Text] -> m ())
72− -> m ())
73 -> Frontend (R appRoute)
111 -> Frontend (R appRoute)
74 -> Map Text ByteString
112 -> Map Text ByteString
75 -> R (ObeliskRoute appRoute)
113 -> R (ObeliskRoute appRoute)
76 -> m ()
114 -> m ()
77−serveDefaultObeliskApp urlEnc serveStaticAsset frontend configs = serveObeliskApp urlEnc serveStaticAsset frontendApp configs
115+serveDefaultObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontend =
116+ serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp
78 where frontendApp = GhcjsApp
117 where frontendApp = GhcjsApp
79 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
118 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
80 , _ghcjsApp_value = frontend
119 , _ghcjsApp_value = frontend
@@ -99,17 +138,20 @@ defaultFrontendGhcjsAssets = StaticAssets
99 , _staticAssets_unprocessed = "frontend.jsexe"
138 , _staticAssets_unprocessed = "frontend.jsexe"
100 }
139 }
101
140
102−runSnapWithCommandLineArgs :: MonadIO m => Snap () -> m ()
141+runSnapWithConfig :: MonadIO m => Config Snap a -> Snap () -> m ()
103−runSnapWithCommandLineArgs a = do
142+runSnapWithConfig conf a = do
104− -- Get the web server configuration from the command line
105− cmdLineConf <- liftIO $ commandLineConfig defaultConfig
106− let httpConf = cmdLineConf
143+ let httpConf = conf
107 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
144 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
108 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
145 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
109 }
146 }
110 -- Start the web server
147 -- Start the web server
111 liftIO $ httpServe httpConf a
148 liftIO $ httpServe httpConf a
112
149
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+
113getPageName :: (MonadSnap m) => m PageName
155getPageName :: (MonadSnap m) => m PageName
114getPageName = do
156getPageName = do
115 p <- getsRequest rqPathInfo
157 p <- getsRequest rqPathInfo
@@ -121,19 +163,24 @@ getRouteWith e = do
121 pageName <- getPageName
163 pageName <- getPageName
122 return $ tryDecode e pageName
164 return $ tryDecode e pageName
123
165
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+
124serveObeliskApp
170serveObeliskApp
125 :: (MonadSnap m, HasCookies m, MonadFail m)
171 :: (MonadSnap m, HasCookies m, MonadFail m)
126 => (R appRoute -> Text)
172 => (R appRoute -> Text)
173+ -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
127 -> ([Text] -> m ())
174 -> ([Text] -> m ())
128 -> GhcjsApp (R appRoute)
175 -> GhcjsApp (R appRoute)
129 -> Map Text ByteString
176 -> Map Text ByteString
130 -> R (ObeliskRoute appRoute)
177 -> R (ObeliskRoute appRoute)
131 -> m ()
178 -> m ()
132−serveObeliskApp urlEnc serveStaticAsset frontendApp config = \case
179+serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp config = \case
133− ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
180+ ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
134 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
181 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
135 ResourceRoute_Static :=> Identity pathSegments -> serveStaticAsset pathSegments
182 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
137 ResourceRoute_JSaddleWarp :=> Identity _ -> do
184 ResourceRoute_JSaddleWarp :=> Identity _ -> do
138 let msg = "Error: Obelisk.Backend received jsaddle request"
185 let msg = "Error: Obelisk.Backend received jsaddle request"
139 liftIO $ putStrLn $ T.unpack msg
186 liftIO $ putStrLn $ T.unpack msg
@@ -160,48 +207,85 @@ staticRenderContentType = "text/html; charset=utf-8"
160serveGhcjsApp
207serveGhcjsApp
161 :: (MonadSnap m, HasCookies m, MonadFail m)
208 :: (MonadSnap m, HasCookies m, MonadFail m)
162 => (R appRouteComponent -> Text)
209 => (R appRouteComponent -> Text)
210+ -> GhcjsWidgets (FrontendWidgetT (R appRouteComponent) ())
163 -> GhcjsApp (R appRouteComponent)
211 -> GhcjsApp (R appRouteComponent)
164 -> Map Text ByteString
212 -> Map Text ByteString
165 -> R (GhcjsAppRoute appRouteComponent)
213 -> R (GhcjsAppRoute appRouteComponent)
166 -> m ()
214 -> m ()
167−serveGhcjsApp urlEnc app config = \case
215+serveGhcjsApp urlEnc ghcjsWidgets app config = \case
168 GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
216 GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
169 modifyResponse $ setContentType staticRenderContentType
217 modifyResponse $ setContentType staticRenderContentType
170 modifyResponse $ setHeader "Cache-Control" "no-store private"
218 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
172 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
220 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
173
221
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.
174runBackend :: Backend backendRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
227runBackend :: Backend backendRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
228+runBackend = runBackendWith defaultBackendConfig
229+
230+-- | Run an obelisk backend with the given configuration.
231+runBackendWith
232+ :: BackendConfig frontendRoute
233+ -> Backend backendRoute frontendRoute
234+ -> Frontend (R frontendRoute)
235+ -> IO ()
175−runBackend backend frontend = case checkEncoder $ _backend_routeEncoder backend of
236+runBackendWith (BackendConfig runSnap staticAssets ghcjsWidgets) backend frontend = case checkEncoder $ _backend_routeEncoder backend of
176 Left e -> fail $ "backend error:\n" <> T.unpack e
237 Left e -> fail $ "backend error:\n" <> T.unpack e
177 Right validFullEncoder -> do
238 Right validFullEncoder -> do
178 publicConfigs <- getPublicConfigs
239 publicConfigs <- getPublicConfigs
179− _backend_run backend $ \serveRoute -> do
240+ _backend_run backend $ \serveRoute ->
180− runSnapWithCommandLineArgs $ do
241+ runSnap $
181 getRouteWith validFullEncoder >>= \case
242 getRouteWith validFullEncoder >>= \case
182 Identity r -> case r of
243 Identity r -> case r of
183 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
244 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
184 FullRoute_Frontend obeliskRoute :/ a ->
245 FullRoute_Frontend obeliskRoute :/ a ->
185− serveDefaultObeliskApp (mkRouteToUrl validFullEncoder) (serveStaticAssets defaultStaticAssets) frontend publicConfigs $
246+ serveDefaultObeliskApp routeToUrl (($ allJsUrl) <$> ghcjsWidgets) (serveStaticAssets staticAssets) frontend publicConfigs $
186 obeliskRoute :/ a
247 obeliskRoute :/ a
187−
248+ where
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
249+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
250+ allJsUrl = renderAllJsPath validFullEncoder
192
251
193renderGhcjsFrontend
252renderGhcjsFrontend
194 :: (MonadSnap m, HasCookies m)
253 :: (MonadSnap m, HasCookies m)
195 => (route -> Text)
254 => (route -> Text)
255+ -> GhcjsWidgets (FrontendWidgetT route ())
196 -> route
256 -> route
197 -> Map Text ByteString
257 -> Map Text ByteString
198 -> Frontend route
258 -> Frontend route
199 -> m ByteString
259 -> m ByteString
200−renderGhcjsFrontend urlEnc route configs f = do
260+renderGhcjsFrontend urlEnc ghcjsWidgets 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
203 cookies <- askCookies
261 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+ ]
205
289
206instance HasCookies Snap where
290instance HasCookies Snap where
207 askCookies = map (\c -> (cookieName c, cookieValue c)) <$> getsRequest rqCookies
291 askCookies = map (\c -> (cookieName c, cookieValue c)) <$> getsRequest rqCookies
lib/cliapp/obelisk-cliapp.cabal+3−2
@@ -7,9 +7,11 @@ cabal-version: >=1.2
7library
7library
8 hs-source-dirs: src
8 hs-source-dirs: src
9 build-depends:
9 build-depends:
10+ aeson
10− ansi-terminal
11+ , ansi-terminal
11 , base
12 , base
12 , bytestring
13 , bytestring
14+ , containers
13 , exceptions
15 , exceptions
14 , io-streams
16 , io-streams
15 , lens
17 , lens
@@ -23,7 +25,6 @@ library
23 , transformers
25 , transformers
24 exposed-modules:
26 exposed-modules:
25 Obelisk.CliApp
27 Obelisk.CliApp
26− Obelisk.CliApp.Demo
27 other-modules:
28 other-modules:
28 Obelisk.CliApp.Logging
29 Obelisk.CliApp.Logging
29 Obelisk.CliApp.Process
30 Obelisk.CliApp.Process
lib/cliapp/src/Obelisk/CliApp.hs+15−6
@@ -33,16 +33,25 @@ module Obelisk.CliApp
33 , Severity (..)
33 , Severity (..)
34
34
35 -- .Process
35 -- .Process
36− , ProcessFailure (..)
37 , AsProcessFailure (..)
36 , AsProcessFailure (..)
38− , readProcessAndLogStderr
37+ , ProcessFailure (..)
39− , readProcessAndLogOutput
38+ , ProcessSpec (..)
40− , readCreateProcessWithExitCode
39+ , callCommand
40+ , callProcess
41 , callProcessAndLogOutput
41 , callProcessAndLogOutput
42 , createProcess_
42 , createProcess_
43− , callProcess
43+ , overCreateProcess
44− , callCommand
44+ , proc
45+ , readCreateProcessWithExitCode
46+ , readProcessAndLogOutput
47+ , readProcessAndLogStderr
48+ , readProcessJSONAndLogStderr
45 , reconstructCommand
49 , reconstructCommand
50+ , setCwd
51+ , setDelegateCtlc
52+ , setEnvOverride
53+ , shell
54+ , waitForProcess
46 ) where
55 ) where
47
56
48import Control.Monad.Log (Severity (..))
57import Control.Monad.Log (Severity (..))
lib/cliapp/src/Obelisk/CliApp/Demo.hsdeleted−53
@@ -1,53 +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−import System.Process (proc)
12−
13−import Control.Monad.Catch (MonadMask)
14−
15−import Obelisk.CliApp
16−
17−cliDemo
18− :: ( MonadIO m, MonadMask m, MonadFail m
19− , CliLog m, HasCliConfig e m, CliThrow e m, AsProcessFailure e, AsUnstructuredError e)
20− => m ()
21−cliDemo = withSpinner "CLI Demo" $ do
22− putLog Notice "This demo will showcase the CLI library functionality"
23− _ <- withSpinner' "Searching long for something" (Just $ \c -> "Discovered " <> T.pack (show c) <> " objects") $ do
24− delay
25− withSpinner "Nested task" $ do
26− delay
27− putLog Notice "In nested task"
28− -- This is a 'no trail' spinner that won't leave a trail (even its sub spinners)
29− withSpinnerNoTrail "In between, doing something temporary" $ do
30− withSpinner "Runnning something deep inside" $ do
31− delay
32− putLog Notice "You can still log from inside no-trail spinners"
33− delay
34− delay
35− putLog Error "Top nested task finished"
36− delay
37− putLog Error "Some user error while spinning"
38− delay
39− putLog Notice "This is some info mesage"
40− putLog Warning "And now a warning as well"
41− delay
42− return (42 :: Integer)
43− putLog Notice "Now we start a 2nd spinner, run a couple of process, the last of which fails:"
44− withSpinner "Looking around" $ do
45− delay
46− output <- readProcessAndLogStderr Notice $ proc "ls" ["-l", "/"]
47− putLog Notice $ "Output was: " <> output
48− delay
49− callProcessAndLogOutput (Notice, Error) $ proc "ls" ["-l", "/does-not-exist"]
50− delay
51− failWith "Something dangerous happened"
52− where
53− 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
39import Control.Monad.Loops (iterateUntil)
39import Control.Monad.Loops (iterateUntil)
40import Control.Monad.Reader (MonadIO, ReaderT (..))
40import Control.Monad.Reader (MonadIO, ReaderT (..))
41import Data.IORef (atomicModifyIORef', newIORef, readIORef, writeIORef)
41import Data.IORef (atomicModifyIORef', newIORef, readIORef, writeIORef)
42−import Data.Maybe
43import Data.Semigroup ((<>))
42import Data.Semigroup ((<>))
44import Data.Text (Text)
43import Data.Text (Text)
45import qualified Data.Text as T
44import qualified Data.Text as T
@@ -67,7 +66,7 @@ newCliConfig sev noColor noSpinner errorLogExitCode = do
67 tipDisplayed <- newIORef False
66 tipDisplayed <- newIORef False
68 stack <- newIORef ([], [])
67 stack <- newIORef ([], [])
69 textEncoding <- hGetEncoding stdout
68 textEncoding <- hGetEncoding stdout
70− let theme = if fromMaybe False $ supportsUnicode <$> textEncoding
69+ let theme = if maybe False supportsUnicode textEncoding
71 then unicodeTheme
70 then unicodeTheme
72 else noUnicodeTheme
71 else noUnicodeTheme
73 return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
72 return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
@@ -133,7 +132,7 @@ handleLog' noColor output = do
133 hFlush stdout
132 hFlush stdout
134 Output_Overwrite ts -> liftIO $ do
133 Output_Overwrite ts -> liftIO $ do
135 width <- TS.getTerminalWidth
134 width <- TS.getTerminalWidth
136− T.putStr $ "\r" <> (TS.render (not noColor) width ts)
135+ T.putStr $ "\r" <> TS.render (not noColor) width ts
137 hFlush stdout
136 hFlush stdout
138 Output_ClearLine -> liftIO $ do
137 Output_ClearLine -> liftIO $ do
139 -- Go to the first column and clear the whole line
138 -- Go to the first column and clear the whole line
@@ -179,14 +178,16 @@ withExitFailMessage msg f = f `catch` \(e :: ExitCode) -> do
179
178
180-- | Write log to stdout, with colors (unless `noColor`)
179-- | Write log to stdout, with colors (unless `noColor`)
181writeLog :: (MonadIO m, MonadMask m) => Bool -> Bool -> WithSeverity Text -> m ()
180writeLog :: (MonadIO m, MonadMask m) => Bool -> Bool -> WithSeverity Text -> m ()
182−writeLog withNewLine noColor (WithSeverity severity s)
181+writeLog withNewLine noColor (WithSeverity severity s) = if T.null s then pure () else write
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
188 where
182 where
183+ write
184+ | noColor && severity <= Warning = liftIO $ putFn $ T.pack (show severity) <> ": " <> s
185+ | not noColor && severity <= Error = TS.putStrWithSGR errorColors h withNewLine s
186+ | not noColor && severity <= Warning = TS.putStrWithSGR warningColors h withNewLine s
187+ | not noColor && severity >= Debug = TS.putStrWithSGR debugColors h withNewLine s
188+ | otherwise = liftIO $ putFn s
189+
189− putFn = if withNewLine then (T.hPutStrLn h) else (T.hPutStr h)
190+ putFn = if withNewLine then T.hPutStrLn h else T.hPutStr h
190 h = if severity <= Error then stderr else stdout
191 h = if severity <= Error then stderr else stdout
191 errorColors = [SetColor Foreground Vivid Red]
192 errorColors = [SetColor Foreground Vivid Red]
192 warningColors = [SetColor Foreground Vivid Yellow]
193 warningColors = [SetColor Foreground Vivid Yellow]
lib/cliapp/src/Obelisk/CliApp/Process.hs+103−36
@@ -9,17 +9,26 @@
9-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
9-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
10-- and is thus spinner friendly.
10-- and is thus spinner friendly.
11module Obelisk.CliApp.Process
11module Obelisk.CliApp.Process
12+ ( AsProcessFailure (..)
12− ( ProcessFailure (..)
13+ , ProcessFailure (..)
13− , AsProcessFailure (..)
14+ , ProcessSpec (..)
14− , readProcessAndLogStderr
15+ , callCommand
15− , readProcessAndLogOutput
16+ , callProcess
16− , readCreateProcessWithExitCode
17 , callProcessAndLogOutput
17 , callProcessAndLogOutput
18 , createProcess
18 , createProcess
19 , createProcess_
19 , createProcess_
20− , callProcess
20+ , overCreateProcess
21− , callCommand
21+ , proc
22+ , readCreateProcessWithExitCode
23+ , readProcessAndLogOutput
24+ , readProcessAndLogStderr
25+ , readProcessJSONAndLogStderr
22 , reconstructCommand
26 , reconstructCommand
27+ , setCwd
28+ , setDelegateCtlc
29+ , setEnvOverride
30+ , shell
31+ , waitForProcess
23 ) where
32 ) where
24
33
25import Control.Monad ((<=<), join, void)
34import Control.Monad ((<=<), join, void)
@@ -30,24 +39,51 @@ import Control.Lens (Prism', review)
30import qualified Data.ByteString as BS
39import qualified Data.ByteString as BS
31import qualified Data.ByteString.Char8 as BSC
40import qualified Data.ByteString.Char8 as BSC
32import Data.Function (fix)
41import Data.Function (fix)
42+import Data.Map (Map)
43+import qualified Data.Map as Map
33import Data.Monoid ((<>))
44import Data.Monoid ((<>))
34import Data.Text (Text)
45import Data.Text (Text)
35import qualified Data.Text as T
46import qualified Data.Text as T
36import qualified Data.Text.Encoding as T
47import qualified Data.Text.Encoding as T
37import Data.Text.Encoding.Error (lenientDecode)
48import Data.Text.Encoding.Error (lenientDecode)
49+import System.Environment (getEnvironment)
38import System.Exit (ExitCode (..))
50import System.Exit (ExitCode (..))
39import System.IO (Handle)
51import System.IO (Handle)
40import System.IO.Streams (InputStream, handleToInputStream)
52import System.IO.Streams (InputStream, handleToInputStream)
41import qualified System.IO.Streams as Streams
53import qualified System.IO.Streams as Streams
42import System.IO.Streams.Concurrent (concurrentMerge)
54import System.IO.Streams.Concurrent (concurrentMerge)
43−import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), cmdspec, std_err, std_out,
55+import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), std_err, std_out)
44− waitForProcess)
45import qualified System.Process as Process
56import qualified System.Process as Process
57+import qualified Data.Aeson as Aeson
46
58
47import Control.Monad.Log (Severity (..))
59import Control.Monad.Log (Severity (..))
48import Obelisk.CliApp.Logging (putLog, putLogRaw)
60import Obelisk.CliApp.Logging (putLog, putLogRaw)
49import Obelisk.CliApp.Types (CliLog, CliThrow)
61import Obelisk.CliApp.Types (CliLog, CliThrow)
50
62
63+data ProcessSpec = ProcessSpec
64+ { _processSpec_createProcess :: !CreateProcess
65+ , _processSpec_overrideEnv :: !(Maybe (Map String String -> Map String String))
66+ }
67+
68+proc :: FilePath -> [String] -> ProcessSpec
69+proc cmd args = ProcessSpec (Process.proc cmd args) Nothing
70+
71+shell :: String -> ProcessSpec
72+shell cmd = ProcessSpec (Process.shell cmd) Nothing
73+
74+setEnvOverride :: (Map String String -> Map String String) -> ProcessSpec -> ProcessSpec
75+setEnvOverride f p = p { _processSpec_overrideEnv = Just f }
76+
77+overCreateProcess :: (CreateProcess -> CreateProcess) -> ProcessSpec -> ProcessSpec
78+overCreateProcess f (ProcessSpec p x) = ProcessSpec (f p) x
79+
80+setDelegateCtlc :: Bool -> ProcessSpec -> ProcessSpec
81+setDelegateCtlc b = overCreateProcess (\p -> p { Process.delegate_ctlc = b })
82+
83+setCwd :: Maybe FilePath -> ProcessSpec -> ProcessSpec
84+setCwd fp = overCreateProcess (\p -> p { Process.cwd = fp })
85+
86+
51-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
87-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
52data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
88data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
53 deriving Show
89 deriving Show
@@ -62,17 +98,31 @@ instance AsProcessFailure ProcessFailure where
62
98
63readProcessAndLogStderr
99readProcessAndLogStderr
64 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
100 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
65− => Severity -> CreateProcess -> m Text
101+ => Severity -> ProcessSpec -> m Text
66readProcessAndLogStderr sev process = do
102readProcessAndLogStderr sev process = do
67 (out, _err) <- withProcess process $ \_out err -> do
103 (out, _err) <- withProcess process $ \_out err -> do
68 streamToLog =<< liftIO (streamHandle sev err)
104 streamToLog =<< liftIO (streamHandle sev err)
69 liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
105 liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
70
106
107+readProcessJSONAndLogStderr
108+ :: (Aeson.FromJSON a, MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
109+ => Severity -> ProcessSpec -> m a
110+readProcessJSONAndLogStderr sev process = do
111+ (out, _err) <- withProcess process $ \_out err -> do
112+ streamToLog =<< liftIO (streamHandle sev err)
113+ json <- liftIO $ BS.hGetContents out
114+ case Aeson.eitherDecodeStrict json of
115+ Right a -> pure a
116+ Left err -> do
117+ putLog Error $ "Could not decode process output as JSON: " <> T.pack err
118+ throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) 0
119+
71readCreateProcessWithExitCode
120readCreateProcessWithExitCode
72 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
121 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
73− => CreateProcess -> m (ExitCode, String, String)
122+ => ProcessSpec -> m (ExitCode, String, String)
74−readCreateProcessWithExitCode process = do
123+readCreateProcessWithExitCode procSpec = do
124+ process <- mkCreateProcess procSpec
75− putLog Debug $ "Creating process: " <> reconstructCommand (cmdspec process)
125+ putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
76 liftIO $ Process.readCreateProcessWithExitCode process ""
126 liftIO $ Process.readCreateProcessWithExitCode process ""
77
127
78-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
128-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
@@ -84,21 +134,21 @@ readCreateProcessWithExitCode process = do
84-- `callProcessAndLogOutput (Debug, Debug)`.
134-- `callProcessAndLogOutput (Debug, Debug)`.
85readProcessAndLogOutput
135readProcessAndLogOutput
86 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
136 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
87− => (Severity, Severity) -> CreateProcess -> m Text
137+ => (Severity, Severity) -> ProcessSpec -> m Text
88readProcessAndLogOutput (sev_out, sev_err) process = do
138readProcessAndLogOutput (sev_out, sev_err) process = do
89− (_, Just out, Just err, p) <- createProcess $ process
139+ (_, Just out, Just err, p) <- createProcess $ overCreateProcess
90− { std_out = CreatePipe , std_err = CreatePipe }
140+ (\p -> p { std_out = CreatePipe , std_err = CreatePipe }) process
91
141
92 -- TODO interleave stdout and stderr in log correctly
142 -- TODO interleave stdout and stderr in log correctly
93 streamToLog =<< liftIO (streamHandle sev_err err)
143 streamToLog =<< liftIO (streamHandle sev_err err)
94 outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
144 outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
95 putLogRaw sev_out outText
145 putLogRaw sev_out outText
96
146
97− liftIO (waitForProcess p) >>= \case
147+ waitForProcess p >>= \case
98 ExitSuccess -> pure outText
148 ExitSuccess -> pure outText
99− ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (cmdspec process) code
149+ ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) code
100
150
101−-- | Like `System.Process.callProcess` but logs the combined output (stdout and stderr)
151+-- | Like 'System.Process.callProcess' but logs the combined output (stdout and stderr)
102-- with the corresponding severity.
152-- with the corresponding severity.
103--
153--
104-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
154-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
@@ -106,9 +156,8 @@ readProcessAndLogOutput (sev_out, sev_err) process = do
106-- which case it is advisable to call it with a non-Error severity for stderr, like
156-- which case it is advisable to call it with a non-Error severity for stderr, like
107-- `callProcessAndLogOutput (Debug, Debug)`.
157-- `callProcessAndLogOutput (Debug, Debug)`.
108callProcessAndLogOutput
158callProcessAndLogOutput
109−
110 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
159 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
111− => (Severity, Severity) -> CreateProcess -> m ()
160+ => (Severity, Severity) -> ProcessSpec -> m ()
112callProcessAndLogOutput (sev_out, sev_err) process =
161callProcessAndLogOutput (sev_out, sev_err) process =
113 void $ withProcess process $ \out err -> do
162 void $ withProcess process $ \out err -> do
114 stream <- liftIO $ join $ combineStream
163 stream <- liftIO $ join $ combineStream
@@ -118,21 +167,31 @@ callProcessAndLogOutput (sev_out, sev_err) process =
118 where
167 where
119 combineStream s1 s2 = concurrentMerge [s1, s2]
168 combineStream s1 s2 = concurrentMerge [s1, s2]
120
169
121−-- | Like `System.Process.createProcess` but also logs (debug) the process being run
170+-- | Like 'System.Process.createProcess' but also logs (debug) the process being run
122createProcess
171createProcess
123 :: (MonadIO m, CliLog m)
172 :: (MonadIO m, CliLog m)
124− => CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
173+ => ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
125−createProcess p = do
174+createProcess procSpec = do
175+ p <- mkCreateProcess procSpec
126− putLog Debug $ "Creating process: " <> reconstructCommand (cmdspec p)
176+ putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
127 liftIO $ Process.createProcess p
177 liftIO $ Process.createProcess p
128
178
129-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
179-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
130createProcess_
180createProcess_
131 :: (MonadIO m, CliLog m)
181 :: (MonadIO m, CliLog m)
132− => String -> CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
182+ => String -> ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
133−createProcess_ name p = do
183+createProcess_ name procSpec = do
184+ p <- mkCreateProcess procSpec
134− putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructCommand (cmdspec p)
185+ putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructProcSpec procSpec
135− liftIO $ Process.createProcess p
186+ liftIO $ Process.createProcess_ name p
187+
188+mkCreateProcess :: MonadIO m => ProcessSpec -> m Process.CreateProcess
189+mkCreateProcess (ProcessSpec p override') = do
190+ case override' of
191+ Nothing -> pure p
192+ Just override -> do
193+ procEnv <- Map.fromList <$> maybe (liftIO getEnvironment) pure (Process.env p)
194+ pure $ p { Process.env = Just $ Map.toAscList (override procEnv) }
136
195
137-- | Like `System.Process.callProcess` but also logs (debug) the process being run
196-- | Like `System.Process.callProcess` but also logs (debug) the process being run
138callProcess
197callProcess
@@ -152,17 +211,17 @@ callCommand cmd = do
152
211
153withProcess
212withProcess
154 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
213 :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
155− => CreateProcess -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
214+ => ProcessSpec -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
156withProcess process f = do -- TODO: Use bracket.
215withProcess process f = do -- TODO: Use bracket.
157 -- FIXME: Using `withCreateProcess` here leads to something operating illegally on closed handles.
216 -- FIXME: Using `withCreateProcess` here leads to something operating illegally on closed handles.
158− (_, Just out, Just err, p) <- createProcess $ process
217+ (_, Just out, Just err, p) <- createProcess $ overCreateProcess
159− { std_out = CreatePipe , std_err = CreatePipe }
218+ (\x -> x { std_out = CreatePipe , std_err = CreatePipe }) process
160
219
161 f out err -- Pass the handles to the passed function
220 f out err -- Pass the handles to the passed function
162
221
163− liftIO (waitForProcess p) >>= \case
222+ waitForProcess p >>= \case
164 ExitSuccess -> return (out, err)
223 ExitSuccess -> return (out, err)
165− ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (cmdspec process) code
224+ ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) code
166
225
167-- Create an input stream from the file handle, associating each item with the given severity.
226-- Create an input stream from the file handle, associating each item with the given severity.
168streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
227streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
@@ -177,10 +236,18 @@ streamToLog stream = fix $ \loop -> do
177 Nothing -> return ()
236 Nothing -> return ()
178 Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
237 Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
179
238
239+-- | Wrapper around `System.Process.waitForProcess`
240+waitForProcess :: MonadIO m => ProcessHandle -> m ExitCode
241+waitForProcess = liftIO . Process.waitForProcess
242+
180-- | Pretty print a 'CmdSpec'
243-- | Pretty print a 'CmdSpec'
181reconstructCommand :: Process.CmdSpec -> Text
244reconstructCommand :: Process.CmdSpec -> Text
245+reconstructCommand p = case p of
182−reconstructCommand (Process.ShellCommand str) = T.pack str
246+ Process.ShellCommand str -> T.pack str
183−reconstructCommand (Process.RawCommand c as) = processToShellString c as
247+ Process.RawCommand c as -> processToShellString c as
184 where
248 where
185 processToShellString cmd args = T.unwords $ map quoteAndEscape (cmd : args)
249 processToShellString cmd args = T.unwords $ map quoteAndEscape (cmd : args)
186 quoteAndEscape x = "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
250 quoteAndEscape x = "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
251+
252+reconstructProcSpec :: ProcessSpec -> Text
253+reconstructProcSpec = reconstructCommand . Process.cmdspec . _processSpec_createProcess
lib/cliapp/src/Obelisk/CliApp/Spinner.hs−1
@@ -3,7 +3,6 @@
3{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
4{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE TupleSections #-}
7-- | Provides a simple CLI spinner that interoperates cleanly with the rest of the logging output.
6-- | Provides a simple CLI spinner that interoperates cleanly with the rest of the logging output.
8module Obelisk.CliApp.Spinner
7module Obelisk.CliApp.Spinner
9 ( withSpinner
8 ( withSpinner
lib/command/obelisk-command.cabal+12−12
@@ -1,5 +1,5 @@
1name: obelisk-command
1name: obelisk-command
2−version: 0.3
2+version: 0.8.0.0
3cabal-version: >= 1.8
3cabal-version: >= 1.8
4build-type: Simple
4build-type: Simple
5
5
@@ -7,35 +7,35 @@ library
7 hs-source-dirs: src
7 hs-source-dirs: src
8 build-depends:
8 build-depends:
9 aeson
9 aeson
10− , ansi-terminal
11− , Cabal
12 , aeson-pretty
10 , aeson-pretty
11+ , ansi-terminal
13 , base
12 , base
14− , base16-bytestring
15− , binary
16 , bytestring
13 , bytestring
17− , obelisk-cliapp
14+ , Cabal
18 , containers
15 , containers
19 , data-default
16 , data-default
20 , directory
17 , directory
21 , either
18 , either
22 , errors
19 , errors
20+ , exceptions
21+ , extra
23 , filepath
22 , filepath
23+ , git
24 , github
24 , github
25 , here
25 , here
26− , git
27 , hnix
26 , hnix
28 , hpack
27 , hpack
29 , io-streams
28 , io-streams
30− , exceptions
31− , logging-effect
32 , lens
29 , lens
30+ , logging-effect
31+ , megaparsec
33 , modern-uri
32 , modern-uri
34 , monad-loops
33 , monad-loops
34+ , monoidal-containers
35 , mtl
35 , mtl
36− , megaparsec
37 , network
36 , network
38 , network-uri
37 , network-uri
38+ , obelisk-cliapp
39 , optparse-applicative
39 , optparse-applicative
40 , placeholders
40 , placeholders
41 , process
41 , process
@@ -58,8 +58,8 @@ library
58 Obelisk.Command.Thunk
58 Obelisk.Command.Thunk
59 Obelisk.Command.Utils
59 Obelisk.Command.Utils
60 Obelisk.Command.VmBuilder
60 Obelisk.Command.VmBuilder
61− -- -fobject-code is so that the StaticPointers extension can work in ghci
61+ Obelisk.Command.Preprocessor
62− ghc-options: -Wall -fobject-code
62+ ghc-options: -Wall
63
63
64executable ob
64executable ob
65 main-is: src-bin/ob.hs
65 main-is: src-bin/ob.hs
lib/command/src/Obelisk/Command.hs+183−151
@@ -3,22 +3,18 @@
3{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
4{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE StaticPointers #-}
6+{-# LANGUAGE TupleSections #-}
7−{-# LANGUAGE TypeApplications #-}
8module Obelisk.Command where
7module Obelisk.Command where
9
8
10−import Control.Monad
9+import Control.Monad.IO.Class (MonadIO, liftIO)
11−import Control.Monad.IO.Class (liftIO)
12−import qualified Data.Binary as Binary
13import Data.Bool (bool)
10import Data.Bool (bool)
14−import qualified Data.ByteString.Base16 as Base16
11+import Data.Foldable (for_)
15−import qualified Data.ByteString.Lazy as LBS
12+import Data.List (isInfixOf, isPrefixOf)
13+import Data.List.NonEmpty (NonEmpty, nonEmpty)
16−import Data.List
14+import qualified Data.List.NonEmpty as NonEmpty
17−import Data.Maybe (catMaybes)
15+import qualified Data.Map as Map
18import qualified Data.Text as T
16import qualified Data.Text as T
19−import Data.Text.Encoding
17+import Data.Traversable (for)
20−import Data.Text.Encoding.Error (lenientDecode)
21−import GHC.StaticPtr
22import Options.Applicative
18import Options.Applicative
23import Options.Applicative.Help.Pretty (text, (<$$>))
19import Options.Applicative.Help.Pretty (text, (<$$>))
24import System.Directory
20import System.Directory
@@ -30,13 +26,12 @@ import System.Posix.Process (executeFile)
30
26
31import Obelisk.App
27import Obelisk.App
32import Obelisk.CliApp
28import Obelisk.CliApp
33−import Obelisk.CliApp.Demo (cliDemo)
34import Obelisk.Command.Deploy
29import Obelisk.Command.Deploy
35import Obelisk.Command.Project
30import Obelisk.Command.Project
36import Obelisk.Command.Run
31import Obelisk.Command.Run
37import Obelisk.Command.Thunk
32import Obelisk.Command.Thunk
38−import Obelisk.Command.Utils
39import qualified Obelisk.Command.VmBuilder as VmBuilder
33import qualified Obelisk.Command.VmBuilder as VmBuilder
34+import qualified Obelisk.Command.Preprocessor as Preprocessor
40
35
41
36
42data Args = Args
37data Args = Args
@@ -79,8 +74,8 @@ argsInfo cfg = info (args cfg <**> helper) $ mconcat
79initSource :: Parser InitSource
74initSource :: Parser InitSource
80initSource = foldl1 (<|>)
75initSource = foldl1 (<|>)
81 [ pure InitSource_Default
76 [ pure InitSource_Default
82− , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH")
77+ , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH" <> help "Initialize the project using the given BRANCH of Obelisk's official repository")
83− , InitSource_Symlink <$> strOption (long "symlink" <> action "directory" <> metavar "PATH")
78+ , InitSource_Symlink <$> strOption (long "symlink" <> action "directory" <> metavar "PATH" <> help "(Use with caution) Initialize the project using the copy of Obelisk found at the given PATH")
84 ]
79 ]
85
80
86initForce :: Parser Bool
81initForce :: Parser Bool
@@ -89,59 +84,53 @@ initForce = switch (long "force" <> help "Allow ob init to overwrite files")
89data ObCommand
84data ObCommand
90 = ObCommand_Init InitSource Bool
85 = ObCommand_Init InitSource Bool
91 | ObCommand_Deploy DeployCommand
86 | ObCommand_Deploy DeployCommand
92− | ObCommand_Run
87+ | ObCommand_Run [(FilePath, Interpret)]
88+ | ObCommand_Profile String [String]
93− | ObCommand_Thunk ThunkCommand
89+ | ObCommand_Thunk ThunkOption
94− | ObCommand_Repl
90+ | ObCommand_Repl [(FilePath, Interpret)]
95− | ObCommand_Watch
91+ | ObCommand_Watch [(FilePath, Interpret)]
96 | ObCommand_Shell ShellOpts
92 | ObCommand_Shell ShellOpts
97 | ObCommand_Doc String [String] -- shell and list of packages
93 | ObCommand_Doc String [String] -- shell and list of packages
94+ | ObCommand_Hoogle String Int -- shell and port
98 | ObCommand_Internal ObInternal
95 | ObCommand_Internal ObInternal
99 deriving Show
96 deriving Show
100
97
101data ObInternal
98data ObInternal
102− = ObInternal_RunStaticIO StaticKey
99+ -- the preprocessor argument syntax is also handled outside
103− | ObInternal_CLIDemo
100+ -- optparse-applicative, but it shouldn't ever conflict with another syntax
101+ = ObInternal_ApplyPackages String String String [String]
102+ | ObInternal_ExportGhciConfig
103+ [(FilePath, Interpret)]
104+ Bool -- ^ Use relative paths
104 deriving Show
105 deriving Show
105
106
106−inNixShell' :: MonadObelisk m => StaticPtr (ObeliskT IO ()) -> m ()
107−inNixShell' p = withProjectRoot "." $ \root -> do
108− cmd <- liftIO $ unwords <$> mkCmd -- TODO: shell escape instead of unwords
109− projectShell root True "ghc" (Just cmd)
110− where
111− mkCmd = do
112− argsCfg <- getArgsConfig
113− myArgs <- getArgs
114− obArgs <- parseCLIArgs argsCfg myArgs
115− progName <- getObeliskExe
116− return $ progName : catMaybes
117− [ Just "--no-handoff"
118− , bool Nothing (Just "--verbose") $ _args_verbose obArgs
119− , Just "internal"
120− , Just "run-static-io"
121− , Just $ encodeStaticKey $ staticKey p
122− ]
123−
124obCommand :: ArgsConfig -> Parser ObCommand
107obCommand :: ArgsConfig -> Parser ObCommand
125obCommand cfg = hsubparser
108obCommand cfg = hsubparser
126− (mconcat
109+ (mconcat
127− [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
110+ [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
128− , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
111+ , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
129− , command "run" $ info (pure ObCommand_Run) $ progDesc "Run current project in development mode"
112+ , command "run" $ info (ObCommand_Run <$> interpretOpts) $ progDesc "Run current project in development mode"
113+ , command "profile" $ info (uncurry ObCommand_Profile <$> profileCommand) $ progDesc "Run current project with profiling enabled"
130− , command "thunk" $ info (ObCommand_Thunk <$> thunkCommand) $ progDesc "Manipulate thunk directories"
114+ , command "thunk" $ info (ObCommand_Thunk <$> thunkOption) $ progDesc "Manipulate thunk directories"
131− , command "repl" $ info (pure ObCommand_Repl) $ progDesc "Open an interactive interpreter"
115+ , command "repl" $ info (ObCommand_Repl <$> interpretOpts) $ progDesc "Open an interactive interpreter"
132− , command "watch" $ info (pure ObCommand_Watch) $ progDesc "Watch current project for errors and warnings"
116+ , command "watch" $ info (ObCommand_Watch <$> interpretOpts) $ progDesc "Watch current project for errors and warnings"
133− , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies"
117+ , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies"
134− , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
118+ , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
135− progDesc "List paths to haddock documentation for specified packages"
119+ progDesc "List paths to haddock documentation for specified packages"
136− <> footerDoc (Just $
120+ <> footerDoc (Just $
137− text "Hint: To open the documentation you can pipe the output of this command like"
121+ text "Hint: To open the documentation you can pipe the output of this command like"
138− <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
122+ <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
139− ])
123+ , command "hoogle" $ info (ObCommand_Hoogle <$> shellFlags <*> portOpt 8080) $ progDesc "Run a hoogle server locally for your project's dependency tree"
140− <|> subparser
141− (mconcat
142− [ internal
143− , command "internal" (info (ObCommand_Internal <$> internalCommand) mempty)
124+ , command "internal" $ info (ObCommand_Internal <$> internalCommand) $ progDesc "Internal Obelisk commands with unstable APIs"
125+ ])
126+
127+internalCommand :: Parser ObInternal
128+internalCommand = hsubparser $ mconcat
129+ [ command "export-ghci-configuration" $ info (ObInternal_ExportGhciConfig <$> interpretOpts <*> useRelativePathsFlag)
130+ $ progDesc "Export the GHCi configuration used by ob run, etc.; useful for IDE integration"
144− ])
131+ ]
132+ where
133+ useRelativePathsFlag = switch (long "use-relative-paths" <> help "Use relative paths")
145
134
146packageNames :: Parser [String]
135packageNames :: Parser [String]
147packageNames = some (strArgument (metavar "PACKAGE-NAME..."))
136packageNames = some (strArgument (metavar "PACKAGE-NAME..."))
@@ -156,7 +145,7 @@ deployCommand cfg = hsubparser $ mconcat
156 where
145 where
157 platformP = hsubparser $ mconcat
146 platformP = hsubparser $ mconcat
158 [ command "android" $ info (pure (Android, [])) mempty
147 [ command "android" $ info (pure (Android, [])) mempty
159− , command "ios" $ info ((,) <$> pure IOS <*> (fmap pure $ strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
148+ , command "ios" $ info ((,) <$> pure IOS <*> fmap pure (strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
160 ]
149 ]
161
150
162 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
151 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
@@ -178,8 +167,8 @@ deployCommand cfg = hsubparser $ mconcat
178
167
179deployInitOpts :: Parser DeployInitOpts
168deployInitOpts :: Parser DeployInitOpts
180deployInitOpts = DeployInitOpts
169deployInitOpts = DeployInitOpts
181− <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory that it will create")
170+ <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory where the deployment repository will be initialized")
182− <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an ssh key that it will symlink to")
171+ <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an SSH key that will be *copied* to the deployment repository")
183 <*> some (strOption (long "hostname" <> metavar "HOSTNAME" <> help "hostname of the deployment target"))
172 <*> some (strOption (long "hostname" <> metavar "HOSTNAME" <> help "hostname of the deployment target"))
184 <*> strOption (long "route" <> metavar "PUBLICROUTE" <> help "Publicly accessible URL of your app")
173 <*> strOption (long "route" <> metavar "PUBLICROUTE" <> help "Publicly accessible URL of your app")
185 <*> strOption (long "admin-email" <> metavar "ADMINEMAIL" <> help "Email address where administrative alerts will be sent")
174 <*> strOption (long "admin-email" <> metavar "ADMINEMAIL" <> help "Email address where administrative alerts will be sent")
@@ -196,49 +185,72 @@ data DeployCommand
196 | DeployCommand_Update
185 | DeployCommand_Update
197 deriving Show
186 deriving Show
198
187
199−data DeployInitOpts = DeployInitOpts
188+profileCommand :: Parser (String, [String])
200− { _deployInitOpts_outputDir :: FilePath
189+profileCommand = (,)
201− , _deployInitOpts_sshKey :: FilePath
190+ <$> strOption
202− , _deployInitOpts_hostname :: [String]
191+ ( long "output"
203− , _deployInitOpts_route :: String
192+ <> short 'o'
204− , _deployInitOpts_adminEmail :: String
193+ <> help "Base output to use for profiling output. Suffixes are added to this based on the profiling type. Defaults to a timestamped path in the profile/ directory in the project's root."
205− , _deployInitOpts_enableHttps :: Bool
194+ <> metavar "PATH"
206− }
195+ <> value "profile/%Y-%m-%dT%H:%M:%S"
196+ <> showDefault
197+ )
198+ <*> (words <$> strOption
199+ ( long "rts-flags"
200+ <> help "RTS Flags to pass to the executable."
201+ <> value "-p -hc"
202+ <> metavar "FLAGS"
203+ <> showDefault
204+ ))
205+
206+thunkConfig :: Parser ThunkConfig
207+thunkConfig = ThunkConfig
208+ <$>
209+ ( flag' (Just True) (long "private" <> help "Mark thunks as pointing to a private repository")
210+ <|> flag' (Just False) (long "public" <> help "Mark thunks as pointing to a public repository")
211+ <|> pure Nothing
212+ )
213+
214+thunkUpdateConfig :: Parser ThunkUpdateConfig
215+thunkUpdateConfig = ThunkUpdateConfig
216+ <$> optional (strOption (long "branch" <> metavar "BRANCH" <> help "Use the given branch when looking for the latest revision"))
217+ <*> thunkConfig
218+
219+thunkPackConfig :: Parser ThunkPackConfig
220+thunkPackConfig = ThunkPackConfig
221+ <$> switch (long "force" <> short 'f' <> help "Force packing thunks even if there are branches not pushed upstream, uncommitted changes, stashes. This will cause changes that have not been pushed upstream to be lost; use with care.")
222+ <*> thunkConfig
223+
224+data ThunkOption = ThunkOption
225+ { _thunkOption_thunks :: NonEmpty FilePath
226+ , _thunkOption_command :: ThunkCommand
207− deriving Show
227+ } deriving Show
208−
209−internalCommand :: Parser ObInternal
210−internalCommand = subparser $ mconcat
211− [ command "run-static-io" $ info (ObInternal_RunStaticIO <$> argument (eitherReader decodeStaticKey) (action "static-key")) mempty
212− , command "clidemo" $ info (pure ObInternal_CLIDemo) mempty
213− ]
214−
215−--TODO: Result should provide normalised path and also original user input for error reporting.
216−thunkDirectoryParser :: Parser FilePath
217−thunkDirectoryParser = fmap (dropTrailingPathSeparator . normalise) . strArgument $ mconcat
218− [ action "directory"
219− , metavar "THUNKDIR"
220− , help "Path to directory containing thunk data"
221− ]
222
228
223data ThunkCommand
229data ThunkCommand
224− = ThunkCommand_Update [FilePath] (Maybe String)
230+ = ThunkCommand_Update ThunkUpdateConfig
225− | ThunkCommand_Unpack [FilePath]
231+ | ThunkCommand_Unpack
226− | ThunkCommand_Pack [FilePath] Bool
232+ | ThunkCommand_Pack ThunkPackConfig
227 deriving Show
233 deriving Show
228
234
229−forceFlag :: Parser Bool
235+thunkOption :: Parser ThunkOption
230−forceFlag = switch $ long "force" <> short 'f' <> help "Force packing thunks even if there are branches not pushed upstream, uncommitted changes, stashes. This will cause changes that have not been pushed upstream to be lost; use with care."
231−
232−thunkCommand :: Parser ThunkCommand
233−thunkCommand = hsubparser $ mconcat
236+thunkOption = hsubparser $ mconcat
234− [ command "update" $ info (ThunkCommand_Update <$> some thunkDirectoryParser <*> optional (strOption (long "branch" <> metavar "BRANCH"))) $ progDesc "Update thunk to latest revision available"
237+ [ command "update" $ info (thunkOptionWith $ ThunkCommand_Update <$> thunkUpdateConfig) $ progDesc "Update packed thunk to latest revision available on the tracked branch"
235− , command "unpack" $ info (ThunkCommand_Unpack <$> some thunkDirectoryParser) $ progDesc "Unpack thunk into git checkout of revision it points to"
238+ , command "unpack" $ info (thunkOptionWith $ pure ThunkCommand_Unpack) $ progDesc "Unpack thunk into git checkout of revision it points to"
236− , command "pack" $ info (ThunkCommand_Pack <$> some thunkDirectoryParser <*> forceFlag) $ progDesc "Pack git checkout into thunk that points at the current branch's upstream"
239+ , command "pack" $ info (thunkOptionWith $ ThunkCommand_Pack <$> thunkPackConfig) $ progDesc "Pack git checkout or unpacked thunk into thunk that points at the current branch's upstream"
237 ]
240 ]
241+ where
242+ thunkOptionWith f = ThunkOption
243+ <$> ((NonEmpty.:|)
244+ <$> thunkDirArg (metavar "THUNKDIRS..." <> help "Paths to directories containing thunk data")
245+ <*> many (thunkDirArg mempty)
246+ )
247+ <*> f
248+ thunkDirArg opts = fmap (dropTrailingPathSeparator . normalise) $ strArgument $ action "directory" <> opts
238
249
239data ShellOpts
250data ShellOpts
240 = ShellOpts
251 = ShellOpts
241 { _shellOpts_shell :: String
252 { _shellOpts_shell :: String
253+ , _shellOpts_interpretPaths :: [(FilePath, Interpret)]
242 , _shellOpts_command :: Maybe String
254 , _shellOpts_command :: Maybe String
243 }
255 }
244 deriving Show
256 deriving Show
@@ -249,19 +261,40 @@ shellFlags =
249 <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
261 <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
250 <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
262 <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
251
263
264+interpretOpts :: Parser [(FilePath, Interpret)]
265+interpretOpts = many
266+ ( (, Interpret_Interpret) <$>
267+ strOption (common <> long "interpret" <> help
268+ "Don't pre-build packages found in DIR when constructing the package database. The default behavior is \
269+ \'--interpret <project-root>', which will load everything which is unpacked into GHCi. \
270+ \ Use --interpret and --no-interpret multiple times to add or remove multiple trees \
271+ \ from the environment. Settings for right-most directories will \
272+ \ override settings for any identical directories given earlier."
273+ )
274+ <|> (, Interpret_NoInterpret) <$>
275+ strOption (common <> long "no-interpret" <> help
276+ "Make packages found in DIR available in the package database (but only when they are used dependencies). \
277+ \ This will build the packages in DIR before loading GHCi. \
278+ \See help for --interpret for how the two options are related."
279+ )
280+ )
281+ where
282+ common = action "directory" <> metavar "DIR"
283+
252shellOpts :: Parser ShellOpts
284shellOpts :: Parser ShellOpts
253shellOpts = ShellOpts
285shellOpts = ShellOpts
254 <$> shellFlags
286 <$> shellFlags
287+ <*> interpretOpts
255 <*> optional (strArgument (metavar "COMMAND"))
288 <*> optional (strArgument (metavar "COMMAND"))
256
289
290+portOpt :: Int -> Parser Int
291+portOpt dfault = option auto (long "port" <> short 'p' <> help "Port number for server" <> showDefault <> value dfault <> metavar "INT")
292+
257parserPrefs :: ParserPrefs
293parserPrefs :: ParserPrefs
258parserPrefs = defaultPrefs
294parserPrefs = defaultPrefs
259 { prefShowHelpOnEmpty = True
295 { prefShowHelpOnEmpty = True
260 }
296 }
261
297
262−parseCLIArgs :: ArgsConfig -> [String] -> IO Args
263−parseCLIArgs cfg as = pure as >>= handleParseResult . execParserPure parserPrefs (argsInfo cfg)
264−
265-- | Create an Obelisk config for the current process.
298-- | Create an Obelisk config for the current process.
266mkObeliskConfig :: IO Obelisk
299mkObeliskConfig :: IO Obelisk
267mkObeliskConfig = do
300mkObeliskConfig = do
@@ -333,6 +366,9 @@ main' argsCfg = do
333 liftIO $ executeFile impl False ("--no-handoff" : myArgs) Nothing
366 liftIO $ executeFile impl False ("--no-handoff" : myArgs) Nothing
334 case myArgs of
367 case myArgs of
335 "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
368 "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
369+ origPath:inPath:outPath:preprocessorName:packagePaths
370+ | preprocessorName == preprocessorIdentifier && any (\c -> c == '.' || c == pathSeparator) origPath ->
371+ ob $ ObCommand_Internal $ ObInternal_ApplyPackages origPath inPath outPath packagePaths
336 a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
372 a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
337 | "--bash-completion" `isPrefixOf` a
373 | "--bash-completion" `isPrefixOf` a
338 && "--no-handoff" `elem` as -> go (a:as)
374 && "--no-handoff" `elem` as -> go (a:as)
@@ -343,29 +379,7 @@ ob :: MonadObelisk m => ObCommand -> m ()
343ob = \case
379ob = \case
344 ObCommand_Init source force -> initProject source force
380 ObCommand_Init source force -> initProject source force
345 ObCommand_Deploy dc -> case dc of
381 ObCommand_Deploy dc -> case dc of
346− DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> do
382+ DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> deployInit deployOpts root
347− let deployDir = _deployInitOpts_outputDir deployOpts
348− r <- liftIO $ canonicalizePath root
349− rootEqualsTarget <- liftIO $ equalFilePath r <$> canonicalizePath deployDir
350− when rootEqualsTarget $
351− failWith $ "Deploy directory " <> T.pack deployDir <> " should not be the same as project root."
352− thunkPtr <- readThunk root >>= \case
353− Left err -> failWith $ case err of
354− ReadThunkError_AmbiguousFiles ->
355− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
356− ReadThunkError_UnrecognizedFiles ->
357− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
358− _ -> "thunk read: " <> T.pack (show err)
359− Right (ThunkData_Packed ptr) -> return ptr
360− Right (ThunkData_Checkout (Just ptr)) -> return ptr
361− Right (ThunkData_Checkout Nothing) ->
362− getThunkPtr False root
363− let sshKeyPath = _deployInitOpts_sshKey deployOpts
364− hostname = _deployInitOpts_hostname deployOpts
365− route = _deployInitOpts_route deployOpts
366− adminEmail = _deployInitOpts_adminEmail deployOpts
367− enableHttps = _deployInitOpts_enableHttps deployOpts
368− deployInit thunkPtr deployDir sshKeyPath hostname route adminEmail enableHttps
369 DeployCommand_Push remoteBuilder -> do
383 DeployCommand_Push remoteBuilder -> do
370 deployPath <- liftIO $ canonicalizePath "."
384 deployPath <- liftIO $ canonicalizePath "."
371 deployPush deployPath $ case remoteBuilder of
385 deployPush deployPath $ case remoteBuilder of
@@ -373,25 +387,36 @@ ob = \case
373 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
387 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
374 DeployCommand_Update -> deployUpdate "."
388 DeployCommand_Update -> deployUpdate "."
375 DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
389 DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
376− ObCommand_Run -> inNixShell' $ static run
390+ ObCommand_Run interpretPathsList -> withInterpretPaths interpretPathsList run
377− -- inNixShell ($(mkClosure 'ghcidAction) ())
391+ ObCommand_Profile basePath rtsFlags -> profile basePath rtsFlags
378− ObCommand_Thunk tc -> case tc of
392+ ObCommand_Thunk to -> case _thunkOption_command to of
379− ThunkCommand_Update thunks mBranch -> mapM_ ((flip updateThunkToLatest) mBranch) thunks
393+ ThunkCommand_Update config -> for_ thunks (updateThunkToLatest config)
380− ThunkCommand_Unpack thunks -> mapM_ unpackThunk thunks
394+ ThunkCommand_Unpack -> for_ thunks unpackThunk
381− ThunkCommand_Pack thunks force -> forM_ thunks (packThunk force)
395+ ThunkCommand_Pack config -> for_ thunks (packThunk config)
396+ where
397+ thunks = _thunkOption_thunks to
382− ObCommand_Repl -> runRepl
398+ ObCommand_Repl interpretPathsList -> withInterpretPaths interpretPathsList runRepl
383− ObCommand_Watch -> inNixShell' $ static runWatch
399+ ObCommand_Watch interpretPathsList -> withInterpretPaths interpretPathsList runWatch
384− ObCommand_Shell so -> withProjectRoot "." $ \root ->
400+ ObCommand_Shell (ShellOpts shellAttr interpretPathsList cmd) -> withInterpretPaths interpretPathsList $ \root interpretPaths ->
385− projectShell root False (_shellOpts_shell so) (_shellOpts_command so)
401+ nixShellForInterpretPaths False shellAttr root interpretPaths cmd
386− ObCommand_Doc shell pkgs -> withProjectRoot "." $ \root ->
402+ ObCommand_Doc shellAttr pkgs -> withProjectRoot "." $ \root ->
387− projectShell root False shell (Just $ haddockCommand pkgs)
403+ nixShellForInterpretPaths True shellAttr root emptyPathTree $ Just $ haddockCommand pkgs
404+ ObCommand_Hoogle shell' port -> withProjectRoot "." $ \root -> do
405+ nixShellWithHoogle root True shell' $ Just $ "hoogle server -p " <> show port <> " --local"
388 ObCommand_Internal icmd -> case icmd of
406 ObCommand_Internal icmd -> case icmd of
389− ObInternal_RunStaticIO k -> liftIO (unsafeLookupStaticPtr @(ObeliskT IO ()) k) >>= \case
407+ ObInternal_ApplyPackages origPath inPath outPath packagePaths -> do
390− Nothing -> failWith $ "ObInternal_RunStaticIO: no such StaticKey: " <> T.pack (show k)
408+ liftIO $ Preprocessor.applyPackages origPath inPath outPath packagePaths
391− Just p -> do
409+ ObInternal_ExportGhciConfig interpretPathsList useRelativePaths ->
392− c <- getObelisk
410+ liftIO . putStrLn . unlines =<< withInterpretPaths interpretPathsList (exportGhciConfig useRelativePaths)
393− liftIO $ runObelisk c $ deRefStaticPtr p
411+
394− ObInternal_CLIDemo -> cliDemo
412+-- | A helper for the common case that the command you want to run needs the project root and a resolved
413+-- set of interpret paths.
414+withInterpretPaths :: MonadObelisk m => [(FilePath, Interpret)] -> (FilePath -> PathTree Interpret -> m a) -> m a
415+withInterpretPaths interpretPathsList f = withProjectRoot "." $ \root -> do
416+ interpretPaths' <- resolveInterpretPaths $ (root, Interpret_Interpret) : interpretPathsList
417+ case interpretPaths' of
418+ Nothing -> failWith "No paths provided for finding packages"
419+ Just interpretPaths -> f root interpretPaths
395
420
396haddockCommand :: [String] -> String
421haddockCommand :: [String] -> String
397haddockCommand pkgs = unwords
422haddockCommand pkgs = unwords
@@ -406,14 +431,21 @@ haddockCommand pkgs = unwords
406getArgsConfig :: IO ArgsConfig
431getArgsConfig :: IO ArgsConfig
407getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
432getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
408
433
409−encodeStaticKey :: StaticKey -> String
434+-- | Resolves an ordered list of paths for use with @--interpret@/@--no-interpret@ by coalescing
410−encodeStaticKey = T.unpack . decodeUtf8With lenientDecode . Base16.encode . LBS.toStrict . Binary.encode
435+-- paths into a non-ambiguous set of paths. Ambiguity is resolved by choosing right-most paths
411−
436+-- over any preceeding identical paths.
412−-- TODO: Use failWith in place of fail to be consistent.
437+--
413−decodeStaticKey :: String -> Either String StaticKey
438+-- For example: @a/b=ON a/b/c=OFF@ and @a/b/c=OFF a/b=ON@ are the same.
414−decodeStaticKey s = case Base16.decode $ encodeUtf8 $ T.pack s of
439+-- @a/b=ON a/b=OFF@ is reduced to @a/b=OFF@. We prefer right-biased choice to increase
415− (b, "") -> case Binary.decodeOrFail $ LBS.fromStrict b of
440+-- scriptability.
416− Right ("", _, a) -> pure a
441+--
417− Right _ -> fail "decodeStaticKey: Binary.decodeOrFail didn't consume all input"
442+-- N.B. All the paths in the result will be canonicalized. It's impossible to determine path
418− Left (_, _, e) -> fail $ "decodeStaticKey: Binary.decodeOrFail failed: " <> show e
443+-- overlap otherwise.
419− _ -> fail $ "decodeStaticKey: could not decode hex string: " <> show s
444+resolveInterpretPaths :: MonadIO m => [(FilePath, a)] -> m (Maybe (PathTree a))
445+resolveInterpretPaths ps = do
446+ trees <- liftIO $ for ps $ \(p, a) -> pathToTree a <$> canonicalizePath p
447+ pure $ foldr1 mergeTrees <$> nonEmpty trees
448+ where
449+ -- | Merge two 'PathTree's preferring leaves on the right in as much as they overlap with paths on the left.
450+ mergeTrees :: PathTree a -> PathTree a -> PathTree a
451+ 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+103−85
@@ -1,63 +1,77 @@
1+{-# LANGUAGE DeriveGeneric #-}
1{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
5+{-# LANGUAGE QuasiQuotes #-}
4{-# LANGUAGE ScopedTypeVariables #-}
6{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ViewPatterns #-}
7{-# LANGUAGE ViewPatterns #-}
6−{-# LANGUAGE DeriveGeneric #-}
7module Obelisk.Command.Deploy where
8module Obelisk.Command.Deploy where
8
9
10+import Control.Applicative (liftA2)
9import Control.Lens
11import Control.Lens
10import Control.Monad
12import Control.Monad
11−import Control.Monad.Catch (Exception (displayException), MonadThrow, throwM, try, bracket_)
13+import Control.Monad.Catch (Exception (displayException), MonadThrow, bracket, throwM, try)
12−import Control.Monad.IO.Class (liftIO)
14+import Control.Monad.IO.Class (MonadIO, liftIO)
13import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
15import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
14import Data.Bits
16import Data.Bits
15import qualified Data.ByteString.Lazy as BSL
17import qualified Data.ByteString.Lazy as BSL
16import Data.Default
18import Data.Default
17−import qualified Data.HashMap.Strict as HM
18import qualified Data.Map as Map
19import qualified Data.Map as Map
19−import Data.Text (Text)
20import qualified Data.Set as Set
20import qualified Data.Set as Set
21+import Data.String.Here.Interpolated (i)
21import qualified Data.Text as T
22import qualified Data.Text as T
22import qualified Data.Text.IO as T
23import qualified Data.Text.IO as T
23import GHC.Generics
24import GHC.Generics
24−import Nix.Pretty
25−import Nix.String (principledMakeNixStringWithoutContext)
26−import Nix.Value
27import System.Directory
25import System.Directory
28−import System.Environment (getEnvironment)
29import System.FilePath
26import System.FilePath
30import System.IO
27import System.IO
31import System.Posix.Files
28import System.Posix.Files
32−import System.Process (delegate_ctlc, env, proc, cwd)
33import Text.URI (URI)
29import Text.URI (URI)
34import qualified Text.URI as URI
30import qualified Text.URI as URI
35import Text.URI.Lens
31import Text.URI.Lens
36
32
37import Obelisk.App (MonadObelisk)
33import Obelisk.App (MonadObelisk)
34+import Obelisk.CliApp (
38−import Obelisk.CliApp (Severity (..), callProcessAndLogOutput, failWith, putLog, withSpinner)
35+ Severity (..), callProcessAndLogOutput, failWith, proc, putLog,
36+ setCwd, setDelegateCtlc, setEnvOverride, withSpinner)
39import Obelisk.Command.Nix
37import Obelisk.Command.Nix
40import Obelisk.Command.Project
38import Obelisk.Command.Project
41import Obelisk.Command.Thunk
39import Obelisk.Command.Thunk
42import Obelisk.Command.Utils
40import Obelisk.Command.Utils
43
41
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+
44−deployInit
62+deployInit'
45 :: MonadObelisk m
63 :: MonadObelisk m
46 => ThunkPtr
64 => ThunkPtr
47− -> FilePath
65+ -> DeployInitOpts
48− -> FilePath
49− -> [String] -- ^ hostnames
50− -> String -- ^ route
51− -> String -- ^ admin email
52− -> Bool -- ^ enable https
53 -> m ()
66 -> 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
55 localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
69 localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
56 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
70 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
57 False -> failWith $ T.pack $ "ob deploy init: file does not exist: " <> sshKeyPath
71 False -> failWith $ T.pack $ "ob deploy init: file does not exist: " <> sshKeyPath
58 True -> pure $ deployDir </> "ssh_key"
72 True -> pure $ deployDir </> "ssh_key"
59 callProcessAndLogOutput (Notice, Error) $
73 callProcessAndLogOutput (Notice, Error) $
60− proc "cp" [sshKeyPath, localKey]
74+ proc cp [sshKeyPath, localKey]
61 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
75 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
62 return localKey
76 return localKey
63 withSpinner "Validating configuration" $ do
77 withSpinner "Validating configuration" $ do
@@ -78,22 +92,30 @@ deployInit thunkPtr deployDir sshKeyPath hostnames route adminEmail enableHttps
78 , deployDir </> "config" </> "common"
92 , deployDir </> "config" </> "common"
79 , deployDir </> "config" </> "frontend"
93 , deployDir </> "config" </> "frontend"
80 ]
94 ]
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+
81 withSpinner "Writing deployment configuration" $ do
101 withSpinner "Writing deployment configuration" $ do
82 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
102 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
83 writeDeployConfig deployDir "enable_https" $ show enableHttps
103 writeDeployConfig deployDir "enable_https" $ show enableHttps
84 writeDeployConfig deployDir "admin_email" adminEmail
104 writeDeployConfig deployDir "admin_email" adminEmail
85− writeDeployConfig deployDir ("config" </> "common" </> "route") $ route
105+ writeDeployConfig deployDir ("config" </> "common" </> "route") route
86− withSpinner "Creating source thunk (./src)" $ liftIO $ do
106+ writeDeployConfig deployDir "module.nix" $
87− createThunk (deployDir </> "src") thunkPtr
107+ "(import " <> toNixPath (makeRelative deployDir srcDir) <> " {}).obelisk.serverModules.mkBaseEc2"
88− setupObeliskImpl deployDir
108+
89 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
109 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
90 initGit deployDir
110 initGit deployDir
91
111
92−setupObeliskImpl :: FilePath -> IO ()
112+setupObeliskImpl :: MonadIO m => FilePath -> m ()
93−setupObeliskImpl deployDir = do
113+setupObeliskImpl deployDir = liftIO $ do
114+ let
94− let implDir = toImplDir deployDir
115+ implDir = toImplDir deployDir
116+ goBackUp = foldr (</>) "" $ (".." <$) $ splitPath $ makeRelative deployDir implDir
95 createDirectoryIfMissing True implDir
117 createDirectoryIfMissing True implDir
96− writeFile (implDir </> "default.nix") "(import ../../src {}).obelisk"
118+ writeFile (implDir </> "default.nix") $ "(import " <> toNixPath (goBackUp </> "src") <> " {}).obelisk"
97
119
98deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
120deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
99deployPush deployPath getNixBuilders = do
121deployPush deployPath getNixBuilders = do
@@ -104,14 +126,16 @@ deployPush deployPath getNixBuilders = do
104 routeHost <- getHostFromRoute enableHttps route
126 routeHost <- getHostFromRoute enableHttps route
105 let srcPath = deployPath </> "src"
127 let srcPath = deployPath </> "src"
106 thunkPtr <- readThunk srcPath >>= \case
128 thunkPtr <- readThunk srcPath >>= \case
107− Right (ThunkData_Packed ptr) -> return ptr
129+ Right (ThunkData_Packed _ ptr) -> return ptr
108− Right (ThunkData_Checkout _) -> do
130+ Right ThunkData_Checkout -> do
109 checkGitCleanStatus srcPath True >>= \case
131 checkGitCleanStatus srcPath True >>= \case
110− True -> packThunk False srcPath
132+ True -> packThunk (ThunkPackConfig False (ThunkConfig Nothing)) srcPath
111 False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
133 False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
112 Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
134 Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
113 let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
135 let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
114 builders <- getNixBuilders
136 builders <- getNixBuilders
137+ let moduleFile = deployPath </> "module.nix"
138+ moduleFileExists <- liftIO $ doesFileExist moduleFile
115 buildOutputByHost <- ifor (Map.fromSet (const ()) hosts) $ \host () -> do
139 buildOutputByHost <- ifor (Map.fromSet (const ()) hosts) $ \host () -> do
116 --TODO: What does it mean if this returns more or less than 1 line of output?
140 --TODO: What does it mean if this returns more or less than 1 line of output?
117 [result] <- fmap lines $ nixCmd $ NixCmd_Build $ def
141 [result] <- fmap lines $ nixCmd $ NixCmd_Build $ def
@@ -121,13 +145,13 @@ deployPush deployPath getNixBuilders = do
121 , _target_expr = Nothing
145 , _target_expr = Nothing
122 }
146 }
123 & nixBuildConfig_outLink .~ OutLink_None
147 & nixBuildConfig_outLink .~ OutLink_None
124− & nixCmdConfig_args .~
148+ & nixCmdConfig_args .~ (
125 [ strArg "hostName" host
149 [ strArg "hostName" host
126 , strArg "adminEmail" adminEmail
150 , strArg "adminEmail" adminEmail
127 , strArg "routeHost" routeHost
151 , strArg "routeHost" routeHost
128 , strArg "version" version
152 , strArg "version" version
129 , boolArg "enableHttps" enableHttps
153 , boolArg "enableHttps" enableHttps
130− ]
154+ ] <> [rawArg "module" ("import " <> toNixPath moduleFile) | moduleFileExists ])
131 & nixCmdConfig_builders .~ builders
155 & nixCmdConfig_builders .~ builders
132 pure result
156 pure result
133 let knownHostsPath = deployPath </> "backend_known_hosts"
157 let knownHostsPath = deployPath </> "backend_known_hosts"
@@ -157,7 +181,7 @@ deployPush deployPath getNixBuilders = do
157 ]
181 ]
158 isClean <- checkGitCleanStatus deployPath True
182 isClean <- checkGitCleanStatus deployPath True
159 when (not isClean) $ do
183 when (not isClean) $ do
160− withSpinner "Commiting changes to Git" $ do
184+ withSpinner "Committing changes to Git" $ do
161 callProcessAndLogOutput (Debug, Error) $ proc "git"
185 callProcessAndLogOutput (Debug, Error) $ proc "git"
162 ["-C", deployPath, "add", "."]
186 ["-C", deployPath, "add", "."]
163 callProcessAndLogOutput (Debug, Error) $ proc "git"
187 callProcessAndLogOutput (Debug, Error) $ proc "git"
@@ -165,26 +189,11 @@ deployPush deployPath getNixBuilders = do
165 putLog Notice $ "Deployed => " <> T.pack route
189 putLog Notice $ "Deployed => " <> T.pack route
166 where
190 where
167 callProcess' envMap cmd args = do
191 callProcess' envMap cmd args = do
168− processEnv <- Map.toList . (envMap <>) . Map.fromList <$> liftIO getEnvironment
192+ let p = setEnvOverride (envMap <>) $ setDelegateCtlc True $ proc cmd args
169− let p = (proc cmd args) { delegate_ctlc = True, env = Just processEnv }
170 callProcessAndLogOutput (Notice, Notice) p
193 callProcessAndLogOutput (Notice, Notice) p
171
194
172deployUpdate :: MonadObelisk m => FilePath -> m ()
195deployUpdate :: MonadObelisk m => FilePath -> m ()
173−deployUpdate deployPath = updateThunkToLatest (deployPath </> "src") Nothing
196+deployUpdate deployPath = updateThunkToLatest (ThunkUpdateConfig Nothing (ThunkConfig Nothing)) (deployPath </> "src")
174−
175−keytoolToAndroidConfig :: KeytoolConfig -> HM.HashMap Text (NValue t Identity m)
176−keytoolToAndroidConfig conf =
177− let path = nvPath $ _keytoolConfig_keystore conf
178− fromStr = nvStr . principledMakeNixStringWithoutContext . T.pack
179− storepass = fromStr $ _keytoolConfig_storepass conf
180− alias = fromStr $ _keytoolConfig_alias conf
181− keypass = fromStr $ _keytoolConfig_keypass conf
182− in HM.fromList
183− [ ("storeFile", path)
184− , ("storePassword", storepass)
185− , ("keyAlias", alias)
186− , ("keyPassword", keypass)
187− ]
188
197
189data PlatformDeployment = Android | IOS
198data PlatformDeployment = Android | IOS
190 deriving (Show, Eq)
199 deriving (Show, Eq)
@@ -200,7 +209,7 @@ deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
200 configDir = root </> "config"
209 configDir = root </> "config"
201 exists <- liftIO $ doesDirectoryExist srcDir
210 exists <- liftIO $ doesDirectoryExist srcDir
202 unless exists $ failWith "ob test should be run inside of a deploy directory"
211 unless exists $ failWith "ob test should be run inside of a deploy directory"
203− nixBuildTarget <- case platform of
212+ (nixBuildTarget, extraArgs) <- case platform of
204 Android -> do
213 Android -> do
205 let keystorePath = root </> "android_keystore.jks"
214 let keystorePath = root </> "android_keystore.jks"
206 keytoolConfPath = root </> "android_keytool_config.json"
215 keytoolConfPath = root </> "android_keytool_config.json"
@@ -219,48 +228,60 @@ deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
219 , _keytoolConfig_storepass = keyStorePassword
228 , _keytoolConfig_storepass = keyStorePassword
220 , _keytoolConfig_keypass = keyStorePassword
229 , _keytoolConfig_keypass = keyStorePassword
221 }
230 }
222− createKeystore root $ keyToolConf
231+ createKeystore root keyToolConf
223 liftIO $ BSL.writeFile keytoolConfPath $ encode keyToolConf
232 liftIO $ BSL.writeFile keytoolConfPath $ encode keyToolConf
224 checkKeytoolConfExist <- liftIO $ doesFileExist keytoolConfPath
233 checkKeytoolConfExist <- liftIO $ doesFileExist keytoolConfPath
225 unless checkKeytoolConfExist $ failWith "Missing android KeytoolConfig"
234 unless checkKeytoolConfExist $ failWith "Missing android KeytoolConfig"
226 keytoolConfContents <- liftIO $ BSL.readFile keytoolConfPath
235 keytoolConfContents <- liftIO $ BSL.readFile keytoolConfPath
227− liftIO $ print keytoolConfContents
228− releaseKey :: String <- case eitherDecode keytoolConfContents :: Either String KeytoolConfig of
236+ keyArgs <- case eitherDecode keytoolConfContents :: Either String KeytoolConfig of
229 Left err -> failWith $ T.pack err
237 Left err -> failWith $ T.pack err
230− Right conf -> return $
238+ Right conf -> pure
231− (printNix :: MonadObelisk m => NValue t Identity m -> String) $
239+ [ "--sign"
232− nvSet (keytoolToAndroidConfig conf) HM.empty
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+ ]
233 let expr = mconcat
245 let expr = mconcat
234− [ "with (import ", srcDir, " {});"
246+ [ "with (import ", toNixPath srcDir, " {});"
235− , "android.frontend.override (drv: { "
247+ , "android.frontend.override (drv: {"
236− , "releaseKey = (if builtins.isNull drv.releaseKey then {} else drv.releaseKey) // " <> releaseKey <> "; "
248+ , "isRelease = true;"
237 , "staticSrc = (passthru.__androidWithConfig ", configDir, ").frontend.staticSrc;"
249 , "staticSrc = (passthru.__androidWithConfig ", configDir, ").frontend.staticSrc;"
250+ , "assets = (passthru.__androidWithConfig ", configDir, ").frontend.assets;"
238 , "})"
251 , "})"
239 ]
252 ]
240− return $ Target
253+ return (Target
241 { _target_path = Nothing
254 { _target_path = Nothing
242 , _target_attr = Nothing
255 , _target_attr = Nothing
243 , _target_expr = Just expr
256 , _target_expr = Just expr
244− }
257+ }, keyArgs)
245 IOS -> do
258 IOS -> do
246 let expr = mconcat
259 let expr = mconcat
247− [ "with (import ", srcDir, " {});"
260+ [ "with (import ", toNixPath srcDir, " {});"
248− , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", configDir, ").frontend.staticSrc; })"
261+ , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", toNixPath configDir, ").frontend.staticSrc; })"
249 ]
262 ]
250− return $ Target
263+ return (Target
251 { _target_path = Nothing
264 { _target_path = Nothing
252 , _target_attr = Nothing
265 , _target_attr = Nothing
253 , _target_expr = Just expr
266 , _target_expr = Just expr
254− }
267+ }, [])
255 result <- nixCmd $ NixCmd_Build $ def
268 result <- nixCmd $ NixCmd_Build $ def
256 & nixBuildConfig_outLink .~ OutLink_None
269 & nixBuildConfig_outLink .~ OutLink_None
257 & nixCmdConfig_target .~ nixBuildTarget
270 & nixCmdConfig_target .~ nixBuildTarget
271+ let mobileArtifact = case platform of
272+ IOS -> "iOS App"
273+ Android -> "Android APK"
258− putLog Notice $ T.pack $ "Your recently built android apk can be found at the following path: " <> show result
274+ putLog Notice $ T.pack $ unwords ["Your recently built", mobileArtifact, "can be found at the following path:", show result]
259− callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") mobileArgs
275+ callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") (mobileArgs ++ extraArgs)
260 where
276 where
261− withEcho showEcho f = do
277+ withEcho showEcho f = bracket
278+ (do
262− prevEcho <- hGetEcho stdin
279+ prevEcho <- hGetEcho stdin
263− bracket_ (hSetEcho stdin showEcho) (hSetEcho stdin prevEcho) f
280+ hSetEcho stdin showEcho
281+ pure prevEcho
282+ )
283+ (hSetEcho stdin)
284+ (const f)
264
285
265data KeytoolConfig = KeytoolConfig
286data KeytoolConfig = KeytoolConfig
266 { _keytoolConfig_keystore :: FilePath
287 { _keytoolConfig_keystore :: FilePath
@@ -273,19 +294,16 @@ instance FromJSON KeytoolConfig
273instance ToJSON KeytoolConfig
294instance ToJSON KeytoolConfig
274
295
275createKeystore :: MonadObelisk m => FilePath -> KeytoolConfig -> m ()
296createKeystore :: MonadObelisk m => FilePath -> KeytoolConfig -> m ()
276−createKeystore root config = do
297+createKeystore root config =
277− let expr = "with (import " <> toImplDir root <> ").reflex-platform.nixpkgs; pkgs.mkShell { buildInputs = [ pkgs.jdk ]; }"
278− callProcessAndLogOutput (Notice,Notice) $ (proc "nix-shell" ["default.nix", "-E" , expr, "--run" , keytoolCmd]) { cwd = Just root }
298+ callProcessAndLogOutput (Notice, Notice) $ setCwd (Just root) $ proc jreKeyToolPath
279− where
280− keytoolCmd = processToShellString "keytool"
281− [ "-genkeypair", "-noprompt"
299+ [ "-genkeypair", "-noprompt"
282− , "-keystore", _keytoolConfig_keystore config
300+ , "-keystore", _keytoolConfig_keystore config
283− , "-keyalg", "RSA", "-keysize", "2048"
301+ , "-keyalg", "RSA", "-keysize", "2048"
284− , "-validity", "1000000"
302+ , "-validity", "1000000"
285− , "-storepass", _keytoolConfig_storepass config
303+ , "-storepass", _keytoolConfig_storepass config
286− , "-alias", _keytoolConfig_alias config
304+ , "-alias", _keytoolConfig_alias config
287− , "-keypass", _keytoolConfig_keypass config
305+ , "-keypass", _keytoolConfig_keypass config
288− ]
306+ ]
289
307
290-- | Simplified deployment configuration mechanism. At one point we may revisit this.
308-- | Simplified deployment configuration mechanism. At one point we may revisit this.
291writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
309writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
lib/command/src/Obelisk/Command/Nix.hs+67−27
@@ -9,22 +9,33 @@
9{-# LANGUAGE TemplateHaskell #-}
9{-# LANGUAGE TemplateHaskell #-}
10{-# LANGUAGE TypeApplications #-}
10{-# LANGUAGE TypeApplications #-}
11module Obelisk.Command.Nix
11module Obelisk.Command.Nix
12− ( nixCmd
12+ ( Arg (..)
13− , NixCmd (..)
14− , nixCmdConfig_target
15− , nixCmdConfig_args
16− , nixCmdConfig_builders
17 , NixBuildConfig (..)
13 , NixBuildConfig (..)
18 , nixBuildConfig_common
14 , nixBuildConfig_common
19 , nixBuildConfig_outLink
15 , nixBuildConfig_outLink
16+ , NixCmd (..)
17+ , nixCmdConfig_args
18+ , nixCmdConfig_builders
19+ , nixCmdConfig_target
20+ , NixCommonConfig (..)
20 , NixInstantiateConfig (..)
21 , NixInstantiateConfig (..)
21 , nixInstantiateConfig_eval
22 , nixInstantiateConfig_eval
22− , NixCommonConfig (..)
23+ , NixShellConfig (..)
23− , Target (..)
24+ , nixShellConfig_common
25+ , nixShellConfig_pure
26+ , nixShellConfig_run
24 , OutLink (..)
27 , OutLink (..)
25− , Arg (..)
28+ , Target (..)
29+ , target_attr
30+ , target_expr
31+ , target_path
32+
26 , boolArg
33 , boolArg
34+ , nixCmd
35+ , nixCmdProc
36+ , nixCmdProc'
27 , rawArg
37 , rawArg
38+ , runNixShellConfig
28 , strArg
39 , strArg
29 ) where
40 ) where
30
41
@@ -37,7 +48,6 @@ import Data.List (intercalate)
37import Data.Maybe
48import Data.Maybe
38import Data.Monoid ((<>))
49import Data.Monoid ((<>))
39import qualified Data.Text as T
50import qualified Data.Text as T
40−import System.Process (proc)
41
51
42import Obelisk.App (MonadObelisk)
52import Obelisk.App (MonadObelisk)
43import Obelisk.CliApp
53import Obelisk.CliApp
@@ -63,10 +73,10 @@ data Arg
63 deriving (Eq, Show)
73 deriving (Eq, Show)
64
74
65strArg :: String -> String -> Arg
75strArg :: String -> String -> Arg
66−strArg k = Arg_Str k
76+strArg = Arg_Str
67
77
68rawArg :: String -> String -> Arg
78rawArg :: String -> String -> Arg
69−rawArg k = Arg_Expr k
79+rawArg = Arg_Expr
70
80
71boolArg :: String -> Bool -> Arg
81boolArg :: String -> Bool -> Arg
72boolArg k = Arg_Expr k . bool "false" "true"
82boolArg k = Arg_Expr k . bool "false" "true"
@@ -86,7 +96,7 @@ makeClassy ''NixCommonConfig
86instance Default NixCommonConfig where
96instance Default NixCommonConfig where
87 def = NixCommonConfig def mempty mempty
97 def = NixCommonConfig def mempty mempty
88
98
89−runNixCommonConfig :: NixCommonConfig -> [FilePath]
99+runNixCommonConfig :: NixCommonConfig -> [String]
90runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
100runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
91 where
101 where
92 path = _target_path $ _nixCmdConfig_target cfg
102 path = _target_path $ _nixCmdConfig_target cfg
@@ -124,7 +134,7 @@ instance HasNixCommonConfig NixBuildConfig where
124instance Default NixBuildConfig where
134instance Default NixBuildConfig where
125 def = NixBuildConfig def def
135 def = NixBuildConfig def def
126
136
127−runNixBuildConfig :: NixBuildConfig -> [FilePath]
137+runNixBuildConfig :: NixBuildConfig -> [String]
128runNixBuildConfig cfg = mconcat
138runNixBuildConfig cfg = mconcat
129 [ runNixCommonConfig $ cfg ^. nixCommonConfig
139 [ runNixCommonConfig $ cfg ^. nixCommonConfig
130 , case _nixBuildConfig_outLink cfg of
140 , case _nixBuildConfig_outLink cfg of
@@ -145,12 +155,26 @@ instance HasNixCommonConfig NixInstantiateConfig where
145instance Default NixInstantiateConfig where
155instance Default NixInstantiateConfig where
146 def = NixInstantiateConfig def False
156 def = NixInstantiateConfig def False
147
157
148−runNixInstantiateConfig :: NixInstantiateConfig -> [FilePath]
158+runNixInstantiateConfig :: NixInstantiateConfig -> [String]
149runNixInstantiateConfig cfg = mconcat
159runNixInstantiateConfig cfg = mconcat
150 [ runNixCommonConfig $ cfg ^. nixCommonConfig
160 [ runNixCommonConfig $ cfg ^. nixCommonConfig
151 , "--eval" <$ guard (_nixInstantiateConfig_eval cfg)
161 , "--eval" <$ guard (_nixInstantiateConfig_eval cfg)
152 ]
162 ]
153
163
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+
154data NixCmd
178data NixCmd
155 = NixCmd_Build NixBuildConfig
179 = NixCmd_Build NixBuildConfig
156 | NixCmd_Instantiate NixInstantiateConfig
180 | NixCmd_Instantiate NixInstantiateConfig
@@ -158,27 +182,43 @@ data NixCmd
158instance Default NixCmd where
182instance Default NixCmd where
159 def = NixCmd_Build def
183 def = NixCmd_Build def
160
184
161−nixCmd :: MonadObelisk m => NixCmd -> m FilePath
185+runNixShellConfig :: NixShellConfig -> [String]
162−nixCmd cmdCfg = withSpinner' ("Running " <> cmd <> desc) (Just $ const $ "Built " <> desc) $ do
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)
163− output <- readProcessAndLogStderr Debug $ proc (T.unpack cmd) $ options
197+nixCmdProc' cmdCfg = (proc (T.unpack cmd) options, cmd)
164− -- Remove final newline that Nix appends
165− Just (outPath, '\n') <- pure $ T.unsnoc output
166− pure $ T.unpack outPath
167 where
198 where
168− (cmd, options, commonCfg) = case cmdCfg of
199+ (cmd, options) = case cmdCfg of
169 NixCmd_Build cfg' ->
200 NixCmd_Build cfg' ->
170 ( "nix-build"
201 ( "nix-build"
171 , runNixBuildConfig cfg'
202 , runNixBuildConfig cfg'
172− , cfg' ^. nixCommonConfig
173 )
203 )
174 NixCmd_Instantiate cfg' ->
204 NixCmd_Instantiate cfg' ->
175 ( "nix-instantiate"
205 ( "nix-instantiate"
176 , runNixInstantiateConfig cfg'
206 , runNixInstantiateConfig cfg'
177− , cfg' ^. nixCommonConfig
178 )
207 )
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
179 path = commonCfg ^. nixCmdConfig_target . target_path
220 path = commonCfg ^. nixCmdConfig_target . target_path
180− desc = T.pack $ mconcat $ catMaybes
221+ desc = concat $ catMaybes
181− [ (" on " <>) <$> path
222+ [ (\x -> ["on", T.pack x]) <$> path
182− , (\a -> " [" <> a <> "]") <$> (commonCfg ^. nixCmdConfig_target . target_attr)
223+ , (\a -> ["[" <> T.pack a <> "]"]) <$> (commonCfg ^. nixCmdConfig_target . target_attr)
183 ]
224 ]
184−
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+121−47
@@ -1,28 +1,37 @@
1{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE OverloadedStrings #-}
4−{-# LANGUAGE TemplateHaskell #-}
5module Obelisk.Command.Project
4module Obelisk.Command.Project
6 ( InitSource (..)
5 ( InitSource (..)
7− , initProject
8 , findProjectObeliskCommand
6 , findProjectObeliskCommand
9 , findProjectRoot
7 , findProjectRoot
10− , withProjectRoot
8+ , findProjectAssets
11− , inProjectShell
9+ , initProject
12− , inImpureProjectShell
10+ , nixShellRunConfig
13− , projectShell
11+ , nixShellRunProc
14−
12+ , nixShellWithHoogle
15− , toObeliskDir
13+ , nixShellWithoutPkgs
14+ , obeliskDirName
16 , toImplDir
15 , toImplDir
16+ , toObeliskDir
17+ , withProjectRoot
17 ) where
18 ) where
18
19
19import Control.Concurrent.MVar (MVar, newMVar, withMVarMasked)
20import Control.Concurrent.MVar (MVar, newMVar, withMVarMasked)
21+import Control.Lens ((.~), (?~), (<&>))
20import Control.Monad
22import Control.Monad
21import Control.Monad.IO.Class (liftIO)
23import Control.Monad.IO.Class (liftIO)
22import Control.Monad.State
24import Control.Monad.State
25+import qualified Data.Aeson as Json
23import Data.Bits
26import Data.Bits
27+import qualified Data.ByteString.Lazy as BSL
28+import Data.Default (def)
24−import Data.Function (on)
29+import Data.Function ((&), on)
30+import Data.Map (Map)
31+import Data.Text (Text)
25import qualified Data.Text as T
32import qualified Data.Text as T
33+import Data.Text.Encoding (decodeUtf8)
34+import Data.Traversable (for)
26import System.Directory
35import System.Directory
27import System.Environment (lookupEnv)
36import System.Environment (lookupEnv)
28import System.FilePath
37import System.FilePath
@@ -30,15 +39,15 @@ import System.IO.Temp
30import System.IO.Unsafe (unsafePerformIO)
39import System.IO.Unsafe (unsafePerformIO)
31import System.Posix (FileStatus, FileMode, CMode (..), UserID, deviceID, fileID, fileMode, fileOwner, getFileStatus, getRealUserID)
40import System.Posix (FileStatus, FileMode, CMode (..), UserID, deviceID, fileID, fileMode, fileOwner, getFileStatus, getRealUserID)
32import System.Posix.Files
41import System.Posix.Files
33−import System.Process (CreateProcess, cwd, proc, waitForProcess, delegate_ctlc)
34−import System.Which (staticWhich)
35
42
36import GitHub.Data.GitData (Branch)
43import GitHub.Data.GitData (Branch)
37import GitHub.Data.Name (Name)
44import GitHub.Data.Name (Name)
38
45
39import Obelisk.App (MonadObelisk)
46import Obelisk.App (MonadObelisk)
40import Obelisk.CliApp
47import Obelisk.CliApp
48+import Obelisk.Command.Nix
41import Obelisk.Command.Thunk
49import Obelisk.Command.Thunk
50+import Obelisk.Command.Utils (nixBuildExePath, nixExePath, toNixPath)
42
51
43--TODO: Make this module resilient to random exceptions
52--TODO: Make this module resilient to random exceptions
44
53
@@ -53,6 +62,7 @@ obeliskSourceWithBranch branch = ThunkSource_GitHub $ GitHubSource
53 { _gitHubSource_owner = "obsidiansystems"
62 { _gitHubSource_owner = "obsidiansystems"
54 , _gitHubSource_repo = "obelisk"
63 , _gitHubSource_repo = "obelisk"
55 , _gitHubSource_branch = Just branch
64 , _gitHubSource_branch = Just branch
65+ , _gitHubSource_private = False
56 }
66 }
57
67
58data InitSource
68data InitSource
@@ -61,9 +71,12 @@ data InitSource
61 | InitSource_Symlink FilePath
71 | InitSource_Symlink FilePath
62 deriving Show
72 deriving Show
63
73
74+obeliskDirName :: FilePath
75+obeliskDirName = ".obelisk"
76+
64-- | Path to obelisk directory in given path
77-- | Path to obelisk directory in given path
65toObeliskDir :: FilePath -> FilePath
78toObeliskDir :: FilePath -> FilePath
66−toObeliskDir p = p </> ".obelisk"
79+toObeliskDir p = p </> obeliskDirName
67
80
68-- | Path to impl file in given path
81-- | Path to impl file in given path
69toImplDir :: FilePath -> FilePath
82toImplDir :: FilePath -> FilePath
@@ -80,16 +93,22 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
80 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
93 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
81 skeleton <- withSpinner "Setting up obelisk" $ do
94 skeleton <- withSpinner "Setting up obelisk" $ do
82 liftIO $ createDirectory obDir
95 liftIO $ createDirectory obDir
96+ -- Clone the git source and repack it with the init source obelisk
97+ -- The purpose of this is to ensure we use the correct thunk spec.
98+ let cloneAndRepack src = do
99+ putLog Debug $ "Cloning obelisk into " <> T.pack implDir <> " and repacking using itself"
100+ commit <- getLatestRev src
101+ gitCloneForThunkUnpack (thunkSourceToGitSource src) (_thunkRev_commit commit) implDir
102+ callHandoffOb implDir ["thunk", "pack", implDir]
83 case source of
103 case source of
84− InitSource_Default -> createThunkWithLatest implDir obeliskSource
104+ InitSource_Default -> cloneAndRepack obeliskSource
85− InitSource_Branch branch -> createThunkWithLatest implDir $ obeliskSourceWithBranch branch
105+ InitSource_Branch branch -> cloneAndRepack $ obeliskSourceWithBranch branch
86 InitSource_Symlink path -> do
106 InitSource_Symlink path -> do
87 let symlinkPath = if isAbsolute path
107 let symlinkPath = if isAbsolute path
88 then path
108 then path
89 else ".." </> path
109 else ".." </> path
90 liftIO $ createSymbolicLink symlinkPath implDir
110 liftIO $ createSymbolicLink symlinkPath implDir
91 _ <- nixBuildAttrWithCache implDir "command"
111 _ <- nixBuildAttrWithCache implDir "command"
92− --TODO: We should probably handoff to the impl here
93 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
112 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
94
113
95 callProcessAndLogOutput (Notice, Error) $
114 callProcessAndLogOutput (Notice, Error) $
@@ -115,6 +134,24 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
115 createDirectoryIfMissing False configDir
134 createDirectoryIfMissing False configDir
116 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
135 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
117
136
137+callHandoffOb
138+ :: MonadObelisk m
139+ => FilePath -- ^ Directory of the obelisk we want to handoff to
140+ -> [String] -- ^ Arguments to pass to ob
141+ -> m ()
142+callHandoffOb dir args = do
143+ obeliskCommandPkg <- nixCmd $ NixCmd_Build $ def
144+ & nixBuildConfig_outLink .~ OutLink_None
145+ & nixCmdConfig_target .~ Target
146+ { _target_path = Just dir
147+ , _target_attr = Just "command"
148+ , _target_expr = Nothing
149+ }
150+ let impl = obeliskCommandPkg </> "bin" </> "ob"
151+ -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
152+ putLog Debug $ "Running '" <> T.pack (unwords args) <> "' with " <> T.pack impl
153+ callProcessAndLogOutput (Debug, Warning) (proc impl ("--no-handoff" : args))
154+
118--TODO: Allow the user to ignore our security concerns
155--TODO: Allow the user to ignore our security concerns
119-- | Find the Obelisk implementation for the project at the given path
156-- | Find the Obelisk implementation for the project at the given path
120findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
157findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
@@ -168,9 +205,9 @@ findProjectRoot :: MonadObelisk m => FilePath -> m (Maybe FilePath)
168findProjectRoot target = do
205findProjectRoot target = do
169 myUid <- liftIO getRealUserID
206 myUid <- liftIO getRealUserID
170 targetStat <- liftIO $ getFileStatus target
207 targetStat <- liftIO $ getFileStatus target
171− umask <- liftIO $ getUmask
208+ umask <- liftIO getUmask
172 (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat umask myUid) []
209 (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat umask myUid) []
173− return result
210+ return $ makeRelative "." <$> result
174
211
175withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
212withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
176withProjectRoot target f = findProjectRoot target >>= \case
213withProjectRoot target f = findProjectRoot target >>= \case
@@ -233,38 +270,75 @@ filePermissionIsSafe s umask = not fileWorldWritable && fileGroupWritable <= uma
233 fileGroupWritable = fileMode s .&. 0o020 == 0o020
270 fileGroupWritable = fileMode s .&. 0o020 == 0o020
234 umaskGroupWritable = umask .&. 0o020 == 0
271 umaskGroupWritable = umask .&. 0o020 == 0
235
272
236−-- | Run a command in the given shell for the current project
273+nixShellRunConfig :: MonadObelisk m => FilePath -> Bool -> Maybe String -> m NixShellConfig
237−inProjectShell :: MonadObelisk m => String -> String -> m ()
274+nixShellRunConfig root isPure command = do
238−inProjectShell shellName command = withProjectRoot "." $ \root ->
275+ nixpkgsPath <- fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $
239− projectShell root True shellName (Just command)
276+ proc nixExePath ["eval", "(import .obelisk/impl {}).nixpkgs.path"]
277+ nixRemote <- liftIO $ lookupEnv "NIX_REMOTE"
278+ pure $ def
279+ & nixShellConfig_pure .~ isPure
280+ & nixShellConfig_common . nixCmdConfig_target .~ (def & target_path .~ Nothing)
281+ & nixShellConfig_run .~ (command <&> \c -> mconcat
282+ [ "export NIX_PATH=nixpkgs=", T.unpack nixpkgsPath, "; "
283+ , maybe "" (\v -> "export NIX_REMOTE=" <> v <> "; ") nixRemote
284+ , c
285+ ])
240
286
241−inImpureProjectShell :: MonadObelisk m => String -> String -> m ()
287+nixShellRunProc :: NixShellConfig -> ProcessSpec
242−inImpureProjectShell shellName command = withProjectRoot "." $ \root ->
288+nixShellRunProc cfg = setDelegateCtlc True $ proc "nix-shell" $ runNixShellConfig cfg
243− projectShell root False shellName (Just command)
244
289
245−projectShell :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
290+nixShellWithoutPkgs
246−projectShell root isPure shellName command = do
291+ :: MonadObelisk m
247− let nixPath = $(staticWhich "nix")
292+ => FilePath -- ^ Path to project root
248− nixpkgsPath <- fmap T.strip $ readProcessAndLogStderr Debug $ proc nixPath ["eval", "(import .obelisk/impl {}).nixpkgs.path"]
293+ -> Bool -- ^ Should this be a pure shell?
249− nixRemote <- liftIO $ lookupEnv "NIX_REMOTE"
294+ -> Bool -- ^ Should we chdir to the package root in the shell?
250− (_, _, _, ph) <- createProcess_ "runNixShellAttr" $ setCtlc $ setCwd (Just root) $ proc "nix-shell" $
295+ -> Map Text FilePath -- ^ Package names mapped to their paths
251− [ "default.nix"] <>
296+ -> String -- ^ Shell attribute to use (e.g. @"ghc"@, @"ghcjs"@, etc.)
252− ["--pure" | isPure] <>
297+ -> Maybe String -- ^ If 'Just' run the given command; otherwise just open the interactive shell
253− [ "-A"
298+ -> m ()
254− , "shells." <> shellName
299+nixShellWithoutPkgs root isPure chdirToRoot packageNamesAndPaths shellAttr command = do
255− ] <> case command of
300+ packageNamesAndAbsPaths <- liftIO $ for packageNamesAndPaths makeAbsolute
256− Nothing -> []
301+ defShellConfig <- nixShellRunConfig root isPure command
257− Just c ->
302+ let setCwd_ = if chdirToRoot then setCwd (Just root) else id
258− -- TODO: Escape nixpkgsPath and nixRemote
303+ (_, _, _, ph) <- createProcess_ "nixShellWithoutPkgs" $ setCwd_ $ nixShellRunProc $ defShellConfig
259− [ "--run"
304+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
260− , "export NIX_PATH=nixpkgs=" <> T.unpack nixpkgsPath <> "; " <>
305+ "{root, pkgs, shell}: ((import root {}).passthru.__unstable__.self.extend (_: _: {\
261− maybe "" (\v -> "export NIX_REMOTE=" <> v <> "; ") nixRemote <>
306+ \shellPackages = builtins.fromJSON pkgs;\
262− c
307+ \})).project.shells.${shell}"
308+ & nixShellConfig_common . nixCmdConfig_args .~
309+ [ rawArg "root" $ toNixPath $ if chdirToRoot then "." else root
310+ , strArg "pkgs" (T.unpack $ decodeUtf8 $ BSL.toStrict $ Json.encode packageNamesAndAbsPaths)
311+ , strArg "shell" shellAttr
263 ]
312 ]
264− void $ liftIO $ waitForProcess ph
313+ void $ waitForProcess ph
265
314
266−setCtlc :: CreateProcess -> CreateProcess
315+nixShellWithHoogle :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
267−setCtlc cfg = cfg { delegate_ctlc = True }
316+nixShellWithHoogle root isPure shell' command = do
317+ defShellConfig <- nixShellRunConfig root isPure command
318+ (_, _, _, ph) <- createProcess_ "nixShellWithHoogle" $ setCwd (Just root) $ nixShellRunProc $ defShellConfig
319+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
320+ "{shell}: ((import ./. {}).passthru.__unstable__.self.extend (_: super: {\
321+ \userSettings = super.userSettings // { withHoogle = true; };\
322+ \})).project.shells.${shell}"
323+ & nixShellConfig_common . nixCmdConfig_args .~ [ strArg "shell" shell' ]
324+ void $ waitForProcess ph
268
325
269−setCwd :: Maybe FilePath -> CreateProcess -> CreateProcess
326+findProjectAssets :: MonadObelisk m => FilePath -> m Text
270−setCwd fp cfg = cfg { cwd = fp }
327+findProjectAssets root = do
328+ isDerivation <- readProcessAndLogStderr Debug $ setCwd (Just root) $
329+ proc nixExePath
330+ [ "eval"
331+ , "(let a = import ./. {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
332+ , "--raw"
333+ -- `--raw` is not available with old nix-instantiate. It drops quotation
334+ -- marks and trailing newline, so is very convenient for shelling out.
335+ ]
336+ -- Check whether the impure static files are a derivation (and so must be built)
337+ if isDerivation == "1"
338+ then fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $ -- Strip whitespace here because nix-build has no --raw option
339+ proc nixBuildExePath
340+ [ "--no-out-link"
341+ , "-E", "(import ./. {}).passthru.staticFilesImpure"
342+ ]
343+ else readProcessAndLogStderr Debug $ setCwd (Just root) $
344+ proc nixExePath ["eval", "-f", ".", "passthru.staticFilesImpure", "--raw"]
lib/command/src/Obelisk/Command/Run.hs+458−172
@@ -1,50 +1,90 @@
1+{-# LANGUAGE DeriveFoldable #-}
2+{-# LANGUAGE DeriveFunctor #-}
3+{-# LANGUAGE DeriveTraversable #-}
1{-# LANGUAGE FlexibleContexts #-}
4{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE LambdaCase #-}
5{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
4{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE QuasiQuotes #-}
5{-# LANGUAGE ScopedTypeVariables #-}
9{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE TemplateHaskell #-}
10+{-# LANGUAGE TupleSections #-}
11+{-# LANGUAGE ViewPatterns #-}
7module Obelisk.Command.Run where
12module Obelisk.Command.Run where
8
13
9−import Control.Exception (bracket)
14+import Control.Arrow ((&&&))
15+import Control.Exception (Exception, bracket)
10−import Control.Monad
16+import Control.Lens (ifor, (.~), (&))
17+import Control.Monad (filterM, unless, void)
18+import Control.Monad.Except (runExceptT, throwError)
11import Control.Monad.IO.Class (liftIO)
19import Control.Monad.IO.Class (liftIO)
12import Control.Monad.Reader (MonadIO)
20import Control.Monad.Reader (MonadIO)
13−import Data.Either
21+import Data.Bifoldable (bifoldr1)
14−import qualified Data.List as L
22+import Data.Bifunctor (bimap)
23+import Data.Coerce (coerce)
24+import Data.Default (def)
25+import Data.Either (partitionEithers)
26+import Data.Foldable (fold, for_, toList)
27+import Data.Functor.Identity (runIdentity)
28+import Data.List.NonEmpty (NonEmpty)
15import qualified Data.List.NonEmpty as NE
29import qualified Data.List.NonEmpty as NE
30+import Data.Map (Map)
31+import qualified Data.Map as Map
32+import qualified Data.Map.Monoidal as MMap
16import Data.Maybe
33import Data.Maybe
34+import Data.Set (Set)
35+import qualified Data.Set as Set
36+import Data.String.Here.Interpolated (i)
37+import Data.Text (Text)
17import qualified Data.Text as T
38import qualified Data.Text as T
39+import Data.Time.Clock (getCurrentTime)
40+import Data.Time.Format (formatTime, defaultTimeLocale)
41+import Data.Traversable (for)
42+import Debug.Trace (trace)
18import Distribution.Compiler (CompilerFlavor(..))
43import Distribution.Compiler (CompilerFlavor(..))
19import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
44import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
20import Distribution.Parsec.ParseResult (runParseResult)
45import Distribution.Parsec.ParseResult (runParseResult)
21−import Distribution.Pretty
46+import qualified Distribution.System as Dist
22import Distribution.Types.BuildInfo
47import Distribution.Types.BuildInfo
23import Distribution.Types.CondTree
48import Distribution.Types.CondTree
24import Distribution.Types.GenericPackageDescription
49import Distribution.Types.GenericPackageDescription
25import Distribution.Types.Library
50import Distribution.Types.Library
26import Distribution.Utils.Generic
51import Distribution.Utils.Generic
52+import qualified Distribution.Parsec.Common as Dist
27−import Hpack.Config
53+import qualified Hpack.Config as Hpack
28−import Hpack.Render
54+import qualified Hpack.Render as Hpack
29−import Hpack.Yaml
55+import qualified Hpack.Yaml as Hpack
30import Language.Haskell.Extension
56import Language.Haskell.Extension
31import Network.Socket hiding (Debug)
57import Network.Socket hiding (Debug)
32import System.Directory
58import System.Directory
59+import System.Environment (getExecutablePath)
33import System.FilePath
60import System.FilePath
34−import System.Process (proc)
61+import qualified System.Info
35import System.IO.Temp (withSystemTempDirectory)
62import System.IO.Temp (withSystemTempDirectory)
36−import System.Which (staticWhich)
37−import Data.ByteString (ByteString)
38
63
39−import Obelisk.App (MonadObelisk, ObeliskT)
64+import Obelisk.App (MonadObelisk)
40−import Obelisk.CliApp
65+import Obelisk.CliApp (
41− ( CliT (..), HasCliConfig, Severity (..)
66+ Severity (..),
42− , callCommand, failWith, getCliConfig, putLog
67+ createProcess_,
68+ failWith,
69+ proc,
70+ putLog,
71+ readCreateProcessWithExitCode,
43− , readProcessAndLogStderr, runCli)
72+ readProcessAndLogStderr,
73+ setCwd,
74+ setDelegateCtlc,
75+ waitForProcess,
76+ withSpinner,
77+ )
78+import Obelisk.Command.Nix
44−import Obelisk.Command.Project (inProjectShell, withProjectRoot)
79+import Obelisk.Command.Project (nixShellWithoutPkgs, withProjectRoot, findProjectAssets)
80+import Obelisk.Command.Thunk (attrCacheFileName)
81+import Obelisk.Command.Utils (findExePath, ghcidExePath)
45
82
46data CabalPackageInfo = CabalPackageInfo
83data CabalPackageInfo = CabalPackageInfo
84+ { _cabalPackageInfo_packageFile :: FilePath
85+ , _cabalPackageInfo_packageName :: T.Text
47− { _cabalPackageInfo_packageRoot :: FilePath
86+ , _cabalPackageInfo_packageRoot :: FilePath
87+ , _cabalPackageInfo_buildable :: Bool
48 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
88 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
49 -- ^ List of hs src dirs of the library component
89 -- ^ List of hs src dirs of the library component
50 , _cabalPackageInfo_defaultExtensions :: [Extension]
90 , _cabalPackageInfo_defaultExtensions :: [Extension]
@@ -55,196 +95,408 @@ data CabalPackageInfo = CabalPackageInfo
55 -- ^ List of compiler-specific options (e.g., the "ghc-options" field of the cabal file)
95 -- ^ List of compiler-specific options (e.g., the "ghc-options" field of the cabal file)
56 }
96 }
57
97
58−-- NOTE: `run` is not polymorphic like the rest because we use StaticPtr to invoke it.
98+-- | 'Bool' with a better name for it's purpose.
59−run :: ObeliskT IO ()
99+data Interpret = Interpret_Interpret | Interpret_NoInterpret deriving (Eq, Ord, Show)
60−run = do
100+
61− let nixPath = $(staticWhich "nix")
101+textInterpret :: Interpret -> Text
62− nixBuildPath = $(staticWhich "nix-build")
102+textInterpret = \case
63− pkgs <- getLocalPkgs
103+ Interpret_Interpret -> "Interpret"
104+ Interpret_NoInterpret -> "NoInterpret"
105+
106+-- | Describe a set of 'FilePath's as a tree to facilitate merging them in a convenient way.
107+data PathTree a = PathTree_Node
108+ (Maybe a) -- An optional leaf at this point in the tree
109+ (Map FilePath (PathTree a)) -- Branches to deeper leaves
110+ deriving (Eq, Ord, Show, Functor, Foldable, Traversable)
111+
112+emptyPathTree :: PathTree a
113+emptyPathTree = PathTree_Node Nothing mempty
114+
115+-- | 2D ASCII drawing of a 'PathTree'. Adapted from Data.Tree.draw.
116+drawPathTree :: (a -> Text) -> PathTree a -> Text
117+drawPathTree showA (PathTree_Node _ ts0) = T.intercalate "\n" $ goForest (Map.toList ts0)
118+ where
119+ annotated ma = maybe id (\a b -> b <> " [" <> showA a <> "]") ma . T.pack
120+ goTree (fp, PathTree_Node ma forest) = annotated ma fp : goForest (Map.toList forest)
121+ goForest [] = []
122+ goForest [tree] = shift "└─ " " " (goTree tree)
123+ goForest (tree:forest) = shift "├─ " "│ " (goTree tree) <> goForest forest
124+ shift first other = zipWith (<>) (first : repeat other)
125+
126+-- | Used to signal to obelisk that it's being invoked as a preprocessor
127+preprocessorIdentifier :: String
128+preprocessorIdentifier = "__preprocessor-apply-packages"
129+
130+profile
131+ :: MonadObelisk m
132+ => String
133+ -> [String]
134+ -> m ()
135+profile profileBasePattern rtsFlags = withProjectRoot "." $ \root -> do
136+ putLog Debug "Using profiled build of project."
137+
138+ outPath <- withSpinner "Building profiled executable" $
139+ fmap (T.unpack . T.strip) $ readProcessAndLogStderr Debug $ setCwd (Just root) $ nixCmdProc $
140+ NixCmd_Build $ def
141+ & nixBuildConfig_outLink .~ OutLink_None
142+ & nixCmdConfig_target .~ Target
143+ { _target_path = Just "."
144+ , _target_attr = Just "__unstable__.profiledObRun"
145+ , _target_expr = Nothing
146+ }
147+ assets <- findProjectAssets root
148+ putLog Debug $ "Assets impurely loaded from: " <> assets
149+ time <- liftIO getCurrentTime
150+ let profileBaseName = formatTime defaultTimeLocale profileBasePattern time
151+ liftIO $ createDirectoryIfMissing True $ takeDirectory $ root </> profileBaseName
152+ putLog Debug $ "Storing profiled data under base name of " <> T.pack (root </> profileBaseName)
153+ freePort <- getFreePort
154+ (_, _, _, ph) <- createProcess_ "runProfExe" $ setCwd (Just root) $ setDelegateCtlc True $ proc (outPath </> "bin" </> "ob-run") $
155+ [ show freePort
156+ , T.unpack assets
157+ , profileBaseName
158+ , "+RTS"
159+ , "-po" <> profileBaseName
160+ ] <> rtsFlags
161+ <> [ "-RTS" ]
162+ void $ waitForProcess ph
163+
164+run :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
165+run root interpretPaths = do
166+ pkgs <- getParsedLocalPkgs root interpretPaths
64 withGhciScript pkgs $ \dotGhciPath -> do
167 withGhciScript pkgs $ \dotGhciPath -> do
65− freePort <- getFreePort
168+ assets <- findProjectAssets root
66− assets <- withProjectRoot "." $ \root -> do
67− let importableRoot = if "/" `isInfixOf` root
68− then root
69− else "./" <> root
70− isDerivation <- readProcessAndLogStderr Debug $
71− proc nixPath
72− [ "eval"
73− , "-f"
74− , root
75− , "(let a = import " <> importableRoot <> " {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
76− , "--raw"
77− -- `--raw` is not available with old nix-instantiate. It drops quotation
78− -- marks and trailing newline, so is very convenient for shelling out.
79− ]
80− -- Check whether the impure static files are a derivation (and so must be built)
81− if isDerivation == "1"
82− then fmap T.strip $ readProcessAndLogStderr Debug $ -- Strip whitespace here because nix-build has no --raw option
83− proc nixBuildPath
84− [ "--no-out-link"
85− , "-E", "(import " <> importableRoot <> "{}).passthru.staticFilesImpure"
86− ]
87− else readProcessAndLogStderr Debug $
88− proc nixPath ["eval", "-f", root, "passthru.staticFilesImpure", "--raw"]
89 putLog Debug $ "Assets impurely loaded from: " <> assets
169 putLog Debug $ "Assets impurely loaded from: " <> assets
170+ ghciArgs <- getGhciSessionSettings pkgs root True
171+ freePort <- getFreePort
90− runGhcid dotGhciPath $ Just $ unwords
172+ runGhcid root True (ghciArgs <> mkGhciScriptArg dotGhciPath) pkgs $ Just $ unwords
91 [ "Obelisk.Run.run"
173 [ "Obelisk.Run.run"
92 , show freePort
174 , show freePort
93− , "(runServeAsset " ++ show assets ++ ")"
175+ , "(Obelisk.Run.runServeAsset " ++ show assets ++ ")"
94 , "Backend.backend"
176 , "Backend.backend"
95 , "Frontend.frontend"
177 , "Frontend.frontend"
96 ]
178 ]
97
179
98−runRepl :: MonadObelisk m => m ()
180+runRepl :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
99−runRepl = do
181+runRepl root interpretPaths = do
100− pkgs <- getLocalPkgs
182+ pkgs <- getParsedLocalPkgs root interpretPaths
183+ ghciArgs <- getGhciSessionSettings pkgs "." True
101− withGhciScript pkgs $ \dotGhciPath -> do
184+ withGhciScript pkgs $ \dotGhciPath ->
102− runGhciRepl dotGhciPath
185+ runGhciRepl root pkgs (ghciArgs <> mkGhciScriptArg dotGhciPath)
186+
187+runWatch :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
188+runWatch root interpretPaths = do
189+ pkgs <- getParsedLocalPkgs root interpretPaths
190+ ghciArgs <- getGhciSessionSettings pkgs root True
191+ withGhciScript pkgs $ \dotGhciPath ->
192+ runGhcid root True (ghciArgs <> mkGhciScriptArg dotGhciPath) pkgs Nothing
193+
194+exportGhciConfig :: MonadObelisk m => Bool -> FilePath -> PathTree Interpret -> m [String]
195+exportGhciConfig useRelativePaths root interpretPaths = do
196+ pkgs <- getParsedLocalPkgs root interpretPaths
197+ getGhciSessionSettings pkgs "." useRelativePaths
198+
199+nixShellForInterpretPaths :: MonadObelisk m => Bool -> String -> FilePath -> PathTree Interpret -> Maybe String -> m ()
200+nixShellForInterpretPaths isPure shell root interpretPaths cmd = do
201+ pkgs <- getParsedLocalPkgs root interpretPaths
202+ nixShellWithoutPkgs root isPure False (packageInfoToNamePathMap pkgs) shell cmd
203+
204+-- | Like 'getLocalPkgs' but also parses them and fails if any of them can't be parsed.
205+getParsedLocalPkgs :: MonadObelisk m => FilePath -> PathTree Interpret -> m (NonEmpty CabalPackageInfo)
206+getParsedLocalPkgs root interpretPaths = parsePackagesOrFail =<< getLocalPkgs root interpretPaths
207+
208+-- | Relative paths to local packages of an obelisk project.
209+--
210+-- These are a combination of the obelisk predefined local packages,
211+-- and any packages that the user has set with the @packages@ argument
212+-- to the Nix @project@ function.
213+getLocalPkgs :: forall m. MonadObelisk m => FilePath -> PathTree Interpret -> m (Set FilePath)
214+getLocalPkgs root interpretPaths = do
215+ putLog Debug $ [i|Finding packages with root ${root} and interpret paths:|] <> "\n" <> drawPathTree textInterpret interpretPaths
216+ obeliskPackagePaths <- runFind ["-L", root, "-name", ".obelisk", "-type", "d"]
217+
218+ -- We do not want to find packages that are embedded inside other obelisk projects, unless that
219+ -- obelisk project is our own.
220+ obeliskPackageExclusions <- liftIO $ fmap Set.fromList $ traverse canonicalizePath $
221+ filter (/= root) $ map takeDirectory obeliskPackagePaths
222+ putLog Debug [i|Excluding obelisk packages: ${T.pack $ unwords $ Set.toList obeliskPackageExclusions}|]
223+ let rootsAndExclusions = calcIntepretFinds "" interpretPaths
224+
225+ fmap fold $ for (MMap.toAscList rootsAndExclusions) $ \(interpretPathRoot, exclusions) ->
226+ let allExclusions = obeliskPackageExclusions <> exclusions <> Set.singleton ("*" </> attrCacheFileName)
227+ in fmap (Set.fromList . map normalise) $ runFind $
228+ ["-L", interpretPathRoot, "(", "-name", "*.cabal", "-o", "-name", Hpack.packageConfig, ")", "-a", "-type", "f"]
229+ <> concat [["-not", "-path", p </> "*"] | p <- toList allExclusions]
230+ where
231+ runFind args = do
232+ (_exitCode, out, err) <- readCreateProcessWithExitCode $ proc findExePath args
233+ putLog Debug $ T.strip $ T.pack err
234+ pure $ map T.unpack $ T.lines $ T.strip $ T.pack out
235+
236+-- | Calculates a set of root 'FilePath's along with each one's corresponding set of exclusions.
237+-- This is used when constructing a set of @find@ commands to run to produce a set of packages
238+-- that matches the user's @--interpret@/@--no-interpret@ settings.
239+calcIntepretFinds :: FilePath -> PathTree Interpret -> MMap.MonoidalMap FilePath (Set FilePath)
240+calcIntepretFinds treeRoot0 tree0 = runIdentity $ go treeRoot0 tree0
241+ where
242+ go treeRoot tree = foldPathTreeFor (== Interpret_Interpret) treeRoot tree $ \parent children -> do
243+ exclusions <- foldPathTreeFor (== Interpret_NoInterpret) parent children $ \parent' children' ->
244+ pure $ Map.singleton parent' children'
245+ deeperFinds <- Map.traverseWithKey go exclusions
246+ pure $ MMap.singleton parent (Map.keysSet exclusions) <> fold (MMap.MonoidalMap deeperFinds)
247+
248+-- | Traverses a 'PathTree' and folds all leaves matching a given predicate.
249+foldPathTreeFor
250+ :: forall m a b. (Applicative m, Monoid b)
251+ => (a -> Bool)
252+ -> FilePath
253+ -> PathTree a
254+ -> (FilePath -> PathTree a -> m b)
255+ -> m b
256+foldPathTreeFor predicate parent children f = case children of
257+ PathTree_Node (Just x) children' | predicate x -> f parent (PathTree_Node Nothing children')
258+ PathTree_Node _ children' -> fmap fold $ flip Map.traverseWithKey children' $ \k children'' ->
259+ foldPathTreeFor predicate (parent </> k) children'' f
260+
261+data GuessPackageFileError = GuessPackageFileError_Ambiguous [FilePath] | GuessPackageFileError_NotFound
262+ deriving (Eq, Ord, Show)
263+instance Exception GuessPackageFileError
264+
265+newtype HPackFilePath = HPackFilePath { unHPackFilePath :: FilePath } deriving (Eq, Ord, Show)
266+newtype CabalFilePath = CabalFilePath { unCabalFilePath :: FilePath } deriving (Eq, Ord, Show)
103
267
104−runWatch :: MonadObelisk m => m ()
268+-- | Given a directory, try to guess what the appropriate @.cabal@ or @package.yaml@ file is for the package.
105−runWatch = do
269+guessCabalPackageFile
106− pkgs <- getLocalPkgs
270+ :: (MonadIO m)
107− withGhciScript pkgs $ \dotGhciPath -> runGhcid dotGhciPath Nothing
271+ => FilePath -- ^ Directory or path to search for cabal package
272+ -> m (Either GuessPackageFileError (Either CabalFilePath HPackFilePath))
273+guessCabalPackageFile pkg = do
274+ liftIO (doesDirectoryExist pkg) >>= \case
275+ False -> case cabalOrHpackFile pkg of
276+ (Just hpack@(Right _)) -> pure $ Right hpack
277+ (Just cabal@(Left (CabalFilePath cabalFilePath))) -> do
278+ -- If the cabal file has a sibling hpack file, we use that instead
279+ -- since running hpack often generates a sibling cabal file
280+ let possibleHpackSibling = takeDirectory cabalFilePath </> Hpack.packageConfig
281+ hasHpackSibling <- liftIO $ doesFileExist possibleHpackSibling
282+ pure $ Right $ if hasHpackSibling then Right (HPackFilePath possibleHpackSibling) else cabal
283+ Nothing -> pure $ Left GuessPackageFileError_NotFound
284+ True -> do
285+ candidates <- liftIO $
286+ filterM (doesFileExist . either unCabalFilePath unHPackFilePath)
287+ =<< mapMaybe (cabalOrHpackFile . (pkg </>)) <$> listDirectory pkg
288+ pure $ case partitionEithers candidates of
289+ ([hpack], _) -> Right $ Left hpack
290+ ([], [cabal]) -> Right $ Right cabal
291+ ([], []) -> Left GuessPackageFileError_NotFound
292+ (hpacks, cabals) -> Left $ GuessPackageFileError_Ambiguous $ coerce hpacks <> coerce cabals
108
293
109−-- | Relative paths to local packages of an obelisk project
294+cabalOrHpackFile :: FilePath -> Maybe (Either CabalFilePath HPackFilePath)
110−-- TODO a way to query this
295+cabalOrHpackFile = \case
111−getLocalPkgs :: Applicative f => f [FilePath]
296+ x | takeExtension x == ".cabal" -> Just (Left $ CabalFilePath x)
112−getLocalPkgs = pure ["backend", "common", "frontend"]
297+ | takeFileName x == Hpack.packageConfig -> Just (Right $ HPackFilePath x)
298+ | otherwise -> Nothing
113
299
300+-- | Parses the cabal package in a given directory.
301+-- This automatically figures out which .cabal file or package.yaml (hpack) file to use in the given directory.
114parseCabalPackage
302parseCabalPackage
115− :: (MonadObelisk m)
303+ :: MonadObelisk m
116− => FilePath -- ^ package directory
304+ => FilePath -- ^ Package directory
117 -> m (Maybe CabalPackageInfo)
305 -> m (Maybe CabalPackageInfo)
118−parseCabalPackage dir = do
306+parseCabalPackage dir = parseCabalPackage' dir >>= \case
119− let cabalFp = dir </> (takeBaseName dir <> ".cabal")
307+ Left err -> Nothing <$ putLog Error err
120− hpackFp = dir </> "package.yaml"
308+ Right (warnings, pkgInfo) -> do
121− hasCabal <- liftIO $ doesFileExist cabalFp
309+ for_ warnings $ putLog Warning . T.pack . show
122− hasHpack <- liftIO $ doesFileExist hpackFp
310+ pure $ Just pkgInfo
123−
311+
124− mCabalContents <- if hasCabal
312+-- | Like 'parseCabalPackage' but returns errors and warnings directly so as to avoid 'MonadObelisk'.
125− then Just <$> liftIO (readUTF8File cabalFp)
313+parseCabalPackage'
126− else if hasHpack
314+ :: (MonadIO m)
127− then do
315+ => FilePath -- ^ Package directory
316+ -> m (Either T.Text ([Dist.PWarning], CabalPackageInfo))
317+parseCabalPackage' pkg = runExceptT $ do
318+ (cabalContents, packageFile, packageName) <- guessCabalPackageFile pkg >>= \case
319+ Left GuessPackageFileError_NotFound -> throwError $ "No .cabal or package.yaml file found in " <> T.pack pkg
320+ Left (GuessPackageFileError_Ambiguous _) -> throwError $ "Unable to determine which .cabal file to use in " <> T.pack pkg
321+ Right (Left (CabalFilePath file)) -> (, file, takeBaseName file) <$> liftIO (readUTF8File file)
322+ Right (Right (HPackFilePath file)) -> do
323+ let
128− let decodeOptions = DecodeOptions (ProgramName "ob") hpackFp Nothing decodeYaml
324+ decodeOptions = Hpack.DecodeOptions (Hpack.ProgramName "ob") file Nothing Hpack.decodeYaml
129− liftIO (readPackageConfig decodeOptions) >>= \case
325+ liftIO (Hpack.readPackageConfig decodeOptions) >>= \case
130− Left err -> do
131− putLog Error $ T.pack $ "Failed to parse " <> hpackFp <> ": " <> err
326+ Left err -> throwError $ T.pack $ "Failed to parse " <> file <> ": " <> err
132− return Nothing
133− Right (DecodeResult hpackPackage _ _ _) -> do
327+ Right (Hpack.DecodeResult hpackPackage _ _ _) -> pure (Hpack.renderPackage [] hpackPackage, file, Hpack.packageName hpackPackage)
134− return $ Just $ renderPackage [] hpackPackage
328+
135− else return Nothing
329+ let
136−
137− fmap join $ forM mCabalContents $ \cabalContents -> do
138− let (warnings, result) = runParseResult $ parseGenericPackageDescription $
330+ (warnings, result) = runParseResult $ parseGenericPackageDescription $ toUTF8BS cabalContents
139− toUTF8BS $ cabalContents
331+ osConfVar = case System.Info.os of
140− mapM_ (putLog Warning) $ fmap (T.pack . show) warnings
332+ "linux" -> Just Dist.Linux
141− case result of
333+ "darwin" -> Just Dist.OSX
142− Right gpkg -> do
334+ _ -> trace "Unrecgonized System.Info.os" Nothing
143− return $ do
335+ archConfVar = Just Dist.X86_64 -- TODO: Actually infer this
144− (_, lib) <- simplifyCondTree (const $ pure True) <$> condLibrary gpkg
336+ evalConfVar v = Right $ case v of
337+ OS osVar -> Just osVar == osConfVar
338+ Arch archVar -> Just archVar == archConfVar
339+ Impl GHC _ -> True -- TODO: Actually check version range
340+ _ -> False
341+ case condLibrary <$> result of
342+ Right (Just condLib) -> do
343+ let (_, lib) = simplifyCondTree evalConfVar condLib
145− pure $ CabalPackageInfo
344+ pure $ (warnings,) $ CabalPackageInfo
345+ { _cabalPackageInfo_packageName = T.pack packageName
346+ , _cabalPackageInfo_packageFile = packageFile
146− { _cabalPackageInfo_packageRoot = takeDirectory cabalFp
347+ , _cabalPackageInfo_packageRoot = takeDirectory packageFile
348+ , _cabalPackageInfo_buildable = buildable $ libBuildInfo lib
147− , _cabalPackageInfo_sourceDirs =
349+ , _cabalPackageInfo_sourceDirs =
148− fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
350+ fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
149− , _cabalPackageInfo_defaultExtensions =
351+ , _cabalPackageInfo_defaultExtensions =
150− defaultExtensions $ libBuildInfo lib
352+ defaultExtensions $ libBuildInfo lib
151− , _cabalPackageInfo_defaultLanguage =
353+ , _cabalPackageInfo_defaultLanguage =
152− defaultLanguage $ libBuildInfo lib
354+ defaultLanguage $ libBuildInfo lib
153− , _cabalPackageInfo_compilerOptions = options $ libBuildInfo lib
355+ , _cabalPackageInfo_compilerOptions = options $ libBuildInfo lib
154− }
356+ }
357+ Right Nothing -> throwError "Haskell package has no library component"
155− Left (_, errors) -> do
358+ Left (_, errors) ->
156− putLog Error $ T.pack $ "Failed to parse " <> cabalFp <> ":"
359+ throwError $ T.pack $ "Failed to parse " <> packageFile <> ":\n" <> unlines (map show errors)
157− mapM_ (putLog Error) $ fmap (T.pack . show) errors
360+
158− return Nothing
361+parsePackagesOrFail :: (MonadObelisk m, Foldable f) => f FilePath -> m (NE.NonEmpty CabalPackageInfo)
159−
362+parsePackagesOrFail dirs' = do
160−withUTF8FileContentsM :: (MonadIO m, HasCliConfig e m) => FilePath -> (ByteString -> CliT e IO a) -> m a
363+ (pkgDirErrs, packageInfos') <- fmap partitionEithers $ for dirs $ \dir -> do
161−withUTF8FileContentsM fp f = do
364+ flip fmap (parseCabalPackage dir) $ \case
162− c <- getCliConfig
365+ Just packageInfo
163− liftIO $ withUTF8FileContents fp $ runCli c . f . toUTF8BS
366+ | _cabalPackageInfo_buildable packageInfo -> Right packageInfo
367+ _ -> Left dir
368+
369+ -- Sort duplicate packages such that we prefer shorter paths, but fall back to alphabetical ordering.
370+ let packagesByName = Map.map (NE.sortBy $ comparing $ \p -> let n = _cabalPackageInfo_packageFile p in (length n, n))
371+ $ Map.fromListWith (<>) [(_cabalPackageInfo_packageName p, p NE.:| []) | p <- packageInfos']
372+ unambiguous <- ifor packagesByName $ \packageName ps -> case ps of
373+ p NE.:| [] -> pure p -- No ambiguity here
374+ p NE.:| _ -> do
375+ let chosenText = " [Chosen] "
376+ prefix p'
377+ | _cabalPackageInfo_packageFile p' == _cabalPackageInfo_packageFile p = chosenText
378+ | otherwise = T.map (const ' ') chosenText
379+ putLog Warning $ T.unlines $
380+ "Packages named '" <> packageName <> "' appear in " <> T.pack (show $ length ps) <> " different locations: "
381+ : map (\p' -> prefix p' <> T.pack (_cabalPackageInfo_packageFile p')) (toList ps)
382+ pure p
383+
384+ packageInfos <- case NE.nonEmpty $ toList unambiguous of
385+ Nothing -> failWith $ T.pack $
386+ "No valid, buildable packages found" <> (if null dirs then "" else " in " <> intercalate ", " dirs)
387+ Just xs -> pure xs
388+
389+ unless (null pkgDirErrs) $
390+ putLog Warning $ T.pack $ "Failed to find buildable packages in " <> intercalate ", " pkgDirErrs
391+
392+ pure packageInfos
393+ where
394+ dirs = toList dirs'
395+
396+packageInfoToNamePathMap :: Foldable f => f CabalPackageInfo -> Map Text FilePath
397+packageInfoToNamePathMap = Map.fromList . map (_cabalPackageInfo_packageName &&& _cabalPackageInfo_packageRoot) . toList
164
398
165-- | Create ghci configuration to load the given packages
399-- | Create ghci configuration to load the given packages
166withGhciScript
400withGhciScript
167− :: MonadObelisk m
401+ :: (MonadObelisk m, Foldable f)
168− => [FilePath] -- ^ List of packages to load into ghci
402+ => f CabalPackageInfo -- ^ List of packages to load into ghci
169− -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporory .ghci
403+ -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporary .ghci
170 -> m ()
404 -> m ()
171−withGhciScript pkgs f = do
405+withGhciScript (toList -> packageInfos) f =
172− (pkgDirErrs, packageInfos) <- fmap partitionEithers $ forM pkgs $ \pkg -> do
173− flip fmap (parseCabalPackage pkg) $ \case
174− Nothing -> Left pkg
175− Just packageInfo -> Right packageInfo
176−
177− when (null packageInfos) $
178− failWith $ T.pack $ "No valid pkgs found in " <> intercalate ", " pkgs
179− unless (null pkgDirErrs) $
180− putLog Warning $ T.pack $ "Failed to find pkgs in " <> intercalate ", " pkgDirErrs
181−
182− let extensions = packageInfos >>= _cabalPackageInfo_defaultExtensions
183− languageFromPkgs = L.nub $ mapMaybe _cabalPackageInfo_defaultLanguage packageInfos
184− -- NOTE when no default-language is present cabal sets Haskell98
185− language = NE.toList $ fromMaybe (Haskell98 NE.:| []) $ NE.nonEmpty languageFromPkgs
186− extensionsLine = if extensions == mempty
187− then ""
188− else ":set " <> intercalate " " ((("-X" <>) . prettyShow) <$> extensions)
189− ghcOptions = concat $ mapMaybe (\case (GHC, xs) -> Just xs; _ -> Nothing) $
190− packageInfos >>= _cabalPackageInfo_compilerOptions
191− dotGhci = unlines $
192− [ ":set -i" <> intercalate ":" (packageInfos >>= rootedSourceDirs)
193− , case ghcOptions of
194− [] -> ""
195− xs -> ":set " <> intercalate " " xs
196− , extensionsLine
197− , ":set " <> intercalate " " (("-X" <>) . prettyShow <$> language)
198− , ":load Backend Frontend"
199− , "import Obelisk.Run"
200− , "import qualified Frontend"
201− , "import qualified Backend"
202− ]
203− warnDifferentLanguages language
204 withSystemTempDirectory "ob-ghci" $ \fp -> do
406 withSystemTempDirectory "ob-ghci" $ \fp -> do
205 let dotGhciPath = fp </> ".ghci"
407 let dotGhciPath = fp </> ".ghci"
206 liftIO $ writeFile dotGhciPath dotGhci
408 liftIO $ writeFile dotGhciPath dotGhci
207 f dotGhciPath
409 f dotGhciPath
410+ where
411+ packageNames = Set.fromList $ map _cabalPackageInfo_packageName packageInfos
412+ modulesToLoad = mconcat
413+ [ [ "Obelisk.Run" | "obelisk-run" `Set.member` packageNames ]
414+ , [ "Backend" | "backend" `Set.member` packageNames ]
415+ , [ "Frontend" | "frontend" `Set.member` packageNames ]
416+ ]
417+ dotGhci = unlines
418+ [ if null modulesToLoad then "" else ":load " <> unwords modulesToLoad
419+ , "import qualified Obelisk.Run"
420+ , "import qualified Frontend"
421+ , "import qualified Backend"
422+ ]
423+
424+-- | Builds a list of options to pass to ghci or set in .ghci file that configures
425+-- the preprocessor and source includes.
426+getGhciSessionSettings
427+ :: (MonadObelisk m, Foldable f)
428+ => f CabalPackageInfo -- ^ List of packages to load into ghci
429+ -> FilePath -- ^ All paths will be relative to this path
430+ -> Bool -- ^ Use relative paths
431+ -> m [String]
432+getGhciSessionSettings (toList -> packageInfos) pathBase useRelativePaths = do
433+ -- N.B. ghci settings do NOT support escaping in any way. To minimize the likelihood that
434+ -- paths-with-spaces ruin our day, we first canonicalize everything, and then relativize
435+ -- all paths to 'pathBase'.
436+ selfExe <- liftIO $ canonicalizePath =<< getExecutablePath
437+ canonicalPathBase <- liftIO $ canonicalizePath pathBase
208
438
439+ (pkgFiles, pkgSrcPaths :: [NonEmpty FilePath]) <- fmap unzip $ liftIO $ for packageInfos $ \pkg -> do
440+ canonicalSrcDirs <- traverse canonicalizePath $ (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
441+ canonicalPkgFile <- canonicalizePath $ _cabalPackageInfo_packageFile pkg
442+ pure (canonicalPkgFile `relativeTo'` canonicalPathBase, (`relativeTo'` canonicalPathBase) <$> canonicalSrcDirs)
443+
444+ pure
445+ $ baseGhciOptions
446+ <> ["-F", "-pgmF", selfExe, "-optF", preprocessorIdentifier]
447+ <> concatMap (\p -> ["-optF", p]) pkgFiles
448+ <> [ "-i" <> intercalate ":" (concatMap toList pkgSrcPaths) ]
209 where
449 where
210− rootedSourceDirs pkg = NE.toList $
450+ relativeTo' = if useRelativePaths then relativeTo else const
211− (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
212
451
213−warnDifferentLanguages :: MonadObelisk m => [Language] -> m ()
452+baseGhciOptions :: [String]
214−warnDifferentLanguages (_:_:_) = putLog Warning "Different languages detected across packages which may result in errors when loading the repl"
453+baseGhciOptions =
215−warnDifferentLanguages _ = return ()
454+ [ "-ignore-dot-ghci"
455+ , "-no-user-package-db"
456+ , "-package-env", "-"
457+ ]
216
458
217-- | Run ghci repl
459-- | Run ghci repl
218runGhciRepl
460runGhciRepl
219− :: MonadObelisk m
461+ :: (MonadObelisk m, Foldable f)
220− => FilePath -- ^ Path to .ghci
462+ => FilePath -- ^ Path to project root
463+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
464+ -> [String] -- ^ GHCi arguments
221 -> m ()
465 -> m ()
222−runGhciRepl dotGhci = inProjectShell "ghc" $ "ghci " <> makeBaseGhciOptions dotGhci
466+runGhciRepl root (toList -> packages) ghciArgs =
467+ -- NOTE: We do *not* want to use $(staticWhich "ghci") here because we need the
468+ -- ghc that is provided by the shell in the user's project.
469+ nixShellWithoutPkgs root True False (packageInfoToNamePathMap packages) "ghc" $
470+ Just $ unwords $ "ghci" : ghciArgs -- TODO: Shell escape
223
471
224-- | Run ghcid
472-- | Run ghcid
225runGhcid
473runGhcid
226− :: MonadObelisk m
474+ :: (MonadObelisk m, Foldable f)
227− => FilePath -- ^ Path to .ghci
475+ => FilePath -- ^ Path to project root
476+ -> Bool -- ^ Should we chdir to root when running this process?
477+ -> [String] -- ^ GHCi arguments
478+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
228 -> Maybe String -- ^ Optional command to run at every reload
479 -> Maybe String -- ^ Optional command to run at every reload
229 -> m ()
480 -> m ()
230−runGhcid dotGhci mcmd = callCommand $ unwords $ $(staticWhich "ghcid") : opts
481+runGhcid root chdirToRoot ghciArgs (toList -> packages) mcmd =
482+ nixShellWithoutPkgs root True chdirToRoot (packageInfoToNamePathMap packages) "ghc" $
483+ Just $ unwords $ ghcidExePath : opts -- TODO: Shell escape
231 where
484 where
232 opts =
485 opts =
233 [ "-W"
486 [ "-W"
234− --TODO: The decision of whether to use -fwarn-redundant-constraints should probably be made by the user
235− , "--command='ghci -Wall -ignore-dot-ghci -fwarn-redundant-constraints " <> makeBaseGhciOptions dotGhci <> "' "
236− , "--reload=config"
237 , "--outputfile=ghcid-output.txt"
487 , "--outputfile=ghcid-output.txt"
488+ ] <> map (\x -> "--reload='" <> x <> "'") reloadFiles
489+ <> map (\x -> "--restart='" <> x <> "'") restartFiles
238− ] <> testCmd
490+ <> testCmd
491+ <> ["--command='" <> unwords ("ghci" : ghciArgs) <> "'"] -- TODO: Shell escape
239− testCmd = maybeToList (flip fmap mcmd $ \cmd -> "--test='" <> cmd <> "'")
492+ testCmd = maybeToList (flip fmap mcmd $ \cmd -> "--test='" <> cmd <> "'") -- TODO: Shell escape
240
493
494+ adjustRoot x = if chdirToRoot then makeRelative root x else x
495+ reloadFiles = map adjustRoot [root </> "config"]
496+ restartFiles = map (adjustRoot . _cabalPackageInfo_packageFile) packages
497+
241−makeBaseGhciOptions :: FilePath -> String
498+mkGhciScriptArg :: FilePath -> [String]
242−makeBaseGhciOptions dotGhci =
243− unwords
244− [ "-no-user-package-db"
245− , "-package-env -"
246− , "-ghci-script " <> dotGhci
499+mkGhciScriptArg dotGhci = ["-ghci-script", dotGhci]
247− ]
248
500
249getFreePort :: MonadIO m => m PortNumber
501getFreePort :: MonadIO m => m PortNumber
250getFreePort = liftIO $ withSocketsDo $ do
502getFreePort = liftIO $ withSocketsDo $ do
@@ -254,4 +506,38 @@ getFreePort = liftIO $ withSocketsDo $ do
254 open addr = do
506 open addr = do
255 sock <- socket (addrFamily addr) (addrSocketType addr) (addrProtocol addr)
507 sock <- socket (addrFamily addr) (addrSocketType addr) (addrProtocol addr)
256 bind sock (addrAddress addr)
508 bind sock (addrAddress addr)
257− return sock
509+ return sock
510+
511+
512+-- | Convert a 'FilePath' into a 'PathTree'.
513+pathToTree :: a -> FilePath -> PathTree a
514+pathToTree a p = go $ splitDirectories p
515+ where
516+ go [] = PathTree_Node (Just a) mempty
517+ go (x : xs) = PathTree_Node Nothing $ Map.singleton x $ go xs
518+
519+-- | Like 'zipWith' but pads with a padding value instead of stopping on the shortest list.
520+zipDefaultWith :: a -> b -> (a -> b -> c) -> [a] -> [b] -> [c]
521+zipDefaultWith _da _db _f [] [] = []
522+zipDefaultWith da db f (a:as) [] = f a db : zipDefaultWith da db f as []
523+zipDefaultWith da db f [] (b:bs) = f da b : zipDefaultWith da db f [] bs
524+zipDefaultWith da db f (a:as) (b:bs) = f a b : zipDefaultWith da db f as bs
525+
526+-- | Makes the first absolute path relative to the second absolute path.
527+--
528+-- Both input paths MUST be absolute.
529+--
530+-- Unlike 'makeRelative' this does not merely strip prefixes. It will introduce
531+-- enough @..@ paths to make the resulting path truly relative in virtually every
532+-- case. The only exception is on Windows when the two paths are on different
533+-- drives. In this case the resulting path may be absolute.
534+relativeTo :: FilePath -> FilePath -> FilePath
535+relativeTo dir base
536+ = bifoldr1 (</>)
537+ $ bimap (collapse . (".." <$) . catMaybes) (collapse . catMaybes)
538+ $ unzip
539+ $ dropWhile (\(a,b) -> a == b)
540+ $ zipDefaultWith Nothing Nothing (,)
541+ (map Just $ splitDirectories base)
542+ (map Just $ splitDirectories dir)
543+ where collapse = foldr (</>) ""
lib/command/src/Obelisk/Command/Thunk.hs+611−355
@@ -5,71 +5,59 @@
5{-# LANGUAGE MultiWayIf #-}
5{-# LANGUAGE MultiWayIf #-}
6{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE PatternGuards #-}
7{-# LANGUAGE PatternGuards #-}
8+{-# LANGUAGE QuasiQuotes #-}
8{-# LANGUAGE ScopedTypeVariables #-}
9{-# LANGUAGE ScopedTypeVariables #-}
9{-# LANGUAGE TypeApplications #-}
10{-# LANGUAGE TypeApplications #-}
10−module Obelisk.Command.Thunk
11+module Obelisk.Command.Thunk where
11− ( ThunkPtr (..)
12− , ThunkRev (..)
13− , ThunkSource (..)
14− , ThunkData (..)
15− , ReadThunkError (..)
16− , GitHubSource (..)
17− , getThunkGitBranch
18− , getLatestRev
19− , updateThunkToLatest
20− , createThunk
21− , createThunkWithLatest
22− , nixBuildAttrWithCache
23− , nixBuildThunkAttrWithCache
24− , unpackThunk
25− , packThunk
26− , readThunk
27− , updateThunk
28− , getThunkPtr
29− , parseGitUri
30− , uriThunkPtr
31− ) where
32
12
33import Control.Applicative
13import Control.Applicative
34import Control.Exception (displayException, try)
14import Control.Exception (displayException, try)
35−import qualified Control.Lens as Lens
15+import Control.Lens (ifor, ifor_, (.~))
36−import Control.Lens.Indexed hiding ((<.>))
37import Control.Monad
16import Control.Monad
38−import Control.Monad.Catch (handle)
17+import Control.Monad.Extra (findM)
18+import Control.Monad.Catch (MonadCatch, handle)
39import Control.Monad.Except
19import Control.Monad.Except
40import Data.Aeson ((.=))
20import Data.Aeson ((.=))
41import qualified Data.Aeson as Aeson
21import qualified Data.Aeson as Aeson
42import Data.Aeson.Encode.Pretty
22import Data.Aeson.Encode.Pretty
43import qualified Data.Aeson.Types as Aeson
23import qualified Data.Aeson.Types as Aeson
24+import Data.Bifunctor (first)
44import qualified Data.ByteString.Lazy as LBS
25import qualified Data.ByteString.Lazy as LBS
26+import Data.Containers.ListUtils (nubOrd)
45import Data.Default
27import Data.Default
46import Data.Either.Combinators (fromRight', rightToMaybe)
28import Data.Either.Combinators (fromRight', rightToMaybe)
29+import Data.Foldable (toList)
30+import Data.Function ((&))
31+import Data.Functor ((<&>))
47import Data.Git.Ref (Ref)
32import Data.Git.Ref (Ref)
48import qualified Data.Git.Ref as Ref
33import qualified Data.Git.Ref as Ref
49import qualified Data.List as L
34import qualified Data.List as L
50−import Data.List.NonEmpty (NonEmpty (..))
35+import Data.List.NonEmpty (NonEmpty (..), nonEmpty)
51import qualified Data.List.NonEmpty as NonEmpty
36import qualified Data.List.NonEmpty as NonEmpty
52import Data.Map (Map)
37import Data.Map (Map)
53import qualified Data.Map as Map
38import qualified Data.Map as Map
54import Data.Maybe
39import Data.Maybe
55import Data.Set (Set)
40import Data.Set (Set)
56import qualified Data.Set as Set
41import qualified Data.Set as Set
42+import Data.String.Here.Interpolated (i)
43+import Data.String.Here.Uninterpolated (here)
57import Data.Text (Text)
44import Data.Text (Text)
58import qualified Data.Text as T
45import qualified Data.Text as T
59import Data.Text.Encoding
46import Data.Text.Encoding
60import qualified Data.Text.IO as T
47import qualified Data.Text.IO as T
61import Data.Time.Clock.POSIX (posixSecondsToUTCTime)
48import Data.Time.Clock.POSIX (posixSecondsToUTCTime)
49+import Data.Traversable (for)
62import Data.Yaml (parseMaybe)
50import Data.Yaml (parseMaybe)
63import GitHub
51import GitHub
64import GitHub.Data.Name
52import GitHub.Data.Name
65import Obelisk.Command.Nix
53import Obelisk.Command.Nix
66import System.Directory
54import System.Directory
55+import System.Exit
67import System.FilePath
56import System.FilePath
68import System.IO.Error
57import System.IO.Error
69import System.IO.Temp
58import System.IO.Temp
70import System.Posix (getSymbolicLinkStatus, modificationTime)
59import System.Posix (getSymbolicLinkStatus, modificationTime)
71−import System.Process (proc)
60+import qualified Text.URI as URI
72−import Text.URI
73
61
74import Obelisk.App (MonadObelisk)
62import Obelisk.App (MonadObelisk)
75import Obelisk.CliApp
63import Obelisk.CliApp
@@ -77,11 +65,10 @@ import Obelisk.Command.Utils
77
65
78--TODO: Support symlinked thunk data
66--TODO: Support symlinked thunk data
79data ThunkData
67data ThunkData
80− = ThunkData_Packed ThunkPtr
68+ = ThunkData_Packed ThunkSpec ThunkPtr
81 -- ^ Packed thunk
69 -- ^ Packed thunk
82− | ThunkData_Checkout (Maybe ThunkPtr)
70+ | ThunkData_Checkout
83 -- ^ Checked out thunk that was unpacked from this pointer
71 -- ^ Checked out thunk that was unpacked from this pointer
84− deriving (Show, Eq, Ord)
85
72
86-- | A reference to the exact data that a thunk should translate into
73-- | A reference to the exact data that a thunk should translate into
87data ThunkPtr = ThunkPtr
74data ThunkPtr = ThunkPtr
@@ -107,41 +94,72 @@ data ThunkSource
107 | ThunkSource_Git GitSource
94 | ThunkSource_Git GitSource
108 deriving (Show, Eq, Ord)
95 deriving (Show, Eq, Ord)
109
96
97+thunkSourceToGitSource :: ThunkSource -> GitSource
98+thunkSourceToGitSource = \case
99+ ThunkSource_GitHub s -> forgetGithub False s
100+ ThunkSource_Git s -> s
101+
110data GitHubSource = GitHubSource
102data GitHubSource = GitHubSource
111 { _gitHubSource_owner :: Name Owner
103 { _gitHubSource_owner :: Name Owner
112 , _gitHubSource_repo :: Name Repo
104 , _gitHubSource_repo :: Name Repo
113 , _gitHubSource_branch :: Maybe (Name Branch)
105 , _gitHubSource_branch :: Maybe (Name Branch)
106+ , _gitHubSource_private :: Bool
114 }
107 }
115 deriving (Show, Eq, Ord)
108 deriving (Show, Eq, Ord)
116
109
110+newtype GitUri = GitUri { unGitUri :: URI.URI } deriving (Eq, Ord, Show)
111+
112+gitUriToText :: GitUri -> Text
113+gitUriToText (GitUri uri)
114+ | (T.toLower . URI.unRText <$> URI.uriScheme uri) == Just "file"
115+ , Just (_, path) <- URI.uriPath uri
116+ = "/" <> T.intercalate "/" (map URI.unRText $ NonEmpty.toList path)
117+ | otherwise = URI.render uri
118+
117data GitSource = GitSource
119data GitSource = GitSource
118− { _gitSource_url :: URI
120+ { _gitSource_url :: GitUri
119 , _gitSource_branch :: Maybe (Name Branch)
121 , _gitSource_branch :: Maybe (Name Branch)
120 , _gitSource_fetchSubmodules :: Bool
122 , _gitSource_fetchSubmodules :: Bool
123+ , _gitSource_private :: Bool
121 }
124 }
122 deriving (Show, Eq, Ord)
125 deriving (Show, Eq, Ord)
123
126
127+newtype ThunkConfig = ThunkConfig
128+ { _thunkConfig_private :: Maybe Bool
129+ } deriving Show
130+
131+data ThunkUpdateConfig = ThunkUpdateConfig
132+ { _thunkUpdateConfig_branch :: Maybe String
133+ , _thunkUpdateConfig_config :: ThunkConfig
134+ } deriving Show
135+
136+data ThunkPackConfig = ThunkPackConfig
137+ { _thunkPackConfig_force :: Bool
138+ , _thunkPackConfig_config :: ThunkConfig
139+ } deriving Show
140+
124-- | Convert a GitHub source to a regular Git source. Assumes no submodules.
141-- | Convert a GitHub source to a regular Git source. Assumes no submodules.
125forgetGithub :: Bool -> GitHubSource -> GitSource
142forgetGithub :: Bool -> GitHubSource -> GitSource
126forgetGithub useSsh s = GitSource
143forgetGithub useSsh s = GitSource
127− { _gitSource_url = URI
144+ { _gitSource_url = GitUri $ URI.URI
128− { uriScheme = Just $ fromRight' $ mkScheme $ if useSsh then "ssh" else "https"
145+ { URI.uriScheme = Just $ fromRight' $ URI.mkScheme $ if useSsh then "ssh" else "https"
129− , uriAuthority = Right $ Authority
146+ , URI.uriAuthority = Right $ URI.Authority
130− { authUserInfo = UserInfo (fromRight' $ mkUsername "git") Nothing
147+ { URI.authUserInfo = URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
131 <$ guard useSsh
148 <$ guard useSsh
132− , authHost = fromRight' $ mkHost "github.com"
149+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
133− , authPort = Nothing
150+ , URI.authPort = Nothing
134 }
151 }
135− , uriPath = Just ( False
152+ , URI.uriPath = Just ( False
136− , fromRight' . mkPathPiece <$>
153+ , fromRight' . URI.mkPathPiece <$>
137 untagName (_gitHubSource_owner s)
154 untagName (_gitHubSource_owner s)
138 :| [ untagName (_gitHubSource_repo s) <> ".git" ]
155 :| [ untagName (_gitHubSource_repo s) <> ".git" ]
139 )
156 )
140− , uriQuery = []
157+ , URI.uriQuery = []
141− , uriFragment = Nothing
158+ , URI.uriFragment = Nothing
142 }
159 }
143 , _gitSource_branch = _gitHubSource_branch s
160 , _gitSource_branch = _gitHubSource_branch s
144 , _gitSource_fetchSubmodules = False
161 , _gitSource_fetchSubmodules = False
162+ , _gitSource_private = _gitHubSource_private s
145 }
163 }
146
164
147getThunkGitBranch :: ThunkPtr -> Maybe Text
165getThunkGitBranch :: ThunkPtr -> Maybe Text
@@ -155,20 +173,20 @@ commitNameToRef (N c) = Ref.fromHex $ encodeUtf8 c
155-- TODO: Use spinner here.
173-- TODO: Use spinner here.
156getNixSha256ForUriUnpacked
174getNixSha256ForUriUnpacked
157 :: MonadObelisk m
175 :: MonadObelisk m
158− => URI
176+ => GitUri
159 -> m NixSha256
177 -> m NixSha256
160getNixSha256ForUriUnpacked uri =
178getNixSha256ForUriUnpacked uri =
161− withExitFailMessage ("nix-prefetch-url: Failed to determine sha256 hash of URL " <> render uri) $ do
179+ withExitFailMessage ("nix-prefetch-url: Failed to determine sha256 hash of URL " <> gitUriToText uri) $ do
162 [hash] <- fmap T.lines $ readProcessAndLogOutput (Debug, Debug) $
180 [hash] <- fmap T.lines $ readProcessAndLogOutput (Debug, Debug) $
163− proc "nix-prefetch-url" ["--unpack" , "--type" , "sha256" , T.unpack $ render uri]
181+ proc "nix-prefetch-url" ["--unpack", "--type", "sha256", T.unpack $ gitUriToText uri]
164 pure hash
182 pure hash
165
183
166−nixPrefetchGit :: MonadObelisk m => URI -> Text -> Bool -> m NixSha256
184+nixPrefetchGit :: MonadObelisk m => GitUri -> Text -> Bool -> m NixSha256
167nixPrefetchGit uri rev fetchSubmodules =
185nixPrefetchGit uri rev fetchSubmodules =
168− withExitFailMessage ("nix-prefetch-git: Failed to determine sha256 hash of Git repo " <> render uri <> " at " <> rev) $ do
186+ withExitFailMessage ("nix-prefetch-git: Failed to determine sha256 hash of Git repo " <> gitUriToText uri <> " at " <> rev) $ do
169 out <- readProcessAndLogStderr Debug $
187 out <- readProcessAndLogStderr Debug $
170 proc "nix-prefetch-git" $ filter (/="")
188 proc "nix-prefetch-git" $ filter (/="")
171− [ "--url", T.unpack $ render uri
189+ [ "--url", T.unpack $ gitUriToText uri
172 , "--rev", T.unpack rev
190 , "--rev", T.unpack rev
173 , if fetchSubmodules then "--fetch-submodules" else ""
191 , if fetchSubmodules then "--fetch-submodules" else ""
174 , "--quiet"
192 , "--quiet"
@@ -180,93 +198,117 @@ nixPrefetchGit uri rev fetchSubmodules =
180
198
181--TODO: Pretty print these
199--TODO: Pretty print these
182data ReadThunkError
200data ReadThunkError
183− = ReadThunkError_UnrecognizedFiles
201+ = ReadThunkError_UnrecognizedThunk
184− | ReadThunkError_AmbiguousFiles
202+ | ReadThunkError_UnrecognizedPaths (NonEmpty FilePath)
185− | ReadThunkError_UnrecognizedLoader Text
203+ | ReadThunkError_MissingPaths (NonEmpty FilePath)
186− | ReadThunkError_UnparseablePtr LBS.ByteString
204+ | ReadThunkError_UnparseablePtr FilePath String
187− deriving (Show)
205+ | ReadThunkError_FileError IOError
188−
206+ | ReadThunkError_FileDoesNotMatch FilePath Text
189−-- | Read a thunk and validate that it is only a thunk, either packed or unpacked.
207+ | ReadThunkError_UnrecognizedState String
190−-- If the thunk is packed and additional data is present, fail.
208+ | ReadThunkError_AmbiguousPackedState ThunkPtr ThunkPtr
191−readThunk :: MonadObelisk m => FilePath -> m (Either ReadThunkError ThunkData)
209+ deriving (Show)
192−readThunk thunkDir = do
210+
193− files <- liftIO $ listDirectory thunkDir
211+unpackedDirName :: FilePath
194− case ".git" `elem` files of
212+unpackedDirName = "."
195− True -> fmap ThunkData_Checkout <$> do
213+
196− let origThunkPath = thunkDir </> ".git" </> "obelisk" </> "orig-thunk"
214+attrCacheFileName :: FilePath
197− liftIO $ doesDirectoryExist origThunkPath >>= \case
215+attrCacheFileName = ".attr-cache"
198− True -> fmap Just <$> readPackedThunk origThunkPath
216+
199− False -> return $ return Nothing
217+-- | Specification for how a file in a thunk version works.
200− False -> liftIO $ fmap ThunkData_Packed <$> readPackedThunk thunkDir
218+data ThunkFileSpec
201−
219+ = ThunkFileSpec_Ptr (LBS.ByteString -> Either String ThunkPtr) -- ^ This file specifies 'ThunkPtr' data
202−data ThunkType = ThunkType
220+ | ThunkFileSpec_FileMatches Text -- ^ This file must match the given content exactly
203− { _thunkType_loader :: FilePath
221+ | ThunkFileSpec_CheckoutIndicator -- ^ Existence of this directory indicates that the thunk is unpacked
204− , _thunkType_json :: FilePath
222+ | ThunkFileSpec_AttrCache -- ^ This directory is an attribute cache
205− , _thunkType_optional :: Set FilePath
223+
206− , _thunkType_loaderVersions :: NonEmpty Text
224+-- | Specification for how a set of files in a thunk version work.
207− , _thunkType_parser :: Aeson.Object -> Aeson.Parser ThunkPtr
225+data ThunkSpec = ThunkSpec
208− }
226+ { _thunkSpec_name :: !Text
209−
227+ , _thunkSpec_files :: !(Map FilePath ThunkFileSpec)
210−gitHubThunkType :: ThunkType
211−gitHubThunkType = ThunkType
212− { _thunkType_loader = "default.nix"
213− , _thunkType_json = "github.json"
214− , _thunkType_optional = Set.fromList [".attr-cache"]
215− , _thunkType_loaderVersions = gitHubStandaloneLoaders
216− , _thunkType_parser = parseThunkPtr $ \v ->
217− ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
218 }
228 }
219
229
220−gitThunkType :: ThunkType
230+thunkSpecTypes :: NonEmpty (NonEmpty ThunkSpec)
221−gitThunkType = ThunkType
231+thunkSpecTypes = gitThunkSpecs :| [gitHubThunkSpecs]
222− { _thunkType_loader = "default.nix"
232+
223− , _thunkType_json = "git.json"
233+-- | Attempts to match a 'ThunkSpec' to a given directory.
224− , _thunkType_optional = Set.fromList [".attr-cache"]
234+matchThunkSpecToDir
225− , _thunkType_loaderVersions = plainGitStandaloneLoaders
235+ :: (MonadError ReadThunkError m, MonadIO m, MonadCatch m)
226− , _thunkType_parser = parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
236+ => ThunkSpec -- ^ 'ThunkSpec' to match against the given files/directory
227− }
237+ -> FilePath -- ^ Path to directory
228−
238+ -> Set FilePath -- ^ Set of file paths relative to the given directory
229−thunkTypes :: [ThunkType]
239+ -> m ThunkData
230−thunkTypes = [gitThunkType, gitHubThunkType]
240+matchThunkSpecToDir thunkSpec dir dirFiles = do
231−
241+ case nonEmpty (toList $ dirFiles `Set.difference` expectedPaths) of
232−findThunkType :: [ThunkType] -> FilePath -> IO (Either ReadThunkError ThunkType)
242+ Just fs -> throwError $ ReadThunkError_UnrecognizedPaths $ (dir </>) <$> fs
233−findThunkType types thunkDir = do
243+ Nothing -> pure ()
234− matches <- fmap catMaybes $ forM types $ \thunkType -> do
244+ case nonEmpty (toList $ requiredPaths `Set.difference` dirFiles) of
235− let
245+ Just fs -> throwError $ ReadThunkError_MissingPaths $ (dir </>) <$> fs
236− expectedContents = Set.fromList $ (thunkDir </>) <$>
246+ Nothing -> pure ()
237− [ _thunkType_loader thunkType
247+ datas <- fmap toList $ flip Map.traverseMaybeWithKey (_thunkSpec_files thunkSpec) $ \expectedPath -> \case
238− , _thunkType_json thunkType
248+ ThunkFileSpec_AttrCache -> Nothing <$ dirMayExist expectedPath
239− ]
249+ ThunkFileSpec_CheckoutIndicator -> liftIO (doesDirectoryExist (dir </> expectedPath)) <&> \case
240− optionalContents = Set.map (thunkDir </>) (_thunkType_optional thunkType)
250+ False -> Nothing
241−
251+ True -> Just ThunkData_Checkout
242− -- Ensure that there aren't any other files in the thunk
252+ ThunkFileSpec_FileMatches expectedContents -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
243− -- NB: System.Directory.listDirectory returns the contents without the directory path
253+ actualContents <- liftIO (T.readFile $ dir </> expectedPath)
244− files <- liftIO $ Set.fromList . fmap (thunkDir </>) <$> listDirectory thunkDir
254+ case T.strip expectedContents == T.strip actualContents of
245− let unexpectedContents = files `Set.difference` (expectedContents `Set.union` optionalContents)
255+ True -> pure Nothing
246− missingContents = expectedContents `Set.difference` files
256+ False -> throwError $ ReadThunkError_FileDoesNotMatch (dir </> expectedPath) expectedContents
247− pure $ if Set.null unexpectedContents && Set.null missingContents
257+ ThunkFileSpec_Ptr parser -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
248− then Just thunkType
258+ let path = dir </> expectedPath
249− else Nothing
259+ liftIO (doesFileExist path) >>= \case
250−
260+ False -> pure Nothing
251− pure $ case matches of
261+ True -> do
252− [singleMatch] -> Right singleMatch
262+ actualContents <- liftIO $ LBS.readFile path
253− [] -> Left ReadThunkError_UnrecognizedFiles
263+ case parser actualContents of
254− _ -> Left ReadThunkError_AmbiguousFiles
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}|]
255
307
256-- | Read a thunk and validate that it is exactly a packed thunk.
308-- | Read a thunk and validate that it is exactly a packed thunk.
257-- If additional data is present, fail.
309-- If additional data is present, fail.
258−readPackedThunk :: FilePath -> IO (Either ReadThunkError ThunkPtr)
310+readThunk :: (MonadObelisk m) => FilePath -> m (Either ReadThunkError ThunkData)
259−readPackedThunk thunkDir = runExceptT $ do
311+readThunk = readThunkWith thunkSpecTypes
260− thunkType <- ExceptT $ findThunkType thunkTypes thunkDir
261− -- Ensure that we recognize the thunk loader
262− loader <- liftIO $ T.readFile $ thunkDir </> _thunkType_loader thunkType
263− unless (loader `elem` _thunkType_loaderVersions thunkType) $ do
264− throwError $ ReadThunkError_UnrecognizedLoader loader
265−
266− txt <- liftIO $ LBS.readFile $ thunkDir </> _thunkType_json thunkType
267− case parseMaybe (_thunkType_parser thunkType) =<< Aeson.decode txt of
268− Nothing -> throwError $ ReadThunkError_UnparseablePtr txt
269− Just ptr -> return ptr
270
312
271parseThunkPtr :: (Aeson.Object -> Aeson.Parser ThunkSource) -> Aeson.Object -> Aeson.Parser ThunkPtr
313parseThunkPtr :: (Aeson.Object -> Aeson.Parser ThunkSource) -> Aeson.Object -> Aeson.Parser ThunkPtr
272parseThunkPtr parseSrc v = do
314parseThunkPtr parseSrc v = do
@@ -286,10 +328,12 @@ parseGitHubSource v = do
286 owner <- v Aeson..: "owner"
328 owner <- v Aeson..: "owner"
287 repo <- v Aeson..: "repo"
329 repo <- v Aeson..: "repo"
288 branch <- v Aeson..:! "branch"
330 branch <- v Aeson..:! "branch"
331+ private <- v Aeson..:? "private"
289 pure $ GitHubSource
332 pure $ GitHubSource
290 { _gitHubSource_owner = owner
333 { _gitHubSource_owner = owner
291 , _gitHubSource_repo = repo
334 , _gitHubSource_repo = repo
292 , _gitHubSource_branch = branch
335 , _gitHubSource_branch = branch
336+ , _gitHubSource_private = fromMaybe False private
293 }
337 }
294
338
295parseGitSource :: Aeson.Object -> Aeson.Parser GitSource
339parseGitSource :: Aeson.Object -> Aeson.Parser GitSource
@@ -297,25 +341,29 @@ parseGitSource v = do
297 Just url <- parseGitUri <$> v Aeson..: "url"
341 Just url <- parseGitUri <$> v Aeson..: "url"
298 branch <- v Aeson..:! "branch"
342 branch <- v Aeson..:! "branch"
299 fetchSubmodules <- v Aeson..:! "fetchSubmodules"
343 fetchSubmodules <- v Aeson..:! "fetchSubmodules"
344+ private <- v Aeson..:? "private"
300 pure $ GitSource
345 pure $ GitSource
301 { _gitSource_url = url
346 { _gitSource_url = url
302 , _gitSource_branch = branch
347 , _gitSource_branch = branch
303 , _gitSource_fetchSubmodules = fromMaybe False fetchSubmodules
348 , _gitSource_fetchSubmodules = fromMaybe False fetchSubmodules
349+ , _gitSource_private = fromMaybe False private
304 }
350 }
305
351
306overwriteThunk :: MonadObelisk m => FilePath -> ThunkPtr -> m ()
352overwriteThunk :: MonadObelisk m => FilePath -> ThunkPtr -> m ()
307overwriteThunk target thunk = do
353overwriteThunk target thunk = do
308 -- Ensure that this directory is a valid thunk (i.e. so we aren't losing any data)
354 -- Ensure that this directory is a valid thunk (i.e. so we aren't losing any data)
309− Right _ <- readThunk target
355+ readThunk target >>= \case
356+ Left e -> failWith [i|Invalid thunk at ${target}: ${e}|]
357+ Right _ -> pure ()
310
358
311 --TODO: Is there a safer way to do this overwriting?
359 --TODO: Is there a safer way to do this overwriting?
312− liftIO $ removeDirectoryRecursive target
360+ liftIO $ removePathForcibly target
313− liftIO $ createThunk target thunk
361+ createThunk target $ Right thunk
314
362
315−thunkPtrLoader :: ThunkPtr -> Text
363+thunkPtrToSpec :: ThunkPtr -> ThunkSpec
316−thunkPtrLoader thunk = case _thunkPtr_source thunk of
364+thunkPtrToSpec thunk = case _thunkPtr_source thunk of
317− ThunkSource_GitHub _ -> NonEmpty.head gitHubStandaloneLoaders
365+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
318− ThunkSource_Git _ -> NonEmpty.head plainGitStandaloneLoaders
366+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
319
367
320-- It's important that formatting be very consistent here, because
368-- It's important that formatting be very consistent here, because
321-- otherwise when people update thunks, their patches will be messy
369-- otherwise when people update thunks, their patches will be messy
@@ -327,13 +375,15 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
327 , ("branch" .=) <$> _gitHubSource_branch s
375 , ("branch" .=) <$> _gitHubSource_branch s
328 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
376 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
329 , Just $ "sha256" .= _thunkRev_nixSha256 rev
377 , Just $ "sha256" .= _thunkRev_nixSha256 rev
378+ , Just $ "private" .= _gitHubSource_private s
330 ]
379 ]
331 ThunkSource_Git s -> encodePretty' plainGitCfg $ Aeson.object $ catMaybes
380 ThunkSource_Git s -> encodePretty' plainGitCfg $ Aeson.object $ catMaybes
332− [ Just $ "url" .= render (_gitSource_url s)
381+ [ Just $ "url" .= gitUriToText (_gitSource_url s)
333 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
382 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
334 , ("branch" .=) <$> _gitSource_branch s
383 , ("branch" .=) <$> _gitSource_branch s
335 , Just $ "sha256" .= _thunkRev_nixSha256 rev
384 , Just $ "sha256" .= _thunkRev_nixSha256 rev
336 , Just $ "fetchSubmodules" .= _gitSource_fetchSubmodules s
385 , Just $ "fetchSubmodules" .= _gitSource_fetchSubmodules s
386+ , Just $ "private" .= _gitSource_private s
337 ]
387 ]
338 where
388 where
339 githubCfg = defConfig
389 githubCfg = defConfig
@@ -354,78 +404,84 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
354 [ "url"
404 [ "url"
355 , "rev"
405 , "rev"
356 , "sha256"
406 , "sha256"
407+ , "private"
357 , "fetchSubmodules"
408 , "fetchSubmodules"
358 ] <> compare
409 ] <> compare
359 , confTrailingNewline = True
410 , confTrailingNewline = True
360 }
411 }
361
412
362−createThunk :: MonadIO m => FilePath -> ThunkPtr -> m ()
413+createThunk :: MonadObelisk m => FilePath -> Either ThunkSpec ThunkPtr -> m ()
363−createThunk target thunk = liftIO $ do
414+createThunk target ptrInfo =
364− createDirectoryIfMissing True (target </> ".attr-cache")
415+ ifor_ (_thunkSpec_files spec) $ \path -> \case
365− T.writeFile (target </> "default.nix") (thunkPtrLoader thunk)
416+ ThunkFileSpec_FileMatches content -> withReadyPath path $ \p -> liftIO $ T.writeFile p content
366− let
417+ ThunkFileSpec_Ptr _ -> case ptrInfo of
367− jsonFileName = case _thunkPtr_source thunk of
418+ Left _ -> pure () -- We can't write the ptr without it
368− ThunkSource_GitHub _ -> "github"
369− ThunkSource_Git _ -> "git"
370− LBS.writeFile (target </> jsonFileName <.> "json") (encodeThunkPtrData thunk)
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
371
428
372createThunkWithLatest :: MonadObelisk m => FilePath -> ThunkSource -> m ()
429createThunkWithLatest :: MonadObelisk m => FilePath -> ThunkSource -> m ()
373createThunkWithLatest target s = do
430createThunkWithLatest target s = do
374 rev <- getLatestRev s
431 rev <- getLatestRev s
375− createThunk target $ ThunkPtr
432+ createThunk target $ Right $ ThunkPtr
376 { _thunkPtr_source = s
433 { _thunkPtr_source = s
377 , _thunkPtr_rev = rev
434 , _thunkPtr_rev = rev
378 }
435 }
379
436
380−updateThunkToLatest :: MonadObelisk m => FilePath -> Maybe String -> m ()
437+updateThunkToLatest :: MonadObelisk m => ThunkUpdateConfig -> FilePath -> m ()
381−updateThunkToLatest target mBranch = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest") $ do
438+updateThunkToLatest (ThunkUpdateConfig mBranch thunkConfig) target = spinner $ do
382− checkThunkDirectory "ob thunk update directory cannot be '.'" target
439+ checkThunkDirectory target
383 -- check to see if thunk should be updated to a specific branch or just update it's current branch
440 -- check to see if thunk should be updated to a specific branch or just update it's current branch
384 case mBranch of
441 case mBranch of
385 Nothing -> do
442 Nothing -> do
386 (overwrite, ptr) <- readThunk target >>= \case
443 (overwrite, ptr) <- readThunk target >>= \case
387− Left err -> failWith $ T.pack $ "thunk update: " <> show err
444+ Left err -> failWith [i|Thunk update: ${err}|]
388 Right c -> case c of
445 Right c -> case c of
389− ThunkData_Packed t -> return (target, t)
446+ ThunkData_Packed _ t -> return (target, t)
390− ThunkData_Checkout _ -> failWith "cannot update an unpacked thunk"
447+ ThunkData_Checkout -> failWith "cannot update an unpacked thunk"
391 let src = _thunkPtr_source ptr
448 let src = _thunkPtr_source ptr
392 rev <- getLatestRev src
449 rev <- getLatestRev src
393− overwriteThunk overwrite $ ThunkPtr
450+ overwriteThunk overwrite $ modifyThunkPtrByConfig thunkConfig $ ThunkPtr
394 { _thunkPtr_source = src
451 { _thunkPtr_source = src
395 , _thunkPtr_rev = rev
452 , _thunkPtr_rev = rev
396 }
453 }
397 Just branch -> readThunk target >>= \case
454 Just branch -> readThunk target >>= \case
398− Left err -> failWith $ T.pack $ "thunk update: " <> show err
455+ Left err -> failWith [i|Thunk update: ${err}|]
399 Right c -> case c of
456 Right c -> case c of
400− ThunkData_Packed t -> case _thunkPtr_source t of
457+ ThunkData_Packed _ t -> setThunk thunkConfig target (thunkSourceToGitSource $ _thunkPtr_source t) branch
401− ThunkSource_Git tsg -> setThunk target tsg branch
402− ThunkSource_GitHub tsgh -> do
403− let tsg = forgetGithub False tsgh
404− setThunk target tsg branch
405− ThunkData_Checkout _ -> failWith $ T.pack $ "thunk located at " <> (show target) <> " is unpacked. Use ob thunk pack on the desired directory and then try ob thunk update again."
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.|]
406−
459+ where
460+ spinner = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest")
461+
407−setThunk :: MonadObelisk m => FilePath -> GitSource -> String -> m ()
462+setThunk :: MonadObelisk m => ThunkConfig -> FilePath -> GitSource -> String -> m ()
408−setThunk target gs branch = do
463+setThunk thunkConfig target gs branch = do
409− newThunkPtr <- uriThunkPtr (_gitSource_url gs) (Just $ T.pack branch) Nothing
464+ newThunkPtr <- uriThunkPtr (_gitSource_url gs) (_thunkConfig_private thunkConfig) (Just $ T.pack branch) Nothing
410 overwriteThunk target newThunkPtr
465 overwriteThunk target newThunkPtr
411− updateThunkToLatest target Nothing
466+ updateThunkToLatest (ThunkUpdateConfig Nothing thunkConfig) target
412
467
413-- | All recognized github standalone loaders, ordered from newest to oldest.
468-- | All recognized github standalone loaders, ordered from newest to oldest.
414-- This tool will only ever produce the newest one when it writes a thunk.
469-- This tool will only ever produce the newest one when it writes a thunk.
415−gitHubStandaloneLoaders :: NonEmpty Text
470+gitHubThunkSpecs :: NonEmpty ThunkSpec
416−gitHubStandaloneLoaders =
471+gitHubThunkSpecs =
417− gitHubStandaloneLoaderV2 :|
472+ gitHubThunkSpecV5 :|
418− [ gitHubStandaloneLoaderV3
473+ [ gitHubThunkSpecV4
419− , gitHubStandaloneLoaderV1
474+ , gitHubThunkSpecV3
475+ , gitHubThunkSpecV2
476+ , gitHubThunkSpecV1
420 ]
477 ]
421
478
422−gitHubStandaloneLoaderV1 :: Text
479+gitHubThunkSpecV1 :: ThunkSpec
423−gitHubStandaloneLoaderV1 = T.unlines
480+gitHubThunkSpecV1 = legacyGitHubThunkSpec "github-v1"
424− [ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
481+ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
425− ]
426
482
427−gitHubStandaloneLoaderV2 :: Text
483+gitHubThunkSpecV2 :: ThunkSpec
428−gitHubStandaloneLoaderV2 = T.unlines
484+gitHubThunkSpecV2 = legacyGitHubThunkSpec "github-v2" $ T.unlines
429 [ "# DO NOT HAND-EDIT THIS FILE" --TODO: Add something about how to get more info on Obelisk, etc.
485 [ "# DO NOT HAND-EDIT THIS FILE" --TODO: Add something about how to get more info on Obelisk, etc.
430 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
486 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
431 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
487 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
@@ -435,8 +491,8 @@ gitHubStandaloneLoaderV2 = T.unlines
435 , "))"
491 , "))"
436 ]
492 ]
437
493
438−gitHubStandaloneLoaderV3 :: Text
494+gitHubThunkSpecV3 :: ThunkSpec
439−gitHubStandaloneLoaderV3 = T.unlines
495+gitHubThunkSpecV3 = legacyGitHubThunkSpec "github-v3" $ T.unlines
440 [ "# DO NOT HAND-EDIT THIS FILE"
496 [ "# DO NOT HAND-EDIT THIS FILE"
441 , "let"
497 , "let"
442 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
498 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
@@ -455,22 +511,62 @@ gitHubStandaloneLoaderV3 = T.unlines
455 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
511 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
456 ]
512 ]
457
513
458−plainGitStandaloneLoaders :: NonEmpty Text
514+gitHubThunkSpecV4 :: ThunkSpec
459−plainGitStandaloneLoaders =
515+gitHubThunkSpecV4 = legacyGitHubThunkSpec "github-v4" $ T.unlines
460− plainGitStandaloneLoaderV1 :|
516+ [ "# DO NOT HAND-EDIT THIS FILE"
461− [ plainGitStandaloneLoaderV2
517+ , "let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:"
518+ , " if !fetchSubmodules && !private then builtins.fetchTarball {"
519+ , " url = \"https://github.com/${owner}/${repo}/archive/${rev}.tar.gz\"; inherit sha256;"
520+ , " } else (import <nixpkgs> {}).fetchFromGitHub {"
521+ , " inherit owner repo rev sha256 fetchSubmodules private;"
522+ , " };"
523+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
524+ ]
525+
526+legacyGitHubThunkSpec :: Text -> Text -> ThunkSpec
527+legacyGitHubThunkSpec name loader = ThunkSpec name $ Map.fromList
528+ [ ("default.nix", ThunkFileSpec_FileMatches $ T.strip loader)
529+ , ("github.json" , ThunkFileSpec_Ptr parseGitHubJsonBytes)
530+ , (attrCacheFileName, ThunkFileSpec_AttrCache)
531+ , (".git", ThunkFileSpec_CheckoutIndicator)
532+ ]
533+
534+gitHubThunkSpecV5 :: ThunkSpec
535+gitHubThunkSpecV5 = mkThunkSpec "github-v5" "github.json" parseGitHubJsonBytes [here|
536+# DO NOT HAND-EDIT THIS FILE
537+let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
538+ if !fetchSubmodules && !private then builtins.fetchTarball {
539+ url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
540+ } else (import <nixpkgs> {}).fetchFromGitHub {
541+ inherit owner repo rev sha256 fetchSubmodules private;
542+ };
543+ json = builtins.fromJSON (builtins.readFile ./github.json);
544+in fetch json
545+|]
546+
547+parseGitHubJsonBytes :: LBS.ByteString -> Either String ThunkPtr
548+parseGitHubJsonBytes = parseJsonObject $ parseThunkPtr $ \v ->
549+ ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
550+
551+gitThunkSpecs :: NonEmpty ThunkSpec
552+gitThunkSpecs =
553+ gitThunkSpecV5 :|
554+ [ gitThunkSpecV4
555+ , gitThunkSpecV3
556+ , gitThunkSpecV2
557+ , gitThunkSpecV1
462 ]
558 ]
463
559
464−plainGitStandaloneLoaderV1 :: Text
560+gitThunkSpecV1 :: ThunkSpec
465−plainGitStandaloneLoaderV1 = T.unlines
561+gitThunkSpecV1 = legacyGitThunkSpec "git-v1" $ T.unlines
466 [ "# DO NOT HAND-EDIT THIS FILE"
562 [ "# DO NOT HAND-EDIT THIS FILE"
467 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
563 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
468 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
564 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
469 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
565 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
470 ]
566 ]
471
567
472−plainGitStandaloneLoaderV2 :: Text
568+gitThunkSpecV2 :: ThunkSpec
473−plainGitStandaloneLoaderV2 = T.unlines
569+gitThunkSpecV2 = legacyGitThunkSpec "git-v2" $ T.unlines
474 [ "# DO NOT HAND-EDIT THIS FILE"
570 [ "# DO NOT HAND-EDIT THIS FILE"
475 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
571 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
476 , " if builtins.hasAttr \"fetchGit\" builtins"
572 , " if builtins.hasAttr \"fetchGit\" builtins"
@@ -479,10 +575,87 @@ plainGitStandaloneLoaderV2 = T.unlines
479 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
575 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
480 ]
576 ]
481
577
482−thunkFileNames :: [FilePath]
578+-- This loader has a bug because @builtins.fetchGit@ is not given a @ref@
483−thunkFileNames = ["default.nix", "github.json", "git.json"]
579+-- and will fail to find commits without this because it does shallow clones.
580+gitThunkSpecV3 :: ThunkSpec
581+gitThunkSpecV3 = legacyGitThunkSpec "git-v3" $ T.unlines
582+ [ "# DO NOT HAND-EDIT THIS FILE"
583+ , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
584+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
585+ , " if firstChar == \"/\" then /. + url"
586+ , " else if firstChar == \".\" then ./. + url"
587+ , " else url;"
588+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
589+ , " url = realUrl; inherit rev;"
590+ , " } else (import <nixpkgs> {}).fetchgit {"
591+ , " url = realUrl; inherit rev sha256;"
592+ , " };"
593+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
594+ ]
595+
596+gitThunkSpecV4 :: ThunkSpec
597+gitThunkSpecV4 = legacyGitThunkSpec "git-v4" $ T.unlines
598+ [ "# DO NOT HAND-EDIT THIS FILE"
599+ , "let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
600+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
601+ , " if firstChar == \"/\" then /. + url"
602+ , " else if firstChar == \".\" then ./. + url"
603+ , " else url;"
604+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
605+ , " url = realUrl; inherit rev;"
606+ , " ${if branch == null then null else \"ref\"} = branch;"
607+ , " } else (import <nixpkgs> {}).fetchgit {"
608+ , " url = realUrl; inherit rev sha256;"
609+ , " };"
610+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
611+ ]
484
612
485−--TODO: when checking something out, make a shallow clone
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+
656+
657+parseJsonObject :: (Aeson.Object -> Aeson.Parser a) -> LBS.ByteString -> Either String a
658+parseJsonObject p bytes = Aeson.parseEither p =<< Aeson.eitherDecode bytes
486
659
487-- | Checks a cache directory to see if there is a fresh symlink
660-- | Checks a cache directory to see if there is a fresh symlink
488-- to the result of building an attribute of a thunk.
661-- to the result of building an attribute of a thunk.
@@ -490,44 +663,49 @@ thunkFileNames = ["default.nix", "github.json", "git.json"]
490-- and the result is symlinked into the cache.
663-- and the result is symlinked into the cache.
491nixBuildThunkAttrWithCache
664nixBuildThunkAttrWithCache
492 :: MonadObelisk m
665 :: MonadObelisk m
666+ => ThunkSpec
493− => FilePath
667+ -> FilePath
494 -- ^ Path to directory containing Thunk
668 -- ^ Path to directory containing Thunk
495 -> String
669 -> String
496 -- ^ Attribute to build
670 -- ^ Attribute to build
497− -> m FilePath
671+ -> m (Maybe FilePath)
498 -- ^ Symlink to cached or built nix output
672 -- ^ Symlink to cached or built nix output
499-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
673-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
500-- the caching mechanism will fail as it merely measures the modification
674-- the caching mechanism will fail as it merely measures the modification
501-- time of the cache link and the expression to build.
675-- time of the cache link and the expression to build.
502−nixBuildThunkAttrWithCache thunkDir attr = do
676+nixBuildThunkAttrWithCache thunkSpec thunkDir attr = do
503− --NB: Expects thunkDir to be normalised with no trailing path separator.
504− --This should be guaranteed by the command argument parser.
505− let cacheErrHandler e
506− | isDoesNotExistError e = return Nothing -- expected from a cache miss
507− | otherwise = putLog Error (T.pack $ displayException e) >> return Nothing
508− cacheDir = thunkDir </> ".attr-cache"
509− cachePath = cacheDir </> attr <.> "out"
510 latestChange <- liftIO $ do
677 latestChange <- liftIO $ do
511− createDirectoryIfMissing False cacheDir
678+ let
512− let getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
679+ getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
680+ thunkFileNames = Map.keys $ _thunkSpec_files thunkSpec
513− maximum . catMaybes <$> mapM (getModificationTimeMaybe . (thunkDir </>)) thunkFileNames
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)
514− cacheHit <- handle cacheErrHandler $ do
692+ cacheHit <- handle cacheErrHandler $ do
515− cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
693+ cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
516− return $ if latestChange <= cacheTime
694+ pure $ if latestChange <= cacheTime
517− then Just cachePath
695+ then Just cachePath
518− else Nothing
696+ else Nothing
519− case cacheHit of
697+ case cacheHit of
520− Just c -> return c
698+ Just c -> pure c
521− Nothing -> do
699+ Nothing -> do
522− putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
700+ putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
701+ liftIO $ createDirectoryIfMissing True (takeDirectory cachePath)
523− _ <- nixCmd $ NixCmd_Build$ def
702+ (cachePath <$) $ nixCmd $ NixCmd_Build $ def
524− Lens.& nixBuildConfig_outLink Lens..~ OutLink_IndirectRoot cachePath
703+ & nixBuildConfig_outLink .~ OutLink_IndirectRoot cachePath
525− Lens.& nixCmdConfig_target Lens..~ Target
704+ & nixCmdConfig_target .~ Target
526− { _target_path = Just thunkDir
705+ { _target_path = Just thunkDir
527− , _target_attr = Just attr
706+ , _target_attr = Just attr
528− , _target_expr = Nothing
707+ , _target_expr = Nothing
529− }
708+ }
530− return cachePath
531
709
532-- | Build a nix attribute, and cache the result if possible
710-- | Build a nix attribute, and cache the result if possible
533nixBuildAttrWithCache
711nixBuildAttrWithCache
@@ -538,13 +716,15 @@ nixBuildAttrWithCache
538 -- ^ Attribute to build
716 -- ^ Attribute to build
539 -> m FilePath
717 -> m FilePath
540 -- ^ Symlink to cached or built nix output
718 -- ^ Symlink to cached or built nix output
541−nixBuildAttrWithCache exprPath attr = do
719+nixBuildAttrWithCache exprPath attr = readThunk exprPath >>= \case
542− readThunk exprPath >>= \case
543− -- Only packed thunks are cached. in particular, checkouts are not
720+ -- Only packed thunks are cached. In particular, checkouts are not.
721+ Right (ThunkData_Packed spec _) ->
544− Right (ThunkData_Packed _) -> nixBuildThunkAttrWithCache exprPath attr
722+ maybe build pure =<< nixBuildThunkAttrWithCache spec exprPath attr
723+ _ -> build
724+ where
545− _ -> nixCmd $ NixCmd_Build $ def
725+ build = nixCmd $ NixCmd_Build $ def
546− Lens.& nixBuildConfig_outLink Lens..~ OutLink_None
726+ & nixBuildConfig_outLink .~ OutLink_None
547− Lens.& nixCmdConfig_target Lens..~ Target
727+ & nixCmdConfig_target .~ Target
548 { _target_path = Just exprPath
728 { _target_path = Just exprPath
549 , _target_attr = Just attr
729 , _target_attr = Just attr
550 , _target_expr = Nothing
730 , _target_expr = Nothing
@@ -565,103 +745,144 @@ updateThunk p f = withSystemTempDirectory "obelisk-thunkptr-" $ \tmpDir -> do
565 where
745 where
566 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
746 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
567 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
747 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
568− Right (ThunkData_Packed _) -> do
748+ Right ThunkData_Packed{} -> do
569 let tmpThunk = tmpDir </> "thunk"
749 let tmpThunk = tmpDir </> "thunk"
570 callProcessAndLogOutput (Notice, Error) $
750 callProcessAndLogOutput (Notice, Error) $
571− proc "cp" ["-r", "-T", thunkDir, tmpThunk]
751+ proc cp ["-r", "-T", thunkDir, tmpThunk]
572 return tmpThunk
752 return tmpThunk
573− Right _ -> failWith $ "Thunk is not packed"
753+ Right _ -> failWith "Thunk is not packed"
574 updateThunkFromTmp p' = do
754 updateThunkFromTmp p' = do
575− _ <- packThunk' True False p'
755+ _ <- packThunk' True (ThunkPackConfig False (ThunkConfig Nothing)) p'
576 callProcessAndLogOutput (Notice, Error) $
756 callProcessAndLogOutput (Notice, Error) $
577− proc "cp" ["-r", "-T", p', p]
757+ proc cp ["-r", "-T", p', p]
578
758
579finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
759finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
580finalMsg noTrail s = if noTrail then Nothing else Just s
760finalMsg noTrail s = if noTrail then Nothing else Just s
581
761
582−unpackThunk :: MonadObelisk m => FilePath -> m ()
583−unpackThunk = unpackThunk' False
584−
585-- | Check that we are not somewhere inside the thunk directory
762-- | Check that we are not somewhere inside the thunk directory
586−checkThunkDirectory :: MonadObelisk m => Text -> FilePath -> m ()
763+checkThunkDirectory :: MonadObelisk m => FilePath -> m ()
587−checkThunkDirectory msg thunkDir = do
764+checkThunkDirectory thunkDir = do
588 currentDir <- liftIO getCurrentDirectory
765 currentDir <- liftIO getCurrentDirectory
589 thunkDir' <- liftIO $ canonicalizePath thunkDir
766 thunkDir' <- liftIO $ canonicalizePath thunkDir
590− 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
591
778
592unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
779unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
593−unpackThunk' noTrail thunkDir = checkThunkDirectory "Can't pack/unpack from within the thunk directory" thunkDir >> readThunk thunkDir >>= \case
780+unpackThunk' noTrail thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
594− Left err -> failWith $ "thunk unpack: " <> T.pack (show err)
781+ Left err -> failWith [i|Invalid thunk at ${thunkDir}: ${err}|]
595 --TODO: Overwrite option that rechecks out thunk; force option to do so even if working directory is dirty
782 --TODO: Overwrite option that rechecks out thunk; force option to do so even if working directory is dirty
596− Right (ThunkData_Checkout _) -> failWith "thunk unpack: thunk is already unpacked"
783+ Right ThunkData_Checkout -> failWith [i|Thunk at ${thunkDir} is already unpacked|]
597− Right (ThunkData_Packed tptr) -> do
784+ Right (ThunkData_Packed _ tptr) -> do
598 let (thunkParent, thunkName) = splitFileName thunkDir
785 let (thunkParent, thunkName) = splitFileName thunkDir
599− withTempDirectory thunkParent thunkName $ \tmpRepo -> do
786+ withTempDirectory thunkParent thunkName $ \tmpThunk -> do
600− let obGitDir = tmpRepo </> ".git" </> "obelisk"
787+ let
788+ gitSrc = thunkSourceToGitSource $ _thunkPtr_source tptr
601− s = case _thunkPtr_source tptr of
789+ newSpec = case _thunkPtr_source tptr of
602− ThunkSource_GitHub s' -> forgetGithub False s'
790+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
603− ThunkSource_Git s' -> s'
791+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
604 withSpinner' ("Fetching thunk " <> T.pack thunkName)
792 withSpinner' ("Fetching thunk " <> T.pack thunkName)
605 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
793 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
794+ let unpackedPath = tmpThunk </> unpackedDirName
795+ gitCloneForThunkUnpack gitSrc (_thunkRev_commit $ _thunkPtr_rev tptr) unpackedPath
796+
797+ let normalizeMore = dropTrailingPathSeparator . normalise
798+ when (normalizeMore unpackedPath /= normalizeMore tmpThunk) $ -- Only write meta data if the checkout is not inplace
799+ createThunk tmpThunk $ Left newSpec
800+
801+ liftIO $ do
802+ removePathForcibly thunkDir
803+ renameDirectory tmpThunk thunkDir
804+
805+gitCloneForThunkUnpack
806+ :: MonadObelisk m
807+ => GitSource -- ^ Git source to use
808+ -> Ref hash -- ^ Commit hash to reset to
809+ -> FilePath -- ^ Directory to clone into
810+ -> m ()
811+gitCloneForThunkUnpack gitSrc commit dir = do
606− let git = callProcessAndLogOutput (Notice, Notice) . gitProc tmpRepo
812+ let git = callProcessAndLogOutput (Notice, Notice) . gitProc dir
607− git $ [ "clone" ]
813+ git $ [ "clone" ]
608− ++ ("--recursive" <$ guard (_gitSource_fetchSubmodules s))
814+ ++ ["--recursive" | _gitSource_fetchSubmodules gitSrc]
609− ++ [ T.unpack $ render $ _gitSource_url s ]
815+ ++ [ T.unpack $ gitUriToText $ _gitSource_url gitSrc ]
610− ++ do branch <- maybeToList $ _gitSource_branch s
816+ ++ do branch <- maybeToList $ _gitSource_branch gitSrc
611− [ "--branch", T.unpack $ untagName branch ]
817+ [ "--branch", T.unpack $ untagName branch ]
612− git ["reset", "--hard", Ref.toHexString $ _thunkRev_commit $ _thunkPtr_rev tptr]
818+ git ["reset", "--hard", Ref.toHexString commit]
613− when (_gitSource_fetchSubmodules s) $
819+ when (_gitSource_fetchSubmodules gitSrc) $
614− git ["submodule", "update", "--recursive", "--init"]
820+ git ["submodule", "update", "--recursive", "--init"]
615−
616− liftIO $ createDirectory obGitDir
617− callProcessAndLogOutput (Notice, Error) $
618− proc "cp" ["-r", "-T", thunkDir </> ".", obGitDir </> "orig-thunk"]
619− callProcessAndLogOutput (Notice, Error) $
620− proc "rm" ["-r", thunkDir]
621− callProcessAndLogOutput (Notice, Error) $
622− proc "mv" ["-T", tmpRepo, thunkDir]
623
821
624--TODO: add a rollback mode to pack to the original thunk
822--TODO: add a rollback mode to pack to the original thunk
625−packThunk :: MonadObelisk m => Bool -> FilePath -> m ThunkPtr
823+packThunk :: MonadObelisk m => ThunkPackConfig -> FilePath -> m ThunkPtr
626packThunk = packThunk' False
824packThunk = packThunk' False
627
825
628−packThunk' :: MonadObelisk m => Bool -> Bool -> FilePath -> m ThunkPtr
826+packThunk' :: MonadObelisk m => Bool -> ThunkPackConfig -> FilePath -> m ThunkPtr
629−packThunk' noTrail force thunkDir = checkThunkDirectory "Can't pack/unpack from within the thunk directory" thunkDir >> readThunk thunkDir >>= \case
827+packThunk' noTrail (ThunkPackConfig force thunkConfig) thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
630− Left err -> failWith $ T.pack $ "thunk pack: " <> show err
631− Right (ThunkData_Packed _) -> failWith "pack: thunk is already packed"
828+ Right ThunkData_Packed{} -> failWith [i|Thunk at ${thunkDir} is is already packed|]
632− Right (ThunkData_Checkout _) -> do
829+ _ -> withSpinner'
633− withSpinner' ("Packing thunk " <> T.pack thunkDir)
830+ ("Packing thunk " <> T.pack thunkDir)
634− (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $ do
831+ (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $
635− thunkPtr <- getThunkPtr (not force) thunkDir
832+ do
636− callProcessAndLogOutput (Debug, Error) $ proc "rm" ["-rf", thunkDir]
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
637− liftIO $ createThunk thunkDir thunkPtr
836+ createThunk thunkDir $ Right thunkPtr
638 pure thunkPtr
837 pure thunkPtr
639
838
839+modifyThunkPtrByConfig :: ThunkConfig -> ThunkPtr -> ThunkPtr
840+modifyThunkPtrByConfig (ThunkConfig markPrivate') ptr = case markPrivate' of
841+ Nothing -> ptr
842+ Just markPrivate -> ptr { _thunkPtr_source = case _thunkPtr_source ptr of
843+ ThunkSource_Git s -> ThunkSource_Git $ s { _gitSource_private = markPrivate }
844+ ThunkSource_GitHub s -> ThunkSource_GitHub $ s { _gitHubSource_private = markPrivate }
845+ }
846+
847+data CheckClean
848+ = CheckClean_FullCheck
849+ -- ^ Check that the repo is clean, including .gitignored files
850+ | CheckClean_NotIgnored
851+ -- ^ Check that the repo is clean, not including .gitignored files
852+ | CheckClean_NoCheck
853+ -- ^ Don't check that the repo is clean
854+
640−getThunkPtr :: forall m. MonadObelisk m => Bool -> FilePath -> m ThunkPtr
855+getThunkPtr :: forall m. MonadObelisk m => CheckClean -> FilePath -> Maybe Bool -> m ThunkPtr
641−getThunkPtr checkClean thunkDir = do
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)
642− when checkClean $ ensureCleanGitRepo thunkDir True $
868+ when checkClean $ ensureCleanGitRepo thunkDir checkIgnored
643 "thunk pack: thunk checkout contains unsaved modifications"
869 "thunk pack: thunk checkout contains unsaved modifications"
644
870
645 -- Check whether there are any stashes
871 -- Check whether there are any stashes
872+ when checkClean $ do
646− stashOutput <- readGitProcess thunkDir ["stash", "list"]
873+ stashOutput <- readGitProcess thunkDir ["stash", "list"]
647− when checkClean $ case T.null stashOutput of
874+ unless (T.null stashOutput) $
648− False -> do
649 failWith $ T.unlines $
875 failWith $ T.unlines $
650 [ "thunk pack: thunk checkout has stashes"
876 [ "thunk pack: thunk checkout has stashes"
651 , "git stash list:"
877 , "git stash list:"
652 ] ++ T.lines stashOutput
878 ] ++ T.lines stashOutput
653− True -> return ()
654
879
655− -- Get current branch ``
880+ -- Get current branch
656 (mCurrentBranch, mCurrentCommit) <- do
881 (mCurrentBranch, mCurrentCommit) <- do
657− b <- listToMaybe
658− <$> T.lines
659− <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
882+ b <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
660− c <- listToMaybe
661− <$> T.lines
662− <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
883+ c <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
663 case b of
884 case b of
664− (Just "HEAD") -> failWith $ T.unlines $
885+ (Just "HEAD") -> failWith $ T.unlines
665 [ "thunk pack: You are in 'detached HEAD' state."
886 [ "thunk pack: You are in 'detached HEAD' state."
666 , "If you want to pack at the current ref \
887 , "If you want to pack at the current ref \
667 \then please create a new branch with 'git checkout -b <new-branch-name>' and push this upstream."
888 \then please create a new branch with 'git checkout -b <new-branch-name>' and push this upstream."
@@ -670,7 +891,7 @@ getThunkPtr checkClean thunkDir = do
670
891
671 -- Get information on all branches and their (optional) designated upstream
892 -- Get information on all branches and their (optional) designated upstream
672 -- correspondents
893 -- correspondents
673− (headDump :: [Text]) <- T.lines <$> readGitProcess thunkDir
894+ headDump :: [Text] <- T.lines <$> readGitProcess thunkDir
674 [ "for-each-ref"
895 [ "for-each-ref"
675 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
896 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
676 , "refs/heads/"
897 , "refs/heads/"
@@ -716,7 +937,7 @@ getThunkPtr checkClean thunkDir = do
716 ]
937 ]
717
938
718 -- loosely by https://stackoverflow.com/questions/7773939/show-git-ahead-and-behind-info-for-all-branches-including-remotes
939 -- loosely by https://stackoverflow.com/questions/7773939/show-git-ahead-and-behind-info-for-all-branches-including-remotes
719− stats <- iforM headUpstream $ \branch (upstream, _remote) -> do
940+ stats <- ifor headUpstream $ \branch (upstream, _remote) -> do
720 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
941 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
721 [ "rev-list", "--left-right"
942 [ "rev-list", "--left-right"
722 , T.unpack branch <> "..." <> T.unpack upstream
943 , T.unpack branch <> "..." <> T.unpack upstream
@@ -733,15 +954,16 @@ getThunkPtr checkClean thunkDir = do
733 [ "thunk pack: Certain branches in the thunk have commits not yet pushed upstream:"
954 [ "thunk pack: Certain branches in the thunk have commits not yet pushed upstream:"
734 , ""
955 , ""
735 ] ++
956 ] ++
736− (flip map (Map.toList nonGood) $ \(branch, (upstream, (ahead, behind))) -> mconcat
957+ flip map (Map.toList nonGood) (\(branch, (upstream, (ahead, behind))) -> mconcat
737 [" ", branch, " ahead: ", T.pack (show ahead), " behind: ", T.pack (show behind), " remote branch ", upstream]) ++
958 [" ", branch, " ahead: ", T.pack (show ahead), " behind: ", T.pack (show behind), " remote branch ", upstream]) ++
738 [ ""
959 [ ""
739 , "Please push these upstream and try again. (Or just fetch, if they are somehow \
960 , "Please push these upstream and try again. (Or just fetch, if they are somehow \
740 \pushed but this repo's remote tracking branches don't know it.)"
961 \pushed but this repo's remote tracking branches don't know it.)"
741 ]
962 ]
742
963
964+ when checkClean $ do
743− -- We assume it's safe to pack the thunk at this point
965+ -- We assume it's safe to pack the thunk at this point
744− putLog Informational $ "All changes safe in git remotes. OK to pack thunk."
966+ putLog Informational "All changes safe in git remotes. OK to pack thunk."
745
967
746 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
968 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
747
969
@@ -754,14 +976,12 @@ getThunkPtr checkClean thunkDir = do
754 remoteUri <- case parseGitUri remoteUri' of
976 remoteUri <- case parseGitUri remoteUri' of
755 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
977 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
756 Just uri -> pure uri
978 Just uri -> pure uri
757− uriThunkPtr remoteUri mCurrentBranch mCurrentCommit
979+ uriThunkPtr remoteUri mPrivate mCurrentBranch mCurrentCommit
758
980
759-- | Get the latest revision available from the given source
981-- | Get the latest revision available from the given source
760getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
982getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
761getLatestRev os = do
983getLatestRev os = do
762− let gitS = case os of
984+ let gitS = thunkSourceToGitSource os
763− ThunkSource_GitHub s -> forgetGithub False s
764− ThunkSource_Git s -> s
765 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
985 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
766 case os of
986 case os of
767 ThunkSource_GitHub s -> githubThunkRev s commit
987 ThunkSource_GitHub s -> githubThunkRev s commit
@@ -773,18 +993,18 @@ getLatestRev os = do
773-- performance. If that doesn't work (e.g. authentication issue), we fall back
993-- performance. If that doesn't work (e.g. authentication issue), we fall back
774-- on just doing things the normal way for git repos in general, and save it as
994-- on just doing things the normal way for git repos in general, and save it as
775-- a regular git thunk.
995-- a regular git thunk.
776−uriThunkPtr :: MonadObelisk m => URI -> Maybe Text -> Maybe Text -> m ThunkPtr
996+uriThunkPtr :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr
777−uriThunkPtr uri mbranch mcommit = do
997+uriThunkPtr uri mPrivate mbranch mcommit = do
778 commit <- case mcommit of
998 commit <- case mcommit of
779 Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
999 Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
780 (Just c) -> return c
1000 (Just c) -> return c
781− (src, rev) <- case uriToThunkSource uri mbranch of
1001+ (src, rev) <- uriToThunkSource uri mPrivate mbranch >>= \case
782 ThunkSource_GitHub s -> do
1002 ThunkSource_GitHub s -> do
783 rev <- runExceptT $ githubThunkRev s commit
1003 rev <- runExceptT $ githubThunkRev s commit
784 case rev of
1004 case rev of
785 Right r -> pure (ThunkSource_GitHub s, r)
1005 Right r -> pure (ThunkSource_GitHub s, r)
786 Left e -> do
1006 Left e -> do
787− putLog Warning $ "\
1007+ putLog Warning "\
788\Failed to fetch archive from GitHub. This is probably a private repo. \
1008\Failed to fetch archive from GitHub. This is probably a private repo. \
789\Falling back on normal fetchgit. Original failure:"
1009\Falling back on normal fetchgit. Original failure:"
790 errorToWarning e
1010 errorToWarning e
@@ -801,34 +1021,66 @@ uriThunkPtr uri mbranch mcommit = do
801-- If the thunk is a GitHub thunk and fails, we do *not* fall back like with
1021-- If the thunk is a GitHub thunk and fails, we do *not* fall back like with
802-- `uriThunkPtr`. Unlike a plain URL, a thunk src explicitly states which method
1022-- `uriThunkPtr`. Unlike a plain URL, a thunk src explicitly states which method
803-- should be employed, and so we respect that.
1023-- should be employed, and so we respect that.
804−uriToThunkSource :: URI -> Maybe Text -> ThunkSource
1024+uriToThunkSource :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> m ThunkSource
805−uriToThunkSource u
1025+uriToThunkSource (GitUri u) mPrivate
806− | Right uriAuth <- uriAuthority u
1026+ | Right uriAuth <- URI.uriAuthority u
807− , Just scheme <- unRText <$> uriScheme u
1027+ , Just scheme <- URI.unRText <$> URI.uriScheme u
808 , case scheme of
1028 , case scheme of
809− "ssh" -> uriAuth == Authority
1029+ "ssh" -> uriAuth == URI.Authority
810− { authUserInfo = Just $ UserInfo (fromRight' $ mkUsername "git") Nothing
1030+ { URI.authUserInfo = Just $ URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
811− , authHost = fromRight' $ mkHost "github.com"
1031+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
812− , authPort = Nothing
1032+ , URI.authPort = Nothing
813 }
1033 }
814 s -> s `L.elem` [ "git", "https", "http" ] -- "http:" just redirects to "https:"
1034 s -> s `L.elem` [ "git", "https", "http" ] -- "http:" just redirects to "https:"
815− && unRText (authHost uriAuth) == "github.com"
1035+ && URI.unRText (URI.authHost uriAuth) == "github.com"
816− , Just (_, owner :| [repoish]) <- uriPath u
1036+ , Just (_, owner :| [repoish]) <- URI.uriPath u
1037+ = \mbranch -> do
1038+ isPrivate <- getIsPrivate
817− = \mbranch -> ThunkSource_GitHub $ GitHubSource
1039+ pure $ ThunkSource_GitHub $ GitHubSource
818− { _gitHubSource_owner = N $ unRText owner
1040+ { _gitHubSource_owner = N $ URI.unRText owner
819− , _gitHubSource_repo = N $ let
1041+ , _gitHubSource_repo = N $ let
820− repoish' = unRText repoish
1042+ repoish' = URI.unRText repoish
821− in case T.stripSuffix ".git" repoish' of
1043+ in fromMaybe repoish' $ T.stripSuffix ".git" repoish'
822− Just repo -> repo
823− Nothing -> repoish'
824− , _gitHubSource_branch = N <$> mbranch
1044+ , _gitHubSource_branch = N <$> mbranch
1045+ , _gitHubSource_private = isPrivate
825− }
1046+ }
826
1047
1048+ | otherwise = \mbranch -> do
1049+ isPrivate <- getIsPrivate
827− | otherwise = \mbranch -> ThunkSource_Git $ GitSource
1050+ pure $ ThunkSource_Git $ GitSource
828− { _gitSource_url = u
1051+ { _gitSource_url = GitUri u
829− , _gitSource_branch = N <$> mbranch
1052+ , _gitSource_branch = N <$> mbranch
830− , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
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
831− }
1083+ }
832
1084
833-- Funny signature indicates no effects depend on the optional branch name.
1085-- Funny signature indicates no effects depend on the optional branch name.
834githubThunkRev
1086githubThunkRev
@@ -840,19 +1092,19 @@ githubThunkRev
840githubThunkRev s commit = do
1092githubThunkRev s commit = do
841 owner <- forcePP $ _gitHubSource_owner s
1093 owner <- forcePP $ _gitHubSource_owner s
842 repo <- forcePP $ _gitHubSource_repo s
1094 repo <- forcePP $ _gitHubSource_repo s
843− revTarball <- mkPathPiece $ commit <> ".tar.gz"
1095+ revTarball <- URI.mkPathPiece $ commit <> ".tar.gz"
844− let archiveUri = URI
1096+ let archiveUri = GitUri $ URI.URI
845− { uriScheme = Just $ fromRight' $ mkScheme "https"
1097+ { URI.uriScheme = Just $ fromRight' $ URI.mkScheme "https"
846− , uriAuthority = Right $ Authority
1098+ , URI.uriAuthority = Right $ URI.Authority
847− { authUserInfo = Nothing
1099+ { URI.authUserInfo = Nothing
848− , authHost = fromRight' $ mkHost "github.com"
1100+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
849− , authPort = Nothing
1101+ , URI.authPort = Nothing
850 }
1102 }
851− , uriPath = Just ( False
1103+ , URI.uriPath = Just ( False
852− , owner :| [ repo, fromRight' $ mkPathPiece "archive", revTarball ]
1104+ , owner :| [ repo, fromRight' $ URI.mkPathPiece "archive", revTarball ]
853 )
1105 )
854− , uriQuery = []
1106+ , URI.uriQuery = []
855− , uriFragment = Nothing
1107+ , URI.uriFragment = Nothing
856 }
1108 }
857 hash <- getNixSha256ForUriUnpacked archiveUri
1109 hash <- getNixSha256ForUriUnpacked archiveUri
858 putLog Debug $ "Nix sha256 is " <> hash
1110 putLog Debug $ "Nix sha256 is " <> hash
@@ -861,8 +1113,8 @@ githubThunkRev s commit = do
861 , _thunkRev_nixSha256 = hash
1113 , _thunkRev_nixSha256 = hash
862 }
1114 }
863 where
1115 where
864− forcePP :: Name entity -> m (RText 'PathPiece)
1116+ forcePP :: Name entity -> m (URI.RText 'URI.PathPiece)
865− forcePP = mkPathPiece . untagName
1117+ forcePP = URI.mkPathPiece . untagName
866
1118
867gitThunkRev
1119gitThunkRev
868 :: MonadObelisk m
1120 :: MonadObelisk m
@@ -871,11 +1123,11 @@ gitThunkRev
871 -> m ThunkRev
1123 -> m ThunkRev
872gitThunkRev s commit = do
1124gitThunkRev s commit = do
873 let u = _gitSource_url s
1125 let u = _gitSource_url s
874− protocols = ["https", "ssh", "git"]
1126+ protocols = ["file", "https", "ssh", "git"]
875− Just scheme <- pure $ unRText <$> uriScheme u
1127+ scheme = maybe "file" URI.unRText $ URI.uriScheme $ (\(GitUri x) -> x) u
876 unless (T.toLower scheme `elem` protocols) $
1128 unless (T.toLower scheme `elem` protocols) $
877 failWith $ "obelisk currently only supports "
1129 failWith $ "obelisk currently only supports "
878− <> T.intercalate ", " protocols <> " protocols for non-GitHub remotes"
1130+ <> T.intercalate ", " protocols <> " protocols for plain Git remotes"
879 hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
1131 hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
880 putLog Informational $ "Nix sha256 is " <> hash
1132 putLog Informational $ "Nix sha256 is " <> hash
881 pure $ ThunkRev
1133 pure $ ThunkRev
@@ -888,11 +1140,12 @@ gitThunkRev s commit = do
888--
1140--
889-- If the branch name is passed in, it is returned exactly as-is. If it is not
1141-- If the branch name is passed in, it is returned exactly as-is. If it is not
890-- passed it, the default branch of the repo is used instead.
1142-- passed it, the default branch of the repo is used instead.
1143+
891gitGetCommitBranch
1144gitGetCommitBranch
892− :: MonadObelisk m => URI -> Maybe Text -> m (Text, CommitId)
1145+ :: MonadObelisk m => GitUri -> Maybe Text -> m (Text, CommitId)
893gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
1146gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
894 (_, bothMaps) <- gitLsRemote
1147 (_, bothMaps) <- gitLsRemote
895− (T.unpack $ render uri)
1148+ (T.unpack $ gitUriToText uri)
896 (GitRef_Branch <$> mbranch)
1149 (GitRef_Branch <$> mbranch)
897 Nothing
1150 Nothing
898 branch <- case mbranch of
1151 branch <- case mbranch of
@@ -908,18 +1161,21 @@ gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote "
908 pure (branch, commit)
1161 pure (branch, commit)
909 where
1162 where
910 rethrowE = either failWith pure
1163 rethrowE = either failWith pure
911− uriMsg = render uri
1164+ uriMsg = gitUriToText uri
1165+
1166+parseGitUri :: Text -> Maybe GitUri
1167+parseGitUri x = GitUri <$> (parseFileURI x <|> parseAbsoluteURI x <|> parseSshShorthand x)
912
1168
913−parseGitUri :: Text -> Maybe URI
1169+parseFileURI :: Text -> Maybe URI.URI
914−parseGitUri x = parseAbsoluteURI x <|> parseSshShorthand x
1170+parseFileURI uri = if "/" `T.isPrefixOf` uri then parseAbsoluteURI ("file://" <> uri) else Nothing
915
1171
916−parseAbsoluteURI :: Text -> Maybe URI
1172+parseAbsoluteURI :: Text -> Maybe URI.URI
917parseAbsoluteURI uri = do
1173parseAbsoluteURI uri = do
918− parsedUri <- mkURI uri
1174+ parsedUri <- URI.mkURI uri
919− guard $ isPathAbsolute parsedUri
1175+ guard $ URI.isPathAbsolute parsedUri
920− pure $ parsedUri
1176+ pure parsedUri
921
1177
922−parseSshShorthand :: Text -> Maybe URI
1178+parseSshShorthand :: Text -> Maybe URI.URI
923parseSshShorthand uri = do
1179parseSshShorthand uri = do
924 -- This is what git does to check that the remote
1180 -- This is what git does to check that the remote
925 -- is not a local file path when parsing shorthand.
1181 -- is not a local file path when parsing shorthand.
@@ -932,4 +1188,4 @@ parseSshShorthand uri = do
932 -- This check is used to disambiguate a filepath containing a colon from shorthand
1188 -- This check is used to disambiguate a filepath containing a colon from shorthand
933 guard $ isNothing (T.findIndex (=='/') authAndHostname)
1189 guard $ isNothing (T.findIndex (=='/') authAndHostname)
934 && not (T.null colonAndPath)
1190 && not (T.null colonAndPath)
935− mkURI properUri
1191+ URI.mkURI properUri
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+59−19
@@ -4,34 +4,63 @@
4{-# LANGUAGE ScopedTypeVariables #-}
4{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE OverloadedStrings #-}
5{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE PatternGuards #-}
6{-# LANGUAGE PatternGuards #-}
7+{-# LANGUAGE TemplateHaskell #-}
7module Obelisk.Command.Utils where
8module Obelisk.Command.Utils where
8
9
9import Control.Applicative hiding (many)
10import Control.Applicative hiding (many)
10import Control.Monad.Except
11import Control.Monad.Except
11import Data.Bool (bool)
12import Data.Bool (bool)
12−import qualified Text.Megaparsec.Char.Lexer as ML
13import Data.Bifunctor
13import Data.Bifunctor
14import Data.Char
14import Data.Char
15import Data.Either
15import Data.Either
16−import Data.Semigroup ((<>))
16+import Data.List (isInfixOf)
17import Data.Map (Map)
17import Data.Map (Map)
18import qualified Data.Map as M
18import qualified Data.Map as M
19import Data.Maybe (maybeToList)
19import Data.Maybe (maybeToList)
20+import Data.Semigroup ((<>))
20import Data.Text (Text)
21import Data.Text (Text)
21import qualified Data.Text as T
22import qualified Data.Text as T
22import Data.Void (Void)
23import Data.Void (Void)
23−import System.Directory (canonicalizePath)
24−import System.Environment (getExecutablePath)
25import System.Exit (ExitCode)
24import System.Exit (ExitCode)
26−import qualified System.Process as P
25+import System.Which (staticWhich)
26+import qualified Text.Megaparsec.Char.Lexer as ML
27import Text.Megaparsec as MP
27import Text.Megaparsec as MP
28import Text.Megaparsec.Char as MP
28import Text.Megaparsec.Char as MP
29
29
30import Obelisk.App (MonadObelisk)
30import Obelisk.App (MonadObelisk)
31import Obelisk.CliApp
31import Obelisk.CliApp
32
32
33−getObeliskExe :: IO FilePath
33+cp :: FilePath
34−getObeliskExe = getExecutablePath >>= canonicalizePath
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+
35
64
36-- Check whether the working directory is clean
65-- Check whether the working directory is clean
37checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
66checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
@@ -61,20 +90,31 @@ initGit repo = do
61 git ["add", "."]
90 git ["add", "."]
62 git ["commit", "-m", "Initial commit."]
91 git ["commit", "-m", "Initial commit."]
63
92
64−gitProcNoRepo :: [String] -> P.CreateProcess
93+gitProcNoRepo :: [String] -> ProcessSpec
65−gitProcNoRepo = P.proc "git"
94+gitProcNoRepo args = setEnvOverride (M.singleton "GIT_TERMINAL_PROMPT" "0" <>) $ proc "git" args
66
95
67−gitProc :: FilePath -> [String] -> P.CreateProcess
96+gitProc :: FilePath -> [String] -> ProcessSpec
68gitProc repo = gitProcNoRepo . runGitInDir
97gitProc repo = gitProcNoRepo . runGitInDir
69 where
98 where
70 runGitInDir args' = case filter (not . null) args' of
99 runGitInDir args' = case filter (not . null) args' of
71 args@("clone":_) -> args <> [repo]
100 args@("clone":_) -> args <> [repo]
72 args -> ["-C", repo] <> args
101 args -> ["-C", repo] <> args
73
102
103+isolateGitProc :: ProcessSpec -> ProcessSpec
104+isolateGitProc = setEnvOverride (overrides <>)
105+ where
106+ overrides = M.fromList
107+ [ ("HOME", "/dev/null")
108+ , ("GIT_CONFIG_NOSYSTEM", "1")
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")
112+ ]
113+
74−-- | Recursively copy a directory using `cp -a`
114+-- | Recursively copy a directory using `cp -a` -- TODO: Should use -rT instead of -a
75−copyDir :: FilePath -> FilePath -> P.CreateProcess
115+copyDir :: FilePath -> FilePath -> ProcessSpec
76copyDir src dest =
116copyDir src dest =
77− (P.proc "cp" ["-a", ".", dest]) { P.cwd = Just src }
117+ setCwd (Just src) $ proc cp ["-a", ".", dest] -- TODO: This will break if dest is relative since we change cwd
78
118
79readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
119readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
80readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
120readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
@@ -87,15 +127,15 @@ processToShellString cmd args = unwords $ map quoteAndEscape (cmd : args)
87 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
127 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
88
128
89-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
129-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
90−runProc :: MonadObelisk m => P.CreateProcess -> m ()
130+runProc :: MonadObelisk m => ProcessSpec -> m ()
91runProc = callProcessAndLogOutput (Notice, Error)
131runProc = callProcessAndLogOutput (Notice, Error)
92
132
93-- | Like runProc, but all output goes to Debug logging level
133-- | Like runProc, but all output goes to Debug logging level
94−runProcSilently :: MonadObelisk m => P.CreateProcess -> m ()
134+runProcSilently :: MonadObelisk m => ProcessSpec -> m ()
95runProcSilently = callProcessAndLogOutput (Debug, Debug)
135runProcSilently = callProcessAndLogOutput (Debug, Debug)
96
136
97-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
137-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
98−readProc :: MonadObelisk m => P.CreateProcess -> m Text
138+readProc :: MonadObelisk m => ProcessSpec -> m Text
99readProc = readProcessAndLogOutput (Debug, Error)
139readProc = readProcessAndLogOutput (Debug, Error)
100
140
101tshow :: Show a => a -> Text
141tshow :: Show a => a -> Text
@@ -129,13 +169,13 @@ gitLsRemote repository mRef mBranch = do
129 (exitCode, out, _err) <- case mBranch of
169 (exitCode, out, _err) <- case mBranch of
130 Nothing -> readCreateProcessWithExitCode $ gitProcNoRepo $
170 Nothing -> readCreateProcessWithExitCode $ gitProcNoRepo $
131 ["ls-remote", "--exit-code", "--symref", repository]
171 ["ls-remote", "--exit-code", "--symref", repository]
132− ++ (maybeToList $ T.unpack . showGitRef <$> mRef)
172+ ++ maybeToList (T.unpack . showGitRef <$> mRef)
133− Just branchName -> readCreateProcessWithExitCode $ gitProcNoRepo $
173+ Just branchName -> readCreateProcessWithExitCode $ gitProcNoRepo
134 ["ls-remote", "--exit-code", repository, branchName]
174 ["ls-remote", "--exit-code", repository, branchName]
135 let t = T.pack out
175 let t = T.pack out
136 maps <- case MP.runParser parseLsRemote "" t of
176 maps <- case MP.runParser parseLsRemote "" t of
137 Left err -> failWith $ T.pack $ MP.errorBundlePretty err
177 Left err -> failWith $ T.pack $ MP.errorBundlePretty err
138− Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers $ table
178+ Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers table
139 putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
179 putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
140 pure (exitCode, maps)
180 pure (exitCode, maps)
141
181
lib/command/src/Obelisk/Command/VmBuilder.hs+2−2
@@ -18,10 +18,10 @@ import System.Directory (createDirectoryIfMissing)
18import System.Exit (ExitCode(..))
18import System.Exit (ExitCode(..))
19import System.FilePath ((<.>), (</>))
19import System.FilePath ((<.>), (</>))
20import qualified System.Info
20import qualified System.Info
21−import System.Process (proc)
22
21
23import Obelisk.App (MonadObelisk, getObeliskUserStateDir)
22import Obelisk.App (MonadObelisk, getObeliskUserStateDir)
24import Obelisk.CliApp
23import Obelisk.CliApp
24+import Obelisk.Command.Utils (rmPath)
25
25
26-- | Generate the `--builders` argument string to enable the VM builder after ensuring it is available.
26-- | Generate the `--builders` argument string to enable the VM builder after ensuring it is available.
27getNixBuildersArg :: MonadObelisk m => m String
27getNixBuildersArg :: MonadObelisk m => m String
@@ -96,7 +96,7 @@ setupNixDocker stateDir = withSpinner ("Creating Docker container named " <> con
96
96
97 -- Create new SSH keys for this container
97 -- Create new SSH keys for this container
98 callProcessAndLogOutput (Debug, Error) $
98 callProcessAndLogOutput (Debug, Error) $
99− proc "rm" ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
99+ proc rmPath ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
100 callProcessAndLogOutput (Debug, Error) $
100 callProcessAndLogOutput (Debug, Error) $
101 proc "ssh-keygen" ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
101 proc "ssh-keygen" ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
102
102
lib/executable-config/default.nix+25−18
@@ -2,26 +2,33 @@
2# configuration information into a canonical location. It also provides a haskell
2# configuration information into a canonical location. It also provides a haskell
3# package that can be used to retrieve the injected configuration on each supported
3# package that can be used to retrieve the injected configuration on each supported
4# platform.
4# platform.
5−{ nixpkgs
5+{ lib
6−, filterGitSource # TODO define this in obelisk
6+, runCommand
7+, obeliskCleanSource
7}:
8}:
9+
10+let
8−let injectConfig = config: assets: nixpkgs.runCommand "inject-config" {} (''
11+ injectConfig = config: assets: runCommand "inject-config" {} (''
9− set -x
12+ set -x
10− mkdir -p $out
13+ mkdir -p $out
11− cp --no-preserve=mode -Lr "${assets}" $out/static
14+ cp --no-preserve=mode -Lr "${assets}" $out/static
12− chmod +w "$out"
15+ chmod +w "$out"
13− '' + nixpkgs.lib.optionalString (!(builtins.isNull config)) ''
16+ '' + lib.optionalString (!(builtins.isNull config)) ''
14− if ! mkdir $out/config; then
17+ if ! mkdir $out/config; then
15− 2>&1 echo config directory already exists or could not be created
18+ 2>&1 echo config directory already exists or could not be created
16− exit 1
19+ exit 1
17− fi
20+ fi
18− cp -a "${config}"/* "$out/config"
21+ cp -a "${config}"/* "$out/config"
22+ # Needed for android deployments
19− find "$out/config" -type f -printf '%P\0' >"$out/config.files"
23+ find "$out/config" -type f -printf '%P\0' > "$out/config.files"
20− '');
24+ '');
21−in with nixpkgs.haskell.lib; {
25+in
26+
27+{
22 haskellOverlay = self: super: {
28 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) {};
24 };
30 };
31+
25 platforms = {
32 platforms = {
26 android = {
33 android = {
27 # Inject the given config directory into an android assets folder
34 # Inject the given config directory into an android assets folder
@@ -32,7 +39,7 @@ in with nixpkgs.haskell.lib; {
32 inject = injectConfig;
39 inject = injectConfig;
33 };
40 };
34 web = {
41 web = {
35− inject = self: self.callCabal2nix "obelisk-executable-config-inject" (filterGitSource ./inject) {};
42+ inject = self: self.callCabal2nix "obelisk-executable-config-inject" (obeliskCleanSource ./inject) {};
36 };
43 };
37 };
44 };
38}
45}
lib/executable-config/lookup/src-other/Obelisk/ExecutableConfig/Lookup.hs+1−8
@@ -1,18 +1,11 @@
1−{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE OverloadedStrings #-}
1{-# LANGUAGE OverloadedStrings #-}
3module Obelisk.ExecutableConfig.Lookup where
2module Obelisk.ExecutableConfig.Lookup where
4
3
5import Data.Map (Map)
4import Data.Map (Map)
6−import qualified Data.Map as Map
7import Data.Text (Text)
5import Data.Text (Text)
8−import qualified Data.Text as T
9import Data.ByteString (ByteString)
6import Data.ByteString (ByteString)
10−import qualified Data.ByteString as BS
11−import System.Directory
12−import System.FilePath
13−import Control.Monad
14
7
15−import Obelisk.Configs.Internal.Directory
8+import Obelisk.Configs.Internal.Directory (getConfigsFromDirectory)
16
9
17getConfigs :: IO (Map Text ByteString)
10getConfigs :: IO (Map Text ByteString)
18getConfigs = getConfigsFromDirectory "config"
11getConfigs = getConfigsFromDirectory "config"
lib/frontend/src/Obelisk/Frontend.hs+8−8
@@ -5,6 +5,7 @@
5{-# LANGUAGE LambdaCase #-}
5{-# LANGUAGE LambdaCase #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE PackageImports #-}
8{-# LANGUAGE RankNTypes #-}
9{-# LANGUAGE RankNTypes #-}
9{-# LANGUAGE RecursiveDo #-}
10{-# LANGUAGE RecursiveDo #-}
10{-# LANGUAGE ScopedTypeVariables #-}
11{-# LANGUAGE ScopedTypeVariables #-}
@@ -19,6 +20,7 @@ module Obelisk.Frontend
19 , renderFrontendHtml
20 , renderFrontendHtml
20 , removeHTMLConfigs
21 , removeHTMLConfigs
21 , FrontendMode (..)
22 , FrontendMode (..)
23+ , FrontendWidgetT
22 , module Obelisk.Frontend.Cookie
24 , module Obelisk.Frontend.Cookie
23 ) where
25 ) where
24
26
@@ -45,7 +47,7 @@ import qualified GHCJS.DOM.History as DOM
45import qualified GHCJS.DOM.Window as DOM
47import qualified GHCJS.DOM.Window as DOM
46import Language.Javascript.JSaddle (MonadJSM, JSM, jsNull)
48import Language.Javascript.JSaddle (MonadJSM, JSM, jsNull)
47import GHCJS.DOM (currentDocument)
49import GHCJS.DOM (currentDocument)
48−import GHCJS.DOM.Document (getHead)
50+import "ghcjs-dom" GHCJS.DOM.Document (getHead)
49import GHCJS.DOM.Node (Node, removeChild_)
51import GHCJS.DOM.Node (Node, removeChild_)
50import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
52import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
51import GHCJS.DOM.ParentNode (querySelectorAll)
53import GHCJS.DOM.ParentNode (querySelectorAll)
@@ -197,7 +199,6 @@ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = d
197 , PrimMonad m
199 , PrimMonad m
198 , MonadSample DomTimeline (Performable m)
200 , MonadSample DomTimeline (Performable m)
199 , DOM.MonadJSM m
201 , DOM.MonadJSM m
200− , Monad (Performable (Client (HydrationDomBuilderT s DomTimeline m)))
201 , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
202 , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
202 , MonadFix (Performable m)
203 , MonadFix (Performable m)
203 , MonadFix m
204 , MonadFix m
@@ -226,18 +227,17 @@ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = d
226 then runHydrationWidgetWithHeadAndBody (pure ()) w
227 then runHydrationWidgetWithHeadAndBody (pure ()) w
227 else runImmediateWidgetWithHeadAndBody w
228 else runImmediateWidgetWithHeadAndBody w
228
229
230+type FrontendWidgetT r = RoutedT DomTimeline r (SetRouteT DomTimeline r (RouteToUrlT r (ConfigsT (CookiesT (HydratableT (PostBuildT DomTimeline (StaticDomBuilderT DomTimeline (PerformEventT DomTimeline DomHost))))))))
231+
229renderFrontendHtml
232renderFrontendHtml
230− :: ( t ~ DomTimeline
231− , MonadIO m
233+ :: MonadIO m
232− , widget ~ RoutedT t r (SetRouteT t r (RouteToUrlT r (ConfigsT (CookiesT (HydratableT (PostBuildT t (StaticDomBuilderT t (PerformEventT t DomHost))))))))
233− )
234 => Map Text ByteString
234 => Map Text ByteString
235 -> Cookies
235 -> Cookies
236 -> (r -> Text)
236 -> (r -> Text)
237 -> r
237 -> r
238 -> Frontend r
238 -> Frontend r
239− -> widget ()
239+ -> FrontendWidgetT r ()
240− -> widget ()
240+ -> FrontendWidgetT r ()
241 -> m ByteString
241 -> m ByteString
242renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
242renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
243 --TODO: We should probably have a "NullEventWriterT" or a frozen reflex timeline
243 --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 @@
6{-# LANGUAGE FlexibleInstances #-}
6{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE GeneralizedNewtypeDeriving #-}
7{-# LANGUAGE GeneralizedNewtypeDeriving #-}
8{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE MultiParamTypeClasses #-}
9+{-# LANGUAGE PackageImports #-}
9{-# LANGUAGE RankNTypes #-}
10{-# LANGUAGE RankNTypes #-}
10{-# LANGUAGE TypeFamilies #-}
11{-# LANGUAGE TypeFamilies #-}
11{-# LANGUAGE UndecidableInstances #-}
12{-# LANGUAGE UndecidableInstances #-}
@@ -22,7 +23,7 @@ import Data.Text.Encoding (encodeUtf8)
22import Reflex
23import Reflex
23import Reflex.Host.Class
24import Reflex.Host.Class
24import Reflex.Dom.Core
25import Reflex.Dom.Core
25−import GHCJS.DOM.Document (getCookie, Document)
26+import "ghcjs-dom" GHCJS.DOM.Document (getCookie, Document)
26import GHCJS.DOM.Types (MonadJSM)
27import GHCJS.DOM.Types (MonadJSM)
27import Web.Cookie
28import Web.Cookie
28
29
lib/route/src/Obelisk/Route.hs+18−9
@@ -20,10 +20,11 @@
20{-# LANGUAGE ViewPatterns #-}
20{-# LANGUAGE ViewPatterns #-}
21module Obelisk.Route
21module Obelisk.Route
22 ( R
22 ( R
23− , pattern (:/)
24 , (:.)
23 , (:.)
25− , pattern (:.)
24+ , (?/)
26 , hoistR
25 , hoistR
26+ , pattern (:.)
27+ , pattern (:/)
27 , PageName
28 , PageName
28 , PathQuery
29 , PathQuery
29 , Encoder
30 , Encoder
@@ -49,6 +50,7 @@ module Obelisk.Route
49 , pathParamEncoder
50 , pathParamEncoder
50 , pathLiteralEncoder
51 , pathLiteralEncoder
51 , singletonListEncoder
52 , singletonListEncoder
53+ , packTextEncoder
52 , unpackTextEncoder
54 , unpackTextEncoder
53 , prefixTextEncoder
55 , prefixTextEncoder
54 , unsafeTshowEncoder
56 , unsafeTshowEncoder
@@ -160,6 +162,7 @@ import Data.Set (Set)
160import qualified Data.Set as Set
162import qualified Data.Set as Set
161import Data.Some (Some(Some))
163import Data.Some (Some(Some))
162import Data.Text (Text)
164import Data.Text (Text)
165+import Data.Text.Lens (IsText, packed, unpacked)
163import qualified Data.Text as T
166import qualified Data.Text as T
164import qualified Data.Text.Encoding as T
167import qualified Data.Text.Encoding as T
165import Data.Universe
168import Data.Universe
@@ -196,10 +199,16 @@ import Data.Aeson (FromJSON, ToJSON)
196
199
197type R f = DSum f Identity --TODO: Better name
200type R f = DSum f Identity --TODO: Better name
198
201
199−{-# COMPLETE (:/) #-}
202+-- | Convenience builder for an 'R' using 'Identity' for the functor.
200−infixr 5 :/
201pattern (:/) :: f a -> a -> R f
203pattern (:/) :: f a -> a -> R f
202pattern a :/ b = a :=> Identity b
204pattern a :/ b = a :=> Identity b
205+{-# COMPLETE (:/) #-}
206+infixr 5 :/
207+
208+-- | Like '(:/)' but adds a 'Just' wrapper around the right-hand side.
209+(?/) :: f (Maybe a) -> a -> R f
210+r ?/ a = r :/ Just a
211+infixr 5 ?/
203
212
204mapSome :: (forall a. f a -> g a) -> Some f -> Some g
213mapSome :: (forall a. f a -> g a) -> Some f -> Some g
205mapSome f (Some a) = Some $ f a
214mapSome f (Some a) = Some $ f a
@@ -756,11 +765,11 @@ prefixNonemptyTextEncoder p = Encoder $ pure $ EncoderImpl
756 Just stripped -> pure stripped
765 Just stripped -> pure stripped
757 }
766 }
758
767
759−unpackTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse Text String
768+packTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse String text
760−unpackTextEncoder = Encoder $ pure $ EncoderImpl
769+packTextEncoder = isoEncoder packed
761− { _encoderImpl_encode = T.unpack
770+
762− , _encoderImpl_decode = pure . T.pack
771+unpackTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse text String
763− }
772+unpackTextEncoder = isoEncoder unpacked
764
773
765toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
774toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
766toListMapEncoder = Encoder $ pure $ EncoderImpl
775toListMapEncoder = Encoder $ pure $ EncoderImpl
lib/route/src/Obelisk/Route/Frontend.hs+80−16
@@ -7,15 +7,11 @@
7{-# LANGUAGE FlexibleContexts #-}
7{-# LANGUAGE FlexibleContexts #-}
8{-# LANGUAGE FlexibleInstances #-}
8{-# LANGUAGE FlexibleInstances #-}
9{-# LANGUAGE GADTs #-}
9{-# LANGUAGE GADTs #-}
10−{-# LANGUAGE KindSignatures #-}
11{-# LANGUAGE LambdaCase #-}
10{-# LANGUAGE LambdaCase #-}
12−{-# LANGUAGE MultiParamTypeClasses #-}
13{-# LANGUAGE OverloadedStrings #-}
11{-# LANGUAGE OverloadedStrings #-}
14{-# LANGUAGE PatternSynonyms #-}
12{-# LANGUAGE PatternSynonyms #-}
15{-# LANGUAGE RankNTypes #-}
13{-# LANGUAGE RankNTypes #-}
16{-# LANGUAGE ScopedTypeVariables #-}
14{-# LANGUAGE ScopedTypeVariables #-}
17−{-# LANGUAGE TemplateHaskell #-}
18−{-# LANGUAGE TupleSections #-}
19{-# LANGUAGE TypeFamilies #-}
15{-# LANGUAGE TypeFamilies #-}
20{-# LANGUAGE TypeOperators #-}
16{-# LANGUAGE TypeOperators #-}
21{-# LANGUAGE ViewPatterns #-}
17{-# LANGUAGE ViewPatterns #-}
@@ -64,7 +60,7 @@ import Prelude hiding ((.), id)
64import Obelisk.Route
60import Obelisk.Route
65
61
66import Control.Category (Category (..), (.))
62import Control.Category (Category (..), (.))
67−import Control.Category.Cartesian
63+import Control.Category.Cartesian ((&&&))
68import Control.Lens hiding (Bifunctor, bimap, universe, element)
64import Control.Lens hiding (Bifunctor, bimap, universe, element)
69import Control.Monad ((<=<))
65import Control.Monad ((<=<))
70import Control.Monad.Fix
66import Control.Monad.Fix
@@ -94,7 +90,9 @@ import Reflex.Dom.Builder.Class
94import Data.Type.Coercion
90import Data.Type.Coercion
95import Language.Javascript.JSaddle --TODO: Get rid of this - other platforms can also be routed
91import Language.Javascript.JSaddle --TODO: Get rid of this - other platforms can also be routed
96import Reflex.Dom.Core
92import Reflex.Dom.Core
93+import qualified GHCJS.DOM as DOM
97import qualified GHCJS.DOM.Types as DOM
94import qualified GHCJS.DOM.Types as DOM
95+import qualified GHCJS.DOM.Window as Window
98import Network.URI
96import Network.URI
99import Data.Maybe (fromMaybe)
97import Data.Maybe (fromMaybe)
100import qualified Data.List as L
98import qualified Data.List as L
@@ -511,59 +509,125 @@ runRouteViewT routeEncoder switchover useHash a = do
511-- | A link widget that, when clicked, sets the route to the provided route. In non-javascript
509-- | A link widget that, when clicked, sets the route to the provided route. In non-javascript
512-- contexts, this widget falls back to using @href@s to control navigation
510-- contexts, this widget falls back to using @href@s to control navigation
513routeLink
511routeLink
514− :: forall t m a route.
512+ :: forall t m a route js.
515 ( DomBuilder t m
513 ( DomBuilder t m
516 , RouteToUrl route m
514 , RouteToUrl route m
517 , SetRoute t route m
515 , SetRoute t route m
516+ , Prerender js t m
518 )
517 )
519 => route -- ^ Target route
518 => route -- ^ Target route
520 -> m a -- ^ Child widget
519 -> m a -- ^ Child widget
521 -> m a
520 -> m a
522routeLink r w = do
521routeLink 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
523 enc <- askRouteToUrl
537 enc <- askRouteToUrl
524 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
538 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
525 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
539 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
526 & elementConfig_initialAttributes .~ "href" =: enc r
540 & elementConfig_initialAttributes .~ "href" =: enc r
527 (e, a) <- element "a" cfg w
541 (e, a) <- element "a" cfg w
528 setRoute $ r <$ domEvent Click e
542 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
530
549
531-- | Like 'routeLinkDynAttr' but without custom attributes.
550-- | Like 'routeLinkDynAttr' but without custom attributes.
532dynRouteLink
551dynRouteLink
533− :: forall t m a route.
552+ :: forall t m a route js.
534 ( DomBuilder t m
553 ( DomBuilder t m
535 , PostBuild t m
554 , PostBuild t m
536− , RouteToUrl (R route) m
555+ , RouteToUrl route m
537− , SetRoute t (R route) m
556+ , SetRoute t route m
557+ , Prerender js t m
538 )
558 )
539− => Dynamic t (R route) -- ^ Target route
559+ => Dynamic t route -- ^ Target route
540− -> m a -- ^ Child widget of the @a@ element
560+ -> m a -- ^ Child widget
541 -> m a
561 -> 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)
543
588
544-- | An @a@-tag link widget that, when clicked, sets the route to current value of the
589-- | An @a@-tag link widget that, when clicked, sets the route to current value of the
545-- provided dynamic route. In non-JavaScript contexts the value of the dynamic post
590-- provided dynamic route. In non-JavaScript contexts the value of the dynamic post
546-- build is used so the link still works like 'routeLink'.
591-- build is used so the link still works like 'routeLink'.
547routeLinkDynAttr
592routeLinkDynAttr
548− :: forall t m a route.
593+ :: forall t m a route js.
549 ( DomBuilder t m
594 ( DomBuilder t m
550 , PostBuild t m
595 , PostBuild t m
551 , RouteToUrl (R route) m
596 , RouteToUrl (R route) m
552 , SetRoute t (R route) m
597 , SetRoute t (R route) m
598+ , Prerender js t m
553 )
599 )
554 => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
600 => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
555 -> Dynamic t (R route) -- ^ Target route
601 -> Dynamic t (R route) -- ^ Target route
556 -> m a -- ^ Child widget of the @a@ element
602 -> m a -- ^ Child widget of the @a@ element
557 -> m a
603 -> m a
558routeLinkDynAttr dAttr dr w = do
604routeLinkDynAttr 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
559 enc <- askRouteToUrl
622 enc <- askRouteToUrl
560 er <- dynamicAttributesToModifyAttributes $ zipDynWith (<>) (("href" =:) . enc <$> dr) dAttr
623 er <- dynamicAttributesToModifyAttributes $ zipDynWith (<>) (("href" =:) . enc <$> dr) dAttr
561 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
624 let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
562 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
625 & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
563 & elementConfig_modifyAttributes .~ er
626 & elementConfig_modifyAttributes .~ er
564 (e, a) <- element "a" cfg w
627 (e, a) <- element "a" cfg w
628+ let clk = domEvent Click e
565− setRoute $ tag (current dr) $ domEvent Click e
629+ setRoute $ tag (current dr) clk
566− return a
630+ return (clk, a)
567
631
568-- On ios due to sandboxing when loading the page from a file adapt the
632-- On ios due to sandboxing when loading the page from a file adapt the
569-- path to be based on the hash.
633-- path to be based on the hash.
lib/run/src/Obelisk/Run.hs+12−7
@@ -79,7 +79,7 @@ import qualified System.Which
79run
79run
80 :: Int -- ^ Port to run the backend
80 :: Int -- ^ Port to run the backend
81 -> ([Text] -> Snap ()) -- ^ Static asset handler
81 -> ([Text] -> Snap ()) -- ^ Static asset handler
82− -> Backend fullRoute frontendRoute -- ^ Backend
82+ -> Backend backendRoute frontendRoute -- ^ Backend
83 -> Frontend (R frontendRoute) -- ^ Frontend
83 -> Frontend (R frontendRoute) -- ^ Frontend
84 -> IO ()
84 -> IO ()
85run port serveStaticAsset backend frontend = do
85run port serveStaticAsset backend frontend = do
@@ -90,14 +90,18 @@ run port serveStaticAsset backend frontend = do
90 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
90 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
91 Right validFullEncoder -> do
91 Right validFullEncoder -> do
92 publicConfigs <- getPublicConfigs
92 publicConfigs <- getPublicConfigs
93− backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $ do
93+ backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $
94− _backend_run backend $ \serveRoute -> do
94+ _backend_run backend $ \serveRoute ->
95− runSnapWithCommandLineArgs $ do
95+ runSnapWithCommandLineArgs $
96 getRouteWith validFullEncoder >>= \case
96 getRouteWith validFullEncoder >>= \case
97 Identity r -> case r of
97 Identity r -> case r of
98 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
98 FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
99 FullRoute_Frontend obeliskRoute :/ a ->
99 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+
101 let conf = defRunConfig { _runConfig_redirectPort = port }
105 let conf = defRunConfig { _runConfig_redirectPort = port }
102 runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
106 runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
103
107
@@ -129,7 +133,7 @@ runWidget conf configs frontend validFullEncoder = do
129 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
133 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
130 settings = setBeforeMainLoop beforeMainLoop (setPort port (setTimeout 3600 defaultSettings))
134 settings = setBeforeMainLoop beforeMainLoop (setPort port (setTimeout 3600 defaultSettings))
131 -- Providing TLS here will also incidentally provide it to proxied requests to the backend.
135 -- Providing TLS here will also incidentally provide it to proxied requests to the backend.
132− prepareRunner = case (uri ^? uriScheme . _Just . unRText) of
136+ prepareRunner = case uri ^? uriScheme . _Just . unRText of
133 Just "https" -> do
137 Just "https" -> do
134 -- Generate a private key and self-signed certificate for TLS
138 -- Generate a private key and self-signed certificate for TLS
135 privateKey <- RSA.generateRSAKey' 2048 3
139 privateKey <- RSA.generateRSAKey' 2048 3
@@ -189,7 +193,8 @@ obeliskApp configs opts frontend validFullEncoder uri backend = do
189 }
193 }
190 FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
194 FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
191 let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
195 let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
196+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
192− html <- renderJsaddleFrontend configs cookies (mkRouteToUrl validFullEncoder) (appRouteComponent :/ appRouteRest) frontend
197+ html <- renderJsaddleFrontend configs cookies routeToUrl (appRouteComponent :/ appRouteRest) frontend
193 sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
198 sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
194 _ -> backend req sendResponse
199 _ -> backend req sendResponse
195
200
lib/selftest/obelisk-selftest.cabal+6−3
@@ -9,18 +9,21 @@ library
9 hs-source-dirs: src
9 hs-source-dirs: src
10 build-depends:
10 build-depends:
11 base
11 base
12+ , bytestring
13+ , aeson
12 , containers
14 , containers
13 , directory
15 , directory
16+ , filepath
14 , hspec
17 , hspec
15 , http-client
18 , http-client
16 , http-types
19 , http-types
17 , HUnit
20 , HUnit
18− , obelisk-cliapp
21+ , network
19 , obelisk-executable-config-lookup
22 , obelisk-executable-config-lookup
20 , obelisk-run
23 , obelisk-run
24+ , which
21 , process
25 , process
22− , network
23− , shelly
26+ , shelly >= 1.9.0
24 , temporary
27 , temporary
25 , text
28 , text
26 exposed-modules:
29 exposed-modules:
lib/selftest/src/Obelisk/SelfTest.hs+473−197
@@ -1,38 +1,48 @@
1+{-# LANGUAGE DoAndIfThenElse #-}
1{-# LANGUAGE EmptyCase #-}
2{-# LANGUAGE EmptyCase #-}
2{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE PatternGuards #-}
5{-# LANGUAGE PatternGuards #-}
5{-# LANGUAGE ScopedTypeVariables #-}
6{-# LANGUAGE ScopedTypeVariables #-}
7+{-# LANGUAGE TemplateHaskell #-}
8+{-# LANGUAGE TypeApplications #-}
9+{-# LANGUAGE ViewPatterns #-}
6module Obelisk.SelfTest where
10module Obelisk.SelfTest where
7
11
12+import Control.Concurrent (threadDelay)
8−import Control.Exception (bracket, throw)
13+import Control.Exception (bracket, throw, try)
9import Control.Monad
14import Control.Monad
10import Control.Monad.IO.Class
15import Control.Monad.IO.Class
16+import qualified Data.Aeson as Aeson
17+import qualified Data.Aeson.Types as Aeson
11import Data.Bool (bool)
18import Data.Bool (bool)
19+import qualified Data.ByteString.Lazy as LBS
20+import Data.Foldable (for_)
12import Data.Function (fix)
21import Data.Function (fix)
13−import Data.Semigroup (Semigroup, (<>))
22+import qualified Data.Map as Map
23+import Data.Semigroup ((<>))
14import qualified Data.Set as Set
24import qualified Data.Set as Set
15import Data.String
25import Data.String
16import Data.Text (Text)
26import Data.Text (Text)
17−import Data.Void
18import qualified Data.Text as T
27import qualified Data.Text as T
28+import qualified Data.Text.Encoding as T
19import qualified Data.Text.IO as T
29import qualified Data.Text.IO as T
20import qualified Network.HTTP.Client as HTTP
30import qualified Network.HTTP.Client as HTTP
21import qualified Network.HTTP.Types as HTTP
31import qualified Network.HTTP.Types as HTTP
22import qualified Network.Socket as Socket
32import qualified Network.Socket as Socket
23import Shelly
33import Shelly
24−import System.Directory (withCurrentDirectory, getDirectoryContents)
34+import System.Directory (getCurrentDirectory, withCurrentDirectory, getDirectoryContents)
25import System.Environment
35import System.Environment
26import System.Exit (ExitCode (..))
36import System.Exit (ExitCode (..))
27−import System.Info
37+import System.FilePath (addTrailingPathSeparator)
38+import qualified System.Info
28−import System.IO (Handle, hClose)
39+import System.IO (Handle, hClose, hIsEOF, hGetContents)
29import System.IO.Temp
40import System.IO.Temp
30−import System.Process (readProcessWithExitCode, CreateProcess(cwd), readCreateProcessWithExitCode, proc)
41+import System.Process (readProcessWithExitCode)
42+import System.Which (staticWhich)
31import Test.Hspec
43import Test.Hspec
32import Test.HUnit.Base
44import Test.HUnit.Base
33
45
34−import Obelisk.CliApp hiding (runCli, readCreateProcessWithExitCode)
35−import qualified Obelisk.CliApp as CliApp
36import Obelisk.ExecutableConfig.Lookup (getConfigs)
46import Obelisk.ExecutableConfig.Lookup (getConfigs)
37import Obelisk.Run (getConfigRoute)
47import Obelisk.Run (getConfigRoute)
38
48
@@ -42,24 +52,53 @@ data ObRunState
42 | ObRunState_BackendStarted
52 | ObRunState_BackendStarted
43 deriving (Eq, Show)
53 deriving (Eq, Show)
44
54
45−doubleQuotes :: (IsString a, Semigroup a) => a -> a
55+cpPath :: FilePath
46−doubleQuotes s = "\"" <> s <> "\""
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"]
47
93
48commit :: Text -> Sh ()
94commit :: Text -> Sh ()
49−commit msg = void $ run "git"
95+commit msg = void $ run gitPath $ gitUserConfig <> [ "commit"
50− [ "commit"
51 , "--no-gpg-sign"
96 , "--no-gpg-sign"
52 , "--allow-empty"
97 , "--allow-empty"
53 , "-m"
98 , "-m"
54− , doubleQuotes msg
99+ , msg
55 ]
100 ]
56
101
57−-- TODO replace Void and stop using loosely typed synchronous exceptions
58−runCli :: MonadIO m => CliT Void IO a -> m a
59−runCli f = liftIO $ do
60− c <- newCliConfig Notice False False (\case {})
61− CliApp.runCli c f
62−
63tshow :: Show a => a -> Text
102tshow :: Show a => a -> Text
64tshow = T.pack . show
103tshow = T.pack . show
65
104
@@ -67,210 +106,322 @@ tshow = T.pack . show
67shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
106shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
68shellyOb f obTest = shelly $ f obTest
107shellyOb f obTest = shelly $ f obTest
69
108
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+
70main :: IO ()
145main :: IO ()
71main = do
146main = do
72 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
147 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
73 isVerbose <- elem "-v" <$> getArgs
148 isVerbose <- elem "-v" <$> getArgs
74 unless isVerbose $
149 unless isVerbose $
75 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
150 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
76− let verbosity = bool silently verbosely isVerbose
151+
77− nixBuild args = run "nix-build" ("--no-out-link" : args)
152+ obeliskImplDirtyReadOnly <- getCurrentDirectory
78− obeliskImpl <- fromString <$> getEnv "OBELISK_IMPL"
79 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
153 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
80− [p0, p1, p2, p3] <- liftIO $ getFreePorts 4
81− withSystemTempDirectory "initCache" $ \initCache -> do
82− -- Setup the ob init cache
83− void . shellyOb verbosity $ chdir (fromString initCache) $ do
84− run_ "ob" ["init"]
85− run_ "git" ["init"]
86− hspec $ parallel $ do
87− let shelly_ = void . shellyOb verbosity
88−
89− inTmp :: (Shelly.FilePath -> Sh a) -> IO ()
90− inTmp f = withTmp (chdir <*> f)
91−
92− withTmp f = shelly_ . withSystemTempDirectory "test" $ f . fromString
93−
94− inTmpObInit f = inTmp $ \dir -> do
95− run_ "cp" ["-a", fromString $ initCache <> "/.", toTextIgnore dir]
96− f dir
97−
98− assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
99− assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
100−
101− revParseHead = T.strip <$> run "git" ["rev-parse", "HEAD"]
102−
103− commitAll = do
104− run_ "git" ["add", "."]
105− commit "checkpoint"
106− revParseHead
107−
108− thunk = ".obelisk/impl"
109− update = run "ob" ["thunk", "update", thunk] >> commitAll
110− pack = run "ob" ["thunk", "pack", thunk] >> commitAll
111− unpack = run "ob" ["thunk", "unpack", thunk] >> commitAll
112−
113− diff a b = run "git" ["diff", a, b]
114−
115− describe "ob init" $ parallel $ do
116− it "works with default impl" $ inTmp $ \_ -> run "ob" ["init"]
117− it "works with master branch impl" $ inTmp $ \_ -> run "ob" ["init", "--branch", "master"]
118− it "works with symlink" $ inTmp $ \_ -> run "ob" ["init", "--symlink", obeliskImpl]
119− it "doesn't silently overwrite existing files" $ withSystemTempDirectory "ob-init" $ \dir -> do
120− let p force = (proc "ob" $ "--no-handoff" : "init" : ["--force"|force]) { cwd = Just dir }
121− (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p False) ""
122− (ExitFailure _, _, _) <- readCreateProcessWithExitCode (p False) ""
123− (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p True) ""
124− pure ()
125−
126− it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
127− void $ errExit False $ run "ob" ["init", "--symlink", "/dev/null"]
128− ls tmp >>= liftIO . assertEqual "" []
129−
130− it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $
131− withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ do
132− configs <- getConfigs
133− return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
134−
135− -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
136− -- when not run by 'nix-build --attr selftest'
137− describe "ob run" $ parallel $ do
138− it "works in root directory" $ inTmpObInit $ \_ -> testObRunInDir p0 p1 Nothing httpManager
139− it "works in sub directory" $ inTmpObInit $ \_ -> testObRunInDir p2 p3 (Just "frontend") httpManager
140−
141− describe "obelisk project" $ parallel $ do
142− it "can build obelisk command" $ inTmpObInit $ \_ -> nixBuild ["-A", "command" , obeliskImpl]
143− it "can build obelisk skeleton" $ inTmpObInit $ \_ -> nixBuild ["-A", "skeleton", obeliskImpl]
144− it "can build obelisk shell" $ inTmpObInit $ \_ -> nixBuild ["-A", "shell", obeliskImpl]
145− it "can build everything" $ inTmpObInit $ \_ -> nixBuild [obeliskImpl]
146−
147− describe "blank initialized project" $ parallel $ do
148−
149− it "can build ghc.backend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghc.backend"]
150− it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghcjs.frontend"]
151−
152− if os == "darwin"
153− then it "can build ios" $ inTmpObInit $ \_ -> nixBuild ["-A", "ios.frontend"]
154− else it "can build android after accepting license" $ inTmpObInit $ \dir -> do
155− let defaultNixPath = dir </> ("default.nix" :: Shelly.FilePath)
156− writefile defaultNixPath
157− =<< T.replace
158− "# config.android_sdk.accept_license = false;"
159− "config.android_sdk.accept_license = true;"
160− <$> readfile defaultNixPath
161− nixBuild ["-A", "android.frontend"]
162−
163− forM_ ["ghc", "ghcjs"] $ \compiler -> do
164− let
165− shell = "shells." <> compiler
166− inShell cmd' = run "nix-shell" ["default.nix", "-A", fromString shell, "--run", cmd']
167− it ("can enter " <> shell) $ inTmpObInit $ \_ -> inShell "exit"
168− it ("can build in " <> shell) $ inTmpObInit $ \_ -> inShell $ "cabal new-build --" <> fromString compiler <> " all"
169−
170− it "has idempotent thunk update" $ inTmpObInit $ \_ -> do
171− u <- update
172− uu <- update
173− assertRevEQ u uu
174−
175− describe "ob thunk pack/unpack" $ parallel $ do
176− it "has thunk pack and unpack inverses" $ inTmpObInit $ \_ -> do
177−
178− e <- commitAll
179− eu <- unpack
180− eup <- pack
181− eupu <- unpack
182− _ <- pack
183−
184− assertRevEQ e eup
185− assertRevEQ eu eupu
186− assertRevNE e eu
187−
188− it "unpacks the correct branch" $ withTmp $ \dir -> do
189− let branch = "master"
190− run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
191− run_ "ob" ["thunk", "pack", toTextIgnore dir]
192− run_ "ob" ["thunk", "unpack", toTextIgnore dir]
193− branch' <- chdir dir $ run "git" ["rev-parse", "--abbrev-ref", "HEAD"]
194− liftIO $ assertEqual "" branch (T.strip branch')
195−
196− it "can pack and unpack plain git repos" $
197− shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
198− let repo = toTextIgnore $ dir </> ("repo" :: String)
199− run_ "git" ["clone", "https://github.com/haskell/process.git", repo]
200− origHash <- chdir (fromText repo) revParseHead
201−
202− run_ "ob" ["thunk", "pack", repo]
203− packedFiles <- Set.fromList <$> ls (fromText repo)
204− liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
205− ["default.nix", "github.json", ".attr-cache" :: String]
206−
207− run_ "ob" ["thunk", "unpack", repo]
208− chdir (fromText repo) $ do
209− unpackHash <- revParseHead
210− assertRevEQ origHash unpackHash
211−
212− testThunkPack $ fromText repo
213−
214− it "aborts thunk pack when there are uncommitted files" $ inTmpObInit $ \dir -> do
215− void unpack
216− testThunkPack (dir </> thunk)
217−
218− describe "ob thunk update --branch" $ parallel $ do
219− it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
220− let branch1 = "master"
221− branch2 = "develop"
222− run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
223− run_ "ob" ["thunk" , "pack", toTextIgnore dir]
224− run_ "ob" ["thunk", "update", toTextIgnore dir, "--branch", branch2]
225−
226− it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
227− let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
228− run_ "git" ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
229− run_ "ob" ["thunk" , "pack", toTextIgnore dir]
230− startingContents <- checkDir dir
231− void $ errExit False $ run "ob" ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
232− checkDir dir >>= liftIO . assertEqual "" startingContents
233
154
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 []
332+
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)
234
381
235-- | Run `ob run` in the given directory (maximum of one level deep)
382-- | Run `ob run` in the given directory (maximum of one level deep)
236−testObRunInDir :: Socket.PortNumber -> Socket.PortNumber -> Maybe Shelly.FilePath -> HTTP.Manager -> Sh ()
383+testObRunInDir :: String -> [Text] -> Maybe FilePath -> HTTP.Manager -> Sh ()
237−testObRunInDir p0 p1 mdir httpManager = handle_sh (\case ExitSuccess -> pure (); e -> throw e) $ do
384+testObRunInDir executable extraArgs mdir httpManager = maskExitSuccess $ do
385+ [p0, p1] <- liftIO $ getFreePorts 2
238 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
386 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
239 writefile "config/common/route" $ uri p0
387 writefile "config/common/route" $ uri p0
240− maybe id chdir mdir $ runHandle "ob" ["run"] $ \stdout -> do
388+ maybe id chdir mdir $ runHandles executable extraArgs [] $ \_stdin stdout stderr -> do
241− firstUri <- handleObRunStdout httpManager stdout
389+ firstUri <- handleObRunStdout httpManager stdout stderr
242 let newUri = uri p1
390 let newUri = uri p1
243 when (firstUri == newUri) $ errorExit $
391 when (firstUri == newUri) $ errorExit $
244 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
392 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
245 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
393 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
246− runningUri <- handleObRunStdout httpManager stdout
394+ runningUri <- handleObRunStdout httpManager stdout stderr
247 if runningUri /= newUri
395 if runningUri /= newUri
248 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
396 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
249 else exit 0
397 else exit 0
250
398
251−testThunkPack :: Shelly.FilePath -> Sh ()
399+testThunkPack :: String -> [Text] -> FilePath -> Sh ()
252−testThunkPack path' = withTempFile (T.unpack $ toTextIgnore path') "test-file" $ \file handle -> do
400+testThunkPack executable args path' = withTempFile repoDir "test-file" $ \file handle -> do
401+ let
253− let pack' = readProcessWithExitCode "ob" ["thunk", "pack", T.unpack $ toTextIgnore path'] ""
402+ pack' = readProcessWithExitCode executable (["thunk", "pack", path'] ++ map T.unpack args) ""
254− ensureThunkPackFails q = liftIO $ pack' >>= \case
403+ ensureThunkPackFails q = liftIO $ pack' >>= \case
255− (code, out, err)
404+ (code, out, err)
256− | code == ExitSuccess -> fail "ob thunk pack succeeded when it should have failed"
405+ | code == ExitSuccess -> fail $ "ob thunk pack succeeded when it should have failed with error '" <> show q <> "'"
257− | q `T.isInfixOf` T.pack (out <> err) -> pure ()
406+ | q `T.isInfixOf` T.pack (out <> err) -> pure ()
258− | otherwise -> fail $ "ob thunk pack failed for an unexpected reason: " <> show out <> "\nstderr: " <> err
407+ | otherwise -> fail $ "ob thunk pack failed for an unexpected reason, expecting '" <> show q <> "', received: " <> show out <> "\nstderr: " <> err
259− git = chdir path' . run "git"
408+ git = chdir repoDir . run_ gitPath
260 -- Untracked files
409 -- Untracked files
261 ensureThunkPackFails "Untracked files"
410 ensureThunkPackFails "Untracked files"
262− void $ git ["add", T.pack file]
411+ git ["add", T.pack file]
263 -- Uncommitted files (staged)
412 -- Uncommitted files (staged)
264 ensureThunkPackFails "unsaved"
413 ensureThunkPackFails "unsaved"
265− chdir path' $ commit "test commit"
414+ chdir repoDir $ commit "test commit"
266 -- Non-pushed commits in any branch
415 -- Non-pushed commits in any branch
267 ensureThunkPackFails "not yet pushed"
416 ensureThunkPackFails "not yet pushed"
268 -- Uncommitted files (unstaged)
417 -- Uncommitted files (unstaged)
269 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
418 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
270 ensureThunkPackFails "modified"
419 ensureThunkPackFails "modified"
271 -- Existing stashes
420 -- Existing stashes
272− void $ git ["stash"]
421+ git $ gitUserConfig <> [ "stash" ]
273 ensureThunkPackFails "has stashes"
422 ensureThunkPackFails "has stashes"
423+ where
424+ repoDir = path' </> unpackedDirName
274
425
275-- | Blocks until a non-empty line is available
426-- | Blocks until a non-empty line is available
276hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
427hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
@@ -290,9 +441,12 @@ alterRouteTo uri stdout = do
290 "Reloading failed: " <> T.pack (show t)
441 "Reloading failed: " <> T.pack (show t)
291
442
292-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
443-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
293−handleObRunStdout :: HTTP.Manager -> Handle -> Sh Text
444+handleObRunStdout :: HTTP.Manager -> Handle -> Handle -> Sh Text
294−handleObRunStdout httpManager stdout = flip fix (ObRunState_Init, []) $ \loop (state, msgs) ->
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
295− liftIO (T.hGetLine stdout) >>= \t -> case state of
449+ else liftIO (T.hGetLine stdout) >>= \t -> case state of
296 ObRunState_Init
450 ObRunState_Init
297 | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
451 | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
298 ObRunState_Startup
452 ObRunState_Startup
@@ -304,8 +458,12 @@ handleObRunStdout httpManager stdout = flip fix (ObRunState_Init, []) $ \loop (s
304 obRunCheck httpManager stdout uri
458 obRunCheck httpManager stdout uri
305 pure uri
459 pure uri
306 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
460 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
307− _ | "Failed" `T.isPrefixOf` t -> errorExit $ "ob run failed: " <> T.unlines (reverse $ t : msgs)
461+ _ | "Failed" `T.isPrefixOf` t -> handleObRunError (t : msgs)
308 | otherwise -> loop (state, t : msgs)
462 | 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
309
467
310-- | Make requests to frontend/backend servers to check they are working properly
468-- | Make requests to frontend/backend servers to check they are working properly
311obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
469obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
@@ -324,3 +482,121 @@ getFreePorts n = Socket.withSocketsDo $ do
324 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
482 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
325 Socket.bind sock (Socket.addrAddress addr)
483 Socket.bind sock (Socket.addrAddress addr)
326 pure sock
484 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 @@
1name: obelisk-snap-extras
1name: obelisk-snap-extras
2version: 0.1
2version: 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
4license: BSD3
4license: BSD3
5build-type: Simple
5build-type: Simple
6cabal-version: >=1.2
6cabal-version: >=1.2
lib/snap-extras/src/Obelisk/Snap/Extras.hs+1−1
@@ -2,13 +2,13 @@
2module Obelisk.Snap.Extras
2module Obelisk.Snap.Extras
3 ( cachePermanently
3 ( cachePermanently
4 , doNotCache
4 , doNotCache
5+ , ensureSecure
5 , serveFileIfExists
6 , serveFileIfExists
6 , serveFileIfExistsAs
7 , serveFileIfExistsAs
7 ) where
8 ) where
8
9
9import Control.Monad.IO.Class
10import Control.Monad.IO.Class
10import Data.ByteString (ByteString)
11import Data.ByteString (ByteString)
11−import Data.Monoid
12import Data.String
12import Data.String
13import Snap.Core
13import Snap.Core
14import Snap.Util.FileServe
14import Snap.Util.FileServe
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 ? {
1+{
2− config.android_sdk.accept_license = true;
2+ supportedSystems ? [ "x86_64-linux" "x86_64-darwin" ]
3− iosSdkVersion = "10.2";
4− }
5−, local-self ? import ./. self-args
6}:
3}:
4+rec {
5+ recurseForDerivations = true;
6+ build = import ./all-builds.nix { inherit supportedSystems; };
7+ test = import ./all-tests.nix { inherit supportedSystems; };
7
8
8−let
9+ inherit (build) metaCache;
9− inherit (local-self.nixpkgs) lib runCommand nix;
10+}
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; }
skeleton/.gitignore+2
@@ -1,7 +1,9 @@
1dist-newstyle
1dist-newstyle
2result
2result
3+result-*
3result-android
4result-android
4result-ios
5result-ios
5result-exe
6result-exe
6.attr-cache
7.attr-cache
7ghcid-output.txt
8ghcid-output.txt
9+profile/
skeleton/backend/src/Backend.hs−3
@@ -1,6 +1,3 @@
1−{-# LANGUAGE FlexibleContexts #-}
2−{-# LANGUAGE RankNTypes #-}
3−{-# LANGUAGE TypeFamilies #-}
4module Backend where
1module Backend where
5
2
6import Common.Route
3import Common.Route
skeleton/common/common.cabal−3
@@ -9,9 +9,6 @@ library
9 , obelisk-route
9 , obelisk-route
10 , mtl
10 , mtl
11 , text
11 , text
12− default-extensions:
13− TypeFamilies
14− PolyKinds
15 exposed-modules:
12 exposed-modules:
16 Common.Api
13 Common.Api
17 Common.Route
14 Common.Route
skeleton/common/src/Common/Route.hs+1
@@ -8,6 +8,7 @@
8{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE OverloadedStrings #-}
9{-# LANGUAGE RankNTypes #-}
9{-# LANGUAGE RankNTypes #-}
10{-# LANGUAGE TemplateHaskell #-}
10{-# LANGUAGE TemplateHaskell #-}
11+{-# LANGUAGE TypeFamilies #-}
11module Common.Route where
12module Common.Route where
12
13
13{- -- You will probably want these imports for composing Encoders.
14{- -- You will probably want these imports for composing Encoders.
skeleton/frontend/frontend.cabal+1
@@ -9,6 +9,7 @@ library
9 , common
9 , common
10 , obelisk-frontend
10 , obelisk-frontend
11 , obelisk-route
11 , obelisk-route
12+ , jsaddle
12 , reflex-dom
13 , reflex-dom
13 , obelisk-executable-config-lookup
14 , obelisk-executable-config-lookup
14 , obelisk-generated-static
15 , obelisk-generated-static
skeleton/frontend/src/Frontend.hs+21−3
@@ -1,25 +1,43 @@
1{-# LANGUAGE DataKinds #-}
1{-# LANGUAGE DataKinds #-}
2{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE TypeApplications #-}
3{-# LANGUAGE TypeApplications #-}
4+
4module Frontend where
5module Frontend where
5
6
7+import Control.Monad
6import qualified Data.Text as T
8import qualified Data.Text as T
7import qualified Data.Text.Encoding as T
9import qualified Data.Text.Encoding as T
10+import Language.Javascript.JSaddle (eval, liftJSM)
11+
8import Obelisk.Frontend
12import Obelisk.Frontend
9import Obelisk.Configs
13import Obelisk.Configs
10import Obelisk.Route
14import Obelisk.Route
15+import Obelisk.Generated.Static
16+
11import Reflex.Dom.Core
17import Reflex.Dom.Core
12
18
13import Common.Api
19import Common.Api
14import Common.Route
20import Common.Route
15−import Obelisk.Generated.Static
16
21
22+
23+-- This runs in a monad that can be run on the client or the server.
24+-- To run code in a pure client or pure server context, use one of the
25+-- `prerender` functions.
17frontend :: Frontend (R FrontendRoute)
26frontend :: Frontend (R FrontendRoute)
18frontend = Frontend
27frontend = Frontend
28+ { _frontend_head = do
19− { _frontend_head = el "title" $ text "Obelisk Minimal Example"
29+ el "title" $ text "Obelisk Minimal Example"
30+ elAttr "link" ("href" =: static @"main.css" <> "type" =: "text/css" <> "rel" =: "stylesheet") blank
20 , _frontend_body = do
31 , _frontend_body = do
21− text "Welcome to Obelisk!"
32+ el "h1" $ text "Welcome to Obelisk!"
22 el "p" $ text $ T.pack commonStuff
33 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+
23 elAttr "img" ("src" =: static @"obelisk.jpg") blank
41 elAttr "img" ("src" =: static @"obelisk.jpg") blank
24 el "div" $ do
42 el "div" $ do
25 exampleConfig <- getConfig "common/example"
43 exampleConfig <- getConfig "common/example"
skeleton/static/main.cssnew file+3
@@ -0,0 +1,3 @@
1+p {
2+ color: red;
3+}