on master help sign in
.github/pull_request_template.mdnew file+10
since splitsnapshots
unifiedsplit
@@ -0,0 +1,10 @@
1+<!-- Provide a clear overview of your changes. -->
2+
3+I have:
4+
5+ - [ ] Based work on latest `develop` branch
6+ - [ ] Followed the [contribution guide](https://github.com/obsidiansystems/obelisk/blob/develop/CONTRIBUTING.md#submitting-changes)
7+ - [ ] Looked for lint in my changes with `hlint .` (lint found code you did not write can be left alone)
8+ - [ ] Run the test suite: `$(nix-build -A selftest --no-out-link)`
9+ - [ ] [Updated the changelog](https://github.com/obsidiansystems/obelisk/blob/develop/CONTRIBUTING.md#in-the-changelog)
10+ - [ ] (Optional) Run CI tests locally: `nix-build release.nix -A build.x86_64-linux --no-out-link` (or `x86_64-darwin` on macOS)
.gitignore+2−3
@@ -2,14 +2,13 @@
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
7−
8TAGS
8TAGS
9tags
9tags
10ctags
10ctags
11dist-newstyle
11dist-newstyle
12cabal.project.local
12cabal.project.local
13.ghc.environment.*
13.ghc.environment.*
14−
15−**/ghcid-output.txt
14+**/ghcid-output.txt
.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
CONTRIBUTING.md+125−3
@@ -1,9 +1,131 @@
1−## Contributing to Obelisk
1+# Contribution Guide
2
2
3−Thanks for taking the time to contribute!
3+Contributions and issue reports are encouraged and appreciated!
4
4
5−Before submitting a pull request, please run the tests:
5+- [Opening Issues](#opening-issues)
6+- [Submitting Changes](#submitting-changes)
7+ - [Guidelines for Commit Messages](#guidelines-for-commit-messages)
8+ - [Guidelines for Pull Requests](#guidelines-for-pull-requests)
9+ - [Code Quality](#code-quality)
10+ - [Documentation](#documentation)
11+- [Development Environment](#development-environment)
6
12
13+## Opening Issues
14+
15+Before opening an issue, please check whether your issue has already been reported. Assuming it has not:
16+
17+* Describe the issue you're encountering or the suggestion you're making
18+* Include any relevant steps to reproduce or code samples you can. It's always easier for us to debug if we have something that demonstrates the error.
19+* Let us know what version of this project you were using. If you're using a github checkout, provide the git hash.
20+
21+## Submitting Changes
22+
23+Most pull requests should target the `develop` branch. `master` is the release branch. `develop` is periodically merged into master after a period of testing.
24+
25+### Guidelines for Commit Messages
26+
27+#### Summary Line
28+The summary line of your commit message should summarize the changes being made. Commit messages should be written in the imperative mood and should describe what happens when the commit is applied. If your commit modifies one of the in-tree haskell packages (found in `./lib`), please prefix your commit summary with the name of the package being modified.
29+
30+One way to think about it is that your commit message should be able to complete the sentence:
31+"When applied, this commit will..."
32+
33+##### Note on bumping dependencies
34+Commits that update a dependency should include some information about why the dependency was updated in the commit message.
35+
36+#### Body
37+For breaking changes, new features, refactors, or other major changes, the body of the commit message should describe the motivation behind the change in greater detail and may include references to the issue tracker. The body shouldn't repeat code/comments from the diff.
38+
39+### Guidelines for Pull Requests
40+
41+Wherever possible, pull requests should add a single feature or fix a single bug. Pull requests should not bundle several unrelated changes.
42+
43+
44+### Code Quality
45+
46+#### Warnings
47+
48+Your pull request should add no new warnings to the project. It should also generally not disable any warnings.
49+
50+#### Build and Test
51+
52+Make sure the project builds and that the tests pass! This will generally also be checked by CI before merge, but trying it yourself first means you'll catch problems earlier and your contribution can be merged that much sooner!
53+
54+You can run the tests like this:
7```bash
55```bash
8$(nix-build -A selftest --no-out-link)
56$(nix-build -A selftest --no-out-link)
9```
57```
58+
59+To test that your changes build across platforms, you can also try to build release.nix, like this:
60+```bash
61+nix-build release.nix
62+```
63+
64+Note, however, that to build release.nix you must accept the android license agreement and your machine must be configured to build both ios and android executables (usually via remote builders).
65+
66+
67+### Documentation
68+
69+#### In the code
70+We're always striving to improve documentation. Please include [haddock](https://haskell-haddock.readthedocs.io/en/latest/index.html) documentation for any added code, and update the documentation for any code you modify.
71+
72+#### In the [Changelog](ChangeLog.md)
73+Add an entry to the changelog when your PR:
74+* Adds a feature
75+* Deprecates something
76+* Includes a breaking change
77+* Makes any other change that will impact users
78+
79+#### In the [Readme](README.md)
80+The readme is the first place a lot of people look for information about the repository. Update any parts of the readme that are affected by your PR.
81+
82+
83+## Development Environment
84+
85+There are two ways to get live compiler feedback while developing Obelisk libraries. For libraries that are dependencies of the `skeleton` application, the easiest way to get feedback is to
86+
87+```bash
88+cd skeleton
89+ob run
90+```
91+
92+This `ob run` session only loads modules that are dependencies of the skeleton and `obelisk-run`. For example, `obelisk-asset` and `obelisk-route` are used by the skeleton.
93+
94+For other libraries like `obelisk-command` you can use `ghcid`. To launch `ghcid` for `lib/command` you can run
95+
96+```bash
97+nix-shell -A obeliskEnvs.obelisk-command --run "cd lib/command && ghcid"
98+```
99+
100+### Building `ob` for testing
101+
102+To re-install `ob` from source globally you can do
103+
104+```bash
105+nix-env -f /path/to/obelisk -iA command
106+```
107+
108+You can also open a shell with the local version of `ob` available on your `$PATH`:
109+
110+```bash
111+nix run -f /path/to/obelisk command
112+```
113+
114+### Hacking on Obelisk from within an Obelisk project
115+
116+`ob` will defer to the version found in your project's `.obelisk/impl` directory. To work on that version specifically:
117+
118+```bash
119+ob thunk unpack ./.obelisk/impl
120+cd ./.obelisk/impl
121+# apply your changes
122+```
123+
124+If you want to commit your changes, first push them to your fork of obelisk and then
125+
126+```bash
127+cd /your/project/root
128+ob thunk pack .obelisk/impl
129+git add .obelisk/impl
130+git commit -m "Bump obelisk"
131+```
ChangeLog.mdnew file+156
@@ -0,0 +1,156 @@
1+# Revision history for obelisk
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.
4+
5+## v0.9.1.0
6+
7+* [#801](https://github.com/obsidiansystems/obelisk/pull/801): Remove errors and warning for local packages without a library component
8+* [#812](https://github.com/obsidiansystems/obelisk/pull/812): Add support for `NoImplicitPrelude` and other extensions disabled via `No`
9+* Pinned version bumps:
10+ * reflex-platform [0.7.0.0](https://github.com/reflex-frp/reflex-platform/releases/tag/v0.7.0.0)
11+ * hnix 0.8.0
12+* [#787](https://github.com/obsidiansystems/obelisk/pull/787): Set `immutable` cache control directive when serving content-addressed static assets
13+* Use iOS SDK 13.2
14+
15+
16+## v0.9.0.1
17+
18+* ([#810](https://github.com/obsidiansystems/obelisk/pull/810)) Fix loading of `all.js` in fully compiled web apps.
19+
20+## v0.9.0.0
21+
22+* **(Breaking change)** Backport nixpkgs upgrades to ACME/Let's Encrypt handling so that HTTPS deployments continue to work flawlessly. If your deployment is having trouble renewing [Let's Encrypt](https://letsencrypt.org/) certificates, upgrade to this version.
23+ * **IMPORTANT:** In order to use [Let's Encrypt](https://letsencrypt.org/) you must now accept their [terms of service](https://letsencrypt.org/repository/). To do that, add `terms.security.acme.acceptTerms = true;` to the `import ./.obelisk/impl {` section in your `default.nix`. The new skeleton application may serve as an [example](https://github.com/obsidiansystems/obelisk/blob/4759342ab3570888c027d4c58cb5694cb832d624/skeleton/default.nix#L13).
24+* Update reflex-platform dependency to v0.6.0.0
25+* ([#715](https://github.com/obsidiansystems/obelisk/pull/715)) In `Obelisk.Route` deprecate `isoEncoder` and `prismEncoder` in favor of more precisely named `viewEncoder` and `reviewEncoder` (respectively) and improve documentation regarding contravariance of `reviewEncoder`.
26+* ([#739](https://github.com/obsidiansystems/obelisk/pull/739)) Improve `ob shell` by allowing commands to be passed verbatim after a `--` argument. For example, `ob shell 'run command'` can now be written `ob shell -- run command`.
27+* ([#735](https://github.com/obsidiansystems/obelisk/pull/735)) Fix regression causing custom `Prelude`s to break `ob run`/`ob watch`/`ob repl`.
28+* ([#737](https://github.com/obsidiansystems/obelisk/pull/737)) Fix bug causing custom `Prelude`s to break `ob profile`.
29+* ([#752](https://github.com/obsidiansystems/obelisk/pull/752)) Fix the `ob` command-line tool to return non-zero exit code when underlying processes fail.
30+* ([#742](https://github.com/obsidiansystems/obelisk/pull/742), [#57](https://github.com/obsidiansystems/obelisk/pull/57), [#406](https://github.com/obsidiansystems/obelisk/pull/406)) Enable `-dedupe` and `-DGHCJS_BROWSER` in GHCJS builds to make JavaScript output considerably smaller leading to faster load/parse times and faster build times.
31+ * **Migration:** New Obelisk projects will automatically benefit from this change, but existing projects need to apply a change similar to [this one](https://github.com/obsidiansystems/obelisk/blob/371cb3302085601c5ec73e9574d51c8b95e3e493/skeleton/frontend/frontend.cabal#L32-L34).
32+* ([#742](https://github.com/obsidiansystems/obelisk/pull/742)) Update `reflex-platform` which includes:
33+ * A new version of GHCJS where `-dedupe` is fixed.
34+
35+## v0.8.0.0
36+
37+* ([#674](https://github.com/obsidiansystems/obelisk/pull/674), [#711](https://github.com/obsidiansystems/obelisk/pull/711)) Introduce a new thunk format to support accessing the thunk's source directly when packed. When packed, thunks have an additional file called `thunk.nix` and `default.nix` is now a thin wrapper around that.
38+* ([#665](https://github.com/obsidiansystems/obelisk/pull/665)) Add `--interpret` and `--no-interpret` options to `ob run`/`ob watch`/`ob repl`/`ob shell`. These options allow you to pick which paths will be pre-compiled by `nix` when entering the shell/session and which won't. For example `ob run --no-interpret dep` will ensure that any dependencies found in `./dep` will be built by `nix` before loading the rest of the project into the `ghci` session. The same configuration for `ob shell` will ensure that those packages are built and available in the `ghc` package database inside the shell.
39+
40+ **NOTE:** `ob shell`'s default behavior is now different. By default it now behaves like `ob run`/`ob watch`/`ob repl` in that it does *not* pre-build any packages whose `.cabal` or `package.yaml` files are found in the project. To regain the previous behavior, use `ob shell --no-interpret . --interpret backend --interpret common --interpret frontend` from the project root.
41+* ([#695](https://github.com/obsidiansystems/obelisk/pull/695)) `ob deploy init` now requires that your obelisk project be a clean `git` checkout with pushed changes. It has always required that your obelisk project be a `git` repository, but it did not require that your local changes be committed and pushed. This new requirement is added to ensure users don't accidentally create a deployment pointing to an old version of the project.
42+* ([#705](https://github.com/obsidiansystems/obelisk/pull/705)) Add `Obelisk.Route.packTextEncoder` and generalize `Obelisk.Route.unpackTextEncoder` over any `Data.Text.Lens.IsText`.
43+* ([#712](https://github.com/obsidiansystems/obelisk/pull/712)) Update [`reflex-platform`](https://github.com/reflex-frp/reflex-platform) to version 0.5.3.0.
44+* ([#700](https://github.com/obsidiansystems/obelisk/pull/700)) Ensure `ob init` uses the thunk format of the target obelisk rather than the one currently running the init command. If a user had installed a version of obelisk with a new thunk format, a newly initialized skeleton of an older version would not be able to unpack its own `.obelisk/impl`.
45+* ([#693](https://github.com/obsidiansystems/obelisk/pull/693)) Fix a bug where some packages in `.attr-cache` directories would be incorrectly picked up and used instead of the correct ones when using `ob run`/`ob watch`/`ob repl`.
46+* ([#709](https://github.com/obsidiansystems/obelisk/pull/709)) Fix a bug in obelisk's preprocessor causing it to incorrectly skip files in some circumstances.
47+* ([#663](https://github.com/obsidiansystems/obelisk/pull/663)) Add **experimental** support for [`ghcide`](https://github.com/digital-asset/ghcide). See the README for more information.
48+* ([#714](https://github.com/obsidiansystems/obelisk/pull/714)) Miscellaneous improvements to CLI help and logging.
49+
50+## v0.7.0.1
51+
52+* Fix the version number for `ob` the command-line tool. ([#679](https://github.com/obsidiansystems/obelisk/pull/679))
53+
54+## v0.7.0.0
55+
56+* Fully support HTTP [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range) requests on static assets to support Safari. ([#664](https://github.com/obsidiansystems/obelisk/pull/664))
57+* Support non-EC2 deployments. ([#658](https://github.com/obsidiansystems/obelisk/pull/658))
58+* Fix `ob deploy test android` to work. ([#645](https://github.com/obsidiansystems/obelisk/pull/645))
59+* Fix vulnerability where Android deployments would leave signing keys in the nix store which is world readable. ([#645](https://github.com/obsidiansystems/obelisk/pull/645)) (Thanks to [kmicklas](https://github.com/kmicklas) for the report.)
60+* Add `Obelisk.Backend.runBackendWith` to allow several customizations. ([#668](https://github.com/obsidiansystems/obelisk/pull/668), [#644](https://github.com/obsidiansystems/obelisk/pull/644))
61+* Add `ob profile` command to run Obelisk projects with profiling. `ob profile` works like `ob run`, but instead of using `ghci`, it builds an executable that is built with profiling enabled. ([#654](https://github.com/obsidiansystems/obelisk/pull/654))
62+* Obelisk's `default.nix` now exposes `mkAssets` function which is used to construct the assets served by an Obelisk application. ([#651](https://github.com/obsidiansystems/obelisk/pull/651))
63+* Bump reflex-platform to v0.5.2.0. ([#671](https://github.com/obsidiansystems/obelisk/pull/671))
64+
65+## v0.6.0.0 - 2020-02-21
66+
67+* Fix a bug in `Obelisk.Route.Frontend` where `routeLink`, `routeLinkDynAttr`, and `dynRouteLink` would not behave exactly like `<a href="...">` when run by JavaScript. These functions now scroll to the top of the page when the link is clicked. ([#540](https://github.com/obsidiansystems/obelisk/pull/540))
68+* Fix a bug in `ob run`/`ob watch`/`ob repl` where nested Obelisk projects would also be loaded into the session. These are now ignored. ([#652](https://github.com/obsidiansystems/obelisk/pull/652))
69+* Improve behavior of `ob run`/`ob watch`/`ob repl` when multiple packages with the same name are encountered. Obelisk now issues a warning and tells you which one it will use. ([#653](https://github.com/obsidiansystems/obelisk/pull/653))
70+* Removed `Obelisk.Backend.mkRouteToUrl` since it is easily written in terms of `Obelisk.Route.renderObeliskRoute`:
71+
72+ mkRouteToUrl validFullEncoder (k :/ v) = renderObeliskRoute validFullEncoder (FullRoute_Frontend (ObeliskRoute_App k) :/ v)
73+
74+* Add `Obelisk.Backend.renderAllJsPath` to expose URL path to `ghcjs/all.js`. ([#545](https://github.com/obsidiansystems/obelisk/pull/545))
75+* Add argument to `serveDefaultObeliskApp`, `serveObeliskApp`, and `serveGhcjsApp` to take the path to `all.js` instead of hard-coding it. ([#545](https://github.com/obsidiansystems/obelisk/pull/545))
76+
77+## v0.5.0.0 - 2020-02-07
78+
79+* Add `Obelisk.Route.(?/)`, a convenience function for constructing routes nested in `Maybe`. ([#457](https://github.com/obsidiansystems/obelisk/pull/457))
80+* Add local unpacked packages to the `ob run`, `ob watch`, and `ob repl` sessions. Any `.cabal` or hpack package inside the current obelisk project will be loaded into the session. For `ob run`/`ob watch` this means the session will automatically reload when you save a source file in any of those packages. For `ob repl` it means that `:r` will reload changes to any of those packages. There are some edge cases where this integration is still rough. Report any issues you encounter. ([#489](https://github.com/obsidiansystems/obelisk/pull/489))
81+* Add `ob hoogle` command to start a local [Hoogle](https://hoogle.haskell.org/) server for the project. ([#628](https://github.com/obsidiansystems/obelisk/pull/628))
82+* `ob thunk pack` will now attempt to automatically detect if the thunk is a private or public repo. To avoid this detection, specify `--private` or `--public` manually. ([#607](https://github.com/obsidiansystems/obelisk/pull/607))
83+* Fix a bug in the plain git thunk loader for thunks marked as 'private' when the revision is not in the default branch. ([#648](https://github.com/obsidiansystems/obelisk/pull/648))
84+* Improve handling of runtime nix dependencies. This may fix some issues encountered particularly by users on systems other than NixOS.
85+
86+## v0.4.0.0 - 2020-01-10
87+
88+* Bump reflex-platform which, notably, bumps nixpkgs to 19.09. ([#585](https://github.com/obsidiansystems/obelisk/pull/585))
89+* Add new thunk loader for Git repositories that supports `file://` Git remotes and supports private repositories via `builtins.fetchGit` for private repositories (when the `git.json` file specifies `"private": true`). ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
90+* Add a new thunk loader for GitHub repositories that uses `builtins.fetchTarball` for public repositories to increase loader performance and uses `fetchFromGitHub` for private repositories (when the `github.json` file specifies `"private": true`). Note that `fetchFromGitHub` requires some Nix configuration for the Nix builder to access the repository. If `ob thunk pack` fails in this case, use `-v` to see Nix's helpful message. ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
91+* Add `--public`/`--private` options to `ob thunk pack` to specify if a repository should be treated as a public or private. ([#594](https://github.com/obsidiansystems/obelisk/pull/594))
92+* Improve error messaging when a dependency doesn't have the expected `.cabal` or `package.yaml` file. ([#597](https://github.com/obsidiansystems/obelisk/pull/597))
93+* Improve the skeleton in small ways. ([#593](https://github.com/obsidiansystems/obelisk/pull/593), [#589](https://github.com/obsidiansystems/obelisk/pull/589))
94+* Fix `ob` commands to again support running from any subdirectory of an obelisk project ([#591](https://github.com/obsidiansystems/obelisk/pull/591))
95+* Add `reflex-platform-func` argument to Obelisk's `default.nix`. It defaults to its prior behavior of using the reflex-platform in in `dep`. ([#612](https://github.com/obsidiansystems/obelisk/pull/612))
96+
97+## v0.3.0.0 - 2019-12-20
98+
99+* Change the structure of Obelisk routes to use a designated
100+ `FullRoute` type. This combines frontend and backend routes into one
101+ structure. This is a **breaking** change which requires Obelisk apps
102+ to take specific migrations. They are:
103+ * Rewrite the implementation of `_backend_routeEncoder` in
104+ `Backend` to use `mkFullRouteEncoder` instead of
105+ `handleEncoder`. Specifically, the backend and frontend cases of
106+ the top-level `pathComponentEncoder` become the second and third
107+ arguments of `mkFullRouteEncoder` respectively, while the
108+ missing route becomes the first argument. An example of how to
109+ do this is available in [a reflex-examples
110+ commit](https://github.com/reflex-frp/reflex-examples/commits/28f566c3e7dc615578dc74297b7c620c1f13683e).
111+ * Replace type constructions of `InL` with `FullRoute_Backend` and
112+ `InR` with `FullRoute_Frontend`.
113+* Generalised `pathSegmentEncoder`, added `pathFieldEncoder`.
114+* Added some `Prism`s to the encoder library for manipulating `DSum`s.
115+* Add `ob doc` command, which lists paths to haddock documentation for specified packages.
116+* Bump reflex-platform so that obelisk now uses GHC 8.6.5 and the nixos-19.03 nixpkgs set.
117+* Add support in `obelisk-route` for single parameters in URL paths.
118+* Bump reflex-platform so that obelisk now uses reflex-dom 0.5.2.0.
119+* Use a `--pure` nix shell in `ob run` for parity with `ob repl` and more resilience against "works on my machine".
120+* Pin usages of `<nixpkgs>` in obelisk thunks, etc. to the nixpkgs used by the project's obelisk impl.
121+* Backport ACMEv2 support in obelisk server to regain LetsEncrypt account creation.
122+* Enable HTTPS in `ob run`.
123+* `ob run` now handles `ghci` errors better, and includes a custom `ghcid`
124+ version. As a result, you no longer need to have ghcid installed to
125+ use `ob run`, as we provide one for you.
126+* `ob` commands now complain less on systems with umasks other than `0022`.
127+* Ignore package environment files in `ob run` and `ob repl`.
128+* Add `Obelisk.Route.Frontend.routeLinkDynAttr`.
129+
130+## v0.2.0.0 - 2019-8-17
131+
132+* Configs become ByteStrings.
133+* FrontendConfigsT has been changed into ConfigsT and configs are made available via getConfig/getConfigs
134+ * The frontend will still only have access to configs that are placed in config/frontend and config/common, while the backend has access to the entire contents of the config directory via `Obelisk.ExecutableConfig.Lookup.getConfigs`.
135+* The backend no longer runs in BackendConfigsT.
136+* Add tabulation package. See Data.Tabulation for details.
137+* Add encoders for `DMap`, `HasFields` (cf. Data.Tabulation), and JSON.
138+* Use IP address for nginx proxy pass instead of localhost
139+
140+## v0.1.1.0 - 2019-05-17
141+
142+* Fix crashes of Android apps on 32-bit ARM devices.
143+* Provide a way to indicate acceptance of the Android SDK license by passing `config.android_sdk.accept_license = true;` in the arguments to the import of `.obelisk/impl` in the project's `default.nix`.
144+* Add `COMPLETE` pragma to `(:/)`. Using this pattern synonym should no longer generate spurious warnings about non-exhaustive pattern matching.
145+* Make asset path hashing strict (see `Obelisk.Asset.Gather`)
146+* Add the `ob shell` command to enter a nix shell for an obelisk project
147+* Allow skeleton's obelisk to be overridden. This changes the skeleton's default.nix interface: the arguments that it used to take are now part of the new "obelisk" argument.
148+* Removed `MonadIO` from `ObeliskWidget` to prevent accidental IO during prerendering. If you need to do IO in a widget it should be on the right hand side of a `prerender`.
149+* Significantly changed the interface to the "executable config" packages. `obelisk-executable-config-lookup` is a new internal package which looks up all configs in a platform-specific way. `obelisk-executable-frontend` and `obelisk-executable-backend` provide MTL-style monad classes (`HasFrontendConfigs` and `HasBackendConfigs`) which the frontend and backend, respectively, can use to look up configs. This replaces the old `get` function which ran in `IO`.
150+* Add a flag to force thunk packing even if there are unpushed changes in the unpacked thunk.
151+
152+
153+## v0.1.0.0 - 2019-03-29
154+
155+* Use reflex-dom's `HydrationDomBuilder` to "hydrate" statically rendered DOM served by the Obelisk backend (rather than re-creating DOM and replacing it all).
156+* Add `HasCookies` and `CookiesT` to allow `ObeliskWidget`s to access cookies during static and "hydrated" DOM rendering.
FAQ.mdnew file+117
@@ -0,0 +1,117 @@
1+# Frequently Asked Questions
2+
3+1. [How do I declare a new Haskell dependency?](#how-do-i-declare-a-new-haskell-dependency)
4+1. [How do I add or override Haskell dependencies in the package set?](#how-do-i-add-or-override-haskell-dependencies-in-the-package-set)
5+1. [How do I extend my Obelisk application with more local packages?](#how-do-i-extend-my-obelisk-application-with-more-local-packages)
6+1. [How do I use `ob run` over HTTPS?](#how-do-i-use-ob-run-over-https)
7+1. [How do I fix invalid entitlements?](#how-do-i-fix-invalid-entitlements)
8+1. [`ob thunk update` or `ob deploy update` fails](#ob-thunk-update-or-ob-deploy-update-fails)
9+1. [How do I fix `Ambiguous module name` errors?](#how-do-i-fix-ambiguous-module-name-errors)
10+
11+### How do I declare a new Haskell dependency?
12+
13+Every component of your Obelisk application is a standard [cabal](https://www.haskell.org/cabal/) package. That means declaring new Haskell dependencies simply involves updating the `build-depends` field in the appropriate cabal file (`backend.cabal` for example). By default, Obelisk will use its curated package set to choose which version of each package you get. It's possible that the package you need is not already in the curated set or the curated version isn't the one you want. See [How do I add or override Haskell dependencies in the package set?](#how-do-i-add-or-override-haskell-dependencies-in-the-package-set) for a solution to this.
14+
15+### How do I add or override Haskell dependencies in the package set?
16+
17+To add a Haskell package that doesn't exist in Obelisk's package set or to override the version of a package, use the `overrides` attribute in your project's `default.nix`. For example, to use a specific version of the `aeson` package fetched from GitHub and a specific version of the `waargonaut` package fetched from Hackage, your `default.nix` will look like:
18+
19+```nix
20+# ...
21+project ./. ({ pkgs, ... }: {
22+# ...
23+ overrides = self: super: let
24+ aesonSrc = pkgs.fetchFromGitHub {
25+ owner = "obsidiansystems";
26+ repo = "aeson-gadt-th";
27+ rev = "ed573c2cccf54d72aa6279026752a3fecf9c1383";
28+ sha256 = "08q6rnz7w9pn76jkrafig6f50yd0f77z48rk2z5iyyl2jbhcbhx3";
29+ };
30+ in
31+ {
32+ aeson = self.callCabal2nix "aeson" aesonSrc {};
33+ waargonaut = self.callHackageDirect {
34+ pkg = "waargonaut";
35+ ver = "0.8.0.1";
36+ sha256 = "1zv28np3k3hg378vqm89v802xr0g8cwk7gy3mr77xrzy5jbgpa39";
37+ } {};
38+ };
39+# ...
40+```
41+
42+For further information see [the Haskell section](https://nixos.org/nixpkgs/manual/#users-guide-to-the-haskell-infrastructure) of nixpkgs "Contributors Guide".
43+
44+### How do I extend my Obelisk application with more local packages?
45+
46+If the standard packages (`frontend`, `backend`, and `common`) are not enough, you may add more local packages by defining them with the `packages` attribute in your `default.nix`. The sources of these packages will be automatically loaded by `ob run`/`ob repl`/etc.
47+
48+```nix
49+# ...
50+project ./. ({ pkgs, ... }: {
51+# ...
52+ packages = {
53+ another = ./dep/another;
54+ };
55+# ...
56+```
57+
58+### How do I use `ob run` over HTTPS?
59+
60+To run your app locally over HTTPS, update the protocol in `config/common/route` to `https`, and then use `ob run` as normal.
61+
62+Obelisk generates a self-signed certificate for running HTTPS so the browser will issue a warning about using an invalid certificate. On Chrome, you can go to `chrome://flags/#allow-insecure-localhost` to enable invalid certificates for localhost.
63+
64+
65+### How do I fix invalid entitlements?
66+
67+You probably did not set `ios.bundleIdentifier` correctly in `default.nix`. When this happens you'll see an error something like this:
68+
69+```
70+2018-11-25 09:34:22.438 ios-deploy[58106:8521046] [ !! ] Error 0xe8008016: The executable was signed with invalid entitlements. AMDeviceSecureInstallApplication(0, device, url, options, install_callback, 0)
71+```
72+
73+Fixing the value of `ios.bundleIdentifier` should fix the error.
74+
75+### `ob thunk update` or `ob deploy update` fails
76+Whenever an `ob` command fails, try re-running it with `-v`.
77+
78+If you're using a private repo, and you get a failure in `nix-prefetch-url`, you may need to unpack and repack the thunk. Here's some example output that shows this issue:
79+
80+```
81+Starting Obelisk </nix/store/j8wls8a89xr6s1a47lg6g83gnbdrfd0l-obelisk-command-0.1/bin/.ob-wrapped> args=["deploy","update","-v"] logging-level=Debug
82+Creating process: 'nix-build' './.obelisk/impl' '-A' 'command' '--no-out-link'
83+✔ Built on ./.obelisk/impl [command]
84+Handing off to /nix/store/j8wls8a89xr6s1a47lg6g83gnbdrfd0l-obelisk-command-0.1/bin/ob
85+Starting Obelisk </nix/store/j8wls8a89xr6s1a47lg6g83gnbdrfd0l-obelisk-command-0.1/bin/.ob-wrapped> args=["--no-handoff","deploy","update","-v"] logging-level=Debug
86+Creating process: 'git' 'ls-remote' '--exit-code' '--symref' 'https://github.com/obsidiansystems/some-private-repo.git' 'refs/heads/master'
87+git ls-remote maps: (fromList [],fromList [(GitRef_Branch "master","8546dfc8be9653f20bb26214e0991dbb957cb290")])
88+Latest commit in branch master from remote repo https://github.com/obsidiansystems/some-private-repo.git is 8546dfc8be9653f20bb26214e0991dbb957cb290
89+Creating process: 'nix-prefetch-url' '--unpack' '--type' 'sha256' 'https://github.com/obsidiansystems/some-private-repo/archive/8546dfc8be9653f20bb26214e0991dbb957cb290.tar.gz'
90+error: unable to download 'https://github.com/obsidiansystems/some-private-repo/archive/8546dfc8be9653f20bb26214e0991dbb957cb290.tar.gz': HTTP error 404
91+Process exited with code 1; 'nix-prefetch-url' '--unpack' '--type' 'sha256' 'https://github.com/obsidiansystems/some-private-repo/archive/8546dfc8be9653f20bb26214e0991dbb957cb290.tar.gz'
92+nix-prefetch-url: Failed to determine sha256 hash of URL https://github.com/obsidiansystems/some-private-repo/archive/8546dfc8be9653f20bb26214e0991dbb957cb290.tar.gz
93+✖ Updating thunk ./src to latest
94+```
95+
96+And here's how you can fix it:
97+
98+```bash
99+ob thunk unpack $SOME_THUNK
100+ob thunk pack $SOME_THUNK
101+```
102+Substitute the directory of your thunk for `$SOME_THUNK`. In the case of `ob deploy update`, `$SOME_THUNK` will be `src` in the deployment directory.
103+
104+(Based on issue #351).
105+
106+### How do I fix `Ambiguous module name` errors?
107+Since obelisk places the common/backend/frontend modules packages into the same ghci, and ghci doesn't "sandbox" them, it is possible to have conflicting module errors inside `ob repl/watch/run` that do not appear when doing a cabal build.
108+
109+You can disambiguate this via [PackageImports](https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/glasgow_exts.html#package-qualified-imports). For instance, if you see
110+```
111+error:
112+ Ambiguous module name ‘Crypto.Hash’:
113+ it was found in multiple packages:
114+ cryptohash-0.11.9 cryptonite-0.25
115+```
116+then specify the package you want in the import, e.g:
117+`import "cryptonite" Crypto.Hash`
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+143−107
@@ -1,136 +1,127 @@
1# Obelisk
1# Obelisk
2
2
3−Obelisk provides an easy way to develop and deploy your [Reflex](https://github.com/reflex-frp/reflex) project as web apps and as mobile apps.
3+[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
4+[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://github.com/obsidiansystems/obelisk/blob/master/LICENSE)
4
5
6+<p align="center"><img src="docs/obelisk-logo-640.png" width="50%" alt="Obelisk Logo"></p>
7+
8+Functional reactive web and mobile applications, with batteries included. Obelisk's goal is to represent a cohesive, highly-curated set of choices that [Obsidian Systems](https://obsidian.systems/) has made for building these types of applications in a way that is extremely fast but does not compromise on production readiness.
9+
10+- [Overview](#overview)
11+ - [Who should consider using it?](#who-should-consider-using-it)
5- [Installing Obelisk](#installing-obelisk)
12- [Installing Obelisk](#installing-obelisk)
6- [Developing an Obelisk project](#developing-an-obelisk-project)
13- [Developing an Obelisk project](#developing-an-obelisk-project)
14+ - [IDE Support](#ide-support)
7- [Deploying](#deploying)
15- [Deploying](#deploying)
16+ - [Default EC2 Deployment](#default-ec2-deployment)
17+ - [Custom Non-EC2 Deployment](#custom-non-ec2-deployment)
18+ - [VirtualBox Deployment](#virtualbox-deployment)
8 - [Locally](#locally)
19 - [Locally](#locally)
9− - [EC2](#ec2)
20+ - [From macOS](#from-macos)
21+ - [Deploying an updated version](#deploying-an-updated-version)
10- [Mobile](#mobile)
22- [Mobile](#mobile)
11 - [iOS](#ios)
23 - [iOS](#ios)
12 - [Android](#android)
24 - [Android](#android)
25+- [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq)
26+- [Contributing](#contributing)
27+
28+## Overview
29+
30+Obelisk allows you to build high-quality web and mobile applications very quickly using [Reflex](https://reflex-frp.org/). In minutes you can go from an empty directory to an interactive application that works on web, iOS, and Android, all sharing the same Haskell codebase! Obelisk's development environment also enables extremely rapid development and feedback. You can take advantage of Haskell's type system across the frontend and backend boundary. This means changes to your backend that would break your frontend are immediately detected during development and vice versa. Obelisk uses Haskell's compiler to give you a complete "TODO list" of what needs to be updated.
31+
32+Obelisk is targeted primarily at Haskell developers who want to build high-quality web and/or mobile applications in Haskell, without the distractions of manually choosing and integrating technology for every piece of the system.
33+
34+### Who should consider using it?
35+
36+Obelisk assumes basic knowledge of [Haskell](https://www.haskell.org/) and [Reflex/Reflex-DOM](https://reflex-frp.org/), web technologies like [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML) and [CSS](https://developer.mozilla.org/en-US/docs/Web/CSS), and a terminal shell like [Bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell)). Knowledge of [Nix](https://nixos.org/) helps but is not strictly necessary.
37+
13
38
14## Installing Obelisk
39## Installing Obelisk
40+
151. [Install Nix](https://nixos.org/nix/).
411. [Install Nix](https://nixos.org/nix/).
16 If you already have Nix installed, make sure you have version 2.0 or higher. To check your current version, run `nix-env --version`.
42 If you already have Nix installed, make sure you have version 2.0 or higher. To check your current version, run `nix-env --version`.
171. Set up nix caches
431. Set up nix caches
18 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
44 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
19− ```
45+ ```nix
20− nix.binaryCaches = [ "https://cache.nixos.org/" "https://nixcache.reflex-frp.org" ];
46+ nix.binaryCaches = [ "https://nixcache.reflex-frp.org" ];
21 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
47 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
22 ```
48 ```
49+ and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
23− 1. If you are using another operating system or linux distribution, ensure that these lines are present in `/etc/nix/nix.conf`:
50+ 1. If you are using another operating system or Linux distribution, ensure that these lines are present in your Nix configuration file (`/etc/nix/nix.conf` on most systems; [see full list](https://nixos.org/nix/manual/#sec-conf-file)):
24− ```
51+ ```nix
25− substituters = https://cache.nixos.org https://nixcache.reflex-frp.org
52+ binary-caches = https://cache.nixos.org https://nixcache.reflex-frp.org
26− trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
53+ binary-cache-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
54+ binary-caches-parallel-connections = 40
27 ```
55 ```
28− * other Linux: enable sandboxing (see https://github.com/obsidiansystems/obelisk/issues/6)
56+ * If you're on a Linux distribution other than NixOS, enable sandboxing (see these [issue 172](https://github.com/obsidiansystems/obelisk/issues/172#issuecomment-411507818) or [issue 6](https://github.com/obsidiansystems/obelisk/issues/6) if you run into build problems) by adding the following:
29− ```
57+ ```nix
30 sandbox = true
58 sandbox = true
31 ```
59 ```
32− * MacOS: disable sandboxing (there are still some impure dependencies for now)
60+ * If you're on MacOS, disable sandboxing (there are still some impure dependencies for now) by adding the following:
33− ```
61+ ```nix
34 sandbox = false
62 sandbox = false
35 ```
63 ```
36 then restart the nix daemon
64 then restart the nix daemon
37− ```
65+ ```bash
38 sudo launchctl stop org.nixos.nix-daemon
66 sudo launchctl stop org.nixos.nix-daemon
39 sudo launchctl start org.nixos.nix-daemon
67 sudo launchctl start org.nixos.nix-daemon
40 ```
68 ```
69+1. Install obelisk:
70+ ```bash
41−1. Install obelisk: `nix-env -f https://github.com/obsidiansystems/obelisk/archive/master.tar.gz -iA command`
71+ nix-env -f https://github.com/obsidiansystems/obelisk/archive/master.tar.gz -iA command
42−
72+ ```
43−### Contributing to Obelisk
44−
45−When developing on obelisk itself you may launch `ghcid` for the corresponding project as follows. For example to launch ghcid for `lib/backend` project:
46
73
47−```
74+### Accessing private repositories
48−nix-shell -A obelisk.obelisk-backend.env --run "cd lib/backend && ghcid -c 'cabal new-repl'"
49−```
50
75
51−Or to launch ghcid for `lib/command` project:
76+To allow the Nix builder to access private git repositories, you must be set up
77+to access them via SSH. Follow these steps depending on the platform you need
78+access to:
52
79
53−```
54−nix-shell -A obelisk.obelisk-command.env --run "cd lib/command && ghcid -c 'cabal new-repl'"
55−```
56−
57−### Accessing private repositories
58−To allow the Nix builder to access private git repositories, follow these steps:
59−
60−1. [Get set up to connect to GitHub with SSH](https://help.github.com/articles/connecting-to-github-with-ssh/)
80+- [GitHub](https://help.github.com/articles/connecting-to-github-with-ssh/)
61−1. [Create a GitHub personal access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/)
81+- [GitLab](https://docs.gitlab.com/ee/gitlab-basics/create-your-ssh-keys.html)
62−1. Set environment variables:
63− * NixOS: Add this to `/etc/nixos/configuration.nix`:
64− ```
65− nix.envVars = {
66− NIX_GITHUB_PRIVATE_USERNAME = "your-github-username";
67− NIX_GITHUB_PRIVATE_PASSWORD = "your-github-personal-access-token";
68− };
69− ```
70− * MacOS:
71− ```
72− sudo launchctl setenv NIX_GITHUB_PRIVATE_USERNAME "your-github-username"
73− sudo launchctl setenv NIX_GITHUB_PRIVATE_PASSWORD "your-github-personal-access"
74− sudo launchctl stop org.nixos.nix-daemon
75− sudo launchctl start org.nixos.nix-daemon
76− ```
77−1. `nix-env -i hub` OR `nix-env -iA nixos.gitAndTools.hub`
78−1. `hub clone yourusername/yourproject`
79− * NOTE: you must authenticate with hub at least once, because the `ob` command uses `hub` for authentication
80− #TODO: Make ob do this itself (either invoke hub automatically or not depend on hub)
81
82
82## Developing an Obelisk project
83## Developing an Obelisk project
83
84
84To create a new Obelisk project, go to an empty directory and run:
85To create a new Obelisk project, go to an empty directory and run:
85
86
86−```
87+```bash
87ob init
88ob init
88```
89```
89
90
90Obelisk 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:
91Obelisk leverages ghcid to provide a live-reloading server that handles both frontend and backend. To run your Obelisk app and monitor the source for changes:
91
92
92−```
93+```bash
93ob run
94ob run
94```
95```
95
96
96−Now go to http://localhost:8000 (or the port specified in `config/common/route`) to access your app.
97+Now, with an appropriate browser, go to http://localhost:8000 (or the address/port specified in `config/common/route`) to access your app.
98+Firefox will not be able to properly run the development website due to [issue 460](https://github.com/obsidiansystems/obelisk/issues/460). Fortunately, this problem does not occur on a fully built website.
97
99
98Every 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.
100Every time you change the Haskell source files in frontend, common or backend, `ob run` will automatically recompile the modified files and reload the server. Furthermore, it will display on screen compilation errors and warnings if any.
99
101
100−## Deploying
102+### IDE Support
101−
102−### Locally
103−
104−Build everything:
105−
106−```
107−nix-build -A exe -o result-exe
108−```
109
103
110−Run the server:
104+Obelisk officially supports terminal-based feedback (akin to [`ghcid`](https://github.com/ndmitchell/ghcid)) in `ob run` and `ob watch`.
111
105
112−```
106+## Deploying
113−cd result-exe
114−./backend
115−```
116
107
117−### EC2
108+### Default EC2 Deployment
118
109
119−In this section we will demonstrate how to deploy your Obelisk app to an Amazon EC2 instance.
110+In this section we will demonstrate how to deploy your Obelisk app to an Amazon EC2 instance. Obelisk deployments are configured for EC2 by default (see [Custom Non-EC2 Deployment](#custom-non-ec2-deployment)).
120
111
121First create a new EC2 instance:
112First create a new EC2 instance:
122
113
123−1. Launch a NixOS 17.09 EC2 instance (we recommend [this AMI](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#LaunchInstanceWizard:ami=ami-40bee63a))
114+1. Launch a NixOS 19.09 EC2 instance (we recommend [this AMI](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#LaunchInstanceWizard:ami=ami-00a8eeaf232a74f84))
1241. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1151. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1251. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
1161. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
126−1. Go to "Security Groups", select your instance's security group and under "Inbound" tab add a new rule for HTTP port 80 and 443.
117+1. Go to "Security Groups", select your instance's security group and under "Inbound" tab add a new rule for HTTP port 80 and HTTPS port 443.
127
118
128At this stage your instance should be booting and become accessible shortly. Note down the hostname of your EC2 instance.
119At this stage your instance should be booting and become accessible shortly. Note down the hostname of your EC2 instance.
129
120
130Now go to your Obelisk project directory (`~/code/myapp`), and initialize a deployment config (`~/code/myapp-deploy`):
121Now go to your Obelisk project directory (`~/code/myapp`), and initialize a deployment config (`~/code/myapp-deploy`):
131Your project directory must be "thunkable", i.e. something on which `ob thunk pack` can be called. Usually it will be a git repository whose current revision has been pushed upstream.
122Your project directory must be "thunkable", i.e. something on which `ob thunk pack` can be called. Usually it will be a git repository whose current revision has been pushed upstream.
132
123
133−```
124+```bash
134cd ~/code/myapp
125cd ~/code/myapp
135SERVER=ec2-35-183-22-197.ca-central-1.compute.amazonaws.com
126SERVER=ec2-35-183-22-197.ca-central-1.compute.amazonaws.com
136ROUTE=https://myapp.com # Publicly accessible route to your app
127ROUTE=https://myapp.com # Publicly accessible route to your app
@@ -143,24 +134,74 @@ ob deploy init \
143 ~/code/myapp-deploy
134 ~/code/myapp-deploy
144```
135```
145
136
146−NOTE: HTTPS is enabled by default; to disable https, pass `--disable-https` to the `ob deploy init` command above.
137+HTTPS is enabled by default; to disable HTTPS pass `--disable-https` to the `ob deploy init` command above.
147
138
148−Then go to that created deployment configuration directory, and initiate the deployment:
139+This step will also require that you manually verify the authenticity of the host `$SERVER`. Obelisk will save the fingerprint in a deployment-specific configuration. **Obelisk deployments do *not* rely on the `known_hosts` of your local machine.** This is because, in the event that you need to switch from one deploy machine / bastion host to another, you want to be absolutely sure that you're still connecting to the machines you think you are, even if that deploy machine / bastion host has never connected to them before. Obelisk explicitly avoids a workflow that encourages people to accept host keys without checking them, since that could result in leaking production secrets to anyone who manages to MITM you, e.g. via DNS spoofing or cache poisoning. (Note that an active attack is a circumstance where you may need to quickly switch bastion hosts, e.g. because the attacker has taken one down or you have taken it down in case it was compromised. In this circumstance you might need to deploy to production to fix an exploit or rotate keys, etc.) When you run `ob deploy` later it will rely on the saved verification in this step.
149
140
141+Next, go to the deployment directory that you just initialized and deploy!
142+
150−```
143+```bash
151cd ~/code/myapp-deploy
144cd ~/code/myapp-deploy
152ob deploy push
145ob deploy push
153```
146```
154
147
155`ob deploy push` will locally build your app and then transfer it, along with all the Nix package dependencies, via ssh to the EC2 instance. The backend will live in `/var/lib/backend`.
148`ob deploy push` will locally build your app and then transfer it, along with all the Nix package dependencies, via ssh to the EC2 instance. The backend will live in `/var/lib/backend`.
156
149
157−At this point you are done. Your app will be accessible at `${ROUTE}`.
150+At this point you are done. Your app will be accessible at `${ROUTE}`. The currently deployed version - the git commit hash of the source repo - can be found at `${ROUTE}/version`.
151+
152+### Custom Non-EC2 Deployment
153+
154+By default Obelisk deployments are configured for NixOS machines running on AWS EC2. To provide your own configuration, you need to write a custom `module.nix` in the deployment repository. This still requires that your server is running NixOS.
155+
156+`module.nix` must contain a Nix *function* that produces a [NixOS module function](https://nixos.org/nixos/manual/index.html#sec-writing-modules). The top-level function takes deployment configuration as arguments: `hostName`, `adminEmail`, `routeHost`, `enableHttps`, `version`, `exe`, `nixosPkgs`. Most of these are the values you specified during `ob deploy init` and are stored in the deployment repository. `version` is a `git` hash for the app that you're deploying. `exe` is the Linux build of the app (as seen in [Deploying Locally](#locally)). `nixosPkgs` is the package set used to construct the NixOS VM.
157+
158+The [VirtualBox Deployment](#virtualbox-deployment) section provides an example.
159+
160+#### VirtualBox Deployment
161+
162+Here's a `module.nix` that is configured for deployment to a VirtualBox VM (running NixOS):
163+
164+```nix
165+{ nixosPkgs, ... }: {...}: {
166+ imports = [ (nixosPkgs.path + /nixos/modules/virtualisation/virtualbox-image.nix) ];
167+}
168+```
169+
170+The `{...}:` and following is the [NixOS module](https://nixos.org/nixos/manual/index.html#sec-writing-modules) definition.
171+
172+### Locally
173+
174+If you want deploy your application locally or test a production-oriented build you can build and deploy the app as described below.
175+
176+Build the application:
177+
178+```bash
179+nix-build -A exe --no-out-link
180+```
181+
182+Copy the result to a new directory, add configuration, and run!
183+
184+```bash
185+mkdir test-app
186+ln -s $(nix-build -A exe --no-out-link)/* test-app/
187+cp -r config test-app
188+(cd test-app && ./backend)
189+```
190+
191+### From macOS
192+
193+Deploying from macOS requires some extra setup:
194+
195+- [Install nix-darwin](https://github.com/LnL7/nix-darwin)
196+- [Install docker](https://docs.docker.com/)
197+
198+Running `ob deploy push` will give you additional setup instructions.
158
199
159### Deploying an updated version
200### Deploying an updated version
160
201
161If 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:
202If you'd like to deploy an updated version (with new commits) of your Obelisk app: simply go to the configuration directory, update the source thunk and push:
162
203
163−```
204+```bash
164cd ~/code/myapp-deploy
205cd ~/code/myapp-deploy
165ob deploy update
206ob deploy update
166ob deploy push
207ob deploy push
@@ -180,20 +221,20 @@ Your account must also belong to an Apple Developer Team, if you want to access
1801. Click accept to authorize on both the computer and the iPhone.
2211. Click accept to authorize on both the computer and the iPhone.
181
222
182##### Xcode
223##### Xcode
183−Install Xcode 8.2 (contains iOS SDK 10.2) and open it so that it runs its post install tool setup.
224+Install Xcode 11.2 (contains iOS SDK 13.2) and open it so that it runs its post install tool setup.
184
225
185These versions will work out of the box but iOS SDKs prior to 11.3 should also work. You can choose another installed version in `default.nix`
226These versions will work out of the box but iOS SDKs prior to 11.3 should also work. You can choose another installed version in `default.nix`
186
227
187More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
228More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
188To 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.
229To add another SDK to your current Xcode, [download](https://developer.apple.com/download/more/) the corresponding Xcode, extract it and copy its SDK folder next to the installed one, e.g.
189−```
230+```bash
190open -W Xcode_9.2.xip
231open -W Xcode_9.2.xip
191sudo 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
232sudo cp -R Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS11.2.sdk
192```
233```
193
234
194
235
195You can verify that you have correct versions by running
236You can verify that you have correct versions by running
196−```
237+```bash
197xcodebuild -showsdks
238xcodebuild -showsdks
198```
239```
199
240
@@ -219,7 +260,7 @@ Ensure that `bundleIdentifier` matches the App ID of the development profile, or
2191. Connect the registered iPhone.
2601. Connect the registered iPhone.
2201. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2611. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2211. Run the deploy command with your Team ID:
2621. Run the deploy command with your Team ID:
222−```
263+```bash
223result-ios/bin/deploy [TEAM_ID]
264result-ios/bin/deploy [TEAM_ID]
224# or in debug mode via lldb:
265# or in debug mode via lldb:
225result-ios/bin/deploy [TEAM_ID] -d
266result-ios/bin/deploy [TEAM_ID] -d
@@ -229,7 +270,7 @@ result-ios/bin/deploy [TEAM_ID] -d
2291. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
2701. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
230Create and download a distribution profile.
271Create and download a distribution profile.
2311. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
2721. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
232−```
273+```bash
233result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
274result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
234```
275```
235
276
@@ -242,7 +283,10 @@ It's also possible to inspect iOS WkWebView apps once they are installed in the
242
283
243### Android
284### Android
244
285
286+NOTE: Currently Android builds are only supported on Linux.
287+
2451. In your project's `default.nix` set a suitable value for `android.applicationId` and `android.displayName`.
2881. In your project's `default.nix` set a suitable value for `android.applicationId` and `android.displayName`.
289+1. In your project's `default.nix` pass `config.android_sdk.accept_license = true;` in the arguments to the import of of `.obelisk/impl` to indicate your acceptance of the [Android Software Development Kit License Agreement](https://developer.android.com/studio/terms), which is required to build Android apps.
2461. Run `nix-build -A android.frontend -o result-android` to build the Android app.
2901. Run `nix-build -A android.frontend -o result-android` to build the Android app.
2471. A debug version of the app should be generated at `result-android/android-app-debug.apk`
2911. A debug version of the app should be generated at `result-android/android-app-debug.apk`
248
292
@@ -252,39 +296,31 @@ Now deploy the built apk file to your Android device:
2521. Connect the device using USB (be sure to confirm any security prompts on the device)
2961. Connect the device using USB (be sure to confirm any security prompts on the device)
2531. Run the deploy script: `result-android/bin/deploy`
2971. Run the deploy script: `result-android/bin/deploy`
254
298
255−This should copy over and install the application on your device (if you see a "*signatures do not match*" error, simply uninstall the previous app from the device before retrying the deploy). The name of the installed application will be what you have specified for `android.displayName` in the `default.nix`.
299+Alternatively, you can deploy from an obelisk deployment directory (a directory generated post `ob deploy init ...` command) using the `ob deploy test android` command.
300+This command will accomplish the following:
256
301
257−#### Releasing to Play Store
302+1. Create a key store and apk signing key (`android_keystore.jks`)
303+1. Build a Signed Android apk for your application
304+1. Deploy the Signed apk to your connected Android device
258
305
259−##### Configure signing
306+In the event that you change your key or keystore password, you will have to update your credentials within the JSON object found in `android_keytool_config.json`.
260
307
261−The previous section would have generated a debug version of the app. In order to build a release version you will need to sign your app. Obelisk can automatically sign the app during build if you provide it with your keystore file in `default.nix`.
308+Additional documentation on Java key stores can be found [here](https://docs.oracle.com/javase/8/docs/technotes/tools/unix/keytool.html).
262
309
263−First, if you do not already have a keystore, create it as follows (for more information, see the [Android documentation](https://developer.android.com/studio/publish/app-signing#signing-manually)):
310+This should copy over and install the application on your device (if you see a "*signatures do not match*" error, simply uninstall the previous app from the device before retrying the deploy). The name of the installed application will be what you have specified for `android.displayName` in the `default.nix`.
264
311
265−```
312+#### Releasing to Play Store
266−nix-shell -p androidenv.platformTools --run "keytool -genkey -v -keystore myandroidkey.jks -keyalg RSA -keysize 2048 -validity 10000 -alias myandroidalias"
267−```
268
313
269−(Be sure to give an appropriate keystore filename and key alias string above.)
314+##### Build a release version
270
315
271−The `keytool` command will ask you for some details, including a keystore password and a key password (we will use these passwords further below). It will now have created a `myandroidkey.jks` file under the current directory. Move that to somewhere safe, and note down its full path.
316+After having configured signing for your app, you may proceed to build a release version of the app. This is no different to how you build the non-release version, so consult the section [Android](#android) further above for exact instructions on building and deploying to your device.
272
317
273−Now edit your project's `default.nix` and tell Obelisk of your app's keystore file. Your `default.nix` should look like this after the edit:
274
318
275−```nix
319+## Frequently Asked Questions (FAQ)
276− ...
277− android.applicationId = "com.example.myapp";
278− android.displayName = "My App";
279− android.releaseKey =
280− { storeFile = /path/to/myandroidkey.jks;
281− storePassword = "abcd1234";
282− keyAlias = "myandroidalias";
283− keyPassword = "abcd1234";
284− };
285− ...
286−```
287
320
288−##### Build a release version
321+Refer to [FAQ](FAQ.md).
289
322
290−After having configured signing for your app, you may proceed to build a release version of the app. This is no different to how you build the non-release version, so consult the section [Android](#android) further above for exact instructions on building and deploying to your device.
323+
324+## Contributing
325+
326+Contributions and issue reports are encouraged and appreciated! Refer to the [Contributing](CONTRIBUTING.md) guide for information about getting started.
acme.nixnew file+430
@@ -0,0 +1,430 @@
1+# Copied from https://github.com/NixOS/nixpkgs-channels/blob/70717a337f7ae4e486ba71a500367cad697e5f09/nixos/modules/security/acme.nix # MODIFIED
2+# Lines marked '# MODIFIED' have been added or modified from the original. # MODIFIED
3+{ config, lib, pkgs, ... }:
4+with lib;
5+let
6+
7+ cfg = config.security.acme;
8+
9+ certOpts = { name, ... }: {
10+ options = {
11+ webroot = mkOption {
12+ type = types.nullOr types.str;
13+ default = null;
14+ example = "/var/lib/acme/acme-challenges";
15+ description = ''
16+ Where the webroot of the HTTP vhost is located.
17+ <filename>.well-known/acme-challenge/</filename> directory
18+ will be created below the webroot if it doesn't exist.
19+ <literal>http://example.org/.well-known/acme-challenge/</literal> must also
20+ be available (notice unencrypted HTTP).
21+ '';
22+ };
23+
24+ server = mkOption {
25+ type = types.nullOr types.str;
26+ default = null;
27+ description = ''
28+ ACME Directory Resource URI. Defaults to let's encrypt
29+ production endpoint,
30+ https://acme-v02.api.letsencrypt.org/directory, if unset.
31+ '';
32+ };
33+
34+ domain = mkOption {
35+ type = types.str;
36+ default = name;
37+ description = "Domain to fetch certificate for (defaults to the entry name)";
38+ };
39+
40+ email = mkOption {
41+ type = types.nullOr types.str;
42+ default = cfg.email;
43+ description = "Contact email address for the CA to be able to reach you.";
44+ };
45+
46+ user = mkOption {
47+ type = types.str;
48+ default = "root";
49+ description = "User running the ACME client.";
50+ };
51+
52+ group = mkOption {
53+ type = types.str;
54+ default = "root";
55+ description = "Group running the ACME client.";
56+ };
57+
58+ allowKeysForGroup = mkOption {
59+ type = types.bool;
60+ default = false;
61+ description = ''
62+ Give read permissions to the specified group
63+ (<option>security.acme.cert.&lt;name&gt;.group</option>) to read SSL private certificates.
64+ '';
65+ };
66+
67+ postRun = mkOption {
68+ type = types.lines;
69+ default = "";
70+ example = "systemctl reload nginx.service";
71+ description = ''
72+ Commands to run after new certificates go live. Typically
73+ the web server and other servers using certificates need to
74+ be reloaded.
75+ Executed in the same directory with the new certificate.
76+ '';
77+ };
78+
79+ directory = mkOption {
80+ type = types.str;
81+ readOnly = true;
82+ default = "/var/lib/acme/${name}";
83+ description = "Directory where certificate and other state is stored.";
84+ };
85+
86+ extraDomains = mkOption {
87+ type = types.attrsOf (types.nullOr types.str);
88+ default = {};
89+ example = literalExample ''
90+ {
91+ "example.org" = null;
92+ "mydomain.org" = null;
93+ }
94+ '';
95+ description = ''
96+ A list of extra domain names, which are included in the one certificate to be issued.
97+ Setting a distinct server root is deprecated and not functional in 20.03+
98+ '';
99+ };
100+
101+ keyType = mkOption {
102+ type = types.str;
103+ default = "ec256";
104+ description = ''
105+ Key type to use for private keys.
106+ For an up to date list of supported values check the --key-type option
107+ at https://go-acme.github.io/lego/usage/cli/#usage.
108+ '';
109+ };
110+
111+ dnsProvider = mkOption {
112+ type = types.nullOr types.str;
113+ default = null;
114+ example = "route53";
115+ description = ''
116+ DNS Challenge provider. For a list of supported providers, see the "code"
117+ field of the DNS providers listed at https://go-acme.github.io/lego/dns/.
118+ '';
119+ };
120+
121+ credentialsFile = mkOption {
122+ type = types.path;
123+ description = ''
124+ Path to an EnvironmentFile for the cert's service containing any required and
125+ optional environment variables for your selected dnsProvider.
126+ To find out what values you need to set, consult the documentation at
127+ https://go-acme.github.io/lego/dns/ for the corresponding dnsProvider.
128+ '';
129+ example = "/var/src/secrets/example.org-route53-api-token";
130+ };
131+
132+ dnsPropagationCheck = mkOption {
133+ type = types.bool;
134+ default = true;
135+ description = ''
136+ Toggles lego DNS propagation check, which is used alongside DNS-01
137+ challenge to ensure the DNS entries required are available.
138+ '';
139+ };
140+ };
141+ };
142+
143+in
144+
145+{
146+
147+ ###### interface
148+ imports = [
149+ (mkRemovedOptionModule [ "security" "acme" "production" ] ''
150+ Use security.acme.server to define your staging ACME server URL instead.
151+ To use the let's encrypt staging server, use security.acme.server =
152+ "https://acme-staging-v02.api.letsencrypt.org/directory".
153+ ''
154+ )
155+ # (mkRemovedOptionModule [ "security" "acme" "directory"] "ACME Directory is now hardcoded to /var/lib/acme and its permisisons are managed by systemd. See https://github.com/NixOS/nixpkgs/issues/53852 for more info.") # MODIFIED
156+ # (mkRemovedOptionModule [ "security" "acme" "preDelay"] "This option has been removed. If you want to make sure that something executes before certificates are provisioned, add a RequiredBy=acme-\${cert}.service to the service you want to execute before the cert renewal") # MODIFIED
157+ # (mkRemovedOptionModule [ "security" "acme" "activationDelay"] "This option has been removed. If you want to make sure that something executes before certificates are provisioned, add a RequiredBy=acme-\${cert}.service to the service you want to execute before the cert renewal") # MODIFIED
158+ (mkChangedOptionModule [ "security" "acme" "validMin"] [ "security" "acme" "validMinDays"] (config: config.security.acme.validMin / (24 * 3600)))
159+ ];
160+ options = {
161+ security.acme = {
162+
163+ validMinDays = mkOption {
164+ type = types.int;
165+ default = 30;
166+ description = "Minimum remaining validity before renewal in days.";
167+ };
168+
169+ email = mkOption {
170+ type = types.nullOr types.str;
171+ default = null;
172+ description = "Contact email address for the CA to be able to reach you.";
173+ };
174+
175+ renewInterval = mkOption {
176+ type = types.str;
177+ default = "daily";
178+ description = ''
179+ Systemd calendar expression when to check for renewal. See
180+ <citerefentry><refentrytitle>systemd.time</refentrytitle>
181+ <manvolnum>7</manvolnum></citerefentry>.
182+ '';
183+ };
184+
185+ server = mkOption {
186+ type = types.nullOr types.str;
187+ default = null;
188+ description = ''
189+ ACME Directory Resource URI. Defaults to let's encrypt
190+ production endpoint,
191+ <literal>https://acme-v02.api.letsencrypt.org/directory</literal>, if unset.
192+ '';
193+ };
194+
195+ preliminarySelfsigned = mkOption {
196+ type = types.bool;
197+ default = true;
198+ description = ''
199+ Whether a preliminary self-signed certificate should be generated before
200+ doing ACME requests. This can be useful when certificates are required in
201+ a webserver, but ACME needs the webserver to make its requests.
202+ With preliminary self-signed certificate the webserver can be started and
203+ can later reload the correct ACME certificates.
204+ '';
205+ };
206+
207+ acceptTerms = mkOption {
208+ type = types.bool;
209+ default = false;
210+ description = ''
211+ Accept the CA's terms of service. The default provier is Let's Encrypt,
212+ you can find their ToS at https://letsencrypt.org/repository/
213+ '';
214+ };
215+
216+ certs = mkOption {
217+ default = { };
218+ type = with types; attrsOf (submodule certOpts);
219+ description = ''
220+ Attribute set of certificates to get signed and renewed. Creates
221+ <literal>acme-''${cert}.{service,timer}</literal> systemd units for
222+ each certificate defined here. Other services can add dependencies
223+ to those units if they rely on the certificates being present,
224+ or trigger restarts of the service if certificates get renewed.
225+ '';
226+ example = literalExample ''
227+ {
228+ "example.com" = {
229+ webroot = "/var/www/challenges/";
230+ email = "foo@example.com";
231+ extraDomains = { "www.example.com" = null; "foo.example.com" = null; };
232+ };
233+ "bar.example.com" = {
234+ webroot = "/var/www/challenges/";
235+ email = "bar@example.com";
236+ };
237+ }
238+ '';
239+ };
240+ };
241+ };
242+
243+ ###### implementation
244+ config = mkMerge [
245+ (mkIf (cfg.certs != { }) {
246+
247+ assertions = let
248+ certs = (mapAttrsToList (k: v: v) cfg.certs);
249+ in [
250+ {
251+ assertion = all (certOpts: certOpts.dnsProvider == null || certOpts.webroot == null) certs;
252+ message = ''
253+ Options `security.acme.certs.<name>.dnsProvider` and
254+ `security.acme.certs.<name>.webroot` are mutually exclusive.
255+ '';
256+ }
257+ {
258+ assertion = cfg.email != null || all (certOpts: certOpts.email != null) certs;
259+ message = ''
260+ You must define `security.acme.certs.<name>.email` or
261+ `security.acme.email` to register with the CA.
262+ '';
263+ }
264+ {
265+ assertion = cfg.acceptTerms;
266+ message = ''
267+ You must accept the CA's terms of service before using
268+ the ACME module by setting `security.acme.acceptTerms`
269+ to `true`. For Let's Encrypt's ToS see https://letsencrypt.org/repository/
270+ '';
271+ }
272+ ];
273+
274+ systemd.services = let
275+ services = concatLists servicesLists;
276+ servicesLists = mapAttrsToList certToServices cfg.certs;
277+ certToServices = cert: data:
278+ let
279+ # StateDirectory must be relative, and will be created under /var/lib by systemd
280+ lpath = "acme/${cert}";
281+ apath = "/var/lib/${lpath}";
282+ spath = "/var/lib/acme/.lego/${cert}";
283+ fileMode = if data.allowKeysForGroup then "640" else "600";
284+ globalOpts = [ "-d" data.domain "--email" data.email "--path" "." "--key-type" data.keyType ]
285+ ++ optionals (cfg.acceptTerms) [ "--accept-tos" ]
286+ ++ optionals (data.dnsProvider != null && !data.dnsPropagationCheck) [ "--dns.disable-cp" ]
287+ ++ concatLists (mapAttrsToList (name: root: [ "-d" name ]) data.extraDomains)
288+ ++ (if data.dnsProvider != null then [ "--dns" data.dnsProvider ] else [ "--http" "--http.webroot" data.webroot ])
289+ ++ optionals (cfg.server != null || data.server != null) ["--server" (if data.server == null then cfg.server else data.server)];
290+ runOpts = escapeShellArgs (globalOpts ++ [ "run" ]);
291+ renewOpts = escapeShellArgs (globalOpts ++ [ "renew" "--days" (toString cfg.validMinDays) ]);
292+ acmeService = {
293+ description = "Renew ACME Certificate for ${cert}";
294+ after = [ "network.target" "network-online.target" ];
295+ wants = [ "network-online.target" ];
296+ wantedBy = mkIf (!config.boot.isContainer) [ "multi-user.target" ];
297+ serviceConfig = {
298+ Type = "oneshot";
299+ User = data.user;
300+ Group = data.group;
301+ PrivateTmp = true;
302+ StateDirectory = "acme/.lego/${cert} acme/.lego/accounts ${lpath}";
303+ StateDirectoryMode = if data.allowKeysForGroup then "750" else "700";
304+ WorkingDirectory = spath;
305+ # Only try loading the credentialsFile if the dns challenge is enabled
306+ EnvironmentFile = if data.dnsProvider != null then data.credentialsFile else null;
307+ ExecStart = pkgs.writeScript "acme-start" ''
308+ #!${pkgs.runtimeShell} -e
309+ test -L ${spath}/accounts -o -d ${spath}/accounts || ln -s ../accounts ${spath}/accounts
310+ ${pkgs.lego}/bin/lego ${renewOpts} || ${pkgs.lego}/bin/lego ${runOpts}
311+ '';
312+ ExecStartPost =
313+ let
314+ keyName = builtins.replaceStrings ["*"] ["_"] data.domain;
315+ script = pkgs.writeScript "acme-post-start" ''
316+ #!${pkgs.runtimeShell} -e
317+ cd ${apath}
318+ # Test that existing cert is older than new cert
319+ KEY=${spath}/certificates/${keyName}.key
320+ KEY_CHANGED=no
321+ if [ -e $KEY -a $KEY -nt key.pem ]; then
322+ KEY_CHANGED=yes
323+ cp -p ${spath}/certificates/${keyName}.key key.pem
324+ cp -p ${spath}/certificates/${keyName}.crt fullchain.pem
325+ cp -p ${spath}/certificates/${keyName}.issuer.crt chain.pem
326+ ln -sf fullchain.pem cert.pem
327+ cat key.pem fullchain.pem > full.pem
328+ fi
329+ chmod ${fileMode} *.pem
330+ chown '${data.user}:${data.group}' *.pem
331+ if [ "$KEY_CHANGED" = "yes" ]; then
332+ : # noop in case postRun is empty
333+ ${data.postRun}
334+ fi
335+ '';
336+ in
337+ "+${script}";
338+ };
339+
340+ };
341+ selfsignedService = {
342+ description = "Create preliminary self-signed certificate for ${cert}";
343+ path = [ pkgs.openssl ];
344+ script =
345+ ''
346+ workdir="$(mktemp -d)"
347+ # Create CA
348+ openssl genrsa -des3 -passout pass:xxxx -out $workdir/ca.pass.key 2048
349+ openssl rsa -passin pass:xxxx -in $workdir/ca.pass.key -out $workdir/ca.key
350+ openssl req -new -key $workdir/ca.key -out $workdir/ca.csr \
351+ -subj "/C=UK/ST=Warwickshire/L=Leamington/O=OrgName/OU=Security Department/CN=example.com"
352+ openssl x509 -req -days 1 -in $workdir/ca.csr -signkey $workdir/ca.key -out $workdir/ca.crt
353+ # Create key
354+ openssl genrsa -des3 -passout pass:xxxx -out $workdir/server.pass.key 2048
355+ openssl rsa -passin pass:xxxx -in $workdir/server.pass.key -out $workdir/server.key
356+ openssl req -new -key $workdir/server.key -out $workdir/server.csr \
357+ -subj "/C=UK/ST=Warwickshire/L=Leamington/O=OrgName/OU=IT Department/CN=example.com"
358+ openssl x509 -req -days 1 -in $workdir/server.csr -CA $workdir/ca.crt \
359+ -CAkey $workdir/ca.key -CAserial $workdir/ca.srl -CAcreateserial \
360+ -out $workdir/server.crt
361+ # Copy key to destination
362+ cp $workdir/server.key ${apath}/key.pem
363+ # Create fullchain.pem (same format as "simp_le ... -f fullchain.pem" creates)
364+ cat $workdir/{server.crt,ca.crt} > "${apath}/fullchain.pem"
365+ # Create full.pem for e.g. lighttpd
366+ cat $workdir/{server.key,server.crt,ca.crt} > "${apath}/full.pem"
367+ # Give key acme permissions
368+ chown '${data.user}:${data.group}' "${apath}/"{key,fullchain,full}.pem
369+ chmod ${fileMode} "${apath}/"{key,fullchain,full}.pem
370+ '';
371+ serviceConfig = {
372+ Type = "oneshot";
373+ PrivateTmp = true;
374+ StateDirectory = lpath;
375+ User = data.user;
376+ Group = data.group;
377+ };
378+ unitConfig = {
379+ # Do not create self-signed key when key already exists
380+ ConditionPathExists = "!${apath}/key.pem";
381+ };
382+ };
383+ in (
384+ [ { name = "acme-${cert}"; value = acmeService; } ]
385+ ++ optional cfg.preliminarySelfsigned { name = "acme-selfsigned-${cert}"; value = selfsignedService; }
386+ );
387+ servicesAttr = listToAttrs services;
388+ in
389+ servicesAttr;
390+
391+ systemd.tmpfiles.rules =
392+ map (data: "d ${data.webroot}/.well-known/acme-challenge - ${data.user} ${data.group}") (filter (data: data.webroot != null) (attrValues cfg.certs));
393+
394+ systemd.timers = let
395+ # Allow systemd to pick a convenient time within the day
396+ # to run the check.
397+ # This allows the coalescing of multiple timer jobs.
398+ # We divide by the number of certificates so that if you
399+ # have many certificates, the renewals are distributed over
400+ # the course of the day to avoid rate limits.
401+ numCerts = length (attrNames cfg.certs);
402+ _24hSecs = 60 * 60 * 24;
403+ AccuracySec = "${toString (_24hSecs / numCerts)}s";
404+ in flip mapAttrs' cfg.certs (cert: data: nameValuePair
405+ ("acme-${cert}")
406+ ({
407+ description = "Renew ACME Certificate for ${cert}";
408+ wantedBy = [ "timers.target" ];
409+ timerConfig = {
410+ OnCalendar = cfg.renewInterval;
411+ Unit = "acme-${cert}.service";
412+ Persistent = "yes";
413+ inherit AccuracySec;
414+ # Skew randomly within the day, per https://letsencrypt.org/docs/integration-guide/.
415+ RandomizedDelaySec = "24h";
416+ };
417+ })
418+ );
419+
420+ systemd.targets.acme-selfsigned-certificates = mkIf cfg.preliminarySelfsigned {};
421+ systemd.targets.acme-certificates = {};
422+ })
423+
424+ ];
425+
426+ meta = {
427+ maintainers = with lib.maintainers; [ abbradar fpletz globin m1cr0man ];
428+ # doc = ./acme.xml; # MODIFIED
429+ };
430+}
all-builds.nixnew file+113
@@ -0,0 +1,113 @@
1+{ self-args ? {
2+ config.android_sdk.accept_license = true;
3+ iosSdkVersion = "13.2";
4+ }
5+, local-self ? import ./. self-args
6+, supportedSystems ? [ builtins.currentSystem ]
7+}:
8+
9+let
10+ inherit (local-self.nixpkgs) lib runCommand nix;
11+ cacheBuildSystems = supportedSystems;
12+
13+ obeliskPackagesCommon = [
14+ "obelisk-frontend"
15+ "obelisk-route"
16+ "obelisk-executable-config-lookup"
17+ ];
18+
19+ obeliskPackagesBackend = obeliskPackagesCommon ++ [
20+ "obelisk-asset-manifest"
21+ "obelisk-asset-serve-snap"
22+ "obelisk-backend"
23+ "obelisk-cliapp"
24+ "obelisk-command"
25+ "obelisk-executable-config-inject"
26+ "obelisk-frontend"
27+ "obelisk-run"
28+ "obelisk-route"
29+ "obelisk-selftest"
30+ "obelisk-snap-extras"
31+ ];
32+
33+ pnameToAttrs = pkgsSet: pnames:
34+ lib.listToAttrs (map
35+ (name: { inherit name; value = pkgsSet.${name}; })
36+ pnames);
37+
38+ collect = v:
39+ if lib.isDerivation v then [v]
40+ else if lib.isAttrs v then lib.concatMap collect (builtins.attrValues v)
41+ else if lib.isList v then lib.concatMap collect v
42+ else [];
43+
44+ perPlatform = lib.genAttrs cacheBuildSystems (system: let
45+ reflex-platform = import ./dep/reflex-platform { inherit system; };
46+
47+ mkPerProfiling = profiling: let
48+ obelisk = import ./. (self-args // { inherit system profiling; });
49+ ghc = pnameToAttrs
50+ obelisk.haskellPackageSets.ghc
51+ obeliskPackagesBackend;
52+ ghcjs = pnameToAttrs
53+ obelisk.haskellPackageSets.ghcjs
54+ obeliskPackagesCommon;
55+ command = obelisk.command;
56+
57+ withSkeletonOptions = skel: options: (skel.passthru.__unstable__.self.extend (self: super: {
58+ userSettings = super.userSettings // options;
59+ })).project;
60+ rawSkeleton = import ./skeleton { inherit obelisk; };
61+ skeleton = withSkeletonOptions rawSkeleton {
62+ withHoogle = true; # cache the Hoogle database for the skeleton
63+ __withGhcide = true; # cache the ghcide build for the skeleton
64+ };
65+
66+ serverSkeletonExe = rawSkeleton.exe;
67+ # TODO fix nixpkgs so it doesn't try to run the result of haskell shells as setup hooks.
68+ serverSkeletonShell = local-self.nixpkgs.runCommand "shell-safe-for-dep" {} ''
69+ touch "$out"
70+ echo "return" >> "$out"
71+ cat "${skeleton.shells.ghc}" >> "$out"
72+ '';
73+ androidSkeleton = skeleton.android.frontend;
74+ iosSkeleton = skeleton.ios.frontend;
75+ nameSuffix = if profiling then "profiled" else "unprofiled";
76+ packages = {
77+ skeletonProfiledObRun = rawSkeleton.__unstable__.profiledObRun;
78+ inherit
79+ command
80+ serverSkeletonShell
81+ ghc
82+ ;
83+ } // lib.optionalAttrs (!profiling) {
84+ inherit
85+ ghcjs
86+ serverSkeletonExe
87+ ;
88+ } // lib.optionalAttrs reflex-platform.androidSupport {
89+ inherit androidSkeleton;
90+ } // lib.optionalAttrs reflex-platform.iosSupport {
91+ inherit iosSkeleton;
92+ };
93+ in packages // {
94+ cache = reflex-platform.pinBuildInputs
95+ "obelisk-${system}-${nameSuffix}"
96+ (collect packages);
97+ };
98+
99+ perProfiling = {
100+ profiled = mkPerProfiling true;
101+ unprofiled = mkPerProfiling false;
102+ };
103+ in perProfiling // {
104+ cache = reflex-platform.pinBuildInputs
105+ "obelisk-${system}"
106+ (map (p: p.cache) (builtins.attrValues perProfiling));
107+ });
108+
109+ metaCache = local-self.reflex-platform.pinBuildInputs
110+ "obelisk-everywhere"
111+ (map (a: a.cache) (builtins.attrValues perPlatform));
112+
113+in perPlatform // { inherit metaCache; }
all-tests.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+261−211
@@ -1,178 +1,123 @@
1{ system ? builtins.currentSystem
1{ system ? builtins.currentSystem
2, profiling ? false
2, profiling ? false
3−, iosSdkVersion ? "10.2"
3+, iosSdkVersion ? "13.2"
4+, config ? {}
5+, terms ? { # Accepted terms, conditions, and licenses
6+ security.acme.acceptTerms = false;
7+ }
8+, reflex-platform-func ? import ./dep/reflex-platform
4}:
9}:
5let
10let
6− getReflexPlatform = sys: import ./dep/reflex-platform { inherit iosSdkVersion; system = sys; enableLibraryProfiling = profiling; };
11+ reflex-platform = getReflexPlatform { inherit system; };
7− reflex-platform = getReflexPlatform system;
8 inherit (reflex-platform) hackGet nixpkgs;
12 inherit (reflex-platform) hackGet nixpkgs;
9 pkgs = nixpkgs;
13 pkgs = nixpkgs;
10−in with pkgs.haskell.lib; with pkgs.lib;
11−let
12− # TODO: Remove this after updating nixpkgs: https://github.com/NixOS/nixpkgs/issues/37750
13− justStaticExecutables' = drv: let
14− drv' = justStaticExecutables drv;
15− in if pkgs.stdenv.isDarwin
16− then removeConfigureFlag drv' "--ghc-option=-optl=-dead_strip"
17− else drv';
18−
19− commandRuntimeDeps = pkgs: with pkgs; [
20− coreutils
21− git
22− gitAndTools.hub
23− nix-prefetch-git
24− openssh
25− ];
26−
27− #TODO: Upstream
28− # Modify a Haskell package to add completion scripts for the given
29− # executable produced by it. These completion scripts will be picked up
30− # automatically if the resulting derivation is installed, e.g. by
31− # `nix-env -i`.
32− addOptparseApplicativeCompletionScripts = exeName: pkg: overrideCabal pkg (drv: {
33− postInstall = (drv.postInstall or "") + ''
34− BASH_COMP_DIR="$out/share/bash-completion/completions"
35− mkdir -p "$BASH_COMP_DIR"
36− "$out/bin/${exeName}" --bash-completion-script "$out/bin/${exeName}" >"$BASH_COMP_DIR/ob"
37−
38− ZSH_COMP_DIR="$out/share/zsh/vendor-completions"
39− mkdir -p "$ZSH_COMP_DIR"
40− "$out/bin/${exeName}" --zsh-completion-script "$out/bin/${exeName}" >"$ZSH_COMP_DIR/_ob"
41−
42− FISH_COMP_DIR="$out/share/fish/vendor_completions.d"
43− mkdir -p "$FISH_COMP_DIR"
44− "$out/bin/${exeName}" --fish-completion-script "$out/bin/${exeName}" >"$FISH_COMP_DIR/ob.fish"
45− '';
46− });
47
14
48− # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
15+ inherit (import dep/gitignore.nix { inherit (nixpkgs) lib; }) gitignoreSource;
49− ghcObelisk = reflex-platform.ghc.override {
50− overrides = composeExtensions defaultHaskellOverrides (self: super: {
51− # Dynamic linking with split objects dramatically increases startup time (about 0.5 seconds on a decent machine with SSD)
52− obelisk-command = addOptparseApplicativeCompletionScripts "ob" (justStaticExecutables' super.obelisk-command);
53− });
54− };
55
16
56− fixUpstreamPkgs = self: super: {
17+ getReflexPlatform = { system, enableLibraryProfiling ? profiling }: reflex-platform-func {
57− algebraic-graphs = pkgs.haskell.lib.doJailbreak
18+ inherit iosSdkVersion config system enableLibraryProfiling;
58− (self.callCabal2nix "algebraic-graphs" (pkgs.fetchFromGitHub {
59− owner = "snowleopard";
60− repo = "alga";
61− rev = "480a73137e9b38ad3f1bc2c628847953d2fb3e25";
62− sha256 = "0dpwi5ffs88brl3lz51bwb004c6zm8ds8pkw1vzsg2a6aaiyhlzl";
63− }) {});
64−
65− # Need deriveSomeUniverse
66− # PR: https://github.com/dmwit/universe/pull/32
67− universe-template = self.callCabal2nix "universe-template" (pkgs.fetchFromGitHub {
68− owner = "obsidiansystems";
69− repo = "universe";
70− rev = "5a2fc823caa4163411d7e41aa80e67cefb15944a";
71− sha256 = "0ll2z0fh18z6x8jl8kbp7ldagwccz3wjmvrw1gw752z058n82yfa";
72− } + /template) {};
73− };
74
19
75− cleanSource = builtins.filterSource (name: _: let baseName = builtins.baseNameOf name; in !(
20+ nixpkgsOverlays = [
76− builtins.match "^\\.ghc\\.environment.*" baseName != null ||
21+ (import ./nixpkgs-overlays)
77− baseName == "cabal.project.local"
22+ ];
78− ));
23+
79−
24+ haskellOverlays = [
80− executableConfig = import ./lib/executable-config { nixpkgs = pkgs; filterGitSource = cleanSource; };
25+ (import ./haskell-overlays/misc-deps.nix { inherit hackGet; })
81−
26+ pkgs.obeliskExecutableConfig.haskellOverlay
82− addLibs = self: super: {
27+ (import ./haskell-overlays/obelisk.nix)
83− obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (hackGet ./lib/asset + "/manifest") {};
28+ (import ./haskell-overlays/tighten-ob-exes.nix)
84− obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (hackGet ./lib/asset + "/serve-snap") {};
29+ ];
85− obelisk-backend = self.callCabal2nix "obelisk-backend" (cleanSource ./lib/backend) {};
86− obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (cleanSource ./lib/cliapp) {};
87− obelisk-command = (self.callCabal2nix "obelisk-command" (cleanSource ./lib/command) {}).overrideAttrs
88− (drv: {
89− buildInputs = drv.buildInputs ++ [ pkgs.makeWrapper ];
90− postInstall = ''
91− ${drv.postInstall or ""}
92− # Install migrations
93− cp -r ${./migration} $out/migration;
94− '';
95− postFixup = ''
96− ${drv.postFixup or ""}
97− # Make `ob` reference its runtime dependencies.
98− wrapProgram "$out"/bin/ob --prefix PATH : ${pkgs.lib.makeBinPath (commandRuntimeDeps pkgs)}
99− '';
100− });
101− obelisk-executable-config = executableConfig.haskellPackage self;
102− obelisk-executable-config-inject = executableConfig.platforms.web.inject self;
103− obelisk-frontend = self.callCabal2nix "obelisk-frontend" (cleanSource ./lib/frontend) {};
104− obelisk-migration = self.callCabal2nix "obelisk-migration" (cleanSource ./lib/migration) {};
105− obelisk-run = self.callCabal2nix "obelisk-run" (cleanSource ./lib/run) {};
106− obelisk-route = self.callCabal2nix "obelisk-route" (cleanSource ./lib/route) {};
107− obelisk-selftest = self.callCabal2nix "obelisk-selftest" (cleanSource ./lib/selftest) {};
108− obelisk-snap = self.callCabal2nix "obelisk-snap" (cleanSource ./lib/snap) {};
109− obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (cleanSource ./lib/snap-extras) {};
110 };
30 };
111
31
32+ # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
33+ ghcObelisk = reflex-platform.ghc;
34+
35+ # Development environments for obelisk packages.
36+ ghcObeliskEnvs = pkgs.lib.mapAttrs (n: v: reflex-platform.workOn ghcObelisk v) ghcObelisk;
37+
112 inherit (import ./lib/asset/assets.nix { inherit nixpkgs; }) mkAssets;
38 inherit (import ./lib/asset/assets.nix { inherit nixpkgs; }) mkAssets;
113
39
114− defaultHaskellOverrides = composeExtensions fixUpstreamPkgs addLibs;
115−in
116−with pkgs.lib;
40+ haskellLib = pkgs.haskell.lib;
41+
117−rec {
42+in rec {
118 inherit reflex-platform;
43 inherit reflex-platform;
119 inherit (reflex-platform) nixpkgs pinBuildInputs;
44 inherit (reflex-platform) nixpkgs pinBuildInputs;
45+ inherit (nixpkgs) lib;
120 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
46 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
121 path = reflex-platform.filterGit ./.;
47 path = reflex-platform.filterGit ./.;
122 obelisk = ghcObelisk;
48 obelisk = ghcObelisk;
49+ obeliskEnvs = pkgs.lib.filterAttrs (k: _: k == "tabulation" || pkgs.lib.strings.hasPrefix "obelisk-" k) ghcObeliskEnvs; #TODO: use thunkSet https://github.com/reflex-frp/reflex-platform/pull/671
123 command = ghcObelisk.obelisk-command;
50 command = ghcObelisk.obelisk-command;
124− shell = pinBuildInputs "obelisk-shell" ([command] ++ commandRuntimeDeps pkgs) [];
51+ shell = pinBuildInputs "obelisk-shell" ([command] ++ command.commandRuntimeDeps);
125
52
126 selftest = pkgs.writeScript "selftest" ''
53 selftest = pkgs.writeScript "selftest" ''
127− #!/usr/bin/env bash
54+ #!${pkgs.runtimeShell}
128 set -euo pipefail
55 set -euo pipefail
129
56
130 PATH="${command}/bin:$PATH"
57 PATH="${command}/bin:$PATH"
131− export OBELISK_IMPL="${hackGet ./.}"
58+ cd ${./.}
132− "${justStaticExecutables' ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" "$@"
59+ "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
133 '';
60 '';
134− #TODO: Why can't I build ./skeleton directly as a derivation? `nix-build -E ./.` doesn't work
135 skeleton = pkgs.runCommand "skeleton" {
61 skeleton = pkgs.runCommand "skeleton" {
136 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
62 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
137 } ''
63 } ''
138 ln -s "$dir" "$out"
64 ln -s "$dir" "$out"
139 '';
65 '';
140− nullIfAbsent = p: if pathExists p then p else null;
66+ nullIfAbsent = p: if lib.pathExists p then p else null;
141− haskellOverrides = addLibs;
142 #TODO: Avoid copying files within the nix store. Right now, obelisk-asset-manifest-generate copies files into a big blob so that the android/ios static assets can be imported from there; instead, we should get everything lined up right before turning it into an APK, so that copies, if necessary, only exist temporarily.
67 #TODO: Avoid copying files within the nix store. Right now, obelisk-asset-manifest-generate copies files into a big blob so that the android/ios static assets can be imported from there; instead, we should get everything lined up right before turning it into an APK, so that copies, if necessary, only exist temporarily.
143 processAssets = { src, packageName ? "obelisk-generated-static", moduleName ? "Obelisk.Generated.Static" }: pkgs.runCommand "asset-manifest" {
68 processAssets = { src, packageName ? "obelisk-generated-static", moduleName ? "Obelisk.Generated.Static" }: pkgs.runCommand "asset-manifest" {
144 inherit src;
69 inherit src;
145 outputs = [ "out" "haskellManifest" "symlinked" ];
70 outputs = [ "out" "haskellManifest" "symlinked" ];
146− buildInputs = [
71+ nativeBuildInputs = [ ghcObelisk.obelisk-asset-manifest ];
147− (reflex-platform.ghc.callCabal2nix "obelisk-asset-manifest" (hackGet ./lib/asset + "/manifest") {})
148− ];
149 } ''
72 } ''
150 set -euo pipefail
73 set -euo pipefail
151 touch "$out"
74 touch "$out"
75+ mkdir -p "$symlinked"
152 obelisk-asset-manifest-generate "$src" "$haskellManifest" ${packageName} ${moduleName} "$symlinked"
76 obelisk-asset-manifest-generate "$src" "$haskellManifest" ${packageName} ${moduleName} "$symlinked"
153 '';
77 '';
154
78
155− compressedJs = frontend: pkgs.runCommand "compressedJs" { buildInputs = [ pkgs.closurecompiler ]; } ''
79+ compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
156− mkdir $out
80+ set -euo pipefail
157− cd $out
158− ln -s "${justStaticExecutables frontend}/bin/frontend.jsexe/all.js" all.unminified.js
81+ cd '${haskellLib.justStaticExecutables frontend}'
82+ shopt -s globstar
83+ for f in **/all.js; do
84+ dir="$out/$(basename "$(dirname "$f")")"
85+ mkdir -p "$dir"
86+ ln -s "$(realpath "$f")" "$dir/all.unminified.js"
87+ ${if optimizationLevel == null then ''
88+ ln -s "$dir/all.unminified.js" "$dir/all.js"
89+ '' else ''
159− closure-compiler --externs "${reflex-platform.ghcjsExternsJs}" -O ADVANCED --jscomp_warning=checkVars --create_source_map="all.js.map" --source_map_format=V3 --js_output_file="all.js" all.unminified.js
90+ '${pkgs.closurecompiler}/bin/closure-compiler' --externs '${reflex-platform.ghcjsExternsJs}' -O '${optimizationLevel}' --jscomp_warning=checkVars --create_source_map="$dir/all.js.map" --source_map_format=V3 --js_output_file="$dir/all.js" "$dir/all.unminified.js"
160− echo "//# sourceMappingURL=all.js.map" >> all.js
91+ echo '//# sourceMappingURL=all.js.map' >> "$dir/all.js"
92+ ''}
93+ done
161 '';
94 '';
162
95
163 serverModules = {
96 serverModules = {
164− mkBaseEc2 = { hostName, routeHost, enableHttps, adminEmail, ... }: {...}: {
97+ mkBaseEc2 = { nixosPkgs, ... }: {...}: {
165 imports = [
98 imports = [
166− (pkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
99+ (nixosPkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
167 ];
100 ];
101+ ec2.hvm = true;
102+ };
103+
104+ mkDefaultNetworking = { adminEmail, enableHttps, hostName, routeHost, ... }: {...}: {
168 networking = {
105 networking = {
169 inherit hostName;
106 inherit hostName;
170 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
107 firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
171 };
108 };
109+
110+ # `amazon-image.nix` already sets these but if the user provides their own module then
111+ # forgetting these can cause them to lose access to the server!
112+ # https://github.com/NixOS/nixpkgs/blob/fab05f17d15e4e125def4fd4e708d205b41d8d74/nixos/modules/virtualisation/amazon-image.nix#L133-L136
113+ services.openssh.enable = true;
114+ services.openssh.permitRootLogin = "prohibit-password";
115+
172 security.acme.certs = if enableHttps then {
116 security.acme.certs = if enableHttps then {
173 "${routeHost}".email = adminEmail;
117 "${routeHost}".email = adminEmail;
174 } else {};
118 } else {};
175− ec2.hvm = true;
119+
120+ security.acme.${if enableHttps && (terms.security.acme.acceptTerms or false) then "acceptTerms" else null} = true;
176 };
121 };
177
122
178 mkObeliskApp =
123 mkObeliskApp =
@@ -189,11 +134,16 @@ rec {
189 }: {...}: {
134 }: {...}: {
190 services.nginx = {
135 services.nginx = {
191 enable = true;
136 enable = true;
137+ recommendedProxySettings = true;
192 virtualHosts."${routeHost}" = {
138 virtualHosts."${routeHost}" = {
193 enableACME = enableHttps;
139 enableACME = enableHttps;
194 forceSSL = enableHttps;
140 forceSSL = enableHttps;
195 locations.${baseUrl} = {
141 locations.${baseUrl} = {
196− proxyPass = "http://localhost:" + toString internalPort;
142+ proxyPass = "http://127.0.0.1:" + toString internalPort;
143+ proxyWebsockets = true;
144+ extraConfig = ''
145+ access_log off;
146+ '';
197 };
147 };
198 };
148 };
199 };
149 };
@@ -201,10 +151,11 @@ rec {
201 wantedBy = [ "multi-user.target" ];
151 wantedBy = [ "multi-user.target" ];
202 after = [ "network.target" ];
152 after = [ "network.target" ];
203 restartIfChanged = true;
153 restartIfChanged = true;
154+ path = [ pkgs.gnutar ];
204 script = ''
155 script = ''
205 ln -sft . '${exe}'/*
156 ln -sft . '${exe}'/*
206 mkdir -p log
157 mkdir -p log
207− exec ./backend ${backendArgs} >>backend.out 2>>backend.err </dev/null
158+ exec ./backend ${backendArgs} </dev/null
208 '';
159 '';
209 serviceConfig = {
160 serviceConfig = {
210 User = user;
161 User = user;
@@ -227,116 +178,215 @@ rec {
227 };
178 };
228 };
179 };
229
180
181+ inherit mkAssets;
182+
230− serverExe = backend: frontend: assets: config:
183+ serverExe = backend: frontend: assets: optimizationLevel: version:
231 pkgs.runCommand "serverExe" {} ''
184 pkgs.runCommand "serverExe" {} ''
232 mkdir $out
185 mkdir $out
233 set -eux
186 set -eux
234− ln -s "${justStaticExecutables backend}"/bin/* $out/
187+ ln -s '${if profiling then backend else haskellLib.justStaticExecutables backend}'/bin/* $out/
235− ln -s "${mkAssets assets}" $out/static.assets
188+ ln -s '${mkAssets assets}' $out/static.assets
236− cp -r ${config} $out/config
237− ln -s ${mkAssets (compressedJs frontend)} $out/frontend.jsexe.assets
189+ for d in '${mkAssets (compressedJs frontend optimizationLevel)}'/*/; do
190+ ln -s "$d" "$out"/"$(basename "$d").assets"
191+ done
192+ echo ${version} > $out/version
238 '';
193 '';
239
194
240− server = { exe, hostName, adminEmail, routeHost, enableHttps, config }@args:
195+ server = { exe, hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }@args:
241 let
196 let
242 nixos = import (pkgs.path + /nixos);
197 nixos = import (pkgs.path + /nixos);
243 in nixos {
198 in nixos {
244 system = "x86_64-linux";
199 system = "x86_64-linux";
245 configuration = {
200 configuration = {
246 imports = [
201 imports = [
202+ (module { inherit exe hostName adminEmail routeHost enableHttps version; nixosPkgs = pkgs; })
247− (serverModules.mkBaseEc2 args)
203+ (serverModules.mkDefaultNetworking args)
248 (serverModules.mkObeliskApp args)
204 (serverModules.mkObeliskApp args)
205+ ./acme.nix # Backport of ACME upgrades from 20.03
206+ ];
207+
208+ # Backport of ACME upgrades from 20.03
209+ disabledModules = [
210+ (pkgs.path + /nixos/modules/security/acme.nix)
211+ ];
212+ nixpkgs.overlays = [
213+ (self: super: {
214+ lego = (import (builtins.fetchTarball {
215+ url = https://github.com/NixOS/nixpkgs-channels/archive/70717a337f7ae4e486ba71a500367cad697e5f09.tar.gz;
216+ sha256 = "1sbmqn7yc5iilqnvy9nvhsa9bx6spfq1kndvvis9031723iyymd1";
217+ }) {}).lego;
218+ })
249 ];
219 ];
250 };
220 };
251 };
221 };
252
222
253−
254 # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
223 # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
255− project = base: projectDefinition:
224+ project = base': projectDefinition:
256− let configPath = base + "/config";
225+ let
257− static = base + "/static";
258− processedStatic = processAssets { src = static; };
259− projectOut = sys: (getReflexPlatform sys).project (args@{ nixpkgs, ... }:
226+ projectOut = { system, enableLibraryProfiling ? profiling }: let reflexPlatformProject = (getReflexPlatform { inherit system enableLibraryProfiling; }).project; in reflexPlatformProject (args@{ nixpkgs, ... }:
227+ let
228+ inherit (lib.strings) hasPrefix;
229+ mkProject =
260− let mkProject = { android ? null #TODO: Better error when missing
230+ { android ? null #TODO: Better error when missing
261− , ios ? null #TODO: Better error when missing
231+ , ios ? null #TODO: Better error when missing
262− , packages ? {}
232+ , packages ? {}
263− , overrides ? _: _: {}
233+ , overrides ? _: _: {}
234+ , staticFiles ? null
264− , tools ? _: []
235+ , tools ? _: []
265− , shellToolOverrides ? _: _: {}
236+ , shellToolOverrides ? _: _: {}
266− , withHoogle ? false # Setting this to `true` makes shell reloading far slower
237+ , withHoogle ? false # Setting this to `true` makes shell reloading far slower
267− }:
238+ , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
268− let frontendName = "frontend";
239+ , __withGhcide ? false
269− backendName = "backend";
270− commonName = "common";
271− staticName = "obelisk-generated-static";
272− staticPath = base + "/static";
273− # The packages whose names and roles are defined by this package
274− predefinedPackages = filterAttrs (_: x: x != null) {
275− ${frontendName} = nullIfAbsent (base + "/frontend");
276− ${commonName} = nullIfAbsent (base + "/common");
277− ${backendName} = nullIfAbsent (base + "/backend");
278− };
240+ }:
279− combinedPackages = predefinedPackages // packages;
241+ let
280− projectOverrides = self: super: {
242+ allConfig = nixpkgs.lib.makeExtensible (self: {
281− ${staticName} = dontHaddock (self.callCabal2nix "static" processedStatic.haskellManifest {});
243+ base = base';
282− ${backendName} = addBuildDepend super.${backendName} self.obelisk-run;
244+ inherit args;
283− };
245+ userSettings = {
284− totalOverrides = composeExtensions (composeExtensions defaultHaskellOverrides projectOverrides) overrides;
246+ inherit android ios packages overrides tools shellToolOverrides withHoogle __closureCompilerOptimizationLevel __withGhcide;
285− inherit (nixpkgs) lib;
247+ staticFiles = if staticFiles == null then self.base + /static else staticFiles;
286− inherit (lib.strings) hasPrefix;
287− privateConfigDirs = ["config/backend"];
288− injectableConfig = builtins.filterSource (path: _:
289− !(lib.lists.any (x: hasPrefix (toString base + "/" + toString x) (toString path)) privateConfigDirs)
290− ) configPath;
291− in {
292− inherit shellToolOverrides tools withHoogle;
293− overrides = totalOverrides;
294− packages = combinedPackages;
295− shells = {
296− ghcSavedSplices = (filter (x: hasAttr x combinedPackages) [
297− commonName
298− frontendName
299− ]);
300− ghc = (filter (x: hasAttr x combinedPackages) [
301− backendName
302− commonName
303− frontendName
304− ]);
305− ghcjs = filter (x: hasAttr x combinedPackages) [
306− frontendName
307− commonName
308− ];
309 };
248 };
310− android = {
249+ frontendName = "frontend";
250+ backendName = "backend";
251+ commonName = "common";
252+ staticName = "obelisk-generated-static";
253+ staticFilesImpure = let fs = self.userSettings.staticFiles; in if lib.isDerivation fs then fs else toString fs;
254+ processedStatic = processAssets { src = self.userSettings.staticFiles; };
255+ # The packages whose names and roles are defined by this package
256+ predefinedPackages = lib.filterAttrs (_: x: x != null) {
257+ ${self.frontendName} = nullIfAbsent (self.base + "/frontend");
258+ ${self.commonName} = nullIfAbsent (self.base + "/common");
259+ ${self.backendName} = nullIfAbsent (self.base + "/backend");
260+ };
261+ shellPackages = {};
262+ combinedPackages = self.predefinedPackages // self.userSettings.packages // self.shellPackages;
263+ projectOverrides = self': super': {
264+ ${self.staticName} = haskellLib.dontHaddock (self'.callCabal2nix self.staticName self.processedStatic.haskellManifest {});
265+ ${self.backendName} = haskellLib.addBuildDepend super'.${self.backendName} self'.obelisk-run;
266+ };
267+ totalOverrides = lib.composeExtensions self.projectOverrides self.userSettings.overrides;
268+ privateConfigDirs = ["config/backend"];
269+ injectableConfig = builtins.filterSource (path: _:
270+ !(lib.lists.any (x: hasPrefix (toString self.base + "/" + toString x) (toString path)) self.privateConfigDirs)
271+ );
272+ __androidWithConfig = configPath: {
311− ${if android == null then null else frontendName} = {
273+ ${if self.userSettings.android == null then null else self.frontendName} = {
312 executableName = "frontend";
274 executableName = "frontend";
313− ${if builtins.pathExists staticPath then "assets" else null} =
275+ ${if builtins.pathExists self.userSettings.staticFiles then "assets" else null} =
276+ nixpkgs.obeliskExecutableConfig.platforms.android.inject
277+ (self.injectableConfig configPath)
314− executableConfig.platforms.android.inject injectableConfig processedStatic.symlinked;
278+ self.processedStatic.symlinked;
315− } // android;
279+ } // self.userSettings.android;
316 };
280 };
317− ios = {
281+ __iosWithConfig = configPath: {
318− ${if ios == null then null else frontendName} = {
282+ ${if self.userSettings.ios == null then null else self.frontendName} = {
319 executableName = "frontend";
283 executableName = "frontend";
320− ${if builtins.pathExists staticPath then "staticSrc" else null} =
284+ ${if builtins.pathExists self.userSettings.staticFiles then "staticSrc" else null} =
285+ nixpkgs.obeliskExecutableConfig.platforms.ios.inject
286+ (self.injectableConfig configPath)
321− executableConfig.platforms.ios.inject injectableConfig processedStatic.symlinked;
287+ self.processedStatic.symlinked;
322− } // ios;
288+ } // self.userSettings.ios;
289+ };
290+
291+ shells-ghc = builtins.attrNames (self.predefinedPackages // self.shellPackages);
292+
293+ shells-ghcjs = [
294+ self.frontendName
295+ self.commonName
296+ ];
297+
298+ shells-ghcSavedSplices = [
299+ self.commonName
300+ self.frontendName
301+ ];
302+
303+ shellToolOverrides = lib.composeExtensions
304+ self.userSettings.shellToolOverrides
305+ (if self.userSettings.__withGhcide
306+ then (import ./haskell-overlays/ghcide.nix)
307+ else (_: _: {})
308+ );
309+
310+ project = reflexPlatformProject ({...}: self.projectConfig);
311+ projectConfig = {
312+ inherit (self) shellToolOverrides;
313+ inherit (self.userSettings) tools withHoogle;
314+ overrides = self.totalOverrides;
315+ packages = self.combinedPackages;
316+ shells = {
317+ ${if self.userSettings.android == null && self.userSettings.ios == null then null else "ghcSavedSplices"} =
318+ lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghcSavedSplices;
319+ ghc = lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghc;
320+ ghcjs = lib.filter (x: lib.hasAttr x self.combinedPackages) self.shells-ghcjs;
321+ };
322+ android = self.__androidWithConfig (self.base + "/config");
323+ ios = self.__iosWithConfig (self.base + "/config");
324+
325+ passthru = {
326+ __unstable__.self = allConfig;
327+ inherit (self)
328+ staticFilesImpure processedStatic
329+ __iosWithConfig __androidWithConfig
330+ ;
331+ inherit (self.userSettings)
332+ android ios overrides packages shellToolOverrides staticFiles tools withHoogle
333+ __closureCompilerOptimizationLevel
334+ ;
335+ };
323 };
336 };
324− };
337+ });
338+ in allConfig;
325− in mkProject (projectDefinition args));
339+ in (mkProject (projectDefinition args)).projectConfig);
326− serverOn = sys: config: serverExe (projectOut sys).ghc.backend (projectOut system).ghcjs.frontend static config;
340+ mainProjectOut = projectOut { inherit system; };
341+ serverOn = projectInst: version: serverExe
342+ projectInst.ghc.backend
343+ mainProjectOut.ghcjs.frontend
344+ projectInst.passthru.staticFiles
345+ projectInst.passthru.__closureCompilerOptimizationLevel
346+ version;
327− linuxExe = serverOn "x86_64-linux";
347+ linuxExe = serverOn (projectOut { system = "x86_64-linux"; });
328− in projectOut system // {
348+ dummyVersion = "Version number is only available for deployments";
349+ in mainProjectOut // {
350+ __unstable__.profiledObRun = let
351+ profiled = projectOut { inherit system; enableLibraryProfiling = true; };
352+ exeSource = builtins.toFile "ob-run.hs" ''
353+ {-# LANGUAGE NoImplicitPrelude #-}
354+ {-# LANGUAGE PackageImports #-}
355+ module Main where
356+
357+ -- Explicitly import Prelude from base lest there be multiple modules called Prelude
358+ import "base" Prelude (IO, (++), read)
359+
360+ import "base" Control.Exception (finally)
361+ import "reflex" Reflex.Profiled (writeProfilingData)
362+ import "base" System.Environment (getArgs)
363+
364+ import qualified "obelisk-run" Obelisk.Run
365+ import qualified Frontend
366+ import qualified Backend
367+
368+ main :: IO ()
369+ main = do
370+ [portStr, assets, profFileName] <- getArgs
371+ Obelisk.Run.run (read portStr) (Obelisk.Run.runServeAsset assets) Backend.backend Frontend.frontend
372+ `finally` writeProfilingData (profFileName ++ ".rprof")
373+ '';
374+ in nixpkgs.runCommand "ob-run" {
375+ buildInputs = [ (profiled.ghc.ghcWithPackages (p: [p.backend p.frontend])) ];
376+ } ''
377+ cp ${exeSource} ob-run.hs
378+ mkdir -p $out/bin
379+ ghc -x hs -prof -fno-prof-auto -threaded ob-run.hs -o $out/bin/ob-run
380+ '';
381+
329 linuxExeConfigurable = linuxExe;
382 linuxExeConfigurable = linuxExe;
330− linuxExe = linuxExe (base + "/config");
383+ linuxExe = linuxExe dummyVersion;
331− exe = serverOn system (base + "/config") ;
384+ exe = serverOn mainProjectOut dummyVersion;
332− server = args@{ hostName, adminEmail, routeHost, enableHttps, config }: let
385+ server = args@{ hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }:
333− injectableConfig = builtins.filterSource (path: _: !(hasPrefix (toString config + "/backend") (toString path))) config;
334− in server (args // { exe = linuxExe injectableConfig; });
386+ server (args // { exe = linuxExe version; });
335− obelisk = import (base + "/.obelisk/impl") {};
387+ obelisk = import (base' + "/.obelisk/impl") {};
336 };
388 };
337 haskellPackageSets = {
389 haskellPackageSets = {
338− ghc = reflex-platform.ghc.override {
390+ inherit (reflex-platform) ghc ghcjs;
339− overrides = defaultHaskellOverrides;
340− };
341 };
391 };
342}
392}
dep/.gitignoredeleted−4
@@ -1,4 +0,0 @@
1−*
2−!.gitignore
3−!*/*.json
4−!*/default.nix
dep/ghcid/default.nixnew file+7
@@ -0,0 +1,7 @@
1+# DO NOT HAND-EDIT THIS FILE
2+import ((import <nixpkgs> {}).fetchFromGitHub (
3+ let json = builtins.fromJSON (builtins.readFile ./github.json);
4+ in { inherit (json) owner repo rev sha256;
5+ private = json.private or false;
6+ }
7+))
dep/ghcid/github.jsonnew file+7
@@ -0,0 +1,7 @@
1+{
2+ "owner": "ndmitchell",
3+ "repo": "ghcid",
4+ "branch": "master",
5+ "rev": "f572318f32b1617f6054248e5888af68222f8e50",
6+ "sha256": "1icg3r70lg2kmd9gdc024ih1n9nrja98yav74z9nvykqygvv5w0n"
7+}
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/hnix/default.nixnew file+7
@@ -0,0 +1,7 @@
1+# DO NOT HAND-EDIT THIS FILE
2+import ((import <nixpkgs> {}).fetchFromGitHub (
3+ let json = builtins.fromJSON (builtins.readFile ./github.json);
4+ in { inherit (json) owner repo rev sha256;
5+ private = json.private or false;
6+ }
7+))
dep/hnix/github.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/reflex-platform/default.nix+1−6
@@ -1,7 +1,2 @@
1# DO NOT HAND-EDIT THIS FILE
1# DO NOT HAND-EDIT THIS FILE
2−import ((import <nixpkgs> {}).fetchFromGitHub (
2+import (import ./thunk.nix)
3− let json = builtins.fromJSON (builtins.readFile ./github.json);
4− in { inherit (json) owner repo rev sha256;
5− private = json.private or false;
6− }
7−))
dep/reflex-platform/github.json+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.7.0.0",
5− "rev": "2f09cea8aea453969172fe1f499905af5afb4719",
5+ "private": false,
6− "sha256": "1v7v2fwahq4mcywjvg1i44jyqimpxd4kgn4x4a24lcdgw9yll9wg"
6+ "rev": "27a7851a780ff21472d85f9a02fb84635ef9027a",
7+ "sha256": "1m4zlw91dpjlbdchjyxhvhv3k7lilm0qa17dhhww868xxc27sann"
7}
8}
dep/reflex-platform/thunk.nixnew file+9
@@ -0,0 +1,9 @@
1+# DO NOT HAND-EDIT THIS FILE
2+let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
3+ if !fetchSubmodules && !private then builtins.fetchTarball {
4+ url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
5+ } else (import <nixpkgs> {}).fetchFromGitHub {
6+ inherit owner repo rev sha256 fetchSubmodules private;
7+ };
8+ json = builtins.fromJSON (builtins.readFile ./github.json);
9+in fetch json
dep/snap-core/default.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+}
docs/obelisk-logo-640.pngnew file

Binary file not shown.

guides/app-deploy/README.mdnew file+324
@@ -0,0 +1,324 @@
1+# Obelisk Application Deployment Guide
2+
3+This document serves two purposes, the first one is to guide new users that want to deploy Obelisk/Reflex apps and the second one to provide a walk-through for test driving Obelisk releases.
4+
5+> **Note:** This guide can be completed on a Linux host with Nix installed or a macOS host with Nix installed. Each section is labeled regarding which operating system hosts it supports. When going through the guide, start at the beginning and go through all sections that are supported on your host and merely skip sections that are not supported. The sections for iOS deployments require an iPhone or iPad device and the sections for Android deployments require an Android device. This guide assumes that you have Nix correctly set up and that your system is configured to fetch from binary caches instead of building everything on your machine. If you notice any of the commands below takes more than 5 minutes, then caches are not likely enabled.
6+>
7+> Refer to the [Obelisk Installation Documentation](https://github.com/obsidiansystems/obelisk#installing-obelisk) for instructions on configuring the binary caches for any Nix-compatible setup.
8+
9+## a) Get Obelisk (Linux, Mac)
10+
11+There are several ways to install Obelisk, but the one we are going to use here allows us to test a single version of Obelisk in different ways. The approach is to clone Obelisk from its GitHub repository and start a project that uses that local check out.
12+
13+Open a terminal and run the following:
14+
15+```bash
16+export WORKDIR=~/obelisk-guide
17+mkdir -p "$WORKDIR"
18+```
19+
20+Then let's get Obelisk from GitHub using a specific branch:
21+
22+```bash
23+export OBELISK_BRANCH=develop
24+git clone https://github.com/obsidiansystems/obelisk.git -b "$OBELISK_BRANCH" "$WORKDIR/obelisk"
25+```
26+
27+Once you have an Obelisk check out, you can build it using Nix and make a shortcut (alias) for the rest of the terminal session. With this you will be able to type `ob` anywhere as long as you do not close the terminal.
28+
29+```bash
30+alias ob=$(nix-build "$WORKDIR/obelisk" -A command --no-out-link)/bin/ob
31+```
32+
33+In order to start an Obelisk project, we need initialize it in a new directory. Let's call it `myapp`:
34+
35+```bash
36+mkdir -p "$WORKDIR/myapp"
37+cd "$WORKDIR/myapp"
38+ob init --branch "$OBELISK_BRANCH"
39+```
40+
41+> **Note:** If the `--branch` parameter is not used, then Obelisk sets your project up to look at the `master` branch from GitHub. This is quite handy for real life projects but distracting for our test drive since we want to make sure any changes we do to the Obelisk codebase (like testing a pull request) are immediately picked up.
42+
43+## b) Run the Obelisk app on localhost (Linux, Mac)
44+
45+Let's test that we can run a server on localhost. This is quite easy:
46+
47+```bash
48+cd "$WORKDIR/myapp"
49+ob run
50+```
51+
52+Now open a browser and point it to http://localhost:8000 (or just click on this link). You should see the following:
53+
54+![](assets/app-deploy.png)
55+
56+## c) Prepare a VirtualBox deploy target (Linux, Mac)
57+
58+### Import the NixOS VirtualBox appliance
59+
60+Install [VirtualBox](https://www.virtualbox.org/) on your machine.
61+
62+On NixOS, do this by adding the following line to your `/etc/nixos/configuration.nix` before the last line containing `}`:
63+
64+```nix
65+ virtualisation.virtualbox.host.enable = true;
66+```
67+
68+then `sudo nixos-rebuild switch`.
69+
70+The NixOS [download page](https://nixos.org/nixos/download.html) has a section called "VirtualBox appliances". Download that as the target system. The author used the 19.09 `.ova` file.
71+
72+With the downloaded file, open VirtualBox and import the `.ova` file:
73+
74+![](assets/virtualbox-appliance-import.png)
75+
76+Leave the default settings and finish the import. That will take a few minutes:
77+
78+![](assets/virtualbox-appliance-import-loading.png)
79+
80+You should now see a NixOS machine in the dashboard:
81+
82+![](assets/virtualbox-dashboard-nixos.png)
83+
84+If you are on a network with DHCP on your wireless or network card then right-click on the "NixOS" image and click "Settings". Go to the "Network" section and make "Attached to:" set to "Bridged Adapter".
85+
86+![](assets/virtualbox-image-settings-network.png)
87+
88+Finally, double-click on the "NixOS" machine and wait for it boot up. If it asks for a password, use `demo`.
89+
90+![](assets/virtualbox-nioxs-after-boot.png)
91+
92+### Configure the virtual machine for SSH
93+
94+Inside the virtual machine open up "Konsole" by clicking on the start menu in the bottom left corner and typing in "Konsole" until you see it as an option in the menu. Then click on it to open it.
95+
96+Change the system configuration using `sudo` to enable SSH access:
97+
98+```bash
99+sudo nano /etc/nixos/configuration.nix
100+```
101+
102+This will ask you to enter your password. Enter `demo`.
103+
104+![](assets/nano-edit-nixos-configuration.png)
105+
106+You need to add the following snippet right before the final line containing `}`.
107+
108+```nix
109+ services.openssh.enable = true;
110+ services.openssh.permitRootLogin = "yes";
111+```
112+
113+Save and close the editor by typing <kbd>Ctrl</kbd>+<kbd>O</kbd>, <kbd>Enter</kbd>, and then <kbd>Ctrl</kbd>+<kbd>X</kbd>.
114+
115+Now run `sudo nixos-rebuild switch` (if it asks for a password, again use `demo`) and then set the root password using `sudo passwd root`. Pick a simple password like `root`. You'll need to use it again.
116+
117+To get the virtual machine's IP address go back to the terminal on your *host* machine (not the virtual machine) and run:
118+
119+```bash
120+export VM_ID=$(VBoxManage list runningvms | grep "NixOS" | awk -F'[{}]' '{print $2}')
121+echo "$VM_ID"
122+```
123+
124+You should see a single identifier that looks like `388bbbe5-e0a2-4b20-9c76-bbaa5746682e`. If you see anything else then you likely you have multiple NixOS machines running. Stop any other machines and run this command again. (Of course, if you're a power user, just change the `grep` to pick out right VM.)
125+
126+Now get the IP address for that machine:
127+
128+```bash
129+export VM_IP=$(VBoxManage guestproperty enumerate "$VM_ID" | grep /V4/IP | awk '{print $4}' | sed 's/,//')
130+echo "$VM_IP"
131+```
132+
133+You should see an IP like `192.168.7.86`.
134+
135+With that you will be able to SSH into that machine from a terminal, using the username `root`.
136+
137+```bash
138+ssh root@$VM_IP echo "Access granted"
139+```
140+
141+This may ask if you want to trust the fingerprint for this server. Answer `yes`. It will ask you for a password. Enter the one you specified above. You should see `Access granted` printed after you type your password and hit <kbd>Enter</kbd>.
142+
143+> **Note:** If instead you see an error like this
144+>
145+> ```
146+> @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
147+> @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
148+> @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
149+> IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
150+> Someone could be eavesdropping on you right now (man-in-the-middle attack)!
151+> It is also possible that a host key has just been changed.
152+> ```
153+>
154+> you need to remove the old fingerprint for this IP. Run the following:
155+>
156+> ```bash
157+> sed -i "/^$VM_IP /d" ~/.ssh/known_hosts
158+> ```
159+>
160+> and then try the previous `ssh` command again.
161+
162+Now we'll allow access with an SSH key instead of a password. Create a new SSH key with `ssh-keygen`:
163+
164+```bash
165+ssh-keygen -t ed25519 -f "$WORKDIR/obkey" -P ""
166+```
167+
168+Now copy your local SSH key to the server:
169+
170+```bash
171+ssh-copy-id -i "$WORKDIR/obkey.pub" root@$VM_IP
172+```
173+
174+This will ask you for your password again.
175+
176+Now test login with your key instead:
177+
178+```bash
179+ssh -i "$WORKDIR/obkey" root@$VM_IP echo "Access granted"
180+```
181+
182+This should print `Access granted` *without* asking for a password.
183+
184+### Configure the git remote
185+
186+Before the project can be deployed, it needs to be a valid `git` repository.
187+
188+> **Note:** You need `git` installed and configured. You can do that with:
189+>
190+> ```bash
191+> nix-env -i git
192+> git config --global user.name "John Doe"
193+> git config --global user.email johndoe@example.com
194+> ```
195+
196+```bash
197+git init --bare "$WORKDIR/myapp-git-remote"
198+cd "$WORKDIR/myapp"
199+git init
200+git add --all
201+git commit -m "initial commit"
202+git remote add origin "$WORKDIR/myapp-git-remote"
203+git push -u origin master
204+```
205+
206+### Initialize deployment directory
207+
208+With that, we can come back to the Obelisk app and initialize the deployment:
209+
210+```bash
211+cd "$WORKDIR/myapp"
212+ob deploy init --ssh-key "$WORKDIR/obkey" --admin-email a@a.a --hostname $VM_IP --route https://$VM_IP "$WORKDIR/myappdeploy" --disable-https
213+```
214+
215+Then configure the deployment for VirtualBox:
216+
217+```bash
218+echo '{nixosPkgs, ...}: {...}: { imports = [ (nixosPkgs.path + /nixos/modules/virtualisation/virtualbox-image.nix) ]; }' > "$WORKDIR/myappdeploy/module.nix"
219+```
220+
221+## d) Deploy to VirtualBox target (Linux only)
222+
223+> Deploying requires a Linux host in order to build the Linux binaries.
224+
225+Now we can deploy to the VirtualBox VM.
226+
227+```bash
228+cd "$WORKDIR/myappdeploy"
229+ob deploy push -v
230+```
231+
232+Once that is complete, open the webpage with
233+
234+```bash
235+xdg-open http://$VM_IP
236+```
237+
238+If that fails, just get the URL by running
239+
240+```bash
241+echo http://$VM_IP
242+```
243+
244+and copy/paste that URL into your browser navigation input.
245+
246+It should look like this:
247+
248+![](assets/app-deploy-2.png)
249+
250+Congratulations! You have deployed an Obelisk application to a remote server via SSH.
251+
252+## e) Deploy an Android app (Linux only)
253+
254+> **Note:** This section requires that you be running a Linux *host*.
255+
256+Modify `$WORKDIR/myapp/default.nix` to set `config.android_sdk.accept_license = true;` and then update your app.
257+
258+```bash
259+cd "$WORKDIR/myapp"
260+sed -i 's/# config.android_sdk.accept_license = false;/config.android_sdk.accept_license = true;/g' default.nix
261+git add default.nix
262+git commit -m"Accept license"
263+git push
264+```
265+
266+Make sure *USB debugging* is enabled in your Android device ([instructions here](https://developer.android.com/studio/debug/dev-options)) and connect the device using USB. Be sure to confirm any security prompts on the device.
267+
268+Now update your deployment and deploy to Android:
269+
270+```bash
271+cd "$WORKDIR/myappdeploy"
272+ob deploy update
273+ob deploy test android -v
274+```
275+
276+This deployment will ask you to create a password (at least 6 characters long) and then ask you a series of questions. You can pick arbitrary answers. When you are presented with prompt like:
277+
278+```
279+Is CN=a, OU=b, O=c, L=d, ST=e, C=f correct?
280+ [no]:
281+```
282+
283+You can enter `yes` to continue. If the deployment fails, try using different USB ports on your computer and running `ob deploy test android -v` again. The USB cable you use can also make a difference.
284+
285+When connecting your Android device you may be asked to "Allow USB debugging". You need to allow it.
286+![](assets/android-confirm-usb-debugging.jpg)
287+
288+
289+When the deployment is complete opening the app should look something like
290+
291+![](assets/android-app.jpg)
292+
293+Congratulations! You have deployed an Obelisk Android app via USB.
294+
295+## f) Deploy an iOS app (Mac only)
296+
297+> **Note:** This section requires that you be running a macOS *host*.
298+
299+Verify that you can see the device from XCode and you have installed a Provisioning profile that links your Apple Developer Id and the Device identifier. The workflow depends on whether or not you are an independent developer or part of an organization and is out of scope for this manual.
300+
301+![](assets/xcode-devices.png)
302+
303+Find your `Team ID` at the following URL (Apple Developer Membership details): https://developer.apple.com/account/#/membership/
304+
305+It will be something like `5B445B3WY1`. With that, you can start the deployment workflow after plugging in an iPhone or iPad via USB and setting it to trust the computer:
306+
307+```bash
308+cd "$WORKDIR/myappdeploy"
309+ob deploy test ios <TEAM-ID> # Use your Team ID here
310+```
311+
312+![](assets/ios-deploy-keychain.png)
313+
314+![](assets/ios-deploy-example.png)
315+
316+If there are no errors and the last line says `100% Installed Package` you can open the device and look for the Obelisk app:
317+
318+![](assets/ios-obelisk-app-icon.jpg)
319+
320+![](assets/ios-obelisk-app-open.jpg)
321+
322+Congratulations, you have deployed an Obelisk app on an iOS device.
323+
324+You are now ready to create your own multi-platform application using Obelisk!
guides/app-deploy/assets/android-app.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+40
@@ -0,0 +1,40 @@
1+self: super:
2+let
3+ pkgs = self.callPackage ({ pkgs }: pkgs) { };
4+ inherit (pkgs.haskell.lib) dontCheck justStaticExecutables;
5+ inherit (pkgs.haskellPackages) callHackageDirect callHackage;
6+
7+in {
8+ ghcide = justStaticExecutables (dontCheck (callHackageDirect {
9+ pkg = "ghcide";
10+ ver = "0.2.0";
11+ sha256 = "199l4qzrghhz6wbfkgqdl4gll4wvgpr190kinzhv88idnn9pxm96";
12+ } rec {
13+ ghc-check = callHackageDirect {
14+ pkg = "ghc-check";
15+ ver = "0.3.0.1";
16+ sha256 = "1dj909m09m24315x51vxvcl28936ahsw4mavbc53danif3wy09ns";
17+ } { };
18+ lsp-test = dontCheck (callHackage "lsp-test" "0.6.1.0" { });
19+ haddock-library = dontCheck (callHackage "haddock-library" "1.8.0" { });
20+ haskell-lsp = dontCheck (callHackageDirect {
21+ pkg = "haskell-lsp";
22+ ver = "0.22.0.0";
23+ sha256 = "1q3w46qcvzraxgmw75s7bl0qvb2fvff242r5vfx95sqska566b4m";
24+ } { inherit haskell-lsp-types; });
25+ haskell-lsp-types = dontCheck (callHackageDirect {
26+ pkg = "haskell-lsp-types";
27+ ver = "0.22.0.0";
28+ sha256 = "1apjclphi2v6ggrdnbc0azxbb1gkfj3x1vkwpc8qd6lsrbyaf0n8";
29+ } { });
30+ regex-tdfa = dontCheck (callHackage "regex-tdfa" "1.3.1.0" {
31+ regex-base = dontCheck (callHackage "regex-base" "0.94.0.0" { });
32+ });
33+ shake = dontCheck (callHackage "shake" "0.18.4" { });
34+ hie-bios = dontCheck (callHackageDirect {
35+ pkg = "hie-bios";
36+ ver = "0.5.0";
37+ sha256 = "116nmpva5jmlgc2dgy8cm5wv6cinhzmga1l0432p305074w720r2";
38+ } { });
39+ }));
40+}
haskell-overlays/misc-deps.nixnew file+26
@@ -0,0 +1,26 @@
1+{ hackGet }:
2+
3+# Fix misc upstream packages
4+self: super:
5+
6+let
7+ pkgs = self.callPackage ({ pkgs }: pkgs) {};
8+ haskellLib = pkgs.haskell.lib;
9+in
10+
11+{
12+ regex-base = self.callHackage "regex-base" "0.94.0.0" {};
13+ regex-posix = self.callHackage "regex-posix" "0.96.0.0" {};
14+ regex-tdfa = self.callHackage "regex-tdfa" "1.3.1.0" {};
15+ test-framework = haskellLib.dontCheck (self.callHackage "test-framework" "0.8.2.0" {});
16+ hnix = haskellLib.dontCheck (self.callHackage "hnix" "0.8.0" {});
17+ hnix-store-core = self.callHackage "hnix-store-core" "0.2.0.0" {};
18+
19+ aeson-gadt-th = self.callHackage "aeson-gadt-th" "0.2.4" {};
20+
21+ ghcid = self.callCabal2nix "ghcid" (hackGet ../dep/ghcid) {};
22+ # Exports more internals
23+ snap-core = haskellLib.dontCheck (self.callCabal2nix "snap-core" (hackGet ../dep/snap-core) {});
24+
25+ shelly = self.callHackage "shelly" "1.9.0" {};
26+}
haskell-overlays/obelisk.nixnew file+48
@@ -0,0 +1,48 @@
1+# Add obelisk packages
2+
3+self: super:
4+
5+let
6+ pkgs = self.callPackage ({ pkgs }: pkgs) {};
7+ inherit (pkgs) obeliskCleanSource;
8+ haskellLib = pkgs.haskell.lib;
9+ onLinux = pkg: f: if pkgs.stdenv.isLinux then f pkg else pkg;
10+in
11+
12+{
13+ obelisk-executable-config-inject = pkgs.obeliskExecutableConfig.platforms.web.inject self;
14+
15+ obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (obeliskCleanSource ../lib/asset/manifest) {};
16+ obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (obeliskCleanSource ../lib/asset/serve-snap) {};
17+ obelisk-backend = self.callCabal2nix "obelisk-backend" (obeliskCleanSource ../lib/backend) {};
18+ obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (obeliskCleanSource ../lib/cliapp) {};
19+ obelisk-command = haskellLib.overrideCabal (self.callCabal2nix "obelisk-command" (obeliskCleanSource ../lib/command) {}) {
20+ librarySystemDepends = [
21+ pkgs.jre
22+ pkgs.git
23+ pkgs.nix
24+ pkgs.nix-prefetch-git
25+ pkgs.openssh
26+ pkgs.rsync
27+ pkgs.which
28+ (haskellLib.justStaticExecutables self.ghcid)
29+ ];
30+ };
31+ obelisk-frontend = self.callCabal2nix "obelisk-frontend" (obeliskCleanSource ../lib/frontend) {};
32+ obelisk-run = onLinux (self.callCabal2nix "obelisk-run" (obeliskCleanSource ../lib/run) {}) (pkg:
33+ haskellLib.overrideCabal pkg (drv: { librarySystemDepends = [ pkgs.iproute ]; })
34+ );
35+ obelisk-route = self.callCabal2nix "obelisk-route" (obeliskCleanSource ../lib/route) {};
36+ obelisk-selftest = haskellLib.overrideCabal (self.callCabal2nix "obelisk-selftest" (obeliskCleanSource ../lib/selftest) {}) {
37+ librarySystemDepends = [
38+ pkgs.cabal-install
39+ pkgs.coreutils
40+ pkgs.git
41+ pkgs.nix
42+ pkgs.nix-prefetch-git
43+ pkgs.rsync
44+ ];
45+ };
46+ obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (obeliskCleanSource ../lib/snap-extras) {};
47+ tabulation = self.callCabal2nix "tabulation" (obeliskCleanSource ../lib/tabulation) {};
48+}
haskell-overlays/tighten-ob-exes.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−66
@@ -1,66 +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− };
33− branchJobset = branch: defaults {
34− description = "obelisk-${branch}";
35− inputs = {
36− obelisk = {
37− value = "https://github.com/obsidiansystems/obelisk ${branch}";
38− type = "git";
39− emailresponsible = false;
40− };
41− };
42− };
43− makePr = num: info: {
44− name = "obelisk-pr-${num}";
45− value = defaults {
46− description = "#${num}: ${info.title}";
47− inputs = {
48− obelisk = {
49− #NOTE: This should really use "pull/${num}/merge"; however, GitHub's
50− #status checks only operate on PR heads. This creates a race
51− #condition, which can currently only be solved by requiring PRs to be
52− #up to date before they're merged. See
53− #https://github.com/isaacs/github/issues/1002
54− value = "https://github.com/obsidiansystems/obelisk pull/${num}/head";
55− type = "git";
56− emailresponsible = false;
57− };
58− };
59− };
60− };
61− processedPrs = mapAttrs' makePr (builtins.fromJSON (builtins.readFile prs));
62− jobsetsAttrs = processedPrs //
63− genAttrs ["master"] branchJobset;
64−in {
65− jobsets = pkgs.writeText "spec.json" (builtins.toJSON jobsetsAttrs);
66−}
lib/asset/README.md+17−20
@@ -1,29 +1,26 @@
1−## obelisk-asset
1+# obelisk-asset
2
2
3−The 'assets.nix' file contains nix expressions that are a mutually
3+[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
4−recursive set of attributes used to create static asset directories
4+[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://github.com/obsidiansystems/obelisk/blob/master/LICENSE)
5−with hashable file encodings. This file should be incorporated within
6−your project's 'default.nix' file. (See ./example/default.nix , line 2)
7−```
8−{assets ? import ./../assets.nix { inherit nixpkgs; }
9−}:
10−```
11
5
12−The 'mkAssets' and 'mkAssetsWith' functions within 'assets.nix' only
6+**Efficiently served, aggressively cached static web resources.**
13−need to be passed an encoding('zopfliEncodings', 'gzipEncodings',
14−'noEncodings') and a static directory of your choice as arguments.
15
7
16−In this example, 'mkAssets' is used on a directory that has a .png
8+The `assets.nix` file contains nix expressions that are a mutually recursive set of attributes used to create static asset directories with hashable file encodings. This file should be incorporated within your project's `default.nix` file. (See `example/default.nix`, line 2)
17−file inside of it. (See ./example/default.nix, line 11)
9+
10+```nix
11+{ assets ? import ./../assets.nix { inherit nixpkgs; } }:
18```
12```
13+
14+The `mkAssets` and `mkAssetsWith` functions within `assets.nix` only need to be passed an `encoding("zopfliEncodings", "gzipEncodings", "noEncodings")` and a static directory of your choice as arguments.
15+
16+In this example, `mkAssets` is used on a directory that has a `.png` file inside of it. (See `example/default.nix`, line 11)
17+
18+```nix
19−myAssets = assets.mkAssets ./static;
19+myAssets = assets.mkAssets ./static;
20```
20```
21
21
22−Once you have successfully incorporated 'assets.nix' into your
22+Once you have successfully incorporated `assets.nix` into your project's nix file(s), use `nix-build` to generate a symlink of your `mkAssets` expression. The following command from `example/run-example` (line 3) will generate an immutable symlink that holds hashed static assets.
23−project's nix file(s), use nix-build to generate a symlink of
23+
24−your 'mkAssets' expression. The following command from
25−example/run-example (line 3) will generate an immutable symlink
26−that holds hashed static assets.
27```bash
24```bash
28nix-build -o static.assets -A myAssets
25nix-build -o static.assets -A myAssets
29```
26```
lib/asset/assets.nix+28−5
@@ -20,7 +20,7 @@ zopfliEncodings = file:
20 nixpkgs.stdenv.mkDerivation {
20 nixpkgs.stdenv.mkDerivation {
21 name = "encodings";
21 name = "encodings";
22
22
23− input = file;
23+ input = mkPath file;
24
24
25 builder = builtins.toFile "builder.sh" ''
25 builder = builtins.toFile "builder.sh" ''
26 source "$stdenv/setup"
26 source "$stdenv/setup"
@@ -46,7 +46,7 @@ gzipEncodings = file:
46 nixpkgs.stdenv.mkDerivation {
46 nixpkgs.stdenv.mkDerivation {
47 name = "encodings";
47 name = "encodings";
48
48
49− input = file;
49+ input = mkPath file;
50
50
51 builder = builtins.toFile "builder.sh" ''
51 builder = builtins.toFile "builder.sh" ''
52 source "$stdenv/setup"
52 source "$stdenv/setup"
@@ -70,7 +70,7 @@ noEncodings = file:
70 nixpkgs.stdenv.mkDerivation {
70 nixpkgs.stdenv.mkDerivation {
71 name = "encodings";
71 name = "encodings";
72
72
73− input = file;
73+ input = mkPath file;
74
74
75 builder = builtins.toFile "builder.sh" ''
75 builder = builtins.toFile "builder.sh" ''
76 source "$stdenv/setup"
76 source "$stdenv/setup"
@@ -203,7 +203,7 @@ hashFile = path:
203 nixpkgs.nix
203 nixpkgs.nix
204 ];
204 ];
205 preferLocalBuild = true;
205 preferLocalBuild = true;
206− inherit path;
206+ path = mkPath path;
207 } ''
207 } ''
208 nix-hash --flat --base32 --type sha256 "$path" | tr -d '\n' >"$out"
208 nix-hash --flat --base32 --type sha256 "$path" | tr -d '\n' >"$out"
209 '');
209 '');
@@ -224,7 +224,30 @@ symlink = path: {
224 inherit path;
224 inherit path;
225};
225};
226
226
227+# Tests if a given character (string of length 1) is valid for a derivation path name.
228+# Passing a string of length other than 1 is undefined.
229+# :: Char -> Bool
230+isValidDrvNameChar = c: "a" <= c && c <= "z" || "A" <= c && c <= "Z" || "0" <= c && c <= "9" || c == "+" || c == "-" || c == "_" || c == "?" || c == "=" || c == ".";
231+
232+# Convert a string into a string that could be used in a derivation name.
233+# replacement lets you choose how to replace invalid characters. It may be any length.
234+# If it contains invalid characters then the result will also be invalid.
235+# :: { str :: String, replacement :: String } -> String
236+mkValidDrvName = { str, replacement ? "?" }:
237+ let
238+ newName = stringAsChars (c: if isValidDrvNameChar c then c else replacement) str;
239+ in if builtins.substring 0 1 newName == "." then "_" + newName else newName;
240+
241+# Like builtins.path but always ensures the name is valid.
242+mkPath = path:
243+ if builtins.typeOf path == "path" # Don't mess with non-paths
244+ then builtins.path {
245+ inherit path;
246+ name = mkValidDrvName { str = builtins.baseNameOf path; };
247+ }
248+ else path;
249+
227−# Given a encoding generation function and a file entry resulting from readDirRecursive in the form { name :: String, value: { path :: String } },
250+# Given an encoding generation function and a file entry resulting from readDirRecursive in the form { name :: String, value: { path :: String } },
228# build a DirEntry for dirToPath with the various encodings of the asset for dirToPath to build into a final directory tree.
251# build a DirEntry for dirToPath with the various encodings of the asset for dirToPath to build into a final directory tree.
229mkAsset = encodings: {name, value}:
252mkAsset = encodings: {name, value}:
230 let nameWithHash = "${hashFile value.path}-${name}";
253 let nameWithHash = "${hashFile value.path}-${name}";
lib/asset/manifest/obelisk-asset-manifest.cabal+5−2
@@ -17,13 +17,14 @@ library
17 base
17 base
18 , bytestring
18 , bytestring
19 , containers
19 , containers
20+ , deepseq
20 , directory
21 , directory
21 , SHA
22 , SHA
22 , filepath
23 , filepath
23 , template-haskell
24 , template-haskell
24 , text
25 , text
25 , transformers
26 , transformers
26− , unix
27+ , unix-compat
27 , vector
28 , vector
28 exposed-modules:
29 exposed-modules:
29 Obelisk.Asset.Gather
30 Obelisk.Asset.Gather
@@ -32,7 +33,9 @@ library
32 Obelisk.Asset.TH
33 Obelisk.Asset.TH
33
34
34 other-extensions: TemplateHaskell
35 other-extensions: TemplateHaskell
36+ ghc-options:
37+ -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O2
35− ghc-options: -Wall -Werror -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls
38+ -fno-warn-unused-do-bind -funbox-strict-fields -fprof-auto-calls
36
39
37executable obelisk-asset-manifest-generate
40executable obelisk-asset-manifest-generate
38 hs-source-dirs: src-bin
41 hs-source-dirs: src-bin
lib/asset/manifest/src/Obelisk/Asset/Gather.hs+5−2
@@ -1,10 +1,12 @@
1{-# LANGUAGE OverloadedStrings #-}
1{-# LANGUAGE OverloadedStrings #-}
2+{-# LANGUAGE BangPatterns #-}
2-- | Functions for collecting up files to be processed by the asset pipeline
3-- | Functions for collecting up files to be processed by the asset pipeline
3module Obelisk.Asset.Gather
4module Obelisk.Asset.Gather
4 ( gatherHashedPaths
5 ( gatherHashedPaths
5 , toHashedPath
6 , toHashedPath
6 ) where
7 ) where
7
8
9+import Control.DeepSeq
8import Control.Monad (forM)
10import Control.Monad (forM)
9import Data.Bits
11import Data.Bits
10import qualified Data.ByteString.Lazy as LBS
12import qualified Data.ByteString.Lazy as LBS
@@ -33,7 +35,7 @@ gatherHashedPaths root = go ""
33 let relativePath = subdir </> sub
35 let relativePath = subdir </> sub
34 isFile <- doesFileExist $ root </> relativePath
36 isFile <- doesFileExist $ root </> relativePath
35 if isFile
37 if isFile
36− then do hashedRelativePath <- toHashedPath root relativePath
38+ then do !hashedRelativePath <- force <$> toHashedPath root relativePath
37 return $ Map.singleton relativePath hashedRelativePath
39 return $ Map.singleton relativePath hashedRelativePath
38 else go relativePath
40 else go relativePath
39
41
@@ -47,7 +49,8 @@ toHashedPath root relativePath = do
47 contents <- LBS.readFile path
49 contents <- LBS.readFile path
48 let hashPrefix = T.unpack $ decodeUtf8 $ LBS.toStrict $ toNixBase32 $ bytestringDigest $ sha256 contents
50 let hashPrefix = T.unpack $ decodeUtf8 $ LBS.toStrict $ toNixBase32 $ bytestringDigest $ sha256 contents
49 (dir, filename) = splitFileName relativePath
51 (dir, filename) = splitFileName relativePath
50− return $ normalise $ dir </> (hashPrefix <> "-" <> filename)
52+ !hashedRelativePath = force $ normalise $ dir </> (hashPrefix <> "-" <> filename)
53+ return hashedRelativePath
51
54
52-- | Convert a ByteString to base 32 in the way that Nix does
55-- | Convert a ByteString to base 32 in the way that Nix does
53toNixBase32 :: LBS.ByteString -> LBS.ByteString
56toNixBase32 :: LBS.ByteString -> LBS.ByteString
lib/asset/manifest/src/Obelisk/Asset/Symlink.hs+1−1
@@ -7,7 +7,7 @@ import Data.Map (Map)
7import qualified Data.Map as Map
7import qualified Data.Map as Map
8import System.Directory
8import System.Directory
9import System.FilePath.Posix
9import System.FilePath.Posix
10−import System.Posix.Files
10+import System.PosixCompat.Files
11
11
12-- | Copy the given hashed files from one location to hashed paths in another
12-- | Copy the given hashed files from one location to hashed paths in another
13-- location, and symlink the unhashed paths to the hashed ones
13-- location, and symlink the unhashed paths to the hashed ones
lib/asset/serve-snap/obelisk-asset-serve-snap.cabal+4−2
@@ -23,10 +23,12 @@ library
23 , obelisk-snap-extras
23 , obelisk-snap-extras
24 , text
24 , text
25 , transformers
25 , transformers
26− , unix
26+ , unix-compat
27 exposed-modules:
27 exposed-modules:
28 Obelisk.Asset.Accept
28 Obelisk.Asset.Accept
29 Obelisk.Asset.Serve.Snap
29 Obelisk.Asset.Serve.Snap
30
30
31 other-extensions: TemplateHaskell
31 other-extensions: TemplateHaskell
32+ ghc-options:
33+ -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O2
32− ghc-options: -Wall -Werror -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls
34+ -fno-warn-unused-do-bind -funbox-strict-fields -fprof-auto-calls
lib/asset/serve-snap/src/Obelisk/Asset/Accept.hs+6−6
@@ -136,16 +136,16 @@ qvalue = do
136 skipMany lws
136 skipMany lws
137 q0 <|> q1
137 q0 <|> q1
138 where q0 = do
138 where q0 = do
139− char '0'
139+ _ <- char '0'
140 decimals <- option [] $ do
140 decimals <- option [] $ do
141− char '.'
141+ _ <- char '.'
142 starRule (Just 0) (Just numAllowedDigits) digit
142 starRule (Just 0) (Just numAllowedDigits) digit
143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
144 q1 = do
144 q1 = do
145− char '1'
145+ _ <- char '1'
146 option () $ do
146 option () $ do
147− char '.'
147+ _ <- char '.'
148− starRule (Just 0) (Just numAllowedDigits) $ char '0'
148+ _ <- starRule (Just 0) (Just numAllowedDigits) $ char '0'
149 return ()
149 return ()
150 return $ QValue 1
150 return $ QValue 1
151 numAllowedDigits :: Int
151 numAllowedDigits :: Int
@@ -232,7 +232,7 @@ hashRule minNum maxNum element = do
232lws :: Parser ()
232lws :: Parser ()
233lws = do
233lws = do
234 option () $ cr >> lf
234 option () $ cr >> lf
235− starRule (Just 1) Nothing $ sp <|> ht
235+ _ <- starRule (Just 1) Nothing $ sp <|> ht
236 return ()
236 return ()
237
237
238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+22−11
@@ -12,13 +12,15 @@ 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)
23+import Control.Monad.Fail (MonadFail)
22import Data.Attoparsec.ByteString (parseOnly, endOfInput)
24import Data.Attoparsec.ByteString (parseOnly, endOfInput)
23import Data.ByteString (ByteString)
25import Data.ByteString (ByteString)
24import qualified Data.ByteString as BS
26import qualified Data.ByteString as BS
@@ -29,7 +31,7 @@ import Data.Text.Encoding (decodeUtf8, encodeUtf8)
29import System.Directory (getDirectoryContents)
31import System.Directory (getDirectoryContents)
30import System.FilePath ((</>), splitFileName, takeDirectory)
32import System.FilePath ((</>), splitFileName, takeDirectory)
31import System.IO.Error (isDoesNotExistError)
33import System.IO.Error (isDoesNotExistError)
32−import System.Posix (getFileStatus, fileSize)
34+import System.PosixCompat.Files (getFileStatus, fileSize)
33
35
34-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
36-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
35--
37--
@@ -38,7 +40,7 @@ import System.Posix (getFileStatus, fileSize)
38-- current version of the asset
40-- current version of the asset
39-- (e.g. @0rx5yvkkgkig2pcqf4ngi1l7vh89qqajdzc6aiayaibyhvj0d853-test.png@). Hashed
41-- (e.g. @0rx5yvkkgkig2pcqf4ngi1l7vh89qqajdzc6aiayaibyhvj0d853-test.png@). Hashed
40-- asset names will be sent with permanent caching headers.
42-- asset names will be sent with permanent caching headers.
41−serveAssets :: MonadSnap m => FilePath -> FilePath -> m ()
43+serveAssets :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> m ()
42serveAssets = serveAssets' True
44serveAssets = serveAssets' True
43
45
44-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
46-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
@@ -47,15 +49,15 @@ serveAssets = serveAssets' True
47-- browser for the logical asset name (e.g. @test.png@) but instead the current
49-- browser for the logical asset name (e.g. @test.png@) but instead the current
48-- version of the asset with to point the browser at the unique filename for the
50-- version of the asset with to point the browser at the unique filename for the
49-- current version of the asset.
51-- current version of the asset.
50−serveAssetsInPlace :: MonadSnap m => FilePath -> FilePath -> m ()
52+serveAssetsInPlace :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> m ()
51serveAssetsInPlace = serveAssets' False
53serveAssetsInPlace = serveAssets' False
52
54
53-- | Like 'serveAssets', but only serves a single specified asset
55-- | Like 'serveAssets', but only serves a single specified asset
54−serveAsset :: MonadSnap m => FilePath -> FilePath -> FilePath -> m ()
56+serveAsset :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> FilePath -> m ()
55serveAsset = serveAsset' True
57serveAsset = serveAsset' True
56
58
57-- | Like 'serveAssetsInPlace', but only serves a single specified asset
59-- | Like 'serveAssetsInPlace', but only serves a single specified asset
58−serveAssetInPlace :: MonadSnap m => FilePath -> FilePath -> FilePath -> m ()
60+serveAssetInPlace :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> FilePath -> m ()
59serveAssetInPlace = serveAsset' False
61serveAssetInPlace = serveAsset' False
60
62
61-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
63-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
@@ -63,13 +65,13 @@ serveAssetInPlace = serveAsset' False
63-- For assets generated from @assets.nix@, the @Bool@ argument @doRedirect@ controls whether redirects will be sent to the browser if a request is made for
65-- For assets generated from @assets.nix@, the @Bool@ argument @doRedirect@ controls whether redirects will be sent to the browser if a request is made for
64-- an unhashed asset name, e.g. @test.png@. For @True@, a redirect will be sent, yielding more round trips to the server but better caching behavior if the
66-- an unhashed asset name, e.g. @test.png@. For @True@, a redirect will be sent, yielding more round trips to the server but better caching behavior if the
65-- asset doesn't change often. Conversely for @False@, the asset will be served "in place" but made uncacheable.
67-- asset doesn't change often. Conversely for @False@, the asset will be served "in place" but made uncacheable.
66−serveAssets' :: MonadSnap m => Bool -> FilePath -> FilePath -> m ()
68+serveAssets' :: (MonadSnap m, MonadFail m) => Bool -> FilePath -> FilePath -> m ()
67serveAssets' doRedirect base fallback = do
69serveAssets' doRedirect base fallback = do
68 pRaw <- getSafePath
70 pRaw <- getSafePath
69 serveAsset' doRedirect base fallback $ if "/" `isSuffixOf` pRaw || pRaw == "" then pRaw <> "index.html" else pRaw
71 serveAsset' doRedirect base fallback $ if "/" `isSuffixOf` pRaw || pRaw == "" then pRaw <> "index.html" else pRaw
70
72
71-- | Serve a single static asset from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
73-- | Serve a single static asset from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
72−serveAsset' :: MonadSnap m => Bool -> FilePath -> FilePath -> FilePath -> m ()
74+serveAsset' :: (MonadFail m, MonadSnap m) => Bool -> FilePath -> FilePath -> FilePath -> m ()
73serveAsset' doRedirect base fallback p = do
75serveAsset' doRedirect base fallback p = do
74 assetType <- liftIO $ try $ BS.readFile $ base </> p </> "type"
76 assetType <- liftIO $ try $ BS.readFile $ base </> p </> "type"
75 case assetType of
77 case assetType of
@@ -93,8 +95,17 @@ serveAsset' doRedirect base fallback p = do
93 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
95 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
94 stat <- liftIO $ getFileStatus finalFilename
96 stat <- liftIO $ getFileStatus finalFilename
95 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"
96− 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
97− sendFile finalFilename
108+ sendFile finalFilename
98 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
109 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
99 Right "redirect" -> do
110 Right "redirect" -> do
100 mtarget <- liftIO $ getAssetTarget $ base </> p
111 mtarget <- liftIO $ getAssetTarget $ base </> p
lib/backend/obelisk-backend.cabal+6−3
@@ -8,6 +8,8 @@ library
8 build-depends: base,
8 build-depends: base,
9 bytestring,
9 bytestring,
10 categories,
10 categories,
11+ containers,
12+ cookie,
11 data-default,
13 data-default,
12 dependent-sum,
14 dependent-sum,
13 dependent-sum-template,
15 dependent-sum-template,
@@ -15,13 +17,14 @@ library
15 mtl,
17 mtl,
16 obelisk-asset-serve-snap,
18 obelisk-asset-serve-snap,
17 obelisk-executable-config-inject,
19 obelisk-executable-config-inject,
20+ obelisk-executable-config-lookup,
18 obelisk-frontend,
21 obelisk-frontend,
19 obelisk-route,
22 obelisk-route,
20− obelisk-snap,
23+ obelisk-snap-extras,
21− reflex-dom,
24+ reflex-dom-core,
22 snap,
25 snap,
23 snap-server,
26 snap-server,
24 text,
27 text,
25 universe
28 universe
26 exposed-modules: Obelisk.Backend
29 exposed-modules: Obelisk.Backend
27− ghc-options: -Wall
30+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/backend/src/Obelisk/Backend.hs+193−50
@@ -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 #-}
@@ -5,58 +7,113 @@
5{-# LANGUAGE LambdaCase #-}
7{-# LANGUAGE LambdaCase #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE OverloadedStrings #-}
9{-# LANGUAGE OverloadedStrings #-}
8−{-# LANGUAGE TemplateHaskell #-}
10+{-# LANGUAGE ScopedTypeVariables #-}
11+{-# OPTIONS_GHC -fno-warn-orphans #-}
9module Obelisk.Backend
12module Obelisk.Backend
10 ( 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
11 -- * Re-exports
30 -- * Re-exports
12 , Default (def)
31 , Default (def)
13 , getPageName
32 , getPageName
14 , getRouteWith
33 , getRouteWith
15 , runSnapWithCommandLineArgs
34 , runSnapWithCommandLineArgs
35+ , runSnapWithConfig
16 , serveDefaultObeliskApp
36 , serveDefaultObeliskApp
17 , prettifyOutput
37 , prettifyOutput
18− , runBackend
38+ , staticRenderContentType
39+ , getPublicConfigs
19 ) where
40 ) where
20
41
21−import Prelude hiding (id, (.))
22−import Control.Category
23import Control.Monad
42import Control.Monad
24import Control.Monad.Except
43import Control.Monad.Except
25−import Control.Categorical.Bifunctor
44+import Control.Monad.Fail (MonadFail)
26import Data.ByteString (ByteString)
45import Data.ByteString (ByteString)
27import qualified Data.ByteString.Char8 as BSC8
46import qualified Data.ByteString.Char8 as BSC8
28import Data.Default (Default (..))
47import Data.Default (Default (..))
29import Data.Dependent.Sum
48import Data.Dependent.Sum
30−import Data.Functor.Sum
31import Data.Functor.Identity
49import Data.Functor.Identity
50+import Data.Map (Map)
51+import qualified Data.Map as Map
52+import Data.Monoid ((<>))
32import Data.Text (Text)
53import Data.Text (Text)
33import qualified Data.Text as T
54import qualified Data.Text as T
34−import Data.Text.Encoding
55+import GHC.Generics (Generic)
35import Obelisk.Asset.Serve.Snap (serveAsset)
56import Obelisk.Asset.Serve.Snap (serveAsset)
36−import Obelisk.ExecutableConfig.Inject (injectExecutableConfigs)
57+import qualified Obelisk.ExecutableConfig.Lookup as Lookup
37import Obelisk.Frontend
58import Obelisk.Frontend
38import Obelisk.Route
59import Obelisk.Route
60+import Obelisk.Snap.Extras (doNotCache, serveFileIfExistsAs)
39−import Reflex.Dom
61+import Reflex.Dom.Core
40−import Snap (MonadSnap, Snap, commandLineConfig, defaultConfig, getsRequest, httpServe, rqPathInfo,
62+import Snap (MonadSnap, Snap, commandLineConfig, defaultConfig, getsRequest, httpServe, modifyResponse
41− rqQueryString, writeBS, writeText)
63+ , rqPathInfo, rqQueryString, setContentType, writeBS, writeText
64+ , rqCookies, Cookie(..) , setHeader)
42import Snap.Internal.Http.Server.Config (Config (accessLog, errorLog), ConfigLog (ConfigIoLog))
65import Snap.Internal.Http.Server.Config (Config (accessLog, errorLog), ConfigLog (ConfigIoLog))
43import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
66import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
44
67
45data Backend backendRoute frontendRoute = Backend
68data Backend backendRoute frontendRoute = Backend
46− { _backend_routeEncoder :: Encoder (Either Text) Identity (R (Sum backendRoute (ObeliskRoute frontendRoute))) PageName
69+ { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
47 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
70 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
48− }
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)
49
80
50-- | 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
51data GhcjsApp route = GhcjsApp
82data GhcjsApp route = GhcjsApp
52 { _ghcjsApp_compiled :: !StaticAssets
83 { _ghcjsApp_compiled :: !StaticAssets
53 , _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
54 }
102 }
55
103
56-- | 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
57--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
58−serveDefaultObeliskApp :: MonadSnap m => Frontend (R appRoute) -> R (ObeliskRoute appRoute) -> m ()
106+serveDefaultObeliskApp
107+ :: (MonadSnap m, HasCookies m, MonadFail m)
108+ => (R appRoute -> Text)
109+ -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
110+ -> ([Text] -> m ())
111+ -> Frontend (R appRoute)
112+ -> Map Text ByteString
113+ -> R (ObeliskRoute appRoute)
114+ -> m ()
59−serveDefaultObeliskApp frontend = serveObeliskApp defaultStaticAssets frontendApp
115+serveDefaultObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontend =
116+ serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp
60 where frontendApp = GhcjsApp
117 where frontendApp = GhcjsApp
61 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
118 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
62 , _ghcjsApp_value = frontend
119 , _ghcjsApp_value = frontend
@@ -81,44 +138,56 @@ defaultFrontendGhcjsAssets = StaticAssets
81 , _staticAssets_unprocessed = "frontend.jsexe"
138 , _staticAssets_unprocessed = "frontend.jsexe"
82 }
139 }
83
140
84−runSnapWithCommandLineArgs :: Snap () -> IO ()
141+runSnapWithConfig :: MonadIO m => Config Snap a -> Snap () -> m ()
85−runSnapWithCommandLineArgs a = do
142+runSnapWithConfig conf a = do
86− -- Get the web server configuration from the command line
87− cmdLineConf <- commandLineConfig defaultConfig
88− let httpConf = cmdLineConf
143+ let httpConf = conf
89 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
144 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
90 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
145 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
91 }
146 }
92 -- Start the web server
147 -- Start the web server
93− httpServe httpConf a
148+ liftIO $ httpServe httpConf a
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
94
154
95getPageName :: (MonadSnap m) => m PageName
155getPageName :: (MonadSnap m) => m PageName
96getPageName = do
156getPageName = do
97 p <- getsRequest rqPathInfo
157 p <- getsRequest rqPathInfo
98 q <- getsRequest rqQueryString
158 q <- getsRequest rqQueryString
99− let pageNameEncoder' :: Encoder Identity Identity PageName (String, String)
159+ return $ byteStringsToPageName p q
100− pageNameEncoder' = bimap
101− (unpackTextEncoder . pathSegmentsTextEncoder . listToNonEmptyEncoder)
102− (unpackTextEncoder . queryParametersTextEncoder . toListMapEncoder)
103− return $ decode pageNameEncoder' (T.unpack (decodeUtf8 p), T.unpack (decodeUtf8 q))
104
160
105getRouteWith :: (MonadSnap m) => Encoder Identity parse route PageName -> m (parse route)
161getRouteWith :: (MonadSnap m) => Encoder Identity parse route PageName -> m (parse route)
106getRouteWith e = do
162getRouteWith e = do
107 pageName <- getPageName
163 pageName <- getPageName
108 return $ tryDecode e pageName
164 return $ tryDecode e pageName
109
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+
170+serveObeliskApp
171+ :: (MonadSnap m, HasCookies m, MonadFail m)
172+ => (R appRoute -> Text)
173+ -> GhcjsWidgets (FrontendWidgetT (R appRoute) ())
174+ -> ([Text] -> m ())
175+ -> GhcjsApp (R appRoute)
176+ -> Map Text ByteString
110−serveObeliskApp :: MonadSnap m => StaticAssets -> GhcjsApp (R appRoute) -> R (ObeliskRoute appRoute) -> m ()
177+ -> R (ObeliskRoute appRoute)
178+ -> m ()
111−serveObeliskApp staticAssets frontendApp = \case
179+serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp config = \case
112− ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp frontendApp $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
180+ ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
113 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
181 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
114− ResourceRoute_Static :=> Identity pathSegments -> serveStaticAssets staticAssets pathSegments
182+ ResourceRoute_Static :=> Identity pathSegments -> serveStaticAsset pathSegments
115− ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp frontendApp $ GhcjsAppRoute_Resource :/ pathSegments
183+ ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_Resource :/ pathSegments
116 ResourceRoute_JSaddleWarp :=> Identity _ -> do
184 ResourceRoute_JSaddleWarp :=> Identity _ -> do
117 let msg = "Error: Obelisk.Backend received jsaddle request"
185 let msg = "Error: Obelisk.Backend received jsaddle request"
118 liftIO $ putStrLn $ T.unpack msg
186 liftIO $ putStrLn $ T.unpack msg
119 writeText msg
187 writeText msg
188+ ResourceRoute_Version :=> Identity () -> doNotCache >> serveFileIfExistsAs "text/plain" "version"
120
189
121−serveStaticAssets :: MonadSnap m => StaticAssets -> [Text] -> m ()
190+serveStaticAssets :: (MonadSnap m, MonadFail m) => StaticAssets -> [Text] -> m ()
122serveStaticAssets assets pathSegments = serveAsset (_staticAssets_processed assets) (_staticAssets_unprocessed assets) $ T.unpack $ T.intercalate "/" pathSegments
191serveStaticAssets assets pathSegments = serveAsset (_staticAssets_processed assets) (_staticAssets_unprocessed assets) $ T.unpack $ T.intercalate "/" pathSegments
123
192
124data StaticAssets = StaticAssets
193data StaticAssets = StaticAssets
@@ -131,25 +200,99 @@ data GhcjsAppRoute :: (* -> *) -> * -> * where
131 GhcjsAppRoute_App :: appRouteComponent a -> GhcjsAppRoute appRouteComponent a
200 GhcjsAppRoute_App :: appRouteComponent a -> GhcjsAppRoute appRouteComponent a
132 GhcjsAppRoute_Resource :: GhcjsAppRoute appRouteComponent [Text]
201 GhcjsAppRoute_Resource :: GhcjsAppRoute appRouteComponent [Text]
133
202
203+staticRenderContentType :: ByteString
204+staticRenderContentType = "text/html; charset=utf-8"
205+
134--TODO: Don't assume we're being served at "/"
206--TODO: Don't assume we're being served at "/"
207+serveGhcjsApp
208+ :: (MonadSnap m, HasCookies m, MonadFail m)
209+ => (R appRouteComponent -> Text)
210+ -> GhcjsWidgets (FrontendWidgetT (R appRouteComponent) ())
211+ -> GhcjsApp (R appRouteComponent)
212+ -> Map Text ByteString
135−serveGhcjsApp :: MonadSnap m => GhcjsApp (R appRouteComponent) -> R (GhcjsAppRoute appRouteComponent) -> m ()
213+ -> R (GhcjsAppRoute appRouteComponent)
214+ -> m ()
136−serveGhcjsApp app = \case
215+serveGhcjsApp urlEnc ghcjsWidgets app config = \case
137− GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest ->
216+ GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
217+ modifyResponse $ setContentType staticRenderContentType
218+ modifyResponse $ setHeader "Cache-Control" "no-store private"
138− writeBS <=< liftIO $ renderGhcjsFrontend (appRouteComponent :/ appRouteRest) $ _ghcjsApp_value app
219+ writeBS <=< renderGhcjsFrontend urlEnc ghcjsWidgets (appRouteComponent :/ appRouteRest) config $ _ghcjsApp_value app
139 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
220 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
140
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.
141−runBackend :: Backend fullRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
227+runBackend :: 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 ()
142−runBackend backend frontend = case checkEncoder $ _backend_routeEncoder backend of
236+runBackendWith (BackendConfig runSnap staticAssets ghcjsWidgets) backend frontend = case checkEncoder $ _backend_routeEncoder backend of
143 Left e -> fail $ "backend error:\n" <> T.unpack e
237 Left e -> fail $ "backend error:\n" <> T.unpack e
238+ Right validFullEncoder -> do
239+ publicConfigs <- getPublicConfigs
144− Right validFullEncoder -> _backend_run backend $ \serveRoute -> do
240+ _backend_run backend $ \serveRoute ->
145− runSnapWithCommandLineArgs $ do
241+ runSnap $
146− getRouteWith validFullEncoder >>= \case
242+ getRouteWith validFullEncoder >>= \case
147− Identity r -> case r of
243+ Identity r -> case r of
148− InL backendRoute :=> Identity a -> serveRoute $ backendRoute :/ a
244+ FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
149− InR obeliskRoute :=> Identity a -> serveDefaultObeliskApp frontend $ obeliskRoute :/ a
245+ FullRoute_Frontend obeliskRoute :/ a ->
150−
246+ serveDefaultObeliskApp routeToUrl (($ allJsUrl) <$> ghcjsWidgets) (serveStaticAssets staticAssets) frontend publicConfigs $
247+ obeliskRoute :/ a
248+ where
249+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
250+ allJsUrl = renderAllJsPath validFullEncoder
251+
151−renderGhcjsFrontend :: route -> Frontend route -> IO ByteString
252+renderGhcjsFrontend
253+ :: (MonadSnap m, HasCookies m)
254+ => (route -> Text)
255+ -> GhcjsWidgets (FrontendWidgetT route ())
256+ -> route
257+ -> Map Text ByteString
258+ -> Frontend route
259+ -> m ByteString
152−renderGhcjsFrontend route f = do
260+renderGhcjsFrontend urlEnc ghcjsWidgets route configs f = do
153− let baseTag = elAttr "base" ("href" =: "/") blank --TODO: Figure out the base URL from the routes
261+ cookies <- askCookies
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 ()
154− ghcjsScript = elAttr "script" ("language" =: "javascript" <> "src" =: "ghcjs/all.js" <> "defer" =: "defer") blank
272+deferredGhcjsScript allJsUrl = elAttr "script" ("type" =: "text/javascript" <> "src" =: allJsUrl <> "defer" =: "defer") blank
155− renderFrontendHtml route (_frontend_head f >> injectExecutableConfigs >> baseTag) (_frontend_body f >> ghcjsScript)
273+
274+-- | An all.js script which is loaded after waiting for some time to pass. This
275+-- is useful to ensure any CSS animations on the page can play smoothly before
276+-- blocking the UI thread by running all.js.
277+delayedGhcjsScript
278+ :: Int -- ^ The number of milliseconds to delay loading by
279+ -> Text -- ^ URL to GHCJS app JavaScript
280+ -> FrontendWidgetT r ()
281+delayedGhcjsScript n allJsUrl = elAttr "script" ("type" =: "text/javascript") $ text $ T.unlines
282+ [ "setTimeout(function() {"
283+ , " var all_js_script = document.createElement('script');"
284+ , " all_js_script.type = 'text/javascript';"
285+ , " all_js_script.src = '" <> allJsUrl <> "';"
286+ , " document.body.appendChild(all_js_script);"
287+ , "}, " <> T.pack (show n) <> ");"
288+ ]
289+
290+instance HasCookies Snap where
291+ askCookies = map (\c -> (cookieName c, cookieValue c)) <$> getsRequest rqCookies
292+
293+-- | Get configs from the canonical "public" locations (i.e., locations that obelisk expects to make available
294+-- to frontend applications, and hence visible to end users).
295+getPublicConfigs :: IO (Map Text ByteString)
296+getPublicConfigs = Map.filterWithKey (\k _ -> isMemberOf k ["common", "frontend"]) <$> Lookup.getConfigs
297+ where
298+ isMemberOf k = any (`T.isPrefixOf` k)
lib/cliapp/obelisk-cliapp.cabal+7−3
@@ -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
@@ -17,17 +19,19 @@ library
17 , monad-loops
19 , monad-loops
18 , mtl
20 , mtl
19 , process
21 , process
22+ , shell-escape
20 , terminal-size
23 , terminal-size
21 , text
24 , text
22 , time
25 , time
23 , transformers
26 , transformers
27+ , utf8-string
24 exposed-modules:
28 exposed-modules:
25 Obelisk.CliApp
29 Obelisk.CliApp
26− Obelisk.CliApp.Demo
27 other-modules:
30 other-modules:
28 Obelisk.CliApp.Logging
31 Obelisk.CliApp.Logging
29 Obelisk.CliApp.Process
32 Obelisk.CliApp.Process
30 Obelisk.CliApp.Spinner
33 Obelisk.CliApp.Spinner
31 Obelisk.CliApp.TerminalString
34 Obelisk.CliApp.TerminalString
35+ Obelisk.CliApp.Theme
32 Obelisk.CliApp.Types
36 Obelisk.CliApp.Types
33− ghc-options: -Wall -fobject-code
37+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/cliapp/src/Obelisk/CliApp.hs+19−5
@@ -33,14 +33,28 @@ 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 (..)
39+ , callCommand
40+ , callProcess
40 , callProcessAndLogOutput
41 , callProcessAndLogOutput
42+ , createProcess
41 , createProcess_
43 , createProcess_
42− , callProcess
44+ , exitCodeToException
43− , callCommand
45+ , overCreateProcess
46+ , proc
47+ , readCreateProcessWithExitCode
48+ , readProcessAndLogOutput
49+ , readProcessAndLogStderr
50+ , readProcessJSONAndLogStderr
51+ , reconstructCommand
52+ , runProcess_
53+ , setCwd
54+ , setDelegateCtlc
55+ , setEnvOverride
56+ , shell
57+ , waitForProcess
44 ) where
58 ) where
45
59
46import Control.Monad.Log (Severity (..))
60import Control.Monad.Log (Severity (..))
lib/cliapp/src/Obelisk/CliApp/Demo.hsdeleted−52
@@ -1,52 +0,0 @@
1−{-# LANGUAGE FlexibleContexts #-}
2−{-# LANGUAGE OverloadedStrings #-}
3−{-# LANGUAGE ScopedTypeVariables #-}
4−module Obelisk.CliApp.Demo where
5−
6−import Control.Concurrent (threadDelay)
7−import Control.Monad.IO.Class
8−import Data.Semigroup ((<>))
9−import qualified Data.Text as T
10−import System.Process (proc)
11−
12−import Control.Monad.Catch (MonadMask)
13−
14−import Obelisk.CliApp
15−
16−cliDemo
17− :: ( MonadIO m, MonadMask m
18− , CliLog m, HasCliConfig e m, CliThrow e m, AsProcessFailure e, AsUnstructuredError e)
19− => m ()
20−cliDemo = withSpinner "CLI Demo" $ do
21− putLog Notice "This demo will showcase the CLI library functionality"
22− _ <- withSpinner' "Searching long for something" (Just $ \c -> "Discovered " <> T.pack (show c) <> " objects") $ do
23− delay
24− withSpinner "Nested task" $ do
25− delay
26− putLog Notice "In nested task"
27− -- This is a 'no trail' spinner that won't leave a trail (even its sub spinners)
28− withSpinnerNoTrail "In between, doing something temporary" $ do
29− withSpinner "Runnning something deep inside" $ do
30− delay
31− putLog Notice "You can still log from inside no-trail spinners"
32− delay
33− delay
34− putLog Error "Top nested task finished"
35− delay
36− putLog Error "Some user error while spinning"
37− delay
38− putLog Notice "This is some info mesage"
39− putLog Warning "And now a warning as well"
40− delay
41− return (42 :: Integer)
42− putLog Notice "Now we start a 2nd spinner, run a couple of process, the last of which fails:"
43− withSpinner "Looking around" $ do
44− delay
45− output <- readProcessAndLogStderr Notice $ proc "ls" ["-l", "/"]
46− putLog Notice $ "Output was: " <> output
47− delay
48− callProcessAndLogOutput (Notice, Error) $ proc "ls" ["-l", "/does-not-exist"]
49− delay
50− failWith "Something dangerous happened"
51− where
52− delay = liftIO $ threadDelay 1000000
lib/cliapp/src/Obelisk/CliApp/Logging.hs+37−12
@@ -43,13 +43,15 @@ import Data.Semigroup ((<>))
43import Data.Text (Text)
43import Data.Text (Text)
44import qualified Data.Text as T
44import qualified Data.Text as T
45import qualified Data.Text.IO as T
45import qualified Data.Text.IO as T
46+import GHC.IO.Encoding.Types
46import System.Console.ANSI (Color (Red, Yellow), ColorIntensity (Vivid),
47import System.Console.ANSI (Color (Red, Yellow), ColorIntensity (Vivid),
47 ConsoleIntensity (FaintIntensity), ConsoleLayer (Foreground),
48 ConsoleIntensity (FaintIntensity), ConsoleLayer (Foreground),
48 SGR (SetColor, SetConsoleIntensity), clearLine)
49 SGR (SetColor, SetConsoleIntensity), clearLine)
49import System.Exit (ExitCode (..))
50import System.Exit (ExitCode (..))
50−import System.IO (BufferMode (NoBuffering), hFlush, hReady, hSetBuffering, stderr, stdin, stdout)
51+import System.IO
51
52
52import qualified Obelisk.CliApp.TerminalString as TS
53import qualified Obelisk.CliApp.TerminalString as TS
54+import Obelisk.CliApp.Theme
53import Obelisk.CliApp.Types
55import Obelisk.CliApp.Types
54
56
55newCliConfig
57newCliConfig
@@ -63,7 +65,11 @@ newCliConfig sev noColor noSpinner errorLogExitCode = do
63 lock <- newMVar False
65 lock <- newMVar False
64 tipDisplayed <- newIORef False
66 tipDisplayed <- newIORef False
65 stack <- newIORef ([], [])
67 stack <- newIORef ([], [])
68+ textEncoding <- hGetEncoding stdout
69+ let theme = if maybe False supportsUnicode textEncoding
70+ then unicodeTheme
71+ else noUnicodeTheme
66− return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode
72+ return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
67
73
68runCli :: MonadIO m => CliConfig e -> CliT e m a -> m a
74runCli :: MonadIO m => CliConfig e -> CliT e m a -> m a
69runCli c =
75runCli c =
@@ -126,7 +132,7 @@ handleLog' noColor output = do
126 hFlush stdout
132 hFlush stdout
127 Output_Overwrite ts -> liftIO $ do
133 Output_Overwrite ts -> liftIO $ do
128 width <- TS.getTerminalWidth
134 width <- TS.getTerminalWidth
129− T.putStr $ "\r" <> (TS.render (not noColor) width ts)
135+ T.putStr $ "\r" <> TS.render (not noColor) width ts
130 hFlush stdout
136 hFlush stdout
131 Output_ClearLine -> liftIO $ do
137 Output_ClearLine -> liftIO $ do
132 -- Go to the first column and clear the whole line
138 -- Go to the first column and clear the whole line
@@ -154,7 +160,7 @@ failWith :: (CliThrow e m, AsUnstructuredError e) => Text -> m a
154failWith = throwError . review asUnstructuredError
160failWith = throwError . review asUnstructuredError
155
161
156errorToWarning
162errorToWarning
157− :: (HasCliConfig e m, CliThrow e m, CliLog m)
163+ :: (HasCliConfig e m, CliLog m)
158 => e -> m ()
164 => e -> m ()
159errorToWarning e = do
165errorToWarning e = do
160 c <- getCliConfig
166 c <- getCliConfig
@@ -171,15 +177,17 @@ withExitFailMessage msg f = f `catch` \(e :: ExitCode) -> do
171 throwM e
177 throwM e
172
178
173-- | Write log to stdout, with colors (unless `noColor`)
179-- | Write log to stdout, with colors (unless `noColor`)
174−writeLog :: (MonadIO m, MonadMask m) => Bool -> Bool -> WithSeverity Text -> m ()
180+writeLog :: (MonadIO m) => Bool -> Bool -> WithSeverity Text -> m ()
175−writeLog withNewLine noColor (WithSeverity severity s)
181+writeLog withNewLine noColor (WithSeverity severity s) = if T.null s then pure () else write
176− | noColor && severity <= Warning = liftIO $ putFn $ T.pack (show severity) <> ": " <> s
177− | not noColor && severity <= Error = TS.putStrWithSGR errorColors h withNewLine s
178− | not noColor && severity <= Warning = TS.putStrWithSGR warningColors h withNewLine s
179− | not noColor && severity >= Debug = TS.putStrWithSGR debugColors h withNewLine s
180− | otherwise = liftIO $ putFn s
181 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+
182− putFn = if withNewLine then (T.hPutStrLn h) else (T.hPutStr h)
190+ putFn = if withNewLine then T.hPutStrLn h else T.hPutStr h
183 h = if severity <= Error then stderr else stdout
191 h = if severity <= Error then stderr else stdout
184 errorColors = [SetColor Foreground Vivid Red]
192 errorColors = [SetColor Foreground Vivid Red]
185 warningColors = [SetColor Foreground Vivid Yellow]
193 warningColors = [SetColor Foreground Vivid Yellow]
@@ -226,3 +234,20 @@ fork :: (HasCliConfig e m, MonadIO m) => CliT e IO () -> m ThreadId
226fork f = do
234fork f = do
227 c <- getCliConfig
235 c <- getCliConfig
228 liftIO $ forkIO $ runCli c f
236 liftIO $ forkIO $ runCli c f
237+
238+-- | Conservatively determines whether the encoding supports Unicode.
239+--
240+-- Currently this uses a whitelist of known-to-work encodings. In principle it
241+-- could test dynamically by opening a file with this encoding, but it doesn't
242+-- look like base exposes any way to determine this in a pure fashion.
243+supportsUnicode :: TextEncoding -> Bool
244+supportsUnicode enc = any ((textEncodingName enc ==) . textEncodingName)
245+ [ utf8
246+ , utf8_bom
247+ , utf16
248+ , utf16be
249+ , utf16le
250+ , utf32
251+ , utf32be
252+ , utf32le
253+ ]
lib/cliapp/src/Obelisk/CliApp/Process.hs+148−50
@@ -1,7 +1,6 @@
1{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE MultiParamTypeClasses #-}
4−{-# LANGUAGE MultiWayIf #-}
5{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE ScopedTypeVariables #-}
5{-# LANGUAGE ScopedTypeVariables #-}
7{-# LANGUAGE TupleSections #-}
6{-# LANGUAGE TupleSections #-}
@@ -9,41 +8,86 @@
9-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
8-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
10-- and is thus spinner friendly.
9-- and is thus spinner friendly.
11module Obelisk.CliApp.Process
10module Obelisk.CliApp.Process
11+ ( AsProcessFailure (..)
12− ( ProcessFailure (..)
12+ , ProcessFailure (..)
13− , AsProcessFailure (..)
13+ , ProcessSpec (..)
14− , readProcessAndLogStderr
14+ , callCommand
15− , readProcessAndLogOutput
15+ , callProcess
16 , callProcessAndLogOutput
16 , callProcessAndLogOutput
17 , createProcess
17 , createProcess
18 , createProcess_
18 , createProcess_
19− , callProcess
19+ , exitCodeToException
20− , callCommand
20+ , overCreateProcess
21+ , proc
22+ , readCreateProcessWithExitCode
23+ , readProcessAndLogOutput
24+ , readProcessAndLogStderr
25+ , readProcessJSONAndLogStderr
26+ , reconstructCommand
27+ , runProcess_
28+ , setCwd
29+ , setDelegateCtlc
30+ , setEnvOverride
31+ , shell
32+ , waitForProcess
21 ) where
33 ) where
22
34
23import Control.Monad ((<=<), join, void)
35import Control.Monad ((<=<), join, void)
36+import Control.Monad.Catch (MonadMask, bracketOnError)
24import Control.Monad.Except (throwError)
37import Control.Monad.Except (throwError)
38+import Control.Monad.Fail
25import Control.Monad.IO.Class (MonadIO, liftIO)
39import Control.Monad.IO.Class (MonadIO, liftIO)
26import Control.Lens (Prism', review)
40import Control.Lens (Prism', review)
27import qualified Data.ByteString as BS
41import qualified Data.ByteString as BS
28import qualified Data.ByteString.Char8 as BSC
42import qualified Data.ByteString.Char8 as BSC
43+import qualified Data.ByteString.UTF8 as BSU
29import Data.Function (fix)
44import Data.Function (fix)
45+import Data.Map (Map)
46+import qualified Data.Map as Map
30import Data.Monoid ((<>))
47import Data.Monoid ((<>))
31import Data.Text (Text)
48import Data.Text (Text)
32import qualified Data.Text as T
49import qualified Data.Text as T
33import qualified Data.Text.Encoding as T
50import qualified Data.Text.Encoding as T
51+import Data.Text.Encoding.Error (lenientDecode)
52+import System.Environment (getEnvironment)
34import System.Exit (ExitCode (..))
53import System.Exit (ExitCode (..))
35import System.IO (Handle)
54import System.IO (Handle)
36import System.IO.Streams (InputStream, handleToInputStream)
55import System.IO.Streams (InputStream, handleToInputStream)
37import qualified System.IO.Streams as Streams
56import qualified System.IO.Streams as Streams
38import System.IO.Streams.Concurrent (concurrentMerge)
57import System.IO.Streams.Concurrent (concurrentMerge)
39−import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), cmdspec, std_err, std_out,
58+import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), std_err, std_out)
40− waitForProcess)
41import qualified System.Process as Process
59import qualified System.Process as Process
60+import Text.ShellEscape (bash, bytes)
61+import qualified Data.Aeson as Aeson
42
62
43import Control.Monad.Log (Severity (..))
63import Control.Monad.Log (Severity (..))
44import Obelisk.CliApp.Logging (putLog, putLogRaw)
64import Obelisk.CliApp.Logging (putLog, putLogRaw)
45import Obelisk.CliApp.Types (CliLog, CliThrow)
65import Obelisk.CliApp.Types (CliLog, CliThrow)
46
66
67+data ProcessSpec = ProcessSpec
68+ { _processSpec_createProcess :: !CreateProcess
69+ , _processSpec_overrideEnv :: !(Maybe (Map String String -> Map String String))
70+ }
71+
72+proc :: FilePath -> [String] -> ProcessSpec
73+proc cmd args = ProcessSpec (Process.proc cmd args) Nothing
74+
75+shell :: String -> ProcessSpec
76+shell cmd = ProcessSpec (Process.shell cmd) Nothing
77+
78+setEnvOverride :: (Map String String -> Map String String) -> ProcessSpec -> ProcessSpec
79+setEnvOverride f p = p { _processSpec_overrideEnv = Just f }
80+
81+overCreateProcess :: (CreateProcess -> CreateProcess) -> ProcessSpec -> ProcessSpec
82+overCreateProcess f (ProcessSpec p x) = ProcessSpec (f p) x
83+
84+setDelegateCtlc :: Bool -> ProcessSpec -> ProcessSpec
85+setDelegateCtlc b = overCreateProcess (\p -> p { Process.delegate_ctlc = b })
86+
87+setCwd :: Maybe FilePath -> ProcessSpec -> ProcessSpec
88+setCwd fp = overCreateProcess (\p -> p { Process.cwd = fp })
89+
90+
47-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
91-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
48data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
92data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
49 deriving Show
93 deriving Show
@@ -57,37 +101,56 @@ instance AsProcessFailure ProcessFailure where
57 asProcessFailure = id
101 asProcessFailure = id
58
102
59readProcessAndLogStderr
103readProcessAndLogStderr
60− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
104+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
61− => Severity -> CreateProcess -> m Text
105+ => Severity -> ProcessSpec -> m Text
62readProcessAndLogStderr sev process = do
106readProcessAndLogStderr sev process = do
63 (out, _err) <- withProcess process $ \_out err -> do
107 (out, _err) <- withProcess process $ \_out err -> do
64 streamToLog =<< liftIO (streamHandle sev err)
108 streamToLog =<< liftIO (streamHandle sev err)
65− liftIO $ T.decodeUtf8 <$> BS.hGetContents out
109+ liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
110+
111+readProcessJSONAndLogStderr
112+ :: (Aeson.FromJSON a, MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
113+ => Severity -> ProcessSpec -> m a
114+readProcessJSONAndLogStderr sev process = do
115+ (out, _err) <- withProcess process $ \_out err -> do
116+ streamToLog =<< liftIO (streamHandle sev err)
117+ json <- liftIO $ BS.hGetContents out
118+ case Aeson.eitherDecodeStrict json of
119+ Right a -> pure a
120+ Left err -> do
121+ putLog Error $ "Could not decode process output as JSON: " <> T.pack err
122+ throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess process) 0
123+
124+readCreateProcessWithExitCode
125+ :: (MonadIO m, CliLog m)
126+ => ProcessSpec -> m (ExitCode, String, String)
127+readCreateProcessWithExitCode procSpec = do
128+ process <- mkCreateProcess procSpec
129+ putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
130+ liftIO $ Process.readCreateProcessWithExitCode process ""
66
131
67-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
132-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
68-- with the corresponding severity.
133-- with the corresponding severity.
69--
134--
70−-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
135+-- Usually this function is called as `readProcessAndLogOutput (Debug, Error)`. However
71-- some processes are known to spit out diagnostic or informative messages in stderr, in
136-- some processes are known to spit out diagnostic or informative messages in stderr, in
72-- which case it is advisable to call it with a non-Error severity for stderr, like
137-- which case it is advisable to call it with a non-Error severity for stderr, like
73−-- `callProcessAndLogOutput (Debug, Debug)`.
138+-- `readProcessAndLogOutput (Debug, Debug)`.
74readProcessAndLogOutput
139readProcessAndLogOutput
75− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
140+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
76− => (Severity, Severity) -> CreateProcess -> m Text
141+ => (Severity, Severity) -> ProcessSpec -> m Text
77readProcessAndLogOutput (sev_out, sev_err) process = do
142readProcessAndLogOutput (sev_out, sev_err) process = do
78− (_, Just out, Just err, p) <- createProcess $ process
143+ (_, Just out, Just err, p) <- createProcess $ overCreateProcess
79− { std_out = CreatePipe , std_err = CreatePipe }
144+ (\p -> p { std_out = CreatePipe , std_err = CreatePipe }) process
80
145
81 -- TODO interleave stdout and stderr in log correctly
146 -- TODO interleave stdout and stderr in log correctly
82 streamToLog =<< liftIO (streamHandle sev_err err)
147 streamToLog =<< liftIO (streamHandle sev_err err)
83− outText <- liftIO $ T.decodeUtf8 <$> BS.hGetContents out
148+ outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
84 putLogRaw sev_out outText
149 putLogRaw sev_out outText
85
150
86− liftIO (waitForProcess p) >>= \case
151+ outText <$ (exitCodeToException process =<< waitForProcess p)
87− ExitSuccess -> pure outText
88− ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (cmdspec process) code
89
152
90−-- | Like `System.Process.callProcess` but logs the combined output (stdout and stderr)
153+-- | Like 'System.Process.callProcess' but logs the combined output (stdout and stderr)
91-- with the corresponding severity.
154-- with the corresponding severity.
92--
155--
93-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
156-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
@@ -95,9 +158,8 @@ readProcessAndLogOutput (sev_out, sev_err) process = do
95-- which case it is advisable to call it with a non-Error severity for stderr, like
158-- which case it is advisable to call it with a non-Error severity for stderr, like
96-- `callProcessAndLogOutput (Debug, Debug)`.
159-- `callProcessAndLogOutput (Debug, Debug)`.
97callProcessAndLogOutput
160callProcessAndLogOutput
98−
99− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
161+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
100− => (Severity, Severity) -> CreateProcess -> m ()
162+ => (Severity, Severity) -> ProcessSpec -> m ()
101callProcessAndLogOutput (sev_out, sev_err) process =
163callProcessAndLogOutput (sev_out, sev_err) process =
102 void $ withProcess process $ \out err -> do
164 void $ withProcess process $ \out err -> do
103 stream <- liftIO $ join $ combineStream
165 stream <- liftIO $ join $ combineStream
@@ -107,21 +169,30 @@ callProcessAndLogOutput (sev_out, sev_err) process =
107 where
169 where
108 combineStream s1 s2 = concurrentMerge [s1, s2]
170 combineStream s1 s2 = concurrentMerge [s1, s2]
109
171
110−-- | Like `System.Process.createProcess` but also logs (debug) the process being run
172+-- | Like 'System.Process.createProcess' but also logs (debug) the process being run
111createProcess
173createProcess
112 :: (MonadIO m, CliLog m)
174 :: (MonadIO m, CliLog m)
113− => CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
175+ => ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
114−createProcess p = do
176+createProcess procSpec = do
177+ p <- mkCreateProcess procSpec
115− putLog Debug $ "Creating process: " <> reconstructCommand (cmdspec p)
178+ putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
116 liftIO $ Process.createProcess p
179 liftIO $ Process.createProcess p
117
180
118-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
181-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
119createProcess_
182createProcess_
120 :: (MonadIO m, CliLog m)
183 :: (MonadIO m, CliLog m)
121− => String -> CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
184+ => String -> ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
122−createProcess_ name p = do
185+createProcess_ name procSpec = do
186+ p <- mkCreateProcess procSpec
123− putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructCommand (cmdspec p)
187+ putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructProcSpec procSpec
124− liftIO $ Process.createProcess p
188+ liftIO $ Process.createProcess_ name p
189+
190+mkCreateProcess :: MonadIO m => ProcessSpec -> m Process.CreateProcess
191+mkCreateProcess (ProcessSpec p override') = case override' of
192+ Nothing -> pure p
193+ Just override -> do
194+ procEnv <- Map.fromList <$> maybe (liftIO getEnvironment) pure (Process.env p)
195+ pure $ p { Process.env = Just $ Map.toAscList (override procEnv) }
125
196
126-- | Like `System.Process.callProcess` but also logs (debug) the process being run
197-- | Like `System.Process.callProcess` but also logs (debug) the process being run
127callProcess
198callProcess
@@ -140,18 +211,30 @@ callCommand cmd = do
140 liftIO $ Process.callCommand cmd
211 liftIO $ Process.callCommand cmd
141
212
142withProcess
213withProcess
143− :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e)
214+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
144− => CreateProcess -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
215+ => ProcessSpec -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
145−withProcess process f = do -- TODO: Use bracket.
216+withProcess process f =
146− -- FIXME: Using `withCreateProcess` here leads to something operating illegally on closed handles.
217+ bracketOnError
147− (_, Just out, Just err, p) <- createProcess $ process
218+ (createProcess $ overCreateProcess
148− { std_out = CreatePipe , std_err = CreatePipe }
219+ (\x -> x { std_out = CreatePipe , std_err = CreatePipe }) process
149−
220+ )
150− f out err -- Pass the handles to the passed function
221+ (liftIO . Process.cleanupProcess)
222+ (\case
223+ (_, Just out, Just err, p) -> do
224+ f out err
225+ (out, err) <$ (exitCodeToException process =<< waitForProcess p)
226+ _ -> error "withProcess: createProcess did not provide handles for CreatePipe as expected"
227+ )
151
228
152− liftIO (waitForProcess p) >>= \case
229+-- | Runs a process to completion failing if it does not exit cleanly.
153− ExitSuccess -> return (out, err)
230+runProcess_
154− ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (cmdspec process) code
231+ :: (MonadIO m, CliLog m, CliThrow e m, MonadMask m, AsProcessFailure e)
232+ => ProcessSpec -> m ()
233+runProcess_ process =
234+ bracketOnError
235+ (createProcess process)
236+ (liftIO . Process.cleanupProcess)
237+ (\(_, _, _, ph) -> exitCodeToException process =<< waitForProcess ph)
155
238
156-- Create an input stream from the file handle, associating each item with the given severity.
239-- Create an input stream from the file handle, associating each item with the given severity.
157streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
240streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
@@ -164,11 +247,26 @@ streamToLog
164streamToLog stream = fix $ \loop -> do
247streamToLog stream = fix $ \loop -> do
165 liftIO (Streams.read stream) >>= \case
248 liftIO (Streams.read stream) >>= \case
166 Nothing -> return ()
249 Nothing -> return ()
167− Just (sev, line) -> putLogRaw sev (T.decodeUtf8 line) >> loop
250+ Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
168
251
252+-- | Wrapper around `System.Process.waitForProcess`
253+waitForProcess :: MonadIO m => ProcessHandle -> m ExitCode
254+waitForProcess = liftIO . Process.waitForProcess
255+
256+-- | Converts an 'ExitCode' to an exception when it's non-zero.
257+exitCodeToException :: (CliThrow e m, AsProcessFailure e) => ProcessSpec -> ExitCode -> m ()
258+exitCodeToException spec = \case
259+ ExitSuccess -> pure ()
260+ ExitFailure code -> throwError $ review asProcessFailure $ ProcessFailure (Process.cmdspec $ _processSpec_createProcess spec) code
261+
262+-- | Pretty print a 'CmdSpec'
169reconstructCommand :: Process.CmdSpec -> Text
263reconstructCommand :: Process.CmdSpec -> Text
264+reconstructCommand p = case p of
170−reconstructCommand (Process.ShellCommand str) = T.pack str
265+ Process.ShellCommand str -> T.pack str
171−reconstructCommand (Process.RawCommand c as) = processToShellString c as
266+ Process.RawCommand c as -> processToShellString c as
172 where
267 where
173− processToShellString cmd args = T.unwords $ map quoteAndEscape (cmd : args)
268+ processToShellString cmd args = T.pack $ unwords $
174− quoteAndEscape x = "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
269+ map (BSU.toString . bytes . bash . BSU.fromString) (cmd : args)
270+
271+reconstructProcSpec :: ProcessSpec -> Text
272+reconstructProcSpec = reconstructCommand . Process.cmdspec . _processSpec_createProcess
lib/cliapp/src/Obelisk/CliApp/Spinner.hs+18−24
@@ -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
@@ -24,6 +23,7 @@ import System.Console.ANSI (Color (Blue, Cyan, Green, Red))
24
23
25import Obelisk.CliApp.Logging (allowUserToMakeLoggingVerbose, fork, putLog)
24import Obelisk.CliApp.Logging (allowUserToMakeLoggingVerbose, fork, putLog)
26import Obelisk.CliApp.TerminalString (TerminalString (..), enquiryCode)
25import Obelisk.CliApp.TerminalString (TerminalString (..), enquiryCode)
26+import Obelisk.CliApp.Theme
27import Obelisk.CliApp.Types (CliLog, CliConfig (..), HasCliConfig, Output (..), getCliConfig)
27import Obelisk.CliApp.Types (CliLog, CliConfig (..), HasCliConfig, Output (..), getCliConfig)
28
28
29-- | Run an action with a CLI spinner.
29-- | Run an action with a CLI spinner.
@@ -51,7 +51,8 @@ withSpinner'
51 -> m a
51 -> m a
52 -> m a
52 -> m a
53withSpinner' msg mkTrail action = do
53withSpinner' msg mkTrail action = do
54− noSpinner <- _cliConfig_noSpinner <$> getCliConfig
54+ cliConf <- getCliConfig
55+ let noSpinner = _cliConfig_noSpinner cliConf
55 if noSpinner
56 if noSpinner
56 then putLog Notice msg >> action
57 then putLog Notice msg >> action
57 else bracket' run cleanup $ const action
58 else bracket' run cleanup $ const action
@@ -61,8 +62,11 @@ withSpinner' msg mkTrail action = do
61 modifyStack pushSpinner >>= \case
62 modifyStack pushSpinner >>= \case
62 True -> do -- Top-level spinner; fork a thread to manage output of anything on the stack
63 True -> do -- Top-level spinner; fork a thread to manage output of anything on the stack
63 ctrleThread <- fork $ allowUserToMakeLoggingVerbose enquiryCode
64 ctrleThread <- fork $ allowUserToMakeLoggingVerbose enquiryCode
65+ cliConf <- getCliConfig
66+ let theme = _cliConfig_theme cliConf
67+ spinner = coloredSpinner $ _cliTheme_spinner theme
64 spinnerThread <- fork $ runSpinner spinner $ \c -> do
68 spinnerThread <- fork $ runSpinner spinner $ \c -> do
65− logs <- renderSpinnerStack c . snd <$> readStack
69+ logs <- renderSpinnerStack theme c . snd <$> readStack
66 logMessage $ Output_Overwrite logs
70 logMessage $ Output_Overwrite logs
67 pure [ctrleThread, spinnerThread]
71 pure [ctrleThread, spinnerThread]
68 False -> -- Sub-spinner; nothing to do.
72 False -> -- Sub-spinner; nothing to do.
@@ -70,13 +74,15 @@ withSpinner' msg mkTrail action = do
70 cleanup tids resultM = do
74 cleanup tids resultM = do
71 liftIO $ mapM_ killThread tids
75 liftIO $ mapM_ killThread tids
72 logMessage Output_ClearLine
76 logMessage Output_ClearLine
77+ cliConf <- getCliConfig
78+ let theme = _cliConfig_theme cliConf
73− logsM <- modifyStack $ popSpinner $ case resultM of
79+ logsM <- modifyStack $ (popSpinner theme) $ case resultM of
74 Nothing ->
80 Nothing ->
75− ( TerminalString_Colorized Red "✖"
81+ ( TerminalString_Colorized Red $ _cliTheme_failed $ _cliConfig_theme cliConf
76 , Just msg -- Always display final message if there was an exception.
82 , Just msg -- Always display final message if there was an exception.
77 )
83 )
78 Just result ->
84 Just result ->
79− ( TerminalString_Colorized Green "✔"
85+ ( TerminalString_Colorized Green $ _cliTheme_done $ _cliConfig_theme cliConf
80 , mkTrail <*> pure result
86 , mkTrail <*> pure result
81 )
87 )
82 -- Last message, finish off with newline.
88 -- Last message, finish off with newline.
@@ -87,10 +93,10 @@ withSpinner' msg mkTrail action = do
87 )
93 )
88 where
94 where
89 isTemporary = isNothing mkTrail
95 isTemporary = isNothing mkTrail
90− popSpinner (mark, trailMsgM) (flag, old) =
96+ popSpinner theme (mark, trailMsgM) (flag, old) =
91 ( (newFlag, new)
97 ( (newFlag, new)
92 -- With final trail spinner message to render
98 -- With final trail spinner message to render
93− , renderSpinnerStack mark . (: new) . TerminalString_Normal <$> (
99+ , renderSpinnerStack theme mark . (: new) . TerminalString_Normal <$> (
94 if inTemporarySpinner then Nothing else trailMsgM
100 if inTemporarySpinner then Nothing else trailMsgM
95 )
101 )
96 )
102 )
@@ -102,19 +108,19 @@ withSpinner' msg mkTrail action = do
102 =<< fmap _cliConfig_spinnerStack getCliConfig
108 =<< fmap _cliConfig_spinnerStack getCliConfig
103 modifyStack f = liftIO . flip atomicModifyIORef' f
109 modifyStack f = liftIO . flip atomicModifyIORef' f
104 =<< fmap _cliConfig_spinnerStack getCliConfig
110 =<< fmap _cliConfig_spinnerStack getCliConfig
105− spinner = coloredSpinner defaultSpinnerTheme
106
111
107-- | How nested spinner logs should be displayed
112-- | How nested spinner logs should be displayed
108renderSpinnerStack
113renderSpinnerStack
114+ :: CliTheme
109− :: TerminalString -- ^ That which comes before the final element in stack
115+ -> TerminalString -- ^ That which comes before the final element in stack
110 -> [TerminalString] -- ^ Spinner elements in reverse order
116 -> [TerminalString] -- ^ Spinner elements in reverse order
111 -> [TerminalString]
117 -> [TerminalString]
112−renderSpinnerStack mark = L.intersperse space . go . L.reverse
118+renderSpinnerStack theme mark = L.intersperse space . go . L.reverse
113 where
119 where
114 go [] = []
120 go [] = []
115 go (x:[]) = mark : [x]
121 go (x:[]) = mark : [x]
116 go (x:xs) = arrow : x : go xs
122 go (x:xs) = arrow : x : go xs
117− arrow = TerminalString_Colorized Blue "⇾"
123+ arrow = TerminalString_Colorized Blue $ _cliTheme_arrow theme
118 space = TerminalString_Normal " "
124 space = TerminalString_Normal " "
119
125
120-- | A spinner is simply an infinite list of strings that supplant each other in a delayed loop, creating the
126-- | A spinner is simply an infinite list of strings that supplant each other in a delayed loop, creating the
@@ -130,18 +136,6 @@ runSpinner spinner f = forM_ spinner $ f >=> const delay
130 where
136 where
131 delay = liftIO $ threadDelay 100000 -- A shorter delay ensures that we update promptly.
137 delay = liftIO $ threadDelay 100000 -- A shorter delay ensures that we update promptly.
132
138
133−type SpinnerTheme = [Text]
134−
135−-- Find more spinners at https://github.com/sindresorhus/cli-spinners/blob/master/spinners.json
136−_spinnerCircleHalves :: SpinnerTheme
137−_spinnerCircleHalves = ["◐", "◓", "◑", "◒"]
138−
139−spinnerMoon :: SpinnerTheme
140−spinnerMoon = ["🌑", "🌒", "🌓", "🌔", "🌕", "🌖", "🌗", "🌘"]
141−
142−defaultSpinnerTheme :: SpinnerTheme
143−defaultSpinnerTheme = spinnerMoon
144−
145-- | Like `bracket` but the `release` function can know whether an exception was raised
139-- | Like `bracket` but the `release` function can know whether an exception was raised
146bracket' :: MonadMask m => m a -> (a -> Maybe c -> m b) -> (a -> m c) -> m c
140bracket' :: MonadMask m => m a -> (a -> Maybe c -> m b) -> (a -> m c) -> m c
147bracket' acquire release use = mask $ \unmasked -> do
141bracket' acquire release use = mask $ \unmasked -> do
lib/cliapp/src/Obelisk/CliApp/Theme.hsnew file+29
@@ -0,0 +1,29 @@
1+{-# LANGUAGE OverloadedStrings #-}
2+module Obelisk.CliApp.Theme where
3+
4+import Data.Text (Text)
5+
6+data CliTheme = CliTheme
7+ { _cliTheme_done :: Text
8+ , _cliTheme_failed :: Text
9+ , _cliTheme_arrow :: Text
10+ , _cliTheme_spinner :: SpinnerTheme
11+ }
12+
13+type SpinnerTheme = [Text]
14+
15+unicodeTheme :: CliTheme
16+unicodeTheme = CliTheme
17+ { _cliTheme_done = "✔"
18+ , _cliTheme_failed = "✖"
19+ , _cliTheme_arrow = "⇾"
20+ , _cliTheme_spinner = ["◐", "◓", "◑", "◒"]
21+ }
22+
23+noUnicodeTheme :: CliTheme
24+noUnicodeTheme = CliTheme
25+ { _cliTheme_done = "DONE"
26+ , _cliTheme_failed = "FAILED"
27+ , _cliTheme_arrow = "->"
28+ , _cliTheme_spinner = ["|", "/", "-", "\\"]
29+ }
lib/cliapp/src/Obelisk/CliApp/Types.hs+10−3
@@ -6,12 +6,14 @@
6{-# LANGUAGE GeneralizedNewtypeDeriving #-}
6{-# LANGUAGE GeneralizedNewtypeDeriving #-}
7{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE OverloadedStrings #-}
9+{-# LANGUAGE StandaloneDeriving #-}
9{-# LANGUAGE UndecidableInstances #-}
10{-# LANGUAGE UndecidableInstances #-}
10module Obelisk.CliApp.Types where
11module Obelisk.CliApp.Types where
11
12
12import Control.Concurrent.MVar (MVar)
13import Control.Concurrent.MVar (MVar)
13import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
14import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
15+import Control.Monad.Fail (MonadFail)
14−import Control.Monad.Log (LoggingT, MonadLog, Severity (..), WithSeverity (..), logMessage)
16+import Control.Monad.Log (LoggingT(..), MonadLog, Severity (..), WithSeverity (..), logMessage)
15import Control.Monad.Reader (MonadIO, ReaderT (..), MonadReader (..), ask, mapReaderT)
17import Control.Monad.Reader (MonadIO, ReaderT (..), MonadReader (..), ask, mapReaderT)
16import Control.Monad.Writer (WriterT)
18import Control.Monad.Writer (WriterT)
17import Control.Monad.State (StateT)
19import Control.Monad.State (StateT)
@@ -23,6 +25,7 @@ import Data.Text (Text)
23import System.Exit (ExitCode (..), exitWith)
25import System.Exit (ExitCode (..), exitWith)
24
26
25import Obelisk.CliApp.TerminalString (TerminalString)
27import Obelisk.CliApp.TerminalString (TerminalString)
28+import Obelisk.CliApp.Theme (CliTheme)
26
29
27--------------------------------------------------------------------------------
30--------------------------------------------------------------------------------
28
31
@@ -44,9 +47,11 @@ type CliThrow e m = MonadError e m
44putLog :: CliLog m => Severity -> Text -> m ()
47putLog :: CliLog m => Severity -> Text -> m ()
45putLog sev = logMessage . Output_Log . WithSeverity sev
48putLog sev = logMessage . Output_Log . WithSeverity sev
46
49
50+deriving instance MonadFail m => MonadFail (LoggingT Output m)
51+
47newtype DieT e m a = DieT { unDieT :: ReaderT (e -> (Text, Int)) (LoggingT Output m) a }
52newtype DieT e m a = DieT { unDieT :: ReaderT (e -> (Text, Int)) (LoggingT Output m) a }
48 deriving
53 deriving
49− ( Functor, Applicative, Monad, MonadIO
54+ ( Functor, Applicative, Monad, MonadIO, MonadFail
50 , MonadThrow, MonadCatch, MonadMask
55 , MonadThrow, MonadCatch, MonadMask
51 , MonadLog Output
56 , MonadLog Output
52 )
57 )
@@ -88,6 +93,8 @@ data CliConfig e = CliConfig
88 _cliConfig_spinnerStack :: IORef ([Bool], [TerminalString])
93 _cliConfig_spinnerStack :: IORef ([Bool], [TerminalString])
89 , -- | Failure handler. How to log error and what exit status to use.
94 , -- | Failure handler. How to log error and what exit status to use.
90 _cliConfig_errorLogExitCode :: e -> (Text, Int)
95 _cliConfig_errorLogExitCode :: e -> (Text, Int)
96+ , -- | Theme strings for spinners
97+ _cliConfig_theme :: CliTheme
91 }
98 }
92
99
93class Monad m => HasCliConfig e m | m -> e where
100class Monad m => HasCliConfig e m | m -> e where
@@ -111,7 +118,7 @@ newtype CliT e m a = CliT
111 { unCliT :: ReaderT (CliConfig e) (DieT e m) a
118 { unCliT :: ReaderT (CliConfig e) (DieT e m) a
112 }
119 }
113 deriving
120 deriving
114− ( Functor, Applicative, Monad, MonadIO
121+ ( Functor, Applicative, Monad, MonadIO, MonadFail
115 , MonadThrow, MonadCatch, MonadMask
122 , MonadThrow, MonadCatch, MonadMask
116 , MonadLog Output -- CliLog
123 , MonadLog Output -- CliLog
117 , MonadError e -- CliThrow
124 , MonadError e -- CliThrow
lib/command/obelisk-command.cabal+20−17
@@ -1,5 +1,5 @@
1name: obelisk-command
1name: obelisk-command
2−version: 0.1
2+version: 0.9.0.1
3cabal-version: >= 1.8
3cabal-version: >= 1.8
4build-type: Simple
4build-type: Simple
5
5
@@ -7,43 +7,48 @@ 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− , obelisk-migration
19 , containers
15 , containers
20 , data-default
16 , data-default
21 , directory
17 , directory
22 , either
18 , either
19+ , errors
20+ , exceptions
21+ , extra
23 , filepath
22 , filepath
23+ , git
24 , github
24 , github
25 , here
25 , here
26− , hit
26+ , hnix
27 , hpack
27 , hpack
28 , io-streams
28 , io-streams
29− , exceptions
30− , logging-effect
31 , lens
29 , lens
30+ , logging-effect
31+ , megaparsec
32 , modern-uri
32 , modern-uri
33 , monad-loops
33 , monad-loops
34+ , monoidal-containers
34 , mtl
35 , mtl
35− , megaparsec
36 , network
36 , network
37 , network-uri
37 , network-uri
38+ , obelisk-cliapp
38 , optparse-applicative
39 , optparse-applicative
39 , placeholders
40 , placeholders
40 , process
41 , process
42+ , shell-escape
41 , temporary
43 , temporary
42 , terminal-size
44 , terminal-size
43 , text
45 , text
44 , time
46 , time
45 , transformers
47 , transformers
46− , unix
48+ , unix-compat
49+ , unordered-containers
50+ , utf8-string
51+ , which
47 , yaml
52 , yaml
48 exposed-modules:
53 exposed-modules:
49 Obelisk.App
54 Obelisk.App
@@ -53,14 +58,12 @@ library
53 Obelisk.Command.Project
58 Obelisk.Command.Project
54 Obelisk.Command.Run
59 Obelisk.Command.Run
55 Obelisk.Command.Thunk
60 Obelisk.Command.Thunk
56− Obelisk.Command.Upgrade
57− Obelisk.Command.Upgrade.Hash
58 Obelisk.Command.Utils
61 Obelisk.Command.Utils
59 Obelisk.Command.VmBuilder
62 Obelisk.Command.VmBuilder
60− -- -fobject-code is so that the StaticPointers extension can work in ghci
63+ Obelisk.Command.Preprocessor
61− ghc-options: -Wall -fobject-code
64+ ghc-options: -Wall
62
65
63executable ob
66executable ob
64 main-is: src-bin/ob.hs
67 main-is: src-bin/ob.hs
65 build-depends: base, obelisk-command
68 build-depends: base, obelisk-command
66− ghc-options: -Wall -O2 -threaded
69+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -threaded
lib/command/src/Obelisk/App.hs+5−2
@@ -12,6 +12,7 @@ module Obelisk.App where
12
12
13import Control.Lens
13import Control.Lens
14import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
14import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
15+import Control.Monad.Fail (MonadFail)
15import Control.Monad.Reader (MonadIO, ReaderT (..), ask, runReaderT)
16import Control.Monad.Reader (MonadIO, ReaderT (..), ask, runReaderT)
16import Control.Monad.Writer (WriterT)
17import Control.Monad.Writer (WriterT)
17import Control.Monad.State (StateT)
18import Control.Monad.State (StateT)
@@ -61,10 +62,11 @@ newtype ObeliskT m a = ObeliskT
61 { unObeliskT :: ReaderT Obelisk (CliT ObeliskError m) a
62 { unObeliskT :: ReaderT Obelisk (CliT ObeliskError m) a
62 }
63 }
63 deriving
64 deriving
64− ( Functor, Applicative, Monad, MonadIO, MonadThrow, MonadCatch, MonadMask
65+ ( Functor, Applicative, Monad, MonadIO, MonadThrow, MonadCatch, MonadMask, MonadFail
65 , MonadLog Output -- CliLog
66 , MonadLog Output -- CliLog
66 , MonadError ObeliskError -- CliThrow ObeliskError
67 , MonadError ObeliskError -- CliThrow ObeliskError
67− , HasCliConfig ObeliskError)
68+ , HasCliConfig ObeliskError
69+ )
68
70
69instance MonadTrans ObeliskT where
71instance MonadTrans ObeliskT where
70 lift = ObeliskT . lift . lift
72 lift = ObeliskT . lift . lift
@@ -104,6 +106,7 @@ type MonadInfallibleObelisk m =
104type MonadObelisk m =
106type MonadObelisk m =
105 ( MonadInfallibleObelisk m
107 ( MonadInfallibleObelisk m
106 , CliThrow ObeliskError m
108 , CliThrow ObeliskError m
109+ , MonadFail m
107 )
110 )
108
111
109getObeliskUserStateDir :: IO FilePath
112getObeliskUserStateDir :: IO FilePath
lib/command/src/Obelisk/Command.hs+249−242
@@ -3,42 +3,35 @@
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)
16−import Data.List
13+import Data.List.NonEmpty (NonEmpty, nonEmpty)
17−import Data.Maybe (catMaybes, listToMaybe)
14+import qualified Data.List.NonEmpty as NonEmpty
18−import Data.Text (Text)
15+import qualified Data.Map as Map
19import qualified Data.Text as T
16import qualified Data.Text as T
20−import Data.Text.Encoding
17+import Data.Traversable (for)
21−import GHC.StaticPtr
22import Options.Applicative
18import Options.Applicative
19+import Options.Applicative.Help.Pretty (text, (<$$>))
23import System.Directory
20import System.Directory
24import System.Environment
21import System.Environment
25import System.FilePath
22import System.FilePath
26import qualified System.Info
23import qualified System.Info
27import System.IO (hIsTerminalDevice, stdout)
24import System.IO (hIsTerminalDevice, stdout)
28−import System.Posix.Process (executeFile)
25+import System.Process (rawSystem)
29
26
30import Obelisk.App
27import Obelisk.App
31import Obelisk.CliApp
28import Obelisk.CliApp
32−import Obelisk.CliApp.Demo (cliDemo)
33import Obelisk.Command.Deploy
29import Obelisk.Command.Deploy
34import Obelisk.Command.Project
30import Obelisk.Command.Project
35import Obelisk.Command.Run
31import Obelisk.Command.Run
36import Obelisk.Command.Thunk
32import Obelisk.Command.Thunk
37−import Obelisk.Command.Upgrade
38−import Obelisk.Command.Upgrade.Hash (getDirectoryHash, getHashAtGitRevision)
39−import Obelisk.Command.Utils
40import qualified Obelisk.Command.VmBuilder as VmBuilder
33import qualified Obelisk.Command.VmBuilder as VmBuilder
41−import Obelisk.Migration (Hash)
34+import qualified Obelisk.Command.Preprocessor as Preprocessor
42
35
43
36
44data Args = Args
37data Args = Args
@@ -81,8 +74,8 @@ argsInfo cfg = info (args cfg <**> helper) $ mconcat
81initSource :: Parser InitSource
74initSource :: Parser InitSource
82initSource = foldl1 (<|>)
75initSource = foldl1 (<|>)
83 [ pure InitSource_Default
76 [ pure InitSource_Default
84− , 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")
85− , 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")
86 ]
79 ]
87
80
88initForce :: Parser Bool
81initForce :: Parser Bool
@@ -91,57 +84,56 @@ initForce = switch (long "force" <> help "Allow ob init to overwrite files")
91data ObCommand
84data ObCommand
92 = ObCommand_Init InitSource Bool
85 = ObCommand_Init InitSource Bool
93 | ObCommand_Deploy DeployCommand
86 | ObCommand_Deploy DeployCommand
94− | ObCommand_Run
87+ | ObCommand_Run [(FilePath, Interpret)]
88+ | ObCommand_Profile String [String]
95− | ObCommand_Thunk ThunkCommand
89+ | ObCommand_Thunk ThunkOption
96− | ObCommand_Repl
90+ | ObCommand_Repl [(FilePath, Interpret)]
97− | ObCommand_Watch
91+ | ObCommand_Watch [(FilePath, Interpret)]
98− | ObCommand_Upgrade (Maybe Text)
92+ | ObCommand_Shell ShellOpts
93+ | ObCommand_Doc String [String] -- shell and list of packages
94+ | ObCommand_Hoogle String Int -- shell and port
99 | ObCommand_Internal ObInternal
95 | ObCommand_Internal ObInternal
100 deriving Show
96 deriving Show
101
97
102data ObInternal
98data ObInternal
103− = ObInternal_RunStaticIO StaticKey
99+ -- the preprocessor argument syntax is also handled outside
104− | ObInternal_Hash (Maybe Text)
100+ -- optparse-applicative, but it shouldn't ever conflict with another syntax
105− | ObInternal_CreateMigration
101+ = ObInternal_ApplyPackages String String String [String]
106− | ObInternal_VerifyMigration
102+ | ObInternal_ExportGhciConfig
107− | ObInternal_Migrate Hash
103+ [(FilePath, Interpret)]
108− | ObInternal_CLIDemo
104+ Bool -- ^ Use relative paths
109 deriving Show
105 deriving Show
110
106
111−inNixShell' :: MonadObelisk m => StaticPtr (ObeliskT IO ()) -> m ()
112−inNixShell' p = withProjectRoot "." $ \root -> do
113− cmd <- liftIO $ unwords <$> mkCmd -- TODO: shell escape instead of unwords
114− projectShell root False "ghc" cmd
115− where
116− mkCmd = do
117− argsCfg <- getArgsConfig
118− myArgs <- getArgs
119− obArgs <- parseCLIArgs argsCfg myArgs
120− progName <- getObeliskExe
121− return $ progName : catMaybes
122− [ Just "--no-handoff"
123− , bool Nothing (Just "--verbose") $ _args_verbose obArgs
124− , Just "internal"
125− , Just "run-static-io"
126− , Just $ encodeStaticKey $ staticKey p
127− ]
128−
129obCommand :: ArgsConfig -> Parser ObCommand
107obCommand :: ArgsConfig -> Parser ObCommand
130obCommand cfg = hsubparser
108obCommand cfg = hsubparser
131− (mconcat
109+ (mconcat
132− [ 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"
133− , 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"
134− , 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"
135− , command "thunk" $ info (ObCommand_Thunk <$> thunkCommand) $ progDesc "Manipulate thunk directories"
114+ , command "thunk" $ info (ObCommand_Thunk <$> thunkOption) $ progDesc "Manipulate thunk directories"
136− , command "repl" $ info (pure ObCommand_Repl) $ progDesc "Open an interactive interpreter"
115+ , command "repl" $ info (ObCommand_Repl <$> interpretOpts) $ progDesc "Open an interactive interpreter"
137− , 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"
138− , command "upgrade" $ info (ObCommand_Upgrade <$> argument (maybeReader $ Just . Just . T.pack) (action "branch" <> metavar "GITBRANCH" <> value Nothing <> help "Git branch of obelisk to update to (defaults to the thunk's branch)")) $ progDesc "Upgrade Obelisk in the project"
117+ , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies or run a command in such a shell. E.g. ob shell -- ghc-pkg list"
139− ])
118+ , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
140− <|> subparser
119+ progDesc "List paths to haddock documentation for specified packages"
141− (mconcat
120+ <> footerDoc (Just $
142− [ internal
121+ text "Hint: To open the documentation you can pipe the output of this command like"
122+ <$$> text "ob doc reflex reflex-dom-core | xargs -n1 xdg-open")
123+ , command "hoogle" $ info (ObCommand_Hoogle <$> shellFlags <*> portOpt 8080) $ progDesc "Run a hoogle server locally for your project's dependency tree"
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")
134+
135+packageNames :: Parser [String]
136+packageNames = some (strArgument (metavar "PACKAGE-NAME..."))
145
137
146deployCommand :: ArgsConfig -> Parser DeployCommand
138deployCommand :: ArgsConfig -> Parser DeployCommand
147deployCommand cfg = hsubparser $ mconcat
139deployCommand cfg = hsubparser $ mconcat
@@ -152,8 +144,8 @@ deployCommand cfg = hsubparser $ mconcat
152 ]
144 ]
153 where
145 where
154 platformP = hsubparser $ mconcat
146 platformP = hsubparser $ mconcat
155− [ command "android" $ info (pure Android) mempty
147+ [ command "android" $ info (pure (Android, [])) mempty
156− , command "ios" $ info (pure IOS <*> 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
157 ]
149 ]
158
150
159 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
151 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
@@ -175,95 +167,149 @@ deployCommand cfg = hsubparser $ mconcat
175
167
176deployInitOpts :: Parser DeployInitOpts
168deployInitOpts :: Parser DeployInitOpts
177deployInitOpts = DeployInitOpts
169deployInitOpts = DeployInitOpts
178− <$> 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")
179− <*> 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")
180 <*> 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"))
181 <*> 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")
182 <*> 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")
183 <*> flag True False (long "disable-https" <> help "Disable automatic https configuration for the backend")
175 <*> flag True False (long "disable-https" <> help "Disable automatic https configuration for the backend")
184
176
185type TeamID = String
177type TeamID = String
186−data PlatformDeployment = Android | IOS TeamID
187− deriving (Show)
188−
189data RemoteBuilder = RemoteBuilder_ObeliskVM
178data RemoteBuilder = RemoteBuilder_ObeliskVM
190 deriving (Eq, Show)
179 deriving (Eq, Show)
191
180
192data DeployCommand
181data DeployCommand
193 = DeployCommand_Init DeployInitOpts
182 = DeployCommand_Init DeployInitOpts
194 | DeployCommand_Push (Maybe RemoteBuilder)
183 | DeployCommand_Push (Maybe RemoteBuilder)
195− | DeployCommand_Test PlatformDeployment
184+ | DeployCommand_Test (PlatformDeployment, [String])
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
227+ } deriving Show
228+
229+data ThunkCommand
230+ = ThunkCommand_Update ThunkUpdateConfig
231+ | ThunkCommand_Unpack
232+ | ThunkCommand_Pack ThunkPackConfig
207 deriving Show
233 deriving Show
208
234
209−internalCommand :: Parser ObInternal
235+thunkOption :: Parser ThunkOption
210−internalCommand = subparser $ mconcat
236+thunkOption = hsubparser $ mconcat
211− [ command "run-static-io" $ info (ObInternal_RunStaticIO <$> argument (eitherReader decodeStaticKey) (action "static-key")) mempty
237+ [ command "update" $ info (thunkOptionWith $ ThunkCommand_Update <$> thunkUpdateConfig) $ progDesc "Update packed thunk to latest revision available on the tracked branch"
212− , command "hash" $ info (ObInternal_Hash <$> argument (maybeReader $ Just . Just . T.pack) (action "rev" <> metavar "GITREVISION" <> value Nothing <> help "Calculate for the specified git revision (defaults to working copy")) $ progDesc "Computes hash of working directory (or git revision)"
238+ , command "unpack" $ info (thunkOptionWith $ pure ThunkCommand_Unpack) $ progDesc "Unpack thunk into git checkout of revision it points to"
213− , command "create-migration" $ info (pure ObInternal_CreateMigration) mempty
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"
214− , command "verify-migration" $ info (pure ObInternal_VerifyMigration) mempty
215− , command "migrate" $ info (ObInternal_Migrate <$> strArgument (action "fromHash" <> metavar "FROMHASH" <> help "Migrate from this hash")) $ progDesc "Perform a migrate from the given hash to HEAD of obelisk thunk"
216− , command "clidemo" $ info (pure ObInternal_CLIDemo) mempty
217 ]
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
249+
250+data ShellOpts
251+ = ShellOpts
252+ { _shellOpts_shell :: String
253+ , _shellOpts_interpretPaths :: [(FilePath, Interpret)]
254+ , _shellOpts_command :: Maybe String
255+ }
256+ deriving Show
218
257
219−--TODO: Result should provide normalised path and also original user input for error reporting.
258+shellFlags :: Parser String
220−thunkDirectoryParser :: Parser FilePath
259+shellFlags =
221−thunkDirectoryParser = fmap (dropTrailingPathSeparator . normalise) . strArgument $ mconcat
260+ flag' "ghc" (long "ghc" <> help "Enter a shell environment having ghc (default)")
222− [ action "directory"
261+ <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
223− , metavar "THUNKDIR"
262+ <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
224− , help "Path to directory containing thunk data"
263+
225− ]
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"
226
283
227−data ThunkCommand
284+shellOpts :: Parser ShellOpts
228− = ThunkCommand_Update [FilePath]
285+shellOpts = ShellOpts
229− | ThunkCommand_Unpack [FilePath]
286+ <$> shellFlags
230− | ThunkCommand_Pack [FilePath]
287+ <*> interpretOpts
231− deriving Show
288+ -- This funny construction is used to support optparse-applicative's @--@ parsing.
289+ -- All arguments after @--@ are left unparsed and instead provided to the last positional parser
290+ -- which must therefore be 'many' in order to consume the rest of the input.
291+ <*> ((\xs -> if null xs then Nothing else Just $ unwords xs) <$> many (strArgument (metavar "COMMAND")))
232
292
233−thunkCommand :: Parser ThunkCommand
293+portOpt :: Int -> Parser Int
234−thunkCommand = hsubparser $ mconcat
294+portOpt dfault = option auto (long "port" <> short 'p' <> help "Port number for server" <> showDefault <> value dfault <> metavar "INT")
235− [ command "update" $ info (ThunkCommand_Update <$> some thunkDirectoryParser) $ progDesc "Update thunk to latest revision available"
236− , command "unpack" $ info (ThunkCommand_Unpack <$> some thunkDirectoryParser) $ progDesc "Unpack thunk into git checkout of revision it points to"
237− , command "pack" $ info (ThunkCommand_Pack <$> some thunkDirectoryParser) $ progDesc "Pack git checkout into thunk that points at the current branch's upstream"
238− ]
239
295
240parserPrefs :: ParserPrefs
296parserPrefs :: ParserPrefs
241parserPrefs = defaultPrefs
297parserPrefs = defaultPrefs
242 { prefShowHelpOnEmpty = True
298 { prefShowHelpOnEmpty = True
243 }
299 }
244
300
245−parseCLIArgs :: ArgsConfig -> [String] -> IO Args
246−parseCLIArgs cfg as = pure as >>= handleParseResult . execParserPure parserPrefs (argsInfo cfg)
247−
248-- | Create an Obelisk config for the current process.
301-- | Create an Obelisk config for the current process.
249mkObeliskConfig :: IO Obelisk
302mkObeliskConfig :: IO Obelisk
250mkObeliskConfig = do
303mkObeliskConfig = do
251 cliArgs <- getArgs
304 cliArgs <- getArgs
252 -- This function should not use argument parser (full argument parsing happens post handoff)
305 -- This function should not use argument parser (full argument parsing happens post handoff)
306+ -- TODO: See if we can use the argument parser with a subset of the parsers to get logging level out.
253− let logLevel = toLogLevel $ "-v" `elem` cliArgs
307+ let logLevel = toLogLevel $ any (`elem` ["-v", "--verbose"]) cliArgs
254 notInteractive <- not <$> isInteractiveTerm
308 notInteractive <- not <$> isInteractiveTerm
255−-- instance MonadIO m => MonadError (Either Text ProcessFailed) (DieT m) where
256−-- throwError = \case
257−-- Left s -> do
258−-- putLog Alert s
259−-- liftIO $ exitWith $ ExitFailure 2
260−-- Right (ProcessFailed p code) -> do
261−-- putLog Alert $ "Process exited with code " <> T.pack (show code) <> "; " <> T.pack (show p)
262−-- liftIO $ exitWith $ ExitFailure 2
263 cliConf <- newCliConfig logLevel notInteractive notInteractive $ \case
309 cliConf <- newCliConfig logLevel notInteractive notInteractive $ \case
264 ObeliskError_ProcessError (ProcessFailure p code) ann ->
310 ObeliskError_ProcessError (ProcessFailure p code) ann ->
265− ( "Process exited with code " <> T.pack (show code) <> "; " <> T.pack (show p)
311+ ( "Process exited with code " <> T.pack (show code) <> "; " <> reconstructCommand p
266− <> maybe "" ("\n\n" <>) ann
312+ <> maybe "" ("\n" <>) ann
267 , 2
313 , 2
268 )
314 )
269 ObeliskError_Unstructured msg -> (msg, 2)
315 ObeliskError_Unstructured msg -> (msg, 2)
@@ -305,144 +351,105 @@ main' argsCfg = do
305 , "logging-level=" <> show logLevel
351 , "logging-level=" <> show logLevel
306 ]
352 ]
307
353
308− (mainWithHandOff argsCfg <=< parseHandoff) =<< liftIO getArgs
354+ --TODO: We'd like to actually use the parser to determine whether to hand off,
309−
355+ --but in the case where this implementation of 'ob' doesn't support all
310−-- Type representing the result of a handoff calculation.
356+ --arguments being passed along, this could fail. For now, we don't bother
311−data HandOff m
357+ --with optparse-applicative until we've done the handoff.
312− = HandOff_Yes FilePath [String] -- Handoff immediately to the given impl with the given args
358+ let go as = do
313− | HandOff_Decide (m Bool) FilePath [String] -- Handoff only if the action returns True
359+ args' <- liftIO $ handleParseResult (execParserPure parserPrefs (argsInfo argsCfg) as)
314− | HandOff_No [String] -- Do not handoff, and continue with the given args
315−
316−mainWithHandOff :: MonadObelisk m => ArgsConfig -> HandOff m -> m ()
317−mainWithHandOff argsCfg = \case
318− HandOff_Yes impl as -> do
319− putLog Debug $ "Handing off to project obelisk " <> T.pack impl
320− liftIO $ executeFile impl False ("--no-handoff" : as) Nothing
321− HandOff_Decide f impl as -> do
322− withSpinner' "Deciding whether to handoff"
323− (Just $ bool
324− "Continuing in ambient obelisk without handing off"
325− "Handed off to project obelisk") f >>= \case
326− True -> mainWithHandOff argsCfg $ HandOff_Yes impl as
327− False -> mainWithHandOff argsCfg $ HandOff_No as
328− HandOff_No as -> do
329− putLog Debug $ "Not handing off"
330− args' <- liftIO $ parseCLIArgs argsCfg as
331− warnIfExtraneousFlag args'
332− ob $ _args_command args'
333− where
334− warnIfExtraneousFlag a = case _args_noHandOffPassed a of
360+ case _args_noHandOffPassed args' of
335− False -> return ()
361+ False -> return ()
336− True -> putLog Warning $
337− "Ignoring unexpected --no-handoff (should only be passed once and as the first argument)"
362+ True -> putLog Warning "--no-handoff should only be passed once and as the first argument; ignoring"
338−
363+ ob $ _args_command args'
339−-- Handoff logic
340−parseHandoff :: MonadObelisk m => [String] -> m (HandOff m)
341−parseHandoff as' = case hasNoHandoff as' of
342− (True, as) ->
343− pure $ HandOff_No as
344− (False, as) -> findProjectObeliskCommand "." >>= \case
364+ handoffAndGo as = findProjectObeliskCommand "." >>= \case
345− Nothing -> do
365+ Nothing -> go as -- If not in a project, just run ourselves
346− putLog Debug "Not in a project; no need to hand off"
366+ Just impl -> do
347− pure $ HandOff_No as
367+ -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
348− Just impl -> case getSubCommand as of
368+ putLog Debug $ "Handing off to " <> T.pack impl
349− Just "upgrade" ->
369+ _ <- liftIO $ rawSystem impl ("--no-handoff" : myArgs)
350− pure $ HandOff_Decide (decideHandOffToProjectOb ".") impl as
370+ return ()
351− _ ->
371+ case myArgs of
352− pure $ HandOff_Yes impl as
353− where
354− getSubCommand = listToMaybe . filter (not . isPrefixOf "-")
355− hasNoHandoff = \case
356− "--no-handoff" : xs ->
357− -- If we've been told not to hand off, don't hand off
372+ "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
358− (True, xs)
373+ origPath:inPath:outPath:preprocessorName:packagePaths
359− x:xs
374+ | preprocessorName == preprocessorIdentifier && any (\c -> c == '.' || c == pathSeparator) origPath ->
375+ ob $ ObCommand_Internal $ ObInternal_ApplyPackages origPath inPath outPath packagePaths
360− -- Otherwise bash completion would always hand-off even if the user isn't trying to
376+ a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
361− | "--bash-completion" `isPrefixOf` x && "--no-handoff" `elem` xs ->
377+ | "--bash-completion" `isPrefixOf` a
362− (True, x:xs)
378+ && "--no-handoff" `elem` as -> go (a:as)
363− | otherwise ->
379+ | otherwise -> handoffAndGo (a:as)
364− (False, x:xs)
380+ as -> handoffAndGo as
365− xs ->
366− (False, xs)
367
381
368ob :: MonadObelisk m => ObCommand -> m ()
382ob :: MonadObelisk m => ObCommand -> m ()
369ob = \case
383ob = \case
370 ObCommand_Init source force -> initProject source force
384 ObCommand_Init source force -> initProject source force
371 ObCommand_Deploy dc -> case dc of
385 ObCommand_Deploy dc -> case dc of
372− DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> do
386+ DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> deployInit deployOpts root
373− let deployDir = _deployInitOpts_outputDir deployOpts
374− r <- liftIO $ canonicalizePath root
375− rootEqualsTarget <- liftIO $ equalFilePath r <$> canonicalizePath deployDir
376− when rootEqualsTarget $
377− failWith $ "Deploy directory " <> T.pack deployDir <> " should not be the same as project root."
378− thunkPtr <- readThunk root >>= \case
379− Left err -> failWith $ case err of
380− ReadThunkError_AmbiguousFiles ->
381− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
382− ReadThunkError_UnrecognizedFiles ->
383− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
384− _ -> "thunk read: " <> T.pack (show err)
385− Right (ThunkData_Packed ptr) -> return ptr
386− Right (ThunkData_Checkout (Just ptr)) -> return ptr
387− Right (ThunkData_Checkout Nothing) ->
388− getThunkPtr' False root
389− let sshKeyPath = _deployInitOpts_sshKey deployOpts
390− hostname = _deployInitOpts_hostname deployOpts
391− route = _deployInitOpts_route deployOpts
392− adminEmail = _deployInitOpts_adminEmail deployOpts
393− enableHttps = _deployInitOpts_enableHttps deployOpts
394− deployInit thunkPtr (root </> "config") deployDir
395− sshKeyPath hostname route adminEmail enableHttps
396 DeployCommand_Push remoteBuilder -> do
387 DeployCommand_Push remoteBuilder -> do
397 deployPath <- liftIO $ canonicalizePath "."
388 deployPath <- liftIO $ canonicalizePath "."
398 deployPush deployPath $ case remoteBuilder of
389 deployPush deployPath $ case remoteBuilder of
399 Nothing -> pure []
390 Nothing -> pure []
400 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
391 Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
401 DeployCommand_Update -> deployUpdate "."
392 DeployCommand_Update -> deployUpdate "."
402− DeployCommand_Test Android -> deployMobile "android" []
393+ DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
403− DeployCommand_Test (IOS teamID) -> deployMobile "ios" [teamID]
394+ ObCommand_Run interpretPathsList -> withInterpretPaths interpretPathsList run
404− ObCommand_Run -> inNixShell' $ static run
395+ ObCommand_Profile basePath rtsFlags -> profile basePath rtsFlags
405− -- inNixShell ($(mkClosure 'ghcidAction) ())
406− ObCommand_Thunk tc -> case tc of
396+ ObCommand_Thunk to -> case _thunkOption_command to of
407− ThunkCommand_Update thunks -> mapM_ updateThunkToLatest thunks
397+ ThunkCommand_Update config -> for_ thunks (updateThunkToLatest config)
408− ThunkCommand_Unpack thunks -> mapM_ unpackThunk thunks
398+ ThunkCommand_Unpack -> for_ thunks unpackThunk
409− ThunkCommand_Pack thunks -> forM_ thunks packThunk
399+ ThunkCommand_Pack config -> for_ thunks (packThunk config)
400+ where
401+ thunks = _thunkOption_thunks to
410− ObCommand_Repl -> runRepl
402+ ObCommand_Repl interpretPathsList -> withInterpretPaths interpretPathsList runRepl
411− ObCommand_Watch -> inNixShell' $ static runWatch
403+ ObCommand_Watch interpretPathsList -> withInterpretPaths interpretPathsList runWatch
412− ObCommand_Upgrade branch -> do
404+ ObCommand_Shell (ShellOpts shellAttr interpretPathsList cmd) -> withInterpretPaths interpretPathsList $ \root interpretPaths ->
413− upgradeObelisk "." branch
405+ nixShellForInterpretPaths False shellAttr root interpretPaths cmd -- N.B. We do NOT bash escape here; we want to run the command as-is
406+ ObCommand_Doc shellAttr pkgs -> withInterpretPaths [] $ \root interpretPaths ->
407+ nixShellForInterpretPaths True shellAttr root interpretPaths $ Just $ haddockCommand pkgs
408+ ObCommand_Hoogle shell' port -> withProjectRoot "." $ \root -> do
409+ nixShellWithHoogle root True shell' $ Just $ "hoogle server -p" <> show port <> " --local"
414 ObCommand_Internal icmd -> case icmd of
410 ObCommand_Internal icmd -> case icmd of
415− ObInternal_RunStaticIO k -> liftIO (unsafeLookupStaticPtr @(ObeliskT IO ()) k) >>= \case
411+ ObInternal_ApplyPackages origPath inPath outPath packagePaths -> do
416− Nothing -> failWith $ "ObInternal_RunStaticIO: no such StaticKey: " <> T.pack (show k)
412+ liftIO $ Preprocessor.applyPackages origPath inPath outPath packagePaths
417− Just p -> do
413+ ObInternal_ExportGhciConfig interpretPathsList useRelativePaths ->
418− c <- getObelisk
414+ liftIO . putStrLn . unlines =<< withInterpretPaths interpretPathsList (exportGhciConfig useRelativePaths)
419− liftIO $ runObelisk c $ deRefStaticPtr p
415+
420− ObInternal_Hash revM -> do
416+-- | A helper for the common case that the command you want to run needs the project root and a resolved
421− hash <- case revM of
417+-- set of interpret paths.
422− Nothing -> getDirectoryHash [migrationDirName] "."
418+withInterpretPaths :: MonadObelisk m => [(FilePath, Interpret)] -> (FilePath -> PathTree Interpret -> m a) -> m a
423− Just rev -> fmap head $ getHashAtGitRevision [rev] [migrationDirName] "."
419+withInterpretPaths interpretPathsList f = withProjectRoot "." $ \root -> do
424− putLog Notice hash
420+ interpretPaths' <- resolveInterpretPaths $ (root, Interpret_Interpret) : interpretPathsList
425− ObInternal_CreateMigration ->
421+ case interpretPaths' of
426− createMigrationEdgeFromHEAD "."
422+ Nothing -> failWith "No paths provided for finding packages"
427− ObInternal_VerifyMigration ->
423+ Just interpretPaths -> f root interpretPaths
428− verifyMigration "."
424+
429− ObInternal_Migrate fromHash ->
425+haddockCommand :: [String] -> String
430− migrateObelisk "." fromHash
426+haddockCommand pkgs = unwords
431− ObInternal_CLIDemo -> cliDemo
427+ [ "for p in"
428+ , unwords [getHaddockPath p ++ "/index.html" | p <- pkgs]
429+ , "; do echo $p; done"
430+ ]
431+ where getHaddockPath p = "$(ghc-pkg field " ++ p ++ " haddock-html --simple-output)"
432
432
433--TODO: Clean up all the magic strings throughout this codebase
433--TODO: Clean up all the magic strings throughout this codebase
434
434
435getArgsConfig :: IO ArgsConfig
435getArgsConfig :: IO ArgsConfig
436getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
436getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
437
437
438−encodeStaticKey :: StaticKey -> String
438+-- | Resolves an ordered list of paths for use with @--interpret@/@--no-interpret@ by coalescing
439−encodeStaticKey = T.unpack . decodeUtf8 . Base16.encode . LBS.toStrict . Binary.encode
439+-- paths into a non-ambiguous set of paths. Ambiguity is resolved by choosing right-most paths
440−
440+-- over any preceeding identical paths.
441−-- TODO: Use failWith in place of fail to be consistent.
441+--
442−decodeStaticKey :: String -> Either String StaticKey
442+-- For example: @a/b=ON a/b/c=OFF@ and @a/b/c=OFF a/b=ON@ are the same.
443−decodeStaticKey s = case Base16.decode $ encodeUtf8 $ T.pack s of
443+-- @a/b=ON a/b=OFF@ is reduced to @a/b=OFF@. We prefer right-biased choice to increase
444− (b, "") -> case Binary.decodeOrFail $ LBS.fromStrict b of
444+-- scriptability.
445− Right ("", _, a) -> pure a
445+--
446− Right _ -> fail "decodeStaticKey: Binary.decodeOrFail didn't consume all input"
446+-- N.B. All the paths in the result will be canonicalized. It's impossible to determine path
447− Left (_, _, e) -> fail $ "decodeStaticKey: Binary.decodeOrFail failed: " <> show e
447+-- overlap otherwise.
448− _ -> fail $ "decodeStaticKey: could not decode hex string: " <> show s
448+resolveInterpretPaths :: MonadIO m => [(FilePath, a)] -> m (Maybe (PathTree a))
449+resolveInterpretPaths ps = do
450+ trees <- liftIO $ for ps $ \(p, a) -> pathToTree a <$> canonicalizePath p
451+ pure $ foldr1 mergeTrees <$> nonEmpty trees
452+ where
453+ -- | Merge two 'PathTree's preferring leaves on the right in as much as they overlap with paths on the left.
454+ mergeTrees :: PathTree a -> PathTree a -> PathTree a
455+ mergeTrees (PathTree_Node ax x) (PathTree_Node ay y) = PathTree_Node (ay <|> ax) $ Map.unionWith mergeTrees x y
lib/command/src/Obelisk/Command/Deploy.hs+241−99
@@ -1,168 +1,309 @@
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 #-}
6module Obelisk.Command.Deploy where
8module Obelisk.Command.Deploy where
7
9
10+import Control.Applicative (liftA2)
8import Control.Lens
11import Control.Lens
9import Control.Monad
12import Control.Monad
10−import Control.Monad.Catch (Exception (displayException), MonadThrow, throwM, try)
13+import Control.Monad.Catch (Exception (displayException), MonadThrow, bracket, throwM, try)
11−import Control.Monad.IO.Class (liftIO)
14+import Control.Monad.IO.Class (MonadIO, liftIO)
15+import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
12import Data.Bits
16import Data.Bits
17+import qualified Data.ByteString.Lazy as BSL
13import Data.Default
18import Data.Default
14import qualified Data.Map as Map
19import qualified Data.Map as Map
15−import Data.Maybe
20+import qualified Data.Set as Set
21+import Data.String.Here.Interpolated (i)
16import qualified Data.Text as T
22import qualified Data.Text as T
17import qualified Data.Text.IO as T
23import qualified Data.Text.IO as T
24+import GHC.Generics
18import System.Directory
25import System.Directory
19−import System.Environment (getEnvironment)
20import System.FilePath
26import System.FilePath
21−import System.Posix.Files
27+import System.IO
22−import System.Process (delegate_ctlc, env, proc)
28+import System.PosixCompat.Files
23import Text.URI (URI)
29import Text.URI (URI)
24import qualified Text.URI as URI
30import qualified Text.URI as URI
25import Text.URI.Lens
31import Text.URI.Lens
26
32
27import Obelisk.App (MonadObelisk)
33import Obelisk.App (MonadObelisk)
34+import Obelisk.CliApp (
28−import Obelisk.CliApp (Severity (..), callProcessAndLogOutput, failWith, putLog, withSpinner)
35+ Severity (..), callProcessAndLogOutput, failWith, proc, putLog,
36+ setCwd, setDelegateCtlc, setEnvOverride, withSpinner)
29import Obelisk.Command.Nix
37import Obelisk.Command.Nix
30import Obelisk.Command.Project
38import Obelisk.Command.Project
31import Obelisk.Command.Thunk
39import Obelisk.Command.Thunk
32import Obelisk.Command.Utils
40import Obelisk.Command.Utils
33
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+
34−deployInit
62+deployInit'
35 :: MonadObelisk m
63 :: MonadObelisk m
36 => ThunkPtr
64 => ThunkPtr
37− -> FilePath
65+ -> DeployInitOpts
38− -> FilePath
39− -> FilePath
40− -> [String] -- ^ hostnames
41− -> String -- ^ route
42− -> String -- ^ admin email
43− -> Bool -- ^ enable https
44 -> m ()
66 -> m ()
45−deployInit thunkPtr configDir deployDir sshKeyPath hostnames route adminEmail enableHttps = do
67+deployInit' thunkPtr (DeployInitOpts deployDir sshKeyPath hostnames route adminEmail enableHttps) = do
68+ liftIO $ createDirectoryIfMissing True deployDir
46− (hasConfigDir, localKey) <- withSpinner ("Preparing " <> T.pack deployDir) $ do
69+ localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
47− hasConfigDir <- liftIO $ do
48− createDirectoryIfMissing True deployDir
49− doesDirectoryExist configDir
50 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
70 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
51 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
52 True -> pure $ deployDir </> "ssh_key"
72 True -> pure $ deployDir </> "ssh_key"
53 callProcessAndLogOutput (Notice, Error) $
73 callProcessAndLogOutput (Notice, Error) $
54− proc "cp" [sshKeyPath, localKey]
74+ proc cp [sshKeyPath, localKey]
55 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
75 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
56− return $ (hasConfigDir, localKey)
76+ return localKey
57 withSpinner "Validating configuration" $ do
77 withSpinner "Validating configuration" $ do
58 void $ getHostFromRoute enableHttps route -- make sure that hostname is present
78 void $ getHostFromRoute enableHttps route -- make sure that hostname is present
59 forM_ hostnames $ \hostname -> do
79 forM_ hostnames $ \hostname -> do
60 putLog Notice $ "Verifying host keys (" <> T.pack hostname <> ")"
80 putLog Notice $ "Verifying host keys (" <> T.pack hostname <> ")"
61 -- Note: we can't use a spinner here as this function will prompt the user.
81 -- Note: we can't use a spinner here as this function will prompt the user.
62 verifyHostKey (deployDir </> "backend_known_hosts") localKey hostname
82 verifyHostKey (deployDir </> "backend_known_hosts") localKey hostname
83+ --IMPORTANT: We cannot copy config directory from the development project to
84+ --the deployment directory. If we do, it's very likely someone will
85+ --accidentally create a production deployment that uses development
86+ --credentials to connect to some resources. This could result in, e.g.,
87+ --production data backed up to a dev environment.
63− when hasConfigDir $ withSpinner "Importing project configuration" $ do
88+ withSpinner "Creating project configuration directories" $ liftIO $ do
64− callProcessAndLogOutput (Notice, Error) $
89+ mapM_ (createDirectoryIfMissing True)
90+ [ deployDir </> "config" </> "backend"
91+ , deployDir </> "config" </> "common"
65− proc "cp" [ "-r" , "-T" , configDir , deployDir </> "config"]
92+ , deployDir </> "config" </> "frontend"
93+ ]
94+
95+ let srcDir = deployDir </> "src"
96+ withSpinner ("Creating source thunk (" <> T.pack (makeRelative deployDir srcDir) <> ")") $ do
97+ createThunk srcDir $ Right thunkPtr
98+ setupObeliskImpl deployDir
99+
66 withSpinner "Writing deployment configuration" $ do
100 withSpinner "Writing deployment configuration" $ do
67 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
101 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
68 writeDeployConfig deployDir "enable_https" $ show enableHttps
102 writeDeployConfig deployDir "enable_https" $ show enableHttps
69 writeDeployConfig deployDir "admin_email" adminEmail
103 writeDeployConfig deployDir "admin_email" adminEmail
70− writeDeployConfig deployDir ("config" </> "common" </> "route") $ route
104+ writeDeployConfig deployDir ("config" </> "common" </> "route") route
71− withSpinner "Creating source thunk (./src)" $ liftIO $ do
105+ writeDeployConfig deployDir "module.nix" $
72− createThunk (deployDir </> "src") thunkPtr
106+ "(import " <> toNixPath (makeRelative deployDir srcDir) <> " {}).obelisk.serverModules.mkBaseEc2"
73− setupObeliskImpl deployDir
107+
74 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
108 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
75 initGit deployDir
109 initGit deployDir
76
110
77−setupObeliskImpl :: FilePath -> IO ()
111+setupObeliskImpl :: MonadIO m => FilePath -> m ()
78−setupObeliskImpl deployDir = do
112+setupObeliskImpl deployDir = liftIO $ do
113+ let
79− let implDir = toImplDir deployDir
114+ implDir = toImplDir deployDir
115+ goBackUp = foldr (</>) "" $ (".." <$) $ splitPath $ makeRelative deployDir implDir
80 createDirectoryIfMissing True implDir
116 createDirectoryIfMissing True implDir
81− writeFile (implDir </> "default.nix") "(import ../../src {}).obelisk"
117+ writeFile (implDir </> "default.nix") $ "(import " <> toNixPath (goBackUp </> "src") <> " {}).obelisk"
82
118
83deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
119deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
84deployPush deployPath getNixBuilders = do
120deployPush deployPath getNixBuilders = do
85− host <- readDeployConfig deployPath "backend_hosts"
121+ hosts <- Set.fromList . filter (/= mempty) . lines <$> readDeployConfig deployPath "backend_hosts"
86 adminEmail <- readDeployConfig deployPath "admin_email"
122 adminEmail <- readDeployConfig deployPath "admin_email"
87 enableHttps <- read <$> readDeployConfig deployPath "enable_https"
123 enableHttps <- read <$> readDeployConfig deployPath "enable_https"
88 route <- readDeployConfig deployPath $ "config" </> "common" </> "route"
124 route <- readDeployConfig deployPath $ "config" </> "common" </> "route"
89 routeHost <- getHostFromRoute enableHttps route
125 routeHost <- getHostFromRoute enableHttps route
90 let srcPath = deployPath </> "src"
126 let srcPath = deployPath </> "src"
91− build = do
92− builders <- getNixBuilders
93− buildOutput <- nixBuild $ def
94− { _nixBuildConfig_target = Target
95− { _target_path = srcPath
96− , _target_attr = Just "server.system"
97− }
98− , _nixBuildConfig_outLink = OutLink_None
99− , _nixBuildConfig_args =
100− [ strArg "hostName" host
101− , strArg "adminEmail" adminEmail
102− , strArg "routeHost" routeHost
103− , boolArg "enableHttps" enableHttps
104− , rawArg "config" $ deployPath </> "config"
105− ]
106− , _nixBuildConfig_builders = builders
107− }
108− return $ listToMaybe $ lines buildOutput
109− result <- readThunk srcPath >>= \case
127+ thunkPtr <- readThunk srcPath >>= \case
110− Right (ThunkData_Packed _) ->
128+ Right (ThunkData_Packed _ ptr) -> return ptr
111− build
112− Right (ThunkData_Checkout _) -> do
129+ Right ThunkData_Checkout -> do
113 checkGitCleanStatus srcPath True >>= \case
130 checkGitCleanStatus srcPath True >>= \case
114− True -> do
115− result <- build
116− packThunk srcPath
131+ True -> packThunk (ThunkPackConfig False (ThunkConfig Nothing)) srcPath
117− return result
118− False -> do
119− _ <- failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
132+ False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
120− return Nothing
133+ Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
121− _ -> return Nothing
134+ let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
122− forM_ result $ \res -> do
135+ builders <- getNixBuilders
136+ let moduleFile = deployPath </> "module.nix"
137+ moduleFileExists <- liftIO $ doesFileExist moduleFile
138+ buildOutputByHost <- ifor (Map.fromSet (const ()) hosts) $ \host () -> do
139+ --TODO: What does it mean if this returns more or less than 1 line of output?
140+ [result] <- fmap lines $ nixCmd $ NixCmd_Build $ def
141+ & nixCmdConfig_target .~ Target
142+ { _target_path = Just srcPath
143+ , _target_attr = Just "server.system"
144+ , _target_expr = Nothing
145+ }
146+ & nixBuildConfig_outLink .~ OutLink_None
147+ & nixCmdConfig_args .~ (
148+ [ strArg "hostName" host
149+ , strArg "adminEmail" adminEmail
150+ , strArg "routeHost" routeHost
151+ , strArg "version" version
152+ , boolArg "enableHttps" enableHttps
153+ ] <> [rawArg "module" ("import " <> toNixPath moduleFile) | moduleFileExists ])
154+ & nixCmdConfig_builders .~ builders
155+ pure result
123− let knownHostsPath = deployPath </> "backend_known_hosts"
156+ let knownHostsPath = deployPath </> "backend_known_hosts"
124− sshOpts = sshArgs knownHostsPath (deployPath </> "ssh_key") False
157+ sshOpts = sshArgs knownHostsPath (deployPath </> "ssh_key") False
125− deployAndSwitch outputPath = do
126− withSpinner "Uploading closure" $ do
158+ withSpinner "Uploading closures" $ ifor_ buildOutputByHost $ \host outputPath -> do
127− callProcess'
159+ callProcess'
128− (Map.fromList [("NIX_SSHOPTS", unwords sshOpts)])
160+ (Map.fromList [("NIX_SSHOPTS", unwords sshOpts)])
129− "nix-copy-closure" ["-v", "--to", "root@" <> host, "--gzip", outputPath]
161+ "nix-copy-closure" ["-v", "--to", "--use-substitutes", "root@" <> host, "--gzip", outputPath]
130−
162+ withSpinner "Uploading config" $ ifor_ buildOutputByHost $ \host _ -> do
163+ callProcessAndLogOutput (Notice, Warning) $
164+ proc rsyncPath
165+ [ "-e " <> sshPath <> " " <> unwords sshOpts
166+ , "-qarvz"
167+ , deployPath </> "config"
168+ , "root@" <> host <> ":/var/lib/backend"
169+ ]
170+ --TODO: Create GC root so we're sure our closure won't go away during this time period
131− withSpinner "Switching to new configuration" $ do
171+ withSpinner "Switching to new configuration" $ ifor_ buildOutputByHost $ \host outputPath -> do
132− callProcessAndLogOutput (Notice, Warning) $
172+ callProcessAndLogOutput (Notice, Warning) $
133− proc "ssh" $ sshOpts <>
173+ proc sshPath $ sshOpts <>
134− [ "root@" <> host
174+ [ "root@" <> host
135− , unwords
175+ , unwords
176+ -- Note that we don't want to $(staticWhich "nix-env") here, because this is executing on a remote machine
136− [ "nix-env -p /nix/var/nix/profiles/system --set " <> outputPath
177+ [ "nix-env -p /nix/var/nix/profiles/system --set " <> outputPath
137− , "&&"
178+ , "&&"
138− , "/nix/var/nix/profiles/system/bin/switch-to-configuration switch"
179+ , "/nix/var/nix/profiles/system/bin/switch-to-configuration switch"
139− ]
180+ ]
140− ]
181+ ]
141− deployAndSwitch res
142− isClean <- checkGitCleanStatus deployPath True
182+ isClean <- checkGitCleanStatus deployPath True
143− when (not isClean) $ do
183+ when (not isClean) $ do
144− withSpinner "Commiting changes to Git" $ do
184+ withSpinner "Committing changes to Git" $ do
145− callProcessAndLogOutput (Debug, Error) $ proc "git"
185+ callProcessAndLogOutput (Debug, Error) $
146− ["-C", deployPath, "add", "."]
186+ gitProc deployPath ["add", "."]
147− callProcessAndLogOutput (Debug, Error) $ proc "git"
187+ callProcessAndLogOutput (Debug, Error) $
148− ["-C", deployPath, "commit", "-m", "New deployment"]
188+ gitProc deployPath ["commit", "-m", "New deployment"]
149− putLog Notice $ "Deployed => " <> T.pack route
189+ putLog Notice $ "Deployed => " <> T.pack route
150 where
190 where
151 callProcess' envMap cmd args = do
191 callProcess' envMap cmd args = do
152− processEnv <- Map.toList . (envMap <>) . Map.fromList <$> liftIO getEnvironment
192+ let p = setEnvOverride (envMap <>) $ setDelegateCtlc True $ proc cmd args
153− let p = (proc cmd args) { delegate_ctlc = True, env = Just processEnv }
154 callProcessAndLogOutput (Notice, Notice) p
193 callProcessAndLogOutput (Notice, Notice) p
155
194
156deployUpdate :: MonadObelisk m => FilePath -> m ()
195deployUpdate :: MonadObelisk m => FilePath -> m ()
157−deployUpdate deployPath = updateThunkToLatest $ deployPath </> "src"
196+deployUpdate deployPath = updateThunkToLatest (ThunkUpdateConfig Nothing (ThunkConfig Nothing)) (deployPath </> "src")
197+
198+data PlatformDeployment = Android | IOS
199+ deriving (Show, Eq)
200+
201+renderPlatformDeployment :: PlatformDeployment -> String
202+renderPlatformDeployment = \case
203+ Android -> "android"
204+ IOS -> "ios"
158
205
159−deployMobile :: MonadObelisk m => String -> [String] -> m ()
206+deployMobile :: forall m. MonadObelisk m => PlatformDeployment -> [String] -> m ()
160deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
207deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
161 let srcDir = root </> "src"
208 let srcDir = root </> "src"
209+ configDir = root </> "config"
162 exists <- liftIO $ doesDirectoryExist srcDir
210 exists <- liftIO $ doesDirectoryExist srcDir
163 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"
164− result <- nixBuildAttrWithCache srcDir $ platform <> ".frontend"
212+ (nixBuildTarget, extraArgs) <- case platform of
213+ Android -> do
214+ let keystorePath = root </> "android_keystore.jks"
215+ keytoolConfPath = root </> "android_keytool_config.json"
216+ hasKeystore <- liftIO $ doesFileExist keystorePath
217+ when (not hasKeystore) $ do
218+ -- TODO log instructions for how to modify the keystore
219+ putLog Notice $ "Creating keystore: " <> T.pack keystorePath
220+ putLog Notice "Enter a keystore password: "
221+ keyStorePassword <- liftIO $ withEcho False getLine
222+ putLog Notice "Re-enter the keystore password: "
223+ keyStorePassword' <- liftIO $ withEcho False getLine
224+ unless (keyStorePassword' == keyStorePassword) $ failWith "passwords do not match"
225+ let keyToolConf = KeytoolConfig
226+ { _keytoolConfig_keystore = keystorePath
227+ , _keytoolConfig_alias = "obelisk"
228+ , _keytoolConfig_storepass = keyStorePassword
229+ , _keytoolConfig_keypass = keyStorePassword
230+ }
231+ createKeystore root keyToolConf
232+ liftIO $ BSL.writeFile keytoolConfPath $ encode keyToolConf
233+ checkKeytoolConfExist <- liftIO $ doesFileExist keytoolConfPath
234+ unless checkKeytoolConfExist $ failWith "Missing android KeytoolConfig"
235+ keytoolConfContents <- liftIO $ BSL.readFile keytoolConfPath
236+ keyArgs <- case eitherDecode keytoolConfContents :: Either String KeytoolConfig of
237+ Left err -> failWith $ T.pack err
238+ Right conf -> pure
239+ [ "--sign"
240+ , "--store-file", _keytoolConfig_keystore conf
241+ , "--store-password", _keytoolConfig_storepass conf
242+ , "--key-alias", _keytoolConfig_alias conf
243+ , "--key-password", _keytoolConfig_keypass conf
244+ ]
245+ let expr = mconcat
246+ [ "with (import ", toNixPath srcDir, " {});"
247+ , "android.frontend.override (drv: {"
248+ , "isRelease = true;"
249+ , "staticSrc = (passthru.__androidWithConfig ", configDir, ").frontend.staticSrc;"
250+ , "assets = (passthru.__androidWithConfig ", configDir, ").frontend.assets;"
251+ , "})"
252+ ]
253+ return (Target
254+ { _target_path = Nothing
255+ , _target_attr = Nothing
256+ , _target_expr = Just expr
257+ }, keyArgs)
258+ IOS -> do
259+ let expr = mconcat
260+ [ "with (import ", toNixPath srcDir, " {});"
261+ , "ios.frontend.override (_: { staticSrc = (passthru.__iosWithConfig ", toNixPath configDir, ").frontend.staticSrc; })"
262+ ]
263+ return (Target
264+ { _target_path = Nothing
265+ , _target_attr = Nothing
266+ , _target_expr = Just expr
267+ }, [])
268+ result <- nixCmd $ NixCmd_Build $ def
269+ & nixBuildConfig_outLink .~ OutLink_None
270+ & nixCmdConfig_target .~ nixBuildTarget
271+ let mobileArtifact = case platform of
272+ IOS -> "iOS App"
273+ Android -> "Android APK"
274+ putLog Notice $ T.pack $ unwords ["Your recently built", mobileArtifact, "can be found at the following path:", show result]
165− callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") mobileArgs
275+ callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") (mobileArgs ++ extraArgs)
276+ where
277+ withEcho showEcho f = bracket
278+ (do
279+ prevEcho <- hGetEcho stdin
280+ hSetEcho stdin showEcho
281+ pure prevEcho
282+ )
283+ (hSetEcho stdin)
284+ (const f)
285+
286+data KeytoolConfig = KeytoolConfig
287+ { _keytoolConfig_keystore :: FilePath
288+ , _keytoolConfig_alias :: String
289+ , _keytoolConfig_storepass :: String
290+ , _keytoolConfig_keypass :: String
291+ } deriving (Show, Generic)
292+
293+instance FromJSON KeytoolConfig
294+instance ToJSON KeytoolConfig
295+
296+createKeystore :: MonadObelisk m => FilePath -> KeytoolConfig -> m ()
297+createKeystore root config =
298+ callProcessAndLogOutput (Notice, Notice) $ setCwd (Just root) $ proc jreKeyToolPath
299+ [ "-genkeypair", "-noprompt"
300+ , "-keystore", _keytoolConfig_keystore config
301+ , "-keyalg", "RSA", "-keysize", "2048"
302+ , "-validity", "1000000"
303+ , "-storepass", _keytoolConfig_storepass config
304+ , "-alias", _keytoolConfig_alias config
305+ , "-keypass", _keytoolConfig_keypass config
306+ ]
166
307
167-- | Simplified deployment configuration mechanism. At one point we may revisit this.
308-- | Simplified deployment configuration mechanism. At one point we may revisit this.
168writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
309writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
@@ -174,9 +315,10 @@ readDeployConfig deployDir fname = liftIO $ do
174
315
175verifyHostKey :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
316verifyHostKey :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
176verifyHostKey knownHostsPath keyPath hostName =
317verifyHostKey knownHostsPath keyPath hostName =
177− callProcessAndLogOutput (Notice, Warning) $ proc "ssh" $
318+ callProcessAndLogOutput (Notice, Warning) $ proc sshPath $
178 sshArgs knownHostsPath keyPath True <>
319 sshArgs knownHostsPath keyPath True <>
179 [ "root@" <> hostName
320 [ "root@" <> hostName
321+ , "-o", "NumberOfPasswordPrompts=0"
180 , "exit"
322 , "exit"
181 ]
323 ]
182
324
lib/command/src/Obelisk/Command/Nix.hs+160−71
@@ -6,54 +6,65 @@
6{-# LANGUAGE OverloadedStrings #-}
6{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE Rank2Types #-}
7{-# LANGUAGE Rank2Types #-}
8{-# LANGUAGE ScopedTypeVariables #-}
8{-# LANGUAGE ScopedTypeVariables #-}
9+{-# LANGUAGE TemplateHaskell #-}
9{-# LANGUAGE TypeApplications #-}
10{-# LANGUAGE TypeApplications #-}
10module Obelisk.Command.Nix
11module Obelisk.Command.Nix
11− ( nixBuild
12+ ( Arg (..)
12− , withNixRemoteCheck
13 , NixBuildConfig (..)
13 , NixBuildConfig (..)
14− , Target (..)
14+ , nixBuildConfig_common
15+ , nixBuildConfig_outLink
16+ , NixCmd (..)
17+ , nixCmdConfig_args
18+ , nixCmdConfig_builders
19+ , nixCmdConfig_target
20+ , NixCommonConfig (..)
21+ , NixInstantiateConfig (..)
22+ , nixInstantiateConfig_eval
23+ , NixShellConfig (..)
24+ , nixShellConfig_common
25+ , nixShellConfig_pure
26+ , nixShellConfig_run
15 , OutLink (..)
27 , OutLink (..)
16− , Arg (..)
28+ , Target (..)
29+ , target_attr
30+ , target_expr
31+ , target_path
32+
17 , boolArg
33 , boolArg
34+ , nixCmd
35+ , nixCmdProc
36+ , nixCmdProc'
18 , rawArg
37 , rawArg
38+ , runNixShellConfig
19 , strArg
39 , strArg
20 ) where
40 ) where
21
41
22−--import Control.Monad.Catch (catch, throwM)
42+import Control.Monad (guard)
23import Control.Lens
43import Control.Lens
24−import Control.Monad.Except (ExceptT, runExceptT, throwError)
44+
25−import Control.Monad.IO.Class (liftIO)
26import Data.Bool (bool)
45import Data.Bool (bool)
27import Data.Default
46import Data.Default
28import Data.List (intercalate)
47import Data.List (intercalate)
48+import Data.Maybe
29import Data.Monoid ((<>))
49import Data.Monoid ((<>))
30import qualified Data.Text as T
50import qualified Data.Text as T
31−import System.Directory
32−import System.Environment
33−import System.Process (proc)
34
51
35−import Obelisk.App (MonadInfallibleObelisk, MonadObelisk, ObeliskError (..))
52+import Obelisk.App (MonadObelisk)
36import Obelisk.CliApp
53import Obelisk.CliApp
37
54
38−-- | Where to put nix-build output
39−data OutLink
40− = OutLink_Default
41− | OutLink_None
42− | OutLink_IndirectRoot FilePath
43−
44−instance Default OutLink where
45− def = OutLink_Default
46−
47-- | What to build
55-- | What to build
48data Target = Target
56data Target = Target
49− { _target_path :: FilePath
57+ { _target_path :: Maybe FilePath
50 , _target_attr :: Maybe String
58 , _target_attr :: Maybe String
59+ , _target_expr :: Maybe String
51 }
60 }
61+makeClassy ''Target
52
62
53instance Default Target where
63instance Default Target where
54 def = Target
64 def = Target
55− { _target_path = "."
65+ { _target_path = Just "."
56 , _target_attr = Nothing
66 , _target_attr = Nothing
67+ , _target_expr = Nothing
57 }
68 }
58
69
59data Arg
70data Arg
@@ -62,10 +73,10 @@ data Arg
62 deriving (Eq, Show)
73 deriving (Eq, Show)
63
74
64strArg :: String -> String -> Arg
75strArg :: String -> String -> Arg
65−strArg k = Arg_Str k
76+strArg = Arg_Str
66
77
67rawArg :: String -> String -> Arg
78rawArg :: String -> String -> Arg
68−rawArg k = Arg_Expr k
79+rawArg = Arg_Expr
69
80
70boolArg :: String -> Bool -> Arg
81boolArg :: String -> Bool -> Arg
71boolArg k = Arg_Expr k . bool "false" "true"
82boolArg k = Arg_Expr k . bool "false" "true"
@@ -75,61 +86,139 @@ cliFromArgs = concatMap $ \case
75 Arg_Str k v -> ["--argstr", k, v]
86 Arg_Str k v -> ["--argstr", k, v]
76 Arg_Expr k v -> ["--arg", k, v]
87 Arg_Expr k v -> ["--arg", k, v]
77
88
78−data NixBuildConfig = NixBuildConfig
89+data NixCommonConfig = NixCommonConfig
79− { _nixBuildConfig_target :: Target
90+ { _nixCmdConfig_target :: Target
80− , _nixBuildConfig_outLink :: OutLink
91+ , _nixCmdConfig_args :: [Arg]
81− , _nixBuildConfig_args :: [Arg]
92+ , _nixCmdConfig_builders :: [String]
82− , _nixBuildConfig_builders :: [String]
83 }
93 }
94+makeClassy ''NixCommonConfig
84
95
85−instance Default NixBuildConfig where
96+instance Default NixCommonConfig where
86− def = NixBuildConfig def def mempty mempty
97+ def = NixCommonConfig def mempty mempty
87
98
88−nixBuild :: MonadObelisk m => NixBuildConfig -> m FilePath
99+runNixCommonConfig :: NixCommonConfig -> [String]
89−nixBuild cfg = withSpinner' ("Running nix-build on " <> desc) (Just $ const $ "Built " <> desc) $ do
90− withNixRemoteCheck $ fmap T.unpack $ readProcessAndLogStderr Debug $ proc "nix-build" $ mconcat
91− [[path], attrArg, args, outLink, buildersArg]
100+runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
92 where
101 where
93− path = _target_path $ _nixBuildConfig_target cfg
102+ path = _target_path $ _nixCmdConfig_target cfg
94− attr = _target_attr $ _nixBuildConfig_target cfg
103+ attr = _target_attr $ _nixCmdConfig_target cfg
104+ expr = _target_expr $ _nixCmdConfig_target cfg
95 attrArg = case attr of
105 attrArg = case attr of
96 Nothing -> []
106 Nothing -> []
97 Just a -> ["-A", a]
107 Just a -> ["-A", a]
108+ exprArg = case expr of
109+ Nothing -> []
110+ Just a -> ["-E", a]
98− args = cliFromArgs $ _nixBuildConfig_args cfg
111+ args = cliFromArgs $ _nixCmdConfig_args cfg
112+ buildersArg = case _nixCmdConfig_builders cfg of
113+ [] -> []
114+ builders -> ["--builders", intercalate ";" builders]
115+
116+-- | Where to put nix-build output
117+data OutLink
118+ = OutLink_Default
119+ | OutLink_None
120+ | OutLink_IndirectRoot FilePath
121+
122+instance Default OutLink where
123+ def = OutLink_Default
124+
125+data NixBuildConfig = NixBuildConfig
126+ { _nixBuildConfig_common :: NixCommonConfig
127+ , _nixBuildConfig_outLink :: OutLink
128+ }
129+makeLenses ''NixBuildConfig
130+
131+instance HasNixCommonConfig NixBuildConfig where
132+ nixCommonConfig = nixBuildConfig_common
133+
134+instance Default NixBuildConfig where
135+ def = NixBuildConfig def def
136+
137+runNixBuildConfig :: NixBuildConfig -> [String]
138+runNixBuildConfig cfg = mconcat
139+ [ runNixCommonConfig $ cfg ^. nixCommonConfig
99− outLink = case _nixBuildConfig_outLink cfg of
140+ , case _nixBuildConfig_outLink cfg of
100 OutLink_Default -> []
141 OutLink_Default -> []
101 OutLink_None -> ["--no-out-link"]
142 OutLink_None -> ["--no-out-link"]
102 OutLink_IndirectRoot l -> ["--out-link", l]
143 OutLink_IndirectRoot l -> ["--out-link", l]
103− desc = T.pack $ path <> maybe "" (\a -> " [" <> a <> "]") attr
144+ ]
104− buildersArg = case _nixBuildConfig_builders cfg of
145+
105− [] -> []
146+data NixInstantiateConfig = NixInstantiateConfig
106− builders -> ["--builders", intercalate ";" builders]
147+ { _nixInstantiateConfig_common :: NixCommonConfig
148+ , _nixInstantiateConfig_eval :: Bool
149+ }
150+makeLenses ''NixInstantiateConfig
151+
152+instance HasNixCommonConfig NixInstantiateConfig where
153+ nixCommonConfig = nixInstantiateConfig_common
154+
155+instance Default NixInstantiateConfig where
156+ def = NixInstantiateConfig def False
157+
158+runNixInstantiateConfig :: NixInstantiateConfig -> [String]
159+runNixInstantiateConfig cfg = mconcat
160+ [ runNixCommonConfig $ cfg ^. nixCommonConfig
161+ , "--eval" <$ guard (_nixInstantiateConfig_eval cfg)
162+ ]
107
163
108−-- | If a nix command fails, and this may be related to the NIX_REMOTE issue,
164+data NixShellConfig = NixShellConfig
109−-- tell the user what to do.
165+ { _nixShellConfig_common :: NixCommonConfig
110−--
166+ , _nixShellConfig_pure :: Bool
111−-- Added: June, 2018. Consider removing this eventually.
167+ , _nixShellConfig_run :: Maybe String
112−withNixRemoteCheck
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+
178+data NixCmd
179+ = NixCmd_Build NixBuildConfig
180+ | NixCmd_Instantiate NixInstantiateConfig
181+
182+instance Default NixCmd where
183+ def = NixCmd_Build def
184+
185+runNixShellConfig :: NixShellConfig -> [String]
186+runNixShellConfig cfg = mconcat
187+ [ runNixCommonConfig $ cfg ^. nixCommonConfig
188+ , [ "--pure" | cfg ^. nixShellConfig_pure ]
189+ ] ++ mconcat [
190+ ["--run", run] | run <- maybeToList $ cfg ^. nixShellConfig_run
191+ ]
192+
193+nixCmdProc :: NixCmd -> ProcessSpec
194+nixCmdProc = fst . nixCmdProc'
195+
196+nixCmdProc' :: NixCmd -> (ProcessSpec, T.Text)
197+nixCmdProc' cmdCfg = (proc (T.unpack cmd) options, cmd)
198+ where
199+ (cmd, options) = case cmdCfg of
200+ NixCmd_Build cfg' ->
201+ ( "nix-build"
202+ , runNixBuildConfig cfg'
203+ )
204+ NixCmd_Instantiate cfg' ->
205+ ( "nix-instantiate"
206+ , runNixInstantiateConfig cfg'
207+ )
208+
113− :: MonadObelisk m
209+nixCmd :: MonadObelisk m => NixCmd -> m FilePath
114− => (forall m'. MonadInfallibleObelisk m' => ExceptT ObeliskError m' a)
210+nixCmd cmdCfg = withSpinner' (T.unwords $ "Running" : cmd : desc) (Just $ const $ T.unwords $ "Built" : desc) $ do
115− -> m a
211+ output <- readProcessAndLogStderr Debug cmdProc
116−withNixRemoteCheck f = do
212+ -- Remove final newline that Nix appends
117− status <- runExceptT f
118− case status of
119− Right a -> pure a
120− Left e -> throwError =<< case matching asProcessFailure e of
121− Left _ -> pure e
122− Right pf -> liftIO (lookupEnv "NIX_REMOTE") >>= \case
123− Just _ -> pure e
213+ Just (outPath, '\n') <- pure $ T.unsnoc output
124− Nothing -> liftIO (writable <$> getPermissions "/nix/var/nix/db") >>= \case
214+ pure $ T.unpack outPath
125− True -> pure e
215+ where
126− False -> pure $ ObeliskError_ProcessError pf $ Just $ T.unlines
216+ (cmdProc, cmd) = nixCmdProc' cmdCfg
127− [ "!!! "
217+ commonCfg = case cmdCfg of
128− , "!!! A nix command failed to run. You might need to set the NIX_REMOTE environment variable"
218+ NixCmd_Build cfg' -> cfg' ^. nixCommonConfig
129− , "!!! to `daemon`. To do this, run the following before running obelisk:"
219+ NixCmd_Instantiate cfg' -> cfg' ^. nixCommonConfig
130− , "!!! "
220+ path = commonCfg ^. nixCmdConfig_target . target_path
131− , "!!! export NIX_REMOTE=daemon"
221+ desc = concat $ catMaybes
132− , "!!! "
222+ [ (\x -> ["on", T.pack x]) <$> path
133− , "!!! For details, see https://github.com/NixOS/nixpkgs/issues/5713"
223+ , (\a -> ["[" <> T.pack a <> "]"]) <$> (commonCfg ^. nixCmdConfig_target . target_attr)
134− , "!!! "
135− ]
224+ ]
lib/command/src/Obelisk/Command/Preprocessor.hsnew file+100
@@ -0,0 +1,100 @@
1+{-# LANGUAGE LambdaCase #-}
2+{-# LANGUAGE OverloadedStrings #-}
3+
4+module Obelisk.Command.Preprocessor where
5+
6+import qualified Data.ByteString.Lazy as BL
7+import qualified Data.ByteString.Lazy.Builder as BU
8+import Data.Foldable (for_)
9+import Data.List (intersperse, isPrefixOf, sortOn)
10+import Data.Maybe (fromMaybe)
11+import qualified Data.Text.Lazy.Builder as TL
12+import qualified Data.Text.Lazy.Encoding as TL
13+import Distribution.Compiler (CompilerFlavor (..))
14+import Language.Haskell.Extension (Extension (..), Language(..))
15+import System.Directory (canonicalizePath)
16+import System.IO (IOMode (..), hPutStrLn, stderr, withFile)
17+import System.FilePath (hasTrailingPathSeparator, joinPath, splitPath)
18+
19+import Obelisk.Command.Run (CabalPackageInfo (..), parseCabalPackage')
20+
21+-- | This code is intended to be executed via ghci's -pgmF preprocessor option.
22+-- The command line arguments are passed in via ghc, which dictates the first three options and meanings
23+-- In order for this code to execute, origPath must contain either a '.' character or a '/' character.
24+-- (This is to avoid the possibility of the command line syntax conflicting with another ob command)
25+-- We do have control over the remaining arguments, but they must be the same for all files.
26+-- Thus, the fourth command line argument must be "apply-packages", which has already been handled.
27+-- We assume all the remaining arguments passed in are paths to cabal or hpack package specifications.
28+-- Thus we must select among the packagePaths for the file we are going to parse.
29+applyPackages :: FilePath -> FilePath -> FilePath -> [FilePath] -> IO ()
30+applyPackages origPath inPath outPath packagePaths' = do
31+ origPathCanonical <- canonicalizePath origPath
32+ packagePaths <- traverse canonicalizePath packagePaths'
33+
34+ let
35+ takeDirs = takeWhile hasTrailingPathSeparator
36+ packageDirs = sortOn (negate . length . takeDirs) $ map splitPath packagePaths
37+ origDir = splitPath origPathCanonical
38+ matches = [ joinPath d | d <- packageDirs, takeDirs d `isPrefixOf` origDir ]
39+
40+ -- The first element of matches is going to be the deepest path to a package spec that contains
41+ -- our file as a subdirectory.
42+ packageInfo' <- case matches of
43+ [] -> do
44+ hPutStrLn stderr $ "Error: Unable to find cabal information for " <> origPath <> "; Skipping preprocessor."
45+ pure Nothing
46+ packagePath:_ -> parseCabalPackage' packagePath >>= \case
47+ Left err -> do
48+ hPutStrLn stderr $ "Error: Unable to parse cabal package " <> packagePath <> "; Skipping preprocessor on " <> origPath <> ". Error: " <> show err
49+ pure Nothing
50+ Right (Just (_, packageInfo)) -> pure $ Just packageInfo
51+ Right Nothing -> pure Nothing
52+
53+ writeOutput packageInfo' inPath outPath
54+
55+writeOutput :: Maybe CabalPackageInfo -> FilePath -> FilePath -> IO ()
56+writeOutput packageInfo' origPath outPath = withFile outPath WriteMode $ \hOut -> do
57+ for_ packageInfo' $ \packageInfo -> hPutTextBuilder hOut (generateHeader origPath packageInfo)
58+ BL.readFile origPath >>= BL.hPut hOut
59+ where
60+ hPutTextBuilder h = BU.hPutBuilder h . TL.encodeUtf8Builder . TL.toLazyText
61+
62+generateHeader :: FilePath -> CabalPackageInfo -> TL.Builder
63+generateHeader origPath packageInfo =
64+ hsExtensions <> ghcOptions <> lineNumberPragma origPath
65+ where
66+ hsExtensions =
67+ if null extList
68+ then mempty
69+ else pragma $ TL.fromText "LANGUAGE " <> mconcat (intersperse (TL.fromText ", ") extList)
70+ extList = addDefaultLanguage $ concatMap showExt $ _cabalPackageInfo_defaultExtensions packageInfo
71+ addDefaultLanguage =
72+ case _cabalPackageInfo_defaultLanguage packageInfo of
73+ Nothing -> id
74+ Just x -> case x of
75+ UnknownLanguage ext -> (TL.fromString ext :)
76+ ext -> (TL.fromString (show ext) :)
77+ showExt = \case
78+ EnableExtension ext -> [TL.fromString (show ext)]
79+ DisableExtension ext -> ["No" <> TL.fromString (show ext)]
80+ UnknownExtension ext -> [TL.fromString ext]
81+
82+ ghcOptions =
83+ if null optList
84+ then mempty
85+ else pragma $
86+ TL.fromText "OPTIONS_GHC " <> mconcat (intersperse (TL.fromText " ") (map TL.fromString optList))
87+ ghcOptList
88+ = filter (not . isPrefixOf "-O")
89+ $ fromMaybe []
90+ $ lookup GHC (_cabalPackageInfo_compilerOptions packageInfo)
91+ optList = _cabalPackageInfo_cppOptions packageInfo <> ghcOptList
92+
93+lineNumberPragma :: FilePath -> TL.Builder
94+lineNumberPragma origPath = pragma $ TL.fromText "LINE 1 " <> quoted '"' (TL.fromString origPath)
95+
96+pragma :: TL.Builder -> TL.Builder
97+pragma x = TL.fromText "{-# " <> x <> TL.fromText " #-}\n"
98+
99+quoted :: Char -> TL.Builder -> TL.Builder
100+quoted char x = TL.singleton char <> x <> TL.singleton char
lib/command/src/Obelisk/Command/Project.hs+203−65
@@ -3,38 +3,56 @@
3{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE OverloadedStrings #-}
4module Obelisk.Command.Project
4module Obelisk.Command.Project
5 ( InitSource (..)
5 ( InitSource (..)
6− , initProject
7 , findProjectObeliskCommand
6 , findProjectObeliskCommand
8 , findProjectRoot
7 , findProjectRoot
9− , withProjectRoot
8+ , findProjectAssets
10− , inProjectShell
9+ , initProject
11− , inImpureProjectShell
10+ , nixShellRunConfig
12− , projectShell
11+ , nixShellRunProc
13−
12+ , nixShellWithHoogle
14− , toObeliskDir
13+ , nixShellWithoutPkgs
14+ , obeliskDirName
15 , toImplDir
15 , toImplDir
16+ , toObeliskDir
17+ , withProjectRoot
18+ , bashEscape
16 ) where
19 ) where
17
20
21+import Control.Concurrent.MVar (MVar, newMVar, withMVarMasked)
22+import Control.Lens ((.~), (?~), (<&>))
18import Control.Monad
23import Control.Monad
19import Control.Monad.IO.Class (liftIO)
24import Control.Monad.IO.Class (liftIO)
20import Control.Monad.State
25import Control.Monad.State
26+import qualified Data.Aeson as Json
27+import qualified Data.ByteString.UTF8 as BSU
21import Data.Bits
28import Data.Bits
29+import qualified Data.ByteString.Lazy as BSL
30+import Data.Default (def)
22−import Data.Function (on)
31+import Data.Function ((&), on)
32+import Data.Map (Map)
33+import Data.Text (Text)
23import qualified Data.Text as T
34import qualified Data.Text as T
35+import Data.Text.Encoding (decodeUtf8, encodeUtf8)
36+import Data.Traversable (for)
24import System.Directory
37import System.Directory
38+import System.Environment (lookupEnv)
25import System.FilePath
39import System.FilePath
26import System.IO.Temp
40import System.IO.Temp
27−import System.Posix (FileStatus, UserID, deviceID, fileID, fileMode, fileOwner, getFileStatus, getRealUserID)
41+import System.IO.Unsafe (unsafePerformIO)
28−import System.Posix.Files
42+import System.PosixCompat.Files
29−import System.Process (CreateProcess, cwd, proc, waitForProcess)
43+import System.PosixCompat.Types
44+import System.PosixCompat.User
45+import Text.ShellEscape (bash, bytes)
30
46
31import GitHub.Data.GitData (Branch)
47import GitHub.Data.GitData (Branch)
32import GitHub.Data.Name (Name)
48import GitHub.Data.Name (Name)
33
49
34import Obelisk.App (MonadObelisk)
50import Obelisk.App (MonadObelisk)
35import Obelisk.CliApp
51import Obelisk.CliApp
52+import Obelisk.Command.Nix
36import Obelisk.Command.Thunk
53import Obelisk.Command.Thunk
37−import Obelisk.Command.Nix (withNixRemoteCheck)
54+import Obelisk.Command.Utils (nixBuildExePath, nixExePath, toNixPath, cp, nixShellPath)
55+
38--TODO: Make this module resilient to random exceptions
56--TODO: Make this module resilient to random exceptions
39
57
40--TODO: Don't hardcode this
58--TODO: Don't hardcode this
@@ -48,17 +66,21 @@ obeliskSourceWithBranch branch = ThunkSource_GitHub $ GitHubSource
48 { _gitHubSource_owner = "obsidiansystems"
66 { _gitHubSource_owner = "obsidiansystems"
49 , _gitHubSource_repo = "obelisk"
67 , _gitHubSource_repo = "obelisk"
50 , _gitHubSource_branch = Just branch
68 , _gitHubSource_branch = Just branch
69+ , _gitHubSource_private = False
51 }
70 }
52
71
53data InitSource
72data InitSource
54− = InitSource_Default
73+ = InitSource_Default
55− | InitSource_Branch (Name Branch)
74+ | InitSource_Branch (Name Branch)
56− | InitSource_Symlink FilePath
75+ | InitSource_Symlink FilePath
57− deriving Show
76+ deriving Show
77+
78+obeliskDirName :: FilePath
79+obeliskDirName = ".obelisk"
58
80
59-- | Path to obelisk directory in given path
81-- | Path to obelisk directory in given path
60toObeliskDir :: FilePath -> FilePath
82toObeliskDir :: FilePath -> FilePath
61−toObeliskDir p = p </> ".obelisk"
83+toObeliskDir p = p </> obeliskDirName
62
84
63-- | Path to impl file in given path
85-- | Path to impl file in given path
64toImplDir :: FilePath -> FilePath
86toImplDir :: FilePath -> FilePath
@@ -75,20 +97,26 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
75 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
97 | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
76 skeleton <- withSpinner "Setting up obelisk" $ do
98 skeleton <- withSpinner "Setting up obelisk" $ do
77 liftIO $ createDirectory obDir
99 liftIO $ createDirectory obDir
100+ -- Clone the git source and repack it with the init source obelisk
101+ -- The purpose of this is to ensure we use the correct thunk spec.
102+ let cloneAndRepack src = do
103+ putLog Debug $ "Cloning obelisk into " <> T.pack implDir <> " and repacking using itself"
104+ commit <- getLatestRev src
105+ gitCloneForThunkUnpack (thunkSourceToGitSource src) (_thunkRev_commit commit) implDir
106+ callHandoffOb implDir ["thunk", "pack", implDir]
78 case source of
107 case source of
79− InitSource_Default -> createThunkWithLatest implDir obeliskSource
108+ InitSource_Default -> cloneAndRepack obeliskSource
80− InitSource_Branch branch -> createThunkWithLatest implDir $ obeliskSourceWithBranch branch
109+ InitSource_Branch branch -> cloneAndRepack $ obeliskSourceWithBranch branch
81 InitSource_Symlink path -> do
110 InitSource_Symlink path -> do
82 let symlinkPath = if isAbsolute path
111 let symlinkPath = if isAbsolute path
83 then path
112 then path
84 else ".." </> path
113 else ".." </> path
85 liftIO $ createSymbolicLink symlinkPath implDir
114 liftIO $ createSymbolicLink symlinkPath implDir
86 _ <- nixBuildAttrWithCache implDir "command"
115 _ <- nixBuildAttrWithCache implDir "command"
87− --TODO: We should probably handoff to the impl here
88 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
116 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
89
117
90 callProcessAndLogOutput (Notice, Error) $
118 callProcessAndLogOutput (Notice, Error) $
91− proc "cp"
119+ proc cp
92 [ "-r"
120 [ "-r"
93 , "--preserve=links"
121 , "--preserve=links"
94 , obDir
122 , obDir
@@ -98,7 +126,7 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
98
126
99 withSpinner "Copying project skeleton" $ do
127 withSpinner "Copying project skeleton" $ do
100 callProcessAndLogOutput (Notice, Error) $
128 callProcessAndLogOutput (Notice, Error) $
101− proc "cp"
129+ proc cp
102 [ "-r"
130 [ "-r"
103 , "--no-preserve=mode"
131 , "--no-preserve=mode"
104 , "-T"
132 , "-T"
@@ -109,21 +137,46 @@ initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
109 let configDir = "config"
137 let configDir = "config"
110 createDirectoryIfMissing False configDir
138 createDirectoryIfMissing False configDir
111 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
139 mapM_ (createDirectoryIfMissing False . (configDir </>)) ["backend", "common", "frontend"]
140+ putLog Notice $ T.intercalate "\n"
141+ [ "An obelisk project has been successfully initialized. Next steps:"
142+ , " 'ob run': Start a development server"
143+ , " 'ob watch': Watch for changes without starting a server"
144+ , " 'ob repl': Load your project into GHCi"
145+ ]
146+
147+callHandoffOb
148+ :: MonadObelisk m
149+ => FilePath -- ^ Directory of the obelisk we want to handoff to
150+ -> [String] -- ^ Arguments to pass to ob
151+ -> m ()
152+callHandoffOb dir args = do
153+ obeliskCommandPkg <- nixCmd $ NixCmd_Build $ def
154+ & nixBuildConfig_outLink .~ OutLink_None
155+ & nixCmdConfig_target .~ Target
156+ { _target_path = Just dir
157+ , _target_attr = Just "command"
158+ , _target_expr = Nothing
159+ }
160+ let impl = obeliskCommandPkg </> "bin" </> "ob"
161+ -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
162+ putLog Debug $ "Running '" <> T.pack (unwords args) <> "' with " <> T.pack impl
163+ callProcessAndLogOutput (Debug, Warning) (proc impl ("--no-handoff" : args))
112
164
113--TODO: Allow the user to ignore our security concerns
165--TODO: Allow the user to ignore our security concerns
114-- | Find the Obelisk implementation for the project at the given path
166-- | Find the Obelisk implementation for the project at the given path
115findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
167findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
116findProjectObeliskCommand target = do
168findProjectObeliskCommand target = do
117 myUid <- liftIO getRealUserID
169 myUid <- liftIO getRealUserID
170+ processUmask <- liftIO getUmask
118 targetStat <- liftIO $ getFileStatus target
171 targetStat <- liftIO $ getFileStatus target
119− (result, insecurePaths) <- flip runStateT [] $ walkToProjectRoot target targetStat myUid >>= \case
172+ (result, insecurePaths) <- flip runStateT [] $ walkToProjectRoot target targetStat processUmask myUid >>= \case
120 Nothing -> pure Nothing
173 Nothing -> pure Nothing
121 Just projectRoot -> liftIO (doesDirectoryExist $ toImplDir projectRoot) >>= \case
174 Just projectRoot -> liftIO (doesDirectoryExist $ toImplDir projectRoot) >>= \case
122 False -> do
175 False -> do
123 putLog Warning $ "Found obelisk directory in " <> T.pack projectRoot <> " but the implementation (impl) file is missing"
176 putLog Warning $ "Found obelisk directory in " <> T.pack projectRoot <> " but the implementation (impl) file is missing"
124 pure Nothing
177 pure Nothing
125 True -> do
178 True -> do
126− walkToImplDir projectRoot myUid -- For security check
179+ walkToImplDir projectRoot myUid processUmask -- For security check
127 return $ Just projectRoot
180 return $ Just projectRoot
128 case (result, insecurePaths) of
181 case (result, insecurePaths) of
129 (Just projDir, []) -> do
182 (Just projDir, []) -> do
@@ -134,19 +187,39 @@ findProjectObeliskCommand target = do
134 putLog Error $ T.unlines
187 putLog Error $ T.unlines
135 [ "Error: Found a project at " <> T.pack (normalise projDir) <> ", but had to traverse one or more insecure directories to get there:"
188 [ "Error: Found a project at " <> T.pack (normalise projDir) <> ", but had to traverse one or more insecure directories to get there:"
136 , T.unlines $ fmap (T.pack . normalise) insecurePaths
189 , T.unlines $ fmap (T.pack . normalise) insecurePaths
137− , "Please ensure that all of these directories are owned by you and are not writable by anyone else."
190+ , "Please ensure that all of these directories are owned by you, not world-writable, and no more group-writable than permitted by your umask."
138 ]
191 ]
139 return Nothing
192 return Nothing
140
193
194+-- | Get the umask for the Obelisk process.
195+--
196+-- Because of
197+-- http://man7.org/linux/man-pages/man2/umask.2.html#NOTES we have to set the
198+-- umask to read it. We are using 'withMVarMasked' to guarantee that setting and
199+-- reading isn't interrupted by any exception or interleaved with another thread.
200+getUmask :: IO FileMode
201+getUmask = withMVarMasked globalUmaskLock $ \() -> do
202+ initialMask <- setFileCreationMask safeUmask
203+ void (setFileCreationMask initialMask)
204+ pure initialMask
205+ where
206+ safeUmask :: FileMode
207+ safeUmask = CMode 0o22
208+
209+{-# NOINLINE globalUmaskLock #-}
210+globalUmaskLock :: MVar ()
211+globalUmaskLock = unsafePerformIO (newMVar ())
212+
141-- | Get the FilePath to the containing project directory, if there is one
213-- | Get the FilePath to the containing project directory, if there is one
142findProjectRoot :: MonadObelisk m => FilePath -> m (Maybe FilePath)
214findProjectRoot :: MonadObelisk m => FilePath -> m (Maybe FilePath)
143findProjectRoot target = do
215findProjectRoot target = do
144 myUid <- liftIO getRealUserID
216 myUid <- liftIO getRealUserID
145 targetStat <- liftIO $ getFileStatus target
217 targetStat <- liftIO $ getFileStatus target
218+ umask <- liftIO getUmask
146− (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat myUid) []
219+ (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat umask myUid) []
147− return result
220+ return $ makeRelative "." <$> result
148
221
149−withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m ()) -> m ()
222+withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
150withProjectRoot target f = findProjectRoot target >>= \case
223withProjectRoot target f = findProjectRoot target >>= \case
151 Nothing -> failWith "Must be used inside of an Obelisk project"
224 Nothing -> failWith "Must be used inside of an Obelisk project"
152 Just root -> f root
225 Just root -> f root
@@ -156,15 +229,15 @@ withProjectRoot target f = findProjectRoot target >>= \case
156-- traversed in the process. Return the project root directory, if found.
229-- traversed in the process. Return the project root directory, if found.
157walkToProjectRoot
230walkToProjectRoot
158 :: (MonadState [FilePath] m, MonadIO m)
231 :: (MonadState [FilePath] m, MonadIO m)
159− => FilePath -> FileStatus -> UserID -> m (Maybe FilePath)
232+ => FilePath -> FileStatus -> FileMode -> UserID -> m (Maybe FilePath)
160−walkToProjectRoot this thisStat myUid = liftIO (doesDirectoryExist this) >>= \case
233+walkToProjectRoot this thisStat desiredUmask myUid = liftIO (doesDirectoryExist this) >>= \case
161 -- It's not a directory, so it can't be a project
234 -- It's not a directory, so it can't be a project
162 False -> do
235 False -> do
163 let dir = takeDirectory this
236 let dir = takeDirectory this
164 dirStat <- liftIO $ getFileStatus dir
237 dirStat <- liftIO $ getFileStatus dir
165− walkToProjectRoot dir dirStat myUid
238+ walkToProjectRoot dir dirStat desiredUmask myUid
166 True -> do
239 True -> do
167− when (not $ isWritableOnlyBy thisStat myUid) $ modify (this:)
240+ when (not $ isWellOwnedAndWellPermissioned thisStat myUid desiredUmask) $ modify (this:)
168 liftIO (doesDirectoryExist $ toObeliskDir this) >>= \case
241 liftIO (doesDirectoryExist $ toObeliskDir this) >>= \case
169 True -> return $ Just this
242 True -> return $ Just this
170 False -> do
243 False -> do
@@ -174,44 +247,109 @@ walkToProjectRoot this thisStat myUid = liftIO (doesDirectoryExist this) >>= \ca
174 isSameFileAs = (==) `on` fileIdentity
247 isSameFileAs = (==) `on` fileIdentity
175 if thisStat `isSameFileAs` nextStat
248 if thisStat `isSameFileAs` nextStat
176 then return Nothing -- Found a cycle; probably hit root directory
249 then return Nothing -- Found a cycle; probably hit root directory
177− else walkToProjectRoot next nextStat myUid
250+ else walkToProjectRoot next nextStat desiredUmask myUid
178
251
179-- | Walk from the given project root directory to its Obelisk implementation
252-- | Walk from the given project root directory to its Obelisk implementation
180-- directory, accumulating potentially insecure directories that were traversed
253-- directory, accumulating potentially insecure directories that were traversed
181-- in the process.
254-- in the process.
182−walkToImplDir :: (MonadState [FilePath] m, MonadIO m) => FilePath -> UserID -> m ()
255+walkToImplDir :: (MonadState [FilePath] m, MonadIO m) => FilePath -> UserID -> FileMode -> m ()
183−walkToImplDir projectRoot myUid = do
256+walkToImplDir projectRoot myUid umask = do
184 let obDir = toObeliskDir projectRoot
257 let obDir = toObeliskDir projectRoot
185 obDirStat <- liftIO $ getFileStatus obDir
258 obDirStat <- liftIO $ getFileStatus obDir
186− when (not $ isWritableOnlyBy obDirStat myUid) $ modify (obDir:)
259+ when (not $ isWellOwnedAndWellPermissioned obDirStat myUid umask) $ modify (obDir:)
187 let implThunk = obDir </> "impl"
260 let implThunk = obDir </> "impl"
188 implThunkStat <- liftIO $ getFileStatus implThunk
261 implThunkStat <- liftIO $ getFileStatus implThunk
189− when (not $ isWritableOnlyBy implThunkStat myUid) $ modify (implThunk:)
262+ when (not $ isWellOwnedAndWellPermissioned implThunkStat myUid umask) $ modify (implThunk:)
190−
263+
191−--TODO: Is there a better way to ask if anyone else can write things?
192−--E.g. what about ACLs?
193−-- | Check to see if directory is only writable by a user whose User ID matches the second argument provided
264+-- | Check to see if directory is writable by a user whose User ID matches the
265+-- second argument provided, and if the fact that other people can write to that
266+-- directory is in accordance with the umask of the system, passed as the third
267+-- argument.
194−isWritableOnlyBy :: FileStatus -> UserID -> Bool
268+isWellOwnedAndWellPermissioned :: FileStatus -> UserID -> FileMode -> Bool
269+isWellOwnedAndWellPermissioned s uid umask = isOwnedBy s uid && filePermissionIsSafe s umask
270+
271+isOwnedBy :: FileStatus -> UserID -> Bool
195−isWritableOnlyBy s uid = fileOwner s == uid && fileMode s .&. 0o22 == 0
272+isOwnedBy s uid = fileOwner s == uid
196−
273+
197−-- | Run a command in the given shell for the current project
274+-- | Check to see if a directory respect the umask, but check explicitly that
198−inProjectShell :: MonadObelisk m => String -> String -> m ()
275+-- it's not world writable in any case.
199−inProjectShell shellName command = withProjectRoot "." $ \root ->
276+filePermissionIsSafe :: FileStatus -> FileMode -> Bool
200− projectShell root True shellName command
277+filePermissionIsSafe s umask = not fileWorldWritable && fileGroupWritable <= umaskGroupWritable
201−
278+ where
279+ fileWorldWritable = fileMode s .&. 0o002 == 0o002
280+ fileGroupWritable = fileMode s .&. 0o020 == 0o020
281+ umaskGroupWritable = umask .&. 0o020 == 0
282+
283+nixShellRunConfig :: MonadObelisk m => FilePath -> Bool -> Maybe String -> m NixShellConfig
284+nixShellRunConfig root isPure command = do
285+ nixpkgsPath <- fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $
286+ proc nixExePath ["eval", "(import .obelisk/impl {}).nixpkgs.path"]
287+ nixRemote <- liftIO $ lookupEnv "NIX_REMOTE"
288+ pure $ def
289+ & nixShellConfig_pure .~ isPure
290+ & nixShellConfig_common . nixCmdConfig_target .~ (def & target_path .~ Nothing)
291+ & nixShellConfig_run .~ (command <&> \cs -> unwords $ concat
292+ [ ["export", BSU.toString . bytes . bash $ "NIX_PATH=nixpkgs=" <> encodeUtf8 nixpkgsPath, ";"]
293+ , maybe [] (\v -> ["export", BSU.toString . bytes . bash $ "NIX_REMOTE=" <> encodeUtf8 (T.pack v), ";"]) nixRemote
294+ , [cs]
295+ ])
296+
297+bashEscape :: String -> String
298+bashEscape = BSU.toString . bytes . bash . BSU.fromString
299+
300+nixShellRunProc :: NixShellConfig -> ProcessSpec
301+nixShellRunProc cfg = setDelegateCtlc True $ proc nixShellPath $ runNixShellConfig cfg
302+
303+nixShellWithoutPkgs
202−inImpureProjectShell :: MonadObelisk m => String -> String -> m ()
304+ :: MonadObelisk m
203−inImpureProjectShell shellName command = withProjectRoot "." $ \root ->
305+ => FilePath -- ^ Path to project root
204− projectShell root False shellName command
306+ -> Bool -- ^ Should this be a pure shell?
205−
307+ -> Bool -- ^ Should we chdir to the package root in the shell?
206−projectShell :: MonadObelisk m => FilePath -> Bool -> String -> String -> m ()
308+ -> Map Text FilePath -- ^ Package names mapped to their paths
207−projectShell root isPure shellName command = withNixRemoteCheck $ do
309+ -> String -- ^ Shell attribute to use (e.g. @"ghc"@, @"ghcjs"@, etc.)
208− (_, _, _, ph) <- createProcess_ "runNixShellAttr" $ setCwd (Just root) $ proc "nix-shell" $
310+ -> Maybe String -- ^ If 'Just' run the given command; otherwise just open the interactive shell
209− [ "--pure" | isPure ] <>
311+ -> m ()
210− [ "-A"
312+nixShellWithoutPkgs root isPure chdirToRoot packageNamesAndPaths shellAttr command = do
211− , "shells." <> shellName
313+ packageNamesAndAbsPaths <- liftIO $ for packageNamesAndPaths makeAbsolute
212− , "--run", command
314+ defShellConfig <- nixShellRunConfig root isPure command
213− ]
315+ let setCwd_ = if chdirToRoot then setCwd (Just root) else id
214− void $ liftIO $ waitForProcess ph
316+ runProcess_ $ setCwd_ $ nixShellRunProc $ defShellConfig
215−
317+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
216−setCwd :: Maybe FilePath -> CreateProcess -> CreateProcess
318+ "{root, pkgs, shell}: ((import root {}).passthru.__unstable__.self.extend (_: _: {\
217−setCwd fp cfg = cfg { cwd = fp }
319+ \shellPackages = builtins.fromJSON pkgs;\
320+ \})).project.shells.${shell}"
321+ & nixShellConfig_common . nixCmdConfig_args .~
322+ [ rawArg "root" $ toNixPath $ if chdirToRoot then "." else root
323+ , strArg "pkgs" (T.unpack $ decodeUtf8 $ BSL.toStrict $ Json.encode packageNamesAndAbsPaths)
324+ , strArg "shell" shellAttr
325+ ]
326+
327+nixShellWithHoogle :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
328+nixShellWithHoogle root isPure shell' command = do
329+ defShellConfig <- nixShellRunConfig root isPure command
330+ runProcess_ $ setCwd (Just root) $ nixShellRunProc $ defShellConfig
331+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
332+ "{shell}: ((import ./. {}).passthru.__unstable__.self.extend (_: super: {\
333+ \userSettings = super.userSettings // { withHoogle = true; };\
334+ \})).project.shells.${shell}"
335+ & nixShellConfig_common . nixCmdConfig_args .~ [ strArg "shell" shell' ]
336+
337+findProjectAssets :: MonadObelisk m => FilePath -> m Text
338+findProjectAssets root = do
339+ isDerivation <- readProcessAndLogStderr Debug $ setCwd (Just root) $
340+ proc nixExePath
341+ [ "eval"
342+ , "(let a = import ./. {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
343+ , "--raw"
344+ -- `--raw` is not available with old nix-instantiate. It drops quotation
345+ -- marks and trailing newline, so is very convenient for shelling out.
346+ ]
347+ -- Check whether the impure static files are a derivation (and so must be built)
348+ if isDerivation == "1"
349+ then fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $ -- Strip whitespace here because nix-build has no --raw option
350+ proc nixBuildExePath
351+ [ "--no-out-link"
352+ , "-E", "(import ./. {}).passthru.staticFilesImpure"
353+ ]
354+ else readProcessAndLogStderr Debug $ setCwd (Just root) $
355+ proc nixExePath ["eval", "-f", ".", "passthru.staticFilesImpure", "--raw"]
lib/command/src/Obelisk/Command/Run.hs+504−140
@@ -1,190 +1,554 @@
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 #-}
10+{-# LANGUAGE TupleSections #-}
11+{-# LANGUAGE ViewPatterns #-}
6module Obelisk.Command.Run where
12module Obelisk.Command.Run where
7
13
8−import Control.Exception (bracket)
14+import Control.Arrow ((&&&))
15+import Control.Exception (Exception, bracket)
9−import Control.Monad
16+import Control.Lens (ifor, (.~), (&))
17+import Control.Monad (filterM)
18+import Control.Monad.Except (runExceptT, throwError)
10import Control.Monad.IO.Class (liftIO)
19import Control.Monad.IO.Class (liftIO)
11import Control.Monad.Reader (MonadIO)
20import Control.Monad.Reader (MonadIO)
12−import Data.Either
21+import Data.Bifoldable (bifoldr1)
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)
13−import Data.List
28+import Data.List (intercalate)
14−import Data.List.NonEmpty as NE
29+import Data.List.NonEmpty (NonEmpty)
30+import qualified Data.List.NonEmpty as NE
15−import Data.Maybe
31+import Data.Map (Map)
32+import qualified Data.Map as Map
33+import qualified Data.Map.Monoidal as MMap
34+import Data.Maybe (catMaybes, fromMaybe, mapMaybe)
35+import Data.Ord (comparing)
36+import Data.Set (Set)
37+import qualified Data.Set as Set
38+import Data.String.Here.Interpolated (i)
39+import Data.Text (Text)
16import qualified Data.Text as T
40import qualified Data.Text as T
41+import Data.Time.Clock (getCurrentTime)
42+import Data.Time.Format (formatTime, defaultTimeLocale)
43+import Data.Traversable (for)
44+import Debug.Trace (trace)
45+import Distribution.Compiler (CompilerFlavor(..))
17import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
46import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
18import Distribution.Parsec.ParseResult (runParseResult)
47import Distribution.Parsec.ParseResult (runParseResult)
19−import Distribution.Pretty
48+import qualified Distribution.System as Dist
20−import Distribution.Types.BuildInfo
49+import Distribution.Types.BuildInfo (buildable, cppOptions, defaultExtensions, defaultLanguage, hsSourceDirs, options)
21−import Distribution.Types.CondTree
50+import Distribution.Types.CondTree (simplifyCondTree)
22−import Distribution.Types.GenericPackageDescription
51+import Distribution.Types.GenericPackageDescription (ConfVar (Arch, Impl, OS), condLibrary)
23−import Distribution.Types.Library
52+import Distribution.Types.Library (libBuildInfo)
24−import Distribution.Utils.Generic
53+import Distribution.Utils.Generic (toUTF8BS, readUTF8File)
54+import qualified Distribution.Parsec.Common as Dist
25−import Hpack.Config
55+import qualified Hpack.Config as Hpack
26−import Hpack.Render
56+import qualified Hpack.Render as Hpack
27−import Hpack.Yaml
57+import qualified Hpack.Yaml as Hpack
28−import Language.Haskell.Extension
58+import Language.Haskell.Extension (Extension, Language)
29−import Network.Socket
59+import qualified Network.Socket as Socket
30import System.Directory
60import System.Directory
61+import System.Environment (getExecutablePath)
31import System.FilePath
62import System.FilePath
63+import qualified System.Info
32import System.IO.Temp (withSystemTempDirectory)
64import System.IO.Temp (withSystemTempDirectory)
33−import Data.ByteString (ByteString)
34
65
35−import Obelisk.App (MonadObelisk, ObeliskT)
66+import Obelisk.App (MonadObelisk)
36−import Obelisk.CliApp (CliT (..), HasCliConfig, Severity (..), callCommand, failWith, getCliConfig, putLog,
67+import Obelisk.CliApp (
37− runCli)
68+ Severity (..),
69+ failWith,
70+ proc,
71+ putLog,
72+ readCreateProcessWithExitCode,
73+ readProcessAndLogStderr,
74+ runProcess_,
75+ setCwd,
76+ setDelegateCtlc,
77+ withSpinner,
78+ )
38−import Obelisk.Command.Project (inProjectShell)
79+import Obelisk.Command.Nix
80+import Obelisk.Command.Project (nixShellWithoutPkgs, withProjectRoot, findProjectAssets, bashEscape)
81+import Obelisk.Command.Thunk (attrCacheFileName)
82+import Obelisk.Command.Utils (findExePath, ghcidExePath)
39
83
40data CabalPackageInfo = CabalPackageInfo
84data CabalPackageInfo = CabalPackageInfo
85+ { _cabalPackageInfo_packageFile :: FilePath
86+ , _cabalPackageInfo_packageName :: T.Text
41− { _cabalPackageInfo_packageRoot :: FilePath
87+ , _cabalPackageInfo_packageRoot :: FilePath
88+ , _cabalPackageInfo_buildable :: Bool
42 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
89 , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
43 -- ^ List of hs src dirs of the library component
90 -- ^ List of hs src dirs of the library component
44 , _cabalPackageInfo_defaultExtensions :: [Extension]
91 , _cabalPackageInfo_defaultExtensions :: [Extension]
45 -- ^ List of globally enable extensions of the library component
92 -- ^ List of globally enable extensions of the library component
93+ , _cabalPackageInfo_defaultLanguage :: Maybe Language
94+ -- ^ List of globally set languages of the library component
95+ , _cabalPackageInfo_compilerOptions :: [(CompilerFlavor, [String])]
96+ -- ^ List of compiler-specific options (e.g., the "ghc-options" field of the cabal file)
97+ , _cabalPackageInfo_cppOptions :: [String]
98+ -- ^ List of CPP (C Preprocessor) options (e.g. the "cpp-options" field of the cabal file)
46 }
99 }
47
100
48−-- NOTE: `run` is not polymorphic like the rest because we use StaticPtr to invoke it.
101+-- | 'Bool' with a better name for its purpose.
49−run :: ObeliskT IO ()
102+data Interpret = Interpret_Interpret | Interpret_NoInterpret deriving (Eq, Ord, Show)
50−run = do
51− pkgs <- getLocalPkgs
52− withGhciScript pkgs $ \dotGhciPath -> do
53− freePort <- getFreePort
54− runGhcid dotGhciPath $ Just $ unwords ["run", show freePort, "Backend.backend", "Frontend.frontend"]
55−
56−runRepl :: MonadObelisk m => m ()
57−runRepl = do
58− pkgs <- getLocalPkgs
59− withGhciScript pkgs $ \dotGhciPath -> do
60− runGhciRepl dotGhciPath
61−
62−runWatch :: MonadObelisk m => m ()
63−runWatch = do
64− pkgs <- getLocalPkgs
65− withGhciScript pkgs $ \dotGhciPath -> runGhcid dotGhciPath Nothing
66−
67−-- | Relative paths to local packages of an obelisk project
68−-- TODO a way to query this
69−getLocalPkgs :: Applicative f => f [FilePath]
70−getLocalPkgs = pure ["backend", "common", "frontend"]
71
103
104+textInterpret :: Interpret -> Text
105+textInterpret = \case
106+ Interpret_Interpret -> "Interpret"
107+ Interpret_NoInterpret -> "NoInterpret"
108+
109+-- | Describe a set of 'FilePath's as a tree to facilitate merging them in a convenient way.
110+data PathTree a = PathTree_Node
111+ (Maybe a) -- An optional leaf at this point in the tree
112+ (Map FilePath (PathTree a)) -- Branches to deeper leaves
113+ deriving (Eq, Ord, Show, Functor, Foldable, Traversable)
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+ runProcess_ $ setCwd (Just root) $ setDelegateCtlc True $ proc (outPath </> "bin" </> "ob-run") $
155+ [ show freePort
156+ , T.unpack assets
157+ , profileBaseName
158+ , "+RTS"
159+ , "-po" <> profileBaseName
160+ ] <> rtsFlags
161+ <> [ "-RTS" ]
162+
163+run :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
164+run root interpretPaths = do
165+ pkgs <- getParsedLocalPkgs root interpretPaths
166+ assets <- findProjectAssets root
167+ putLog Debug $ "Assets impurely loaded from: " <> assets
168+ ghciArgs <- getGhciSessionSettings pkgs root True
169+ freePort <- getFreePort
170+ withGhciScriptArgs pkgs $ \dotGhciArgs -> do
171+ runGhcid root True (ghciArgs <> dotGhciArgs) pkgs $ Just $ unwords
172+ [ "Obelisk.Run.run"
173+ , show freePort
174+ , "(Obelisk.Run.runServeAsset " ++ show assets ++ ")"
175+ , "Backend.backend"
176+ , "Frontend.frontend"
177+ ]
178+
179+runRepl :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
180+runRepl root interpretPaths = do
181+ pkgs <- getParsedLocalPkgs root interpretPaths
182+ ghciArgs <- getGhciSessionSettings pkgs "." True
183+ withGhciScriptArgs pkgs $ \dotGhciArgs ->
184+ runGhciRepl root pkgs (ghciArgs <> dotGhciArgs)
185+
186+runWatch :: MonadObelisk m => FilePath -> PathTree Interpret -> m ()
187+runWatch root interpretPaths = do
188+ pkgs <- getParsedLocalPkgs root interpretPaths
189+ ghciArgs <- getGhciSessionSettings pkgs root True
190+ withGhciScriptArgs pkgs $ \dotGhciArgs ->
191+ runGhcid root True (ghciArgs <> dotGhciArgs) pkgs Nothing
192+
193+exportGhciConfig :: MonadObelisk m => Bool -> FilePath -> PathTree Interpret -> m [String]
194+exportGhciConfig useRelativePaths root interpretPaths = do
195+ pkgs <- getParsedLocalPkgs root interpretPaths
196+ getGhciSessionSettings pkgs "." useRelativePaths
197+
198+nixShellForInterpretPaths :: MonadObelisk m => Bool -> String -> FilePath -> PathTree Interpret -> Maybe String -> m ()
199+nixShellForInterpretPaths isPure shell root interpretPaths cmd = do
200+ pkgs <- getParsedLocalPkgs root interpretPaths
201+ nixShellWithoutPkgs root isPure False (packageInfoToNamePathMap pkgs) shell cmd
202+
203+-- | Like 'getLocalPkgs' but also parses them and fails if any of them can't be parsed.
204+getParsedLocalPkgs :: MonadObelisk m => FilePath -> PathTree Interpret -> m (NonEmpty CabalPackageInfo)
205+getParsedLocalPkgs root interpretPaths = parsePackagesOrFail =<< getLocalPkgs root interpretPaths
206+
207+-- | Relative paths to local packages of an obelisk project.
208+--
209+-- These are a combination of the obelisk predefined local packages,
210+-- and any packages that the user has set with the @packages@ argument
211+-- to the Nix @project@ function.
212+getLocalPkgs :: forall m. MonadObelisk m => FilePath -> PathTree Interpret -> m (Set FilePath)
213+getLocalPkgs root interpretPaths = do
214+ putLog Debug $ [i|Finding packages with root ${root} and interpret paths:|] <> "\n" <> drawPathTree textInterpret interpretPaths
215+ obeliskPackagePaths <- runFind ["-L", root, "-name", ".obelisk", "-type", "d"]
216+
217+ -- We do not want to find packages that are embedded inside other obelisk projects, unless that
218+ -- obelisk project is our own.
219+ obeliskPackageExclusions <- liftIO $ fmap Set.fromList $ traverse canonicalizePath $
220+ filter (/= root) $ map takeDirectory obeliskPackagePaths
221+ putLog Debug [i|Excluding obelisk packages: ${T.pack $ unwords $ Set.toList obeliskPackageExclusions}|]
222+ let rootsAndExclusions = calcIntepretFinds "" interpretPaths
223+
224+ fmap fold $ for (MMap.toAscList rootsAndExclusions) $ \(interpretPathRoot, exclusions) ->
225+ let allExclusions = obeliskPackageExclusions <> exclusions <> Set.singleton ("*" </> attrCacheFileName)
226+ in fmap (Set.fromList . map normalise) $ runFind $
227+ ["-L", interpretPathRoot, "(", "-name", "*.cabal", "-o", "-name", Hpack.packageConfig, ")", "-a", "-type", "f"]
228+ <> concat [["-not", "-path", p </> "*"] | p <- toList allExclusions]
229+ where
230+ runFind args = do
231+ (_exitCode, out, err) <- readCreateProcessWithExitCode $ proc findExePath args
232+ putLog Debug $ T.strip $ T.pack err
233+ pure $ map T.unpack $ T.lines $ T.strip $ T.pack out
234+
235+-- | Calculates a set of root 'FilePath's along with each one's corresponding set of exclusions.
236+-- This is used when constructing a set of @find@ commands to run to produce a set of packages
237+-- that matches the user's @--interpret@/@--no-interpret@ settings.
238+calcIntepretFinds :: FilePath -> PathTree Interpret -> MMap.MonoidalMap FilePath (Set FilePath)
239+calcIntepretFinds treeRoot0 tree0 = runIdentity $ go treeRoot0 tree0
240+ where
241+ go treeRoot tree = foldPathTreeFor (== Interpret_Interpret) treeRoot tree $ \parent children -> do
242+ exclusions <- foldPathTreeFor (== Interpret_NoInterpret) parent children $ \parent' children' ->
243+ pure $ Map.singleton parent' children'
244+ deeperFinds <- Map.traverseWithKey go exclusions
245+ pure $ MMap.singleton parent (Map.keysSet exclusions) <> fold (MMap.MonoidalMap deeperFinds)
246+
247+-- | Traverses a 'PathTree' and folds all leaves matching a given predicate.
248+foldPathTreeFor
249+ :: forall m a b. (Applicative m, Monoid b)
250+ => (a -> Bool)
251+ -> FilePath
252+ -> PathTree a
253+ -> (FilePath -> PathTree a -> m b)
254+ -> m b
255+foldPathTreeFor predicate parent children f = case children of
256+ PathTree_Node (Just x) children' | predicate x -> f parent (PathTree_Node Nothing children')
257+ PathTree_Node _ children' -> fmap fold $ flip Map.traverseWithKey children' $ \k children'' ->
258+ foldPathTreeFor predicate (parent </> k) children'' f
259+
260+data GuessPackageFileError = GuessPackageFileError_Ambiguous [FilePath] | GuessPackageFileError_NotFound
261+ deriving (Eq, Ord, Show)
262+instance Exception GuessPackageFileError
263+
264+newtype HPackFilePath = HPackFilePath { unHPackFilePath :: FilePath } deriving (Eq, Ord, Show)
265+newtype CabalFilePath = CabalFilePath { unCabalFilePath :: FilePath } deriving (Eq, Ord, Show)
266+
267+-- | Given a directory, try to guess what the appropriate @.cabal@ or @package.yaml@ file is for the package.
268+guessCabalPackageFile
269+ :: (MonadIO m)
270+ => FilePath -- ^ Directory or path to search for cabal package
271+ -> m (Either GuessPackageFileError (Either CabalFilePath HPackFilePath))
272+guessCabalPackageFile pkg = do
273+ liftIO (doesDirectoryExist pkg) >>= \case
274+ False -> case cabalOrHpackFile pkg of
275+ (Just hpack@(Right _)) -> pure $ Right hpack
276+ (Just cabal@(Left (CabalFilePath cabalFilePath))) -> do
277+ -- If the cabal file has a sibling hpack file, we use that instead
278+ -- since running hpack often generates a sibling cabal file
279+ let possibleHpackSibling = takeDirectory cabalFilePath </> Hpack.packageConfig
280+ hasHpackSibling <- liftIO $ doesFileExist possibleHpackSibling
281+ pure $ Right $ if hasHpackSibling then Right (HPackFilePath possibleHpackSibling) else cabal
282+ Nothing -> pure $ Left GuessPackageFileError_NotFound
283+ True -> do
284+ candidates <- liftIO $
285+ filterM (doesFileExist . either unCabalFilePath unHPackFilePath)
286+ =<< mapMaybe (cabalOrHpackFile . (pkg </>)) <$> listDirectory pkg
287+ pure $ case partitionEithers candidates of
288+ ([hpack], _) -> Right $ Left hpack
289+ ([], [cabal]) -> Right $ Right cabal
290+ ([], []) -> Left GuessPackageFileError_NotFound
291+ (hpacks, cabals) -> Left $ GuessPackageFileError_Ambiguous $ coerce hpacks <> coerce cabals
292+
293+cabalOrHpackFile :: FilePath -> Maybe (Either CabalFilePath HPackFilePath)
294+cabalOrHpackFile = \case
295+ x | takeExtension x == ".cabal" -> Just (Left $ CabalFilePath x)
296+ | takeFileName x == Hpack.packageConfig -> Just (Right $ HPackFilePath x)
297+ | otherwise -> Nothing
298+
299+-- | Parses the cabal package in a given directory.
300+-- This automatically figures out which .cabal file or package.yaml (hpack) file to use in the given directory.
72parseCabalPackage
301parseCabalPackage
73− :: (MonadObelisk m)
302+ :: MonadObelisk m
74− => FilePath -- ^ package directory
303+ => FilePath -- ^ Package directory
75 -> m (Maybe CabalPackageInfo)
304 -> m (Maybe CabalPackageInfo)
76−parseCabalPackage dir = do
305+parseCabalPackage dir = parseCabalPackage' dir >>= \case
77− let cabalFp = dir </> (takeBaseName dir <> ".cabal")
306+ Left err -> Nothing <$ putLog Error err
78− hpackFp = dir </> "package.yaml"
307+ Right (Just (warnings, pkgInfo)) -> do
79− hasCabal <- liftIO $ doesFileExist cabalFp
308+ for_ warnings $ putLog Warning . T.pack . show
80− hasHpack <- liftIO $ doesFileExist hpackFp
309+ pure $ Just pkgInfo
81−
310+ Right Nothing -> pure Nothing
82− mCabalContents <- if hasCabal
311+
83− then Just <$> liftIO (readUTF8File cabalFp)
312+-- | Like 'parseCabalPackage' but returns errors and warnings directly so as to avoid 'MonadObelisk'.
84− else if hasHpack
313+parseCabalPackage'
85− then do
314+ :: (MonadIO m)
315+ => FilePath -- ^ Package directory
316+ -> m (Either T.Text (Maybe ([Dist.PWarning], CabalPackageInfo)))
317+parseCabalPackage' pkg = runExceptT $ do
318+ (cabalContents, packageFile, packageName) <- guessCabalPackageFile pkg >>= \case
319+ Left GuessPackageFileError_NotFound -> throwError $ "No .cabal or package.yaml file found in " <> T.pack pkg
320+ Left (GuessPackageFileError_Ambiguous _) -> throwError $ "Unable to determine which .cabal file to use in " <> T.pack pkg
321+ Right (Left (CabalFilePath file)) -> (, file, takeBaseName file) <$> liftIO (readUTF8File file)
322+ Right (Right (HPackFilePath file)) -> do
323+ let
86− let decodeOptions = DecodeOptions hpackFp Nothing decodeYaml
324+ decodeOptions = Hpack.DecodeOptions (Hpack.ProgramName "ob") file Nothing Hpack.decodeYaml
87− liftIO (readPackageConfig decodeOptions) >>= \case
325+ liftIO (Hpack.readPackageConfig decodeOptions) >>= \case
88− Left err -> do
89− putLog Error $ T.pack $ "Failed to parse " <> hpackFp <> ": " <> err
326+ Left err -> throwError $ T.pack $ "Failed to parse " <> file <> ": " <> err
90− return Nothing
91− Right (DecodeResult hpackPackage _ _) -> do
327+ Right (Hpack.DecodeResult hpackPackage _ _ _) -> pure (Hpack.renderPackage [] hpackPackage, file, Hpack.packageName hpackPackage)
92− return $ Just $ renderPackage [] hpackPackage
328+
93− else return Nothing
329+ let
94−
95− fmap join $ forM mCabalContents $ \cabalContents -> do
96− let (warnings, result) = runParseResult $ parseGenericPackageDescription $
330+ (warnings, result) = runParseResult $ parseGenericPackageDescription $ toUTF8BS cabalContents
97− toUTF8BS $ cabalContents
331+ osConfVar = case System.Info.os of
98− mapM_ (putLog Warning) $ fmap (T.pack . show) warnings
332+ "linux" -> Just Dist.Linux
99− case result of
333+ "darwin" -> Just Dist.OSX
100− Right gpkg -> do
334+ _ -> trace "Unrecgonized System.Info.os" Nothing
101− return $ do
335+ archConfVar = Just Dist.X86_64 -- TODO: Actually infer this
102− (_, 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
103− pure $ CabalPackageInfo
344+ pure $ Just $ (warnings,) $ CabalPackageInfo
345+ { _cabalPackageInfo_packageName = T.pack packageName
346+ , _cabalPackageInfo_packageFile = packageFile
104− { _cabalPackageInfo_packageRoot = takeDirectory cabalFp
347+ , _cabalPackageInfo_packageRoot = takeDirectory packageFile
348+ , _cabalPackageInfo_buildable = buildable $ libBuildInfo lib
105− , _cabalPackageInfo_sourceDirs =
349+ , _cabalPackageInfo_sourceDirs =
106− fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
350+ fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
107− , _cabalPackageInfo_defaultExtensions =
351+ , _cabalPackageInfo_defaultExtensions =
108− defaultExtensions $ libBuildInfo lib
352+ defaultExtensions $ libBuildInfo lib
353+ , _cabalPackageInfo_defaultLanguage =
354+ defaultLanguage $ libBuildInfo lib
355+ , _cabalPackageInfo_compilerOptions = options $ libBuildInfo lib
356+ , _cabalPackageInfo_cppOptions = cppOptions $ libBuildInfo lib
109− }
357+ }
358+ Right Nothing -> pure Nothing
110− Left (_, errors) -> do
359+ Left (_, errors) ->
111− putLog Error $ T.pack $ "Failed to parse " <> cabalFp <> ":"
360+ throwError $ T.pack $ "Failed to parse " <> packageFile <> ":\n" <> unlines (map show errors)
112− mapM_ (putLog Error) $ fmap (T.pack . show) errors
361+
113− return Nothing
362+parsePackagesOrFail :: (MonadObelisk m, Foldable f) => f FilePath -> m (NE.NonEmpty CabalPackageInfo)
114−
363+parsePackagesOrFail dirs' = do
115−withUTF8FileContentsM :: (MonadIO m, HasCliConfig e m) => FilePath -> (ByteString -> CliT e IO a) -> m a
364+ packageInfos' <- fmap catMaybes $ for dirs $ \dir -> do
116−withUTF8FileContentsM fp f = do
365+ flip fmap (parseCabalPackage dir) $ \case
117− c <- getCliConfig
366+ Just packageInfo
118− liftIO $ withUTF8FileContents fp $ runCli c . f . toUTF8BS
367+ | _cabalPackageInfo_buildable packageInfo -> Just packageInfo
368+ _ -> Nothing
369+
370+ -- Sort duplicate packages such that we prefer shorter paths, but fall back to alphabetical ordering.
371+ let packagesByName = Map.map (NE.sortBy $ comparing $ \p -> let n = _cabalPackageInfo_packageFile p in (length n, n))
372+ $ Map.fromListWith (<>) [(_cabalPackageInfo_packageName p, p NE.:| []) | p <- packageInfos']
373+ unambiguous <- ifor packagesByName $ \packageName ps -> case ps of
374+ p NE.:| [] -> pure p -- No ambiguity here
375+ p NE.:| _ -> do
376+ let chosenText = " [Chosen] "
377+ prefix p'
378+ | _cabalPackageInfo_packageFile p' == _cabalPackageInfo_packageFile p = chosenText
379+ | otherwise = T.map (const ' ') chosenText
380+ putLog Warning $ T.unlines $
381+ "Packages named '" <> packageName <> "' appear in " <> T.pack (show $ length ps) <> " different locations: "
382+ : map (\p' -> prefix p' <> T.pack (_cabalPackageInfo_packageFile p')) (toList ps)
383+ pure p
384+
385+ packageInfos <- case NE.nonEmpty $ toList unambiguous of
386+ Nothing -> failWith $ T.pack $
387+ "No valid, buildable packages found" <> (if null dirs then "" else " in " <> intercalate ", " dirs)
388+ Just xs -> pure xs
389+
390+ pure packageInfos
391+ where
392+ dirs = toList dirs'
393+
394+packageInfoToNamePathMap :: Foldable f => f CabalPackageInfo -> Map Text FilePath
395+packageInfoToNamePathMap = Map.fromList . map (_cabalPackageInfo_packageName &&& _cabalPackageInfo_packageRoot) . toList
396+
397+-- Like 'withGhciScript' but provides the precise ghci arguments to add to a ghci session
398+withGhciScriptArgs
399+ :: (MonadObelisk m, Foldable f)
400+ => f CabalPackageInfo -- ^ List of packages to load into ghci
401+ -> ([String] -> m ()) -- ^ Action to run with the extra ghci arguments
402+ -> m ()
403+withGhciScriptArgs packageInfos f = withGhciScript loadPreludeManually packageInfos $ \fp -> f ["-XNoImplicitPrelude", "-ghci-script", fp]
404+ where
405+ -- These lines must be first and allow the session to support a custom Prelude when @-XNoImplicitPrelude@
406+ -- is passed to the ghci session.
407+ loadPreludeManually =
408+ [ ":add Prelude" -- @:add@ is used because it's less noisy when there is no custom Prelude
409+ , ":set -XImplicitPrelude" -- Turn the default setting on
410+ ]
119
411
120-- | Create ghci configuration to load the given packages
412-- | Create ghci configuration to load the given packages
121withGhciScript
413withGhciScript
122− :: MonadObelisk m
414+ :: (MonadObelisk m, Foldable f)
415+ => [String] -- ^ Commands to prefix to file
123− => [FilePath] -- ^ List of packages to load into ghci
416+ -> f CabalPackageInfo -- ^ List of packages to load into ghci
124− -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporory .ghci
417+ -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporary .ghci
125 -> m ()
418 -> m ()
126−withGhciScript pkgs f = do
419+withGhciScript preCommands (toList -> packageInfos) f =
127− (pkgDirErrs, packageInfos) <- fmap partitionEithers $ forM pkgs $ \pkg -> do
128− flip fmap (parseCabalPackage pkg) $ \case
129− Nothing -> Left pkg
130− Just packageInfo -> Right packageInfo
131−
132− when (null packageInfos) $
133− failWith $ T.pack $ "No valid pkgs found in " <> intercalate ", " pkgs
134− unless (null pkgDirErrs) $
135− putLog Warning $ T.pack $ "Failed to find pkgs in " <> intercalate ", " pkgDirErrs
136−
137− let extensions = packageInfos >>= _cabalPackageInfo_defaultExtensions
138− extensionsLine = if extensions == mempty
139− then ""
140− else ":set " <> intercalate " " ((("-X" <>) . prettyShow) <$> extensions)
141− dotGhci = unlines $
142− [ ":set -i" <> intercalate ":" (packageInfos >>= rootedSourceDirs)
143− , extensionsLine
144− , ":load Backend Frontend"
145− , "import Obelisk.Run"
146− , "import qualified Frontend"
147− , "import qualified Backend"
148− ]
149 withSystemTempDirectory "ob-ghci" $ \fp -> do
420 withSystemTempDirectory "ob-ghci" $ \fp -> do
150 let dotGhciPath = fp </> ".ghci"
421 let dotGhciPath = fp </> ".ghci"
151 liftIO $ writeFile dotGhciPath dotGhci
422 liftIO $ writeFile dotGhciPath dotGhci
152 f dotGhciPath
423 f dotGhciPath
424+ where
425+ packageNames = Set.fromList $ map _cabalPackageInfo_packageName packageInfos
426+ modulesToLoad = mconcat
427+ [ [ "Obelisk.Run" | "obelisk-run" `Set.member` packageNames ]
428+ , [ "Backend" | "backend" `Set.member` packageNames ]
429+ , [ "Frontend" | "frontend" `Set.member` packageNames ]
430+ ]
431+ dotGhci = unlines $
432+ preCommands <>
433+ [ if null modulesToLoad then "" else ":load " <> unwords modulesToLoad
434+ , "import qualified Obelisk.Run"
435+ , "import qualified Frontend"
436+ , "import qualified Backend"
437+ ]
438+
439+-- | Builds a list of options to pass to ghci or set in .ghci file that configures
440+-- the preprocessor and source includes.
441+getGhciSessionSettings
442+ :: (MonadObelisk m, Foldable f)
443+ => f CabalPackageInfo -- ^ List of packages to load into ghci
444+ -> FilePath -- ^ All paths will be relative to this path
445+ -> Bool -- ^ Use relative paths
446+ -> m [String]
447+getGhciSessionSettings (toList -> packageInfos) pathBase useRelativePaths = do
448+ -- N.B. ghci settings do NOT support escaping in any way. To minimize the likelihood that
449+ -- paths-with-spaces ruin our day, we first canonicalize everything, and then relativize
450+ -- all paths to 'pathBase'.
451+ selfExe <- liftIO $ canonicalizePath =<< getExecutablePath
452+ canonicalPathBase <- liftIO $ canonicalizePath pathBase
453+
454+ (pkgFiles, pkgSrcPaths :: [NonEmpty FilePath]) <- fmap unzip $ liftIO $ for packageInfos $ \pkg -> do
455+ canonicalSrcDirs <- traverse canonicalizePath $ (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
456+ canonicalPkgFile <- canonicalizePath $ _cabalPackageInfo_packageFile pkg
457+ pure (canonicalPkgFile `relativeTo'` canonicalPathBase, (`relativeTo'` canonicalPathBase) <$> canonicalSrcDirs)
153
458
459+ pure
460+ $ baseGhciOptions
461+ <> ["-F", "-pgmF", selfExe, "-optF", preprocessorIdentifier]
462+ <> concatMap (\p -> ["-optF", p]) pkgFiles
463+ <> [ "-i" <> intercalate ":" (concatMap toList pkgSrcPaths) ]
154 where
464 where
155− rootedSourceDirs pkg = NE.toList $
465+ relativeTo' = if useRelativePaths then relativeTo else const
156− (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
466+
467+baseGhciOptions :: [String]
468+baseGhciOptions =
469+ [ "-ignore-dot-ghci"
470+ , "-no-user-package-db"
471+ , "-package-env", "-"
472+ ]
157
473
158-- | Run ghci repl
474-- | Run ghci repl
159runGhciRepl
475runGhciRepl
160− :: MonadObelisk m
476+ :: (MonadObelisk m, Foldable f)
161− => FilePath -- ^ Path to .ghci
477+ => FilePath -- ^ Path to project root
478+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
479+ -> [String] -- ^ GHCi arguments
162 -> m ()
480 -> m ()
163−runGhciRepl dotGhci = inProjectShell "ghc" $ unwords $ "ghci" : ["-ghci-script", dotGhci]
481+runGhciRepl root (toList -> packages) ghciArgs =
482+ -- NOTE: We do *not* want to use $(staticWhich "ghci") here because we need the
483+ -- ghc that is provided by the shell in the user's project.
484+ nixShellWithoutPkgs root True False (packageInfoToNamePathMap packages) "ghc" $
485+ Just $ unwords $ fmap bashEscape $ "ghci" : ghciArgs
164
486
165-- | Run ghcid
487-- | Run ghcid
166runGhcid
488runGhcid
167− :: MonadObelisk m
489+ :: (MonadObelisk m, Foldable f)
168− => FilePath -- ^ Path to .ghci
490+ => FilePath -- ^ Path to project root
491+ -> Bool -- ^ Should we chdir to root when running this process?
492+ -> [String] -- ^ GHCi arguments
493+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
169 -> Maybe String -- ^ Optional command to run at every reload
494 -> Maybe String -- ^ Optional command to run at every reload
170 -> m ()
495 -> m ()
171−runGhcid dotGhci mcmd = callCommand $ unwords $ "ghcid" : opts
496+runGhcid root chdirToRoot ghciArgs (toList -> packages) mcmd =
497+ nixShellWithoutPkgs root True chdirToRoot (packageInfoToNamePathMap packages) "ghc" $
498+ Just $ unwords $ fmap bashEscape $ ghcidExePath : opts
172 where
499 where
173− opts =
500+ opts = concat
174− [ "-W"
501+ [ ["-W"]
175− --TODO: The decision of whether to use -fwarn-redundant-constraints should probably be made by the user
176− , "--command='ghci -Wall -ignore-dot-ghci -fwarn-redundant-constraints -ghci-script " <> dotGhci <> "' "
177− , "--reload=config"
178− , "--outputfile=ghcid-output.txt"
502+ , ["--outputfile=ghcid-output.txt"]
179− ] <> testCmd
503+ , map (\x -> "--reload=" <> x) reloadFiles
180− testCmd = maybeToList (flip fmap mcmd $ \cmd -> "--test='" <> cmd <> "'")
504+ , map (\x -> "--restart=" <> x) restartFiles
181−
505+ , maybe [] (\cmd -> ["--test=" <> cmd]) mcmd
506+ , ["--command=" <> unwords ("ghci" : ghciArgs)]
507+ ]
508+ adjustRoot x = if chdirToRoot then makeRelative root x else x
509+ reloadFiles = map adjustRoot [root </> "config"]
510+ restartFiles = map (adjustRoot . _cabalPackageInfo_packageFile) packages
511+
182−getFreePort :: MonadIO m => m PortNumber
512+getFreePort :: MonadIO m => m Socket.PortNumber
183−getFreePort = liftIO $ withSocketsDo $ do
513+getFreePort = liftIO $ Socket.withSocketsDo $ do
184− addr:_ <- getAddrInfo (Just defaultHints) (Just "127.0.0.1") (Just "0")
514+ addr:_ <- Socket.getAddrInfo (Just Socket.defaultHints) (Just "127.0.0.1") (Just "0")
185− bracket (open addr) close socketPort
515+ bracket (open addr) Socket.close Socket.socketPort
186 where
516 where
187 open addr = do
517 open addr = do
188− sock <- socket (addrFamily addr) (addrSocketType addr) (addrProtocol addr)
518+ sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
189− bind sock (addrAddress addr)
519+ Socket.bind sock (Socket.addrAddress addr)
190 return sock
520 return sock
521+
522+
523+-- | Convert a 'FilePath' into a 'PathTree'.
524+pathToTree :: a -> FilePath -> PathTree a
525+pathToTree a p = go $ splitDirectories p
526+ where
527+ go [] = PathTree_Node (Just a) mempty
528+ go (x : xs) = PathTree_Node Nothing $ Map.singleton x $ go xs
529+
530+-- | Like 'zipWith' but pads with a padding value instead of stopping on the shortest list.
531+zipDefaultWith :: a -> b -> (a -> b -> c) -> [a] -> [b] -> [c]
532+zipDefaultWith _da _db _f [] [] = []
533+zipDefaultWith da db f (a:as) [] = f a db : zipDefaultWith da db f as []
534+zipDefaultWith da db f [] (b:bs) = f da b : zipDefaultWith da db f [] bs
535+zipDefaultWith da db f (a:as) (b:bs) = f a b : zipDefaultWith da db f as bs
536+
537+-- | Makes the first absolute path relative to the second absolute path.
538+--
539+-- Both input paths MUST be absolute.
540+--
541+-- Unlike 'makeRelative' this does not merely strip prefixes. It will introduce
542+-- enough @..@ paths to make the resulting path truly relative in virtually every
543+-- case. The only exception is on Windows when the two paths are on different
544+-- drives. In this case the resulting path may be absolute.
545+relativeTo :: FilePath -> FilePath -> FilePath
546+relativeTo dir base
547+ = bifoldr1 (</>)
548+ $ bimap (collapse . (".." <$) . catMaybes) (collapse . catMaybes)
549+ $ unzip
550+ $ dropWhile (\(a,b) -> a == b)
551+ $ zipDefaultWith Nothing Nothing (,)
552+ (map Just $ splitDirectories base)
553+ (map Just $ splitDirectories dir)
554+ where collapse = foldr (</>) ""
lib/command/src/Obelisk/Command/Thunk.hs+651−359
@@ -5,84 +5,70 @@
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− , getThunkPtr'
30− , parseGitUri
31− , uriThunkPtr
32− ) where
33
12
34import Control.Applicative
13import Control.Applicative
35import Control.Exception (displayException, try)
14import Control.Exception (displayException, try)
36−import Control.Lens.Indexed hiding ((<.>))
15+import Control.Lens (ifor, ifor_, (.~))
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
70−import System.Posix (getSymbolicLinkStatus, modificationTime)
59+import System.PosixCompat.Files (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
76−import Obelisk.Command.Nix (withNixRemoteCheck)
77import Obelisk.Command.Utils
64import Obelisk.Command.Utils
78
65
79--TODO: Support symlinked thunk data
66--TODO: Support symlinked thunk data
80data ThunkData
67data ThunkData
81− = ThunkData_Packed ThunkPtr
68+ = ThunkData_Packed ThunkSpec ThunkPtr
82 -- ^ Packed thunk
69 -- ^ Packed thunk
83− | ThunkData_Checkout (Maybe ThunkPtr)
70+ | ThunkData_Checkout
84 -- ^ Checked out thunk that was unpacked from this pointer
71 -- ^ Checked out thunk that was unpacked from this pointer
85− deriving (Show, Eq, Ord)
86
72
87-- | 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
88data ThunkPtr = ThunkPtr
74data ThunkPtr = ThunkPtr
@@ -95,7 +81,7 @@ type NixSha256 = Text --TODO: Use a smart constructor and make this actually ver
95
81
96-- | A specific revision of data; it may be available from multiple sources
82-- | A specific revision of data; it may be available from multiple sources
97data ThunkRev = ThunkRev
83data ThunkRev = ThunkRev
98− { _thunkRev_commit :: Ref
84+ { _thunkRev_commit :: Ref Ref.SHA1
99 , _thunkRev_nixSha256 :: NixSha256
85 , _thunkRev_nixSha256 :: NixSha256
100 }
86 }
101 deriving (Show, Eq, Ord)
87 deriving (Show, Eq, Ord)
@@ -108,41 +94,72 @@ data ThunkSource
108 | ThunkSource_Git GitSource
94 | ThunkSource_Git GitSource
109 deriving (Show, Eq, Ord)
95 deriving (Show, Eq, Ord)
110
96
97+thunkSourceToGitSource :: ThunkSource -> GitSource
98+thunkSourceToGitSource = \case
99+ ThunkSource_GitHub s -> forgetGithub False s
100+ ThunkSource_Git s -> s
101+
111data GitHubSource = GitHubSource
102data GitHubSource = GitHubSource
112 { _gitHubSource_owner :: Name Owner
103 { _gitHubSource_owner :: Name Owner
113 , _gitHubSource_repo :: Name Repo
104 , _gitHubSource_repo :: Name Repo
114 , _gitHubSource_branch :: Maybe (Name Branch)
105 , _gitHubSource_branch :: Maybe (Name Branch)
106+ , _gitHubSource_private :: Bool
115 }
107 }
116 deriving (Show, Eq, Ord)
108 deriving (Show, Eq, Ord)
117
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+
118data GitSource = GitSource
119data GitSource = GitSource
119− { _gitSource_url :: URI
120+ { _gitSource_url :: GitUri
120 , _gitSource_branch :: Maybe (Name Branch)
121 , _gitSource_branch :: Maybe (Name Branch)
121 , _gitSource_fetchSubmodules :: Bool
122 , _gitSource_fetchSubmodules :: Bool
123+ , _gitSource_private :: Bool
122 }
124 }
123 deriving (Show, Eq, Ord)
125 deriving (Show, Eq, Ord)
124
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+
125-- | 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.
126forgetGithub :: Bool -> GitHubSource -> GitSource
142forgetGithub :: Bool -> GitHubSource -> GitSource
127forgetGithub useSsh s = GitSource
143forgetGithub useSsh s = GitSource
128− { _gitSource_url = URI
144+ { _gitSource_url = GitUri $ URI.URI
129− { uriScheme = Just $ fromRight' $ mkScheme $ if useSsh then "ssh" else "https"
145+ { URI.uriScheme = Just $ fromRight' $ URI.mkScheme $ if useSsh then "ssh" else "https"
130− , uriAuthority = Right $ Authority
146+ , URI.uriAuthority = Right $ URI.Authority
131− { authUserInfo = UserInfo (fromRight' $ mkUsername "git") Nothing
147+ { URI.authUserInfo = URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
132 <$ guard useSsh
148 <$ guard useSsh
133− , authHost = fromRight' $ mkHost "github.com"
149+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
134− , authPort = Nothing
150+ , URI.authPort = Nothing
135 }
151 }
136− , uriPath = Just ( False
152+ , URI.uriPath = Just ( False
137− , fromRight' . mkPathPiece <$>
153+ , fromRight' . URI.mkPathPiece <$>
138 untagName (_gitHubSource_owner s)
154 untagName (_gitHubSource_owner s)
139 :| [ untagName (_gitHubSource_repo s) <> ".git" ]
155 :| [ untagName (_gitHubSource_repo s) <> ".git" ]
140 )
156 )
141− , uriQuery = []
157+ , URI.uriQuery = []
142− , uriFragment = Nothing
158+ , URI.uriFragment = Nothing
143 }
159 }
144 , _gitSource_branch = _gitHubSource_branch s
160 , _gitSource_branch = _gitHubSource_branch s
145 , _gitSource_fetchSubmodules = False
161 , _gitSource_fetchSubmodules = False
162+ , _gitSource_private = _gitHubSource_private s
146 }
163 }
147
164
148getThunkGitBranch :: ThunkPtr -> Maybe Text
165getThunkGitBranch :: ThunkPtr -> Maybe Text
@@ -150,25 +167,26 @@ getThunkGitBranch (ThunkPtr _ src) = fmap untagName $ case src of
150 ThunkSource_GitHub s -> _gitHubSource_branch s
167 ThunkSource_GitHub s -> _gitHubSource_branch s
151 ThunkSource_Git s -> _gitSource_branch s
168 ThunkSource_Git s -> _gitSource_branch s
152
169
153−commitNameToRef :: Name Commit -> Ref
170+commitNameToRef :: Name Commit -> Ref Ref.SHA1
154commitNameToRef (N c) = Ref.fromHex $ encodeUtf8 c
171commitNameToRef (N c) = Ref.fromHex $ encodeUtf8 c
155
172
156-- TODO: Use spinner here.
173-- TODO: Use spinner here.
157getNixSha256ForUriUnpacked
174getNixSha256ForUriUnpacked
158 :: MonadObelisk m
175 :: MonadObelisk m
159− => URI
176+ => GitUri
160 -> m NixSha256
177 -> m NixSha256
161getNixSha256ForUriUnpacked uri =
178getNixSha256ForUriUnpacked uri =
162− 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
163− withNixRemoteCheck $ readProcessAndLogOutput (Debug, Debug) $
180+ [hash] <- fmap T.lines $ readProcessAndLogOutput (Debug, Debug) $
164− proc "nix-prefetch-url" ["--unpack" , "--type" , "sha256" , T.unpack $ render uri]
181+ proc nixPrefetchUrlPath ["--unpack", "--type", "sha256", T.unpack $ gitUriToText uri]
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 <- withNixRemoteCheck $ readProcessAndLogStderr Debug $
187+ out <- readProcessAndLogStderr Debug $
170− proc "nix-prefetch-git" $ filter (/="")
188+ proc nixPrefetchGitPath $ 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
226+ { _thunkSpec_name :: !Text
227+ , _thunkSpec_files :: !(Map FilePath ThunkFileSpec)
208 }
228 }
209
229
210−gitHubThunkType :: ThunkType
230+thunkSpecTypes :: NonEmpty (NonEmpty ThunkSpec)
211−gitHubThunkType = ThunkType
231+thunkSpecTypes = gitThunkSpecs :| [gitHubThunkSpecs]
212− { _thunkType_loader = "default.nix"
232+
213− , _thunkType_json = "github.json"
233+-- | Attempts to match a 'ThunkSpec' to a given directory.
214− , _thunkType_optional = Set.fromList [".attr-cache"]
234+matchThunkSpecToDir
215− , _thunkType_loaderVersions = gitHubStandaloneLoaders
235+ :: (MonadError ReadThunkError m, MonadIO m, MonadCatch m)
216− , _thunkType_parser = parseThunkPtr $ \v ->
236+ => ThunkSpec -- ^ 'ThunkSpec' to match against the given files/directory
217− ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
237+ -> FilePath -- ^ Path to directory
218− }
238+ -> Set FilePath -- ^ Set of file paths relative to the given directory
219−
239+ -> m ThunkData
220−gitThunkType :: ThunkType
240+matchThunkSpecToDir thunkSpec dir dirFiles = do
221−gitThunkType = ThunkType
241+ case nonEmpty (toList $ dirFiles `Set.difference` expectedPaths) of
222− { _thunkType_loader = "default.nix"
242+ Just fs -> throwError $ ReadThunkError_UnrecognizedPaths $ (dir </>) <$> fs
223− , _thunkType_json = "git.json"
243+ Nothing -> pure ()
224− , _thunkType_optional = Set.fromList [".attr-cache"]
244+ case nonEmpty (toList $ requiredPaths `Set.difference` dirFiles) of
225− , _thunkType_loaderVersions = plainGitStandaloneLoaders
245+ Just fs -> throwError $ ReadThunkError_MissingPaths $ (dir </>) <$> fs
226− , _thunkType_parser = parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
246+ Nothing -> pure ()
227− }
247+ datas <- fmap toList $ flip Map.traverseMaybeWithKey (_thunkSpec_files thunkSpec) $ \expectedPath -> \case
228−
248+ ThunkFileSpec_AttrCache -> Nothing <$ dirMayExist expectedPath
229−thunkTypes :: [ThunkType]
249+ ThunkFileSpec_CheckoutIndicator -> liftIO (doesDirectoryExist (dir </> expectedPath)) <&> \case
230−thunkTypes = [gitThunkType, gitHubThunkType]
250+ False -> Nothing
231−
251+ True -> Just ThunkData_Checkout
232−findThunkType :: [ThunkType] -> FilePath -> IO (Either ReadThunkError ThunkType)
252+ ThunkFileSpec_FileMatches expectedContents -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
233−findThunkType types thunkDir = do
253+ actualContents <- liftIO (T.readFile $ dir </> expectedPath)
234− matches <- fmap catMaybes $ forM types $ \thunkType -> do
254+ case T.strip expectedContents == T.strip actualContents of
235− let
255+ True -> pure Nothing
236− expectedContents = Set.fromList $ (thunkDir </>) <$>
256+ False -> throwError $ ReadThunkError_FileDoesNotMatch (dir </> expectedPath) expectedContents
237− [ _thunkType_loader thunkType
257+ ThunkFileSpec_Ptr parser -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
238− , _thunkType_json thunkType
258+ let path = dir </> expectedPath
239− ]
259+ liftIO (doesFileExist path) >>= \case
240− optionalContents = Set.map (thunkDir </>) (_thunkType_optional thunkType)
260+ False -> pure Nothing
241−
261+ True -> do
242− -- Ensure that there aren't any other files in the thunk
262+ actualContents <- liftIO $ LBS.readFile path
243− -- NB: System.Directory.listDirectory returns the contents without the directory path
263+ case parser actualContents of
244− files <- liftIO $ Set.fromList . fmap (thunkDir </>) <$> listDirectory thunkDir
264+ Right v -> pure $ Just (ThunkData_Packed thunkSpec v)
245− let unexpectedContents = files `Set.difference` (expectedContents `Set.union` optionalContents)
265+ Left e -> throwError $ ReadThunkError_UnparseablePtr (dir </> expectedPath) e
246− missingContents = expectedContents `Set.difference` files
266+
247− pure $ if Set.null unexpectedContents && Set.null missingContents
267+ case nonEmpty datas of
248− then Just thunkType
268+ Nothing -> throwError ReadThunkError_UnrecognizedThunk
249− else Nothing
269+ Just xs -> fold1WithM xs $ \a b -> either throwError pure (mergeThunkData a b)
250−
270+ where
251− pure $ case matches of
271+ rootPathsOnly = Set.fromList . mapMaybe takeRootDir . Map.keys
252− [singleMatch] -> Right singleMatch
272+ takeRootDir = fmap NonEmpty.head . nonEmpty . splitPath
253− [] -> Left ReadThunkError_UnrecognizedFiles
273+
254− _ -> Left ReadThunkError_AmbiguousFiles
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,59 +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 -> m ()
437+updateThunkToLatest :: MonadObelisk m => ThunkUpdateConfig -> FilePath -> m ()
381−updateThunkToLatest target = 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
439+ checkThunkDirectory target
440+ -- check to see if thunk should be updated to a specific branch or just update it's current branch
441+ case mBranch of
442+ Nothing -> do
382− (overwrite, ptr) <- readThunk target >>= \case
443+ (overwrite, ptr) <- readThunk target >>= \case
383− Left err -> failWith $ T.pack $ "thunk update: " <> show err
444+ Left err -> failWith [i|Thunk update: ${err}|]
384− Right c -> case c of
445+ Right c -> case c of
385− ThunkData_Packed t -> return (target, t)
446+ ThunkData_Packed _ t -> return (target, t)
386− ThunkData_Checkout _ -> failWith "cannot update an unpacked thunk"
447+ ThunkData_Checkout -> failWith "cannot update an unpacked thunk"
387− let src = _thunkPtr_source ptr
448+ let src = _thunkPtr_source ptr
388− rev <- getLatestRev src
449+ rev <- getLatestRev src
389− overwriteThunk overwrite $ ThunkPtr
450+ overwriteThunk overwrite $ modifyThunkPtrByConfig thunkConfig $ ThunkPtr
390− { _thunkPtr_source = src
451+ { _thunkPtr_source = src
391− , _thunkPtr_rev = rev
452+ , _thunkPtr_rev = rev
392− }
453+ }
454+ Just branch -> readThunk target >>= \case
455+ Left err -> failWith [i|Thunk update: ${err}|]
456+ Right c -> case c of
457+ ThunkData_Packed _ t -> setThunk thunkConfig target (thunkSourceToGitSource $ _thunkPtr_source t) branch
458+ ThunkData_Checkout -> failWith [i|Thunk located at ${target} is unpacked. Use 'ob thunk pack' on the desired directory and then try 'ob thunk update' again.|]
459+ where
460+ spinner = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest")
461+
462+setThunk :: MonadObelisk m => ThunkConfig -> FilePath -> GitSource -> String -> m ()
463+setThunk thunkConfig target gs branch = do
464+ newThunkPtr <- uriThunkPtr (_gitSource_url gs) (_thunkConfig_private thunkConfig) (Just $ T.pack branch) Nothing
465+ overwriteThunk target newThunkPtr
466+ updateThunkToLatest (ThunkUpdateConfig Nothing thunkConfig) target
393
467
394-- | All recognized github standalone loaders, ordered from newest to oldest.
468-- | All recognized github standalone loaders, ordered from newest to oldest.
395-- 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.
396−gitHubStandaloneLoaders :: NonEmpty Text
470+gitHubThunkSpecs :: NonEmpty ThunkSpec
397−gitHubStandaloneLoaders =
471+gitHubThunkSpecs =
398− gitHubStandaloneLoaderV2 :|
472+ gitHubThunkSpecV5 :|
399− [ gitHubStandaloneLoaderV3
473+ [ gitHubThunkSpecV4
400− , gitHubStandaloneLoaderV1
474+ , gitHubThunkSpecV3
475+ , gitHubThunkSpecV2
476+ , gitHubThunkSpecV1
401 ]
477 ]
402
478
403−gitHubStandaloneLoaderV1 :: Text
479+gitHubThunkSpecV1 :: ThunkSpec
404−gitHubStandaloneLoaderV1 = T.unlines
480+gitHubThunkSpecV1 = legacyGitHubThunkSpec "github-v1"
405− [ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
481+ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
406− ]
407
482
408−gitHubStandaloneLoaderV2 :: Text
483+gitHubThunkSpecV2 :: ThunkSpec
409−gitHubStandaloneLoaderV2 = T.unlines
484+gitHubThunkSpecV2 = legacyGitHubThunkSpec "github-v2" $ T.unlines
410 [ "# 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.
411 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
486 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
412 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
487 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
@@ -416,8 +491,8 @@ gitHubStandaloneLoaderV2 = T.unlines
416 , "))"
491 , "))"
417 ]
492 ]
418
493
419−gitHubStandaloneLoaderV3 :: Text
494+gitHubThunkSpecV3 :: ThunkSpec
420−gitHubStandaloneLoaderV3 = T.unlines
495+gitHubThunkSpecV3 = legacyGitHubThunkSpec "github-v3" $ T.unlines
421 [ "# DO NOT HAND-EDIT THIS FILE"
496 [ "# DO NOT HAND-EDIT THIS FILE"
422 , "let"
497 , "let"
423 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
498 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
@@ -436,22 +511,62 @@ gitHubStandaloneLoaderV3 = T.unlines
436 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
511 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
437 ]
512 ]
438
513
439−plainGitStandaloneLoaders :: NonEmpty Text
514+gitHubThunkSpecV4 :: ThunkSpec
440−plainGitStandaloneLoaders =
515+gitHubThunkSpecV4 = legacyGitHubThunkSpec "github-v4" $ T.unlines
441− plainGitStandaloneLoaderV1 :|
516+ [ "# DO NOT HAND-EDIT THIS FILE"
442− [ 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)
443 ]
532 ]
444
533
445−plainGitStandaloneLoaderV1 :: Text
534+gitHubThunkSpecV5 :: ThunkSpec
446−plainGitStandaloneLoaderV1 = T.unlines
535+gitHubThunkSpecV5 = mkThunkSpec "github-v5" "github.json" parseGitHubJsonBytes [here|
536+# DO NOT HAND-EDIT THIS FILE
537+let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
538+ if !fetchSubmodules && !private then builtins.fetchTarball {
539+ url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
540+ } else (import <nixpkgs> {}).fetchFromGitHub {
541+ inherit owner repo rev sha256 fetchSubmodules private;
542+ };
543+ json = builtins.fromJSON (builtins.readFile ./github.json);
544+in fetch json
545+|]
546+
547+parseGitHubJsonBytes :: LBS.ByteString -> Either String ThunkPtr
548+parseGitHubJsonBytes = parseJsonObject $ parseThunkPtr $ \v ->
549+ ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
550+
551+gitThunkSpecs :: NonEmpty ThunkSpec
552+gitThunkSpecs =
553+ gitThunkSpecV5 :|
554+ [ gitThunkSpecV4
555+ , gitThunkSpecV3
556+ , gitThunkSpecV2
557+ , gitThunkSpecV1
558+ ]
559+
560+gitThunkSpecV1 :: ThunkSpec
561+gitThunkSpecV1 = legacyGitThunkSpec "git-v1" $ T.unlines
447 [ "# DO NOT HAND-EDIT THIS FILE"
562 [ "# DO NOT HAND-EDIT THIS FILE"
448 , "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}:"
449 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
564 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
450 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
565 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
451 ]
566 ]
452
567
453−plainGitStandaloneLoaderV2 :: Text
568+gitThunkSpecV2 :: ThunkSpec
454−plainGitStandaloneLoaderV2 = T.unlines
569+gitThunkSpecV2 = legacyGitThunkSpec "git-v2" $ T.unlines
455 [ "# DO NOT HAND-EDIT THIS FILE"
570 [ "# DO NOT HAND-EDIT THIS FILE"
456 , "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}:"
457 , " if builtins.hasAttr \"fetchGit\" builtins"
572 , " if builtins.hasAttr \"fetchGit\" builtins"
@@ -460,10 +575,87 @@ plainGitStandaloneLoaderV2 = T.unlines
460 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
575 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
461 ]
576 ]
462
577
463−thunkFileNames :: [FilePath]
578+-- This loader has a bug because @builtins.fetchGit@ is not given a @ref@
464−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+ ]
465
595
466−--TODO: when checking something out, make a shallow clone
596+gitThunkSpecV4 :: ThunkSpec
597+gitThunkSpecV4 = legacyGitThunkSpec "git-v4" $ T.unlines
598+ [ "# DO NOT HAND-EDIT THIS FILE"
599+ , "let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
600+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
601+ , " if firstChar == \"/\" then /. + url"
602+ , " else if firstChar == \".\" then ./. + url"
603+ , " else url;"
604+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
605+ , " url = realUrl; inherit rev;"
606+ , " ${if branch == null then null else \"ref\"} = branch;"
607+ , " } else (import <nixpkgs> {}).fetchgit {"
608+ , " url = realUrl; inherit rev sha256;"
609+ , " };"
610+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
611+ ]
612+
613+legacyGitThunkSpec :: Text -> Text -> ThunkSpec
614+legacyGitThunkSpec name loader = ThunkSpec name $ Map.fromList
615+ [ ("default.nix", ThunkFileSpec_FileMatches $ T.strip loader)
616+ , ("git.json" , ThunkFileSpec_Ptr parseGitJsonBytes)
617+ , (attrCacheFileName, ThunkFileSpec_AttrCache)
618+ , (".git", ThunkFileSpec_CheckoutIndicator)
619+ ]
620+
621+gitThunkSpecV5 :: ThunkSpec
622+gitThunkSpecV5 = mkThunkSpec "git-v5" "git.json" parseGitJsonBytes [here|
623+# DO NOT HAND-EDIT THIS FILE
624+let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:
625+ let realUrl = let firstChar = builtins.substring 0 1 url; in
626+ if firstChar == "/" then /. + url
627+ else if firstChar == "." then ./. + url
628+ else url;
629+ in if !fetchSubmodules && private then builtins.fetchGit {
630+ url = realUrl; inherit rev;
631+ ${if branch == null then null else "ref"} = branch;
632+ } else (import <nixpkgs> {}).fetchgit {
633+ url = realUrl; inherit rev sha256;
634+ };
635+ json = builtins.fromJSON (builtins.readFile ./git.json);
636+in fetch json
637+|]
638+
639+parseGitJsonBytes :: LBS.ByteString -> Either String ThunkPtr
640+parseGitJsonBytes = parseJsonObject $ parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
641+
642+mkThunkSpec :: Text -> FilePath -> (LBS.ByteString -> Either String ThunkPtr) -> Text -> ThunkSpec
643+mkThunkSpec name jsonFileName parser srcNix = ThunkSpec name $ Map.fromList
644+ [ ("default.nix", ThunkFileSpec_FileMatches defaultNixViaSrc)
645+ , ("thunk.nix", ThunkFileSpec_FileMatches srcNix)
646+ , (jsonFileName, ThunkFileSpec_Ptr parser)
647+ , (attrCacheFileName, ThunkFileSpec_AttrCache)
648+ , (normalise $ unpackedDirName </> ".git", ThunkFileSpec_CheckoutIndicator)
649+ ]
650+ where
651+ defaultNixViaSrc = [here|
652+# DO NOT HAND-EDIT THIS FILE
653+import (import ./thunk.nix)
654+|]
655+
656+
657+parseJsonObject :: (Aeson.Object -> Aeson.Parser a) -> LBS.ByteString -> Either String a
658+parseJsonObject p bytes = Aeson.parseEither p =<< Aeson.eitherDecode bytes
467
659
468-- | 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
469-- to the result of building an attribute of a thunk.
661-- to the result of building an attribute of a thunk.
@@ -471,44 +663,49 @@ thunkFileNames = ["default.nix", "github.json", "git.json"]
471-- and the result is symlinked into the cache.
663-- and the result is symlinked into the cache.
472nixBuildThunkAttrWithCache
664nixBuildThunkAttrWithCache
473 :: MonadObelisk m
665 :: MonadObelisk m
666+ => ThunkSpec
474− => FilePath
667+ -> FilePath
475 -- ^ Path to directory containing Thunk
668 -- ^ Path to directory containing Thunk
476 -> String
669 -> String
477 -- ^ Attribute to build
670 -- ^ Attribute to build
478− -> m FilePath
671+ -> m (Maybe FilePath)
479 -- ^ Symlink to cached or built nix output
672 -- ^ Symlink to cached or built nix output
480-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
673-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
481-- the caching mechanism will fail as it merely measures the modification
674-- the caching mechanism will fail as it merely measures the modification
482-- time of the cache link and the expression to build.
675-- time of the cache link and the expression to build.
483−nixBuildThunkAttrWithCache thunkDir attr = do
676+nixBuildThunkAttrWithCache thunkSpec thunkDir attr = do
484− --NB: Expects thunkDir to be normalised with no trailing path separator.
485− --This should be guaranteed by the command argument parser.
486− let cacheErrHandler e
487− | isDoesNotExistError e = return Nothing -- expected from a cache miss
488− | otherwise = putLog Error (T.pack $ displayException e) >> return Nothing
489− cacheDir = thunkDir </> ".attr-cache"
490− cachePath = cacheDir </> attr <.> "out"
491 latestChange <- liftIO $ do
677 latestChange <- liftIO $ do
492− createDirectoryIfMissing False cacheDir
678+ let
493− let getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
679+ getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
680+ thunkFileNames = Map.keys $ _thunkSpec_files thunkSpec
494− 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)
495− cacheHit <- handle cacheErrHandler $ do
692+ cacheHit <- handle cacheErrHandler $ do
496− cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
693+ cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
497− return $ if latestChange <= cacheTime
694+ pure $ if latestChange <= cacheTime
498− then Just cachePath
695+ then Just cachePath
499− else Nothing
696+ else Nothing
500− case cacheHit of
697+ case cacheHit of
501− Just c -> return c
698+ Just c -> pure c
502− Nothing -> do
699+ Nothing -> do
503− putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
700+ putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
504− _ <- nixBuild $ def
701+ liftIO $ createDirectoryIfMissing True (takeDirectory cachePath)
505− { _nixBuildConfig_target = Target
702+ (cachePath <$) $ nixCmd $ NixCmd_Build $ def
703+ & nixBuildConfig_outLink .~ OutLink_IndirectRoot cachePath
704+ & nixCmdConfig_target .~ Target
506− { _target_path = thunkDir
705+ { _target_path = Just thunkDir
507− , _target_attr = Just attr
706+ , _target_attr = Just attr
508− }
707+ , _target_expr = Nothing
509− , _nixBuildConfig_outLink = OutLink_IndirectRoot cachePath
510− }
708+ }
511− return cachePath
512
709
513-- | Build a nix attribute, and cache the result if possible
710-- | Build a nix attribute, and cache the result if possible
514nixBuildAttrWithCache
711nixBuildAttrWithCache
@@ -519,17 +716,19 @@ nixBuildAttrWithCache
519 -- ^ Attribute to build
716 -- ^ Attribute to build
520 -> m FilePath
717 -> m FilePath
521 -- ^ Symlink to cached or built nix output
718 -- ^ Symlink to cached or built nix output
522−nixBuildAttrWithCache exprPath attr = do
719+nixBuildAttrWithCache exprPath attr = readThunk exprPath >>= \case
523− readThunk exprPath >>= \case
524− -- 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 _) ->
525− Right (ThunkData_Packed _) -> nixBuildThunkAttrWithCache exprPath attr
722+ maybe build pure =<< nixBuildThunkAttrWithCache spec exprPath attr
526− _ -> nixBuild $ def
723+ _ -> build
527− { _nixBuildConfig_target = Target
724+ where
725+ build = nixCmd $ NixCmd_Build $ def
726+ & nixBuildConfig_outLink .~ OutLink_None
727+ & nixCmdConfig_target .~ Target
528− { _target_path = exprPath
728+ { _target_path = Just exprPath
529 , _target_attr = Just attr
729 , _target_attr = Just attr
730+ , _target_expr = Nothing
530 }
731 }
531− , _nixBuildConfig_outLink = OutLink_None
532− }
533
732
534-- | Safely update thunk using a custom action
733-- | Safely update thunk using a custom action
535--
734--
@@ -546,93 +745,153 @@ updateThunk p f = withSystemTempDirectory "obelisk-thunkptr-" $ \tmpDir -> do
546 where
745 where
547 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
746 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
548 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
747 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
549− Right (ThunkData_Packed _) -> do
748+ Right ThunkData_Packed{} -> do
550 let tmpThunk = tmpDir </> "thunk"
749 let tmpThunk = tmpDir </> "thunk"
551 callProcessAndLogOutput (Notice, Error) $
750 callProcessAndLogOutput (Notice, Error) $
552− proc "cp" ["-r", "-T", thunkDir, tmpThunk]
751+ proc cp ["-r", "-T", thunkDir, tmpThunk]
553 return tmpThunk
752 return tmpThunk
554− Right _ -> failWith $ "Thunk is not packed"
753+ Right _ -> failWith "Thunk is not packed"
555 updateThunkFromTmp p' = do
754 updateThunkFromTmp p' = do
556− packThunk' True p'
755+ _ <- packThunk' True (ThunkPackConfig False (ThunkConfig Nothing)) p'
557 callProcessAndLogOutput (Notice, Error) $
756 callProcessAndLogOutput (Notice, Error) $
558− proc "cp" ["-r", "-T", p', p]
757+ proc cp ["-r", "-T", p', p]
559
758
560finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
759finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
561finalMsg noTrail s = if noTrail then Nothing else Just s
760finalMsg noTrail s = if noTrail then Nothing else Just s
562
761
762+-- | Check that we are not somewhere inside the thunk directory
763+checkThunkDirectory :: MonadObelisk m => FilePath -> m ()
764+checkThunkDirectory thunkDir = do
765+ currentDir <- liftIO getCurrentDirectory
766+ thunkDir' <- liftIO $ canonicalizePath thunkDir
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+
563unpackThunk :: MonadObelisk m => FilePath -> m ()
776unpackThunk :: MonadObelisk m => FilePath -> m ()
564unpackThunk = unpackThunk' False
777unpackThunk = unpackThunk' False
565
778
566unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
779unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
567−unpackThunk' noTrail thunkDir = readThunk thunkDir >>= \case
780+unpackThunk' noTrail thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
568− Left err -> failWith $ "thunk unpack: " <> T.pack (show err)
781+ Left err -> failWith [i|Invalid thunk at ${thunkDir}: ${err}|]
569 --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
570− Right (ThunkData_Checkout _) -> failWith "thunk unpack: thunk is already unpacked"
783+ Right ThunkData_Checkout -> failWith [i|Thunk at ${thunkDir} is already unpacked|]
571− Right (ThunkData_Packed tptr) -> do
784+ Right (ThunkData_Packed _ tptr) -> do
572 let (thunkParent, thunkName) = splitFileName thunkDir
785 let (thunkParent, thunkName) = splitFileName thunkDir
573− withTempDirectory thunkParent thunkName $ \tmpRepo -> do
786+ withTempDirectory thunkParent thunkName $ \tmpThunk -> do
574− let obGitDir = tmpRepo </> ".git" </> "obelisk"
787+ let
788+ gitSrc = thunkSourceToGitSource $ _thunkPtr_source tptr
575− s = case _thunkPtr_source tptr of
789+ newSpec = case _thunkPtr_source tptr of
576− ThunkSource_GitHub s' -> forgetGithub False s'
790+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
577− ThunkSource_Git s' -> s'
791+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
578 withSpinner' ("Fetching thunk " <> T.pack thunkName)
792 withSpinner' ("Fetching thunk " <> T.pack thunkName)
579 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
793 (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
580− let git = callProcessAndLogOutput (Notice, Notice) . gitProc tmpRepo
794+ let unpackedPath = tmpThunk </> unpackedDirName
581− git $ [ "clone" ]
795+ gitCloneForThunkUnpack gitSrc (_thunkRev_commit $ _thunkPtr_rev tptr) unpackedPath
582− ++ ("--recursive" <$ guard (_gitSource_fetchSubmodules s))
796+
583− ++ [ T.unpack $ render $ _gitSource_url s ]
797+ let normalizeMore = dropTrailingPathSeparator . normalise
584− git ["reset", "--hard", Ref.toHexString $ _thunkRev_commit $ _thunkPtr_rev tptr]
798+ when (normalizeMore unpackedPath /= normalizeMore tmpThunk) $ -- Only write meta data if the checkout is not inplace
585− when (_gitSource_fetchSubmodules s) $
799+ createThunk tmpThunk $ Left newSpec
586− git ["submodule", "update", "--recursive", "--init"]
800+
587− case _gitSource_branch s of
801+ liftIO $ do
588− Just b -> git ["branch", "-u", "origin/" <> T.unpack (untagName $ b)]
802+ removePathForcibly thunkDir
589− Nothing -> pure ()
803+ renameDirectory tmpThunk thunkDir
590−
804+
591− liftIO $ createDirectory obGitDir
805+gitCloneForThunkUnpack
592− callProcessAndLogOutput (Notice, Error) $
806+ :: MonadObelisk m
593− proc "cp" ["-r", "-T", thunkDir </> ".", obGitDir </> "orig-thunk"]
807+ => GitSource -- ^ Git source to use
594− callProcessAndLogOutput (Notice, Error) $
808+ -> Ref hash -- ^ Commit hash to reset to
595− proc "rm" ["-r", thunkDir]
809+ -> FilePath -- ^ Directory to clone into
596− callProcessAndLogOutput (Notice, Error) $
810+ -> m ()
597− proc "mv" ["-T", tmpRepo, thunkDir]
811+gitCloneForThunkUnpack gitSrc commit dir = do
812+ let git = callProcessAndLogOutput (Notice, Notice) . gitProc dir
813+ git $ [ "clone" ]
814+ ++ ["--recursive" | _gitSource_fetchSubmodules gitSrc]
815+ ++ [ T.unpack $ gitUriToText $ _gitSource_url gitSrc ]
816+ ++ do branch <- maybeToList $ _gitSource_branch gitSrc
817+ [ "--branch", T.unpack $ untagName branch ]
818+ git ["reset", "--hard", Ref.toHexString commit]
819+ when (_gitSource_fetchSubmodules gitSrc) $
820+ git ["submodule", "update", "--recursive", "--init"]
598
821
599−--TODO: add force mode to pack even if changes are present
600--TODO: add a rollback mode to pack to the original thunk
822--TODO: add a rollback mode to pack to the original thunk
601−packThunk :: MonadObelisk m => FilePath -> m ()
823+packThunk :: MonadObelisk m => ThunkPackConfig -> FilePath -> m ThunkPtr
602packThunk = packThunk' False
824packThunk = packThunk' False
603
825
604−packThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
826+packThunk' :: MonadObelisk m => Bool -> ThunkPackConfig -> FilePath -> m ThunkPtr
605−packThunk' noTrail thunkDir = readThunk thunkDir >>= \case
827+packThunk' noTrail (ThunkPackConfig force thunkConfig) thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
606− Left err -> failWith $ T.pack $ "thunk pack: " <> show err
828+ Right ThunkData_Packed{} -> failWith [i|Thunk at ${thunkDir} is is already packed|]
607− Right (ThunkData_Packed _) -> failWith "pack: thunk is already packed"
829+ _ -> withSpinner'
608− Right (ThunkData_Checkout _) -> do
830+ ("Packing thunk " <> T.pack thunkDir)
609− withSpinner' ("Packing thunk " <> T.pack thunkDir)
831+ (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $
610− (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $ do
832+ do
611− thunkPtr <- getThunkPtr thunkDir
833+ let checkClean = if force then CheckClean_NoCheck else CheckClean_FullCheck
612− callProcessAndLogOutput (Debug, Error) $ proc "rm" ["-rf", thunkDir]
834+ thunkPtr <- modifyThunkPtrByConfig thunkConfig <$> getThunkPtr checkClean thunkDir (_thunkConfig_private thunkConfig)
613− liftIO $ createThunk thunkDir thunkPtr
835+ liftIO $ removePathForcibly thunkDir
614−
836+ createThunk thunkDir $ Right thunkPtr
615−getThunkPtr :: MonadObelisk m => FilePath -> m ThunkPtr
837+ pure thunkPtr
616−getThunkPtr = getThunkPtr' True
838+
617−
839+modifyThunkPtrByConfig :: ThunkConfig -> ThunkPtr -> ThunkPtr
618−getThunkPtr' :: forall m. MonadObelisk m => Bool -> FilePath -> m ThunkPtr
840+modifyThunkPtrByConfig (ThunkConfig markPrivate') ptr = case markPrivate' of
619−getThunkPtr' checkClean thunkDir = do
841+ Nothing -> ptr
620− when checkClean $ ensureCleanGitRepo thunkDir True $
842+ Just markPrivate -> ptr { _thunkPtr_source = case _thunkPtr_source ptr of
843+ ThunkSource_Git s -> ThunkSource_Git $ s { _gitSource_private = markPrivate }
844+ ThunkSource_GitHub s -> ThunkSource_GitHub $ s { _gitHubSource_private = markPrivate }
845+ }
846+
847+data CheckClean
848+ = CheckClean_FullCheck
849+ -- ^ Check that the repo is clean, including .gitignored files
850+ | CheckClean_NotIgnored
851+ -- ^ Check that the repo is clean, not including .gitignored files
852+ | CheckClean_NoCheck
853+ -- ^ Don't check that the repo is clean
854+
855+getThunkPtr :: forall m. MonadObelisk m => CheckClean -> FilePath -> Maybe Bool -> m ThunkPtr
856+getThunkPtr gitCheckClean dir mPrivate = do
857+ let repoLocations = nubOrd $ map (first normalise)
858+ [(".git", "."), (unpackedDirName </> ".git", unpackedDirName)]
859+ repoLocation' <- liftIO $ flip findM repoLocations $ doesDirectoryExist . (dir </>) . fst
860+ thunkDir <- case repoLocation' of
861+ Nothing -> failWith [i|Can't find an unpacked thunk in ${dir}|]
862+ Just (_, path) -> pure $ normalise $ dir </> path
863+
864+ let (checkClean, checkIgnored) = case gitCheckClean of
865+ CheckClean_FullCheck -> (True, True)
866+ CheckClean_NotIgnored -> (True, False)
867+ CheckClean_NoCheck -> (False, False)
868+ when checkClean $ ensureCleanGitRepo thunkDir checkIgnored
621 "thunk pack: thunk checkout contains unsaved modifications"
869 "thunk pack: thunk checkout contains unsaved modifications"
622
870
623 -- Check whether there are any stashes
871 -- Check whether there are any stashes
624− stashOutput <- readGitProcess thunkDir ["stash", "list"]
872+ when checkClean $ do
625− when checkClean $ case T.null stashOutput of
873+ stashOutput <- readGitProcess thunkDir ["stash", "list"]
626− False -> do
874+ unless (T.null stashOutput) $
627 failWith $ T.unlines $
875 failWith $ T.unlines $
628 [ "thunk pack: thunk checkout has stashes"
876 [ "thunk pack: thunk checkout has stashes"
629 , "git stash list:"
877 , "git stash list:"
630 ] ++ T.lines stashOutput
878 ] ++ T.lines stashOutput
631− True -> return ()
879+
880+ -- Get current branch
881+ (mCurrentBranch, mCurrentCommit) <- do
882+ b <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
883+ c <- listToMaybe . T.lines <$> readGitProcess thunkDir ["rev-parse", "HEAD"]
884+ case b of
885+ (Just "HEAD") -> failWith $ T.unlines
886+ [ "thunk pack: You are in 'detached HEAD' state."
887+ , "If you want to pack at the current ref \
888+ \then please create a new branch with 'git checkout -b <new-branch-name>' and push this upstream."
889+ ]
890+ _ -> return (b, c)
632
891
633 -- Get information on all branches and their (optional) designated upstream
892 -- Get information on all branches and their (optional) designated upstream
634 -- correspondents
893 -- correspondents
635− (headDump :: [Text]) <- T.lines <$> readGitProcess thunkDir
894+ headDump :: [Text] <- T.lines <$> readGitProcess thunkDir
636 [ "for-each-ref"
895 [ "for-each-ref"
637 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
896 , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
638 , "refs/heads/"
897 , "refs/heads/"
@@ -662,7 +921,7 @@ getThunkPtr' checkClean thunkDir = do
662 let untrackedBranches = Map.keys errorMap
921 let untrackedBranches = Map.keys errorMap
663 when (not $ L.null untrackedBranches) $ failWith $ T.unlines $
922 when (not $ L.null untrackedBranches) $ failWith $ T.unlines $
664 [ "thunk pack: Certain branches in the thunk have no upstream branch \
923 [ "thunk pack: Certain branches in the thunk have no upstream branch \
665− \set. This means don't know to check whether all your work is \
924+ \set. This means we don't know to check whether all your work is \
666 \saved. The offending branches are:"
925 \saved. The offending branches are:"
667 , ""
926 , ""
668 , T.unwords untrackedBranches
927 , T.unwords untrackedBranches
@@ -678,7 +937,7 @@ getThunkPtr' checkClean thunkDir = do
678 ]
937 ]
679
938
680 -- 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
681− stats <- iforM headUpstream $ \branch (upstream, _remote) -> do
940+ stats <- ifor headUpstream $ \branch (upstream, _remote) -> do
682 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
941 (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
683 [ "rev-list", "--left-right"
942 [ "rev-list", "--left-right"
684 , T.unpack branch <> "..." <> T.unpack upstream
943 , T.unpack branch <> "..." <> T.unpack upstream
@@ -695,20 +954,16 @@ getThunkPtr' checkClean thunkDir = do
695 [ "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:"
696 , ""
955 , ""
697 ] ++
956 ] ++
698− (flip map (Map.toList nonGood) $ \(branch, (upstream, (ahead, behind))) -> mconcat
957+ flip map (Map.toList nonGood) (\(branch, (upstream, (ahead, behind))) -> mconcat
699 [" ", 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]) ++
700 [ ""
959 [ ""
701 , "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 \
702 \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.)"
703 ]
962 ]
704
963
705− -- We assume it's safe to pack the thunk at this point
964+ when checkClean $ do
706− putLog Informational $ "All changes safe in git remotes. OK to pack thunk."
965+ -- We assume it's safe to pack the thunk at this point
707−
966+ putLog Informational "All changes safe in git remotes. OK to pack thunk."
708− -- Get current branch ``
709− mCurrentBranch <- listToMaybe
710− <$> T.lines
711− <$> readGitProcess thunkDir ["rev-parse", "--abbrev-ref", "HEAD"]
712
967
713 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
968 let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
714
969
@@ -721,14 +976,12 @@ getThunkPtr' checkClean thunkDir = do
721 remoteUri <- case parseGitUri remoteUri' of
976 remoteUri <- case parseGitUri remoteUri' of
722 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
977 Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
723 Just uri -> pure uri
978 Just uri -> pure uri
724− uriThunkPtr remoteUri mCurrentBranch
979+ uriThunkPtr remoteUri mPrivate mCurrentBranch mCurrentCommit
725
980
726-- | Get the latest revision available from the given source
981-- | Get the latest revision available from the given source
727getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
982getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
728getLatestRev os = do
983getLatestRev os = do
729− let gitS = case os of
984+ let gitS = thunkSourceToGitSource os
730− ThunkSource_GitHub s -> forgetGithub False s
731− ThunkSource_Git s -> s
732 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
985 (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
733 case os of
986 case os of
734 ThunkSource_GitHub s -> githubThunkRev s commit
987 ThunkSource_GitHub s -> githubThunkRev s commit
@@ -740,18 +993,20 @@ getLatestRev os = do
740-- 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
741-- 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
742-- a regular git thunk.
995-- a regular git thunk.
743−uriThunkPtr :: MonadObelisk m => URI -> Maybe Text -> m ThunkPtr
996+uriThunkPtr :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr
744−uriThunkPtr uri mbranch = do
997+uriThunkPtr uri mPrivate mbranch mcommit = do
745− (_, commit) <- gitGetCommitBranch uri mbranch
998+ commit <- case mcommit of
746− (src, rev) <- case uriToThunkSource uri mbranch of
999+ Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
1000+ (Just c) -> return c
1001+ (src, rev) <- uriToThunkSource uri mPrivate mbranch >>= \case
747 ThunkSource_GitHub s -> do
1002 ThunkSource_GitHub s -> do
748 rev <- runExceptT $ githubThunkRev s commit
1003 rev <- runExceptT $ githubThunkRev s commit
749 case rev of
1004 case rev of
750 Right r -> pure (ThunkSource_GitHub s, r)
1005 Right r -> pure (ThunkSource_GitHub s, r)
751 Left e -> do
1006 Left e -> do
752− putLog Warning $ "\
1007+ putLog Warning "\
753\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. \
754−\Falling back on normal fetchgit. Original failure:\n\n"
1009+\Falling back on normal fetchgit. Original failure:"
755 errorToWarning e
1010 errorToWarning e
756 let s' = forgetGithub True s
1011 let s' = forgetGithub True s
757 (,) (ThunkSource_Git s') <$> gitThunkRev s' commit
1012 (,) (ThunkSource_Git s') <$> gitThunkRev s' commit
@@ -766,34 +1021,66 @@ uriThunkPtr uri mbranch = do
766-- 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
767-- `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
768-- should be employed, and so we respect that.
1023-- should be employed, and so we respect that.
769−uriToThunkSource :: URI -> Maybe Text -> ThunkSource
1024+uriToThunkSource :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> m ThunkSource
770−uriToThunkSource u
1025+uriToThunkSource (GitUri u) mPrivate
771− | Right uriAuth <- uriAuthority u
1026+ | Right uriAuth <- URI.uriAuthority u
772− , Just scheme <- unRText <$> uriScheme u
1027+ , Just scheme <- URI.unRText <$> URI.uriScheme u
773 , case scheme of
1028 , case scheme of
774− "ssh" -> uriAuth == Authority
1029+ "ssh" -> uriAuth == URI.Authority
775− { authUserInfo = Just $ UserInfo (fromRight' $ mkUsername "git") Nothing
1030+ { URI.authUserInfo = Just $ URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
776− , authHost = fromRight' $ mkHost "github.com"
1031+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
777− , authPort = Nothing
1032+ , URI.authPort = Nothing
778 }
1033 }
779 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:"
780− && unRText (authHost uriAuth) == "github.com"
1035+ && URI.unRText (URI.authHost uriAuth) == "github.com"
781− , Just (_, owner :| [repoish]) <- uriPath u
1036+ , Just (_, owner :| [repoish]) <- URI.uriPath u
782− = \mbranch -> ThunkSource_GitHub $ GitHubSource
1037+ = \mbranch -> do
783− { _gitHubSource_owner = N $ unRText owner
1038+ isPrivate <- getIsPrivate
784− , _gitHubSource_repo = N $ let
1039+ pure $ ThunkSource_GitHub $ GitHubSource
785− repoish' = unRText repoish
1040+ { _gitHubSource_owner = N $ URI.unRText owner
786− in case T.stripSuffix ".git" repoish' of
1041+ , _gitHubSource_repo = N $ let
787− Just repo -> repo
1042+ repoish' = URI.unRText repoish
788− Nothing -> repoish'
1043+ in fromMaybe repoish' $ T.stripSuffix ".git" repoish'
789− , _gitHubSource_branch = N <$> mbranch
1044+ , _gitHubSource_branch = N <$> mbranch
790− }
1045+ , _gitHubSource_private = isPrivate
1046+ }
791
1047
792− | otherwise = \mbranch -> ThunkSource_Git $ GitSource
1048+ | otherwise = \mbranch -> do
793− { _gitSource_url = u
1049+ isPrivate <- getIsPrivate
794− , _gitSource_branch = N <$> mbranch
1050+ pure $ ThunkSource_Git $ GitSource
795− , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
1051+ { _gitSource_url = GitUri u
796− }
1052+ , _gitSource_branch = N <$> mbranch
1053+ , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
1054+ , _gitSource_private = isPrivate
1055+ }
1056+ where
1057+ getIsPrivate = maybe (guessGitRepoIsPrivate $ GitUri u) pure mPrivate
1058+
1059+guessGitRepoIsPrivate :: MonadObelisk m => GitUri -> m Bool
1060+guessGitRepoIsPrivate uri = flip fix urisToTry $ \loop -> \case
1061+ [] -> pure True
1062+ uriAttempt:xs -> do
1063+ result <- readCreateProcessWithExitCode $
1064+ isolateGitProc $
1065+ gitProcNoRepo
1066+ [ "ls-remote"
1067+ , "--quiet"
1068+ , "--exit-code"
1069+ , "--symref"
1070+ , T.unpack $ gitUriToText uriAttempt
1071+ ]
1072+ case result of
1073+ (ExitSuccess, _, _) -> pure False -- Must be a public repo
1074+ _ -> loop xs
1075+ where
1076+ urisToTry = nubOrd $
1077+ -- Include the original URI if it isn't using SSH because SSH will certainly fail.
1078+ [uri | fmap URI.unRText (URI.uriScheme (unGitUri uri)) /= Just "ssh"] <>
1079+ [changeScheme "https" uri, changeScheme "http" uri]
1080+ changeScheme scheme (GitUri u) = GitUri $ u
1081+ { URI.uriScheme = URI.mkScheme scheme
1082+ , URI.uriAuthority = (\x -> x { URI.authUserInfo = Nothing }) <$> URI.uriAuthority u
1083+ }
797
1084
798-- Funny signature indicates no effects depend on the optional branch name.
1085-- Funny signature indicates no effects depend on the optional branch name.
799githubThunkRev
1086githubThunkRev
@@ -805,19 +1092,19 @@ githubThunkRev
805githubThunkRev s commit = do
1092githubThunkRev s commit = do
806 owner <- forcePP $ _gitHubSource_owner s
1093 owner <- forcePP $ _gitHubSource_owner s
807 repo <- forcePP $ _gitHubSource_repo s
1094 repo <- forcePP $ _gitHubSource_repo s
808− revTarball <- mkPathPiece $ commit <> ".tar.gz"
1095+ revTarball <- URI.mkPathPiece $ commit <> ".tar.gz"
809− let archiveUri = URI
1096+ let archiveUri = GitUri $ URI.URI
810− { uriScheme = Just $ fromRight' $ mkScheme "https"
1097+ { URI.uriScheme = Just $ fromRight' $ URI.mkScheme "https"
811− , uriAuthority = Right $ Authority
1098+ , URI.uriAuthority = Right $ URI.Authority
812− { authUserInfo = Nothing
1099+ { URI.authUserInfo = Nothing
813− , authHost = fromRight' $ mkHost "github.com"
1100+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
814− , authPort = Nothing
1101+ , URI.authPort = Nothing
815 }
1102 }
816− , uriPath = Just ( False
1103+ , URI.uriPath = Just ( False
817− , owner :| [ repo, fromRight' $ mkPathPiece "archive", revTarball ]
1104+ , owner :| [ repo, fromRight' $ URI.mkPathPiece "archive", revTarball ]
818 )
1105 )
819− , uriQuery = []
1106+ , URI.uriQuery = []
820− , uriFragment = Nothing
1107+ , URI.uriFragment = Nothing
821 }
1108 }
822 hash <- getNixSha256ForUriUnpacked archiveUri
1109 hash <- getNixSha256ForUriUnpacked archiveUri
823 putLog Debug $ "Nix sha256 is " <> hash
1110 putLog Debug $ "Nix sha256 is " <> hash
@@ -826,8 +1113,8 @@ githubThunkRev s commit = do
826 , _thunkRev_nixSha256 = hash
1113 , _thunkRev_nixSha256 = hash
827 }
1114 }
828 where
1115 where
829− forcePP :: Name entity -> m (RText 'PathPiece)
1116+ forcePP :: Name entity -> m (URI.RText 'URI.PathPiece)
830− forcePP = mkPathPiece . untagName
1117+ forcePP = URI.mkPathPiece . untagName
831
1118
832gitThunkRev
1119gitThunkRev
833 :: MonadObelisk m
1120 :: MonadObelisk m
@@ -836,11 +1123,11 @@ gitThunkRev
836 -> m ThunkRev
1123 -> m ThunkRev
837gitThunkRev s commit = do
1124gitThunkRev s commit = do
838 let u = _gitSource_url s
1125 let u = _gitSource_url s
839− protocols = ["https", "ssh", "git"]
1126+ protocols = ["file", "https", "ssh", "git"]
840− Just scheme <- pure $ unRText <$> uriScheme u
1127+ scheme = maybe "file" URI.unRText $ URI.uriScheme $ (\(GitUri x) -> x) u
841 unless (T.toLower scheme `elem` protocols) $
1128 unless (T.toLower scheme `elem` protocols) $
842 failWith $ "obelisk currently only supports "
1129 failWith $ "obelisk currently only supports "
843− <> T.intercalate ", " protocols <> " protocols for non-GitHub remotes"
1130+ <> T.intercalate ", " protocols <> " protocols for plain Git remotes"
844 hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
1131 hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
845 putLog Informational $ "Nix sha256 is " <> hash
1132 putLog Informational $ "Nix sha256 is " <> hash
846 pure $ ThunkRev
1133 pure $ ThunkRev
@@ -853,12 +1140,14 @@ gitThunkRev s commit = do
853--
1140--
854-- 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
855-- passed it, the default branch of the repo is used instead.
1142-- passed it, the default branch of the repo is used instead.
1143+
856gitGetCommitBranch
1144gitGetCommitBranch
857− :: MonadObelisk m => URI -> Maybe Text -> m (Text, CommitId)
1145+ :: MonadObelisk m => GitUri -> Maybe Text -> m (Text, CommitId)
858gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
1146gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
859− bothMaps <- gitLsRemote
1147+ (_, bothMaps) <- gitLsRemote
860− (T.unpack $ render uri)
1148+ (T.unpack $ gitUriToText uri)
861 (GitRef_Branch <$> mbranch)
1149 (GitRef_Branch <$> mbranch)
1150+ Nothing
862 branch <- case mbranch of
1151 branch <- case mbranch of
863 Nothing -> withExitFailMessage "Failed to find default branch" $ do
1152 Nothing -> withExitFailMessage "Failed to find default branch" $ do
864 b <- rethrowE $ gitLookupDefaultBranch bothMaps
1153 b <- rethrowE $ gitLookupDefaultBranch bothMaps
@@ -872,18 +1161,21 @@ gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote "
872 pure (branch, commit)
1161 pure (branch, commit)
873 where
1162 where
874 rethrowE = either failWith pure
1163 rethrowE = either failWith pure
875− uriMsg = render uri
1164+ uriMsg = gitUriToText uri
1165+
1166+parseGitUri :: Text -> Maybe GitUri
1167+parseGitUri x = GitUri <$> (parseFileURI x <|> parseAbsoluteURI x <|> parseSshShorthand x)
876
1168
877−parseGitUri :: Text -> Maybe URI
1169+parseFileURI :: Text -> Maybe URI.URI
878−parseGitUri x = parseAbsoluteURI x <|> parseSshShorthand x
1170+parseFileURI uri = if "/" `T.isPrefixOf` uri then parseAbsoluteURI ("file://" <> uri) else Nothing
879
1171
880−parseAbsoluteURI :: Text -> Maybe URI
1172+parseAbsoluteURI :: Text -> Maybe URI.URI
881parseAbsoluteURI uri = do
1173parseAbsoluteURI uri = do
882− parsedUri <- mkURI uri
1174+ parsedUri <- URI.mkURI uri
883− guard $ isPathAbsolute parsedUri
1175+ guard $ URI.isPathAbsolute parsedUri
884− pure $ parsedUri
1176+ pure parsedUri
885
1177
886−parseSshShorthand :: Text -> Maybe URI
1178+parseSshShorthand :: Text -> Maybe URI.URI
887parseSshShorthand uri = do
1179parseSshShorthand uri = do
888 -- This is what git does to check that the remote
1180 -- This is what git does to check that the remote
889 -- is not a local file path when parsing shorthand.
1181 -- is not a local file path when parsing shorthand.
@@ -896,4 +1188,4 @@ parseSshShorthand uri = do
896 -- 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
897 guard $ isNothing (T.findIndex (=='/') authAndHostname)
1189 guard $ isNothing (T.findIndex (=='/') authAndHostname)
898 && not (T.null colonAndPath)
1190 && not (T.null colonAndPath)
899− mkURI properUri
1191+ URI.mkURI properUri
lib/command/src/Obelisk/Command/Upgrade.hsdeleted−293
@@ -1,293 +0,0 @@
1−{-# LANGUAGE FlexibleContexts #-}
2−{-# LANGUAGE GeneralizedNewtypeDeriving #-}
3−{-# LANGUAGE LambdaCase #-}
4−{-# LANGUAGE MultiParamTypeClasses #-}
5−{-# LANGUAGE OverloadedStrings #-}
6−{-# LANGUAGE ScopedTypeVariables #-}
7−{-# LANGUAGE TypeApplications #-}
8−module Obelisk.Command.Upgrade where
9−
10−import Control.Monad (forM, unless, void)
11−import Control.Monad.Catch (onException)
12−import Control.Monad.Except
13−import Control.Monad.IO.Class (liftIO)
14−import Data.Maybe (catMaybes)
15−import Data.Monoid (Any (..), getAny)
16−import Data.Semigroup ((<>))
17−import qualified Data.Set as S
18−import Data.Text (Text)
19−import qualified Data.Text as T
20−import System.Directory
21−import System.FilePath
22−import System.Posix.Process (executeFile)
23−
24−import Obelisk.App (MonadObelisk)
25−import Obelisk.CliApp
26−import Obelisk.Command.Utils
27−
28−import Obelisk.Command.Project (toImplDir)
29−import Obelisk.Command.Project (findProjectObeliskCommand)
30−import Obelisk.Command.Thunk (ThunkData (..), getThunkGitBranch, readThunk, updateThunk)
31−
32−import Obelisk.Command.Upgrade.Hash
33−import Obelisk.Migration
34−
35−newtype HandOffAction = HandoffAction Any
36− deriving (Monoid, Semigroup, Ord, Eq, Show)
37−
38−instance Action HandOffAction where
39− parseEdgeMeta = HandoffAction . Any . (== "True")
40−
41−data MigrationGraph
42− = MigrationGraph_ObeliskUpgrade
43− | MigrationGraph_ObeliskHandoff
44− deriving (Eq, Show, Bounded, Enum)
45−
46−graphName :: MigrationGraph -> Text
47−graphName = \case
48− MigrationGraph_ObeliskHandoff -> "obelisk-handoff"
49− MigrationGraph_ObeliskUpgrade -> "obelisk-upgrade"
50−
51−fromGraphName :: Text -> MigrationGraph
52−fromGraphName = \case
53− "obelisk-handoff" -> MigrationGraph_ObeliskHandoff
54− "obelisk-upgrade" -> MigrationGraph_ObeliskUpgrade
55− _ -> error "Invalid graph name specified"
56−
57−graphNames :: [Text]
58−graphNames = fmap graphName $ [minBound .. maxBound]
59−
60−ensureCleanProject :: MonadObelisk m => FilePath -> m ()
61−ensureCleanProject project =
62− ensureCleanGitRepo project False "Cannot upgrade with uncommited changes"
63−
64−-- | Decide whether we (ambient ob) should handoff to project obelisk before performing upgrade
65−decideHandOffToProjectOb :: MonadObelisk m => FilePath -> m Bool
66−decideHandOffToProjectOb project = do
67− ensureCleanProject project
68− updateThunk (toImplDir project) $ \projectOb -> do
69− (ambientGraph, ambientHash) <- getAmbientObInfo
70− projectHash <- computeVertexHash projectOb
71− case hasVertex projectHash ambientGraph of
72− False -> do
73− putLog Warning "Project ob not found in ambient ob's migration graph; handing off anyway"
74− return True
75− True -> handleMigrationError (findPathAction ambientGraph projectHash ambientHash) >>= \case
76− Nothing -> do
77− putLog Warning "No migration path between project and ambient ob; handing off anyway"
78− return True
79− Just (HandoffAction dontHandoff) -> do
80− return $ not $ getAny dontHandoff
81− where
82− getAmbientObInfo = do
83− ambientOb <- getAmbientOb
84− getMigrationGraph' ambientOb MigrationGraph_ObeliskHandoff >>= \case
85− Nothing -> do
86− failWith "Ambient ob has no migration (this can't be possible)"
87− Just m -> do
88− -- We don't have ambient's ob source code, so locate its hash from the
89− -- graph. The last vertex should be it.
90− ambientHash <- handleMigrationError $ getLast (_migration_graph m)
91− return (m, ambientHash)
92−
93−-- | Return the path to the current ('ambient') obelisk process Nix directory
94−getAmbientOb :: MonadObelisk m => m FilePath
95−getAmbientOb = takeDirectory . takeDirectory <$> liftIO getObeliskExe
96−
97−upgradeObelisk :: MonadObelisk m => FilePath -> Maybe Text -> m ()
98−upgradeObelisk project gitBranchM = do
99− ensureCleanProject project
100− gitBranch <- maybe (getObeliskBranch project) pure gitBranchM
101− updateObelisk project gitBranch >>= handOffToNewOb project
102−
103−getObeliskBranch :: MonadObelisk m => FilePath -> m Text
104−getObeliskBranch project = readThunk (toImplDir project) >>= \case
105− Left e -> failWith $ T.pack $ show e
106− Right (ThunkData_Checkout _) -> failWith "obelisk thunk must be packed"
107− Right (ThunkData_Packed tptr) -> case getThunkGitBranch tptr of
108− Just v -> pure v
109− Nothing ->
110− failWith "You must run `ob upgrade` with the Git branch specified explicitly, as the project's obelisk thunk does not specify any."
111−
112−updateObelisk :: MonadObelisk m => FilePath -> Text -> m Hash
113−updateObelisk project gitBranch =
114− withSpinner ("Fetching new obelisk [" <> gitBranch <> "]") $
115− updateThunk (toImplDir project) $ \obImpl -> do
116− fromHash <- computeVertexHash obImpl
117− callProcessAndLogOutput (Debug, Debug) $
118− gitProc obImpl ["checkout", T.unpack gitBranch]
119− callProcessAndLogOutput (Debug, Debug) $
120− gitProc obImpl ["pull"]
121− return fromHash
122−
123−handOffToNewOb :: MonadObelisk m => FilePath -> Hash -> m ()
124−handOffToNewOb project fromHash = do
125− impl <- withSpinner' "Preparing for handoff" (Just $ ("Handed off to new obelisk " <>) . T.pack) $
126− findProjectObeliskCommand project >>= \case
127− Nothing -> failWith "Not an obelisk project"
128− Just impl -> pure impl
129− let opts = ["internal", "migrate", T.unpack fromHash]
130− liftIO $ executeFile impl False ("--no-handoff" : opts) Nothing
131−
132−migrateObelisk :: MonadObelisk m => FilePath -> Hash -> m ()
133−migrateObelisk project fromHash = void $ withSpinner' "Migrating to new obelisk" (Just id) $ do
134− updateThunk (toImplDir project) $ \obImpl -> revertObImplOnFail obImpl $ do
135− toHash <- computeVertexHash obImpl
136− g <- getMigrationGraph' obImpl MigrationGraph_ObeliskUpgrade >>= \case
137− Nothing -> failWith "New obelisk has no migration metadata"
138− Just m -> pure m
139−
140− unless (hasVertex fromHash g) $ do
141− failWith $ "Current obelisk hash " <> fromHash <> " missing in migration graph of new obelisk"
142− unless (hasVertex toHash g) $ do
143− -- This usually means that the target obelisk branch does not have
144− -- migration vertex for its latest commit; typically due to developer
145− -- negligence.
146− failWith $ "New obelisk hash " <> toHash <> " missing in its migration graph"
147−
148− if fromHash == toHash
149− then do
150− pure $ "No upgrade available (new Obelisk is the same)"
151− else do
152− putLog Debug $ "Migrating from " <> fromHash <> " to " <> toHash
153− handleMigrationError (findPathAction g fromHash toHash) >>= \case
154− Nothing -> do
155− failWith "Unable to find migration path"
156− Just action -> do
157− unless (action == mempty) $ do
158− putLog Notice "To upgrade your project to the new version of obelisk, please follow these instructions:\n"
159− putLog Notice action
160− pure $ "Migrated from " <> fromHash <> " to " <> toHash
161− where
162− revertObImplOnFail impl f = f `onException` do
163− putLog Notice $ T.pack $ "Reverting changes to " <> impl
164− callProcessAndLogOutput (Notice, Notice) $ gitProc project ["checkout", impl]
165−
166−-- | Get the migration graph for project
167−getMigrationGraph
168− :: (Action action, MonadObelisk m)
169− => FilePath -> MigrationGraph -> m (Migration action)
170−getMigrationGraph obDir graph = getMigrationGraph' obDir graph >>= \case
171− Nothing -> failWith "Migration graph missing"
172− Just m -> pure m
173−
174−getMigrationGraph'
175− :: (Action action, MonadObelisk m)
176− => FilePath -> MigrationGraph -> m (Maybe (Migration action))
177−getMigrationGraph' obDir graph = do
178− let name = graphName graph
179− dir = migrationDir obDir
180− putLog Debug $ "Reading migration graph " <> name <> " from " <> T.pack dir
181− liftIO $ readGraph dir name
182−
183−computeVertexHash :: MonadObelisk m => FilePath -> m Hash
184−computeVertexHash = getDirectoryHash [migrationDirName]
185−
186−-- | Verify the integrity of the migration graph in relation to the Git repo.
187−verifyMigration :: MonadObelisk m => FilePath -> m ()
188−verifyMigration obDir = do
189− upgradeGraph <- withSpinner "Reading migration graph" $
190− getMigrationGraph @Text obDir MigrationGraph_ObeliskUpgrade
191− withSpinner "Checking graph integrity" $
192− handleMigrationError $ ensureGraphIntegrity upgradeGraph
193− headVertex <- liftIO (doesDirectoryExist $ obDir </> ".git") >>= \case
194− True ->
195− withSpinner "Checking existence of HEAD vertex" $
196− getHeadVertex obDir
197− False -> do
198− hash <- computeVertexHash obDir
199− unless (hasVertex hash upgradeGraph) $
200− failWith $ "No vertex found for obelisk hash " <> hash
201− pure hash
202− withSpinner "Checking graph linearity" $
203− -- NOTE: We don't support merge commits (i.e., diamonds in a graph) yet.
204− -- Until we do, ensure that the graph is a fully connected linear list.
205− runExceptT (ensureGraphLinearity upgradeGraph) >>= \case
206− Left (NonLinearGraph_MultipleAdjacents vertex) ->
207− failWith $ "Graph is not linear; branches at vertex: " <> tshow vertex
208− Left (NonLinearGraph_NotConnected isolatedVertices) ->
209− failWith $ "Graph is partly linear, with isolated vertices: " <> tshow isolatedVertices
210− Left e ->
211− failWith $ "Error in migration graph: " <> tshow e
212− Right lastVertex -> unless (lastVertex == headVertex) $
213− failWith $ "Graph is linear, but its last vertex (" <> lastVertex <> ") is different from head vertex (" <> headVertex <> ")"
214−
215−-- | Create an edge from HEAD vertex to the hash corresponding to the Git
216−-- working copy. The HEAD vertex must already exist.
217−createMigrationEdgeFromHEAD :: MonadObelisk m => FilePath -> m ()
218−createMigrationEdgeFromHEAD obDir = do
219− headHash <- getHeadVertex obDir
220− wcHash <- getDirectoryHash migrationIgnore obDir
221− if (headHash == wcHash)
222− then
223− putLog Warning "No migration necessary (working copy has the same hash as that of HEAD)"
224− else do
225− writeEdge (migrationDir obDir) graphNames headHash wcHash >>= \case
226− Nothing ->
227− putLog Warning "No migration was created"
228− Just edgeDir ->
229− putLog Notice $ "Created edge: " <> T.pack edgeDir
230−
231−-- | Return the hash corresponding to HEAD
232−--
233−-- Fail if the hash does not exist in project's migration graph.
234−getHeadVertex :: MonadObelisk m => FilePath -> m Hash
235−getHeadVertex obDir = do
236− projectGraph <- getMigrationGraph @Text obDir MigrationGraph_ObeliskUpgrade
237− [headHash] <- getHashAtGitRevision ["HEAD"] migrationIgnore obDir
238− unless (hasVertex headHash projectGraph) $ do
239− -- This means that the HEAD commit has no vertex in the graph,
240− -- possibly due to developer negligence when commiting it.
241− -- Perhaps we should use a post-commit hook or some such thing
242− -- to reject such commits in the first place? For now, just
243− -- error out.
244− failWith $ "No vertex found for HEAD (" <> headHash <> ")"
245− return headHash
246−
247−-- | Create, or update, the migration graph with new edges and new vertices
248−-- corresponding to every commit in the Git history from HEAD.
249−--
250−-- NOTE: This creates a linear graph, and doesn't follow the Git graph
251−-- structure.
252−backfillGraph :: MonadObelisk m => Maybe Int -> FilePath -> m ()
253−backfillGraph lastN obDir = do
254− revs <- fmap (takeM lastN . fmap (fst . T.breakOn " ") . T.lines) $
255− readProc $ gitProc obDir ["log", "--pretty=oneline"]
256− -- Note: we need to take unique hashes only; this is fine for backfilling.
257− -- But future migrations should ensure that there are no duplicate hashes
258− -- (which would cause cycles) such as those introduced by revert commits.
259− vertices :: [Hash] <- withSpinnerNoTrail "Computing hash for git history" $
260− fmap (unique . reverse) $ getHashAtGitRevision revs [migrationDirName] obDir
261− void $ withSpinner'
262− ("Backfilling with " <> tshow (length vertices) <> " vertices")
263− (Just $ \n -> "Backfilled " <> tshow n <> " edges.") $ do
264− let vertexPairs = zip vertices $ drop 1 vertices
265− let edgesDir = migrationDir obDir
266− liftIO $ createDirectoryIfMissing False edgesDir
267− fmap (length . catMaybes) $ forM vertexPairs $ \(v1, v2) -> do
268− writeEdge edgesDir graphNames v1 v2
269− where
270− -- Return unique items in the list /while/ preserving order
271− unique = loop mempty
272− where
273− loop _ [] = []
274− loop s (x : xs)
275− | S.member x s = loop s xs
276− | otherwise = x : loop (S.insert x s) xs
277− takeM n' xs = case n' of
278− Just n -> take n xs
279− Nothing -> xs
280−
281−handleMigrationError :: MonadObelisk m => Except MigrationError a -> m a
282−handleMigrationError m = case runExcept m of
283− Left e -> failWith $ "Error in migration graph: " <> tshow e
284− Right a -> return a
285−
286−migrationDir :: FilePath -> FilePath
287−migrationDir project = project </> migrationDirName
288−
289−migrationIgnore :: [FilePath]
290−migrationIgnore = [migrationDirName]
291−
292−migrationDirName :: FilePath
293−migrationDirName = "migration"
lib/command/src/Obelisk/Command/Upgrade/Hash.hsdeleted−115
@@ -1,115 +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.Nix (withNixRemoteCheck)
27−import Obelisk.Command.Utils
28−
29−import Obelisk.Migration
30−
31−-- | Get the unique hash of the given directory
32−--
33−-- Excludes the following before computing the hash:
34−-- * the specified top-level files/ directories.
35−-- * .git directory
36−-- * untracked Git files
37−-- * ignored Git files
38−-- * empty directories
39−--
40−-- Uses the same predictive algorithm as that of Nix (`nix-hash`).
41−--
42−-- This function will do a full copy of the directory to a temporary location before
43−-- computing the hash. Because it will be deleting the files in exclude list, and
44−-- other files if the directory is a git repo, which needs to be done as `nix-hash`
45−-- doesn't support taking an excludes list.
46−getDirectoryHash :: MonadObelisk m => [FilePath] -> FilePath -> m Hash
47−getDirectoryHash excludes dir = withSystemTempDirectory "obelisk-hash-" $ \tmpDir -> do
48− withSpinnerNoTrail (T.pack $ "Copying " <> dir <> " to " <> tmpDir) $ do
49− runProc $ copyDir dir tmpDir
50− getDirectoryHashDestructive excludes tmpDir
51−
52−getDirectoryHashDestructive :: MonadObelisk m => [FilePath] -> FilePath -> m Hash
53−getDirectoryHashDestructive excludes dir = do
54− liftIO (doesDirectoryExist $ dir </> ".git") >>= \case
55− True -> do
56− tidyUpGitWorkingCopy dir
57− withSpinnerNoTrail "Removing .git directory" $
58− liftIO $ removePathForcibly $ dir </> ".git"
59− False -> pure ()
60− withSpinnerNoTrail "Removing excluded paths" $ do
61− forM_ (fmap (dir </>) excludes) $
62− liftIO . removePathForcibly
63− nixHash dir
64−
65−getHashAtGitRevision :: MonadObelisk m => [Text] -> [FilePath] -> FilePath -> m [Hash]
66−getHashAtGitRevision revs excludes dir = withSystemTempDirectory "obelisk-hashrev-" $ \tmpDir -> do
67− withSpinnerNoTrail (T.pack $ "Copying " <> dir <> " to " <> tmpDir) $ do
68− runProc $ copyDir dir tmpDir
69− tidyUpGitWorkingCopy tmpDir
70− -- Discard changes to tracked files
71− runProcSilently $ gitProc tmpDir ["reset", "--hard"]
72− forM revs $ \rev -> do
73− runProcSilently $ gitProc tmpDir ["checkout", T.unpack rev]
74− -- Checking out an arbitrary revision can leave untracked files (from
75− -- previous revison) around, so tidy them up.
76− tidyUpGitWorkingCopy tmpDir
77− withFilesStashed tmpDir (excludes <> [".git"]) $
78− nixHash tmpDir
79− where
80− withFilesStashed base fs m = withSystemTempDirectory "obelisk-hashrev-stash-" $ \stashDir -> do
81− existingPaths <- fmap catMaybes $ forM fs $ \p -> do
82− liftIO (doesPathExist $ base </> p) >>= pure . bool Nothing (Just p)
83− forM_ existingPaths $ \p ->
84− liftIO $ renamePath (base </> p) (stashDir </> p)
85− result <- m
86− forM_ existingPaths $ \p ->
87− liftIO $ renamePath (stashDir </> p) (base </> p)
88− return result
89−
90−nixHash :: MonadObelisk m => FilePath -> m Hash
91−nixHash dir = withSpinnerNoTrail "Running `nix-hash`" $ withNixRemoteCheck $
92− readProc $ proc "nix-hash" [dir]
93−
94−-- | Clean up the following files in the git working copy
95−--
96−-- * Paths ignored by .gitignore, and still present
97−-- * Untracked files (not added to git index)
98−-- * Any empty directories (these are not tracked by git)
99−--
100−-- Note that this leaves modified (staged or unstaged) files as they are.
101−tidyUpGitWorkingCopy :: MonadObelisk m => FilePath -> m ()
102−tidyUpGitWorkingCopy dir = withSpinnerNoTrail "Tidying up git working copy" $ do
103− ignored <- gitLsFiles dir ["--ignored", "--exclude-standard", "--others"]
104− untracked <- gitLsFiles dir ["--exclude-standard", "--others"]
105− putLog Debug $ "Ignored: " <> T.pack (show $ length ignored) <> " files."
106− putLog Debug $ "Untracked files:\n" <> T.unlines untracked
107− withSpinnerNoTrail "Removing untracked and ignored files" $ do
108− forM_ (fmap ((dir </>) . T.unpack) $ ignored <> untracked) $
109− liftIO . removePathForcibly
110− -- Empty directories won't be included in these lists. Git doesn't track them
111− -- So we must delete these separately.
112− runProc $ proc "find" [dir, "-depth", "-empty", "-type", "d", "-delete"]
113− where
114− gitLsFiles pwd opts = fmap T.lines $ readProc $
115− (proc "git" $ ["ls-files", "."] <> opts) { cwd = Just pwd }
lib/command/src/Obelisk/Command/Utils.hs+105−24
@@ -4,33 +4,95 @@
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.Exit (ExitCode)
24−import System.Environment (getExecutablePath)
25+import System.Which (staticWhich)
25−import qualified System.Process as P
26+import qualified Text.Megaparsec.Char.Lexer as ML
26import Text.Megaparsec as MP
27import Text.Megaparsec as MP
27import Text.Megaparsec.Char as MP
28import Text.Megaparsec.Char as MP
28
29
29import Obelisk.App (MonadObelisk)
30import Obelisk.App (MonadObelisk)
30import Obelisk.CliApp
31import Obelisk.CliApp
31
32
32−getObeliskExe :: IO FilePath
33+cp :: FilePath
33−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+nixPrefetchGitPath :: FilePath
58+nixPrefetchGitPath = $(staticWhich "nix-prefetch-git")
59+
60+nixPrefetchUrlPath :: FilePath
61+nixPrefetchUrlPath = $(staticWhich "nix-prefetch-url")
62+
63+nixShellPath :: FilePath
64+nixShellPath = $(staticWhich "nix-shell")
65+
66+rsyncPath :: FilePath
67+rsyncPath = $(staticWhich "rsync")
68+
69+sshPath :: FilePath
70+sshPath = $(staticWhich "ssh")
71+
72+gitPath :: FilePath
73+gitPath = $(staticWhich "git")
74+
75+whichPath :: FilePath
76+whichPath = $(staticWhich "which")
77+
78+sshKeygenPath :: FilePath
79+sshKeygenPath = $(staticWhich "ssh-keygen")
80+
81+-- $(staticWhich "docker") was intentionally omitted, at least for now
82+-- One concern is that I don't know how particular docker is about having the
83+-- CLI exe match the version of the docker daemon, which is largely outside of
84+-- the control of obelisk-command.
85+-- TODO: Investigate the tradeoffs associated with this choice
86+dockerPath :: FilePath
87+dockerPath = "docker"
88+
89+-- | Nix syntax requires relative paths to be prefixed by @./@ or
90+-- @../@. This will make a 'FilePath' that can be embedded in a Nix
91+-- expression.
92+toNixPath :: FilePath -> FilePath
93+toNixPath root | "/" `isInfixOf` root = root
94+ | otherwise = "./" <> root
95+
34
96
35-- Check whether the working directory is clean
97-- Check whether the working directory is clean
36checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
98checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
@@ -60,38 +122,52 @@ initGit repo = do
60 git ["add", "."]
122 git ["add", "."]
61 git ["commit", "-m", "Initial commit."]
123 git ["commit", "-m", "Initial commit."]
62
124
63−gitProcNoRepo :: [String] -> P.CreateProcess
125+gitProcNoRepo :: [String] -> ProcessSpec
64−gitProcNoRepo = P.proc "git"
126+gitProcNoRepo args = setEnvOverride (M.singleton "GIT_TERMINAL_PROMPT" "0" <>) $ proc gitPath args
65
127
66−gitProc :: FilePath -> [String] -> P.CreateProcess
128+gitProc :: FilePath -> [String] -> ProcessSpec
67gitProc repo = gitProcNoRepo . runGitInDir
129gitProc repo = gitProcNoRepo . runGitInDir
68 where
130 where
69 runGitInDir args' = case filter (not . null) args' of
131 runGitInDir args' = case filter (not . null) args' of
70 args@("clone":_) -> args <> [repo]
132 args@("clone":_) -> args <> [repo]
71 args -> ["-C", repo] <> args
133 args -> ["-C", repo] <> args
72
134
73−-- | Recursively copy a directory using `cp -a`
135+isolateGitProc :: ProcessSpec -> ProcessSpec
74−copyDir :: FilePath -> FilePath -> P.CreateProcess
136+isolateGitProc = setEnvOverride (overrides <>)
137+ where
138+ overrides = M.fromList
139+ [ ("HOME", "/dev/null")
140+ , ("GIT_CONFIG_NOSYSTEM", "1")
141+ , ("GIT_TERMINAL_PROMPT", "0") -- git 2.3+
142+ , ("GIT_ASKPASS", "echo") -- pre git 2.3 to just use empty password
143+ , ("GIT_SSH_COMMAND", "ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no -o GSSAPIAuthentication=no")
144+ ]
145+
146+-- | Recursively copy a directory using `cp -a` -- TODO: Should use -rT instead of -a
147+copyDir :: FilePath -> FilePath -> ProcessSpec
75copyDir src dest =
148copyDir src dest =
76− (P.proc "cp" ["-a", ".", dest]) { P.cwd = Just src }
149+ setCwd (Just src) $ proc cp ["-a", ".", dest] -- TODO: This will break if dest is relative since we change cwd
77
150
78readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
151readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
79readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
152readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
80
153
154+readGitProcessNoRepo :: MonadObelisk m => [String] -> m Text
155+readGitProcessNoRepo = readProcessAndLogOutput (Debug, Notice) . gitProcNoRepo
156+
81processToShellString :: FilePath -> [String] -> String
157processToShellString :: FilePath -> [String] -> String
82processToShellString cmd args = unwords $ map quoteAndEscape (cmd : args)
158processToShellString cmd args = unwords $ map quoteAndEscape (cmd : args)
83 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
159 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
84
160
85-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
161-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
86−runProc :: MonadObelisk m => P.CreateProcess -> m ()
162+runProc :: MonadObelisk m => ProcessSpec -> m ()
87runProc = callProcessAndLogOutput (Notice, Error)
163runProc = callProcessAndLogOutput (Notice, Error)
88
164
89-- | Like runProc, but all output goes to Debug logging level
165-- | Like runProc, but all output goes to Debug logging level
90−runProcSilently :: MonadObelisk m => P.CreateProcess -> m ()
166+runProcSilently :: MonadObelisk m => ProcessSpec -> m ()
91runProcSilently = callProcessAndLogOutput (Debug, Debug)
167runProcSilently = callProcessAndLogOutput (Debug, Debug)
92
168
93-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
169-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
94−readProc :: MonadObelisk m => P.CreateProcess -> m Text
170+readProc :: MonadObelisk m => ProcessSpec -> m Text
95readProc = readProcessAndLogOutput (Debug, Error)
171readProc = readProcessAndLogOutput (Debug, Error)
96
172
97tshow :: Show a => a -> Text
173tshow :: Show a => a -> Text
@@ -119,16 +195,21 @@ gitLsRemote
119 :: MonadObelisk m
195 :: MonadObelisk m
120 => String
196 => String
121 -> Maybe GitRef
197 -> Maybe GitRef
122− -> m GitLsRemoteMaps
198+ -> Maybe String
123−gitLsRemote repository mRef = do
199+ -> m (ExitCode, GitLsRemoteMaps)
124− t <- readProc $ gitProcNoRepo $
200+gitLsRemote repository mRef mBranch = do
125− ["ls-remote", "--symref", repository]
201+ (exitCode, out, _err) <- case mBranch of
126− ++ (maybeToList $ T.unpack . showGitRef <$> mRef)
202+ Nothing -> readCreateProcessWithExitCode $ gitProcNoRepo $
203+ ["ls-remote", "--exit-code", "--symref", repository]
204+ ++ maybeToList (T.unpack . showGitRef <$> mRef)
205+ Just branchName -> readCreateProcessWithExitCode $ gitProcNoRepo
206+ ["ls-remote", "--exit-code", repository, branchName]
207+ let t = T.pack out
127 maps <- case MP.runParser parseLsRemote "" t of
208 maps <- case MP.runParser parseLsRemote "" t of
128− Left err -> failWith $ T.pack $ MP.parseErrorPretty' t err
209+ Left err -> failWith $ T.pack $ MP.errorBundlePretty err
129− Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers $ table
210+ Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers table
130 putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
211 putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
131− pure maps
212+ pure (exitCode, maps)
132
213
133lexeme :: Parsec Void Text a -> Parsec Void Text a
214lexeme :: Parsec Void Text a -> Parsec Void Text a
134lexeme = ML.lexeme $ void $ MP.takeWhileP (Just "within-line white space") $
215lexeme = ML.lexeme $ void $ MP.takeWhileP (Just "within-line white space") $
lib/command/src/Obelisk/Command/VmBuilder.hs+65−36
@@ -1,13 +1,13 @@
1{-# LANGUAGE FlexibleContexts #-}
1{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE OverloadedStrings #-}
2{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE QuasiQuotes #-}
3{-# LANGUAGE QuasiQuotes #-}
4+{-# LANGUAGE ScopedTypeVariables #-}
4module Obelisk.Command.VmBuilder where
5module Obelisk.Command.VmBuilder where
5
6
6import Control.Applicative (liftA2)
7import Control.Applicative (liftA2)
7−import Control.Monad (unless)
8+import Control.Monad (when, unless)
8−import Control.Monad.Catch (try)
9+import Control.Monad.Catch (handle)
9import Control.Monad.IO.Class (liftIO)
10import Control.Monad.IO.Class (liftIO)
10−import Data.Either (isRight)
11import Data.Monoid ((<>))
11import Data.Monoid ((<>))
12import Data.String (IsString)
12import Data.String (IsString)
13import Data.String.Here.Uninterpolated (hereLit)
13import Data.String.Here.Uninterpolated (hereLit)
@@ -15,23 +15,45 @@ import Data.Text (Text)
15import qualified Data.Text as T
15import qualified Data.Text as T
16import qualified Data.Text.IO as T
16import qualified Data.Text.IO as T
17import System.Directory (createDirectoryIfMissing)
17import System.Directory (createDirectoryIfMissing)
18−import System.Exit (ExitCode)
18+import 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
25−import Obelisk.Command.Nix (withNixRemoteCheck)
24+import Obelisk.Command.Utils (rmPath, whichPath, sshKeygenPath, nixBuildExePath, dockerPath)
26
25
27-- | 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.
28getNixBuildersArg :: MonadObelisk m => m String
27getNixBuildersArg :: MonadObelisk m => m String
29getNixBuildersArg = do
28getNixBuildersArg = do
30 stateDir <- liftIO getDockerBuilderStateDir
29 stateDir <- liftIO getDockerBuilderStateDir
31− exists <- containerExists
30+ let sshIdFile = stateDir </> sshKeyFileName
31+ checkForNixDarwin sshIdFile
32+ exists <- containerExists stateDir
32 if exists then startContainer else setupNixDocker stateDir
33 if exists then startContainer else setupNixDocker stateDir
33 pure $ nixBuildersArgString stateDir
34 pure $ nixBuildersArgString stateDir
34
35
36+checkForNixDarwin :: MonadObelisk m => String -> m ()
37+checkForNixDarwin sshIdFile = do
38+ (exitCode, _, _) <- readCreateProcessWithExitCode $ proc whichPath ["darwin-rebuild"]
39+ unless (exitCode == ExitSuccess) $ failWith $ T.intercalate "\n"
40+ [ "Deployments from macOS require nix-darwin to be installed."
41+ , "Follow the installation instructions here: https://github.com/LnL7/nix-darwin"
42+ , "You'll also need to add the following to your 'configuration.nix' and run 'darwin-rebuild switch':"
43+ , ""
44+ , T.intercalate "\n" $ map (" " <>)
45+ [ "nix.distributedBuilds = true;"
46+ , "nix.buildMachines = [{"
47+ , " hostName = " <> T.pack (show (containerName :: String)) <> ";"
48+ , " sshUser = \"root\";"
49+ , " sshKey = " <> T.pack (show sshIdFile) <> ";"
50+ , " sshPort = " <> T.pack (show containerSshPort) <> ";"
51+ , " systems = [ \"x86_64-linux\" ];"
52+ , " maxJobs = 2;"
53+ , "}];"
54+ ]
55+ ]
56+
35-- | String to pass to nix's `--builders` arguments to enable the VM builder.
57-- | String to pass to nix's `--builders` arguments to enable the VM builder.
36nixBuildersArgString :: FilePath -> String
58nixBuildersArgString :: FilePath -> String
37nixBuildersArgString stateDir = unwords [containerName, "x86_64-linux", stateDir </> sshKeyFileName, "1", "1", "kvm"]
59nixBuildersArgString stateDir = unwords [containerName, "x86_64-linux", stateDir </> sshKeyFileName, "1", "1", "kvm"]
@@ -41,14 +63,19 @@ containerName :: IsString str => str
41containerName = "obelisk-docker-nix-builder"
63containerName = "obelisk-docker-nix-builder"
42
64
43-- | Check to see if the Docker container exists. This will exit with a helpful message if Docker is not installed.
65-- | Check to see if the Docker container exists. This will exit with a helpful message if Docker is not installed.
44−containerExists :: MonadObelisk m => m Bool
66+containerExists :: MonadObelisk m => FilePath -> m Bool
45−containerExists = withExitFailMessage needDockerMsg $ do
67+containerExists stateDir = handle (\(_ :: IOError) -> failWith needDockerMsg) $ do
46 containerNames <- fmap (map T.strip . T.lines) $
68 containerNames <- fmap (map T.strip . T.lines) $
47 readProcessAndLogStderr Error $
69 readProcessAndLogStderr Error $
48− proc "docker" ["container", "list", "--all", "--format", "{{.Names}}"]
70+ proc dockerPath ["container", "list", "--all", "--format", "{{.Names}}"]
49− pure $ containerName `elem` containerNames
71+ let exists = containerName `elem` containerNames
72+ when exists $ testLinuxBuild stateDir
73+ pure exists
50 where
74 where
51− needDockerMsg = "This feature requires that you have Docker installed and the `docker` command available on your PATH. Please go https://docs.docker.com/ to install Docker and try this command again."
75+ needDockerMsg = T.intercalate "\n"
76+ [ "This feature requires that you have Docker installed and the `docker` command available on your PATH."
77+ , "Please go https://docs.docker.com/ to install Docker and try this command again."
78+ ]
52
79
53-- | SSH port on localhost that connects to the container.
80-- | SSH port on localhost that connects to the container.
54containerSshPort :: Int
81containerSshPort :: Int
@@ -58,7 +85,7 @@ containerSshPort = 2222
58startContainer :: MonadObelisk m => m ()
85startContainer :: MonadObelisk m => m ()
59startContainer = withSpinner "Starting VM builder" $
86startContainer = withSpinner "Starting VM builder" $
60 callProcessAndLogOutput (Debug, Debug) $
87 callProcessAndLogOutput (Debug, Debug) $
61− proc "docker" ["start", containerName]
88+ proc dockerPath ["start", containerName]
62
89
63-- | Creates the Docker container; assumes it does not exist.
90-- | Creates the Docker container; assumes it does not exist.
64setupNixDocker :: MonadObelisk m => FilePath -> m ()
91setupNixDocker :: MonadObelisk m => FilePath -> m ()
@@ -69,30 +96,25 @@ setupNixDocker stateDir = withSpinner ("Creating Docker container named " <> con
69
96
70 -- Create new SSH keys for this container
97 -- Create new SSH keys for this container
71 callProcessAndLogOutput (Debug, Error) $
98 callProcessAndLogOutput (Debug, Error) $
72− proc "rm" ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
99+ proc rmPath ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
73 callProcessAndLogOutput (Debug, Error) $
100 callProcessAndLogOutput (Debug, Error) $
74− proc "ssh-keygen" ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
101+ proc sshKeygenPath ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
75
102
76 -- Build the docker container (which uses the SSH keys in the 'ssh' folder)
103 -- Build the docker container (which uses the SSH keys in the 'ssh' folder)
77− containerId <- readProcessAndLogStderr Error $
104+ containerId <- fmap T.strip $ readProcessAndLogStderr Error $
78− proc "docker" ["build", stateDir, "--quiet"]
105+ proc dockerPath ["build", stateDir, "--quiet"]
79− callProcessAndLogOutput (Debug, Error) $ proc "docker"
106+ callProcessAndLogOutput (Debug, Error) $ proc dockerPath
80 [ "run"
107 [ "run"
81 , "--restart", "always"
108 , "--restart", "always"
82 , "--detach"
109 , "--detach"
83 , "--publish", show containerSshPort <> ":22"
110 , "--publish", show containerSshPort <> ":22"
84 , "--name", T.unpack containerName, T.unpack containerId
111 , "--name", T.unpack containerName, T.unpack containerId
85 ]
112 ]
86− exists <- containerExists
113+ exists <- containerExists stateDir
87 unless exists $
114 unless exists $
88 failWith $ "Expected to see docker container named " <> containerName <> " but it does not exist."
115 failWith $ "Expected to see docker container named " <> containerName <> " but it does not exist."
89
116
90− linuxBuildWorked <- if System.Info.os == "linux"
117+ testLinuxBuild stateDir
91− then pure False -- The Linux test is useless on Linux so just assume the setup is incomplete.
92− else testLinuxBuild stateDir
93− unless linuxBuildWorked $ do
94− let sshIdFile = stateDir </> sshKeyFileName
95− failWith $ setupInstructions sshIdFile
96
118
97-- | The instructions for setting up SSH access to the container for the Nix daemon.
119-- | The instructions for setting up SSH access to the container for the Nix daemon.
98setupInstructions :: FilePath -> Text
120setupInstructions :: FilePath -> Text
@@ -129,19 +151,25 @@ getDockerBuilderStateDir :: IO FilePath
129getDockerBuilderStateDir = liftA2 (</>) getObeliskUserStateDir (pure "nix-docker-builder")
151getDockerBuilderStateDir = liftA2 (</>) getObeliskUserStateDir (pure "nix-docker-builder")
130
152
131-- | Run a test build to see if a Linux build can finish successfully.
153-- | Run a test build to see if a Linux build can finish successfully.
132−testLinuxBuild :: MonadObelisk m => FilePath -> m Bool
154+testLinuxBuild :: MonadObelisk m => FilePath -> m ()
133−testLinuxBuild stateDir =
155+testLinuxBuild stateDir
134− fmap (isRight :: Either ExitCode () -> Bool) $ try $ withNixRemoteCheck $
156+ | System.Info.os == "linux" = failWith "Using the docker builder is not necessary on linux."
135− callProcessAndLogOutput (Debug, Debug) $ proc "nix-build"
157+ | otherwise = do
136− [ "-E", "(import <nixpkgs> { system = \"x86_64-linux\"; }).writeText \"test\" builtins.currentTime"
158+ (exitCode, _stdout, stderr) <- readCreateProcessWithExitCode $ proc nixBuildExePath
137− , "--builders", nixBuildersArgString stateDir
159+ [ "--no-out-link"
138− ]
160+ , "-E", "(import <nixpkgs> { system = \"x86_64-linux\"; }).writeText \"test\" builtins.currentTime"
139−
161+ , "--builders", nixBuildersArgString stateDir
140−-- Copied from https://raw.githubusercontent.com/LnL7/nix-docker/bf28b99aebd8e403d2fc2171f4fa8878f857171c/ssh/Dockerfile
162+ ]
163+ unless (exitCode == ExitSuccess) $ do
164+ let sshIdFile = stateDir </> sshKeyFileName
165+ putLog Error $ T.pack stderr
166+ failWith $ setupInstructions sshIdFile
167+
168+-- Copied from https://github.com/LnL7/nix-docker/blob/8dcfb3aff1f87cdafeecb0d27964b27c3fb8b1d2/ssh/Dockerfile
141-- Renamed "insecure_rsa" to 'sshKeyFileName'
169-- Renamed "insecure_rsa" to 'sshKeyFileName'
142dockerfile :: Text
170dockerfile :: Text
143dockerfile = [hereLit|
171dockerfile = [hereLit|
144−FROM lnl7/nix:2018-04-17
172+FROM lnl7/nix:2018-09-21
145
173
146RUN nix-env -f '<nixpkgs>' -iA \
174RUN nix-env -f '<nixpkgs>' -iA \
147 gnused \
175 gnused \
@@ -166,7 +194,8 @@ RUN mkdir -p /etc/ssh \
166 ] <> [hereLit|
194 ] <> [hereLit|
167
195
168EXPOSE 22
196EXPOSE 22
169−CMD ["/nix/store/hpnx760s247labqc3nbn2kripk73p0ca-openssh-7.6p1/bin/sshd", "-D", "-e"]
197+CMD ["/nix/store/mydwfxzk8bka4iwjml033dir6gkmqwic-openssh-7.7p1/bin/sshd", "-D", "-e"]
198+
170|]
199|]
171
200
172sshKeyFileName :: FilePath
201sshKeyFileName :: FilePath
lib/executable-config/default.nix+38−16
@@ -2,22 +2,44 @@
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}:
8−let injectConfig = config: assets: nixpkgs.runCommand "inject-config" {} ''
9+
9− set -x
10+let
10− mkdir -p $out
11+ injectConfig = config: assets: runCommand "inject-config" {} (''
11− cp --no-preserve=mode -Lr "${assets}" $out/static
12+ set -x
12− chmod +w "$out"
13+ mkdir -p $out
13− if ! mkdir $out/config; then
14+ cp --no-preserve=mode -Lr "${assets}" $out/static
14− 2>&1 echo config directory already exists or could not be created
15+ chmod +w "$out"
15− exit 1
16+ '' + lib.optionalString (!(builtins.isNull config)) ''
16− fi
17+ if ! mkdir $out/config; then
17− cp -a "${config}"/* "$out/config"
18+ 2>&1 echo config directory already exists or could not be created
18− '';
19+ exit 1
19−in with nixpkgs.haskell.lib; {
20+ fi
20− haskellPackage = self: self.callPackage (filterGitSource ./lookup) {};
21+ cp -a "${config}"/* "$out/config"
22+ # Needed for android deployments
23+ find "$out/config" -type f -printf '%P\0' > "$out/config.files"
24+ '');
25+in
26+
27+{
28+ haskellOverlay = self: super:
29+ let
30+ pkgs = self.callPackage ({pkgs}: pkgs) {};
31+ in {
32+ obelisk-executable-config-lookup = pkgs.haskell.lib.overrideCabal
33+ (self.callCabal2nix "obelisk-executable-config-lookup" (obeliskCleanSource ./lookup) {})
34+ (drv: {
35+ # Hack until https://github.com/NixOS/cabal2nix/pull/432 lands
36+ libraryHaskellDepends = (drv.libraryHaskellDepends or [])
37+ ++ pkgs.stdenv.lib.optionals (with pkgs.stdenv.hostPlatform; isAndroid && is32bit) [
38+ self.android-activity
39+ ];
40+ });
41+ };
42+
21 platforms = {
43 platforms = {
22 android = {
44 android = {
23 # Inject the given config directory into an android assets folder
45 # Inject the given config directory into an android assets folder
@@ -28,7 +50,7 @@ in with nixpkgs.haskell.lib; {
28 inject = injectConfig;
50 inject = injectConfig;
29 };
51 };
30 web = {
52 web = {
31− inject = self: self.callCabal2nix "obelisk-executable-config-inject" (filterGitSource ./inject) {};
53+ inject = self: self.callCabal2nix "obelisk-executable-config-inject" (obeliskCleanSource ./inject) {};
32 };
54 };
33 };
55 };
34}
56}
lib/executable-config/inject/obelisk-executable-config-inject.cabal+3−3
@@ -9,10 +9,10 @@ library
9 build-depends:
9 build-depends:
10 base,
10 base,
11 bytestring,
11 bytestring,
12− directory,
12+ base64-bytestring,
13− filepath,
13+ containers,
14 reflex-dom-core,
14 reflex-dom-core,
15 text
15 text
16
16
17 exposed-modules: Obelisk.ExecutableConfig.Inject
17 exposed-modules: Obelisk.ExecutableConfig.Inject
18− ghc-options: -Wall
18+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/executable-config/inject/src/Obelisk/ExecutableConfig/Inject.hs+14−40
@@ -2,50 +2,24 @@
2module Obelisk.ExecutableConfig.Inject where
2module Obelisk.ExecutableConfig.Inject where
3
3
4import Control.Monad (mapM_)
4import Control.Monad (mapM_)
5−import Control.Monad.IO.Class (MonadIO, liftIO)
5+import Control.Monad.IO.Class (MonadIO)
6−import Data.Semigroup ((<>))
7import Data.ByteString (ByteString)
6import Data.ByteString (ByteString)
7+import qualified Data.ByteString.Base64 as B64
8+import Data.Map (Map)
9+import qualified Data.Map as Map
10+import Data.Semigroup ((<>))
8import Data.Text (Text)
11import Data.Text (Text)
9−import qualified Data.Text as T
12+import qualified Data.Text.Encoding as T
10−import qualified Data.Text.IO as T
11import Reflex.Dom.Core hiding (value)
13import Reflex.Dom.Core hiding (value)
12−import System.Directory
13−import System.FilePath ((</>))
14−
15−-- | Produces a @<script>@ tag containing the contents of the config item,
16−-- rendered as a 'ByteString'.
17−inject :: FilePath -> IO ByteString
18−inject key = do
19− value <- T.readFile key
20− fmap snd $ renderStatic $ injectPure (T.pack key) value
21
14
22-- | Produces a @<script>@ tag with an @id@ attribute containing the key and
15-- | Produces a @<script>@ tag with an @id@ attribute containing the key and
23−-- whose value is the provided configuration
16+-- whose value is the provided configuration, encoded in base64.
24−injectPure :: DomBuilder t m => Text -> Text -> m ()
17+injectPure :: DomBuilder t m => Text -> ByteString -> m ()
25injectPure key value =
18injectPure key value =
26− let attrs = ("type" =: "text/plain" <> "id" =: ("config-" <> key))
19+ let attrs = ("type" =: "text/plain" <> "data-obelisk-executable-config-inject-key" =: key <> "data-hydration-skip" =: "")
27− in elAttr "script" attrs $ text value
20+ in elAttr "script" attrs $ text (T.decodeUtf8 (B64.encode value))
28−
29−-- | Scans the "common" and "frontend" configuration folders and produces
30−-- injectable @<script>@ tags containing the configuration keys (filepaths) and
31−-- values.
32−injectExecutableConfigs :: (MonadIO m, DomBuilder t m) => m ()
33−injectExecutableConfigs = do
34− cfgC <- getConfigs "config/common"
35− cfgF <- getConfigs "config/frontend"
36− mapM_ (uncurry injectPure) (cfgC <> cfgF)
37
21
38−getConfigs :: MonadIO m => FilePath -> m [(Text, Text)]
22+-- | Produces injectable @<script>@ tags containing the configuration keys
39−getConfigs fp = liftIO $ do
23+-- (filepaths) and values.
40− dir <- doesDirectoryExist fp
24+injectExecutableConfigs :: (MonadIO m, DomBuilder t m) => Map Text ByteString -> m ()
41− if dir
25+injectExecutableConfigs = mapM_ (uncurry injectPure) . Map.toList
42− then do
43− ps <- listDirectory fp
44− fmap concat $ mapM (\p -> getConfigs $ fp </> p) ps
45− else do
46− file <- doesFileExist fp
47− if file
48− then do
49− f <- T.readFile fp
50− return [(T.pack fp, f)]
51− else return []
lib/executable-config/lookup/default.nixdeleted−24
@@ -1,24 +0,0 @@
1−{ hostPlatform, ghc
2−, mkDerivation, base, bytestring, filepath, stdenv, text, transformers
3−, android-activity ? null, jsaddle-wkwebview ? null, ghcjs-dom ? null
4−}:
5−let isAndroid = hostPlatform.libc == "bionic";
6− isIOS = hostPlatform.isDarwin && hostPlatform.isAarch64;
7− isGhcjs = ghc.isGhcjs or false;
8−in mkDerivation {
9− pname = "obelisk-executable-config";
10− version = "0.1";
11− src = ./.;
12− libraryHaskellDepends = [
13− base bytestring filepath text transformers
14− ] ++ (if isAndroid then [
15− android-activity
16− ] else if isIOS then [
17− jsaddle-wkwebview
18− ] else if isGhcjs then [
19− ghcjs-dom
20− ] else [
21− ]);
22− license = stdenv.lib.licenses.bsd3;
23−}
24−
lib/executable-config/lookup/obelisk-executable-config-lookup.cabalnew file+48
@@ -0,0 +1,48 @@
1+name: obelisk-executable-config-lookup
2+version: 0.1.1
3+cabal-version: >= 1.2
4+build-type: Simple
5+
6+library
7+ exposed-modules: Obelisk.ExecutableConfig.Lookup, Obelisk.Configs
8+ if os(ios)
9+ hs-source-dirs: src-ios, src
10+ other-modules: Obelisk.Configs.Internal.Directory
11+ build-depends: jsaddle-wkwebview
12+ build-depends: directory
13+ else
14+ if os(linux-android)
15+ hs-source-dirs: src-android, src
16+ c-sources: cbits/ExecutableConfig.c
17+ other-modules: Obelisk.ExecutableConfig.Internal.AssetManager
18+ build-depends: android-activity
19+ ld-options: -landroid
20+ else
21+ if impl(ghcjs)
22+ hs-source-dirs: src-ghcjs, src
23+ build-depends: ghcjs-dom
24+ else
25+ hs-source-dirs: src-other, src
26+ other-modules: Obelisk.Configs.Internal.Directory
27+ build-depends: directory
28+
29+ build-depends:
30+ base,
31+ base64-bytestring,
32+ bytestring,
33+ containers,
34+ exceptions,
35+ filepath,
36+ jsaddle,
37+ mmorph,
38+ monad-control,
39+ mtl,
40+ primitive,
41+ ref-tf,
42+ reflex-dom-core,
43+ reflex,
44+ text,
45+ transformers-base,
46+ transformers
47+
48+ ghc-options: -Wall
lib/executable-config/lookup/obelisk-executable-config.cabaldeleted−30
@@ -1,30 +0,0 @@
1−name: obelisk-executable-config
2−version: 0.1.1
3−cabal-version: >= 1.2
4−build-type: Simple
5−
6−library
7− exposed-modules: Obelisk.ExecutableConfig
8− if os(ios)
9− hs-source-dirs: src-ios
10− build-depends: jsaddle-wkwebview
11− else
12− if os(linux-android)
13− hs-source-dirs: src-android
14− c-sources: cbits/ExecutableConfig.c
15− other-modules: Obelisk.ExecutableConfig.Internal.AssetManager
16− build-depends: android-activity
17− ld-options: -landroid
18− else
19− if impl(ghcjs)
20− hs-source-dirs: src-ghcjs
21− build-depends: ghcjs-dom
22− else
23− hs-source-dirs: src
24−
25− build-depends:
26− base,
27− bytestring,
28− filepath,
29− text,
30− transformers
lib/executable-config/lookup/src-android/Obelisk/ExecutableConfig.hsdeleted−27
@@ -1,27 +0,0 @@
1−module Obelisk.ExecutableConfig (get) where
2−
3−import Control.Exception (bracket)
4−import qualified Data.ByteString as BS
5−import Data.Text (Text)
6−import qualified Data.Text as T
7−import qualified Data.Text.Encoding as T
8−import Foreign.C.String (withCString)
9−import Foreign.Ptr (nullPtr)
10−import System.FilePath.Posix ((</>))
11−
12−import Obelisk.ExecutableConfig.Internal.AssetManager
13−
14−get :: Text -> IO (Maybe Text)
15−get name = bracket getAssets freeAssetManager $ \mgrObj -> do
16− mgr <- assetManagerFromJava mgrObj
17− let open = do
18− a <- withCString (T.unpack name) $ \fn ->
19− assetManager_open mgr fn 3
20− return $ if unAAsset a == nullPtr
21− then Nothing
22− else Just a
23− close = mapM_ asset_close
24− bracket open close $ mapM $ \asset -> do
25− b <- asset_getBuffer asset
26− l <- asset_getLength asset
27− fmap T.decodeUtf8 $ BS.packCStringLen (b, fromIntegral l)
lib/executable-config/lookup/src-android/Obelisk/ExecutableConfig/Lookup.hsnew file+60
@@ -0,0 +1,60 @@
1+{-# LANGUAGE LambdaCase #-}
2+{-# LANGUAGE OverloadedStrings #-}
3+module Obelisk.ExecutableConfig.Lookup where
4+
5+import Control.Exception (bracket)
6+import Control.Monad (forM)
7+import Data.ByteString (ByteString)
8+import qualified Data.ByteString as BS
9+import Data.Map (Map)
10+import qualified Data.Map as Map
11+import Data.Text (Text)
12+import qualified Data.Text.Encoding as T
13+import Foreign.C.String (withCString)
14+import Foreign.Ptr (nullPtr)
15+
16+import Obelisk.ExecutableConfig.Internal.AssetManager
17+
18+getFromMgr :: AAssetManager -> BS.ByteString -> IO (Maybe ByteString)
19+getFromMgr mgr name = do
20+ let open = do
21+ a <- BS.useAsCString name $ \fn ->
22+ assetManager_open mgr fn 3
23+ return $ if unAAsset a == nullPtr
24+ then Nothing
25+ else Just a
26+ close = mapM_ asset_close
27+ bracket open close $ mapM $ \asset -> do
28+ b <- asset_getBuffer asset
29+ l <- asset_getLength asset
30+ BS.packCStringLen (b, fromIntegral l)
31+
32+getConfigs :: IO (Map Text ByteString)
33+getConfigs = fmap (Map.mapKeys T.decodeUtf8) $ bracket getAssets freeAssetManager $ \mgrObj -> do
34+ mgr <- assetManagerFromJava mgrObj
35+ let openDir = do
36+ d <- withCString "config.files" $ \fn ->
37+ assetManager_open mgr fn 3
38+ return $ if unAAsset d == nullPtr
39+ then Nothing
40+ else Just d
41+ closeDir = mapM_ asset_close
42+ configPaths <- bracket openDir closeDir $ \case
43+ Just asset -> do
44+ b <- asset_getBuffer asset
45+ l <- asset_getLength asset
46+ lines0 <$> BS.packCStringLen (b, fromIntegral l)
47+ Nothing -> error "could not open configuration manifest 'config.files'"
48+ result <- fmap Map.fromList $ forM configPaths $ \fp ->
49+ getFromMgr mgr ("config/" <> fp) >>= \case
50+ Just v -> return (fp, v)
51+ Nothing -> error $ "Config present in config.files but not in assets: " <> show fp
52+ putStrLn $ "getConfigs: found " <> show result
53+ pure result
54+
55+lines0 :: BS.ByteString -> [BS.ByteString]
56+lines0 ps
57+ | BS.null ps = []
58+ | otherwise = case BS.elemIndex 0 ps of
59+ Nothing -> [ps]
60+ Just n -> BS.take n ps : lines0 (BS.drop (n+1) ps)
lib/executable-config/lookup/src-ghcjs/Obelisk/ExecutableConfig.hsdeleted−17
@@ -1,17 +0,0 @@
1−{-# LANGUAGE OverloadedStrings #-}
2−module Obelisk.ExecutableConfig where
3−
4−import Control.Monad.Trans.Maybe
5−import Data.Semigroup ((<>))
6−import Data.Text (Text)
7−import GHCJS.DOM
8−import GHCJS.DOM.Document
9−import GHCJS.DOM.Element
10−import GHCJS.DOM.NonElementParentNode
11−
12−get :: Text -> IO (Maybe Text)
13−get item = runMaybeT $ do
14− doc <- MaybeT currentDocument
15− e <- MaybeT $ getElementById doc $ "config-" <> item
16− getInnerHTML e
17−
lib/executable-config/lookup/src-ghcjs/Obelisk/ExecutableConfig/Lookup.hsnew file+51
@@ -0,0 +1,51 @@
1+{-# LANGUAGE LambdaCase #-}
2+{-# LANGUAGE OverloadedStrings #-}
3+module Obelisk.ExecutableConfig.Lookup where
4+
5+import Data.ByteString (ByteString)
6+import qualified Data.ByteString.Base64 as B64
7+import Data.Map (Map)
8+import qualified Data.Map as Map
9+import Data.Maybe (catMaybes)
10+import Data.Text (Text)
11+import qualified Data.Text.Encoding as T
12+import Data.Traversable (for)
13+import GHCJS.DOM
14+import GHCJS.DOM.Document (getHead)
15+import GHCJS.DOM.DOMStringMap (get)
16+import GHCJS.DOM.Element (getInnerHTML)
17+import GHCJS.DOM.HTMLElement (HTMLElement(HTMLElement), getDataset)
18+import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
19+import GHCJS.DOM.ParentNode (querySelectorAll)
20+import GHCJS.DOM.Types (MonadJSM, Node(Node), castTo)
21+
22+getConfigs :: IO (Map Text ByteString)
23+getConfigs = do
24+ Just doc <- currentDocument
25+ Just hd <- getHead doc
26+ nodes <- nodeListNodes =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
27+ fmap Map.fromList $ for nodes $ \node -> do
28+ e <- castTo HTMLElement node >>= \case
29+ Nothing -> error "Found node with data attribute obelisk-executable-config-inject-key that is not an HTMLElement."
30+ Just htmlE -> return htmlE
31+ dataset <- getDataset e
32+ (,)
33+ -- the key is camelCased: https://html.spec.whatwg.org/multipage/dom.html#dom-dataset
34+ <$> get dataset ("obeliskExecutableConfigInjectKey" :: Text)
35+ <*> (fmap decodeOrFail (getInnerHTML e))
36+ where
37+ decodeOrFail x = case B64.decode (T.encodeUtf8 x) of
38+ Left e -> error ("Obelisk.ExecutableConfig.Lookup.getConfigs: error when decoding base64: " ++ e)
39+ Right x' -> x'
40+
41+-- | Collect all nodes in the node list.
42+--
43+-- TODO: this and the version in obelisk-frontend should be
44+-- upstreamed to jsaddle.
45+nodeListNodes :: (IsNodeList l, MonadJSM m) => l -> m [Node]
46+nodeListNodes es = do
47+ len <- getLength es
48+ -- Warning! len is unsigned. If the NodeList is empty, we must avoid
49+ -- accidentally traversing over [0..maxBound::Word]
50+ nodes <- traverse (item es) $ if len == 0 then [] else [0..len-1]
51+ pure $ catMaybes nodes
lib/executable-config/lookup/src-ios/Obelisk/ExecutableConfig.hsdeleted−22
@@ -1,22 +0,0 @@
1−module Obelisk.ExecutableConfig (get) where
2−
3−import Control.Exception
4−import Control.Monad
5−import Control.Monad.Trans.Maybe
6−import Data.ByteString as BS
7−import Data.Text (Text)
8−import qualified Data.Text as T
9−import qualified Data.Text.IO as T
10−import qualified Data.Text.Encoding as T
11−import Language.Javascript.JSaddle.WKWebView
12−import System.FilePath.Posix ((</>))
13−import System.IO.Error
14−
15−get :: Text -> IO (Maybe Text)
16−get name = fmap join $ mainBundleResourcePath >>= \mp -> forM mp $ \p ->
17− catchDoesNotExist $ T.readFile $ T.unpack (T.decodeUtf8 p) </> T.unpack name
18−
19−catchDoesNotExist :: IO a -> IO (Maybe a)
20−catchDoesNotExist f = catchJust doesNotExist (Just <$> f) $ const $ return Nothing
21− where
22− doesNotExist e = if isDoesNotExistError e then Just () else Nothing
lib/executable-config/lookup/src-ios/Obelisk/ExecutableConfig/Lookup.hsnew file+17
@@ -0,0 +1,17 @@
1+{-# LANGUAGE LambdaCase #-}
2+module Obelisk.ExecutableConfig.Lookup where
3+
4+import Data.ByteString (ByteString)
5+import Data.Map (Map)
6+import Data.Text (Text)
7+import qualified Data.Text as T
8+import qualified Data.Text.Encoding as T
9+import Language.Javascript.JSaddle.WKWebView
10+import System.FilePath.Posix
11+
12+import Obelisk.Configs.Internal.Directory
13+
14+getConfigs :: IO (Map Text ByteString)
15+getConfigs = mainBundleResourcePath >>= \case
16+ Nothing -> error "Could not get bundle resource path."
17+ Just p -> getConfigsFromDirectory $ T.unpack (T.decodeUtf8 p) </> "config"
lib/executable-config/lookup/src-other/Obelisk/ExecutableConfig/Lookup.hsnew file+11
@@ -0,0 +1,11 @@
1+{-# LANGUAGE OverloadedStrings #-}
2+module Obelisk.ExecutableConfig.Lookup where
3+
4+import Data.Map (Map)
5+import Data.Text (Text)
6+import Data.ByteString (ByteString)
7+
8+import Obelisk.Configs.Internal.Directory (getConfigsFromDirectory)
9+
10+getConfigs :: IO (Map Text ByteString)
11+getConfigs = getConfigsFromDirectory "config"
lib/executable-config/lookup/src/Obelisk/Configs.hsnew file+148
@@ -0,0 +1,148 @@
1+{-# LANGUAGE CPP #-}
2+{-# LANGUAGE DataKinds #-}
3+{-# LANGUAGE DefaultSignatures #-}
4+{-# LANGUAGE DeriveFunctor #-}
5+{-# LANGUAGE FlexibleContexts #-}
6+{-# LANGUAGE FlexibleInstances #-}
7+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
8+{-# LANGUAGE MultiParamTypeClasses #-}
9+{-# LANGUAGE OverloadedStrings #-}
10+{-# LANGUAGE RankNTypes #-}
11+{-# LANGUAGE TypeFamilies #-}
12+{-# LANGUAGE UndecidableInstances #-}
13+module Obelisk.Configs
14+ ( HasConfigs(..)
15+ , ConfigsT
16+ , runConfigsT
17+ , mapConfigsT
18+ , getTextConfig
19+ ) where
20+
21+import Control.Applicative (Alternative)
22+import Control.Monad (MonadPlus)
23+import Control.Monad.Base (MonadBase)
24+import Control.Monad.Catch (MonadThrow)
25+import Control.Monad.Fail (MonadFail)
26+import Control.Monad.Fix (MonadFix)
27+import Control.Monad.IO.Class (MonadIO)
28+import Control.Monad.Morph (MFunctor)
29+import Control.Monad.Primitive (PrimMonad, PrimState, primitive)
30+import Control.Monad.Ref (MonadRef)
31+import Control.Monad.Trans (MonadTrans, lift)
32+import Control.Monad.Trans.Control (MonadBaseControl)
33+import Control.Monad.Trans.Reader (ReaderT (..), ask, mapReaderT)
34+import Control.Monad.Trans.State (StateT)
35+import qualified Control.Monad.Trans.State.Strict as Strict
36+import Data.ByteString (ByteString)
37+import Data.Map (Map)
38+import qualified Data.Map as Map
39+import Data.Text (Text)
40+import qualified Data.Text.Encoding as T
41+import Reflex
42+import Reflex.Host.Class (MonadReflexCreateTrigger)
43+import Reflex.Dom.Core
44+ ( DomBuilder
45+ , DomRenderHook
46+ , HasDocument
47+ , HasJS
48+ , HasJSContext
49+ , Prerender (Client)
50+ , StaticDomBuilderT
51+ , prerender
52+ )
53+#ifndef ghcjs_HOST_OS
54+import Language.Javascript.JSaddle (MonadJSM)
55+#endif
56+
57+class Monad m => HasConfigs m where
58+ getConfigs :: m (Map Text ByteString)
59+ default getConfigs :: (HasConfigs m', m ~ t m', MonadTrans t) => m (Map Text ByteString)
60+ getConfigs = lift getConfigs
61+ getConfig :: Text -> m (Maybe ByteString)
62+ getConfig k = do
63+ configs <- getConfigs
64+ return $ Map.lookup k configs
65+
66+instance Monad m => HasConfigs (ConfigsT m) where
67+ getConfigs = ConfigsT ask
68+
69+getTextConfig :: HasConfigs m => Text -> m (Maybe Text)
70+getTextConfig k = fmap T.decodeUtf8 <$> getConfig k
71+
72+instance HasConfigs m => HasConfigs (BehaviorWriterT t w m)
73+instance HasConfigs m => HasConfigs (DynamicWriterT t w m)
74+instance HasConfigs m => HasConfigs (EventWriterT t w m)
75+instance HasConfigs m => HasConfigs (PostBuildT t m)
76+instance HasConfigs m => HasConfigs (QueryT t q m)
77+instance HasConfigs m => HasConfigs (ReaderT r m)
78+instance HasConfigs m => HasConfigs (RequesterT t request response m)
79+instance HasConfigs m => HasConfigs (StateT w m)
80+instance HasConfigs m => HasConfigs (Strict.StateT w m)
81+instance HasConfigs m => HasConfigs (StaticDomBuilderT t m)
82+instance HasConfigs m => HasConfigs (TriggerEventT t m)
83+
84+newtype ConfigsT m a = ConfigsT { unConfigsT :: ReaderT (Map Text ByteString) m a }
85+ deriving
86+ ( Functor
87+ , Applicative
88+ , Monad
89+ , MonadPlus
90+ , Alternative
91+ , MonadFail
92+ , MonadFix
93+ , MonadThrow
94+ , MonadIO
95+ , MonadBase m'
96+ , MonadBaseControl m'
97+ , MonadRef
98+ , MonadTrans
99+ , MFunctor
100+ , DomBuilder t
101+ , MonadHold t
102+ , MonadReflexCreateTrigger t
103+ , MonadSample t
104+ , NotReady t
105+ , PostBuild t
106+ , TriggerEvent t
107+ , HasDocument
108+ , DomRenderHook t
109+ , HasJSContext
110+ , HasJS js
111+#ifndef ghcjs_HOST_OS
112+ , MonadJSM
113+#endif
114+ )
115+
116+instance PerformEvent t m => PerformEvent t (ConfigsT m) where
117+ type Performable (ConfigsT m) = ConfigsT (Performable m)
118+ performEvent e = ConfigsT $ ReaderT $ \configs ->
119+ performEvent $ runConfigsT configs <$> e
120+ performEvent_ e = ConfigsT $ ReaderT $ \configs ->
121+ performEvent_ $ runConfigsT configs <$> e
122+
123+instance Adjustable t m => Adjustable t (ConfigsT m) where
124+ runWithReplace a e = ConfigsT $ runWithReplace (unConfigsT a) (unConfigsT <$> e)
125+ traverseDMapWithKeyWithAdjust f m e = ConfigsT $ traverseDMapWithKeyWithAdjust (\k v -> unConfigsT $ f k v) m e
126+ traverseIntMapWithKeyWithAdjust f m e = ConfigsT $ traverseIntMapWithKeyWithAdjust (\k v -> unConfigsT $ f k v) m e
127+ traverseDMapWithKeyWithAdjustWithMove f m e = ConfigsT $ traverseDMapWithKeyWithAdjustWithMove (\k v -> unConfigsT $ f k v) m e
128+
129+instance Prerender js t m => Prerender js t (ConfigsT m) where
130+ type Client (ConfigsT m) = ConfigsT (Client m)
131+ prerender server client = ConfigsT $ ReaderT $ \configs ->
132+ prerender (runConfigsT configs server) (runConfigsT configs client)
133+
134+instance PrimMonad m => PrimMonad (ConfigsT m) where
135+ type PrimState (ConfigsT m) = PrimState m
136+ primitive = lift . primitive
137+
138+runConfigsT
139+ :: Map Text ByteString
140+ -> ConfigsT m a
141+ -> m a
142+runConfigsT cs child = runReaderT (unConfigsT child) cs
143+
144+mapConfigsT
145+ :: (forall x. m x -> n x)
146+ -> ConfigsT m a
147+ -> ConfigsT n a
148+mapConfigsT f (ConfigsT x) = ConfigsT $ mapReaderT f x
lib/executable-config/lookup/src/Obelisk/Configs/Internal/Directory.hsnew file+24
@@ -0,0 +1,24 @@
1+{-# LANGUAGE LambdaCase #-}
2+{-# LANGUAGE OverloadedStrings #-}
3+module Obelisk.Configs.Internal.Directory where
4+
5+import Control.Monad
6+import Data.ByteString (ByteString)
7+import qualified Data.ByteString as BS
8+import Data.Map (Map)
9+import qualified Data.Map as Map
10+import Data.Text (Text)
11+import qualified Data.Text as T
12+import System.Directory
13+import System.FilePath.Posix
14+
15+getConfigsFromDirectory :: FilePath -> IO (Map Text ByteString)
16+getConfigsFromDirectory base = doesDirectoryExist base >>= \case
17+ True -> do
18+ ps <- listDirectory base
19+ fmap mconcat $ forM ps $ \p -> do
20+ subdirConfigs <- getConfigsFromDirectory $ base </> p
21+ pure $ Map.mapKeys (T.pack . (p </>) . T.unpack) subdirConfigs
22+ False -> doesFileExist base >>= \case
23+ True -> Map.singleton "" <$> BS.readFile base
24+ False -> pure mempty
lib/executable-config/lookup/src/Obelisk/ExecutableConfig.hsdeleted−13
@@ -1,13 +0,0 @@
1−module Obelisk.ExecutableConfig (get) where
2−
3−import Control.Exception
4−import Data.Text (Text)
5−import Data.Text as T
6−import Data.Text.IO as T
7−import System.FilePath.Posix ((</>))
8−import System.IO.Error
9−
10−get :: Text -> IO (Maybe Text)
11−get path = do
12− let doesNotExist = \e -> if isDoesNotExistError e then Just () else Nothing
13− catchJust doesNotExist (fmap Just $ T.readFile $ T.unpack path) (\_ -> pure Nothing)
lib/frontend/obelisk-frontend.cabal+9−2
@@ -7,10 +7,15 @@ library
7 hs-source-dirs: src
7 hs-source-dirs: src
8 build-depends: base,
8 build-depends: base,
9 bytestring,
9 bytestring,
10+ containers,
11+ cookie,
10 dependent-sum,
12 dependent-sum,
11 ghcjs-dom,
13 ghcjs-dom,
12 jsaddle,
14 jsaddle,
13 lens,
15 lens,
16+ mtl,
17+ obelisk-executable-config-inject,
18+ obelisk-executable-config-lookup,
14 obelisk-route,
19 obelisk-route,
15 primitive,
20 primitive,
16 ref-tf,
21 ref-tf,
@@ -18,5 +23,7 @@ library
18 reflex-dom-core,
23 reflex-dom-core,
19 text,
24 text,
20 transformers
25 transformers
21− exposed-modules: Obelisk.Frontend
26+ exposed-modules:
22− ghc-options: -Wall
27+ Obelisk.Frontend
28+ Obelisk.Frontend.Cookie
29+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/frontend/src/Obelisk/Frontend.hs+186−96
@@ -1,10 +1,13 @@
1+{-# LANGUAGE CPP #-}
1{-# LANGUAGE ConstraintKinds #-}
2{-# LANGUAGE ConstraintKinds #-}
2{-# LANGUAGE FlexibleContexts #-}
3{-# LANGUAGE FlexibleContexts #-}
3{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE LambdaCase #-}
5{-# LANGUAGE LambdaCase #-}
5{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE PackageImports #-}
7{-# LANGUAGE RankNTypes #-}
9{-# LANGUAGE RankNTypes #-}
10+{-# LANGUAGE RecursiveDo #-}
8{-# LANGUAGE ScopedTypeVariables #-}
11{-# LANGUAGE ScopedTypeVariables #-}
9{-# LANGUAGE TemplateHaskell #-}
12{-# LANGUAGE TemplateHaskell #-}
10{-# LANGUAGE TypeFamilies #-}
13{-# LANGUAGE TypeFamilies #-}
@@ -13,37 +16,55 @@ module Obelisk.Frontend
13 ( ObeliskWidget
16 ( ObeliskWidget
14 , Frontend (..)
17 , Frontend (..)
15 , runFrontend
18 , runFrontend
19+ , runFrontendWithConfigsAndCurrentRoute
16 , renderFrontendHtml
20 , renderFrontendHtml
21+ , removeHTMLConfigs
22+ , FrontendMode (..)
23+ , FrontendWidgetT
24+ , module Obelisk.Frontend.Cookie
17 ) where
25 ) where
18
26
19import Prelude hiding ((.))
27import Prelude hiding ((.))
20
28
21import Control.Category
29import Control.Category
22−import Control.Concurrent
23import Control.Lens
30import Control.Lens
24−import Control.Monad
25import Control.Monad.Fix
31import Control.Monad.Fix
26import Control.Monad.IO.Class
32import Control.Monad.IO.Class
27import Control.Monad.Primitive
33import Control.Monad.Primitive
34+import Control.Monad.Reader
28import Control.Monad.Ref
35import Control.Monad.Ref
29−import Control.Monad.Trans.Class
36+import Control.Monad.Trans.Maybe (MaybeT(..), runMaybeT)
30import Data.ByteString (ByteString)
37import Data.ByteString (ByteString)
31−import Data.Dependent.Sum (DSum (..))
38+import Data.Foldable (for_)
32import Data.Functor.Sum
39import Data.Functor.Sum
33−import Data.IORef
40+import Data.Map (Map)
34−import GHCJS.DOM hiding (bracket, catch)
41+import Data.Maybe (catMaybes)
35−import GHCJS.DOM.Document
42+import Data.Monoid ((<>))
36−import GHCJS.DOM.Node
43+import Data.Text (Text)
44+import qualified GHCJS.DOM as DOM
37import qualified GHCJS.DOM.Types as DOM
45import qualified GHCJS.DOM.Types as DOM
38−import Language.Javascript.JSaddle (JSM)
46+import qualified GHCJS.DOM.History as DOM
47+import qualified GHCJS.DOM.Window as DOM
48+import Language.Javascript.JSaddle (MonadJSM, JSM, jsNull)
49+import GHCJS.DOM (currentDocument)
50+import "ghcjs-dom" GHCJS.DOM.Document (getHead)
51+import GHCJS.DOM.Node (Node, removeChild_)
52+import GHCJS.DOM.NodeList (IsNodeList, item, getLength)
53+import GHCJS.DOM.ParentNode (querySelectorAll)
54+import Obelisk.Frontend.Cookie
39import Obelisk.Route.Frontend
55import Obelisk.Route.Frontend
40import Reflex.Dom.Core
56import Reflex.Dom.Core
41import Reflex.Host.Class
57import Reflex.Host.Class
42−import qualified Reflex.TriggerEvent.Base as TriggerEvent
58+import Obelisk.Configs
59+import Obelisk.ExecutableConfig.Inject (injectExecutableConfigs)
60+import qualified Obelisk.ExecutableConfig.Lookup as Lookup
61+import Web.Cookie
62+
63+import Debug.Trace
43
64
44makePrisms ''Sum
65makePrisms ''Sum
45
66
46−type ObeliskWidget t x route m =
67+type ObeliskWidget js t route m =
47 ( DomBuilder t m
68 ( DomBuilder t m
48 , MonadFix m
69 , MonadFix m
49 , MonadHold t m
70 , MonadHold t m
@@ -51,8 +72,6 @@ type ObeliskWidget t x route m =
51 , MonadReflexCreateTrigger t m
72 , MonadReflexCreateTrigger t m
52 , PostBuild t m
73 , PostBuild t m
53 , PerformEvent t m
74 , PerformEvent t m
54− , MonadIO m
55− , MonadIO (Performable m)
56 , TriggerEvent t m
75 , TriggerEvent t m
57 , HasDocument m
76 , HasDocument m
58 , MonadRef m
77 , MonadRef m
@@ -61,104 +80,175 @@ type ObeliskWidget t x route m =
61 , Ref (Performable m) ~ Ref IO
80 , Ref (Performable m) ~ Ref IO
62 , MonadFix (Performable m)
81 , MonadFix (Performable m)
63 , PrimMonad m
82 , PrimMonad m
64− , Prerender x m
83+ , Prerender js t m
65− , SetRoute t route m
84+ , PrebuildAgnostic t route m
85+ , PrebuildAgnostic t route (Client m)
86+ , HasConfigs m
87+ , HasCookies m
88+ , MonadIO (Performable m)
89+ )
90+
91+type PrebuildAgnostic t route m =
92+ ( SetRoute t route m
93+ , RouteToUrl route m
94+ , MonadFix m
95+ , HasConfigs m
96+ , HasConfigs (Performable m)
66 )
97 )
67
98
68data Frontend route = Frontend
99data Frontend route = Frontend
69− { _frontend_head :: !(forall t m x. ObeliskWidget t x route m => RoutedT t route m ())
100+ { _frontend_head :: !(forall js t m. ObeliskWidget js t route m => RoutedT t route m ())
70− , _frontend_body :: !(forall t m x. ObeliskWidget t x route m => RoutedT t route m ())
101+ , _frontend_body :: !(forall js t m. ObeliskWidget js t route m => RoutedT t route m ())
71 }
102 }
72
103
73−type Widget' x = ImmediateDomBuilderT DomTimeline (DomCoreWidget x)
104+baseTag :: forall route js t m. ObeliskWidget js t route m => RoutedT t route m ()
74−
105+baseTag = elAttr "base" ("href" =: "/") blank --TODO: Figure out the base URL from the routes
75−-- | A widget that isn't attached to any particular part of the DOM hierarchy
106+
76−type FloatingWidget x = TriggerEventT DomTimeline (DomCoreWidget x)
107+removeHTMLConfigs :: JSM ()
77−
108+removeHTMLConfigs = void $ runMaybeT $ do
78−type DomCoreWidget x = PostBuildT DomTimeline (WithJSContextSingleton x (PerformEventT DomTimeline DomHost))
109+ doc <- MaybeT currentDocument
79−
110+ hd <- MaybeT $ getHead doc
80−--TODO: Rename
111+ es <- nodeListNodes =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
81−{-# INLINABLE attachWidget''' #-}
112+ for_ es $ removeChild_ hd
82−attachWidget'''
113+
83− :: (EventChannel -> PerformEventT DomTimeline (SpiderHost Global) (IORef (Maybe (EventTrigger DomTimeline ()))))
114+-- | Collect all nodes in the node list.
84− -> IO ()
115+--
85−attachWidget''' w = runDomHost $ do
116+-- TODO: this and the version in exe-config/ghcjs/lookup should be
86− events <- liftIO newChan
117+-- upstreamed to jsaddle.
87− (postBuildTriggerRef, fc@(FireCommand fire)) <- hostPerformEventT $ w events
118+nodeListNodes :: (IsNodeList l, MonadJSM m) => l -> m [Node]
88− mPostBuildTrigger <- readRef postBuildTriggerRef
119+nodeListNodes es = do
89− forM_ mPostBuildTrigger $ \postBuildTrigger -> fire [postBuildTrigger :=> Identity ()] $ return ()
120+ len <- getLength es
90− liftIO $ processAsyncEvents events fc
121+ -- Warning! len is unsigned. If the NodeList is empty, we must avoid
91−
122+ -- accidentally traversing over [0..maxBound::Word]
92−--TODO: This is a collection of random stuff; we should make it make some more sense and then upstream to reflex-dom-core
123+ nodes <- traverse (item es) $ if len == 0 then [] else [0..len-1]
93−runWithHeadAndBody
124+ pure $ catMaybes nodes
94− :: ( (forall c. Widget' () c -> FloatingWidget () c) -- "Append to head"
125+
95− -> (forall c. Widget' () c -> FloatingWidget () c) -- "Append to body"
126+setInitialRoute :: Bool -> JSM ()
96− -> FloatingWidget () ()
127+setInitialRoute useHash = do
97− )
128+ traceM "setInitialRoute"
129+ window <- DOM.currentWindowUnchecked
130+ initialLocation <- DOM.getLocation window
131+ initialUri <- getLocationUri initialLocation
132+ history <- DOM.getHistory window
133+ DOM.replaceState history jsNull ("" :: Text) $ Just $
134+ show $ setAdaptedUriPath useHash "/" initialUri
135+
136+data FrontendMode = FrontendMode
137+ { _frontendMode_hydrate :: Bool
138+ -- ^ There is already a rendering of the DOM in place; hydrate it rather
139+ -- than building new DOM
140+ , _frontendMode_adjustRoute :: Bool
141+ -- ^ The page can't use regular routes, so encode routes into the hash
142+ -- instead
143+ }
144+
145+-- | Run the frontend, setting the initial route to "/" on platforms where no
146+-- route exists ambiently in the context (e.g. anything but web).
147+-- Selects FrontendMode based on platform; this doesn't work for jsaddle-warp
148+runFrontend
149+ :: forall backendRoute route
150+ . Encoder Identity Identity (R (FullRoute backendRoute route)) PageName
151+ -> Frontend (R route)
98 -> JSM ()
152 -> JSM ()
99−runWithHeadAndBody app = withJSContextSingletonMono $ \jsSing -> do
100− globalDoc <- currentDocumentUnchecked
101− headFragment <- createDocumentFragment globalDoc
102− bodyFragment <- createDocumentFragment globalDoc
103− unreadyChildren <- liftIO $ newIORef 0
104− let commit = do
105− headElement <- getHeadUnchecked globalDoc
106− bodyElement <- getBodyUnchecked globalDoc
107− void $ inAnimationFrame' $ \_ -> do
108− replaceElementContents headElement headFragment
109− replaceElementContents bodyElement bodyFragment
110− liftIO $ attachWidget''' $ \events -> flip runWithJSContextSingleton jsSing $ do
111− (postBuild, postBuildTriggerRef) <- newEventWithTriggerRef
112− let appendImmediateDom :: DOM.DocumentFragment -> Widget' () c -> FloatingWidget () c
113− appendImmediateDom df w = do
114− events' <- TriggerEvent.askEvents
115− lift $ do
116− doc <- getOwnerDocumentUnchecked df
117− let builderEnv = ImmediateDomBuilderEnv
118− { _immediateDomBuilderEnv_document = doc
119− , _immediateDomBuilderEnv_parent = toNode df
120− , _immediateDomBuilderEnv_unreadyChildren = unreadyChildren
121− , _immediateDomBuilderEnv_commitAction = commit
122− }
123− runImmediateDomBuilderT w builderEnv events'
124− flip runPostBuildT postBuild $ flip runTriggerEventT events $ app (appendImmediateDom headFragment) (appendImmediateDom bodyFragment)
125− liftIO (readIORef unreadyChildren) >>= \case
126− 0 -> DOM.liftJSM commit
127− _ -> return ()
128− return postBuildTriggerRef
129−
130−runFrontend :: forall backendRoute route. Encoder Identity Identity (R (Sum backendRoute (ObeliskRoute route))) PageName -> Frontend (R route) -> JSM ()
131runFrontend validFullEncoder frontend = do
153runFrontend validFullEncoder frontend = do
132− let ve = validFullEncoder . hoistParse errorLeft (prismEncoder (rPrism $ _InR . _ObeliskRoute_App))
154+ let mode = FrontendMode
155+ { _frontendMode_hydrate =
156+#ifdef ghcjs_HOST_OS
157+ True
158+#else
159+ False
160+#endif
161+ , _frontendMode_adjustRoute =
162+#ifdef ghcjs_HOST_OS
163+ False
164+#else
165+ True
166+#endif
167+ }
168+ configs <- liftIO Lookup.getConfigs
169+ when (_frontendMode_hydrate mode) removeHTMLConfigs
170+ -- There's no fundamental reason that adjustRoute needs to control setting the
171+ -- initial route and *also* the useHash parameter; that's why these are
172+ -- separate here. However, currently, they are always the same.
173+ when (_frontendMode_adjustRoute mode) $ do
174+ setInitialRoute $ _frontendMode_adjustRoute mode
175+ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend
176+
177+runFrontendWithConfigsAndCurrentRoute
178+ :: forall backendRoute frontendRoute
179+ . FrontendMode
180+ -> Map Text ByteString
181+ -> Encoder Identity Identity (R (FullRoute backendRoute frontendRoute)) PageName
182+ -> Frontend (R frontendRoute)
183+ -> JSM ()
184+runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend = do
185+ let ve = validFullEncoder . hoistParse errorLeft (reviewEncoder (rPrism $ _FullRoute_Frontend . _ObeliskRoute_App))
133 errorLeft = \case
186 errorLeft = \case
134 Left _ -> error "runFrontend: Unexpected non-app ObeliskRoute reached the frontend. This shouldn't happen."
187 Left _ -> error "runFrontend: Unexpected non-app ObeliskRoute reached the frontend. This shouldn't happen."
135 Right x -> Identity x
188 Right x -> Identity x
136− runMyRouteViewT
189+ w :: ( RawDocument (DomBuilderSpace (HydrationDomBuilderT s DomTimeline m)) ~ DOM.Document
137− :: ( TriggerEvent t m
190+ , Ref (Performable m) ~ Ref IO
138− , PerformEvent t m
191+ , Ref m ~ Ref IO
139− , MonadHold t m
192+ , DomBuilder DomTimeline (HydrationDomBuilderT s DomTimeline m)
193+ , MonadHold DomTimeline m
194+ , MonadRef m
195+ , MonadRef (Performable m)
196+ , MonadReflexCreateTrigger DomTimeline m
197+ , PerformEvent DomTimeline m
198+ , PostBuild DomTimeline m
199+ , PrimMonad m
200+ , MonadSample DomTimeline (Performable m)
140 , DOM.MonadJSM m
201 , DOM.MonadJSM m
141− , DOM.MonadJSM (Performable m)
202+ , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
142− , MonadFix m
143 , MonadFix (Performable m)
203 , MonadFix (Performable m)
204+ , MonadFix m
205+ , Prerender js DomTimeline (HydrationDomBuilderT s DomTimeline m)
206+ , MonadIO (Performable m)
144 )
207 )
145− => RoutedT t (R route) (SetRouteT t (R route) m) a
208+ => (forall c. HydrationDomBuilderT s DomTimeline m c -> FloatingWidget () c)
146− -> m a
209+ -> (forall c. HydrationDomBuilderT s DomTimeline m c -> FloatingWidget () c)
147− runMyRouteViewT = runRouteViewT ve
210+ -> FloatingWidget () ()
148− runWithHeadAndBody $ \appendHead appendBody -> runMyRouteViewT $ do
211+ w appendHead appendBody = do
149− mapRoutedT (mapSetRouteT appendHead) $ _frontend_head frontend
212+ rec switchover <- runRouteViewT ve switchover (_frontendMode_adjustRoute mode) $ do
150− mapRoutedT (mapSetRouteT appendBody) $ _frontend_body frontend
213+ (switchover'', fire) <- newTriggerEvent
214+ mapRoutedT (mapSetRouteT (mapRouteToUrlT (appendHead . runConfigsT configs))) $ do
215+ -- The order here is important - baseTag has to be before headWidget!
216+ baseTag
217+ _frontend_head frontend
218+ mapRoutedT (mapSetRouteT (mapRouteToUrlT (appendBody . runConfigsT configs))) $ do
219+ _frontend_body frontend
220+ switchover' <- case _frontendMode_hydrate mode of
221+ True -> lift $ lift $ lift $ lift $ HydrationDomBuilderT $ asks _hydrationDomBuilderEnv_switchover
222+ False -> getPostBuild
223+ performEvent_ $ liftIO (fire ()) <$ switchover'
224+ pure switchover''
225+ pure ()
226+ if _frontendMode_hydrate mode
227+ then runHydrationWidgetWithHeadAndBody (pure ()) w
228+ else runImmediateWidgetWithHeadAndBody w
229+
230+type FrontendWidgetT r = RoutedT DomTimeline r (SetRouteT DomTimeline r (RouteToUrlT r (ConfigsT (CookiesT (HydratableT (PostBuildT DomTimeline (StaticDomBuilderT DomTimeline (PerformEventT DomTimeline DomHost))))))))
151
231
152renderFrontendHtml
232renderFrontendHtml
153− :: (t ~ SpiderTimeline Global)
233+ :: MonadIO m
154− => r
234+ => Map Text ByteString
155− -> RoutedT t r (SetRouteT t r' (PostBuildT Spider (StaticDomBuilderT Spider (PerformEventT Spider (SpiderHost Global))))) ()
235+ -> Cookies
156− -> RoutedT t r (SetRouteT t r' (PostBuildT Spider (StaticDomBuilderT Spider (PerformEventT Spider (SpiderHost Global))))) ()
236+ -> (r -> Text)
157− -> IO ByteString
237+ -> r
158−renderFrontendHtml route headWidget bodyWidget = do
238+ -> Frontend r
239+ -> FrontendWidgetT r ()
240+ -> FrontendWidgetT r ()
241+ -> m ByteString
242+renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
159 --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
160− html <- fmap snd $ renderStatic $ fmap fst $ runSetRouteT $ flip runRoutedT (pure route) $
244+ html <- fmap snd $ liftIO $ renderStatic $ runHydratableT $ fmap fst $ runCookiesT cookies $ runConfigsT configs $ flip runRouteToUrlT urlEnc $ runSetRouteT $ flip runRoutedT (pure route) $
161 el "html" $ do
245 el "html" $ do
162− el "head" headWidget
246+ el "head" $ do
163− el "body" bodyWidget
247+ baseTag
248+ injectExecutableConfigs configs
249+ _frontend_head frontend
250+ headExtra
251+ el "body" $ do
252+ _frontend_body frontend
253+ bodyExtra
164 return $ "<!DOCTYPE html>" <> html
254 return $ "<!DOCTYPE html>" <> html
lib/frontend/src/Obelisk/Frontend/Cookie.hsnew file+103
@@ -0,0 +1,103 @@
1+{-# LANGUAGE CPP #-}
2+{-# LANGUAGE DataKinds #-}
3+{-# LANGUAGE DefaultSignatures #-}
4+{-# LANGUAGE DeriveFunctor #-}
5+{-# LANGUAGE FlexibleContexts #-}
6+{-# LANGUAGE FlexibleInstances #-}
7+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
8+{-# LANGUAGE MultiParamTypeClasses #-}
9+{-# LANGUAGE PackageImports #-}
10+{-# LANGUAGE RankNTypes #-}
11+{-# LANGUAGE TypeFamilies #-}
12+{-# LANGUAGE UndecidableInstances #-}
13+
14+module Obelisk.Frontend.Cookie where
15+
16+import Control.Monad.Fix
17+import Control.Monad.Primitive
18+import Control.Monad.Ref
19+import Control.Monad.IO.Class
20+import Control.Monad.Trans.Class
21+import Control.Monad.Trans.Reader
22+import Data.Text.Encoding (encodeUtf8)
23+import Reflex
24+import Reflex.Host.Class
25+import Reflex.Dom.Core
26+import "ghcjs-dom" GHCJS.DOM.Document (getCookie, Document)
27+import GHCJS.DOM.Types (MonadJSM)
28+import Web.Cookie
29+
30+import Obelisk.Configs
31+import Obelisk.Route.Frontend
32+
33+class Monad m => HasCookies m where
34+ askCookies :: m Cookies
35+ default askCookies :: (HasCookies m', m ~ t m', MonadTrans t) => m Cookies
36+ askCookies = lift askCookies
37+
38+instance HasCookies m => HasCookies (BehaviorWriterT t w m)
39+instance HasCookies m => HasCookies (DynamicWriterT t w m)
40+instance HasCookies m => HasCookies (EventWriterT t w m)
41+instance HasCookies m => HasCookies (PostBuildT t m)
42+instance HasCookies m => HasCookies (QueryT t q m)
43+instance HasCookies m => HasCookies (ReaderT r m)
44+instance HasCookies m => HasCookies (RequesterT t request response m)
45+instance HasCookies m => HasCookies (RouteToUrlT t m)
46+instance HasCookies m => HasCookies (SetRouteT t r m)
47+instance HasCookies m => HasCookies (StaticDomBuilderT t m)
48+instance HasCookies m => HasCookies (TriggerEventT t m)
49+instance HasCookies m => HasCookies (RoutedT t r m)
50+instance HasCookies m => HasCookies (ConfigsT m)
51+instance HasConfigs m => HasConfigs (CookiesT m)
52+
53+newtype CookiesT m a = CookiesT { unCookiesT :: ReaderT Cookies m a }
54+ deriving
55+ ( Functor
56+ , Applicative
57+ , DomBuilder t
58+ , Monad
59+ , MonadFix
60+ , MonadHold t
61+ , MonadIO
62+#ifndef ghcjs_HOST_OS
63+ , MonadJSM
64+#endif
65+ , MonadRef
66+ , MonadReflexCreateTrigger t
67+ , MonadSample t
68+ , MonadTrans
69+ , NotReady t
70+ , PerformEvent t
71+ , PostBuild t
72+ , Prerender js t
73+ , TriggerEvent t
74+ , HasDocument
75+ )
76+
77+instance Adjustable t m => Adjustable t (CookiesT m) where
78+ runWithReplace a e = CookiesT $ runWithReplace (unCookiesT a) (unCookiesT <$> e)
79+ traverseDMapWithKeyWithAdjust f m e = CookiesT $ traverseDMapWithKeyWithAdjust (\k v -> unCookiesT $ f k v) m e
80+ traverseIntMapWithKeyWithAdjust f m e = CookiesT $ traverseIntMapWithKeyWithAdjust (\k v -> unCookiesT $ f k v) m e
81+ traverseDMapWithKeyWithAdjustWithMove f m e = CookiesT $ traverseDMapWithKeyWithAdjustWithMove (\k v -> unCookiesT $ f k v) m e
82+
83+instance PrimMonad m => PrimMonad (CookiesT m) where
84+ type PrimState (CookiesT m) = PrimState m
85+ primitive = lift . primitive
86+
87+runCookiesT
88+ :: Cookies
89+ -> CookiesT m a
90+ -> m a
91+runCookiesT cs child = runReaderT (unCookiesT child) cs
92+
93+instance Monad m => HasCookies (CookiesT m) where
94+ askCookies = CookiesT ask
95+
96+mapCookiesT
97+ :: (forall x. m x -> n x)
98+ -> CookiesT m a
99+ -> CookiesT n a
100+mapCookiesT f (CookiesT x) = CookiesT $ mapReaderT f x
101+
102+instance (MonadJSM m, RawDocument (DomBuilderSpace (HydrationDomBuilderT s t m)) ~ Document) => HasCookies (HydrationDomBuilderT s t m) where
103+ askCookies = fmap (parseCookies . encodeUtf8) $ getCookie =<< askDocument
lib/migration/obelisk-migration.cabaldeleted−24
@@ -1,24 +0,0 @@
1−name: obelisk-migration
2−version: 0.1
3−license: BSD3
4−build-type: Simple
5−cabal-version: >=1.2
6−
7−library
8− hs-source-dirs: src
9− build-depends:
10− algebraic-graphs >= 0.2
11− , base
12− , containers
13− , directory
14− , exceptions
15− , filepath
16− , mtl
17− , obelisk-cliapp
18− , process
19− , text
20− , transformers
21− exposed-modules:
22− Obelisk.Migration
23− other-modules:
24− ghc-options: -Wall -fobject-code
lib/migration/src/Obelisk/Migration.hsdeleted−223
@@ -1,223 +0,0 @@
1−{-# LANGUAGE FlexibleContexts #-}
2−{-# LANGUAGE LambdaCase #-}
3−{-# LANGUAGE OverloadedStrings #-}
4−{-# LANGUAGE ScopedTypeVariables #-}
5−{-# LANGUAGE TupleSections #-}
6−module Obelisk.Migration where
7−
8−import Control.Monad (forM, forM_, unless, void)
9−import Control.Monad.Except
10−import Control.Monad.IO.Class (MonadIO, liftIO)
11−import Control.Monad.State.Strict (evalStateT, get, put)
12−import Data.Map (Map)
13−import qualified Data.Map as Map
14−import Data.Maybe (catMaybes)
15−import Data.Semigroup ((<>))
16−import Data.Set (Set)
17−import qualified Data.Set as Set
18−import Data.Text (Text)
19−import qualified Data.Text as T
20−import qualified Data.Text.IO as T
21−import System.Directory
22−import System.FilePath
23−
24−import Algebra.Graph.AdjacencyMap
25−
26−type Hash = Text
27−
28−-- Migration graph with edge metadata
29−data Migration action = Migration
30− { _migration_graph :: AdjacencyMap Hash
31− , _migration_actions :: Map (Hash, Hash) action -- Edge metadata
32− }
33− deriving (Eq, Show)
34−
35−-- A path is a list of edges
36−type Path = [(Hash, Hash)]
37−
38−data MigrationError
39− = GraphInternalError Text
40− | CyclicGraphError
41− | MultipleTerminalVertices
42− | NoTerminalVertex
43− | NonEquivalentPaths Hash Hash
44− | MissingEdgeInActionMap (Hash, Hash)
45− | NonLinearGraph_MultipleAdjacents Hash
46− | NonLinearGraph_NotConnected (Set Hash)
47− deriving (Eq, Ord, Show)
48−
49−class Action action where
50− parseEdgeMeta :: Text -> action
51−
52−instance Action Text where
53− parseEdgeMeta = id
54−
55−-- | Get the directed-acylic graph of migration
56−-- TODO: Consider calling getDag only when reading the graph for efficiency.
57−getDag :: (MonadError MigrationError m, Ord a) => AdjacencyMap a -> m (AdjacencyMap a)
58−getDag g = case topSort g of
59− Just _ -> pure g
60− Nothing -> throwError CyclicGraphError
61−
62−-- | Read the graph from a directory of files.
63−readGraph :: Action action => FilePath -> Text -> IO (Maybe (Migration action))
64−readGraph root name = doesDirectoryExist root >>= \case
65− False -> return Nothing
66− True -> do
67− allVertexPairs <- listDirectory root >>= return . catMaybes . fmap getEdgeVertices
68− edgesInfo <- fmap catMaybes $ forM allVertexPairs $ \vs -> do
69− getEdgeFor name vs >>= return . fmap (vs, )
70− return $ pure $ Migration (edges $ fmap fst edgesInfo) (Map.fromList edgesInfo)
71− where
72− getEdgeVertices p = case T.splitOn "-" $ T.pack p of
73− [v1, v2] -> Just (v1, v2)
74− _ -> Nothing
75− getEdgeFor graph (v1, v2) = do
76− let f = root </> (T.unpack $ v1 <> "-" <> v2) </> T.unpack graph
77− doesFileExist f >>= \case
78− True -> do
79− c <- parseEdgeMeta <$> T.readFile f
80− return $ Just c
81− False -> do
82− return Nothing
83−
84−-- | Ensure that the migration graph is correct
85−--
86−-- In a correct migration graph: for all pairs of nodes, all paths between
87−-- those nodes have the same migration value
88−--
89−-- Throw the following if integrity check fails
90−-- * `CyclicGraphError`
91−-- * `NonEquivalentPaths`
92−--
93−-- Complexity: O(V+E)
94−ensureGraphIntegrity
95− :: (MonadError MigrationError m, Monoid action, Ord action)
96− => Migration action -> m ()
97−ensureGraphIntegrity m = do
98− graph <- fmap adjacencyMap $ getDag $ _migration_graph m
99− firstVertex <- getFirst $ _migration_graph m
100− let
101− visitFrom visited acc start = case Map.lookup start graph of
102− Nothing -> pure ()
103− Just adjs -> void $ flip traverse (Set.toList adjs) $ \adj -> do
104− acc' <- fmap (mappend acc) $ getAction m (start, adj)
105− visited' <- case Map.lookup adj visited of
106− Nothing -> pure $ Map.insert adj acc' visited
107− Just adjAcc -> if acc' == adjAcc
108− then pure visited
109− else throwError $ NonEquivalentPaths start adj
110− visitFrom visited' acc' adj
111− -- We only check all paths from the _first_ vertex; it is not necessary to
112− -- check all paths between _all_ pairs of vertices as that can be proved by
113− -- induction, as long as there is exactly one first vertex (which we check on
114− -- further above).
115− visitFrom mempty mempty firstVertex
116−
117−-- | Ensure that the graph is a fully connected linear list
118−--
119−-- Returns the last vertex in the linear list.
120−ensureGraphLinearity :: MonadError MigrationError m => Migration action -> m Hash
121−ensureGraphLinearity m = do
122− graph <- fmap adjacencyMap $ getDag $ _migration_graph m
123− firstVertex <- getFirst $ _migration_graph m
124− let
125− allVertices = vertexSet $ _migration_graph m
126− visitFrom start = case Map.lookup start graph of
127− Nothing -> throwError $ GraphInternalError $ "Vertex not found: " <> start
128− Just adjs -> case (Set.toList adjs) of
129− [] -> pure (start, [start])
130− [adj] -> fmap (start :) <$> visitFrom adj
131− _ -> throwError $ NonLinearGraph_MultipleAdjacents start
132− (lastVertex, visitedVertices) <- visitFrom firstVertex
133− let unvisitedVertices = Set.difference allVertices $ Set.fromList visitedVertices
134− if Set.null unvisitedVertices
135− then pure lastVertex
136− else throwError $ NonLinearGraph_NotConnected unvisitedVertices
137−
138−-- | Find the concatenated actions between two vertices
139−--
140−-- All paths between the vertices must have the same mappend'ed action;
141−-- otherwise this will throw.
142−--
143−-- Complexity: O(V+E)
144−findPathAction
145− :: (MonadError MigrationError m, Action action, Monoid action, Ord action)
146− => Migration action -> Hash -> Hash -> m (Maybe action)
147−findPathAction m start end = flip evalStateT Map.empty $ do
148− graph <- fmap adjacencyMap $ getDag $ _migration_graph m
149− let
150− findPathFromCached start' = do
151− -- TODO: refactor the caching part into a separate `memoize` function
152− cache <- get
153− case Map.lookup start' cache of
154− Just result ->
155− pure result
156− Nothing -> do
157− result <- findPathFrom start'
158− put $ Map.insert start' result cache
159− pure result
160− findPathFrom start' = if start' == end
161− then
162− pure $ Just mempty
163− else case Map.lookup start' graph of
164− Just adjs -> do
165− actions <- fmap catMaybes $ flip traverse (Set.toList adjs) $ \adj -> do
166− action0 <- getAction m (start', adj)
167− actionM <- findPathFromCached adj
168− pure $ fmap (mappend action0) $ actionM
169− case uniqs actions of
170− [] -> pure Nothing
171− [v] -> pure $ Just v -- Exactly one monoidal value; accept.
172− _ -> throwError $ NonEquivalentPaths start' end
173− Nothing ->
174− pure Nothing
175− uniqs = Set.toList . Set.fromList
176− findPathFromCached start
177−
178−hasVertex :: Hash -> Migration action -> Bool
179−hasVertex h (Migration g _) = Set.member h $ vertexSet g
180−
181−-- | Get the action for the given edge (which must exist)
182−getAction :: MonadError MigrationError m => Migration action -> (Hash, Hash) -> m action
183−getAction (Migration _ h) e = case Map.lookup e h of
184− Just v -> pure v
185− Nothing -> throwError $ MissingEdgeInActionMap e
186−
187−-- | Get the last vertex of the given DAG. Nothing if empty graph.
188−--
189−-- Assumes that the graph is fully connected.
190−getLast :: (MonadError MigrationError m, Ord a, Eq a) => AdjacencyMap a -> m a
191−getLast g = lastVertices >>= \case
192− [] -> throwError NoTerminalVertex
193− [x] -> pure x
194− _ -> throwError MultipleTerminalVertices
195− where
196− lastVertices
197− = pure
198− . fmap fst
199− . filter (\(_, nexts) -> nexts == [])
200− . adjacencyList
201− =<< getDag g
202−
203−-- | Get the first vertex of the given DAG. Nothing if empty graph.
204−getFirst :: (MonadError MigrationError m, Ord a, Eq a) => AdjacencyMap a -> m a
205−getFirst = getLast . transpose
206−
207−-- | Write an edge directly to the filesystem.
208−--
209−-- Actions are written with empty string.
210−--
211−-- Return the edge directory created.
212−writeEdge :: MonadIO m => FilePath -> [Text] -> Hash -> Hash -> m (Maybe FilePath)
213−writeEdge dir actionFiles v1 v2 = do
214− unless (v1 /= v2) $
215− fail $ "Cannot create self loop with: " <> T.unpack v1
216− let edgeDir = dir </> (T.unpack $ v1 <> "-" <> v2)
217− liftIO (doesDirectoryExist edgeDir) >>= \case
218− True -> pure Nothing
219− False -> do
220− liftIO $ createDirectory edgeDir
221− forM_ actionFiles $ \fp -> liftIO $
222− writeFile (edgeDir </> T.unpack fp) ""
223− pure $ Just edgeDir
lib/route/README.mdnew file+6
@@ -0,0 +1,6 @@
1+# obelisk-route
2+
3+[![Haskell Programming Language](https://img.shields.io/badge/language-Haskell-blue.svg)](http://www.haskell.org)
4+[![BSD3 License](http://img.shields.io/badge/license-BSD3-brightgreen.svg)](https://github.com/obsidiansystems/obelisk/blob/master/LICENSE)
5+
6+Robust URL management for single-page apps.
lib/route/obelisk-route.cabal+9−3
@@ -6,31 +6,37 @@ build-type: Simple
6library
6library
7 hs-source-dirs: src
7 hs-source-dirs: src
8 build-depends: base,
8 build-depends: base,
9+ aeson,
10+ bytestring,
9 categories,
11 categories,
10 constraints,
12 constraints,
13+ constraints-extras,
11 containers,
14 containers,
12 dependent-map,
15 dependent-map,
13 dependent-sum,
16 dependent-sum,
14− dependent-sum-universe-orphans,
15 dependent-sum-template,
17 dependent-sum-template,
16 either,
18 either,
17 ghcjs-dom,
19 ghcjs-dom,
18 http-types,
20 http-types,
19 jsaddle,
21 jsaddle,
20 lens,
22 lens,
23+ mmorph,
21 monad-control,
24 monad-control,
22 mtl,
25 mtl,
23 network-uri,
26 network-uri,
27+ obelisk-executable-config-lookup,
24 primitive,
28 primitive,
25 ref-tf,
29 ref-tf,
26 reflex,
30 reflex,
27 reflex-dom-core,
31 reflex-dom-core,
28 template-haskell,
32 template-haskell,
33+ tabulation,
29 text,
34 text,
35+ th-extras,
30 transformers,
36 transformers,
31 universe,
37 universe,
32− universe-template
38+ universe-dependent-sum
33 exposed-modules: Obelisk.Route
39 exposed-modules: Obelisk.Route
34 Obelisk.Route.TH
40 Obelisk.Route.TH
35 Obelisk.Route.Frontend
41 Obelisk.Route.Frontend
36− ghc-options: -Wall -fwarn-redundant-constraints
42+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/route/src/Obelisk/Route.hs+479−69
@@ -1,3 +1,4 @@
1+{-# LANGUAGE CPP #-}
1{-# LANGUAGE ApplicativeDo #-}
2{-# LANGUAGE ApplicativeDo #-}
2{-# LANGUAGE ConstraintKinds #-}
3{-# LANGUAGE ConstraintKinds #-}
3{-# LANGUAGE EmptyCase #-}
4{-# LANGUAGE EmptyCase #-}
@@ -5,19 +6,24 @@
5{-# LANGUAGE FlexibleContexts #-}
6{-# LANGUAGE FlexibleContexts #-}
6{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE GADTs #-}
8{-# LANGUAGE GADTs #-}
8−{-# LANGUAGE KindSignatures #-}
9{-# LANGUAGE LambdaCase #-}
9{-# LANGUAGE LambdaCase #-}
10{-# LANGUAGE MultiParamTypeClasses #-}
10{-# LANGUAGE MultiParamTypeClasses #-}
11{-# LANGUAGE OverloadedStrings #-}
11{-# LANGUAGE OverloadedStrings #-}
12{-# LANGUAGE PatternSynonyms #-}
12{-# LANGUAGE PatternSynonyms #-}
13{-# LANGUAGE RankNTypes #-}
13{-# LANGUAGE RankNTypes #-}
14{-# LANGUAGE ScopedTypeVariables #-}
14{-# LANGUAGE ScopedTypeVariables #-}
15+{-# LANGUAGE StandaloneDeriving #-}
15{-# LANGUAGE TemplateHaskell #-}
16{-# LANGUAGE TemplateHaskell #-}
17+{-# LANGUAGE TypeApplications #-}
16{-# LANGUAGE TypeFamilies #-}
18{-# LANGUAGE TypeFamilies #-}
17{-# LANGUAGE TypeOperators #-}
19{-# LANGUAGE TypeOperators #-}
18{-# LANGUAGE ViewPatterns #-}
20{-# LANGUAGE ViewPatterns #-}
19module Obelisk.Route
21module Obelisk.Route
20 ( R
22 ( R
23+ , (:.)
24+ , (?/)
25+ , hoistR
26+ , pattern (:.)
21 , pattern (:/)
27 , pattern (:/)
22 , PageName
28 , PageName
23 , PathQuery
29 , PathQuery
@@ -40,7 +46,11 @@ module Obelisk.Route
40 , checkEnum1EncoderFunc
46 , checkEnum1EncoderFunc
41 , unitEncoder
47 , unitEncoder
42 , pathOnlyEncoder
48 , pathOnlyEncoder
49+ , addPathSegmentEncoder
50+ , pathParamEncoder
51+ , pathLiteralEncoder
43 , singletonListEncoder
52 , singletonListEncoder
53+ , packTextEncoder
44 , unpackTextEncoder
54 , unpackTextEncoder
45 , prefixTextEncoder
55 , prefixTextEncoder
46 , unsafeTshowEncoder
56 , unsafeTshowEncoder
@@ -51,6 +61,7 @@ module Obelisk.Route
51 , justEncoder
61 , justEncoder
52 , nothingEncoder
62 , nothingEncoder
53 , isoEncoder
63 , isoEncoder
64+ , viewEncoder
54 , wrappedEncoder
65 , wrappedEncoder
55 , unwrappedEncoder
66 , unwrappedEncoder
56 , listToNonEmptyEncoder
67 , listToNonEmptyEncoder
@@ -59,11 +70,17 @@ module Obelisk.Route
59 , toListMapEncoder
70 , toListMapEncoder
60 , shadowEncoder
71 , shadowEncoder
61 , prismEncoder
72 , prismEncoder
73+ , reviewEncoder
62 , rPrism
74 , rPrism
75+ , _R
63 , obeliskRouteEncoder
76 , obeliskRouteEncoder
64 , obeliskRouteSegment
77 , obeliskRouteSegment
65 , pageNameEncoder
78 , pageNameEncoder
66 , handleEncoder
79 , handleEncoder
80+ , FullRoute (..)
81+ , _FullRoute_Frontend
82+ , _FullRoute_Backend
83+ , mkFullRouteEncoder
67 , ObeliskRoute (..)
84 , ObeliskRoute (..)
68 , _ObeliskRoute_App
85 , _ObeliskRoute_App
69 , _ObeliskRoute_Resource
86 , _ObeliskRoute_Resource
@@ -78,6 +95,19 @@ module Obelisk.Route
78 , void1Encoder
95 , void1Encoder
79 , pathSegmentsTextEncoder
96 , pathSegmentsTextEncoder
80 , queryParametersTextEncoder
97 , queryParametersTextEncoder
98+ , renderObeliskRoute
99+ , renderBackendRoute
100+ , renderFrontendRoute
101+ , readShowEncoder
102+ , integralEncoder
103+ , pathSegmentEncoder
104+ , queryOnlyEncoder
105+ , Decoder(..)
106+ , dmapEncoder
107+ , fieldMapEncoder
108+ , pathFieldEncoder
109+ , jsonEncoder
110+ , byteStringsToPageName
81 ) where
111 ) where
82
112
83import Prelude hiding ((.), id)
113import Prelude hiding ((.), id)
@@ -88,13 +118,41 @@ import qualified Control.Categorical.Functor as Cat
88import Control.Categorical.Bifunctor
118import Control.Categorical.Bifunctor
89import Control.Category.Associative
119import Control.Category.Associative
90import Control.Category.Monoidal
120import Control.Category.Monoidal
91−import Control.Lens (Identity (..), Prism', makePrisms, itraverse, imap, prism, (^.), re, matching, (^?), _Just, _Nothing, Iso', from, view, Wrapped (..))
121+import Control.Category.Braided
122+import Control.Lens
123+ ( Identity (..)
124+ , (^.)
125+ , (^?)
126+ , _Just
127+ , _Nothing
128+ , Cons(..)
129+ , from
130+ , imap
131+ , iso
132+ , Iso'
133+ , itraverse
134+ , makePrisms
135+ , Prism'
136+ , prism'
137+ , re
138+ , review
139+ , view
140+ , Wrapped (..)
141+ )
92import Control.Monad.Except
142import Control.Monad.Except
93−import Data.Dependent.Sum (DSum (..))
143+import qualified Control.Monad.State.Strict as State
144+import Control.Monad.Trans (lift)
145+import Control.Monad.Writer (execWriter, tell)
146+import Data.Aeson (FromJSON, ToJSON)
147+import qualified Data.Aeson as Aeson
148+import qualified Data.ByteString as BS
149+import qualified Data.ByteString.Lazy as BSL
94import Data.Dependent.Map (DMap)
150import Data.Dependent.Map (DMap)
95import qualified Data.Dependent.Map as DMap
151import qualified Data.Dependent.Map as DMap
152+import Data.Dependent.Sum (DSum (..))
96import Data.Either.Validation (Validation (..))
153import Data.Either.Validation (Validation (..))
97import Data.Foldable
154import Data.Foldable
155+import Data.Functor (($>))
98import Data.Functor.Sum
156import Data.Functor.Sum
99import Data.GADT.Compare
157import Data.GADT.Compare
100import Data.GADT.Compare.TH
158import Data.GADT.Compare.TH
@@ -103,16 +161,20 @@ import Data.List.NonEmpty (NonEmpty (..))
103import Data.Map (Map)
161import Data.Map (Map)
104import qualified Data.Map as Map
162import qualified Data.Map as Map
105import Data.Maybe
163import Data.Maybe
164+import Data.Monoid ((<>))
106import Data.Set (Set)
165import Data.Set (Set)
107import qualified Data.Set as Set
166import qualified Data.Set as Set
108−import Data.Some (Some)
167+import Data.Some (Some(Some))
109−import qualified Data.Some as Some
168+import Data.Tabulation
110−import Data.Some.Universe.Orphans ()
111import Data.Text (Text)
169import Data.Text (Text)
112import qualified Data.Text as T
170import qualified Data.Text as T
113−import Data.Text.Encoding
171+import qualified Data.Text.Encoding as T
172+import Data.Text.Lens (IsText, packed, unpacked)
173+import Data.Type.Equality
114import Data.Universe
174import Data.Universe
175+import Data.Universe.Some
115import Network.HTTP.Types.URI
176import Network.HTTP.Types.URI
177+import qualified Numeric.Lens
116import Obelisk.Route.TH
178import Obelisk.Route.TH
117import Text.Read (readMaybe)
179import Text.Read (readMaybe)
118
180
@@ -140,13 +202,76 @@ import Text.Read (readMaybe)
140
202
141type R f = DSum f Identity --TODO: Better name
203type R f = DSum f Identity --TODO: Better name
142
204
143−--TODO: COMPLETE pragma
205+-- | Convenience builder for an 'R' using 'Identity' for the functor.
144−infixr 5 :/
145pattern (:/) :: f a -> a -> R f
206pattern (:/) :: f a -> a -> R f
146pattern a :/ b = a :=> Identity b
207pattern a :/ b = a :=> Identity b
208+{-# COMPLETE (:/) #-}
209+infixr 5 :/
210+
211+-- | Like '(:/)' but adds a 'Just' wrapper around the right-hand side.
212+(?/) :: f (Maybe a) -> a -> R f
213+r ?/ a = r :/ Just a
214+infixr 5 ?/
147
215
148mapSome :: (forall a. f a -> g a) -> Some f -> Some g
216mapSome :: (forall a. f a -> g a) -> Some f -> Some g
149−mapSome f (Some.This a) = Some.This $ f a
217+mapSome f (Some a) = Some $ f a
218+
219+hoistR :: (forall x. f x -> g x) -> R f -> R g
220+hoistR f (x :=> Identity y) = f x :/ y
221+
222+--------------------------------------------------------------------------------
223+-- Dealing with pairs (i.e. non-dependently-typed subroutes/paths)
224+--------------------------------------------------------------------------------
225+
226+infixr 5 :.
227+type (:.) = (,)
228+
229+#ifdef __GLASGOW_HASKELL__
230+#if __GLASGOW_HASKELL__ >= 810
231+{-# COMPLETE (:.) #-}
232+#else
233+{-# WARNING (:.)
234+ [ "Use of this pattern in GHC < 8.10 will result in spurious non-exhaustive warnings at every use site."
235+ , "We cannot provide a COMPLETE pragma to silence these due to a GHC bug: https://gitlab.haskell.org/ghc/ghc/issues/17729."
236+ , "The bug hides incompleteness warnings for all two tuples when the COMPLETE pattern is in scope."
237+ , "Instead, you should use (,) directly until you can switch to GHC >= 8.10, where the COMPLETE pragma is reinstated."
238+ ]
239+ #-}
240+#endif
241+#endif
242+pattern (:.) :: a -> b -> a :. b
243+pattern a :. b = (a, b)
244+
245+addPathSegmentEncoder
246+ :: ( Applicative check
247+ , MonadError Text parse
248+ )
249+ => Encoder check parse (Text, PageName) PageName
250+addPathSegmentEncoder = unsafeMkEncoder $ EncoderImpl
251+ { _encoderImpl_encode = \(ph, (pt, q)) -> (ph : pt, q)
252+ , _encoderImpl_decode = \(p, q) -> case p of
253+ [] -> throwError "Expected a path segment"
254+ ph : pt -> pure (ph, (pt, q))
255+ }
256+
257+pathParamEncoder
258+ :: forall check parse item rest.
259+ ( Applicative check
260+ , MonadError Text parse
261+ )
262+ => Encoder check parse item Text
263+ -> Encoder check parse rest PageName
264+ -> Encoder check parse (item :. rest) PageName
265+pathParamEncoder itemUnchecked restUnchecked = addPathSegmentEncoder . bimap itemUnchecked restUnchecked
266+
267+pathLiteralEncoder
268+ :: ( Applicative check
269+ , MonadError Text parse
270+ )
271+ => Text
272+ -> Encoder check parse a PageName
273+ -> Encoder check parse a PageName
274+pathLiteralEncoder t e = addPathSegmentEncoder . bimap (unitEncoder t) e . coidl
150
275
151--------------------------------------------------------------------------------
276--------------------------------------------------------------------------------
152-- Encoder fundamentals
277-- Encoder fundamentals
@@ -179,13 +304,13 @@ decode e x = runIdentity (tryDecode e x)
179-- | Once an 'Encoder' has been checked, so that its check monad has become 'Identity', even if the same is not true of the
304-- | Once an 'Encoder' has been checked, so that its check monad has become 'Identity', even if the same is not true of the
180-- parse monad, we may still attempt to decode with it in its parse monad.
305-- parse monad, we may still attempt to decode with it in its parse monad.
181tryDecode :: Encoder Identity parse decoded encoded -> encoded -> parse decoded
306tryDecode :: Encoder Identity parse decoded encoded -> encoded -> parse decoded
182−tryDecode (Encoder (Identity impl)) x = _encoderImpl_decode impl x
307+tryDecode (Encoder (Identity impl)) = _encoderImpl_decode impl
183
308
184−-- | Similar to 'decode' above, once an encoder has been checked so that its check monad is Identity, it
309+-- | Similar to 'decode', once an encoder has been checked so that its check monad is Identity, it
185-- can be used to actually encode by using this. Note that while there's no constraint on the parse monad here,
310-- can be used to actually encode by using this. Note that while there's no constraint on the parse monad here,
186-- one should usually be applying decode and encode to the same 'Encoder'
311-- one should usually be applying decode and encode to the same 'Encoder'
187encode :: Encoder Identity parse decoded encoded -> decoded -> encoded
312encode :: Encoder Identity parse decoded encoded -> decoded -> encoded
188−encode (Encoder (Identity impl)) x = _encoderImpl_encode impl x
313+encode (Encoder (Identity impl)) = _encoderImpl_encode impl
189
314
190-- | This is a primitive used to build encoders which can't fail to check. It should not be used unless one is
315-- | This is a primitive used to build encoders which can't fail to check. It should not be used unless one is
191-- reasonably certain that the law given for 'EncoderImpl' above holds.
316-- reasonably certain that the law given for 'EncoderImpl' above holds.
@@ -231,6 +356,10 @@ instance Monad parse => Bifunctor (,) (EncoderImpl parse) (EncoderImpl parse) (E
231 , _encoderImpl_decode = \(a, b) -> liftA2 (,) (_encoderImpl_decode f a) (_encoderImpl_decode g b)
356 , _encoderImpl_decode = \(a, b) -> liftA2 (,) (_encoderImpl_decode f a) (_encoderImpl_decode g b)
232 }
357 }
233
358
359+instance (Monad parse, Applicative check) => Braided (Encoder check parse) (,) where
360+ braid = viewEncoder (iso swap swap)
361+
362+
234instance (Applicative check, Monad parse) => PFunctor (,) (Encoder check parse) (Encoder check parse) where
363instance (Applicative check, Monad parse) => PFunctor (,) (Encoder check parse) (Encoder check parse) where
235 first f = bimap f id
364 first f = bimap f id
236instance (Applicative check, Monad parse) => QFunctor (,) (Encoder check parse) (Encoder check parse) where
365instance (Applicative check, Monad parse) => QFunctor (,) (Encoder check parse) (Encoder check parse) where
@@ -244,6 +373,34 @@ instance (Traversable f, Monad parse) => Cat.Functor f (EncoderImpl parse) (Enco
244 , _encoderImpl_decode = traverse $ _encoderImpl_decode ve
373 , _encoderImpl_decode = traverse $ _encoderImpl_decode ve
245 }
374 }
246
375
376+instance Monad parse => PFunctor Either (EncoderImpl parse) (EncoderImpl parse) where
377+ first f = bimap f id
378+instance Monad parse => QFunctor Either (EncoderImpl parse) (EncoderImpl parse) where
379+ second g = bimap id g
380+instance Monad parse => Bifunctor Either (EncoderImpl parse) (EncoderImpl parse) (EncoderImpl parse) where
381+ bimap f g = EncoderImpl
382+ { _encoderImpl_encode = bimap (_encoderImpl_encode f) (_encoderImpl_encode g)
383+ , _encoderImpl_decode = \case
384+ Left a -> Left <$> _encoderImpl_decode f a
385+ Right b -> Right <$> _encoderImpl_decode g b
386+ }
387+
388+instance (Monad parse, Applicative check) => QFunctor Either (Encoder check parse) (Encoder check parse) where
389+ second g = bimap id g
390+instance (Monad parse, Applicative check) => PFunctor Either (Encoder check parse) (Encoder check parse) where
391+ first f = bimap f id
392+instance (Monad parse, Applicative check) => Bifunctor Either (Encoder check parse) (Encoder check parse) (Encoder check parse) where
393+ bimap f g = Encoder $ liftA2 bimap (unEncoder f) (unEncoder g)
394+
395+instance (Applicative check, Monad parse) => Associative (Encoder check parse) Either where
396+ associate = viewEncoder (iso (associate @(->) @Either) disassociate)
397+ disassociate = viewEncoder (iso disassociate associate)
398+
399+instance (Monad parse, Applicative check) => Braided (Encoder check parse) Either where
400+ braid = viewEncoder (iso swap swap)
401+
402+
403+
247instance (Traversable f, Monad check, Monad parse) => Cat.Functor f (Encoder check parse) (Encoder check parse) where
404instance (Traversable f, Monad check, Monad parse) => Cat.Functor f (Encoder check parse) (Encoder check parse) where
248 fmap e = Encoder $ do
405 fmap e = Encoder $ do
249 ve <- unEncoder e
406 ve <- unEncoder e
@@ -294,17 +451,17 @@ instance (Applicative check, Monad parse) => Monoidal (Encoder check parse) (,)
294--------------------------------------------------------------------------------
451--------------------------------------------------------------------------------
295
452
296-- | Given a valid 'Iso' from lens, construct an 'Encoder'
453-- | Given a valid 'Iso' from lens, construct an 'Encoder'
297−isoEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
454+viewEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
298−isoEncoder f = unsafeMkEncoder $ EncoderImpl
455+viewEncoder f = unsafeMkEncoder $ EncoderImpl
299 { _encoderImpl_encode = view f
456 { _encoderImpl_encode = view f
300 , _encoderImpl_decode = pure . view (from f)
457 , _encoderImpl_decode = pure . view (from f)
301 }
458 }
302
459
303wrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse (Unwrapped a) a
460wrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse (Unwrapped a) a
304−wrappedEncoder = isoEncoder $ from _Wrapped'
461+wrappedEncoder = viewEncoder $ from _Wrapped'
305
462
306unwrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse a (Unwrapped a)
463unwrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse a (Unwrapped a)
307−unwrappedEncoder = isoEncoder _Wrapped'
464+unwrappedEncoder = viewEncoder $ _Wrapped'
308
465
309maybeToEitherEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a) (Either () a)
466maybeToEitherEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a) (Either () a)
310maybeToEitherEncoder = unsafeMkEncoder $ EncoderImpl
467maybeToEitherEncoder = unsafeMkEncoder $ EncoderImpl
@@ -329,16 +486,16 @@ maybeEncoder f g = shadowEncoder f g . maybeToEitherEncoder
329
486
330-- | Encode a value by simply applying 'Just'
487-- | Encode a value by simply applying 'Just'
331justEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a (Maybe a)
488justEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a (Maybe a)
332−justEncoder = prismEncoder _Just
489+justEncoder = reviewEncoder _Just
333
490
334−-- |
491+-- | Encode () to 'Nothing'.
335nothingEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse () (Maybe a)
492nothingEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse () (Maybe a)
336−nothingEncoder = prismEncoder _Nothing
493+nothingEncoder = reviewEncoder _Nothing
337
494
338someConstEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Const a)) a
495someConstEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Const a)) a
339someConstEncoder = unsafeMkEncoder $ EncoderImpl
496someConstEncoder = unsafeMkEncoder $ EncoderImpl
340− { _encoderImpl_encode = \(Some.This (Const a)) -> a
497+ { _encoderImpl_encode = \(Some (Const a)) -> a
341− , _encoderImpl_decode = pure . Some.This . Const
498+ , _encoderImpl_decode = pure . Some . Const
342 }
499 }
343
500
344-- | WARNING: This is only safe if the Show and Read instances for 'a' are
501-- | WARNING: This is only safe if the Show and Read instances for 'a' are
@@ -366,7 +523,7 @@ checkEnum1EncoderFunc
366 -> check (EncoderFunc check' parse p r)
523 -> check (EncoderFunc check' parse p r)
367checkEnum1EncoderFunc f = do
524checkEnum1EncoderFunc f = do
368 (encoderImpls :: DMap p (Flip (EncoderImpl parse) r)) <- DMap.fromList <$>
525 (encoderImpls :: DMap p (Flip (EncoderImpl parse) r)) <- DMap.fromList <$>
369− traverse (\(Some.This p) -> (p :=>) . Flip <$> unEncoder (f p)) universe
526+ traverse (\(Some p) -> (p :=>) . Flip <$> unEncoder (f p)) universe
370 pure $ EncoderFunc $ \p -> unsafeMkEncoder . unFlip $
527 pure $ EncoderFunc $ \p -> unsafeMkEncoder . unFlip $
371 DMap.findWithDefault (error "checkEnum1EncoderFunc: EncoderImpl not found (should be impossible)") p encoderImpls
528 DMap.findWithDefault (error "checkEnum1EncoderFunc: EncoderImpl not found (should be impossible)") p encoderImpls
372
529
@@ -398,11 +555,11 @@ pathComponentEncoder f = Encoder $ do
398 unEncoder (pathComponentEncoderImpl (enum1Encoder (extractPathSegment . f)) f')
555 unEncoder (pathComponentEncoderImpl (enum1Encoder (extractPathSegment . f)) f')
399
556
400pathComponentEncoderImpl :: forall check parse p. (Monad check, Monad parse)
557pathComponentEncoderImpl :: forall check parse p. (Monad check, Monad parse)
401− => (Encoder check parse (Some p) (Maybe Text))
558+ => Encoder check parse (Some p) (Maybe Text)
402 -> (forall a. p a -> Encoder Identity parse a PageName)
559 -> (forall a. p a -> Encoder Identity parse a PageName)
403 -> Encoder check parse (R p) PageName
560 -> Encoder check parse (R p) PageName
404−pathComponentEncoderImpl this rest =
561+pathComponentEncoderImpl =
405− chainEncoder (lensEncoder (\(_, b) a -> (a, b)) Prelude.fst consEncoder) this rest
562+ chainEncoder (lensEncoder (\(_, b) a -> (a, b)) Prelude.fst consEncoder)
406
563
407--NOTE: Naming convention in this module is to always talk about things in the *encoding* direction, never in the *decoding* direction
564--NOTE: Naming convention in this module is to always talk about things in the *encoding* direction, never in the *decoding* direction
408
565
@@ -421,11 +578,12 @@ chainEncoder cons this rest = Encoder $ do
421 pure $ EncoderImpl
578 pure $ EncoderImpl
422 { _encoderImpl_decode = \v -> do
579 { _encoderImpl_decode = \v -> do
423 (here, following) <- _encoderImpl_decode consValid v
580 (here, following) <- _encoderImpl_decode consValid v
424− Some.This r <- _encoderImpl_decode thisValid here
581+ _encoderImpl_decode thisValid here >>= \case
425− (r :/) <$> _encoderImpl_decode (runIdentity . unEncoder $ rest r) following
582+ Some r ->
583+ (r :/) <$> _encoderImpl_decode (runIdentity . unEncoder $ rest r) following
426 , _encoderImpl_encode = \(r :/ s) ->
584 , _encoderImpl_encode = \(r :/ s) ->
427 _encoderImpl_encode consValid
585 _encoderImpl_encode consValid
428− ( _encoderImpl_encode thisValid $ Some.This r
586+ ( _encoderImpl_encode thisValid $ Some r
429 , _encoderImpl_encode (runIdentity . unEncoder $ rest r) s)
587 , _encoderImpl_encode (runIdentity . unEncoder $ rest r) s)
430 }
588 }
431
589
@@ -492,7 +650,7 @@ enum1Encoder
492 , Show r
650 , Show r
493 )
651 )
494 => (forall a. p a -> r) -> Encoder check parse (Some p) r
652 => (forall a. p a -> r) -> Encoder check parse (Some p) r
495−enum1Encoder f = enumEncoder $ \(Some.This p) -> f p
653+enum1Encoder f = enumEncoder $ \(Some p) -> f p
496
654
497-- | Encode an enumerable, bounded type. WARNING: Don't use this on types that
655-- | Encode an enumerable, bounded type. WARNING: Don't use this on types that
498-- have a large number of values - it will use a lot of memory.
656-- have a large number of values - it will use a lot of memory.
@@ -528,15 +686,18 @@ unitEncoder expected = unsafeMkEncoder $ EncoderImpl
528singlePathSegmentEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse Text PageName
686singlePathSegmentEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse Text PageName
529singlePathSegmentEncoder = pathOnlyEncoder . singletonListEncoder
687singlePathSegmentEncoder = pathOnlyEncoder . singletonListEncoder
530
688
531−pathOnlyEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse [Text] PageName
689+pathOnlyEncoderIgnoringQuery :: (Applicative check, MonadError Text parse) => Encoder check parse [Text] PageName
532−pathOnlyEncoder = unsafeMkEncoder $ EncoderImpl
690+pathOnlyEncoderIgnoringQuery = unsafeMkEncoder $ EncoderImpl
533− { _encoderImpl_decode = \(path, query) ->
691+ { _encoderImpl_decode = \(path, _query) -> pure path
534− if query == mempty
535− then pure path
536− else throwError "pathOnlyEncoderImpl: query was provided"
537 , _encoderImpl_encode = \path -> (path, mempty)
692 , _encoderImpl_encode = \path -> (path, mempty)
538 }
693 }
539
694
695+pathOnlyEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse [Text] PageName
696+pathOnlyEncoder = second (unitEncoder mempty) . coidr
697+
698+queryOnlyEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse (Map Text (Maybe Text)) PageName
699+queryOnlyEncoder = first (unitEncoder []) . coidl
700+
540singletonListEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a [a]
701singletonListEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a [a]
541singletonListEncoder = unsafeMkEncoder $ EncoderImpl
702singletonListEncoder = unsafeMkEncoder $ EncoderImpl
542 { _encoderImpl_decode = \case
703 { _encoderImpl_decode = \case
@@ -578,10 +739,10 @@ queryParametersTextEncoder = Encoder $ pure $ EncoderImpl
578 in (urlDecodeText True k, urlDecodeText True <$> mv)
739 in (urlDecodeText True k, urlDecodeText True <$> mv)
579
740
580urlEncodeText :: Bool -> Text -> Text
741urlEncodeText :: Bool -> Text -> Text
581−urlEncodeText q = decodeUtf8 . urlEncode q . encodeUtf8
742+urlEncodeText q = T.decodeUtf8 . urlEncode q . T.encodeUtf8
582
743
583urlDecodeText :: Bool -> Text -> Text
744urlDecodeText :: Bool -> Text -> Text
584−urlDecodeText q = decodeUtf8 . urlDecode q . encodeUtf8
745+urlDecodeText q = T.decodeUtf8 . urlDecode q . T.encodeUtf8
585
746
586listToNonEmptyEncoder :: (Applicative check, Applicative parse, Monoid a, Eq a) => Encoder check parse [a] (NonEmpty a)
747listToNonEmptyEncoder :: (Applicative check, Applicative parse, Monoid a, Eq a) => Encoder check parse [a] (NonEmpty a)
587listToNonEmptyEncoder = Encoder $ pure $ EncoderImpl
748listToNonEmptyEncoder = Encoder $ pure $ EncoderImpl
@@ -614,11 +775,11 @@ prefixNonemptyTextEncoder p = Encoder $ pure $ EncoderImpl
614 Just stripped -> pure stripped
775 Just stripped -> pure stripped
615 }
776 }
616
777
617−unpackTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse Text String
778+packTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse String text
618−unpackTextEncoder = Encoder $ pure $ EncoderImpl
779+packTextEncoder = isoEncoder packed
619− { _encoderImpl_encode = T.unpack
780+
620− , _encoderImpl_decode = pure . T.pack
781+unpackTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse text String
621− }
782+unpackTextEncoder = isoEncoder unpacked
622
783
623toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
784toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
624toListMapEncoder = Encoder $ pure $ EncoderImpl
785toListMapEncoder = Encoder $ pure $ EncoderImpl
@@ -639,19 +800,63 @@ joinPairTextEncoder = Encoder . \case
639 _ -> return (kt, T.drop (T.length separator) vt)
800 _ -> return (kt, T.drop (T.length separator) vt)
640 }
801 }
641
802
642−--TODO: Rewrite this by composing the given prism with a lens on the first element of the DSum
803+-- This slight generalization of 'rPrism' happens to be enough to write all our
643−-- Or, more likely, the user can compose it themselves
804+-- prism combinators so far.
644−rPrism :: forall f g. (forall a. Prism' (f a) (g a)) -> Prism' (R f) (R g)
805+dSumPrism
645−rPrism p = prism (\(g :/ x) -> g ^. re p :/ x) (\(f :/ x) -> bimap (:/ x) (:/ x) $ matching p f)
806+ :: forall f f' g
807+ . (forall a. Prism' (f a) (f' a))
808+ -> Prism' (DSum f g) (DSum f' g)
809+dSumPrism p = prism'
810+ (\(f' :=> x) -> f' ^. re p :=> x)
811+ (\(f :=> x) -> (:=> x) <$> (f ^? p))
812+
813+-- already in obelisk
814+rPrism
815+ :: forall f f'
816+ . (forall a. Prism' (f a) (f' a))
817+ -> Prism' (R f) (R f')
818+rPrism = dSumPrism
819+
820+dSumPrism'
821+ :: forall f g a
822+ . (forall b. Prism' (f b) (a :~: b))
823+ -> Prism' (DSum f g) (g a)
824+dSumPrism' p = dSumPrism p . iso (\(Refl :=> b) -> b) (Refl :=>)
825+
826+dSumGEqPrism
827+ :: GEq f
828+ => f a
829+ -> Prism' (DSum f g) (g a)
830+dSumGEqPrism variant = dSumPrism' $ prism' (\Refl -> variant) (geq variant)
831+
832+-- | Given a 'tag :: f a', make a prism for 'R f'. This generalizes the usual
833+-- prisms for a sum type (the ones that 'mkPrisms' would make), just as 'R'
834+-- generalized a usual sum type.
835+--
836+-- [This is given the '_R' name of the "cannonical" prism not because it is the
837+-- most general, but because it seems the most useful for routes, and 'R' itself
838+-- trades generality for route-specificity.]
839+_R
840+ :: GEq f
841+ => f a
842+ -> Prism' (R f) a
843+_R variant = dSumGEqPrism variant . iso runIdentity Identity
646
844
647-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
845-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
648-- if the prism doesn't match.
846-- if the prism doesn't match.
649−prismEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
847+--
650−prismEncoder p = unsafeMkEncoder $ EncoderImpl
848+-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
651− { _encoderImpl_encode = (^. re p)
849+-- (i.e. 'reviewEncoder' is a contravariant functor from the category of prisms to the category of encoders),
850+-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
851+-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
852+-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
853+-- reverse direction. In short @reviewEncoder (f . g) = reviewEncoder g . reviewEncoder f@.
854+reviewEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
855+reviewEncoder p = unsafeMkEncoder $ EncoderImpl
856+ { _encoderImpl_encode = review p
652 , _encoderImpl_decode = \r -> case r ^? p of
857 , _encoderImpl_decode = \r -> case r ^? p of
653 Just a -> pure a
858 Just a -> pure a
654− Nothing -> throwError "prismEncoder: value is not present in the prism"
859+ Nothing -> throwError "reviewEncoder: value is not present in the prism"
655 }
860 }
656
861
657-- | A URL path and query string, in which trailing slashes don't matter in the path
862-- | A URL path and query string, in which trailing slashes don't matter in the path
@@ -686,6 +891,45 @@ handleEncoder recover e = Encoder $ do
686-- Actual obelisk route info
891-- Actual obelisk route info
687--------------------------------------------------------------------------------
892--------------------------------------------------------------------------------
688
893
894+-- | The typical full route type comprising all of an Obelisk application's routes.
895+-- Parameterised by the top level GADTs that define backend and frontend routes, respectively.
896+data FullRoute :: (* -> *) -> (* -> *) -> * -> * where
897+ FullRoute_Backend :: br a -> FullRoute br fr a
898+ FullRoute_Frontend :: ObeliskRoute fr a -> FullRoute br fr a
899+
900+instance (GShow br, GShow fr) => GShow (FullRoute br fr) where
901+ gshowsPrec p = \case
902+ FullRoute_Backend x -> showParen (p > 10) (showString "FullRoute_Backend " . gshowsPrec 11 x)
903+ FullRoute_Frontend x -> showParen (p > 10) (showString "FullRoute_Frontend " . gshowsPrec 11 x)
904+
905+instance (GEq br, GEq fr) => GEq (FullRoute br fr) where
906+ geq (FullRoute_Backend x) (FullRoute_Backend y) = geq x y
907+ geq (FullRoute_Frontend x) (FullRoute_Frontend y) = geq x y
908+ geq _ _ = Nothing
909+
910+instance (GCompare br, GCompare fr) => GCompare (FullRoute br fr) where
911+ gcompare (FullRoute_Backend _) (FullRoute_Frontend _) = GLT
912+ gcompare (FullRoute_Frontend _) (FullRoute_Backend _) = GGT
913+ gcompare (FullRoute_Backend x) (FullRoute_Backend y) = gcompare x y
914+ gcompare (FullRoute_Frontend x) (FullRoute_Frontend y) = gcompare x y
915+
916+instance (UniverseSome br, UniverseSome fr) => UniverseSome (FullRoute br fr) where
917+ universeSome = [Some (FullRoute_Backend x) | Some x <- universeSome]
918+ ++ [Some (FullRoute_Frontend x) | Some x <- universeSome]
919+
920+-- | Build the typical top level application route encoder from a route for handling 404's,
921+-- and segment encoders for backend and frontend routes.
922+mkFullRouteEncoder
923+ :: (GCompare br, GCompare fr, GShow br, GShow fr, UniverseSome br, UniverseSome fr)
924+ => R (FullRoute br fr) -- ^ 404 handler
925+ -> (forall a. br a -> SegmentResult (Either Text) (Either Text) a) -- ^ How to encode a single backend route segment
926+ -> (forall a. fr a -> SegmentResult (Either Text) (Either Text) a) -- ^ How to encode a single frontend route segment
927+ -> Encoder (Either Text) Identity (R (FullRoute br fr)) PageName
928+mkFullRouteEncoder missing backendSegment frontendSegment = handleEncoder (const missing) $
929+ pathComponentEncoder $ \case
930+ FullRoute_Backend backendRoute -> backendSegment backendRoute
931+ FullRoute_Frontend obeliskRoute -> obeliskRouteSegment obeliskRoute frontendSegment
932+
689-- | A type which can represent Obelisk-specific resource routes, in addition to application specific routes which serve your
933-- | A type which can represent Obelisk-specific resource routes, in addition to application specific routes which serve your
690-- frontend.
934-- frontend.
691data ObeliskRoute :: (* -> *) -> * -> * where
935data ObeliskRoute :: (* -> *) -> * -> * where
@@ -693,9 +937,11 @@ data ObeliskRoute :: (* -> *) -> * -> * where
693 ObeliskRoute_App :: f a -> ObeliskRoute f a
937 ObeliskRoute_App :: f a -> ObeliskRoute f a
694 ObeliskRoute_Resource :: ResourceRoute a -> ObeliskRoute f a
938 ObeliskRoute_Resource :: ResourceRoute a -> ObeliskRoute f a
695
939
696−instance Universe (Some f) => Universe (Some (ObeliskRoute f)) where
940+instance UniverseSome f => UniverseSome (ObeliskRoute f) where
697− universe = fmap (\(Some.This x) -> Some.This (ObeliskRoute_App x)) universe
941+ universeSome = concat
698− ++ fmap (\(Some.This x) -> Some.This (ObeliskRoute_Resource x)) universe
942+ [ (\(Some x) -> Some (ObeliskRoute_App x)) <$> universe
943+ , (\(Some x) -> Some (ObeliskRoute_Resource x)) <$> universe
944+ ]
699
945
700instance GEq f => GEq (ObeliskRoute f) where
946instance GEq f => GEq (ObeliskRoute f) where
701 geq (ObeliskRoute_App x) (ObeliskRoute_App y) = geq x y
947 geq (ObeliskRoute_App x) (ObeliskRoute_App y) = geq x y
@@ -714,6 +960,7 @@ data ResourceRoute :: * -> * where
714 ResourceRoute_Static :: ResourceRoute [Text] -- This [Text] represents the *path in our static files directory*, not necessarily the URL path that the asset gets served at (although that will often be "/static/this/text/thing")
960 ResourceRoute_Static :: ResourceRoute [Text] -- This [Text] represents the *path in our static files directory*, not necessarily the URL path that the asset gets served at (although that will often be "/static/this/text/thing")
715 ResourceRoute_Ghcjs :: ResourceRoute [Text]
961 ResourceRoute_Ghcjs :: ResourceRoute [Text]
716 ResourceRoute_JSaddleWarp :: ResourceRoute (R JSaddleWarpRoute)
962 ResourceRoute_JSaddleWarp :: ResourceRoute (R JSaddleWarpRoute)
963+ ResourceRoute_Version :: ResourceRoute ()
717
964
718-- | If there are no additional backend routes in your app (i.e. ObeliskRoute gives you all the routes you need),
965-- | If there are no additional backend routes in your app (i.e. ObeliskRoute gives you all the routes you need),
719-- this constructs a suitable 'Encoder' to use for encoding routes to 'PageName's. If you do have additional backend routes,
966-- this constructs a suitable 'Encoder' to use for encoding routes to 'PageName's. If you do have additional backend routes,
@@ -747,9 +994,10 @@ obeliskRouteSegment r appRouteSegment = case r of
747-- be combined with other such segment encoders before 'pathComponentEncoder' turns it into a proper 'Encoder'.
994-- be combined with other such segment encoders before 'pathComponentEncoder' turns it into a proper 'Encoder'.
748resourceRouteSegment :: (MonadError Text check, MonadError Text parse) => ResourceRoute a -> SegmentResult check parse a
995resourceRouteSegment :: (MonadError Text check, MonadError Text parse) => ResourceRoute a -> SegmentResult check parse a
749resourceRouteSegment = \case
996resourceRouteSegment = \case
750− ResourceRoute_Static -> PathSegment "static" $ pathOnlyEncoder
997+ ResourceRoute_Static -> PathSegment "static" pathOnlyEncoderIgnoringQuery
751− ResourceRoute_Ghcjs -> PathSegment "ghcjs" $ pathOnlyEncoder
998+ ResourceRoute_Ghcjs -> PathSegment "ghcjs" pathOnlyEncoder
752− ResourceRoute_JSaddleWarp -> PathSegment "jsaddle" $ jsaddleWarpRouteEncoder
999+ ResourceRoute_JSaddleWarp -> PathSegment "jsaddle" jsaddleWarpRouteEncoder
1000+ ResourceRoute_Version -> PathSegment "version" $ unitEncoder mempty
753
1001
754data JSaddleWarpRoute :: * -> * where
1002data JSaddleWarpRoute :: * -> * where
755 JSaddleWarpRoute_JavaScript :: JSaddleWarpRoute ()
1003 JSaddleWarpRoute_JavaScript :: JSaddleWarpRoute ()
@@ -760,7 +1008,7 @@ jsaddleWarpRouteEncoder :: (MonadError Text check, MonadError Text parse) => Enc
760jsaddleWarpRouteEncoder = pathComponentEncoder $ \case
1008jsaddleWarpRouteEncoder = pathComponentEncoder $ \case
761 JSaddleWarpRoute_JavaScript -> PathSegment "jsaddle.js" $ unitEncoder mempty
1009 JSaddleWarpRoute_JavaScript -> PathSegment "jsaddle.js" $ unitEncoder mempty
762 JSaddleWarpRoute_WebSocket -> PathEnd $ unitEncoder mempty
1010 JSaddleWarpRoute_WebSocket -> PathEnd $ unitEncoder mempty
763− JSaddleWarpRoute_Sync -> PathSegment "sync" $ pathOnlyEncoder
1011+ JSaddleWarpRoute_Sync -> PathSegment "sync" pathOnlyEncoder
764
1012
765instance GShow appRoute => GShow (ObeliskRoute appRoute) where
1013instance GShow appRoute => GShow (ObeliskRoute appRoute) where
766 gshowsPrec prec = \case
1014 gshowsPrec prec = \case
@@ -781,29 +1029,193 @@ indexOnlyRouteEncoder = pathComponentEncoder indexOnlyRouteSegment
781
1029
782someSumEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Sum a b)) (Either (Some a) (Some b))
1030someSumEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Sum a b)) (Either (Some a) (Some b))
783someSumEncoder = Encoder $ pure $ EncoderImpl
1031someSumEncoder = Encoder $ pure $ EncoderImpl
784− { _encoderImpl_encode = \(Some.This t) -> case t of
1032+ { _encoderImpl_encode = \(Some t) -> case t of
785− InL l -> Left $ Some.This l
1033+ InL l -> Left $ Some l
786− InR r -> Right $ Some.This r
1034+ InR r -> Right $ Some r
787 , _encoderImpl_decode = pure . \case
1035 , _encoderImpl_decode = pure . \case
788− Left (Some.This l) -> Some.This (InL l)
1036+ Left (Some l) -> Some (InL l)
789− Right (Some.This r) -> Some.This (InR r)
1037+ Right (Some r) -> Some (InR r)
790 }
1038 }
791
1039
792data Void1 :: * -> * where {}
1040data Void1 :: * -> * where {}
793
1041
794−instance Universe (Some Void1) where
1042+instance UniverseSome Void1 where
795− universe = []
1043+ universeSome = []
796
1044
797void1Encoder :: (Applicative check, MonadError Text parse) => Encoder check parse (Some Void1) a
1045void1Encoder :: (Applicative check, MonadError Text parse) => Encoder check parse (Some Void1) a
798void1Encoder = Encoder $ pure $ EncoderImpl
1046void1Encoder = Encoder $ pure $ EncoderImpl
799 { _encoderImpl_encode = \case
1047 { _encoderImpl_encode = \case
800− Some.This f -> case f of {}
1048+ Some f -> case f of {}
801 , _encoderImpl_decode = \_ -> throwError "void1Encoder: can't decode anything"
1049 , _encoderImpl_decode = \_ -> throwError "void1Encoder: can't decode anything"
802 }
1050 }
803
1051
804instance GShow Void1 where
1052instance GShow Void1 where
805 gshowsPrec _ = \case {}
1053 gshowsPrec _ = \case {}
806
1054
1055+-- | Given a backend route and a checked route encoder, render the route (path
1056+-- and query string). See 'checkEncoder' for how to produce a checked encoder.
1057+renderBackendRoute
1058+ :: forall br a.
1059+ Encoder Identity Identity (R (FullRoute br a)) PageName
1060+ -> R br
1061+ -> Text
1062+renderBackendRoute enc = renderObeliskRoute enc . hoistR FullRoute_Backend
1063+
1064+-- | Renders a frontend route with the supplied checked encoder
1065+renderFrontendRoute
1066+ :: forall a fr.
1067+ Encoder Identity Identity (R (FullRoute a fr)) PageName
1068+ -> R fr
1069+ -> Text
1070+renderFrontendRoute enc = renderObeliskRoute enc . hoistR (FullRoute_Frontend . ObeliskRoute_App)
1071+
1072+-- | Renders a route of the form typically found in an Obelisk project
1073+renderObeliskRoute
1074+ :: forall a b.
1075+ Encoder Identity Identity (R (FullRoute a b)) PageName
1076+ -> R (FullRoute a b)
1077+ -> Text
1078+renderObeliskRoute e r =
1079+ let enc :: Encoder Identity (Either Text) (R (FullRoute a b)) PathQuery
1080+ enc = (pageNameEncoder . hoistParse (pure . runIdentity) e)
1081+ in (T.pack . uncurry (<>)) $ encode enc r
1082+
1083+readShowEncoder :: (MonadError Text parse, Read a, Show a, Applicative check) => Encoder check parse a PageName
1084+readShowEncoder = singlePathSegmentEncoder . unsafeTshowEncoder
1085+
1086+integralEncoder :: (MonadError Text parse, Applicative check, Integral a) => Encoder check parse a Integer
1087+integralEncoder = reviewEncoder Numeric.Lens.integral
1088+
1089+pathSegmentEncoder :: (MonadError Text parse, Applicative check, Cons as as a a) =>
1090+ Encoder check parse (a, (as, b)) (as, b)
1091+pathSegmentEncoder = first (reviewEncoder _Cons) . disassociate
1092+
1093+newtype Decoder check parse b a = Decoder { toEncoder :: Encoder check parse a b }
1094+
1095+dmapEncoder :: forall check parse k k' v.
1096+ ( Monad check
1097+ , MonadError Text parse
1098+ , Universe (Some k')
1099+ , Ord k
1100+ , GCompare k'
1101+ , GShow k'
1102+ )
1103+ => Encoder check parse (Some k') k
1104+ -> (forall v'. k' v' -> Encoder check parse v' v)
1105+ -> Encoder check parse (DMap k' Identity) (Map k v)
1106+dmapEncoder keyEncoder' valueEncoderFor = unsafeEncoder $ do
1107+ keyEncoder :: Encoder Identity parse (Some k') k <- checkEncoder keyEncoder'
1108+ valueDecoders :: DMap k' (Decoder Identity parse v) <- fmap DMap.fromList . forM universe $ \(Some (k' :: k' t)) -> do
1109+ ve :: Encoder Identity parse t v <- checkEncoder (valueEncoderFor k')
1110+ return $ (k' :: k' t) :=> (Decoder ve :: Decoder Identity parse v t)
1111+ let keyError k = "dmapEncoder: key `" <> k <> "' was missing from the Universe instance for its type."
1112+ return $ EncoderImpl
1113+ { _encoderImpl_encode = \dm -> Map.fromList $ do
1114+ ((k' :: k' t) :=> Identity v') <- DMap.toList dm
1115+ return ( encode keyEncoder (Some k')
1116+ , encode (toEncoder (DMap.findWithDefault (error . keyError $ gshow k') k' valueDecoders)) v'
1117+ )
1118+ , _encoderImpl_decode = \m -> fmap DMap.fromList . forM (Map.toList m) $ \(k,v) -> do
1119+ tryDecode keyEncoder k >>= \case
1120+ Some (k' :: k' t) -> case DMap.lookup k' valueDecoders of
1121+ Nothing -> throwError . T.pack . keyError $ gshow k'
1122+ Just (Decoder e) -> do
1123+ v' <- tryDecode e v
1124+ return (k' :=> Identity v')
1125+ }
1126+
1127+fieldMapEncoder :: forall check parse r.
1128+ ( Applicative check
1129+ , MonadError Text parse
1130+ , HasFields r
1131+ , Universe (Some (Field r))
1132+ , GShow (Field r)
1133+ , GCompare (Field r)
1134+ )
1135+ => Encoder check parse r (DMap (Field r) Identity)
1136+fieldMapEncoder = unsafeEncoder $ do
1137+ pure $ EncoderImpl
1138+ { _encoderImpl_encode = \r -> DMap.fromList [ f :=> Identity (indexField r f) | Some f <- universe ]
1139+ , _encoderImpl_decode = \dm -> tabulateFieldsA $ \f -> do
1140+ case DMap.lookup f dm of
1141+ Nothing -> throwError $ "fieldMapEncoder: Couldn't find key for `" <> T.pack (gshow f) <> "' in DMap."
1142+ Just (Identity v) -> return v
1143+ }
1144+
1145+-- this is in base 4.12 (GHC 8.6);
1146+newtype Ap f a = Ap {getAp :: f a}
1147+
1148+instance (Applicative f, Semigroup a) => Semigroup (Ap f a) where
1149+ Ap x <> Ap y = Ap (liftA2 (<>) x y)
1150+
1151+instance (Applicative f, Monoid a) => Monoid (Ap f a) where
1152+ mappend = (<>)
1153+ mempty = Ap (pure mempty)
1154+
1155+pathFieldEncoder :: forall a p check parse . (HasFields a, Monad check, MonadError Text parse, GCompare (Field a)) => (forall x. Field a x -> Encoder check parse x p) -> Encoder check parse (a, [p]) [p]
1156+pathFieldEncoder fieldEncoder = unsafeEncoder $ do
1157+ fieldEncoderPureMap :: DMap.DMap (Field a) (Decoder Identity parse p) <- getAp $ getConst $ tabulateFieldsA @a $ \f -> Const (Ap $ fmap (DMap.singleton f . Decoder) $ (checkEncoder @Identity) $ fieldEncoder f)
1158+ let fieldEncoderPure :: forall x. Field a x -> Encoder Identity parse x p
1159+ fieldEncoderPure f = toEncoder (DMap.findWithDefault (error "bad") f fieldEncoderPureMap)
1160+ pure $ EncoderImpl
1161+ { _encoderImpl_encode = \(x, rest) -> execWriter $ do
1162+ _ <- traverseWithField (\f x_i -> tell (pure $ encode (fieldEncoderPure f) x_i) $> x_i) x
1163+ tell rest
1164+ , _encoderImpl_decode = State.runStateT $ tabulateFieldsA $ \f -> State.get >>= \case
1165+ [] -> throwError $ T.pack "not enough path components"
1166+ p:ps -> do
1167+ State.put ps
1168+ lift $ tryDecode (fieldEncoderPure f) p
1169+ }
1170+
1171+-- | Use ToJSON/FromJSON to encode to Text. The correctness of this encoder is dependent on the encoding being injective and round-tripping correctly.
1172+jsonEncoder :: forall check parse r.
1173+ ( ToJSON r
1174+ , FromJSON r
1175+ , Applicative check
1176+ , MonadError Text parse
1177+ )
1178+ => Encoder check parse r Text
1179+jsonEncoder = unsafeEncoder $ do
1180+ pure $ EncoderImpl
1181+ { _encoderImpl_encode = \r -> T.decodeUtf8 . BSL.toStrict $ Aeson.encode r
1182+ , _encoderImpl_decode = \t -> case Aeson.eitherDecodeStrict $ T.encodeUtf8 t of
1183+ Left err -> throwError ("jsonEncoder: " <> T.pack err)
1184+ Right x -> return x
1185+ }
1186+
1187+-- Useful for app server integration.
1188+-- p must not start with slashes
1189+byteStringsToPageName :: BS.ByteString -> BS.ByteString -> PageName
1190+byteStringsToPageName p q =
1191+ let pageNameEncoder' :: Encoder Identity Identity PageName (String, String)
1192+ pageNameEncoder' = bimap
1193+ (unpackTextEncoder . pathSegmentsTextEncoder . listToNonEmptyEncoder)
1194+ (unpackTextEncoder . queryParametersTextEncoder . toListMapEncoder)
1195+ in decode pageNameEncoder' (T.unpack (T.decodeUtf8 p), T.unpack (T.decodeUtf8 q))
1196+
1197+--TODO: decodeURIComponent as appropriate
1198+
1199+
1200+{-# DEPRECATED isoEncoder "Instead of 'isoEncoder f', use 'viewEncoder f'" #-}
1201+-- | Given a valid 'Iso' from lens, construct an 'Encoder'
1202+isoEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
1203+isoEncoder = viewEncoder
1204+
1205+{-# DEPRECATED prismEncoder "Instead of 'prismEncoder f', use 'reviewEncoder f'" #-}
1206+-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
1207+-- if the prism doesn't match.
1208+--
1209+-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
1210+-- (i.e. 'prismEncoder' is a contravariant functor from the category of prisms to the category of encoders),
1211+-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
1212+-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
1213+-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
1214+-- reverse direction. In short @prismEncoder (f . g) = prismEncoder g . prismEncoder f@.
1215+prismEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
1216+prismEncoder = reviewEncoder
1217+
1218+
807concat <$> mapM deriveRouteComponent
1219concat <$> mapM deriveRouteComponent
808 [ ''ResourceRoute
1220 [ ''ResourceRoute
809 , ''JSaddleWarpRoute
1221 , ''JSaddleWarpRoute
@@ -811,8 +1223,6 @@ concat <$> mapM deriveRouteComponent
811 ]
1223 ]
812
1224
813makePrisms ''ObeliskRoute
1225makePrisms ''ObeliskRoute
814−
1226+makePrisms ''FullRoute
815deriveGEq ''Void1
1227deriveGEq ''Void1
816deriveGCompare ''Void1
1228deriveGCompare ''Void1
817−
818−--TODO: decodeURIComponent as appropriate
lib/route/src/Obelisk/Route/Frontend.hs+383−67
@@ -1,26 +1,24 @@
1−{-# LANGUAGE ApplicativeDo #-}
2{-# LANGUAGE CPP #-}
1{-# LANGUAGE CPP #-}
3−{-# LANGUAGE RecursiveDo #-}
2+{-# LANGUAGE ApplicativeDo #-}
4−{-# LANGUAGE StandaloneDeriving #-}
5{-# LANGUAGE ConstraintKinds #-}
3{-# LANGUAGE ConstraintKinds #-}
4+{-# LANGUAGE DataKinds #-}
5+{-# LANGUAGE DefaultSignatures #-}
6{-# LANGUAGE FlexibleContexts #-}
6{-# LANGUAGE FlexibleContexts #-}
7{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE FlexibleInstances #-}
8+{-# LANGUAGE FunctionalDependencies #-}
8{-# LANGUAGE GADTs #-}
9{-# LANGUAGE GADTs #-}
9−{-# LANGUAGE KindSignatures #-}
10+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
10{-# LANGUAGE LambdaCase #-}
11{-# LANGUAGE LambdaCase #-}
11−{-# LANGUAGE MultiParamTypeClasses #-}
12{-# LANGUAGE OverloadedStrings #-}
12{-# LANGUAGE OverloadedStrings #-}
13{-# LANGUAGE PatternSynonyms #-}
13{-# LANGUAGE PatternSynonyms #-}
14{-# LANGUAGE RankNTypes #-}
14{-# LANGUAGE RankNTypes #-}
15+{-# LANGUAGE RecursiveDo #-}
15{-# LANGUAGE ScopedTypeVariables #-}
16{-# LANGUAGE ScopedTypeVariables #-}
16−{-# LANGUAGE TemplateHaskell #-}
17+{-# LANGUAGE StandaloneDeriving #-}
17{-# LANGUAGE TypeFamilies #-}
18{-# LANGUAGE TypeFamilies #-}
18{-# LANGUAGE TypeOperators #-}
19{-# LANGUAGE TypeOperators #-}
19−{-# LANGUAGE ViewPatterns #-}
20−{-# LANGUAGE GeneralizedNewtypeDeriving #-}
21{-# LANGUAGE UndecidableInstances #-}
20{-# LANGUAGE UndecidableInstances #-}
22−{-# LANGUAGE DataKinds #-}
21+{-# LANGUAGE ViewPatterns #-}
23−{-# LANGUAGE FunctionalDependencies #-}
24
22
25module Obelisk.Route.Frontend
23module Obelisk.Route.Frontend
26 ( module Obelisk.Route
24 ( module Obelisk.Route
@@ -33,72 +31,115 @@ module Obelisk.Route.Frontend
33 , mapRoutedT
31 , mapRoutedT
34 , subRoute
32 , subRoute
35 , subRoute_
33 , subRoute_
34+ , subPairRoute
35+ , subPairRoute_
36 , maybeRoute
36 , maybeRoute
37 , maybeRoute_
37 , maybeRoute_
38 , maybeRouted
38 , maybeRouted
39+ , eitherRoute
40+ , eitherRoute_
41+ , eitherRouted
39 , runRouteViewT
42 , runRouteViewT
40 , SetRouteT(..)
43 , SetRouteT(..)
41 , SetRoute(..)
44 , SetRoute(..)
42 , runSetRouteT
45 , runSetRouteT
43 , mapSetRouteT
46 , mapSetRouteT
47+ , RouteToUrl(..)
48+ , RouteToUrlT(..)
49+ , runRouteToUrlT
50+ , mapRouteToUrlT
51+ , routeLink
52+ , routeLinkDynAttr
53+ , dynRouteLink
54+ , adaptedUriPath
55+ , setAdaptedUriPath
44 ) where
56 ) where
45
57
46import Prelude hiding ((.), id)
58import Prelude hiding ((.), id)
47
59
48−import Obelisk.Route
49−
50import Control.Category (Category (..), (.))
60import Control.Category (Category (..), (.))
51−import Control.Category.Cartesian
61+import Control.Category.Cartesian ((&&&))
52−import Control.Lens hiding (Bifunctor, bimap, universe)
62+import Control.Lens hiding (Bifunctor, bimap, universe, element)
63+import Control.Monad ((<=<))
53import Control.Monad.Fix
64import Control.Monad.Fix
65+import Control.Monad.Morph
54import Control.Monad.Primitive
66import Control.Monad.Primitive
67+import Control.Monad.Reader
55import Control.Monad.Ref
68import Control.Monad.Ref
56−import Control.Monad.Trans
57import Control.Monad.Trans.Control
69import Control.Monad.Trans.Control
58−import Control.Monad.Trans.Reader
59import Data.Coerce
70import Data.Coerce
60−import Data.Constraint (Dict (..))
61import Data.Dependent.Sum (DSum (..))
71import Data.Dependent.Sum (DSum (..))
72+import Data.Functor.Compose
73+import Data.Functor.Misc
62import Data.GADT.Compare
74import Data.GADT.Compare
75+import qualified Data.List as L
76+import Data.Map (Map)
77+import Data.Maybe (fromMaybe)
63import Data.Monoid
78import Data.Monoid
79+import Data.Proxy
80+import Data.Text (Text)
64import qualified Data.Text as T
81import qualified Data.Text as T
65−import Data.Functor.Compose
66−import Reflex.Class
67−import Reflex.Host.Class
68−import Reflex.PostBuild.Class
69−import Reflex.TriggerEvent.Class
70−import Reflex.PerformEvent.Class
71−import Reflex.EventWriter.Class
72−import Reflex.EventWriter.Base
73−import Reflex.Dynamic
74−import Reflex.Dom.Builder.Class
75import Data.Type.Coercion
82import Data.Type.Coercion
76−import Language.Javascript.JSaddle --TODO: Get rid of this - other platforms can also be routed
83+import qualified GHCJS.DOM as DOM
77−import Reflex.Dom.Core
78import qualified GHCJS.DOM.Types as DOM
84import qualified GHCJS.DOM.Types as DOM
85+import qualified GHCJS.DOM.Window as Window
86+import Language.Javascript.JSaddle (MonadJSM, jsNull, liftJSM) --TODO: Get rid of this - other platforms can also be routed
79import Network.URI
87import Network.URI
80−#if defined(ios_HOST_OS)
88+import Reflex.Class
81−import Data.Maybe (fromMaybe)
89+import Reflex.Dom.Builder.Class
82−import qualified Data.List as L
90+import Reflex.Dom.Core
83−#endif
91+import Reflex.Host.Class
84−
85import Unsafe.Coerce
92import Unsafe.Coerce
86
93
94+import Obelisk.Configs
95+import Obelisk.Route
96+
87infixr 5 :~
97infixr 5 :~
88pattern (:~) :: Reflex t => f a -> Dynamic t a -> DSum f (Compose (Dynamic t) Identity)
98pattern (:~) :: Reflex t => f a -> Dynamic t a -> DSum f (Compose (Dynamic t) Identity)
89pattern a :~ b <- a :=> (coerceDynamic . getCompose -> b)
99pattern a :~ b <- a :=> (coerceDynamic . getCompose -> b)
90
100
91class Routed t r m | m -> t r where
101class Routed t r m | m -> t r where
92 askRoute :: m (Dynamic t r)
102 askRoute :: m (Dynamic t r)
103+ default askRoute :: (Monad m', MonadTrans f, Routed t r m', m ~ f m') => m (Dynamic t r)
104+ askRoute = lift askRoute
93
105
94instance Monad m => Routed t r (RoutedT t r m) where
106instance Monad m => Routed t r (RoutedT t r m) where
95 askRoute = RoutedT ask
107 askRoute = RoutedT ask
96
108
97−newtype RoutedT t r m a = RoutedT { unRoutedT :: ReaderT (Dynamic t r) m a }
109+instance (Monad m, Routed t r m) => Routed t r (ReaderT r' m)
98− deriving (Functor, Applicative, Monad, MonadFix, MonadTrans, NotReady t, MonadHold t, MonadSample t, PostBuild t, TriggerEvent t, HasJSContext, MonadIO, MonadReflexCreateTrigger t, HasDocument)
99
110
100−instance Prerender js m => Prerender js (RoutedT t r m) where
111+newtype RoutedT t r m a = RoutedT { unRoutedT :: ReaderT (Dynamic t r) m a }
101− prerenderClientDict = fmap (\Dict -> Dict) (prerenderClientDict :: Maybe (Dict (PrerenderClientConstraint js m)))
112+ deriving
113+ ( Functor
114+ , Applicative
115+ , Monad
116+ , MonadFix
117+ , MonadTrans
118+ , MFunctor
119+ , NotReady t
120+ , MonadHold t
121+ , MonadSample t
122+ , PostBuild t
123+ , TriggerEvent t
124+ , MonadIO
125+ , MonadReflexCreateTrigger t
126+ , HasDocument
127+ , DomRenderHook t
128+ )
129+
130+instance MonadReader r' m => MonadReader r' (RoutedT t r m) where
131+ ask = lift ask
132+ local = mapRoutedT . local
133+
134+instance HasJSContext m => HasJSContext (RoutedT t r m) where
135+ type JSContextPhantom (RoutedT t r m) = JSContextPhantom m
136+ askJSContext = lift askJSContext
137+
138+instance (Prerender js t m, Monad m) => Prerender js t (RoutedT t r m) where
139+ type Client (RoutedT t r m) = RoutedT t r (Client m)
140+ prerender server client = RoutedT $ do
141+ r <- ask
142+ lift $ prerender (runRoutedT server r) (runRoutedT client r)
102
143
103instance Requester t m => Requester t (RoutedT t r m) where
144instance Requester t m => Requester t (RoutedT t r m) where
104 type Request (RoutedT t r m) = Request m
145 type Request (RoutedT t r m) = Request m
@@ -150,10 +191,24 @@ instance (Monad m, MonadQuery t vs m) => MonadQuery t vs (RoutedT t r m) where
150 askQueryResult = lift askQueryResult
191 askQueryResult = lift askQueryResult
151 queryIncremental = lift . queryIncremental
192 queryIncremental = lift . queryIncremental
152
193
194+instance HasConfigs m => HasConfigs (RoutedT t r m)
195+
196+instance (Monad m, RouteToUrl r m) => RouteToUrl r (QueryT t q m)
197+
198+instance (Monad m, SetRoute t r m) => SetRoute t r (QueryT t q m)
199+
200+instance (Monad m, RouteToUrl r m) => RouteToUrl r (EventWriterT t w m)
201+
202+instance (Monad m, SetRoute t r m) => SetRoute t r (EventWriterT t w m)
203+
204+instance (Monad m, RouteToUrl r m) => RouteToUrl r (DynamicWriterT t w m)
205+
206+instance (Monad m, SetRoute t r m) => SetRoute t r (DynamicWriterT t w m)
207+
153runRoutedT :: RoutedT t r m a -> Dynamic t r -> m a
208runRoutedT :: RoutedT t r m a -> Dynamic t r -> m a
154runRoutedT = runReaderT . unRoutedT
209runRoutedT = runReaderT . unRoutedT
155
210
156−mapRoutedT :: (m a -> n a) -> RoutedT t r m a -> RoutedT t r n a
211+mapRoutedT :: (m a -> n b) -> RoutedT t r m a -> RoutedT t r n b
157mapRoutedT f = RoutedT . mapReaderT f . unRoutedT
212mapRoutedT f = RoutedT . mapReaderT f . unRoutedT
158
213
159withRoutedT :: (Dynamic t r -> Dynamic t r') -> RoutedT t r' m a -> RoutedT t r m a
214withRoutedT :: (Dynamic t r -> Dynamic t r') -> RoutedT t r' m a -> RoutedT t r m a
@@ -163,10 +218,18 @@ subRoute_ :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r
163subRoute_ f = factorRouted $ strictDynWidget_ $ \(c :=> r') -> do
218subRoute_ f = factorRouted $ strictDynWidget_ $ \(c :=> r') -> do
164 runRoutedT (f c) r'
219 runRoutedT (f c) r'
165
220
221+-- | Like 'subRoute_', but with a pair rather than an R
222+subPairRoute_ :: (MonadFix m, MonadHold t m, Eq a, Adjustable t m) => (a -> RoutedT t b m ()) -> RoutedT t (a, b) m ()
223+subPairRoute_ f = withRoutedT (fmap (\(a, b) -> Const2 a :/ b)) $ subRoute_ (\(Const2 a) -> f a)
224+
166subRoute :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r a -> RoutedT t a m b) -> RoutedT t (R r) m (Dynamic t b)
225subRoute :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r a -> RoutedT t a m b) -> RoutedT t (R r) m (Dynamic t b)
167subRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
226subRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
168 runRoutedT (f c) r'
227 runRoutedT (f c) r'
169
228
229+-- | Like 'subRoute_', but with a pair rather than an R
230+subPairRoute :: (MonadFix m, MonadHold t m, Eq a, Adjustable t m) => (a -> RoutedT t b m c) -> RoutedT t (a, b) m (Dynamic t c)
231+subPairRoute f = withRoutedT (fmap (\(a, b) -> Const2 a :/ b)) $ subRoute (\(Const2 a) -> f a)
232+
170maybeRoute_ :: (MonadFix m, MonadHold t m, Adjustable t m) => m () -> RoutedT t r m () -> RoutedT t (Maybe r) m ()
233maybeRoute_ :: (MonadFix m, MonadHold t m, Adjustable t m) => m () -> RoutedT t r m () -> RoutedT t (Maybe r) m ()
171maybeRoute_ n j = maybeRouted $ strictDynWidget_ $ \case
234maybeRoute_ n j = maybeRouted $ strictDynWidget_ $ \case
172 Nothing -> n
235 Nothing -> n
@@ -183,6 +246,20 @@ maybeRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
183 runRoutedT (f c) r'
246 runRoutedT (f c) r'
184-}
247-}
185
248
249+eitherRoute_
250+ :: (MonadFix m, MonadHold t m, Adjustable t m)
251+ => RoutedT t l m ()
252+ -> RoutedT t r m ()
253+ -> RoutedT t (Either l r) m ()
254+eitherRoute_ l r = eitherRouted $ strictDynWidget_ $ either (runRoutedT l) (runRoutedT r)
255+
256+eitherRoute
257+ :: (MonadFix m, MonadHold t m, Adjustable t m)
258+ => RoutedT t l m a
259+ -> RoutedT t r m a
260+ -> RoutedT t (Either l r) m (Dynamic t a)
261+eitherRoute l r = eitherRouted $ strictDynWidget $ either (runRoutedT l) (runRoutedT r)
262+
186dsumValueCoercion :: Coercion f g -> Coercion (DSum k f) (DSum k g)
263dsumValueCoercion :: Coercion f g -> Coercion (DSum k f) (DSum k g)
187dsumValueCoercion Coercion = Coercion
264dsumValueCoercion Coercion = Coercion
188
265
@@ -192,13 +269,16 @@ dynamicIdentityCoercion = unsafeCoerce (Coercion :: Coercion (Identity ()) ()) -
192factorRouted :: (Reflex t, MonadFix m, MonadHold t m, GEq f) => RoutedT t (DSum f (Dynamic t)) m a -> RoutedT t (DSum f Identity) m a
269factorRouted :: (Reflex t, MonadFix m, MonadHold t m, GEq f) => RoutedT t (DSum f (Dynamic t)) m a -> RoutedT t (DSum f Identity) m a
193factorRouted r = RoutedT $ ReaderT $ \d -> do
270factorRouted r = RoutedT $ ReaderT $ \d -> do
194 d' <- factorDyn d
271 d' <- factorDyn d
195− runRoutedT r $ (coerceWith (dynamicCoercion $ dsumValueCoercion dynamicIdentityCoercion) d')
272+ runRoutedT r $ coerceWith (dynamicCoercion $ dsumValueCoercion dynamicIdentityCoercion) d'
196
273
197maybeRouted :: (Reflex t, MonadFix m, MonadHold t m) => RoutedT t (Maybe (Dynamic t a)) m b -> RoutedT t (Maybe a) m b
274maybeRouted :: (Reflex t, MonadFix m, MonadHold t m) => RoutedT t (Maybe (Dynamic t a)) m b -> RoutedT t (Maybe a) m b
198maybeRouted r = RoutedT $ ReaderT $ \d -> do
275maybeRouted r = RoutedT $ ReaderT $ \d -> do
199 d' <- maybeDyn d
276 d' <- maybeDyn d
200 runRoutedT r d'
277 runRoutedT r d'
201
278
279+eitherRouted :: (Reflex t, MonadFix m, MonadHold t m) => RoutedT t (Either (Dynamic t a) (Dynamic t b)) m c -> RoutedT t (Either a b) m c
280+eitherRouted r = RoutedT $ ReaderT $ runRoutedT r <=< eitherDyn
281+
202-- | WARNING: The input 'Dynamic' must be fully constructed when this is run
282-- | WARNING: The input 'Dynamic' must be fully constructed when this is run
203strictDynWidget :: (MonadSample t m, MonadHold t m, Adjustable t m) => (a -> m b) -> RoutedT t a m (Dynamic t b)
283strictDynWidget :: (MonadSample t m, MonadHold t m, Adjustable t m) => (a -> m b) -> RoutedT t a m (Dynamic t b)
204strictDynWidget f = RoutedT $ ReaderT $ \r -> do
284strictDynWidget f = RoutedT $ ReaderT $ \r -> do
@@ -213,7 +293,18 @@ strictDynWidget_ f = RoutedT $ ReaderT $ \r -> do
213 pure ()
293 pure ()
214
294
215newtype SetRouteT t r m a = SetRouteT { unSetRouteT :: EventWriterT t (Endo r) m a }
295newtype SetRouteT t r m a = SetRouteT { unSetRouteT :: EventWriterT t (Endo r) m a }
216− deriving (Functor, Applicative, Monad, MonadFix, MonadTrans, NotReady t, MonadHold t, MonadSample t, PostBuild t, TriggerEvent t, HasJSContext, MonadIO, MonadReflexCreateTrigger t, HasDocument, DomBuilder t)
296+ deriving (Functor, Applicative, Monad, MonadFix, MonadTrans, MonadIO, NotReady t, MonadHold t, MonadSample t, PostBuild t, TriggerEvent t, MonadReflexCreateTrigger t, HasDocument, DomRenderHook t)
297+
298+instance (MonadFix m, MonadHold t m, DomBuilder t m) => DomBuilder t (SetRouteT t r m) where
299+ type DomBuilderSpace (SetRouteT t r m) = DomBuilderSpace m
300+ element t cfg child = SetRouteT $ element t cfg $ unSetRouteT child
301+ inputElement = lift . inputElement
302+ textAreaElement = lift . textAreaElement
303+ selectElement cfg child = SetRouteT $ selectElement cfg $ unSetRouteT child
304+
305+instance HasJSContext m => HasJSContext (SetRouteT t r m) where
306+ type JSContextPhantom (SetRouteT t r m) = JSContextPhantom m
307+ askJSContext = lift askJSContext
217
308
218mapSetRouteT :: (forall x. m x -> n x) -> SetRouteT t r m a -> SetRouteT t r n a
309mapSetRouteT :: (forall x. m x -> n x) -> SetRouteT t r m a -> SetRouteT t r n a
219mapSetRouteT f (SetRouteT x) = SetRouteT (mapEventWriterT f x)
310mapSetRouteT f (SetRouteT x) = SetRouteT (mapEventWriterT f x)
@@ -224,16 +315,26 @@ runSetRouteT = runEventWriterT . unSetRouteT
224class Reflex t => SetRoute t r m | m -> t r where
315class Reflex t => SetRoute t r m | m -> t r where
225 setRoute :: Event t r -> m ()
316 setRoute :: Event t r -> m ()
226 modifyRoute :: Event t (r -> r) -> m ()
317 modifyRoute :: Event t (r -> r) -> m ()
318+ default modifyRoute :: (Monad m', MonadTrans f, SetRoute t r m', m ~ f m') => Event t (r -> r) -> m ()
319+ modifyRoute = lift . modifyRoute
320+
227 setRoute = modifyRoute . fmap const
321 setRoute = modifyRoute . fmap const
228
322
229instance (Reflex t, Monad m) => SetRoute t r (SetRouteT t r m) where
323instance (Reflex t, Monad m) => SetRoute t r (SetRouteT t r m) where
230 modifyRoute = SetRouteT . tellEvent . fmap Endo
324 modifyRoute = SetRouteT . tellEvent . fmap Endo
231
325
232−instance (Monad m, SetRoute t r m) => SetRoute t r (RoutedT t r' m) where
326+instance (Monad m, SetRoute t r m) => SetRoute t r (RoutedT t r' m)
233− modifyRoute = lift . modifyRoute
327+
328+instance (Monad m, SetRoute t r m) => SetRoute t r (ReaderT r' m)
234
329
235−instance Prerender js m => Prerender js (SetRouteT t r m) where
330+instance (PerformEvent t m, Prerender js t m, Monad m, Reflex t) => Prerender js t (SetRouteT t r m) where
236− prerenderClientDict = fmap (\Dict -> Dict) (prerenderClientDict :: Maybe (Dict (PrerenderClientConstraint js m)))
331+ type Client (SetRouteT t r m) = SetRouteT t r (Client m)
332+ prerender server client = do
333+ d <- lift $ prerender (runSetRouteT server) (runSetRouteT client)
334+ let (a, r) = splitDynPure d
335+ -- Must be prompt here
336+ SetRouteT . tellEvent $ switchPromptlyDyn r
337+ pure a
237
338
238instance Requester t m => Requester t (SetRouteT t r m) where
339instance Requester t m => Requester t (SetRouteT t r m) where
239 type Request (SetRouteT t r m) = Request m
340 type Request (SetRouteT t r m) = Request m
@@ -241,6 +342,8 @@ instance Requester t m => Requester t (SetRouteT t r m) where
241 requesting = SetRouteT . requesting
342 requesting = SetRouteT . requesting
242 requesting_ = SetRouteT . requesting_
343 requesting_ = SetRouteT . requesting_
243
344
345+instance (Monad m, SetRoute t r m) => SetRoute t r (RequesterT t req rsp m)
346+
244#ifndef ghcjs_HOST_OS
347#ifndef ghcjs_HOST_OS
245deriving instance MonadJSM m => MonadJSM (SetRouteT t r m)
348deriving instance MonadJSM m => MonadJSM (SetRouteT t r m)
246#endif
349#endif
@@ -264,6 +367,8 @@ instance PrimMonad m => PrimMonad (SetRouteT t r m ) where
264 type PrimState (SetRouteT t r m) = PrimState m
367 type PrimState (SetRouteT t r m) = PrimState m
265 primitive = lift . primitive
368 primitive = lift . primitive
266
369
370+instance HasConfigs m => HasConfigs (SetRouteT t r m)
371+
267instance (MonadHold t m, Adjustable t m) => Adjustable t (SetRouteT t r m) where
372instance (MonadHold t m, Adjustable t m) => Adjustable t (SetRouteT t r m) where
268 runWithReplace a0 a' = SetRouteT $ runWithReplace (coerce a0) $ coerceEvent a'
373 runWithReplace a0 a' = SetRouteT $ runWithReplace (coerce a0) $ coerceEvent a'
269 traverseIntMapWithKeyWithAdjust f a0 a' = SetRouteT $ traverseIntMapWithKeyWithAdjust (coerce f) (coerce a0) $ coerce a'
374 traverseIntMapWithKeyWithAdjust f a0 a' = SetRouteT $ traverseIntMapWithKeyWithAdjust (coerce f) (coerce a0) $ coerce a'
@@ -275,6 +380,94 @@ instance (Monad m, MonadQuery t vs m) => MonadQuery t vs (SetRouteT t r m) where
275 askQueryResult = lift askQueryResult
380 askQueryResult = lift askQueryResult
276 queryIncremental = lift . queryIncremental
381 queryIncremental = lift . queryIncremental
277
382
383+class RouteToUrl r m | m -> r where
384+ askRouteToUrl :: m (r -> Text)
385+ default askRouteToUrl :: (Monad m', MonadTrans f, RouteToUrl r m', m ~ f m') => m (r -> Text)
386+ askRouteToUrl = lift askRouteToUrl
387+
388+newtype RouteToUrlT r m a = RouteToUrlT { unRouteToUrlT :: ReaderT (r -> Text) m a }
389+ deriving (Functor, Applicative, Monad, MonadFix, MonadTrans, NotReady t, MonadHold t, MonadSample t, PostBuild t, TriggerEvent t, MonadIO, MonadReflexCreateTrigger t, HasDocument, DomRenderHook t)
390+
391+runRouteToUrlT
392+ :: RouteToUrlT r m a
393+ -> (r -> Text)
394+ -> m a
395+runRouteToUrlT a = runReaderT (unRouteToUrlT a)
396+
397+mapRouteToUrlT :: (forall x. m x -> n x) -> RouteToUrlT r m a -> RouteToUrlT r n a
398+mapRouteToUrlT f (RouteToUrlT m) = RouteToUrlT $ mapReaderT f m
399+
400+instance Monad m => RouteToUrl r (RouteToUrlT r m) where
401+ askRouteToUrl = RouteToUrlT ask
402+
403+instance (Monad m, RouteToUrl r m) => RouteToUrl r (SetRouteT t r' m) where
404+
405+instance (Monad m, RouteToUrl r m) => RouteToUrl r (RoutedT t r' m) where
406+
407+instance (Monad m, RouteToUrl r m) => RouteToUrl r (ReaderT r' m) where
408+
409+instance (Monad m, RouteToUrl r m) => RouteToUrl r (RequesterT t req rsp m)
410+
411+instance HasJSContext m => HasJSContext (RouteToUrlT r m) where
412+ type JSContextPhantom (RouteToUrlT r m) = JSContextPhantom m
413+ askJSContext = lift askJSContext
414+
415+instance (Prerender js t m, Monad m) => Prerender js t (RouteToUrlT r m) where
416+ type Client (RouteToUrlT r m) = RouteToUrlT r (Client m)
417+ prerender server client = do
418+ r <- RouteToUrlT ask
419+ lift $ prerender (runRouteToUrlT server r) (runRouteToUrlT client r)
420+
421+instance Requester t m => Requester t (RouteToUrlT r m) where
422+ type Request (RouteToUrlT r m) = Request m
423+ type Response (RouteToUrlT r m) = Response m
424+ requesting = RouteToUrlT . requesting
425+ requesting_ = RouteToUrlT . requesting_
426+
427+#ifndef ghcjs_HOST_OS
428+deriving instance MonadJSM m => MonadJSM (RouteToUrlT r m)
429+#endif
430+
431+instance PerformEvent t m => PerformEvent t (RouteToUrlT r m) where
432+ type Performable (RouteToUrlT r m) = Performable m
433+ performEvent = lift . performEvent
434+ performEvent_ = lift . performEvent_
435+
436+instance MonadRef m => MonadRef (RouteToUrlT r m) where
437+ type Ref (RouteToUrlT r m) = Ref m
438+ newRef = lift . newRef
439+ readRef = lift . readRef
440+ writeRef r = lift . writeRef r
441+
442+instance HasJS x m => HasJS x (RouteToUrlT r m) where
443+ type JSX (RouteToUrlT r m) = JSX m
444+ liftJS = lift . liftJS
445+
446+instance MonadTransControl (RouteToUrlT r) where
447+ type StT (RouteToUrlT r) a = StT (ReaderT (r -> Text)) a
448+ liftWith = defaultLiftWith RouteToUrlT unRouteToUrlT
449+ restoreT = defaultRestoreT RouteToUrlT
450+
451+instance PrimMonad m => PrimMonad (RouteToUrlT r m ) where
452+ type PrimState (RouteToUrlT r m) = PrimState m
453+ primitive = lift . primitive
454+
455+instance DomBuilder t m => DomBuilder t (RouteToUrlT r m) where
456+ type DomBuilderSpace (RouteToUrlT r m) = DomBuilderSpace m
457+
458+instance Adjustable t m => Adjustable t (RouteToUrlT r m) where
459+ runWithReplace a0 a' = RouteToUrlT $ runWithReplace (coerce a0) $ coerceEvent a'
460+ traverseIntMapWithKeyWithAdjust f a0 a' = RouteToUrlT $ traverseIntMapWithKeyWithAdjust (coerce f) (coerce a0) $ coerce a'
461+ traverseDMapWithKeyWithAdjust f a0 a' = RouteToUrlT $ traverseDMapWithKeyWithAdjust (\k v -> coerce $ f k v) (coerce a0) $ coerce a'
462+ traverseDMapWithKeyWithAdjustWithMove f a0 a' = RouteToUrlT $ traverseDMapWithKeyWithAdjustWithMove (\k v -> coerce $ f k v) (coerce a0) $ coerce a'
463+
464+instance (Monad m, MonadQuery t vs m) => MonadQuery t vs (RouteToUrlT r m) where
465+ tellQueryIncremental = lift . tellQueryIncremental
466+ askQueryResult = lift askQueryResult
467+ queryIncremental = lift . queryIncremental
468+
469+instance HasConfigs m => HasConfigs (RouteToUrlT t m)
470+
278runRouteViewT
471runRouteViewT
279 :: forall t m r a.
472 :: forall t m r a.
280 ( TriggerEvent t m
473 ( TriggerEvent t m
@@ -284,21 +477,25 @@ runRouteViewT
284 , MonadJSM (Performable m)
477 , MonadJSM (Performable m)
285 , MonadFix m
478 , MonadFix m
286 )
479 )
287− => (Encoder Identity Identity r PageName)
480+ => Encoder Identity Identity r PageName
288− -> RoutedT t r (SetRouteT t r m) a
481+ --TODO: Get rid of the switchover and useHash arguments
482+ -- useHash can probably be baked into the encoder
483+ -> Event t () -- ^ Switchover event, nothing is done until this event fires. Used to prevent incorrect DOM expectations at hydration switchover time
484+ -> Bool
485+ -> RoutedT t r (SetRouteT t r (RouteToUrlT r m)) a
289 -> m a
486 -> m a
290−runRouteViewT routeEncoder a = do
487+runRouteViewT routeEncoder switchover useHash a = do
291− rec historyState <- manageHistory $ HistoryCommand_PushState <$> setState
488+ rec historyState <- manageHistory' switchover $ HistoryCommand_PushState <$> setState
292 let theEncoder = pageNameEncoder . hoistParse (pure . runIdentity) routeEncoder
489 let theEncoder = pageNameEncoder . hoistParse (pure . runIdentity) routeEncoder
293 -- NB: The can only fail if the uriPath doesn't begin with a '/' or if the uriQuery
490 -- NB: The can only fail if the uriPath doesn't begin with a '/' or if the uriQuery
294 -- is nonempty, but begins with a character that isn't '?'. Since we don't expect
491 -- is nonempty, but begins with a character that isn't '?'. Since we don't expect
295 -- this ever to happen, we'll just handle it by failing completely with 'error'.
492 -- this ever to happen, we'll just handle it by failing completely with 'error'.
296 route :: Dynamic t r
493 route :: Dynamic t r
297− route = fmap (errorLeft . tryDecode theEncoder . (adaptedUriPath &&& uriQuery) . _historyItem_uri) historyState
494+ route = fmap (errorLeft . tryDecode theEncoder . (adaptedUriPath useHash &&& uriQuery) . _historyItem_uri) historyState
298 where
495 where
299 errorLeft (Left e) = error (T.unpack e)
496 errorLeft (Left e) = error (T.unpack e)
300 errorLeft (Right x) = x
497 errorLeft (Right x) = x
301− (result, changeState) <- runSetRouteT $ runRoutedT a route
498+ (result, changeState) <- runRouteToUrlT (runSetRouteT $ runRoutedT a route) $ (\(p, q) -> T.pack $ p <> q) . encode theEncoder
302 let f (currentHistoryState, oldRoute) change =
499 let f (currentHistoryState, oldRoute) change =
303 let newRoute = appEndo change oldRoute
500 let newRoute = appEndo change oldRoute
304 (newPath, newQuery) = encode theEncoder newRoute
501 (newPath, newQuery) = encode theEncoder newRoute
@@ -315,32 +512,151 @@ runRouteViewT routeEncoder a = do
315 -- we can change this function later to accommodate.
512 -- we can change this function later to accommodate.
316 -- See: https://github.com/whatwg/html/issues/2174
513 -- See: https://github.com/whatwg/html/issues/2174
317 , _historyStateUpdate_title = ""
514 , _historyStateUpdate_title = ""
318− , _historyStateUpdate_uri = Just $ setAdaptedUriPath newPath $ (_historyItem_uri currentHistoryState)
515+ , _historyStateUpdate_uri = Just $ setAdaptedUriPath useHash newPath $ (_historyItem_uri currentHistoryState)
319 { uriQuery = newQuery
516 { uriQuery = newQuery
320 }
517 }
321 }
518 }
322 setState = attachWith f ((,) <$> current historyState <*> current route) changeState
519 setState = attachWith f ((,) <$> current historyState <*> current route) changeState
323 return result
520 return result
324
521
522+-- | A link widget that, when clicked, sets the route to the provided route. In non-javascript
523+-- contexts, this widget falls back to using @href@s to control navigation
524+routeLink
525+ :: forall t m a route js.
526+ ( DomBuilder t m
527+ , RouteToUrl route m
528+ , SetRoute t route m
529+ , Prerender js t m
530+ )
531+ => route -- ^ Target route
532+ -> m a -- ^ Child widget
533+ -> m a
534+routeLink r w = do
535+ (e, a) <- routeLinkImpl r w
536+ scrollToTop e
537+ return a
538+
539+-- | Raw implementation of 'routeLink'. Does not scroll to the top of the page on clicks.
540+routeLinkImpl
541+ :: forall t m a route.
542+ ( DomBuilder t m
543+ , RouteToUrl route m
544+ , SetRoute t route m
545+ )
546+ => route -- ^ Target route
547+ -> m a -- ^ Child widget
548+ -> m (Event t (), a)
549+routeLinkImpl r w = do
550+ enc <- askRouteToUrl
551+ let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
552+ & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
553+ & elementConfig_initialAttributes .~ "href" =: enc r
554+ (e, a) <- element "a" cfg w
555+ setRoute $ r <$ domEvent Click e
556+ return (domEvent Click e, a)
557+
558+scrollToTop :: forall m t js. (Prerender js t m, Monad m) => Event t () -> m ()
559+scrollToTop e = prerender_ blank $ performEvent_ $ ffor e $ \_ -> liftJSM $ DOM.currentWindow >>= \case
560+ Nothing -> pure ()
561+ Just win -> Window.scrollTo win 0 0
562+
563+-- | Like 'routeLinkDynAttr' but without custom attributes.
564+dynRouteLink
565+ :: forall t m a route js.
566+ ( DomBuilder t m
567+ , PostBuild t m
568+ , RouteToUrl route m
569+ , SetRoute t route m
570+ , Prerender js t m
571+ )
572+ => Dynamic t route -- ^ Target route
573+ -> m a -- ^ Child widget
574+ -> m a
575+dynRouteLink r w = do
576+ (e, a) <- dynRouteLinkImpl r w
577+ scrollToTop e
578+ return a
579+
580+-- | Raw implementation of 'dynRouteLink'. Does not scroll to the top of the page on clicks.
581+dynRouteLinkImpl
582+ :: forall t m a route.
583+ ( DomBuilder t m
584+ , PostBuild t m
585+ , RouteToUrl route m
586+ , SetRoute t route m
587+ )
588+ => Dynamic t route -- ^ Target route
589+ -> m a -- ^ Child widget
590+ -> m (Event t (), a)
591+dynRouteLinkImpl dr w = do
592+ enc <- askRouteToUrl
593+ er <- dynamicAttributesToModifyAttributes $ ("href" =:) . enc <$> dr
594+ let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
595+ & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
596+ & elementConfig_modifyAttributes .~ er
597+ (e, a) <- element "a" cfg w
598+ let clk = domEvent Click e
599+ setRoute $ tag (current dr) clk
600+ return (clk, a)
601+
602+-- | An @a@-tag link widget that, when clicked, sets the route to current value of the
603+-- provided dynamic route. In non-JavaScript contexts the value of the dynamic post
604+-- build is used so the link still works like 'routeLink'.
605+routeLinkDynAttr
606+ :: forall t m a route js.
607+ ( DomBuilder t m
608+ , PostBuild t m
609+ , RouteToUrl (R route) m
610+ , SetRoute t (R route) m
611+ , Prerender js t m
612+ )
613+ => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
614+ -> Dynamic t (R route) -- ^ Target route
615+ -> m a -- ^ Child widget of the @a@ element
616+ -> m a
617+routeLinkDynAttr dAttr dr w = do
618+ (e, a) <- routeLinkDynAttrImpl dAttr dr w
619+ scrollToTop e
620+ return a
621+
622+-- | Raw implementation of 'routeLinkDynAttr'. Does not scroll to the top of the page on clicks.
623+routeLinkDynAttrImpl
624+ :: forall t m a route.
625+ ( DomBuilder t m
626+ , PostBuild t m
627+ , RouteToUrl (R route) m
628+ , SetRoute t (R route) m
629+ )
630+ => Dynamic t (Map AttributeName Text) -- ^ Attributes for @a@ element. Note that if @href@ is present it will be ignored
631+ -> Dynamic t (R route) -- ^ Target route
632+ -> m a -- ^ Child widget of the @a@ element
633+ -> m (Event t (), a)
634+routeLinkDynAttrImpl dAttr dr w = do
635+ enc <- askRouteToUrl
636+ er <- dynamicAttributesToModifyAttributes $ zipDynWith (<>) (("href" =:) . enc <$> dr) dAttr
637+ let cfg = (def :: ElementConfig EventResult t (DomBuilderSpace m))
638+ & elementConfig_eventSpec %~ addEventSpecFlags (Proxy :: Proxy (DomBuilderSpace m)) Click (\_ -> preventDefault)
639+ & elementConfig_modifyAttributes .~ er
640+ (e, a) <- element "a" cfg w
641+ let clk = domEvent Click e
642+ setRoute $ tag (current dr) clk
643+ return (clk, a)
644+
325-- On ios due to sandboxing when loading the page from a file adapt the
645-- On ios due to sandboxing when loading the page from a file adapt the
326-- path to be based on the hash.
646-- path to be based on the hash.
327
647
328−adaptedUriPath :: URI -> String
648+adaptedUriPath :: Bool -> URI -> String
329−#if defined(ios_HOST_OS)
649+adaptedUriPath = \case
330−adaptedUriPath = hashToPath . uriFragment
650+ True -> hashToPath . uriFragment
651+ False -> uriPath
331
652
332−hashToPath :: String -> String
653+setAdaptedUriPath :: Bool -> String -> URI -> URI
333−hashToPath = ('/' :) . fromMaybe "" . L.stripPrefix "#"
654+setAdaptedUriPath useHash s u = case useHash of
334−#else
655+ True -> u { uriFragment = pathToHash s }
335−adaptedUriPath = uriPath
656+ False -> u { uriPath = s }
336−#endif
337−
338−setAdaptedUriPath :: String -> URI -> URI
339−#if defined(ios_HOST_OS)
340−setAdaptedUriPath s u = u { uriFragment = pathToHash s }
341
657
342pathToHash :: String -> String
658pathToHash :: String -> String
343pathToHash = ('#' :) . fromMaybe "" . L.stripPrefix "/"
659pathToHash = ('#' :) . fromMaybe "" . L.stripPrefix "/"
344−#else
660+
345−setAdaptedUriPath s u = u { uriPath = s }
661+hashToPath :: String -> String
346−#endif
662+hashToPath = ('/' :) . fromMaybe "" . L.stripPrefix "#"
lib/route/src/Obelisk/Route/TH.hs+4−5
@@ -1,8 +1,9 @@
1module Obelisk.Route.TH (deriveRouteComponent) where
1module Obelisk.Route.TH (deriveRouteComponent) where
2
2
3+import Data.Constraint.Extras.TH
3import Data.GADT.Show.TH
4import Data.GADT.Show.TH
4import Data.GADT.Compare.TH
5import Data.GADT.Compare.TH
5−import Data.Universe.TH
6+import Data.Universe.Some.TH
6import Language.Haskell.TH
7import Language.Haskell.TH
7
8
8-- | Derive all the typeclasses needed for a RouteComponent type. The argument should be the name of a type of kind @k -> *@
9-- | Derive all the typeclasses needed for a RouteComponent type. The argument should be the name of a type of kind @k -> *@
@@ -11,8 +12,6 @@ deriveRouteComponent x = concat <$> traverse ($ x)
11 [ deriveGShow
12 [ deriveGShow
12 , deriveGEq
13 , deriveGEq
13 , deriveGCompare
14 , deriveGCompare
14− , deriveShowTagIdentity
15+ , deriveUniverseSome
15− , deriveEqTagIdentity
16+ , deriveArgDict
16− , deriveOrdTagIdentity
17− , deriveSomeUniverse
18 ]
17 ]
lib/run/obelisk-run.cabal+13−4
@@ -10,9 +10,12 @@ library
10 attoparsec
10 attoparsec
11 , base
11 , base
12 , bytestring
12 , bytestring
13+ , containers
14+ , cookie
13 , dependent-sum
15 , dependent-sum
14 , dependent-sum-template
16 , dependent-sum-template
15 , ghcjs-dom
17 , ghcjs-dom
18+ , HsOpenSSL
16 , http-client
19 , http-client
17 , http-reverse-proxy
20 , http-reverse-proxy
18 , http-types
21 , http-types
@@ -22,23 +25,29 @@ library
22 , modern-uri
25 , modern-uri
23 , mtl
26 , mtl
24 , network
27 , network
28+ , obelisk-asset-serve-snap
25 , obelisk-backend
29 , obelisk-backend
26− , obelisk-executable-config
30+ , obelisk-executable-config-lookup
27− , obelisk-executable-config-inject
28 , obelisk-frontend
31 , obelisk-frontend
29 , obelisk-route
32 , obelisk-route
30 , process
33 , process
31 , ref-tf
34 , ref-tf
32 , reflex
35 , reflex
33− , reflex-dom
36+ , reflex-dom-core
34 , snap-core
37 , snap-core
35 , streaming-commons
38 , streaming-commons
36 , text
39 , text
40+ , time
37 , universe
41 , universe
42+ , utf8-string
38 , wai
43 , wai
39 , wai-websockets
44 , wai-websockets
40 , warp
45 , warp
46+ , warp-tls
41 , websockets
47 , websockets
42 exposed-modules:
48 exposed-modules:
43 Obelisk.Run
49 Obelisk.Run
44− ghc-options: -Wall -fwarn-redundant-constraints
50+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
51+ if os(linux)
52+ cpp-options: -DIPROUTE_SUPPORTED
53+ build-depends: which
lib/run/src/Obelisk/Run.hs+131−55
@@ -1,17 +1,17 @@
1+{-# LANGUAGE CPP #-}
2+#if defined(IPROUTE_SUPPORTED)
3+{-# LANGUAGE TemplateHaskell #-}
4+#endif
5+
1{-# LANGUAGE ConstraintKinds #-}
6{-# LANGUAGE ConstraintKinds #-}
2−{-# LANGUAGE EmptyCase #-}
3−{-# LANGUAGE EmptyDataDecls #-}
4{-# LANGUAGE FlexibleContexts #-}
7{-# LANGUAGE FlexibleContexts #-}
5{-# LANGUAGE FlexibleInstances #-}
8{-# LANGUAGE FlexibleInstances #-}
6{-# LANGUAGE GADTs #-}
9{-# LANGUAGE GADTs #-}
7−{-# LANGUAGE KindSignatures #-}
8{-# LANGUAGE LambdaCase #-}
10{-# LANGUAGE LambdaCase #-}
9{-# LANGUAGE MultiParamTypeClasses #-}
11{-# LANGUAGE MultiParamTypeClasses #-}
10{-# LANGUAGE OverloadedStrings #-}
12{-# LANGUAGE OverloadedStrings #-}
11{-# LANGUAGE Rank2Types #-}
13{-# LANGUAGE Rank2Types #-}
12−{-# LANGUAGE RecursiveDo #-}
13{-# LANGUAGE ScopedTypeVariables #-}
14{-# LANGUAGE ScopedTypeVariables #-}
14−{-# LANGUAGE TemplateHaskell #-}
15{-# LANGUAGE TypeFamilies #-}
15{-# LANGUAGE TypeFamilies #-}
16{-# LANGUAGE UndecidableInstances #-}
16{-# LANGUAGE UndecidableInstances #-}
17{-# OPTIONS_GHC -fno-warn-orphans #-} -- Due to instance HasJS x (EventWriterT t w m)
17{-# OPTIONS_GHC -fno-warn-orphans #-} -- Due to instance HasJS x (EventWriterT t w m)
@@ -25,17 +25,22 @@ import Control.Exception
25import Control.Lens ((%~), (^?), _Just, _Right)
25import Control.Lens ((%~), (^?), _Just, _Right)
26import qualified Data.Attoparsec.ByteString.Char8 as A
26import qualified Data.Attoparsec.ByteString.Char8 as A
27import Data.ByteString (ByteString)
27import Data.ByteString (ByteString)
28+import qualified Data.ByteString as BS
28import qualified Data.ByteString.Char8 as BSC
29import qualified Data.ByteString.Char8 as BSC
29import qualified Data.ByteString.Lazy.Char8 as BSLC
30import qualified Data.ByteString.Lazy.Char8 as BSLC
30−import Data.Dependent.Sum (DSum (..))
31+import qualified Data.ByteString.UTF8 as BSUTF8
31import Data.Functor.Identity
32import Data.Functor.Identity
32−import Data.Functor.Sum
33import Data.List (uncons)
33import Data.List (uncons)
34+import Data.Map (Map)
35+import qualified Data.Map as Map
34import Data.Maybe
36import Data.Maybe
35import Data.Semigroup ((<>))
37import Data.Semigroup ((<>))
36import Data.Streaming.Network (bindPortTCP)
38import Data.Streaming.Network (bindPortTCP)
39+import Data.String (fromString)
37import Data.Text (Text)
40import Data.Text (Text)
38import qualified Data.Text as T
41import qualified Data.Text as T
42+import qualified Data.Text.Encoding as T
43+import Data.Time.Clock (getCurrentTime, addUTCTime)
39import Language.Javascript.JSaddle.Run (syncPoint)
44import Language.Javascript.JSaddle.Run (syncPoint)
40import Language.Javascript.JSaddle.WebSockets
45import Language.Javascript.JSaddle.WebSockets
41import Network.HTTP.Client (Manager, defaultManagerSettings, newManager)
46import Network.HTTP.Client (Manager, defaultManagerSettings, newManager)
@@ -45,104 +50,165 @@ import Network.Socket
45import Network.Wai (Application)
50import Network.Wai (Application)
46import qualified Network.Wai as W
51import qualified Network.Wai as W
47import Network.Wai.Handler.Warp
52import Network.Wai.Handler.Warp
53+import Network.Wai.Handler.WarpTLS
48import Network.Wai.Handler.Warp.Internal (settingsHost, settingsPort)
54import Network.Wai.Handler.Warp.Internal (settingsHost, settingsPort)
49import Network.WebSockets (ConnectionOptions)
55import Network.WebSockets (ConnectionOptions)
50import Network.WebSockets.Connection (defaultConnectionOptions)
56import Network.WebSockets.Connection (defaultConnectionOptions)
51−import Obelisk.ExecutableConfig (get)
57+import qualified Obelisk.Asset.Serve.Snap as Snap
52−import Obelisk.ExecutableConfig.Inject (injectExecutableConfigs)
58+import Obelisk.Backend
53import Obelisk.Frontend
59import Obelisk.Frontend
54import Obelisk.Route.Frontend
60import Obelisk.Route.Frontend
61+import qualified OpenSSL.PEM as PEM
62+import qualified OpenSSL.RSA as RSA
63+import qualified OpenSSL.X509 as X509
64+import qualified OpenSSL.X509.Request as X509Request
55import Reflex.Dom.Core
65import Reflex.Dom.Core
66+import Snap.Core (Snap)
56import System.Environment
67import System.Environment
57import System.IO
68import System.IO
58import System.Process
69import System.Process
59import Text.URI (URI)
70import Text.URI (URI)
60import qualified Text.URI as URI
71import qualified Text.URI as URI
61import Text.URI.Lens
72import Text.URI.Lens
62−import Obelisk.Backend
73+import Web.Cookie
74+
75+#if defined(IPROUTE_SUPPORTED)
76+import qualified System.Which
77+#endif
63
78
64run
79run
65 :: Int -- ^ Port to run the backend
80 :: Int -- ^ Port to run the backend
66− -> Backend fullRoute frontendRoute -- ^ Backend
81+ -> ([Text] -> Snap ()) -- ^ Static asset handler
82+ -> Backend backendRoute frontendRoute -- ^ Backend
67 -> Frontend (R frontendRoute) -- ^ Frontend
83 -> Frontend (R frontendRoute) -- ^ Frontend
68 -> IO ()
84 -> IO ()
69−run port backend frontend = do
85+run port serveStaticAsset backend frontend = do
70 prettifyOutput
86 prettifyOutput
71 let handleBackendErr (e :: IOException) = hPutStrLn stderr $ "backend stopped; make a change to your code to reload - error " <> show e
87 let handleBackendErr (e :: IOException) = hPutStrLn stderr $ "backend stopped; make a change to your code to reload - error " <> show e
72 --TODO: Use Obelisk.Backend.runBackend; this will require separating the checking and running phases
88 --TODO: Use Obelisk.Backend.runBackend; this will require separating the checking and running phases
73 case checkEncoder $ _backend_routeEncoder backend of
89 case checkEncoder $ _backend_routeEncoder backend of
74 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
90 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
75 Right validFullEncoder -> do
91 Right validFullEncoder -> do
76− backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $ do
92+ publicConfigs <- getPublicConfigs
77− _backend_run backend $ \serveRoute -> do
93+ backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $
78− runSnapWithCommandLineArgs $ do
94+ _backend_run backend $ \serveRoute ->
95+ runSnapWithCommandLineArgs $
79 getRouteWith validFullEncoder >>= \case
96 getRouteWith validFullEncoder >>= \case
80 Identity r -> case r of
97 Identity r -> case r of
81− InL backendRoute :=> Identity a -> serveRoute $ backendRoute :/ a
98+ FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
82− InR obeliskRoute :=> Identity a -> serveDefaultObeliskApp frontend $ obeliskRoute :/ a
99+ FullRoute_Frontend 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+
83 let conf = defRunConfig { _runConfig_redirectPort = port }
105 let conf = defRunConfig { _runConfig_redirectPort = port }
84− runWidget conf frontend validFullEncoder `finally` killThread backendTid
106+ runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
85−
107+
86−getConfigRoute :: IO (Maybe URI)
108+-- Convenience wrapper to handle path segments for 'Snap.serveAsset'
87−getConfigRoute = get "config/common/route" >>= \case
109+runServeAsset :: FilePath -> [Text] -> Snap ()
88− Just r -> case URI.mkURI $ T.strip r of
110+runServeAsset rootPath = Snap.serveAsset "" rootPath . T.unpack . T.intercalate "/"
89− Just route -> pure $ Just route
111+
90− Nothing -> do
112+getConfigRoute :: Map Text ByteString -> Either Text URI
91− putStrLn $ "Route is invalid: " <> show r
113+getConfigRoute configs = case Map.lookup "common/route" configs of
92− pure Nothing
114+ Just r ->
93− Nothing -> pure Nothing
115+ let stripped = T.strip (T.decodeUtf8 r)
94−
116+ in case URI.mkURI stripped of
95−defAppUri :: URI
117+ Just route -> Right route
96−defAppUri = fromMaybe (error "defAppUri") $ URI.mkURI "http://127.0.0.1:8000"
118+ Nothing -> Left $ "Couldn't parse route as URI; value read was: " <> T.pack (show stripped)
97−
119+ Nothing -> Left $ "Couldn't find config file common/route; it should contain the site's canonical root URI" <> T.pack (show $ Map.keys configs)
98−runWidget :: RunConfig -> Frontend (R route) -> Encoder Identity Identity (R (Sum backendRoute (ObeliskRoute route))) PageName -> IO ()
120+
99−runWidget conf frontend validFullEncoder = do
121+runWidget
100− uri <- fromMaybe defAppUri <$> getConfigRoute
122+ :: RunConfig
123+ -> Map Text ByteString
124+ -> Frontend (R frontendRoute)
125+ -> Encoder Identity Identity (R (FullRoute backendRoute frontendRoute)) PageName
126+ -> IO ()
127+runWidget conf configs frontend validFullEncoder = do
128+ uri <- either (fail . T.unpack) pure $ getConfigRoute configs
101 let port = fromIntegral $ fromMaybe 80 $ uri ^? uriAuthority . _Right . authPort . _Just
129 let port = fromIntegral $ fromMaybe 80 $ uri ^? uriAuthority . _Right . authPort . _Just
102 redirectHost = _runConfig_redirectHost conf
130 redirectHost = _runConfig_redirectHost conf
103 redirectPort = _runConfig_redirectPort conf
131 redirectPort = _runConfig_redirectPort conf
104 beforeMainLoop = do
132 beforeMainLoop = do
105 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
133 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
106 settings = setBeforeMainLoop beforeMainLoop (setPort port (setTimeout 3600 defaultSettings))
134 settings = setBeforeMainLoop beforeMainLoop (setPort port (setTimeout 3600 defaultSettings))
135+ -- Providing TLS here will also incidentally provide it to proxied requests to the backend.
136+ prepareRunner = case uri ^? uriScheme . _Just . unRText of
137+ Just "https" -> do
138+ -- Generate a private key and self-signed certificate for TLS
139+ privateKey <- RSA.generateRSAKey' 2048 3
140+
141+ certRequest <- X509Request.newX509Req
142+ _ <- X509Request.setPublicKey certRequest privateKey
143+ _ <- X509Request.signX509Req certRequest privateKey Nothing
144+
145+ cert <- X509.newX509 >>= X509Request.makeX509FromReq certRequest
146+ _ <- X509.setPublicKey cert privateKey
147+ timenow <- getCurrentTime
148+ _ <- X509.setNotBefore cert $ addUTCTime (-1) timenow
149+ _ <- X509.setNotAfter cert $ addUTCTime (365 * 24 * 60 * 60) timenow
150+ _ <- X509.signX509 cert privateKey Nothing
151+
152+ certByteString <- BSUTF8.fromString <$> PEM.writeX509 cert
153+ privateKeyByteString <- BSUTF8.fromString <$> PEM.writePKCS8PrivateKey privateKey Nothing
154+
155+ return $ runTLSSocket (tlsSettingsMemory certByteString privateKeyByteString)
156+ _ -> return runSettingsSocket
157+ runner <- prepareRunner
107 bracket
158 bracket
108 (bindPortTCPRetry settings (logPortBindErr port) (_runConfig_retryTimeout conf))
159 (bindPortTCPRetry settings (logPortBindErr port) (_runConfig_retryTimeout conf))
109 close
160 close
110 (\skt -> do
161 (\skt -> do
111 man <- newManager defaultManagerSettings
162 man <- newManager defaultManagerSettings
112− app <- obeliskApp defaultConnectionOptions frontend validFullEncoder uri $ fallbackProxy redirectHost redirectPort man
163+ app <- obeliskApp configs defaultConnectionOptions frontend validFullEncoder uri $ fallbackProxy redirectHost redirectPort man
113− runSettingsSocket settings skt app)
164+ runner settings skt app)
114
165
115obeliskApp
166obeliskApp
116− :: forall route backendRoute. ConnectionOptions
167+ :: forall frontendRoute backendRoute
117− -> Frontend (R route)
168+ . Map Text ByteString
118− -> Encoder Identity Identity (R (Sum backendRoute (ObeliskRoute route))) PageName
169+ -> ConnectionOptions
170+ -> Frontend (R frontendRoute)
171+ -> Encoder Identity Identity (R (FullRoute backendRoute frontendRoute)) PageName
119 -> URI
172 -> URI
120 -> Application
173 -> Application
121 -> IO Application
174 -> IO Application
122−obeliskApp opts frontend validFullEncoder uri backend = do
175+obeliskApp configs opts frontend validFullEncoder uri backend = do
123− let entryPoint = do
176+ let mode = FrontendMode
124− runFrontend validFullEncoder frontend
177+ { _frontendMode_hydrate = True
178+ , _frontendMode_adjustRoute = False
179+ }
180+ entryPoint = do
181+ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend
125 syncPoint
182 syncPoint
126 jsaddlePath <- URI.mkPathPiece "jsaddle"
183 jsaddlePath <- URI.mkPathPiece "jsaddle"
127 let jsaddleUri = BSLC.fromStrict $ URI.renderBs $ uri & uriPath %~ (<>[jsaddlePath])
184 let jsaddleUri = BSLC.fromStrict $ URI.renderBs $ uri & uriPath %~ (<>[jsaddlePath])
128 Right (jsaddleWarpRouteValidEncoder :: Encoder Identity (Either Text) (R JSaddleWarpRoute) PageName) <- return $ checkEncoder jsaddleWarpRouteEncoder
185 Right (jsaddleWarpRouteValidEncoder :: Encoder Identity (Either Text) (R JSaddleWarpRoute) PageName) <- return $ checkEncoder jsaddleWarpRouteEncoder
129 jsaddle <- jsaddleWithAppOr opts entryPoint $ \_ sendResponse -> sendResponse $ W.responseLBS H.status500 [("Content-Type", "text/plain")] "obeliskApp: jsaddle got a bad URL"
186 jsaddle <- jsaddleWithAppOr opts entryPoint $ \_ sendResponse -> sendResponse $ W.responseLBS H.status500 [("Content-Type", "text/plain")] "obeliskApp: jsaddle got a bad URL"
130− return $ \req sendResponse -> case tryDecode validFullEncoder (W.pathInfo req, mempty) of --TODO: Query strings
187+ return $ \req sendResponse -> case tryDecode validFullEncoder $ byteStringsToPageName (BS.dropWhile (== (fromIntegral $ fromEnum '/')) $ W.rawPathInfo req) (BS.drop 1 $ W.rawQueryString req) of
131 Identity r -> case r of
188 Identity r -> case r of
132− InR (ObeliskRoute_Resource ResourceRoute_JSaddleWarp) :=> Identity jsaddleRoute -> case jsaddleRoute of
189+ FullRoute_Frontend (ObeliskRoute_Resource ResourceRoute_JSaddleWarp) :/ jsaddleRoute -> case jsaddleRoute of
133 JSaddleWarpRoute_JavaScript :/ () -> sendResponse $ W.responseLBS H.status200 [("Content-Type", "application/javascript")] $ jsaddleJs' (Just jsaddleUri) False
190 JSaddleWarpRoute_JavaScript :/ () -> sendResponse $ W.responseLBS H.status200 [("Content-Type", "application/javascript")] $ jsaddleJs' (Just jsaddleUri) False
134 _ -> flip jsaddle sendResponse $ req
191 _ -> flip jsaddle sendResponse $ req
135 { W.pathInfo = fst $ encode jsaddleWarpRouteValidEncoder jsaddleRoute
192 { W.pathInfo = fst $ encode jsaddleWarpRouteValidEncoder jsaddleRoute
136 }
193 }
137− InR (ObeliskRoute_App appRouteComponent) :=> Identity appRouteRest -> do
194+ FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
138− html <- renderJsaddleFrontend (appRouteComponent :/ appRouteRest) frontend
195+ let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
139− sendResponse $ W.responseLBS H.status200 [("Content-Type", "text/html")] $ BSLC.fromStrict html
196+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
197+ html <- renderJsaddleFrontend configs cookies routeToUrl (appRouteComponent :/ appRouteRest) frontend
198+ sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
140 _ -> backend req sendResponse
199 _ -> backend req sendResponse
141
200
142−renderJsaddleFrontend :: route -> Frontend route -> IO ByteString
201+renderJsaddleFrontend
143−renderJsaddleFrontend r f =
202+ :: Map Text ByteString
203+ -> Cookies
204+ -> (route -> Text)
205+ -> route
206+ -> Frontend route
207+ -> IO ByteString
208+renderJsaddleFrontend configs cookies urlEnc r f =
144 let jsaddleScript = elAttr "script" ("src" =: "/jsaddle/jsaddle.js") blank
209 let jsaddleScript = elAttr "script" ("src" =: "/jsaddle/jsaddle.js") blank
145− in renderFrontendHtml r (_frontend_head f >> injectExecutableConfigs) (_frontend_body f >> jsaddleScript)
210+ jsaddlePreload = elAttr "link" ("rel" =: "preload" <> "as" =: "script" <> "href" =: "/jsaddle/jsaddle.js") blank
211+ in renderFrontendHtml configs cookies urlEnc r f jsaddlePreload jsaddleScript
146
212
147-- | like 'bindPortTCP' but reconnects on exception
213-- | like 'bindPortTCP' but reconnects on exception
148bindPortTCPRetry :: Settings
214bindPortTCPRetry :: Settings
@@ -159,12 +225,22 @@ logPortBindErr p e = getProcessIdForPort p >>= \case
159 Nothing -> putStrLn $ "runWidget: " <> show e
225 Nothing -> putStrLn $ "runWidget: " <> show e
160 Just pid -> putStrLn $ unwords [ "Port", show p, "is being used by process ID", show pid <> ".", "Please kill that process or change the port in config/common/route."]
226 Just pid -> putStrLn $ unwords [ "Port", show p, "is being used by process ID", show pid <> ".", "Please kill that process or change the port in config/common/route."]
161
227
228+ssPath :: Maybe String
229+ssPath =
230+#if defined(IPROUTE_SUPPORTED)
231+ Just $(System.Which.staticWhich "ss")
232+#else
233+ Nothing
234+#endif
235+
162getProcessIdForPort :: Int -> IO (Maybe Int)
236getProcessIdForPort :: Int -> IO (Maybe Int)
163−getProcessIdForPort port = do
237+getProcessIdForPort port = case ssPath of
164− xs <- lines <$> readProcess "ss" ["-lptn", "sport = " <> show port] mempty
238+ Just ss -> do
165− case uncons xs of
239+ xs <- lines <$> readProcess ss ["-lptn", "sport = " <> show port] mempty
166− Just (_, x:_) -> return $ A.maybeResult $ A.parse parseSsPid $ BSC.pack x
240+ case uncons xs of
167− _ -> return Nothing
241+ Just (_, x:_) -> return $ A.maybeResult $ A.parse parseSsPid $ BSC.pack x
242+ _ -> return Nothing
243+ _ -> return Nothing
168
244
169parseSsPid :: A.Parser Int
245parseSsPid :: A.Parser Int
170parseSsPid = do
246parseSsPid = do
lib/selftest/obelisk-selftest.cabal+7−3
@@ -9,17 +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
22+ , obelisk-executable-config-lookup
19 , obelisk-run
23 , obelisk-run
24+ , which
20 , process
25 , process
21− , network
26+ , shelly >= 1.9.0
22− , shelly
23 , temporary
27 , temporary
24 , text
28 , text
25 exposed-modules:
29 exposed-modules:
lib/selftest/src/Obelisk/SelfTest.hs+518−202
@@ -1,258 +1,451 @@
1+{-# LANGUAGE DoAndIfThenElse #-}
2+{-# LANGUAGE EmptyCase #-}
1{-# LANGUAGE LambdaCase #-}
3{-# LANGUAGE LambdaCase #-}
2{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE OverloadedStrings #-}
3{-# LANGUAGE PatternGuards #-}
5{-# LANGUAGE PatternGuards #-}
4{-# LANGUAGE ScopedTypeVariables #-}
6{-# LANGUAGE ScopedTypeVariables #-}
7+{-# LANGUAGE TemplateHaskell #-}
5{-# LANGUAGE TypeApplications #-}
8{-# LANGUAGE TypeApplications #-}
9+{-# LANGUAGE ViewPatterns #-}
6module Obelisk.SelfTest where
10module Obelisk.SelfTest where
7
11
8−import Control.Exception (bracket, throw)
12+import Control.Concurrent (threadDelay)
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 Data.List (isInfixOf)
23+import qualified Data.Map as Map
24+import Data.Semigroup ((<>))
14import qualified Data.Set as Set
25import qualified Data.Set as Set
15import Data.String
26import Data.String
16import Data.Text (Text)
27import Data.Text (Text)
17import qualified Data.Text as T
28import qualified Data.Text as T
29+import qualified Data.Text.Encoding as T
18import qualified Data.Text.IO as T
30import qualified Data.Text.IO as T
19import qualified Network.HTTP.Client as HTTP
31import qualified Network.HTTP.Client as HTTP
20import qualified Network.HTTP.Types as HTTP
32import qualified Network.HTTP.Types as HTTP
21import qualified Network.Socket as Socket
33import qualified Network.Socket as Socket
22import Shelly
34import Shelly
23−import System.Directory (withCurrentDirectory)
35+import System.Directory (getCurrentDirectory, withCurrentDirectory, getDirectoryContents)
24import System.Environment
36import System.Environment
25import System.Exit (ExitCode (..))
37import System.Exit (ExitCode (..))
26−import System.Info
38+import System.FilePath (addTrailingPathSeparator)
27−import System.IO (Handle, hClose)
39+import qualified System.Info
40+import System.IO (Handle, hClose, hIsEOF, hGetContents)
28import System.IO.Temp
41import System.IO.Temp
29−import System.Process (readProcessWithExitCode, CreateProcess(cwd), readCreateProcessWithExitCode, proc)
42+import System.Process (readProcessWithExitCode)
30−import System.Timeout
43+import System.Which (staticWhich)
31import Test.Hspec
44import Test.Hspec
32import Test.HUnit.Base
45import Test.HUnit.Base
33
46
34−import Obelisk.CliApp hiding (runCli)
47+import Obelisk.ExecutableConfig.Lookup (getConfigs)
35−import qualified Obelisk.CliApp as CliApp
36import Obelisk.Run (getConfigRoute)
48import Obelisk.Run (getConfigRoute)
37
49
38data ObRunState
50data ObRunState
39 = ObRunState_Init
51 = ObRunState_Init
40 | ObRunState_Startup
52 | ObRunState_Startup
41− | ObRunState_BackendStarted Text -- Port of backend
53+ | ObRunState_BackendStarted
42 deriving (Eq, Show)
54 deriving (Eq, Show)
43
55
44−doubleQuotes :: (IsString a, Semigroup a) => a -> a
56+cpPath :: FilePath
45−doubleQuotes s = "\"" <> s <> "\""
57+cpPath = $(staticWhich "cp")
58+
59+cabalPath :: FilePath
60+cabalPath = $(staticWhich "cabal")
61+
62+gitPath :: FilePath
63+gitPath = $(staticWhich "git")
64+
65+chownPath :: FilePath
66+chownPath = $(staticWhich "chown")
67+
68+chmodPath :: FilePath
69+chmodPath = $(staticWhich "chmod")
70+
71+whoamiPath :: FilePath
72+whoamiPath = $(staticWhich "whoami")
73+
74+nixInstantiatePath :: FilePath
75+nixInstantiatePath = $(staticWhich "nix-instantiate")
76+
77+nixBuildPath :: FilePath
78+nixBuildPath = $(staticWhich "nix-build")
79+
80+nixPrefetchGitPath :: FilePath
81+nixPrefetchGitPath = $(staticWhich "nix-prefetch-git")
82+
83+lnPath :: FilePath
84+lnPath = $(staticWhich "ln")
85+
86+rmPath :: FilePath
87+rmPath = $(staticWhich "rm")
88+
89+rsyncPath :: FilePath
90+rsyncPath = $(staticWhich "rsync")
91+
92+gitUserConfig :: [Text]
93+gitUserConfig = ["-c", "user.name=Obelisk Selftest", "-c", "user.email=noreply@example.com"]
46
94
47commit :: Text -> Sh ()
95commit :: Text -> Sh ()
48−commit msg = void $ run "git"
96+commit msg = void $ run gitPath $ gitUserConfig <> [ "commit"
49− [ "commit"
50 , "--no-gpg-sign"
97 , "--no-gpg-sign"
51 , "--allow-empty"
98 , "--allow-empty"
52 , "-m"
99 , "-m"
53− , doubleQuotes msg
100+ , msg
54 ]
101 ]
55
102
56−runCli :: MonadIO m => CliT IO a -> m a
57−runCli f = liftIO $ do
58− c <- newCliConfig Notice False False
59− CliApp.runCli c f
60−
61tshow :: Show a => a -> Text
103tshow :: Show a => a -> Text
62tshow = T.pack . show
104tshow = T.pack . show
63
105
64-- | Like `shelly` but used when running `ob` commands
106-- | Like `shelly` but used when running `ob` commands
65−--
66−-- This tests the NIX_REMOTE workaround, whether that gets printed
67−-- on failure, and whether retrying with the suggested workaround
68−-- leads to the test succeeding.
69shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
107shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
70−shellyOb f obTest = shelly $ f $ do
108+shellyOb f obTest = shelly $ f obTest
71− obTest `catch_sh` \(e :: RunFailed) -> do
109+
72− obStderr <- lastStderr
110+-- Set "ob" in a single place so it can be replaced with a
73− if T.isInfixOf "export NIX_REMOTE" obStderr
111+-- link to obelisk in the nix store in the future,
74− then do
112+-- and avoid PATH hacking before calling this script.
75− runCli $ do
113+ob :: FilePath
76− putLog Notice "Detected NIX_REMOTE suggestion in stderr of failed ob"
114+ob = "ob"
77− putLog Warning "Retrying this test with NIX_REMOTE=daemon"
115+
78− setenv "NIX_REMOTE" "daemon"
116+augmentWithVerbosity :: (String -> [Text] -> a) -> String -> Bool -> [Text] -> a
79− f obTest
117+augmentWithVerbosity runner executable isVerbose args = runner executable $ (if isVerbose then ("-v" :) else id) args
80− else throw e
118+
119+isolatedGitShell :: Bool -> FilePath -> (([Text] -> Sh Text) -> Sh a) -> IO a
120+isolatedGitShell isVerbose dir f = shelly $ bool silently verbosely isVerbose $ do
121+ setenv "HOME" "/dev/null"
122+ setenv "GIT_CONFIG_NOSYSTEM" "1"
123+ _ <- git ["init"]
124+ _ <- git ["config", "user.name", "SelfTest"]
125+ _ <- git ["config", "user.email", "self@test"]
126+ f git
127+ where
128+ git args = run gitPath $ ["-C", toTextIgnore dir] <> args
129+
130+-- | Copies a git repo to a new location and "resets" the git history to include
131+-- exactly one commit with all files added. It then restricts writing and reading
132+-- for group and user to make the repo ideal for being a valid git remote for thunks.
133+--
134+-- Using this allows dirty repos to be used as git remotes during the test since 'git clone'ing
135+-- a dirty repo will not include the uncommitted changes.
136+copyForGitRemote :: Bool -> FilePath -> FilePath -> IO ()
137+copyForGitRemote isVerbose origDir copyDir = isolatedGitShell isVerbose copyDir $ \git -> do
138+ run_ rsyncPath
139+ [ "-r", "--no-perms", "--no-owner", "--no-group", "--exclude", ".git"
140+ , toTextIgnore (addTrailingPathSeparator origDir), toTextIgnore copyDir
141+ ]
142+ _ <- git ["add", "--all"]
143+ _ <- git ["commit", "-m", "Copy repo"]
144+ run_ chmodPath ["-R", "u-w,g-rw,o-rw", toTextIgnore copyDir] -- Freeze this state
81
145
82main :: IO ()
146main :: IO ()
83main = do
147main = do
84 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
148 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
85− isVerbose <- (elem "-v") <$> getArgs
149+ isVerbose <- elem "-v" <$> getArgs
86 unless isVerbose $
150 unless isVerbose $
87 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
151 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
88− let verbosity = bool silently verbosely isVerbose
152+
89− obeliskImpl <- fromString <$> getEnv "OBELISK_IMPL"
153+ obeliskImplDirtyReadOnly <- getCurrentDirectory
90 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
154 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
91− withSystemTempDirectory "blank-project" $ \blankProject ->
155+
92− hspec $ do
156+ withSystemTempDirectory "obelisk-repo-git-remote" $ \copyDir -> do
93− let shelly_ = void . shellyOb verbosity
157+ copyForGitRemote isVerbose obeliskImplDirtyReadOnly copyDir
94−
158+ main' isVerbose httpManager copyDir
95− inProj :: Sh a -> IO ()
159+
96− inProj = shelly_ . chdir (fromString blankProject)
160+main' :: Bool -> HTTP.Manager -> FilePath -> IO ()
97−
161+main' isVerbose httpManager obeliskRepoReadOnly = withInitCache $ \initCache -> hspec $ parallel $ do
98− inTmp :: (Shelly.FilePath -> Sh a) -> IO ()
162+ let
99− inTmp f = shelly_ . withSystemTempDirectory "ob-init" $ (chdir <*> f) . fromString
163+ inTmpObInit' dirname f = inTmp' dirname $ \dir -> do
100−
164+ run_ cpPath ["-rT", fromString initCache, toTextIgnore dir]
101− assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
165+ f dir
102− assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
166+ inTmpObInit = inTmpObInit' defaultTmpDirName
103−
167+
104− revParseHead = T.strip <$> run "git" ["rev-parse", "HEAD"]
168+ -- To be used in tests that change the obelisk impl directory
105−
169+ inTmpObInitWithImplCopy f = inTmpObInit $ \dir ->
106− commitAll = do
170+ withObeliskImplClean $ \(fromString -> implClean) -> do
107− run_ "git" ["add", "."]
171+ run_ rmPath [thunk]
108− commit "checkpoint"
172+ run_ lnPath ["-s", implClean, thunk]
109− revParseHead
173+ f dir
110−
174+
111− thunk = ".obelisk/impl"
175+ describe "ob init" $ parallel $ do
112− update = run "ob" ["thunk", "update", thunk] >> commitAll
176+ it "works with default impl" $ inTmp $ \_ -> runOb ["init"]
113− pack = run "ob" ["thunk", "pack", thunk] >> commitAll
177+ it "works with master branch impl" $ inTmp $ \_ -> runOb ["init", "--branch", "master"]
114− unpack = run "ob" ["thunk", "unpack", thunk] >> commitAll
178+ it "works with symlink" $ inTmp $ \_ -> runOb ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
115−
179+ it "doesn't silently overwrite existing files" $ inTmp $ \_ -> do
116− diff a b = run "git" ["diff", a, b]
180+ let p force = errExit False $ do
117−
181+ run_ ob $ "--no-handoff" : "-v" : "init" : ["--force"|force]
118− describe "ob init" $ do
182+ (== 0) <$> lastExitCode
119− it "works with default impl" $ inTmp $ \_ -> run "ob" ["init"]
183+
120− it "works with master branch impl" $ inTmp $ \_ -> run "ob" ["init", "--branch", "master"]
184+ True <- p False
121− it "works with symlink" $ inTmp $ \_ -> run "ob" ["init", "--symlink", obeliskImpl]
185+ False <- p False
122− it "doesn't silently overwrite existing files" $ withSystemTempDirectory "ob-init" $ \dir -> do
186+ True <- p True
123− let p force = (proc "ob" $ "--no-handoff" : "init" : if force then ["--force"] else []) { cwd = Just dir }
187+ pure ()
124− (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p False) ""
188+
125− (ExitFailure _, _, _) <- readCreateProcessWithExitCode (p False) ""
189+ it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
126− (ExitSuccess, _, _) <- readCreateProcessWithExitCode (p True) ""
190+ void $ errExit False $ runOb ["init", "--symlink", "/dev/null"]
127− pure ()
191+ ls tmp >>= liftIO . assertEqual "" []
128−
192+
129− it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
193+ it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $
130− void $ errExit False $ run "ob" ["init", "--symlink", "/dev/null"]
194+ withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ do
131− ls tmp >>= liftIO . assertEqual "" []
195+ configs <- getConfigs
132−
196+ return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
133− it "produces a valid route config" $ inTmp $ \tmp -> do
197+
134− run_ "ob" ["init"]
198+ it "can unpack and repack .obelisk/impl after init with master branch impl" $ inTmp $ \_ -> do
135− liftIO $ withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ getConfigRoute `shouldNotReturn` Nothing
199+ runOb_ ["init", "--branch", "master"]
136−
200+ runOb_ ["thunk", "unpack", ".obelisk/impl"]
137− describe "ob run" $ do
201+ runOb_ ["thunk", "pack", ".obelisk/impl"]
138− it "works in root directory" $ inTmp $ \_ -> do
202+
139− run_ "ob" ["init"]
203+ -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
140− testObRunInDir Nothing httpManager
204+ -- when not run by 'nix-build --attr selftest'
141− it "works in sub directory" $ inTmp $ \_ -> do
205+ describe "ob run" $ {- NOT parallel $ -} do
142− run_ "ob" ["init"]
206+ it "works in root directory" $ inTmpObInit $ \_ -> testObRunInDir' Nothing httpManager
143− testObRunInDir (Just "frontend") httpManager
207+ it "works in sub directory" $ inTmpObInit $ \_ -> testObRunInDir' (Just "frontend") httpManager
144−
208+
145− describe "obelisk project" $ parallel $ do
209+ describe "ob repl" $ do
146− it "can build obelisk command" $ shelly_ $ run "nix-build" ["-A", "command" , obeliskImpl]
210+ it "accepts stdin commands" $ inTmpObInit $ \_ -> do
147− it "can build obelisk skeleton" $ shelly_ $ run "nix-build" ["-A", "skeleton", obeliskImpl]
211+ setStdin "print 3\n:q"
148− it "can build obelisk shell" $ shelly_ $ run "nix-build" ["-A", "shell", obeliskImpl]
212+ output <- runOb ["repl"]
149− -- See https://github.com/obsidiansystems/obelisk/issues/101
213+ liftIO $ assertBool "" $
150− -- it "can build everything" $ shelly_ $ run "nix-build" [obeliskImpl]
214+ [ "*Obelisk.Run Obelisk.Run Frontend Backend> 3"
151−
215+ , "*Obelisk.Run Obelisk.Run Frontend Backend> Leaving GHCi."
152− describe "blank initialized project" $ do
216+ ] `isInfixOf` T.lines (T.strip output)
153− it "can be created" $ inProj $ do
217+ it "works with custom Prelude" $ inTmpObInit $ \_ -> do
154− run_ "ob" ["init"]
218+ writefile "common/src/Prelude.hs"
155− run_ "git" ["init"]
219+ "{-# LANGUAGE PackageImports #-} module Prelude (module X) where import \"base\" Prelude as X"
156− commitAll
220+ setStdin ":q"
157−
221+ output <- runOb ["repl"]
158− it "can build ghc.backend" $ inProj $ do
222+ liftIO $ assertBool "" $
159− run "nix-build" ["--no-out-link", "-A", "ghc.backend"]
223+ "*Obelisk.Run Obelisk.Run Frontend Backend> Leaving GHCi." `T.isInfixOf` output
160− it "can build ghcjs.frontend" $ inProj $ do
224+
161− run "nix-build" ["--no-out-link", "-A", "ghcjs.frontend"]
225+ describe "obelisk project" $ parallel $ do
162−
226+ it "can build obelisk command" $ inTmpObInit $ \_ -> nixBuild ["-A", "command" , toTextIgnore obeliskRepoReadOnly]
163− if os == "darwin"
227+ it "can build obelisk skeleton" $ inTmpObInit $ \_ -> nixBuild ["-A", "skeleton", toTextIgnore obeliskRepoReadOnly]
164− then it "can build ios" $ inProj $ run "nix-build" ["--no-out-link", "-A", "ios.frontend" ]
228+ it "can build obelisk shell" $ inTmpObInit $ \_ -> nixBuild ["-A", "shell", toTextIgnore obeliskRepoReadOnly]
165− else it "can build android" $ inProj $ run "nix-build" ["--no-out-link", "-A", "android.frontend"]
229+ it "can build everything" $ inTmpObInit $ \_ -> nixBuild [toTextIgnore obeliskRepoReadOnly]
166−
230+
167− forM_ ["ghc", "ghcjs"] $ \compiler -> do
231+ describe "blank initialized project" $ parallel $ do
168− let
232+
169− shell = "shells." <> compiler
233+ it "can build ghc.backend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghc.backend"]
170− inShell cmd' = run "nix-shell" ["-A", fromString shell, "--run", cmd']
234+ it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghcjs.frontend"]
171− it ("can enter " <> shell) $ inProj $ inShell "exit"
235+
172− it ("can build in " <> shell) $ inProj $ inShell $ "cabal new-build --" <> fromString compiler <> " all"
236+ if System.Info.os == "darwin"
173−
237+ then it "can build ios" $ inTmpObInit $ \_ -> nixBuild ["-A", "ios.frontend"]
174− it "can build reflex project" $ inProj $ do
238+ else it "can build android after accepting license" $ inTmpObInit $ \dir -> do
175− run "nix-build" []
239+ let defaultNixPath = dir </> ("default.nix" :: FilePath)
176−
240+ writefile defaultNixPath
177− it "has idempotent thunk update" $ inProj $ do
241+ =<< T.replace
178− u <- update
242+ "# config.android_sdk.accept_license = false;"
179− uu <- update
243+ "config.android_sdk.accept_license = true;"
180− assertRevEQ u uu
244+ <$> readfile defaultNixPath
181−
245+ nixBuild ["-A", "android.frontend"]
182− describe "ob thunk pack/unpack" $ do
246+
183− it "has thunk pack and unpack inverses" $ inProj $ do
247+ forM_ ["ghc", "ghcjs"] $ \compiler -> do
184− e <- commitAll
248+ let
185− eu <- unpack
249+ shellName = "shells." <> compiler
186− eup <- pack
250+ inShell cmd' = run_ "nix-shell" ["default.nix", "-A", fromString shellName, "--run", cmd']
187− eupu <- unpack
251+ it ("can enter " <> shellName) $ inTmpObInit $ \_ -> inShell "exit"
188− _ <- pack
252+ -- NOTE: We override the temporary directory name because cabal has a bug preventing new-build from working
189−
253+ -- in a path that has unicode characters.
190− assertRevEQ e eup
254+ it ("can build in " <> shellName) $ inTmpObInit' "test" $ \_ -> inShell $
191− assertRevEQ eu eupu
255+ T.pack cabalPath <> " --version; " <> T.pack cabalPath <> " new-build --" <> T.pack compiler <> " all"
192− assertRevNE e eu
256+
193−
257+ it "has idempotent thunk update" $ inTmpObInitWithImplCopy $ \_ -> do
194− it "can pack and unpack plain git repos" $ do
258+ _ <- pack
195− shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
259+ u <- update
196− let repo = toTextIgnore $ dir </> ("repo" :: String)
260+ uu <- update
197− run_ "git" ["clone", "https://github.com/haskell/process.git", repo]
261+ assertRevEQ u uu
198− origHash <- chdir (fromText repo) revParseHead
262+
199−
263+ it "can run 'ob doc'" $ inTmpObInit $ \_ -> runOb_ ["doc", "reflex"]
200− run_ "ob" ["thunk", "pack", repo]
264+
201− packedFiles <- Set.fromList <$> ls (fromText repo)
265+ describe "ob thunk pack/unpack" $ parallel $ do
202− liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
266+ it "has thunk pack and unpack inverses" $ inTmpObInitWithImplCopy $ \_ -> do
203− ["default.nix", "github.json", ".attr-cache" :: String]
267+
204−
268+ _ <- pack
205− run_ "ob" ["thunk", "unpack", repo]
269+ e <- commitAll
206− chdir (fromText repo) $ do
270+ eu <- unpack
207− unpackHash <- revParseHead
271+ eup <- pack
208− assertRevEQ origHash unpackHash
272+ eupu <- unpack
209−
273+ _ <- pack
210− testThunkPack $ fromText repo
274+
211−
275+ assertRevEQ e eup
212− it "aborts thunk pack when there are uncommitted files" $ inProj $ do
276+ assertRevEQ eu eupu
213− void $ unpack
277+ assertRevNE e eu
214− testThunkPack (blankProject </> thunk)
278+
279+ it "unpacks the correct branch" $ withTmp $ \dir -> do
280+ let branch = "master"
281+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
282+ runOb_ ["thunk", "pack", toTextIgnore dir]
283+ runOb_ ["thunk", "unpack", toTextIgnore dir]
284+ branch' <- run gitPath ["-C", toTextIgnore $ dir </> unpackedDirName, "rev-parse", "--abbrev-ref", "HEAD"]
285+ liftIO $ assertEqual "" branch (T.strip branch')
286+
287+ it "can pack and unpack plain git repos" $
288+ shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
289+ let repo = toTextIgnore $ dir </> ("repo" :: FilePath)
290+ run_ gitPath ["clone", "https://github.com/haskell/process.git", repo]
291+ origHash <- chdir (fromText repo) revParseHead
292+
293+ runOb_ ["thunk", "pack", repo]
294+ packedFiles <- Set.fromList <$> ls (fromText repo)
295+ liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
296+ ["default.nix", "thunk.nix", "github.json" :: FilePath]
297+
298+ runOb_ ["thunk", "unpack", repo]
299+ chdir (fromText repo </> unpackedDirName) $ do
300+ unpackHash <- revParseHead
301+ assertRevEQ origHash unpackHash
302+
303+ testThunkPack' $ fromText repo
304+
305+ it "aborts thunk pack when there are uncommitted files" $ inTmpObInitWithImplCopy $ \dir -> do
306+ testThunkPack' (dir </> thunk)
307+
308+ it "works on legacy git thunks" $ testLegacyGitThunks isVerbose
309+
310+ describe "ob thunk update --branch" $ parallel $ do
311+ it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
312+ let branch1 = "master"
313+ branch2 = "develop"
314+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
315+ runOb_ ["thunk" , "pack", toTextIgnore dir]
316+ runOb_ ["thunk", "update", toTextIgnore dir, "--branch", branch2]
317+
318+ it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
319+ let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
320+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
321+ runOb_ ["thunk" , "pack", toTextIgnore dir]
322+ startingContents <- checkDir dir
323+ void $ errExit False $ runOb ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
324+ checkDir dir >>= liftIO . assertEqual "" startingContents
325+
326+ describe "ob shell" $ parallel $ do
327+ it "works with --" $ inTmpObInit $ \_ -> do
328+ output <- runOb ["shell", "--", "ghc-pkg", "list"]
329+ liftIO $ assertBool "Unexpected output from ob shell" $ ("Cabal-" `T.isInfixOf` output) && ("ghc-" `T.isInfixOf` output)
330+
331+ describe "ob hoogle" $ {- NOT parallel -} do
332+ it "starts a hoogle server on the given port" $ inTmpObInit $ \_ -> do
333+ [p0] <- liftIO $ getFreePorts 1
334+ maskExitSuccess $ runHandle "ob" ["hoogle", "--port", T.pack (show p0)] $ \stdout -> flip fix Nothing $ \loop -> \case
335+ Nothing -> do -- Still waiting for initial signal that the server has started
336+ ln <- liftIO $ T.hGetLine stdout
337+ let search = "Server starting on port " <> T.pack (show p0)
338+ case search `T.isInfixOf` ln of
339+ False -> loop Nothing -- keep waiting
340+ True -> loop $ Just 10
341+ Just (n :: Int) -> do -- Server has started and we have n attempts left
342+ let req uri = liftIO $ try @HTTP.HttpException $ HTTP.parseRequest uri >>= flip HTTP.httpLbs httpManager
343+ req ("http://127.0.0.1:" <> show p0) >>= \case
344+ Right r | HTTP.responseStatus r == HTTP.ok200 -> exit 0
345+ e -> if n <= 0
346+ then errorExit $ "Request to hoogle server failed: " <> T.pack (show e)
347+ else liftIO (threadDelay (1*10^(6 :: Int))) *> loop (Just $ n - 1)
348+ where
349+ verbosity = bool silently verbosely isVerbose
350+ nixBuild args = run nixBuildPath ("--no-out-link" : args)
351+
352+ runOb_ = augmentWithVerbosity run_ ob isVerbose
353+ runOb = augmentWithVerbosity run ob isVerbose
354+ testObRunInDir' = augmentWithVerbosity testObRunInDir ob isVerbose ["run"]
355+ testThunkPack' = augmentWithVerbosity testThunkPack ob isVerbose []
356+
357+ withObeliskImplClean f =
358+ withSystemTempDirectory "obelisk-impl-clean" $ \obeliskImpl -> do
359+ void . shellyOb verbosity $ do
360+ dirtyFiles <- T.strip <$> run gitPath ["-C", toTextIgnore obeliskRepoReadOnly, "diff", "--stat"]
361+ () <- when (dirtyFiles /= "") $ error "SelfTest does not work correctly with dirty obelisk repos as remote"
362+ run_ gitPath ["clone", "file://" <> toTextIgnore obeliskRepoReadOnly, toTextIgnore obeliskImpl]
363+ f obeliskImpl
364+
365+ withInitCache f =
366+ withSystemTempDirectory "init Cache λ" $ \initCache -> do
367+ -- Setup the ob init cache
368+ void . shellyOb verbosity $ chdir initCache $ do
369+ runOb_ ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
370+ run_ gitPath ["init"]
371+
372+ f initCache
373+
374+ shelly_ = void . shellyOb verbosity
375+
376+ defaultTmpDirName = "test λ"
377+
378+ inTmp' :: FilePath -> (FilePath -> Sh a) -> IO ()
379+ inTmp' dirname f = withTmp' dirname (chdir <*> f)
380+ inTmp = inTmp' defaultTmpDirName
381+
382+ withTmp' dirname f = shelly_ . withSystemTempDirectory dirname $ f . fromString
383+ withTmp = withTmp' defaultTmpDirName
384+
385+ assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
386+ assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
387+
388+ revParseHead = T.strip <$> run gitPath ["rev-parse", "HEAD"]
389+
390+ commitAll = do
391+ run_ gitPath ["add", "."]
392+ commit "checkpoint"
393+ revParseHead
394+
395+ thunk = ".obelisk/impl"
396+ update = runOb ["thunk", "update", thunk] *> commitAll
397+ pack = runOb ["thunk", "pack", thunk] *> commitAll
398+ unpack = runOb ["thunk", "unpack", thunk] *> commitAll
399+
400+ diff a b = run gitPath ["diff", a, b]
401+
402+
403+maskExitSuccess :: Sh () -> Sh ()
404+maskExitSuccess = handle_sh (\case ExitSuccess -> pure (); e -> throw e)
215
405
216-- | Run `ob run` in the given directory (maximum of one level deep)
406-- | Run `ob run` in the given directory (maximum of one level deep)
217−testObRunInDir :: Maybe Shelly.FilePath -> HTTP.Manager -> Sh ()
407+testObRunInDir :: String -> [Text] -> Maybe FilePath -> HTTP.Manager -> Sh ()
218−testObRunInDir mdir httpManager = handle_sh (\case ExitSuccess -> pure (); e -> throw e) $ do
408+testObRunInDir executable extraArgs mdir httpManager = maskExitSuccess $ do
409+ [p0, p1] <- liftIO $ getFreePorts 2
219 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
410 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
220− writefile "config/common/route" . uri =<< liftIO getFreePort -- Use a free port initially
411+ writefile "config/common/route" $ uri p0
221− maybe id chdir mdir $ runHandle "ob" ["run"] $ \stdout -> do
412+ maybe id chdir mdir $ runHandles executable extraArgs [] $ \_stdin stdout stderr -> do
222− freePort <- liftIO getFreePort
413+ firstUri <- handleObRunStdout httpManager stdout stderr
223− (_, firstUri) <- handleObRunStdout httpManager stdout
414+ let newUri = uri p1
224− let newUri = uri freePort
225 when (firstUri == newUri) $ errorExit $
415 when (firstUri == newUri) $ errorExit $
226 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
416 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
227 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
417 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
228− (_, runningUri) <- handleObRunStdout httpManager stdout
418+ runningUri <- handleObRunStdout httpManager stdout stderr
229 if runningUri /= newUri
419 if runningUri /= newUri
230 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
420 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
231 else exit 0
421 else exit 0
232
422
233−testThunkPack :: Shelly.FilePath -> Sh ()
423+testThunkPack :: String -> [Text] -> FilePath -> Sh ()
234−testThunkPack path' = withTempFile (T.unpack $ toTextIgnore path') "test-file" $ \file handle -> do
424+testThunkPack executable args path' = withTempFile repoDir "test-file" $ \file handle -> do
235− let pack' = readProcessWithExitCode "ob" ["thunk", "pack", T.unpack $ toTextIgnore path'] ""
425+ let
236− ensureThunkPackFails q = liftIO $ pack' >>= \case
426+ pack' = readProcessWithExitCode executable (["thunk", "pack", path'] ++ map T.unpack args) ""
237− (code, out, err)
427+ ensureThunkPackFails q = liftIO $ pack' >>= \case
238− | code == ExitSuccess -> fail "ob thunk pack succeeded when it should have failed"
428+ (code, out, err)
239− | q `T.isInfixOf` T.pack (out <> err) -> pure ()
429+ | code == ExitSuccess -> fail $ "ob thunk pack succeeded when it should have failed with error '" <> show q <> "'"
240− | otherwise -> fail $ "ob thunk pack failed for an unexpected reason: " <> show out <> "\nstderr: " <> err
430+ | q `T.isInfixOf` T.pack (out <> err) -> pure ()
241− git = chdir path' . run "git"
431+ | otherwise -> fail $ "ob thunk pack failed for an unexpected reason, expecting '" <> show q <> "', received: " <> show out <> "\nstderr: " <> err
432+ git = chdir repoDir . run_ gitPath
242 -- Untracked files
433 -- Untracked files
243 ensureThunkPackFails "Untracked files"
434 ensureThunkPackFails "Untracked files"
244− void $ git ["add", T.pack file]
435+ git ["add", T.pack file]
245 -- Uncommitted files (staged)
436 -- Uncommitted files (staged)
246 ensureThunkPackFails "unsaved"
437 ensureThunkPackFails "unsaved"
247− chdir path' $ commit "test commit"
438+ chdir repoDir $ commit "test commit"
248 -- Non-pushed commits in any branch
439 -- Non-pushed commits in any branch
249− ensureThunkPackFails "not been pushed"
440+ ensureThunkPackFails "not yet pushed"
250 -- Uncommitted files (unstaged)
441 -- Uncommitted files (unstaged)
251 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
442 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
252 ensureThunkPackFails "modified"
443 ensureThunkPackFails "modified"
253 -- Existing stashes
444 -- Existing stashes
254− void $ git ["stash"]
445+ git $ gitUserConfig <> [ "stash" ]
255 ensureThunkPackFails "has stashes"
446 ensureThunkPackFails "has stashes"
447+ where
448+ repoDir = path' </> unpackedDirName
256
449
257-- | Blocks until a non-empty line is available
450-- | Blocks until a non-empty line is available
258hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
451hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
@@ -272,39 +465,162 @@ alterRouteTo uri stdout = do
272 "Reloading failed: " <> T.pack (show t)
465 "Reloading failed: " <> T.pack (show t)
273
466
274-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
467-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
275−handleObRunStdout :: HTTP.Manager -> Handle -> Sh (Text, Text)
468+handleObRunStdout :: HTTP.Manager -> Handle -> Handle -> Sh Text
276−handleObRunStdout httpManager stdout = flip fix ObRunState_Init $ \loop state -> do
469+handleObRunStdout httpManager stdout stderr = flip fix (ObRunState_Init, []) $ \loop (state, msgs) -> do
277− liftIO (T.hGetLine stdout) >>= \t -> case state of
470+ isEOF <- liftIO $ hIsEOF stdout
471+ if isEOF
472+ then handleObRunError msgs
473+ else liftIO (T.hGetLine stdout) >>= \t -> case state of
278 ObRunState_Init
474 ObRunState_Init
279− | "Running test..." `T.isPrefixOf` t -> loop ObRunState_Startup
475+ | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
280 ObRunState_Startup
476 ObRunState_Startup
281− | t == "backend stopped; make a change to your code to reload" -> loop ObRunState_Startup
477+ | t == "backend stopped; make a change to your code to reload" -> loop (ObRunState_Startup, msgs)
282− | Just port <- "Backend running on port " `T.stripPrefix` t -> loop $ ObRunState_BackendStarted port
478+ -- | Just port <- "Backend running on port " `T.stripPrefix` t -> loop $ ObRunState_BackendStarted port
283 | not (T.null t) -> errorExit $ "Startup: " <> t -- If theres any other output here, startup failed
479 | not (T.null t) -> errorExit $ "Startup: " <> t -- If theres any other output here, startup failed
284− ObRunState_BackendStarted port
480+ ObRunState_BackendStarted
285 | Just uri <- "Frontend running on " `T.stripPrefix` t -> do
481 | Just uri <- "Frontend running on " `T.stripPrefix` t -> do
286− obRunCheck httpManager stdout port uri
482+ obRunCheck httpManager stdout uri
287− pure (port, uri)
483+ pure uri
288 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
484 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
289− _ -> loop state
485+ _ | "Failed" `T.isPrefixOf` t -> handleObRunError (t : msgs)
486+ | otherwise -> loop (state, t : msgs)
487+ where
488+ handleObRunError msgs = do
489+ stderrContent <- liftIO $ hGetContents stderr
490+ errorExit $ "ob run failed: " <> T.unlines (reverse msgs) <> " stderr: " <> T.pack stderrContent
290
491
291-- | Make requests to frontend/backend servers to check they are working properly
492-- | Make requests to frontend/backend servers to check they are working properly
292−obRunCheck :: HTTP.Manager -> Handle -> Text -> Text -> Sh ()
493+obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
293−obRunCheck httpManager stdout backendPort frontendUri = do
494+obRunCheck httpManager _stdout frontendUri = do
294 let req uri = liftIO $ HTTP.parseRequest (T.unpack uri) >>= flip HTTP.httpLbs httpManager
495 let req uri = liftIO $ HTTP.parseRequest (T.unpack uri) >>= flip HTTP.httpLbs httpManager
295 req frontendUri >>= \r -> when (HTTP.responseStatus r /= HTTP.ok200) $ errorExit $
496 req frontendUri >>= \r -> when (HTTP.responseStatus r /= HTTP.ok200) $ errorExit $
296 "Request to frontend server failed: " <> T.pack (show r)
497 "Request to frontend server failed: " <> T.pack (show r)
297− void $ req $ "http://localhost:" <> backendPort
298− liftIO (timeout 1000000 $ T.hGetLine stdout) >>= \case
299− Just t | "127.0.0.1" `T.isPrefixOf` t -> pure () -- Backend request logged
300− x -> errorExit $ "Couldn't get backend request log: " <> T.pack (show x)
301
498
302−getFreePort :: IO Socket.PortNumber
499+getFreePorts :: Int -> IO [Socket.PortNumber]
303−getFreePort = Socket.withSocketsDo $ do
500+getFreePorts 0 = pure []
501+getFreePorts n = Socket.withSocketsDo $ do
304 addr:_ <- Socket.getAddrInfo (Just Socket.defaultHints) (Just "127.0.0.1") (Just "0")
502 addr:_ <- Socket.getAddrInfo (Just Socket.defaultHints) (Just "127.0.0.1") (Just "0")
305− bracket (open addr) Socket.close Socket.socketPort
503+ bracket (open addr) Socket.close $ \s -> (:) <$> Socket.socketPort s <*> getFreePorts (n - 1)
306 where
504 where
307 open addr = do
505 open addr = do
308 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
506 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
309 Socket.bind sock (Socket.addrAddress addr)
507 Socket.bind sock (Socket.addrAddress addr)
310 pure sock
508 pure sock
509+
510+testLegacyGitThunks :: Bool -> IO ()
511+testLegacyGitThunks isVerbose = withSystemTempDirectory "test-git-repo" $ \gitDir -> do
512+ isolatedGitShell isVerbose gitDir $ \git -> do
513+ writefile (gitDir </> ("default.nix" :: FilePath)) "{}: \"hello\""
514+ _ <- git ["add", "--all"]
515+ _ <- git ["commit", "-m", "Initial commit"]
516+ rev <- T.strip <$> git ["rev-parse", "HEAD"]
517+ sha256 :: Text
518+ <- either error pure
519+ =<< (Aeson.parseEither (Aeson..: "sha256") <=< Aeson.eitherDecodeStrict . T.encodeUtf8)
520+ <$> run nixPrefetchGitPath [toTextIgnore gitDir]
521+
522+ for_ (legacyGitThunks (GitThunkParams gitDir rev sha256)) $ \mkFiles ->
523+ withSystemTempDirectory "test-thunks" $ \thunkDir -> do
524+ liftIO $ mkFiles thunkDir
525+ run_ "ob" ["thunk", "unpack", toTextIgnore thunkDir]
526+ run_ "ob" ["thunk", "pack", toTextIgnore thunkDir]
527+
528+data GitThunkParams = GitThunkParams
529+ { _gitThunkParams_repo :: !FilePath
530+ , _gitThunkParams_rev :: !Text
531+ , _gitThunkParams_sha256 :: !Text
532+ } deriving Show
533+
534+legacyGitThunks :: GitThunkParams -> [FilePath -> IO ()]
535+legacyGitThunks (GitThunkParams repo' rev sha256) =
536+ [ mkLegacyIO
537+ (T.unlines
538+ [ "# DO NOT HAND-EDIT THIS FILE"
539+ , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
540+ , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
541+ , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
542+ ]
543+ )
544+ (Map.fromList
545+ [ ("url", repo)
546+ , ("rev", rev)
547+ , ("branch", "master")
548+ , ("sha256", sha256)
549+ ]
550+ )
551+ , mkLegacyIO
552+ (T.unlines
553+ [ "# DO NOT HAND-EDIT THIS FILE"
554+ , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
555+ , " if builtins.hasAttr \"fetchGit\" builtins"
556+ , " then builtins.fetchGit ({ inherit url rev; } // (if branch == null then {} else { ref = branch; }))"
557+ , " else abort \"Plain Git repositories are only supported on nix 2.0 or higher.\";"
558+ , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
559+ ]
560+ )
561+ (Map.fromList
562+ [ ("url", repo)
563+ , ("rev", rev)
564+ , ("branch", "master")
565+ , ("sha256", sha256)
566+ ]
567+ )
568+ , mkLegacyIO
569+ (T.unlines
570+ [ "# DO NOT HAND-EDIT THIS FILE"
571+ , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
572+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
573+ , " if firstChar == \"/\" then /. + url"
574+ , " else if firstChar == \".\" then ./. + url"
575+ , " else url;"
576+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
577+ , " url = realUrl; inherit rev;"
578+ , " } else (import <nixpkgs> {}).fetchgit {"
579+ , " url = realUrl; inherit rev sha256;"
580+ , " };"
581+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
582+ ]
583+ )
584+ (Map.fromList
585+ [ ("url", Aeson.String repo)
586+ , ("rev", Aeson.String rev)
587+ , ("branch", Aeson.String "master")
588+ , ("sha256", Aeson.String sha256)
589+ , ("private", Aeson.Bool False)
590+ ]
591+ )
592+ , mkLegacyIO
593+ (T.unlines
594+ [ "# DO NOT HAND-EDIT THIS FILE"
595+ , "let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
596+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
597+ , " if firstChar == \"/\" then /. + url"
598+ , " else if firstChar == \".\" then ./. + url"
599+ , " else url;"
600+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
601+ , " url = realUrl; inherit rev;"
602+ , " ${if branch == null then null else \"ref\"} = branch;"
603+ , " } else (import <nixpkgs> {}).fetchgit {"
604+ , " url = realUrl; inherit rev sha256;"
605+ , " };"
606+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
607+ ]
608+ )
609+ (Map.fromList
610+ [ ("url", Aeson.String repo)
611+ , ("rev", Aeson.String rev)
612+ , ("branch", Aeson.String "master")
613+ , ("sha256", Aeson.String sha256)
614+ , ("private", Aeson.Bool False)
615+ ]
616+ )
617+ ]
618+ where
619+ repo = T.pack repo'
620+ mkLegacyIO :: Aeson.ToJSON v => Text -> Map.Map Text v -> FilePath -> IO ()
621+ mkLegacyIO defaultNix gitJson dir = do
622+ T.writeFile (dir </> ("default.nix" :: FilePath)) defaultNix
623+ LBS.writeFile (dir </> ("git.json" :: FilePath)) (Aeson.encode gitJson)
624+
625+unpackedDirName :: FilePath
626+unpackedDirName = "."
lib/snap-extras/obelisk-snap-extras.cabal+2−3
@@ -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
@@ -12,10 +12,9 @@ library
12 , base
12 , base
13 , bytestring
13 , bytestring
14 , snap-core
14 , snap-core
15− , unix
16 , directory
15 , directory
17 , filepath
16 , filepath
18 , text
17 , text
19 exposed-modules:
18 exposed-modules:
20 Obelisk.Snap.Extras
19 Obelisk.Snap.Extras
21− ghc-options: -Wall
20+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/snap-extras/src/Obelisk/Snap/Extras.hs+2−2
@@ -2,13 +2,13 @@
2module Obelisk.Snap.Extras
2module Obelisk.Snap.Extras
3 ( cachePermanently
3 ( cachePermanently
4 , doNotCache
4 , doNotCache
5+ , ensureSecure
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
@@ -17,7 +17,7 @@ import System.Directory
17-- | Set response header for "permanent" caching
17-- | Set response header for "permanent" caching
18cachePermanently :: MonadSnap m => m ()
18cachePermanently :: MonadSnap m => m ()
19cachePermanently = do
19cachePermanently = do
20− modifyResponse $ setHeader "Cache-Control" "public, max-age=315360000"
20+ modifyResponse $ setHeader "Cache-Control" "public, max-age=315360000, immutable"
21 modifyResponse $ setHeader "Expires" "Tue, 01 Feb 2050 00:00:00 GMT" --TODO: This should be set to "approximately one year from the time the response is sent"
21 modifyResponse $ setHeader "Expires" "Tue, 01 Feb 2050 00:00:00 GMT" --TODO: This should be set to "approximately one year from the time the response is sent"
22
22
23-- | Set response header to not cache
23-- | Set response header to not cache
lib/snap/obelisk-snap.cabaldeleted−40
@@ -1,40 +0,0 @@
1−Name: obelisk-snap
2−Version: 0.1
3−Synopsis: Project Synopsis Here
4−Description: Project Description Here
5−License: BSD3
6−Author: Obsidian Systems
7−Maintainer: maintainer@obsidian.systems
8−Stability: Experimental
9−Category: Web
10−Build-type: Simple
11−Cabal-version: >=1.2
12−
13−library
14− hs-source-dirs: src
15−
16− build-depends:
17− base,
18− bytestring,
19− data-default,
20− diagrams-lib,
21− diagrams-svg,
22− filepath,
23− lens,
24− lucid,
25− monad-control,
26− obelisk-asset-serve-snap,
27− obelisk-snap-extras,
28− semigroups,
29− raw-strings-qq,
30− snap,
31− snap-core,
32− svg-builder,
33− text,
34− transformers-base
35−
36− exposed-modules:
37− Obelisk.Snap
38−
39− other-extensions: TemplateHaskell
40− ghc-options: -threaded -Wall -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls -rtsopts
lib/snap/src/Obelisk/Snap.hsdeleted−99
@@ -1,99 +0,0 @@
1−{-# LANGUAGE TemplateHaskell #-}
2−{-# LANGUAGE QuasiQuotes #-}
3−{-# LANGUAGE OverloadedStrings #-}
4−
5−module Obelisk.Snap where
6−
7−import Obelisk.Asset.Serve.Snap
8−import Obelisk.Snap.Extras
9−
10−import Snap
11−
12−import Control.Lens
13−import Data.ByteString (ByteString)
14−import Data.Default
15−import Data.Monoid
16−import qualified Data.Text as T
17−import Lucid
18−import System.FilePath
19−import Control.Monad.IO.Class
20−
21−-- Data type for web app configuration
22−data AppConfig m
23− = AppConfig { _appConfig_initialBody :: m ByteString
24− , _appConfig_initialHead :: ByteString
25− , _appConfig_serveJsexe :: Bool
26− , _appConfig_jsexe :: FilePath
27− }
28−
29−-- Default instance for app configuration
30−instance Monad m => Default (AppConfig m) where
31− def = AppConfig { _appConfig_initialBody = return mempty
32− , _appConfig_initialHead = mempty
33− , _appConfig_serveJsexe = True
34− , _appConfig_jsexe = "frontend.jsexe"
35− }
36−
37−{- | Takes a location, app, and an app configuration as arguements and
38− routes the request to the correct handler. If "appConfig_serveJsexe"
39− returns "True", additional js paths and asset paths will be appended to
40− handler. Otherwise, it will return "404 Not Found" -}
41−serveAppAt :: MonadSnap m => ByteString -> FilePath -> AppConfig m -> m ()
42−serveAppAt loc app cfg = do
43− route $ [ (loc, ifTop $ serveStaticIndex cfg)
44− , (loc, serveAssets (app </> "static.assets") (app </> "static"))
45− , (loc <> "/version", doNotCache >> serveFileIfExistsAs "text/plain" (app </> "version"))
46− ]
47− ++ if _appConfig_serveJsexe cfg
48− then [(loc, serveAssets (app </> frontendJsAssetsPath cfg) (app </> frontendJsPath cfg))]
49− else []
50− ++ [ (loc, doNotCache >> error404) ]
51−
52−-- Helper function used in 'serveAppAt', writes a 404 error message in ByteString
53−error404 :: MonadSnap m => m ()
54−error404 = do
55− modifyResponse $ setResponseCode 404
56− writeBS "404 Not Found"
57−
58−-- Partially applied 'serveAppAt', specialized to the root directory
59−serveApp :: MonadSnap m => FilePath -> AppConfig m -> m ()
60−serveApp = serveAppAt ""
61−
62−-- Helper function used in 'serveAppAt', returns a frontendJs/... filepath
63−frontendJsPath :: AppConfig m -> FilePath
64−frontendJsPath (AppConfig { _appConfig_jsexe = jsexe }) = "frontendJs" </> jsexe
65−
66−-- Helper function used in 'serveAppAt', returns a frontendJs.assets/... filepath
67−frontendJsAssetsPath :: AppConfig m -> FilePath
68−frontendJsAssetsPath (AppConfig { _appConfig_jsexe = jsexe }) = "frontendJs.assets" </> jsexe
69−
70−-- Helper funtion used in 'serveAppAt', writes a lazy bytestring to the body of Http response
71−serveStaticIndex :: MonadSnap m => AppConfig m -> m ()
72−serveStaticIndex cfg = do
73− -- Decode, pack, and append asset target to file path
74− appJsPath <- liftIO $ getAssetPath (frontendJsAssetsPath cfg) "/all.js"
75− initialBody <- _appConfig_initialBody cfg
76− -- Render and write html head and body to response
77− writeLBS $ renderBS $ doctypehtml_ $ do
78− head_ $ do
79− meta_ [charset_ "utf-8"] -- meta-data charset description
80− meta_ [name_ "viewport", content_ "width=device-width, initial-scale=1.0"] -- meta-data viewport description
81− toHtmlRaw $ _appConfig_initialHead cfg
82− body_ $ do -- <body>
83− toHtmlRaw initialBody -- HtmlT monad wrapper
84− script_ [type_ "application/javascript", src_ (maybe "/all.js" T.pack appJsPath), defer_ "defer"] ("" :: String)
85−
86−{- | Takes an AppConfig monad and uses it to generate & write Lazy ByteString
87− to the body of the https response. This one comes with hard coded values
88− for the logo -}
89−serveIndex :: MonadSnap m => AppConfig m -> m ()
90−serveIndex cfg = do
91− appJsPath <- liftIO $ getAssetPath (frontendJsAssetsPath cfg) "all.js"
92− writeLBS $ renderBS $ doctypehtml_ $ do
93− head_ $ do
94− meta_ [charset_ "utf-8"]
95− meta_ [name_ "viewport", content_ "width=device-width, initial-scale=1.0"]
96− body_ $ do
97− script_ [type_ "application/javascript", src_ (maybe "/all.js" T.pack appJsPath), defer_ "defer"] ("" :: String)
98−
99−makeLenses ''AppConfig
lib/tabulation/CHANGELOG.mdnew file+5
@@ -0,0 +1,5 @@
1+# Revision history for tabulation
2+
3+## 0.1.0.0 -- 2019-05-24
4+
5+* First version. Basically carve out this library as a place for the HasFields class.
lib/tabulation/LICENSEnew file+30
@@ -0,0 +1,30 @@
1+Copyright (c) 2019, Cale Gibbard
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 Cale Gibbard 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.
lib/tabulation/Setup.hsnew file+2
@@ -0,0 +1,2 @@
1+import Distribution.Simple
2+main = defaultMain
lib/tabulation/src/Data/Tabulation.hsnew file+21
@@ -0,0 +1,21 @@
1+{-# LANGUAGE TypeFamilies #-}
2+{-# LANGUAGE RankNTypes #-}
3+
4+module Data.Tabulation where
5+
6+import Control.Lens
7+
8+-- | This is a class for record types whose fields can be enumerated by an associated GADT. It's closely related to the concept of a representable functor, except without the functor part, and the fields are not all the same type.
9+class HasFields a where
10+ type Field a :: * -> *
11+
12+ fieldLens :: Field a x -> Lens' a x
13+ tabulateFieldsA :: Applicative f => (forall x. Field a x -> f x) -> f a
14+
15+ tabulateFields :: (forall x. Field a x -> x) -> a
16+ tabulateFields f = runIdentity (tabulateFieldsA (Identity . f))
17+ traverseWithField :: Applicative m => (forall x. Field a x -> x -> m x) -> a -> m a
18+ traverseWithField t r = tabulateFieldsA (\f -> t f (indexField r f))
19+ indexField :: a -> Field a x -> x
20+ indexField a f = a ^. fieldLens f
21+ {-# MINIMAL fieldLens, tabulateFieldsA #-}
lib/tabulation/tabulation.cabalnew file+26
@@ -0,0 +1,26 @@
1+cabal-version: >=1.10
2+-- Initial package description 'tabulation.cabal' generated by 'cabal
3+-- init'. For further documentation, see
4+-- http://haskell.org/cabal/users-guide/
5+
6+name: tabulation
7+version: 0.1.0.0
8+synopsis: A library for types that can be completely reconstructed by fields as specified by a GADT.
9+-- description:
10+-- bug-reports:
11+license: BSD3
12+license-file: LICENSE
13+author: Cale Gibbard
14+maintainer: cale.gibbard@obsidian.systems
15+-- copyright:
16+category: Data
17+build-type: Simple
18+extra-source-files: CHANGELOG.md
19+
20+library
21+ exposed-modules: Data.Tabulation
22+ -- other-modules:
23+ -- other-extensions:
24+ build-depends: base, lens
25+ hs-source-dirs: src
26+ default-language: Haskell2010
migration/001efbbe866b66eebc6ee1ea0a906f2d-b0c1d039514a686529561f186332c91e/obelisk-handoffdeleted

No changes to the content.

migration/001efbbe866b66eebc6ee1ea0a906f2d-b0c1d039514a686529561f186332c91e/obelisk-upgradedeleted

No changes to the content.

migration/00a480749e96ef7e21fbe8f4943152b1-abdb013baf130e1bd7e7fd04e535c44c/obelisk-handoffdeleted

No changes to the content.

migration/00a480749e96ef7e21fbe8f4943152b1-abdb013baf130e1bd7e7fd04e535c44c/obelisk-upgradedeleted

No changes to the content.

migration/00bee4377690b5040bd5b3702dce2a88-98629a336dcd5fa3524a09f8ea6ad636/obelisk-handoffdeleted

No changes to the content.

migration/00bee4377690b5040bd5b3702dce2a88-98629a336dcd5fa3524a09f8ea6ad636/obelisk-upgradedeleted

No changes to the content.

migration/00c627540326314c7154cc209e8a71e9-67bfa5b784a35e66875fb74ad84a38c0/obelisk-handoffdeleted

No changes to the content.

migration/00c627540326314c7154cc209e8a71e9-67bfa5b784a35e66875fb74ad84a38c0/obelisk-upgradedeleted

No changes to the content.

migration/01c0ee6c93a3f9f69e097c41169927ac-2913c440c7ad7731aae96e60a86bf7a8/obelisk-handoffdeleted

No changes to the content.

migration/01c0ee6c93a3f9f69e097c41169927ac-2913c440c7ad7731aae96e60a86bf7a8/obelisk-upgradedeleted

No changes to the content.

migration/01ddc6354698efa1ae5822da3be562dc-a536d01b9c489f5e00e30abf27427da0/obelisk-handoffdeleted

No changes to the content.

migration/01ddc6354698efa1ae5822da3be562dc-a536d01b9c489f5e00e30abf27427da0/obelisk-upgradedeleted

No changes to the content.

migration/01fb7610e4184ad1b491267fcb0c7f43-c0c1452986b8d4c181bb0c6c83c56a2f/obelisk-handoffdeleted

No changes to the content.

migration/01fb7610e4184ad1b491267fcb0c7f43-c0c1452986b8d4c181bb0c6c83c56a2f/obelisk-upgradedeleted

No changes to the content.

migration/0298e61f6a03e553df08dcef03e27bd1-06d184d1fb27966294a8fee1c7df7cb6/obelisk-handoffdeleted

No changes to the content.

migration/0298e61f6a03e553df08dcef03e27bd1-06d184d1fb27966294a8fee1c7df7cb6/obelisk-upgradedeleted

No changes to the content.

migration/02d0f8b5c7472e6f8a99ec2cfcb59807-5b6770965bbef440db49b0703cd243a3/obelisk-handoffdeleted

No changes to the content.

migration/02d0f8b5c7472e6f8a99ec2cfcb59807-5b6770965bbef440db49b0703cd243a3/obelisk-upgradedeleted

No changes to the content.

migration/02f532fd8bb64a167a5349c2ba8e3331-1088e2464720e12067dd74683546b132/obelisk-handoffdeleted

No changes to the content.

migration/02f532fd8bb64a167a5349c2ba8e3331-1088e2464720e12067dd74683546b132/obelisk-upgradedeleted

No changes to the content.

migration/02fb88dab35884e09deef1721c1cfc13-ae824b83b569b3b23b8e198190371ca0/obelisk-handoffdeleted

No changes to the content.

migration/02fb88dab35884e09deef1721c1cfc13-ae824b83b569b3b23b8e198190371ca0/obelisk-upgradedeleted

No changes to the content.

migration/030ed18dacf3571cbb9e3e7d9d99627b-d37d70fe5d7d11e68b59ce12022281c9/obelisk-handoffdeleted

No changes to the content.

migration/030ed18dacf3571cbb9e3e7d9d99627b-d37d70fe5d7d11e68b59ce12022281c9/obelisk-upgradedeleted

No changes to the content.

migration/03b845f308e73a1567eb843dfca182d2-e9ec84bfe7099b713c0fda32308f5815/obelisk-handoffdeleted

No changes to the content.

migration/03b845f308e73a1567eb843dfca182d2-e9ec84bfe7099b713c0fda32308f5815/obelisk-upgradedeleted

No changes to the content.

migration/03b9747848d7f3e995b118f776ef96c7-3da702ef7f531ad6db874ac3f85e9c06/obelisk-handoffdeleted−1
@@ -1 +0,0 @@
1−True
migration/03b9747848d7f3e995b118f776ef96c7-3da702ef7f531ad6db874ac3f85e9c06/obelisk-upgradedeleted

No changes to the content.

migration/04a5ae41e8fcef5f719cb84d01430382-f391c6a74ee14217ce4565c278fceed6/obelisk-handoffdeleted

No changes to the content.

migration/04a5ae41e8fcef5f719cb84d01430382-f391c6a74ee14217ce4565c278fceed6/obelisk-upgradedeleted

No changes to the content.

migration/04dd95ecb889ac1b0a616ddfeec781c4-f790ac9400501511b4ee045e22bc5fe1/obelisk-handoffdeleted

No changes to the content.

migration/04dd95ecb889ac1b0a616ddfeec781c4-f790ac9400501511b4ee045e22bc5fe1/obelisk-upgradedeleted

No changes to the content.

migration/0535e06dd0d61f3e6970b491a17cf1f8-28a6ada033c86e5ae914cc31cecb6239/obelisk-handoffdeleted

No changes to the content.

migration/0535e06dd0d61f3e6970b491a17cf1f8-28a6ada033c86e5ae914cc31cecb6239/obelisk-upgradedeleted

No changes to the content.

migration/053c0b2f84a7a2eadeb5c3f9575ffa0d-2600ab2ec96d3177d2a6b3462e09862d/obelisk-handoffdeleted

No changes to the content.

migration/053c0b2f84a7a2eadeb5c3f9575ffa0d-2600ab2ec96d3177d2a6b3462e09862d/obelisk-upgradedeleted

No changes to the content.

migration/063665b78b6705e7de952f73fa9797bf-172e629829334d2b33cda8d3b5e0b148/obelisk-handoffdeleted

No changes to the content.

migration/063665b78b6705e7de952f73fa9797bf-172e629829334d2b33cda8d3b5e0b148/obelisk-upgradedeleted

No changes to the content.

migration/06d184d1fb27966294a8fee1c7df7cb6-b1692927da5ed59af72fac5be8094fa2/obelisk-handoffdeleted

No changes to the content.

migration/06d184d1fb27966294a8fee1c7df7cb6-b1692927da5ed59af72fac5be8094fa2/obelisk-upgradedeleted

No changes to the content.

migration/071f5b3326b8886de3eddc927b80eb10-28e25b7a8812869a709579cd34e7bcb4/obelisk-handoffdeleted

No changes to the content.

migration/071f5b3326b8886de3eddc927b80eb10-28e25b7a8812869a709579cd34e7bcb4/obelisk-upgradedeleted

No changes to the content.

migration/07900e6c41ab9a78917f66fcf7e0d9b8-554c459ff2cced3e1b11241ed403890d/obelisk-handoffdeleted

No changes to the content.

migration/07900e6c41ab9a78917f66fcf7e0d9b8-554c459ff2cced3e1b11241ed403890d/obelisk-upgradedeleted

No changes to the content.

migration/07900e6c41ab9a78917f66fcf7e0d9b8-8c84f81d9b09a5e0f028f3c6341ffb36/obelisk-handoffdeleted

No changes to the content.

migration/07900e6c41ab9a78917f66fcf7e0d9b8-8c84f81d9b09a5e0f028f3c6341ffb36/obelisk-upgradedeleted−15
@@ -1,15 +0,0 @@
1−# ob deploy: HTTPs support
2−
3−Obelisk deployments now support HTTPs. You must upgrade the deployment repo
4−associated with the obelisk project as follows:
5−
6−```
7−cd /your/project's/deployment/repo
8−echo True > enable_https
9−echo admin@yoursite.com > admin_email
10−echo https://yoursite.com/ > config/common/route
11−git add ... && git commit ...
12−ob deploy push
13−```
14−
15−If you do not wish to enable HTTPs, write `False` to `enable_https` instead.
migration/0804ef73b54a4dc7fbde18147f33b4f9-00bee4377690b5040bd5b3702dce2a88/obelisk-handoffdeleted

No changes to the content.

migration/0804ef73b54a4dc7fbde18147f33b4f9-00bee4377690b5040bd5b3702dce2a88/obelisk-upgradedeleted

No changes to the content.

migration/08dbdf23867a8efa680283ad251d3429-f2a9ba4a93c3a04acbee2211bca9e27a/obelisk-handoffdeleted

No changes to the content.

migration/08dbdf23867a8efa680283ad251d3429-f2a9ba4a93c3a04acbee2211bca9e27a/obelisk-upgradedeleted

No changes to the content.

migration/0abd9d31c77be8c9a9e83bf1f73276f6-fc42c5fc24031fc6a8836a10cfb45143/obelisk-handoffdeleted

No changes to the content.

migration/0abd9d31c77be8c9a9e83bf1f73276f6-fc42c5fc24031fc6a8836a10cfb45143/obelisk-upgradedeleted

No changes to the content.

migration/0b2cab546a1526414096980fca85d0d3-99aebbfcac51725464bc59571b7d71b8/obelisk-handoffdeleted

No changes to the content.

migration/0b2cab546a1526414096980fca85d0d3-99aebbfcac51725464bc59571b7d71b8/obelisk-upgradedeleted

No changes to the content.

migration/0c6127453069ad707e34ddfedb67e2f9-7c98ef4a123c1a580d368d14e54961b7/obelisk-handoffdeleted

No changes to the content.

migration/0c6127453069ad707e34ddfedb67e2f9-7c98ef4a123c1a580d368d14e54961b7/obelisk-upgradedeleted

No changes to the content.

migration/0c9826e42d5d4fa9988c7db53722826e-c56de2f95c90def16704f62639246bbc/obelisk-handoffdeleted

No changes to the content.

migration/0c9826e42d5d4fa9988c7db53722826e-c56de2f95c90def16704f62639246bbc/obelisk-upgradedeleted

No changes to the content.

migration/0c991bc3c06801f72df48486ee78e350-58479e482d3828ce44f2c8371ed9135a/obelisk-handoffdeleted

No changes to the content.

migration/0c991bc3c06801f72df48486ee78e350-58479e482d3828ce44f2c8371ed9135a/obelisk-upgradedeleted

No changes to the content.

migration/0d3b4cfe9b4c72b830780a4c44942176-214979923f2d7e6278856493c1978fdc/obelisk-handoffdeleted

No changes to the content.

migration/0d3b4cfe9b4c72b830780a4c44942176-214979923f2d7e6278856493c1978fdc/obelisk-upgradedeleted

No changes to the content.

migration/0da1150f0e9fe57d1fafbb6cabe24fa1-a632452cf9c5956becd1a40512472b43/obelisk-handoffdeleted

No changes to the content.

migration/0da1150f0e9fe57d1fafbb6cabe24fa1-a632452cf9c5956becd1a40512472b43/obelisk-upgradedeleted

No changes to the content.

migration/0e4d0f0f0af0925474b0d772be2b145f-b82e9c3fe22feff4bb3a6be49943fd6c/obelisk-handoffdeleted

No changes to the content.

migration/0e4d0f0f0af0925474b0d772be2b145f-b82e9c3fe22feff4bb3a6be49943fd6c/obelisk-upgradedeleted

No changes to the content.

migration/0ec6f67d94d3913cf3243d813238ec39-0804ef73b54a4dc7fbde18147f33b4f9/obelisk-handoffdeleted

No changes to the content.

migration/0ec6f67d94d3913cf3243d813238ec39-0804ef73b54a4dc7fbde18147f33b4f9/obelisk-upgradedeleted

No changes to the content.

migration/0f78d9d6875933336bbf0c1c8888b73f-d1b3f5f5375558bf91d55c88547784b9/obelisk-handoffdeleted

No changes to the content.

migration/0f78d9d6875933336bbf0c1c8888b73f-d1b3f5f5375558bf91d55c88547784b9/obelisk-upgradedeleted

No changes to the content.

migration/0fb3a912a8aaf5ef6f734a25f0bce7e2-cccf4140dc336263489bcf67c8c58f86/obelisk-handoffdeleted

No changes to the content.

migration/0fb3a912a8aaf5ef6f734a25f0bce7e2-cccf4140dc336263489bcf67c8c58f86/obelisk-upgradedeleted

No changes to the content.

migration/0fba399e046852d4ecf8e1dad831a2f9-6620e6dc5622593e5f671127af9ade05/obelisk-handoffdeleted

No changes to the content.

migration/0fba399e046852d4ecf8e1dad831a2f9-6620e6dc5622593e5f671127af9ade05/obelisk-upgradedeleted

No changes to the content.

migration/0fe60df438daa8a2cca5f2b569e361a5-2e3e85cc59aa31f24f18c027542c0510/obelisk-handoffdeleted

No changes to the content.

migration/0fe60df438daa8a2cca5f2b569e361a5-2e3e85cc59aa31f24f18c027542c0510/obelisk-upgradedeleted

No changes to the content.

migration/1088e2464720e12067dd74683546b132-b2282679f6f63cec89d921c3dd512d1e/obelisk-handoffdeleted

No changes to the content.

migration/1088e2464720e12067dd74683546b132-b2282679f6f63cec89d921c3dd512d1e/obelisk-upgradedeleted

No changes to the content.

migration/11a5917ea91e021f1fa541a2fe158c80-d8adb57b2f2266e128ebb6f6d7e65920/obelisk-handoffdeleted

No changes to the content.

migration/11a5917ea91e021f1fa541a2fe158c80-d8adb57b2f2266e128ebb6f6d7e65920/obelisk-upgradedeleted

No changes to the content.

migration/11f38b38c2d38004bb8a9dbfe2ef3e4a-29d9b8b8ae9698888f3ea90b10ff5e92/obelisk-handoffdeleted

No changes to the content.

migration/11f38b38c2d38004bb8a9dbfe2ef3e4a-29d9b8b8ae9698888f3ea90b10ff5e92/obelisk-upgradedeleted

No changes to the content.

migration/1269155fffe21926f3704d5077e04332-1a97559d049bf85cebb762b7e7b70db1/obelisk-handoffdeleted

No changes to the content.

migration/1269155fffe21926f3704d5077e04332-1a97559d049bf85cebb762b7e7b70db1/obelisk-upgradedeleted

No changes to the content.

migration/12c8a24c34c2d8441f3181d179c2baab-bd6728737dffcc3505d30ada344e2f4b/obelisk-handoffdeleted

No changes to the content.

migration/12c8a24c34c2d8441f3181d179c2baab-bd6728737dffcc3505d30ada344e2f4b/obelisk-upgradedeleted

No changes to the content.

migration/131e1d5cc8163ce9a174a8782be23fe7-e323ce1352e512109f1609276fb509b4/obelisk-handoffdeleted

No changes to the content.

migration/131e1d5cc8163ce9a174a8782be23fe7-e323ce1352e512109f1609276fb509b4/obelisk-upgradedeleted

No changes to the content.

migration/13f6767460e94079cdfa6d5e1df79ecb-c106f9398d5c203a1a296b85c7411bf9/obelisk-handoffdeleted

No changes to the content.

migration/13f6767460e94079cdfa6d5e1df79ecb-c106f9398d5c203a1a296b85c7411bf9/obelisk-upgradedeleted

No changes to the content.

migration/145650b66e83adf5bdb8261593076379-e2be519915794ef130249f2be7640382/obelisk-handoffdeleted

No changes to the content.

migration/145650b66e83adf5bdb8261593076379-e2be519915794ef130249f2be7640382/obelisk-upgradedeleted

No changes to the content.

migration/14840816db4b5cfd5580ae099022604a-aaf979dd0121603a8b48127e1ea47c7d/obelisk-handoffdeleted

No changes to the content.

migration/14840816db4b5cfd5580ae099022604a-aaf979dd0121603a8b48127e1ea47c7d/obelisk-upgradedeleted

No changes to the content.

migration/15f3f3f517b38664131b85da0594522f-9715967793be68dfd8c9a7d631f8d589/obelisk-handoffdeleted

No changes to the content.

migration/15f3f3f517b38664131b85da0594522f-9715967793be68dfd8c9a7d631f8d589/obelisk-upgradedeleted

No changes to the content.

migration/1629d0d70e360df6b2280fac36d21e8a-a825fbb74e8d050a5ce10ec4c62b83f5/obelisk-handoffdeleted

No changes to the content.

migration/1629d0d70e360df6b2280fac36d21e8a-a825fbb74e8d050a5ce10ec4c62b83f5/obelisk-upgradedeleted

No changes to the content.

migration/166c5f8e4a0f1dfd227b075a96237386-a5904e3a899e346fe2fe26314f69c075/obelisk-handoffdeleted

No changes to the content.

migration/166c5f8e4a0f1dfd227b075a96237386-a5904e3a899e346fe2fe26314f69c075/obelisk-upgradedeleted

No changes to the content.

migration/16b24e1a12b93ea83d7656a09d5e3338-8a64ec5f2ee43d69607499f085560857/obelisk-handoffdeleted

No changes to the content.

migration/16b24e1a12b93ea83d7656a09d5e3338-8a64ec5f2ee43d69607499f085560857/obelisk-upgradedeleted

No changes to the content.

migration/17089ea0edc0cf4b6f616936f8a06174-a34d758508a0a5d08bc10e76482c4d11/obelisk-handoffdeleted

No changes to the content.

migration/17089ea0edc0cf4b6f616936f8a06174-a34d758508a0a5d08bc10e76482c4d11/obelisk-upgradedeleted

No changes to the content.

migration/172e629829334d2b33cda8d3b5e0b148-a808a04519bbf2874e41028ded9c180c/obelisk-handoffdeleted

No changes to the content.

migration/172e629829334d2b33cda8d3b5e0b148-a808a04519bbf2874e41028ded9c180c/obelisk-upgradedeleted

No changes to the content.

migration/174fa1072ee767be39b7b01aecea5714-6566f0555737425bae9106d1a4a0a2dd/obelisk-handoffdeleted

No changes to the content.

migration/174fa1072ee767be39b7b01aecea5714-6566f0555737425bae9106d1a4a0a2dd/obelisk-upgradedeleted

No changes to the content.

migration/1859cc62bb2f89f528bb2aa170c36e84-be5a7b436cef0ae35cb074700d5f0d00/obelisk-handoffdeleted

No changes to the content.

migration/1859cc62bb2f89f528bb2aa170c36e84-be5a7b436cef0ae35cb074700d5f0d00/obelisk-upgradedeleted

No changes to the content.

migration/190460dabd2b9773c3fe81902d0c8a62-e7385c9eae2b807a483b73be4295b207/obelisk-handoffdeleted

No changes to the content.

migration/190460dabd2b9773c3fe81902d0c8a62-e7385c9eae2b807a483b73be4295b207/obelisk-upgradedeleted

No changes to the content.

migration/1a08b154ae5f898992128e229090c4d8-4e95e2f8ef50420371b71022c644e25d/obelisk-handoffdeleted

No changes to the content.

migration/1a08b154ae5f898992128e229090c4d8-4e95e2f8ef50420371b71022c644e25d/obelisk-upgradedeleted

No changes to the content.

migration/1a97559d049bf85cebb762b7e7b70db1-5cb98d0250bf5224b94e544a5140a54c/obelisk-handoffdeleted

No changes to the content.

migration/1a97559d049bf85cebb762b7e7b70db1-5cb98d0250bf5224b94e544a5140a54c/obelisk-upgradedeleted

No changes to the content.

migration/1ada2d50d7847a12dbe29df4097b5bdc-11a5917ea91e021f1fa541a2fe158c80/obelisk-handoffdeleted

No changes to the content.

migration/1ada2d50d7847a12dbe29df4097b5bdc-11a5917ea91e021f1fa541a2fe158c80/obelisk-upgradedeleted

No changes to the content.

migration/1b1686b03b41bd840ff46776cec7b33a-31a676fd9e1f69bd07380480ec879da0/obelisk-handoffdeleted

No changes to the content.

migration/1b1686b03b41bd840ff46776cec7b33a-31a676fd9e1f69bd07380480ec879da0/obelisk-upgradedeleted

No changes to the content.

migration/1c1c3f2b4426d5d26377eef08dbccb3c-29abdd56a2dbbf3a2a0715210d441d06/obelisk-handoffdeleted

No changes to the content.

migration/1c1c3f2b4426d5d26377eef08dbccb3c-29abdd56a2dbbf3a2a0715210d441d06/obelisk-upgradedeleted

No changes to the content.

migration/1c2c93819c07f33ad899e39ec6769c3c-909b6b2066cbdc991e6c16455f13637c/obelisk-handoffdeleted

No changes to the content.

migration/1c2c93819c07f33ad899e39ec6769c3c-909b6b2066cbdc991e6c16455f13637c/obelisk-upgradedeleted

No changes to the content.

migration/1c4fc23cbf5653613c6060668e065f37-5b252c24612c2ba868580add9d9c19e3/obelisk-handoffdeleted

No changes to the content.

migration/1c4fc23cbf5653613c6060668e065f37-5b252c24612c2ba868580add9d9c19e3/obelisk-upgradedeleted

No changes to the content.

migration/1c9bdb5c544f2e5432f549653a61dabe-20926beb4c30e2efa819d23e5694645e/obelisk-handoffdeleted

No changes to the content.

migration/1c9bdb5c544f2e5432f549653a61dabe-20926beb4c30e2efa819d23e5694645e/obelisk-upgradedeleted

No changes to the content.

migration/1cc8d98f6f61441570fdde2d697e6e3c-69fafe6ab155ff215b6d9d330f700ba1/obelisk-handoffdeleted

No changes to the content.

migration/1cc8d98f6f61441570fdde2d697e6e3c-69fafe6ab155ff215b6d9d330f700ba1/obelisk-upgradedeleted

No changes to the content.

migration/1d084e187591225f0e8fa6fa824f8863-02f532fd8bb64a167a5349c2ba8e3331/obelisk-handoffdeleted

No changes to the content.

migration/1d084e187591225f0e8fa6fa824f8863-02f532fd8bb64a167a5349c2ba8e3331/obelisk-upgradedeleted

No changes to the content.

migration/1df871cede0758cabe43971d9091279d-0b2cab546a1526414096980fca85d0d3/obelisk-handoffdeleted

No changes to the content.

migration/1df871cede0758cabe43971d9091279d-0b2cab546a1526414096980fca85d0d3/obelisk-upgradedeleted

No changes to the content.

migration/1e36dc8817e2784df36d643b7499092d-ba0ccd5ef6110f6c5133d9d6ea6277f0/obelisk-handoffdeleted

No changes to the content.

migration/1e36dc8817e2784df36d643b7499092d-ba0ccd5ef6110f6c5133d9d6ea6277f0/obelisk-upgradedeleted

No changes to the content.

migration/1e376437f069662df26178e4a7873190-ca5ee8f372ecb07b09283081f0298733/obelisk-handoffdeleted

No changes to the content.

migration/1e376437f069662df26178e4a7873190-ca5ee8f372ecb07b09283081f0298733/obelisk-upgradedeleted

No changes to the content.

migration/1f09fcf196bfe90ed52f113c38ffbfdb-d16784e9a2d93db7f953941e3003fa8c/obelisk-handoffdeleted

No changes to the content.

migration/1f09fcf196bfe90ed52f113c38ffbfdb-d16784e9a2d93db7f953941e3003fa8c/obelisk-upgradedeleted

No changes to the content.

migration/1f5b6e2a19c87d3820b953f942ab4a27-8b098f49e1fd1aa10ca22b9dc312644e/obelisk-handoffdeleted

No changes to the content.

migration/1f5b6e2a19c87d3820b953f942ab4a27-8b098f49e1fd1aa10ca22b9dc312644e/obelisk-upgradedeleted

No changes to the content.

migration/1f7fb90cb1e558f5285b2d19a25a1078-5a98cdb6c195e88beac878a3f311c5b5/obelisk-handoffdeleted

No changes to the content.

migration/1f7fb90cb1e558f5285b2d19a25a1078-5a98cdb6c195e88beac878a3f311c5b5/obelisk-upgradedeleted

No changes to the content.

migration/1fe00204f9d2cd653ff2894eae3d9356-4b3f45ce8aeb17ef18d1d9502b74bb7e/obelisk-handoffdeleted

No changes to the content.

migration/1fe00204f9d2cd653ff2894eae3d9356-4b3f45ce8aeb17ef18d1d9502b74bb7e/obelisk-upgradedeleted

No changes to the content.

migration/20926beb4c30e2efa819d23e5694645e-212ead9571b83b8164b3f18d2537d52b/obelisk-handoffdeleted

No changes to the content.

migration/20926beb4c30e2efa819d23e5694645e-212ead9571b83b8164b3f18d2537d52b/obelisk-upgradedeleted

No changes to the content.

migration/212ead9571b83b8164b3f18d2537d52b-3bf8e28473fb05791c5790f8906e2609/obelisk-handoffdeleted

No changes to the content.

migration/212ead9571b83b8164b3f18d2537d52b-3bf8e28473fb05791c5790f8906e2609/obelisk-upgradedeleted

No changes to the content.

migration/214979923f2d7e6278856493c1978fdc-13f6767460e94079cdfa6d5e1df79ecb/obelisk-handoffdeleted

No changes to the content.

migration/214979923f2d7e6278856493c1978fdc-13f6767460e94079cdfa6d5e1df79ecb/obelisk-upgradedeleted

No changes to the content.

migration/215b6810b09f219a5cb3842aacc88432-2ef4f9cce6d15ae62d5112d3c224eb7a/obelisk-handoffdeleted

No changes to the content.

migration/215b6810b09f219a5cb3842aacc88432-2ef4f9cce6d15ae62d5112d3c224eb7a/obelisk-upgradedeleted

No changes to the content.

migration/2164344be67da5d0e57052c15f30646d-0c9826e42d5d4fa9988c7db53722826e/obelisk-handoffdeleted

No changes to the content.

migration/2164344be67da5d0e57052c15f30646d-0c9826e42d5d4fa9988c7db53722826e/obelisk-upgradedeleted

No changes to the content.

migration/237aeb7eee0ffed230234ee04e49569f-55cf43fb0d3868040c9efbf2f92d538a/obelisk-handoffdeleted

No changes to the content.

migration/237aeb7eee0ffed230234ee04e49569f-55cf43fb0d3868040c9efbf2f92d538a/obelisk-upgradedeleted

No changes to the content.

migration/23af4d9671962484de53f537a0626d83-7ce32302cfbba8b7567a05144057f8a3/obelisk-handoffdeleted

No changes to the content.

migration/23af4d9671962484de53f537a0626d83-7ce32302cfbba8b7567a05144057f8a3/obelisk-upgradedeleted

No changes to the content.

migration/24e0d027f4160a6478c1356e51f419cf-4e3e6e8b9d0f4194842e530438ff686f/obelisk-handoffdeleted

No changes to the content.

migration/24e0d027f4160a6478c1356e51f419cf-4e3e6e8b9d0f4194842e530438ff686f/obelisk-upgradedeleted

No changes to the content.

migration/24f151a674662ac47845237d7a9f6a4f-4fe321cf196b9cd25210c35e09e09d8f/obelisk-handoffdeleted

No changes to the content.

migration/24f151a674662ac47845237d7a9f6a4f-4fe321cf196b9cd25210c35e09e09d8f/obelisk-upgradedeleted

No changes to the content.

migration/2543866165016a449562ea7a1ee36f6f-1a08b154ae5f898992128e229090c4d8/obelisk-handoffdeleted

No changes to the content.

migration/2543866165016a449562ea7a1ee36f6f-1a08b154ae5f898992128e229090c4d8/obelisk-upgradedeleted

No changes to the content.

migration/25615a274650370633e8083ed19fbdd0-80cb6b08443d55bb512e4a35b4768b72/obelisk-handoffdeleted

No changes to the content.

migration/25615a274650370633e8083ed19fbdd0-80cb6b08443d55bb512e4a35b4768b72/obelisk-upgradedeleted

No changes to the content.

migration/2600ab2ec96d3177d2a6b3462e09862d-e2b2d878b0ba6eb653b194523bf0a0e0/obelisk-handoffdeleted

No changes to the content.

migration/2600ab2ec96d3177d2a6b3462e09862d-e2b2d878b0ba6eb653b194523bf0a0e0/obelisk-upgradedeleted

No changes to the content.

migration/2619464637b85cb35376393fe612ddae-a8ebe201ab7a7b0211de41b14a95192e/obelisk-handoffdeleted

No changes to the content.

migration/2619464637b85cb35376393fe612ddae-a8ebe201ab7a7b0211de41b14a95192e/obelisk-upgradedeleted

No changes to the content.

migration/26a2491fc8a9658751c1511c777a67bd-470df6504156dc940b8e7f89c148e619/obelisk-handoffdeleted

No changes to the content.

migration/26a2491fc8a9658751c1511c777a67bd-470df6504156dc940b8e7f89c148e619/obelisk-upgradedeleted

No changes to the content.

migration/270b3b3f7bc510c692e3253a895f122a-c2d4eeb20f2b319a2d9dc5b6b0762f83/obelisk-handoffdeleted

No changes to the content.

migration/270b3b3f7bc510c692e3253a895f122a-c2d4eeb20f2b319a2d9dc5b6b0762f83/obelisk-upgradedeleted

No changes to the content.

migration/2773d4a82ca59b48faf036755e163a5f-71c6959cf98e05d356ff798ada6db2b8/obelisk-handoffdeleted

No changes to the content.

migration/2773d4a82ca59b48faf036755e163a5f-71c6959cf98e05d356ff798ada6db2b8/obelisk-upgradedeleted

No changes to the content.

migration/28a6ada033c86e5ae914cc31cecb6239-90b4e20464e08ade5f215f2a4ea28cc6/obelisk-handoffdeleted

No changes to the content.

migration/28a6ada033c86e5ae914cc31cecb6239-90b4e20464e08ade5f215f2a4ea28cc6/obelisk-upgradedeleted

No changes to the content.

migration/28c5fec3b7b0b14b3625d5c8f60bcf68-4509e2a908da9e497fa67acacdd107b6/obelisk-handoffdeleted

No changes to the content.

migration/28c5fec3b7b0b14b3625d5c8f60bcf68-4509e2a908da9e497fa67acacdd107b6/obelisk-upgradedeleted

No changes to the content.

migration/28e25b7a8812869a709579cd34e7bcb4-2543866165016a449562ea7a1ee36f6f/obelisk-handoffdeleted

No changes to the content.

migration/28e25b7a8812869a709579cd34e7bcb4-2543866165016a449562ea7a1ee36f6f/obelisk-upgradedeleted

No changes to the content.

migration/2913c440c7ad7731aae96e60a86bf7a8-a08aebb6f40fb45d174b229532314ac4/obelisk-handoffdeleted

No changes to the content.

migration/2913c440c7ad7731aae96e60a86bf7a8-a08aebb6f40fb45d174b229532314ac4/obelisk-upgradedeleted

No changes to the content.

migration/29abdd56a2dbbf3a2a0715210d441d06-51c7d001730ddd3d76e0c8bb57038773/obelisk-handoffdeleted

No changes to the content.

migration/29abdd56a2dbbf3a2a0715210d441d06-51c7d001730ddd3d76e0c8bb57038773/obelisk-upgradedeleted

No changes to the content.

migration/29d9b8b8ae9698888f3ea90b10ff5e92-1ada2d50d7847a12dbe29df4097b5bdc/obelisk-handoffdeleted

No changes to the content.

migration/29d9b8b8ae9698888f3ea90b10ff5e92-1ada2d50d7847a12dbe29df4097b5bdc/obelisk-upgradedeleted

No changes to the content.

migration/29fd07af89cc31526fca00226ff52a82-50b85e79010ad50ee275eaeba0df6f8d/obelisk-handoffdeleted

No changes to the content.

migration/29fd07af89cc31526fca00226ff52a82-50b85e79010ad50ee275eaeba0df6f8d/obelisk-upgradedeleted

No changes to the content.

migration/2ba356b187db8db13b8aa40f43ca025f-3c1fc501da00f467c9a48a1ddee2c2b0/obelisk-handoffdeleted

No changes to the content.

migration/2ba356b187db8db13b8aa40f43ca025f-3c1fc501da00f467c9a48a1ddee2c2b0/obelisk-upgradedeleted

No changes to the content.

migration/2bdd4221307cafa3e98c4d3017cdc912-5f6fe243beb9fcc0c4117536022fc14c/obelisk-handoffdeleted

No changes to the content.

migration/2bdd4221307cafa3e98c4d3017cdc912-5f6fe243beb9fcc0c4117536022fc14c/obelisk-upgradedeleted

No changes to the content.

migration/2c1521e5a5be64e6d28a9fdae950cd76-92ab733e8991f12cc12148f8d4e1b35d/obelisk-handoffdeleted

No changes to the content.

migration/2c1521e5a5be64e6d28a9fdae950cd76-92ab733e8991f12cc12148f8d4e1b35d/obelisk-upgradedeleted

No changes to the content.

migration/2ccf977797628dc3b1c002927fedc7a8-46f9c6c66e2bd8980402b6117ca40965/obelisk-handoffdeleted

No changes to the content.

migration/2ccf977797628dc3b1c002927fedc7a8-46f9c6c66e2bd8980402b6117ca40965/obelisk-upgradedeleted

No changes to the content.

migration/2df092178e167b474dd08dfa46ec3a49-9c94cd459a25b5c2de56067c8fdac620/obelisk-handoffdeleted

No changes to the content.

migration/2df092178e167b474dd08dfa46ec3a49-9c94cd459a25b5c2de56067c8fdac620/obelisk-upgradedeleted

No changes to the content.

migration/2e3e85cc59aa31f24f18c027542c0510-47357c6c23f049241902bf2e2e686ac8/obelisk-handoffdeleted

No changes to the content.

migration/2e3e85cc59aa31f24f18c027542c0510-47357c6c23f049241902bf2e2e686ac8/obelisk-upgradedeleted

No changes to the content.

migration/2e7cdc2bea08bb2358219ddefef372e0-a00870cfca85ff8dae5db3a78f5a227d/obelisk-handoffdeleted

No changes to the content.

migration/2e7cdc2bea08bb2358219ddefef372e0-a00870cfca85ff8dae5db3a78f5a227d/obelisk-upgradedeleted

No changes to the content.

migration/2e9a04a228106f62128ea5bd19d6b25e-947784563e3a27cf6486bed9a3c52f15/obelisk-handoffdeleted

No changes to the content.

migration/2e9a04a228106f62128ea5bd19d6b25e-947784563e3a27cf6486bed9a3c52f15/obelisk-upgradedeleted

No changes to the content.

migration/2eb907820012f77e60350430d89631fe-494be5819cd601fd2f0c20e1b23b84a3/obelisk-handoffdeleted

No changes to the content.

migration/2eb907820012f77e60350430d89631fe-494be5819cd601fd2f0c20e1b23b84a3/obelisk-upgradedeleted

No changes to the content.

migration/2ef4f9cce6d15ae62d5112d3c224eb7a-a080b8549e32f21fec11084f4ab1e052/obelisk-handoffdeleted

No changes to the content.

migration/2ef4f9cce6d15ae62d5112d3c224eb7a-a080b8549e32f21fec11084f4ab1e052/obelisk-upgradedeleted

No changes to the content.

migration/2f3ecb5cdb0ab839a49271d91dd7852a-f9ad863c0bebc103f8b81afdf82e6293/obelisk-handoffdeleted

No changes to the content.

migration/2f3ecb5cdb0ab839a49271d91dd7852a-f9ad863c0bebc103f8b81afdf82e6293/obelisk-upgradedeleted

No changes to the content.

migration/2f928f9c4a137186f808a231c9e3c141-9e61f37dd79310b71c80ee166aeb4e80/obelisk-handoffdeleted

No changes to the content.

migration/2f928f9c4a137186f808a231c9e3c141-9e61f37dd79310b71c80ee166aeb4e80/obelisk-upgradedeleted

No changes to the content.

migration/315cd79f97dae2f3669551dc03e0fd27-c801cbcf925c0a7b084ef152e3c08f8e/obelisk-handoffdeleted

No changes to the content.

migration/315cd79f97dae2f3669551dc03e0fd27-c801cbcf925c0a7b084ef152e3c08f8e/obelisk-upgradedeleted

No changes to the content.

migration/31a676fd9e1f69bd07380480ec879da0-9223532a537f698ef36f4dce6e922a6b/obelisk-handoffdeleted

No changes to the content.

migration/31a676fd9e1f69bd07380480ec879da0-9223532a537f698ef36f4dce6e922a6b/obelisk-upgradedeleted

No changes to the content.

migration/338b92f88c49c7c3a1d8ec231d9f7189-a4477746ae1a7024bc3cd0807180d418/obelisk-handoffdeleted

No changes to the content.

migration/338b92f88c49c7c3a1d8ec231d9f7189-a4477746ae1a7024bc3cd0807180d418/obelisk-upgradedeleted

No changes to the content.

migration/33da5c0e6705843afa6e39e65bfa0564-3ec562b7333839d48e9523aec595f3ab/obelisk-handoffdeleted

No changes to the content.

migration/33da5c0e6705843afa6e39e65bfa0564-3ec562b7333839d48e9523aec595f3ab/obelisk-upgradedeleted

No changes to the content.

migration/34d14d4a444d3bf1487ada6129815df4-afbd010add526d309dccee6895e42d0d/obelisk-handoffdeleted

No changes to the content.

migration/34d14d4a444d3bf1487ada6129815df4-afbd010add526d309dccee6895e42d0d/obelisk-upgradedeleted

No changes to the content.

migration/35acc1e0c4d9c02d60abd116f3df84ee-ffa62158ed6fdece012980e4ad25e6ac/obelisk-handoffdeleted

No changes to the content.

migration/35acc1e0c4d9c02d60abd116f3df84ee-ffa62158ed6fdece012980e4ad25e6ac/obelisk-upgradedeleted

No changes to the content.

migration/367616bd36eda757f251a5e8e9096acc-ddaa8e0e42a1ef00154d580a390c9f17/obelisk-handoffdeleted

No changes to the content.

migration/367616bd36eda757f251a5e8e9096acc-ddaa8e0e42a1ef00154d580a390c9f17/obelisk-upgradedeleted

No changes to the content.

migration/36cdb1c744c3036c2932f01d5fadd9f5-e7b566495114e160f1f4d722b7ed8174/obelisk-handoffdeleted

No changes to the content.

migration/36cdb1c744c3036c2932f01d5fadd9f5-e7b566495114e160f1f4d722b7ed8174/obelisk-upgradedeleted

No changes to the content.

migration/375acf7f2a3b3c487da2a6b30735d74d-3b614d291e262d0f281b54ff42a6bb66/obelisk-handoffdeleted

No changes to the content.

migration/375acf7f2a3b3c487da2a6b30735d74d-3b614d291e262d0f281b54ff42a6bb66/obelisk-upgradedeleted

No changes to the content.

migration/37c2ed0ba2cd54c0ec29eae9043bc4c8-190460dabd2b9773c3fe81902d0c8a62/obelisk-handoffdeleted

No changes to the content.

migration/37c2ed0ba2cd54c0ec29eae9043bc4c8-190460dabd2b9773c3fe81902d0c8a62/obelisk-upgradedeleted

No changes to the content.

migration/388d7d29a65c1713e07a654e91eb9caf-b6ffce85249f30616da76334c7bbec6e/obelisk-handoffdeleted

No changes to the content.

migration/388d7d29a65c1713e07a654e91eb9caf-b6ffce85249f30616da76334c7bbec6e/obelisk-upgradedeleted

No changes to the content.

migration/39df6544d6b035d4c77cc829729f9c19-9f6c8fd80ab3ff2dcc48bfd211c8b761/obelisk-handoffdeleted

No changes to the content.

migration/39df6544d6b035d4c77cc829729f9c19-9f6c8fd80ab3ff2dcc48bfd211c8b761/obelisk-upgradedeleted

No changes to the content.

migration/3a207630aa67e5df48d2b87d34db616b-8adb921f4dbb9d363bf6647d304e02fe/obelisk-handoffdeleted

No changes to the content.

migration/3a207630aa67e5df48d2b87d34db616b-8adb921f4dbb9d363bf6647d304e02fe/obelisk-upgradedeleted

No changes to the content.

migration/3b614d291e262d0f281b54ff42a6bb66-2e9a04a228106f62128ea5bd19d6b25e/obelisk-handoffdeleted

No changes to the content.

migration/3b614d291e262d0f281b54ff42a6bb66-2e9a04a228106f62128ea5bd19d6b25e/obelisk-upgradedeleted

No changes to the content.

migration/3bc53f3a28cb8f403cc41c11a37eec5d-cd86427cc2d5b2e931d7ab03deb19d20/obelisk-handoffdeleted

No changes to the content.

migration/3bc53f3a28cb8f403cc41c11a37eec5d-cd86427cc2d5b2e931d7ab03deb19d20/obelisk-upgradedeleted

No changes to the content.

migration/3bf8e28473fb05791c5790f8906e2609-45185a6f053557f93a13cb8cd03963a7/obelisk-handoffdeleted

No changes to the content.

migration/3bf8e28473fb05791c5790f8906e2609-45185a6f053557f93a13cb8cd03963a7/obelisk-upgradedeleted

No changes to the content.

migration/3c1fc501da00f467c9a48a1ddee2c2b0-cd5b54d21dd0fb868f48624d41021f47/obelisk-handoffdeleted

No changes to the content.

migration/3c1fc501da00f467c9a48a1ddee2c2b0-cd5b54d21dd0fb868f48624d41021f47/obelisk-upgradedeleted

No changes to the content.

migration/3c4b3152f0608d23d07240e2df3ff8da-c6baede3962454713b73acefcc92fe75/obelisk-handoffdeleted

No changes to the content.

migration/3c4b3152f0608d23d07240e2df3ff8da-c6baede3962454713b73acefcc92fe75/obelisk-upgradedeleted

No changes to the content.

migration/3c7755e495f20cfac5e4dabe78644c5a-51e25cf740f064faa0a29b8e2afcc109/obelisk-handoffdeleted

No changes to the content.

migration/3c7755e495f20cfac5e4dabe78644c5a-51e25cf740f064faa0a29b8e2afcc109/obelisk-upgradedeleted

No changes to the content.

migration/3c80eccfe80d0abd36b07bb11e69fc7a-b4f6596f2c16811442d8bb2961fbb721/obelisk-handoffdeleted

No changes to the content.

migration/3c80eccfe80d0abd36b07bb11e69fc7a-b4f6596f2c16811442d8bb2961fbb721/obelisk-upgradedeleted

No changes to the content.

migration/3cb52c2838303a362e9efb7c7eea37bd-aeafaa5d20bab4439a5d31f29023a839/obelisk-handoffdeleted

No changes to the content.

migration/3cb52c2838303a362e9efb7c7eea37bd-aeafaa5d20bab4439a5d31f29023a839/obelisk-upgradedeleted

No changes to the content.

migration/3da702ef7f531ad6db874ac3f85e9c06-73bcf3ed6593d074bd097cd43f5145d1/obelisk-handoffdeleted

No changes to the content.

migration/3da702ef7f531ad6db874ac3f85e9c06-73bcf3ed6593d074bd097cd43f5145d1/obelisk-upgradedeleted

No changes to the content.

migration/3da7d4a3b507d18097a90becf4dde9aa-e1ef432db54d9a6daa9bdeeb543262ae/obelisk-handoffdeleted

No changes to the content.

migration/3da7d4a3b507d18097a90becf4dde9aa-e1ef432db54d9a6daa9bdeeb543262ae/obelisk-upgradedeleted

No changes to the content.

migration/3daecb03985f83d8af466a9e0541782b-a2665cfd303a4a34a7bfa3b7d0d264bb/obelisk-handoffdeleted

No changes to the content.

migration/3daecb03985f83d8af466a9e0541782b-a2665cfd303a4a34a7bfa3b7d0d264bb/obelisk-upgradedeleted

No changes to the content.

migration/3e253c6beb567ba8f4c8086a76b70645-d6cacd7f4fab95c4b6aa2d6c1a4ad2a0/obelisk-handoffdeleted

No changes to the content.

migration/3e253c6beb567ba8f4c8086a76b70645-d6cacd7f4fab95c4b6aa2d6c1a4ad2a0/obelisk-upgradedeleted

No changes to the content.

migration/3e763ebe16cc3a261f5776ab1f1f6d9a-583ec22b9af66e8f629ee404307eb2dc/obelisk-handoffdeleted

No changes to the content.

migration/3e763ebe16cc3a261f5776ab1f1f6d9a-583ec22b9af66e8f629ee404307eb2dc/obelisk-upgradedeleted

No changes to the content.

migration/3e8a6968585d3d60f3b13652a386aec0-c118e1ee09ec8d9aa3edf04e211ae035/obelisk-handoffdeleted

No changes to the content.

migration/3e8a6968585d3d60f3b13652a386aec0-c118e1ee09ec8d9aa3edf04e211ae035/obelisk-upgradedeleted

No changes to the content.

migration/3ec562b7333839d48e9523aec595f3ab-7b9c28d09bd962e89b9715500f9e184c/obelisk-handoffdeleted

No changes to the content.

migration/3ec562b7333839d48e9523aec595f3ab-7b9c28d09bd962e89b9715500f9e184c/obelisk-upgradedeleted

No changes to the content.

migration/3f0687592a77c0c66193652e9cd981fd-fb81153791e49cd00850e91ff7418018/obelisk-handoffdeleted

No changes to the content.

migration/3f0687592a77c0c66193652e9cd981fd-fb81153791e49cd00850e91ff7418018/obelisk-upgradedeleted

No changes to the content.

migration/3f23549fba6f8e67ba36b4405e8680b3-a6633fc9687566aa84c3d5d5e2bff4fd/obelisk-handoffdeleted

No changes to the content.

migration/3f23549fba6f8e67ba36b4405e8680b3-a6633fc9687566aa84c3d5d5e2bff4fd/obelisk-upgradedeleted

No changes to the content.

migration/41e3ba178b727517aa1cedc8815abe86-1d084e187591225f0e8fa6fa824f8863/obelisk-handoffdeleted

No changes to the content.

migration/41e3ba178b727517aa1cedc8815abe86-1d084e187591225f0e8fa6fa824f8863/obelisk-upgradedeleted

No changes to the content.

migration/4205857df2e234a476ad56f84a33e6ed-db327f87e60d4e59bdbfd482e5abe985/obelisk-handoffdeleted

No changes to the content.

migration/4205857df2e234a476ad56f84a33e6ed-db327f87e60d4e59bdbfd482e5abe985/obelisk-upgradedeleted

No changes to the content.

migration/423088b98df50b986c9197af83c42a25-3a207630aa67e5df48d2b87d34db616b/obelisk-handoffdeleted

No changes to the content.

migration/423088b98df50b986c9197af83c42a25-3a207630aa67e5df48d2b87d34db616b/obelisk-upgradedeleted

No changes to the content.

migration/42357310c09e345f9360259c6c4102f2-ae8862f8b7292690c852111ca5659ce9/obelisk-handoffdeleted

No changes to the content.

migration/42357310c09e345f9360259c6c4102f2-ae8862f8b7292690c852111ca5659ce9/obelisk-upgradedeleted

No changes to the content.

migration/4344c1bd0ef04ebc055d5252f58b0bef-2f3ecb5cdb0ab839a49271d91dd7852a/obelisk-handoffdeleted

No changes to the content.

migration/4344c1bd0ef04ebc055d5252f58b0bef-2f3ecb5cdb0ab839a49271d91dd7852a/obelisk-upgradedeleted

No changes to the content.

migration/4509e2a908da9e497fa67acacdd107b6-1fe00204f9d2cd653ff2894eae3d9356/obelisk-handoffdeleted

No changes to the content.

migration/4509e2a908da9e497fa67acacdd107b6-1fe00204f9d2cd653ff2894eae3d9356/obelisk-upgradedeleted

No changes to the content.

migration/45185a6f053557f93a13cb8cd03963a7-cffcc6cab6080a35b7bf7c5c7facd6bc/obelisk-handoffdeleted

No changes to the content.

migration/45185a6f053557f93a13cb8cd03963a7-cffcc6cab6080a35b7bf7c5c7facd6bc/obelisk-upgradedeleted

No changes to the content.

migration/455279b6974b96a673613cd0ccc8ed54-b3ff195b0a90ef5900f9cef2ba75f2fe/obelisk-handoffdeleted

No changes to the content.

migration/455279b6974b96a673613cd0ccc8ed54-b3ff195b0a90ef5900f9cef2ba75f2fe/obelisk-upgradedeleted

No changes to the content.

migration/463646ba21b356f612539ea34178adf9-b3b107d406a6a7675cd5b9f52e5f7d8e/obelisk-handoffdeleted

No changes to the content.

migration/463646ba21b356f612539ea34178adf9-b3b107d406a6a7675cd5b9f52e5f7d8e/obelisk-upgradedeleted

No changes to the content.

migration/466a19f9cfa2a103467fe6627225d27f-c67f206b6d2626eb6d36b00122b52784/obelisk-handoffdeleted

No changes to the content.

migration/466a19f9cfa2a103467fe6627225d27f-c67f206b6d2626eb6d36b00122b52784/obelisk-upgradedeleted

No changes to the content.

migration/469a31d20d69da72e6a3a3ea2bb02f9d-75c9cd9763d0ed89c17d455f49d66a4f/obelisk-handoffdeleted

No changes to the content.

migration/469a31d20d69da72e6a3a3ea2bb02f9d-75c9cd9763d0ed89c17d455f49d66a4f/obelisk-upgradedeleted

No changes to the content.

migration/46aed07c1a61476dd245ff8e74c0559f-73e2573d9074884d7ae83106d55ad229/obelisk-handoffdeleted

No changes to the content.

migration/46aed07c1a61476dd245ff8e74c0559f-73e2573d9074884d7ae83106d55ad229/obelisk-upgradedeleted

No changes to the content.

migration/46f9c6c66e2bd8980402b6117ca40965-463646ba21b356f612539ea34178adf9/obelisk-handoffdeleted

No changes to the content.

migration/46f9c6c66e2bd8980402b6117ca40965-463646ba21b356f612539ea34178adf9/obelisk-upgradedeleted

No changes to the content.

migration/470df6504156dc940b8e7f89c148e619-a5297d8457aa4c327f35d4697f6cb66f/obelisk-handoffdeleted

No changes to the content.

migration/470df6504156dc940b8e7f89c148e619-a5297d8457aa4c327f35d4697f6cb66f/obelisk-upgradedeleted

No changes to the content.

migration/47357c6c23f049241902bf2e2e686ac8-d62d6d443d9c2261b7e09664398aa005/obelisk-handoffdeleted

No changes to the content.

migration/47357c6c23f049241902bf2e2e686ac8-d62d6d443d9c2261b7e09664398aa005/obelisk-upgradedeleted

No changes to the content.

migration/475f9a0d63e84e9cf13b8be3986cb603-b95c8d049256fb7360ca14b12acd8544/obelisk-handoffdeleted

No changes to the content.

migration/475f9a0d63e84e9cf13b8be3986cb603-b95c8d049256fb7360ca14b12acd8544/obelisk-upgradedeleted

No changes to the content.

migration/477a0bb12b48357d1e2b415c91d904e3-486d5218951605d14ec4a1046d3fe83e/obelisk-handoffdeleted

No changes to the content.

migration/477a0bb12b48357d1e2b415c91d904e3-486d5218951605d14ec4a1046d3fe83e/obelisk-upgradedeleted

No changes to the content.

migration/486d5218951605d14ec4a1046d3fe83e-90489c1a9f7edd46a070d6474dceac86/obelisk-handoffdeleted

No changes to the content.

migration/486d5218951605d14ec4a1046d3fe83e-90489c1a9f7edd46a070d6474dceac86/obelisk-upgradedeleted

No changes to the content.

migration/48c027da19d895ba03e7b9120f771291-29fd07af89cc31526fca00226ff52a82/obelisk-handoffdeleted

No changes to the content.

migration/48c027da19d895ba03e7b9120f771291-29fd07af89cc31526fca00226ff52a82/obelisk-upgradedeleted

No changes to the content.

migration/494be5819cd601fd2f0c20e1b23b84a3-c66bc5ba27dec52d144ceb0aa429e449/obelisk-handoffdeleted

No changes to the content.

migration/494be5819cd601fd2f0c20e1b23b84a3-c66bc5ba27dec52d144ceb0aa429e449/obelisk-upgradedeleted

No changes to the content.

migration/4a037879b8a542f1590cbb87b0242331-4344c1bd0ef04ebc055d5252f58b0bef/obelisk-handoffdeleted

No changes to the content.

migration/4a037879b8a542f1590cbb87b0242331-4344c1bd0ef04ebc055d5252f58b0bef/obelisk-upgradedeleted

No changes to the content.

migration/4ab915b764f38a1b0b4ae6f619f5c3fa-59e4a192c611a2a9f6736afde9fe1a0e/obelisk-handoffdeleted

No changes to the content.

migration/4ab915b764f38a1b0b4ae6f619f5c3fa-59e4a192c611a2a9f6736afde9fe1a0e/obelisk-upgradedeleted

No changes to the content.

migration/4ace4414d71235a291f7148f80a0b0f5-9705509619667aacf799e91927c16dc8/obelisk-handoffdeleted

No changes to the content.

migration/4ace4414d71235a291f7148f80a0b0f5-9705509619667aacf799e91927c16dc8/obelisk-upgradedeleted

No changes to the content.

migration/4aefa80392582ec03a19f946e752d331-cb98f93880e6dea74014976977d6eb93/obelisk-handoffdeleted

No changes to the content.

migration/4aefa80392582ec03a19f946e752d331-cb98f93880e6dea74014976977d6eb93/obelisk-upgradedeleted

No changes to the content.

migration/4b3f45ce8aeb17ef18d1d9502b74bb7e-4efbe4a73c260cca09fed7169e82a7ff/obelisk-handoffdeleted

No changes to the content.

migration/4b3f45ce8aeb17ef18d1d9502b74bb7e-4efbe4a73c260cca09fed7169e82a7ff/obelisk-upgradedeleted

No changes to the content.

migration/4b7a36dce2c1cf94554e12d8a7903269-dd6ca52a58ea6cda7b3eaa2e87bb13d9/obelisk-handoffdeleted

No changes to the content.

migration/4b7a36dce2c1cf94554e12d8a7903269-dd6ca52a58ea6cda7b3eaa2e87bb13d9/obelisk-upgradedeleted

No changes to the content.

migration/4c9372bf9aa6ebed1ea20abf3dbb0075-b641dd9c5359201200e483a784456cc2/obelisk-handoffdeleted

No changes to the content.

migration/4c9372bf9aa6ebed1ea20abf3dbb0075-b641dd9c5359201200e483a784456cc2/obelisk-upgradedeleted

No changes to the content.

migration/4d6197d8166de78f882376102e36300b-4205857df2e234a476ad56f84a33e6ed/obelisk-handoffdeleted

No changes to the content.

migration/4d6197d8166de78f882376102e36300b-4205857df2e234a476ad56f84a33e6ed/obelisk-upgradedeleted

No changes to the content.

migration/4d85ee8cdb0db20a5662b09567a2bbe7-b6425c7661af2116b912a558e9548013/obelisk-handoffdeleted

No changes to the content.

migration/4d85ee8cdb0db20a5662b09567a2bbe7-b6425c7661af2116b912a558e9548013/obelisk-upgradedeleted

No changes to the content.

migration/4da182e21be35feeee484dc85be7a075-14840816db4b5cfd5580ae099022604a/obelisk-handoffdeleted

No changes to the content.

migration/4da182e21be35feeee484dc85be7a075-14840816db4b5cfd5580ae099022604a/obelisk-upgradedeleted

No changes to the content.

migration/4db97ca86399c557e5ee0d04d0838acc-c203adc5fed9bf79f67df43d72a4631a/obelisk-handoffdeleted

No changes to the content.

migration/4db97ca86399c557e5ee0d04d0838acc-c203adc5fed9bf79f67df43d72a4631a/obelisk-upgradedeleted

No changes to the content.

migration/4e3e6e8b9d0f4194842e530438ff686f-b7e30314f9d0e69efdc84c7eb4e3bcc3/obelisk-handoffdeleted

No changes to the content.

migration/4e3e6e8b9d0f4194842e530438ff686f-b7e30314f9d0e69efdc84c7eb4e3bcc3/obelisk-upgradedeleted

No changes to the content.

migration/4e95e2f8ef50420371b71022c644e25d-8df9e256d8e43fa4e22d953024269b5b/obelisk-handoffdeleted

No changes to the content.

migration/4e95e2f8ef50420371b71022c644e25d-8df9e256d8e43fa4e22d953024269b5b/obelisk-upgradedeleted

No changes to the content.

migration/4efbe4a73c260cca09fed7169e82a7ff-315cd79f97dae2f3669551dc03e0fd27/obelisk-handoffdeleted

No changes to the content.

migration/4efbe4a73c260cca09fed7169e82a7ff-315cd79f97dae2f3669551dc03e0fd27/obelisk-upgradedeleted

No changes to the content.

migration/4fe321cf196b9cd25210c35e09e09d8f-56d7fd24c8a996e49bb26dd797819897/obelisk-handoffdeleted

No changes to the content.

migration/4fe321cf196b9cd25210c35e09e09d8f-56d7fd24c8a996e49bb26dd797819897/obelisk-upgradedeleted

No changes to the content.

migration/4ff5bf819ea43a638abbcfa071bbf3ef-975cd8245d06ad09e4fb176cfc9af5e0/obelisk-handoffdeleted

No changes to the content.

migration/4ff5bf819ea43a638abbcfa071bbf3ef-975cd8245d06ad09e4fb176cfc9af5e0/obelisk-upgradedeleted

No changes to the content.

migration/50b85e79010ad50ee275eaeba0df6f8d-e327773e1525eaa1eb2112dff8f41b26/obelisk-handoffdeleted

No changes to the content.

migration/50b85e79010ad50ee275eaeba0df6f8d-e327773e1525eaa1eb2112dff8f41b26/obelisk-upgradedeleted

No changes to the content.

migration/51c7d001730ddd3d76e0c8bb57038773-423088b98df50b986c9197af83c42a25/obelisk-handoffdeleted

No changes to the content.

migration/51c7d001730ddd3d76e0c8bb57038773-423088b98df50b986c9197af83c42a25/obelisk-upgradedeleted

No changes to the content.

migration/51e25cf740f064faa0a29b8e2afcc109-7bc4c944b24621967a6334f522437cc1/obelisk-handoffdeleted

No changes to the content.

migration/51e25cf740f064faa0a29b8e2afcc109-7bc4c944b24621967a6334f522437cc1/obelisk-upgradedeleted

No changes to the content.

migration/51f3d5068259f596b811450f0bf25419-f9716ad47c84e0b7ac7d426e8ad059f3/obelisk-handoffdeleted

No changes to the content.

migration/51f3d5068259f596b811450f0bf25419-f9716ad47c84e0b7ac7d426e8ad059f3/obelisk-upgradedeleted

No changes to the content.

migration/52330622ae996023b3f80a40991521a4-1df871cede0758cabe43971d9091279d/obelisk-handoffdeleted

No changes to the content.

migration/52330622ae996023b3f80a40991521a4-1df871cede0758cabe43971d9091279d/obelisk-upgradedeleted

No changes to the content.

migration/52df183d0f32d5a1e9ebe276b6d83d37-08dbdf23867a8efa680283ad251d3429/obelisk-handoffdeleted

No changes to the content.

migration/52df183d0f32d5a1e9ebe276b6d83d37-08dbdf23867a8efa680283ad251d3429/obelisk-upgradedeleted

No changes to the content.

migration/53d29061537ddaf7530aef88624ab266-9fe2922674fcee5e840c9f52cf534f88/obelisk-handoffdeleted

No changes to the content.

migration/53d29061537ddaf7530aef88624ab266-9fe2922674fcee5e840c9f52cf534f88/obelisk-upgradedeleted

No changes to the content.

migration/53fdf819333b86dfb485bf16a8f28db2-93fc625d41bae9fcf06b9febeacb686d/obelisk-handoffdeleted

No changes to the content.

migration/53fdf819333b86dfb485bf16a8f28db2-93fc625d41bae9fcf06b9febeacb686d/obelisk-upgradedeleted

No changes to the content.

migration/554c459ff2cced3e1b11241ed403890d-3543ea607791bc2e19419d22918823bd/obelisk-handoffdeleted

No changes to the content.

migration/554c459ff2cced3e1b11241ed403890d-3543ea607791bc2e19419d22918823bd/obelisk-upgradedeleted

No changes to the content.

migration/554c459ff2cced3e1b11241ed403890d-6a18939264224d6ce24c7426249edfea/obelisk-handoffdeleted

No changes to the content.

migration/554c459ff2cced3e1b11241ed403890d-6a18939264224d6ce24c7426249edfea/obelisk-upgradedeleted

No changes to the content.

migration/55cf43fb0d3868040c9efbf2f92d538a-e2706f337218a12a3bdddd18fa3f4cfd/obelisk-handoffdeleted

No changes to the content.

migration/55cf43fb0d3868040c9efbf2f92d538a-e2706f337218a12a3bdddd18fa3f4cfd/obelisk-upgradedeleted

No changes to the content.

migration/55d9c5eb3b86c9cb27966f849b2d32cf-0e4d0f0f0af0925474b0d772be2b145f/obelisk-handoffdeleted

No changes to the content.

migration/55d9c5eb3b86c9cb27966f849b2d32cf-0e4d0f0f0af0925474b0d772be2b145f/obelisk-upgradedeleted

No changes to the content.

migration/5631293b75143d170b8fca5579e15fee-0abd9d31c77be8c9a9e83bf1f73276f6/obelisk-handoffdeleted

No changes to the content.

migration/5631293b75143d170b8fca5579e15fee-0abd9d31c77be8c9a9e83bf1f73276f6/obelisk-upgradedeleted

No changes to the content.

migration/569227e5e7754c1890022850fd552292-ff1105290f89350bc9deb6eb907e0a53/obelisk-handoffdeleted

No changes to the content.

migration/569227e5e7754c1890022850fd552292-ff1105290f89350bc9deb6eb907e0a53/obelisk-upgradedeleted

No changes to the content.

migration/56d7fd24c8a996e49bb26dd797819897-61f734d4c59e46f03e92d2b86299c7c9/obelisk-handoffdeleted

No changes to the content.

migration/56d7fd24c8a996e49bb26dd797819897-61f734d4c59e46f03e92d2b86299c7c9/obelisk-upgradedeleted

No changes to the content.

migration/5734398c41e4eb5bb58d933ed2e12041-fb374b0721716a1e849e64daf6da73c4/obelisk-handoffdeleted

No changes to the content.

migration/5734398c41e4eb5bb58d933ed2e12041-fb374b0721716a1e849e64daf6da73c4/obelisk-upgradedeleted

No changes to the content.

migration/58391ba73c13d922e8a12116b28caad2-215b6810b09f219a5cb3842aacc88432/obelisk-handoffdeleted

No changes to the content.

migration/58391ba73c13d922e8a12116b28caad2-215b6810b09f219a5cb3842aacc88432/obelisk-upgradedeleted

No changes to the content.

migration/583ec22b9af66e8f629ee404307eb2dc-6c7f4af3693c31e1a2c6a2c3f189ddf5/obelisk-handoffdeleted

No changes to the content.

migration/583ec22b9af66e8f629ee404307eb2dc-6c7f4af3693c31e1a2c6a2c3f189ddf5/obelisk-upgradedeleted

No changes to the content.

migration/58479e482d3828ce44f2c8371ed9135a-174fa1072ee767be39b7b01aecea5714/obelisk-handoffdeleted

No changes to the content.

migration/58479e482d3828ce44f2c8371ed9135a-174fa1072ee767be39b7b01aecea5714/obelisk-upgradedeleted

No changes to the content.

migration/589eb89cdb09655c5edde4cd2a4deb80-c5a306045ad998f906f80748fe18487f/obelisk-handoffdeleted

No changes to the content.

migration/589eb89cdb09655c5edde4cd2a4deb80-c5a306045ad998f906f80748fe18487f/obelisk-upgradedeleted

No changes to the content.

migration/58f9d23d2cede2081dc6f6cfa2283f60-41e3ba178b727517aa1cedc8815abe86/obelisk-handoffdeleted

No changes to the content.

migration/58f9d23d2cede2081dc6f6cfa2283f60-41e3ba178b727517aa1cedc8815abe86/obelisk-upgradedeleted

No changes to the content.

migration/59742705e53838ae13066a2239a72040-95955d1dd0981ebb538ee941cde1f963/obelisk-handoffdeleted

No changes to the content.

migration/59742705e53838ae13066a2239a72040-95955d1dd0981ebb538ee941cde1f963/obelisk-upgradedeleted

No changes to the content.

migration/59e4a192c611a2a9f6736afde9fe1a0e-8143888349912db9780231c370ea2060/obelisk-handoffdeleted

No changes to the content.

migration/59e4a192c611a2a9f6736afde9fe1a0e-8143888349912db9780231c370ea2060/obelisk-upgradedeleted

No changes to the content.

migration/5a98cdb6c195e88beac878a3f311c5b5-66d79b4c393877a72aec18f227049207/obelisk-handoffdeleted

No changes to the content.

migration/5a98cdb6c195e88beac878a3f311c5b5-66d79b4c393877a72aec18f227049207/obelisk-upgradedeleted

No changes to the content.

migration/5b252c24612c2ba868580add9d9c19e3-6f104c322bbaff565981739406290402/obelisk-handoffdeleted

No changes to the content.

migration/5b252c24612c2ba868580add9d9c19e3-6f104c322bbaff565981739406290402/obelisk-upgradedeleted

No changes to the content.

migration/5b6770965bbef440db49b0703cd243a3-11f38b38c2d38004bb8a9dbfe2ef3e4a/obelisk-handoffdeleted

No changes to the content.

migration/5b6770965bbef440db49b0703cd243a3-11f38b38c2d38004bb8a9dbfe2ef3e4a/obelisk-upgradedeleted

No changes to the content.

migration/5cb98d0250bf5224b94e544a5140a54c-fa18f7522903a21b615dbee24c26bfbe/obelisk-handoffdeleted

No changes to the content.

migration/5cb98d0250bf5224b94e544a5140a54c-fa18f7522903a21b615dbee24c26bfbe/obelisk-upgradedeleted

No changes to the content.

migration/5d90abd974b4ec53091a8cb3fc2258ce-d40e0e3051a76c4c198cc11c2e8e4b7c/obelisk-handoffdeleted

No changes to the content.

migration/5d90abd974b4ec53091a8cb3fc2258ce-d40e0e3051a76c4c198cc11c2e8e4b7c/obelisk-upgradedeleted

No changes to the content.

migration/5f0d3f7480d67df7deebdb880726b356-4ab915b764f38a1b0b4ae6f619f5c3fa/obelisk-handoffdeleted

No changes to the content.

migration/5f0d3f7480d67df7deebdb880726b356-4ab915b764f38a1b0b4ae6f619f5c3fa/obelisk-upgradedeleted

No changes to the content.

migration/5f307639ccf6a64309166bfe58037397-702c65f35bc47641d60580d636ede330/obelisk-handoffdeleted

No changes to the content.

migration/5f307639ccf6a64309166bfe58037397-702c65f35bc47641d60580d636ede330/obelisk-upgradedeleted

No changes to the content.

migration/5f6fe243beb9fcc0c4117536022fc14c-f41b690c74938e347cf042cee2d4fc72/obelisk-handoffdeleted

No changes to the content.

migration/5f6fe243beb9fcc0c4117536022fc14c-f41b690c74938e347cf042cee2d4fc72/obelisk-upgradedeleted

No changes to the content.

migration/6095bdaccd933d319c84cde7983e2d10-477a0bb12b48357d1e2b415c91d904e3/obelisk-handoffdeleted

No changes to the content.

migration/6095bdaccd933d319c84cde7983e2d10-477a0bb12b48357d1e2b415c91d904e3/obelisk-upgradedeleted

No changes to the content.

migration/610dcf99f7eb8c8b591ff3f5f1722938-131e1d5cc8163ce9a174a8782be23fe7/obelisk-handoffdeleted

No changes to the content.

migration/610dcf99f7eb8c8b591ff3f5f1722938-131e1d5cc8163ce9a174a8782be23fe7/obelisk-upgradedeleted

No changes to the content.

migration/61f734d4c59e46f03e92d2b86299c7c9-02d0f8b5c7472e6f8a99ec2cfcb59807/obelisk-handoffdeleted

No changes to the content.

migration/61f734d4c59e46f03e92d2b86299c7c9-02d0f8b5c7472e6f8a99ec2cfcb59807/obelisk-upgradedeleted

No changes to the content.

migration/63422a9bade5c703461b600e03e227f0-01ddc6354698efa1ae5822da3be562dc/obelisk-handoffdeleted

No changes to the content.

migration/63422a9bade5c703461b600e03e227f0-01ddc6354698efa1ae5822da3be562dc/obelisk-upgradedeleted

No changes to the content.

migration/63ff9426130baa080f37400a86c55fdd-569227e5e7754c1890022850fd552292/obelisk-handoffdeleted

No changes to the content.

migration/63ff9426130baa080f37400a86c55fdd-569227e5e7754c1890022850fd552292/obelisk-upgradedeleted

No changes to the content.

migration/64ee9e40f4943e0122398e48019f5616-cd38e239c47fb92fabd867b7f86fc99a/obelisk-handoffdeleted

No changes to the content.

migration/64ee9e40f4943e0122398e48019f5616-cd38e239c47fb92fabd867b7f86fc99a/obelisk-upgradedeleted

No changes to the content.

migration/65071e255719af6389857646bc087d37-02fb88dab35884e09deef1721c1cfc13/obelisk-handoffdeleted

No changes to the content.

migration/65071e255719af6389857646bc087d37-02fb88dab35884e09deef1721c1cfc13/obelisk-upgradedeleted

No changes to the content.

migration/6558f8bda2aa17d76c509dde0a3dea56-2ccf977797628dc3b1c002927fedc7a8/obelisk-handoffdeleted

No changes to the content.

migration/6558f8bda2aa17d76c509dde0a3dea56-2ccf977797628dc3b1c002927fedc7a8/obelisk-upgradedeleted

No changes to the content.

migration/6566f0555737425bae9106d1a4a0a2dd-1f7fb90cb1e558f5285b2d19a25a1078/obelisk-handoffdeleted

No changes to the content.

migration/6566f0555737425bae9106d1a4a0a2dd-1f7fb90cb1e558f5285b2d19a25a1078/obelisk-upgradedeleted

No changes to the content.

migration/6620e6dc5622593e5f671127af9ade05-4ff5bf819ea43a638abbcfa071bbf3ef/obelisk-handoffdeleted

No changes to the content.

migration/6620e6dc5622593e5f671127af9ade05-4ff5bf819ea43a638abbcfa071bbf3ef/obelisk-upgradedeleted

No changes to the content.

migration/662eb30d6e4612f130edc3f6d37d92a2-94dd4eb45a4e7eb945027d5fd8eb4fa6/obelisk-handoffdeleted

No changes to the content.

migration/662eb30d6e4612f130edc3f6d37d92a2-94dd4eb45a4e7eb945027d5fd8eb4fa6/obelisk-upgradedeleted

No changes to the content.

migration/66a9b6b9e9bc4a5b0cfa78127479b231-88765caf54c2bf9f23ea4d05816a9f65/obelisk-handoffdeleted

No changes to the content.

migration/66a9b6b9e9bc4a5b0cfa78127479b231-88765caf54c2bf9f23ea4d05816a9f65/obelisk-upgradedeleted

No changes to the content.

migration/66d79b4c393877a72aec18f227049207-04dd95ecb889ac1b0a616ddfeec781c4/obelisk-handoffdeleted

No changes to the content.

migration/66d79b4c393877a72aec18f227049207-04dd95ecb889ac1b0a616ddfeec781c4/obelisk-upgradedeleted

No changes to the content.

migration/66f7a274206ad9f6d3c5701e4bcffc9d-2e7cdc2bea08bb2358219ddefef372e0/obelisk-handoffdeleted

No changes to the content.

migration/66f7a274206ad9f6d3c5701e4bcffc9d-2e7cdc2bea08bb2358219ddefef372e0/obelisk-upgradedeleted

No changes to the content.

migration/6708d14c71c475ac494808e75660a385-6095bdaccd933d319c84cde7983e2d10/obelisk-handoffdeleted

No changes to the content.

migration/6708d14c71c475ac494808e75660a385-6095bdaccd933d319c84cde7983e2d10/obelisk-upgradedeleted

No changes to the content.

migration/67173f110f2c54d135e6943b65118303-17089ea0edc0cf4b6f616936f8a06174/obelisk-handoffdeleted

No changes to the content.

migration/67173f110f2c54d135e6943b65118303-17089ea0edc0cf4b6f616936f8a06174/obelisk-upgradedeleted

No changes to the content.

migration/67bfa5b784a35e66875fb74ad84a38c0-f3ec62d09836804e39fad9d814137845/obelisk-handoffdeleted

No changes to the content.

migration/67bfa5b784a35e66875fb74ad84a38c0-f3ec62d09836804e39fad9d814137845/obelisk-upgradedeleted

No changes to the content.

migration/68cca18f813a16eb0cc2c3ed7fa08044-ee3dccc89ea6fdaaf9c1146b92861e90/obelisk-handoffdeleted

No changes to the content.

migration/68cca18f813a16eb0cc2c3ed7fa08044-ee3dccc89ea6fdaaf9c1146b92861e90/obelisk-upgradedeleted

No changes to the content.

migration/69537089a0e97845ffe05c73c3cc1536-e92786eaf56c32fd6b452c4a841d6317/obelisk-handoffdeleted

No changes to the content.

migration/69537089a0e97845ffe05c73c3cc1536-e92786eaf56c32fd6b452c4a841d6317/obelisk-upgradedeleted

No changes to the content.

migration/69cd775958e25e3b2cff7e4897f2a9bb-fca48edfdaa31b036176b97b04384682/obelisk-handoffdeleted

No changes to the content.

migration/69cd775958e25e3b2cff7e4897f2a9bb-fca48edfdaa31b036176b97b04384682/obelisk-upgradedeleted

No changes to the content.

migration/69fafe6ab155ff215b6d9d330f700ba1-6558f8bda2aa17d76c509dde0a3dea56/obelisk-handoffdeleted

No changes to the content.

migration/69fafe6ab155ff215b6d9d330f700ba1-6558f8bda2aa17d76c509dde0a3dea56/obelisk-upgradedeleted

No changes to the content.

migration/6a18939264224d6ce24c7426249edfea-e66afc8befac4d76b5780a960f768c31/obelisk-handoffdeleted

No changes to the content.

migration/6a18939264224d6ce24c7426249edfea-e66afc8befac4d76b5780a960f768c31/obelisk-upgradedeleted−15
@@ -1,15 +0,0 @@
1−# ob deploy: HTTPs support
2−
3−Obelisk deployments now support HTTPs. You must upgrade the deployment repo
4−associated with the obelisk project as follows:
5−
6−```
7−cd /your/project's/deployment/repo
8−echo True > enable_https
9−echo admin@yoursite.com > admin_email
10−echo https://yoursite.com/ > config/common/route
11−git add ... && git commit ...
12−ob deploy push
13−```
14−
15−If you do not wish to enable HTTPs, write `False` to `enable_https` instead.
migration/6c7f4af3693c31e1a2c6a2c3f189ddf5-388d7d29a65c1713e07a654e91eb9caf/obelisk-handoffdeleted

No changes to the content.

migration/6c7f4af3693c31e1a2c6a2c3f189ddf5-388d7d29a65c1713e07a654e91eb9caf/obelisk-upgradedeleted

No changes to the content.

migration/6da2e5b02ab780d12527640722d2b511-ca88f98cf9fb63d2feaef7fc19b30eca/obelisk-handoffdeleted

No changes to the content.

migration/6da2e5b02ab780d12527640722d2b511-ca88f98cf9fb63d2feaef7fc19b30eca/obelisk-upgradedeleted

No changes to the content.

migration/6dc299cb41f8977785a5d676cbcd32d7-237aeb7eee0ffed230234ee04e49569f/obelisk-handoffdeleted

No changes to the content.

migration/6dc299cb41f8977785a5d676cbcd32d7-237aeb7eee0ffed230234ee04e49569f/obelisk-upgradedeleted

No changes to the content.

migration/6f104c322bbaff565981739406290402-f98b82f5d142ce83733a3f18bdacb138/obelisk-handoffdeleted

No changes to the content.

migration/6f104c322bbaff565981739406290402-f98b82f5d142ce83733a3f18bdacb138/obelisk-upgradedeleted

No changes to the content.

migration/6f3a0f756847ee5aa208a1dc79404779-00c627540326314c7154cc209e8a71e9/obelisk-handoffdeleted

No changes to the content.

migration/6f3a0f756847ee5aa208a1dc79404779-00c627540326314c7154cc209e8a71e9/obelisk-upgradedeleted

No changes to the content.

migration/6fc44f180bb825d5b372444339681135-6dc299cb41f8977785a5d676cbcd32d7/obelisk-handoffdeleted

No changes to the content.

migration/6fc44f180bb825d5b372444339681135-6dc299cb41f8977785a5d676cbcd32d7/obelisk-upgradedeleted

No changes to the content.

migration/702c65f35bc47641d60580d636ede330-9217718d2b3b217dbba72e7091459548/obelisk-handoffdeleted

No changes to the content.

migration/702c65f35bc47641d60580d636ede330-9217718d2b3b217dbba72e7091459548/obelisk-upgradedeleted

No changes to the content.

migration/71a47d4d6856c1956c0d1c9de9af231f-bb9a87fc325204313d89dbfb689dba2f/obelisk-handoffdeleted

No changes to the content.

migration/71a47d4d6856c1956c0d1c9de9af231f-bb9a87fc325204313d89dbfb689dba2f/obelisk-upgradedeleted

No changes to the content.

migration/71c6959cf98e05d356ff798ada6db2b8-55d9c5eb3b86c9cb27966f849b2d32cf/obelisk-handoffdeleted

No changes to the content.

migration/71c6959cf98e05d356ff798ada6db2b8-55d9c5eb3b86c9cb27966f849b2d32cf/obelisk-upgradedeleted

No changes to the content.

migration/71da39c91abb23488021a1e9142507d5-16b24e1a12b93ea83d7656a09d5e3338/obelisk-handoffdeleted

No changes to the content.

migration/71da39c91abb23488021a1e9142507d5-16b24e1a12b93ea83d7656a09d5e3338/obelisk-upgradedeleted

No changes to the content.

migration/721a02f3a7549e7d6efeaed087bfacb5-52df183d0f32d5a1e9ebe276b6d83d37/obelisk-handoffdeleted

No changes to the content.

migration/721a02f3a7549e7d6efeaed087bfacb5-52df183d0f32d5a1e9ebe276b6d83d37/obelisk-upgradedeleted

No changes to the content.

migration/729aaf942e685bb37fdbd5e97293bbcb-7b2b9cefa7dd57d51b587c3501a1b9ef/obelisk-handoffdeleted

No changes to the content.

migration/729aaf942e685bb37fdbd5e97293bbcb-7b2b9cefa7dd57d51b587c3501a1b9ef/obelisk-upgradedeleted

No changes to the content.

migration/73bcf3ed6593d074bd097cd43f5145d1-375acf7f2a3b3c487da2a6b30735d74d/obelisk-handoffdeleted

No changes to the content.

migration/73bcf3ed6593d074bd097cd43f5145d1-375acf7f2a3b3c487da2a6b30735d74d/obelisk-upgradedeleted

No changes to the content.

migration/73e2573d9074884d7ae83106d55ad229-729aaf942e685bb37fdbd5e97293bbcb/obelisk-handoffdeleted

No changes to the content.

migration/73e2573d9074884d7ae83106d55ad229-729aaf942e685bb37fdbd5e97293bbcb/obelisk-upgradedeleted

No changes to the content.

migration/7447d29f4712c72458c049cdb9380753-e24a771ee59f24e45afc0a27307f2070/obelisk-handoffdeleted

No changes to the content.

migration/7447d29f4712c72458c049cdb9380753-e24a771ee59f24e45afc0a27307f2070/obelisk-upgradedeleted

No changes to the content.

migration/749df832c9305e1c6309a794b0c1b201-2619464637b85cb35376393fe612ddae/obelisk-handoffdeleted

No changes to the content.

migration/749df832c9305e1c6309a794b0c1b201-2619464637b85cb35376393fe612ddae/obelisk-upgradedeleted

No changes to the content.

migration/75c9cd9763d0ed89c17d455f49d66a4f-94372bb14f8afd19bce24f8402c7564c/obelisk-handoffdeleted

No changes to the content.

migration/75c9cd9763d0ed89c17d455f49d66a4f-94372bb14f8afd19bce24f8402c7564c/obelisk-upgradedeleted

No changes to the content.

migration/77a721a8fa97d1f84dd2af622089871b-cb2d040cc16752b1dc89eecf200ea798/obelisk-handoffdeleted

No changes to the content.

migration/77a721a8fa97d1f84dd2af622089871b-cb2d040cc16752b1dc89eecf200ea798/obelisk-upgradedeleted

No changes to the content.

migration/79357758056556793db0472562d62ff9-f15c9c2f894c8cc4fac07e2cdef47180/obelisk-handoffdeleted

No changes to the content.

migration/79357758056556793db0472562d62ff9-f15c9c2f894c8cc4fac07e2cdef47180/obelisk-upgradedeleted

No changes to the content.

migration/7adece557941a7d7ac7c150f77f758be-67173f110f2c54d135e6943b65118303/obelisk-handoffdeleted

No changes to the content.

migration/7adece557941a7d7ac7c150f77f758be-67173f110f2c54d135e6943b65118303/obelisk-upgradedeleted

No changes to the content.

migration/7b2b9cefa7dd57d51b587c3501a1b9ef-1269155fffe21926f3704d5077e04332/obelisk-handoffdeleted

No changes to the content.

migration/7b2b9cefa7dd57d51b587c3501a1b9ef-1269155fffe21926f3704d5077e04332/obelisk-upgradedeleted

No changes to the content.

migration/7b75ffdcd86b5a330d9c325ad5767393-97873167212295a0fdc1219102b6b600/obelisk-handoffdeleted

No changes to the content.

migration/7b75ffdcd86b5a330d9c325ad5767393-97873167212295a0fdc1219102b6b600/obelisk-upgradedeleted

No changes to the content.

migration/7b9c28d09bd962e89b9715500f9e184c-df71cd82e801ca701bf4bc44b80b6d50/obelisk-handoffdeleted

No changes to the content.

migration/7b9c28d09bd962e89b9715500f9e184c-df71cd82e801ca701bf4bc44b80b6d50/obelisk-upgradedeleted

No changes to the content.

migration/7bc4c944b24621967a6334f522437cc1-3e8a6968585d3d60f3b13652a386aec0/obelisk-handoffdeleted

No changes to the content.

migration/7bc4c944b24621967a6334f522437cc1-3e8a6968585d3d60f3b13652a386aec0/obelisk-upgradedeleted

No changes to the content.

migration/7c0ab1210424b615251ef57036d316c3-b8aa42d4f2e5ef7db9ba34ecf6c42079/obelisk-handoffdeleted

No changes to the content.

migration/7c0ab1210424b615251ef57036d316c3-b8aa42d4f2e5ef7db9ba34ecf6c42079/obelisk-upgradedeleted

No changes to the content.

migration/7c98ef4a123c1a580d368d14e54961b7-adad34a1075a2fd51e1a1c06ec9d002d/obelisk-handoffdeleted

No changes to the content.

migration/7c98ef4a123c1a580d368d14e54961b7-adad34a1075a2fd51e1a1c06ec9d002d/obelisk-upgradedeleted

No changes to the content.

migration/7ce32302cfbba8b7567a05144057f8a3-28c5fec3b7b0b14b3625d5c8f60bcf68/obelisk-handoffdeleted

No changes to the content.

migration/7ce32302cfbba8b7567a05144057f8a3-28c5fec3b7b0b14b3625d5c8f60bcf68/obelisk-upgradedeleted

No changes to the content.

migration/7cf814f7404638f1c1be662a24d7cfea-e609d945b642fd9d4ce99931e3699db7/obelisk-handoffdeleted

No changes to the content.

migration/7cf814f7404638f1c1be662a24d7cfea-e609d945b642fd9d4ce99931e3699db7/obelisk-upgradedeleted

No changes to the content.

migration/7dd60550d7d79bd3923d91d67ecb433a-46aed07c1a61476dd245ff8e74c0559f/obelisk-handoffdeleted

No changes to the content.

migration/7dd60550d7d79bd3923d91d67ecb433a-46aed07c1a61476dd245ff8e74c0559f/obelisk-upgradedeleted

No changes to the content.

migration/7f46d84c4d303f30602b920f96acf871-97c7e1ea2c1ddb0ef23d2e4a9279f65c/obelisk-handoffdeleted

No changes to the content.

migration/7f46d84c4d303f30602b920f96acf871-97c7e1ea2c1ddb0ef23d2e4a9279f65c/obelisk-upgradedeleted

No changes to the content.

migration/7fac40a2398039b364746989bb78798b-68cca18f813a16eb0cc2c3ed7fa08044/obelisk-handoffdeleted

No changes to the content.

migration/7fac40a2398039b364746989bb78798b-68cca18f813a16eb0cc2c3ed7fa08044/obelisk-upgradedeleted

No changes to the content.

migration/7fc381538805adac19c54b73ea118601-982c57eada4652019d0b0cf6ad355d25/obelisk-handoffdeleted

No changes to the content.

migration/7fc381538805adac19c54b73ea118601-982c57eada4652019d0b0cf6ad355d25/obelisk-upgradedeleted

No changes to the content.

migration/80cb6b08443d55bb512e4a35b4768b72-59742705e53838ae13066a2239a72040/obelisk-handoffdeleted

No changes to the content.

migration/80cb6b08443d55bb512e4a35b4768b72-59742705e53838ae13066a2239a72040/obelisk-upgradedeleted

No changes to the content.

migration/81223455459db28cdbc990c3d4e6eedd-71da39c91abb23488021a1e9142507d5/obelisk-handoffdeleted

No changes to the content.

migration/81223455459db28cdbc990c3d4e6eedd-71da39c91abb23488021a1e9142507d5/obelisk-upgradedeleted

No changes to the content.

migration/8143888349912db9780231c370ea2060-beaa30317dadbef830531237279cbca4/obelisk-handoffdeleted

No changes to the content.

migration/8143888349912db9780231c370ea2060-beaa30317dadbef830531237279cbca4/obelisk-upgradedeleted

No changes to the content.

migration/81f3dbeef0d78bfb523cd2ac113b8ad8-4ace4414d71235a291f7148f80a0b0f5/obelisk-handoffdeleted

No changes to the content.

migration/81f3dbeef0d78bfb523cd2ac113b8ad8-4ace4414d71235a291f7148f80a0b0f5/obelisk-upgradedeleted

No changes to the content.

migration/84f4d5c5491abb855d8dbe3acf3bc8e6-01fb7610e4184ad1b491267fcb0c7f43/obelisk-handoffdeleted

No changes to the content.

migration/84f4d5c5491abb855d8dbe3acf3bc8e6-01fb7610e4184ad1b491267fcb0c7f43/obelisk-upgradedeleted

No changes to the content.

migration/85c2c4fb8472d50eaa97aed0bdc9b142-3e253c6beb567ba8f4c8086a76b70645/obelisk-handoffdeleted

No changes to the content.

migration/85c2c4fb8472d50eaa97aed0bdc9b142-3e253c6beb567ba8f4c8086a76b70645/obelisk-upgradedeleted

No changes to the content.

migration/8746b8f08b75b2bb7c22d8f17f22d72d-e3b3014d7e0dc983fe118d32546654e5/obelisk-handoffdeleted

No changes to the content.

migration/8746b8f08b75b2bb7c22d8f17f22d72d-e3b3014d7e0dc983fe118d32546654e5/obelisk-upgradedeleted

No changes to the content.

migration/88046de6fbbdad3f6a8a5d311948ff9b-4a037879b8a542f1590cbb87b0242331/obelisk-handoffdeleted

No changes to the content.

migration/88046de6fbbdad3f6a8a5d311948ff9b-4a037879b8a542f1590cbb87b0242331/obelisk-upgradedeleted

No changes to the content.

migration/88439725720c7ba784750cda91157dfd-69cd775958e25e3b2cff7e4897f2a9bb/obelisk-handoffdeleted

No changes to the content.

migration/88439725720c7ba784750cda91157dfd-69cd775958e25e3b2cff7e4897f2a9bb/obelisk-upgradedeleted

No changes to the content.

migration/88765caf54c2bf9f23ea4d05816a9f65-52330622ae996023b3f80a40991521a4/obelisk-handoffdeleted

No changes to the content.

migration/88765caf54c2bf9f23ea4d05816a9f65-52330622ae996023b3f80a40991521a4/obelisk-upgradedeleted

No changes to the content.

migration/8911be694899014078c8e79fc858be45-33da5c0e6705843afa6e39e65bfa0564/obelisk-handoffdeleted

No changes to the content.

migration/8911be694899014078c8e79fc858be45-33da5c0e6705843afa6e39e65bfa0564/obelisk-upgradedeleted

No changes to the content.

migration/8a64ec5f2ee43d69607499f085560857-cba28ee4b736cf8ed43cb342ccaef12e/obelisk-handoffdeleted

No changes to the content.

migration/8a64ec5f2ee43d69607499f085560857-cba28ee4b736cf8ed43cb342ccaef12e/obelisk-upgradedeleted

No changes to the content.

migration/8adb921f4dbb9d363bf6647d304e02fe-bb2f504aa4f6f1ab8ed75697dc773efb/obelisk-handoffdeleted

No changes to the content.

migration/8adb921f4dbb9d363bf6647d304e02fe-bb2f504aa4f6f1ab8ed75697dc773efb/obelisk-upgradedeleted

No changes to the content.

migration/8b098f49e1fd1aa10ca22b9dc312644e-0ec6f67d94d3913cf3243d813238ec39/obelisk-handoffdeleted

No changes to the content.

migration/8b098f49e1fd1aa10ca22b9dc312644e-0ec6f67d94d3913cf3243d813238ec39/obelisk-upgradedeleted

No changes to the content.

migration/8c7718f94e2676c957fe844b7dc2637c-96c3d49b08a9d2cfb059197c60f49c05/obelisk-handoffdeleted

No changes to the content.

migration/8c7718f94e2676c957fe844b7dc2637c-96c3d49b08a9d2cfb059197c60f49c05/obelisk-upgradedeleted

No changes to the content.

migration/8c9599be2461288eee7e78d7a34643d8-053c0b2f84a7a2eadeb5c3f9575ffa0d/obelisk-handoffdeleted

No changes to the content.

migration/8c9599be2461288eee7e78d7a34643d8-053c0b2f84a7a2eadeb5c3f9575ffa0d/obelisk-upgradedeleted

No changes to the content.

migration/8d5dba70e93ae7e784ea238281842408-c93529e579e64263fd91663216fd3fe7/obelisk-handoffdeleted

No changes to the content.

migration/8d5dba70e93ae7e784ea238281842408-c93529e579e64263fd91663216fd3fe7/obelisk-upgradedeleted

No changes to the content.

migration/8dcf46725e839f4a5dcb7a9f0235e01b-0da1150f0e9fe57d1fafbb6cabe24fa1/obelisk-handoffdeleted

No changes to the content.

migration/8dcf46725e839f4a5dcb7a9f0235e01b-0da1150f0e9fe57d1fafbb6cabe24fa1/obelisk-upgradedeleted

No changes to the content.

migration/8df9e256d8e43fa4e22d953024269b5b-9d86cedf551a6ee24c5ae6779021b925/obelisk-handoffdeleted

No changes to the content.

migration/8df9e256d8e43fa4e22d953024269b5b-9d86cedf551a6ee24c5ae6779021b925/obelisk-upgradedeleted

No changes to the content.

migration/8e01c7fee83aa74229a77772d8c928f3-8911be694899014078c8e79fc858be45/obelisk-handoffdeleted

No changes to the content.

migration/8e01c7fee83aa74229a77772d8c928f3-8911be694899014078c8e79fc858be45/obelisk-upgradedeleted

No changes to the content.

migration/8e1e426afe242ea3079f160bccd94cf0-610dcf99f7eb8c8b591ff3f5f1722938/obelisk-handoffdeleted

No changes to the content.

migration/8e1e426afe242ea3079f160bccd94cf0-610dcf99f7eb8c8b591ff3f5f1722938/obelisk-upgradedeleted

No changes to the content.

migration/8fca2c4d6478ed8628925852b2af45bf-03b845f308e73a1567eb843dfca182d2/obelisk-handoffdeleted

No changes to the content.

migration/8fca2c4d6478ed8628925852b2af45bf-03b845f308e73a1567eb843dfca182d2/obelisk-upgradedeleted

No changes to the content.

migration/90489c1a9f7edd46a070d6474dceac86-7fac40a2398039b364746989bb78798b/obelisk-handoffdeleted

No changes to the content.

migration/90489c1a9f7edd46a070d6474dceac86-7fac40a2398039b364746989bb78798b/obelisk-upgradedeleted

No changes to the content.

migration/909b6b2066cbdc991e6c16455f13637c-1e36dc8817e2784df36d643b7499092d/obelisk-handoffdeleted

No changes to the content.

migration/909b6b2066cbdc991e6c16455f13637c-1e36dc8817e2784df36d643b7499092d/obelisk-upgradedeleted

No changes to the content.

migration/90b4e20464e08ade5f215f2a4ea28cc6-b7630e5f30252987bf899c74de3953ad/obelisk-handoffdeleted

No changes to the content.

migration/90b4e20464e08ade5f215f2a4ea28cc6-b7630e5f30252987bf899c74de3953ad/obelisk-upgradedeleted

No changes to the content.

migration/9217718d2b3b217dbba72e7091459548-88046de6fbbdad3f6a8a5d311948ff9b/obelisk-handoffdeleted

No changes to the content.

migration/9217718d2b3b217dbba72e7091459548-88046de6fbbdad3f6a8a5d311948ff9b/obelisk-upgradedeleted

No changes to the content.

migration/9223532a537f698ef36f4dce6e922a6b-d327ceb69d24e40dc11792840454cff9/obelisk-handoffdeleted

No changes to the content.

migration/9223532a537f698ef36f4dce6e922a6b-d327ceb69d24e40dc11792840454cff9/obelisk-upgradedeleted

No changes to the content.

migration/92ab733e8991f12cc12148f8d4e1b35d-e4b89dd259f3831bc60b56147b3586a6/obelisk-handoffdeleted

No changes to the content.

migration/92ab733e8991f12cc12148f8d4e1b35d-e4b89dd259f3831bc60b56147b3586a6/obelisk-upgradedeleted

No changes to the content.

migration/930e9213e072e87c207f93461bd3c96c-7f46d84c4d303f30602b920f96acf871/obelisk-handoffdeleted

No changes to the content.

migration/930e9213e072e87c207f93461bd3c96c-7f46d84c4d303f30602b920f96acf871/obelisk-upgradedeleted

No changes to the content.

migration/93f164bbd887f688fd49bb80afffccd6-f8eee9431c8b7a767d96da0a8cfae95d/obelisk-handoffdeleted

No changes to the content.

migration/93f164bbd887f688fd49bb80afffccd6-f8eee9431c8b7a767d96da0a8cfae95d/obelisk-upgradedeleted

No changes to the content.

migration/93fc625d41bae9fcf06b9febeacb686d-662eb30d6e4612f130edc3f6d37d92a2/obelisk-handoffdeleted

No changes to the content.

migration/93fc625d41bae9fcf06b9febeacb686d-662eb30d6e4612f130edc3f6d37d92a2/obelisk-upgradedeleted

No changes to the content.

migration/94252585266fa745a91733888e2f50b7-d207ab99328b8ece5fb27fa1f4dbf9f6/obelisk-handoffdeleted

No changes to the content.

migration/94252585266fa745a91733888e2f50b7-d207ab99328b8ece5fb27fa1f4dbf9f6/obelisk-upgradedeleted

No changes to the content.

migration/94372bb14f8afd19bce24f8402c7564c-7dd60550d7d79bd3923d91d67ecb433a/obelisk-handoffdeleted

No changes to the content.

migration/94372bb14f8afd19bce24f8402c7564c-7dd60550d7d79bd3923d91d67ecb433a/obelisk-upgradedeleted

No changes to the content.

migration/947784563e3a27cf6486bed9a3c52f15-25615a274650370633e8083ed19fbdd0/obelisk-handoffdeleted

No changes to the content.

migration/947784563e3a27cf6486bed9a3c52f15-25615a274650370633e8083ed19fbdd0/obelisk-upgradedeleted

No changes to the content.

migration/94dd4eb45a4e7eb945027d5fd8eb4fa6-e22c51145e08d4a089003460ae80a7f9/obelisk-handoffdeleted

No changes to the content.

migration/94dd4eb45a4e7eb945027d5fd8eb4fa6-e22c51145e08d4a089003460ae80a7f9/obelisk-upgradedeleted

No changes to the content.

migration/95955d1dd0981ebb538ee941cde1f963-07900e6c41ab9a78917f66fcf7e0d9b8/obelisk-handoffdeleted

No changes to the content.

migration/95955d1dd0981ebb538ee941cde1f963-07900e6c41ab9a78917f66fcf7e0d9b8/obelisk-upgradedeleted

No changes to the content.

migration/959ae2925bcd2b5beff631a8e7aeaf00-071f5b3326b8886de3eddc927b80eb10/obelisk-handoffdeleted

No changes to the content.

migration/959ae2925bcd2b5beff631a8e7aeaf00-071f5b3326b8886de3eddc927b80eb10/obelisk-upgradedeleted

No changes to the content.

migration/962e2bd1ae8d0c233f8da89ecebffe50-d6c090699acd25fc60213ff4bd9eebcf/obelisk-handoffdeleted

No changes to the content.

migration/962e2bd1ae8d0c233f8da89ecebffe50-d6c090699acd25fc60213ff4bd9eebcf/obelisk-upgradedeleted

No changes to the content.

migration/96c3d49b08a9d2cfb059197c60f49c05-6da2e5b02ab780d12527640722d2b511/obelisk-handoffdeleted

No changes to the content.

migration/96c3d49b08a9d2cfb059197c60f49c05-6da2e5b02ab780d12527640722d2b511/obelisk-upgradedeleted

No changes to the content.

migration/9705509619667aacf799e91927c16dc8-2773d4a82ca59b48faf036755e163a5f/obelisk-handoffdeleted

No changes to the content.

migration/9705509619667aacf799e91927c16dc8-2773d4a82ca59b48faf036755e163a5f/obelisk-upgradedeleted

No changes to the content.

migration/9715967793be68dfd8c9a7d631f8d589-d532356dfb65a4c8a39452d2ebca2516/obelisk-handoffdeleted

No changes to the content.

migration/9715967793be68dfd8c9a7d631f8d589-d532356dfb65a4c8a39452d2ebca2516/obelisk-upgradedeleted

No changes to the content.

migration/975cd8245d06ad09e4fb176cfc9af5e0-3f23549fba6f8e67ba36b4405e8680b3/obelisk-handoffdeleted

No changes to the content.

migration/975cd8245d06ad09e4fb176cfc9af5e0-3f23549fba6f8e67ba36b4405e8680b3/obelisk-upgradedeleted

No changes to the content.

migration/97873167212295a0fdc1219102b6b600-88439725720c7ba784750cda91157dfd/obelisk-handoffdeleted

No changes to the content.

migration/97873167212295a0fdc1219102b6b600-88439725720c7ba784750cda91157dfd/obelisk-upgradedeleted

No changes to the content.

migration/97c7e1ea2c1ddb0ef23d2e4a9279f65c-d747c3d0620b2034aca44265dd1c8c86/obelisk-handoffdeleted

No changes to the content.

migration/97c7e1ea2c1ddb0ef23d2e4a9279f65c-d747c3d0620b2034aca44265dd1c8c86/obelisk-upgradedeleted

No changes to the content.

migration/982c57eada4652019d0b0cf6ad355d25-6708d14c71c475ac494808e75660a385/obelisk-handoffdeleted

No changes to the content.

migration/982c57eada4652019d0b0cf6ad355d25-6708d14c71c475ac494808e75660a385/obelisk-upgradedeleted

No changes to the content.

migration/98629a336dcd5fa3524a09f8ea6ad636-8c9599be2461288eee7e78d7a34643d8/obelisk-handoffdeleted

No changes to the content.

migration/98629a336dcd5fa3524a09f8ea6ad636-8c9599be2461288eee7e78d7a34643d8/obelisk-upgradedeleted

No changes to the content.

migration/98da197f133bca81e533ab5ffbf4c82d-a0b418c582d5c6ef9e0cd9a19abe046e/obelisk-handoffdeleted

No changes to the content.

migration/98da197f133bca81e533ab5ffbf4c82d-a0b418c582d5c6ef9e0cd9a19abe046e/obelisk-upgradedeleted

No changes to the content.

migration/98f9e0bbd21e36b0f4daa440d11e7177-bab3871bcfbfcb3d2bad4495d44ae4f8/obelisk-handoffdeleted

No changes to the content.

migration/98f9e0bbd21e36b0f4daa440d11e7177-bab3871bcfbfcb3d2bad4495d44ae4f8/obelisk-upgradedeleted

No changes to the content.

migration/99aebbfcac51725464bc59571b7d71b8-34d14d4a444d3bf1487ada6129815df4/obelisk-handoffdeleted

No changes to the content.

migration/99aebbfcac51725464bc59571b7d71b8-34d14d4a444d3bf1487ada6129815df4/obelisk-upgradedeleted

No changes to the content.

migration/9b33a49f0c978e27b752fa457aca97cc-51f3d5068259f596b811450f0bf25419/obelisk-handoffdeleted

No changes to the content.

migration/9b33a49f0c978e27b752fa457aca97cc-51f3d5068259f596b811450f0bf25419/obelisk-upgradedeleted

No changes to the content.

migration/9b9d73736773550dde7d36de2498b029-69537089a0e97845ffe05c73c3cc1536/obelisk-handoffdeleted

No changes to the content.

migration/9b9d73736773550dde7d36de2498b029-69537089a0e97845ffe05c73c3cc1536/obelisk-upgradedeleted

No changes to the content.

migration/9c94cd459a25b5c2de56067c8fdac620-721a02f3a7549e7d6efeaed087bfacb5/obelisk-handoffdeleted

No changes to the content.

migration/9c94cd459a25b5c2de56067c8fdac620-721a02f3a7549e7d6efeaed087bfacb5/obelisk-upgradedeleted

No changes to the content.

migration/9cef2dd1885f16455ff9b6801ec99454-63ff9426130baa080f37400a86c55fdd/obelisk-handoffdeleted

No changes to the content.

migration/9cef2dd1885f16455ff9b6801ec99454-63ff9426130baa080f37400a86c55fdd/obelisk-upgradedeleted

No changes to the content.

migration/9d86cedf551a6ee24c5ae6779021b925-1c9bdb5c544f2e5432f549653a61dabe/obelisk-handoffdeleted

No changes to the content.

migration/9d86cedf551a6ee24c5ae6779021b925-1c9bdb5c544f2e5432f549653a61dabe/obelisk-upgradedeleted

No changes to the content.

migration/9e05cc6b81c6380ba0ac59bad1021cac-ce7f0d15d71d36d4bcf4fbadcdfa1b58/obelisk-handoffdeleted

No changes to the content.

migration/9e05cc6b81c6380ba0ac59bad1021cac-ce7f0d15d71d36d4bcf4fbadcdfa1b58/obelisk-upgradedeleted

No changes to the content.

migration/9e61f37dd79310b71c80ee166aeb4e80-466a19f9cfa2a103467fe6627225d27f/obelisk-handoffdeleted

No changes to the content.

migration/9e61f37dd79310b71c80ee166aeb4e80-466a19f9cfa2a103467fe6627225d27f/obelisk-upgradedeleted

No changes to the content.

migration/9f6c8fd80ab3ff2dcc48bfd211c8b761-24f151a674662ac47845237d7a9f6a4f/obelisk-handoffdeleted

No changes to the content.

migration/9f6c8fd80ab3ff2dcc48bfd211c8b761-24f151a674662ac47845237d7a9f6a4f/obelisk-upgradedeleted

No changes to the content.

migration/9f71fc9d2ed805fecbc8c4a3aae5685b-cb2197d0267b52385ee39bf4adcfe475/obelisk-handoffdeleted

No changes to the content.

migration/9f71fc9d2ed805fecbc8c4a3aae5685b-cb2197d0267b52385ee39bf4adcfe475/obelisk-upgradedeleted

No changes to the content.

migration/9fb504b182cbd8dfb666175b651e0b49-338b92f88c49c7c3a1d8ec231d9f7189/obelisk-handoffdeleted

No changes to the content.

migration/9fb504b182cbd8dfb666175b651e0b49-338b92f88c49c7c3a1d8ec231d9f7189/obelisk-upgradedeleted

No changes to the content.

migration/9fe2922674fcee5e840c9f52cf534f88-ac92878eb85c5283bcc5f3f34cd35aa6/obelisk-handoffdeleted

No changes to the content.

migration/9fe2922674fcee5e840c9f52cf534f88-ac92878eb85c5283bcc5f3f34cd35aa6/obelisk-upgradedeleted

No changes to the content.

migration/a00870cfca85ff8dae5db3a78f5a227d-c2502429502b46133a749f021d188cf0/obelisk-handoffdeleted

No changes to the content.

migration/a00870cfca85ff8dae5db3a78f5a227d-c2502429502b46133a749f021d188cf0/obelisk-upgradedeleted

No changes to the content.

migration/a080b8549e32f21fec11084f4ab1e052-bd7c24fc03bf82e5a990515531a69147/obelisk-handoffdeleted

No changes to the content.

migration/a080b8549e32f21fec11084f4ab1e052-bd7c24fc03bf82e5a990515531a69147/obelisk-upgradedeleted

No changes to the content.

migration/a08aebb6f40fb45d174b229532314ac4-1c1c3f2b4426d5d26377eef08dbccb3c/obelisk-handoffdeleted

No changes to the content.

migration/a08aebb6f40fb45d174b229532314ac4-1c1c3f2b4426d5d26377eef08dbccb3c/obelisk-upgradedeleted

No changes to the content.

migration/a0b418c582d5c6ef9e0cd9a19abe046e-63422a9bade5c703461b600e03e227f0/obelisk-handoffdeleted

No changes to the content.

migration/a0b418c582d5c6ef9e0cd9a19abe046e-63422a9bade5c703461b600e03e227f0/obelisk-upgradedeleted

No changes to the content.

migration/a0f5ac2ff5c6a957e565f898a9fc8bfb-bf3fbc8db3d6fd42a37982dfb5a30b5c/obelisk-handoffdeleted

No changes to the content.

migration/a0f5ac2ff5c6a957e565f898a9fc8bfb-bf3fbc8db3d6fd42a37982dfb5a30b5c/obelisk-upgradedeleted

No changes to the content.

migration/a262678b7d849de5a9732d06199666ae-ebb95c5864d1d1d2f78fbf7cc8235dac/obelisk-handoffdeleted

No changes to the content.

migration/a262678b7d849de5a9732d06199666ae-ebb95c5864d1d1d2f78fbf7cc8235dac/obelisk-upgradedeleted

No changes to the content.

migration/a2665cfd303a4a34a7bfa3b7d0d264bb-aff3f143ddaa4ed3ffad873d6638e277/obelisk-handoffdeleted

No changes to the content.

migration/a2665cfd303a4a34a7bfa3b7d0d264bb-aff3f143ddaa4ed3ffad873d6638e277/obelisk-upgradedeleted

No changes to the content.

migration/a2b33f8dc1f90b8dddce942b174be5b8-00a480749e96ef7e21fbe8f4943152b1/obelisk-handoffdeleted

No changes to the content.

migration/a2b33f8dc1f90b8dddce942b174be5b8-00a480749e96ef7e21fbe8f4943152b1/obelisk-upgradedeleted

No changes to the content.

migration/a2bdbf1985b75442e78e84523c4ced5f-48c027da19d895ba03e7b9120f771291/obelisk-handoffdeleted

No changes to the content.

migration/a2bdbf1985b75442e78e84523c4ced5f-48c027da19d895ba03e7b9120f771291/obelisk-upgradedeleted

No changes to the content.

migration/a34d758508a0a5d08bc10e76482c4d11-8fca2c4d6478ed8628925852b2af45bf/obelisk-handoffdeleted

No changes to the content.

migration/a34d758508a0a5d08bc10e76482c4d11-8fca2c4d6478ed8628925852b2af45bf/obelisk-upgradedeleted

No changes to the content.

migration/a4477746ae1a7024bc3cd0807180d418-fb5110e527cf77c568bcae7d435ee035/obelisk-handoffdeleted

No changes to the content.

migration/a4477746ae1a7024bc3cd0807180d418-fb5110e527cf77c568bcae7d435ee035/obelisk-upgradedeleted

No changes to the content.

migration/a5297d8457aa4c327f35d4697f6cb66f-2f928f9c4a137186f808a231c9e3c141/obelisk-handoffdeleted

No changes to the content.

migration/a5297d8457aa4c327f35d4697f6cb66f-2f928f9c4a137186f808a231c9e3c141/obelisk-upgradedeleted

No changes to the content.

migration/a536d01b9c489f5e00e30abf27427da0-b8a8ffc909e5fc350d9f8a6a90e7b3d9/obelisk-handoffdeleted

No changes to the content.

migration/a536d01b9c489f5e00e30abf27427da0-b8a8ffc909e5fc350d9f8a6a90e7b3d9/obelisk-upgradedeleted

No changes to the content.

migration/a5904e3a899e346fe2fe26314f69c075-e4513b485b6ba8b7f4bd34b12458ff0c/obelisk-handoffdeleted

No changes to the content.

migration/a5904e3a899e346fe2fe26314f69c075-e4513b485b6ba8b7f4bd34b12458ff0c/obelisk-upgradedeleted

No changes to the content.

migration/a5bbc0b9ceab9c3f7ca32a7da8c1f685-3c4b3152f0608d23d07240e2df3ff8da/obelisk-handoffdeleted

No changes to the content.

migration/a5bbc0b9ceab9c3f7ca32a7da8c1f685-3c4b3152f0608d23d07240e2df3ff8da/obelisk-upgradedeleted

No changes to the content.

migration/a5e40d67714a1b2daa06e3fb3293216d-04a5ae41e8fcef5f719cb84d01430382/obelisk-handoffdeleted

No changes to the content.

migration/a5e40d67714a1b2daa06e3fb3293216d-04a5ae41e8fcef5f719cb84d01430382/obelisk-upgradedeleted

No changes to the content.

migration/a632452cf9c5956becd1a40512472b43-d6a3ea5f7eb3c95f5e5ea09fb1330270/obelisk-handoffdeleted

No changes to the content.

migration/a632452cf9c5956becd1a40512472b43-d6a3ea5f7eb3c95f5e5ea09fb1330270/obelisk-upgradedeleted

No changes to the content.

migration/a6633fc9687566aa84c3d5d5e2bff4fd-b5cab336f6244293913433101cd0feff/obelisk-handoffdeleted

No changes to the content.

migration/a6633fc9687566aa84c3d5d5e2bff4fd-b5cab336f6244293913433101cd0feff/obelisk-upgradedeleted

No changes to the content.

migration/a6d50c7e756dfd1e3ae891111b81a1ae-270b3b3f7bc510c692e3253a895f122a/obelisk-handoffdeleted

No changes to the content.

migration/a6d50c7e756dfd1e3ae891111b81a1ae-270b3b3f7bc510c692e3253a895f122a/obelisk-upgradedeleted

No changes to the content.

migration/a7c7b80a875d1863f027c97eb433b884-cbe155a3e856fb7eaad0bd18feb408be/obelisk-handoffdeleted

No changes to the content.

migration/a7c7b80a875d1863f027c97eb433b884-cbe155a3e856fb7eaad0bd18feb408be/obelisk-upgradedeleted

No changes to the content.

migration/a808a04519bbf2874e41028ded9c180c-8e1e426afe242ea3079f160bccd94cf0/obelisk-handoffdeleted

No changes to the content.

migration/a808a04519bbf2874e41028ded9c180c-8e1e426afe242ea3079f160bccd94cf0/obelisk-upgradedeleted

No changes to the content.

migration/a825fbb74e8d050a5ce10ec4c62b83f5-c3298d81428117be58196b80853e3c7b/obelisk-handoffdeleted

No changes to the content.

migration/a825fbb74e8d050a5ce10ec4c62b83f5-c3298d81428117be58196b80853e3c7b/obelisk-upgradedeleted

No changes to the content.

migration/a826f01311fe00ef5cf87568832605d3-9fb504b182cbd8dfb666175b651e0b49/obelisk-handoffdeleted

No changes to the content.

migration/a826f01311fe00ef5cf87568832605d3-9fb504b182cbd8dfb666175b651e0b49/obelisk-upgradedeleted

No changes to the content.

migration/a878ad346b9305ad2ae3fd85410a7ed7-0f78d9d6875933336bbf0c1c8888b73f/obelisk-handoffdeleted

No changes to the content.

migration/a878ad346b9305ad2ae3fd85410a7ed7-0f78d9d6875933336bbf0c1c8888b73f/obelisk-upgradedeleted

No changes to the content.

migration/a8ebe201ab7a7b0211de41b14a95192e-65071e255719af6389857646bc087d37/obelisk-handoffdeleted

No changes to the content.

migration/a8ebe201ab7a7b0211de41b14a95192e-65071e255719af6389857646bc087d37/obelisk-upgradedeleted

No changes to the content.

migration/a96d491705acc139315264fd340d228f-be615dc4d60c9d8710fbd120857c2fa1/obelisk-handoffdeleted

No changes to the content.

migration/a96d491705acc139315264fd340d228f-be615dc4d60c9d8710fbd120857c2fa1/obelisk-upgradedeleted

No changes to the content.

migration/aa8e6712fd46824acdea303068634078-dc95f39fb27634ccbca7318ff2065608/obelisk-handoffdeleted

No changes to the content.

migration/aa8e6712fd46824acdea303068634078-dc95f39fb27634ccbca7318ff2065608/obelisk-upgradedeleted

No changes to the content.

migration/aaf979dd0121603a8b48127e1ea47c7d-4b7a36dce2c1cf94554e12d8a7903269/obelisk-handoffdeleted

No changes to the content.

migration/aaf979dd0121603a8b48127e1ea47c7d-4b7a36dce2c1cf94554e12d8a7903269/obelisk-upgradedeleted

No changes to the content.

migration/abdb013baf130e1bd7e7fd04e535c44c-39df6544d6b035d4c77cc829729f9c19/obelisk-handoffdeleted

No changes to the content.

migration/abdb013baf130e1bd7e7fd04e535c44c-39df6544d6b035d4c77cc829729f9c19/obelisk-upgradedeleted

No changes to the content.

migration/ac5e28caddd6832d0bf1f7445a4a6a28-e01cc01684deaf4c75ad5d65270bf3d5/obelisk-handoffdeleted

No changes to the content.

migration/ac5e28caddd6832d0bf1f7445a4a6a28-e01cc01684deaf4c75ad5d65270bf3d5/obelisk-upgradedeleted

No changes to the content.

migration/ac92878eb85c5283bcc5f3f34cd35aa6-145650b66e83adf5bdb8261593076379/obelisk-handoffdeleted

No changes to the content.

migration/ac92878eb85c5283bcc5f3f34cd35aa6-145650b66e83adf5bdb8261593076379/obelisk-upgradedeleted

No changes to the content.

migration/adad34a1075a2fd51e1a1c06ec9d002d-930e9213e072e87c207f93461bd3c96c/obelisk-handoffdeleted

No changes to the content.

migration/adad34a1075a2fd51e1a1c06ec9d002d-930e9213e072e87c207f93461bd3c96c/obelisk-upgradedeleted

No changes to the content.

migration/ae4328daeb7d2c52c534a687fbd184b6-3e763ebe16cc3a261f5776ab1f1f6d9a/obelisk-handoffdeleted

No changes to the content.

migration/ae4328daeb7d2c52c534a687fbd184b6-3e763ebe16cc3a261f5776ab1f1f6d9a/obelisk-upgradedeleted

No changes to the content.

migration/ae824b83b569b3b23b8e198190371ca0-81f3dbeef0d78bfb523cd2ac113b8ad8/obelisk-handoffdeleted

No changes to the content.

migration/ae824b83b569b3b23b8e198190371ca0-81f3dbeef0d78bfb523cd2ac113b8ad8/obelisk-upgradedeleted

No changes to the content.

migration/ae8862f8b7292690c852111ca5659ce9-ae4328daeb7d2c52c534a687fbd184b6/obelisk-handoffdeleted

No changes to the content.

migration/ae8862f8b7292690c852111ca5659ce9-ae4328daeb7d2c52c534a687fbd184b6/obelisk-upgradedeleted

No changes to the content.

migration/aeafaa5d20bab4439a5d31f29023a839-79357758056556793db0472562d62ff9/obelisk-handoffdeleted

No changes to the content.

migration/aeafaa5d20bab4439a5d31f29023a839-79357758056556793db0472562d62ff9/obelisk-upgradedeleted

No changes to the content.

migration/aef6ac052515a869c7d3061d4ccc69dd-15f3f3f517b38664131b85da0594522f/obelisk-handoffdeleted

No changes to the content.

migration/aef6ac052515a869c7d3061d4ccc69dd-15f3f3f517b38664131b85da0594522f/obelisk-upgradedeleted

No changes to the content.

migration/afbd010add526d309dccee6895e42d0d-6f3a0f756847ee5aa208a1dc79404779/obelisk-handoffdeleted

No changes to the content.

migration/afbd010add526d309dccee6895e42d0d-6f3a0f756847ee5aa208a1dc79404779/obelisk-upgradedeleted

No changes to the content.

migration/aff3f143ddaa4ed3ffad873d6638e277-6fc44f180bb825d5b372444339681135/obelisk-handoffdeleted

No changes to the content.

migration/aff3f143ddaa4ed3ffad873d6638e277-6fc44f180bb825d5b372444339681135/obelisk-upgradedeleted

No changes to the content.

migration/b0c1d039514a686529561f186332c91e-a878ad346b9305ad2ae3fd85410a7ed7/obelisk-handoffdeleted

No changes to the content.

migration/b0c1d039514a686529561f186332c91e-a878ad346b9305ad2ae3fd85410a7ed7/obelisk-upgradedeleted

No changes to the content.

migration/b1692927da5ed59af72fac5be8094fa2-d5ba6f13296205e5bd88ca2756107df0/obelisk-handoffdeleted

No changes to the content.

migration/b1692927da5ed59af72fac5be8094fa2-d5ba6f13296205e5bd88ca2756107df0/obelisk-upgradedeleted

No changes to the content.

migration/b2282679f6f63cec89d921c3dd512d1e-1f09fcf196bfe90ed52f113c38ffbfdb/obelisk-handoffdeleted

No changes to the content.

migration/b2282679f6f63cec89d921c3dd512d1e-1f09fcf196bfe90ed52f113c38ffbfdb/obelisk-upgradedeleted

No changes to the content.

migration/b3b107d406a6a7675cd5b9f52e5f7d8e-0d3b4cfe9b4c72b830780a4c44942176/obelisk-handoffdeleted

No changes to the content.

migration/b3b107d406a6a7675cd5b9f52e5f7d8e-0d3b4cfe9b4c72b830780a4c44942176/obelisk-upgradedeleted

No changes to the content.

migration/b3ff195b0a90ef5900f9cef2ba75f2fe-24e0d027f4160a6478c1356e51f419cf/obelisk-handoffdeleted

No changes to the content.

migration/b3ff195b0a90ef5900f9cef2ba75f2fe-24e0d027f4160a6478c1356e51f419cf/obelisk-upgradedeleted

No changes to the content.

migration/b4f6596f2c16811442d8bb2961fbb721-3c7755e495f20cfac5e4dabe78644c5a/obelisk-handoffdeleted

No changes to the content.

migration/b4f6596f2c16811442d8bb2961fbb721-3c7755e495f20cfac5e4dabe78644c5a/obelisk-upgradedeleted

No changes to the content.

migration/b5cab336f6244293913433101cd0feff-8746b8f08b75b2bb7c22d8f17f22d72d/obelisk-handoffdeleted

No changes to the content.

migration/b5cab336f6244293913433101cd0feff-8746b8f08b75b2bb7c22d8f17f22d72d/obelisk-upgradedeleted

No changes to the content.

migration/b641dd9c5359201200e483a784456cc2-cc4307fc88e3486b1c3f9ce07db95808/obelisk-handoffdeleted

No changes to the content.

migration/b641dd9c5359201200e483a784456cc2-cc4307fc88e3486b1c3f9ce07db95808/obelisk-upgradedeleted

No changes to the content.

migration/b6425c7661af2116b912a558e9548013-4aefa80392582ec03a19f946e752d331/obelisk-handoffdeleted

No changes to the content.

migration/b6425c7661af2116b912a558e9548013-4aefa80392582ec03a19f946e752d331/obelisk-upgradedeleted

No changes to the content.

migration/b68a785fbf27a63334ef1d1fe82b2dac-d6b34eba6ed4f89875a6615fe2c41ec2/obelisk-handoffdeleted

No changes to the content.

migration/b68a785fbf27a63334ef1d1fe82b2dac-d6b34eba6ed4f89875a6615fe2c41ec2/obelisk-upgradedeleted

No changes to the content.

migration/b6ffce85249f30616da76334c7bbec6e-66a9b6b9e9bc4a5b0cfa78127479b231/obelisk-handoffdeleted

No changes to the content.

migration/b6ffce85249f30616da76334c7bbec6e-66a9b6b9e9bc4a5b0cfa78127479b231/obelisk-upgradedeleted

No changes to the content.

migration/b7630e5f30252987bf899c74de3953ad-3f0687592a77c0c66193652e9cd981fd/obelisk-handoffdeleted

No changes to the content.

migration/b7630e5f30252987bf899c74de3953ad-3f0687592a77c0c66193652e9cd981fd/obelisk-upgradedeleted

No changes to the content.

migration/b7e30314f9d0e69efdc84c7eb4e3bcc3-e4051219d89b3c9a8350fe824ad96a82/obelisk-handoffdeleted

No changes to the content.

migration/b7e30314f9d0e69efdc84c7eb4e3bcc3-e4051219d89b3c9a8350fe824ad96a82/obelisk-upgradedeleted

No changes to the content.

migration/b82e9c3fe22feff4bb3a6be49943fd6c-fbb3eb3209281031dc5183d289eb4e75/obelisk-handoffdeleted

No changes to the content.

migration/b82e9c3fe22feff4bb3a6be49943fd6c-fbb3eb3209281031dc5183d289eb4e75/obelisk-upgradedeleted

No changes to the content.

migration/b8a8ffc909e5fc350d9f8a6a90e7b3d9-aef6ac052515a869c7d3061d4ccc69dd/obelisk-handoffdeleted

No changes to the content.

migration/b8a8ffc909e5fc350d9f8a6a90e7b3d9-aef6ac052515a869c7d3061d4ccc69dd/obelisk-upgradedeleted

No changes to the content.

migration/b8aa42d4f2e5ef7db9ba34ecf6c42079-37c2ed0ba2cd54c0ec29eae9043bc4c8/obelisk-handoffdeleted

No changes to the content.

migration/b8aa42d4f2e5ef7db9ba34ecf6c42079-37c2ed0ba2cd54c0ec29eae9043bc4c8/obelisk-upgradedeleted

No changes to the content.

migration/b95c8d049256fb7360ca14b12acd8544-e7b17aa124e17c357cead8081a58f089/obelisk-handoffdeleted

No changes to the content.

migration/b95c8d049256fb7360ca14b12acd8544-e7b17aa124e17c357cead8081a58f089/obelisk-upgradedeleted

No changes to the content.

migration/ba0ccd5ef6110f6c5133d9d6ea6277f0-e78ec85bec14f4784faeef4d8d3e4d0a/obelisk-handoffdeleted

No changes to the content.

migration/ba0ccd5ef6110f6c5133d9d6ea6277f0-e78ec85bec14f4784faeef4d8d3e4d0a/obelisk-upgradedeleted

No changes to the content.

migration/ba4829dc61dcc12bcafd8de5fc8a76dc-2164344be67da5d0e57052c15f30646d/obelisk-handoffdeleted

No changes to the content.

migration/ba4829dc61dcc12bcafd8de5fc8a76dc-2164344be67da5d0e57052c15f30646d/obelisk-upgradedeleted

No changes to the content.

migration/bab3871bcfbfcb3d2bad4495d44ae4f8-9cef2dd1885f16455ff9b6801ec99454/obelisk-handoffdeleted

No changes to the content.

migration/bab3871bcfbfcb3d2bad4495d44ae4f8-9cef2dd1885f16455ff9b6801ec99454/obelisk-upgradedeleted

No changes to the content.

migration/bb2f504aa4f6f1ab8ed75697dc773efb-bcd13da3a7fba8514084c1a9dbeabb31/obelisk-handoffdeleted

No changes to the content.

migration/bb2f504aa4f6f1ab8ed75697dc773efb-bcd13da3a7fba8514084c1a9dbeabb31/obelisk-upgradedeleted

No changes to the content.

migration/bb9a87fc325204313d89dbfb689dba2f-d2d86ce0ca16b143b49374302a9e9e2f/obelisk-handoffdeleted

No changes to the content.

migration/bb9a87fc325204313d89dbfb689dba2f-d2d86ce0ca16b143b49374302a9e9e2f/obelisk-upgradedeleted

No changes to the content.

migration/bc7688ff47218c0e13d02d917b03caa0-2bdd4221307cafa3e98c4d3017cdc912/obelisk-handoffdeleted

No changes to the content.

migration/bc7688ff47218c0e13d02d917b03caa0-2bdd4221307cafa3e98c4d3017cdc912/obelisk-upgradedeleted

No changes to the content.

migration/bcd13da3a7fba8514084c1a9dbeabb31-8dcf46725e839f4a5dcb7a9f0235e01b/obelisk-handoffdeleted

No changes to the content.

migration/bcd13da3a7fba8514084c1a9dbeabb31-8dcf46725e839f4a5dcb7a9f0235e01b/obelisk-upgradedeleted

No changes to the content.

migration/bd6728737dffcc3505d30ada344e2f4b-1cc8d98f6f61441570fdde2d697e6e3c/obelisk-handoffdeleted

No changes to the content.

migration/bd6728737dffcc3505d30ada344e2f4b-1cc8d98f6f61441570fdde2d697e6e3c/obelisk-upgradedeleted

No changes to the content.

migration/bd7c24fc03bf82e5a990515531a69147-a5e40d67714a1b2daa06e3fb3293216d/obelisk-handoffdeleted

No changes to the content.

migration/bd7c24fc03bf82e5a990515531a69147-a5e40d67714a1b2daa06e3fb3293216d/obelisk-upgradedeleted

No changes to the content.

migration/bd8f5fa095c3eb19b87d85247b36f1df-5d90abd974b4ec53091a8cb3fc2258ce/obelisk-handoffdeleted

No changes to the content.

migration/bd8f5fa095c3eb19b87d85247b36f1df-5d90abd974b4ec53091a8cb3fc2258ce/obelisk-upgradedeleted

No changes to the content.

migration/be5a7b436cef0ae35cb074700d5f0d00-7c0ab1210424b615251ef57036d316c3/obelisk-handoffdeleted

No changes to the content.

migration/be5a7b436cef0ae35cb074700d5f0d00-7c0ab1210424b615251ef57036d316c3/obelisk-upgradedeleted

No changes to the content.

migration/be615dc4d60c9d8710fbd120857c2fa1-1e376437f069662df26178e4a7873190/obelisk-handoffdeleted

No changes to the content.

migration/be615dc4d60c9d8710fbd120857c2fa1-1e376437f069662df26178e4a7873190/obelisk-upgradedeleted

No changes to the content.

migration/beaa30317dadbef830531237279cbca4-a0f5ac2ff5c6a957e565f898a9fc8bfb/obelisk-handoffdeleted

No changes to the content.

migration/beaa30317dadbef830531237279cbca4-a0f5ac2ff5c6a957e565f898a9fc8bfb/obelisk-upgradedeleted

No changes to the content.

migration/bf22c91488f01ebf503c1786ee805d0c-64ee9e40f4943e0122398e48019f5616/obelisk-handoffdeleted

No changes to the content.

migration/bf22c91488f01ebf503c1786ee805d0c-64ee9e40f4943e0122398e48019f5616/obelisk-upgradedeleted

No changes to the content.

migration/bf3fbc8db3d6fd42a37982dfb5a30b5c-0c6127453069ad707e34ddfedb67e2f9/obelisk-handoffdeleted

No changes to the content.

migration/bf3fbc8db3d6fd42a37982dfb5a30b5c-0c6127453069ad707e34ddfedb67e2f9/obelisk-upgradedeleted

No changes to the content.

migration/bf81caf2a7d528f86acacc1f5d2ffcfa-a5bbc0b9ceab9c3f7ca32a7da8c1f685/obelisk-handoffdeleted

No changes to the content.

migration/bf81caf2a7d528f86acacc1f5d2ffcfa-a5bbc0b9ceab9c3f7ca32a7da8c1f685/obelisk-upgradedeleted

No changes to the content.

migration/c0811b664036c7996fcfd19fee241a10-a2bdbf1985b75442e78e84523c4ced5f/obelisk-handoffdeleted

No changes to the content.

migration/c0811b664036c7996fcfd19fee241a10-a2bdbf1985b75442e78e84523c4ced5f/obelisk-upgradedeleted

No changes to the content.

migration/c0c1452986b8d4c181bb0c6c83c56a2f-bf22c91488f01ebf503c1786ee805d0c/obelisk-handoffdeleted

No changes to the content.

migration/c0c1452986b8d4c181bb0c6c83c56a2f-bf22c91488f01ebf503c1786ee805d0c/obelisk-upgradedeleted

No changes to the content.

migration/c106f9398d5c203a1a296b85c7411bf9-1c2c93819c07f33ad899e39ec6769c3c/obelisk-handoffdeleted

No changes to the content.

migration/c106f9398d5c203a1a296b85c7411bf9-1c2c93819c07f33ad899e39ec6769c3c/obelisk-upgradedeleted

No changes to the content.

migration/c118e1ee09ec8d9aa3edf04e211ae035-749df832c9305e1c6309a794b0c1b201/obelisk-handoffdeleted

No changes to the content.

migration/c118e1ee09ec8d9aa3edf04e211ae035-749df832c9305e1c6309a794b0c1b201/obelisk-upgradedeleted

No changes to the content.

migration/c203adc5fed9bf79f67df43d72a4631a-e6980e47ba847245dfab61fb4d5b8ce5/obelisk-handoffdeleted

No changes to the content.

migration/c203adc5fed9bf79f67df43d72a4631a-e6980e47ba847245dfab61fb4d5b8ce5/obelisk-upgradedeleted

No changes to the content.

migration/c2502429502b46133a749f021d188cf0-93f164bbd887f688fd49bb80afffccd6/obelisk-handoffdeleted

No changes to the content.

migration/c2502429502b46133a749f021d188cf0-93f164bbd887f688fd49bb80afffccd6/obelisk-upgradedeleted

No changes to the content.

migration/c2d4eeb20f2b319a2d9dc5b6b0762f83-01c0ee6c93a3f9f69e097c41169927ac/obelisk-handoffdeleted

No changes to the content.

migration/c2d4eeb20f2b319a2d9dc5b6b0762f83-01c0ee6c93a3f9f69e097c41169927ac/obelisk-upgradedeleted

No changes to the content.

migration/c2d581d48dd821a94d7906ca8f33b504-81223455459db28cdbc990c3d4e6eedd/obelisk-handoffdeleted

No changes to the content.

migration/c2d581d48dd821a94d7906ca8f33b504-81223455459db28cdbc990c3d4e6eedd/obelisk-upgradedeleted

No changes to the content.

migration/c3298d81428117be58196b80853e3c7b-f68462dc88ed7fc451d1c757c040cfee/obelisk-handoffdeleted

No changes to the content.

migration/c3298d81428117be58196b80853e3c7b-f68462dc88ed7fc451d1c757c040cfee/obelisk-upgradedeleted

No changes to the content.

migration/c3a8b70b1290031feb21880914cb081e-c2d581d48dd821a94d7906ca8f33b504/obelisk-handoffdeleted

No changes to the content.

migration/c3a8b70b1290031feb21880914cb081e-c2d581d48dd821a94d7906ca8f33b504/obelisk-upgradedeleted

No changes to the content.

migration/c56de2f95c90def16704f62639246bbc-77a721a8fa97d1f84dd2af622089871b/obelisk-handoffdeleted

No changes to the content.

migration/c56de2f95c90def16704f62639246bbc-77a721a8fa97d1f84dd2af622089871b/obelisk-upgradedeleted

No changes to the content.

migration/c5a306045ad998f906f80748fe18487f-e474bad466cd6e413fba753746eb58ef/obelisk-handoffdeleted

No changes to the content.

migration/c5a306045ad998f906f80748fe18487f-e474bad466cd6e413fba753746eb58ef/obelisk-upgradedeleted

No changes to the content.

migration/c66bc5ba27dec52d144ceb0aa429e449-1b1686b03b41bd840ff46776cec7b33a/obelisk-handoffdeleted

No changes to the content.

migration/c66bc5ba27dec52d144ceb0aa429e449-1b1686b03b41bd840ff46776cec7b33a/obelisk-upgradedeleted

No changes to the content.

migration/c67f206b6d2626eb6d36b00122b52784-3bc53f3a28cb8f403cc41c11a37eec5d/obelisk-handoffdeleted

No changes to the content.

migration/c67f206b6d2626eb6d36b00122b52784-3bc53f3a28cb8f403cc41c11a37eec5d/obelisk-upgradedeleted

No changes to the content.

migration/c6baede3962454713b73acefcc92fe75-a96d491705acc139315264fd340d228f/obelisk-handoffdeleted

No changes to the content.

migration/c6baede3962454713b73acefcc92fe75-a96d491705acc139315264fd340d228f/obelisk-upgradedeleted

No changes to the content.

migration/c6f38304ee53762590c67020f30d2ab4-58391ba73c13d922e8a12116b28caad2/obelisk-handoffdeleted

No changes to the content.

migration/c6f38304ee53762590c67020f30d2ab4-58391ba73c13d922e8a12116b28caad2/obelisk-upgradedeleted

No changes to the content.

migration/c7dbf17de8aebd3043617ea6db790dcc-d35f6eb2d1b066d366c9a89ab26144e1/obelisk-handoffdeleted

No changes to the content.

migration/c7dbf17de8aebd3043617ea6db790dcc-d35f6eb2d1b066d366c9a89ab26144e1/obelisk-upgradedeleted

No changes to the content.

migration/c801cbcf925c0a7b084ef152e3c08f8e-8d5dba70e93ae7e784ea238281842408/obelisk-handoffdeleted

No changes to the content.

migration/c801cbcf925c0a7b084ef152e3c08f8e-8d5dba70e93ae7e784ea238281842408/obelisk-upgradedeleted

No changes to the content.

migration/c93529e579e64263fd91663216fd3fe7-12c8a24c34c2d8441f3181d179c2baab/obelisk-handoffdeleted

No changes to the content.

migration/c93529e579e64263fd91663216fd3fe7-12c8a24c34c2d8441f3181d179c2baab/obelisk-upgradedeleted

No changes to the content.

migration/ca5ee8f372ecb07b09283081f0298733-36cdb1c744c3036c2932f01d5fadd9f5/obelisk-handoffdeleted

No changes to the content.

migration/ca5ee8f372ecb07b09283081f0298733-36cdb1c744c3036c2932f01d5fadd9f5/obelisk-upgradedeleted

No changes to the content.

migration/ca88f98cf9fb63d2feaef7fc19b30eca-962e2bd1ae8d0c233f8da89ecebffe50/obelisk-handoffdeleted

No changes to the content.

migration/ca88f98cf9fb63d2feaef7fc19b30eca-962e2bd1ae8d0c233f8da89ecebffe50/obelisk-upgradedeleted

No changes to the content.

migration/cb2197d0267b52385ee39bf4adcfe475-fbe0c6b69a63f3a44109a2c7526bc577/obelisk-handoffdeleted

No changes to the content.

migration/cb2197d0267b52385ee39bf4adcfe475-fbe0c6b69a63f3a44109a2c7526bc577/obelisk-upgradedeleted

No changes to the content.

migration/cb2d040cc16752b1dc89eecf200ea798-5734398c41e4eb5bb58d933ed2e12041/obelisk-handoffdeleted

No changes to the content.

migration/cb2d040cc16752b1dc89eecf200ea798-5734398c41e4eb5bb58d933ed2e12041/obelisk-upgradedeleted

No changes to the content.

migration/cb98f93880e6dea74014976977d6eb93-a7c7b80a875d1863f027c97eb433b884/obelisk-handoffdeleted

No changes to the content.

migration/cb98f93880e6dea74014976977d6eb93-a7c7b80a875d1863f027c97eb433b884/obelisk-upgradedeleted

No changes to the content.

migration/cba28ee4b736cf8ed43cb342ccaef12e-8e01c7fee83aa74229a77772d8c928f3/obelisk-handoffdeleted

No changes to the content.

migration/cba28ee4b736cf8ed43cb342ccaef12e-8e01c7fee83aa74229a77772d8c928f3/obelisk-upgradedeleted

No changes to the content.

migration/cbe155a3e856fb7eaad0bd18feb408be-4c9372bf9aa6ebed1ea20abf3dbb0075/obelisk-handoffdeleted

No changes to the content.

migration/cbe155a3e856fb7eaad0bd18feb408be-4c9372bf9aa6ebed1ea20abf3dbb0075/obelisk-upgradedeleted

No changes to the content.

migration/cc4307fc88e3486b1c3f9ce07db95808-0fba399e046852d4ecf8e1dad831a2f9/obelisk-handoffdeleted

No changes to the content.

migration/cc4307fc88e3486b1c3f9ce07db95808-0fba399e046852d4ecf8e1dad831a2f9/obelisk-upgradedeleted

No changes to the content.

migration/ccadc106cd03c9c32e77457d3adc77a1-aa8e6712fd46824acdea303068634078/obelisk-handoffdeleted

No changes to the content.

migration/ccadc106cd03c9c32e77457d3adc77a1-aa8e6712fd46824acdea303068634078/obelisk-upgradedeleted

No changes to the content.

migration/cccf4140dc336263489bcf67c8c58f86-d50a30fd9643486c5848399d5ba7f1f1/obelisk-handoffdeleted

No changes to the content.

migration/cccf4140dc336263489bcf67c8c58f86-d50a30fd9643486c5848399d5ba7f1f1/obelisk-upgradedeleted

No changes to the content.

migration/cd38e239c47fb92fabd867b7f86fc99a-7447d29f4712c72458c049cdb9380753/obelisk-handoffdeleted

No changes to the content.

migration/cd38e239c47fb92fabd867b7f86fc99a-7447d29f4712c72458c049cdb9380753/obelisk-upgradedeleted

No changes to the content.

migration/cd5b54d21dd0fb868f48624d41021f47-0fe60df438daa8a2cca5f2b569e361a5/obelisk-handoffdeleted

No changes to the content.

migration/cd5b54d21dd0fb868f48624d41021f47-0fe60df438daa8a2cca5f2b569e361a5/obelisk-upgradedeleted

No changes to the content.

migration/cd86427cc2d5b2e931d7ab03deb19d20-bd8f5fa095c3eb19b87d85247b36f1df/obelisk-handoffdeleted

No changes to the content.

migration/cd86427cc2d5b2e931d7ab03deb19d20-bd8f5fa095c3eb19b87d85247b36f1df/obelisk-upgradedeleted

No changes to the content.

migration/ce7f0d15d71d36d4bcf4fbadcdfa1b58-4db97ca86399c557e5ee0d04d0838acc/obelisk-handoffdeleted

No changes to the content.

migration/ce7f0d15d71d36d4bcf4fbadcdfa1b58-4db97ca86399c557e5ee0d04d0838acc/obelisk-upgradedeleted

No changes to the content.

migration/cffcc6cab6080a35b7bf7c5c7facd6bc-5631293b75143d170b8fca5579e15fee/obelisk-handoffdeleted

No changes to the content.

migration/cffcc6cab6080a35b7bf7c5c7facd6bc-5631293b75143d170b8fca5579e15fee/obelisk-upgradedeleted

No changes to the content.

migration/d125109aa22f485d282f6ceb7cd5936e-9b9d73736773550dde7d36de2498b029/obelisk-handoffdeleted

No changes to the content.

migration/d125109aa22f485d282f6ceb7cd5936e-9b9d73736773550dde7d36de2498b029/obelisk-upgradedeleted

No changes to the content.

migration/d16784e9a2d93db7f953941e3003fa8c-a262678b7d849de5a9732d06199666ae/obelisk-handoffdeleted

No changes to the content.

migration/d16784e9a2d93db7f953941e3003fa8c-a262678b7d849de5a9732d06199666ae/obelisk-upgradedeleted

No changes to the content.

migration/d17b41a4669ac17960559614c830d69a-66f7a274206ad9f6d3c5701e4bcffc9d/obelisk-handoffdeleted

No changes to the content.

migration/d17b41a4669ac17960559614c830d69a-66f7a274206ad9f6d3c5701e4bcffc9d/obelisk-upgradedeleted

No changes to the content.

migration/d1b3f5f5375558bf91d55c88547784b9-c0811b664036c7996fcfd19fee241a10/obelisk-handoffdeleted

No changes to the content.

migration/d1b3f5f5375558bf91d55c88547784b9-c0811b664036c7996fcfd19fee241a10/obelisk-upgradedeleted

No changes to the content.

migration/d207ab99328b8ece5fb27fa1f4dbf9f6-e6a85005bd7e5d343bc23e17bfc345f6/obelisk-handoffdeleted

No changes to the content.

migration/d207ab99328b8ece5fb27fa1f4dbf9f6-e6a85005bd7e5d343bc23e17bfc345f6/obelisk-upgradedeleted

No changes to the content.

migration/d2d86ce0ca16b143b49374302a9e9e2f-84f4d5c5491abb855d8dbe3acf3bc8e6/obelisk-handoffdeleted

No changes to the content.

migration/d2d86ce0ca16b143b49374302a9e9e2f-84f4d5c5491abb855d8dbe3acf3bc8e6/obelisk-upgradedeleted

No changes to the content.

migration/d327ceb69d24e40dc11792840454cff9-de469e6488ddf192f2104ec0a030daf7/obelisk-handoffdeleted

No changes to the content.

migration/d327ceb69d24e40dc11792840454cff9-de469e6488ddf192f2104ec0a030daf7/obelisk-upgradedeleted

No changes to the content.

migration/d35f6eb2d1b066d366c9a89ab26144e1-03b9747848d7f3e995b118f776ef96c7/obelisk-handoffdeleted

No changes to the content.

migration/d35f6eb2d1b066d366c9a89ab26144e1-03b9747848d7f3e995b118f776ef96c7/obelisk-upgradedeleted

No changes to the content.

migration/d37d70fe5d7d11e68b59ce12022281c9-5f0d3f7480d67df7deebdb880726b356/obelisk-handoffdeleted

No changes to the content.

migration/d37d70fe5d7d11e68b59ce12022281c9-5f0d3f7480d67df7deebdb880726b356/obelisk-upgradedeleted

No changes to the content.

migration/d40e0e3051a76c4c198cc11c2e8e4b7c-1859cc62bb2f89f528bb2aa170c36e84/obelisk-handoffdeleted

No changes to the content.

migration/d40e0e3051a76c4c198cc11c2e8e4b7c-1859cc62bb2f89f528bb2aa170c36e84/obelisk-upgradedeleted

No changes to the content.

migration/d50a30fd9643486c5848399d5ba7f1f1-1f5b6e2a19c87d3820b953f942ab4a27/obelisk-handoffdeleted

No changes to the content.

migration/d50a30fd9643486c5848399d5ba7f1f1-1f5b6e2a19c87d3820b953f942ab4a27/obelisk-upgradedeleted

No changes to the content.

migration/d532356dfb65a4c8a39452d2ebca2516-bf81caf2a7d528f86acacc1f5d2ffcfa/obelisk-handoffdeleted

No changes to the content.

migration/d532356dfb65a4c8a39452d2ebca2516-bf81caf2a7d528f86acacc1f5d2ffcfa/obelisk-upgradedeleted

No changes to the content.

migration/d5ba6f13296205e5bd88ca2756107df0-26a2491fc8a9658751c1511c777a67bd/obelisk-handoffdeleted

No changes to the content.

migration/d5ba6f13296205e5bd88ca2756107df0-26a2491fc8a9658751c1511c777a67bd/obelisk-upgradedeleted

No changes to the content.

migration/d62d6d443d9c2261b7e09664398aa005-fcc617e973168e1210379a6afe7171be/obelisk-handoffdeleted

No changes to the content.

migration/d62d6d443d9c2261b7e09664398aa005-fcc617e973168e1210379a6afe7171be/obelisk-upgradedeleted

No changes to the content.

migration/d6a3ea5f7eb3c95f5e5ea09fb1330270-bc7688ff47218c0e13d02d917b03caa0/obelisk-handoffdeleted

No changes to the content.

migration/d6a3ea5f7eb3c95f5e5ea09fb1330270-bc7688ff47218c0e13d02d917b03caa0/obelisk-upgradedeleted

No changes to the content.

migration/d6b34eba6ed4f89875a6615fe2c41ec2-3daecb03985f83d8af466a9e0541782b/obelisk-handoffdeleted

No changes to the content.

migration/d6b34eba6ed4f89875a6615fe2c41ec2-3daecb03985f83d8af466a9e0541782b/obelisk-upgradedeleted

No changes to the content.

migration/d6c090699acd25fc60213ff4bd9eebcf-0298e61f6a03e553df08dcef03e27bd1/obelisk-handoffdeleted

No changes to the content.

migration/d6c090699acd25fc60213ff4bd9eebcf-0298e61f6a03e553df08dcef03e27bd1/obelisk-upgradedeleted

No changes to the content.

migration/d6cacd7f4fab95c4b6aa2d6c1a4ad2a0-4d6197d8166de78f882376102e36300b/obelisk-handoffdeleted

No changes to the content.

migration/d6cacd7f4fab95c4b6aa2d6c1a4ad2a0-4d6197d8166de78f882376102e36300b/obelisk-upgradedeleted

No changes to the content.

migration/d747c3d0620b2034aca44265dd1c8c86-eeb970434a53f4883c9f0255db555581/obelisk-handoffdeleted

No changes to the content.

migration/d747c3d0620b2034aca44265dd1c8c86-eeb970434a53f4883c9f0255db555581/obelisk-upgradedeleted

No changes to the content.

migration/d8adb57b2f2266e128ebb6f6d7e65920-ccadc106cd03c9c32e77457d3adc77a1/obelisk-handoffdeleted

No changes to the content.

migration/d8adb57b2f2266e128ebb6f6d7e65920-ccadc106cd03c9c32e77457d3adc77a1/obelisk-upgradedeleted

No changes to the content.

migration/da23605ee4058c8474687e74a3999354-dfd7dbceea141c60bbfca962d50c1c06/obelisk-handoffdeleted

No changes to the content.

migration/da23605ee4058c8474687e74a3999354-dfd7dbceea141c60bbfca962d50c1c06/obelisk-upgradedeleted

No changes to the content.

migration/db327f87e60d4e59bdbfd482e5abe985-eb99c1a66237ba99cd1f6d244cafb9cc/obelisk-handoffdeleted

No changes to the content.

migration/db327f87e60d4e59bdbfd482e5abe985-eb99c1a66237ba99cd1f6d244cafb9cc/obelisk-upgradedeleted

No changes to the content.

migration/dc95f39fb27634ccbca7318ff2065608-0fb3a912a8aaf5ef6f734a25f0bce7e2/obelisk-handoffdeleted

No changes to the content.

migration/dc95f39fb27634ccbca7318ff2065608-0fb3a912a8aaf5ef6f734a25f0bce7e2/obelisk-upgradedeleted

No changes to the content.

migration/dd6ca52a58ea6cda7b3eaa2e87bb13d9-a6d50c7e756dfd1e3ae891111b81a1ae/obelisk-handoffdeleted

No changes to the content.

migration/dd6ca52a58ea6cda7b3eaa2e87bb13d9-a6d50c7e756dfd1e3ae891111b81a1ae/obelisk-upgradedeleted

No changes to the content.

migration/ddaa8e0e42a1ef00154d580a390c9f17-53d29061537ddaf7530aef88624ab266/obelisk-handoffdeleted

No changes to the content.

migration/ddaa8e0e42a1ef00154d580a390c9f17-53d29061537ddaf7530aef88624ab266/obelisk-upgradedeleted

No changes to the content.

migration/de469e6488ddf192f2104ec0a030daf7-3da7d4a3b507d18097a90becf4dde9aa/obelisk-handoffdeleted

No changes to the content.

migration/de469e6488ddf192f2104ec0a030daf7-3da7d4a3b507d18097a90becf4dde9aa/obelisk-upgradedeleted

No changes to the content.

migration/df71cd82e801ca701bf4bc44b80b6d50-f423ecd4d096de9dca37a67b8b4143eb/obelisk-handoffdeleted

No changes to the content.

migration/df71cd82e801ca701bf4bc44b80b6d50-f423ecd4d096de9dca37a67b8b4143eb/obelisk-upgradedeleted

No changes to the content.

migration/dfd7dbceea141c60bbfca962d50c1c06-030ed18dacf3571cbb9e3e7d9d99627b/obelisk-handoffdeleted

No changes to the content.

migration/dfd7dbceea141c60bbfca962d50c1c06-030ed18dacf3571cbb9e3e7d9d99627b/obelisk-upgradedeleted

No changes to the content.

migration/e01cc01684deaf4c75ad5d65270bf3d5-c7dbf17de8aebd3043617ea6db790dcc/obelisk-handoffdeleted

No changes to the content.

migration/e01cc01684deaf4c75ad5d65270bf3d5-c7dbf17de8aebd3043617ea6db790dcc/obelisk-upgradedeleted

No changes to the content.

migration/e1ef432db54d9a6daa9bdeeb543262ae-2ba356b187db8db13b8aa40f43ca025f/obelisk-handoffdeleted

No changes to the content.

migration/e1ef432db54d9a6daa9bdeeb543262ae-2ba356b187db8db13b8aa40f43ca025f/obelisk-upgradedeleted

No changes to the content.

migration/e22c51145e08d4a089003460ae80a7f9-42357310c09e345f9360259c6c4102f2/obelisk-handoffdeleted

No changes to the content.

migration/e22c51145e08d4a089003460ae80a7f9-42357310c09e345f9360259c6c4102f2/obelisk-upgradedeleted

No changes to the content.

migration/e24a771ee59f24e45afc0a27307f2070-2eb907820012f77e60350430d89631fe/obelisk-handoffdeleted

No changes to the content.

migration/e24a771ee59f24e45afc0a27307f2070-2eb907820012f77e60350430d89631fe/obelisk-upgradedeleted

No changes to the content.

migration/e2706f337218a12a3bdddd18fa3f4cfd-475f9a0d63e84e9cf13b8be3986cb603/obelisk-handoffdeleted

No changes to the content.

migration/e2706f337218a12a3bdddd18fa3f4cfd-475f9a0d63e84e9cf13b8be3986cb603/obelisk-upgradedeleted

No changes to the content.

migration/e2b2d878b0ba6eb653b194523bf0a0e0-5f307639ccf6a64309166bfe58037397/obelisk-handoffdeleted

No changes to the content.

migration/e2b2d878b0ba6eb653b194523bf0a0e0-5f307639ccf6a64309166bfe58037397/obelisk-upgradedeleted

No changes to the content.

migration/e2be519915794ef130249f2be7640382-455279b6974b96a673613cd0ccc8ed54/obelisk-handoffdeleted

No changes to the content.

migration/e2be519915794ef130249f2be7640382-455279b6974b96a673613cd0ccc8ed54/obelisk-upgradedeleted

No changes to the content.

migration/e323ce1352e512109f1609276fb509b4-2c1521e5a5be64e6d28a9fdae950cd76/obelisk-handoffdeleted

No changes to the content.

migration/e323ce1352e512109f1609276fb509b4-2c1521e5a5be64e6d28a9fdae950cd76/obelisk-upgradedeleted

No changes to the content.

migration/e327773e1525eaa1eb2112dff8f41b26-f595b01939b4c87b7c146ea9ff331b39/obelisk-handoffdeleted

No changes to the content.

migration/e327773e1525eaa1eb2112dff8f41b26-f595b01939b4c87b7c146ea9ff331b39/obelisk-upgradedeleted

No changes to the content.

migration/e3b3014d7e0dc983fe118d32546654e5-063665b78b6705e7de952f73fa9797bf/obelisk-handoffdeleted

No changes to the content.

migration/e3b3014d7e0dc983fe118d32546654e5-063665b78b6705e7de952f73fa9797bf/obelisk-upgradedeleted

No changes to the content.

migration/e4051219d89b3c9a8350fe824ad96a82-166c5f8e4a0f1dfd227b075a96237386/obelisk-handoffdeleted

No changes to the content.

migration/e4051219d89b3c9a8350fe824ad96a82-166c5f8e4a0f1dfd227b075a96237386/obelisk-upgradedeleted

No changes to the content.

migration/e4513b485b6ba8b7f4bd34b12458ff0c-3c80eccfe80d0abd36b07bb11e69fc7a/obelisk-handoffdeleted

No changes to the content.

migration/e4513b485b6ba8b7f4bd34b12458ff0c-3c80eccfe80d0abd36b07bb11e69fc7a/obelisk-upgradedeleted

No changes to the content.

migration/e474bad466cd6e413fba753746eb58ef-f19b3699616f3b1de3a277f9cba617c7/obelisk-handoffdeleted

No changes to the content.

migration/e474bad466cd6e413fba753746eb58ef-f19b3699616f3b1de3a277f9cba617c7/obelisk-upgradedeleted

No changes to the content.

migration/e4b89dd259f3831bc60b56147b3586a6-98da197f133bca81e533ab5ffbf4c82d/obelisk-handoffdeleted

No changes to the content.

migration/e4b89dd259f3831bc60b56147b3586a6-98da197f133bca81e533ab5ffbf4c82d/obelisk-upgradedeleted

No changes to the content.

migration/e609d945b642fd9d4ce99931e3699db7-85c2c4fb8472d50eaa97aed0bdc9b142/obelisk-handoffdeleted

No changes to the content.

migration/e609d945b642fd9d4ce99931e3699db7-85c2c4fb8472d50eaa97aed0bdc9b142/obelisk-upgradedeleted

No changes to the content.

migration/e6980e47ba847245dfab61fb4d5b8ce5-58f9d23d2cede2081dc6f6cfa2283f60/obelisk-handoffdeleted

No changes to the content.

migration/e6980e47ba847245dfab61fb4d5b8ce5-58f9d23d2cede2081dc6f6cfa2283f60/obelisk-upgradedeleted

No changes to the content.

migration/e6a85005bd7e5d343bc23e17bfc345f6-98f9e0bbd21e36b0f4daa440d11e7177/obelisk-handoffdeleted

No changes to the content.

migration/e6a85005bd7e5d343bc23e17bfc345f6-98f9e0bbd21e36b0f4daa440d11e7177/obelisk-upgradedeleted

No changes to the content.

migration/e7288bb723a4e5b7139ac67842963287-7b75ffdcd86b5a330d9c325ad5767393/obelisk-handoffdeleted

No changes to the content.

migration/e7288bb723a4e5b7139ac67842963287-7b75ffdcd86b5a330d9c325ad5767393/obelisk-upgradedeleted

No changes to the content.

migration/e7385c9eae2b807a483b73be4295b207-fb02559b6f723d599e12931a81be3a1b/obelisk-handoffdeleted

No changes to the content.

migration/e7385c9eae2b807a483b73be4295b207-fb02559b6f723d599e12931a81be3a1b/obelisk-upgradedeleted

No changes to the content.

migration/e7667778f2ab3055aa3ccc68443d14df-7adece557941a7d7ac7c150f77f758be/obelisk-handoffdeleted

No changes to the content.

migration/e7667778f2ab3055aa3ccc68443d14df-7adece557941a7d7ac7c150f77f758be/obelisk-upgradedeleted

No changes to the content.

migration/e78ec85bec14f4784faeef4d8d3e4d0a-e7667778f2ab3055aa3ccc68443d14df/obelisk-handoffdeleted

No changes to the content.

migration/e78ec85bec14f4784faeef4d8d3e4d0a-e7667778f2ab3055aa3ccc68443d14df/obelisk-upgradedeleted

No changes to the content.

migration/e7b17aa124e17c357cead8081a58f089-ac5e28caddd6832d0bf1f7445a4a6a28/obelisk-handoffdeleted

No changes to the content.

migration/e7b17aa124e17c357cead8081a58f089-ac5e28caddd6832d0bf1f7445a4a6a28/obelisk-upgradedeleted

No changes to the content.

migration/e7b566495114e160f1f4d722b7ed8174-7cf814f7404638f1c1be662a24d7cfea/obelisk-handoffdeleted

No changes to the content.

migration/e7b566495114e160f1f4d722b7ed8174-7cf814f7404638f1c1be662a24d7cfea/obelisk-upgradedeleted

No changes to the content.

migration/e92786eaf56c32fd6b452c4a841d6317-f24a7fb6e3261c4919ea2a2fee83ed6b/obelisk-handoffdeleted

No changes to the content.

migration/e92786eaf56c32fd6b452c4a841d6317-f24a7fb6e3261c4919ea2a2fee83ed6b/obelisk-upgradedeleted

No changes to the content.

migration/e9ec84bfe7099b713c0fda32308f5815-f0a064ca5f709233204168c136b99a7e/obelisk-handoffdeleted

No changes to the content.

migration/e9ec84bfe7099b713c0fda32308f5815-f0a064ca5f709233204168c136b99a7e/obelisk-upgradedeleted

No changes to the content.

migration/eb99c1a66237ba99cd1f6d244cafb9cc-da23605ee4058c8474687e74a3999354/obelisk-handoffdeleted

No changes to the content.

migration/eb99c1a66237ba99cd1f6d244cafb9cc-da23605ee4058c8474687e74a3999354/obelisk-upgradedeleted

No changes to the content.

migration/ebb95c5864d1d1d2f78fbf7cc8235dac-ba4829dc61dcc12bcafd8de5fc8a76dc/obelisk-handoffdeleted

No changes to the content.

migration/ebb95c5864d1d1d2f78fbf7cc8235dac-ba4829dc61dcc12bcafd8de5fc8a76dc/obelisk-upgradedeleted

No changes to the content.

migration/ec11d10a6131abca9222a8f8026fb5e4-f3d494ffee7091cd588bbdd2fd9bcdf9/obelisk-handoffdeleted

No changes to the content.

migration/ec11d10a6131abca9222a8f8026fb5e4-f3d494ffee7091cd588bbdd2fd9bcdf9/obelisk-upgradedeleted

No changes to the content.

migration/ec94619fa3f25db1ca84d179e47db1ca-23af4d9671962484de53f537a0626d83/obelisk-handoffdeleted

No changes to the content.

migration/ec94619fa3f25db1ca84d179e47db1ca-23af4d9671962484de53f537a0626d83/obelisk-upgradedeleted

No changes to the content.

migration/ed95a99cdde4adc90c6a8e2de82410eb-1c4fc23cbf5653613c6060668e065f37/obelisk-handoffdeleted

No changes to the content.

migration/ed95a99cdde4adc90c6a8e2de82410eb-1c4fc23cbf5653613c6060668e065f37/obelisk-upgradedeleted

No changes to the content.

migration/ee3dccc89ea6fdaaf9c1146b92861e90-f3eac05465851232f8174a7a347d1c4b/obelisk-handoffdeleted

No changes to the content.

migration/ee3dccc89ea6fdaaf9c1146b92861e90-f3eac05465851232f8174a7a347d1c4b/obelisk-upgradedeleted

No changes to the content.

migration/eeb970434a53f4883c9f0255db555581-a2b33f8dc1f90b8dddce942b174be5b8/obelisk-handoffdeleted

No changes to the content.

migration/eeb970434a53f4883c9f0255db555581-a2b33f8dc1f90b8dddce942b174be5b8/obelisk-upgradedeleted

No changes to the content.

migration/ef33c06500054e09c97eee9e9c55485a-367616bd36eda757f251a5e8e9096acc/obelisk-handoffdeleted

No changes to the content.

migration/ef33c06500054e09c97eee9e9c55485a-367616bd36eda757f251a5e8e9096acc/obelisk-upgradedeleted

No changes to the content.

migration/ef6aebc8cba2af6c4f930c981b06e8ac-d17b41a4669ac17960559614c830d69a/obelisk-handoffdeleted

No changes to the content.

migration/ef6aebc8cba2af6c4f930c981b06e8ac-d17b41a4669ac17960559614c830d69a/obelisk-upgradedeleted

No changes to the content.

migration/f0a064ca5f709233204168c136b99a7e-ef6aebc8cba2af6c4f930c981b06e8ac/obelisk-handoffdeleted

No changes to the content.

migration/f0a064ca5f709233204168c136b99a7e-ef6aebc8cba2af6c4f930c981b06e8ac/obelisk-upgradedeleted

No changes to the content.

migration/f15c9c2f894c8cc4fac07e2cdef47180-94252585266fa745a91733888e2f50b7/obelisk-handoffdeleted

No changes to the content.

migration/f15c9c2f894c8cc4fac07e2cdef47180-94252585266fa745a91733888e2f50b7/obelisk-upgradedeleted

No changes to the content.

migration/f19b3699616f3b1de3a277f9cba617c7-4d85ee8cdb0db20a5662b09567a2bbe7/obelisk-handoffdeleted

No changes to the content.

migration/f19b3699616f3b1de3a277f9cba617c7-4d85ee8cdb0db20a5662b09567a2bbe7/obelisk-upgradedeleted

No changes to the content.

migration/f24a7fb6e3261c4919ea2a2fee83ed6b-f913f01e90549c56a8b05f8100cfa21d/obelisk-handoffdeleted

No changes to the content.

migration/f24a7fb6e3261c4919ea2a2fee83ed6b-f913f01e90549c56a8b05f8100cfa21d/obelisk-upgradedeleted

No changes to the content.

migration/f2a9ba4a93c3a04acbee2211bca9e27a-ec94619fa3f25db1ca84d179e47db1ca/obelisk-handoffdeleted

No changes to the content.

migration/f2a9ba4a93c3a04acbee2211bca9e27a-ec94619fa3f25db1ca84d179e47db1ca/obelisk-upgradedeleted

No changes to the content.

migration/f391c6a74ee14217ce4565c278fceed6-e7288bb723a4e5b7139ac67842963287/obelisk-handoffdeleted

No changes to the content.

migration/f391c6a74ee14217ce4565c278fceed6-e7288bb723a4e5b7139ac67842963287/obelisk-upgradedeleted

No changes to the content.

migration/f3d494ffee7091cd588bbdd2fd9bcdf9-b68a785fbf27a63334ef1d1fe82b2dac/obelisk-handoffdeleted

No changes to the content.

migration/f3d494ffee7091cd588bbdd2fd9bcdf9-b68a785fbf27a63334ef1d1fe82b2dac/obelisk-upgradedeleted

No changes to the content.

migration/f3eac05465851232f8174a7a347d1c4b-1629d0d70e360df6b2280fac36d21e8a/obelisk-handoffdeleted

No changes to the content.

migration/f3eac05465851232f8174a7a347d1c4b-1629d0d70e360df6b2280fac36d21e8a/obelisk-upgradedeleted

No changes to the content.

migration/f3ec62d09836804e39fad9d814137845-ef33c06500054e09c97eee9e9c55485a/obelisk-handoffdeleted

No changes to the content.

migration/f3ec62d09836804e39fad9d814137845-ef33c06500054e09c97eee9e9c55485a/obelisk-upgradedeleted

No changes to the content.

migration/f41b690c74938e347cf042cee2d4fc72-7fc381538805adac19c54b73ea118601/obelisk-handoffdeleted

No changes to the content.

migration/f41b690c74938e347cf042cee2d4fc72-7fc381538805adac19c54b73ea118601/obelisk-upgradedeleted

No changes to the content.

migration/f423ecd4d096de9dca37a67b8b4143eb-469a31d20d69da72e6a3a3ea2bb02f9d/obelisk-handoffdeleted

No changes to the content.

migration/f423ecd4d096de9dca37a67b8b4143eb-469a31d20d69da72e6a3a3ea2bb02f9d/obelisk-upgradedeleted

No changes to the content.

migration/f595b01939b4c87b7c146ea9ff331b39-4da182e21be35feeee484dc85be7a075/obelisk-handoffdeleted

No changes to the content.

migration/f595b01939b4c87b7c146ea9ff331b39-4da182e21be35feeee484dc85be7a075/obelisk-upgradedeleted

No changes to the content.

migration/f68462dc88ed7fc451d1c757c040cfee-589eb89cdb09655c5edde4cd2a4deb80/obelisk-handoffdeleted

No changes to the content.

migration/f68462dc88ed7fc451d1c757c040cfee-589eb89cdb09655c5edde4cd2a4deb80/obelisk-upgradedeleted

No changes to the content.

migration/f790ac9400501511b4ee045e22bc5fe1-a826f01311fe00ef5cf87568832605d3/obelisk-handoffdeleted

No changes to the content.

migration/f790ac9400501511b4ee045e22bc5fe1-a826f01311fe00ef5cf87568832605d3/obelisk-upgradedeleted

No changes to the content.

migration/f8e51a9e8ac6598f7c073b09e4ba09b5-ff57aebc7325bd7e02b436fec79e799c/obelisk-handoffdeleted

No changes to the content.

migration/f8e51a9e8ac6598f7c073b09e4ba09b5-ff57aebc7325bd7e02b436fec79e799c/obelisk-upgradedeleted

No changes to the content.

migration/f8eee9431c8b7a767d96da0a8cfae95d-9e05cc6b81c6380ba0ac59bad1021cac/obelisk-handoffdeleted

No changes to the content.

migration/f8eee9431c8b7a767d96da0a8cfae95d-9e05cc6b81c6380ba0ac59bad1021cac/obelisk-upgradedeleted

No changes to the content.

migration/f913f01e90549c56a8b05f8100cfa21d-001efbbe866b66eebc6ee1ea0a906f2d/obelisk-handoffdeleted

No changes to the content.

migration/f913f01e90549c56a8b05f8100cfa21d-001efbbe866b66eebc6ee1ea0a906f2d/obelisk-upgradedeleted

No changes to the content.

migration/f9716ad47c84e0b7ac7d426e8ad059f3-ec11d10a6131abca9222a8f8026fb5e4/obelisk-handoffdeleted

No changes to the content.

migration/f9716ad47c84e0b7ac7d426e8ad059f3-ec11d10a6131abca9222a8f8026fb5e4/obelisk-upgradedeleted

No changes to the content.

migration/f98b82f5d142ce83733a3f18bdacb138-35acc1e0c4d9c02d60abd116f3df84ee/obelisk-handoffdeleted

No changes to the content.

migration/f98b82f5d142ce83733a3f18bdacb138-35acc1e0c4d9c02d60abd116f3df84ee/obelisk-upgradedeleted

No changes to the content.

migration/f9ad863c0bebc103f8b81afdf82e6293-c6f38304ee53762590c67020f30d2ab4/obelisk-handoffdeleted

No changes to the content.

migration/f9ad863c0bebc103f8b81afdf82e6293-c6f38304ee53762590c67020f30d2ab4/obelisk-upgradedeleted

No changes to the content.

migration/fa18f7522903a21b615dbee24c26bfbe-0535e06dd0d61f3e6970b491a17cf1f8/obelisk-handoffdeleted

No changes to the content.

migration/fa18f7522903a21b615dbee24c26bfbe-0535e06dd0d61f3e6970b491a17cf1f8/obelisk-upgradedeleted

No changes to the content.

migration/fb02559b6f723d599e12931a81be3a1b-71a47d4d6856c1956c0d1c9de9af231f/obelisk-handoffdeleted

No changes to the content.

migration/fb02559b6f723d599e12931a81be3a1b-71a47d4d6856c1956c0d1c9de9af231f/obelisk-upgradedeleted

No changes to the content.

migration/fb374b0721716a1e849e64daf6da73c4-f8e51a9e8ac6598f7c073b09e4ba09b5/obelisk-handoffdeleted

No changes to the content.

migration/fb374b0721716a1e849e64daf6da73c4-f8e51a9e8ac6598f7c073b09e4ba09b5/obelisk-upgradedeleted

No changes to the content.

migration/fb5110e527cf77c568bcae7d435ee035-53fdf819333b86dfb485bf16a8f28db2/obelisk-handoffdeleted

No changes to the content.

migration/fb5110e527cf77c568bcae7d435ee035-53fdf819333b86dfb485bf16a8f28db2/obelisk-upgradedeleted

No changes to the content.

migration/fb81153791e49cd00850e91ff7418018-9b33a49f0c978e27b752fa457aca97cc/obelisk-handoffdeleted

No changes to the content.

migration/fb81153791e49cd00850e91ff7418018-9b33a49f0c978e27b752fa457aca97cc/obelisk-upgradedeleted

No changes to the content.

migration/fbb3eb3209281031dc5183d289eb4e75-8c7718f94e2676c957fe844b7dc2637c/obelisk-handoffdeleted

No changes to the content.

migration/fbb3eb3209281031dc5183d289eb4e75-8c7718f94e2676c957fe844b7dc2637c/obelisk-upgradedeleted

No changes to the content.

migration/fbe0c6b69a63f3a44109a2c7526bc577-c3a8b70b1290031feb21880914cb081e/obelisk-handoffdeleted

No changes to the content.

migration/fbe0c6b69a63f3a44109a2c7526bc577-c3a8b70b1290031feb21880914cb081e/obelisk-upgradedeleted

No changes to the content.

migration/fc42c5fc24031fc6a8836a10cfb45143-d125109aa22f485d282f6ceb7cd5936e/obelisk-handoffdeleted

No changes to the content.

migration/fc42c5fc24031fc6a8836a10cfb45143-d125109aa22f485d282f6ceb7cd5936e/obelisk-upgradedeleted

No changes to the content.

migration/fca48edfdaa31b036176b97b04384682-2df092178e167b474dd08dfa46ec3a49/obelisk-handoffdeleted

No changes to the content.

migration/fca48edfdaa31b036176b97b04384682-2df092178e167b474dd08dfa46ec3a49/obelisk-upgradedeleted

No changes to the content.

migration/fcc617e973168e1210379a6afe7171be-ed95a99cdde4adc90c6a8e2de82410eb/obelisk-handoffdeleted

No changes to the content.

migration/fcc617e973168e1210379a6afe7171be-ed95a99cdde4adc90c6a8e2de82410eb/obelisk-upgradedeleted

No changes to the content.

migration/ff1105290f89350bc9deb6eb907e0a53-0c991bc3c06801f72df48486ee78e350/obelisk-handoffdeleted

No changes to the content.

migration/ff1105290f89350bc9deb6eb907e0a53-0c991bc3c06801f72df48486ee78e350/obelisk-upgradedeleted

No changes to the content.

migration/ff57aebc7325bd7e02b436fec79e799c-9f71fc9d2ed805fecbc8c4a3aae5685b/obelisk-handoffdeleted

No changes to the content.

migration/ff57aebc7325bd7e02b436fec79e799c-9f71fc9d2ed805fecbc8c4a3aae5685b/obelisk-upgradedeleted

No changes to the content.

migration/ffa62158ed6fdece012980e4ad25e6ac-959ae2925bcd2b5beff631a8e7aeaf00/obelisk-handoffdeleted

No changes to the content.

migration/ffa62158ed6fdece012980e4ad25e6ac-959ae2925bcd2b5beff631a8e7aeaf00/obelisk-upgradedeleted

No changes to the content.

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−43
@@ -1,45 +1,10 @@
1−{ local-self ? import ./. {}
1+{
2−, local-pkgs ? local-self.nixpkgs
2+ supportedSystems ? [ "x86_64-linux" "x86_64-darwin" ]
3}:
3}:
4+rec {
5+ recurseForDerivations = true;
6+ build = import ./all-builds.nix { inherit supportedSystems; };
7+ test = import ./all-tests.nix { inherit supportedSystems; };
4
8
5−with local-pkgs.lib;
9+ inherit (build) metaCache;
6−
10+}
7−genAttrs [ "x86_64-linux" "x86_64-darwin" ] (system: {
8− inherit (import ./. { inherit system; }) command;
9− built-skeleton = (import ./skeleton { inherit system; }).all;
10− tests = {
11− #TODO: Doesn't work; see discussion in https://www.pivotaltracker.com/story/show/157265140
12− # ob-init = runCommand "ob-init" {
13− # nativeBuildInputs = [
14− # self.command
15− # nix
16− # ];
17− # } ''
18− # # mkdir $out
19− # # cd $out
20− # # ob init --symlink=${self.path}
21− #'';
22−
23− #TODO: Re-enable this
24− #verify-migration = runCommand "verify-migration" {
25− # nativeBuildInputs = [
26− # self.command
27− # nix # obelisk uses `nix-hash`
28− # ];
29− #} ''
30− # set -e
31− # # Fix permissions so `removePathForcibly` works on copied-to-tmp paths
32− # cp -a ${self.pathGit} $TMPDIR/obelisk
33− # cd $TMPDIR/obelisk
34− # chmod -R u+w .
35− #
36− # (set -x;
37− # ob internal hash;
38− # ob internal verify-migration;
39− # )
40− #
41− # mkdir -p $out
42− # touch $out/done
43− #'';
44− };
45−})
scripts/ghcid-this-libdeleted−4
@@ -1,4 +0,0 @@
1−#!/usr/bin/env bash
2−set -euo pipefail
3−
4−nix-shell -E "with (import ../.. {}); reflex-platform.workOn haskellPackageSets.ghc haskellPackageSets.ghc.obelisk-$(basename $PWD)" --run "cabal configure ; ghcid -c'cabal repl'"
skeleton/.gitignore+13−5
@@ -1,7 +1,15 @@
1−dist-newstyle
2−result
3−result-android
4−result-ios
5−result-exe
6.attr-cache
1.attr-cache
2+.cabal-sandbox
3+*.hi
4+*.o
5+cabal.project.local
6+cabal.sandbox.config
7+ctags
8+dist-newstyle/
9+dist/
7ghcid-output.txt
10ghcid-output.txt
11+profile/
12+result
13+result-*
14+tags
15+TAGS
skeleton/backend/backend.cabal+2−1
@@ -14,11 +14,12 @@ library
14 , obelisk-route
14 , obelisk-route
15 exposed-modules:
15 exposed-modules:
16 Backend
16 Backend
17− ghc-options: -Wall
17+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
18
18
19executable backend
19executable backend
20 main-is: main.hs
20 main-is: main.hs
21 hs-source-dirs: src-bin
21 hs-source-dirs: src-bin
22+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -threaded -fno-show-valid-hole-fits
22 if impl(ghcjs)
23 if impl(ghcjs)
23 buildable: False
24 buildable: False
24 build-depends: base
25 build-depends: base
skeleton/backend/src/Backend.hs+1−6
@@ -1,8 +1,3 @@
1−{-# LANGUAGE EmptyCase #-}
2−{-# LANGUAGE FlexibleContexts #-}
3−{-# LANGUAGE LambdaCase #-}
4−{-# LANGUAGE RankNTypes #-}
5−{-# LANGUAGE TypeFamilies #-}
6module Backend where
1module Backend where
7
2
8import Common.Route
3import Common.Route
@@ -11,5 +6,5 @@ import Obelisk.Backend
11backend :: Backend BackendRoute FrontendRoute
6backend :: Backend BackendRoute FrontendRoute
12backend = Backend
7backend = Backend
13 { _backend_run = \serve -> serve $ const $ return ()
8 { _backend_run = \serve -> serve $ const $ return ()
14− , _backend_routeEncoder = backendRouteEncoder
9+ , _backend_routeEncoder = fullRouteEncoder
15 }
10 }
skeleton/cabal.project+1
@@ -1,2 +1,3 @@
1optional-packages:
1optional-packages:
2 *
2 *
3+write-ghc-environment-files: never
skeleton/common/common.cabal+1−1
@@ -9,7 +9,7 @@ library
9 , obelisk-route
9 , obelisk-route
10 , mtl
10 , mtl
11 , text
11 , text
12−
13 exposed-modules:
12 exposed-modules:
14 Common.Api
13 Common.Api
15 Common.Route
14 Common.Route
15+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
skeleton/common/src/Common/Api.hs+1−1
@@ -1,4 +1,4 @@
1module Common.Api where
1module Common.Api where
2
2
3commonStuff :: String
3commonStuff :: String
4−commonStuff = "Here is a string defined in code common to the frontend and backend."
4+commonStuff = "Here is a string defined in Common.Api"
skeleton/common/src/Common/Route.hs+13−18
@@ -1,15 +1,14 @@
1{-# LANGUAGE EmptyCase #-}
1{-# LANGUAGE EmptyCase #-}
2{-# LANGUAGE FlexibleContexts #-}
2{-# LANGUAGE FlexibleContexts #-}
3+{-# LANGUAGE FlexibleInstances #-}
3{-# LANGUAGE GADTs #-}
4{-# LANGUAGE GADTs #-}
4−{-# LANGUAGE LambdaCase #-}
5−{-# LANGUAGE RankNTypes #-}
6−{-# LANGUAGE TemplateHaskell #-}
7{-# LANGUAGE KindSignatures #-}
5{-# LANGUAGE KindSignatures #-}
8−{-# LANGUAGE EmptyCase #-}
6+{-# LANGUAGE LambdaCase #-}
9{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE MultiParamTypeClasses #-}
10−{-# LANGUAGE FlexibleInstances #-}
11{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE OverloadedStrings #-}
12−
9+{-# LANGUAGE RankNTypes #-}
10+{-# LANGUAGE TemplateHaskell #-}
11+{-# LANGUAGE TypeFamilies #-}
13module Common.Route where
12module Common.Route where
14
13
15{- -- You will probably want these imports for composing Encoders.
14{- -- You will probably want these imports for composing Encoders.
@@ -19,7 +18,6 @@ import Control.Category
19
18
20import Data.Text (Text)
19import Data.Text (Text)
21import Data.Functor.Identity
20import Data.Functor.Identity
22−import Data.Functor.Sum
23
21
24import Obelisk.Route
22import Obelisk.Route
25import Obelisk.Route.TH
23import Obelisk.Route.TH
@@ -34,17 +32,14 @@ data FrontendRoute :: * -> * where
34 FrontendRoute_Main :: FrontendRoute ()
32 FrontendRoute_Main :: FrontendRoute ()
35 -- This type is used to define frontend routes, i.e. ones for which the backend will serve the frontend.
33 -- This type is used to define frontend routes, i.e. ones for which the backend will serve the frontend.
36
34
37−backendRouteEncoder
35+fullRouteEncoder
38− :: Encoder (Either Text) Identity (R (Sum BackendRoute (ObeliskRoute FrontendRoute))) PageName
36+ :: Encoder (Either Text) Identity (R (FullRoute BackendRoute FrontendRoute)) PageName
39−backendRouteEncoder = handleEncoder (const (InL BackendRoute_Missing :/ ())) $
37+fullRouteEncoder = mkFullRouteEncoder
40− pathComponentEncoder $ \case
38+ (FullRoute_Backend BackendRoute_Missing :/ ())
41− InL backendRoute -> case backendRoute of
39+ (\case
42− BackendRoute_Missing -> PathSegment "missing" $ unitEncoder mempty
40+ BackendRoute_Missing -> PathSegment "missing" $ unitEncoder mempty)
43− InR obeliskRoute -> obeliskRouteSegment obeliskRoute $ \case
41+ (\case
44− -- The encoder given to PathEnd determines how to parse query parameters,
42+ FrontendRoute_Main -> PathEnd $ unitEncoder mempty)
45− -- in this example, we have none, so we insist on it.
46− FrontendRoute_Main -> PathEnd $ unitEncoder mempty
47−
48
43
49concat <$> mapM deriveRouteComponent
44concat <$> mapM deriveRouteComponent
50 [ ''BackendRoute
45 [ ''BackendRoute
skeleton/config/common/examplenew file+1
@@ -0,0 +1 @@
1+This string comes from config/common/example
skeleton/default.nix+16−3
@@ -1,7 +1,20 @@
1−{ system ? builtins.currentSystem # TODO: Get rid of this system cruft
1+{ system ? builtins.currentSystem
2−, iosSdkVersion ? "10.2"
2+, obelisk ? import ./.obelisk/impl {
3+ inherit system;
4+ iosSdkVersion = "13.2";
5+
6+ # You must accept the Android Software Development Kit License Agreement at
7+ # https://developer.android.com/studio/terms in order to build Android apps.
8+ # Uncomment and set this to `true` to indicate your acceptance:
9+ # config.android_sdk.accept_license = false;
10+
11+ # In order to use Let's Encrypt for HTTPS deployments you must accept
12+ # their terms of service at https://letsencrypt.org/repository/.
13+ # Uncomment and set this to `true` to indicate your acceptance:
14+ # terms.security.acme.acceptTerms = false;
15+ }
3}:
16}:
4−with import ./.obelisk/impl { inherit system iosSdkVersion; };
17+with obelisk;
5project ./. ({ ... }: {
18project ./. ({ ... }: {
6 android.applicationId = "systems.obsidian.obelisk.examples.minimal";
19 android.applicationId = "systems.obsidian.obelisk.examples.minimal";
7 android.displayName = "Obelisk Minimal Example";
20 android.displayName = "Obelisk Minimal Example";
skeleton/frontend/frontend.cabal+8−4
@@ -9,12 +9,14 @@ 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
14+ , obelisk-executable-config-lookup
13 , obelisk-generated-static
15 , obelisk-generated-static
14 , text
16 , text
15 exposed-modules:
17 exposed-modules:
16 Frontend
18 Frontend
17− ghc-options: -Wall
19+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
18
20
19executable frontend
21executable frontend
20 main-is: main.hs
22 main-is: main.hs
@@ -26,7 +28,9 @@ executable frontend
26 , reflex-dom
28 , reflex-dom
27 , obelisk-generated-static
29 , obelisk-generated-static
28 , frontend
30 , frontend
29− --TODO: Make these ghc-options optional
31+ ghc-options: -threaded -O -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -fno-show-valid-hole-fits
30− ghc-options: -threaded
32+ if impl(ghcjs)
33+ ghc-options: -dedupe
34+ cpp-options: -DGHCJS_BROWSER
31 if os(darwin)
35 if os(darwin)
32− ghc-options: -dynamic
36+ ghc-options: -dynamic
skeleton/frontend/src-bin/main.hs+1−1
@@ -6,5 +6,5 @@ import Reflex.Dom
6
6
7main :: IO ()
7main :: IO ()
8main = do
8main = do
9− let Right validFullEncoder = checkEncoder backendRouteEncoder
9+ let Right validFullEncoder = checkEncoder fullRouteEncoder
10 run $ runFrontend validFullEncoder frontend
10 run $ runFrontend validFullEncoder frontend
skeleton/frontend/src/Frontend.hs+28−3
@@ -1,23 +1,48 @@
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
9+import qualified Data.Text.Encoding as T
10+import Language.Javascript.JSaddle (eval, liftJSM)
11+
7import Obelisk.Frontend
12import Obelisk.Frontend
13+import Obelisk.Configs
8import Obelisk.Route
14import Obelisk.Route
15+import Obelisk.Generated.Static
16+
9import Reflex.Dom.Core
17import Reflex.Dom.Core
10
18
11import Common.Api
19import Common.Api
12import Common.Route
20import Common.Route
13−import Obelisk.Generated.Static
14
21
15
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.
16frontend :: Frontend (R FrontendRoute)
26frontend :: Frontend (R FrontendRoute)
17frontend = Frontend
27frontend = Frontend
18− { _frontend_head = el "title" $ text "Obelisk Minimal Example"
28+ { _frontend_head = do
29+ el "title" $ text "Obelisk Minimal Example"
30+ elAttr "link" ("href" =: static @"main.css" <> "type" =: "text/css" <> "rel" =: "stylesheet") blank
19 , _frontend_body = do
31 , _frontend_body = do
20− text "Welcome to Obelisk!"
32+ el "h1" $ text "Welcome to Obelisk!"
21 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+
22 elAttr "img" ("src" =: static @"obelisk.jpg") blank
41 elAttr "img" ("src" =: static @"obelisk.jpg") blank
42+ el "div" $ do
43+ exampleConfig <- getConfig "common/example"
44+ case exampleConfig of
45+ Nothing -> text "No config file found in config/common/example"
46+ Just s -> text $ T.decodeUtf8 s
47+ return ()
23 }
48 }
skeleton/static/main.cssnew file+3
@@ -0,0 +1,3 @@
1+p {
2+ color: red;
3+}