on master help sign in
1175 files changed+8736−3815
since splitsnapshots
unifiedsplit
.github/pull_request_template.md+10 .gitignore+2−3 .hlint.yaml+65 CONTRIBUTING.md+125−3 ChangeLog.md+156 FAQ.md+117 LICENSE+30 README.md+152−109 acme.nix+430 all-builds.nix+113 all-tests.nix+145 default.nix+331−258 dep/.gitignore−4 dep/ghcid/default.nix+7 dep/ghcid/github.json+7 dep/gitignore.nix/default.nix+8 dep/gitignore.nix/github.json+8 dep/hnix/default.nix+7 dep/hnix/github.json+7 dep/reflex-platform/default.nix+1−6 dep/reflex-platform/github.json+4−3 dep/reflex-platform/thunk.nix+9 dep/snap-core/default.nix+8 dep/snap-core/github.json+8 docs/obelisk-logo-640.png guides/app-deploy/README.md+324 guides/app-deploy/assets/android-app.jpg guides/app-deploy/assets/android-confirm-usb-debugging.jpg guides/app-deploy/assets/app-deploy-2.png guides/app-deploy/assets/app-deploy.png guides/app-deploy/assets/ios-deploy-example.png guides/app-deploy/assets/ios-deploy-keychain.png guides/app-deploy/assets/ios-obelisk-app-icon.jpg guides/app-deploy/assets/ios-obelisk-app-open.jpg guides/app-deploy/assets/nano-edit-nixos-configuration.png guides/app-deploy/assets/virtualbox-appliance-import-loading.png guides/app-deploy/assets/virtualbox-appliance-import.png guides/app-deploy/assets/virtualbox-dashboard-nixos.png guides/app-deploy/assets/virtualbox-image-settings-network.png guides/app-deploy/assets/virtualbox-nioxs-after-boot.png guides/app-deploy/assets/xcode-devices.png haskell-overlays/ghcide.nix+40 haskell-overlays/misc-deps.nix+26 haskell-overlays/obelisk.nix+48 haskell-overlays/tighten-ob-exes.nix+32 jobsets.nix−66 lib/asset/README.md+17−20 lib/asset/assets.nix+28−5 lib/asset/manifest/obelisk-asset-manifest.cabal+5−2 lib/asset/manifest/src/Obelisk/Asset/Gather.hs+5−2 lib/asset/manifest/src/Obelisk/Asset/Promoted.hs+7−2 lib/asset/manifest/src/Obelisk/Asset/Symlink.hs+1−1 lib/asset/serve-snap/obelisk-asset-serve-snap.cabal+4−2 lib/asset/serve-snap/src/Obelisk/Asset/Accept.hs+6−6 lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+22−11 lib/backend/obelisk-backend.cabal+7−3 lib/backend/src/Obelisk/Backend.hs+196−50 lib/cliapp/obelisk-cliapp.cabal+8−3 lib/cliapp/src/Obelisk/CliApp.hs+24−5 lib/cliapp/src/Obelisk/CliApp/Demo.hs−49 lib/cliapp/src/Obelisk/CliApp/Logging.hs+102−40 lib/cliapp/src/Obelisk/CliApp/Process.hs+194−54 lib/cliapp/src/Obelisk/CliApp/Spinner.hs+22−28 lib/cliapp/src/Obelisk/CliApp/Theme.hs+29 lib/cliapp/src/Obelisk/CliApp/Types.hs+102−19 lib/command/obelisk-command.cabal+21−16 lib/command/src/Obelisk/App.hs+73−15 lib/command/src/Obelisk/Command.hs+272−255 lib/command/src/Obelisk/Command/Deploy.hs+241−99 lib/command/src/Obelisk/Command/Nix.hs+164−61 lib/command/src/Obelisk/Command/Preprocessor.hs+100 lib/command/src/Obelisk/Command/Project.hs+209−68 lib/command/src/Obelisk/Command/Run.hs+518−104 lib/command/src/Obelisk/Command/Thunk.hs+865−494 lib/command/src/Obelisk/Command/Upgrade.hs−293 lib/command/src/Obelisk/Command/Upgrade/Hash.hs−116 lib/command/src/Obelisk/Command/Utils.hs+197−18 lib/command/src/Obelisk/Command/VmBuilder.hs+67−38 lib/executable-config/default.nix+38−15 lib/executable-config/inject/obelisk-executable-config-inject.cabal+4−4 lib/executable-config/inject/src/Obelisk/ExecutableConfig/Inject.hs+15−41 lib/executable-config/lookup/default.nix−24 lib/executable-config/lookup/obelisk-executable-config-lookup.cabal+48 lib/executable-config/lookup/obelisk-executable-config.cabal−30 lib/executable-config/lookup/src-android/Obelisk/ExecutableConfig.hs−27 lib/executable-config/lookup/src-android/Obelisk/ExecutableConfig/Lookup.hs+60 lib/executable-config/lookup/src-ghcjs/Obelisk/ExecutableConfig.hs−17 lib/executable-config/lookup/src-ghcjs/Obelisk/ExecutableConfig/Lookup.hs+51 lib/executable-config/lookup/src-ios/Obelisk/ExecutableConfig.hs−22 lib/executable-config/lookup/src-ios/Obelisk/ExecutableConfig/Lookup.hs+17 lib/executable-config/lookup/src-other/Obelisk/ExecutableConfig/Lookup.hs+11 lib/executable-config/lookup/src/Obelisk/Configs.hs+148 lib/executable-config/lookup/src/Obelisk/Configs/Internal/Directory.hs+24 lib/executable-config/lookup/src/Obelisk/ExecutableConfig.hs−13 lib/frontend/obelisk-frontend.cabal+9−2 lib/frontend/src/Obelisk/Frontend.hs+188−104 lib/frontend/src/Obelisk/Frontend/Cookie.hs+103 lib/migration/obelisk-migration.cabal−24 lib/migration/src/Obelisk/Migration.hs−222 lib/route/README.md+6 lib/route/obelisk-route.cabal+11−4 lib/route/src/Obelisk/Route.hs+844−330 lib/route/src/Obelisk/Route/Frontend.hs+490−48 lib/route/src/Obelisk/Route/TH.hs+4−5 lib/run/obelisk-run.cabal+13−4 lib/run/src/Obelisk/Run.hs+135−64 lib/selftest/obelisk-selftest.cabal+7−3 lib/selftest/src/Obelisk/SelfTest.hs+517−195 lib/snap-extras/obelisk-snap-extras.cabal+2−3 lib/snap-extras/src/Obelisk/Snap/Extras.hs+2−2 lib/snap/obelisk-snap.cabal−40 lib/snap/src/Obelisk/Snap.hs−99 lib/tabulation/CHANGELOG.md+5 lib/tabulation/LICENSE+30 lib/tabulation/Setup.hs+2 lib/tabulation/src/Data/Tabulation.hs+21 lib/tabulation/tabulation.cabal+26 migration/001efbbe866b66eebc6ee1ea0a906f2d-b0c1d039514a686529561f186332c91e/obelisk-handoff migration/001efbbe866b66eebc6ee1ea0a906f2d-b0c1d039514a686529561f186332c91e/obelisk-upgrade migration/00a480749e96ef7e21fbe8f4943152b1-abdb013baf130e1bd7e7fd04e535c44c/obelisk-handoff migration/00a480749e96ef7e21fbe8f4943152b1-abdb013baf130e1bd7e7fd04e535c44c/obelisk-upgrade migration/00bee4377690b5040bd5b3702dce2a88-98629a336dcd5fa3524a09f8ea6ad636/obelisk-handoff migration/00bee4377690b5040bd5b3702dce2a88-98629a336dcd5fa3524a09f8ea6ad636/obelisk-upgrade migration/00c627540326314c7154cc209e8a71e9-67bfa5b784a35e66875fb74ad84a38c0/obelisk-handoff migration/00c627540326314c7154cc209e8a71e9-67bfa5b784a35e66875fb74ad84a38c0/obelisk-upgrade migration/01c0ee6c93a3f9f69e097c41169927ac-2913c440c7ad7731aae96e60a86bf7a8/obelisk-handoff migration/01c0ee6c93a3f9f69e097c41169927ac-2913c440c7ad7731aae96e60a86bf7a8/obelisk-upgrade migration/01ddc6354698efa1ae5822da3be562dc-a536d01b9c489f5e00e30abf27427da0/obelisk-handoff migration/01ddc6354698efa1ae5822da3be562dc-a536d01b9c489f5e00e30abf27427da0/obelisk-upgrade migration/01fb7610e4184ad1b491267fcb0c7f43-c0c1452986b8d4c181bb0c6c83c56a2f/obelisk-handoff migration/01fb7610e4184ad1b491267fcb0c7f43-c0c1452986b8d4c181bb0c6c83c56a2f/obelisk-upgrade migration/0298e61f6a03e553df08dcef03e27bd1-06d184d1fb27966294a8fee1c7df7cb6/obelisk-handoff migration/0298e61f6a03e553df08dcef03e27bd1-06d184d1fb27966294a8fee1c7df7cb6/obelisk-upgrade migration/02d0f8b5c7472e6f8a99ec2cfcb59807-5b6770965bbef440db49b0703cd243a3/obelisk-handoff migration/02d0f8b5c7472e6f8a99ec2cfcb59807-5b6770965bbef440db49b0703cd243a3/obelisk-upgrade migration/02f532fd8bb64a167a5349c2ba8e3331-1088e2464720e12067dd74683546b132/obelisk-handoff migration/02f532fd8bb64a167a5349c2ba8e3331-1088e2464720e12067dd74683546b132/obelisk-upgrade migration/02fb88dab35884e09deef1721c1cfc13-ae824b83b569b3b23b8e198190371ca0/obelisk-handoff migration/02fb88dab35884e09deef1721c1cfc13-ae824b83b569b3b23b8e198190371ca0/obelisk-upgrade migration/030ed18dacf3571cbb9e3e7d9d99627b-d37d70fe5d7d11e68b59ce12022281c9/obelisk-handoff migration/030ed18dacf3571cbb9e3e7d9d99627b-d37d70fe5d7d11e68b59ce12022281c9/obelisk-upgrade migration/03b845f308e73a1567eb843dfca182d2-e9ec84bfe7099b713c0fda32308f5815/obelisk-handoff migration/03b845f308e73a1567eb843dfca182d2-e9ec84bfe7099b713c0fda32308f5815/obelisk-upgrade migration/03b9747848d7f3e995b118f776ef96c7-3da702ef7f531ad6db874ac3f85e9c06/obelisk-handoff−1 migration/03b9747848d7f3e995b118f776ef96c7-3da702ef7f531ad6db874ac3f85e9c06/obelisk-upgrade migration/04a5ae41e8fcef5f719cb84d01430382-f391c6a74ee14217ce4565c278fceed6/obelisk-handoff migration/04a5ae41e8fcef5f719cb84d01430382-f391c6a74ee14217ce4565c278fceed6/obelisk-upgrade migration/04dd95ecb889ac1b0a616ddfeec781c4-f790ac9400501511b4ee045e22bc5fe1/obelisk-handoff migration/04dd95ecb889ac1b0a616ddfeec781c4-f790ac9400501511b4ee045e22bc5fe1/obelisk-upgrade migration/0535e06dd0d61f3e6970b491a17cf1f8-28a6ada033c86e5ae914cc31cecb6239/obelisk-handoff migration/0535e06dd0d61f3e6970b491a17cf1f8-28a6ada033c86e5ae914cc31cecb6239/obelisk-upgrade migration/053c0b2f84a7a2eadeb5c3f9575ffa0d-2600ab2ec96d3177d2a6b3462e09862d/obelisk-handoff migration/053c0b2f84a7a2eadeb5c3f9575ffa0d-2600ab2ec96d3177d2a6b3462e09862d/obelisk-upgrade migration/063665b78b6705e7de952f73fa9797bf-172e629829334d2b33cda8d3b5e0b148/obelisk-handoff migration/063665b78b6705e7de952f73fa9797bf-172e629829334d2b33cda8d3b5e0b148/obelisk-upgrade migration/06d184d1fb27966294a8fee1c7df7cb6-b1692927da5ed59af72fac5be8094fa2/obelisk-handoff migration/06d184d1fb27966294a8fee1c7df7cb6-b1692927da5ed59af72fac5be8094fa2/obelisk-upgrade migration/071f5b3326b8886de3eddc927b80eb10-28e25b7a8812869a709579cd34e7bcb4/obelisk-handoff migration/071f5b3326b8886de3eddc927b80eb10-28e25b7a8812869a709579cd34e7bcb4/obelisk-upgrade migration/07900e6c41ab9a78917f66fcf7e0d9b8-554c459ff2cced3e1b11241ed403890d/obelisk-handoff migration/07900e6c41ab9a78917f66fcf7e0d9b8-554c459ff2cced3e1b11241ed403890d/obelisk-upgrade migration/07900e6c41ab9a78917f66fcf7e0d9b8-8c84f81d9b09a5e0f028f3c6341ffb36/obelisk-handoff migration/07900e6c41ab9a78917f66fcf7e0d9b8-8c84f81d9b09a5e0f028f3c6341ffb36/obelisk-upgrade−15 migration/0804ef73b54a4dc7fbde18147f33b4f9-00bee4377690b5040bd5b3702dce2a88/obelisk-handoff migration/0804ef73b54a4dc7fbde18147f33b4f9-00bee4377690b5040bd5b3702dce2a88/obelisk-upgrade migration/08dbdf23867a8efa680283ad251d3429-f2a9ba4a93c3a04acbee2211bca9e27a/obelisk-handoff migration/08dbdf23867a8efa680283ad251d3429-f2a9ba4a93c3a04acbee2211bca9e27a/obelisk-upgrade migration/0abd9d31c77be8c9a9e83bf1f73276f6-fc42c5fc24031fc6a8836a10cfb45143/obelisk-handoff migration/0abd9d31c77be8c9a9e83bf1f73276f6-fc42c5fc24031fc6a8836a10cfb45143/obelisk-upgrade migration/0b2cab546a1526414096980fca85d0d3-99aebbfcac51725464bc59571b7d71b8/obelisk-handoff migration/0b2cab546a1526414096980fca85d0d3-99aebbfcac51725464bc59571b7d71b8/obelisk-upgrade migration/0c6127453069ad707e34ddfedb67e2f9-7c98ef4a123c1a580d368d14e54961b7/obelisk-handoff migration/0c6127453069ad707e34ddfedb67e2f9-7c98ef4a123c1a580d368d14e54961b7/obelisk-upgrade migration/0c9826e42d5d4fa9988c7db53722826e-c56de2f95c90def16704f62639246bbc/obelisk-handoff migration/0c9826e42d5d4fa9988c7db53722826e-c56de2f95c90def16704f62639246bbc/obelisk-upgrade migration/0c991bc3c06801f72df48486ee78e350-58479e482d3828ce44f2c8371ed9135a/obelisk-handoff migration/0c991bc3c06801f72df48486ee78e350-58479e482d3828ce44f2c8371ed9135a/obelisk-upgrade migration/0d3b4cfe9b4c72b830780a4c44942176-214979923f2d7e6278856493c1978fdc/obelisk-handoff migration/0d3b4cfe9b4c72b830780a4c44942176-214979923f2d7e6278856493c1978fdc/obelisk-upgrade migration/0da1150f0e9fe57d1fafbb6cabe24fa1-a632452cf9c5956becd1a40512472b43/obelisk-handoff migration/0da1150f0e9fe57d1fafbb6cabe24fa1-a632452cf9c5956becd1a40512472b43/obelisk-upgrade migration/0e4d0f0f0af0925474b0d772be2b145f-b82e9c3fe22feff4bb3a6be49943fd6c/obelisk-handoff migration/0e4d0f0f0af0925474b0d772be2b145f-b82e9c3fe22feff4bb3a6be49943fd6c/obelisk-upgrade migration/0ec6f67d94d3913cf3243d813238ec39-0804ef73b54a4dc7fbde18147f33b4f9/obelisk-handoff migration/0ec6f67d94d3913cf3243d813238ec39-0804ef73b54a4dc7fbde18147f33b4f9/obelisk-upgrade migration/0f78d9d6875933336bbf0c1c8888b73f-d1b3f5f5375558bf91d55c88547784b9/obelisk-handoff migration/0f78d9d6875933336bbf0c1c8888b73f-d1b3f5f5375558bf91d55c88547784b9/obelisk-upgrade migration/0fb3a912a8aaf5ef6f734a25f0bce7e2-cccf4140dc336263489bcf67c8c58f86/obelisk-handoff migration/0fb3a912a8aaf5ef6f734a25f0bce7e2-cccf4140dc336263489bcf67c8c58f86/obelisk-upgrade migration/0fba399e046852d4ecf8e1dad831a2f9-6620e6dc5622593e5f671127af9ade05/obelisk-handoff migration/0fba399e046852d4ecf8e1dad831a2f9-6620e6dc5622593e5f671127af9ade05/obelisk-upgrade migration/0fe60df438daa8a2cca5f2b569e361a5-2e3e85cc59aa31f24f18c027542c0510/obelisk-handoff migration/0fe60df438daa8a2cca5f2b569e361a5-2e3e85cc59aa31f24f18c027542c0510/obelisk-upgrade migration/1088e2464720e12067dd74683546b132-b2282679f6f63cec89d921c3dd512d1e/obelisk-handoff migration/1088e2464720e12067dd74683546b132-b2282679f6f63cec89d921c3dd512d1e/obelisk-upgrade migration/11a5917ea91e021f1fa541a2fe158c80-d8adb57b2f2266e128ebb6f6d7e65920/obelisk-handoff migration/11a5917ea91e021f1fa541a2fe158c80-d8adb57b2f2266e128ebb6f6d7e65920/obelisk-upgrade migration/11f38b38c2d38004bb8a9dbfe2ef3e4a-29d9b8b8ae9698888f3ea90b10ff5e92/obelisk-handoff migration/11f38b38c2d38004bb8a9dbfe2ef3e4a-29d9b8b8ae9698888f3ea90b10ff5e92/obelisk-upgrade migration/1269155fffe21926f3704d5077e04332-1a97559d049bf85cebb762b7e7b70db1/obelisk-handoff migration/1269155fffe21926f3704d5077e04332-1a97559d049bf85cebb762b7e7b70db1/obelisk-upgrade migration/12c8a24c34c2d8441f3181d179c2baab-bd6728737dffcc3505d30ada344e2f4b/obelisk-handoff migration/12c8a24c34c2d8441f3181d179c2baab-bd6728737dffcc3505d30ada344e2f4b/obelisk-upgrade migration/131e1d5cc8163ce9a174a8782be23fe7-e323ce1352e512109f1609276fb509b4/obelisk-handoff migration/131e1d5cc8163ce9a174a8782be23fe7-e323ce1352e512109f1609276fb509b4/obelisk-upgrade migration/13f6767460e94079cdfa6d5e1df79ecb-c106f9398d5c203a1a296b85c7411bf9/obelisk-handoff migration/13f6767460e94079cdfa6d5e1df79ecb-c106f9398d5c203a1a296b85c7411bf9/obelisk-upgrade migration/145650b66e83adf5bdb8261593076379-e2be519915794ef130249f2be7640382/obelisk-handoff migration/145650b66e83adf5bdb8261593076379-e2be519915794ef130249f2be7640382/obelisk-upgrade migration/14840816db4b5cfd5580ae099022604a-aaf979dd0121603a8b48127e1ea47c7d/obelisk-handoff migration/14840816db4b5cfd5580ae099022604a-aaf979dd0121603a8b48127e1ea47c7d/obelisk-upgrade migration/15f3f3f517b38664131b85da0594522f-9715967793be68dfd8c9a7d631f8d589/obelisk-handoff migration/15f3f3f517b38664131b85da0594522f-9715967793be68dfd8c9a7d631f8d589/obelisk-upgrade migration/1629d0d70e360df6b2280fac36d21e8a-a825fbb74e8d050a5ce10ec4c62b83f5/obelisk-handoff migration/1629d0d70e360df6b2280fac36d21e8a-a825fbb74e8d050a5ce10ec4c62b83f5/obelisk-upgrade migration/166c5f8e4a0f1dfd227b075a96237386-a5904e3a899e346fe2fe26314f69c075/obelisk-handoff migration/166c5f8e4a0f1dfd227b075a96237386-a5904e3a899e346fe2fe26314f69c075/obelisk-upgrade migration/16b24e1a12b93ea83d7656a09d5e3338-8a64ec5f2ee43d69607499f085560857/obelisk-handoff migration/16b24e1a12b93ea83d7656a09d5e3338-8a64ec5f2ee43d69607499f085560857/obelisk-upgrade migration/17089ea0edc0cf4b6f616936f8a06174-a34d758508a0a5d08bc10e76482c4d11/obelisk-handoff migration/17089ea0edc0cf4b6f616936f8a06174-a34d758508a0a5d08bc10e76482c4d11/obelisk-upgrade migration/172e629829334d2b33cda8d3b5e0b148-a808a04519bbf2874e41028ded9c180c/obelisk-handoff migration/172e629829334d2b33cda8d3b5e0b148-a808a04519bbf2874e41028ded9c180c/obelisk-upgrade migration/174fa1072ee767be39b7b01aecea5714-6566f0555737425bae9106d1a4a0a2dd/obelisk-handoff migration/174fa1072ee767be39b7b01aecea5714-6566f0555737425bae9106d1a4a0a2dd/obelisk-upgrade migration/1859cc62bb2f89f528bb2aa170c36e84-be5a7b436cef0ae35cb074700d5f0d00/obelisk-handoff migration/1859cc62bb2f89f528bb2aa170c36e84-be5a7b436cef0ae35cb074700d5f0d00/obelisk-upgrade migration/190460dabd2b9773c3fe81902d0c8a62-e7385c9eae2b807a483b73be4295b207/obelisk-handoff migration/190460dabd2b9773c3fe81902d0c8a62-e7385c9eae2b807a483b73be4295b207/obelisk-upgrade migration/1a08b154ae5f898992128e229090c4d8-4e95e2f8ef50420371b71022c644e25d/obelisk-handoff migration/1a08b154ae5f898992128e229090c4d8-4e95e2f8ef50420371b71022c644e25d/obelisk-upgrade migration/1a97559d049bf85cebb762b7e7b70db1-5cb98d0250bf5224b94e544a5140a54c/obelisk-handoff migration/1a97559d049bf85cebb762b7e7b70db1-5cb98d0250bf5224b94e544a5140a54c/obelisk-upgrade migration/1ada2d50d7847a12dbe29df4097b5bdc-11a5917ea91e021f1fa541a2fe158c80/obelisk-handoff migration/1ada2d50d7847a12dbe29df4097b5bdc-11a5917ea91e021f1fa541a2fe158c80/obelisk-upgrade migration/1b1686b03b41bd840ff46776cec7b33a-31a676fd9e1f69bd07380480ec879da0/obelisk-handoff migration/1b1686b03b41bd840ff46776cec7b33a-31a676fd9e1f69bd07380480ec879da0/obelisk-upgrade migration/1c1c3f2b4426d5d26377eef08dbccb3c-29abdd56a2dbbf3a2a0715210d441d06/obelisk-handoff migration/1c1c3f2b4426d5d26377eef08dbccb3c-29abdd56a2dbbf3a2a0715210d441d06/obelisk-upgrade migration/1c2c93819c07f33ad899e39ec6769c3c-909b6b2066cbdc991e6c16455f13637c/obelisk-handoff migration/1c2c93819c07f33ad899e39ec6769c3c-909b6b2066cbdc991e6c16455f13637c/obelisk-upgrade migration/1c4fc23cbf5653613c6060668e065f37-5b252c24612c2ba868580add9d9c19e3/obelisk-handoff migration/1c4fc23cbf5653613c6060668e065f37-5b252c24612c2ba868580add9d9c19e3/obelisk-upgrade migration/1c9bdb5c544f2e5432f549653a61dabe-20926beb4c30e2efa819d23e5694645e/obelisk-handoff migration/1c9bdb5c544f2e5432f549653a61dabe-20926beb4c30e2efa819d23e5694645e/obelisk-upgrade migration/1cc8d98f6f61441570fdde2d697e6e3c-69fafe6ab155ff215b6d9d330f700ba1/obelisk-handoff migration/1cc8d98f6f61441570fdde2d697e6e3c-69fafe6ab155ff215b6d9d330f700ba1/obelisk-upgrade migration/1d084e187591225f0e8fa6fa824f8863-02f532fd8bb64a167a5349c2ba8e3331/obelisk-handoff migration/1d084e187591225f0e8fa6fa824f8863-02f532fd8bb64a167a5349c2ba8e3331/obelisk-upgrade migration/1df871cede0758cabe43971d9091279d-0b2cab546a1526414096980fca85d0d3/obelisk-handoff migration/1df871cede0758cabe43971d9091279d-0b2cab546a1526414096980fca85d0d3/obelisk-upgrade migration/1e36dc8817e2784df36d643b7499092d-ba0ccd5ef6110f6c5133d9d6ea6277f0/obelisk-handoff migration/1e36dc8817e2784df36d643b7499092d-ba0ccd5ef6110f6c5133d9d6ea6277f0/obelisk-upgrade migration/1e376437f069662df26178e4a7873190-ca5ee8f372ecb07b09283081f0298733/obelisk-handoff migration/1e376437f069662df26178e4a7873190-ca5ee8f372ecb07b09283081f0298733/obelisk-upgrade migration/1f09fcf196bfe90ed52f113c38ffbfdb-d16784e9a2d93db7f953941e3003fa8c/obelisk-handoff migration/1f09fcf196bfe90ed52f113c38ffbfdb-d16784e9a2d93db7f953941e3003fa8c/obelisk-upgrade migration/1f5b6e2a19c87d3820b953f942ab4a27-8b098f49e1fd1aa10ca22b9dc312644e/obelisk-handoff migration/1f5b6e2a19c87d3820b953f942ab4a27-8b098f49e1fd1aa10ca22b9dc312644e/obelisk-upgrade migration/1f7fb90cb1e558f5285b2d19a25a1078-5a98cdb6c195e88beac878a3f311c5b5/obelisk-handoff migration/1f7fb90cb1e558f5285b2d19a25a1078-5a98cdb6c195e88beac878a3f311c5b5/obelisk-upgrade migration/1fe00204f9d2cd653ff2894eae3d9356-4b3f45ce8aeb17ef18d1d9502b74bb7e/obelisk-handoff migration/1fe00204f9d2cd653ff2894eae3d9356-4b3f45ce8aeb17ef18d1d9502b74bb7e/obelisk-upgrade migration/20926beb4c30e2efa819d23e5694645e-212ead9571b83b8164b3f18d2537d52b/obelisk-handoff migration/20926beb4c30e2efa819d23e5694645e-212ead9571b83b8164b3f18d2537d52b/obelisk-upgrade migration/212ead9571b83b8164b3f18d2537d52b-3bf8e28473fb05791c5790f8906e2609/obelisk-handoff migration/212ead9571b83b8164b3f18d2537d52b-3bf8e28473fb05791c5790f8906e2609/obelisk-upgrade migration/214979923f2d7e6278856493c1978fdc-13f6767460e94079cdfa6d5e1df79ecb/obelisk-handoff migration/214979923f2d7e6278856493c1978fdc-13f6767460e94079cdfa6d5e1df79ecb/obelisk-upgrade migration/215b6810b09f219a5cb3842aacc88432-2ef4f9cce6d15ae62d5112d3c224eb7a/obelisk-handoff migration/215b6810b09f219a5cb3842aacc88432-2ef4f9cce6d15ae62d5112d3c224eb7a/obelisk-upgrade migration/2164344be67da5d0e57052c15f30646d-0c9826e42d5d4fa9988c7db53722826e/obelisk-handoff migration/2164344be67da5d0e57052c15f30646d-0c9826e42d5d4fa9988c7db53722826e/obelisk-upgrade migration/237aeb7eee0ffed230234ee04e49569f-55cf43fb0d3868040c9efbf2f92d538a/obelisk-handoff migration/237aeb7eee0ffed230234ee04e49569f-55cf43fb0d3868040c9efbf2f92d538a/obelisk-upgrade migration/23af4d9671962484de53f537a0626d83-7ce32302cfbba8b7567a05144057f8a3/obelisk-handoff migration/23af4d9671962484de53f537a0626d83-7ce32302cfbba8b7567a05144057f8a3/obelisk-upgrade migration/24e0d027f4160a6478c1356e51f419cf-4e3e6e8b9d0f4194842e530438ff686f/obelisk-handoff migration/24e0d027f4160a6478c1356e51f419cf-4e3e6e8b9d0f4194842e530438ff686f/obelisk-upgrade migration/24f151a674662ac47845237d7a9f6a4f-4fe321cf196b9cd25210c35e09e09d8f/obelisk-handoff migration/24f151a674662ac47845237d7a9f6a4f-4fe321cf196b9cd25210c35e09e09d8f/obelisk-upgrade migration/2543866165016a449562ea7a1ee36f6f-1a08b154ae5f898992128e229090c4d8/obelisk-handoff migration/2543866165016a449562ea7a1ee36f6f-1a08b154ae5f898992128e229090c4d8/obelisk-upgrade migration/25615a274650370633e8083ed19fbdd0-80cb6b08443d55bb512e4a35b4768b72/obelisk-handoff migration/25615a274650370633e8083ed19fbdd0-80cb6b08443d55bb512e4a35b4768b72/obelisk-upgrade migration/2600ab2ec96d3177d2a6b3462e09862d-e2b2d878b0ba6eb653b194523bf0a0e0/obelisk-handoff migration/2600ab2ec96d3177d2a6b3462e09862d-e2b2d878b0ba6eb653b194523bf0a0e0/obelisk-upgrade migration/2619464637b85cb35376393fe612ddae-a8ebe201ab7a7b0211de41b14a95192e/obelisk-handoff migration/2619464637b85cb35376393fe612ddae-a8ebe201ab7a7b0211de41b14a95192e/obelisk-upgrade migration/26a2491fc8a9658751c1511c777a67bd-470df6504156dc940b8e7f89c148e619/obelisk-handoff migration/26a2491fc8a9658751c1511c777a67bd-470df6504156dc940b8e7f89c148e619/obelisk-upgrade migration/270b3b3f7bc510c692e3253a895f122a-c2d4eeb20f2b319a2d9dc5b6b0762f83/obelisk-handoff migration/270b3b3f7bc510c692e3253a895f122a-c2d4eeb20f2b319a2d9dc5b6b0762f83/obelisk-upgrade migration/2773d4a82ca59b48faf036755e163a5f-71c6959cf98e05d356ff798ada6db2b8/obelisk-handoff migration/2773d4a82ca59b48faf036755e163a5f-71c6959cf98e05d356ff798ada6db2b8/obelisk-upgrade migration/28a6ada033c86e5ae914cc31cecb6239-90b4e20464e08ade5f215f2a4ea28cc6/obelisk-handoff migration/28a6ada033c86e5ae914cc31cecb6239-90b4e20464e08ade5f215f2a4ea28cc6/obelisk-upgrade migration/28c5fec3b7b0b14b3625d5c8f60bcf68-4509e2a908da9e497fa67acacdd107b6/obelisk-handoff migration/28c5fec3b7b0b14b3625d5c8f60bcf68-4509e2a908da9e497fa67acacdd107b6/obelisk-upgrade migration/28e25b7a8812869a709579cd34e7bcb4-2543866165016a449562ea7a1ee36f6f/obelisk-handoff migration/28e25b7a8812869a709579cd34e7bcb4-2543866165016a449562ea7a1ee36f6f/obelisk-upgrade migration/2913c440c7ad7731aae96e60a86bf7a8-a08aebb6f40fb45d174b229532314ac4/obelisk-handoff migration/2913c440c7ad7731aae96e60a86bf7a8-a08aebb6f40fb45d174b229532314ac4/obelisk-upgrade migration/29abdd56a2dbbf3a2a0715210d441d06-51c7d001730ddd3d76e0c8bb57038773/obelisk-handoff migration/29abdd56a2dbbf3a2a0715210d441d06-51c7d001730ddd3d76e0c8bb57038773/obelisk-upgrade migration/29d9b8b8ae9698888f3ea90b10ff5e92-1ada2d50d7847a12dbe29df4097b5bdc/obelisk-handoff migration/29d9b8b8ae9698888f3ea90b10ff5e92-1ada2d50d7847a12dbe29df4097b5bdc/obelisk-upgrade migration/29fd07af89cc31526fca00226ff52a82-50b85e79010ad50ee275eaeba0df6f8d/obelisk-handoff migration/29fd07af89cc31526fca00226ff52a82-50b85e79010ad50ee275eaeba0df6f8d/obelisk-upgrade migration/2ba356b187db8db13b8aa40f43ca025f-3c1fc501da00f467c9a48a1ddee2c2b0/obelisk-handoff migration/2ba356b187db8db13b8aa40f43ca025f-3c1fc501da00f467c9a48a1ddee2c2b0/obelisk-upgrade migration/2bdd4221307cafa3e98c4d3017cdc912-5f6fe243beb9fcc0c4117536022fc14c/obelisk-handoff migration/2bdd4221307cafa3e98c4d3017cdc912-5f6fe243beb9fcc0c4117536022fc14c/obelisk-upgrade migration/2c1521e5a5be64e6d28a9fdae950cd76-92ab733e8991f12cc12148f8d4e1b35d/obelisk-handoff migration/2c1521e5a5be64e6d28a9fdae950cd76-92ab733e8991f12cc12148f8d4e1b35d/obelisk-upgrade migration/2ccf977797628dc3b1c002927fedc7a8-46f9c6c66e2bd8980402b6117ca40965/obelisk-handoff migration/2ccf977797628dc3b1c002927fedc7a8-46f9c6c66e2bd8980402b6117ca40965/obelisk-upgrade migration/2df092178e167b474dd08dfa46ec3a49-9c94cd459a25b5c2de56067c8fdac620/obelisk-handoff migration/2df092178e167b474dd08dfa46ec3a49-9c94cd459a25b5c2de56067c8fdac620/obelisk-upgrade migration/2e3e85cc59aa31f24f18c027542c0510-47357c6c23f049241902bf2e2e686ac8/obelisk-handoff migration/2e3e85cc59aa31f24f18c027542c0510-47357c6c23f049241902bf2e2e686ac8/obelisk-upgrade migration/2e7cdc2bea08bb2358219ddefef372e0-a00870cfca85ff8dae5db3a78f5a227d/obelisk-handoff migration/2e7cdc2bea08bb2358219ddefef372e0-a00870cfca85ff8dae5db3a78f5a227d/obelisk-upgrade migration/2e9a04a228106f62128ea5bd19d6b25e-947784563e3a27cf6486bed9a3c52f15/obelisk-handoff migration/2e9a04a228106f62128ea5bd19d6b25e-947784563e3a27cf6486bed9a3c52f15/obelisk-upgrade migration/2eb907820012f77e60350430d89631fe-494be5819cd601fd2f0c20e1b23b84a3/obelisk-handoff migration/2eb907820012f77e60350430d89631fe-494be5819cd601fd2f0c20e1b23b84a3/obelisk-upgrade migration/2ef4f9cce6d15ae62d5112d3c224eb7a-a080b8549e32f21fec11084f4ab1e052/obelisk-handoff migration/2ef4f9cce6d15ae62d5112d3c224eb7a-a080b8549e32f21fec11084f4ab1e052/obelisk-upgrade migration/2f3ecb5cdb0ab839a49271d91dd7852a-f9ad863c0bebc103f8b81afdf82e6293/obelisk-handoff migration/2f3ecb5cdb0ab839a49271d91dd7852a-f9ad863c0bebc103f8b81afdf82e6293/obelisk-upgrade migration/2f928f9c4a137186f808a231c9e3c141-9e61f37dd79310b71c80ee166aeb4e80/obelisk-handoff migration/2f928f9c4a137186f808a231c9e3c141-9e61f37dd79310b71c80ee166aeb4e80/obelisk-upgrade migration/315cd79f97dae2f3669551dc03e0fd27-c801cbcf925c0a7b084ef152e3c08f8e/obelisk-handoff migration/315cd79f97dae2f3669551dc03e0fd27-c801cbcf925c0a7b084ef152e3c08f8e/obelisk-upgrade migration/31a676fd9e1f69bd07380480ec879da0-9223532a537f698ef36f4dce6e922a6b/obelisk-handoff migration/31a676fd9e1f69bd07380480ec879da0-9223532a537f698ef36f4dce6e922a6b/obelisk-upgrade migration/338b92f88c49c7c3a1d8ec231d9f7189-a4477746ae1a7024bc3cd0807180d418/obelisk-handoff migration/338b92f88c49c7c3a1d8ec231d9f7189-a4477746ae1a7024bc3cd0807180d418/obelisk-upgrade migration/33da5c0e6705843afa6e39e65bfa0564-3ec562b7333839d48e9523aec595f3ab/obelisk-handoff migration/33da5c0e6705843afa6e39e65bfa0564-3ec562b7333839d48e9523aec595f3ab/obelisk-upgrade migration/34d14d4a444d3bf1487ada6129815df4-afbd010add526d309dccee6895e42d0d/obelisk-handoff migration/34d14d4a444d3bf1487ada6129815df4-afbd010add526d309dccee6895e42d0d/obelisk-upgrade migration/35acc1e0c4d9c02d60abd116f3df84ee-ffa62158ed6fdece012980e4ad25e6ac/obelisk-handoff migration/35acc1e0c4d9c02d60abd116f3df84ee-ffa62158ed6fdece012980e4ad25e6ac/obelisk-upgrade migration/367616bd36eda757f251a5e8e9096acc-ddaa8e0e42a1ef00154d580a390c9f17/obelisk-handoff migration/367616bd36eda757f251a5e8e9096acc-ddaa8e0e42a1ef00154d580a390c9f17/obelisk-upgrade migration/36cdb1c744c3036c2932f01d5fadd9f5-e7b566495114e160f1f4d722b7ed8174/obelisk-handoff migration/36cdb1c744c3036c2932f01d5fadd9f5-e7b566495114e160f1f4d722b7ed8174/obelisk-upgrade migration/375acf7f2a3b3c487da2a6b30735d74d-3b614d291e262d0f281b54ff42a6bb66/obelisk-handoff migration/375acf7f2a3b3c487da2a6b30735d74d-3b614d291e262d0f281b54ff42a6bb66/obelisk-upgrade migration/37c2ed0ba2cd54c0ec29eae9043bc4c8-190460dabd2b9773c3fe81902d0c8a62/obelisk-handoff migration/37c2ed0ba2cd54c0ec29eae9043bc4c8-190460dabd2b9773c3fe81902d0c8a62/obelisk-upgrade migration/388d7d29a65c1713e07a654e91eb9caf-b6ffce85249f30616da76334c7bbec6e/obelisk-handoff migration/388d7d29a65c1713e07a654e91eb9caf-b6ffce85249f30616da76334c7bbec6e/obelisk-upgrade migration/39df6544d6b035d4c77cc829729f9c19-9f6c8fd80ab3ff2dcc48bfd211c8b761/obelisk-handoff migration/39df6544d6b035d4c77cc829729f9c19-9f6c8fd80ab3ff2dcc48bfd211c8b761/obelisk-upgrade migration/3a207630aa67e5df48d2b87d34db616b-8adb921f4dbb9d363bf6647d304e02fe/obelisk-handoff migration/3a207630aa67e5df48d2b87d34db616b-8adb921f4dbb9d363bf6647d304e02fe/obelisk-upgrade migration/3b614d291e262d0f281b54ff42a6bb66-2e9a04a228106f62128ea5bd19d6b25e/obelisk-handoff migration/3b614d291e262d0f281b54ff42a6bb66-2e9a04a228106f62128ea5bd19d6b25e/obelisk-upgrade migration/3bc53f3a28cb8f403cc41c11a37eec5d-cd86427cc2d5b2e931d7ab03deb19d20/obelisk-handoff migration/3bc53f3a28cb8f403cc41c11a37eec5d-cd86427cc2d5b2e931d7ab03deb19d20/obelisk-upgrade migration/3bf8e28473fb05791c5790f8906e2609-45185a6f053557f93a13cb8cd03963a7/obelisk-handoff migration/3bf8e28473fb05791c5790f8906e2609-45185a6f053557f93a13cb8cd03963a7/obelisk-upgrade migration/3c1fc501da00f467c9a48a1ddee2c2b0-cd5b54d21dd0fb868f48624d41021f47/obelisk-handoff migration/3c1fc501da00f467c9a48a1ddee2c2b0-cd5b54d21dd0fb868f48624d41021f47/obelisk-upgrade migration/3c4b3152f0608d23d07240e2df3ff8da-c6baede3962454713b73acefcc92fe75/obelisk-handoff migration/3c4b3152f0608d23d07240e2df3ff8da-c6baede3962454713b73acefcc92fe75/obelisk-upgrade migration/3c7755e495f20cfac5e4dabe78644c5a-51e25cf740f064faa0a29b8e2afcc109/obelisk-handoff migration/3c7755e495f20cfac5e4dabe78644c5a-51e25cf740f064faa0a29b8e2afcc109/obelisk-upgrade migration/3c80eccfe80d0abd36b07bb11e69fc7a-b4f6596f2c16811442d8bb2961fbb721/obelisk-handoff migration/3c80eccfe80d0abd36b07bb11e69fc7a-b4f6596f2c16811442d8bb2961fbb721/obelisk-upgrade migration/3cb52c2838303a362e9efb7c7eea37bd-aeafaa5d20bab4439a5d31f29023a839/obelisk-handoff migration/3cb52c2838303a362e9efb7c7eea37bd-aeafaa5d20bab4439a5d31f29023a839/obelisk-upgrade migration/3da702ef7f531ad6db874ac3f85e9c06-73bcf3ed6593d074bd097cd43f5145d1/obelisk-handoff migration/3da702ef7f531ad6db874ac3f85e9c06-73bcf3ed6593d074bd097cd43f5145d1/obelisk-upgrade migration/3da7d4a3b507d18097a90becf4dde9aa-e1ef432db54d9a6daa9bdeeb543262ae/obelisk-handoff migration/3da7d4a3b507d18097a90becf4dde9aa-e1ef432db54d9a6daa9bdeeb543262ae/obelisk-upgrade migration/3daecb03985f83d8af466a9e0541782b-a2665cfd303a4a34a7bfa3b7d0d264bb/obelisk-handoff migration/3daecb03985f83d8af466a9e0541782b-a2665cfd303a4a34a7bfa3b7d0d264bb/obelisk-upgrade migration/3e253c6beb567ba8f4c8086a76b70645-d6cacd7f4fab95c4b6aa2d6c1a4ad2a0/obelisk-handoff migration/3e253c6beb567ba8f4c8086a76b70645-d6cacd7f4fab95c4b6aa2d6c1a4ad2a0/obelisk-upgrade migration/3e763ebe16cc3a261f5776ab1f1f6d9a-583ec22b9af66e8f629ee404307eb2dc/obelisk-handoff migration/3e763ebe16cc3a261f5776ab1f1f6d9a-583ec22b9af66e8f629ee404307eb2dc/obelisk-upgrade migration/3e8a6968585d3d60f3b13652a386aec0-c118e1ee09ec8d9aa3edf04e211ae035/obelisk-handoff migration/3e8a6968585d3d60f3b13652a386aec0-c118e1ee09ec8d9aa3edf04e211ae035/obelisk-upgrade migration/3ec562b7333839d48e9523aec595f3ab-7b9c28d09bd962e89b9715500f9e184c/obelisk-handoff migration/3ec562b7333839d48e9523aec595f3ab-7b9c28d09bd962e89b9715500f9e184c/obelisk-upgrade migration/3f0687592a77c0c66193652e9cd981fd-fb81153791e49cd00850e91ff7418018/obelisk-handoff migration/3f0687592a77c0c66193652e9cd981fd-fb81153791e49cd00850e91ff7418018/obelisk-upgrade migration/3f23549fba6f8e67ba36b4405e8680b3-a6633fc9687566aa84c3d5d5e2bff4fd/obelisk-handoff migration/3f23549fba6f8e67ba36b4405e8680b3-a6633fc9687566aa84c3d5d5e2bff4fd/obelisk-upgrade migration/41e3ba178b727517aa1cedc8815abe86-1d084e187591225f0e8fa6fa824f8863/obelisk-handoff migration/41e3ba178b727517aa1cedc8815abe86-1d084e187591225f0e8fa6fa824f8863/obelisk-upgrade migration/4205857df2e234a476ad56f84a33e6ed-db327f87e60d4e59bdbfd482e5abe985/obelisk-handoff migration/4205857df2e234a476ad56f84a33e6ed-db327f87e60d4e59bdbfd482e5abe985/obelisk-upgrade migration/423088b98df50b986c9197af83c42a25-3a207630aa67e5df48d2b87d34db616b/obelisk-handoff migration/423088b98df50b986c9197af83c42a25-3a207630aa67e5df48d2b87d34db616b/obelisk-upgrade migration/42357310c09e345f9360259c6c4102f2-ae8862f8b7292690c852111ca5659ce9/obelisk-handoff migration/42357310c09e345f9360259c6c4102f2-ae8862f8b7292690c852111ca5659ce9/obelisk-upgrade migration/4344c1bd0ef04ebc055d5252f58b0bef-2f3ecb5cdb0ab839a49271d91dd7852a/obelisk-handoff migration/4344c1bd0ef04ebc055d5252f58b0bef-2f3ecb5cdb0ab839a49271d91dd7852a/obelisk-upgrade migration/4509e2a908da9e497fa67acacdd107b6-1fe00204f9d2cd653ff2894eae3d9356/obelisk-handoff migration/4509e2a908da9e497fa67acacdd107b6-1fe00204f9d2cd653ff2894eae3d9356/obelisk-upgrade migration/45185a6f053557f93a13cb8cd03963a7-cffcc6cab6080a35b7bf7c5c7facd6bc/obelisk-handoff migration/45185a6f053557f93a13cb8cd03963a7-cffcc6cab6080a35b7bf7c5c7facd6bc/obelisk-upgrade migration/455279b6974b96a673613cd0ccc8ed54-b3ff195b0a90ef5900f9cef2ba75f2fe/obelisk-handoff migration/455279b6974b96a673613cd0ccc8ed54-b3ff195b0a90ef5900f9cef2ba75f2fe/obelisk-upgrade migration/463646ba21b356f612539ea34178adf9-b3b107d406a6a7675cd5b9f52e5f7d8e/obelisk-handoff migration/463646ba21b356f612539ea34178adf9-b3b107d406a6a7675cd5b9f52e5f7d8e/obelisk-upgrade migration/466a19f9cfa2a103467fe6627225d27f-c67f206b6d2626eb6d36b00122b52784/obelisk-handoff migration/466a19f9cfa2a103467fe6627225d27f-c67f206b6d2626eb6d36b00122b52784/obelisk-upgrade migration/469a31d20d69da72e6a3a3ea2bb02f9d-75c9cd9763d0ed89c17d455f49d66a4f/obelisk-handoff migration/469a31d20d69da72e6a3a3ea2bb02f9d-75c9cd9763d0ed89c17d455f49d66a4f/obelisk-upgrade migration/46aed07c1a61476dd245ff8e74c0559f-73e2573d9074884d7ae83106d55ad229/obelisk-handoff migration/46aed07c1a61476dd245ff8e74c0559f-73e2573d9074884d7ae83106d55ad229/obelisk-upgrade migration/46f9c6c66e2bd8980402b6117ca40965-463646ba21b356f612539ea34178adf9/obelisk-handoff migration/46f9c6c66e2bd8980402b6117ca40965-463646ba21b356f612539ea34178adf9/obelisk-upgrade migration/470df6504156dc940b8e7f89c148e619-a5297d8457aa4c327f35d4697f6cb66f/obelisk-handoff migration/470df6504156dc940b8e7f89c148e619-a5297d8457aa4c327f35d4697f6cb66f/obelisk-upgrade migration/47357c6c23f049241902bf2e2e686ac8-d62d6d443d9c2261b7e09664398aa005/obelisk-handoff migration/47357c6c23f049241902bf2e2e686ac8-d62d6d443d9c2261b7e09664398aa005/obelisk-upgrade migration/475f9a0d63e84e9cf13b8be3986cb603-b95c8d049256fb7360ca14b12acd8544/obelisk-handoff migration/475f9a0d63e84e9cf13b8be3986cb603-b95c8d049256fb7360ca14b12acd8544/obelisk-upgrade migration/477a0bb12b48357d1e2b415c91d904e3-486d5218951605d14ec4a1046d3fe83e/obelisk-handoff migration/477a0bb12b48357d1e2b415c91d904e3-486d5218951605d14ec4a1046d3fe83e/obelisk-upgrade migration/486d5218951605d14ec4a1046d3fe83e-90489c1a9f7edd46a070d6474dceac86/obelisk-handoff migration/486d5218951605d14ec4a1046d3fe83e-90489c1a9f7edd46a070d6474dceac86/obelisk-upgrade migration/48c027da19d895ba03e7b9120f771291-29fd07af89cc31526fca00226ff52a82/obelisk-handoff migration/48c027da19d895ba03e7b9120f771291-29fd07af89cc31526fca00226ff52a82/obelisk-upgrade migration/494be5819cd601fd2f0c20e1b23b84a3-c66bc5ba27dec52d144ceb0aa429e449/obelisk-handoff migration/494be5819cd601fd2f0c20e1b23b84a3-c66bc5ba27dec52d144ceb0aa429e449/obelisk-upgrade migration/4a037879b8a542f1590cbb87b0242331-4344c1bd0ef04ebc055d5252f58b0bef/obelisk-handoff migration/4a037879b8a542f1590cbb87b0242331-4344c1bd0ef04ebc055d5252f58b0bef/obelisk-upgrade migration/4ab915b764f38a1b0b4ae6f619f5c3fa-59e4a192c611a2a9f6736afde9fe1a0e/obelisk-handoff migration/4ab915b764f38a1b0b4ae6f619f5c3fa-59e4a192c611a2a9f6736afde9fe1a0e/obelisk-upgrade migration/4ace4414d71235a291f7148f80a0b0f5-9705509619667aacf799e91927c16dc8/obelisk-handoff migration/4ace4414d71235a291f7148f80a0b0f5-9705509619667aacf799e91927c16dc8/obelisk-upgrade migration/4aefa80392582ec03a19f946e752d331-cb98f93880e6dea74014976977d6eb93/obelisk-handoff migration/4aefa80392582ec03a19f946e752d331-cb98f93880e6dea74014976977d6eb93/obelisk-upgrade migration/4b3f45ce8aeb17ef18d1d9502b74bb7e-4efbe4a73c260cca09fed7169e82a7ff/obelisk-handoff migration/4b3f45ce8aeb17ef18d1d9502b74bb7e-4efbe4a73c260cca09fed7169e82a7ff/obelisk-upgrade migration/4b7a36dce2c1cf94554e12d8a7903269-dd6ca52a58ea6cda7b3eaa2e87bb13d9/obelisk-handoff migration/4b7a36dce2c1cf94554e12d8a7903269-dd6ca52a58ea6cda7b3eaa2e87bb13d9/obelisk-upgrade migration/4c9372bf9aa6ebed1ea20abf3dbb0075-b641dd9c5359201200e483a784456cc2/obelisk-handoff migration/4c9372bf9aa6ebed1ea20abf3dbb0075-b641dd9c5359201200e483a784456cc2/obelisk-upgrade migration/4d6197d8166de78f882376102e36300b-4205857df2e234a476ad56f84a33e6ed/obelisk-handoff migration/4d6197d8166de78f882376102e36300b-4205857df2e234a476ad56f84a33e6ed/obelisk-upgrade migration/4d85ee8cdb0db20a5662b09567a2bbe7-b6425c7661af2116b912a558e9548013/obelisk-handoff migration/4d85ee8cdb0db20a5662b09567a2bbe7-b6425c7661af2116b912a558e9548013/obelisk-upgrade migration/4da182e21be35feeee484dc85be7a075-14840816db4b5cfd5580ae099022604a/obelisk-handoff migration/4da182e21be35feeee484dc85be7a075-14840816db4b5cfd5580ae099022604a/obelisk-upgrade migration/4db97ca86399c557e5ee0d04d0838acc-c203adc5fed9bf79f67df43d72a4631a/obelisk-handoff migration/4db97ca86399c557e5ee0d04d0838acc-c203adc5fed9bf79f67df43d72a4631a/obelisk-upgrade migration/4e3e6e8b9d0f4194842e530438ff686f-b7e30314f9d0e69efdc84c7eb4e3bcc3/obelisk-handoff migration/4e3e6e8b9d0f4194842e530438ff686f-b7e30314f9d0e69efdc84c7eb4e3bcc3/obelisk-upgrade migration/4e95e2f8ef50420371b71022c644e25d-8df9e256d8e43fa4e22d953024269b5b/obelisk-handoff migration/4e95e2f8ef50420371b71022c644e25d-8df9e256d8e43fa4e22d953024269b5b/obelisk-upgrade migration/4efbe4a73c260cca09fed7169e82a7ff-315cd79f97dae2f3669551dc03e0fd27/obelisk-handoff migration/4efbe4a73c260cca09fed7169e82a7ff-315cd79f97dae2f3669551dc03e0fd27/obelisk-upgrade migration/4fe321cf196b9cd25210c35e09e09d8f-56d7fd24c8a996e49bb26dd797819897/obelisk-handoff migration/4fe321cf196b9cd25210c35e09e09d8f-56d7fd24c8a996e49bb26dd797819897/obelisk-upgrade migration/4ff5bf819ea43a638abbcfa071bbf3ef-975cd8245d06ad09e4fb176cfc9af5e0/obelisk-handoff migration/4ff5bf819ea43a638abbcfa071bbf3ef-975cd8245d06ad09e4fb176cfc9af5e0/obelisk-upgrade migration/50b85e79010ad50ee275eaeba0df6f8d-e327773e1525eaa1eb2112dff8f41b26/obelisk-handoff migration/50b85e79010ad50ee275eaeba0df6f8d-e327773e1525eaa1eb2112dff8f41b26/obelisk-upgrade migration/51c7d001730ddd3d76e0c8bb57038773-423088b98df50b986c9197af83c42a25/obelisk-handoff migration/51c7d001730ddd3d76e0c8bb57038773-423088b98df50b986c9197af83c42a25/obelisk-upgrade migration/51e25cf740f064faa0a29b8e2afcc109-7bc4c944b24621967a6334f522437cc1/obelisk-handoff migration/51e25cf740f064faa0a29b8e2afcc109-7bc4c944b24621967a6334f522437cc1/obelisk-upgrade migration/51f3d5068259f596b811450f0bf25419-f9716ad47c84e0b7ac7d426e8ad059f3/obelisk-handoff migration/51f3d5068259f596b811450f0bf25419-f9716ad47c84e0b7ac7d426e8ad059f3/obelisk-upgrade migration/52330622ae996023b3f80a40991521a4-1df871cede0758cabe43971d9091279d/obelisk-handoff migration/52330622ae996023b3f80a40991521a4-1df871cede0758cabe43971d9091279d/obelisk-upgrade migration/52df183d0f32d5a1e9ebe276b6d83d37-08dbdf23867a8efa680283ad251d3429/obelisk-handoff migration/52df183d0f32d5a1e9ebe276b6d83d37-08dbdf23867a8efa680283ad251d3429/obelisk-upgrade migration/53d29061537ddaf7530aef88624ab266-9fe2922674fcee5e840c9f52cf534f88/obelisk-handoff migration/53d29061537ddaf7530aef88624ab266-9fe2922674fcee5e840c9f52cf534f88/obelisk-upgrade migration/53fdf819333b86dfb485bf16a8f28db2-93fc625d41bae9fcf06b9febeacb686d/obelisk-handoff migration/53fdf819333b86dfb485bf16a8f28db2-93fc625d41bae9fcf06b9febeacb686d/obelisk-upgrade migration/554c459ff2cced3e1b11241ed403890d-3543ea607791bc2e19419d22918823bd/obelisk-handoff migration/554c459ff2cced3e1b11241ed403890d-3543ea607791bc2e19419d22918823bd/obelisk-upgrade migration/554c459ff2cced3e1b11241ed403890d-6a18939264224d6ce24c7426249edfea/obelisk-handoff migration/554c459ff2cced3e1b11241ed403890d-6a18939264224d6ce24c7426249edfea/obelisk-upgrade migration/55cf43fb0d3868040c9efbf2f92d538a-e2706f337218a12a3bdddd18fa3f4cfd/obelisk-handoff migration/55cf43fb0d3868040c9efbf2f92d538a-e2706f337218a12a3bdddd18fa3f4cfd/obelisk-upgrade migration/55d9c5eb3b86c9cb27966f849b2d32cf-0e4d0f0f0af0925474b0d772be2b145f/obelisk-handoff migration/55d9c5eb3b86c9cb27966f849b2d32cf-0e4d0f0f0af0925474b0d772be2b145f/obelisk-upgrade migration/5631293b75143d170b8fca5579e15fee-0abd9d31c77be8c9a9e83bf1f73276f6/obelisk-handoff migration/5631293b75143d170b8fca5579e15fee-0abd9d31c77be8c9a9e83bf1f73276f6/obelisk-upgrade migration/569227e5e7754c1890022850fd552292-ff1105290f89350bc9deb6eb907e0a53/obelisk-handoff migration/569227e5e7754c1890022850fd552292-ff1105290f89350bc9deb6eb907e0a53/obelisk-upgrade migration/56d7fd24c8a996e49bb26dd797819897-61f734d4c59e46f03e92d2b86299c7c9/obelisk-handoff migration/56d7fd24c8a996e49bb26dd797819897-61f734d4c59e46f03e92d2b86299c7c9/obelisk-upgrade migration/5734398c41e4eb5bb58d933ed2e12041-fb374b0721716a1e849e64daf6da73c4/obelisk-handoff migration/5734398c41e4eb5bb58d933ed2e12041-fb374b0721716a1e849e64daf6da73c4/obelisk-upgrade migration/58391ba73c13d922e8a12116b28caad2-215b6810b09f219a5cb3842aacc88432/obelisk-handoff migration/58391ba73c13d922e8a12116b28caad2-215b6810b09f219a5cb3842aacc88432/obelisk-upgrade migration/583ec22b9af66e8f629ee404307eb2dc-6c7f4af3693c31e1a2c6a2c3f189ddf5/obelisk-handoff migration/583ec22b9af66e8f629ee404307eb2dc-6c7f4af3693c31e1a2c6a2c3f189ddf5/obelisk-upgrade migration/58479e482d3828ce44f2c8371ed9135a-174fa1072ee767be39b7b01aecea5714/obelisk-handoff migration/58479e482d3828ce44f2c8371ed9135a-174fa1072ee767be39b7b01aecea5714/obelisk-upgrade migration/589eb89cdb09655c5edde4cd2a4deb80-c5a306045ad998f906f80748fe18487f/obelisk-handoff migration/589eb89cdb09655c5edde4cd2a4deb80-c5a306045ad998f906f80748fe18487f/obelisk-upgrade migration/58f9d23d2cede2081dc6f6cfa2283f60-41e3ba178b727517aa1cedc8815abe86/obelisk-handoff migration/58f9d23d2cede2081dc6f6cfa2283f60-41e3ba178b727517aa1cedc8815abe86/obelisk-upgrade migration/59742705e53838ae13066a2239a72040-95955d1dd0981ebb538ee941cde1f963/obelisk-handoff migration/59742705e53838ae13066a2239a72040-95955d1dd0981ebb538ee941cde1f963/obelisk-upgrade migration/59e4a192c611a2a9f6736afde9fe1a0e-8143888349912db9780231c370ea2060/obelisk-handoff migration/59e4a192c611a2a9f6736afde9fe1a0e-8143888349912db9780231c370ea2060/obelisk-upgrade migration/5a98cdb6c195e88beac878a3f311c5b5-66d79b4c393877a72aec18f227049207/obelisk-handoff migration/5a98cdb6c195e88beac878a3f311c5b5-66d79b4c393877a72aec18f227049207/obelisk-upgrade migration/5b252c24612c2ba868580add9d9c19e3-6f104c322bbaff565981739406290402/obelisk-handoff migration/5b252c24612c2ba868580add9d9c19e3-6f104c322bbaff565981739406290402/obelisk-upgrade migration/5b6770965bbef440db49b0703cd243a3-11f38b38c2d38004bb8a9dbfe2ef3e4a/obelisk-handoff migration/5b6770965bbef440db49b0703cd243a3-11f38b38c2d38004bb8a9dbfe2ef3e4a/obelisk-upgrade migration/5cb98d0250bf5224b94e544a5140a54c-fa18f7522903a21b615dbee24c26bfbe/obelisk-handoff migration/5cb98d0250bf5224b94e544a5140a54c-fa18f7522903a21b615dbee24c26bfbe/obelisk-upgrade migration/5d90abd974b4ec53091a8cb3fc2258ce-d40e0e3051a76c4c198cc11c2e8e4b7c/obelisk-handoff migration/5d90abd974b4ec53091a8cb3fc2258ce-d40e0e3051a76c4c198cc11c2e8e4b7c/obelisk-upgrade migration/5f0d3f7480d67df7deebdb880726b356-4ab915b764f38a1b0b4ae6f619f5c3fa/obelisk-handoff migration/5f0d3f7480d67df7deebdb880726b356-4ab915b764f38a1b0b4ae6f619f5c3fa/obelisk-upgrade migration/5f307639ccf6a64309166bfe58037397-702c65f35bc47641d60580d636ede330/obelisk-handoff migration/5f307639ccf6a64309166bfe58037397-702c65f35bc47641d60580d636ede330/obelisk-upgrade migration/5f6fe243beb9fcc0c4117536022fc14c-f41b690c74938e347cf042cee2d4fc72/obelisk-handoff migration/5f6fe243beb9fcc0c4117536022fc14c-f41b690c74938e347cf042cee2d4fc72/obelisk-upgrade migration/6095bdaccd933d319c84cde7983e2d10-477a0bb12b48357d1e2b415c91d904e3/obelisk-handoff migration/6095bdaccd933d319c84cde7983e2d10-477a0bb12b48357d1e2b415c91d904e3/obelisk-upgrade migration/610dcf99f7eb8c8b591ff3f5f1722938-131e1d5cc8163ce9a174a8782be23fe7/obelisk-handoff migration/610dcf99f7eb8c8b591ff3f5f1722938-131e1d5cc8163ce9a174a8782be23fe7/obelisk-upgrade migration/61f734d4c59e46f03e92d2b86299c7c9-02d0f8b5c7472e6f8a99ec2cfcb59807/obelisk-handoff migration/61f734d4c59e46f03e92d2b86299c7c9-02d0f8b5c7472e6f8a99ec2cfcb59807/obelisk-upgrade migration/63422a9bade5c703461b600e03e227f0-01ddc6354698efa1ae5822da3be562dc/obelisk-handoff migration/63422a9bade5c703461b600e03e227f0-01ddc6354698efa1ae5822da3be562dc/obelisk-upgrade migration/63ff9426130baa080f37400a86c55fdd-569227e5e7754c1890022850fd552292/obelisk-handoff migration/63ff9426130baa080f37400a86c55fdd-569227e5e7754c1890022850fd552292/obelisk-upgrade migration/64ee9e40f4943e0122398e48019f5616-cd38e239c47fb92fabd867b7f86fc99a/obelisk-handoff migration/64ee9e40f4943e0122398e48019f5616-cd38e239c47fb92fabd867b7f86fc99a/obelisk-upgrade migration/65071e255719af6389857646bc087d37-02fb88dab35884e09deef1721c1cfc13/obelisk-handoff migration/65071e255719af6389857646bc087d37-02fb88dab35884e09deef1721c1cfc13/obelisk-upgrade migration/6558f8bda2aa17d76c509dde0a3dea56-2ccf977797628dc3b1c002927fedc7a8/obelisk-handoff migration/6558f8bda2aa17d76c509dde0a3dea56-2ccf977797628dc3b1c002927fedc7a8/obelisk-upgrade migration/6566f0555737425bae9106d1a4a0a2dd-1f7fb90cb1e558f5285b2d19a25a1078/obelisk-handoff migration/6566f0555737425bae9106d1a4a0a2dd-1f7fb90cb1e558f5285b2d19a25a1078/obelisk-upgrade migration/6620e6dc5622593e5f671127af9ade05-4ff5bf819ea43a638abbcfa071bbf3ef/obelisk-handoff migration/6620e6dc5622593e5f671127af9ade05-4ff5bf819ea43a638abbcfa071bbf3ef/obelisk-upgrade migration/662eb30d6e4612f130edc3f6d37d92a2-94dd4eb45a4e7eb945027d5fd8eb4fa6/obelisk-handoff migration/662eb30d6e4612f130edc3f6d37d92a2-94dd4eb45a4e7eb945027d5fd8eb4fa6/obelisk-upgrade migration/66a9b6b9e9bc4a5b0cfa78127479b231-88765caf54c2bf9f23ea4d05816a9f65/obelisk-handoff migration/66a9b6b9e9bc4a5b0cfa78127479b231-88765caf54c2bf9f23ea4d05816a9f65/obelisk-upgrade migration/66d79b4c393877a72aec18f227049207-04dd95ecb889ac1b0a616ddfeec781c4/obelisk-handoff migration/66d79b4c393877a72aec18f227049207-04dd95ecb889ac1b0a616ddfeec781c4/obelisk-upgrade migration/66f7a274206ad9f6d3c5701e4bcffc9d-2e7cdc2bea08bb2358219ddefef372e0/obelisk-handoff migration/66f7a274206ad9f6d3c5701e4bcffc9d-2e7cdc2bea08bb2358219ddefef372e0/obelisk-upgrade migration/6708d14c71c475ac494808e75660a385-6095bdaccd933d319c84cde7983e2d10/obelisk-handoff migration/6708d14c71c475ac494808e75660a385-6095bdaccd933d319c84cde7983e2d10/obelisk-upgrade migration/67173f110f2c54d135e6943b65118303-17089ea0edc0cf4b6f616936f8a06174/obelisk-handoff migration/67173f110f2c54d135e6943b65118303-17089ea0edc0cf4b6f616936f8a06174/obelisk-upgrade migration/67bfa5b784a35e66875fb74ad84a38c0-f3ec62d09836804e39fad9d814137845/obelisk-handoff migration/67bfa5b784a35e66875fb74ad84a38c0-f3ec62d09836804e39fad9d814137845/obelisk-upgrade migration/68cca18f813a16eb0cc2c3ed7fa08044-ee3dccc89ea6fdaaf9c1146b92861e90/obelisk-handoff migration/68cca18f813a16eb0cc2c3ed7fa08044-ee3dccc89ea6fdaaf9c1146b92861e90/obelisk-upgrade migration/69537089a0e97845ffe05c73c3cc1536-e92786eaf56c32fd6b452c4a841d6317/obelisk-handoff migration/69537089a0e97845ffe05c73c3cc1536-e92786eaf56c32fd6b452c4a841d6317/obelisk-upgrade migration/69cd775958e25e3b2cff7e4897f2a9bb-fca48edfdaa31b036176b97b04384682/obelisk-handoff migration/69cd775958e25e3b2cff7e4897f2a9bb-fca48edfdaa31b036176b97b04384682/obelisk-upgrade migration/69fafe6ab155ff215b6d9d330f700ba1-6558f8bda2aa17d76c509dde0a3dea56/obelisk-handoff migration/69fafe6ab155ff215b6d9d330f700ba1-6558f8bda2aa17d76c509dde0a3dea56/obelisk-upgrade migration/6a18939264224d6ce24c7426249edfea-e66afc8befac4d76b5780a960f768c31/obelisk-handoff migration/6a18939264224d6ce24c7426249edfea-e66afc8befac4d76b5780a960f768c31/obelisk-upgrade−15 migration/6c7f4af3693c31e1a2c6a2c3f189ddf5-388d7d29a65c1713e07a654e91eb9caf/obelisk-handoff migration/6c7f4af3693c31e1a2c6a2c3f189ddf5-388d7d29a65c1713e07a654e91eb9caf/obelisk-upgrade migration/6da2e5b02ab780d12527640722d2b511-ca88f98cf9fb63d2feaef7fc19b30eca/obelisk-handoff migration/6da2e5b02ab780d12527640722d2b511-ca88f98cf9fb63d2feaef7fc19b30eca/obelisk-upgrade migration/6dc299cb41f8977785a5d676cbcd32d7-237aeb7eee0ffed230234ee04e49569f/obelisk-handoff migration/6dc299cb41f8977785a5d676cbcd32d7-237aeb7eee0ffed230234ee04e49569f/obelisk-upgrade migration/6f104c322bbaff565981739406290402-f98b82f5d142ce83733a3f18bdacb138/obelisk-handoff migration/6f104c322bbaff565981739406290402-f98b82f5d142ce83733a3f18bdacb138/obelisk-upgrade migration/6f3a0f756847ee5aa208a1dc79404779-00c627540326314c7154cc209e8a71e9/obelisk-handoff migration/6f3a0f756847ee5aa208a1dc79404779-00c627540326314c7154cc209e8a71e9/obelisk-upgrade migration/6fc44f180bb825d5b372444339681135-6dc299cb41f8977785a5d676cbcd32d7/obelisk-handoff migration/6fc44f180bb825d5b372444339681135-6dc299cb41f8977785a5d676cbcd32d7/obelisk-upgrade migration/702c65f35bc47641d60580d636ede330-9217718d2b3b217dbba72e7091459548/obelisk-handoff migration/702c65f35bc47641d60580d636ede330-9217718d2b3b217dbba72e7091459548/obelisk-upgrade migration/71a47d4d6856c1956c0d1c9de9af231f-bb9a87fc325204313d89dbfb689dba2f/obelisk-handoff migration/71a47d4d6856c1956c0d1c9de9af231f-bb9a87fc325204313d89dbfb689dba2f/obelisk-upgrade migration/71c6959cf98e05d356ff798ada6db2b8-55d9c5eb3b86c9cb27966f849b2d32cf/obelisk-handoff migration/71c6959cf98e05d356ff798ada6db2b8-55d9c5eb3b86c9cb27966f849b2d32cf/obelisk-upgrade migration/71da39c91abb23488021a1e9142507d5-16b24e1a12b93ea83d7656a09d5e3338/obelisk-handoff migration/71da39c91abb23488021a1e9142507d5-16b24e1a12b93ea83d7656a09d5e3338/obelisk-upgrade migration/721a02f3a7549e7d6efeaed087bfacb5-52df183d0f32d5a1e9ebe276b6d83d37/obelisk-handoff migration/721a02f3a7549e7d6efeaed087bfacb5-52df183d0f32d5a1e9ebe276b6d83d37/obelisk-upgrade migration/729aaf942e685bb37fdbd5e97293bbcb-7b2b9cefa7dd57d51b587c3501a1b9ef/obelisk-handoff migration/729aaf942e685bb37fdbd5e97293bbcb-7b2b9cefa7dd57d51b587c3501a1b9ef/obelisk-upgrade migration/73bcf3ed6593d074bd097cd43f5145d1-375acf7f2a3b3c487da2a6b30735d74d/obelisk-handoff migration/73bcf3ed6593d074bd097cd43f5145d1-375acf7f2a3b3c487da2a6b30735d74d/obelisk-upgrade migration/73e2573d9074884d7ae83106d55ad229-729aaf942e685bb37fdbd5e97293bbcb/obelisk-handoff migration/73e2573d9074884d7ae83106d55ad229-729aaf942e685bb37fdbd5e97293bbcb/obelisk-upgrade migration/7447d29f4712c72458c049cdb9380753-e24a771ee59f24e45afc0a27307f2070/obelisk-handoff migration/7447d29f4712c72458c049cdb9380753-e24a771ee59f24e45afc0a27307f2070/obelisk-upgrade migration/749df832c9305e1c6309a794b0c1b201-2619464637b85cb35376393fe612ddae/obelisk-handoff migration/749df832c9305e1c6309a794b0c1b201-2619464637b85cb35376393fe612ddae/obelisk-upgrade migration/75c9cd9763d0ed89c17d455f49d66a4f-94372bb14f8afd19bce24f8402c7564c/obelisk-handoff migration/75c9cd9763d0ed89c17d455f49d66a4f-94372bb14f8afd19bce24f8402c7564c/obelisk-upgrade migration/77a721a8fa97d1f84dd2af622089871b-cb2d040cc16752b1dc89eecf200ea798/obelisk-handoff migration/77a721a8fa97d1f84dd2af622089871b-cb2d040cc16752b1dc89eecf200ea798/obelisk-upgrade migration/79357758056556793db0472562d62ff9-f15c9c2f894c8cc4fac07e2cdef47180/obelisk-handoff migration/79357758056556793db0472562d62ff9-f15c9c2f894c8cc4fac07e2cdef47180/obelisk-upgrade migration/7adece557941a7d7ac7c150f77f758be-67173f110f2c54d135e6943b65118303/obelisk-handoff migration/7adece557941a7d7ac7c150f77f758be-67173f110f2c54d135e6943b65118303/obelisk-upgrade migration/7b2b9cefa7dd57d51b587c3501a1b9ef-1269155fffe21926f3704d5077e04332/obelisk-handoff migration/7b2b9cefa7dd57d51b587c3501a1b9ef-1269155fffe21926f3704d5077e04332/obelisk-upgrade migration/7b75ffdcd86b5a330d9c325ad5767393-97873167212295a0fdc1219102b6b600/obelisk-handoff migration/7b75ffdcd86b5a330d9c325ad5767393-97873167212295a0fdc1219102b6b600/obelisk-upgrade migration/7b9c28d09bd962e89b9715500f9e184c-df71cd82e801ca701bf4bc44b80b6d50/obelisk-handoff migration/7b9c28d09bd962e89b9715500f9e184c-df71cd82e801ca701bf4bc44b80b6d50/obelisk-upgrade migration/7bc4c944b24621967a6334f522437cc1-3e8a6968585d3d60f3b13652a386aec0/obelisk-handoff migration/7bc4c944b24621967a6334f522437cc1-3e8a6968585d3d60f3b13652a386aec0/obelisk-upgrade migration/7c0ab1210424b615251ef57036d316c3-b8aa42d4f2e5ef7db9ba34ecf6c42079/obelisk-handoff migration/7c0ab1210424b615251ef57036d316c3-b8aa42d4f2e5ef7db9ba34ecf6c42079/obelisk-upgrade migration/7c98ef4a123c1a580d368d14e54961b7-adad34a1075a2fd51e1a1c06ec9d002d/obelisk-handoff migration/7c98ef4a123c1a580d368d14e54961b7-adad34a1075a2fd51e1a1c06ec9d002d/obelisk-upgrade migration/7ce32302cfbba8b7567a05144057f8a3-28c5fec3b7b0b14b3625d5c8f60bcf68/obelisk-handoff migration/7ce32302cfbba8b7567a05144057f8a3-28c5fec3b7b0b14b3625d5c8f60bcf68/obelisk-upgrade migration/7cf814f7404638f1c1be662a24d7cfea-e609d945b642fd9d4ce99931e3699db7/obelisk-handoff migration/7cf814f7404638f1c1be662a24d7cfea-e609d945b642fd9d4ce99931e3699db7/obelisk-upgrade migration/7dd60550d7d79bd3923d91d67ecb433a-46aed07c1a61476dd245ff8e74c0559f/obelisk-handoff migration/7dd60550d7d79bd3923d91d67ecb433a-46aed07c1a61476dd245ff8e74c0559f/obelisk-upgrade migration/7f46d84c4d303f30602b920f96acf871-97c7e1ea2c1ddb0ef23d2e4a9279f65c/obelisk-handoff migration/7f46d84c4d303f30602b920f96acf871-97c7e1ea2c1ddb0ef23d2e4a9279f65c/obelisk-upgrade migration/7fac40a2398039b364746989bb78798b-68cca18f813a16eb0cc2c3ed7fa08044/obelisk-handoff migration/7fac40a2398039b364746989bb78798b-68cca18f813a16eb0cc2c3ed7fa08044/obelisk-upgrade migration/7fc381538805adac19c54b73ea118601-982c57eada4652019d0b0cf6ad355d25/obelisk-handoff migration/7fc381538805adac19c54b73ea118601-982c57eada4652019d0b0cf6ad355d25/obelisk-upgrade migration/80cb6b08443d55bb512e4a35b4768b72-59742705e53838ae13066a2239a72040/obelisk-handoff migration/80cb6b08443d55bb512e4a35b4768b72-59742705e53838ae13066a2239a72040/obelisk-upgrade migration/81223455459db28cdbc990c3d4e6eedd-71da39c91abb23488021a1e9142507d5/obelisk-handoff migration/81223455459db28cdbc990c3d4e6eedd-71da39c91abb23488021a1e9142507d5/obelisk-upgrade migration/8143888349912db9780231c370ea2060-beaa30317dadbef830531237279cbca4/obelisk-handoff migration/8143888349912db9780231c370ea2060-beaa30317dadbef830531237279cbca4/obelisk-upgrade migration/81f3dbeef0d78bfb523cd2ac113b8ad8-4ace4414d71235a291f7148f80a0b0f5/obelisk-handoff migration/81f3dbeef0d78bfb523cd2ac113b8ad8-4ace4414d71235a291f7148f80a0b0f5/obelisk-upgrade migration/84f4d5c5491abb855d8dbe3acf3bc8e6-01fb7610e4184ad1b491267fcb0c7f43/obelisk-handoff migration/84f4d5c5491abb855d8dbe3acf3bc8e6-01fb7610e4184ad1b491267fcb0c7f43/obelisk-upgrade migration/85c2c4fb8472d50eaa97aed0bdc9b142-3e253c6beb567ba8f4c8086a76b70645/obelisk-handoff migration/85c2c4fb8472d50eaa97aed0bdc9b142-3e253c6beb567ba8f4c8086a76b70645/obelisk-upgrade migration/8746b8f08b75b2bb7c22d8f17f22d72d-e3b3014d7e0dc983fe118d32546654e5/obelisk-handoff migration/8746b8f08b75b2bb7c22d8f17f22d72d-e3b3014d7e0dc983fe118d32546654e5/obelisk-upgrade migration/88046de6fbbdad3f6a8a5d311948ff9b-4a037879b8a542f1590cbb87b0242331/obelisk-handoff migration/88046de6fbbdad3f6a8a5d311948ff9b-4a037879b8a542f1590cbb87b0242331/obelisk-upgrade migration/88439725720c7ba784750cda91157dfd-69cd775958e25e3b2cff7e4897f2a9bb/obelisk-handoff migration/88439725720c7ba784750cda91157dfd-69cd775958e25e3b2cff7e4897f2a9bb/obelisk-upgrade migration/88765caf54c2bf9f23ea4d05816a9f65-52330622ae996023b3f80a40991521a4/obelisk-handoff migration/88765caf54c2bf9f23ea4d05816a9f65-52330622ae996023b3f80a40991521a4/obelisk-upgrade migration/8911be694899014078c8e79fc858be45-33da5c0e6705843afa6e39e65bfa0564/obelisk-handoff migration/8911be694899014078c8e79fc858be45-33da5c0e6705843afa6e39e65bfa0564/obelisk-upgrade migration/8a64ec5f2ee43d69607499f085560857-cba28ee4b736cf8ed43cb342ccaef12e/obelisk-handoff migration/8a64ec5f2ee43d69607499f085560857-cba28ee4b736cf8ed43cb342ccaef12e/obelisk-upgrade migration/8adb921f4dbb9d363bf6647d304e02fe-bb2f504aa4f6f1ab8ed75697dc773efb/obelisk-handoff migration/8adb921f4dbb9d363bf6647d304e02fe-bb2f504aa4f6f1ab8ed75697dc773efb/obelisk-upgrade migration/8b098f49e1fd1aa10ca22b9dc312644e-0ec6f67d94d3913cf3243d813238ec39/obelisk-handoff migration/8b098f49e1fd1aa10ca22b9dc312644e-0ec6f67d94d3913cf3243d813238ec39/obelisk-upgrade migration/8c7718f94e2676c957fe844b7dc2637c-96c3d49b08a9d2cfb059197c60f49c05/obelisk-handoff migration/8c7718f94e2676c957fe844b7dc2637c-96c3d49b08a9d2cfb059197c60f49c05/obelisk-upgrade migration/8c9599be2461288eee7e78d7a34643d8-053c0b2f84a7a2eadeb5c3f9575ffa0d/obelisk-handoff migration/8c9599be2461288eee7e78d7a34643d8-053c0b2f84a7a2eadeb5c3f9575ffa0d/obelisk-upgrade migration/8d5dba70e93ae7e784ea238281842408-c93529e579e64263fd91663216fd3fe7/obelisk-handoff migration/8d5dba70e93ae7e784ea238281842408-c93529e579e64263fd91663216fd3fe7/obelisk-upgrade migration/8dcf46725e839f4a5dcb7a9f0235e01b-0da1150f0e9fe57d1fafbb6cabe24fa1/obelisk-handoff migration/8dcf46725e839f4a5dcb7a9f0235e01b-0da1150f0e9fe57d1fafbb6cabe24fa1/obelisk-upgrade migration/8df9e256d8e43fa4e22d953024269b5b-9d86cedf551a6ee24c5ae6779021b925/obelisk-handoff migration/8df9e256d8e43fa4e22d953024269b5b-9d86cedf551a6ee24c5ae6779021b925/obelisk-upgrade migration/8e01c7fee83aa74229a77772d8c928f3-8911be694899014078c8e79fc858be45/obelisk-handoff migration/8e01c7fee83aa74229a77772d8c928f3-8911be694899014078c8e79fc858be45/obelisk-upgrade migration/8e1e426afe242ea3079f160bccd94cf0-610dcf99f7eb8c8b591ff3f5f1722938/obelisk-handoff migration/8e1e426afe242ea3079f160bccd94cf0-610dcf99f7eb8c8b591ff3f5f1722938/obelisk-upgrade migration/8fca2c4d6478ed8628925852b2af45bf-03b845f308e73a1567eb843dfca182d2/obelisk-handoff migration/8fca2c4d6478ed8628925852b2af45bf-03b845f308e73a1567eb843dfca182d2/obelisk-upgrade migration/90489c1a9f7edd46a070d6474dceac86-7fac40a2398039b364746989bb78798b/obelisk-handoff migration/90489c1a9f7edd46a070d6474dceac86-7fac40a2398039b364746989bb78798b/obelisk-upgrade migration/909b6b2066cbdc991e6c16455f13637c-1e36dc8817e2784df36d643b7499092d/obelisk-handoff migration/909b6b2066cbdc991e6c16455f13637c-1e36dc8817e2784df36d643b7499092d/obelisk-upgrade migration/90b4e20464e08ade5f215f2a4ea28cc6-b7630e5f30252987bf899c74de3953ad/obelisk-handoff migration/90b4e20464e08ade5f215f2a4ea28cc6-b7630e5f30252987bf899c74de3953ad/obelisk-upgrade migration/9217718d2b3b217dbba72e7091459548-88046de6fbbdad3f6a8a5d311948ff9b/obelisk-handoff migration/9217718d2b3b217dbba72e7091459548-88046de6fbbdad3f6a8a5d311948ff9b/obelisk-upgrade migration/9223532a537f698ef36f4dce6e922a6b-d327ceb69d24e40dc11792840454cff9/obelisk-handoff migration/9223532a537f698ef36f4dce6e922a6b-d327ceb69d24e40dc11792840454cff9/obelisk-upgrade migration/92ab733e8991f12cc12148f8d4e1b35d-e4b89dd259f3831bc60b56147b3586a6/obelisk-handoff migration/92ab733e8991f12cc12148f8d4e1b35d-e4b89dd259f3831bc60b56147b3586a6/obelisk-upgrade migration/930e9213e072e87c207f93461bd3c96c-7f46d84c4d303f30602b920f96acf871/obelisk-handoff migration/930e9213e072e87c207f93461bd3c96c-7f46d84c4d303f30602b920f96acf871/obelisk-upgrade migration/93f164bbd887f688fd49bb80afffccd6-f8eee9431c8b7a767d96da0a8cfae95d/obelisk-handoff migration/93f164bbd887f688fd49bb80afffccd6-f8eee9431c8b7a767d96da0a8cfae95d/obelisk-upgrade migration/93fc625d41bae9fcf06b9febeacb686d-662eb30d6e4612f130edc3f6d37d92a2/obelisk-handoff migration/93fc625d41bae9fcf06b9febeacb686d-662eb30d6e4612f130edc3f6d37d92a2/obelisk-upgrade migration/94252585266fa745a91733888e2f50b7-d207ab99328b8ece5fb27fa1f4dbf9f6/obelisk-handoff migration/94252585266fa745a91733888e2f50b7-d207ab99328b8ece5fb27fa1f4dbf9f6/obelisk-upgrade migration/94372bb14f8afd19bce24f8402c7564c-7dd60550d7d79bd3923d91d67ecb433a/obelisk-handoff migration/94372bb14f8afd19bce24f8402c7564c-7dd60550d7d79bd3923d91d67ecb433a/obelisk-upgrade migration/947784563e3a27cf6486bed9a3c52f15-25615a274650370633e8083ed19fbdd0/obelisk-handoff migration/947784563e3a27cf6486bed9a3c52f15-25615a274650370633e8083ed19fbdd0/obelisk-upgrade migration/94dd4eb45a4e7eb945027d5fd8eb4fa6-e22c51145e08d4a089003460ae80a7f9/obelisk-handoff migration/94dd4eb45a4e7eb945027d5fd8eb4fa6-e22c51145e08d4a089003460ae80a7f9/obelisk-upgrade migration/95955d1dd0981ebb538ee941cde1f963-07900e6c41ab9a78917f66fcf7e0d9b8/obelisk-handoff migration/95955d1dd0981ebb538ee941cde1f963-07900e6c41ab9a78917f66fcf7e0d9b8/obelisk-upgrade migration/959ae2925bcd2b5beff631a8e7aeaf00-071f5b3326b8886de3eddc927b80eb10/obelisk-handoff migration/959ae2925bcd2b5beff631a8e7aeaf00-071f5b3326b8886de3eddc927b80eb10/obelisk-upgrade migration/962e2bd1ae8d0c233f8da89ecebffe50-d6c090699acd25fc60213ff4bd9eebcf/obelisk-handoff migration/962e2bd1ae8d0c233f8da89ecebffe50-d6c090699acd25fc60213ff4bd9eebcf/obelisk-upgrade migration/96c3d49b08a9d2cfb059197c60f49c05-6da2e5b02ab780d12527640722d2b511/obelisk-handoff migration/96c3d49b08a9d2cfb059197c60f49c05-6da2e5b02ab780d12527640722d2b511/obelisk-upgrade migration/9705509619667aacf799e91927c16dc8-2773d4a82ca59b48faf036755e163a5f/obelisk-handoff migration/9705509619667aacf799e91927c16dc8-2773d4a82ca59b48faf036755e163a5f/obelisk-upgrade migration/9715967793be68dfd8c9a7d631f8d589-d532356dfb65a4c8a39452d2ebca2516/obelisk-handoff migration/9715967793be68dfd8c9a7d631f8d589-d532356dfb65a4c8a39452d2ebca2516/obelisk-upgrade migration/975cd8245d06ad09e4fb176cfc9af5e0-3f23549fba6f8e67ba36b4405e8680b3/obelisk-handoff migration/975cd8245d06ad09e4fb176cfc9af5e0-3f23549fba6f8e67ba36b4405e8680b3/obelisk-upgrade migration/97873167212295a0fdc1219102b6b600-88439725720c7ba784750cda91157dfd/obelisk-handoff migration/97873167212295a0fdc1219102b6b600-88439725720c7ba784750cda91157dfd/obelisk-upgrade migration/97c7e1ea2c1ddb0ef23d2e4a9279f65c-d747c3d0620b2034aca44265dd1c8c86/obelisk-handoff migration/97c7e1ea2c1ddb0ef23d2e4a9279f65c-d747c3d0620b2034aca44265dd1c8c86/obelisk-upgrade migration/982c57eada4652019d0b0cf6ad355d25-6708d14c71c475ac494808e75660a385/obelisk-handoff migration/982c57eada4652019d0b0cf6ad355d25-6708d14c71c475ac494808e75660a385/obelisk-upgrade migration/98629a336dcd5fa3524a09f8ea6ad636-8c9599be2461288eee7e78d7a34643d8/obelisk-handoff migration/98629a336dcd5fa3524a09f8ea6ad636-8c9599be2461288eee7e78d7a34643d8/obelisk-upgrade migration/98da197f133bca81e533ab5ffbf4c82d-a0b418c582d5c6ef9e0cd9a19abe046e/obelisk-handoff migration/98da197f133bca81e533ab5ffbf4c82d-a0b418c582d5c6ef9e0cd9a19abe046e/obelisk-upgrade migration/98f9e0bbd21e36b0f4daa440d11e7177-bab3871bcfbfcb3d2bad4495d44ae4f8/obelisk-handoff migration/98f9e0bbd21e36b0f4daa440d11e7177-bab3871bcfbfcb3d2bad4495d44ae4f8/obelisk-upgrade migration/99aebbfcac51725464bc59571b7d71b8-34d14d4a444d3bf1487ada6129815df4/obelisk-handoff migration/99aebbfcac51725464bc59571b7d71b8-34d14d4a444d3bf1487ada6129815df4/obelisk-upgrade migration/9b33a49f0c978e27b752fa457aca97cc-51f3d5068259f596b811450f0bf25419/obelisk-handoff migration/9b33a49f0c978e27b752fa457aca97cc-51f3d5068259f596b811450f0bf25419/obelisk-upgrade migration/9b9d73736773550dde7d36de2498b029-69537089a0e97845ffe05c73c3cc1536/obelisk-handoff migration/9b9d73736773550dde7d36de2498b029-69537089a0e97845ffe05c73c3cc1536/obelisk-upgrade migration/9c94cd459a25b5c2de56067c8fdac620-721a02f3a7549e7d6efeaed087bfacb5/obelisk-handoff migration/9c94cd459a25b5c2de56067c8fdac620-721a02f3a7549e7d6efeaed087bfacb5/obelisk-upgrade migration/9cef2dd1885f16455ff9b6801ec99454-63ff9426130baa080f37400a86c55fdd/obelisk-handoff migration/9cef2dd1885f16455ff9b6801ec99454-63ff9426130baa080f37400a86c55fdd/obelisk-upgrade migration/9d86cedf551a6ee24c5ae6779021b925-1c9bdb5c544f2e5432f549653a61dabe/obelisk-handoff migration/9d86cedf551a6ee24c5ae6779021b925-1c9bdb5c544f2e5432f549653a61dabe/obelisk-upgrade migration/9e05cc6b81c6380ba0ac59bad1021cac-ce7f0d15d71d36d4bcf4fbadcdfa1b58/obelisk-handoff migration/9e05cc6b81c6380ba0ac59bad1021cac-ce7f0d15d71d36d4bcf4fbadcdfa1b58/obelisk-upgrade migration/9e61f37dd79310b71c80ee166aeb4e80-466a19f9cfa2a103467fe6627225d27f/obelisk-handoff migration/9e61f37dd79310b71c80ee166aeb4e80-466a19f9cfa2a103467fe6627225d27f/obelisk-upgrade migration/9f6c8fd80ab3ff2dcc48bfd211c8b761-24f151a674662ac47845237d7a9f6a4f/obelisk-handoff migration/9f6c8fd80ab3ff2dcc48bfd211c8b761-24f151a674662ac47845237d7a9f6a4f/obelisk-upgrade migration/9f71fc9d2ed805fecbc8c4a3aae5685b-cb2197d0267b52385ee39bf4adcfe475/obelisk-handoff migration/9f71fc9d2ed805fecbc8c4a3aae5685b-cb2197d0267b52385ee39bf4adcfe475/obelisk-upgrade migration/9fb504b182cbd8dfb666175b651e0b49-338b92f88c49c7c3a1d8ec231d9f7189/obelisk-handoff migration/9fb504b182cbd8dfb666175b651e0b49-338b92f88c49c7c3a1d8ec231d9f7189/obelisk-upgrade migration/9fe2922674fcee5e840c9f52cf534f88-ac92878eb85c5283bcc5f3f34cd35aa6/obelisk-handoff migration/9fe2922674fcee5e840c9f52cf534f88-ac92878eb85c5283bcc5f3f34cd35aa6/obelisk-upgrade migration/a00870cfca85ff8dae5db3a78f5a227d-c2502429502b46133a749f021d188cf0/obelisk-handoff migration/a00870cfca85ff8dae5db3a78f5a227d-c2502429502b46133a749f021d188cf0/obelisk-upgrade migration/a080b8549e32f21fec11084f4ab1e052-bd7c24fc03bf82e5a990515531a69147/obelisk-handoff migration/a080b8549e32f21fec11084f4ab1e052-bd7c24fc03bf82e5a990515531a69147/obelisk-upgrade migration/a08aebb6f40fb45d174b229532314ac4-1c1c3f2b4426d5d26377eef08dbccb3c/obelisk-handoff migration/a08aebb6f40fb45d174b229532314ac4-1c1c3f2b4426d5d26377eef08dbccb3c/obelisk-upgrade migration/a0b418c582d5c6ef9e0cd9a19abe046e-63422a9bade5c703461b600e03e227f0/obelisk-handoff migration/a0b418c582d5c6ef9e0cd9a19abe046e-63422a9bade5c703461b600e03e227f0/obelisk-upgrade migration/a0f5ac2ff5c6a957e565f898a9fc8bfb-bf3fbc8db3d6fd42a37982dfb5a30b5c/obelisk-handoff migration/a0f5ac2ff5c6a957e565f898a9fc8bfb-bf3fbc8db3d6fd42a37982dfb5a30b5c/obelisk-upgrade migration/a262678b7d849de5a9732d06199666ae-ebb95c5864d1d1d2f78fbf7cc8235dac/obelisk-handoff migration/a262678b7d849de5a9732d06199666ae-ebb95c5864d1d1d2f78fbf7cc8235dac/obelisk-upgrade migration/a2665cfd303a4a34a7bfa3b7d0d264bb-aff3f143ddaa4ed3ffad873d6638e277/obelisk-handoff migration/a2665cfd303a4a34a7bfa3b7d0d264bb-aff3f143ddaa4ed3ffad873d6638e277/obelisk-upgrade migration/a2b33f8dc1f90b8dddce942b174be5b8-00a480749e96ef7e21fbe8f4943152b1/obelisk-handoff migration/a2b33f8dc1f90b8dddce942b174be5b8-00a480749e96ef7e21fbe8f4943152b1/obelisk-upgrade migration/a2bdbf1985b75442e78e84523c4ced5f-48c027da19d895ba03e7b9120f771291/obelisk-handoff migration/a2bdbf1985b75442e78e84523c4ced5f-48c027da19d895ba03e7b9120f771291/obelisk-upgrade migration/a34d758508a0a5d08bc10e76482c4d11-8fca2c4d6478ed8628925852b2af45bf/obelisk-handoff migration/a34d758508a0a5d08bc10e76482c4d11-8fca2c4d6478ed8628925852b2af45bf/obelisk-upgrade migration/a4477746ae1a7024bc3cd0807180d418-fb5110e527cf77c568bcae7d435ee035/obelisk-handoff migration/a4477746ae1a7024bc3cd0807180d418-fb5110e527cf77c568bcae7d435ee035/obelisk-upgrade migration/a5297d8457aa4c327f35d4697f6cb66f-2f928f9c4a137186f808a231c9e3c141/obelisk-handoff migration/a5297d8457aa4c327f35d4697f6cb66f-2f928f9c4a137186f808a231c9e3c141/obelisk-upgrade migration/a536d01b9c489f5e00e30abf27427da0-b8a8ffc909e5fc350d9f8a6a90e7b3d9/obelisk-handoff migration/a536d01b9c489f5e00e30abf27427da0-b8a8ffc909e5fc350d9f8a6a90e7b3d9/obelisk-upgrade migration/a5904e3a899e346fe2fe26314f69c075-e4513b485b6ba8b7f4bd34b12458ff0c/obelisk-handoff migration/a5904e3a899e346fe2fe26314f69c075-e4513b485b6ba8b7f4bd34b12458ff0c/obelisk-upgrade migration/a5bbc0b9ceab9c3f7ca32a7da8c1f685-3c4b3152f0608d23d07240e2df3ff8da/obelisk-handoff migration/a5bbc0b9ceab9c3f7ca32a7da8c1f685-3c4b3152f0608d23d07240e2df3ff8da/obelisk-upgrade migration/a5e40d67714a1b2daa06e3fb3293216d-04a5ae41e8fcef5f719cb84d01430382/obelisk-handoff migration/a5e40d67714a1b2daa06e3fb3293216d-04a5ae41e8fcef5f719cb84d01430382/obelisk-upgrade migration/a632452cf9c5956becd1a40512472b43-d6a3ea5f7eb3c95f5e5ea09fb1330270/obelisk-handoff migration/a632452cf9c5956becd1a40512472b43-d6a3ea5f7eb3c95f5e5ea09fb1330270/obelisk-upgrade migration/a6633fc9687566aa84c3d5d5e2bff4fd-b5cab336f6244293913433101cd0feff/obelisk-handoff migration/a6633fc9687566aa84c3d5d5e2bff4fd-b5cab336f6244293913433101cd0feff/obelisk-upgrade migration/a6d50c7e756dfd1e3ae891111b81a1ae-270b3b3f7bc510c692e3253a895f122a/obelisk-handoff migration/a6d50c7e756dfd1e3ae891111b81a1ae-270b3b3f7bc510c692e3253a895f122a/obelisk-upgrade migration/a7c7b80a875d1863f027c97eb433b884-cbe155a3e856fb7eaad0bd18feb408be/obelisk-handoff migration/a7c7b80a875d1863f027c97eb433b884-cbe155a3e856fb7eaad0bd18feb408be/obelisk-upgrade migration/a808a04519bbf2874e41028ded9c180c-8e1e426afe242ea3079f160bccd94cf0/obelisk-handoff migration/a808a04519bbf2874e41028ded9c180c-8e1e426afe242ea3079f160bccd94cf0/obelisk-upgrade migration/a825fbb74e8d050a5ce10ec4c62b83f5-c3298d81428117be58196b80853e3c7b/obelisk-handoff migration/a825fbb74e8d050a5ce10ec4c62b83f5-c3298d81428117be58196b80853e3c7b/obelisk-upgrade migration/a826f01311fe00ef5cf87568832605d3-9fb504b182cbd8dfb666175b651e0b49/obelisk-handoff migration/a826f01311fe00ef5cf87568832605d3-9fb504b182cbd8dfb666175b651e0b49/obelisk-upgrade migration/a878ad346b9305ad2ae3fd85410a7ed7-0f78d9d6875933336bbf0c1c8888b73f/obelisk-handoff migration/a878ad346b9305ad2ae3fd85410a7ed7-0f78d9d6875933336bbf0c1c8888b73f/obelisk-upgrade migration/a8ebe201ab7a7b0211de41b14a95192e-65071e255719af6389857646bc087d37/obelisk-handoff migration/a8ebe201ab7a7b0211de41b14a95192e-65071e255719af6389857646bc087d37/obelisk-upgrade migration/a96d491705acc139315264fd340d228f-be615dc4d60c9d8710fbd120857c2fa1/obelisk-handoff migration/a96d491705acc139315264fd340d228f-be615dc4d60c9d8710fbd120857c2fa1/obelisk-upgrade migration/aa8e6712fd46824acdea303068634078-dc95f39fb27634ccbca7318ff2065608/obelisk-handoff migration/aa8e6712fd46824acdea303068634078-dc95f39fb27634ccbca7318ff2065608/obelisk-upgrade migration/aaf979dd0121603a8b48127e1ea47c7d-4b7a36dce2c1cf94554e12d8a7903269/obelisk-handoff migration/aaf979dd0121603a8b48127e1ea47c7d-4b7a36dce2c1cf94554e12d8a7903269/obelisk-upgrade migration/abdb013baf130e1bd7e7fd04e535c44c-39df6544d6b035d4c77cc829729f9c19/obelisk-handoff migration/abdb013baf130e1bd7e7fd04e535c44c-39df6544d6b035d4c77cc829729f9c19/obelisk-upgrade migration/ac5e28caddd6832d0bf1f7445a4a6a28-e01cc01684deaf4c75ad5d65270bf3d5/obelisk-handoff migration/ac5e28caddd6832d0bf1f7445a4a6a28-e01cc01684deaf4c75ad5d65270bf3d5/obelisk-upgrade migration/ac92878eb85c5283bcc5f3f34cd35aa6-145650b66e83adf5bdb8261593076379/obelisk-handoff migration/ac92878eb85c5283bcc5f3f34cd35aa6-145650b66e83adf5bdb8261593076379/obelisk-upgrade migration/adad34a1075a2fd51e1a1c06ec9d002d-930e9213e072e87c207f93461bd3c96c/obelisk-handoff migration/adad34a1075a2fd51e1a1c06ec9d002d-930e9213e072e87c207f93461bd3c96c/obelisk-upgrade migration/ae4328daeb7d2c52c534a687fbd184b6-3e763ebe16cc3a261f5776ab1f1f6d9a/obelisk-handoff migration/ae4328daeb7d2c52c534a687fbd184b6-3e763ebe16cc3a261f5776ab1f1f6d9a/obelisk-upgrade migration/ae824b83b569b3b23b8e198190371ca0-81f3dbeef0d78bfb523cd2ac113b8ad8/obelisk-handoff migration/ae824b83b569b3b23b8e198190371ca0-81f3dbeef0d78bfb523cd2ac113b8ad8/obelisk-upgrade migration/ae8862f8b7292690c852111ca5659ce9-ae4328daeb7d2c52c534a687fbd184b6/obelisk-handoff migration/ae8862f8b7292690c852111ca5659ce9-ae4328daeb7d2c52c534a687fbd184b6/obelisk-upgrade migration/aeafaa5d20bab4439a5d31f29023a839-79357758056556793db0472562d62ff9/obelisk-handoff migration/aeafaa5d20bab4439a5d31f29023a839-79357758056556793db0472562d62ff9/obelisk-upgrade migration/aef6ac052515a869c7d3061d4ccc69dd-15f3f3f517b38664131b85da0594522f/obelisk-handoff migration/aef6ac052515a869c7d3061d4ccc69dd-15f3f3f517b38664131b85da0594522f/obelisk-upgrade migration/afbd010add526d309dccee6895e42d0d-6f3a0f756847ee5aa208a1dc79404779/obelisk-handoff migration/afbd010add526d309dccee6895e42d0d-6f3a0f756847ee5aa208a1dc79404779/obelisk-upgrade migration/aff3f143ddaa4ed3ffad873d6638e277-6fc44f180bb825d5b372444339681135/obelisk-handoff migration/aff3f143ddaa4ed3ffad873d6638e277-6fc44f180bb825d5b372444339681135/obelisk-upgrade migration/b0c1d039514a686529561f186332c91e-a878ad346b9305ad2ae3fd85410a7ed7/obelisk-handoff migration/b0c1d039514a686529561f186332c91e-a878ad346b9305ad2ae3fd85410a7ed7/obelisk-upgrade migration/b1692927da5ed59af72fac5be8094fa2-d5ba6f13296205e5bd88ca2756107df0/obelisk-handoff migration/b1692927da5ed59af72fac5be8094fa2-d5ba6f13296205e5bd88ca2756107df0/obelisk-upgrade migration/b2282679f6f63cec89d921c3dd512d1e-1f09fcf196bfe90ed52f113c38ffbfdb/obelisk-handoff migration/b2282679f6f63cec89d921c3dd512d1e-1f09fcf196bfe90ed52f113c38ffbfdb/obelisk-upgrade migration/b3b107d406a6a7675cd5b9f52e5f7d8e-0d3b4cfe9b4c72b830780a4c44942176/obelisk-handoff migration/b3b107d406a6a7675cd5b9f52e5f7d8e-0d3b4cfe9b4c72b830780a4c44942176/obelisk-upgrade migration/b3ff195b0a90ef5900f9cef2ba75f2fe-24e0d027f4160a6478c1356e51f419cf/obelisk-handoff migration/b3ff195b0a90ef5900f9cef2ba75f2fe-24e0d027f4160a6478c1356e51f419cf/obelisk-upgrade migration/b4f6596f2c16811442d8bb2961fbb721-3c7755e495f20cfac5e4dabe78644c5a/obelisk-handoff migration/b4f6596f2c16811442d8bb2961fbb721-3c7755e495f20cfac5e4dabe78644c5a/obelisk-upgrade migration/b5cab336f6244293913433101cd0feff-8746b8f08b75b2bb7c22d8f17f22d72d/obelisk-handoff migration/b5cab336f6244293913433101cd0feff-8746b8f08b75b2bb7c22d8f17f22d72d/obelisk-upgrade migration/b641dd9c5359201200e483a784456cc2-cc4307fc88e3486b1c3f9ce07db95808/obelisk-handoff migration/b641dd9c5359201200e483a784456cc2-cc4307fc88e3486b1c3f9ce07db95808/obelisk-upgrade migration/b6425c7661af2116b912a558e9548013-4aefa80392582ec03a19f946e752d331/obelisk-handoff migration/b6425c7661af2116b912a558e9548013-4aefa80392582ec03a19f946e752d331/obelisk-upgrade migration/b68a785fbf27a63334ef1d1fe82b2dac-d6b34eba6ed4f89875a6615fe2c41ec2/obelisk-handoff migration/b68a785fbf27a63334ef1d1fe82b2dac-d6b34eba6ed4f89875a6615fe2c41ec2/obelisk-upgrade migration/b6ffce85249f30616da76334c7bbec6e-66a9b6b9e9bc4a5b0cfa78127479b231/obelisk-handoff migration/b6ffce85249f30616da76334c7bbec6e-66a9b6b9e9bc4a5b0cfa78127479b231/obelisk-upgrade migration/b7630e5f30252987bf899c74de3953ad-3f0687592a77c0c66193652e9cd981fd/obelisk-handoff migration/b7630e5f30252987bf899c74de3953ad-3f0687592a77c0c66193652e9cd981fd/obelisk-upgrade migration/b7e30314f9d0e69efdc84c7eb4e3bcc3-e4051219d89b3c9a8350fe824ad96a82/obelisk-handoff migration/b7e30314f9d0e69efdc84c7eb4e3bcc3-e4051219d89b3c9a8350fe824ad96a82/obelisk-upgrade migration/b82e9c3fe22feff4bb3a6be49943fd6c-fbb3eb3209281031dc5183d289eb4e75/obelisk-handoff migration/b82e9c3fe22feff4bb3a6be49943fd6c-fbb3eb3209281031dc5183d289eb4e75/obelisk-upgrade migration/b8a8ffc909e5fc350d9f8a6a90e7b3d9-aef6ac052515a869c7d3061d4ccc69dd/obelisk-handoff migration/b8a8ffc909e5fc350d9f8a6a90e7b3d9-aef6ac052515a869c7d3061d4ccc69dd/obelisk-upgrade migration/b8aa42d4f2e5ef7db9ba34ecf6c42079-37c2ed0ba2cd54c0ec29eae9043bc4c8/obelisk-handoff migration/b8aa42d4f2e5ef7db9ba34ecf6c42079-37c2ed0ba2cd54c0ec29eae9043bc4c8/obelisk-upgrade migration/b95c8d049256fb7360ca14b12acd8544-e7b17aa124e17c357cead8081a58f089/obelisk-handoff migration/b95c8d049256fb7360ca14b12acd8544-e7b17aa124e17c357cead8081a58f089/obelisk-upgrade migration/ba0ccd5ef6110f6c5133d9d6ea6277f0-e78ec85bec14f4784faeef4d8d3e4d0a/obelisk-handoff migration/ba0ccd5ef6110f6c5133d9d6ea6277f0-e78ec85bec14f4784faeef4d8d3e4d0a/obelisk-upgrade migration/ba4829dc61dcc12bcafd8de5fc8a76dc-2164344be67da5d0e57052c15f30646d/obelisk-handoff migration/ba4829dc61dcc12bcafd8de5fc8a76dc-2164344be67da5d0e57052c15f30646d/obelisk-upgrade migration/bab3871bcfbfcb3d2bad4495d44ae4f8-9cef2dd1885f16455ff9b6801ec99454/obelisk-handoff migration/bab3871bcfbfcb3d2bad4495d44ae4f8-9cef2dd1885f16455ff9b6801ec99454/obelisk-upgrade migration/bb2f504aa4f6f1ab8ed75697dc773efb-bcd13da3a7fba8514084c1a9dbeabb31/obelisk-handoff migration/bb2f504aa4f6f1ab8ed75697dc773efb-bcd13da3a7fba8514084c1a9dbeabb31/obelisk-upgrade migration/bb9a87fc325204313d89dbfb689dba2f-d2d86ce0ca16b143b49374302a9e9e2f/obelisk-handoff migration/bb9a87fc325204313d89dbfb689dba2f-d2d86ce0ca16b143b49374302a9e9e2f/obelisk-upgrade migration/bc7688ff47218c0e13d02d917b03caa0-2bdd4221307cafa3e98c4d3017cdc912/obelisk-handoff migration/bc7688ff47218c0e13d02d917b03caa0-2bdd4221307cafa3e98c4d3017cdc912/obelisk-upgrade migration/bcd13da3a7fba8514084c1a9dbeabb31-8dcf46725e839f4a5dcb7a9f0235e01b/obelisk-handoff migration/bcd13da3a7fba8514084c1a9dbeabb31-8dcf46725e839f4a5dcb7a9f0235e01b/obelisk-upgrade migration/bd6728737dffcc3505d30ada344e2f4b-1cc8d98f6f61441570fdde2d697e6e3c/obelisk-handoff migration/bd6728737dffcc3505d30ada344e2f4b-1cc8d98f6f61441570fdde2d697e6e3c/obelisk-upgrade migration/bd7c24fc03bf82e5a990515531a69147-a5e40d67714a1b2daa06e3fb3293216d/obelisk-handoff migration/bd7c24fc03bf82e5a990515531a69147-a5e40d67714a1b2daa06e3fb3293216d/obelisk-upgrade migration/bd8f5fa095c3eb19b87d85247b36f1df-5d90abd974b4ec53091a8cb3fc2258ce/obelisk-handoff migration/bd8f5fa095c3eb19b87d85247b36f1df-5d90abd974b4ec53091a8cb3fc2258ce/obelisk-upgrade migration/be5a7b436cef0ae35cb074700d5f0d00-7c0ab1210424b615251ef57036d316c3/obelisk-handoff migration/be5a7b436cef0ae35cb074700d5f0d00-7c0ab1210424b615251ef57036d316c3/obelisk-upgrade migration/be615dc4d60c9d8710fbd120857c2fa1-1e376437f069662df26178e4a7873190/obelisk-handoff migration/be615dc4d60c9d8710fbd120857c2fa1-1e376437f069662df26178e4a7873190/obelisk-upgrade migration/beaa30317dadbef830531237279cbca4-a0f5ac2ff5c6a957e565f898a9fc8bfb/obelisk-handoff migration/beaa30317dadbef830531237279cbca4-a0f5ac2ff5c6a957e565f898a9fc8bfb/obelisk-upgrade migration/bf22c91488f01ebf503c1786ee805d0c-64ee9e40f4943e0122398e48019f5616/obelisk-handoff migration/bf22c91488f01ebf503c1786ee805d0c-64ee9e40f4943e0122398e48019f5616/obelisk-upgrade migration/bf3fbc8db3d6fd42a37982dfb5a30b5c-0c6127453069ad707e34ddfedb67e2f9/obelisk-handoff migration/bf3fbc8db3d6fd42a37982dfb5a30b5c-0c6127453069ad707e34ddfedb67e2f9/obelisk-upgrade migration/bf81caf2a7d528f86acacc1f5d2ffcfa-a5bbc0b9ceab9c3f7ca32a7da8c1f685/obelisk-handoff migration/bf81caf2a7d528f86acacc1f5d2ffcfa-a5bbc0b9ceab9c3f7ca32a7da8c1f685/obelisk-upgrade migration/c0811b664036c7996fcfd19fee241a10-a2bdbf1985b75442e78e84523c4ced5f/obelisk-handoff migration/c0811b664036c7996fcfd19fee241a10-a2bdbf1985b75442e78e84523c4ced5f/obelisk-upgrade migration/c0c1452986b8d4c181bb0c6c83c56a2f-bf22c91488f01ebf503c1786ee805d0c/obelisk-handoff migration/c0c1452986b8d4c181bb0c6c83c56a2f-bf22c91488f01ebf503c1786ee805d0c/obelisk-upgrade migration/c106f9398d5c203a1a296b85c7411bf9-1c2c93819c07f33ad899e39ec6769c3c/obelisk-handoff migration/c106f9398d5c203a1a296b85c7411bf9-1c2c93819c07f33ad899e39ec6769c3c/obelisk-upgrade migration/c118e1ee09ec8d9aa3edf04e211ae035-749df832c9305e1c6309a794b0c1b201/obelisk-handoff migration/c118e1ee09ec8d9aa3edf04e211ae035-749df832c9305e1c6309a794b0c1b201/obelisk-upgrade migration/c203adc5fed9bf79f67df43d72a4631a-e6980e47ba847245dfab61fb4d5b8ce5/obelisk-handoff migration/c203adc5fed9bf79f67df43d72a4631a-e6980e47ba847245dfab61fb4d5b8ce5/obelisk-upgrade migration/c2502429502b46133a749f021d188cf0-93f164bbd887f688fd49bb80afffccd6/obelisk-handoff migration/c2502429502b46133a749f021d188cf0-93f164bbd887f688fd49bb80afffccd6/obelisk-upgrade migration/c2d4eeb20f2b319a2d9dc5b6b0762f83-01c0ee6c93a3f9f69e097c41169927ac/obelisk-handoff migration/c2d4eeb20f2b319a2d9dc5b6b0762f83-01c0ee6c93a3f9f69e097c41169927ac/obelisk-upgrade migration/c2d581d48dd821a94d7906ca8f33b504-81223455459db28cdbc990c3d4e6eedd/obelisk-handoff migration/c2d581d48dd821a94d7906ca8f33b504-81223455459db28cdbc990c3d4e6eedd/obelisk-upgrade migration/c3298d81428117be58196b80853e3c7b-f68462dc88ed7fc451d1c757c040cfee/obelisk-handoff migration/c3298d81428117be58196b80853e3c7b-f68462dc88ed7fc451d1c757c040cfee/obelisk-upgrade migration/c3a8b70b1290031feb21880914cb081e-c2d581d48dd821a94d7906ca8f33b504/obelisk-handoff migration/c3a8b70b1290031feb21880914cb081e-c2d581d48dd821a94d7906ca8f33b504/obelisk-upgrade migration/c56de2f95c90def16704f62639246bbc-77a721a8fa97d1f84dd2af622089871b/obelisk-handoff migration/c56de2f95c90def16704f62639246bbc-77a721a8fa97d1f84dd2af622089871b/obelisk-upgrade migration/c5a306045ad998f906f80748fe18487f-e474bad466cd6e413fba753746eb58ef/obelisk-handoff migration/c5a306045ad998f906f80748fe18487f-e474bad466cd6e413fba753746eb58ef/obelisk-upgrade migration/c66bc5ba27dec52d144ceb0aa429e449-1b1686b03b41bd840ff46776cec7b33a/obelisk-handoff migration/c66bc5ba27dec52d144ceb0aa429e449-1b1686b03b41bd840ff46776cec7b33a/obelisk-upgrade migration/c67f206b6d2626eb6d36b00122b52784-3bc53f3a28cb8f403cc41c11a37eec5d/obelisk-handoff migration/c67f206b6d2626eb6d36b00122b52784-3bc53f3a28cb8f403cc41c11a37eec5d/obelisk-upgrade migration/c6baede3962454713b73acefcc92fe75-a96d491705acc139315264fd340d228f/obelisk-handoff migration/c6baede3962454713b73acefcc92fe75-a96d491705acc139315264fd340d228f/obelisk-upgrade migration/c6f38304ee53762590c67020f30d2ab4-58391ba73c13d922e8a12116b28caad2/obelisk-handoff migration/c6f38304ee53762590c67020f30d2ab4-58391ba73c13d922e8a12116b28caad2/obelisk-upgrade migration/c7dbf17de8aebd3043617ea6db790dcc-d35f6eb2d1b066d366c9a89ab26144e1/obelisk-handoff migration/c7dbf17de8aebd3043617ea6db790dcc-d35f6eb2d1b066d366c9a89ab26144e1/obelisk-upgrade migration/c801cbcf925c0a7b084ef152e3c08f8e-8d5dba70e93ae7e784ea238281842408/obelisk-handoff migration/c801cbcf925c0a7b084ef152e3c08f8e-8d5dba70e93ae7e784ea238281842408/obelisk-upgrade migration/c93529e579e64263fd91663216fd3fe7-12c8a24c34c2d8441f3181d179c2baab/obelisk-handoff migration/c93529e579e64263fd91663216fd3fe7-12c8a24c34c2d8441f3181d179c2baab/obelisk-upgrade migration/ca5ee8f372ecb07b09283081f0298733-36cdb1c744c3036c2932f01d5fadd9f5/obelisk-handoff migration/ca5ee8f372ecb07b09283081f0298733-36cdb1c744c3036c2932f01d5fadd9f5/obelisk-upgrade migration/ca88f98cf9fb63d2feaef7fc19b30eca-962e2bd1ae8d0c233f8da89ecebffe50/obelisk-handoff migration/ca88f98cf9fb63d2feaef7fc19b30eca-962e2bd1ae8d0c233f8da89ecebffe50/obelisk-upgrade migration/cb2197d0267b52385ee39bf4adcfe475-fbe0c6b69a63f3a44109a2c7526bc577/obelisk-handoff migration/cb2197d0267b52385ee39bf4adcfe475-fbe0c6b69a63f3a44109a2c7526bc577/obelisk-upgrade migration/cb2d040cc16752b1dc89eecf200ea798-5734398c41e4eb5bb58d933ed2e12041/obelisk-handoff migration/cb2d040cc16752b1dc89eecf200ea798-5734398c41e4eb5bb58d933ed2e12041/obelisk-upgrade migration/cb98f93880e6dea74014976977d6eb93-a7c7b80a875d1863f027c97eb433b884/obelisk-handoff migration/cb98f93880e6dea74014976977d6eb93-a7c7b80a875d1863f027c97eb433b884/obelisk-upgrade migration/cba28ee4b736cf8ed43cb342ccaef12e-8e01c7fee83aa74229a77772d8c928f3/obelisk-handoff migration/cba28ee4b736cf8ed43cb342ccaef12e-8e01c7fee83aa74229a77772d8c928f3/obelisk-upgrade migration/cbe155a3e856fb7eaad0bd18feb408be-4c9372bf9aa6ebed1ea20abf3dbb0075/obelisk-handoff migration/cbe155a3e856fb7eaad0bd18feb408be-4c9372bf9aa6ebed1ea20abf3dbb0075/obelisk-upgrade migration/cc4307fc88e3486b1c3f9ce07db95808-0fba399e046852d4ecf8e1dad831a2f9/obelisk-handoff migration/cc4307fc88e3486b1c3f9ce07db95808-0fba399e046852d4ecf8e1dad831a2f9/obelisk-upgrade migration/ccadc106cd03c9c32e77457d3adc77a1-aa8e6712fd46824acdea303068634078/obelisk-handoff migration/ccadc106cd03c9c32e77457d3adc77a1-aa8e6712fd46824acdea303068634078/obelisk-upgrade migration/cccf4140dc336263489bcf67c8c58f86-d50a30fd9643486c5848399d5ba7f1f1/obelisk-handoff migration/cccf4140dc336263489bcf67c8c58f86-d50a30fd9643486c5848399d5ba7f1f1/obelisk-upgrade migration/cd38e239c47fb92fabd867b7f86fc99a-7447d29f4712c72458c049cdb9380753/obelisk-handoff migration/cd38e239c47fb92fabd867b7f86fc99a-7447d29f4712c72458c049cdb9380753/obelisk-upgrade migration/cd5b54d21dd0fb868f48624d41021f47-0fe60df438daa8a2cca5f2b569e361a5/obelisk-handoff migration/cd5b54d21dd0fb868f48624d41021f47-0fe60df438daa8a2cca5f2b569e361a5/obelisk-upgrade migration/cd86427cc2d5b2e931d7ab03deb19d20-bd8f5fa095c3eb19b87d85247b36f1df/obelisk-handoff migration/cd86427cc2d5b2e931d7ab03deb19d20-bd8f5fa095c3eb19b87d85247b36f1df/obelisk-upgrade migration/ce7f0d15d71d36d4bcf4fbadcdfa1b58-4db97ca86399c557e5ee0d04d0838acc/obelisk-handoff migration/ce7f0d15d71d36d4bcf4fbadcdfa1b58-4db97ca86399c557e5ee0d04d0838acc/obelisk-upgrade migration/cffcc6cab6080a35b7bf7c5c7facd6bc-5631293b75143d170b8fca5579e15fee/obelisk-handoff migration/cffcc6cab6080a35b7bf7c5c7facd6bc-5631293b75143d170b8fca5579e15fee/obelisk-upgrade migration/d125109aa22f485d282f6ceb7cd5936e-9b9d73736773550dde7d36de2498b029/obelisk-handoff migration/d125109aa22f485d282f6ceb7cd5936e-9b9d73736773550dde7d36de2498b029/obelisk-upgrade migration/d16784e9a2d93db7f953941e3003fa8c-a262678b7d849de5a9732d06199666ae/obelisk-handoff migration/d16784e9a2d93db7f953941e3003fa8c-a262678b7d849de5a9732d06199666ae/obelisk-upgrade migration/d17b41a4669ac17960559614c830d69a-66f7a274206ad9f6d3c5701e4bcffc9d/obelisk-handoff migration/d17b41a4669ac17960559614c830d69a-66f7a274206ad9f6d3c5701e4bcffc9d/obelisk-upgrade migration/d1b3f5f5375558bf91d55c88547784b9-c0811b664036c7996fcfd19fee241a10/obelisk-handoff migration/d1b3f5f5375558bf91d55c88547784b9-c0811b664036c7996fcfd19fee241a10/obelisk-upgrade migration/d207ab99328b8ece5fb27fa1f4dbf9f6-e6a85005bd7e5d343bc23e17bfc345f6/obelisk-handoff migration/d207ab99328b8ece5fb27fa1f4dbf9f6-e6a85005bd7e5d343bc23e17bfc345f6/obelisk-upgrade migration/d2d86ce0ca16b143b49374302a9e9e2f-84f4d5c5491abb855d8dbe3acf3bc8e6/obelisk-handoff migration/d2d86ce0ca16b143b49374302a9e9e2f-84f4d5c5491abb855d8dbe3acf3bc8e6/obelisk-upgrade migration/d327ceb69d24e40dc11792840454cff9-de469e6488ddf192f2104ec0a030daf7/obelisk-handoff migration/d327ceb69d24e40dc11792840454cff9-de469e6488ddf192f2104ec0a030daf7/obelisk-upgrade migration/d35f6eb2d1b066d366c9a89ab26144e1-03b9747848d7f3e995b118f776ef96c7/obelisk-handoff migration/d35f6eb2d1b066d366c9a89ab26144e1-03b9747848d7f3e995b118f776ef96c7/obelisk-upgrade migration/d37d70fe5d7d11e68b59ce12022281c9-5f0d3f7480d67df7deebdb880726b356/obelisk-handoff migration/d37d70fe5d7d11e68b59ce12022281c9-5f0d3f7480d67df7deebdb880726b356/obelisk-upgrade migration/d40e0e3051a76c4c198cc11c2e8e4b7c-1859cc62bb2f89f528bb2aa170c36e84/obelisk-handoff migration/d40e0e3051a76c4c198cc11c2e8e4b7c-1859cc62bb2f89f528bb2aa170c36e84/obelisk-upgrade migration/d50a30fd9643486c5848399d5ba7f1f1-1f5b6e2a19c87d3820b953f942ab4a27/obelisk-handoff migration/d50a30fd9643486c5848399d5ba7f1f1-1f5b6e2a19c87d3820b953f942ab4a27/obelisk-upgrade migration/d532356dfb65a4c8a39452d2ebca2516-bf81caf2a7d528f86acacc1f5d2ffcfa/obelisk-handoff migration/d532356dfb65a4c8a39452d2ebca2516-bf81caf2a7d528f86acacc1f5d2ffcfa/obelisk-upgrade migration/d5ba6f13296205e5bd88ca2756107df0-26a2491fc8a9658751c1511c777a67bd/obelisk-handoff migration/d5ba6f13296205e5bd88ca2756107df0-26a2491fc8a9658751c1511c777a67bd/obelisk-upgrade migration/d62d6d443d9c2261b7e09664398aa005-fcc617e973168e1210379a6afe7171be/obelisk-handoff migration/d62d6d443d9c2261b7e09664398aa005-fcc617e973168e1210379a6afe7171be/obelisk-upgrade migration/d6a3ea5f7eb3c95f5e5ea09fb1330270-bc7688ff47218c0e13d02d917b03caa0/obelisk-handoff migration/d6a3ea5f7eb3c95f5e5ea09fb1330270-bc7688ff47218c0e13d02d917b03caa0/obelisk-upgrade migration/d6b34eba6ed4f89875a6615fe2c41ec2-3daecb03985f83d8af466a9e0541782b/obelisk-handoff migration/d6b34eba6ed4f89875a6615fe2c41ec2-3daecb03985f83d8af466a9e0541782b/obelisk-upgrade migration/d6c090699acd25fc60213ff4bd9eebcf-0298e61f6a03e553df08dcef03e27bd1/obelisk-handoff migration/d6c090699acd25fc60213ff4bd9eebcf-0298e61f6a03e553df08dcef03e27bd1/obelisk-upgrade migration/d6cacd7f4fab95c4b6aa2d6c1a4ad2a0-4d6197d8166de78f882376102e36300b/obelisk-handoff migration/d6cacd7f4fab95c4b6aa2d6c1a4ad2a0-4d6197d8166de78f882376102e36300b/obelisk-upgrade migration/d747c3d0620b2034aca44265dd1c8c86-eeb970434a53f4883c9f0255db555581/obelisk-handoff migration/d747c3d0620b2034aca44265dd1c8c86-eeb970434a53f4883c9f0255db555581/obelisk-upgrade migration/d8adb57b2f2266e128ebb6f6d7e65920-ccadc106cd03c9c32e77457d3adc77a1/obelisk-handoff migration/d8adb57b2f2266e128ebb6f6d7e65920-ccadc106cd03c9c32e77457d3adc77a1/obelisk-upgrade migration/da23605ee4058c8474687e74a3999354-dfd7dbceea141c60bbfca962d50c1c06/obelisk-handoff migration/da23605ee4058c8474687e74a3999354-dfd7dbceea141c60bbfca962d50c1c06/obelisk-upgrade migration/db327f87e60d4e59bdbfd482e5abe985-eb99c1a66237ba99cd1f6d244cafb9cc/obelisk-handoff migration/db327f87e60d4e59bdbfd482e5abe985-eb99c1a66237ba99cd1f6d244cafb9cc/obelisk-upgrade migration/dc95f39fb27634ccbca7318ff2065608-0fb3a912a8aaf5ef6f734a25f0bce7e2/obelisk-handoff migration/dc95f39fb27634ccbca7318ff2065608-0fb3a912a8aaf5ef6f734a25f0bce7e2/obelisk-upgrade migration/dd6ca52a58ea6cda7b3eaa2e87bb13d9-a6d50c7e756dfd1e3ae891111b81a1ae/obelisk-handoff migration/dd6ca52a58ea6cda7b3eaa2e87bb13d9-a6d50c7e756dfd1e3ae891111b81a1ae/obelisk-upgrade migration/ddaa8e0e42a1ef00154d580a390c9f17-53d29061537ddaf7530aef88624ab266/obelisk-handoff migration/ddaa8e0e42a1ef00154d580a390c9f17-53d29061537ddaf7530aef88624ab266/obelisk-upgrade migration/de469e6488ddf192f2104ec0a030daf7-3da7d4a3b507d18097a90becf4dde9aa/obelisk-handoff migration/de469e6488ddf192f2104ec0a030daf7-3da7d4a3b507d18097a90becf4dde9aa/obelisk-upgrade migration/df71cd82e801ca701bf4bc44b80b6d50-f423ecd4d096de9dca37a67b8b4143eb/obelisk-handoff migration/df71cd82e801ca701bf4bc44b80b6d50-f423ecd4d096de9dca37a67b8b4143eb/obelisk-upgrade migration/dfd7dbceea141c60bbfca962d50c1c06-030ed18dacf3571cbb9e3e7d9d99627b/obelisk-handoff migration/dfd7dbceea141c60bbfca962d50c1c06-030ed18dacf3571cbb9e3e7d9d99627b/obelisk-upgrade migration/e01cc01684deaf4c75ad5d65270bf3d5-c7dbf17de8aebd3043617ea6db790dcc/obelisk-handoff migration/e01cc01684deaf4c75ad5d65270bf3d5-c7dbf17de8aebd3043617ea6db790dcc/obelisk-upgrade migration/e1ef432db54d9a6daa9bdeeb543262ae-2ba356b187db8db13b8aa40f43ca025f/obelisk-handoff migration/e1ef432db54d9a6daa9bdeeb543262ae-2ba356b187db8db13b8aa40f43ca025f/obelisk-upgrade migration/e22c51145e08d4a089003460ae80a7f9-42357310c09e345f9360259c6c4102f2/obelisk-handoff migration/e22c51145e08d4a089003460ae80a7f9-42357310c09e345f9360259c6c4102f2/obelisk-upgrade migration/e24a771ee59f24e45afc0a27307f2070-2eb907820012f77e60350430d89631fe/obelisk-handoff migration/e24a771ee59f24e45afc0a27307f2070-2eb907820012f77e60350430d89631fe/obelisk-upgrade migration/e2706f337218a12a3bdddd18fa3f4cfd-475f9a0d63e84e9cf13b8be3986cb603/obelisk-handoff migration/e2706f337218a12a3bdddd18fa3f4cfd-475f9a0d63e84e9cf13b8be3986cb603/obelisk-upgrade migration/e2b2d878b0ba6eb653b194523bf0a0e0-5f307639ccf6a64309166bfe58037397/obelisk-handoff migration/e2b2d878b0ba6eb653b194523bf0a0e0-5f307639ccf6a64309166bfe58037397/obelisk-upgrade migration/e2be519915794ef130249f2be7640382-455279b6974b96a673613cd0ccc8ed54/obelisk-handoff migration/e2be519915794ef130249f2be7640382-455279b6974b96a673613cd0ccc8ed54/obelisk-upgrade migration/e323ce1352e512109f1609276fb509b4-2c1521e5a5be64e6d28a9fdae950cd76/obelisk-handoff migration/e323ce1352e512109f1609276fb509b4-2c1521e5a5be64e6d28a9fdae950cd76/obelisk-upgrade migration/e327773e1525eaa1eb2112dff8f41b26-f595b01939b4c87b7c146ea9ff331b39/obelisk-handoff migration/e327773e1525eaa1eb2112dff8f41b26-f595b01939b4c87b7c146ea9ff331b39/obelisk-upgrade migration/e3b3014d7e0dc983fe118d32546654e5-063665b78b6705e7de952f73fa9797bf/obelisk-handoff migration/e3b3014d7e0dc983fe118d32546654e5-063665b78b6705e7de952f73fa9797bf/obelisk-upgrade migration/e4051219d89b3c9a8350fe824ad96a82-166c5f8e4a0f1dfd227b075a96237386/obelisk-handoff migration/e4051219d89b3c9a8350fe824ad96a82-166c5f8e4a0f1dfd227b075a96237386/obelisk-upgrade migration/e4513b485b6ba8b7f4bd34b12458ff0c-3c80eccfe80d0abd36b07bb11e69fc7a/obelisk-handoff migration/e4513b485b6ba8b7f4bd34b12458ff0c-3c80eccfe80d0abd36b07bb11e69fc7a/obelisk-upgrade migration/e474bad466cd6e413fba753746eb58ef-f19b3699616f3b1de3a277f9cba617c7/obelisk-handoff migration/e474bad466cd6e413fba753746eb58ef-f19b3699616f3b1de3a277f9cba617c7/obelisk-upgrade migration/e4b89dd259f3831bc60b56147b3586a6-98da197f133bca81e533ab5ffbf4c82d/obelisk-handoff migration/e4b89dd259f3831bc60b56147b3586a6-98da197f133bca81e533ab5ffbf4c82d/obelisk-upgrade migration/e609d945b642fd9d4ce99931e3699db7-85c2c4fb8472d50eaa97aed0bdc9b142/obelisk-handoff migration/e609d945b642fd9d4ce99931e3699db7-85c2c4fb8472d50eaa97aed0bdc9b142/obelisk-upgrade migration/e6980e47ba847245dfab61fb4d5b8ce5-58f9d23d2cede2081dc6f6cfa2283f60/obelisk-handoff migration/e6980e47ba847245dfab61fb4d5b8ce5-58f9d23d2cede2081dc6f6cfa2283f60/obelisk-upgrade migration/e6a85005bd7e5d343bc23e17bfc345f6-98f9e0bbd21e36b0f4daa440d11e7177/obelisk-handoff migration/e6a85005bd7e5d343bc23e17bfc345f6-98f9e0bbd21e36b0f4daa440d11e7177/obelisk-upgrade migration/e7288bb723a4e5b7139ac67842963287-7b75ffdcd86b5a330d9c325ad5767393/obelisk-handoff migration/e7288bb723a4e5b7139ac67842963287-7b75ffdcd86b5a330d9c325ad5767393/obelisk-upgrade migration/e7385c9eae2b807a483b73be4295b207-fb02559b6f723d599e12931a81be3a1b/obelisk-handoff migration/e7385c9eae2b807a483b73be4295b207-fb02559b6f723d599e12931a81be3a1b/obelisk-upgrade migration/e7667778f2ab3055aa3ccc68443d14df-7adece557941a7d7ac7c150f77f758be/obelisk-handoff migration/e7667778f2ab3055aa3ccc68443d14df-7adece557941a7d7ac7c150f77f758be/obelisk-upgrade migration/e78ec85bec14f4784faeef4d8d3e4d0a-e7667778f2ab3055aa3ccc68443d14df/obelisk-handoff migration/e78ec85bec14f4784faeef4d8d3e4d0a-e7667778f2ab3055aa3ccc68443d14df/obelisk-upgrade migration/e7b17aa124e17c357cead8081a58f089-ac5e28caddd6832d0bf1f7445a4a6a28/obelisk-handoff migration/e7b17aa124e17c357cead8081a58f089-ac5e28caddd6832d0bf1f7445a4a6a28/obelisk-upgrade migration/e7b566495114e160f1f4d722b7ed8174-7cf814f7404638f1c1be662a24d7cfea/obelisk-handoff migration/e7b566495114e160f1f4d722b7ed8174-7cf814f7404638f1c1be662a24d7cfea/obelisk-upgrade migration/e92786eaf56c32fd6b452c4a841d6317-f24a7fb6e3261c4919ea2a2fee83ed6b/obelisk-handoff migration/e92786eaf56c32fd6b452c4a841d6317-f24a7fb6e3261c4919ea2a2fee83ed6b/obelisk-upgrade migration/e9ec84bfe7099b713c0fda32308f5815-f0a064ca5f709233204168c136b99a7e/obelisk-handoff migration/e9ec84bfe7099b713c0fda32308f5815-f0a064ca5f709233204168c136b99a7e/obelisk-upgrade migration/eb99c1a66237ba99cd1f6d244cafb9cc-da23605ee4058c8474687e74a3999354/obelisk-handoff migration/eb99c1a66237ba99cd1f6d244cafb9cc-da23605ee4058c8474687e74a3999354/obelisk-upgrade migration/ebb95c5864d1d1d2f78fbf7cc8235dac-ba4829dc61dcc12bcafd8de5fc8a76dc/obelisk-handoff migration/ebb95c5864d1d1d2f78fbf7cc8235dac-ba4829dc61dcc12bcafd8de5fc8a76dc/obelisk-upgrade migration/ec11d10a6131abca9222a8f8026fb5e4-f3d494ffee7091cd588bbdd2fd9bcdf9/obelisk-handoff migration/ec11d10a6131abca9222a8f8026fb5e4-f3d494ffee7091cd588bbdd2fd9bcdf9/obelisk-upgrade migration/ec94619fa3f25db1ca84d179e47db1ca-23af4d9671962484de53f537a0626d83/obelisk-handoff migration/ec94619fa3f25db1ca84d179e47db1ca-23af4d9671962484de53f537a0626d83/obelisk-upgrade migration/ed95a99cdde4adc90c6a8e2de82410eb-1c4fc23cbf5653613c6060668e065f37/obelisk-handoff migration/ed95a99cdde4adc90c6a8e2de82410eb-1c4fc23cbf5653613c6060668e065f37/obelisk-upgrade migration/ee3dccc89ea6fdaaf9c1146b92861e90-f3eac05465851232f8174a7a347d1c4b/obelisk-handoff migration/ee3dccc89ea6fdaaf9c1146b92861e90-f3eac05465851232f8174a7a347d1c4b/obelisk-upgrade migration/eeb970434a53f4883c9f0255db555581-a2b33f8dc1f90b8dddce942b174be5b8/obelisk-handoff migration/eeb970434a53f4883c9f0255db555581-a2b33f8dc1f90b8dddce942b174be5b8/obelisk-upgrade migration/ef33c06500054e09c97eee9e9c55485a-367616bd36eda757f251a5e8e9096acc/obelisk-handoff migration/ef33c06500054e09c97eee9e9c55485a-367616bd36eda757f251a5e8e9096acc/obelisk-upgrade migration/ef6aebc8cba2af6c4f930c981b06e8ac-d17b41a4669ac17960559614c830d69a/obelisk-handoff migration/ef6aebc8cba2af6c4f930c981b06e8ac-d17b41a4669ac17960559614c830d69a/obelisk-upgrade migration/f0a064ca5f709233204168c136b99a7e-ef6aebc8cba2af6c4f930c981b06e8ac/obelisk-handoff migration/f0a064ca5f709233204168c136b99a7e-ef6aebc8cba2af6c4f930c981b06e8ac/obelisk-upgrade migration/f15c9c2f894c8cc4fac07e2cdef47180-94252585266fa745a91733888e2f50b7/obelisk-handoff migration/f15c9c2f894c8cc4fac07e2cdef47180-94252585266fa745a91733888e2f50b7/obelisk-upgrade migration/f19b3699616f3b1de3a277f9cba617c7-4d85ee8cdb0db20a5662b09567a2bbe7/obelisk-handoff migration/f19b3699616f3b1de3a277f9cba617c7-4d85ee8cdb0db20a5662b09567a2bbe7/obelisk-upgrade migration/f24a7fb6e3261c4919ea2a2fee83ed6b-f913f01e90549c56a8b05f8100cfa21d/obelisk-handoff migration/f24a7fb6e3261c4919ea2a2fee83ed6b-f913f01e90549c56a8b05f8100cfa21d/obelisk-upgrade migration/f2a9ba4a93c3a04acbee2211bca9e27a-ec94619fa3f25db1ca84d179e47db1ca/obelisk-handoff migration/f2a9ba4a93c3a04acbee2211bca9e27a-ec94619fa3f25db1ca84d179e47db1ca/obelisk-upgrade migration/f391c6a74ee14217ce4565c278fceed6-e7288bb723a4e5b7139ac67842963287/obelisk-handoff migration/f391c6a74ee14217ce4565c278fceed6-e7288bb723a4e5b7139ac67842963287/obelisk-upgrade migration/f3d494ffee7091cd588bbdd2fd9bcdf9-b68a785fbf27a63334ef1d1fe82b2dac/obelisk-handoff migration/f3d494ffee7091cd588bbdd2fd9bcdf9-b68a785fbf27a63334ef1d1fe82b2dac/obelisk-upgrade migration/f3eac05465851232f8174a7a347d1c4b-1629d0d70e360df6b2280fac36d21e8a/obelisk-handoff migration/f3eac05465851232f8174a7a347d1c4b-1629d0d70e360df6b2280fac36d21e8a/obelisk-upgrade migration/f3ec62d09836804e39fad9d814137845-ef33c06500054e09c97eee9e9c55485a/obelisk-handoff migration/f3ec62d09836804e39fad9d814137845-ef33c06500054e09c97eee9e9c55485a/obelisk-upgrade migration/f41b690c74938e347cf042cee2d4fc72-7fc381538805adac19c54b73ea118601/obelisk-handoff migration/f41b690c74938e347cf042cee2d4fc72-7fc381538805adac19c54b73ea118601/obelisk-upgrade migration/f423ecd4d096de9dca37a67b8b4143eb-469a31d20d69da72e6a3a3ea2bb02f9d/obelisk-handoff migration/f423ecd4d096de9dca37a67b8b4143eb-469a31d20d69da72e6a3a3ea2bb02f9d/obelisk-upgrade migration/f595b01939b4c87b7c146ea9ff331b39-4da182e21be35feeee484dc85be7a075/obelisk-handoff migration/f595b01939b4c87b7c146ea9ff331b39-4da182e21be35feeee484dc85be7a075/obelisk-upgrade migration/f68462dc88ed7fc451d1c757c040cfee-589eb89cdb09655c5edde4cd2a4deb80/obelisk-handoff migration/f68462dc88ed7fc451d1c757c040cfee-589eb89cdb09655c5edde4cd2a4deb80/obelisk-upgrade migration/f790ac9400501511b4ee045e22bc5fe1-a826f01311fe00ef5cf87568832605d3/obelisk-handoff migration/f790ac9400501511b4ee045e22bc5fe1-a826f01311fe00ef5cf87568832605d3/obelisk-upgrade migration/f8e51a9e8ac6598f7c073b09e4ba09b5-ff57aebc7325bd7e02b436fec79e799c/obelisk-handoff migration/f8e51a9e8ac6598f7c073b09e4ba09b5-ff57aebc7325bd7e02b436fec79e799c/obelisk-upgrade migration/f8eee9431c8b7a767d96da0a8cfae95d-9e05cc6b81c6380ba0ac59bad1021cac/obelisk-handoff migration/f8eee9431c8b7a767d96da0a8cfae95d-9e05cc6b81c6380ba0ac59bad1021cac/obelisk-upgrade migration/f913f01e90549c56a8b05f8100cfa21d-001efbbe866b66eebc6ee1ea0a906f2d/obelisk-handoff migration/f913f01e90549c56a8b05f8100cfa21d-001efbbe866b66eebc6ee1ea0a906f2d/obelisk-upgrade migration/f9716ad47c84e0b7ac7d426e8ad059f3-ec11d10a6131abca9222a8f8026fb5e4/obelisk-handoff migration/f9716ad47c84e0b7ac7d426e8ad059f3-ec11d10a6131abca9222a8f8026fb5e4/obelisk-upgrade migration/f98b82f5d142ce83733a3f18bdacb138-35acc1e0c4d9c02d60abd116f3df84ee/obelisk-handoff migration/f98b82f5d142ce83733a3f18bdacb138-35acc1e0c4d9c02d60abd116f3df84ee/obelisk-upgrade migration/f9ad863c0bebc103f8b81afdf82e6293-c6f38304ee53762590c67020f30d2ab4/obelisk-handoff migration/f9ad863c0bebc103f8b81afdf82e6293-c6f38304ee53762590c67020f30d2ab4/obelisk-upgrade migration/fa18f7522903a21b615dbee24c26bfbe-0535e06dd0d61f3e6970b491a17cf1f8/obelisk-handoff migration/fa18f7522903a21b615dbee24c26bfbe-0535e06dd0d61f3e6970b491a17cf1f8/obelisk-upgrade migration/fb02559b6f723d599e12931a81be3a1b-71a47d4d6856c1956c0d1c9de9af231f/obelisk-handoff migration/fb02559b6f723d599e12931a81be3a1b-71a47d4d6856c1956c0d1c9de9af231f/obelisk-upgrade migration/fb374b0721716a1e849e64daf6da73c4-f8e51a9e8ac6598f7c073b09e4ba09b5/obelisk-handoff migration/fb374b0721716a1e849e64daf6da73c4-f8e51a9e8ac6598f7c073b09e4ba09b5/obelisk-upgrade migration/fb5110e527cf77c568bcae7d435ee035-53fdf819333b86dfb485bf16a8f28db2/obelisk-handoff migration/fb5110e527cf77c568bcae7d435ee035-53fdf819333b86dfb485bf16a8f28db2/obelisk-upgrade migration/fb81153791e49cd00850e91ff7418018-9b33a49f0c978e27b752fa457aca97cc/obelisk-handoff migration/fb81153791e49cd00850e91ff7418018-9b33a49f0c978e27b752fa457aca97cc/obelisk-upgrade migration/fbb3eb3209281031dc5183d289eb4e75-8c7718f94e2676c957fe844b7dc2637c/obelisk-handoff migration/fbb3eb3209281031dc5183d289eb4e75-8c7718f94e2676c957fe844b7dc2637c/obelisk-upgrade migration/fbe0c6b69a63f3a44109a2c7526bc577-c3a8b70b1290031feb21880914cb081e/obelisk-handoff migration/fbe0c6b69a63f3a44109a2c7526bc577-c3a8b70b1290031feb21880914cb081e/obelisk-upgrade migration/fc42c5fc24031fc6a8836a10cfb45143-d125109aa22f485d282f6ceb7cd5936e/obelisk-handoff migration/fc42c5fc24031fc6a8836a10cfb45143-d125109aa22f485d282f6ceb7cd5936e/obelisk-upgrade migration/fca48edfdaa31b036176b97b04384682-2df092178e167b474dd08dfa46ec3a49/obelisk-handoff migration/fca48edfdaa31b036176b97b04384682-2df092178e167b474dd08dfa46ec3a49/obelisk-upgrade migration/fcc617e973168e1210379a6afe7171be-ed95a99cdde4adc90c6a8e2de82410eb/obelisk-handoff migration/fcc617e973168e1210379a6afe7171be-ed95a99cdde4adc90c6a8e2de82410eb/obelisk-upgrade migration/ff1105290f89350bc9deb6eb907e0a53-0c991bc3c06801f72df48486ee78e350/obelisk-handoff migration/ff1105290f89350bc9deb6eb907e0a53-0c991bc3c06801f72df48486ee78e350/obelisk-upgrade migration/ff57aebc7325bd7e02b436fec79e799c-9f71fc9d2ed805fecbc8c4a3aae5685b/obelisk-handoff migration/ff57aebc7325bd7e02b436fec79e799c-9f71fc9d2ed805fecbc8c4a3aae5685b/obelisk-upgrade migration/ffa62158ed6fdece012980e4ad25e6ac-959ae2925bcd2b5beff631a8e7aeaf00/obelisk-handoff migration/ffa62158ed6fdece012980e4ad25e6ac-959ae2925bcd2b5beff631a8e7aeaf00/obelisk-upgrade nixpkgs-overlays/default.nix+15 release.nix+7−41 scripts/ghcid-this-lib−4 skeleton/.gitignore+13−5 skeleton/backend/backend.cabal+3−6 skeleton/backend/src-bin/main.hs+3−17 skeleton/backend/src/Backend.hs+6−6 skeleton/cabal.project+1 skeleton/common/common.cabal+5−1 skeleton/common/src/Common/Api.hs+1−1 skeleton/common/src/Common/Route.hs+47 skeleton/config/common/example+1 skeleton/default.nix+16−3 skeleton/devel/Devel.hs−10 skeleton/frontend/frontend.cabal+14−7 skeleton/frontend/src-bin/main.hs+7−2 skeleton/frontend/src/Frontend.hs+37−8 skeleton/static/main.css+3
.github/pull_request_template.mdnew file+10
@@ -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 @@
22**/.cabal-sandbox
33**/cabal.sandbox.config
44result
5+result-*
56*.o
67*.hi
7−
88TAGS
99tags
1010ctags
1111dist-newstyle
1212cabal.project.local
1313.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
22
3−Thanks for taking the time to contribute!
3+Contributions and issue reports are encouraged and appreciated!
44
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)
612
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:
755```bash
856$(nix-build -A selftest --no-out-link)
957```
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+152−109
@@ -1,129 +1,127 @@
11# Obelisk
22
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)
45
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)
512- [Installing Obelisk](#installing-obelisk)
613- [Developing an Obelisk project](#developing-an-obelisk-project)
14+ - [IDE Support](#ide-support)
715- [Deploying](#deploying)
16+ - [Default EC2 Deployment](#default-ec2-deployment)
17+ - [Custom Non-EC2 Deployment](#custom-non-ec2-deployment)
18+ - [VirtualBox Deployment](#virtualbox-deployment)
819 - [Locally](#locally)
9− - [EC2](#ec2)
20+ - [From macOS](#from-macos)
21+ - [Deploying an updated version](#deploying-an-updated-version)
1022- [Mobile](#mobile)
1123 - [iOS](#ios)
1224 - [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+
1338
1439## Installing Obelisk
40+
15411. [Install Nix](https://nixos.org/nix/).
1642 If you already have Nix installed, make sure you have version 2.0 or higher. To check your current version, run `nix-env --version`.
17431. Set up nix caches
1844 1. If you are running NixOS, add this to `/etc/nixos/configuration.nix`:
19− ```
20− nix.binaryCaches = [ "https://cache.nixos.org/" "https://nixcache.reflex-frp.org" ];
45+ ```nix
46+ nix.binaryCaches = [ "https://nixcache.reflex-frp.org" ];
2147 nix.binaryCachePublicKeys = [ "ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=" ];
2248 ```
23− 1. If you are using another operating system or linux distribution, ensure that these lines are present in `/etc/nix/nix.conf`:
49+ and rebuild your NixOS configuration (e.g. `sudo nixos-rebuild switch`).
50+ 1. If you are using another operating system or Linux distribution, ensure that these lines are present in your Nix configuration file (`/etc/nix/nix.conf` on most systems; [see full list](https://nixos.org/nix/manual/#sec-conf-file)):
51+ ```nix
52+ binary-caches = https://cache.nixos.org https://nixcache.reflex-frp.org
53+ binary-cache-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
54+ binary-caches-parallel-connections = 40
2455 ```
25− sandbox = true
26− substituters = https://cache.nixos.org https://nixcache.reflex-frp.org
27− trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= ryantrinkle.com-1:JJiAKaRv9mWgpVAz8dwewnZe0AzzEAzPkagE9SP5NWI=
28− ```
29− * If you are on MacOS, restart the nix daemon
30− ```
31− sudo launchctl stop org.nixos.nix-daemon
32− sudo launchctl start org.nixos.nix-daemon
33− ```
34−1. Install obelisk: `nix-env -f https://github.com/obsidiansystems/obelisk/archive/master.tar.gz -iA command`
35−
36−### Contributing to Obelisk
37−
38−When developing on obelisk itself you may launch `ghcid` for the corresponding project as follows. For example to launch ghcid for `lib/backend` project:
39−
40−```
41−nix-shell -A obelisk.obelisk-backend.env --run "cd lib/backend && ghcid -c 'cabal new-repl'"
42−```
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:
57+ ```nix
58+ sandbox = true
59+ ```
60+ * If you're on MacOS, disable sandboxing (there are still some impure dependencies for now) by adding the following:
61+ ```nix
62+ sandbox = false
63+ ```
64+ then restart the nix daemon
65+ ```bash
66+ sudo launchctl stop org.nixos.nix-daemon
67+ sudo launchctl start org.nixos.nix-daemon
68+ ```
69+1. Install obelisk:
70+ ```bash
71+ nix-env -f https://github.com/obsidiansystems/obelisk/archive/master.tar.gz -iA command
72+ ```
4373
44−Or to launch ghcid for `lib/command` project:
74+### Accessing private repositories
4575
46−```
47−nix-shell -A obelisk.obelisk-command.env --run "cd lib/command && ghcid -c 'cabal new-repl'"
48−```
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:
4979
50−### Accessing private repositories
51−To allow the Nix builder to access private git repositories, follow these steps:
52−
53−1. [Get set up to connect to GitHub with SSH](https://help.github.com/articles/connecting-to-github-with-ssh/)
54−1. [Create a GitHub personal access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/)
55−1. Set environment variables:
56− * NixOS: Add this to `/etc/nixos/configuration.nix`:
57− ```
58− nix.envVars = {
59− NIX_GITHUB_PRIVATE_USERNAME = "your-github-username";
60− NIX_GITHUB_PRIVATE_PASSWORD = "your-github-personal-access-token";
61− };
62− ```
63− * MacOS:
64− ```
65− sudo launchctl setenv NIX_GITHUB_PRIVATE_USERNAME "your-github-username"
66− sudo launchctl setenv NIX_GITHUB_PRIVATE_PASSWORD "your-github-personal-access"
67− sudo launchctl stop org.nixos.nix-daemon
68− sudo launchctl start org.nixos.nix-daemon
69− ```
70−1. `nix-env -i hub` OR `nix-env -iA nixos.gitAndTools.hub`
71−1. `hub clone yourusername/yourproject`
72− * NOTE: you must authenticate with hub at least once, because the `ob` command uses `hub` for authentication
73− #TODO: Make ob do this itself (either invoke hub automatically or not depend on hub)
80+- [GitHub](https://help.github.com/articles/connecting-to-github-with-ssh/)
81+- [GitLab](https://docs.gitlab.com/ee/gitlab-basics/create-your-ssh-keys.html)
7482
7583## Developing an Obelisk project
7684
7785To create a new Obelisk project, go to an empty directory and run:
7886
79−```
87+```bash
8088ob init
8189```
8290
8391Obelisk 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:
8492
85−```
93+```bash
8694ob run
8795```
8896
89−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.
9099
91100Every 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.
92101
93−## Deploying
94−
95−### Locally
96−
97−Build everything:
102+### IDE Support
98103
99−```
100−nix-build -A exe -o result-exe
101−```
104+Obelisk officially supports terminal-based feedback (akin to [`ghcid`](https://github.com/ndmitchell/ghcid)) in `ob run` and `ob watch`.
102105
103−Run the server:
104−
105−```
106−cd result-exe
107−./backend
108−```
106+## Deploying
109107
110−### EC2
108+### Default EC2 Deployment
111109
112−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)).
113111
114112First create a new EC2 instance:
115113
116−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))
1171151. In the instance configuration wizard ensure that your instance has at least 1GB RAM and 10GB disk space.
1181161. When prompted save your AWS private key (`~/myaws.pem`) somewhere safe. We'll need it later during deployment.
119−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.
120118
121119At this stage your instance should be booting and become accessible shortly. Note down the hostname of your EC2 instance.
122120
123121Now go to your Obelisk project directory (`~/code/myapp`), and initialize a deployment config (`~/code/myapp-deploy`):
124122Your 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.
125123
126−```
124+```bash
127125cd ~/code/myapp
128126SERVER=ec2-35-183-22-197.ca-central-1.compute.amazonaws.com
129127ROUTE=https://myapp.com # Publicly accessible route to your app
@@ -136,24 +134,74 @@ ob deploy init \
136134 ~/code/myapp-deploy
137135```
138136
139−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.
140138
141−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.
142140
143−```
141+Next, go to the deployment directory that you just initialized and deploy!
142+
143+```bash
144144cd ~/code/myapp-deploy
145145ob deploy push
146146```
147147
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.
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`.
149+
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:
149194
150−At this point you are done. Your app will be accessible at `${ROUTE}`.
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.
151199
152200### Deploying an updated version
153201
154202If 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:
155203
156−```
204+```bash
157205cd ~/code/myapp-deploy
158206ob deploy update
159207ob deploy push
@@ -173,20 +221,20 @@ Your account must also belong to an Apple Developer Team, if you want to access
1732211. Click accept to authorize on both the computer and the iPhone.
174222
175223##### Xcode
176−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.
177225
178226These 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`
179227
180228More recent Xcodes should also work, as long as one of the SDKs mentioned above has been used.
181229To 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.
182−```
230+```bash
183231open -W Xcode_9.2.xip
184232sudo 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
185233```
186234
187235
188236You can verify that you have correct versions by running
189−```
237+```bash
190238xcodebuild -showsdks
191239```
192240
@@ -212,7 +260,7 @@ Ensure that `bundleIdentifier` matches the App ID of the development profile, or
2122601. Connect the registered iPhone.
2132611. Find your Apple Team ID in the [developer portal](https://developer.apple.com/account/#/membership).
2142621. Run the deploy command with your Team ID:
215−```
263+```bash
216264result-ios/bin/deploy [TEAM_ID]
217265# or in debug mode via lldb:
218266result-ios/bin/deploy [TEAM_ID] -d
@@ -222,7 +270,7 @@ result-ios/bin/deploy [TEAM_ID] -d
2222701. Go to [developer portal - distribution profiles](https://developer.apple.com/account/ios/profile/production).
223271Create and download a distribution profile.
2242721. Run the package script with your TEAM ID and your distribution profile to create a `.ipa`:
225−```
273+```bash
226274result-ios/bin/package [TEAM_ID] /path/to/output/.ipa /path/to/profile/file
227275```
228276
@@ -235,7 +283,10 @@ It's also possible to inspect iOS WkWebView apps once they are installed in the
235283
236284### Android
237285
286+NOTE: Currently Android builds are only supported on Linux.
287+
2382881. 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.
2392901. Run `nix-build -A android.frontend -o result-android` to build the Android app.
2402911. A debug version of the app should be generated at `result-android/android-app-debug.apk`
241292
@@ -245,39 +296,31 @@ Now deploy the built apk file to your Android device:
2452961. Connect the device using USB (be sure to confirm any security prompts on the device)
2462971. Run the deploy script: `result-android/bin/deploy`
247298
248−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:
249301
250−#### 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
251305
252−##### 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`.
253307
254−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).
255309
256−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`.
257311
258−```
259−nix-shell -p androidenv.platformTools --run "keytool -genkey -v -keystore myandroidkey.jks -keyalg RSA -keysize 2048 -validity 10000 -alias myandroidalias"
260−```
312+#### Releasing to Play Store
261313
262−(Besure to give an appropriate keystore filename and key alias string above.)
314+##### Build a release version
263315
264−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.
265317
266−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:
267318
268−```nix
269− ...
270− android.applicationId = "com.example.myapp";
271− android.displayName = "My App";
272− android.releaseKey =
273− { storeFile = /path/to/myandroidkey.jks;
274− storePassword = "abcd1234";
275− keyAlias = "myandroidalias";
276− keyPassword = "abcd1234";
277− };
278− ...
279−```
319+## Frequently Asked Questions (FAQ)
280320
281−##### Build a release version
321+Refer to [FAQ](FAQ.md).
282322
283−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+331−258
@@ -1,319 +1,392 @@
11{ system ? builtins.currentSystem
22, 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
49}:
510let
6− getReflexPlatform = sys: import ./dep/reflex-platform { inherit iosSdkVersion; system = sys; };
7− reflex-platform = getReflexPlatform system;
11+ reflex-platform = getReflexPlatform { inherit system; };
812 inherit (reflex-platform) hackGet nixpkgs;
913 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− nixStable
25− openssh
26− ];
27−
28− #TODO: Upstream
29− # Modify a Haskell package to add completion scripts for the given
30− # executable produced by it. These completion scripts will be picked up
31− # automatically if the resulting derivation is installed, e.g. by
32− # `nix-env -i`.
33− addOptparseApplicativeCompletionScripts = exeName: pkg: overrideCabal pkg (drv: {
34− postInstall = (drv.postInstall or "") + ''
35− BASH_COMP_DIR="$out/share/bash-completion/completions"
36− mkdir -p "$BASH_COMP_DIR"
37− "$out/bin/${exeName}" --bash-completion-script "$out/bin/${exeName}" >"$BASH_COMP_DIR/ob"
38−
39− ZSH_COMP_DIR="$out/share/zsh/vendor-completions"
40− mkdir -p "$ZSH_COMP_DIR"
41− "$out/bin/${exeName}" --zsh-completion-script "$out/bin/${exeName}" >"$ZSH_COMP_DIR/_ob"
42−
43− FISH_COMP_DIR="$out/share/fish/vendor_completions.d"
44− mkdir -p "$FISH_COMP_DIR"
45− "$out/bin/${exeName}" --fish-completion-script "$out/bin/${exeName}" >"$FISH_COMP_DIR/ob.fish"
46− '';
47− });
4814
49− # The haskell environment used to build Obelisk itself, e.g. the 'ob' command
50− ghcObelisk = reflex-platform.ghc.override {
51− overrides = composeExtensions defaultHaskellOverrides (self: super: {
52− mkDerivation = args: super.mkDerivation (args // {
53− enableLibraryProfiling = profiling;
54− });
55−
56− # Dynamic linking with split objects dramatically increases startup time (about 0.5 seconds on a decent machine with SSD)
57− obelisk-command = addOptparseApplicativeCompletionScripts "ob" (justStaticExecutables' super.obelisk-command);
58− });
59− };
15+ inherit (import dep/gitignore.nix { inherit (nixpkgs) lib; }) gitignoreSource;
6016
61− fixUpstreamPkgs = self: super: {
62− algebraic-graphs = pkgs.haskell.lib.doJailbreak
63− (self.callCabal2nix "algebraic-graphs" (pkgs.fetchFromGitHub {
64− owner = "snowleopard";
65− repo = "alga";
66− rev = "480a73137e9b38ad3f1bc2c628847953d2fb3e25";
67− sha256 = "0dpwi5ffs88brl3lz51bwb004c6zm8ds8pkw1vzsg2a6aaiyhlzl";
68− }) {});
69−
70− monoidal-containers =
71− let src = pkgs.fetchFromGitHub {
72− owner = "obsidiansystems";
73− repo = "monoidal-containers";
74− rev = "af5f6cedd1acd8725b19fd6a0277f83906603491";
75− sha256 = "11v20ing8lrb5ccf6g9iihwcw5d22yj2ifw15v04ypn19y8kariw";
76− };
77− in pkgs.haskell.lib.dontCheck (self.callCabal2nix "monoidal-containers" src {});
78−
79− # Need deriveSomeUniverse
80− # PR: https://github.com/dmwit/universe/pull/32
81− universe-template = self.callCabal2nix "universe-template" (pkgs.fetchFromGitHub {
82− owner = "obsidiansystems";
83− repo = "universe";
84− rev = "5a2fc823caa4163411d7e41aa80e67cefb15944a";
85− sha256 = "0ll2z0fh18z6x8jl8kbp7ldagwccz3wjmvrw1gw752z058n82yfa";
86− } + /template) {};
87−
88− # Need ShowTag, EqTag, and OrdTag instances
89− dependent-sum-template = self.callCabal2nix "dependent-sum-template" (pkgs.fetchFromGitHub {
90− owner = "mokus0";
91− repo = "dependent-sum-template";
92− rev = "bfe9c37f4eaffd8b17c03f216c06a0bfb66f7df7";
93− sha256 = "1w3s7nvw0iw5li3ry7s8r4651qwgd22hmgz6by0iw3rm64fy8x0y";
94− }) {};
95− };
17+ getReflexPlatform = { system, enableLibraryProfiling ? profiling }: reflex-platform-func {
18+ inherit iosSdkVersion config system enableLibraryProfiling;
19+
20+ nixpkgsOverlays = [
21+ (import ./nixpkgs-overlays)
22+ ];
9623
97− cleanSource = builtins.filterSource (name: _: let baseName = builtins.baseNameOf name; in !(
98− builtins.match "^\\.ghc\\.environment.*" baseName != null ||
99− baseName == "cabal.project.local"
100− ));
101−
102− executableConfig = import ./lib/executable-config { nixpkgs = pkgs; filterGitSource = cleanSource; };
103−
104− addLibs = self: super: {
105− obelisk-asset-manifest = self.callCabal2nix "obelisk-asset-manifest" (hackGet ./lib/asset + "/manifest") {};
106− obelisk-asset-serve-snap = self.callCabal2nix "obelisk-asset-serve-snap" (hackGet ./lib/asset + "/serve-snap") {};
107− obelisk-backend = self.callCabal2nix "obelisk-backend" (cleanSource ./lib/backend) {};
108− obelisk-cliapp = self.callCabal2nix "obelisk-cliapp" (cleanSource ./lib/cliapp) {};
109− obelisk-command = (self.callCabal2nix "obelisk-command" (cleanSource ./lib/command) {});
110− obelisk-executable-config = executableConfig.haskellPackage self;
111− obelisk-executable-config-inject = executableConfig.platforms.web.inject self; # TODO handle platforms.{ios,android}
112− obelisk-frontend = self.callCabal2nix "obelisk-frontend" (cleanSource ./lib/frontend) {};
113− obelisk-migration = self.callCabal2nix "obelisk-migration" (cleanSource ./lib/migration) {};
114− obelisk-run = self.callCabal2nix "obelisk-run" (cleanSource ./lib/run) {};
115− obelisk-route = self.callCabal2nix "obelisk-route" (cleanSource ./lib/route) {};
116− obelisk-selftest = self.callCabal2nix "obelisk-selftest" (cleanSource ./lib/selftest) {};
117− obelisk-snap = self.callCabal2nix "obelisk-snap" (cleanSource ./lib/snap) {};
118− obelisk-snap-extras = self.callCabal2nix "obelisk-snap-extras" (cleanSource ./lib/snap-extras) {};
24+ haskellOverlays = [
25+ (import ./haskell-overlays/misc-deps.nix { inherit hackGet; })
26+ pkgs.obeliskExecutableConfig.haskellOverlay
27+ (import ./haskell-overlays/obelisk.nix)
28+ (import ./haskell-overlays/tighten-ob-exes.nix)
29+ ];
11930 };
12031
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+
12138 inherit (import ./lib/asset/assets.nix { inherit nixpkgs; }) mkAssets;
12239
123− defaultHaskellOverrides = composeExtensions fixUpstreamPkgs addLibs;
124−in
125−with pkgs.lib;
126−rec {
40+ haskellLib = pkgs.haskell.lib;
41+
42+in rec {
12743 inherit reflex-platform;
12844 inherit (reflex-platform) nixpkgs pinBuildInputs;
45+ inherit (nixpkgs) lib;
12946 pathGit = ./.; # Used in CI by the migration graph hash algorithm to correctly ignore files.
13047 path = reflex-platform.filterGit ./.;
13148 obelisk = ghcObelisk;
132− commandWithMigration = ghcObelisk.obelisk-command.overrideAttrs (drv: {
133− postInstall = (drv.postInstall or "") +
134− ''cp -r ${./migration} $out/migration;'';
135− });
136− command = pkgs.runCommand commandWithMigration.name { nativeBuildInputs = [pkgs.makeWrapper]; } ''
137− mkdir -p "$out/bin"
138− ln -s '${commandWithMigration}/bin/ob' "$out/bin/ob"
139− wrapProgram "$out"/bin/ob --prefix PATH : ${pkgs.lib.makeBinPath (commandRuntimeDeps pkgs)}
140− '';
141− shell = pinBuildInputs "obelisk-shell" ([command] ++ commandRuntimeDeps pkgs) [];
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
50+ command = ghcObelisk.obelisk-command;
51+ shell = pinBuildInputs "obelisk-shell" ([command] ++ command.commandRuntimeDeps);
14252
14353 selftest = pkgs.writeScript "selftest" ''
144− #!/usr/bin/env bash
54+ #!${pkgs.runtimeShell}
14555 set -euo pipefail
14656
14757 PATH="${command}/bin:$PATH"
148− export OBELISK_IMPL="${hackGet ./.}"
149− "${justStaticExecutables' ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" "$@"
58+ cd ${./.}
59+ "${ghcObelisk.obelisk-selftest}/bin/obelisk-selftest" +RTS -N -RTS "$@"
15060 '';
151− #TODO: Why can't I build ./skeleton directly as a derivation? `nix-build -E ./.` doesn't work
15261 skeleton = pkgs.runCommand "skeleton" {
15362 dir = builtins.filterSource (path: type: builtins.trace path (baseNameOf path != ".obelisk")) ./skeleton;
15463 } ''
15564 ln -s "$dir" "$out"
15665 '';
157− nullIfAbsent = p: if pathExists p then p else null;
158− haskellOverrides = addLibs;
66+ nullIfAbsent = p: if lib.pathExists p then p else null;
15967 #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.
160− processAssets = { src, packageName ? "static", moduleName ? "Static" }: pkgs.runCommand "asset-manifest" {
68+ processAssets = { src, packageName ? "obelisk-generated-static", moduleName ? "Obelisk.Generated.Static" }: pkgs.runCommand "asset-manifest" {
16169 inherit src;
16270 outputs = [ "out" "haskellManifest" "symlinked" ];
163− buildInputs = [
164− (reflex-platform.ghc.callCabal2nix "obelisk-asset-manifest" (hackGet ./lib/asset + "/manifest") {})
165− ];
71+ nativeBuildInputs = [ ghcObelisk.obelisk-asset-manifest ];
16672 } ''
16773 set -euo pipefail
16874 touch "$out"
75+ mkdir -p "$symlinked"
16976 obelisk-asset-manifest-generate "$src" "$haskellManifest" ${packageName} ${moduleName} "$symlinked"
17077 '';
17178
172− compressedJs = frontend: pkgs.runCommand "compressedJs" { buildInputs = [ pkgs.closurecompiler ]; } ''
173− mkdir $out
174− cd $out
175− ln -s "${justStaticExecutables frontend}/bin/frontend.jsexe/all.js" all.unminified.js
176− 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
177− echo "//# sourceMappingURL=all.js.map" >> all.js
79+ compressedJs = frontend: optimizationLevel: pkgs.runCommand "compressedJs" {} ''
80+ set -euo pipefail
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 ''
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"
91+ echo '//# sourceMappingURL=all.js.map' >> "$dir/all.js"
92+ ''}
93+ done
17894 '';
17995
180− serverExe = backend: frontend: assets: config:
181− pkgs.runCommand "serverExe" {} ''
182− mkdir $out
183− set -eux
184− ln -s "${justStaticExecutables backend}"/bin/* $out/
185− ln -s "${mkAssets assets}" $out/static.assets
186− cp -r ${config} $out/config
187− ln -s ${mkAssets (compressedJs frontend)} $out/frontend.jsexe.assets
188− '';
96+ serverModules = {
97+ mkBaseEc2 = { nixosPkgs, ... }: {...}: {
98+ imports = [
99+ (nixosPkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
100+ ];
101+ ec2.hvm = true;
102+ };
189103
190− server = { exe, hostName, adminEmail, routeHost, enableHttps, ... }:
191− let system = "x86_64-linux";
192− nixos = import (pkgs.path + /nixos);
193− backendPort = 8000;
194− in nixos {
195− inherit system;
196− configuration = args: {
197− imports = [
198− (pkgs.path + /nixos/modules/virtualisation/amazon-image.nix)
199− ];
200− networking = {
201− inherit hostName;
202− firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
203− };
204− services.nginx = {
205− enable = true;
206− virtualHosts."${routeHost}" = {
207− enableACME = enableHttps;
208− forceSSL = enableHttps;
209− locations."/" = {
210− proxyPass = "http://127.0.0.1:" + toString backendPort;
211− };
104+ mkDefaultNetworking = { adminEmail, enableHttps, hostName, routeHost, ... }: {...}: {
105+ networking = {
106+ inherit hostName;
107+ firewall.allowedTCPPorts = if enableHttps then [ 80 443 ] else [ 80 ];
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+
116+ security.acme.certs = if enableHttps then {
117+ "${routeHost}".email = adminEmail;
118+ } else {};
119+
120+ security.acme.${if enableHttps && (terms.security.acme.acceptTerms or false) then "acceptTerms" else null} = true;
121+ };
122+
123+ mkObeliskApp =
124+ { exe
125+ , routeHost
126+ , enableHttps
127+ , name ? "backend"
128+ , user ? name
129+ , group ? user
130+ , baseUrl ? "/"
131+ , internalPort ? 8000
132+ , backendArgs ? "--port=${toString internalPort}"
133+ , ...
134+ }: {...}: {
135+ services.nginx = {
136+ enable = true;
137+ recommendedProxySettings = true;
138+ virtualHosts."${routeHost}" = {
139+ enableACME = enableHttps;
140+ forceSSL = enableHttps;
141+ locations.${baseUrl} = {
142+ proxyPass = "http://127.0.0.1:" + toString internalPort;
143+ proxyWebsockets = true;
144+ extraConfig = ''
145+ access_log off;
146+ '';
212147 };
213148 };
214− security.acme.certs = if enableHttps then {
215− "${routeHost}".email = adminEmail;
216− } else { };
217− systemd.services.backend = {
218− wantedBy = [ "multi-user.target" ];
219− after = [ "network.target" ];
220− restartIfChanged = true;
221− script = ''
222− ln -sft . "${exe}"/*
223− mkdir -p log
224− exec ./backend >>backend.out 2>>backend.err </dev/null
225− '';
226− serviceConfig = {
227− User = "backend";
228− KillMode = "process";
229− WorkingDirectory = "~";
230− Restart = "always";
231− RestartSec = 5;
232− };
149+ };
150+ systemd.services.${name} = {
151+ wantedBy = [ "multi-user.target" ];
152+ after = [ "network.target" ];
153+ restartIfChanged = true;
154+ path = [ pkgs.gnutar ];
155+ script = ''
156+ ln -sft . '${exe}'/*
157+ mkdir -p log
158+ exec ./backend ${backendArgs} </dev/null
159+ '';
160+ serviceConfig = {
161+ User = user;
162+ KillMode = "process";
163+ WorkingDirectory = "~";
164+ Restart = "always";
165+ RestartSec = 5;
233166 };
234− users.extraUsers.backend = {
235− description = "backend service";
236− home = "/var/lib/backend";
167+ };
168+ users = {
169+ users.${user} = {
170+ description = "${user} service";
171+ home = "/var/lib/${user}";
237172 createHome = true;
238173 isSystemUser = true;
239− group = "backend";
174+ group = group;
240175 };
241− ec2.hvm = true;
176+ groups.${group} = {};
242177 };
243178 };
179+ };
244180
181+ inherit mkAssets;
182+
183+ serverExe = backend: frontend: assets: optimizationLevel: version:
184+ pkgs.runCommand "serverExe" {} ''
185+ mkdir $out
186+ set -eux
187+ ln -s '${if profiling then backend else haskellLib.justStaticExecutables backend}'/bin/* $out/
188+ ln -s '${mkAssets assets}' $out/static.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
193+ '';
194+
195+ server = { exe, hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }@args:
196+ let
197+ nixos = import (pkgs.path + /nixos);
198+ in nixos {
199+ system = "x86_64-linux";
200+ configuration = {
201+ imports = [
202+ (module { inherit exe hostName adminEmail routeHost enableHttps version; nixosPkgs = pkgs; })
203+ (serverModules.mkDefaultNetworking 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+ })
219+ ];
220+ };
221+ };
245222
246223 # An Obelisk project is a reflex-platform project with a predefined layout and role for each component
247− project = base: projectDefinition:
248− let configPath = base + "/config";
249− static = base + "/static";
250− processedStatic = processAssets { src = static; };
251− projectOut = sys: (getReflexPlatform sys).project (args@{ nixpkgs, ... }:
252− let mkProject = { android ? null #TODO: Better error when missing
253− , ios ? null #TODO: Better error when missing
254− , packages ? {}
255− , overrides ? _: _: {}
256− }:
257− let frontendName = "frontend";
258− backendName = "backend";
259− commonName = "common";
260− staticName = "static";
261− staticPath = base + "/static";
262− # The packages whose names and roles are defined by this package
263− predefinedPackages = filterAttrs (_: x: x != null) {
264− ${frontendName} = nullIfAbsent (base + "/frontend");
265− ${commonName} = nullIfAbsent (base + "/common");
266− ${backendName} = nullIfAbsent (base + "/backend");
267− };
268− combinedPackages = predefinedPackages // packages;
269− projectOverrides = self: super: {
270− ${staticName} = dontHaddock (self.callCabal2nix "static" processedStatic.haskellManifest {});
271− ${backendName} = addBuildDepend super.${backendName} self.obelisk-run;
272− };
273− totalOverrides = composeExtensions (composeExtensions defaultHaskellOverrides projectOverrides) overrides;
274− in {
275− overrides = totalOverrides;
276− packages = combinedPackages;
277− shells = {
278− ghc = (filter (x: hasAttr x combinedPackages) [
279− backendName
280− commonName
281− frontendName
282− ]);
283− ghcjs = filter (x: hasAttr x combinedPackages) [
284− frontendName
285− commonName
286− ];
224+ project = base': projectDefinition:
225+ let
226+ projectOut = { system, enableLibraryProfiling ? profiling }: let reflexPlatformProject = (getReflexPlatform { inherit system enableLibraryProfiling; }).project; in reflexPlatformProject (args@{ nixpkgs, ... }:
227+ let
228+ inherit (lib.strings) hasPrefix;
229+ mkProject =
230+ { android ? null #TODO: Better error when missing
231+ , ios ? null #TODO: Better error when missing
232+ , packages ? {}
233+ , overrides ? _: _: {}
234+ , staticFiles ? null
235+ , tools ? _: []
236+ , shellToolOverrides ? _: _: {}
237+ , withHoogle ? false # Setting this to `true` makes shell reloading far slower
238+ , __closureCompilerOptimizationLevel ? "ADVANCED" # Set this to `null` to skip the closure-compiler step
239+ , __withGhcide ? false
240+ }:
241+ let
242+ allConfig = nixpkgs.lib.makeExtensible (self: {
243+ base = base';
244+ inherit args;
245+ userSettings = {
246+ inherit android ios packages overrides tools shellToolOverrides withHoogle __closureCompilerOptimizationLevel __withGhcide;
247+ staticFiles = if staticFiles == null then self.base + /static else staticFiles;
287248 };
288− withHoogle = false; # Setting this to `true` makes shell reloading far slower
289− android = {
290− ${if android == null then null else frontendName} = {
249+ frontendName = "frontend";
250+ backendName = "backend";
251+ commonName = "common";
252+ staticName = "obelisk-generated-static";
253+ staticFilesImpure = let fs = self.userSettings.staticFiles; in if lib.isDerivation fs then fs else toString fs;
254+ processedStatic = processAssets { src = self.userSettings.staticFiles; };
255+ # The packages whose names and roles are defined by this package
256+ predefinedPackages = lib.filterAttrs (_: x: x != null) {
257+ ${self.frontendName} = nullIfAbsent (self.base + "/frontend");
258+ ${self.commonName} = nullIfAbsent (self.base + "/common");
259+ ${self.backendName} = nullIfAbsent (self.base + "/backend");
260+ };
261+ shellPackages = {};
262+ combinedPackages = self.predefinedPackages // self.userSettings.packages // self.shellPackages;
263+ projectOverrides = self': super': {
264+ ${self.staticName} = haskellLib.dontHaddock (self'.callCabal2nix self.staticName self.processedStatic.haskellManifest {});
265+ ${self.backendName} = haskellLib.addBuildDepend super'.${self.backendName} self'.obelisk-run;
266+ };
267+ totalOverrides = lib.composeExtensions self.projectOverrides self.userSettings.overrides;
268+ privateConfigDirs = ["config/backend"];
269+ injectableConfig = builtins.filterSource (path: _:
270+ !(lib.lists.any (x: hasPrefix (toString self.base + "/" + toString x) (toString path)) self.privateConfigDirs)
271+ );
272+ __androidWithConfig = configPath: {
273+ ${if self.userSettings.android == null then null else self.frontendName} = {
291274 executableName = "frontend";
292− ${if builtins.pathExists staticPath then "assets" else null} = processedStatic.symlinked;
293− } // android;
275+ ${if builtins.pathExists self.userSettings.staticFiles then "assets" else null} =
276+ nixpkgs.obeliskExecutableConfig.platforms.android.inject
277+ (self.injectableConfig configPath)
278+ self.processedStatic.symlinked;
279+ } // self.userSettings.android;
294280 };
295− ios = {
296− ${if ios == null then null else frontendName} = {
281+ __iosWithConfig = configPath: {
282+ ${if self.userSettings.ios == null then null else self.frontendName} = {
297283 executableName = "frontend";
298− ${if builtins.pathExists staticPath then "staticSrc" else null} = processedStatic.symlinked;
299− } // ios;
284+ ${if builtins.pathExists self.userSettings.staticFiles then "staticSrc" else null} =
285+ nixpkgs.obeliskExecutableConfig.platforms.ios.inject
286+ (self.injectableConfig configPath)
287+ self.processedStatic.symlinked;
288+ } // self.userSettings.ios;
300289 };
301− };
302− in mkProject (projectDefinition args));
303− serverOn = sys: config: serverExe (projectOut sys).ghc.backend (projectOut system).ghcjs.frontend static config;
304− # `exe` is project's backend executable, with frontend assets, config, etc.
305− # `linuxExe` is the same but built for x86_64-linux.
306− exe = serverOn system configPath;
307− linuxExe = serverOn "x86_64-linux" configPath;
308− in projectOut system // {
309− inherit exe linuxExe;
310− server = args@{ hostName, adminEmail, routeHost, enableHttps, config }:
311− server (args // { exe = serverOn "x86_64-linux" config;});
312− obelisk = import (base + "/.obelisk/impl") {};
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+ };
336+ };
337+ });
338+ in allConfig;
339+ in (mkProject (projectDefinition args)).projectConfig);
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;
347+ linuxExe = serverOn (projectOut { system = "x86_64-linux"; });
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+
382+ linuxExeConfigurable = linuxExe;
383+ linuxExe = linuxExe dummyVersion;
384+ exe = serverOn mainProjectOut dummyVersion;
385+ server = args@{ hostName, adminEmail, routeHost, enableHttps, version, module ? serverModules.mkBaseEc2 }:
386+ server (args // { exe = linuxExe version; });
387+ obelisk = import (base' + "/.obelisk/impl") {};
313388 };
314389 haskellPackageSets = {
315− ghc = reflex-platform.ghc.override {
316− overrides = defaultHaskellOverrides;
317− };
390+ inherit (reflex-platform) ghc ghcjs;
318391 };
319392}
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 @@
11# DO NOT HAND-EDIT THIS FILE
2−import ((import <nixpkgs> {}).fetchFromGitHub (
3− let json = builtins.fromJSON (builtins.readFile ./github.json);
4− in { inherit (json) owner repo rev sha256;
5− private = json.private or false;
6− }
7−))
2+import (import ./thunk.nix)
dep/reflex-platform/github.json+4−3
@@ -1,7 +1,8 @@
11{
22 "owner": "reflex-frp",
33 "repo": "reflex-platform",
4− "branch": "reunification",
5− "rev": "12d6ff3f297b46a896edc5143e156fe770931b83",
6− "sha256": "01virrzqi8m0dadqcx6yqx9jxapz6r6vxckxkk3alaq64g10qlv7"
4+ "branch": "release/0.7.0.0",
5+ "private": false,
6+ "rev": "27a7851a780ff21472d85f9a02fb84635ef9027a",
7+ "sha256": "1m4zlw91dpjlbdchjyxhvhv3k7lilm0qa17dhhww868xxc27sann"
78}
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
22
3−The 'assets.nix' file contains nix expressions that are a mutually
4−recursive set of attributes used to create static asset directories
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−```
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)
115
12−The 'mkAssets' and 'mkAssetsWith' functions within 'assets.nix' only
13−need to be passed an encoding('zopfliEncodings', 'gzipEncodings',
14−'noEncodings') and a static directory of your choice as arguments.
6+**Efficiently served, aggressively cached static web resources.**
157
16−In this example, 'mkAssets' is used on a directory that has a .png
17−file inside of it. (See ./example/default.nix, line 11)
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)
9+
10+```nix
11+{ assets ? import ./../assets.nix { inherit nixpkgs; } }:
1812```
19−myAssets = assets.mkAssets ./static;
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;
2020```
2121
22−Once you have successfully incorporated 'assets.nix' into your
23−project's nix file(s), use nix-build to generate a symlink of
24−your 'mkAssets' expression. The following command from
25−example/run-example (line 3) will generate an immutable symlink
26−that holds hashed static assets.
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+
2724```bash
2825nix-build -o static.assets -A myAssets
2926```
lib/asset/assets.nix+28−5
@@ -20,7 +20,7 @@ zopfliEncodings = file:
2020 nixpkgs.stdenv.mkDerivation {
2121 name = "encodings";
2222
23− input = file;
23+ input = mkPath file;
2424
2525 builder = builtins.toFile "builder.sh" ''
2626 source "$stdenv/setup"
@@ -46,7 +46,7 @@ gzipEncodings = file:
4646 nixpkgs.stdenv.mkDerivation {
4747 name = "encodings";
4848
49− input = file;
49+ input = mkPath file;
5050
5151 builder = builtins.toFile "builder.sh" ''
5252 source "$stdenv/setup"
@@ -70,7 +70,7 @@ noEncodings = file:
7070 nixpkgs.stdenv.mkDerivation {
7171 name = "encodings";
7272
73− input = file;
73+ input = mkPath file;
7474
7575 builder = builtins.toFile "builder.sh" ''
7676 source "$stdenv/setup"
@@ -203,7 +203,7 @@ hashFile = path:
203203 nixpkgs.nix
204204 ];
205205 preferLocalBuild = true;
206− inherit path;
206+ path = mkPath path;
207207 } ''
208208 nix-hash --flat --base32 --type sha256 "$path" | tr -d '\n' >"$out"
209209 '');
@@ -224,7 +224,30 @@ symlink = path: {
224224 inherit path;
225225};
226226
227−# Given a encoding generation function and a file entry resulting from readDirRecursive in the form { name :: String, value: { path :: String } },
227+# Tests if a given character (string of length 1) is valid for a derivation path name.
228+# Passing a string of length other than 1 is undefined.
229+# :: Char -> Bool
230+isValidDrvNameChar = c: "a" <= c && c <= "z" || "A" <= c && c <= "Z" || "0" <= c && c <= "9" || c == "+" || c == "-" || c == "_" || c == "?" || c == "=" || c == ".";
231+
232+# Convert a string into a string that could be used in a derivation name.
233+# replacement lets you choose how to replace invalid characters. It may be any length.
234+# If it contains invalid characters then the result will also be invalid.
235+# :: { str :: String, replacement :: String } -> String
236+mkValidDrvName = { str, replacement ? "?" }:
237+ let
238+ newName = stringAsChars (c: if isValidDrvNameChar c then c else replacement) str;
239+ in if builtins.substring 0 1 newName == "." then "_" + newName else newName;
240+
241+# Like builtins.path but always ensures the name is valid.
242+mkPath = path:
243+ if builtins.typeOf path == "path" # Don't mess with non-paths
244+ then builtins.path {
245+ inherit path;
246+ name = mkValidDrvName { str = builtins.baseNameOf path; };
247+ }
248+ else path;
249+
250+# Given an encoding generation function and a file entry resulting from readDirRecursive in the form { name :: String, value: { path :: String } },
228251# build a DirEntry for dirToPath with the various encodings of the asset for dirToPath to build into a final directory tree.
229252mkAsset = encodings: {name, value}:
230253 let nameWithHash = "${hashFile value.path}-${name}";
lib/asset/manifest/obelisk-asset-manifest.cabal+5−2
@@ -17,13 +17,14 @@ library
1717 base
1818 , bytestring
1919 , containers
20+ , deepseq
2021 , directory
2122 , SHA
2223 , filepath
2324 , template-haskell
2425 , text
2526 , transformers
26− , unix
27+ , unix-compat
2728 , vector
2829 exposed-modules:
2930 Obelisk.Asset.Gather
@@ -32,7 +33,9 @@ library
3233 Obelisk.Asset.TH
3334
3435 other-extensions: TemplateHaskell
35− ghc-options: -Wall -Werror -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls
36+ ghc-options:
37+ -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O2
38+ -fno-warn-unused-do-bind -funbox-strict-fields -fprof-auto-calls
3639
3740executable obelisk-asset-manifest-generate
3841 hs-source-dirs: src-bin
lib/asset/manifest/src/Obelisk/Asset/Gather.hs+5−2
@@ -1,10 +1,12 @@
11{-# LANGUAGE OverloadedStrings #-}
2+{-# LANGUAGE BangPatterns #-}
23-- | Functions for collecting up files to be processed by the asset pipeline
34module Obelisk.Asset.Gather
45 ( gatherHashedPaths
56 , toHashedPath
67 ) where
78
9+import Control.DeepSeq
810import Control.Monad (forM)
911import Data.Bits
1012import qualified Data.ByteString.Lazy as LBS
@@ -33,7 +35,7 @@ gatherHashedPaths root = go ""
3335 let relativePath = subdir </> sub
3436 isFile <- doesFileExist $ root </> relativePath
3537 if isFile
36− then do hashedRelativePath <- toHashedPath root relativePath
38+ then do !hashedRelativePath <- force <$> toHashedPath root relativePath
3739 return $ Map.singleton relativePath hashedRelativePath
3840 else go relativePath
3941
@@ -47,7 +49,8 @@ toHashedPath root relativePath = do
4749 contents <- LBS.readFile path
4850 let hashPrefix = T.unpack $ decodeUtf8 $ LBS.toStrict $ toNixBase32 $ bytestringDigest $ sha256 contents
4951 (dir, filename) = splitFileName relativePath
50− return $ normalise $ dir </> (hashPrefix <> "-" <> filename)
52+ !hashedRelativePath = force $ normalise $ dir </> (hashPrefix <> "-" <> filename)
53+ return hashedRelativePath
5154
5255-- | Convert a ByteString to base 32 in the way that Nix does
5356toNixBase32 :: LBS.ByteString -> LBS.ByteString
lib/asset/manifest/src/Obelisk/Asset/Promoted.hs+7−2
@@ -10,6 +10,7 @@ module Obelisk.Asset.Promoted
1010import Obelisk.Asset.Gather
1111
1212import Data.Foldable
13+import qualified Data.List as L
1314import Language.Haskell.TH (runQ, pprint)
1415import Language.Haskell.TH.Syntax hiding (lift)
1516import GHC.TypeLits
@@ -31,11 +32,15 @@ data StaticConfig = StaticConfig
3132
3233writeStaticProject :: Map FilePath FilePath -> FilePath -> StaticConfig -> IO ()
3334writeStaticProject paths target cfg = do
34− createDirectoryIfMissing True $ target </> "src"
35+ createDirectoryIfMissing True target
3536 T.writeFile (target </> T.unpack (_staticConfig_packageName cfg) <.> "cabal") $ staticCabalFile cfg
3637 let modName = _staticConfig_moduleName cfg
38+ (modName', moduleDirPath) = case L.uncons (reverse $ T.splitOn "." modName) of
39+ Nothing -> error $ "writeStaticProject: invalid module name " <> T.unpack modName
40+ Just (name, parents) -> (name, target </> "src" </> T.unpack (T.intercalate "/" $ reverse parents))
41+ createDirectoryIfMissing True moduleDirPath
3742 modContents <- staticModuleFile modName paths
38− T.writeFile (target </> "src" </> T.unpack modName <.> "hs") modContents
43+ T.writeFile (moduleDirPath </> T.unpack modName' <.> "hs") modContents
3944
4045staticCabalFile :: StaticConfig -> Text
4146staticCabalFile cfg = T.unlines
lib/asset/manifest/src/Obelisk/Asset/Symlink.hs+1−1
@@ -7,7 +7,7 @@ import Data.Map (Map)
77import qualified Data.Map as Map
88import System.Directory
99import System.FilePath.Posix
10−import System.Posix.Files
10+import System.PosixCompat.Files
1111
1212-- | Copy the given hashed files from one location to hashed paths in another
1313-- 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
2323 , obelisk-snap-extras
2424 , text
2525 , transformers
26− , unix
26+ , unix-compat
2727 exposed-modules:
2828 Obelisk.Asset.Accept
2929 Obelisk.Asset.Serve.Snap
3030
3131 other-extensions: TemplateHaskell
32− ghc-options: -Wall -Werror -fno-warn-unused-do-bind -fwarn-tabs -funbox-strict-fields -O2 -fprof-auto-calls
32+ ghc-options:
33+ -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O2
34+ -fno-warn-unused-do-bind -funbox-strict-fields -fprof-auto-calls
lib/asset/serve-snap/src/Obelisk/Asset/Accept.hs+6−6
@@ -136,16 +136,16 @@ qvalue = do
136136 skipMany lws
137137 q0 <|> q1
138138 where q0 = do
139− char '0'
139+ _ <- char '0'
140140 decimals <- option [] $ do
141− char '.'
141+ _ <- char '.'
142142 starRule (Just 0) (Just numAllowedDigits) digit
143143 return $ QValue $ MkFixed $ fromIntegral $ (read ('0' : decimals) :: Int) * 10 ^ (numAllowedDigits - length decimals)
144144 q1 = do
145− char '1'
145+ _ <- char '1'
146146 option () $ do
147− char '.'
148− starRule (Just 0) (Just numAllowedDigits) $ char '0'
147+ _ <- char '.'
148+ _ <- starRule (Just 0) (Just numAllowedDigits) $ char '0'
149149 return ()
150150 return $ QValue 1
151151 numAllowedDigits :: Int
@@ -232,7 +232,7 @@ hashRule minNum maxNum element = do
232232lws :: Parser ()
233233lws = do
234234 option () $ cr >> lf
235− starRule (Just 1) Nothing $ sp <|> ht
235+ _ <- starRule (Just 1) Nothing $ sp <|> ht
236236 return ()
237237
238238-- | See http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2
lib/asset/serve-snap/src/Obelisk/Asset/Serve/Snap.hs+22−11
@@ -12,13 +12,15 @@ import Obelisk.Asset.Accept (Encoding (..), acceptEncodingBody, chooseEncoding,
1212import Obelisk.Snap.Extras
1313
1414import Snap
15− (MonadSnap, getHeader, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
15+ (MonadSnap, getHeader, getRequest, getsRequest, modifyResponse, pass, redirect, sendFile, setContentLength, setContentType, setHeader, setResponseCode)
1616import Snap.Util.FileServe (defaultMimeTypes, fileType, getSafePath, serveFile)
17+import Snap.Internal.Util.FileServe (checkRangeReq)
1718
1819import Control.Applicative ((<|>))
1920import Control.Exception (handleJust, try, throwIO)
20−import Control.Monad (forM, liftM)
21+import Control.Monad (forM, liftM, unless)
2122import Control.Monad.IO.Class (liftIO)
23+import Control.Monad.Fail (MonadFail)
2224import Data.Attoparsec.ByteString (parseOnly, endOfInput)
2325import Data.ByteString (ByteString)
2426import qualified Data.ByteString as BS
@@ -29,7 +31,7 @@ import Data.Text.Encoding (decodeUtf8, encodeUtf8)
2931import System.Directory (getDirectoryContents)
3032import System.FilePath ((</>), splitFileName, takeDirectory)
3133import System.IO.Error (isDoesNotExistError)
32−import System.Posix (getFileStatus, fileSize)
34+import System.PosixCompat.Files (getFileStatus, fileSize)
3335
3436-- | Serve static assets from an asset directory generated via @assets.nix@ or, failing that, from a regular directory.
3537--
@@ -38,7 +40,7 @@ import System.Posix (getFileStatus, fileSize)
3840-- current version of the asset
3941-- (e.g. @0rx5yvkkgkig2pcqf4ngi1l7vh89qqajdzc6aiayaibyhvj0d853-test.png@). Hashed
4042-- 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 ()
4244serveAssets = serveAssets' True
4345
4446-- | 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
4749-- browser for the logical asset name (e.g. @test.png@) but instead the current
4850-- version of the asset with to point the browser at the unique filename for the
4951-- current version of the asset.
50−serveAssetsInPlace :: MonadSnap m => FilePath -> FilePath -> m ()
52+serveAssetsInPlace :: (MonadSnap m, MonadFail m) => FilePath -> FilePath -> m ()
5153serveAssetsInPlace = serveAssets' False
5254
5355-- | 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 ()
5557serveAsset = serveAsset' True
5658
5759-- | 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 ()
5961serveAssetInPlace = serveAsset' False
6062
6163-- | 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
6365-- 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
6466-- 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
6567-- 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 ()
6769serveAssets' doRedirect base fallback = do
6870 pRaw <- getSafePath
6971 serveAsset' doRedirect base fallback $ if "/" `isSuffixOf` pRaw || pRaw == "" then pRaw <> "index.html" else pRaw
7072
7173-- | 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 ()
7375serveAsset' doRedirect base fallback p = do
7476 assetType <- liftIO $ try $ BS.readFile $ base </> p </> "type"
7577 case assetType of
@@ -93,8 +95,17 @@ serveAsset' doRedirect base fallback p = do
9395 let finalFilename = base </> p </> "encodings" </> T.unpack (decodeUtf8 e)
9496 stat <- liftIO $ getFileStatus finalFilename
9597 modifyResponse $ setHeader "Last-Modified" "Thu, 1 Jan 1970 00:00:00 GMT"
96− modifyResponse $ setResponseCode 200 . setContentLength (fromIntegral $ fileSize stat) . setContentType (fileType defaultMimeTypes p)
97− sendFile finalFilename
98+ . setHeader "Accept-Ranges" "bytes"
99+ . setContentType (fileType defaultMimeTypes p)
100+ let size = fromIntegral $ fileSize stat
101+ req <- getRequest
102+ -- Despite the name, this function actually does all of the work for
103+ -- responding to range requests. We only need to handle *none* range
104+ -- requests ourselves.
105+ wasRange <- checkRangeReq req finalFilename size
106+ unless wasRange $ do
107+ modifyResponse $ setResponseCode 200 . setContentLength size
108+ sendFile finalFilename
98109 Just _ -> cachePermanently >> modifyResponse (setResponseCode 304)
99110 Right "redirect" -> do
100111 mtarget <- liftIO $ getAssetTarget $ base </> p
lib/backend/obelisk-backend.cabal+7−3
@@ -7,6 +7,9 @@ library
77 hs-source-dirs: src
88 build-depends: base,
99 bytestring,
10+ categories,
11+ containers,
12+ cookie,
1013 data-default,
1114 dependent-sum,
1215 dependent-sum-template,
@@ -14,13 +17,14 @@ library
1417 mtl,
1518 obelisk-asset-serve-snap,
1619 obelisk-executable-config-inject,
20+ obelisk-executable-config-lookup,
1721 obelisk-frontend,
1822 obelisk-route,
19− obelisk-snap,
20− reflex-dom,
23+ obelisk-snap-extras,
24+ reflex-dom-core,
2125 snap,
2226 snap-server,
2327 text,
2428 universe
2529 exposed-modules: Obelisk.Backend
26− ghc-options: -Wall
30+ ghc-options: -Wall -Werror -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O
lib/backend/src/Obelisk/Backend.hs+196−50
@@ -1,3 +1,5 @@
1+{-# LANGUAGE DeriveFunctor #-}
2+{-# LANGUAGE DeriveGeneric #-}
13{-# LANGUAGE FlexibleContexts #-}
24{-# LANGUAGE FlexibleInstances #-}
35{-# LANGUAGE GADTs #-}
@@ -5,55 +7,113 @@
57{-# LANGUAGE LambdaCase #-}
68{-# LANGUAGE MultiParamTypeClasses #-}
79{-# LANGUAGE OverloadedStrings #-}
8−{-# LANGUAGE TemplateHaskell #-}
10+{-# LANGUAGE ScopedTypeVariables #-}
11+{-# OPTIONS_GHC -fno-warn-orphans #-}
912module Obelisk.Backend
1013 ( 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
1130 -- * Re-exports
1231 , Default (def)
1332 , getPageName
1433 , getRouteWith
1534 , runSnapWithCommandLineArgs
35+ , runSnapWithConfig
1636 , serveDefaultObeliskApp
1737 , prettifyOutput
18− , runBackend
38+ , staticRenderContentType
39+ , getPublicConfigs
1940 ) where
2041
2142import Control.Monad
2243import Control.Monad.Except
44+import Control.Monad.Fail (MonadFail)
2345import Data.ByteString (ByteString)
2446import qualified Data.ByteString.Char8 as BSC8
2547import Data.Default (Default (..))
2648import Data.Dependent.Sum
27−import Data.Functor.Sum
2849import Data.Functor.Identity
50+import Data.Map (Map)
51+import qualified Data.Map as Map
52+import Data.Monoid ((<>))
2953import Data.Text (Text)
3054import qualified Data.Text as T
31−import Data.Text.Encoding
55+import GHC.Generics (Generic)
3256import Obelisk.Asset.Serve.Snap (serveAsset)
33−import Obelisk.ExecutableConfig.Inject (injectExecutableConfigs)
57+import qualified Obelisk.ExecutableConfig.Lookup as Lookup
3458import Obelisk.Frontend
3559import Obelisk.Route
36−import Reflex.Dom
37−import Snap (MonadSnap, Snap, commandLineConfig, defaultConfig, getsRequest, httpServe, rqPathInfo,
38− rqQueryString, writeBS, writeText)
60+import Obelisk.Snap.Extras (doNotCache, serveFileIfExistsAs)
61+import Reflex.Dom.Core
62+import Snap (MonadSnap, Snap, commandLineConfig, defaultConfig, getsRequest, httpServe, modifyResponse
63+ , rqPathInfo, rqQueryString, setContentType, writeBS, writeText
64+ , rqCookies, Cookie(..) , setHeader)
3965import Snap.Internal.Http.Server.Config (Config (accessLog, errorLog), ConfigLog (ConfigIoLog))
4066import System.IO (BufferMode (..), hSetBuffering, stderr, stdout)
4167
4268data Backend backendRoute frontendRoute = Backend
43− { _backend_routeEncoder :: Encoder (Either Text) (Either Text) (R (Sum backendRoute (ObeliskRoute frontendRoute))) PageName
69+ { _backend_routeEncoder :: Encoder (Either Text) Identity (R (FullRoute backendRoute frontendRoute)) PageName
4470 , _backend_run :: ((R backendRoute -> Snap ()) -> IO ()) -> IO ()
45− }
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)
4680
4781-- | The static assets provided must contain a compiled GHCJS app that corresponds exactly to the Frontend provided
4882data GhcjsApp route = GhcjsApp
4983 { _ghcjsApp_compiled :: !StaticAssets
5084 , _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
51102 }
52103
53104-- | Serve a frontend, which must be the same frontend that Obelisk has built and placed in the default location
54105--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
55−serveDefaultObeliskApp :: MonadSnap m => Frontend (R appRoute) -> R (ObeliskRoute appRoute) -> m ()
56−serveDefaultObeliskApp frontend = serveObeliskApp defaultStaticAssets frontendApp
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 ()
115+serveDefaultObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontend =
116+ serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp
57117 where frontendApp = GhcjsApp
58118 { _ghcjsApp_compiled = defaultFrontendGhcjsAssets
59119 , _ghcjsApp_value = frontend
@@ -78,43 +138,56 @@ defaultFrontendGhcjsAssets = StaticAssets
78138 , _staticAssets_unprocessed = "frontend.jsexe"
79139 }
80140
81−runSnapWithCommandLineArgs :: Snap () -> IO ()
82−runSnapWithCommandLineArgs a = do
83− -- Get the web server configuration from the command line
84− cmdLineConf <- commandLineConfig defaultConfig
85− let httpConf = cmdLineConf
141+runSnapWithConfig :: MonadIO m => Config Snap a -> Snap () -> m ()
142+runSnapWithConfig conf a = do
143+ let httpConf = conf
86144 { accessLog = Just $ ConfigIoLog BSC8.putStrLn
87145 , errorLog = Just $ ConfigIoLog BSC8.putStrLn
88146 }
89147 -- Start the web server
90− httpServe httpConf a
148+ liftIO $ httpServe httpConf a
91149
92−getPageName :: (MonadSnap m, MonadError Text parse) => m (parse PageName)
150+-- Get the web server configuration from the command line
151+runSnapWithCommandLineArgs :: MonadIO m => Snap () -> m ()
152+runSnapWithCommandLineArgs s = liftIO (commandLineConfig defaultConfig) >>= \c ->
153+ runSnapWithConfig c s
154+
155+getPageName :: (MonadSnap m) => m PageName
93156getPageName = do
94157 p <- getsRequest rqPathInfo
95158 q <- getsRequest rqQueryString
96− return $ _validEncoder_decode pageNameValidEncoder
97− ( "/" <> T.unpack (decodeUtf8 p)
98− , "?" <> T.unpack (decodeUtf8 q)
99− )
159+ return $ byteStringsToPageName p q
100160
101−getRouteWith :: (MonadSnap m, MonadError Text parse) => ValidEncoder parse route PageName -> m (parse route)
161+getRouteWith :: (MonadSnap m) => Encoder Identity parse route PageName -> m (parse route)
102162getRouteWith e = do
103163 pageName <- getPageName
104− return $ pageName >>= _validEncoder_decode e
164+ return $ tryDecode e pageName
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"]
105169
106−serveObeliskApp :: MonadSnap m => StaticAssets -> GhcjsApp (R appRoute) -> R (ObeliskRoute appRoute) -> m ()
107−serveObeliskApp staticAssets frontendApp = \case
108− ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp frontendApp $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
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
177+ -> R (ObeliskRoute appRoute)
178+ -> m ()
179+serveObeliskApp urlEnc ghcjsWidgets serveStaticAsset frontendApp config = \case
180+ ObeliskRoute_App appRouteComponent :=> Identity appRouteRest -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_App appRouteComponent :/ appRouteRest
109181 ObeliskRoute_Resource resComponent :=> Identity resRest -> case resComponent :=> Identity resRest of
110− ResourceRoute_Static :=> Identity pathSegments -> serveStaticAssets staticAssets pathSegments
111− ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp frontendApp $ GhcjsAppRoute_Resource :/ pathSegments
182+ ResourceRoute_Static :=> Identity pathSegments -> serveStaticAsset pathSegments
183+ ResourceRoute_Ghcjs :=> Identity pathSegments -> serveGhcjsApp urlEnc ghcjsWidgets frontendApp config $ GhcjsAppRoute_Resource :/ pathSegments
112184 ResourceRoute_JSaddleWarp :=> Identity _ -> do
113185 let msg = "Error: Obelisk.Backend received jsaddle request"
114186 liftIO $ putStrLn $ T.unpack msg
115187 writeText msg
188+ ResourceRoute_Version :=> Identity () -> doNotCache >> serveFileIfExistsAs "text/plain" "version"
116189
117−serveStaticAssets :: MonadSnap m => StaticAssets -> [Text] -> m ()
190+serveStaticAssets :: (MonadSnap m, MonadFail m) => StaticAssets -> [Text] -> m ()
118191serveStaticAssets assets pathSegments = serveAsset (_staticAssets_processed assets) (_staticAssets_unprocessed assets) $ T.unpack $ T.intercalate "/" pathSegments
119192
120193data StaticAssets = StaticAssets
@@ -127,26 +200,99 @@ data GhcjsAppRoute :: (* -> *) -> * -> * where
127200 GhcjsAppRoute_App :: appRouteComponent a -> GhcjsAppRoute appRouteComponent a
128201 GhcjsAppRoute_Resource :: GhcjsAppRoute appRouteComponent [Text]
129202
203+staticRenderContentType :: ByteString
204+staticRenderContentType = "text/html; charset=utf-8"
205+
130206--TODO: Don't assume we're being served at "/"
131−serveGhcjsApp :: MonadSnap m => GhcjsApp (R appRouteComponent) -> R (GhcjsAppRoute appRouteComponent) -> m ()
132−serveGhcjsApp app = \case
133− GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest ->
134− writeBS <=< liftIO $ renderGhcjsFrontend (appRouteComponent :/ appRouteRest) $ _ghcjsApp_value app
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
213+ -> R (GhcjsAppRoute appRouteComponent)
214+ -> m ()
215+serveGhcjsApp urlEnc ghcjsWidgets app config = \case
216+ GhcjsAppRoute_App appRouteComponent :=> Identity appRouteRest -> do
217+ modifyResponse $ setContentType staticRenderContentType
218+ modifyResponse $ setHeader "Cache-Control" "no-store private"
219+ writeBS <=< renderGhcjsFrontend urlEnc ghcjsWidgets (appRouteComponent :/ appRouteRest) config $ _ghcjsApp_value app
135220 GhcjsAppRoute_Resource :=> Identity pathSegments -> serveStaticAssets (_ghcjsApp_compiled app) pathSegments
136221
137−runBackend :: Backend fullRoute frontendRoute -> Frontend (R frontendRoute) -> IO ()
138−runBackend backend frontend = case checkEncoder $ _backend_routeEncoder backend of
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.
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 ()
236+runBackendWith (BackendConfig runSnap staticAssets ghcjsWidgets) backend frontend = case checkEncoder $ _backend_routeEncoder backend of
139237 Left e -> fail $ "backend error:\n" <> T.unpack e
140− Right validFullEncoder -> _backend_run backend $ \serveRoute -> do
141− runSnapWithCommandLineArgs $ do
142− getRouteWith validFullEncoder >>= \case
143− Left e -> writeText e
144− Right r -> case r of
145− InL backendRoute :=> Identity a -> serveRoute $ backendRoute :/ a
146− InR obeliskRoute :=> Identity a -> serveDefaultObeliskApp frontend $ obeliskRoute :/ a
147−
148−renderGhcjsFrontend :: route -> Frontend route -> IO ByteString
149−renderGhcjsFrontend route f = do
150− let baseTag = elAttr "base" ("href" =: "/") blank --TODO: Figure out the base URL from the routes
151− ghcjsScript = elAttr "script" ("language" =: "javascript" <> "src" =: "ghcjs/all.js" <> "defer" =: "defer") blank
152− renderFrontendHtml route (_frontend_head f >> injectExecutableConfigs >> baseTag) (_frontend_body f >> ghcjsScript)
238+ Right validFullEncoder -> do
239+ publicConfigs <- getPublicConfigs
240+ _backend_run backend $ \serveRoute ->
241+ runSnap $
242+ getRouteWith validFullEncoder >>= \case
243+ Identity r -> case r of
244+ FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ a
245+ FullRoute_Frontend obeliskRoute :/ a ->
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+
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
260+renderGhcjsFrontend urlEnc ghcjsWidgets route configs f = do
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 ()
272+deferredGhcjsScript allJsUrl = elAttr "script" ("type" =: "text/javascript" <> "src" =: allJsUrl <> "defer" =: "defer") blank
273+
274+-- | An all.js script which is loaded after waiting for some time to pass. This
275+-- is useful to ensure any CSS animations on the page can play smoothly before
276+-- blocking the UI thread by running all.js.
277+delayedGhcjsScript
278+ :: Int -- ^ The number of milliseconds to delay loading by
279+ -> Text -- ^ URL to GHCJS app JavaScript
280+ -> FrontendWidgetT r ()
281+delayedGhcjsScript n allJsUrl = elAttr "script" ("type" =: "text/javascript") $ text $ T.unlines
282+ [ "setTimeout(function() {"
283+ , " var all_js_script = document.createElement('script');"
284+ , " all_js_script.type = 'text/javascript';"
285+ , " all_js_script.src = '" <> allJsUrl <> "';"
286+ , " document.body.appendChild(all_js_script);"
287+ , "}, " <> T.pack (show n) <> ");"
288+ ]
289+
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+8−3
@@ -7,26 +7,31 @@ cabal-version: >=1.2
77library
88 hs-source-dirs: src
99 build-depends:
10− ansi-terminal
10+ aeson
11+ , ansi-terminal
1112 , base
1213 , bytestring
14+ , containers
1315 , exceptions
1416 , io-streams
17+ , lens
1518 , logging-effect
1619 , monad-loops
1720 , mtl
1821 , process
22+ , shell-escape
1923 , terminal-size
2024 , text
2125 , time
2226 , transformers
27+ , utf8-string
2328 exposed-modules:
2429 Obelisk.CliApp
25− Obelisk.CliApp.Demo
2630 other-modules:
2731 Obelisk.CliApp.Logging
2832 Obelisk.CliApp.Process
2933 Obelisk.CliApp.Spinner
3034 Obelisk.CliApp.TerminalString
35+ Obelisk.CliApp.Theme
3136 Obelisk.CliApp.Types
32− 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+24−5
@@ -6,7 +6,8 @@
66module Obelisk.CliApp
77 (
88 -- .Types
9− Cli
9+ CliLog
10+ , CliThrow
1011 , CliT(..)
1112 , runCli
1213 , CliConfig
@@ -20,22 +21,40 @@ module Obelisk.CliApp
2021 , withSpinner'
2122
2223 -- .Logging
24+ , AsUnstructuredError (..)
2325 , newCliConfig
2426 , getLogLevel
2527 , putLog
2628 , failWith
29+ , errorToWarning
2730 , withExitFailMessage
2831
2932 -- Control.Monad.Log
3033 , Severity (..)
3134
3235 -- .Process
33− , ProcessFailed (..)
34− , readProcessAndLogStderr
36+ , AsProcessFailure (..)
37+ , ProcessFailure (..)
38+ , ProcessSpec (..)
39+ , callCommand
40+ , callProcess
3541 , callProcessAndLogOutput
42+ , createProcess
3643 , createProcess_
37− , callProcess
38− , callCommand
44+ , exitCodeToException
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
3958 ) where
4059
4160import Control.Monad.Log (Severity (..))
lib/cliapp/src/Obelisk/CliApp/Demo.hsdeleted−49
@@ -1,49 +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 :: (MonadIO m, MonadMask m, Cli m, HasCliConfig m) => m ()
17−cliDemo = withSpinner "CLI Demo" $ do
18− putLog Notice "This demo will showcase the CLI library functionality"
19− _ <- withSpinner' "Searching long for something" (Just $ \c -> "Discovered " <> T.pack (show c) <> " objects") $ do
20− delay
21− withSpinner "Nested task" $ do
22− delay
23− putLog Notice "In nested task"
24− -- This is a 'no trail' spinner that won't leave a trail (even its sub spinners)
25− withSpinnerNoTrail "In between, doing something temporary" $ do
26− withSpinner "Runnning something deep inside" $ do
27− delay
28− putLog Notice "You can still log from inside no-trail spinners"
29− delay
30− delay
31− putLog Error "Top nested task finished"
32− delay
33− putLog Error "Some user error while spinning"
34− delay
35− putLog Notice "This is some info mesage"
36− putLog Warning "And now a warning as well"
37− delay
38− return (42 :: Integer)
39− putLog Notice "Now we start a 2nd spinner, run a couple of process, the last of which fails:"
40− withSpinner "Looking around" $ do
41− delay
42− output <- readProcessAndLogStderr Notice $ proc "ls" ["-l", "/"]
43− putLog Notice $ "Output was: " <> T.pack output
44− delay
45− callProcessAndLogOutput (Notice, Error) $ proc "ls" ["-l", "/does-not-exist"]
46− delay
47− failWith "Something dangerous happened"
48− where
49− delay = liftIO $ threadDelay 1000000
lib/cliapp/src/Obelisk/CliApp/Logging.hs+102−40
@@ -4,15 +4,36 @@
44{-# LANGUAGE LambdaCase #-}
55{-# LANGUAGE MultiParamTypeClasses #-}
66{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE RankNTypes #-}
78{-# LANGUAGE ScopedTypeVariables #-}
89-- | Provides a logging handler that facilitates safe ouputting to terminal using MVar based locking.
910-- | Spinner.hs and Process.hs work on this guarantee.
10−module Obelisk.CliApp.Logging where
11+module Obelisk.CliApp.Logging
12+ ( AsUnstructuredError (..)
13+ , newCliConfig
14+ , runCli
15+ , verboseLogLevel
16+ , isOverwrite
17+ , getSeverity
18+ , getLogLevel
19+ , setLogLevel
20+ , putLog
21+ , putLogRaw
22+ , failWith
23+ , errorToWarning
24+ , withExitFailMessage
25+ , writeLog
26+ , allowUserToMakeLoggingVerbose
27+ , getChars
28+ , fork
29+ ) where
1130
1231import Control.Concurrent (ThreadId, forkIO, killThread, threadDelay)
1332import Control.Concurrent.MVar (modifyMVar_, newMVar)
33+import Control.Lens (Prism', review)
1434import Control.Monad (unless, void, when)
1535import Control.Monad.Catch (MonadCatch, MonadMask, bracket, catch, throwM)
36+import Control.Monad.Except (throwError)
1637import Control.Monad.IO.Class (liftIO)
1738import Control.Monad.Log (Severity (..), WithSeverity (..), logMessage, runLoggingT)
1839import Control.Monad.Loops (iterateUntil)
@@ -22,26 +43,39 @@ import Data.Semigroup ((<>))
2243import Data.Text (Text)
2344import qualified Data.Text as T
2445import qualified Data.Text.IO as T
25−import System.Console.ANSI (Color (Red, White, Yellow), ColorIntensity (Vivid),
46+import GHC.IO.Encoding.Types
47+import System.Console.ANSI (Color (Red, Yellow), ColorIntensity (Vivid),
2648 ConsoleIntensity (FaintIntensity), ConsoleLayer (Foreground),
2749 SGR (SetColor, SetConsoleIntensity), clearLine)
28−import System.Exit (ExitCode (..), exitWith)
29−import System.IO (BufferMode (NoBuffering), hFlush, hReady, hSetBuffering, stderr, stdin, stdout)
50+import System.Exit (ExitCode (..))
51+import System.IO
3052
3153import qualified Obelisk.CliApp.TerminalString as TS
54+import Obelisk.CliApp.Theme
3255import Obelisk.CliApp.Types
3356
34−newCliConfig :: Severity -> Bool -> Bool -> IO CliConfig
35−newCliConfig sev noColor noSpinner = do
57+newCliConfig
58+ :: Severity
59+ -> Bool
60+ -> Bool
61+ -> (e -> (Text, Int))
62+ -> IO (CliConfig e)
63+newCliConfig sev noColor noSpinner errorLogExitCode = do
3664 level <- newIORef sev
3765 lock <- newMVar False
3866 tipDisplayed <- newIORef False
3967 stack <- newIORef ([], [])
40− return $ CliConfig level noColor noSpinner lock tipDisplayed stack
68+ textEncoding <- hGetEncoding stdout
69+ let theme = if maybe False supportsUnicode textEncoding
70+ then unicodeTheme
71+ else noUnicodeTheme
72+ return $ CliConfig level noColor noSpinner lock tipDisplayed stack errorLogExitCode theme
4173
42−runCli :: MonadIO m => CliConfig -> CliT m a -> m a
74+runCli :: MonadIO m => CliConfig e -> CliT e m a -> m a
4375runCli c =
4476 flip runLoggingT (handleLog c)
77+ . flip runReaderT (_cliConfig_errorLogExitCode c)
78+ . unDieT
4579 . flip runReaderT c
4680 . unCliT
4781
@@ -59,18 +93,18 @@ getSeverity = \case
5993 Output_LogRaw (WithSeverity sev _) -> Just sev
6094 _ -> Nothing
6195
62−setLogLevel :: (MonadIO m, HasCliConfig m) => Severity -> m ()
63−setLogLevel sev = do
64− l <- _cliConfig_logLevel <$> getCliConfig
65− liftIO $ writeIORef l sev
66−
67−getLogLevel :: (MonadIO m, HasCliConfig m) => m Severity
96+getLogLevel :: (MonadIO m, HasCliConfig e m) => m Severity
6897getLogLevel = getLogLevel' =<< getCliConfig
6998
70−getLogLevel' :: MonadIO m => CliConfig -> m Severity
99+getLogLevel' :: MonadIO m => CliConfig e -> m Severity
71100getLogLevel' = liftIO . readIORef . _cliConfig_logLevel
72101
73−handleLog :: MonadIO m => CliConfig -> Output -> m ()
102+setLogLevel :: (MonadIO m, HasCliConfig e m) => Severity -> m ()
103+setLogLevel sev = do
104+ l <- _cliConfig_logLevel <$> getCliConfig
105+ liftIO $ writeIORef l sev
106+
107+handleLog :: MonadIO m => CliConfig e -> Output -> m ()
74108handleLog conf output = do
75109 level <- getLogLevel' conf
76110 liftIO $ modifyMVar_ (_cliConfig_lock conf) $ \wasOverwriting -> do
@@ -98,7 +132,7 @@ handleLog' noColor output = do
98132 hFlush stdout
99133 Output_Overwrite ts -> liftIO $ do
100134 width <- TS.getTerminalWidth
101− T.putStr $ "\r" <> (TS.render (not noColor) width ts)
135+ T.putStr $ "\r" <> TS.render (not noColor) width ts
102136 hFlush stdout
103137 Output_ClearLine -> liftIO $ do
104138 -- Go to the first column and clear the whole line
@@ -107,26 +141,35 @@ handleLog' noColor output = do
107141 hFlush stdout
108142 return $ isOverwrite output
109143
110−-- | Log a message to the console.
111−--
112−-- Logs safely even if there are ongoing spinners.
113−putLog :: Cli m => Severity -> Text -> m ()
114−putLog sev = logMessage . Output_Log . WithSeverity sev
115−
116144-- | Like `putLog` but without the implicit newline added.
117−putLogRaw :: Cli m => Severity -> Text -> m ()
145+putLogRaw :: CliLog m => Severity -> Text -> m ()
118146putLogRaw sev = logMessage . Output_LogRaw . WithSeverity sev
119147
148+-- | Indicates unstructured errors form one variant (or conceptual projection)
149+-- of the error type.
150+--
151+-- Shouldn't really use this, but who has time to clean up that much!
152+class AsUnstructuredError e where
153+ asUnstructuredError :: Prism' e Text
154+
155+instance AsUnstructuredError Text where
156+ asUnstructuredError = id
157+
120158-- | Like `putLog Alert` but also abrupts the program.
121−failWith :: (MonadIO m, Cli m) => Text -> m a
122−failWith s = do
123− putLog Alert s
124− liftIO $ exitWith $ ExitFailure 2
159+failWith :: (CliThrow e m, AsUnstructuredError e) => Text -> m a
160+failWith = throwError . review asUnstructuredError
161+
162+errorToWarning
163+ :: (HasCliConfig e m, CliLog m)
164+ => e -> m ()
165+errorToWarning e = do
166+ c <- getCliConfig
167+ putLog Warning $ fst $ _cliConfig_errorLogExitCode c e
125168
126169-- | Intercept ExitFailure exceptions and log the given alert before exiting.
127170--
128171-- This is useful when you want to provide contextual information to a deeper failure.
129−withExitFailMessage :: (Cli m, MonadCatch m) => Text -> m a -> m a
172+withExitFailMessage :: (CliLog m, MonadCatch m) => Text -> m a -> m a
130173withExitFailMessage msg f = f `catch` \(e :: ExitCode) -> do
131174 case e of
132175 ExitFailure _ -> putLog Alert msg
@@ -134,25 +177,27 @@ withExitFailMessage msg f = f `catch` \(e :: ExitCode) -> do
134177 throwM e
135178
136179-- | Write log to stdout, with colors (unless `noColor`)
137−writeLog:: (MonadIO m, MonadMask m) => Bool -> Bool -> WithSeverity Text -> m ()
138−writeLog withNewLine noColor (WithSeverity severity s)
139− | noColor && severity <= Warning = liftIO $ putFn $ T.pack (show severity) <> ": " <> s
140− | not noColor && severity <= Error = TS.putStrWithSGR errorColors h withNewLine s
141− | not noColor && severity <= Warning = TS.putStrWithSGR warningColors h withNewLine s
142− | not noColor && severity >= Debug = TS.putStrWithSGR debugColors h withNewLine s
143− | otherwise = liftIO $ putFn s
180+writeLog :: (MonadIO m) => Bool -> Bool -> WithSeverity Text -> m ()
181+writeLog withNewLine noColor (WithSeverity severity s) = if T.null s then pure () else write
144182 where
145− putFn = if withNewLine then (T.hPutStrLn h) else (T.hPutStr h)
183+ write
184+ | noColor && severity <= Warning = liftIO $ putFn $ T.pack (show severity) <> ": " <> s
185+ | not noColor && severity <= Error = TS.putStrWithSGR errorColors h withNewLine s
186+ | not noColor && severity <= Warning = TS.putStrWithSGR warningColors h withNewLine s
187+ | not noColor && severity >= Debug = TS.putStrWithSGR debugColors h withNewLine s
188+ | otherwise = liftIO $ putFn s
189+
190+ putFn = if withNewLine then T.hPutStrLn h else T.hPutStr h
146191 h = if severity <= Error then stderr else stdout
147192 errorColors = [SetColor Foreground Vivid Red]
148193 warningColors = [SetColor Foreground Vivid Yellow]
149− debugColors = [SetColor Foreground Vivid White, SetConsoleIntensity FaintIntensity]
194+ debugColors = [SetConsoleIntensity FaintIntensity]
150195
151196-- | Allow the user to immediately switch to verbose logging upon pressing a particular key.
152197--
153198-- Call this function in a thread, and kill it to turn off keystroke monitoring.
154199allowUserToMakeLoggingVerbose
155− :: (MonadIO m, MonadMask m, Cli m, HasCliConfig m)
200+ :: (MonadIO m, MonadMask m, CliLog m, HasCliConfig e m)
156201 => String -- ^ The key to press in order to make logging verbose
157202 -> m ()
158203allowUserToMakeLoggingVerbose keyCode = bracket showTip (liftIO . killThread) $ \_ -> do
@@ -185,7 +230,24 @@ getChars = reverse <$> f mempty
185230 True -> f (x:xs)
186231 False -> return (x:xs)
187232
188−fork :: (HasCliConfig m, MonadIO m) => CliT IO () -> m ThreadId
233+fork :: (HasCliConfig e m, MonadIO m) => CliT e IO () -> m ThreadId
189234fork f = do
190235 c <- getCliConfig
191236 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+194−54
@@ -1,7 +1,6 @@
11{-# LANGUAGE FlexibleContexts #-}
22{-# LANGUAGE LambdaCase #-}
33{-# LANGUAGE MultiParamTypeClasses #-}
4−{-# LANGUAGE MultiWayIf #-}
54{-# LANGUAGE OverloadedStrings #-}
65{-# LANGUAGE ScopedTypeVariables #-}
76{-# LANGUAGE TupleSections #-}
@@ -9,88 +8,195 @@
98-- | An extension of `System.Process` that integrates with logging (`Obelisk.CLI.Logging`)
109-- and is thus spinner friendly.
1110module Obelisk.CliApp.Process
12− ( ProcessFailed (..)
13− , readProcessAndLogStderr
11+ ( AsProcessFailure (..)
12+ , ProcessFailure (..)
13+ , ProcessSpec (..)
14+ , callCommand
15+ , callProcess
1416 , callProcessAndLogOutput
1517 , createProcess
1618 , createProcess_
17− , callProcess
18− , callCommand
19+ , exitCodeToException
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
1933 ) where
2034
21−import Control.Applicative (liftA2)
22−import Control.Monad (void, (<=<))
23−import Control.Monad.Catch (Exception, MonadMask, throwM)
35+import Control.Monad ((<=<), join, void)
36+import Control.Monad.Catch (MonadMask, bracketOnError)
37+import Control.Monad.Except (throwError)
38+import Control.Monad.Fail
2439import Control.Monad.IO.Class (MonadIO, liftIO)
40+import Control.Lens (Prism', review)
41+import qualified Data.ByteString as BS
2542import qualified Data.ByteString.Char8 as BSC
43+import qualified Data.ByteString.UTF8 as BSU
2644import Data.Function (fix)
45+import Data.Map (Map)
46+import qualified Data.Map as Map
2747import Data.Monoid ((<>))
48+import Data.Text (Text)
2849import qualified Data.Text as T
29−import Data.Text.Encoding (decodeUtf8)
30−import qualified Data.Text.IO as T
50+import qualified Data.Text.Encoding as T
51+import Data.Text.Encoding.Error (lenientDecode)
52+import System.Environment (getEnvironment)
3153import System.Exit (ExitCode (..))
3254import System.IO (Handle)
3355import System.IO.Streams (InputStream, handleToInputStream)
3456import qualified System.IO.Streams as Streams
3557import System.IO.Streams.Concurrent (concurrentMerge)
36−import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), cmdspec, std_err, std_out,
37− waitForProcess)
58+import System.Process (CreateProcess, ProcessHandle, StdStream (CreatePipe), std_err, std_out)
3859import qualified System.Process as Process
60+import Text.ShellEscape (bash, bytes)
61+import qualified Data.Aeson as Aeson
3962
4063import Control.Monad.Log (Severity (..))
4164import Obelisk.CliApp.Logging (putLog, putLogRaw)
42−import Obelisk.CliApp.Types (Cli)
65+import Obelisk.CliApp.Types (CliLog, CliThrow)
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
4374
44−data ProcessFailed = ProcessFailed Process.CmdSpec Int -- exit code
75+shell :: String -> ProcessSpec
76+shell cmd = ProcessSpec (Process.shell cmd) Nothing
77+
78+setEnvOverride :: (Map String String -> Map String String) -> ProcessSpec -> ProcessSpec
79+setEnvOverride f p = p { _processSpec_overrideEnv = Just f }
80+
81+overCreateProcess :: (CreateProcess -> CreateProcess) -> ProcessSpec -> ProcessSpec
82+overCreateProcess f (ProcessSpec p x) = ProcessSpec (f p) x
83+
84+setDelegateCtlc :: Bool -> ProcessSpec -> ProcessSpec
85+setDelegateCtlc b = overCreateProcess (\p -> p { Process.delegate_ctlc = b })
86+
87+setCwd :: Maybe FilePath -> ProcessSpec -> ProcessSpec
88+setCwd fp = overCreateProcess (\p -> p { Process.cwd = fp })
89+
90+
91+-- TODO put back in `Obelisk.CliApp.Process` and use prisms for extensible exceptions
92+data ProcessFailure = ProcessFailure Process.CmdSpec Int -- exit code
4593 deriving Show
4694
47−instance Exception ProcessFailed
95+-- | Indicates arbitrary process failures form one variant (or conceptual projection) of
96+-- the error type.
97+class AsProcessFailure e where
98+ asProcessFailure :: Prism' e ProcessFailure
99+
100+instance AsProcessFailure ProcessFailure where
101+ asProcessFailure = id
48102
49103readProcessAndLogStderr
50− :: (MonadIO m, MonadMask m, Cli m)
51− => Severity -> CreateProcess -> m String
104+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
105+ => Severity -> ProcessSpec -> m Text
52106readProcessAndLogStderr sev process = do
53107 (out, _err) <- withProcess process $ \_out err -> do
54108 streamToLog =<< liftIO (streamHandle sev err)
55− -- TODO: Why are we using Text here?
56− liftIO $ T.unpack . T.strip <$> T.hGetContents out
109+ liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
57110
58−-- | Like `System.Process.callProcess` but logs the combined output--stdout and stderr with the corresponding
59−-- severity.
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 ""
131+
132+-- | Like `System.Process.readProcess` but logs the combined output (stdout and stderr)
133+-- with the corresponding severity.
134+--
135+-- Usually this function is called as `readProcessAndLogOutput (Debug, Error)`. However
136+-- some processes are known to spit out diagnostic or informative messages in stderr, in
137+-- which case it is advisable to call it with a non-Error severity for stderr, like
138+-- `readProcessAndLogOutput (Debug, Debug)`.
139+readProcessAndLogOutput
140+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadFail m)
141+ => (Severity, Severity) -> ProcessSpec -> m Text
142+readProcessAndLogOutput (sev_out, sev_err) process = do
143+ (_, Just out, Just err, p) <- createProcess $ overCreateProcess
144+ (\p -> p { std_out = CreatePipe , std_err = CreatePipe }) process
145+
146+ -- TODO interleave stdout and stderr in log correctly
147+ streamToLog =<< liftIO (streamHandle sev_err err)
148+ outText <- liftIO $ T.decodeUtf8With lenientDecode <$> BS.hGetContents out
149+ putLogRaw sev_out outText
150+
151+ outText <$ (exitCodeToException process =<< waitForProcess p)
152+
153+-- | Like 'System.Process.callProcess' but logs the combined output (stdout and stderr)
154+-- with the corresponding severity.
60155--
61−-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However some processes
62−-- are known to spit out diagnostic or informative messages in stderr, in which case it is advisable to call
63−-- it with a non-Error severity for stderr, like `callProcessAndLogOutput (Debug, Debug)`.
156+-- Usually this function is called as `callProcessAndLogOutput (Debug, Error)`. However
157+-- some processes are known to spit out diagnostic or informative messages in stderr, in
158+-- which case it is advisable to call it with a non-Error severity for stderr, like
159+-- `callProcessAndLogOutput (Debug, Debug)`.
64160callProcessAndLogOutput
65− :: (MonadIO m, MonadMask m, Cli m)
66− => (Severity, Severity) -> CreateProcess -> m ()
67−callProcessAndLogOutput (sev_out, sev_err) process = do
161+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
162+ => (Severity, Severity) -> ProcessSpec -> m ()
163+callProcessAndLogOutput (sev_out, sev_err) process =
68164 void $ withProcess process $ \out err -> do
69− stream <- liftIO $ do
70− uncurry combineStream =<< liftA2 (,) (streamHandle sev_out out) (streamHandle sev_err err)
165+ stream <- liftIO $ join $ combineStream
166+ <$> streamHandle sev_out out
167+ <*> streamHandle sev_err err
71168 streamToLog stream
72169 where
73170 combineStream s1 s2 = concurrentMerge [s1, s2]
74171
75−-- | 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
76173createProcess
77− :: (MonadIO m, Cli m)
78− => CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
79−createProcess p = do
80− putLog Debug $ "Creating process: " <> T.pack (show $ cmdspec p)
174+ :: (MonadIO m, CliLog m)
175+ => ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
176+createProcess procSpec = do
177+ p <- mkCreateProcess procSpec
178+ putLog Debug $ "Creating process: " <> reconstructProcSpec procSpec
81179 liftIO $ Process.createProcess p
82180
83181-- | Like `System.Process.createProcess_` but also logs (debug) the process being run
84182createProcess_
85− :: (MonadIO m, Cli m)
86− => String -> CreateProcess -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
87−createProcess_ name p = do
88− putLog Debug $ "Creating process " <> T.pack name <> ": " <> T.pack (show $ cmdspec p)
89− liftIO $ Process.createProcess p
183+ :: (MonadIO m, CliLog m)
184+ => String -> ProcessSpec -> m (Maybe Handle, Maybe Handle, Maybe Handle, ProcessHandle)
185+createProcess_ name procSpec = do
186+ p <- mkCreateProcess procSpec
187+ putLog Debug $ "Creating process " <> T.pack name <> ": " <> reconstructProcSpec procSpec
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) }
90196
91197-- | Like `System.Process.callProcess` but also logs (debug) the process being run
92198callProcess
93− :: (MonadIO m, Cli m)
199+ :: (MonadIO m, CliLog m)
94200 => String -> [String] -> m ()
95201callProcess exe args = do
96202 putLog Debug $ "Calling process " <> T.pack exe <> " with args: " <> T.pack (show args)
@@ -98,25 +204,37 @@ callProcess exe args = do
98204
99205-- | Like `System.Process.callCommand` but also logs (debug) the command being run
100206callCommand
101− :: (MonadIO m, Cli m)
207+ :: (MonadIO m, CliLog m)
102208 => String -> m ()
103209callCommand cmd = do
104210 putLog Debug $ "Calling command " <> T.pack cmd
105211 liftIO $ Process.callCommand cmd
106212
107213withProcess
108− :: (MonadIO m, MonadMask m, Cli m)
109− => CreateProcess -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
110−withProcess process f = do -- TODO: Use bracket.
111− -- FIXME: Using `withCreateProcess` here leads to something operating illegally on closed handles.
112− (_, Just out, Just err, p) <- createProcess $ process
113− { std_out = CreatePipe , std_err = CreatePipe }
114−
115− f out err -- Pass the handles to the passed function
214+ :: (MonadIO m, CliLog m, CliThrow e m, AsProcessFailure e, MonadMask m)
215+ => ProcessSpec -> (Handle -> Handle -> m ()) -> m (Handle, Handle)
216+withProcess process f =
217+ bracketOnError
218+ (createProcess $ overCreateProcess
219+ (\x -> x { std_out = CreatePipe , std_err = CreatePipe }) process
220+ )
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+ )
116228
117− liftIO (waitForProcess p) >>= \case
118− ExitSuccess -> return (out, err)
119− ExitFailure code -> throwM $ ProcessFailed (cmdspec process) code
229+-- | Runs a process to completion failing if it does not exit cleanly.
230+runProcess_
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)
120238
121239-- Create an input stream from the file handle, associating each item with the given severity.
122240streamHandle :: Severity -> Handle -> IO (InputStream (Severity, BSC.ByteString))
@@ -124,9 +242,31 @@ streamHandle sev = Streams.map (sev,) <=< handleToInputStream
124242
125243-- | Read from an input stream and log its contents
126244streamToLog
127− :: (MonadIO m, MonadMask m, Cli m)
245+ :: (MonadIO m, CliLog m)
128246 => InputStream (Severity, BSC.ByteString) -> m ()
129247streamToLog stream = fix $ \loop -> do
130248 liftIO (Streams.read stream) >>= \case
131249 Nothing -> return ()
132− Just (sev, line) -> putLogRaw sev (decodeUtf8 line) >> loop
250+ Just (sev, line) -> putLogRaw sev (T.decodeUtf8With lenientDecode line) >> loop
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'
263+reconstructCommand :: Process.CmdSpec -> Text
264+reconstructCommand p = case p of
265+ Process.ShellCommand str -> T.pack str
266+ Process.RawCommand c as -> processToShellString c as
267+ where
268+ processToShellString cmd args = T.pack $ unwords $
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+22−28
@@ -3,7 +3,6 @@
33{-# LANGUAGE MultiParamTypeClasses #-}
44{-# LANGUAGE OverloadedStrings #-}
55{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE TupleSections #-}
76-- | Provides a simple CLI spinner that interoperates cleanly with the rest of the logging output.
87module Obelisk.CliApp.Spinner
98 ( withSpinner
@@ -24,11 +23,12 @@ import System.Console.ANSI (Color (Blue, Cyan, Green, Red))
2423
2524import Obelisk.CliApp.Logging (allowUserToMakeLoggingVerbose, fork, putLog)
2625import Obelisk.CliApp.TerminalString (TerminalString (..), enquiryCode)
27−import Obelisk.CliApp.Types (Cli, CliConfig (..), HasCliConfig, Output (..), getCliConfig)
26+import Obelisk.CliApp.Theme
27+import Obelisk.CliApp.Types (CliLog, CliConfig (..), HasCliConfig, Output (..), getCliConfig)
2828
2929-- | Run an action with a CLI spinner.
3030withSpinner
31− :: (MonadIO m, MonadMask m, Cli m, HasCliConfig m)
31+ :: (MonadIO m, MonadMask m, CliLog m, HasCliConfig e m)
3232 => Text -> m a -> m a
3333withSpinner s = withSpinner' s $ Just $ const s
3434
@@ -39,19 +39,20 @@ withSpinner s = withSpinner' s $ Just $ const s
3939-- The 'no trail' property automatically carries over to sub-spinners (in that
4040-- they won't leave a trail either).
4141withSpinnerNoTrail
42− :: (MonadIO m, MonadMask m, Cli m, HasCliConfig m)
42+ :: (MonadIO m, MonadMask m, CliLog m, HasCliConfig e m)
4343 => Text -> m a -> m a
4444withSpinnerNoTrail s = withSpinner' s Nothing
4545
4646-- | Advanced version that controls the display and content of the trail message.
4747withSpinner'
48− :: (MonadIO m, MonadMask m, Cli m, HasCliConfig m)
48+ :: (MonadIO m, MonadMask m, CliLog m, HasCliConfig e m)
4949 => Text
5050 -> Maybe (a -> Text) -- ^ Leave an optional trail with the given message creator
5151 -> m a
5252 -> m a
5353withSpinner' msg mkTrail action = do
54− noSpinner <- _cliConfig_noSpinner <$> getCliConfig
54+ cliConf <- getCliConfig
55+ let noSpinner = _cliConfig_noSpinner cliConf
5556 if noSpinner
5657 then putLog Notice msg >> action
5758 else bracket' run cleanup $ const action
@@ -61,8 +62,11 @@ withSpinner' msg mkTrail action = do
6162 modifyStack pushSpinner >>= \case
6263 True -> do -- Top-level spinner; fork a thread to manage output of anything on the stack
6364 ctrleThread <- fork $ allowUserToMakeLoggingVerbose enquiryCode
65+ cliConf <- getCliConfig
66+ let theme = _cliConfig_theme cliConf
67+ spinner = coloredSpinner $ _cliTheme_spinner theme
6468 spinnerThread <- fork $ runSpinner spinner $ \c -> do
65− logs <- renderSpinnerStack c . snd <$> readStack
69+ logs <- renderSpinnerStack theme c . snd <$> readStack
6670 logMessage $ Output_Overwrite logs
6771 pure [ctrleThread, spinnerThread]
6872 False -> -- Sub-spinner; nothing to do.
@@ -70,13 +74,15 @@ withSpinner' msg mkTrail action = do
7074 cleanup tids resultM = do
7175 liftIO $ mapM_ killThread tids
7276 logMessage Output_ClearLine
73− logsM <- modifyStack $ popSpinner $ case resultM of
77+ cliConf <- getCliConfig
78+ let theme = _cliConfig_theme cliConf
79+ logsM <- modifyStack $ (popSpinner theme) $ case resultM of
7480 Nothing ->
75− ( TerminalString_Colorized Red "✖"
81+ ( TerminalString_Colorized Red $ _cliTheme_failed $ _cliConfig_theme cliConf
7682 , Just msg -- Always display final message if there was an exception.
7783 )
7884 Just result ->
79− ( TerminalString_Colorized Green "✔"
85+ ( TerminalString_Colorized Green $ _cliTheme_done $ _cliConfig_theme cliConf
8086 , mkTrail <*> pure result
8187 )
8288 -- Last message, finish off with newline.
@@ -87,10 +93,10 @@ withSpinner' msg mkTrail action = do
8793 )
8894 where
8995 isTemporary = isNothing mkTrail
90− popSpinner (mark, trailMsgM) (flag, old) =
96+ popSpinner theme (mark, trailMsgM) (flag, old) =
9197 ( (newFlag, new)
9298 -- With final trail spinner message to render
93− , renderSpinnerStack mark . (: new) . TerminalString_Normal <$> (
99+ , renderSpinnerStack theme mark . (: new) . TerminalString_Normal <$> (
94100 if inTemporarySpinner then Nothing else trailMsgM
95101 )
96102 )
@@ -102,19 +108,19 @@ withSpinner' msg mkTrail action = do
102108 =<< fmap _cliConfig_spinnerStack getCliConfig
103109 modifyStack f = liftIO . flip atomicModifyIORef' f
104110 =<< fmap _cliConfig_spinnerStack getCliConfig
105− spinner = coloredSpinner defaultSpinnerTheme
106111
107112-- | How nested spinner logs should be displayed
108113renderSpinnerStack
109− :: TerminalString -- ^ That which comes before the final element in stack
114+ :: CliTheme
115+ -> TerminalString -- ^ That which comes before the final element in stack
110116 -> [TerminalString] -- ^ Spinner elements in reverse order
111117 -> [TerminalString]
112−renderSpinnerStack mark = L.intersperse space . go . L.reverse
118+renderSpinnerStack theme mark = L.intersperse space . go . L.reverse
113119 where
114120 go [] = []
115121 go (x:[]) = mark : [x]
116122 go (x:xs) = arrow : x : go xs
117− arrow = TerminalString_Colorized Blue "⇾"
123+ arrow = TerminalString_Colorized Blue $ _cliTheme_arrow theme
118124 space = TerminalString_Normal " "
119125
120126-- | 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
130136 where
131137 delay = liftIO $ threadDelay 100000 -- A shorter delay ensures that we update promptly.
132138
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−
145139-- | Like `bracket` but the `release` function can know whether an exception was raised
146140bracket' :: MonadMask m => m a -> (a -> Maybe c -> m b) -> (a -> m c) -> m c
147141bracket' 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+102−19
@@ -1,27 +1,33 @@
11{-# LANGUAGE ConstraintKinds #-}
22{-# LANGUAGE FlexibleContexts #-}
33{-# LANGUAGE FlexibleInstances #-}
4+{-# LANGUAGE FunctionalDependencies #-}
5+{-# LANGUAGE LambdaCase #-}
46{-# LANGUAGE GeneralizedNewtypeDeriving #-}
57{-# LANGUAGE MultiParamTypeClasses #-}
8+{-# LANGUAGE OverloadedStrings #-}
9+{-# LANGUAGE StandaloneDeriving #-}
10+{-# LANGUAGE UndecidableInstances #-}
611module Obelisk.CliApp.Types where
712
813import Control.Concurrent.MVar (MVar)
914import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
10−import Control.Monad.Log (LoggingT, MonadLog, Severity (..), WithSeverity (..))
11−import Control.Monad.Reader (MonadIO, ReaderT (..), ask)
15+import Control.Monad.Fail (MonadFail)
16+import Control.Monad.Log (LoggingT(..), MonadLog, Severity (..), WithSeverity (..), logMessage)
17+import Control.Monad.Reader (MonadIO, ReaderT (..), MonadReader (..), ask, mapReaderT)
18+import Control.Monad.Writer (WriterT)
19+import Control.Monad.State (StateT)
20+import Control.Monad.Except (ExceptT, MonadError (..))
21+import Control.Monad.IO.Class (liftIO)
22+import Control.Monad.Trans (MonadTrans, lift)
1223import Data.IORef (IORef)
1324import Data.Text (Text)
25+import System.Exit (ExitCode (..), exitWith)
1426
1527import Obelisk.CliApp.TerminalString (TerminalString)
28+import Obelisk.CliApp.Theme (CliTheme)
1629
17−data CliConfig = CliConfig
18− { _cliConfig_logLevel :: IORef Severity -- We are capable of changing the log level at runtime
19− , _cliConfig_noColor :: Bool -- Disallow coloured output
20− , _cliConfig_noSpinner :: Bool -- Disallow spinners
21− , _cliConfig_lock :: MVar Bool -- Whether the last message was an Overwrite output
22− , _cliConfig_tipDisplayed :: IORef Bool -- Whether the user tip (to make verbose) was already displayed
23− , _cliConfig_spinnerStack :: IORef ([Bool], [TerminalString]) -- Stack of logs from nested spinners
24− }
30+--------------------------------------------------------------------------------
2531
2632data Output
2733 = Output_Log (WithSeverity Text) -- Regular logging message (with colors and newlines)
@@ -31,19 +37,96 @@ data Output
3137 | Output_ClearLine -- Clear the line
3238 deriving (Eq, Show, Ord)
3339
34−type Cli m = MonadLog Output m
40+type CliLog m = MonadLog Output m
3541
36−newtype CliT m a = CliT
37− { unCliT :: ReaderT CliConfig (LoggingT Output m) a
38− }
42+type CliThrow e m = MonadError e m
43+
44+-- | Log a message to the console.
45+--
46+-- Logs safely even if there are ongoing spinners.
47+putLog :: CliLog m => Severity -> Text -> m ()
48+putLog sev = logMessage . Output_Log . WithSeverity sev
49+
50+deriving instance MonadFail m => MonadFail (LoggingT Output m)
51+
52+newtype DieT e m a = DieT { unDieT :: ReaderT (e -> (Text, Int)) (LoggingT Output m) a }
3953 deriving
40− ( Functor, Applicative, Monad, MonadIO
54+ ( Functor, Applicative, Monad, MonadIO, MonadFail
4155 , MonadThrow, MonadCatch, MonadMask
4256 , MonadLog Output
4357 )
4458
45−class Monad m => HasCliConfig m where
46− getCliConfig :: m CliConfig
59+instance MonadTrans (DieT e) where
60+ lift = DieT . lift . lift
61+
62+-- | Error printer is private to DieT
63+instance MonadReader r m => MonadReader r (DieT e m) where
64+ ask = DieT $ lift $ ask
65+ local = (\f (DieT a) -> DieT $ f a) . mapReaderT . local
66+ reader = DieT . lift . lift . reader
67+
68+-- TODO generalize to bigger error types
69+instance MonadIO m => MonadError e (DieT e m) where
70+ throwError e = do
71+ handler <- DieT ask
72+ let (output, exitCode) = handler e
73+ putLog Alert output
74+ liftIO $ exitWith $ ExitFailure exitCode
75+
76+ -- Cannot catch
77+ catchError m _ = m
78+
79+--------------------------------------------------------------------------------
80+
81+data CliConfig e = CliConfig
82+ { -- | We are capable of changing the log level at runtime
83+ _cliConfig_logLevel :: IORef Severity
84+ , -- | Disallow coloured output
85+ _cliConfig_noColor :: Bool
86+ , -- | Disallow spinners
87+ _cliConfig_noSpinner :: Bool
88+ , -- | Whether the last message was an Overwrite output
89+ _cliConfig_lock :: MVar Bool
90+ , -- | Whether the user tip (to make verbose) was already displayed
91+ _cliConfig_tipDisplayed :: IORef Bool
92+ , -- | Stack of logs from nested spinners
93+ _cliConfig_spinnerStack :: IORef ([Bool], [TerminalString])
94+ , -- | Failure handler. How to log error and what exit status to use.
95+ _cliConfig_errorLogExitCode :: e -> (Text, Int)
96+ , -- | Theme strings for spinners
97+ _cliConfig_theme :: CliTheme
98+ }
99+
100+class Monad m => HasCliConfig e m | m -> e where
101+ getCliConfig :: m (CliConfig e)
102+
103+instance HasCliConfig e m => HasCliConfig e (ReaderT r m) where
104+ getCliConfig = lift getCliConfig
105+
106+instance (Monoid w, HasCliConfig e m) => HasCliConfig e (WriterT w m) where
107+ getCliConfig = lift getCliConfig
108+
109+instance HasCliConfig e m => HasCliConfig e (StateT s m) where
110+ getCliConfig = lift getCliConfig
111+
112+instance HasCliConfig e m => HasCliConfig e (ExceptT e m) where
113+ getCliConfig = lift getCliConfig
114+
115+--------------------------------------------------------------------------------
116+
117+newtype CliT e m a = CliT
118+ { unCliT :: ReaderT (CliConfig e) (DieT e m) a
119+ }
120+ deriving
121+ ( Functor, Applicative, Monad, MonadIO, MonadFail
122+ , MonadThrow, MonadCatch, MonadMask
123+ , MonadLog Output -- CliLog
124+ , MonadError e -- CliThrow
125+ , MonadReader (CliConfig e) -- HasCliConfig
126+ )
127+
128+instance MonadTrans (CliT e) where
129+ lift = CliT . lift . lift
47130
48−instance Monad m => HasCliConfig (CliT m) where
49− getCliConfig = CliT ask
131+instance Monad m => HasCliConfig e (CliT e m)where
132+ getCliConfig = ask
lib/command/obelisk-command.cabal+21−16
@@ -1,5 +1,5 @@
11name: obelisk-command
2−version: 0.1
2+version: 0.9.0.1
33cabal-version: >= 1.8
44build-type: Simple
55
@@ -7,41 +7,48 @@ library
77 hs-source-dirs: src
88 build-depends:
99 aeson
10− , ansi-terminal
11− , Cabal
1210 , aeson-pretty
11+ , ansi-terminal
1312 , base
14− , base16-bytestring
15− , binary
1613 , bytestring
17− , obelisk-cliapp
18− , obelisk-migration
14+ , Cabal
1915 , containers
2016 , data-default
2117 , directory
2218 , either
19+ , errors
20+ , exceptions
21+ , extra
2322 , filepath
23+ , git
2424 , github
2525 , here
26− , hit
26+ , hnix
27+ , hpack
2728 , io-streams
28− , exceptions
29− , logging-effect
3029 , lens
30+ , logging-effect
31+ , megaparsec
3132 , modern-uri
3233 , monad-loops
34+ , monoidal-containers
3335 , mtl
3436 , network
3537 , network-uri
38+ , obelisk-cliapp
3639 , optparse-applicative
3740 , placeholders
3841 , process
42+ , shell-escape
3943 , temporary
4044 , terminal-size
4145 , text
4246 , time
4347 , transformers
44− , unix
48+ , unix-compat
49+ , unordered-containers
50+ , utf8-string
51+ , which
4552 , yaml
4653 exposed-modules:
4754 Obelisk.App
@@ -51,14 +58,12 @@ library
5158 Obelisk.Command.Project
5259 Obelisk.Command.Run
5360 Obelisk.Command.Thunk
54− Obelisk.Command.Upgrade
55− Obelisk.Command.Upgrade.Hash
5661 Obelisk.Command.Utils
5762 Obelisk.Command.VmBuilder
58− -- -fobject-code is so that the StaticPointers extension can work in ghci
59− ghc-options: -Wall -fobject-code
63+ Obelisk.Command.Preprocessor
64+ ghc-options: -Wall
6065
6166executable ob
6267 main-is: src-bin/ob.hs
6368 build-depends: base, obelisk-command
64− 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+73−15
@@ -2,40 +2,92 @@
22{-# LANGUAGE FlexibleContexts #-}
33{-# LANGUAGE FlexibleInstances #-}
44{-# LANGUAGE GeneralizedNewtypeDeriving #-}
5+{-# LANGUAGE LambdaCase #-}
56{-# LANGUAGE MultiParamTypeClasses #-}
67{-# LANGUAGE ScopedTypeVariables #-}
78{-# LANGUAGE StandaloneDeriving #-}
9+{-# LANGUAGE TemplateHaskell #-}
10+{-# LANGUAGE TupleSections #-}
811module Obelisk.App where
912
13+import Control.Lens
1014import Control.Monad.Catch (MonadCatch, MonadMask, MonadThrow)
15+import Control.Monad.Fail (MonadFail)
1116import Control.Monad.Reader (MonadIO, ReaderT (..), ask, runReaderT)
12−import Control.Monad.Trans.Class (lift)
17+import Control.Monad.Writer (WriterT)
18+import Control.Monad.State (StateT)
19+import Control.Monad.Except (ExceptT, MonadError)
20+import Control.Monad.Trans.Class (MonadTrans, lift)
21+import Data.Text (Text)
1322import System.Directory (XdgDirectory (XdgData), getXdgDirectory)
1423import Control.Monad.Log (MonadLog)
1524
16−import Obelisk.CliApp (CliConfig, CliT, HasCliConfig, getCliConfig, runCli, Output)
25+import Obelisk.CliApp
26+ ( CliConfig
27+ , CliLog
28+ , CliThrow
29+ , CliT (..)
30+ , ProcessFailure
31+ , AsProcessFailure (..)
32+ , AsUnstructuredError (..)
33+ , HasCliConfig
34+ , Output
35+ , runCli
36+ )
37+
38+data ObeliskError
39+ = ObeliskError_ProcessError
40+ { obeliskError_err :: ProcessFailure
41+ , obeliskError_mAnn :: Maybe Text
42+ }
43+ | ObeliskError_Unstructured Text
44+
45+makePrisms ''ObeliskError
46+
47+instance AsUnstructuredError ObeliskError where
48+ asUnstructuredError = _ObeliskError_Unstructured
49+
50+-- Only project when the other field is null, otherwise we are not law abiding.
51+instance AsProcessFailure ObeliskError where
52+ asProcessFailure = _ObeliskError_ProcessError . prism (, Nothing) f
53+ where f = \case
54+ (pf, Nothing) -> Right pf
55+ pann@(_, Just _) -> Left pann
1756
1857newtype Obelisk = Obelisk
19− { _obelisk_cliConfig :: CliConfig
58+ { _obelisk_cliConfig :: CliConfig ObeliskError
2059 }
2160
2261newtype ObeliskT m a = ObeliskT
23− { unObeliskT :: ReaderT Obelisk (CliT m) a
62+ { unObeliskT :: ReaderT Obelisk (CliT ObeliskError m) a
2463 }
2564 deriving
26− ( Functor, Applicative, Monad, MonadIO, MonadThrow, MonadCatch, MonadMask
27− , HasObelisk, HasCliConfig)
65+ ( Functor, Applicative, Monad, MonadIO, MonadThrow, MonadCatch, MonadMask, MonadFail
66+ , MonadLog Output -- CliLog
67+ , MonadError ObeliskError -- CliThrow ObeliskError
68+ , HasCliConfig ObeliskError
69+ )
2870
29−deriving instance Monad m => MonadLog Output (ObeliskT m)
71+instance MonadTrans ObeliskT where
72+ lift = ObeliskT . lift . lift
3073
31−class HasObelisk m where
74+class Monad m => HasObelisk m where
3275 getObelisk :: m Obelisk
3376
34−instance Monad m => HasObelisk (ReaderT Obelisk m) where
35− getObelisk = ask
77+instance Monad m => HasObelisk (ObeliskT m) where
78+ getObelisk = ObeliskT ask
79+
80+instance HasObelisk m => HasObelisk (ReaderT r m) where
81+ getObelisk = lift getObelisk
3682
37−instance HasCliConfig m => HasCliConfig (ReaderT Obelisk m) where
38− getCliConfig = lift getCliConfig
83+instance (Monoid w, HasObelisk m) => HasObelisk (WriterT w m) where
84+ getObelisk = lift getObelisk
85+
86+instance HasObelisk m => HasObelisk (StateT r m) where
87+ getObelisk = lift getObelisk
88+
89+instance HasObelisk m => HasObelisk (ExceptT e m) where
90+ getObelisk = lift getObelisk
3991
4092runObelisk :: MonadIO m => Obelisk -> ObeliskT m a -> m a
4193runObelisk c =
@@ -43,13 +95,19 @@ runObelisk c =
4395 . flip runReaderT c
4496 . unObeliskT
4597
46−type MonadObelisk m =
47− ( MonadLog Output m
48− , HasCliConfig m
98+type MonadInfallibleObelisk m =
99+ ( CliLog m
100+ , HasCliConfig ObeliskError m
49101 , HasObelisk m
50102 , MonadIO m
51103 , MonadMask m
52104 )
53105
106+type MonadObelisk m =
107+ ( MonadInfallibleObelisk m
108+ , CliThrow ObeliskError m
109+ , MonadFail m
110+ )
111+
54112getObeliskUserStateDir :: IO FilePath
55113getObeliskUserStateDir = getXdgDirectory XdgData "obelisk"
lib/command/src/Obelisk/Command.hs+272−255
@@ -3,43 +3,35 @@
33{-# LANGUAGE MultiParamTypeClasses #-}
44{-# LANGUAGE OverloadedStrings #-}
55{-# LANGUAGE ScopedTypeVariables #-}
6−{-# LANGUAGE StaticPointers #-}
7−{-# LANGUAGE TypeApplications #-}
6+{-# LANGUAGE TupleSections #-}
87module Obelisk.Command where
98
10−import Control.Monad
11−import Control.Monad.Catch (catch)
12−import Control.Monad.IO.Class (liftIO)
13−import qualified Data.Binary as Binary
9+import Control.Monad.IO.Class (MonadIO, liftIO)
1410import Data.Bool (bool)
15−import qualified Data.ByteString.Base16 as Base16
16−import qualified Data.ByteString.Lazy as LBS
17−import Data.List
18−import Data.Maybe (catMaybes, listToMaybe)
19−import Data.Text (Text)
11+import Data.Foldable (for_)
12+import Data.List (isInfixOf, isPrefixOf)
13+import Data.List.NonEmpty (NonEmpty, nonEmpty)
14+import qualified Data.List.NonEmpty as NonEmpty
15+import qualified Data.Map as Map
2016import qualified Data.Text as T
21−import Data.Text.Encoding
22−import GHC.StaticPtr
17+import Data.Traversable (for)
2318import Options.Applicative
19+import Options.Applicative.Help.Pretty (text, (<$$>))
2420import System.Directory
2521import System.Environment
2622import System.FilePath
2723import qualified System.Info
2824import System.IO (hIsTerminalDevice, stdout)
29−import System.Posix.Process (executeFile)
25+import System.Process (rawSystem)
3026
3127import Obelisk.App
3228import Obelisk.CliApp
33−import Obelisk.CliApp.Demo (cliDemo)
3429import Obelisk.Command.Deploy
3530import Obelisk.Command.Project
3631import Obelisk.Command.Run
3732import Obelisk.Command.Thunk
38−import Obelisk.Command.Upgrade
39−import Obelisk.Command.Upgrade.Hash (getDirectoryHash, getHashAtGitRevision)
40−import Obelisk.Command.Utils
4133import qualified Obelisk.Command.VmBuilder as VmBuilder
42−import Obelisk.Migration (Hash)
34+import qualified Obelisk.Command.Preprocessor as Preprocessor
4335
4436
4537data Args = Args
@@ -82,62 +74,66 @@ argsInfo cfg = info (args cfg <**> helper) $ mconcat
8274initSource :: Parser InitSource
8375initSource = foldl1 (<|>)
8476 [ pure InitSource_Default
85− , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH")
86− , InitSource_Symlink <$> strOption (long "symlink" <> action "directory" <> metavar "PATH")
77+ , InitSource_Branch <$> strOption (long "branch" <> metavar "BRANCH" <> help "Initialize the project using the given BRANCH of Obelisk's official repository")
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")
8779 ]
8880
81+initForce :: Parser Bool
82+initForce = switch (long "force" <> help "Allow ob init to overwrite files")
83+
8984data ObCommand
90− = ObCommand_Init InitSource
85+ = ObCommand_Init InitSource Bool
9186 | ObCommand_Deploy DeployCommand
92− | ObCommand_Run
93− | ObCommand_Thunk ThunkCommand
94− | ObCommand_Repl
95− | ObCommand_Upgrade (Maybe Text)
87+ | ObCommand_Run [(FilePath, Interpret)]
88+ | ObCommand_Profile String [String]
89+ | ObCommand_Thunk ThunkOption
90+ | ObCommand_Repl [(FilePath, Interpret)]
91+ | ObCommand_Watch [(FilePath, Interpret)]
92+ | ObCommand_Shell ShellOpts
93+ | ObCommand_Doc String [String] -- shell and list of packages
94+ | ObCommand_Hoogle String Int -- shell and port
9695 | ObCommand_Internal ObInternal
9796 deriving Show
9897
9998data ObInternal
100− = ObInternal_RunStaticIO StaticKey
101− | ObInternal_Hash (Maybe Text)
102− | ObInternal_CreateMigration
103− | ObInternal_VerifyMigration
104− | ObInternal_Migrate Hash
105− | ObInternal_CLIDemo
99+ -- the preprocessor argument syntax is also handled outside
100+ -- optparse-applicative, but it shouldn't ever conflict with another syntax
101+ = ObInternal_ApplyPackages String String String [String]
102+ | ObInternal_ExportGhciConfig
103+ [(FilePath, Interpret)]
104+ Bool -- ^ Use relative paths
106105 deriving Show
107106
108−inNixShell' :: MonadObelisk m => StaticPtr (ObeliskT IO ()) -> m ()
109−inNixShell' p = withProjectRoot "." $ \root -> do
110− cmd <- liftIO $ unwords <$> mkCmd -- TODO: shell escape instead of unwords
111− projectShell root False "ghc" cmd
112− where
113− mkCmd = do
114− argsCfg <- getArgsConfig
115− myArgs <- getArgs
116− obArgs <- parseCLIArgs argsCfg myArgs
117− progName <- getObeliskExe
118− return $ progName : catMaybes
119− [ Just "--no-handoff"
120− , bool Nothing (Just "--verbose") $ _args_verbose obArgs
121− , Just "internal"
122− , Just "run-static-io"
123− , Just $ encodeStaticKey $ staticKey p
124− ]
125−
126107obCommand :: ArgsConfig -> Parser ObCommand
127108obCommand cfg = hsubparser
128− (mconcat
129− [ command "init" $ info (ObCommand_Init <$> initSource) $ progDesc "Initialize an Obelisk project"
130− , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
131− , command "run" $ info (pure ObCommand_Run) $ progDesc "Run current project in development mode"
132− , command "thunk" $ info (ObCommand_Thunk <$> thunkCommand) $ progDesc "Manipulate thunk directories"
133− , command "repl" $ info (pure ObCommand_Repl) $ progDesc "Open an interactive interpreter"
134− , 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"
135− ])
136− <|> subparser
137− (mconcat
138− [ internal
139− , command "internal" (info (ObCommand_Internal <$> internalCommand) mempty)
140− ])
109+ (mconcat
110+ [ command "init" $ info (ObCommand_Init <$> initSource <*> initForce) $ progDesc "Initialize an Obelisk project"
111+ , command "deploy" $ info (ObCommand_Deploy <$> deployCommand cfg) $ progDesc "Prepare a deployment for an Obelisk project"
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"
114+ , command "thunk" $ info (ObCommand_Thunk <$> thunkOption) $ progDesc "Manipulate thunk directories"
115+ , command "repl" $ info (ObCommand_Repl <$> interpretOpts) $ progDesc "Open an interactive interpreter"
116+ , command "watch" $ info (ObCommand_Watch <$> interpretOpts) $ progDesc "Watch current project for errors and warnings"
117+ , command "shell" $ info (ObCommand_Shell <$> shellOpts) $ progDesc "Enter a shell with project dependencies or run a command in such a shell. E.g. ob shell -- ghc-pkg list"
118+ , command "doc" $ info (ObCommand_Doc <$> shellFlags <*> packageNames) $
119+ progDesc "List paths to haddock documentation for specified packages"
120+ <> footerDoc (Just $
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"
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"
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..."))
141137
142138deployCommand :: ArgsConfig -> Parser DeployCommand
143139deployCommand cfg = hsubparser $ mconcat
@@ -148,8 +144,8 @@ deployCommand cfg = hsubparser $ mconcat
148144 ]
149145 where
150146 platformP = hsubparser $ mconcat
151− [ command "android" $ info (pure Android) mempty
152− , command "ios" $ info (pure IOS <*> strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal")) mempty
147+ [ command "android" $ info (pure (Android, [])) mempty
148+ , command "ios" $ info ((,) <$> pure IOS <*> fmap pure (strArgument (metavar "TEAMID" <> help "Your Team ID - found in the Apple developer portal"))) mempty
153149 ]
154150
155151 remoteBuilderParser :: Parser (Maybe RemoteBuilder)
@@ -171,101 +167,153 @@ deployCommand cfg = hsubparser $ mconcat
171167
172168deployInitOpts :: Parser DeployInitOpts
173169deployInitOpts = DeployInitOpts
174− <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory that it will create")
175− <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an ssh key that it will symlink to")
170+ <$> strArgument (action "directory" <> metavar "DEPLOYDIR" <> help "Path to a directory where the deployment repository will be initialized")
171+ <*> strOption (long "ssh-key" <> action "file" <> metavar "SSHKEY" <> help "Path to an SSH key that will be *copied* to the deployment repository")
176172 <*> some (strOption (long "hostname" <> metavar "HOSTNAME" <> help "hostname of the deployment target"))
177173 <*> strOption (long "route" <> metavar "PUBLICROUTE" <> help "Publicly accessible URL of your app")
178174 <*> strOption (long "admin-email" <> metavar "ADMINEMAIL" <> help "Email address where administrative alerts will be sent")
179175 <*> flag True False (long "disable-https" <> help "Disable automatic https configuration for the backend")
180− <*> strOption (long "upstream" <> value "origin" <> metavar "REMOTE" <> help "git remote to use for the src thunk" <> showDefault)
181176
182177type TeamID = String
183−data PlatformDeployment = Android | IOS TeamID
184− deriving (Show)
185−
186178data RemoteBuilder = RemoteBuilder_ObeliskVM
187179 deriving (Eq, Show)
188180
189181data DeployCommand
190182 = DeployCommand_Init DeployInitOpts
191183 | DeployCommand_Push (Maybe RemoteBuilder)
192− | DeployCommand_Test PlatformDeployment
184+ | DeployCommand_Test (PlatformDeployment, [String])
193185 | DeployCommand_Update
194186 deriving Show
195187
196−data DeployInitOpts = DeployInitOpts
197− { _deployInitOpts_outputDir :: FilePath
198− , _deployInitOpts_sshKey :: FilePath
199− , _deployInitOpts_hostname :: [String]
200− , _deployInitOpts_route :: String
201− , _deployInitOpts_adminEmail :: String
202− , _deployInitOpts_enableHttps :: Bool
203− , _deployInitOpts_remote :: String
204− }
205− deriving Show
188+profileCommand :: Parser (String, [String])
189+profileCommand = (,)
190+ <$> strOption
191+ ( long "output"
192+ <> short 'o'
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."
194+ <> metavar "PATH"
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
206228
207−internalCommand :: Parser ObInternal
208−internalCommand = subparser $ mconcat
209− [ command "run-static-io" $ info (ObInternal_RunStaticIO <$> argument (eitherReader decodeStaticKey) (action "static-key")) mempty
210− , 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)"
211− , command "create-migration" $ info (pure ObInternal_CreateMigration) mempty
212− , command "verify-migration" $ info (pure ObInternal_VerifyMigration) mempty
213− , 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"
214− , command "clidemo" $ info (pure ObInternal_CLIDemo) mempty
215− ]
229+data ThunkCommand
230+ = ThunkCommand_Update ThunkUpdateConfig
231+ | ThunkCommand_Unpack
232+ | ThunkCommand_Pack ThunkPackConfig
233+ deriving Show
216234
217−--TODO: Result should provide normalised path and also original user input for error reporting.
218−thunkDirectoryParser :: Parser FilePath
219−thunkDirectoryParser = fmap (dropTrailingPathSeparator . normalise) . strArgument $ mconcat
220− [ action "directory"
221− , metavar "THUNKDIR"
222− , help "Path to directory containing thunk data"
235+thunkOption :: Parser ThunkOption
236+thunkOption = hsubparser $ mconcat
237+ [ command "update" $ info (thunkOptionWith $ ThunkCommand_Update <$> thunkUpdateConfig) $ progDesc "Update packed thunk to latest revision available on the tracked branch"
238+ , command "unpack" $ info (thunkOptionWith $ pure ThunkCommand_Unpack) $ progDesc "Unpack thunk into git checkout of revision it points to"
239+ , command "pack" $ info (thunkOptionWith $ ThunkCommand_Pack <$> thunkPackConfig) $ progDesc "Pack git checkout or unpacked thunk into thunk that points at the current branch's upstream"
223240 ]
224−
225−data ThunkPackOpts = ThunkPackOpts
226− { _thunkPackOpts_directory :: FilePath
227− , _thunkPackOpts_upstream :: String
228− }
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+ }
229256 deriving Show
230257
231−data ThunkCommand
232− = ThunkCommand_Update [FilePath]
233− | ThunkCommand_Unpack [FilePath]
234− | ThunkCommand_Pack [ThunkPackOpts]
235− deriving Show
258+shellFlags :: Parser String
259+shellFlags =
260+ flag' "ghc" (long "ghc" <> help "Enter a shell environment having ghc (default)")
261+ <|> flag "ghc" "ghcjs" (long "ghcjs" <> help "Enter a shell having ghcjs rather than ghc")
262+ <|> strOption (short 'A' <> long "argument" <> metavar "NIXARG" <> help "Use the environment specified by the given nix argument of `shells'")
263+
264+interpretOpts :: Parser [(FilePath, Interpret)]
265+interpretOpts = many
266+ ( (, Interpret_Interpret) <$>
267+ strOption (common <> long "interpret" <> help
268+ "Don't pre-build packages found in DIR when constructing the package database. The default behavior is \
269+ \'--interpret <project-root>', which will load everything which is unpacked into GHCi. \
270+ \ Use --interpret and --no-interpret multiple times to add or remove multiple trees \
271+ \ from the environment. Settings for right-most directories will \
272+ \ override settings for any identical directories given earlier."
273+ )
274+ <|> (, Interpret_NoInterpret) <$>
275+ strOption (common <> long "no-interpret" <> help
276+ "Make packages found in DIR available in the package database (but only when they are used dependencies). \
277+ \ This will build the packages in DIR before loading GHCi. \
278+ \See help for --interpret for how the two options are related."
279+ )
280+ )
281+ where
282+ common = action "directory" <> metavar "DIR"
236283
237−thunkPackOpts :: Parser ThunkPackOpts
238−thunkPackOpts = (ThunkPackOpts <$> thunkDirectoryParser <*>) . strOption $ mconcat
239− [ long "upstream"
240− , value "origin"
241− , metavar "REMOTE"
242− , help "Git remote that packed thunk will point to"
243− , showDefault
244− ]
284+shellOpts :: Parser ShellOpts
285+shellOpts = ShellOpts
286+ <$> shellFlags
287+ <*> interpretOpts
288+ -- This funny construction is used to support optparse-applicative's @--@ parsing.
289+ -- All arguments after @--@ are left unparsed and instead provided to the last positional parser
290+ -- which must therefore be 'many' in order to consume the rest of the input.
291+ <*> ((\xs -> if null xs then Nothing else Just $ unwords xs) <$> many (strArgument (metavar "COMMAND")))
245292
246−thunkCommand :: Parser ThunkCommand
247−thunkCommand = hsubparser $ mconcat
248− [ command "update" $ info (ThunkCommand_Update <$> some thunkDirectoryParser) $ progDesc "Update thunk to latest revision available"
249− , command "unpack" $ info (ThunkCommand_Unpack <$> some thunkDirectoryParser) $ progDesc "Unpack thunk into git checkout of revision it points to"
250− , command "pack" $ info (ThunkCommand_Pack <$> some thunkPackOpts) $ progDesc "Pack git checkout into thunk that points at given upstream"
251− ]
293+portOpt :: Int -> Parser Int
294+portOpt dfault = option auto (long "port" <> short 'p' <> help "Port number for server" <> showDefault <> value dfault <> metavar "INT")
252295
253296parserPrefs :: ParserPrefs
254297parserPrefs = defaultPrefs
255298 { prefShowHelpOnEmpty = True
256299 }
257300
258−parseCLIArgs :: ArgsConfig -> [String] -> IO Args
259−parseCLIArgs cfg as = pure as >>= handleParseResult . execParserPure parserPrefs (argsInfo cfg)
260−
261301-- | Create an Obelisk config for the current process.
262302mkObeliskConfig :: IO Obelisk
263303mkObeliskConfig = do
264304 cliArgs <- getArgs
265305 -- This function should not use argument parser (full argument parsing happens post handoff)
266− let logLevel = toLogLevel $ "-v" `elem` cliArgs
306+ -- TODO: See if we can use the argument parser with a subset of the parsers to get logging level out.
307+ let logLevel = toLogLevel $ any (`elem` ["-v", "--verbose"]) cliArgs
267308 notInteractive <- not <$> isInteractiveTerm
268− cliConf <- newCliConfig logLevel notInteractive notInteractive
309+ cliConf <- newCliConfig logLevel notInteractive notInteractive $ \case
310+ ObeliskError_ProcessError (ProcessFailure p code) ann ->
311+ ( "Process exited with code " <> T.pack (show code) <> "; " <> reconstructCommand p
312+ <> maybe "" ("\n" <>) ann
313+ , 2
314+ )
315+ ObeliskError_Unstructured msg -> (msg, 2)
316+
269317 return $ Obelisk cliConf
270318 where
271319 toLogLevel = bool Notice Debug
@@ -273,7 +321,14 @@ mkObeliskConfig = do
273321 isTerm <- hIsTerminalDevice stdout
274322 -- Running in bash/fish/zsh completion
275323 inShellCompletion <- liftIO $ isInfixOf "completion" . unwords <$> getArgs
276− return $ isTerm && not inShellCompletion
324+
325+ -- Respect the user’s TERM environment variable. Dumb terminals
326+ -- like Eshell cannot handle lots of control sequences that the
327+ -- spinner uses.
328+ termEnv <- lookupEnv "TERM"
329+ let isDumb = termEnv == Just "dumb"
330+
331+ return $ isTerm && not inShellCompletion && not isDumb
277332
278333-- | For use from development obelisk repls
279334--
@@ -296,143 +351,105 @@ main' argsCfg = do
296351 , "logging-level=" <> show logLevel
297352 ]
298353
299− (mainWithHandOff argsCfg <=< parseHandoff) =<< liftIO getArgs
300− `catch`
301− \(ProcessFailed p code) -> failWith $ "Process exited with code " <> tshow code <> "; " <> tshow p
302−
303−-- Type representing the result of a handoff calculation.
304−data HandOff m
305− = HandOff_Yes FilePath [String] -- Handoff immediately to the given impl with the given args
306− | HandOff_Decide (m Bool) FilePath [String] -- Handoff only if the action returns True
307− | HandOff_No [String] -- Do not handoff, and continue with the given args
308−
309−mainWithHandOff :: MonadObelisk m => ArgsConfig -> HandOff m -> m ()
310−mainWithHandOff argsCfg = \case
311− HandOff_Yes impl as -> do
312− putLog Debug $ "Handing off to project obelisk " <> T.pack impl
313− liftIO $ executeFile impl False ("--no-handoff" : as) Nothing
314− HandOff_Decide f impl as -> do
315− withSpinner' "Deciding whether to handoff"
316− (Just $ bool
317− "Continuing in ambient obelisk without handing off"
318− "Handed off to project obelisk") f >>= \case
319− True -> mainWithHandOff argsCfg $ HandOff_Yes impl as
320− False -> mainWithHandOff argsCfg $ HandOff_No as
321− HandOff_No as -> do
322− putLog Debug $ "Not handing off"
323− args' <- liftIO $ parseCLIArgs argsCfg as
324− warnIfExtraneousFlag args'
325− ob $ _args_command args'
326− where
327− warnIfExtraneousFlag a = case _args_noHandOffPassed a of
328− False -> return ()
329− True -> putLog Warning $
330− "Ignoring unexpected --no-handoff (should only be passed once and as the first argument)"
331−
332−-- Handoff logic
333−parseHandoff :: MonadObelisk m => [String] -> m (HandOff m)
334−parseHandoff as' = case hasNoHandoff as' of
335− (True, as) ->
336− pure $ HandOff_No as
337− (False, as) -> findProjectObeliskCommand "." >>= \case
338− Nothing -> do
339− putLog Debug "Not in a project; no need to hand off"
340− pure $ HandOff_No as
341− Just impl -> case getSubCommand as of
342− Just "upgrade" ->
343− pure $ HandOff_Decide (decideHandOffToProjectOb ".") impl as
344− _ ->
345− pure $ HandOff_Yes impl as
346− where
347− getSubCommand = listToMaybe . filter (not . isPrefixOf "-")
348− hasNoHandoff = \case
349− "--no-handoff" : xs ->
350− -- If we've been told not to hand off, don't hand off
351− (True, xs)
352− x:xs
353− -- Otherwise bash completion would always hand-off even if the user isn't trying to
354− | "--bash-completion" `isPrefixOf` x && "--no-handoff" `elem` xs ->
355− (True, x:xs)
356− | otherwise ->
357− (False, x:xs)
358− xs ->
359− (False, xs)
354+ --TODO: We'd like to actually use the parser to determine whether to hand off,
355+ --but in the case where this implementation of 'ob' doesn't support all
356+ --arguments being passed along, this could fail. For now, we don't bother
357+ --with optparse-applicative until we've done the handoff.
358+ let go as = do
359+ args' <- liftIO $ handleParseResult (execParserPure parserPrefs (argsInfo argsCfg) as)
360+ case _args_noHandOffPassed args' of
361+ False -> return ()
362+ True -> putLog Warning "--no-handoff should only be passed once and as the first argument; ignoring"
363+ ob $ _args_command args'
364+ handoffAndGo as = findProjectObeliskCommand "." >>= \case
365+ Nothing -> go as -- If not in a project, just run ourselves
366+ Just impl -> do
367+ -- Invoke the real implementation, using --no-handoff to prevent infinite recursion
368+ putLog Debug $ "Handing off to " <> T.pack impl
369+ _ <- liftIO $ rawSystem impl ("--no-handoff" : myArgs)
370+ return ()
371+ case myArgs of
372+ "--no-handoff" : as -> go as -- If we've been told not to hand off, don't hand off
373+ origPath:inPath:outPath:preprocessorName:packagePaths
374+ | preprocessorName == preprocessorIdentifier && any (\c -> c == '.' || c == pathSeparator) origPath ->
375+ ob $ ObCommand_Internal $ ObInternal_ApplyPackages origPath inPath outPath packagePaths
376+ a:as -- Otherwise bash completion would always hand-off even if the user isn't trying to
377+ | "--bash-completion" `isPrefixOf` a
378+ && "--no-handoff" `elem` as -> go (a:as)
379+ | otherwise -> handoffAndGo (a:as)
380+ as -> handoffAndGo as
360381
361382ob :: MonadObelisk m => ObCommand -> m ()
362383ob = \case
363− ObCommand_Init source -> initProject source
384+ ObCommand_Init source force -> initProject source force
364385 ObCommand_Deploy dc -> case dc of
365− DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> do
366− let deployDir = _deployInitOpts_outputDir deployOpts
367− r <- liftIO $ canonicalizePath root
368− rootEqualsTarget <- liftIO $ equalFilePath r <$> canonicalizePath deployDir
369− when rootEqualsTarget $
370− failWith $ "Deploy directory " <> T.pack deployDir <> " should not be the same as project root."
371− thunkPtr <- readThunk root >>= \case
372− Left err -> failWith $ case err of
373− ReadThunkError_AmbiguousFiles ->
374− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
375− ReadThunkError_UnrecognizedFiles ->
376− "Project root " <> T.pack r <> " is not a git repository or valid thunk"
377− _ -> "thunk read: " <> T.pack (show err)
378− Right (ThunkData_Packed ptr) -> return ptr
379− Right (ThunkData_Checkout (Just ptr)) -> return ptr
380− Right (ThunkData_Checkout Nothing) ->
381− getThunkPtr' False root (T.pack $ _deployInitOpts_remote deployOpts)
382− let sshKeyPath = _deployInitOpts_sshKey deployOpts
383− hostname = _deployInitOpts_hostname deployOpts
384− route = _deployInitOpts_route deployOpts
385− adminEmail = _deployInitOpts_adminEmail deployOpts
386− enableHttps = _deployInitOpts_enableHttps deployOpts
387− deployInit thunkPtr (root </> "config") deployDir
388− sshKeyPath hostname route adminEmail enableHttps
389− DeployCommand_Push remoteBuilder -> deployPush "." $ case remoteBuilder of
390− Nothing -> pure []
391− Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
386+ DeployCommand_Init deployOpts -> withProjectRoot "." $ \root -> deployInit deployOpts root
387+ DeployCommand_Push remoteBuilder -> do
388+ deployPath <- liftIO $ canonicalizePath "."
389+ deployPush deployPath $ case remoteBuilder of
390+ Nothing -> pure []
391+ Just RemoteBuilder_ObeliskVM -> (:[]) <$> VmBuilder.getNixBuildersArg
392392 DeployCommand_Update -> deployUpdate "."
393− DeployCommand_Test Android -> deployMobile "android" []
394− DeployCommand_Test (IOS teamID) -> deployMobile "ios" [teamID]
395− ObCommand_Run -> inNixShell' $ static run
396− -- inNixShell ($(mkClosure 'ghcidAction) ())
397− ObCommand_Thunk tc -> case tc of
398− ThunkCommand_Update thunks -> mapM_ updateThunkToLatest thunks
399− ThunkCommand_Unpack thunks -> mapM_ unpackThunk thunks
400− ThunkCommand_Pack thunks -> forM_ thunks $ \(ThunkPackOpts dir upstream) -> packThunk dir (T.pack upstream)
401− ObCommand_Repl -> runRepl
402− ObCommand_Upgrade branch -> do
403− upgradeObelisk "." branch
393+ DeployCommand_Test (platform, extraArgs) -> deployMobile platform extraArgs
394+ ObCommand_Run interpretPathsList -> withInterpretPaths interpretPathsList run
395+ ObCommand_Profile basePath rtsFlags -> profile basePath rtsFlags
396+ ObCommand_Thunk to -> case _thunkOption_command to of
397+ ThunkCommand_Update config -> for_ thunks (updateThunkToLatest config)
398+ ThunkCommand_Unpack -> for_ thunks unpackThunk
399+ ThunkCommand_Pack config -> for_ thunks (packThunk config)
400+ where
401+ thunks = _thunkOption_thunks to
402+ ObCommand_Repl interpretPathsList -> withInterpretPaths interpretPathsList runRepl
403+ ObCommand_Watch interpretPathsList -> withInterpretPaths interpretPathsList runWatch
404+ ObCommand_Shell (ShellOpts shellAttr interpretPathsList cmd) -> withInterpretPaths interpretPathsList $ \root interpretPaths ->
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"
404410 ObCommand_Internal icmd -> case icmd of
405− ObInternal_RunStaticIO k -> liftIO (unsafeLookupStaticPtr @(ObeliskT IO ()) k) >>= \case
406− Nothing -> failWith $ "ObInternal_RunStaticIO: no such StaticKey: " <> T.pack (show k)
407− Just p -> do
408− c <- getObelisk
409− liftIO $ runObelisk c $ deRefStaticPtr p
410− ObInternal_Hash revM -> do
411− hash <- case revM of
412− Nothing -> getDirectoryHash [migrationDirName] "."
413− Just rev -> fmap head $ getHashAtGitRevision [rev] [migrationDirName] "."
414− putLog Notice hash
415− ObInternal_CreateMigration ->
416− createMigrationEdgeFromHEAD "."
417− ObInternal_VerifyMigration ->
418− verifyMigration "."
419− ObInternal_Migrate fromHash ->
420− migrateObelisk "." fromHash
421− ObInternal_CLIDemo -> cliDemo
411+ ObInternal_ApplyPackages origPath inPath outPath packagePaths -> do
412+ liftIO $ Preprocessor.applyPackages origPath inPath outPath packagePaths
413+ ObInternal_ExportGhciConfig interpretPathsList useRelativePaths ->
414+ liftIO . putStrLn . unlines =<< withInterpretPaths interpretPathsList (exportGhciConfig useRelativePaths)
415+
416+-- | A helper for the common case that the command you want to run needs the project root and a resolved
417+-- set of interpret paths.
418+withInterpretPaths :: MonadObelisk m => [(FilePath, Interpret)] -> (FilePath -> PathTree Interpret -> m a) -> m a
419+withInterpretPaths interpretPathsList f = withProjectRoot "." $ \root -> do
420+ interpretPaths' <- resolveInterpretPaths $ (root, Interpret_Interpret) : interpretPathsList
421+ case interpretPaths' of
422+ Nothing -> failWith "No paths provided for finding packages"
423+ Just interpretPaths -> f root interpretPaths
424+
425+haddockCommand :: [String] -> String
426+haddockCommand pkgs = unwords
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)"
422432
423433--TODO: Clean up all the magic strings throughout this codebase
424434
425435getArgsConfig :: IO ArgsConfig
426436getArgsConfig = pure $ ArgsConfig { _argsConfig_enableVmBuilderByDefault = System.Info.os == "darwin" }
427437
428−encodeStaticKey :: StaticKey -> String
429−encodeStaticKey = T.unpack . decodeUtf8 . Base16.encode . LBS.toStrict . Binary.encode
430−
431−-- TODO: Use failWith in place of fail to be consistent.
432−decodeStaticKey :: String -> Either String StaticKey
433−decodeStaticKey s = case Base16.decode $ encodeUtf8 $ T.pack s of
434− (b, "") -> case Binary.decodeOrFail $ LBS.fromStrict b of
435− Right ("", _, a) -> pure a
436− Right _ -> fail "decodeStaticKey: Binary.decodeOrFail didn't consume all input"
437− Left (_, _, e) -> fail $ "decodeStaticKey: Binary.decodeOrFail failed: " <> show e
438− _ -> fail $ "decodeStaticKey: could not decode hex string: " <> show s
438+-- | Resolves an ordered list of paths for use with @--interpret@/@--no-interpret@ by coalescing
439+-- paths into a non-ambiguous set of paths. Ambiguity is resolved by choosing right-most paths
440+-- over any preceeding identical paths.
441+--
442+-- For example: @a/b=ON a/b/c=OFF@ and @a/b/c=OFF a/b=ON@ are the same.
443+-- @a/b=ON a/b=OFF@ is reduced to @a/b=OFF@. We prefer right-biased choice to increase
444+-- scriptability.
445+--
446+-- N.B. All the paths in the result will be canonicalized. It's impossible to determine path
447+-- overlap otherwise.
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 #-}
12{-# LANGUAGE FlexibleContexts #-}
23{-# LANGUAGE LambdaCase #-}
34{-# LANGUAGE OverloadedStrings #-}
5+{-# LANGUAGE QuasiQuotes #-}
46{-# LANGUAGE ScopedTypeVariables #-}
57{-# LANGUAGE ViewPatterns #-}
68module Obelisk.Command.Deploy where
79
10+import Control.Applicative (liftA2)
811import Control.Lens
912import Control.Monad
10−import Control.Monad.Catch (Exception (displayException), MonadThrow, throwM, try)
11−import Control.Monad.IO.Class (liftIO)
13+import Control.Monad.Catch (Exception (displayException), MonadThrow, bracket, throwM, try)
14+import Control.Monad.IO.Class (MonadIO, liftIO)
15+import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
1216import Data.Bits
17+import qualified Data.ByteString.Lazy as BSL
1318import Data.Default
1419import qualified Data.Map as Map
15−import Data.Maybe
20+import qualified Data.Set as Set
21+import Data.String.Here.Interpolated (i)
1622import qualified Data.Text as T
1723import qualified Data.Text.IO as T
24+import GHC.Generics
1825import System.Directory
19−import System.Environment (getEnvironment)
2026import System.FilePath
21−import System.Posix.Files
22−import System.Process (delegate_ctlc, env, proc)
27+import System.IO
28+import System.PosixCompat.Files
2329import Text.URI (URI)
2430import qualified Text.URI as URI
2531import Text.URI.Lens
2632
2733import Obelisk.App (MonadObelisk)
28−import Obelisk.CliApp (Severity (..), callProcessAndLogOutput, failWith, putLog, withSpinner)
34+import Obelisk.CliApp (
35+ Severity (..), callProcessAndLogOutput, failWith, proc, putLog,
36+ setCwd, setDelegateCtlc, setEnvOverride, withSpinner)
2937import Obelisk.Command.Nix
3038import Obelisk.Command.Project
3139import Obelisk.Command.Thunk
3240import Obelisk.Command.Utils
3341
34−deployInit
42+data DeployInitOpts = DeployInitOpts
43+ { _deployInitOpts_outputDir :: FilePath
44+ , _deployInitOpts_sshKey :: FilePath
45+ , _deployInitOpts_hostname :: [String]
46+ , _deployInitOpts_route :: String
47+ , _deployInitOpts_adminEmail :: String
48+ , _deployInitOpts_enableHttps :: Bool
49+ } deriving Show
50+
51+deployInit :: MonadObelisk m => DeployInitOpts -> FilePath -> m ()
52+deployInit deployOpts root = do
53+ let deployDir = _deployInitOpts_outputDir deployOpts
54+ rootEqualsTarget <- liftIO $ liftA2 equalFilePath (canonicalizePath root) (canonicalizePath deployDir)
55+ when rootEqualsTarget $
56+ failWith [i|Deploy directory ${deployDir} should not be the same as project root.|]
57+ thunkPtr <- readThunk root >>= \case
58+ Right (ThunkData_Packed _ ptr) -> return ptr
59+ _ -> getThunkPtr CheckClean_NotIgnored root Nothing
60+ deployInit' thunkPtr deployOpts
61+
62+deployInit'
3563 :: MonadObelisk m
3664 => ThunkPtr
37− -> FilePath
38− -> FilePath
39− -> FilePath
40− -> [String] -- ^ hostnames
41− -> String -- ^ route
42− -> String -- ^ admin email
43− -> Bool -- ^ enable https
65+ -> DeployInitOpts
4466 -> m ()
45−deployInit thunkPtr configDir deployDir sshKeyPath hostnames route adminEmail enableHttps = do
46− (hasConfigDir, localKey) <- withSpinner ("Preparing " <> T.pack deployDir) $ do
47− hasConfigDir <- liftIO $ do
48− createDirectoryIfMissing True deployDir
49− doesDirectoryExist configDir
67+deployInit' thunkPtr (DeployInitOpts deployDir sshKeyPath hostnames route adminEmail enableHttps) = do
68+ liftIO $ createDirectoryIfMissing True deployDir
69+ localKey <- withSpinner ("Preparing " <> T.pack deployDir) $ do
5070 localKey <- liftIO (doesFileExist sshKeyPath) >>= \case
5171 False -> failWith $ T.pack $ "ob deploy init: file does not exist: " <> sshKeyPath
5272 True -> pure $ deployDir </> "ssh_key"
5373 callProcessAndLogOutput (Notice, Error) $
54− proc "cp" [sshKeyPath, localKey]
74+ proc cp [sshKeyPath, localKey]
5575 liftIO $ setFileMode localKey $ ownerReadMode .|. ownerWriteMode
56− return $ (hasConfigDir, localKey)
76+ return localKey
5777 withSpinner "Validating configuration" $ do
5878 void $ getHostFromRoute enableHttps route -- make sure that hostname is present
5979 forM_ hostnames $ \hostname -> do
6080 putLog Notice $ "Verifying host keys (" <> T.pack hostname <> ")"
6181 -- Note: we can't use a spinner here as this function will prompt the user.
6282 verifyHostKey (deployDir </> "backend_known_hosts") localKey hostname
63− when hasConfigDir $ withSpinner "Importing project configuration" $ do
64− callProcessAndLogOutput (Notice, Error) $
65− proc "cp" [ "-r" , "-T" , configDir , deployDir </> "config"]
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.
88+ withSpinner "Creating project configuration directories" $ liftIO $ do
89+ mapM_ (createDirectoryIfMissing True)
90+ [ deployDir </> "config" </> "backend"
91+ , deployDir </> "config" </> "common"
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+
66100 withSpinner "Writing deployment configuration" $ do
67101 writeDeployConfig deployDir "backend_hosts" $ unlines hostnames
68102 writeDeployConfig deployDir "enable_https" $ show enableHttps
69103 writeDeployConfig deployDir "admin_email" adminEmail
70− writeDeployConfig deployDir ("config" </> "common" </> "route") $ route
71− withSpinner "Creating source thunk (./src)" $ liftIO $ do
72− createThunk (deployDir </> "src") thunkPtr
73− setupObeliskImpl deployDir
104+ writeDeployConfig deployDir ("config" </> "common" </> "route") route
105+ writeDeployConfig deployDir "module.nix" $
106+ "(import " <> toNixPath (makeRelative deployDir srcDir) <> " {}).obelisk.serverModules.mkBaseEc2"
107+
74108 withSpinner ("Initializing git repository (" <> T.pack deployDir <> ")") $
75109 initGit deployDir
76110
77−setupObeliskImpl :: FilePath -> IO ()
78−setupObeliskImpl deployDir = do
79− let implDir = toImplDir deployDir
111+setupObeliskImpl :: MonadIO m => FilePath -> m ()
112+setupObeliskImpl deployDir = liftIO $ do
113+ let
114+ implDir = toImplDir deployDir
115+ goBackUp = foldr (</>) "" $ (".." <$) $ splitPath $ makeRelative deployDir implDir
80116 createDirectoryIfMissing True implDir
81− writeFile (implDir </> "default.nix") "(import ../../src {}).obelisk"
117+ writeFile (implDir </> "default.nix") $ "(import " <> toNixPath (goBackUp </> "src") <> " {}).obelisk"
82118
83119deployPush :: MonadObelisk m => FilePath -> m [String] -> m ()
84120deployPush deployPath getNixBuilders = do
85− host <- readDeployConfig deployPath "backend_hosts"
121+ hosts <- Set.fromList . filter (/= mempty) . lines <$> readDeployConfig deployPath "backend_hosts"
86122 adminEmail <- readDeployConfig deployPath "admin_email"
87123 enableHttps <- read <$> readDeployConfig deployPath "enable_https"
88124 route <- readDeployConfig deployPath $ "config" </> "common" </> "route"
89125 routeHost <- getHostFromRoute enableHttps route
90126 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
110− Right (ThunkData_Packed _) ->
111− build
112− Right (ThunkData_Checkout _) -> do
127+ thunkPtr <- readThunk srcPath >>= \case
128+ Right (ThunkData_Packed _ ptr) -> return ptr
129+ Right ThunkData_Checkout -> do
113130 checkGitCleanStatus srcPath True >>= \case
114− True -> do
115− result <- build
116− packThunk srcPath "origin" -- get upstream
117− return result
118− False -> do
119− _ <- failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
120− return Nothing
121− _ -> return Nothing
122− forM_ result $ \res -> do
123− let knownHostsPath = deployPath </> "backend_known_hosts"
124− sshOpts = sshArgs knownHostsPath (deployPath </> "ssh_key") False
125− deployAndSwitch outputPath = do
126− withSpinner "Uploading closure" $ do
127− callProcess'
128− (Map.fromList [("NIX_SSHOPTS", unwords sshOpts)])
129− "nix-copy-closure" ["-v", "--to", "root@" <> host, "--gzip", outputPath]
130−
131− withSpinner "Switching to new configuration" $ do
132− callProcessAndLogOutput (Notice, Warning) $
133− proc "ssh" $ sshOpts <>
134− [ "root@" <> host
135− , unwords
136− [ "nix-env -p /nix/var/nix/profiles/system --set " <> outputPath
137− , "&&"
138− , "/nix/var/nix/profiles/system/bin/switch-to-configuration switch"
139− ]
140− ]
141− deployAndSwitch res
142− isClean <- checkGitCleanStatus deployPath True
143− when (not isClean) $ do
144− withSpinner "Commiting changes to Git" $ do
145− callProcessAndLogOutput (Debug, Error) $ proc "git"
146− ["-C", deployPath, "add", "."]
147− callProcessAndLogOutput (Debug, Error) $ proc "git"
148− ["-C", deployPath, "commit", "-m", "New deployment"]
149− putLog Notice $ "Deployed => " <> T.pack route
131+ True -> packThunk (ThunkPackConfig False (ThunkConfig Nothing)) srcPath
132+ False -> failWith $ T.pack $ "ob deploy push: ensure " <> srcPath <> " has no pending changes and latest is pushed upstream."
133+ Left err -> failWith $ "ob deploy push: couldn't read src thunk: " <> T.pack (show err)
134+ let version = show . _thunkRev_commit $ _thunkPtr_rev thunkPtr
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
156+ let knownHostsPath = deployPath </> "backend_known_hosts"
157+ sshOpts = sshArgs knownHostsPath (deployPath </> "ssh_key") False
158+ withSpinner "Uploading closures" $ ifor_ buildOutputByHost $ \host outputPath -> do
159+ callProcess'
160+ (Map.fromList [("NIX_SSHOPTS", unwords sshOpts)])
161+ "nix-copy-closure" ["-v", "--to", "--use-substitutes", "root@" <> host, "--gzip", outputPath]
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
171+ withSpinner "Switching to new configuration" $ ifor_ buildOutputByHost $ \host outputPath -> do
172+ callProcessAndLogOutput (Notice, Warning) $
173+ proc sshPath $ sshOpts <>
174+ [ "root@" <> host
175+ , unwords
176+ -- Note that we don't want to $(staticWhich "nix-env") here, because this is executing on a remote machine
177+ [ "nix-env -p /nix/var/nix/profiles/system --set " <> outputPath
178+ , "&&"
179+ , "/nix/var/nix/profiles/system/bin/switch-to-configuration switch"
180+ ]
181+ ]
182+ isClean <- checkGitCleanStatus deployPath True
183+ when (not isClean) $ do
184+ withSpinner "Committing changes to Git" $ do
185+ callProcessAndLogOutput (Debug, Error) $
186+ gitProc deployPath ["add", "."]
187+ callProcessAndLogOutput (Debug, Error) $
188+ gitProc deployPath ["commit", "-m", "New deployment"]
189+ putLog Notice $ "Deployed => " <> T.pack route
150190 where
151191 callProcess' envMap cmd args = do
152− processEnv <- Map.toList . (envMap <>) . Map.fromList <$> liftIO getEnvironment
153− let p = (proc cmd args) { delegate_ctlc = True, env = Just processEnv }
192+ let p = setEnvOverride (envMap <>) $ setDelegateCtlc True $ proc cmd args
154193 callProcessAndLogOutput (Notice, Notice) p
155194
156195deployUpdate :: 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"
158205
159−deployMobile :: MonadObelisk m => String -> [String] -> m ()
206+deployMobile :: forall m. MonadObelisk m => PlatformDeployment -> [String] -> m ()
160207deployMobile platform mobileArgs = withProjectRoot "." $ \root -> do
161208 let srcDir = root </> "src"
209+ configDir = root </> "config"
162210 exists <- liftIO $ doesDirectoryExist srcDir
163211 unless exists $ failWith "ob test should be run inside of a deploy directory"
164− result <- nixBuildAttrWithCache srcDir $ platform <> ".frontend"
165− callProcessAndLogOutput (Notice, Error) $ proc (result </> "bin" </> "deploy") mobileArgs
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]
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+ ]
166307
167308-- | Simplified deployment configuration mechanism. At one point we may revisit this.
168309writeDeployConfig :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
@@ -174,9 +315,10 @@ readDeployConfig deployDir fname = liftIO $ do
174315
175316verifyHostKey :: MonadObelisk m => FilePath -> FilePath -> String -> m ()
176317verifyHostKey knownHostsPath keyPath hostName =
177− callProcessAndLogOutput (Notice, Warning) $ proc "ssh" $
318+ callProcessAndLogOutput (Notice, Warning) $ proc sshPath $
178319 sshArgs knownHostsPath keyPath True <>
179320 [ "root@" <> hostName
321+ , "-o", "NumberOfPasswordPrompts=0"
180322 , "exit"
181323 ]
182324
lib/command/src/Obelisk/Command/Nix.hs+164−61
@@ -1,53 +1,70 @@
1+{-# LANGUAGE AllowAmbiguousTypes #-}
2+{-# LANGUAGE ConstraintKinds #-}
13{-# LANGUAGE FlexibleContexts #-}
24{-# LANGUAGE LambdaCase #-}
35{-# LANGUAGE MultiParamTypeClasses #-}
46{-# LANGUAGE OverloadedStrings #-}
7+{-# LANGUAGE Rank2Types #-}
58{-# LANGUAGE ScopedTypeVariables #-}
9+{-# LANGUAGE TemplateHaskell #-}
10+{-# LANGUAGE TypeApplications #-}
611module Obelisk.Command.Nix
7− ( nixBuild
8− , withNixRemoteCheck
12+ ( Arg (..)
913 , NixBuildConfig (..)
10− , 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
1127 , OutLink (..)
12− , Arg (..)
28+ , Target (..)
29+ , target_attr
30+ , target_expr
31+ , target_path
32+
1333 , boolArg
34+ , nixCmd
35+ , nixCmdProc
36+ , nixCmdProc'
1437 , rawArg
38+ , runNixShellConfig
1539 , strArg
1640 ) where
1741
18−import Control.Monad.Catch (catch, throwM)
19−import Control.Monad.IO.Class (liftIO)
42+import Control.Monad (guard)
43+import Control.Lens
44+
2045import Data.Bool (bool)
2146import Data.Default
2247import Data.List (intercalate)
48+import Data.Maybe
2349import Data.Monoid ((<>))
2450import qualified Data.Text as T
25−import System.Directory
26−import System.Environment
27−import System.Process (proc)
2851
2952import Obelisk.App (MonadObelisk)
3053import Obelisk.CliApp
3154
32−-- | Where to put nix-build output
33−data OutLink
34− = OutLink_Default
35− | OutLink_None
36− | OutLink_IndirectRoot FilePath
37−
38−instance Default OutLink where
39− def = OutLink_Default
40−
4155-- | What to build
4256data Target = Target
43− { _target_path :: FilePath
57+ { _target_path :: Maybe FilePath
4458 , _target_attr :: Maybe String
59+ , _target_expr :: Maybe String
4560 }
61+makeClassy ''Target
4662
4763instance Default Target where
4864 def = Target
49− { _target_path = "."
65+ { _target_path = Just "."
5066 , _target_attr = Nothing
67+ , _target_expr = Nothing
5168 }
5269
5370data Arg
@@ -56,10 +73,10 @@ data Arg
5673 deriving (Eq, Show)
5774
5875strArg :: String -> String -> Arg
59−strArg k = Arg_Str k
76+strArg = Arg_Str
6077
6178rawArg :: String -> String -> Arg
62−rawArg k = Arg_Expr k
79+rawArg = Arg_Expr
6380
6481boolArg :: String -> Bool -> Arg
6582boolArg k = Arg_Expr k . bool "false" "true"
@@ -69,53 +86,139 @@ cliFromArgs = concatMap $ \case
6986 Arg_Str k v -> ["--argstr", k, v]
7087 Arg_Expr k v -> ["--arg", k, v]
7188
72−data NixBuildConfig = NixBuildConfig
73− { _nixBuildConfig_target :: Target
74− , _nixBuildConfig_outLink :: OutLink
75− , _nixBuildConfig_args :: [Arg]
76− , _nixBuildConfig_builders :: [String]
89+data NixCommonConfig = NixCommonConfig
90+ { _nixCmdConfig_target :: Target
91+ , _nixCmdConfig_args :: [Arg]
92+ , _nixCmdConfig_builders :: [String]
7793 }
94+makeClassy ''NixCommonConfig
7895
79−instance Default NixBuildConfig where
80− def = NixBuildConfig def def mempty mempty
96+instance Default NixCommonConfig where
97+ def = NixCommonConfig def mempty mempty
8198
82−nixBuild :: MonadObelisk m => NixBuildConfig -> m FilePath
83−nixBuild cfg = withSpinner' ("Running nix-build on " <> desc) (Just $ const $ "Built " <> desc) $ do
84− withNixRemoteCheck $ readProcessAndLogStderr Debug $ proc "nix-build" $ mconcat
85− [[path], attrArg, args, outLink, buildersArg]
99+runNixCommonConfig :: NixCommonConfig -> [String]
100+runNixCommonConfig cfg = mconcat [maybeToList path, attrArg, exprArg, args, buildersArg]
86101 where
87− path = _target_path $ _nixBuildConfig_target cfg
88− attr = _target_attr $ _nixBuildConfig_target cfg
102+ path = _target_path $ _nixCmdConfig_target cfg
103+ attr = _target_attr $ _nixCmdConfig_target cfg
104+ expr = _target_expr $ _nixCmdConfig_target cfg
89105 attrArg = case attr of
90106 Nothing -> []
91107 Just a -> ["-A", a]
92− args = cliFromArgs $ _nixBuildConfig_args cfg
93− outLink = case _nixBuildConfig_outLink cfg of
108+ exprArg = case expr of
109+ Nothing -> []
110+ Just a -> ["-E", a]
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
140+ , case _nixBuildConfig_outLink cfg of
94141 OutLink_Default -> []
95142 OutLink_None -> ["--no-out-link"]
96143 OutLink_IndirectRoot l -> ["--out-link", l]
97− desc = T.pack $ path <> maybe "" (\a -> " [" <> a <> "]") attr
98− buildersArg = case _nixBuildConfig_builders cfg of
99− [] -> []
100− builders -> ["--builders", intercalate ";" builders]
144+ ]
145+
146+data NixInstantiateConfig = NixInstantiateConfig
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+ ]
101163
102−-- | If a nix command fails, and this may be related to the NIX_REMOTE issue,
103−-- tell the user what to do.
104−--
105−-- Added: June, 2018. Consider removing this eventually.
106−withNixRemoteCheck :: MonadObelisk m => m a -> m a
107−withNixRemoteCheck f = f `catch` \e@(ProcessFailed _ _) -> do
108− liftIO (lookupEnv "NIX_REMOTE") >>= \case
109− Just _ -> throwM e
110− Nothing -> liftIO (writable <$> getPermissions "/nix/var/nix/db") >>= \case
111− True -> throwM e
112− False -> do
113− putLog Error "!!! "
114− putLog Error "!!! A nix command failed to run. You might need to set the NIX_REMOTE environment variable"
115− putLog Error "!!! to `daemon`. To do this, run the following before running obelisk:"
116− putLog Error "!!! "
117− putLog Error "!!! export NIX_REMOTE=daemon"
118− putLog Error "!!! "
119− putLog Error "!!! For details, see https://github.com/NixOS/nixpkgs/issues/5713"
120− putLog Error "!!! "
121− throwM e
164+data NixShellConfig = NixShellConfig
165+ { _nixShellConfig_common :: NixCommonConfig
166+ , _nixShellConfig_pure :: Bool
167+ , _nixShellConfig_run :: Maybe String
168+ }
169+
170+makeLenses ''NixShellConfig
171+
172+instance HasNixCommonConfig NixShellConfig where
173+ nixCommonConfig = nixShellConfig_common
174+
175+instance Default NixShellConfig where
176+ def = NixShellConfig def False Nothing
177+
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+
209+nixCmd :: MonadObelisk m => NixCmd -> m FilePath
210+nixCmd cmdCfg = withSpinner' (T.unwords $ "Running" : cmd : desc) (Just $ const $ T.unwords $ "Built" : desc) $ do
211+ output <- readProcessAndLogStderr Debug cmdProc
212+ -- Remove final newline that Nix appends
213+ Just (outPath, '\n') <- pure $ T.unsnoc output
214+ pure $ T.unpack outPath
215+ where
216+ (cmdProc, cmd) = nixCmdProc' cmdCfg
217+ commonCfg = case cmdCfg of
218+ NixCmd_Build cfg' -> cfg' ^. nixCommonConfig
219+ NixCmd_Instantiate cfg' -> cfg' ^. nixCommonConfig
220+ path = commonCfg ^. nixCmdConfig_target . target_path
221+ desc = concat $ catMaybes
222+ [ (\x -> ["on", T.pack x]) <$> path
223+ , (\a -> ["[" <> T.pack a <> "]"]) <$> (commonCfg ^. nixCmdConfig_target . target_attr)
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+209−68
@@ -3,38 +3,56 @@
33{-# LANGUAGE OverloadedStrings #-}
44module Obelisk.Command.Project
55 ( InitSource (..)
6− , initProject
76 , findProjectObeliskCommand
87 , findProjectRoot
9− , withProjectRoot
10− , inProjectShell
11− , inImpureProjectShell
12− , projectShell
13−
14− , toObeliskDir
8+ , findProjectAssets
9+ , initProject
10+ , nixShellRunConfig
11+ , nixShellRunProc
12+ , nixShellWithHoogle
13+ , nixShellWithoutPkgs
14+ , obeliskDirName
1515 , toImplDir
16+ , toObeliskDir
17+ , withProjectRoot
18+ , bashEscape
1619 ) where
1720
21+import Control.Concurrent.MVar (MVar, newMVar, withMVarMasked)
22+import Control.Lens ((.~), (?~), (<&>))
1823import Control.Monad
1924import Control.Monad.IO.Class (liftIO)
2025import Control.Monad.State
26+import qualified Data.Aeson as Json
27+import qualified Data.ByteString.UTF8 as BSU
2128import Data.Bits
22−import Data.Function (on)
29+import qualified Data.ByteString.Lazy as BSL
30+import Data.Default (def)
31+import Data.Function ((&), on)
32+import Data.Map (Map)
33+import Data.Text (Text)
2334import qualified Data.Text as T
35+import Data.Text.Encoding (decodeUtf8, encodeUtf8)
36+import Data.Traversable (for)
2437import System.Directory
38+import System.Environment (lookupEnv)
2539import System.FilePath
2640import System.IO.Temp
27−import System.Posix (FileStatus, UserID, deviceID, fileID, fileMode, fileOwner, getFileStatus, getRealUserID)
28−import System.Posix.Files
29−import System.Process (CreateProcess, cwd, proc, waitForProcess)
41+import System.IO.Unsafe (unsafePerformIO)
42+import System.PosixCompat.Files
43+import System.PosixCompat.Types
44+import System.PosixCompat.User
45+import Text.ShellEscape (bash, bytes)
3046
3147import GitHub.Data.GitData (Branch)
3248import GitHub.Data.Name (Name)
3349
3450import Obelisk.App (MonadObelisk)
3551import Obelisk.CliApp
52+import Obelisk.Command.Nix
3653import Obelisk.Command.Thunk
37−import Obelisk.Command.Nix (withNixRemoteCheck)
54+import Obelisk.Command.Utils (nixBuildExePath, nixExePath, toNixPath, cp, nixShellPath)
55+
3856--TODO: Make this module resilient to random exceptions
3957
4058--TODO: Don't hardcode this
@@ -52,40 +70,53 @@ obeliskSourceWithBranch branch = ThunkSource_GitHub $ GitHubSource
5270 }
5371
5472data InitSource
55− = InitSource_Default
56− | InitSource_Branch (Name Branch)
57− | InitSource_Symlink FilePath
58− deriving Show
73+ = InitSource_Default
74+ | InitSource_Branch (Name Branch)
75+ | InitSource_Symlink FilePath
76+ deriving Show
77+
78+obeliskDirName :: FilePath
79+obeliskDirName = ".obelisk"
5980
6081-- | Path to obelisk directory in given path
6182toObeliskDir :: FilePath -> FilePath
62−toObeliskDir p = p </> ".obelisk"
83+toObeliskDir p = p </> obeliskDirName
6384
6485-- | Path to impl file in given path
6586toImplDir :: FilePath -> FilePath
6687toImplDir p = toObeliskDir p </> "impl"
6788
6889-- | Create a new project rooted in the current directory
69−initProject :: MonadObelisk m => InitSource -> m ()
70−initProject source = withSystemTempDirectory "ob-init" $ \tmpDir -> do
90+initProject :: MonadObelisk m => InitSource -> Bool -> m ()
91+initProject source force = withSystemTempDirectory "ob-init" $ \tmpDir -> do
7192 let implDir = toImplDir tmpDir
7293 obDir = toObeliskDir tmpDir
94+ liftIO (listDirectory ".") >>= \case
95+ [] -> pure ()
96+ _ | force -> putLog Warning "Initializing in non-empty directory"
97+ | otherwise -> failWith "ob init requires an empty directory. Use the flag --force to init anyway, potentially overwriting files."
7398 skeleton <- withSpinner "Setting up obelisk" $ do
7499 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]
75107 case source of
76− InitSource_Default -> createThunkWithLatest implDir obeliskSource
77− InitSource_Branch branch -> createThunkWithLatest implDir $ obeliskSourceWithBranch branch
108+ InitSource_Default -> cloneAndRepack obeliskSource
109+ InitSource_Branch branch -> cloneAndRepack $ obeliskSourceWithBranch branch
78110 InitSource_Symlink path -> do
79111 let symlinkPath = if isAbsolute path
80112 then path
81113 else ".." </> path
82114 liftIO $ createSymbolicLink symlinkPath implDir
83115 _ <- nixBuildAttrWithCache implDir "command"
84− --TODO: We should probably handoff to the impl here
85116 skel <- nixBuildAttrWithCache implDir "skeleton" --TODO: I don't think there's actually any reason to cache this
86117
87118 callProcessAndLogOutput (Notice, Error) $
88− proc "cp"
119+ proc cp
89120 [ "-r"
90121 , "--preserve=links"
91122 , obDir
@@ -95,7 +126,7 @@ initProject source = withSystemTempDirectory "ob-init" $ \tmpDir -> do
95126
96127 withSpinner "Copying project skeleton" $ do
97128 callProcessAndLogOutput (Notice, Error) $
98− proc "cp"
129+ proc cp
99130 [ "-r"
100131 , "--no-preserve=mode"
101132 , "-T"
@@ -106,21 +137,46 @@ initProject source = withSystemTempDirectory "ob-init" $ \tmpDir -> do
106137 let configDir = "config"
107138 createDirectoryIfMissing False configDir
108139 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))
109164
110165--TODO: Allow the user to ignore our security concerns
111166-- | Find the Obelisk implementation for the project at the given path
112167findProjectObeliskCommand :: MonadObelisk m => FilePath -> m (Maybe FilePath)
113−findProjectObeliskCommand target = withSpinnerNoTrail "Locating project obelisk" $ do
168+findProjectObeliskCommand target = do
114169 myUid <- liftIO getRealUserID
170+ processUmask <- liftIO getUmask
115171 targetStat <- liftIO $ getFileStatus target
116− (result, insecurePaths) <- flip runStateT [] $ walkToProjectRoot target targetStat myUid >>= \case
172+ (result, insecurePaths) <- flip runStateT [] $ walkToProjectRoot target targetStat processUmask myUid >>= \case
117173 Nothing -> pure Nothing
118174 Just projectRoot -> liftIO (doesDirectoryExist $ toImplDir projectRoot) >>= \case
119175 False -> do
120176 putLog Warning $ "Found obelisk directory in " <> T.pack projectRoot <> " but the implementation (impl) file is missing"
121177 pure Nothing
122178 True -> do
123− walkToImplDir projectRoot myUid -- For security check
179+ walkToImplDir projectRoot myUid processUmask -- For security check
124180 return $ Just projectRoot
125181 case (result, insecurePaths) of
126182 (Just projDir, []) -> do
@@ -131,19 +187,39 @@ findProjectObeliskCommand target = withSpinnerNoTrail "Locating project obelisk"
131187 putLog Error $ T.unlines
132188 [ "Error: Found a project at " <> T.pack (normalise projDir) <> ", but had to traverse one or more insecure directories to get there:"
133189 , T.unlines $ fmap (T.pack . normalise) insecurePaths
134− , "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."
135191 ]
136192 return Nothing
137193
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+
138213-- | Get the FilePath to the containing project directory, if there is one
139214findProjectRoot :: MonadObelisk m => FilePath -> m (Maybe FilePath)
140215findProjectRoot target = do
141216 myUid <- liftIO getRealUserID
142217 targetStat <- liftIO $ getFileStatus target
143− (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat myUid) []
144− return result
218+ umask <- liftIO getUmask
219+ (result, _) <- liftIO $ runStateT (walkToProjectRoot target targetStat umask myUid) []
220+ return $ makeRelative "." <$> result
145221
146−withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m ()) -> m ()
222+withProjectRoot :: MonadObelisk m => FilePath -> (FilePath -> m a) -> m a
147223withProjectRoot target f = findProjectRoot target >>= \case
148224 Nothing -> failWith "Must be used inside of an Obelisk project"
149225 Just root -> f root
@@ -153,15 +229,15 @@ withProjectRoot target f = findProjectRoot target >>= \case
153229-- traversed in the process. Return the project root directory, if found.
154230walkToProjectRoot
155231 :: (MonadState [FilePath] m, MonadIO m)
156− => FilePath -> FileStatus -> UserID -> m (Maybe FilePath)
157−walkToProjectRoot this thisStat myUid = liftIO (doesDirectoryExist this) >>= \case
232+ => FilePath -> FileStatus -> FileMode -> UserID -> m (Maybe FilePath)
233+walkToProjectRoot this thisStat desiredUmask myUid = liftIO (doesDirectoryExist this) >>= \case
158234 -- It's not a directory, so it can't be a project
159235 False -> do
160236 let dir = takeDirectory this
161237 dirStat <- liftIO $ getFileStatus dir
162− walkToProjectRoot dir dirStat myUid
238+ walkToProjectRoot dir dirStat desiredUmask myUid
163239 True -> do
164− when (not $ isWritableOnlyBy thisStat myUid) $ modify (this:)
240+ when (not $ isWellOwnedAndWellPermissioned thisStat myUid desiredUmask) $ modify (this:)
165241 liftIO (doesDirectoryExist $ toObeliskDir this) >>= \case
166242 True -> return $ Just this
167243 False -> do
@@ -171,44 +247,109 @@ walkToProjectRoot this thisStat myUid = liftIO (doesDirectoryExist this) >>= \ca
171247 isSameFileAs = (==) `on` fileIdentity
172248 if thisStat `isSameFileAs` nextStat
173249 then return Nothing -- Found a cycle; probably hit root directory
174− else walkToProjectRoot next nextStat myUid
250+ else walkToProjectRoot next nextStat desiredUmask myUid
175251
176252-- | Walk from the given project root directory to its Obelisk implementation
177253-- directory, accumulating potentially insecure directories that were traversed
178254-- in the process.
179−walkToImplDir :: (MonadState [FilePath] m, MonadIO m) => FilePath -> UserID -> m ()
180−walkToImplDir projectRoot myUid = do
255+walkToImplDir :: (MonadState [FilePath] m, MonadIO m) => FilePath -> UserID -> FileMode -> m ()
256+walkToImplDir projectRoot myUid umask = do
181257 let obDir = toObeliskDir projectRoot
182258 obDirStat <- liftIO $ getFileStatus obDir
183− when (not $ isWritableOnlyBy obDirStat myUid) $ modify (obDir:)
259+ when (not $ isWellOwnedAndWellPermissioned obDirStat myUid umask) $ modify (obDir:)
184260 let implThunk = obDir </> "impl"
185261 implThunkStat <- liftIO $ getFileStatus implThunk
186− when (not $ isWritableOnlyBy implThunkStat myUid) $ modify (implThunk:)
187−
188−--TODO: Is there a better way to ask if anyone else can write things?
189−--E.g. what about ACLs?
190−-- | Check to see if directory is only writable by a user whose User ID matches the second argument provided
191−isWritableOnlyBy :: FileStatus -> UserID -> Bool
192−isWritableOnlyBy s uid = fileOwner s == uid && fileMode s .&. 0o22 == 0
193−
194−-- | Run a command in the given shell for the current project
195−inProjectShell :: MonadObelisk m => String -> String -> m ()
196−inProjectShell shellName command = withProjectRoot "." $ \root ->
197− projectShell root True shellName command
198−
199−inImpureProjectShell :: MonadObelisk m => String -> String -> m ()
200−inImpureProjectShell shellName command = withProjectRoot "." $ \root ->
201− projectShell root False shellName command
202−
203−projectShell :: MonadObelisk m => FilePath -> Bool -> String -> String -> m ()
204−projectShell root isPure shellName command = withNixRemoteCheck $ do
205− (_, _, _, ph) <- createProcess_ "runNixShellAttr" $ setCwd (Just root) $ proc "nix-shell" $
206− [ "--pure" | isPure ] <>
207− [ "-A"
208− , "shells." <> shellName
209− , "--run", command
210− ]
211− void $ liftIO $ waitForProcess ph
212−
213−setCwd :: Maybe FilePath -> CreateProcess -> CreateProcess
214−setCwd fp cfg = cfg { cwd = fp }
262+ when (not $ isWellOwnedAndWellPermissioned implThunkStat myUid umask) $ modify (implThunk:)
263+
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.
268+isWellOwnedAndWellPermissioned :: FileStatus -> UserID -> FileMode -> Bool
269+isWellOwnedAndWellPermissioned s uid umask = isOwnedBy s uid && filePermissionIsSafe s umask
270+
271+isOwnedBy :: FileStatus -> UserID -> Bool
272+isOwnedBy s uid = fileOwner s == uid
273+
274+-- | Check to see if a directory respect the umask, but check explicitly that
275+-- it's not world writable in any case.
276+filePermissionIsSafe :: FileStatus -> FileMode -> Bool
277+filePermissionIsSafe s umask = not fileWorldWritable && fileGroupWritable <= umaskGroupWritable
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
304+ :: MonadObelisk m
305+ => FilePath -- ^ Path to project root
306+ -> Bool -- ^ Should this be a pure shell?
307+ -> Bool -- ^ Should we chdir to the package root in the shell?
308+ -> Map Text FilePath -- ^ Package names mapped to their paths
309+ -> String -- ^ Shell attribute to use (e.g. @"ghc"@, @"ghcjs"@, etc.)
310+ -> Maybe String -- ^ If 'Just' run the given command; otherwise just open the interactive shell
311+ -> m ()
312+nixShellWithoutPkgs root isPure chdirToRoot packageNamesAndPaths shellAttr command = do
313+ packageNamesAndAbsPaths <- liftIO $ for packageNamesAndPaths makeAbsolute
314+ defShellConfig <- nixShellRunConfig root isPure command
315+ let setCwd_ = if chdirToRoot then setCwd (Just root) else id
316+ runProcess_ $ setCwd_ $ nixShellRunProc $ defShellConfig
317+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
318+ "{root, pkgs, shell}: ((import root {}).passthru.__unstable__.self.extend (_: _: {\
319+ \shellPackages = builtins.fromJSON pkgs;\
320+ \})).project.shells.${shell}"
321+ & nixShellConfig_common . nixCmdConfig_args .~
322+ [ rawArg "root" $ toNixPath $ if chdirToRoot then "." else root
323+ , strArg "pkgs" (T.unpack $ decodeUtf8 $ BSL.toStrict $ Json.encode packageNamesAndAbsPaths)
324+ , strArg "shell" shellAttr
325+ ]
326+
327+nixShellWithHoogle :: MonadObelisk m => FilePath -> Bool -> String -> Maybe String -> m ()
328+nixShellWithHoogle root isPure shell' command = do
329+ defShellConfig <- nixShellRunConfig root isPure command
330+ runProcess_ $ setCwd (Just root) $ nixShellRunProc $ defShellConfig
331+ & nixShellConfig_common . nixCmdConfig_target . target_expr ?~
332+ "{shell}: ((import ./. {}).passthru.__unstable__.self.extend (_: super: {\
333+ \userSettings = super.userSettings // { withHoogle = true; };\
334+ \})).project.shells.${shell}"
335+ & nixShellConfig_common . nixCmdConfig_args .~ [ strArg "shell" shell' ]
336+
337+findProjectAssets :: MonadObelisk m => FilePath -> m Text
338+findProjectAssets root = do
339+ isDerivation <- readProcessAndLogStderr Debug $ setCwd (Just root) $
340+ proc nixExePath
341+ [ "eval"
342+ , "(let a = import ./. {}; in toString (a.reflex.nixpkgs.lib.isDerivation a.passthru.staticFilesImpure))"
343+ , "--raw"
344+ -- `--raw` is not available with old nix-instantiate. It drops quotation
345+ -- marks and trailing newline, so is very convenient for shelling out.
346+ ]
347+ -- Check whether the impure static files are a derivation (and so must be built)
348+ if isDerivation == "1"
349+ then fmap T.strip $ readProcessAndLogStderr Debug $ setCwd (Just root) $ -- Strip whitespace here because nix-build has no --raw option
350+ proc nixBuildExePath
351+ [ "--no-out-link"
352+ , "-E", "(import ./. {}).passthru.staticFilesImpure"
353+ ]
354+ else readProcessAndLogStderr Debug $ setCwd (Just root) $
355+ proc nixExePath ["eval", "-f", ".", "passthru.staticFilesImpure", "--raw"]
lib/command/src/Obelisk/Command/Run.hs+518−104
@@ -1,140 +1,554 @@
1+{-# LANGUAGE DeriveFoldable #-}
2+{-# LANGUAGE DeriveFunctor #-}
3+{-# LANGUAGE DeriveTraversable #-}
14{-# LANGUAGE FlexibleContexts #-}
25{-# LANGUAGE LambdaCase #-}
36{-# LANGUAGE MultiParamTypeClasses #-}
47{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE QuasiQuotes #-}
59{-# LANGUAGE ScopedTypeVariables #-}
10+{-# LANGUAGE TupleSections #-}
11+{-# LANGUAGE ViewPatterns #-}
612module Obelisk.Command.Run where
713
8−import Control.Exception (bracket)
9−import Control.Monad
14+import Control.Arrow ((&&&))
15+import Control.Exception (Exception, bracket)
16+import Control.Lens (ifor, (.~), (&))
17+import Control.Monad (filterM)
18+import Control.Monad.Except (runExceptT, throwError)
1019import Control.Monad.IO.Class (liftIO)
1120import Control.Monad.Reader (MonadIO)
12−import Data.Either
13−import Data.List
14−import Data.List.NonEmpty as NE
15−import Data.Maybe
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)
28+import Data.List (intercalate)
29+import Data.List.NonEmpty (NonEmpty)
30+import qualified Data.List.NonEmpty as NE
31+import Data.Map (Map)
32+import qualified Data.Map as Map
33+import qualified Data.Map.Monoidal as MMap
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)
1640import 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(..))
1746import Distribution.PackageDescription.Parsec (parseGenericPackageDescription)
1847import Distribution.Parsec.ParseResult (runParseResult)
19−import Distribution.Types.BuildInfo
20−import Distribution.Types.CondTree
21−import Distribution.Types.GenericPackageDescription
22−import Distribution.Types.Library
23−import Distribution.Utils.Generic (withUTF8FileContents, toUTF8BS)
24−import Network.Socket
48+import qualified Distribution.System as Dist
49+import Distribution.Types.BuildInfo (buildable, cppOptions, defaultExtensions, defaultLanguage, hsSourceDirs, options)
50+import Distribution.Types.CondTree (simplifyCondTree)
51+import Distribution.Types.GenericPackageDescription (ConfVar (Arch, Impl, OS), condLibrary)
52+import Distribution.Types.Library (libBuildInfo)
53+import Distribution.Utils.Generic (toUTF8BS, readUTF8File)
54+import qualified Distribution.Parsec.Common as Dist
55+import qualified Hpack.Config as Hpack
56+import qualified Hpack.Render as Hpack
57+import qualified Hpack.Yaml as Hpack
58+import Language.Haskell.Extension (Extension, Language)
59+import qualified Network.Socket as Socket
2560import System.Directory
61+import System.Environment (getExecutablePath)
2662import System.FilePath
63+import qualified System.Info
2764import System.IO.Temp (withSystemTempDirectory)
28−import Data.ByteString (ByteString)
29−
30−import Obelisk.App (MonadObelisk, ObeliskT)
31−import Obelisk.CliApp (CliT (..), HasCliConfig, Severity (..), callCommand, failWith, getCliConfig, putLog,
32− runCli)
33−import Obelisk.Command.Project (inProjectShell)
34−
35−-- NOTE: `run` is not polymorphic like the rest because we use StaticPtr to invoke it.
36−run :: ObeliskT IO ()
37−run = do
38− pkgs <- getLocalPkgs
39− withGhciScript pkgs $ \dotGhciPath -> do
40− freePort <- getFreePort
41− runGhcid dotGhciPath $ Just $ unwords ["main", show freePort]
42−
43−runRepl :: MonadObelisk m => m ()
44−runRepl = do
45− pkgs <- getLocalPkgs
46− withGhciScript pkgs $ \dotGhciPath -> do
47− runGhciRepl dotGhciPath
48−
49−-- | Relative paths to local packages of an obelisk project
50−-- TODO a way to query this
51−getLocalPkgs :: Applicative f => f [FilePath]
52−getLocalPkgs = pure ["backend", "common", "frontend"]
53−
54−parseHsSrcDir
55− :: (MonadObelisk m)
56− => FilePath -- ^ package cabal file path
57− -> m (Maybe (NE.NonEmpty FilePath)) -- ^ List of hs src dirs of the library component
58−parseHsSrcDir cabalFp = do
59− exists <- liftIO $ doesFileExist cabalFp
60− if exists
61− then do
62− withUTF8FileContentsM cabalFp $ \cabal -> do
63− let (warnings, result) = runParseResult $ parseGenericPackageDescription cabal
64− mapM_ (putLog Warning) $ fmap (T.pack . show) warnings
65− case result of
66− Right gpkg -> do
67− return $ do
68− (_, lib) <- simplifyCondTree (const $ pure True) <$> condLibrary gpkg
69− pure $ fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
70− Left (_, errors) -> do
71− putLog Error $ T.pack "Failed to parse cabal file: "
72− mapM_ (putLog Error) $ fmap (T.pack . show) errors
73− return Nothing
74− else return Nothing
75−
76−withUTF8FileContentsM :: (MonadIO m, HasCliConfig m) => FilePath -> (ByteString -> CliT IO a) -> m a
77−withUTF8FileContentsM fp f = do
78− c <- getCliConfig
79− liftIO $ withUTF8FileContents fp $ runCli c . f . toUTF8BS
65+
66+import Obelisk.App (MonadObelisk)
67+import Obelisk.CliApp (
68+ Severity (..),
69+ failWith,
70+ proc,
71+ putLog,
72+ readCreateProcessWithExitCode,
73+ readProcessAndLogStderr,
74+ runProcess_,
75+ setCwd,
76+ setDelegateCtlc,
77+ withSpinner,
78+ )
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)
83+
84+data CabalPackageInfo = CabalPackageInfo
85+ { _cabalPackageInfo_packageFile :: FilePath
86+ , _cabalPackageInfo_packageName :: T.Text
87+ , _cabalPackageInfo_packageRoot :: FilePath
88+ , _cabalPackageInfo_buildable :: Bool
89+ , _cabalPackageInfo_sourceDirs :: NE.NonEmpty FilePath
90+ -- ^ List of hs src dirs of the library component
91+ , _cabalPackageInfo_defaultExtensions :: [Extension]
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)
99+ }
100+
101+-- | 'Bool' with a better name for its purpose.
102+data Interpret = Interpret_Interpret | Interpret_NoInterpret deriving (Eq, Ord, Show)
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.
301+parseCabalPackage
302+ :: MonadObelisk m
303+ => FilePath -- ^ Package directory
304+ -> m (Maybe CabalPackageInfo)
305+parseCabalPackage dir = parseCabalPackage' dir >>= \case
306+ Left err -> Nothing <$ putLog Error err
307+ Right (Just (warnings, pkgInfo)) -> do
308+ for_ warnings $ putLog Warning . T.pack . show
309+ pure $ Just pkgInfo
310+ Right Nothing -> pure Nothing
311+
312+-- | Like 'parseCabalPackage' but returns errors and warnings directly so as to avoid 'MonadObelisk'.
313+parseCabalPackage'
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
324+ decodeOptions = Hpack.DecodeOptions (Hpack.ProgramName "ob") file Nothing Hpack.decodeYaml
325+ liftIO (Hpack.readPackageConfig decodeOptions) >>= \case
326+ Left err -> throwError $ T.pack $ "Failed to parse " <> file <> ": " <> err
327+ Right (Hpack.DecodeResult hpackPackage _ _ _) -> pure (Hpack.renderPackage [] hpackPackage, file, Hpack.packageName hpackPackage)
328+
329+ let
330+ (warnings, result) = runParseResult $ parseGenericPackageDescription $ toUTF8BS cabalContents
331+ osConfVar = case System.Info.os of
332+ "linux" -> Just Dist.Linux
333+ "darwin" -> Just Dist.OSX
334+ _ -> trace "Unrecgonized System.Info.os" Nothing
335+ archConfVar = Just Dist.X86_64 -- TODO: Actually infer this
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
344+ pure $ Just $ (warnings,) $ CabalPackageInfo
345+ { _cabalPackageInfo_packageName = T.pack packageName
346+ , _cabalPackageInfo_packageFile = packageFile
347+ , _cabalPackageInfo_packageRoot = takeDirectory packageFile
348+ , _cabalPackageInfo_buildable = buildable $ libBuildInfo lib
349+ , _cabalPackageInfo_sourceDirs =
350+ fromMaybe (pure ".") $ NE.nonEmpty $ hsSourceDirs $ libBuildInfo lib
351+ , _cabalPackageInfo_defaultExtensions =
352+ defaultExtensions $ libBuildInfo lib
353+ , _cabalPackageInfo_defaultLanguage =
354+ defaultLanguage $ libBuildInfo lib
355+ , _cabalPackageInfo_compilerOptions = options $ libBuildInfo lib
356+ , _cabalPackageInfo_cppOptions = cppOptions $ libBuildInfo lib
357+ }
358+ Right Nothing -> pure Nothing
359+ Left (_, errors) ->
360+ throwError $ T.pack $ "Failed to parse " <> packageFile <> ":\n" <> unlines (map show errors)
361+
362+parsePackagesOrFail :: (MonadObelisk m, Foldable f) => f FilePath -> m (NE.NonEmpty CabalPackageInfo)
363+parsePackagesOrFail dirs' = do
364+ packageInfos' <- fmap catMaybes $ for dirs $ \dir -> do
365+ flip fmap (parseCabalPackage dir) $ \case
366+ Just packageInfo
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+ ]
80411
81412-- | Create ghci configuration to load the given packages
82413withGhciScript
83− :: MonadObelisk m
84− => [FilePath] -- ^ List of packages to load into ghci
85− -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporory .ghci
414+ :: (MonadObelisk m, Foldable f)
415+ => [String] -- ^ Commands to prefix to file
416+ -> f CabalPackageInfo -- ^ List of packages to load into ghci
417+ -> (FilePath -> m ()) -- ^ Action to run with the path to generated temporary .ghci
86418 -> m ()
87−withGhciScript pkgs f = do
88− (pkgDirErrs, hsSrcDirs) <- fmap partitionEithers $ forM pkgs $ \pkg -> do
89− let cabalFp = pkg </> pkg <.> "cabal"
90− flip fmap (parseHsSrcDir cabalFp) $ \case
91− Nothing -> Left pkg
92− Just hsSrcDirs -> Right $ toList $ fmap (pkg </>) hsSrcDirs
93−
94− when (null hsSrcDirs) $
95− failWith $ T.pack $ "No valid pkgs found in " <> intercalate ", " pkgs
96− unless (null pkgDirErrs) $
97− putLog Warning $ T.pack $ "Failed to find pkgs in " <> intercalate ", " pkgDirErrs
98−
99− let dotGhci = unlines
100− [ ":set -i" <> intercalate ":" (mconcat hsSrcDirs)
101− , ":load ./devel/Devel.hs" -- TODO more robust filepath
102− ]
419+withGhciScript preCommands (toList -> packageInfos) f =
103420 withSystemTempDirectory "ob-ghci" $ \fp -> do
104421 let dotGhciPath = fp </> ".ghci"
105422 liftIO $ writeFile dotGhciPath dotGhci
106423 f dotGhciPath
424+ where
425+ packageNames = Set.fromList $ map _cabalPackageInfo_packageName packageInfos
426+ modulesToLoad = mconcat
427+ [ [ "Obelisk.Run" | "obelisk-run" `Set.member` packageNames ]
428+ , [ "Backend" | "backend" `Set.member` packageNames ]
429+ , [ "Frontend" | "frontend" `Set.member` packageNames ]
430+ ]
431+ dotGhci = unlines $
432+ preCommands <>
433+ [ if null modulesToLoad then "" else ":load " <> unwords modulesToLoad
434+ , "import qualified Obelisk.Run"
435+ , "import qualified Frontend"
436+ , "import qualified Backend"
437+ ]
438+
439+-- | Builds a list of options to pass to ghci or set in .ghci file that configures
440+-- the preprocessor and source includes.
441+getGhciSessionSettings
442+ :: (MonadObelisk m, Foldable f)
443+ => f CabalPackageInfo -- ^ List of packages to load into ghci
444+ -> FilePath -- ^ All paths will be relative to this path
445+ -> Bool -- ^ Use relative paths
446+ -> m [String]
447+getGhciSessionSettings (toList -> packageInfos) pathBase useRelativePaths = do
448+ -- N.B. ghci settings do NOT support escaping in any way. To minimize the likelihood that
449+ -- paths-with-spaces ruin our day, we first canonicalize everything, and then relativize
450+ -- all paths to 'pathBase'.
451+ selfExe <- liftIO $ canonicalizePath =<< getExecutablePath
452+ canonicalPathBase <- liftIO $ canonicalizePath pathBase
453+
454+ (pkgFiles, pkgSrcPaths :: [NonEmpty FilePath]) <- fmap unzip $ liftIO $ for packageInfos $ \pkg -> do
455+ canonicalSrcDirs <- traverse canonicalizePath $ (_cabalPackageInfo_packageRoot pkg </>) <$> _cabalPackageInfo_sourceDirs pkg
456+ canonicalPkgFile <- canonicalizePath $ _cabalPackageInfo_packageFile pkg
457+ pure (canonicalPkgFile `relativeTo'` canonicalPathBase, (`relativeTo'` canonicalPathBase) <$> canonicalSrcDirs)
458+
459+ pure
460+ $ baseGhciOptions
461+ <> ["-F", "-pgmF", selfExe, "-optF", preprocessorIdentifier]
462+ <> concatMap (\p -> ["-optF", p]) pkgFiles
463+ <> [ "-i" <> intercalate ":" (concatMap toList pkgSrcPaths) ]
464+ where
465+ relativeTo' = if useRelativePaths then relativeTo else const
466+
467+baseGhciOptions :: [String]
468+baseGhciOptions =
469+ [ "-ignore-dot-ghci"
470+ , "-no-user-package-db"
471+ , "-package-env", "-"
472+ ]
107473
108474-- | Run ghci repl
109475runGhciRepl
110− :: MonadObelisk m
111− => FilePath -- ^ Path to .ghci
476+ :: (MonadObelisk m, Foldable f)
477+ => FilePath -- ^ Path to project root
478+ -> f CabalPackageInfo -- ^ Packages to keep unbuilt
479+ -> [String] -- ^ GHCi arguments
112480 -> m ()
113−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
114486
115487-- | Run ghcid
116488runGhcid
117− :: MonadObelisk m
118− => FilePath -- ^ Path to .ghci
489+ :: (MonadObelisk m, Foldable f)
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
119494 -> Maybe String -- ^ Optional command to run at every reload
120495 -> m ()
121−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
122499 where
123− opts =
124− [ "-W"
125− --TODO: The decision of whether to use -fwarn-redundant-constraints should probably be made by the user
126− , "--command='ghci -Wall -fwarn-redundant-constraints -ghci-script " <> dotGhci <> "' "
127− , "--reload=config"
128− , "--outputfile=ghcid-output.txt"
129− ] <> testCmd
130− testCmd = maybeToList (flip fmap mcmd $ \cmd -> "--test='" <> cmd <> "'")
131−
132−getFreePort :: MonadIO m => m PortNumber
133−getFreePort = liftIO $ withSocketsDo $ do
134− addr:_ <- getAddrInfo (Just defaultHints) (Just "127.0.0.1") (Just "0")
135− bracket (open addr) close socketPort
500+ opts = concat
501+ [ ["-W"]
502+ , ["--outputfile=ghcid-output.txt"]
503+ , map (\x -> "--reload=" <> x) reloadFiles
504+ , map (\x -> "--restart=" <> x) restartFiles
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+
512+getFreePort :: MonadIO m => m Socket.PortNumber
513+getFreePort = liftIO $ Socket.withSocketsDo $ do
514+ addr:_ <- Socket.getAddrInfo (Just Socket.defaultHints) (Just "127.0.0.1") (Just "0")
515+ bracket (open addr) Socket.close Socket.socketPort
136516 where
137517 open addr = do
138− sock <- socket (addrFamily addr) (addrSocketType addr) (addrProtocol addr)
139− bind sock (addrAddress addr)
518+ sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
519+ Socket.bind sock (Socket.addrAddress addr)
140520 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+865−494
@@ -5,84 +5,70 @@
55{-# LANGUAGE MultiWayIf #-}
66{-# LANGUAGE OverloadedStrings #-}
77{-# LANGUAGE PatternGuards #-}
8+{-# LANGUAGE QuasiQuotes #-}
89{-# LANGUAGE ScopedTypeVariables #-}
910{-# LANGUAGE TypeApplications #-}
10−module Obelisk.Command.Thunk
11− ( ThunkPtr (..)
12− , ThunkRev (..)
13− , ThunkSource (..)
14− , ThunkData (..)
15− , ReadThunkError (..)
16− , GitHubSource (..)
17− , getThunkGitBranch
18− , getLatestRev
19− , updateThunkToLatest
20− , createThunk
21− , createThunkWithLatest
22− , nixBuildAttrWithCache
23− , nixBuildThunkAttrWithCache
24− , unpackThunk
25− , packThunk
26− , readThunk
27− , updateThunk
28− , getThunkPtr
29− , getThunkPtr'
30− ) where
11+module Obelisk.Command.Thunk where
3112
3213import Control.Applicative
33−import Control.Exception (displayException, throwIO, try)
14+import Control.Exception (displayException, try)
15+import Control.Lens (ifor, ifor_, (.~))
3416import Control.Monad
35−import Control.Monad.Catch (handle)
17+import Control.Monad.Extra (findM)
18+import Control.Monad.Catch (MonadCatch, handle)
3619import Control.Monad.Except
3720import Data.Aeson ((.=))
3821import qualified Data.Aeson as Aeson
3922import Data.Aeson.Encode.Pretty
4023import qualified Data.Aeson.Types as Aeson
24+import Data.Bifunctor (first)
4125import qualified Data.ByteString.Lazy as LBS
42−import qualified Data.ByteString.Lazy.Char8 as LBSC
26+import Data.Containers.ListUtils (nubOrd)
4327import Data.Default
44−import Data.Either.Combinators (rightToMaybe)
45−import Data.Foldable
28+import Data.Either.Combinators (fromRight', rightToMaybe)
29+import Data.Foldable (toList)
30+import Data.Function ((&))
31+import Data.Functor ((<&>))
4632import Data.Git.Ref (Ref)
4733import qualified Data.Git.Ref as Ref
4834import qualified Data.List as L
49−import Data.List.NonEmpty (NonEmpty (..))
35+import Data.List.NonEmpty (NonEmpty (..), nonEmpty)
5036import qualified Data.List.NonEmpty as NonEmpty
37+import Data.Map (Map)
5138import qualified Data.Map as Map
5239import Data.Maybe
5340import Data.Set (Set)
5441import qualified Data.Set as Set
42+import Data.String.Here.Interpolated (i)
43+import Data.String.Here.Uninterpolated (here)
5544import Data.Text (Text)
5645import qualified Data.Text as T
5746import Data.Text.Encoding
5847import qualified Data.Text.IO as T
5948import Data.Time.Clock.POSIX (posixSecondsToUTCTime)
60−import Data.Yaml (parseMaybe, (.:))
61−import qualified Data.Yaml as Yaml
49+import Data.Traversable (for)
50+import Data.Yaml (parseMaybe)
6251import GitHub
6352import GitHub.Data.Name
64−import GitHub.Endpoints.Repos.Contents (archiveForR)
65−import Network.URI
6653import Obelisk.Command.Nix
6754import System.Directory
55+import System.Exit
6856import System.FilePath
6957import System.IO.Error
7058import System.IO.Temp
71−import System.Posix (getSymbolicLinkStatus, modificationTime)
72−import System.Process (proc)
59+import System.PosixCompat.Files (getSymbolicLinkStatus, modificationTime)
60+import qualified Text.URI as URI
7361
7462import Obelisk.App (MonadObelisk)
7563import Obelisk.CliApp
76−import Obelisk.Command.Nix (withNixRemoteCheck)
7764import Obelisk.Command.Utils
7865
7966--TODO: Support symlinked thunk data
8067data ThunkData
81− = ThunkData_Packed ThunkPtr
68+ = ThunkData_Packed ThunkSpec ThunkPtr
8269 -- ^ Packed thunk
83− | ThunkData_Checkout (Maybe ThunkPtr)
70+ | ThunkData_Checkout
8471 -- ^ Checked out thunk that was unpacked from this pointer
85− deriving (Show, Eq, Ord)
8672
8773-- | A reference to the exact data that a thunk should translate into
8874data ThunkPtr = ThunkPtr
@@ -95,7 +81,7 @@ type NixSha256 = Text --TODO: Use a smart constructor and make this actually ver
9581
9682-- | A specific revision of data; it may be available from multiple sources
9783data ThunkRev = ThunkRev
98− { _thunkRev_commit :: Ref
84+ { _thunkRev_commit :: Ref Ref.SHA1
9985 , _thunkRev_nixSha256 :: NixSha256
10086 }
10187 deriving (Show, Eq, Ord)
@@ -108,6 +94,11 @@ data ThunkSource
10894 | ThunkSource_Git GitSource
10995 deriving (Show, Eq, Ord)
11096
97+thunkSourceToGitSource :: ThunkSource -> GitSource
98+thunkSourceToGitSource = \case
99+ ThunkSource_GitHub s -> forgetGithub False s
100+ ThunkSource_Git s -> s
101+
111102data GitHubSource = GitHubSource
112103 { _gitHubSource_owner :: Name Owner
113104 , _gitHubSource_repo :: Name Repo
@@ -116,182 +107,208 @@ data GitHubSource = GitHubSource
116107 }
117108 deriving (Show, Eq, Ord)
118109
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+
119119data GitSource = GitSource
120− { _gitSource_url :: URI
121− , _gitSource_branch :: Name Branch
120+ { _gitSource_url :: GitUri
121+ , _gitSource_branch :: Maybe (Name Branch)
122122 , _gitSource_fetchSubmodules :: Bool
123+ , _gitSource_private :: Bool
123124 }
124125 deriving (Show, Eq, Ord)
125126
127+newtype ThunkConfig = ThunkConfig
128+ { _thunkConfig_private :: Maybe Bool
129+ } deriving Show
130+
131+data ThunkUpdateConfig = ThunkUpdateConfig
132+ { _thunkUpdateConfig_branch :: Maybe String
133+ , _thunkUpdateConfig_config :: ThunkConfig
134+ } deriving Show
135+
136+data ThunkPackConfig = ThunkPackConfig
137+ { _thunkPackConfig_force :: Bool
138+ , _thunkPackConfig_config :: ThunkConfig
139+ } deriving Show
140+
141+-- | Convert a GitHub source to a regular Git source. Assumes no submodules.
142+forgetGithub :: Bool -> GitHubSource -> GitSource
143+forgetGithub useSsh s = GitSource
144+ { _gitSource_url = GitUri $ URI.URI
145+ { URI.uriScheme = Just $ fromRight' $ URI.mkScheme $ if useSsh then "ssh" else "https"
146+ , URI.uriAuthority = Right $ URI.Authority
147+ { URI.authUserInfo = URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
148+ <$ guard useSsh
149+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
150+ , URI.authPort = Nothing
151+ }
152+ , URI.uriPath = Just ( False
153+ , fromRight' . URI.mkPathPiece <$>
154+ untagName (_gitHubSource_owner s)
155+ :| [ untagName (_gitHubSource_repo s) <> ".git" ]
156+ )
157+ , URI.uriQuery = []
158+ , URI.uriFragment = Nothing
159+ }
160+ , _gitSource_branch = _gitHubSource_branch s
161+ , _gitSource_fetchSubmodules = False
162+ , _gitSource_private = _gitHubSource_private s
163+ }
164+
126165getThunkGitBranch :: ThunkPtr -> Maybe Text
127166getThunkGitBranch (ThunkPtr _ src) = fmap untagName $ case src of
128167 ThunkSource_GitHub s -> _gitHubSource_branch s
129− ThunkSource_Git s -> Just $ _gitSource_branch s
168+ ThunkSource_Git s -> _gitSource_branch s
130169
131−commitNameToRef :: Name Commit -> Ref
170+commitNameToRef :: Name Commit -> Ref Ref.SHA1
132171commitNameToRef (N c) = Ref.fromHex $ encodeUtf8 c
133172
134173-- TODO: Use spinner here.
135−getNixSha256ForUriUnpacked :: MonadObelisk m => URI -> m NixSha256
174+getNixSha256ForUriUnpacked
175+ :: MonadObelisk m
176+ => GitUri
177+ -> m NixSha256
136178getNixSha256ForUriUnpacked uri =
137− withExitFailMessage ("nix-prefetch-url: Failed to determine sha256 hash of URL " <> T.pack (show uri)) $ do
138− fmap T.pack $ withNixRemoteCheck $ readProcessAndLogStderr Debug $
139− proc "nix-prefetch-url" ["--unpack" , "--type" , "sha256" , show uri]
179+ withExitFailMessage ("nix-prefetch-url: Failed to determine sha256 hash of URL " <> gitUriToText uri) $ do
180+ [hash] <- fmap T.lines $ readProcessAndLogOutput (Debug, Debug) $
181+ proc nixPrefetchUrlPath ["--unpack", "--type", "sha256", T.unpack $ gitUriToText uri]
182+ pure hash
140183
141−nixPrefetchGit :: MonadObelisk m => URI -> Text -> Bool -> m NixSha256
184+nixPrefetchGit :: MonadObelisk m => GitUri -> Text -> Bool -> m NixSha256
142185nixPrefetchGit uri rev fetchSubmodules =
143− withExitFailMessage ("nix-prefetch-git: Failed to determine sha256 hash of Git repo " <> T.pack (show uri) <> " at " <> rev) $ do
144− out <- withNixRemoteCheck $ readProcessAndLogStderr Debug $
145− proc "nix-prefetch-git" $ filter (/="")
146− [ "--url", show uri
186+ withExitFailMessage ("nix-prefetch-git: Failed to determine sha256 hash of Git repo " <> gitUriToText uri <> " at " <> rev) $ do
187+ out <- readProcessAndLogStderr Debug $
188+ proc nixPrefetchGitPath $ filter (/="")
189+ [ "--url", T.unpack $ gitUriToText uri
147190 , "--rev", T.unpack rev
148191 , if fetchSubmodules then "--fetch-submodules" else ""
149192 , "--quiet"
150193 ]
151194
152− case parseMaybe (Aeson..: "sha256") =<< Aeson.decode (LBSC.pack out) of
153− Nothing -> failWith $ "nix-prefetch-git: unrecognized output " <> T.pack out
195+ case parseMaybe (Aeson..: "sha256") =<< Aeson.decodeStrict (encodeUtf8 out) of
196+ Nothing -> failWith $ "nix-prefetch-git: unrecognized output " <> out
154197 Just x -> pure x
155198
156−getLatestGitRev :: MonadObelisk m => GitSource -> m ThunkRev
157−getLatestGitRev s = withSystemTempDirectory "git-clone" $ \tmpDir -> do
158− withExitFailMessage ("Unable to determine latest git revision for branch " <> branch) $ do
159− let git = fmap T.pack . readProcessAndLogStderr Debug . gitProc tmpDir
160− out <- liftA2 (<>)
161− (git ["clone", "--no-checkout", show $ _gitSource_url s]) -- Might be able to use --bare here instead to go faster.
162− (git ["log", T.unpack branch, "--max-count=1", "--format=%H"])
163−
164− case T.strip <$> safeLast (T.lines out) of
165− Nothing -> failWith $ "Unable to parse git log: " <> out
166− Just rev -> do
167− putLog Debug $ "Latest commit in " <> branch <> " is " <> rev
168− sha <- nixPrefetchGit (_gitSource_url s) rev (_gitSource_fetchSubmodules s)
169− putLog Debug $ "Nix sha256 is " <> sha
170− pure $ ThunkRev
171− { _thunkRev_commit = Ref.fromHexString $ T.unpack rev
172− , _thunkRev_nixSha256 = sha
173− }
174− where
175− remote :: Text = "origin"
176− branch :: Text = remote <> "/" <> untagName (_gitSource_branch s)
177−
178− safeLast [] = Nothing
179− safeLast xs = Just $ last xs
180−
181−-- | Get the latest revision available from the given source
182−getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
183−getLatestRev = \case
184− ThunkSource_GitHub s -> do
185− auth <- liftIO $ getHubAuth "github.com"
186− commitsResult <- liftIO $ executeRequestMaybe auth $ commitsWithOptionsForR
187− (_gitHubSource_owner s)
188− (_gitHubSource_repo s)
189− (FetchAtLeast 1)
190− $ case _gitHubSource_branch s of
191− Nothing -> []
192− Just b -> [CommitQuerySha $ untagName b]
193− commitInfos <- either (liftIO . throwIO) return commitsResult
194− commitInfo : _ <- return $ toList commitInfos
195− let commit = commitSha commitInfo
196− putLog Debug $ "Latest commit is " <> untagName commit
197− Right archiveUri <- liftIO $ executeRequestMaybe auth $ archiveForR (_gitHubSource_owner s) (_gitHubSource_repo s) ArchiveFormatTarball $ Just $ untagName commit
198− nixSha256 <- getNixSha256ForUriUnpacked archiveUri
199− putLog Debug $ "Nix sha256 is " <> nixSha256
200− return $ ThunkRev
201− { _thunkRev_commit = commitNameToRef commit
202− , _thunkRev_nixSha256 = nixSha256
203− }
204− ThunkSource_Git s -> getLatestGitRev s
205−
206199--TODO: Pretty print these
207200data ReadThunkError
208− = ReadThunkError_UnrecognizedFiles
209− | ReadThunkError_AmbiguousFiles
210− | ReadThunkError_UnrecognizedLoader Text
211− | ReadThunkError_UnparseablePtr LBS.ByteString
212− deriving (Show)
213−
214−-- | Read a thunk and validate that it is only a thunk, either packed or unpacked.
215−-- If the thunk is packed and additional data is present, fail.
216−readThunk :: MonadObelisk m => FilePath -> m (Either ReadThunkError ThunkData)
217−readThunk thunkDir = do
218− files <- liftIO $ listDirectory thunkDir
219− case ".git" `elem` files of
220− True -> fmap ThunkData_Checkout <$> do
221− let origThunkPath = thunkDir </> ".git" </> "obelisk" </> "orig-thunk"
222− liftIO $ doesDirectoryExist origThunkPath >>= \case
223− True -> fmap Just <$> readPackedThunk origThunkPath
224− False -> return $ return Nothing
225− False -> liftIO $ fmap ThunkData_Packed <$> readPackedThunk thunkDir
226−
227−data ThunkType = ThunkType
228− { _thunkType_loader :: FilePath
229− , _thunkType_json :: FilePath
230− , _thunkType_optional :: Set FilePath
231− , _thunkType_loaderVersions :: NonEmpty Text
232− , _thunkType_parser :: Aeson.Object -> Aeson.Parser ThunkPtr
201+ = ReadThunkError_UnrecognizedThunk
202+ | ReadThunkError_UnrecognizedPaths (NonEmpty FilePath)
203+ | ReadThunkError_MissingPaths (NonEmpty FilePath)
204+ | ReadThunkError_UnparseablePtr FilePath String
205+ | ReadThunkError_FileError IOError
206+ | ReadThunkError_FileDoesNotMatch FilePath Text
207+ | ReadThunkError_UnrecognizedState String
208+ | ReadThunkError_AmbiguousPackedState ThunkPtr ThunkPtr
209+ deriving (Show)
210+
211+unpackedDirName :: FilePath
212+unpackedDirName = "."
213+
214+attrCacheFileName :: FilePath
215+attrCacheFileName = ".attr-cache"
216+
217+-- | Specification for how a file in a thunk version works.
218+data ThunkFileSpec
219+ = ThunkFileSpec_Ptr (LBS.ByteString -> Either String ThunkPtr) -- ^ This file specifies 'ThunkPtr' data
220+ | ThunkFileSpec_FileMatches Text -- ^ This file must match the given content exactly
221+ | ThunkFileSpec_CheckoutIndicator -- ^ Existence of this directory indicates that the thunk is unpacked
222+ | ThunkFileSpec_AttrCache -- ^ This directory is an attribute cache
223+
224+-- | Specification for how a set of files in a thunk version work.
225+data ThunkSpec = ThunkSpec
226+ { _thunkSpec_name :: !Text
227+ , _thunkSpec_files :: !(Map FilePath ThunkFileSpec)
233228 }
234229
235−gitHubThunkType :: ThunkType
236−gitHubThunkType = ThunkType
237− { _thunkType_loader = "default.nix"
238− , _thunkType_json = "github.json"
239− , _thunkType_optional = Set.fromList [".attr-cache"]
240− , _thunkType_loaderVersions = gitHubStandaloneLoaders
241− , _thunkType_parser = parseThunkPtr $ \v ->
242− ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
243− }
244−
245−gitThunkType :: ThunkType
246−gitThunkType = ThunkType
247− { _thunkType_loader = "default.nix"
248− , _thunkType_json = "git.json"
249− , _thunkType_optional = Set.fromList [".attr-cache"]
250− , _thunkType_loaderVersions = plainGitStandaloneLoaders
251− , _thunkType_parser = parseThunkPtr $ fmap ThunkSource_Git . parseGitSource
252− }
253−
254−thunkTypes :: [ThunkType]
255−thunkTypes = [gitThunkType, gitHubThunkType]
256−
257−findThunkType :: [ThunkType] -> FilePath -> IO (Either ReadThunkError ThunkType)
258−findThunkType types thunkDir = do
259− matches <- fmap catMaybes $ forM types $ \thunkType -> do
260− let
261− expectedContents = Set.fromList $ (thunkDir </>) <$>
262− [ _thunkType_loader thunkType
263− , _thunkType_json thunkType
264− ]
265− optionalContents = Set.map (thunkDir </>) (_thunkType_optional thunkType)
266−
267− -- Ensure that there aren't any other files in the thunk
268− -- NB: System.Directory.listDirectory returns the contents without the directory path
269− files <- liftIO $ Set.fromList . fmap (thunkDir </>) <$> listDirectory thunkDir
270− let unexpectedContents = files `Set.difference` (expectedContents `Set.union` optionalContents)
271− missingContents = expectedContents `Set.difference` files
272− pure $ if Set.null unexpectedContents && Set.null missingContents
273− then Just thunkType
274− else Nothing
275−
276− pure $ case matches of
277− [singleMatch] -> Right singleMatch
278− [] -> Left ReadThunkError_UnrecognizedFiles
279− _ -> Left ReadThunkError_AmbiguousFiles
230+thunkSpecTypes :: NonEmpty (NonEmpty ThunkSpec)
231+thunkSpecTypes = gitThunkSpecs :| [gitHubThunkSpecs]
232+
233+-- | Attempts to match a 'ThunkSpec' to a given directory.
234+matchThunkSpecToDir
235+ :: (MonadError ReadThunkError m, MonadIO m, MonadCatch m)
236+ => ThunkSpec -- ^ 'ThunkSpec' to match against the given files/directory
237+ -> FilePath -- ^ Path to directory
238+ -> Set FilePath -- ^ Set of file paths relative to the given directory
239+ -> m ThunkData
240+matchThunkSpecToDir thunkSpec dir dirFiles = do
241+ case nonEmpty (toList $ dirFiles `Set.difference` expectedPaths) of
242+ Just fs -> throwError $ ReadThunkError_UnrecognizedPaths $ (dir </>) <$> fs
243+ Nothing -> pure ()
244+ case nonEmpty (toList $ requiredPaths `Set.difference` dirFiles) of
245+ Just fs -> throwError $ ReadThunkError_MissingPaths $ (dir </>) <$> fs
246+ Nothing -> pure ()
247+ datas <- fmap toList $ flip Map.traverseMaybeWithKey (_thunkSpec_files thunkSpec) $ \expectedPath -> \case
248+ ThunkFileSpec_AttrCache -> Nothing <$ dirMayExist expectedPath
249+ ThunkFileSpec_CheckoutIndicator -> liftIO (doesDirectoryExist (dir </> expectedPath)) <&> \case
250+ False -> Nothing
251+ True -> Just ThunkData_Checkout
252+ ThunkFileSpec_FileMatches expectedContents -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
253+ actualContents <- liftIO (T.readFile $ dir </> expectedPath)
254+ case T.strip expectedContents == T.strip actualContents of
255+ True -> pure Nothing
256+ False -> throwError $ ReadThunkError_FileDoesNotMatch (dir </> expectedPath) expectedContents
257+ ThunkFileSpec_Ptr parser -> handle (\(e :: IOError) -> throwError $ ReadThunkError_FileError e) $ do
258+ let path = dir </> expectedPath
259+ liftIO (doesFileExist path) >>= \case
260+ False -> pure Nothing
261+ True -> do
262+ actualContents <- liftIO $ LBS.readFile path
263+ case parser actualContents of
264+ Right v -> pure $ Just (ThunkData_Packed thunkSpec v)
265+ Left e -> throwError $ ReadThunkError_UnparseablePtr (dir </> expectedPath) e
266+
267+ case nonEmpty datas of
268+ Nothing -> throwError ReadThunkError_UnrecognizedThunk
269+ Just xs -> fold1WithM xs $ \a b -> either throwError pure (mergeThunkData a b)
270+ where
271+ rootPathsOnly = Set.fromList . mapMaybe takeRootDir . Map.keys
272+ takeRootDir = fmap NonEmpty.head . nonEmpty . splitPath
273+
274+ expectedPaths = rootPathsOnly $ _thunkSpec_files thunkSpec
275+
276+ requiredPaths = rootPathsOnly $ Map.filter isRequiredFileSpec $ _thunkSpec_files thunkSpec
277+ isRequiredFileSpec = \case
278+ ThunkFileSpec_FileMatches _ -> True
279+ _ -> False
280+
281+ dirMayExist expectedPath = liftIO (doesFileExist (dir </> expectedPath)) >>= \case
282+ True -> throwError $ ReadThunkError_UnrecognizedPaths $ expectedPath :| []
283+ False -> pure ()
284+
285+ -- Combine 'ThunkData' from different files, preferring "Checkout" over "Packed"
286+ mergeThunkData ThunkData_Checkout ThunkData_Checkout = Right ThunkData_Checkout
287+ mergeThunkData ThunkData_Checkout ThunkData_Packed{} = Left bothPackedAndUnpacked
288+ mergeThunkData ThunkData_Packed{} ThunkData_Checkout = Left bothPackedAndUnpacked
289+ mergeThunkData a@(ThunkData_Packed _ ptrA) (ThunkData_Packed _ ptrB) =
290+ if ptrA == ptrB then Right a else Left $ ReadThunkError_AmbiguousPackedState ptrA ptrB
291+
292+ bothPackedAndUnpacked = ReadThunkError_UnrecognizedState "Both packed data and checkout present"
293+
294+ fold1WithM (x :| xs) f = foldM f x xs
295+
296+readThunkWith
297+ :: (MonadObelisk m)
298+ => NonEmpty (NonEmpty ThunkSpec) -> FilePath -> m (Either ReadThunkError ThunkData)
299+readThunkWith specTypes dir = do
300+ dirFiles <- Set.fromList <$> liftIO (listDirectory dir)
301+ let specs = concatMap toList $ toList $ NonEmpty.transpose specTypes -- Interleave spec types so we try each one in a "fair" ordering
302+ flip fix specs $ \loop -> \case
303+ [] -> pure $ Left ReadThunkError_UnrecognizedThunk
304+ spec:rest -> runExceptT (matchThunkSpecToDir spec dir dirFiles) >>= \case
305+ Left e -> putLog Debug [i|Thunk specification ${_thunkSpec_name spec} did not match ${dir}: ${e}|] *> loop rest
306+ x@(Right _) -> x <$ putLog Debug [i|Thunk specification ${_thunkSpec_name spec} matched ${dir}|]
280307
281308-- | Read a thunk and validate that it is exactly a packed thunk.
282309-- If additional data is present, fail.
283−readPackedThunk :: FilePath -> IO (Either ReadThunkError ThunkPtr)
284−readPackedThunk thunkDir = runExceptT $ do
285− thunkType <- ExceptT $ findThunkType thunkTypes thunkDir
286− -- Ensure that we recognize the thunk loader
287− loader <- liftIO $ T.readFile $ thunkDir </> _thunkType_loader thunkType
288− unless (loader `elem` _thunkType_loaderVersions thunkType) $ do
289− throwError $ ReadThunkError_UnrecognizedLoader loader
290−
291− txt <- liftIO $ LBS.readFile $ thunkDir </> _thunkType_json thunkType
292− case parseMaybe (_thunkType_parser thunkType) =<< Aeson.decode txt of
293− Nothing -> throwError $ ReadThunkError_UnparseablePtr txt
294− Just ptr -> return ptr
310+readThunk :: (MonadObelisk m) => FilePath -> m (Either ReadThunkError ThunkData)
311+readThunk = readThunkWith thunkSpecTypes
295312
296313parseThunkPtr :: (Aeson.Object -> Aeson.Parser ThunkSource) -> Aeson.Object -> Aeson.Parser ThunkPtr
297314parseThunkPtr parseSrc v = do
@@ -311,38 +328,42 @@ parseGitHubSource v = do
311328 owner <- v Aeson..: "owner"
312329 repo <- v Aeson..: "repo"
313330 branch <- v Aeson..:! "branch"
314− mPrivate <- v Aeson..:! "private"
331+ private <- v Aeson..:? "private"
315332 pure $ GitHubSource
316333 { _gitHubSource_owner = owner
317334 , _gitHubSource_repo = repo
318335 , _gitHubSource_branch = branch
319− , _gitHubSource_private = fromMaybe False mPrivate
336+ , _gitHubSource_private = fromMaybe False private
320337 }
321338
322339parseGitSource :: Aeson.Object -> Aeson.Parser GitSource
323340parseGitSource v = do
324341 Just url <- parseGitUri <$> v Aeson..: "url"
325− branch <- v Aeson..: "branch"
342+ branch <- v Aeson..:! "branch"
326343 fetchSubmodules <- v Aeson..:! "fetchSubmodules"
344+ private <- v Aeson..:? "private"
327345 pure $ GitSource
328346 { _gitSource_url = url
329347 , _gitSource_branch = branch
330348 , _gitSource_fetchSubmodules = fromMaybe False fetchSubmodules
349+ , _gitSource_private = fromMaybe False private
331350 }
332351
333352overwriteThunk :: MonadObelisk m => FilePath -> ThunkPtr -> m ()
334353overwriteThunk target thunk = do
335354 -- Ensure that this directory is a valid thunk (i.e. so we aren't losing any data)
336− Right _ <- readThunk target
355+ readThunk target >>= \case
356+ Left e -> failWith [i|Invalid thunk at ${target}: ${e}|]
357+ Right _ -> pure ()
337358
338359 --TODO: Is there a safer way to do this overwriting?
339− liftIO $ removeDirectoryRecursive target
340− liftIO $ createThunk target thunk
360+ liftIO $ removePathForcibly target
361+ createThunk target $ Right thunk
341362
342−thunkPtrLoader :: ThunkPtr -> Text
343−thunkPtrLoader thunk = case _thunkPtr_source thunk of
344− ThunkSource_GitHub _ -> NonEmpty.head gitHubStandaloneLoaders
345− ThunkSource_Git _ -> NonEmpty.head plainGitStandaloneLoaders
363+thunkPtrToSpec :: ThunkPtr -> ThunkSpec
364+thunkPtrToSpec thunk = case _thunkPtr_source thunk of
365+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
366+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
346367
347368-- It's important that formatting be very consistent here, because
348369-- otherwise when people update thunks, their patches will be messy
@@ -351,22 +372,18 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
351372 ThunkSource_GitHub s -> encodePretty' githubCfg $ Aeson.object $ catMaybes
352373 [ Just $ "owner" .= _gitHubSource_owner s
353374 , Just $ "repo" .= _gitHubSource_repo s
354− , case _gitHubSource_branch s of
355− Just b -> Just $ "branch" .= b
356− Nothing -> Nothing
357− , if _gitHubSource_private s
358− then Just $ "private" .= True
359− else Nothing
375+ , ("branch" .=) <$> _gitHubSource_branch s
360376 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
361377 , Just $ "sha256" .= _thunkRev_nixSha256 rev
378+ , Just $ "private" .= _gitHubSource_private s
362379 ]
363380 ThunkSource_Git s -> encodePretty' plainGitCfg $ Aeson.object $ catMaybes
364− --TODO: Is this safe? read/show is jank for `URI`
365− [ Just $ "url" .= show (_gitSource_url s)
381+ [ Just $ "url" .= gitUriToText (_gitSource_url s)
366382 , Just $ "rev" .= Ref.toHexString (_thunkRev_commit rev)
367− , Just $ "branch" .= _gitSource_branch s
383+ , ("branch" .=) <$> _gitSource_branch s
368384 , Just $ "sha256" .= _thunkRev_nixSha256 rev
369385 , Just $ "fetchSubmodules" .= _gitSource_fetchSubmodules s
386+ , Just $ "private" .= _gitSource_private s
370387 ]
371388 where
372389 githubCfg = defConfig
@@ -387,59 +404,84 @@ encodeThunkPtrData (ThunkPtr rev src) = case src of
387404 [ "url"
388405 , "rev"
389406 , "sha256"
407+ , "private"
390408 , "fetchSubmodules"
391409 ] <> compare
392410 , confTrailingNewline = True
393411 }
394412
395−createThunk :: MonadIO m => FilePath -> ThunkPtr -> m ()
396−createThunk target thunk = liftIO $ do
397− createDirectoryIfMissing True (target </> ".attr-cache")
398− T.writeFile (target </> "default.nix") (thunkPtrLoader thunk)
399− let
400− jsonFileName = case _thunkPtr_source thunk of
401− ThunkSource_GitHub _ -> "github"
402− ThunkSource_Git _ -> "git"
403− LBS.writeFile (target </> jsonFileName <.> "json") (encodeThunkPtrData thunk)
413+createThunk :: MonadObelisk m => FilePath -> Either ThunkSpec ThunkPtr -> m ()
414+createThunk target ptrInfo =
415+ ifor_ (_thunkSpec_files spec) $ \path -> \case
416+ ThunkFileSpec_FileMatches content -> withReadyPath path $ \p -> liftIO $ T.writeFile p content
417+ ThunkFileSpec_Ptr _ -> case ptrInfo of
418+ Left _ -> pure () -- We can't write the ptr without it
419+ Right ptr -> withReadyPath path $ \p -> liftIO $ LBS.writeFile p (encodeThunkPtrData ptr)
420+ _ -> pure ()
421+ where
422+ spec = either id thunkPtrToSpec ptrInfo
423+ withReadyPath path f = do
424+ let fullPath = target </> path
425+ putLog Debug $ "Writing thunk file " <> T.pack fullPath
426+ liftIO $ createDirectoryIfMissing True $ takeDirectory fullPath
427+ f fullPath
404428
405429createThunkWithLatest :: MonadObelisk m => FilePath -> ThunkSource -> m ()
406430createThunkWithLatest target s = do
407431 rev <- getLatestRev s
408− createThunk target $ ThunkPtr
432+ createThunk target $ Right $ ThunkPtr
409433 { _thunkPtr_source = s
410434 , _thunkPtr_rev = rev
411435 }
412436
413−updateThunkToLatest :: MonadObelisk m => FilePath -> m ()
414−updateThunkToLatest target = withSpinner' ("Updating thunk " <> T.pack target <> " to latest") (pure $ const $ "Thunk " <> T.pack target <> " updated to latest") $ do
415− (overwrite, ptr) <- readThunk target >>= \case
416− Left err -> failWith $ T.pack $ "thunk update: " <> show err
417− Right c -> case c of
418− ThunkData_Packed t -> return (target, t)
419− ThunkData_Checkout _ -> failWith "cannot update an unpacked thunk"
420− let src = _thunkPtr_source ptr
421− rev <- getLatestRev src
422− overwriteThunk overwrite $ ThunkPtr
423− { _thunkPtr_source = src
424− , _thunkPtr_rev = rev
425− }
437+updateThunkToLatest :: MonadObelisk m => ThunkUpdateConfig -> FilePath -> m ()
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
443+ (overwrite, ptr) <- readThunk target >>= \case
444+ Left err -> failWith [i|Thunk update: ${err}|]
445+ Right c -> case c of
446+ ThunkData_Packed _ t -> return (target, t)
447+ ThunkData_Checkout -> failWith "cannot update an unpacked thunk"
448+ let src = _thunkPtr_source ptr
449+ rev <- getLatestRev src
450+ overwriteThunk overwrite $ modifyThunkPtrByConfig thunkConfig $ ThunkPtr
451+ { _thunkPtr_source = src
452+ , _thunkPtr_rev = rev
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
426467
427468-- | All recognized github standalone loaders, ordered from newest to oldest.
428469-- This tool will only ever produce the newest one when it writes a thunk.
429−gitHubStandaloneLoaders :: NonEmpty Text
430−gitHubStandaloneLoaders =
431− gitHubStandaloneLoaderV2 :|
432− [ gitHubStandaloneLoaderV3
433− , gitHubStandaloneLoaderV1
470+gitHubThunkSpecs :: NonEmpty ThunkSpec
471+gitHubThunkSpecs =
472+ gitHubThunkSpecV5 :|
473+ [ gitHubThunkSpecV4
474+ , gitHubThunkSpecV3
475+ , gitHubThunkSpecV2
476+ , gitHubThunkSpecV1
434477 ]
435478
436−gitHubStandaloneLoaderV1 :: Text
437−gitHubStandaloneLoaderV1 = T.unlines
438− [ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
439− ]
479+gitHubThunkSpecV1 :: ThunkSpec
480+gitHubThunkSpecV1 = legacyGitHubThunkSpec "github-v1"
481+ "import ((import <nixpkgs> {}).fetchFromGitHub (builtins.fromJSON (builtins.readFile ./github.json)))"
440482
441−gitHubStandaloneLoaderV2 :: Text
442−gitHubStandaloneLoaderV2 = T.unlines
483+gitHubThunkSpecV2 :: ThunkSpec
484+gitHubThunkSpecV2 = legacyGitHubThunkSpec "github-v2" $ T.unlines
443485 [ "# DO NOT HAND-EDIT THIS FILE" --TODO: Add something about how to get more info on Obelisk, etc.
444486 , "import ((import <nixpkgs> {}).fetchFromGitHub ("
445487 , " let json = builtins.fromJSON (builtins.readFile ./github.json);"
@@ -449,8 +491,8 @@ gitHubStandaloneLoaderV2 = T.unlines
449491 , "))"
450492 ]
451493
452−gitHubStandaloneLoaderV3 :: Text
453−gitHubStandaloneLoaderV3 = T.unlines
494+gitHubThunkSpecV3 :: ThunkSpec
495+gitHubThunkSpecV3 = legacyGitHubThunkSpec "github-v3" $ T.unlines
454496 [ "# DO NOT HAND-EDIT THIS FILE"
455497 , "let"
456498 , " fetch = { private ? false, ... }@args: if private && builtins.hasAttr \"fetchGit\" builtins"
@@ -469,22 +511,62 @@ gitHubStandaloneLoaderV3 = T.unlines
469511 , "in import (fetch (builtins.fromJSON (builtins.readFile ./github.json)))"
470512 ]
471513
472−plainGitStandaloneLoaders :: NonEmpty Text
473−plainGitStandaloneLoaders =
474− plainGitStandaloneLoaderV1 :|
475− [ plainGitStandaloneLoaderV2
514+gitHubThunkSpecV4 :: ThunkSpec
515+gitHubThunkSpecV4 = legacyGitHubThunkSpec "github-v4" $ T.unlines
516+ [ "# DO NOT HAND-EDIT THIS FILE"
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)))"
476524 ]
477525
478−plainGitStandaloneLoaderV1 :: Text
479−plainGitStandaloneLoaderV1 = T.unlines
526+legacyGitHubThunkSpec :: Text -> Text -> ThunkSpec
527+legacyGitHubThunkSpec name loader = ThunkSpec name $ Map.fromList
528+ [ ("default.nix", ThunkFileSpec_FileMatches $ T.strip loader)
529+ , ("github.json" , ThunkFileSpec_Ptr parseGitHubJsonBytes)
530+ , (attrCacheFileName, ThunkFileSpec_AttrCache)
531+ , (".git", ThunkFileSpec_CheckoutIndicator)
532+ ]
533+
534+gitHubThunkSpecV5 :: ThunkSpec
535+gitHubThunkSpecV5 = mkThunkSpec "github-v5" "github.json" parseGitHubJsonBytes [here|
536+# DO NOT HAND-EDIT THIS FILE
537+let fetch = { private ? false, fetchSubmodules ? false, owner, repo, rev, sha256, ... }:
538+ if !fetchSubmodules && !private then builtins.fetchTarball {
539+ url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz"; inherit sha256;
540+ } else (import <nixpkgs> {}).fetchFromGitHub {
541+ inherit owner repo rev sha256 fetchSubmodules private;
542+ };
543+ json = builtins.fromJSON (builtins.readFile ./github.json);
544+in fetch json
545+|]
546+
547+parseGitHubJsonBytes :: LBS.ByteString -> Either String ThunkPtr
548+parseGitHubJsonBytes = parseJsonObject $ parseThunkPtr $ \v ->
549+ ThunkSource_GitHub <$> parseGitHubSource v <|> ThunkSource_Git <$> parseGitSource v
550+
551+gitThunkSpecs :: NonEmpty ThunkSpec
552+gitThunkSpecs =
553+ gitThunkSpecV5 :|
554+ [ gitThunkSpecV4
555+ , gitThunkSpecV3
556+ , gitThunkSpecV2
557+ , gitThunkSpecV1
558+ ]
559+
560+gitThunkSpecV1 :: ThunkSpec
561+gitThunkSpecV1 = legacyGitThunkSpec "git-v1" $ T.unlines
480562 [ "# DO NOT HAND-EDIT THIS FILE"
481563 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
482564 , " assert !fetchSubmodules; (import <nixpkgs> {}).fetchgit { inherit url rev sha256; };"
483565 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
484566 ]
485567
486−plainGitStandaloneLoaderV2 :: Text
487−plainGitStandaloneLoaderV2 = T.unlines
568+gitThunkSpecV2 :: ThunkSpec
569+gitThunkSpecV2 = legacyGitThunkSpec "git-v2" $ T.unlines
488570 [ "# DO NOT HAND-EDIT THIS FILE"
489571 , "let fetchGit = {url, rev, ref ? null, branch ? null, sha256 ? null, fetchSubmodules ? null}:"
490572 , " if builtins.hasAttr \"fetchGit\" builtins"
@@ -493,24 +575,87 @@ plainGitStandaloneLoaderV2 = T.unlines
493575 , "in import (fetchGit (builtins.fromJSON (builtins.readFile ./git.json)))"
494576 ]
495577
496−thunkFileNames :: [FilePath]
497−thunkFileNames = ["default.nix", "github.json", "git.json"]
498−
499−-- | Look for authentication info from the 'hub' command
500−getHubAuth
501− :: Text -- ^ Domain name
502− -> IO (Maybe Auth)
503−getHubAuth domain = do
504− hubConfig <- getXdgDirectory XdgConfig "hub"
505− Yaml.decodeFileEither hubConfig >>= \case
506− Left _ -> return Nothing
507− Right v -> return $ flip parseMaybe v $ \v' -> do
508− Yaml.Array domainConfigs <- v' .: domain --TODO: Determine what multiple domainConfigs means
509− [Yaml.Object domainConfig] <- return $ toList domainConfigs
510− token <- domainConfig .: "oauth_token"
511− return $ OAuth $ encodeUtf8 token
512−
513−--TODO: when checking something out, make a shallow clone
578+-- This loader has a bug because @builtins.fetchGit@ is not given a @ref@
579+-- and will fail to find commits without this because it does shallow clones.
580+gitThunkSpecV3 :: ThunkSpec
581+gitThunkSpecV3 = legacyGitThunkSpec "git-v3" $ T.unlines
582+ [ "# DO NOT HAND-EDIT THIS FILE"
583+ , "let fetch = {url, rev, ref ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
584+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
585+ , " if firstChar == \"/\" then /. + url"
586+ , " else if firstChar == \".\" then ./. + url"
587+ , " else url;"
588+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
589+ , " url = realUrl; inherit rev;"
590+ , " } else (import <nixpkgs> {}).fetchgit {"
591+ , " url = realUrl; inherit rev sha256;"
592+ , " };"
593+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
594+ ]
595+
596+gitThunkSpecV4 :: ThunkSpec
597+gitThunkSpecV4 = legacyGitThunkSpec "git-v4" $ T.unlines
598+ [ "# DO NOT HAND-EDIT THIS FILE"
599+ , "let fetch = {url, rev, branch ? null, sha256 ? null, fetchSubmodules ? false, private ? false, ...}:"
600+ , " let realUrl = let firstChar = builtins.substring 0 1 url; in"
601+ , " if firstChar == \"/\" then /. + url"
602+ , " else if firstChar == \".\" then ./. + url"
603+ , " else url;"
604+ , " in if !fetchSubmodules && private then builtins.fetchGit {"
605+ , " url = realUrl; inherit rev;"
606+ , " ${if branch == null then null else \"ref\"} = branch;"
607+ , " } else (import <nixpkgs> {}).fetchgit {"
608+ , " url = realUrl; inherit rev sha256;"
609+ , " };"
610+ , "in import (fetch (builtins.fromJSON (builtins.readFile ./git.json)))"
611+ ]
612+
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
514659
515660-- | Checks a cache directory to see if there is a fresh symlink
516661-- to the result of building an attribute of a thunk.
@@ -518,44 +663,49 @@ getHubAuth domain = do
518663-- and the result is symlinked into the cache.
519664nixBuildThunkAttrWithCache
520665 :: MonadObelisk m
521− => FilePath
666+ => ThunkSpec
667+ -> FilePath
522668 -- ^ Path to directory containing Thunk
523669 -> String
524670 -- ^ Attribute to build
525− -> m FilePath
671+ -> m (Maybe FilePath)
526672 -- ^ Symlink to cached or built nix output
527673-- WARNING: If the thunk uses an impure reference such as '<nixpkgs>'
528674-- the caching mechanism will fail as it merely measures the modification
529675-- time of the cache link and the expression to build.
530−nixBuildThunkAttrWithCache thunkDir attr = do
531− --NB: Expects thunkDir to be normalised with no trailing path separator.
532− --This should be guaranteed by the command argument parser.
533− let cacheErrHandler e
534− | isDoesNotExistError e = return Nothing -- expected from a cache miss
535− | otherwise = putLog Error (T.pack $ displayException e) >> return Nothing
536− cacheDir = thunkDir </> ".attr-cache"
537− cachePath = cacheDir </> attr <.> "out"
676+nixBuildThunkAttrWithCache thunkSpec thunkDir attr = do
538677 latestChange <- liftIO $ do
539− createDirectoryIfMissing False cacheDir
540− let getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
541− maximum . catMaybes <$> mapM (getModificationTimeMaybe . (thunkDir </>)) thunkFileNames
542− cacheHit <- handle cacheErrHandler $ do
543− cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
544− return $ if latestChange <= cacheTime
545− then Just cachePath
546− else Nothing
547− case cacheHit of
548− Just c -> return c
549− Nothing -> do
550− putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
551− _ <- nixBuild $ def
552− { _nixBuildConfig_target = Target
553− { _target_path = thunkDir
554− , _target_attr = Just attr
555− }
556− , _nixBuildConfig_outLink = OutLink_IndirectRoot cachePath
557− }
558− return cachePath
678+ let
679+ getModificationTimeMaybe = fmap rightToMaybe . try @IOError . getModificationTime
680+ thunkFileNames = Map.keys $ _thunkSpec_files thunkSpec
681+ maximum . catMaybes <$> traverse (getModificationTimeMaybe . (thunkDir </>)) thunkFileNames
682+
683+ let cachePaths' = nonEmpty $ Map.keys $ Map.filter (\case ThunkFileSpec_AttrCache -> True; _ -> False) $
684+ _thunkSpec_files thunkSpec
685+ for cachePaths' $ \cachePaths ->
686+ fmap NonEmpty.head $ for cachePaths $ \cacheDir -> do
687+ let
688+ cachePath = thunkDir </> cacheDir </> attr <.> "out"
689+ cacheErrHandler e
690+ | isDoesNotExistError e = pure Nothing -- expected from a cache miss
691+ | otherwise = Nothing <$ putLog Error (T.pack $ displayException e)
692+ cacheHit <- handle cacheErrHandler $ do
693+ cacheTime <- liftIO $ posixSecondsToUTCTime . realToFrac . modificationTime <$> getSymbolicLinkStatus cachePath
694+ pure $ if latestChange <= cacheTime
695+ then Just cachePath
696+ else Nothing
697+ case cacheHit of
698+ Just c -> pure c
699+ Nothing -> do
700+ putLog Warning $ T.pack $ mconcat [thunkDir, ": ", attr, " not cached, building ..."]
701+ liftIO $ createDirectoryIfMissing True (takeDirectory cachePath)
702+ (cachePath <$) $ nixCmd $ NixCmd_Build $ def
703+ & nixBuildConfig_outLink .~ OutLink_IndirectRoot cachePath
704+ & nixCmdConfig_target .~ Target
705+ { _target_path = Just thunkDir
706+ , _target_attr = Just attr
707+ , _target_expr = Nothing
708+ }
559709
560710-- | Build a nix attribute, and cache the result if possible
561711nixBuildAttrWithCache
@@ -566,17 +716,19 @@ nixBuildAttrWithCache
566716 -- ^ Attribute to build
567717 -> m FilePath
568718 -- ^ Symlink to cached or built nix output
569−nixBuildAttrWithCache exprPath attr = do
570− readThunk exprPath >>= \case
571− -- Only packed thunks are cached. in particular, checkouts are not
572− Right (ThunkData_Packed _) -> nixBuildThunkAttrWithCache exprPath attr
573− _ -> nixBuild $ def
574− { _nixBuildConfig_target = Target
575− { _target_path = exprPath
719+nixBuildAttrWithCache exprPath attr = readThunk exprPath >>= \case
720+ -- Only packed thunks are cached. In particular, checkouts are not.
721+ Right (ThunkData_Packed spec _) ->
722+ maybe build pure =<< nixBuildThunkAttrWithCache spec exprPath attr
723+ _ -> build
724+ where
725+ build = nixCmd $ NixCmd_Build $ def
726+ & nixBuildConfig_outLink .~ OutLink_None
727+ & nixCmdConfig_target .~ Target
728+ { _target_path = Just exprPath
576729 , _target_attr = Just attr
730+ , _target_expr = Nothing
577731 }
578− , _nixBuildConfig_outLink = OutLink_None
579− }
580732
581733-- | Safely update thunk using a custom action
582734--
@@ -588,223 +740,442 @@ updateThunk p f = withSystemTempDirectory "obelisk-thunkptr-" $ \tmpDir -> do
588740 p' <- copyThunkToTmp tmpDir p
589741 unpackThunk' True p'
590742 result <- f p'
591− updateThunkFromTmp p' "origin" -- TODO: stop hardcoding remote
743+ updateThunkFromTmp p'
592744 return result
593745 where
594746 copyThunkToTmp tmpDir thunkDir = readThunk thunkDir >>= \case
595747 Left err -> failWith $ "withThunkUnpacked: " <> T.pack (show err)
596− Right (ThunkData_Packed _) -> do
748+ Right ThunkData_Packed{} -> do
597749 let tmpThunk = tmpDir </> "thunk"
598750 callProcessAndLogOutput (Notice, Error) $
599− proc "cp" ["-r", "-T", thunkDir, tmpThunk]
751+ proc cp ["-r", "-T", thunkDir, tmpThunk]
600752 return tmpThunk
601− Right _ -> failWith $ "Thunk is not packed"
602− updateThunkFromTmp p' remote = do
603− packThunk' True p' remote
753+ Right _ -> failWith "Thunk is not packed"
754+ updateThunkFromTmp p' = do
755+ _ <- packThunk' True (ThunkPackConfig False (ThunkConfig Nothing)) p'
604756 callProcessAndLogOutput (Notice, Error) $
605− proc "cp" ["-r", "-T", p', p]
757+ proc cp ["-r", "-T", p', p]
606758
607759finalMsg :: Bool -> (a -> Text) -> Maybe (a -> Text)
608760finalMsg noTrail s = if noTrail then Nothing else Just s
609761
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+
610776unpackThunk :: MonadObelisk m => FilePath -> m ()
611777unpackThunk = unpackThunk' False
612778
613779unpackThunk' :: MonadObelisk m => Bool -> FilePath -> m ()
614−unpackThunk' noTrail thunkDir = readThunk thunkDir >>= \case
615− Left err -> failWith $ "thunk unpack: " <> T.pack (show err)
780+unpackThunk' noTrail thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
781+ Left err -> failWith [i|Invalid thunk at ${thunkDir}: ${err}|]
616782 --TODO: Overwrite option that rechecks out thunk; force option to do so even if working directory is dirty
617− Right (ThunkData_Checkout _) -> failWith "thunk unpack: thunk is already unpacked"
618− Right (ThunkData_Packed tptr) -> do
783+ Right ThunkData_Checkout -> failWith [i|Thunk at ${thunkDir} is already unpacked|]
784+ Right (ThunkData_Packed _ tptr) -> do
619785 let (thunkParent, thunkName) = splitFileName thunkDir
620− withTempDirectory thunkParent thunkName $ \tmpRepo -> do
621− let obGitDir = tmpRepo </> ".git" </> "obelisk"
622− case _thunkPtr_source tptr of
623− ThunkSource_GitHub s -> do
624− mauth <- liftIO $ getHubAuth "github.com"
625− repoResult <- liftIO $ executeRequestMaybe mauth $ repositoryR (_gitHubSource_owner s) (_gitHubSource_repo s)
626− githubURI <- either (liftIO . throwIO) (return . repoSshUrl) repoResult >>= \case
627− Nothing -> failWith "Cannot determine clone URI for thunk source"
628− Just c -> return $ T.unpack $ getUrl c
629−
630− withSpinner' ("Fetching thunk " <> T.pack thunkDir)
631− ( finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkDir) $ do
632− callProcessAndLogOutput (Debug, Debug) $
633− proc "hub" ["clone", "-n", githubURI, tmpRepo]
634− --If this directory already exists then something is weird and we should fail
635− liftIO $ createDirectory obGitDir
636− callProcessAndLogOutput (Debug, Error) $
637− proc "cp" ["-r", "-T", thunkDir </> ".", obGitDir </> "orig-thunk"]
638−
639− -- Checkout
640− putLog Debug $ "Checking out " <> T.pack (show $ maybe "" untagName $ _gitHubSource_branch s)
641− callProcessAndLogOutput (Debug, Debug) $
642− proc "hub" $ concat
643− [ ["-C", tmpRepo]
644− , pure "checkout"
645− , maybe [] (\n -> ["-B", T.unpack (untagName n)]) (_gitHubSource_branch s)
646− , pure $ Ref.toHexString $ _thunkRev_commit $ _thunkPtr_rev tptr
647− ]
648− -- Set upstream branch
649− forM_ (_gitHubSource_branch s) $ \branch ->
650− callProcessAndLogOutput (Debug, Error) $
651− proc "hub" ["-C", tmpRepo, "branch", "-u", "origin/" <> T.unpack (untagName branch)]
652− callProcessAndLogOutput (Notice, Error) $ proc "rm" ["-r", thunkDir]
653− callProcessAndLogOutput (Notice, Error) $ proc "mv" ["-T", tmpRepo, thunkDir]
654−
655− ThunkSource_Git s -> do
656− withSpinner' ("Fetching thunk " <> T.pack thunkName)
657− (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
658− let git = callProcessAndLogOutput (Notice, Notice) . gitProc tmpRepo
659− git ["clone", if _gitSource_fetchSubmodules s then "--recursive" else "", show (_gitSource_url s)]
660− git ["reset", "--hard", Ref.toHexString $ _thunkRev_commit $ _thunkPtr_rev tptr]
661− when (_gitSource_fetchSubmodules s) $
662− git ["submodule", "update", "--recursive", "--init"]
663− git ["branch", "-u", "origin/" <> T.unpack (untagName $ _gitSource_branch s)]
664−
665− liftIO $ createDirectory obGitDir
666− callProcessAndLogOutput (Notice, Error) $
667− proc "cp" ["-r", "-T", thunkDir </> ".", obGitDir </> "orig-thunk"]
668− callProcessAndLogOutput (Notice, Error) $
669− proc "rm" ["-r", thunkDir]
670− callProcessAndLogOutput (Notice, Error) $
671− proc "mv" ["-T", tmpRepo, thunkDir]
672−
673−--TODO: add force mode to pack even if changes are present
786+ withTempDirectory thunkParent thunkName $ \tmpThunk -> do
787+ let
788+ gitSrc = thunkSourceToGitSource $ _thunkPtr_source tptr
789+ newSpec = case _thunkPtr_source tptr of
790+ ThunkSource_GitHub _ -> NonEmpty.head gitHubThunkSpecs
791+ ThunkSource_Git _ -> NonEmpty.head gitThunkSpecs
792+ withSpinner' ("Fetching thunk " <> T.pack thunkName)
793+ (finalMsg noTrail $ const $ "Fetched thunk " <> T.pack thunkName) $ do
794+ let unpackedPath = tmpThunk </> unpackedDirName
795+ gitCloneForThunkUnpack gitSrc (_thunkRev_commit $ _thunkPtr_rev tptr) unpackedPath
796+
797+ let normalizeMore = dropTrailingPathSeparator . normalise
798+ when (normalizeMore unpackedPath /= normalizeMore tmpThunk) $ -- Only write meta data if the checkout is not inplace
799+ createThunk tmpThunk $ Left newSpec
800+
801+ liftIO $ do
802+ removePathForcibly thunkDir
803+ renameDirectory tmpThunk thunkDir
804+
805+gitCloneForThunkUnpack
806+ :: MonadObelisk m
807+ => GitSource -- ^ Git source to use
808+ -> Ref hash -- ^ Commit hash to reset to
809+ -> FilePath -- ^ Directory to clone into
810+ -> m ()
811+gitCloneForThunkUnpack gitSrc commit dir = do
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"]
821+
674822--TODO: add a rollback mode to pack to the original thunk
675−packThunk :: MonadObelisk m => FilePath -> Text -> m ()
823+packThunk :: MonadObelisk m => ThunkPackConfig -> FilePath -> m ThunkPtr
676824packThunk = packThunk' False
677825
678−packThunk' :: MonadObelisk m => Bool -> FilePath -> Text -> m ()
679−packThunk' noTrail thunkDir upstream = readThunk thunkDir >>= \case
680− Left err -> failWith $ T.pack $ "thunk pack: " <> show err
681− Right (ThunkData_Packed _) -> failWith "pack: thunk is already packed"
682− Right (ThunkData_Checkout _) -> do
683− withSpinner' ("Packing thunk " <> T.pack thunkDir)
684− (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $ do
685− thunkPtr <- getThunkPtr thunkDir upstream
686− callProcessAndLogOutput (Debug, Error) $ proc "rm" ["-rf", thunkDir]
687− liftIO $ createThunk thunkDir thunkPtr
688−
689−getThunkPtr :: MonadObelisk m => FilePath -> Text -> m ThunkPtr
690−getThunkPtr = getThunkPtr' True
691−
692−getThunkPtr' :: MonadObelisk m => Bool -> FilePath -> Text -> m ThunkPtr
693−getThunkPtr' checkClean thunkDir upstream = do
694− when checkClean $ ensureCleanGitRepo thunkDir True $
695− "thunk pack: thunk checkout contains unsaved modifications"
696−
697− -- Check whether there are any stashes
826+packThunk' :: MonadObelisk m => Bool -> ThunkPackConfig -> FilePath -> m ThunkPtr
827+packThunk' noTrail (ThunkPackConfig force thunkConfig) thunkDir = checkThunkDirectory thunkDir *> readThunk thunkDir >>= \case
828+ Right ThunkData_Packed{} -> failWith [i|Thunk at ${thunkDir} is is already packed|]
829+ _ -> withSpinner'
830+ ("Packing thunk " <> T.pack thunkDir)
831+ (finalMsg noTrail $ const $ "Packed thunk " <> T.pack thunkDir) $
832+ do
833+ let checkClean = if force then CheckClean_NoCheck else CheckClean_FullCheck
834+ thunkPtr <- modifyThunkPtrByConfig thunkConfig <$> getThunkPtr checkClean thunkDir (_thunkConfig_private thunkConfig)
835+ liftIO $ removePathForcibly thunkDir
836+ createThunk thunkDir $ Right thunkPtr
837+ pure thunkPtr
838+
839+modifyThunkPtrByConfig :: ThunkConfig -> ThunkPtr -> ThunkPtr
840+modifyThunkPtrByConfig (ThunkConfig markPrivate') ptr = case markPrivate' of
841+ Nothing -> ptr
842+ Just markPrivate -> ptr { _thunkPtr_source = case _thunkPtr_source ptr of
843+ ThunkSource_Git s -> ThunkSource_Git $ s { _gitSource_private = markPrivate }
844+ ThunkSource_GitHub s -> ThunkSource_GitHub $ s { _gitHubSource_private = markPrivate }
845+ }
846+
847+data CheckClean
848+ = CheckClean_FullCheck
849+ -- ^ Check that the repo is clean, including .gitignored files
850+ | CheckClean_NotIgnored
851+ -- ^ Check that the repo is clean, not including .gitignored files
852+ | CheckClean_NoCheck
853+ -- ^ Don't check that the repo is clean
854+
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
869+ "thunk pack: thunk checkout contains unsaved modifications"
870+
871+ -- Check whether there are any stashes
872+ when checkClean $ do
698873 stashOutput <- readGitProcess thunkDir ["stash", "list"]
699− when checkClean $ case T.null stashOutput of
700− False -> do
701− failWith $ T.unlines $
702− [ "thunk pack: thunk checkout has stashes"
703− , "git stash list:"
704− ] ++ T.lines stashOutput
705− True -> return ()
706−
707− --Check whether all local heads are pushed
708− repoHeads <- T.lines <$> readGitProcess thunkDir ["for-each-ref", "--format=%(refname:short)", "refs/heads/"]
709− remotes <- T.lines <$> readGitProcess thunkDir ["remote"]
710− --Check that the upstream specified actually exists
711− case L.find (== upstream) remotes of
712− Nothing -> failWith $ "thunk pack: upstream " <> upstream <> " does not exist. Available upstreams are " <> T.intercalate ", " remotes
713− Just _ -> return ()
714− -- iterate over cartesian product
715− when checkClean $ forM_ repoHeads $ \hd -> do
716− [localRev] <- T.lines <$> readGitProcess thunkDir ["rev-parse", T.unpack hd]
717− forM_ remotes $ \rm -> do
718− --TODO: The error you get if a branch isn't pushed anywhere could be made more user friendly
719− [remoteMergeRev] <- fmap T.lines $ readGitProcess thunkDir
720− ["merge-base", T.unpack localRev, "remotes/" <> T.unpack rm <> "/" <> T.unpack hd]
721− case remoteMergeRev == localRev of
722− False -> failWith $ mconcat [ "thunk unpack: branch ", hd, " has not been pushed to ", rm ]
723− True -> return ()
724−
725− --We assume it's safe to pack the thunk at this point
726− [remoteUri'] <- fmap T.lines $ readGitProcess thunkDir ["config", "--get", "remote." <> T.unpack upstream <> ".url"]
727−
728− let uriParseFailure = "Could not identify git remote: " <> remoteUri'
729− mRemoteUri = parseGitUri remoteUri'
730− case mRemoteUri of
731− Nothing -> failWith uriParseFailure
732− Just remoteUri -> do
733− refs <- fmap (map (refsToTuples . T.words) . T.lines) $ readGitProcess thunkDir ["show-ref", "--head"]
734− -- safe because exactly one hash is associated with HEAD
735− let Just currentHead = fst <$> L.find ((== "HEAD") . snd) refs
736− remoteHeads = Map.fromList $ catMaybes $ fmap
737− (\(x,y) -> (,) x <$> T.stripPrefix ("refs/remotes/" <> upstream <> "/") y)
738− refs
739− localHeads = Map.fromList $ catMaybes $ fmap
740− (\(x,y) -> (,) x <$> T.stripPrefix "refs/heads/" y)
741− refs
742− currentUpstreamBranch = Map.lookup currentHead remoteHeads
743− <|> Map.lookup currentHead localHeads
744− if isGithubThunk remoteUri
745− then githubThunkPtr remoteUri currentHead currentUpstreamBranch
746− else gitThunkPtr remoteUri currentHead currentUpstreamBranch
747− where
748− refsToTuples [x, y] = (x, y)
749− refsToTuples x = error $ "thunk pack: cannot parse ref " <> show x
750− isGithubThunk u
751− | Just uriAuth <- uriAuthority u
752− = case uriScheme u of
753− "ssh:" -> uriAuth == URIAuth "git@" "github.com" ""
754− s -> s `L.elem` [ "git:", "https:", "http:" ] -- "http:" just redirects to "https:"
755− && uriRegName uriAuth == "github.com"
756− | otherwise = False
757− githubThunkPtr u commit' branch' = do
758− ["/", owner', repo'] <- return $ splitDirectories (uriPath u)
759− let owner = N (T.pack owner')
760− dropGitExtension r = fromMaybe r $ T.stripSuffix ".git" r
761− repo = N $ dropGitExtension $ T.pack repo'
762− commit = N commit'
763− branch = N <$> branch'
764− mauth <- liftIO $ getHubAuth "github.com"
765− repoResult <- liftIO $ executeRequestMaybe mauth $ repositoryR owner repo
766− repoIsPrivate <- either (liftIO . throwIO) (return . repoPrivate) repoResult
767− archiveResult <- liftIO $ executeRequestMaybe mauth $
768− archiveForR owner repo ArchiveFormatTarball (Just (untagName commit))
769− archiveUri <- either (liftIO . throwIO) return archiveResult
770− hash <- getNixSha256ForUriUnpacked archiveUri
771− return $ ThunkPtr
772− { _thunkPtr_rev = ThunkRev
773− { _thunkRev_commit = commitNameToRef commit
774− , _thunkRev_nixSha256 = hash
775− }
776− , _thunkPtr_source = ThunkSource_GitHub $ GitHubSource
777− { _gitHubSource_owner = owner
778− , _gitHubSource_repo = repo
779− , _gitHubSource_branch = branch
780− , _gitHubSource_private = repoIsPrivate
874+ unless (T.null stashOutput) $
875+ failWith $ T.unlines $
876+ [ "thunk pack: thunk checkout has stashes"
877+ , "git stash list:"
878+ ] ++ T.lines stashOutput
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)
891+
892+ -- Get information on all branches and their (optional) designated upstream
893+ -- correspondents
894+ headDump :: [Text] <- T.lines <$> readGitProcess thunkDir
895+ [ "for-each-ref"
896+ , "--format=%(refname:short) %(upstream:short) %(upstream:remotename)"
897+ , "refs/heads/"
898+ ]
899+
900+ (headInfo :: Map Text (Maybe (Text, Text)))
901+ <- fmap Map.fromList $ forM headDump $ \line -> do
902+ (branch : restOfLine) <- pure $ T.words line
903+ mUpstream <- case restOfLine of
904+ [] -> pure Nothing
905+ [u, r] -> pure $ Just (u, r)
906+ (_:_) -> failWith "git for-each-ref invalid output"
907+ pure (branch, mUpstream)
908+
909+ putLog Debug $ "branches: " <> T.pack (show headInfo)
910+
911+ let errorMap :: Map Text ()
912+ headUpstream :: Map Text (Text, Text)
913+ (errorMap, headUpstream) = flip Map.mapEither headInfo $ \case
914+ Nothing -> Left ()
915+ Just b -> Right b
916+
917+ putLog Debug $ "branches with upstream branch set: " <> T.pack (show headUpstream)
918+
919+ -- Check that every branch has a remote equivalent
920+ when checkClean $ do
921+ let untrackedBranches = Map.keys errorMap
922+ when (not $ L.null untrackedBranches) $ failWith $ T.unlines $
923+ [ "thunk pack: Certain branches in the thunk have no upstream branch \
924+ \set. This means we don't know to check whether all your work is \
925+ \saved. The offending branches are:"
926+ , ""
927+ , T.unwords untrackedBranches
928+ , ""
929+ , "To fix this, you probably want to do:"
930+ , ""
931+ ] ++
932+ ((\branch -> "git push -u origin " <> branch) <$> untrackedBranches) ++
933+ [ ""
934+ , "These will push the branches to the default remote under the same \
935+ \name, and (thanks to the `-u`) remember that choice so you don't \
936+ \get this error again."
937+ ]
938+
939+ -- loosely by https://stackoverflow.com/questions/7773939/show-git-ahead-and-behind-info-for-all-branches-including-remotes
940+ stats <- ifor headUpstream $ \branch (upstream, _remote) -> do
941+ (stat :: [Text]) <- T.lines <$> readGitProcess thunkDir
942+ [ "rev-list", "--left-right"
943+ , T.unpack branch <> "..." <> T.unpack upstream
944+ ]
945+ let ahead = length $ [ () | Just ('<', _) <- T.uncons <$> stat ]
946+ behind = length $ [ () | Just ('>', _) <- T.uncons <$> stat ]
947+ pure (upstream, (ahead, behind))
948+
949+ -- Those branches which have commits ahead of, i.e. not on, the upstream
950+ -- branch. Purely being behind is fine.
951+ let nonGood = Map.filter ((/= 0) . fst . snd) stats
952+
953+ when (not $ Map.null nonGood) $ failWith $ T.unlines $
954+ [ "thunk pack: Certain branches in the thunk have commits not yet pushed upstream:"
955+ , ""
956+ ] ++
957+ flip map (Map.toList nonGood) (\(branch, (upstream, (ahead, behind))) -> mconcat
958+ [" ", branch, " ahead: ", T.pack (show ahead), " behind: ", T.pack (show behind), " remote branch ", upstream]) ++
959+ [ ""
960+ , "Please push these upstream and try again. (Or just fetch, if they are somehow \
961+ \pushed but this repo's remote tracking branches don't know it.)"
962+ ]
963+
964+ when checkClean $ do
965+ -- We assume it's safe to pack the thunk at this point
966+ putLog Informational "All changes safe in git remotes. OK to pack thunk."
967+
968+ let remote = maybe "origin" snd $ flip Map.lookup headUpstream =<< mCurrentBranch
969+
970+ [remoteUri'] <- fmap T.lines $ readGitProcess thunkDir
971+ [ "config"
972+ , "--get"
973+ , "remote." <> T.unpack remote <> ".url"
974+ ]
975+
976+ remoteUri <- case parseGitUri remoteUri' of
977+ Nothing -> failWith $ "Could not identify git remote: " <> remoteUri'
978+ Just uri -> pure uri
979+ uriThunkPtr remoteUri mPrivate mCurrentBranch mCurrentCommit
980+
981+-- | Get the latest revision available from the given source
982+getLatestRev :: MonadObelisk m => ThunkSource -> m ThunkRev
983+getLatestRev os = do
984+ let gitS = thunkSourceToGitSource os
985+ (_, commit) <- gitGetCommitBranch (_gitSource_url gitS) (untagName <$> _gitSource_branch gitS)
986+ case os of
987+ ThunkSource_GitHub s -> githubThunkRev s commit
988+ ThunkSource_Git s -> gitThunkRev s commit
989+
990+-- | Convert a URI to a thunk
991+--
992+-- If the URL is a github URL, we try to just download an archive for
993+-- performance. If that doesn't work (e.g. authentication issue), we fall back
994+-- on just doing things the normal way for git repos in general, and save it as
995+-- a regular git thunk.
996+uriThunkPtr :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> Maybe Text -> m ThunkPtr
997+uriThunkPtr uri mPrivate mbranch mcommit = do
998+ commit <- case mcommit of
999+ Nothing -> gitGetCommitBranch uri mbranch >>= return . snd
1000+ (Just c) -> return c
1001+ (src, rev) <- uriToThunkSource uri mPrivate mbranch >>= \case
1002+ ThunkSource_GitHub s -> do
1003+ rev <- runExceptT $ githubThunkRev s commit
1004+ case rev of
1005+ Right r -> pure (ThunkSource_GitHub s, r)
1006+ Left e -> do
1007+ putLog Warning "\
1008+\Failed to fetch archive from GitHub. This is probably a private repo. \
1009+\Falling back on normal fetchgit. Original failure:"
1010+ errorToWarning e
1011+ let s' = forgetGithub True s
1012+ (,) (ThunkSource_Git s') <$> gitThunkRev s' commit
1013+ ThunkSource_Git s -> (,) (ThunkSource_Git s) <$> gitThunkRev s commit
1014+ pure $ ThunkPtr
1015+ { _thunkPtr_rev = rev
1016+ , _thunkPtr_source = src
1017+ }
1018+
1019+-- | N.B. Cannot infer all fields.
1020+--
1021+-- If the thunk is a GitHub thunk and fails, we do *not* fall back like with
1022+-- `uriThunkPtr`. Unlike a plain URL, a thunk src explicitly states which method
1023+-- should be employed, and so we respect that.
1024+uriToThunkSource :: MonadObelisk m => GitUri -> Maybe Bool -> Maybe Text -> m ThunkSource
1025+uriToThunkSource (GitUri u) mPrivate
1026+ | Right uriAuth <- URI.uriAuthority u
1027+ , Just scheme <- URI.unRText <$> URI.uriScheme u
1028+ , case scheme of
1029+ "ssh" -> uriAuth == URI.Authority
1030+ { URI.authUserInfo = Just $ URI.UserInfo (fromRight' $ URI.mkUsername "git") Nothing
1031+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
1032+ , URI.authPort = Nothing
7811033 }
782− }
783− gitThunkPtr u commit branch' = do
784− let protocols = ["https:", "ssh:", "git:"]
785− unless (T.toLower (T.pack $ uriScheme u) `elem` protocols) $
786− failWith $ "thunk pack: obelisk currently only supports "
787− <> T.intercalate ", " protocols <> " protocols for non-GitHub remotes"
788− hash <- nixPrefetchGit u commit False
789− branch <- case branch' of
790− Nothing -> failWith "thunk pack: git thunks must track a branch"
791− Just b -> pure $ N b
792− pure $ ThunkPtr
793− { _thunkPtr_rev = ThunkRev
794− { _thunkRev_commit = commitNameToRef (N commit)
795− , _thunkRev_nixSha256 = hash
1034+ s -> s `L.elem` [ "git", "https", "http" ] -- "http:" just redirects to "https:"
1035+ && URI.unRText (URI.authHost uriAuth) == "github.com"
1036+ , Just (_, owner :| [repoish]) <- URI.uriPath u
1037+ = \mbranch -> do
1038+ isPrivate <- getIsPrivate
1039+ pure $ ThunkSource_GitHub $ GitHubSource
1040+ { _gitHubSource_owner = N $ URI.unRText owner
1041+ , _gitHubSource_repo = N $ let
1042+ repoish' = URI.unRText repoish
1043+ in fromMaybe repoish' $ T.stripSuffix ".git" repoish'
1044+ , _gitHubSource_branch = N <$> mbranch
1045+ , _gitHubSource_private = isPrivate
7961046 }
797− , _thunkPtr_source = ThunkSource_Git $ GitSource
798− { _gitSource_url = u
799− , _gitSource_branch = branch
1047+
1048+ | otherwise = \mbranch -> do
1049+ isPrivate <- getIsPrivate
1050+ pure $ ThunkSource_Git $ GitSource
1051+ { _gitSource_url = GitUri u
1052+ , _gitSource_branch = N <$> mbranch
8001053 , _gitSource_fetchSubmodules = False -- TODO: How do we determine if this should be true?
1054+ , _gitSource_private = isPrivate
8011055 }
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
8021083 }
8031084
804−parseGitUri :: Text -> Maybe URI
805−parseGitUri x = parseURIReference (T.unpack x) <|> parseSshShorthand x
1085+-- Funny signature indicates no effects depend on the optional branch name.
1086+githubThunkRev
1087+ :: forall m
1088+ . MonadObelisk m
1089+ => GitHubSource
1090+ -> Text
1091+ -> m ThunkRev
1092+githubThunkRev s commit = do
1093+ owner <- forcePP $ _gitHubSource_owner s
1094+ repo <- forcePP $ _gitHubSource_repo s
1095+ revTarball <- URI.mkPathPiece $ commit <> ".tar.gz"
1096+ let archiveUri = GitUri $ URI.URI
1097+ { URI.uriScheme = Just $ fromRight' $ URI.mkScheme "https"
1098+ , URI.uriAuthority = Right $ URI.Authority
1099+ { URI.authUserInfo = Nothing
1100+ , URI.authHost = fromRight' $ URI.mkHost "github.com"
1101+ , URI.authPort = Nothing
1102+ }
1103+ , URI.uriPath = Just ( False
1104+ , owner :| [ repo, fromRight' $ URI.mkPathPiece "archive", revTarball ]
1105+ )
1106+ , URI.uriQuery = []
1107+ , URI.uriFragment = Nothing
1108+ }
1109+ hash <- getNixSha256ForUriUnpacked archiveUri
1110+ putLog Debug $ "Nix sha256 is " <> hash
1111+ return $ ThunkRev
1112+ { _thunkRev_commit = commitNameToRef $ N commit
1113+ , _thunkRev_nixSha256 = hash
1114+ }
1115+ where
1116+ forcePP :: Name entity -> m (URI.RText 'URI.PathPiece)
1117+ forcePP = URI.mkPathPiece . untagName
1118+
1119+gitThunkRev
1120+ :: MonadObelisk m
1121+ => GitSource
1122+ -> Text
1123+ -> m ThunkRev
1124+gitThunkRev s commit = do
1125+ let u = _gitSource_url s
1126+ protocols = ["file", "https", "ssh", "git"]
1127+ scheme = maybe "file" URI.unRText $ URI.uriScheme $ (\(GitUri x) -> x) u
1128+ unless (T.toLower scheme `elem` protocols) $
1129+ failWith $ "obelisk currently only supports "
1130+ <> T.intercalate ", " protocols <> " protocols for plain Git remotes"
1131+ hash <- nixPrefetchGit u commit $ _gitSource_fetchSubmodules s
1132+ putLog Informational $ "Nix sha256 is " <> hash
1133+ pure $ ThunkRev
1134+ { _thunkRev_commit = commitNameToRef (N commit)
1135+ , _thunkRev_nixSha256 = hash
1136+ }
1137+
1138+-- | Given the URI to a git remote, and an optional branch name, return the name
1139+-- of the branch along with the hash of the commit at tip of that branch.
1140+--
1141+-- If the branch name is passed in, it is returned exactly as-is. If it is not
1142+-- passed it, the default branch of the repo is used instead.
1143+
1144+gitGetCommitBranch
1145+ :: MonadObelisk m => GitUri -> Maybe Text -> m (Text, CommitId)
1146+gitGetCommitBranch uri mbranch = withExitFailMessage ("Failure for git remote " <> uriMsg) $ do
1147+ (_, bothMaps) <- gitLsRemote
1148+ (T.unpack $ gitUriToText uri)
1149+ (GitRef_Branch <$> mbranch)
1150+ Nothing
1151+ branch <- case mbranch of
1152+ Nothing -> withExitFailMessage "Failed to find default branch" $ do
1153+ b <- rethrowE $ gitLookupDefaultBranch bothMaps
1154+ putLog Debug $ "Default branch for remote repo " <> uriMsg <> " is " <> b
1155+ pure b
1156+ Just b -> pure b
1157+ commit <- rethrowE $ gitLookupCommitForRef bothMaps (GitRef_Branch branch)
1158+ putLog Informational $ "Latest commit in branch " <> branch
1159+ <> " from remote repo " <> uriMsg
1160+ <> " is " <> commit
1161+ pure (branch, commit)
1162+ where
1163+ rethrowE = either failWith pure
1164+ uriMsg = gitUriToText uri
1165+
1166+parseGitUri :: Text -> Maybe GitUri
1167+parseGitUri x = GitUri <$> (parseFileURI x <|> parseAbsoluteURI x <|> parseSshShorthand x)
1168+
1169+parseFileURI :: Text -> Maybe URI.URI
1170+parseFileURI uri = if "/" `T.isPrefixOf` uri then parseAbsoluteURI ("file://" <> uri) else Nothing
1171+
1172+parseAbsoluteURI :: Text -> Maybe URI.URI
1173+parseAbsoluteURI uri = do
1174+ parsedUri <- URI.mkURI uri
1175+ guard $ URI.isPathAbsolute parsedUri
1176+ pure parsedUri
8061177
807−parseSshShorthand :: Text -> Maybe URI
1178+parseSshShorthand :: Text -> Maybe URI.URI
8081179parseSshShorthand uri = do
8091180 -- This is what git does to check that the remote
8101181 -- is not a local file path when parsing shorthand.
@@ -817,4 +1188,4 @@ parseSshShorthand uri = do
8171188 -- This check is used to disambiguate a filepath containing a colon from shorthand
8181189 guard $ isNothing (T.findIndex (=='/') authAndHostname)
8191190 && not (T.null colonAndPath)
820− parseURI $ T.unpack 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−116
@@ -1,116 +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 $ T.pack $ "Ignored: " <> show (length ignored) <> " files."
106− putLog Debug $ T.pack $ "Untracked files:\n" <> unlines untracked
107− withSpinnerNoTrail "Removing untracked and ignored files" $ do
108− forM_ (fmap (dir </>) $ 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 lines $ readProcessAndLogStderr Error $
115− (proc "git" $ ["ls-files", "."] <> opts) { cwd = Just pwd }
116−
lib/command/src/Obelisk/Command/Utils.hs+197−18
@@ -1,22 +1,98 @@
11{-# LANGUAGE FlexibleContexts #-}
22{-# LANGUAGE LambdaCase #-}
3+{-# LANGUAGE MultiWayIf #-}
4+{-# LANGUAGE ScopedTypeVariables #-}
35{-# LANGUAGE OverloadedStrings #-}
6+{-# LANGUAGE PatternGuards #-}
7+{-# LANGUAGE TemplateHaskell #-}
48module Obelisk.Command.Utils where
59
6−import Control.Applicative (liftA2)
10+import Control.Applicative hiding (many)
11+import Control.Monad.Except
712import Data.Bool (bool)
13+import Data.Bifunctor
14+import Data.Char
15+import Data.Either
16+import Data.List (isInfixOf)
17+import Data.Map (Map)
18+import qualified Data.Map as M
19+import Data.Maybe (maybeToList)
820import Data.Semigroup ((<>))
921import Data.Text (Text)
1022import qualified Data.Text as T
11−import System.Directory (canonicalizePath)
12−import System.Environment (getExecutablePath)
13−import qualified System.Process as P
23+import Data.Void (Void)
24+import System.Exit (ExitCode)
25+import System.Which (staticWhich)
26+import qualified Text.Megaparsec.Char.Lexer as ML
27+import Text.Megaparsec as MP
28+import Text.Megaparsec.Char as MP
1429
1530import Obelisk.App (MonadObelisk)
1631import Obelisk.CliApp
1732
18−getObeliskExe :: IO FilePath
19−getObeliskExe = getExecutablePath >>= canonicalizePath
33+cp :: FilePath
34+cp = $(staticWhich "cp")
35+
36+mvPath :: FilePath
37+mvPath = $(staticWhich "mv")
38+
39+rmPath :: FilePath
40+rmPath = $(staticWhich "rm")
41+
42+ghcidExePath :: FilePath
43+ghcidExePath = $(staticWhich "ghcid")
44+
45+findExePath :: FilePath
46+findExePath = $(staticWhich "find")
47+
48+nixExePath :: FilePath
49+nixExePath = $(staticWhich "nix")
50+
51+nixBuildExePath :: FilePath
52+nixBuildExePath = $(staticWhich "nix-build")
53+
54+jreKeyToolPath :: FilePath
55+jreKeyToolPath = $(staticWhich "keytool")
56+
57+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+
2096
2197-- Check whether the working directory is clean
2298checkGitCleanStatus :: MonadObelisk m => FilePath -> Bool -> m Bool
@@ -25,7 +101,7 @@ checkGitCleanStatus repo withIgnored = do
25101 runGit = readProcessAndLogStderr Debug . gitProc repo
26102 gitStatus = runGit $ ["status", "--porcelain"] <> bool [] ["--ignored"] withIgnored
27103 gitDiff = runGit ["diff"]
28− null <$> liftA2 (<>) gitStatus gitDiff
104+ T.null <$> liftA2 (<>) gitStatus gitDiff
29105
30106-- | Ensure that git repo is clean
31107ensureCleanGitRepo :: MonadObelisk m => FilePath -> Bool -> Text -> m ()
@@ -46,37 +122,140 @@ initGit repo = do
46122 git ["add", "."]
47123 git ["commit", "-m", "Initial commit."]
48124
49−gitProc :: FilePath -> [String] -> P.CreateProcess
50−gitProc repo argsRaw =
51− P.proc "git" $ runGitInDir argsRaw
125+gitProcNoRepo :: [String] -> ProcessSpec
126+gitProcNoRepo args = setEnvOverride (M.singleton "GIT_TERMINAL_PROMPT" "0" <>) $ proc gitPath args
127+
128+gitProc :: FilePath -> [String] -> ProcessSpec
129+gitProc repo = gitProcNoRepo . runGitInDir
52130 where
53131 runGitInDir args' = case filter (not . null) args' of
54132 args@("clone":_) -> args <> [repo]
55133 args -> ["-C", repo] <> args
56134
57−-- | Recursively copy a directory using `cp -a`
58−copyDir :: FilePath -> FilePath -> P.CreateProcess
135+isolateGitProc :: ProcessSpec -> ProcessSpec
136+isolateGitProc = setEnvOverride (overrides <>)
137+ where
138+ overrides = M.fromList
139+ [ ("HOME", "/dev/null")
140+ , ("GIT_CONFIG_NOSYSTEM", "1")
141+ , ("GIT_TERMINAL_PROMPT", "0") -- git 2.3+
142+ , ("GIT_ASKPASS", "echo") -- pre git 2.3 to just use empty password
143+ , ("GIT_SSH_COMMAND", "ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no -o GSSAPIAuthentication=no")
144+ ]
145+
146+-- | Recursively copy a directory using `cp -a` -- TODO: Should use -rT instead of -a
147+copyDir :: FilePath -> FilePath -> ProcessSpec
59148copyDir src dest =
60− (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
61150
62151readGitProcess :: MonadObelisk m => FilePath -> [String] -> m Text
63−readGitProcess repo = fmap T.pack . readProcessAndLogStderr Notice . gitProc repo
152+readGitProcess repo = readProcessAndLogOutput (Debug, Notice) . gitProc repo
153+
154+readGitProcessNoRepo :: MonadObelisk m => [String] -> m Text
155+readGitProcessNoRepo = readProcessAndLogOutput (Debug, Notice) . gitProcNoRepo
64156
65157processToShellString :: FilePath -> [String] -> String
66158processToShellString cmd args = unwords $ map quoteAndEscape (cmd : args)
67159 where quoteAndEscape x = T.unpack $ "'" <> T.replace "'" "'\''" (T.pack x) <> "'"
68160
69161-- | A simpler wrapper for CliApp's most used process function with sensible defaults.
70−runProc :: MonadObelisk m => P.CreateProcess -> m ()
162+runProc :: MonadObelisk m => ProcessSpec -> m ()
71163runProc = callProcessAndLogOutput (Notice, Error)
72164
73165-- | Like runProc, but all output goes to Debug logging level
74−runProcSilently :: MonadObelisk m => P.CreateProcess -> m ()
166+runProcSilently :: MonadObelisk m => ProcessSpec -> m ()
75167runProcSilently = callProcessAndLogOutput (Debug, Debug)
76168
77169-- | A simpler wrapper for CliApp's readProcessAndLogStderr with sensible defaults.
78−readProc :: MonadObelisk m => P.CreateProcess -> m Text
79−readProc = fmap T.pack . readProcessAndLogStderr Error
170+readProc :: MonadObelisk m => ProcessSpec -> m Text
171+readProc = readProcessAndLogOutput (Debug, Error)
80172
81173tshow :: Show a => a -> Text
82174tshow = T.pack . show
175+
176+gitLookupDefaultBranch :: GitLsRemoteMaps -> Either Text Text
177+gitLookupDefaultBranch (refs, _) = do
178+ ref <- case M.lookup GitRef_Head refs of
179+ Just ref -> pure ref
180+ Nothing -> throwError
181+ "No symref entry for HEAD. \
182+ \ Is your git version at least 1.8.5? \
183+ \ Otherwise `git ls-remote --symref` will not work."
184+ case ref of
185+ GitRef_Branch b -> pure b
186+ _ -> throwError $
187+ "Default ref " <> showGitRef ref <> " is not a branch!"
188+
189+gitLookupCommitForRef :: GitLsRemoteMaps -> GitRef -> Either Text CommitId
190+gitLookupCommitForRef (_, commits) ref = case M.lookup ref commits of
191+ Just a -> pure a
192+ Nothing -> throwError $ "Did not find commit for " <> showGitRef ref
193+
194+gitLsRemote
195+ :: MonadObelisk m
196+ => String
197+ -> Maybe GitRef
198+ -> Maybe String
199+ -> m (ExitCode, GitLsRemoteMaps)
200+gitLsRemote repository mRef mBranch = do
201+ (exitCode, out, _err) <- case mBranch of
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
208+ maps <- case MP.runParser parseLsRemote "" t of
209+ Left err -> failWith $ T.pack $ MP.errorBundlePretty err
210+ Right table -> pure $ bimap M.fromList M.fromList $ partitionEithers table
211+ putLog Debug $ "git ls-remote maps: " <> T.pack (show maps)
212+ pure (exitCode, maps)
213+
214+lexeme :: Parsec Void Text a -> Parsec Void Text a
215+lexeme = ML.lexeme $ void $ MP.takeWhileP (Just "within-line white space") $
216+ flip elem [' ', '\t']
217+
218+-- $ git ls-remote --symref git@github.com:obsidiansystems/obelisk.git HEAD
219+-- ref: refs/heads/master HEAD
220+-- d0a8d25dc93f0acd096bc4ff2f550da9e2d0c8f5 refs/heads/master
221+parseLsRemote :: Parsec Void Text [Either (GitRef, GitRef) (GitRef, CommitId)]
222+parseLsRemote =
223+ many ((fmap Left (try parseRef) <|> fmap Right parseCommit) <* try MP.eol) <* MP.eof
224+ where
225+ parseRef :: Parsec Void Text (GitRef, GitRef)
226+ parseRef = MP.label "ref and symbolic ref" $ do
227+ _ <- lexeme "ref:"
228+ ref <- lexeme $ MP.takeWhileP (Just "ref") $ not . isSpace
229+ symbolicRef <- lexeme $ MP.takeWhileP (Just "symbolic ref") $ not . isSpace
230+ return (toGitRef symbolicRef, toGitRef ref)
231+ parseCommit :: Parsec Void Text (GitRef, CommitId)
232+ parseCommit = MP.label "commit and ref" $ do
233+ commitId <- lexeme $ MP.takeWhileP (Just "commit id") $ not . isSpace
234+ ref <- lexeme $ MP.takeWhileP (Just "ref") $ not . isSpace
235+ return (toGitRef ref, commitId)
236+
237+data GitRef
238+ = GitRef_Head
239+ | GitRef_Branch Text
240+ | GitRef_Tag Text
241+ | GitRef_Other Text
242+ deriving (Show, Eq, Ord)
243+
244+showGitRef :: GitRef -> Text
245+showGitRef = \case
246+ GitRef_Head -> "HEAD"
247+ GitRef_Branch x -> "refs/heads/" <> x
248+ GitRef_Tag x -> "refs/tags/" <> x
249+ GitRef_Other x -> x
250+
251+toGitRef :: Text -> GitRef
252+toGitRef = \case
253+ "HEAD" -> GitRef_Head
254+ r -> if
255+ | Just s <- "refs/heads/" `T.stripPrefix` r -> GitRef_Branch s
256+ | Just s <- "refs/tags/" `T.stripPrefix` r -> GitRef_Tag s
257+ | otherwise -> GitRef_Other r
258+
259+type CommitId = Text
260+
261+type GitLsRemoteMaps = (Map GitRef GitRef, Map GitRef CommitId)
lib/command/src/Obelisk/Command/VmBuilder.hs+67−38
@@ -1,13 +1,13 @@
11{-# LANGUAGE FlexibleContexts #-}
22{-# LANGUAGE OverloadedStrings #-}
33{-# LANGUAGE QuasiQuotes #-}
4+{-# LANGUAGE ScopedTypeVariables #-}
45module Obelisk.Command.VmBuilder where
56
67import Control.Applicative (liftA2)
7−import Control.Monad (unless)
8−import Control.Monad.Catch (try)
8+import Control.Monad (when, unless)
9+import Control.Monad.Catch (handle)
910import Control.Monad.IO.Class (liftIO)
10−import Data.Either (isRight)
1111import Data.Monoid ((<>))
1212import Data.String (IsString)
1313import Data.String.Here.Uninterpolated (hereLit)
@@ -15,23 +15,45 @@ import Data.Text (Text)
1515import qualified Data.Text as T
1616import qualified Data.Text.IO as T
1717import System.Directory (createDirectoryIfMissing)
18−import System.Exit (ExitCode)
18+import System.Exit (ExitCode(..))
1919import System.FilePath ((<.>), (</>))
2020import qualified System.Info
21−import System.Process (proc)
2221
2322import Obelisk.App (MonadObelisk, getObeliskUserStateDir)
2423import Obelisk.CliApp
25−import Obelisk.Command.Nix (withNixRemoteCheck)
24+import Obelisk.Command.Utils (rmPath, whichPath, sshKeygenPath, nixBuildExePath, dockerPath)
2625
2726-- | Generate the `--builders` argument string to enable the VM builder after ensuring it is available.
2827getNixBuildersArg :: MonadObelisk m => m String
2928getNixBuildersArg = do
3029 stateDir <- liftIO getDockerBuilderStateDir
31− exists <- containerExists
30+ let sshIdFile = stateDir </> sshKeyFileName
31+ checkForNixDarwin sshIdFile
32+ exists <- containerExists stateDir
3233 if exists then startContainer else setupNixDocker stateDir
3334 pure $ nixBuildersArgString stateDir
3435
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+
3557-- | String to pass to nix's `--builders` arguments to enable the VM builder.
3658nixBuildersArgString :: FilePath -> String
3759nixBuildersArgString stateDir = unwords [containerName, "x86_64-linux", stateDir </> sshKeyFileName, "1", "1", "kvm"]
@@ -41,14 +63,19 @@ containerName :: IsString str => str
4163containerName = "obelisk-docker-nix-builder"
4264
4365-- | 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
45−containerExists = withExitFailMessage needDockerMsg $ do
46− containerNames <- fmap (map T.strip . T.lines . T.pack) $
66+containerExists :: MonadObelisk m => FilePath -> m Bool
67+containerExists stateDir = handle (\(_ :: IOError) -> failWith needDockerMsg) $ do
68+ containerNames <- fmap (map T.strip . T.lines) $
4769 readProcessAndLogStderr Error $
48− proc "docker" ["container", "list", "--all", "--format", "{{.Names}}"]
49− pure $ containerName `elem` containerNames
70+ proc dockerPath ["container", "list", "--all", "--format", "{{.Names}}"]
71+ let exists = containerName `elem` containerNames
72+ when exists $ testLinuxBuild stateDir
73+ pure exists
5074 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+ ]
5279
5380-- | SSH port on localhost that connects to the container.
5481containerSshPort :: Int
@@ -58,7 +85,7 @@ containerSshPort = 2222
5885startContainer :: MonadObelisk m => m ()
5986startContainer = withSpinner "Starting VM builder" $
6087 callProcessAndLogOutput (Debug, Debug) $
61− proc "docker" ["start", containerName]
88+ proc dockerPath ["start", containerName]
6289
6390-- | Creates the Docker container; assumes it does not exist.
6491setupNixDocker :: MonadObelisk m => FilePath -> m ()
@@ -69,30 +96,25 @@ setupNixDocker stateDir = withSpinner ("Creating Docker container named " <> con
6996
7097 -- Create new SSH keys for this container
7198 callProcessAndLogOutput (Debug, Error) $
72− proc "rm" ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
99+ proc rmPath ["-f", stateDir </> sshKeyFileName, stateDir </> sshKeyFileName <.> "pub"]
73100 callProcessAndLogOutput (Debug, Error) $
74− proc "ssh-keygen" ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
101+ proc sshKeygenPath ["-t", "ed25519", "-f", stateDir </> sshKeyFileName, "-P", ""]
75102
76103 -- Build the docker container (which uses the SSH keys in the 'ssh' folder)
77− containerId <- readProcessAndLogStderr Error $
78− proc "docker" ["build", stateDir, "--quiet"]
79− callProcessAndLogOutput (Debug, Error) $ proc "docker"
104+ containerId <- fmap T.strip $ readProcessAndLogStderr Error $
105+ proc dockerPath ["build", stateDir, "--quiet"]
106+ callProcessAndLogOutput (Debug, Error) $ proc dockerPath
80107 [ "run"
81108 , "--restart", "always"
82109 , "--detach"
83110 , "--publish", show containerSshPort <> ":22"
84− , "--name", containerName, containerId
111+ , "--name", T.unpack containerName, T.unpack containerId
85112 ]
86− exists <- containerExists
113+ exists <- containerExists stateDir
87114 unless exists $
88115 failWith $ "Expected to see docker container named " <> containerName <> " but it does not exist."
89116
90− linuxBuildWorked <- if System.Info.os == "linux"
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
117+ testLinuxBuild stateDir
96118
97119-- | The instructions for setting up SSH access to the container for the Nix daemon.
98120setupInstructions :: FilePath -> Text
@@ -129,19 +151,25 @@ getDockerBuilderStateDir :: IO FilePath
129151getDockerBuilderStateDir = liftA2 (</>) getObeliskUserStateDir (pure "nix-docker-builder")
130152
131153-- | Run a test build to see if a Linux build can finish successfully.
132−testLinuxBuild :: MonadObelisk m => FilePath -> m Bool
133−testLinuxBuild stateDir =
134− fmap (isRight :: Either ExitCode () -> Bool) $ try $ withNixRemoteCheck $
135− callProcessAndLogOutput (Debug, Debug) $ proc "nix-build"
136− [ "-E", "(import <nixpkgs> { system = \"x86_64-linux\"; }).writeText \"test\" builtins.currentTime"
137− , "--builders", nixBuildersArgString stateDir
138− ]
139−
140−-- Copied from https://raw.githubusercontent.com/LnL7/nix-docker/bf28b99aebd8e403d2fc2171f4fa8878f857171c/ssh/Dockerfile
154+testLinuxBuild :: MonadObelisk m => FilePath -> m ()
155+testLinuxBuild stateDir
156+ | System.Info.os == "linux" = failWith "Using the docker builder is not necessary on linux."
157+ | otherwise = do
158+ (exitCode, _stdout, stderr) <- readCreateProcessWithExitCode $ proc nixBuildExePath
159+ [ "--no-out-link"
160+ , "-E", "(import <nixpkgs> { system = \"x86_64-linux\"; }).writeText \"test\" builtins.currentTime"
161+ , "--builders", nixBuildersArgString stateDir
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
141169-- Renamed "insecure_rsa" to 'sshKeyFileName'
142170dockerfile :: Text
143171dockerfile = [hereLit|
144−FROM lnl7/nix:2018-04-17
172+FROM lnl7/nix:2018-09-21
145173
146174RUN nix-env -f '<nixpkgs>' -iA \
147175 gnused \
@@ -166,7 +194,8 @@ RUN mkdir -p /etc/ssh \
166194 ] <> [hereLit|
167195
168196EXPOSE 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+
170199|]
171200
172201sshKeyFileName :: FilePath
lib/executable-config/default.nix+38−15
@@ -2,21 +2,44 @@
22# configuration information into a canonical location. It also provides a haskell
33# package that can be used to retrieve the injected configuration on each supported
44# platform.
5−{ nixpkgs
6−, filterGitSource # TODO define this in obelisk
5+{ lib
6+, runCommand
7+, obeliskCleanSource
78}:
8−let injectConfig = config: assets: nixpkgs.runCommand "inject-config" {} ''
9− set -x
10− cp -a "${assets}" $out
11− chmod +w "$out"
12− if ! mkdir $out/config; then
13− 2>&1 echo config directory already exists or could not be created
14− exit 1
15− fi
16− cp -a "${config}"/* "$out/config"
17− '';
18−in with nixpkgs.haskell.lib; {
19− haskellPackage = self: self.callPackage (filterGitSource ./lookup) {};
9+
10+let
11+ injectConfig = config: assets: runCommand "inject-config" {} (''
12+ set -x
13+ mkdir -p $out
14+ cp --no-preserve=mode -Lr "${assets}" $out/static
15+ chmod +w "$out"
16+ '' + lib.optionalString (!(builtins.isNull config)) ''
17+ if ! mkdir $out/config; then
18+ 2>&1 echo config directory already exists or could not be created
19+ exit 1
20+ fi
21+ cp -a "${config}"/* "$out/config"
22+ # Needed for android deployments
23+ find "$out/config" -type f -printf '%P\0' > "$out/config.files"
24+ '');
25+in
26+
27+{
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+
2043 platforms = {
2144 android = {
2245 # Inject the given config directory into an android assets folder
@@ -27,7 +50,7 @@ in with nixpkgs.haskell.lib; {
2750 inject = injectConfig;
2851 };
2952 web = {
30− inject = self: self.callCabal2nix "obelisk-executable-config-inject" (filterGitSource ./inject) {};
53+ inject = self: self.callCabal2nix "obelisk-executable-config-inject" (obeliskCleanSource ./inject) {};
3154 };
3255 };
3356}
lib/executable-config/inject/obelisk-executable-config-inject.cabal+4−4
@@ -9,10 +9,10 @@ library
99 build-depends:
1010 base,
1111 bytestring,
12− directory,
13− filepath,
14− reflex-dom,
12+ base64-bytestring,
13+ containers,
14+ reflex-dom-core,
1515 text
1616
1717 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+15−41
@@ -2,50 +2,24 @@
22module Obelisk.ExecutableConfig.Inject where
33
44import Control.Monad (mapM_)
5−import Control.Monad.IO.Class (MonadIO, liftIO)
6−import Data.Semigroup ((<>))
5+import Control.Monad.IO.Class (MonadIO)
76import 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 ((<>))
811import Data.Text (Text)
9−import qualified Data.Text as T
10−import qualified Data.Text.IO as T
11−import Reflex.Dom 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
12+import qualified Data.Text.Encoding as T
13+import Reflex.Dom.Core hiding (value)
2114
2215-- | Produces a @<script>@ tag with an @id@ attribute containing the key and
23−-- whose value is the provided configuration
24−injectPure :: DomBuilder t m => Text -> Text -> m ()
16+-- whose value is the provided configuration, encoded in base64.
17+injectPure :: DomBuilder t m => Text -> ByteString -> m ()
2518injectPure key value =
26− let attrs = ("type" =: "text/plain" <> "id" =: ("config-" <> key))
27− in elAttr "script" attrs $ text 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)
19+ let attrs = ("type" =: "text/plain" <> "data-obelisk-executable-config-inject-key" =: key <> "data-hydration-skip" =: "")
20+ in elAttr "script" attrs $ text (T.decodeUtf8 (B64.encode value))
3721
38−getConfigs :: MonadIO m => FilePath -> m [(Text, Text)]
39−getConfigs fp = liftIO $ do
40− dir <- doesDirectoryExist fp
41− if dir
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 []
22+-- | Produces injectable @<script>@ tags containing the configuration keys
23+-- (filepaths) and values.
24+injectExecutableConfigs :: (MonadIO m, DomBuilder t m) => Map Text ByteString -> m ()
25+injectExecutableConfigs = mapM_ (uncurry injectPure) . Map.toList
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 ("config" </> 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) </> "config" </> 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
77 hs-source-dirs: src
88 build-depends: base,
99 bytestring,
10+ containers,
11+ cookie,
1012 dependent-sum,
1113 ghcjs-dom,
1214 jsaddle,
1315 lens,
16+ mtl,
17+ obelisk-executable-config-inject,
18+ obelisk-executable-config-lookup,
1419 obelisk-route,
1520 primitive,
1621 ref-tf,
@@ -18,5 +23,7 @@ library
1823 reflex-dom-core,
1924 text,
2025 transformers
21− exposed-modules: Obelisk.Frontend
22− ghc-options: -Wall
26+ exposed-modules:
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+188−104
@@ -1,10 +1,13 @@
1+{-# LANGUAGE CPP #-}
12{-# LANGUAGE ConstraintKinds #-}
23{-# LANGUAGE FlexibleContexts #-}
34{-# LANGUAGE FlexibleInstances #-}
45{-# LANGUAGE LambdaCase #-}
56{-# LANGUAGE MultiParamTypeClasses #-}
67{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE PackageImports #-}
79{-# LANGUAGE RankNTypes #-}
10+{-# LANGUAGE RecursiveDo #-}
811{-# LANGUAGE ScopedTypeVariables #-}
912{-# LANGUAGE TemplateHaskell #-}
1013{-# LANGUAGE TypeFamilies #-}
@@ -13,39 +16,55 @@ module Obelisk.Frontend
1316 ( ObeliskWidget
1417 , Frontend (..)
1518 , runFrontend
19+ , runFrontendWithConfigsAndCurrentRoute
1620 , renderFrontendHtml
21+ , removeHTMLConfigs
22+ , FrontendMode (..)
23+ , FrontendWidgetT
24+ , module Obelisk.Frontend.Cookie
1725 ) where
1826
1927import Prelude hiding ((.))
2028
2129import Control.Category
22−import Control.Concurrent
2330import Control.Lens
24−import Control.Monad
2531import Control.Monad.Fix
2632import Control.Monad.IO.Class
2733import Control.Monad.Primitive
34+import Control.Monad.Reader
2835import Control.Monad.Ref
29−import Control.Monad.Trans.Class
36+import Control.Monad.Trans.Maybe (MaybeT(..), runMaybeT)
3037import Data.ByteString (ByteString)
31−import Data.Dependent.Sum (DSum (..))
38+import Data.Foldable (for_)
3239import Data.Functor.Sum
33−import Data.IORef
34−import Data.Monoid hiding (Sum)
40+import Data.Map (Map)
41+import Data.Maybe (catMaybes)
42+import Data.Monoid ((<>))
3543import Data.Text (Text)
36−import GHCJS.DOM hiding (bracket, catch)
37−import GHCJS.DOM.Document
38−import GHCJS.DOM.Node
44+import qualified GHCJS.DOM as DOM
3945import qualified GHCJS.DOM.Types as DOM
40−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
4155import Obelisk.Route.Frontend
4256import Reflex.Dom.Core
4357import Reflex.Host.Class
44−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
4564
4665makePrisms ''Sum
4766
48−type ObeliskWidget t x route m =
67+type ObeliskWidget js t route m =
4968 ( DomBuilder t m
5069 , MonadFix m
5170 , MonadHold t m
@@ -53,8 +72,6 @@ type ObeliskWidget t x route m =
5372 , MonadReflexCreateTrigger t m
5473 , PostBuild t m
5574 , PerformEvent t m
56− , MonadIO m
57− , MonadIO (Performable m)
5875 , TriggerEvent t m
5976 , HasDocument m
6077 , MonadRef m
@@ -63,108 +80,175 @@ type ObeliskWidget t x route m =
6380 , Ref (Performable m) ~ Ref IO
6481 , MonadFix (Performable m)
6582 , PrimMonad m
66− , Prerender x m
67− , EventWriter t (Endo route) m
83+ , Prerender js t 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)
6897 )
6998
7099data Frontend route = Frontend
71− { _frontend_head :: !(forall t m x. ObeliskWidget t x route m => RoutedT t route m ())
72− , _frontend_body :: !(forall t m x. ObeliskWidget t x route m => RoutedT t route m ())
73− , _frontend_notFoundRoute :: !(Text -> route) --TODO: Instead, maybe we should just require that the `parse` Monad for routeEncoder be `Identity`
100+ { _frontend_head :: !(forall js t m. ObeliskWidget js t route m => RoutedT t route m ())
101+ , _frontend_body :: !(forall js t m. ObeliskWidget js t route m => RoutedT t route m ())
74102 }
75103
76−type Widget' x = ImmediateDomBuilderT DomTimeline (DomCoreWidget x)
77−
78−-- | A widget that isn't attached to any particular part of the DOM hierarchy
79−type FloatingWidget x = TriggerEventT DomTimeline (DomCoreWidget x)
80−
81−type DomCoreWidget x = PostBuildT DomTimeline (WithJSContextSingleton x (PerformEventT DomTimeline DomHost))
82−
83−--TODO: Rename
84−{-# INLINABLE attachWidget''' #-}
85−attachWidget'''
86− :: (EventChannel -> PerformEventT DomTimeline (SpiderHost Global) (IORef (Maybe (EventTrigger DomTimeline ()))))
87− -> IO ()
88−attachWidget''' w = runDomHost $ do
89− events <- liftIO newChan
90− (postBuildTriggerRef, fc@(FireCommand fire)) <- hostPerformEventT $ w events
91− mPostBuildTrigger <- readRef postBuildTriggerRef
92− forM_ mPostBuildTrigger $ \postBuildTrigger -> fire [postBuildTrigger :=> Identity ()] $ return ()
93− liftIO $ processAsyncEvents events fc
94−
95−--TODO: This is a collection of random stuff; we should make it make some more sense and then upstream to reflex-dom-core
96−runWithHeadAndBody
97− :: ( (forall c. Widget' () c -> FloatingWidget () c) -- "Append to head"
98− -> (forall c. Widget' () c -> FloatingWidget () c) -- "Append to body"
99− -> FloatingWidget () ()
100− )
104+baseTag :: forall route js t m. ObeliskWidget js t route m => RoutedT t route m ()
105+baseTag = elAttr "base" ("href" =: "/") blank --TODO: Figure out the base URL from the routes
106+
107+removeHTMLConfigs :: JSM ()
108+removeHTMLConfigs = void $ runMaybeT $ do
109+ doc <- MaybeT currentDocument
110+ hd <- MaybeT $ getHead doc
111+ es <- nodeListNodes =<< querySelectorAll hd ("[data-obelisk-executable-config-inject-key]" :: Text)
112+ for_ es $ removeChild_ hd
113+
114+-- | Collect all nodes in the node list.
115+--
116+-- TODO: this and the version in exe-config/ghcjs/lookup should be
117+-- upstreamed to jsaddle.
118+nodeListNodes :: (IsNodeList l, MonadJSM m) => l -> m [Node]
119+nodeListNodes es = do
120+ len <- getLength es
121+ -- Warning! len is unsigned. If the NodeList is empty, we must avoid
122+ -- accidentally traversing over [0..maxBound::Word]
123+ nodes <- traverse (item es) $ if len == 0 then [] else [0..len-1]
124+ pure $ catMaybes nodes
125+
126+setInitialRoute :: Bool -> JSM ()
127+setInitialRoute useHash = do
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)
101152 -> JSM ()
102−runWithHeadAndBody app = withJSContextSingletonMono $ \jsSing -> do
103− globalDoc <- currentDocumentUnchecked
104− headFragment <- createDocumentFragment globalDoc
105− bodyFragment <- createDocumentFragment globalDoc
106− unreadyChildren <- liftIO $ newIORef 0
107− let commit = do
108− headElement <- getHeadUnchecked globalDoc
109− bodyElement <- getBodyUnchecked globalDoc
110− void $ inAnimationFrame' $ \_ -> do
111− replaceElementContents headElement headFragment
112− replaceElementContents bodyElement bodyFragment
113− liftIO $ attachWidget''' $ \events -> flip runWithJSContextSingleton jsSing $ do
114− (postBuild, postBuildTriggerRef) <- newEventWithTriggerRef
115− let appendImmediateDom :: DOM.DocumentFragment -> Widget' () c -> FloatingWidget () c
116− appendImmediateDom df w = do
117− events' <- TriggerEvent.askEvents
118− lift $ do
119− doc <- getOwnerDocumentUnchecked df
120− let builderEnv = ImmediateDomBuilderEnv
121− { _immediateDomBuilderEnv_document = doc
122− , _immediateDomBuilderEnv_parent = toNode df
123− , _immediateDomBuilderEnv_unreadyChildren = unreadyChildren
124− , _immediateDomBuilderEnv_commitAction = commit
125− }
126− runImmediateDomBuilderT w builderEnv events'
127− flip runPostBuildT postBuild $ flip runTriggerEventT events $ app (appendImmediateDom headFragment) (appendImmediateDom bodyFragment)
128− liftIO (readIORef unreadyChildren) >>= \case
129− 0 -> DOM.liftJSM commit
130− _ -> return ()
131− return postBuildTriggerRef
132−
133−runFrontend :: forall backendRoute route. ValidEncoder (Either Text) (R (Sum backendRoute (ObeliskRoute route))) PageName -> Frontend (R route) -> JSM ()
134153runFrontend validFullEncoder frontend = do
135− let ve = validFullEncoder . prismValidEncoder (rPrism $ _InR . _ObeliskRoute_App)
136− runMyRouteViewT
137− :: ( TriggerEvent t m
138− , PerformEvent t m
139− , MonadHold t m
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))
186+ errorLeft = \case
187+ Left _ -> error "runFrontend: Unexpected non-app ObeliskRoute reached the frontend. This shouldn't happen."
188+ Right x -> Identity x
189+ w :: ( RawDocument (DomBuilderSpace (HydrationDomBuilderT s DomTimeline m)) ~ DOM.Document
190+ , Ref (Performable m) ~ Ref IO
191+ , Ref m ~ Ref IO
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)
140201 , DOM.MonadJSM m
141− , DOM.MonadJSM (Performable m)
142− , MonadFix m
202+ , MonadFix (Client (HydrationDomBuilderT s DomTimeline m))
143203 , MonadFix (Performable m)
204+ , MonadFix m
205+ , Prerender js DomTimeline (HydrationDomBuilderT s DomTimeline m)
206+ , MonadIO (Performable m)
144207 )
145− => RoutedT t (R route) (EventWriterT t (Endo (R route)) m) a
146− -> m a
147− runMyRouteViewT = runRouteViewT
148− ve
149− (_frontend_notFoundRoute frontend)
150− runWithHeadAndBody $ \appendHead appendBody -> runMyRouteViewT $ do
151− mapRoutedT (mapEventWriterT appendHead) $ _frontend_head frontend
152− mapRoutedT (mapEventWriterT appendBody) $ _frontend_body frontend
153−
154−instance PrimMonad m => PrimMonad (EventWriterT t w m) where
155− type PrimState (EventWriterT t w m) = PrimState m
156− primitive = lift . primitive
208+ => (forall c. HydrationDomBuilderT s DomTimeline m c -> FloatingWidget () c)
209+ -> (forall c. HydrationDomBuilderT s DomTimeline m c -> FloatingWidget () c)
210+ -> FloatingWidget () ()
211+ w appendHead appendBody = do
212+ rec switchover <- runRouteViewT ve switchover (_frontendMode_adjustRoute mode) $ do
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))))))))
157231
158232renderFrontendHtml
159− :: (Semigroup w, t ~ SpiderTimeline Global)
160− => r
161− -> RoutedT t r (EventWriterT t w (PostBuildT Spider (StaticDomBuilderT Spider (PerformEventT Spider (SpiderHost Global))))) ()
162− -> RoutedT t r (EventWriterT t w (PostBuildT Spider (StaticDomBuilderT Spider (PerformEventT Spider (SpiderHost Global))))) ()
163− -> IO ByteString
164−renderFrontendHtml route headWidget bodyWidget = do
233+ :: MonadIO m
234+ => Map Text ByteString
235+ -> Cookies
236+ -> (r -> Text)
237+ -> r
238+ -> Frontend r
239+ -> FrontendWidgetT r ()
240+ -> FrontendWidgetT r ()
241+ -> m ByteString
242+renderFrontendHtml configs cookies urlEnc route frontend headExtra bodyExtra = do
165243 --TODO: We should probably have a "NullEventWriterT" or a frozen reflex timeline
166− html <- fmap snd $ renderStatic $ fmap fst $ runEventWriterT $ 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) $
167245 el "html" $ do
168− el "head" headWidget
169− el "body" bodyWidget
246+ el "head" $ do
247+ baseTag
248+ injectExecutableConfigs configs
249+ _frontend_head frontend
250+ headExtra
251+ el "body" $ do
252+ _frontend_body frontend
253+ bodyExtra
170254 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−222
@@ -1,222 +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 System.Directory
21−import System.FilePath
22−
23−import Algebra.Graph.AdjacencyMap
24−
25−type Hash = Text
26−
27−-- Migration graph with edge metadata
28−data Migration action = Migration
29− { _migration_graph :: AdjacencyMap Hash
30− , _migration_actions :: Map (Hash, Hash) action -- Edge metadata
31− }
32− deriving (Eq, Show)
33−
34−-- A path is a list of edges
35−type Path = [(Hash, Hash)]
36−
37−data MigrationError
38− = GraphInternalError Text
39− | CyclicGraphError
40− | MultipleTerminalVertices
41− | NoTerminalVertex
42− | NonEquivalentPaths Hash Hash
43− | MissingEdgeInActionMap (Hash, Hash)
44− | NonLinearGraph_MultipleAdjacents Hash
45− | NonLinearGraph_NotConnected (Set Hash)
46− deriving (Eq, Ord, Show)
47−
48−class Action action where
49− parseEdgeMeta :: String -> action
50−
51−instance Action Text where
52− parseEdgeMeta = T.pack
53−
54−-- | Get the directed-acylic graph of migration
55−-- TODO: Consider calling getDag only when reading the graph for efficiency.
56−getDag :: (MonadError MigrationError m, Ord a) => AdjacencyMap a -> m (AdjacencyMap a)
57−getDag g = case topSort g of
58− Just _ -> pure g
59− Nothing -> throwError CyclicGraphError
60−
61−-- | Read the graph from a directory of files.
62−readGraph :: Action action => FilePath -> Text -> IO (Maybe (Migration action))
63−readGraph root name = doesDirectoryExist root >>= \case
64− False -> return Nothing
65− True -> do
66− allVertexPairs <- listDirectory root >>= return . catMaybes . fmap getEdgeVertices
67− edgesInfo <- fmap catMaybes $ forM allVertexPairs $ \vs -> do
68− getEdgeFor name vs >>= return . fmap (vs, )
69− return $ pure $ Migration (edges $ fmap fst edgesInfo) (Map.fromList edgesInfo)
70− where
71− getEdgeVertices p = case T.splitOn "-" $ T.pack p of
72− [v1, v2] -> Just (v1, v2)
73− _ -> Nothing
74− getEdgeFor graph (v1, v2) = do
75− let f = root </> (T.unpack $ v1 <> "-" <> v2) </> T.unpack graph
76− doesFileExist f >>= \case
77− True -> do
78− c <- readFile f >>= pure . parseEdgeMeta
79− return $ Just c
80− False -> do
81− return Nothing
82−
83−-- | Ensure that the migration graph is correct
84−--
85−-- In a correct migration graph: for all pairs of nodes, all paths between
86−-- those nodes have the same migration value
87−--
88−-- Throw the following if integrity check fails
89−-- * `CyclicGraphError`
90−-- * `NonEquivalentPaths`
91−--
92−-- Complexity: O(V+E)
93−ensureGraphIntegrity
94− :: (MonadError MigrationError m, Monoid action, Ord action)
95− => Migration action -> m ()
96−ensureGraphIntegrity m = do
97− graph <- fmap adjacencyMap $ getDag $ _migration_graph m
98− firstVertex <- getFirst $ _migration_graph m
99− let
100− visitFrom visited acc start = case Map.lookup start graph of
101− Nothing -> pure ()
102− Just adjs -> void $ flip traverse (Set.toList adjs) $ \adj -> do
103− acc' <- fmap (mappend acc) $ getAction m (start, adj)
104− visited' <- case Map.lookup adj visited of
105− Nothing -> pure $ Map.insert adj acc' visited
106− Just adjAcc -> if acc' == adjAcc
107− then pure visited
108− else throwError $ NonEquivalentPaths start adj
109− visitFrom visited' acc' adj
110− -- We only check all paths from the _first_ vertex; it is not necessary to
111− -- check all paths between _all_ pairs of vertices as that can be proved by
112− -- induction, as long as there is exactly one first vertex (which we check on
113− -- further above).
114− visitFrom mempty mempty firstVertex
115−
116−-- | Ensure that the graph is a fully connected linear list
117−--
118−-- Returns the last vertex in the linear list.
119−ensureGraphLinearity :: MonadError MigrationError m => Migration action -> m Hash
120−ensureGraphLinearity m = do
121− graph <- fmap adjacencyMap $ getDag $ _migration_graph m
122− firstVertex <- getFirst $ _migration_graph m
123− let
124− allVertices = vertexSet $ _migration_graph m
125− visitFrom start = case Map.lookup start graph of
126− Nothing -> throwError $ GraphInternalError $ "Vertex not found: " <> start
127− Just adjs -> case (Set.toList adjs) of
128− [] -> pure (start, [start])
129− [adj] -> fmap (start :) <$> visitFrom adj
130− _ -> throwError $ NonLinearGraph_MultipleAdjacents start
131− (lastVertex, visitedVertices) <- visitFrom firstVertex
132− let unvisitedVertices = Set.difference allVertices $ Set.fromList visitedVertices
133− if Set.null unvisitedVertices
134− then pure lastVertex
135− else throwError $ NonLinearGraph_NotConnected unvisitedVertices
136−
137−-- | Find the concatenated actions between two vertices
138−--
139−-- All paths between the vertices must have the same mappend'ed action;
140−-- otherwise this will throw.
141−--
142−-- Complexity: O(V+E)
143−findPathAction
144− :: (MonadError MigrationError m, Action action, Monoid action, Ord action)
145− => Migration action -> Hash -> Hash -> m (Maybe action)
146−findPathAction m start end = flip evalStateT Map.empty $ do
147− graph <- fmap adjacencyMap $ getDag $ _migration_graph m
148− let
149− findPathFromCached start' = do
150− -- TODO: refactor the caching part into a separate `memoize` function
151− cache <- get
152− case Map.lookup start' cache of
153− Just result ->
154− pure result
155− Nothing -> do
156− result <- findPathFrom start'
157− put $ Map.insert start' result cache
158− pure result
159− findPathFrom start' = if start' == end
160− then
161− pure $ Just mempty
162− else case Map.lookup start' graph of
163− Just adjs -> do
164− actions <- fmap catMaybes $ flip traverse (Set.toList adjs) $ \adj -> do
165− action0 <- getAction m (start', adj)
166− actionM <- findPathFromCached adj
167− pure $ fmap (mappend action0) $ actionM
168− case uniqs actions of
169− [] -> pure Nothing
170− [v] -> pure $ Just v -- Exactly one monoidal value; accept.
171− _ -> throwError $ NonEquivalentPaths start' end
172− Nothing ->
173− pure Nothing
174− uniqs = Set.toList . Set.fromList
175− findPathFromCached start
176−
177−hasVertex :: Hash -> Migration action -> Bool
178−hasVertex h (Migration g _) = Set.member h $ vertexSet g
179−
180−-- | Get the action for the given edge (which must exist)
181−getAction :: MonadError MigrationError m => Migration action -> (Hash, Hash) -> m action
182−getAction (Migration _ h) e = case Map.lookup e h of
183− Just v -> pure v
184− Nothing -> throwError $ MissingEdgeInActionMap e
185−
186−-- | Get the last vertex of the given DAG. Nothing if empty graph.
187−--
188−-- Assumes that the graph is fully connected.
189−getLast :: (MonadError MigrationError m, Ord a, Eq a) => AdjacencyMap a -> m a
190−getLast g = lastVertices >>= \case
191− [] -> throwError NoTerminalVertex
192− [x] -> pure x
193− _ -> throwError MultipleTerminalVertices
194− where
195− lastVertices
196− = pure
197− . fmap fst
198− . filter (\(_, nexts) -> nexts == [])
199− . adjacencyList
200− =<< getDag g
201−
202−-- | Get the first vertex of the given DAG. Nothing if empty graph.
203−getFirst :: (MonadError MigrationError m, Ord a, Eq a) => AdjacencyMap a -> m a
204−getFirst = getLast . transpose
205−
206−-- | Write an edge directly to the filesystem.
207−--
208−-- Actions are written with empty string.
209−--
210−-- Return the edge directory created.
211−writeEdge :: MonadIO m => FilePath -> [Text] -> Hash -> Hash -> m (Maybe FilePath)
212−writeEdge dir actionFiles v1 v2 = do
213− unless (v1 /= v2) $
214− fail $ "Cannot create self loop with: " <> T.unpack v1
215− let edgeDir = dir </> (T.unpack $ v1 <> "-" <> v2)
216− liftIO (doesDirectoryExist edgeDir) >>= \case
217− True -> pure Nothing
218− False -> do
219− liftIO $ createDirectory edgeDir
220− forM_ actionFiles $ \fp -> liftIO $
221− writeFile (edgeDir </> T.unpack fp) ""
222− 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+11−4
@@ -1,13 +1,16 @@
11name: obelisk-route
2−version: 0.1
2+version: 0.2
33cabal-version: >= 1.2
44build-type: Simple
55
66library
77 hs-source-dirs: src
88 build-depends: base,
9+ aeson,
10+ bytestring,
911 categories,
1012 constraints,
13+ constraints-extras,
1114 containers,
1215 dependent-map,
1316 dependent-sum,
@@ -17,19 +20,23 @@ library
1720 http-types,
1821 jsaddle,
1922 lens,
23+ mmorph,
2024 monad-control,
2125 mtl,
2226 network-uri,
27+ obelisk-executable-config-lookup,
2328 primitive,
2429 ref-tf,
2530 reflex,
26− reflex-dom,
31+ reflex-dom-core,
2732 template-haskell,
33+ tabulation,
2834 text,
35+ th-extras,
2936 transformers,
3037 universe,
31− universe-template
38+ universe-dependent-sum
3239 exposed-modules: Obelisk.Route
3340 Obelisk.Route.TH
3441 Obelisk.Route.Frontend
35− 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+844−330
@@ -1,3 +1,4 @@
1+{-# LANGUAGE CPP #-}
12{-# LANGUAGE ApplicativeDo #-}
23{-# LANGUAGE ConstraintKinds #-}
34{-# LANGUAGE EmptyCase #-}
@@ -5,55 +6,81 @@
56{-# LANGUAGE FlexibleContexts #-}
67{-# LANGUAGE FlexibleInstances #-}
78{-# LANGUAGE GADTs #-}
8−{-# LANGUAGE KindSignatures #-}
99{-# LANGUAGE LambdaCase #-}
1010{-# LANGUAGE MultiParamTypeClasses #-}
1111{-# LANGUAGE OverloadedStrings #-}
1212{-# LANGUAGE PatternSynonyms #-}
1313{-# LANGUAGE RankNTypes #-}
1414{-# LANGUAGE ScopedTypeVariables #-}
15+{-# LANGUAGE StandaloneDeriving #-}
1516{-# LANGUAGE TemplateHaskell #-}
17+{-# LANGUAGE TypeApplications #-}
1618{-# LANGUAGE TypeFamilies #-}
1719{-# LANGUAGE TypeOperators #-}
1820{-# LANGUAGE ViewPatterns #-}
1921module Obelisk.Route
2022 ( R
23+ , (:.)
24+ , (?/)
25+ , hoistR
26+ , pattern (:.)
2127 , pattern (:/)
2228 , PageName
23− , Encoder (..) --TODO: unsafe
29+ , PathQuery
30+ , Encoder
31+ , unsafeEncoder
2432 , checkEncoder
25− , ValidEncoder (..) --TODO: unsafe
26− , ValidEncoderFunc (..)
33+ , EncoderImpl (..)
34+ , EncoderFunc (..)
35+ , unsafeMkEncoder
36+ , encode
37+ , decode
38+ , tryDecode
39+ , hoistCheck
40+ , hoistParse
2741 , mapSome
42+ , SegmentResult (..)
2843 , pathComponentEncoder
2944 , enumEncoder
3045 , enum1Encoder
3146 , checkEnum1EncoderFunc
32− , endValidEncoder
33− , pathOnlyValidEncoder
34− , singletonListValidEncoder
47+ , unitEncoder
48+ , pathOnlyEncoder
49+ , addPathSegmentEncoder
50+ , pathParamEncoder
51+ , pathLiteralEncoder
52+ , singletonListEncoder
53+ , packTextEncoder
3554 , unpackTextEncoder
3655 , prefixTextEncoder
37− , unsafeTshowValidEncoder
38− , someConstValidEncoder
39− , singlePathSegmentValidEncoder
40− , justValidEncoder
41− , nothingValidEncoder
42− , isoValidEncoder
43− , wrappedValidEncoder
44− , unwrappedValidEncoder
56+ , unsafeTshowEncoder
57+ , someConstEncoder
58+ , singlePathSegmentEncoder
59+ , maybeEncoder
60+ , maybeToEitherEncoder
61+ , justEncoder
62+ , nothingEncoder
63+ , isoEncoder
64+ , viewEncoder
65+ , wrappedEncoder
66+ , unwrappedEncoder
4567 , listToNonEmptyEncoder
4668 , prefixNonemptyTextEncoder
4769 , joinPairTextEncoder
4870 , toListMapEncoder
4971 , shadowEncoder
50− , prismValidEncoder
72+ , prismEncoder
73+ , reviewEncoder
5174 , rPrism
75+ , _R
5276 , obeliskRouteEncoder
53− , obeliskRouteComponentEncoder
54− , checkObeliskRouteRestEncoder
55− , pageNameValidEncoder
56− , catchValidEncoder
77+ , obeliskRouteSegment
78+ , pageNameEncoder
79+ , handleEncoder
80+ , FullRoute (..)
81+ , _FullRoute_Frontend
82+ , _FullRoute_Backend
83+ , mkFullRouteEncoder
5784 , ObeliskRoute (..)
5885 , _ObeliskRoute_App
5986 , _ObeliskRoute_Resource
@@ -61,11 +88,26 @@ module Obelisk.Route
6188 , JSaddleWarpRoute (..)
6289 , jsaddleWarpRouteEncoder
6390 , IndexOnlyRoute (..)
64− , indexOnlyRouteComponentEncoder
65− , indexOnlyRouteRestEncoder
91+ , indexOnlyRouteSegment
92+ , indexOnlyRouteEncoder
6693 , someSumEncoder
6794 , Void1
6895 , void1Encoder
96+ , pathSegmentsTextEncoder
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
69111 ) where
70112
71113import Prelude hiding ((.), id)
@@ -76,13 +118,41 @@ import qualified Control.Categorical.Functor as Cat
76118import Control.Categorical.Bifunctor
77119import Control.Category.Associative
78120import Control.Category.Monoidal
79−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+ )
80142import Control.Monad.Except
81−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
82150import Data.Dependent.Map (DMap)
83151import qualified Data.Dependent.Map as DMap
152+import Data.Dependent.Sum (DSum (..))
84153import Data.Either.Validation (Validation (..))
85154import Data.Foldable
155+import Data.Functor (($>))
86156import Data.Functor.Sum
87157import Data.GADT.Compare
88158import Data.GADT.Compare.TH
@@ -91,15 +161,20 @@ import Data.List.NonEmpty (NonEmpty (..))
91161import Data.Map (Map)
92162import qualified Data.Map as Map
93163import Data.Maybe
164+import Data.Monoid ((<>))
94165import Data.Set (Set)
95166import qualified Data.Set as Set
96−import Data.Some (Some)
97−import qualified Data.Some as Some
167+import Data.Some (Some(Some))
168+import Data.Tabulation
98169import Data.Text (Text)
99170import qualified Data.Text as T
100−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
101174import Data.Universe
175+import Data.Universe.Some
102176import Network.HTTP.Types.URI
177+import qualified Numeric.Lens
103178import Obelisk.Route.TH
104179import Text.Read (readMaybe)
105180
@@ -127,100 +202,237 @@ import Text.Read (readMaybe)
127202
128203type R f = DSum f Identity --TODO: Better name
129204
130−--TODO: COMPLETE pragma
131−infixr 5 :/
205+-- | Convenience builder for an 'R' using 'Identity' for the functor.
132206pattern (:/) :: f a -> a -> R f
133207pattern 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 ?/
134215
135216mapSome :: (forall a. f a -> g a) -> Some f -> Some g
136−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
137221
138222--------------------------------------------------------------------------------
139−-- Encoder fundamentals
223+-- Dealing with pairs (i.e. non-dependently-typed subroutes/paths)
140224--------------------------------------------------------------------------------
141225
142−newtype Encoder check parse decoded encoded = Encoder { unEncoder :: check (ValidEncoder parse decoded encoded) }
226+infixr 5 :.
227+type (:.) = (,)
228+
229+#ifdef __GLASGOW_HASKELL__
230+#if __GLASGOW_HASKELL__ >= 810
231+{-# COMPLETE (:.) #-}
232+#else
233+{-# WARNING (:.)
234+ [ "Use of this pattern in GHC < 8.10 will result in spurious non-exhaustive warnings at every use site."
235+ , "We cannot provide a COMPLETE pragma to silence these due to a GHC bug: https://gitlab.haskell.org/ghc/ghc/issues/17729."
236+ , "The bug hides incompleteness warnings for all two tuples when the COMPLETE pattern is in scope."
237+ , "Instead, you should use (,) directly until you can switch to GHC >= 8.10, where the COMPLETE pragma is reinstated."
238+ ]
239+ #-}
240+#endif
241+#endif
242+pattern (:.) :: a -> b -> a :. b
243+pattern a :. b = (a, b)
244+
245+addPathSegmentEncoder
246+ :: ( Applicative check
247+ , MonadError Text parse
248+ )
249+ => Encoder check parse (Text, PageName) PageName
250+addPathSegmentEncoder = unsafeMkEncoder $ EncoderImpl
251+ { _encoderImpl_encode = \(ph, (pt, q)) -> (ph : pt, q)
252+ , _encoderImpl_decode = \(p, q) -> case p of
253+ [] -> throwError "Expected a path segment"
254+ ph : pt -> pure (ph, (pt, q))
255+ }
256+
257+pathParamEncoder
258+ :: forall check parse item rest.
259+ ( Applicative check
260+ , MonadError Text parse
261+ )
262+ => Encoder check parse item Text
263+ -> Encoder check parse rest PageName
264+ -> Encoder check parse (item :. rest) PageName
265+pathParamEncoder itemUnchecked restUnchecked = addPathSegmentEncoder . bimap itemUnchecked restUnchecked
266+
267+pathLiteralEncoder
268+ :: ( Applicative check
269+ , MonadError Text parse
270+ )
271+ => Text
272+ -> Encoder check parse a PageName
273+ -> Encoder check parse a PageName
274+pathLiteralEncoder t e = addPathSegmentEncoder . bimap (unitEncoder t) e . coidl
275+
276+--------------------------------------------------------------------------------
277+-- Encoder fundamentals
278+--------------------------------------------------------------------------------
143279
144−-- | Law:
145−-- forall p. _validEncoder_decode ve . _validEncoder_encode ve p == pure
146−-- Note that the reverse may not be the case: when parsing, a route may be canonicalized, and erroneous routes may be collapsed to a single 404 route. However, as a consequence of the law, encode . decode must be idemponent.
147−data ValidEncoder parse decoded encoded = ValidEncoder
148− { _validEncoder_decode :: !(encoded -> parse decoded) -- Can fail; can lose information; must always succeed on outputs of `_validEncoder_encode` and result in the original value
149− , _validEncoder_encode :: !(decoded -> encoded) -- Must be injective
280+-- | This is the type of route encoder/decoders. It is parameterised over two monads: Firstly, the monad
281+-- used to check the validity of the encoder (i.e. that it is total), secondly the monad used for parsing
282+-- during the decode phase. The following two parameters are respectively the type of decoded data, and the
283+-- encoded type.
284+newtype Encoder check parse decoded encoded =
285+ Encoder { unEncoder :: check (EncoderImpl parse decoded encoded) }
286+
287+unsafeEncoder :: check (EncoderImpl parse decoded encoded) -> Encoder check parse decoded encoded
288+unsafeEncoder = Encoder
289+
290+-- | The internal type used to construct primitive 'Encoder' values.
291+-- Law:
292+-- forall p. _encoderImpl_decode ve . _encoderImpl_encode ve p == pure
293+-- Note that the reverse may not be the case: when parsing, a route may be canonicalized, and erroneous routes may be collapsed to a single 404 route. However, as a consequence of the law, encode . decode must be idempotent.
294+data EncoderImpl parse decoded encoded = EncoderImpl
295+ { _encoderImpl_decode :: !(encoded -> parse decoded) -- Can fail; can lose information; must always succeed on outputs of `_encoderImpl_encode` and result in the original value
296+ , _encoderImpl_encode :: !(decoded -> encoded) -- Must be injective
150297 }
151298
152−checkEncoder :: Encoder check parse decoded encoded -> check (ValidEncoder parse decoded encoded)
153−checkEncoder = unEncoder
299+-- | Once an 'Encoder' has been checked, so that its check monad has become 'Identity', and its parser is total
300+-- so that its parse monad is also 'Identity', it may be used to actually decode by applying this function.
301+decode :: Encoder Identity Identity decoded encoded -> encoded -> decoded
302+decode e x = runIdentity (tryDecode e x)
303+
304+-- | Once an 'Encoder' has been checked, so that its check monad has become 'Identity', even if the same is not true of the
305+-- parse monad, we may still attempt to decode with it in its parse monad.
306+tryDecode :: Encoder Identity parse decoded encoded -> encoded -> parse decoded
307+tryDecode (Encoder (Identity impl)) = _encoderImpl_decode impl
308+
309+-- | Similar to 'decode', once an encoder has been checked so that its check monad is Identity, it
310+-- can be used to actually encode by using this. Note that while there's no constraint on the parse monad here,
311+-- one should usually be applying decode and encode to the same 'Encoder'
312+encode :: Encoder Identity parse decoded encoded -> decoded -> encoded
313+encode (Encoder (Identity impl)) = _encoderImpl_encode impl
314+
315+-- | This is a primitive used to build encoders which can't fail to check. It should not be used unless one is
316+-- reasonably certain that the law given for 'EncoderImpl' above holds.
317+unsafeMkEncoder :: (Applicative check) => EncoderImpl parse decoded encoded -> Encoder check parse decoded encoded
318+unsafeMkEncoder impl = Encoder (pure impl)
319+
320+-- | Transform the check monad of an 'Encoder' by applying a natural transformation.
321+hoistCheck :: (forall t. check t -> check' t) -> Encoder check parse a b -> Encoder check' parse a b
322+hoistCheck f (Encoder x) = Encoder (f x)
323+
324+-- | Transform the parse monad of an 'Encoder' by applying a natural transformation.
325+hoistParse :: (Functor check)
326+ => (forall t. parse t -> parse' t) -> Encoder check parse a b -> Encoder check parse' a b
327+hoistParse f (Encoder x) = Encoder (fmap (\(EncoderImpl dec enc) -> EncoderImpl (f . dec) enc) x)
328+
329+-- | Check an 'Encoder', transforming it into one whose check monad is anything we want (usually Identity).
330+checkEncoder :: (Applicative check', Functor check)
331+ => Encoder check parse decoded encoded
332+ -> check (Encoder check' parse decoded encoded)
333+checkEncoder = fmap unsafeMkEncoder . unEncoder
154334
155335instance (Applicative check, Monad parse) => Category (Encoder check parse) where
156336 id = Encoder $ pure id
157337 Encoder f . Encoder g = Encoder $ liftA2 (.) f g
158338
159−instance Monad parse => Category (ValidEncoder parse) where
160− id = ValidEncoder
161− { _validEncoder_decode = pure
162− , _validEncoder_encode = id
339+instance Monad parse => Category (EncoderImpl parse) where
340+ id = EncoderImpl
341+ { _encoderImpl_decode = pure
342+ , _encoderImpl_encode = id
163343 }
164− f . g = ValidEncoder
165− { _validEncoder_decode = _validEncoder_decode g <=< _validEncoder_decode f
166− , _validEncoder_encode = _validEncoder_encode f . _validEncoder_encode g
344+ f . g = EncoderImpl
345+ { _encoderImpl_decode = _encoderImpl_decode g <=< _encoderImpl_decode f
346+ , _encoderImpl_encode = _encoderImpl_encode f . _encoderImpl_encode g
167347 }
168348
169−instance Monad parse => PFunctor (,) (ValidEncoder parse) (ValidEncoder parse) where
349+instance Monad parse => PFunctor (,) (EncoderImpl parse) (EncoderImpl parse) where
170350 first f = bimap f id
171−instance Monad parse => QFunctor (,) (ValidEncoder parse) (ValidEncoder parse) where
351+instance Monad parse => QFunctor (,) (EncoderImpl parse) (EncoderImpl parse) where
172352 second g = bimap id g
173−instance Monad parse => Bifunctor (,) (ValidEncoder parse) (ValidEncoder parse) (ValidEncoder parse) where
174− bimap f g = ValidEncoder
175− { _validEncoder_encode = bimap (_validEncoder_encode f) (_validEncoder_encode g)
176− , _validEncoder_decode = \(a, b) -> liftA2 (,) (_validEncoder_decode f a) (_validEncoder_decode g b)
353+instance Monad parse => Bifunctor (,) (EncoderImpl parse) (EncoderImpl parse) (EncoderImpl parse) where
354+ bimap f g = EncoderImpl
355+ { _encoderImpl_encode = bimap (_encoderImpl_encode f) (_encoderImpl_encode g)
356+ , _encoderImpl_decode = \(a, b) -> liftA2 (,) (_encoderImpl_decode f a) (_encoderImpl_decode g b)
177357 }
178358
359+instance (Monad parse, Applicative check) => Braided (Encoder check parse) (,) where
360+ braid = viewEncoder (iso swap swap)
361+
362+
179363instance (Applicative check, Monad parse) => PFunctor (,) (Encoder check parse) (Encoder check parse) where
180364 first f = bimap f id
181365instance (Applicative check, Monad parse) => QFunctor (,) (Encoder check parse) (Encoder check parse) where
182366 second g = bimap id g
183367instance (Applicative check, Monad parse) => Bifunctor (,) (Encoder check parse) (Encoder check parse) (Encoder check parse) where
184− bimap f g = Encoder $ liftA2 bimap (checkEncoder f) (checkEncoder g)
368+ bimap f g = Encoder $ liftA2 bimap (unEncoder f) (unEncoder g)
185369
186−instance (Traversable f, Monad parse) => Cat.Functor f (ValidEncoder parse) (ValidEncoder parse) where
187− fmap ve = ValidEncoder
188− { _validEncoder_encode = fmap $ _validEncoder_encode ve
189− , _validEncoder_decode = traverse $ _validEncoder_decode ve
370+instance (Traversable f, Monad parse) => Cat.Functor f (EncoderImpl parse) (EncoderImpl parse) where
371+ fmap ve = EncoderImpl
372+ { _encoderImpl_encode = fmap $ _encoderImpl_encode ve
373+ , _encoderImpl_decode = traverse $ _encoderImpl_decode ve
190374 }
191375
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+
192404instance (Traversable f, Monad check, Monad parse) => Cat.Functor f (Encoder check parse) (Encoder check parse) where
193405 fmap e = Encoder $ do
194− ve <- checkEncoder e
406+ ve <- unEncoder e
195407 pure $ Cat.fmap ve
196408
197−instance Monad parse => Associative (ValidEncoder parse) (,) where
198− associate = ValidEncoder
199− { _validEncoder_encode = associate
200− , _validEncoder_decode = pure . disassociate
409+instance Monad parse => Associative (EncoderImpl parse) (,) where
410+ associate = EncoderImpl
411+ { _encoderImpl_encode = associate
412+ , _encoderImpl_decode = pure . disassociate
201413 }
202− disassociate = ValidEncoder
203− { _validEncoder_encode = disassociate
204− , _validEncoder_decode = pure . associate
414+ disassociate = EncoderImpl
415+ { _encoderImpl_encode = disassociate
416+ , _encoderImpl_decode = pure . associate
205417 }
206418
207−instance Monad parse => Monoidal (ValidEncoder parse) (,) where
208− type Id (ValidEncoder parse) (,) = ()
209− idl = ValidEncoder
210− { _validEncoder_encode = idl
211− , _validEncoder_decode = pure . coidl
419+instance Monad parse => Monoidal (EncoderImpl parse) (,) where
420+ type Id (EncoderImpl parse) (,) = ()
421+ idl = EncoderImpl
422+ { _encoderImpl_encode = idl
423+ , _encoderImpl_decode = pure . coidl
212424 }
213− idr = ValidEncoder
214− { _validEncoder_encode = idr
215− , _validEncoder_decode = pure . coidr
425+ idr = EncoderImpl
426+ { _encoderImpl_encode = idr
427+ , _encoderImpl_decode = pure . coidr
216428 }
217− coidl = ValidEncoder
218− { _validEncoder_encode = coidl
219− , _validEncoder_decode = pure . idl
429+ coidl = EncoderImpl
430+ { _encoderImpl_encode = coidl
431+ , _encoderImpl_decode = pure . idl
220432 }
221− coidr = ValidEncoder
222− { _validEncoder_encode = coidr
223− , _validEncoder_decode = pure . idr
433+ coidr = EncoderImpl
434+ { _encoderImpl_encode = coidr
435+ , _encoderImpl_decode = pure . idr
224436 }
225437
226438instance (Applicative check, Monad parse) => Associative (Encoder check parse) (,) where
@@ -234,53 +446,120 @@ instance (Applicative check, Monad parse) => Monoidal (Encoder check parse) (,)
234446 coidl = Encoder $ pure coidl
235447 coidr = Encoder $ pure coidr
236448
237−
238449--------------------------------------------------------------------------------
239450-- Specific instances of encoders
240451--------------------------------------------------------------------------------
241452
242−-- | A path and query string, in which trailing slashes don't matter in the path
243−-- and duplicate query parameters are not allowed
244−type PageName = ([Text], Map Text (Maybe Text))
453+-- | Given a valid 'Iso' from lens, construct an 'Encoder'
454+viewEncoder :: (Applicative check, Applicative parse) => Iso' a b -> Encoder check parse a b
455+viewEncoder f = unsafeMkEncoder $ EncoderImpl
456+ { _encoderImpl_encode = view f
457+ , _encoderImpl_decode = pure . view (from f)
458+ }
245459
246−newtype Flip f a b = Flip { unFlip :: f b a }
460+wrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse (Unwrapped a) a
461+wrappedEncoder = viewEncoder $ from _Wrapped'
247462
248−someConstValidEncoder :: Applicative parse => ValidEncoder parse (Some (Const a)) a
249−someConstValidEncoder = ValidEncoder
250− { _validEncoder_encode = \(Some.This (Const a)) -> a
251− , _validEncoder_decode = pure . Some.This . Const
463+unwrappedEncoder :: (Wrapped a, Applicative check, Applicative parse) => Encoder check parse a (Unwrapped a)
464+unwrappedEncoder = viewEncoder $ _Wrapped'
465+
466+maybeToEitherEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a) (Either () a)
467+maybeToEitherEncoder = unsafeMkEncoder $ EncoderImpl
468+ { _encoderImpl_encode = \case
469+ Nothing -> Left ()
470+ Just a -> Right a
471+ , _encoderImpl_decode = pure . \case
472+ Left _ -> Nothing
473+ Right a -> Just a
474+ }
475+
476+maybeEncoder
477+ :: ( MonadError Text check
478+ , Show a
479+ , Show b
480+ , check ~ parse
481+ )
482+ => Encoder check parse () b
483+ -> Encoder check parse a b
484+ -> Encoder check parse (Maybe a) b
485+maybeEncoder f g = shadowEncoder f g . maybeToEitherEncoder
486+
487+-- | Encode a value by simply applying 'Just'
488+justEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a (Maybe a)
489+justEncoder = reviewEncoder _Just
490+
491+-- | Encode () to 'Nothing'.
492+nothingEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse () (Maybe a)
493+nothingEncoder = reviewEncoder _Nothing
494+
495+someConstEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Const a)) a
496+someConstEncoder = unsafeMkEncoder $ EncoderImpl
497+ { _encoderImpl_encode = \(Some (Const a)) -> a
498+ , _encoderImpl_decode = pure . Some . Const
252499 }
253500
254501-- | WARNING: This is only safe if the Show and Read instances for 'a' are
255502-- inverses of each other
256−unsafeTshowValidEncoder :: (Show a, Read a, MonadError Text parse) => ValidEncoder parse a Text
257−unsafeTshowValidEncoder = ValidEncoder
258− { _validEncoder_encode = tshow
259− , _validEncoder_decode = \raw -> case readMaybe $ T.unpack raw of
260− Nothing -> throwError $ "unsafeTshowValidEncoder: couldn't decode " <> tshow raw
503+unsafeTshowEncoder :: (Show a, Read a, Applicative check, MonadError Text parse) => Encoder check parse a Text
504+unsafeTshowEncoder = unsafeMkEncoder $ EncoderImpl
505+ { _encoderImpl_encode = tshow
506+ , _encoderImpl_decode = \raw -> case readMaybe $ T.unpack raw of
507+ Nothing -> throwError $ "unsafeTshowEncoderImpl: couldn't decode " <> tshow raw
261508 Just parsed -> pure parsed
262509 }
263510
264−justValidEncoder :: MonadError Text parse => ValidEncoder parse a (Maybe a)
265−justValidEncoder = prismValidEncoder _Just
266−
267−nothingValidEncoder :: MonadError Text parse => ValidEncoder parse () (Maybe a)
268−nothingValidEncoder = prismValidEncoder _Nothing
269−
270−isoValidEncoder :: Applicative parse => Iso' a b -> ValidEncoder parse a b
271−isoValidEncoder f = ValidEncoder
272− { _validEncoder_encode = view f
273− , _validEncoder_decode = pure . view (from f)
274− }
511+newtype EncoderFunc check parse p r = EncoderFunc { runEncoderImplFunc :: forall a. p a -> Encoder check parse a r }
275512
276−wrappedValidEncoder :: (Wrapped a, Applicative parse) => ValidEncoder parse (Unwrapped a) a
277−wrappedValidEncoder = isoValidEncoder $ from _Wrapped'
278−
279−unwrappedValidEncoder :: (Wrapped a, Applicative parse) => ValidEncoder parse a (Unwrapped a)
280−unwrappedValidEncoder = isoValidEncoder _Wrapped'
513+newtype Flip f a b = Flip { unFlip :: f b a }
281514
282−pathComponentEncoder :: forall check parse p. (Monad check, Monad parse) => (Encoder check parse (Some p) (Maybe Text)) -> (forall a. p a -> ValidEncoder parse a PageName) -> Encoder check parse (R p) PageName
283−pathComponentEncoder this rest = chainEncoder (lensEncoder (\(_, b) a -> (a, b)) Prelude.fst consValidEncoder) this rest
515+checkEnum1EncoderFunc
516+ :: forall check check' parse p r.
517+ ( Universe (Some p)
518+ , GCompare p
519+ , Monad check
520+ , Applicative check'
521+ )
522+ => (forall a. p a -> Encoder check parse a r)
523+ -> check (EncoderFunc check' parse p r)
524+checkEnum1EncoderFunc f = do
525+ (encoderImpls :: DMap p (Flip (EncoderImpl parse) r)) <- DMap.fromList <$>
526+ traverse (\(Some p) -> (p :=>) . Flip <$> unEncoder (f p)) universe
527+ pure $ EncoderFunc $ \p -> unsafeMkEncoder . unFlip $
528+ DMap.findWithDefault (error "checkEnum1EncoderFunc: EncoderImpl not found (should be impossible)") p encoderImpls
529+
530+-- | This type is used by pathComponentEncoder to allow the user to indicate how to treat various cases when encoding a dependent sum of type `(R p)`.
531+data SegmentResult check parse a =
532+ PathEnd (Encoder check parse a (Map Text (Maybe Text))) -- ^ Indicate that the path is finished, with an Encoder that translates the corresponding value into query parameters
533+ | PathSegment Text (Encoder check parse a PageName) -- ^ Indicate that the key should be represented by an additional path segment with the given 'Text', and give an Encoder for translating the corresponding value into the remainder of the route.
534+
535+-- | Encode a dependent sum of type `(R p)` into a PageName (i.e. the path and query part of a URL) by using the
536+-- supplied function to decide how to encode the constructors of p using the SegmentResult type. It is important
537+-- that the number of values of type `(Some p)` be relatively small in order for checking to complete quickly.
538+pathComponentEncoder
539+ :: forall check parse p.
540+ ( Universe (Some p)
541+ , GShow p
542+ , GCompare p
543+ , MonadError Text check
544+ , MonadError Text parse )
545+ => (forall a. p a -> SegmentResult check parse a)
546+ -> Encoder check parse (R p) PageName
547+pathComponentEncoder f = Encoder $ do
548+ let extractEncoder = \case
549+ PathEnd e -> first (unitEncoder []) . coidl . e
550+ PathSegment _ e -> e
551+ extractPathSegment = \case
552+ PathEnd _ -> Nothing
553+ PathSegment t _ -> Just t
554+ EncoderFunc f' <- checkEnum1EncoderFunc (extractEncoder . f)
555+ unEncoder (pathComponentEncoderImpl (enum1Encoder (extractPathSegment . f)) f')
556+
557+pathComponentEncoderImpl :: forall check parse p. (Monad check, Monad parse)
558+ => Encoder check parse (Some p) (Maybe Text)
559+ -> (forall a. p a -> Encoder Identity parse a PageName)
560+ -> Encoder check parse (R p) PageName
561+pathComponentEncoderImpl =
562+ chainEncoder (lensEncoder (\(_, b) a -> (a, b)) Prelude.fst consEncoder)
284563
285564--NOTE: Naming convention in this module is to always talk about things in the *encoding* direction, never in the *decoding* direction
286565
@@ -289,34 +568,41 @@ chainEncoder
289568 ( Monad check
290569 , Monad parse
291570 )
292− => ValidEncoder parse (b, r) r
571+ => Encoder check parse (b, r) r
293572 -> Encoder check parse (Some p) b
294− -> (forall a. p a -> ValidEncoder parse a r)
573+ -> (forall a. p a -> Encoder Identity parse a r)
295574 -> Encoder check parse (R p) r
296575chainEncoder cons this rest = Encoder $ do
297− thisValid <- checkEncoder this
298− pure $ ValidEncoder
299− { _validEncoder_decode = \v -> do
300− (here, following) <- _validEncoder_decode cons v
301− Some.This r <- _validEncoder_decode thisValid here
302− (r :/) <$> _validEncoder_decode (rest r) following
303− , _validEncoder_encode = \(r :/ s) ->
304− _validEncoder_encode cons (_validEncoder_encode thisValid $ Some.This r, _validEncoder_encode (rest r) s)
576+ consValid <- unEncoder cons
577+ thisValid <- unEncoder this
578+ pure $ EncoderImpl
579+ { _encoderImpl_decode = \v -> do
580+ (here, following) <- _encoderImpl_decode consValid v
581+ _encoderImpl_decode thisValid here >>= \case
582+ Some r ->
583+ (r :/) <$> _encoderImpl_decode (runIdentity . unEncoder $ rest r) following
584+ , _encoderImpl_encode = \(r :/ s) ->
585+ _encoderImpl_encode consValid
586+ ( _encoderImpl_encode thisValid $ Some r
587+ , _encoderImpl_encode (runIdentity . unEncoder $ rest r) s)
305588 }
306589
307590--TODO: Do this in terms of a lens instead
308−lensEncoder :: Monad parse => (b -> [a] -> b) -> (b -> [a]) -> ValidEncoder parse (c, [a]) [a] -> ValidEncoder parse (c, b) b
309−lensEncoder set get g = ValidEncoder
310− { _validEncoder_encode = \(ma, b) -> set b $ _validEncoder_encode g (ma, get b)
311− , _validEncoder_decode = \b -> do
312− (ma, la) <- _validEncoder_decode g $ get b
313− pure (ma, set b la)
314− }
591+lensEncoder :: (Applicative check, Monad parse)
592+ => (b -> [a] -> b) -> (b -> [a]) -> Encoder check parse (c, [a]) [a] -> Encoder check parse (c, b) b
593+lensEncoder set get g = Encoder $ do
594+ gImpl <- unEncoder g
595+ pure $ EncoderImpl
596+ { _encoderImpl_encode = \(ma, b) -> set b $ _encoderImpl_encode gImpl (ma, get b)
597+ , _encoderImpl_decode = \b -> do
598+ (ma, la) <- _encoderImpl_decode gImpl $ get b
599+ pure (ma, set b la)
600+ }
315601
316−consValidEncoder :: Applicative parse => ValidEncoder parse (Maybe a, [a]) [a] --TODO: Really shouldn't *always* have the [a], even in the Nothing case
317−consValidEncoder = ValidEncoder
318− { _validEncoder_encode = \(h, t) -> maybeToList h <> t
319− , _validEncoder_decode = pure . \case
602+consEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Maybe a, [a]) [a] --TODO: Really shouldn't *always* have the [a], even in the Nothing case
603+consEncoder = unsafeMkEncoder $ EncoderImpl
604+ { _encoderImpl_encode = \(h, t) -> maybeToList h <> t
605+ , _encoderImpl_decode = pure . \case
320606 [] -> (Nothing, [])
321607 h:t -> (Just h, t)
322608 }
@@ -336,35 +622,35 @@ shadowEncoder
336622 -> Encoder check parse b c -- ^ Gets overlapped
337623 -> Encoder check parse (Either a b) c
338624shadowEncoder f g = Encoder $ do
339− vf <- checkEncoder f
340− vg <- checkEncoder g
341− let gCanParse c = catchError (Just <$> _validEncoder_decode vg c) (\_ -> pure Nothing)
625+ vf <- unEncoder f
626+ vg <- unEncoder g
627+ let gCanParse c = catchError (Just <$> _encoderImpl_decode vg c) (\_ -> pure Nothing)
342628 overlaps <- fmap catMaybes $ forM universe $ \a -> do
343− let c = _validEncoder_encode vf a
629+ let c = _encoderImpl_encode vf a
344630 mb <- gCanParse c
345631 pure $ fmap (\b -> (a, b, c)) mb
346632 case overlaps of
347633 [] -> pure ()
348634 _ -> throwError $ "shadowEncoder: overlap detected: " <> T.unlines
349635 (flip fmap overlaps $ \(a, b, c) -> "first encoder encodes " <> tshow a <> " as " <> tshow c <> ", which second encoder decodes as " <> tshow b)
350− pure $ ValidEncoder
351− { _validEncoder_encode = \case
352− Left a -> _validEncoder_encode vf a
353− Right b -> _validEncoder_encode vg b
354− , _validEncoder_decode = \c -> (Left <$> _validEncoder_decode vf c) `catchError` \_ -> Right <$> _validEncoder_decode vg c
636+ pure $ EncoderImpl
637+ { _encoderImpl_encode = \case
638+ Left a -> _encoderImpl_encode vf a
639+ Right b -> _encoderImpl_encode vg b
640+ , _encoderImpl_decode = \c -> (Left <$> _encoderImpl_decode vf c) `catchError` \_ -> Right <$> _encoderImpl_decode vg c
355641 }
356642
357643enum1Encoder
358644 :: ( Universe (Some p)
359645 , GShow p
360646 , GCompare p
361− , Ord r
362647 , MonadError Text check
363648 , MonadError Text parse
649+ , Ord r
364650 , Show r
365651 )
366652 => (forall a. p a -> r) -> Encoder check parse (Some p) r
367−enum1Encoder f = enumEncoder $ \(Some.This p) -> f p
653+enum1Encoder f = enumEncoder $ \(Some p) -> f p
368654
369655-- | Encode an enumerable, bounded type. WARNING: Don't use this on types that
370656-- have a large number of values - it will use a lot of memory.
@@ -381,40 +667,43 @@ enumEncoder f = Encoder $ do
381667 case itraverse checkSingleton reversed :: Validation (Map r (Set p)) (Map r p) of
382668 Failure ambiguousEntries -> throwError $ T.unlines $
383669 "enumEncoder: ambiguous encodings detected:" : concat (Map.elems $ imap showRedundant ambiguousEntries)
384− Success m -> pure $ ValidEncoder
385− { _validEncoder_decode = \r -> case Map.lookup r m of
670+ Success m -> pure $ EncoderImpl
671+ { _encoderImpl_decode = \r -> case Map.lookup r m of
386672 Just a -> pure a
387673 Nothing -> throwError $ "enumEncoder: not recognized: " <> tshow r --TODO: Report this as a better type
388− , _validEncoder_encode = f
674+ , _encoderImpl_encode = f
389675 }
390676
391−endValidEncoder :: (MonadError Text parse, Show r, Eq r) => r -> ValidEncoder parse () r
392−endValidEncoder expected = ValidEncoder
393− { _validEncoder_decode = \obtained ->
677+unitEncoder :: (Applicative check, MonadError Text parse, Show r, Eq r) => r -> Encoder check parse () r
678+unitEncoder expected = unsafeMkEncoder $ EncoderImpl
679+ { _encoderImpl_decode = \obtained ->
394680 if obtained == expected
395681 then pure ()
396− else throwError $ "endValidEncoder: expected " <> tshow expected <> ", got " <> tshow obtained
397− , _validEncoder_encode = \_ -> expected
682+ else throwError $ "endEncoderImpl: expected " <> tshow expected <> ", got " <> tshow obtained
683+ , _encoderImpl_encode = \_ -> expected
398684 }
399685
400−singlePathSegmentValidEncoder :: MonadError Text parse => ValidEncoder parse Text PageName
401−singlePathSegmentValidEncoder = pathOnlyValidEncoder . singletonListValidEncoder
686+singlePathSegmentEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse Text PageName
687+singlePathSegmentEncoder = pathOnlyEncoder . singletonListEncoder
402688
403−pathOnlyValidEncoder :: (MonadError Text parse) => ValidEncoder parse [Text] PageName
404−pathOnlyValidEncoder = ValidEncoder
405− { _validEncoder_decode = \(path, query) ->
406− if query == mempty
407− then pure path
408− else throwError "pathOnlyValidEncoder: query was provided"
409− , _validEncoder_encode = \path -> (path, mempty)
689+pathOnlyEncoderIgnoringQuery :: (Applicative check, MonadError Text parse) => Encoder check parse [Text] PageName
690+pathOnlyEncoderIgnoringQuery = unsafeMkEncoder $ EncoderImpl
691+ { _encoderImpl_decode = \(path, _query) -> pure path
692+ , _encoderImpl_encode = \path -> (path, mempty)
410693 }
411694
412−singletonListValidEncoder :: (MonadError Text parse) => ValidEncoder parse a [a]
413−singletonListValidEncoder = ValidEncoder
414− { _validEncoder_decode = \case
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+
701+singletonListEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse a [a]
702+singletonListEncoder = unsafeMkEncoder $ EncoderImpl
703+ { _encoderImpl_decode = \case
415704 [a] -> pure a
416− l -> throwError $ "singletonListValidEncoder: expected one item, got " <> tshow (length l)
417− , _validEncoder_encode = (:[])
705+ l -> throwError $ "singletonListEncoderImpl: expected one item, got " <> tshow (length l)
706+ , _encoderImpl_encode = (:[])
418707 }
419708
420709splitTextNonEmpty :: Text -> Text -> NonEmpty Text
@@ -423,18 +712,18 @@ splitTextNonEmpty separator v = case T.splitOn separator v of
423712 h : t -> h :| t
424713
425714--TODO: To know this is reversible, we must know that the separator isn't included anywhere in the input text
426−pathSegmentsTextEncoder :: (MonadError Text check, Applicative parse) => Encoder check parse (NonEmpty Text) Text
427−pathSegmentsTextEncoder = Encoder $ pure $ ValidEncoder
428− { _validEncoder_encode = T.intercalate "/" . fmap (urlEncodeText False) . toList
429− , _validEncoder_decode = pure . fmap (urlDecodeText False) . splitTextNonEmpty "/"
715+pathSegmentsTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse (NonEmpty Text) Text
716+pathSegmentsTextEncoder = unsafeMkEncoder $ EncoderImpl
717+ { _encoderImpl_encode = T.intercalate "/" . fmap (urlEncodeText False) . toList
718+ , _encoderImpl_decode = pure . fmap (urlDecodeText False) . splitTextNonEmpty "/"
430719 }
431720
432721queryParametersTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse [(Text, Maybe Text)] Text
433−queryParametersTextEncoder = Encoder $ pure $ ValidEncoder
434− { _validEncoder_encode = \case
722+queryParametersTextEncoder = Encoder $ pure $ EncoderImpl
723+ { _encoderImpl_encode = \case
435724 [] -> ""
436725 params -> T.intercalate "&" (fmap encodeParameter params)
437− , _validEncoder_decode = pure . \case
726+ , _encoderImpl_decode = pure . \case
438727 "" -> []
439728 encoded ->
440729 let h :| t = splitTextNonEmpty "&" encoded
@@ -450,60 +739,60 @@ queryParametersTextEncoder = Encoder $ pure $ ValidEncoder
450739 in (urlDecodeText True k, urlDecodeText True <$> mv)
451740
452741urlEncodeText :: Bool -> Text -> Text
453−urlEncodeText q = decodeUtf8 . urlEncode q . encodeUtf8
742+urlEncodeText q = T.decodeUtf8 . urlEncode q . T.encodeUtf8
454743
455744urlDecodeText :: Bool -> Text -> Text
456−urlDecodeText q = decodeUtf8 . urlDecode q . encodeUtf8
745+urlDecodeText q = T.decodeUtf8 . urlDecode q . T.encodeUtf8
457746
458747listToNonEmptyEncoder :: (Applicative check, Applicative parse, Monoid a, Eq a) => Encoder check parse [a] (NonEmpty a)
459−listToNonEmptyEncoder = Encoder $ pure $ ValidEncoder
460− { _validEncoder_encode = \case
748+listToNonEmptyEncoder = Encoder $ pure $ EncoderImpl
749+ { _encoderImpl_encode = \case
461750 [] -> mempty :| []
462751 h : t -> h :| t
463− , _validEncoder_decode = \(h :| t) -> pure $
752+ , _encoderImpl_decode = \(h :| t) -> pure $
464753 if h == mempty
465754 then []
466755 else h : t
467756 }
468757
469758prefixTextEncoder :: (Applicative check, MonadError Text parse) => Text -> Encoder check parse Text Text
470−prefixTextEncoder p = Encoder $ pure $ ValidEncoder
471− { _validEncoder_encode = mappend p
472− , _validEncoder_decode = \v -> case T.stripPrefix p v of
759+prefixTextEncoder p = Encoder $ pure $ EncoderImpl
760+ { _encoderImpl_encode = mappend p
761+ , _encoderImpl_decode = \v -> case T.stripPrefix p v of
473762 Nothing -> throwError $ "prefixTextEncoder: wrong prefix; expected " <> tshow p <> ", got " <> tshow (T.take (T.length p) v)
474763 Just stripped -> pure stripped
475764 }
476765
477766prefixNonemptyTextEncoder :: (Applicative check, MonadError Text parse) => Text -> Encoder check parse Text Text
478−prefixNonemptyTextEncoder p = Encoder $ pure $ ValidEncoder
479− { _validEncoder_encode = \case
767+prefixNonemptyTextEncoder p = Encoder $ pure $ EncoderImpl
768+ { _encoderImpl_encode = \case
480769 "" -> ""
481770 v -> p <> v
482− , _validEncoder_decode = \case
771+ , _encoderImpl_decode = \case
483772 "" -> pure ""
484773 v -> case T.stripPrefix p v of
485774 Nothing -> throwError $ "prefixTextEncoder: wrong prefix; expected " <> tshow p
486775 Just stripped -> pure stripped
487776 }
488777
489−unpackTextEncoder :: (Applicative check, Applicative parse) => Encoder check parse Text String
490−unpackTextEncoder = Encoder $ pure $ ValidEncoder
491− { _validEncoder_encode = T.unpack
492− , _validEncoder_decode = pure . T.pack
493− }
778+packTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse String text
779+packTextEncoder = isoEncoder packed
780+
781+unpackTextEncoder :: (Applicative check, Applicative parse, IsText text) => Encoder check parse text String
782+unpackTextEncoder = isoEncoder unpacked
494783
495784toListMapEncoder :: (Applicative check, Applicative parse, Ord k) => Encoder check parse (Map k v) [(k, v)]
496−toListMapEncoder = Encoder $ pure $ ValidEncoder
497− { _validEncoder_encode = Map.toList
498− , _validEncoder_decode = pure . Map.fromList --TODO: Should we be stricter about repeated keys?
785+toListMapEncoder = Encoder $ pure $ EncoderImpl
786+ { _encoderImpl_encode = Map.toList
787+ , _encoderImpl_decode = pure . Map.fromList --TODO: Should we be stricter about repeated keys?
499788 }
500789
501790joinPairTextEncoder :: (MonadError Text check, MonadError Text parse) => Text -> Encoder check parse (Text, Text) Text
502791joinPairTextEncoder = Encoder . \case
503792 "" -> throwError "joinPairTextEncoder: empty separator"
504− separator -> pure $ ValidEncoder
505− { _validEncoder_encode = \(k, v) -> k <> separator <> v
506− , _validEncoder_decode = \r ->
793+ separator -> pure $ EncoderImpl
794+ { _encoderImpl_encode = \(k, v) -> k <> separator <> v
795+ , _encoderImpl_decode = \r ->
507796 let (kt, vt) = T.breakOn separator r
508797 in case vt of
509798 -- The separator was not found
@@ -511,142 +800,215 @@ joinPairTextEncoder = Encoder . \case
511800 _ -> return (kt, T.drop (T.length separator) vt)
512801 }
513802
514−--TODO: Rewrite this by composing the given prism with a lens on the first element of the DSum
515−-- Or, more likely, the user can compose it themselves
516−rPrism :: forall f g. (forall a. Prism' (f a) (g a)) -> Prism' (R f) (R g)
517−rPrism p = prism (\(g :/ x) -> g ^. re p :/ x) (\(f :/ x) -> bimap (:/ x) (:/ x) $ matching p f)
518−
519−-- An encoder that only works on the items available via the prism
520−prismValidEncoder :: MonadError Text parse => Prism' b a -> ValidEncoder parse a b
521−prismValidEncoder p = ValidEncoder
522− { _validEncoder_encode = (^. re p)
523− , _validEncoder_decode = \r -> case r ^? p of
803+-- This slight generalization of 'rPrism' happens to be enough to write all our
804+-- prism combinators so far.
805+dSumPrism
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
844+
845+-- | An encoder that only works on the items available via the prism. An error will be thrown in the parse monad
846+-- if the prism doesn't match.
847+--
848+-- Note that a 'Prism' from @a@ to @b@ will produce an 'Encoder' from @b@ to @a@
849+-- (i.e. 'reviewEncoder' is a contravariant functor from the category of prisms to the category of encoders),
850+-- just like 'review' produces a function @b -> a@. This is because 'Prism's extract values, in a way that might
851+-- fail, in their forward direction and inject values, in a way that cannot fail, in their reverse direction;
852+-- whereas 'Encoder's encode, which cannot fail, in their forward direction, and decode, which can fail, in their
853+-- reverse direction. In short @reviewEncoder (f . g) = reviewEncoder g . reviewEncoder f@.
854+reviewEncoder :: (Applicative check, MonadError Text parse) => Prism' b a -> Encoder check parse a b
855+reviewEncoder p = unsafeMkEncoder $ EncoderImpl
856+ { _encoderImpl_encode = review p
857+ , _encoderImpl_decode = \r -> case r ^? p of
524858 Just a -> pure a
525− Nothing -> throwError "prismValidEncoder: value is not present in the prism"
859+ Nothing -> throwError "reviewEncoder: value is not present in the prism"
526860 }
527861
862+-- | A URL path and query string, in which trailing slashes don't matter in the path
863+-- and duplicate query parameters are not allowed. A final goal of encoders using this library
864+-- will frequently be to produce this.
865+type PageName = ([Text], Map Text (Maybe Text))
528866
529−-- | Encode a PageName into a path and query string, suitable for use in the
530−-- 'URI' type
531−pageNameValidEncoder :: MonadError Text parse => ValidEncoder parse PageName (String, String)
532−pageNameValidEncoder = ve
533− where Right ve = checkEncoder $ bimap
534− (unpackTextEncoder . prefixTextEncoder "/" . pathSegmentsTextEncoder . listToNonEmptyEncoder)
535− (unpackTextEncoder . prefixNonemptyTextEncoder "?" . queryParametersTextEncoder . toListMapEncoder)
536−
537−catchValidEncoder :: (e -> a) -> ValidEncoder (Either e) a b -> ValidEncoder Identity a b
538−catchValidEncoder recover ve = ve
539− { _validEncoder_decode = \a -> pure $ case _validEncoder_decode ve a of
867+-- | A path (separated by slashes), and a query string.
868+type PathQuery = (String, String)
869+
870+-- | Encode a PageName into a path and query string.
871+pageNameEncoder :: (Applicative check, MonadError Text parse) => Encoder check parse PageName PathQuery
872+pageNameEncoder = bimap
873+ (unpackTextEncoder . prefixTextEncoder "/" . pathSegmentsTextEncoder . listToNonEmptyEncoder)
874+ (unpackTextEncoder . prefixNonemptyTextEncoder "?" . queryParametersTextEncoder . toListMapEncoder)
875+
876+-- | Handle an error in parsing, for example, in order to redirect to a 404 page.
877+handleEncoder
878+ :: (Functor check)
879+ => (e -> a)
880+ -> Encoder check (Either e) a b
881+ -> Encoder check Identity a b
882+handleEncoder recover e = Encoder $ do
883+ i <- unEncoder e
884+ return $ i
885+ { _encoderImpl_decode = \a -> pure $ case _encoderImpl_decode i a of
540886 Right r -> r
541887 Left err -> recover err
542− }
888+ }
543889
544890--------------------------------------------------------------------------------
545891-- Actual obelisk route info
546892--------------------------------------------------------------------------------
547893
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+
933+-- | A type which can represent Obelisk-specific resource routes, in addition to application specific routes which serve your
934+-- frontend.
548935data ObeliskRoute :: (* -> *) -> * -> * where
549936 -- We need to have the `f a` as an argument here, because otherwise we have no way to specifically check for overlap between us and the given encoder
550937 ObeliskRoute_App :: f a -> ObeliskRoute f a
551938 ObeliskRoute_Resource :: ResourceRoute a -> ObeliskRoute f a
552939
940+instance UniverseSome f => UniverseSome (ObeliskRoute f) where
941+ universeSome = concat
942+ [ (\(Some x) -> Some (ObeliskRoute_App x)) <$> universe
943+ , (\(Some x) -> Some (ObeliskRoute_Resource x)) <$> universe
944+ ]
945+
946+instance GEq f => GEq (ObeliskRoute f) where
947+ geq (ObeliskRoute_App x) (ObeliskRoute_App y) = geq x y
948+ geq (ObeliskRoute_Resource x) (ObeliskRoute_Resource y) = geq x y
949+ geq _ _ = Nothing
950+
951+instance GCompare f => GCompare (ObeliskRoute f) where
952+ gcompare (ObeliskRoute_App x) (ObeliskRoute_App y) = gcompare x y
953+ gcompare (ObeliskRoute_Resource x) (ObeliskRoute_Resource y) = gcompare x y
954+ gcompare (ObeliskRoute_App _) (ObeliskRoute_Resource _) = GLT
955+ gcompare (ObeliskRoute_Resource _) (ObeliskRoute_App _) = GGT
956+
957+-- | A type representing the various resource routes served by Obelisk. These can in principle map to any physical routes you want,
958+-- but sane defaults are provided by 'resourceRouteSegment'
553959data ResourceRoute :: * -> * where
554960 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")
555961 ResourceRoute_Ghcjs :: ResourceRoute [Text]
556962 ResourceRoute_JSaddleWarp :: ResourceRoute (R JSaddleWarpRoute)
557−
558−--TODO: Figure out a way to check this
559−obeliskComponentEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (ObeliskRoute f)) (Either (Some ResourceRoute) (Some f))
560−obeliskComponentEncoder = Encoder $ pure $ ValidEncoder
561− { _validEncoder_encode = \(Some.This o) -> case o of
562− ObeliskRoute_App r -> Right $ Some.This r
563− ObeliskRoute_Resource r -> Left $ Some.This r
564− , _validEncoder_decode = pure . \case
565− Right (Some.This r) -> Some.This $ ObeliskRoute_App r
566− Left (Some.This r) -> Some.This $ ObeliskRoute_Resource r
567− }
568−
569−newtype ValidEncoderFunc parse p r = ValidEncoderFunc { runValidEncoderFunc :: forall a. p a -> ValidEncoder parse a r }
570−
571−checkEnum1EncoderFunc
572− :: forall check parse p r.
573− ( Universe (Some p)
574− , GCompare p
575− , Monad check
576− )
577− => (forall a. p a -> Encoder check parse a r)
578− -> check (ValidEncoderFunc parse p r)
579−checkEnum1EncoderFunc f = do
580− validEncoders :: DMap p (Flip (ValidEncoder parse) r) <- DMap.fromList <$> traverse (\(Some.This p) -> (p :=>) . Flip <$> checkEncoder (f p)) universe
581− pure $ ValidEncoderFunc $ \p -> unFlip $ DMap.findWithDefault (error "checkEnum1EncoderFunc: ValidEncoder not found (should be impossible)") p validEncoders
582−
583−obeliskRouteEncoder
584− :: forall check parse appRoute.
585− ( Universe (Some appRoute)
586− , GCompare appRoute
963+ ResourceRoute_Version :: ResourceRoute ()
964+
965+-- | If there are no additional backend routes in your app (i.e. ObeliskRoute gives you all the routes you need),
966+-- this constructs a suitable 'Encoder' to use for encoding routes to 'PageName's. If you do have additional backend routes,
967+-- you'll want to use 'pathComponentEncoder' yourself, applied to a function that will likely use obeliskRouteSegment in order to
968+-- handle the ObeliskRoute case (i.e. Obelisk resource routes and app frontend routes).
969+obeliskRouteEncoder :: forall check parse appRoute.
970+ ( Universe (Some (ObeliskRoute appRoute))
971+ , GCompare (ObeliskRoute appRoute)
587972 , GShow appRoute
588973 , MonadError Text check
589974 , check ~ parse --TODO: Get rid of this
590975 )
591− => (Encoder check parse (Some appRoute) (Maybe Text))
592− -> (forall a. appRoute a -> Encoder check parse a PageName)
976+ => (forall a. appRoute a -> SegmentResult check parse a)
593977 -> Encoder check parse (R (ObeliskRoute appRoute)) PageName
594−obeliskRouteEncoder appComponentEncoder appRouteEncoder = Encoder $ do
595− let componentEncoder = obeliskRouteComponentEncoder appComponentEncoder
596− restEncoder <- checkObeliskRouteRestEncoder appRouteEncoder
597− checkEncoder $ pathComponentEncoder componentEncoder $ runValidEncoderFunc restEncoder
598−
599−checkObeliskRouteRestEncoder
600− :: ( MonadError Text check
601− , MonadError Text parse
602− , Universe (Some appRoute)
603− , GCompare appRoute
604− )
605− => (forall a. appRoute a -> Encoder check parse a PageName)
606− -> check (ValidEncoderFunc parse (ObeliskRoute appRoute) PageName)
607−checkObeliskRouteRestEncoder appRouteEncoder = do
608− appRouteValidEncoder <- checkEnum1EncoderFunc appRouteEncoder
609− resourceRouteValidEncoder <- checkEnum1EncoderFunc resourceRouteEncoder
610− return $ ValidEncoderFunc $ \case
611− ObeliskRoute_App appRoute -> runValidEncoderFunc appRouteValidEncoder appRoute
612− ObeliskRoute_Resource resRoute -> runValidEncoderFunc resourceRouteValidEncoder resRoute
613−
614−obeliskRouteComponentEncoder
615− :: ( MonadError Text parse
616− , GShow appRoute
617− , check ~ parse
618− )
619− => Encoder check parse (Some appRoute) (Maybe Text) -> Encoder check parse (Some (ObeliskRoute appRoute)) (Maybe Text)
620−obeliskRouteComponentEncoder appComponentEncoder = (resourceComponentEncoder `shadowEncoder` appComponentEncoder) . obeliskComponentEncoder
621−
622−resourceComponentEncoder :: (MonadError Text check, MonadError Text parse) => Encoder check parse (Some ResourceRoute) (Maybe Text)
623−resourceComponentEncoder = enum1Encoder $ \case
624− ResourceRoute_Static -> Just "static"
625− ResourceRoute_Ghcjs -> Just "ghcjs"
626− ResourceRoute_JSaddleWarp -> Just "jsaddle"
627−
628−resourceRouteEncoder :: (MonadError Text check, MonadError Text parse) => ResourceRoute a -> Encoder check parse a PageName
629−resourceRouteEncoder = \case
630− ResourceRoute_Static -> Encoder $ pure pathOnlyValidEncoder
631− ResourceRoute_Ghcjs -> Encoder $ pure pathOnlyValidEncoder
632− ResourceRoute_JSaddleWarp -> jsaddleWarpRouteEncoder
978+obeliskRouteEncoder appRouteSegment = pathComponentEncoder $ \r ->
979+ obeliskRouteSegment r appRouteSegment
980+
981+-- | From a function which explains how app-specific frontend routes translate into segments, produce a function which does the
982+-- same for ObeliskRoute. This uses the given function for the 'ObeliskRoute_App' case, and 'resourceRouteSegment' for the
983+-- 'ObeliskRoute_Resource' case.
984+obeliskRouteSegment :: forall check parse appRoute a.
985+ (MonadError Text check, MonadError Text parse)
986+ => ObeliskRoute appRoute a
987+ -> (forall b. appRoute b -> SegmentResult check parse b)
988+ -> SegmentResult check parse a
989+obeliskRouteSegment r appRouteSegment = case r of
990+ ObeliskRoute_App appRoute -> appRouteSegment appRoute
991+ ObeliskRoute_Resource resourceRoute -> resourceRouteSegment resourceRoute
992+
993+-- | A function which gives a sane default for how to encode Obelisk resource routes. It's given in this form, because it will
994+-- be combined with other such segment encoders before 'pathComponentEncoder' turns it into a proper 'Encoder'.
995+resourceRouteSegment :: (MonadError Text check, MonadError Text parse) => ResourceRoute a -> SegmentResult check parse a
996+resourceRouteSegment = \case
997+ ResourceRoute_Static -> PathSegment "static" pathOnlyEncoderIgnoringQuery
998+ ResourceRoute_Ghcjs -> PathSegment "ghcjs" pathOnlyEncoder
999+ ResourceRoute_JSaddleWarp -> PathSegment "jsaddle" jsaddleWarpRouteEncoder
1000+ ResourceRoute_Version -> PathSegment "version" $ unitEncoder mempty
6331001
6341002data JSaddleWarpRoute :: * -> * where
6351003 JSaddleWarpRoute_JavaScript :: JSaddleWarpRoute ()
6361004 JSaddleWarpRoute_WebSocket :: JSaddleWarpRoute ()
6371005 JSaddleWarpRoute_Sync :: JSaddleWarpRoute [Text]
6381006
639−jsaddleWarpRouteComponentEncoder :: (MonadError Text check, MonadError Text parse) => Encoder check parse (Some JSaddleWarpRoute) (Maybe Text)
640−jsaddleWarpRouteComponentEncoder = enum1Encoder $ \case
641− JSaddleWarpRoute_JavaScript -> Just "jsaddle.js"
642− JSaddleWarpRoute_WebSocket -> Nothing
643− JSaddleWarpRoute_Sync -> Just "sync"
644−
6451007jsaddleWarpRouteEncoder :: (MonadError Text check, MonadError Text parse) => Encoder check parse (R JSaddleWarpRoute) PageName
646−jsaddleWarpRouteEncoder = pathComponentEncoder jsaddleWarpRouteComponentEncoder $ \case
647− JSaddleWarpRoute_JavaScript -> endValidEncoder mempty
648− JSaddleWarpRoute_WebSocket -> endValidEncoder mempty
649− JSaddleWarpRoute_Sync -> pathOnlyValidEncoder
1008+jsaddleWarpRouteEncoder = pathComponentEncoder $ \case
1009+ JSaddleWarpRoute_JavaScript -> PathSegment "jsaddle.js" $ unitEncoder mempty
1010+ JSaddleWarpRoute_WebSocket -> PathEnd $ unitEncoder mempty
1011+ JSaddleWarpRoute_Sync -> PathSegment "sync" pathOnlyEncoder
6501012
6511013instance GShow appRoute => GShow (ObeliskRoute appRoute) where
6521014 gshowsPrec prec = \case
@@ -655,52 +1017,204 @@ instance GShow appRoute => GShow (ObeliskRoute appRoute) where
6551017 ObeliskRoute_Resource appRoute -> showParen (prec > 10) $
6561018 showString "ObeliskRoute_Resource " . gshowsPrec 11 appRoute
6571019
658−
6591020data IndexOnlyRoute :: * -> * where
6601021 IndexOnlyRoute :: IndexOnlyRoute ()
6611022
662−indexOnlyRouteComponentEncoder :: (MonadError Text check, MonadError Text parse) => Encoder check parse (Some IndexOnlyRoute) (Maybe Text)
663−indexOnlyRouteComponentEncoder = enum1Encoder $ \case
664− IndexOnlyRoute -> Nothing
665−
666−indexOnlyRouteRestEncoder :: (Applicative check, MonadError Text parse) => IndexOnlyRoute a -> Encoder check parse a PageName
667−indexOnlyRouteRestEncoder = \case
668− IndexOnlyRoute -> Encoder $ pure $ constLaxValidEncoder mempty
1023+indexOnlyRouteSegment :: (Applicative check, MonadError Text parse) => IndexOnlyRoute a -> SegmentResult check parse a
1024+indexOnlyRouteSegment = \case
1025+ IndexOnlyRoute -> PathEnd $ unitEncoder mempty
6691026
670−--TODO: Come up with a naming scheme that is better at describing how permissive
671−--versus strict things are
672−constLaxValidEncoder :: Applicative parse => a -> ValidEncoder parse () a
673−constLaxValidEncoder a = ValidEncoder
674− { _validEncoder_encode = \_ -> a
675− , _validEncoder_decode = \_ -> pure ()
676− }
1027+indexOnlyRouteEncoder :: (MonadError Text check, MonadError Text parse) => Encoder check parse (R IndexOnlyRoute) PageName
1028+indexOnlyRouteEncoder = pathComponentEncoder indexOnlyRouteSegment
6771029
6781030someSumEncoder :: (Applicative check, Applicative parse) => Encoder check parse (Some (Sum a b)) (Either (Some a) (Some b))
679−someSumEncoder = Encoder $ pure $ ValidEncoder
680− { _validEncoder_encode = \(Some.This t) -> case t of
681− InL l -> Left $ Some.This l
682− InR r -> Right $ Some.This r
683− , _validEncoder_decode = pure . \case
684− Left (Some.This l) -> Some.This (InL l)
685− Right (Some.This r) -> Some.This (InR r)
1031+someSumEncoder = Encoder $ pure $ EncoderImpl
1032+ { _encoderImpl_encode = \(Some t) -> case t of
1033+ InL l -> Left $ Some l
1034+ InR r -> Right $ Some r
1035+ , _encoderImpl_decode = pure . \case
1036+ Left (Some l) -> Some (InL l)
1037+ Right (Some r) -> Some (InR r)
6861038 }
6871039
6881040data Void1 :: * -> * where {}
6891041
690−instance Universe (Some Void1) where
691− universe = []
1042+instance UniverseSome Void1 where
1043+ universeSome = []
6921044
6931045void1Encoder :: (Applicative check, MonadError Text parse) => Encoder check parse (Some Void1) a
694−void1Encoder = Encoder $ pure $ ValidEncoder
695− { _validEncoder_encode = \case
696− Some.This f -> case f of {}
697− , _validEncoder_decode = \_ -> throwError "void1Encoder: can't decode anything"
1046+void1Encoder = Encoder $ pure $ EncoderImpl
1047+ { _encoderImpl_encode = \case
1048+ Some f -> case f of {}
1049+ , _encoderImpl_decode = \_ -> throwError "void1Encoder: can't decode anything"
6981050 }
6991051
7001052instance GShow Void1 where
7011053 gshowsPrec _ = \case {}
7021054
703−makePrisms ''ObeliskRoute
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+
7041218
7051219concat <$> mapM deriveRouteComponent
7061220 [ ''ResourceRoute
@@ -708,7 +1222,7 @@ concat <$> mapM deriveRouteComponent
7081222 , ''IndexOnlyRoute
7091223 ]
7101224
1225+makePrisms ''ObeliskRoute
1226+makePrisms ''FullRoute
7111227deriveGEq ''Void1
7121228deriveGCompare ''Void1
713−
714−--TODO: decodeURIComponent as appropriate
lib/route/src/Obelisk/Route/Frontend.hs+490−48
@@ -1,24 +1,25 @@
1−{-# LANGUAGE ApplicativeDo #-}
21{-# LANGUAGE CPP #-}
3−{-# LANGUAGE RecursiveDo #-}
4−{-# LANGUAGE StandaloneDeriving #-}
2+{-# LANGUAGE ApplicativeDo #-}
53{-# LANGUAGE ConstraintKinds #-}
4+{-# LANGUAGE DataKinds #-}
5+{-# LANGUAGE DefaultSignatures #-}
66{-# LANGUAGE FlexibleContexts #-}
77{-# LANGUAGE FlexibleInstances #-}
8+{-# LANGUAGE FunctionalDependencies #-}
89{-# LANGUAGE GADTs #-}
9−{-# LANGUAGE KindSignatures #-}
10+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
1011{-# LANGUAGE LambdaCase #-}
11−{-# LANGUAGE MultiParamTypeClasses #-}
1212{-# LANGUAGE OverloadedStrings #-}
1313{-# LANGUAGE PatternSynonyms #-}
1414{-# LANGUAGE RankNTypes #-}
15+{-# LANGUAGE RecursiveDo #-}
1516{-# LANGUAGE ScopedTypeVariables #-}
16−{-# LANGUAGE TemplateHaskell #-}
17+{-# LANGUAGE StandaloneDeriving #-}
1718{-# LANGUAGE TypeFamilies #-}
1819{-# LANGUAGE TypeOperators #-}
19−{-# LANGUAGE ViewPatterns #-}
20−{-# LANGUAGE GeneralizedNewtypeDeriving #-}
2120{-# LANGUAGE UndecidableInstances #-}
21+{-# LANGUAGE ViewPatterns #-}
22+
2223module Obelisk.Route.Frontend
2324 ( module Obelisk.Route
2425 , pattern (:~)
@@ -30,61 +31,115 @@ module Obelisk.Route.Frontend
3031 , mapRoutedT
3132 , subRoute
3233 , subRoute_
34+ , subPairRoute
35+ , subPairRoute_
36+ , maybeRoute
37+ , maybeRoute_
38+ , maybeRouted
39+ , eitherRoute
40+ , eitherRoute_
41+ , eitherRouted
3342 , runRouteViewT
43+ , SetRouteT(..)
44+ , SetRoute(..)
45+ , runSetRouteT
46+ , mapSetRouteT
47+ , RouteToUrl(..)
48+ , RouteToUrlT(..)
49+ , runRouteToUrlT
50+ , mapRouteToUrlT
51+ , routeLink
52+ , routeLinkDynAttr
53+ , dynRouteLink
54+ , adaptedUriPath
55+ , setAdaptedUriPath
3456 ) where
3557
3658import Prelude hiding ((.), id)
3759
38−import Obelisk.Route
39−
4060import Control.Category (Category (..), (.))
41−import Control.Category.Cartesian
42−import Control.Lens hiding (Bifunctor, bimap, universe)
61+import Control.Category.Cartesian ((&&&))
62+import Control.Lens hiding (Bifunctor, bimap, universe, element)
63+import Control.Monad ((<=<))
4364import Control.Monad.Fix
65+import Control.Monad.Morph
4466import Control.Monad.Primitive
67+import Control.Monad.Reader
4568import Control.Monad.Ref
46−import Control.Monad.Trans
4769import Control.Monad.Trans.Control
48−import Control.Monad.Trans.Reader
4970import Data.Coerce
50−import Data.Constraint (Dict (..))
5171import Data.Dependent.Sum (DSum (..))
72+import Data.Functor.Compose
73+import Data.Functor.Misc
5274import Data.GADT.Compare
75+import qualified Data.List as L
76+import Data.Map (Map)
77+import Data.Maybe (fromMaybe)
5378import Data.Monoid
79+import Data.Proxy
5480import Data.Text (Text)
55−import Data.Functor.Compose
56−import Reflex.Class
57−import Reflex.Host.Class
58−import Reflex.PostBuild.Class
59−import Reflex.TriggerEvent.Class
60−import Reflex.PerformEvent.Class
61−import Reflex.EventWriter.Class
62−import Reflex.EventWriter.Base
63−import Reflex.Dynamic
64−import Reflex.Dom.Builder.Class
81+import qualified Data.Text as T
6582import Data.Type.Coercion
66−import Language.Javascript.JSaddle --TODO: Get rid of this - other platforms can also be routed
67−import Reflex.Dom.Core
83+import qualified GHCJS.DOM as DOM
6884import 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
6987import Network.URI
70−
88+import Reflex.Class
89+import Reflex.Dom.Builder.Class
90+import Reflex.Dom.Core
91+import Reflex.Host.Class
7192import Unsafe.Coerce
7293
94+import Obelisk.Configs
95+import Obelisk.Route
96+
7397infixr 5 :~
7498pattern (:~) :: Reflex t => f a -> Dynamic t a -> DSum f (Compose (Dynamic t) Identity)
7599pattern a :~ b <- a :=> (coerceDynamic . getCompose -> b)
76100
77−class Routed t r m where
101+class Routed t r m | m -> t r where
78102 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
79105
80106instance Monad m => Routed t r (RoutedT t r m) where
81107 askRoute = RoutedT ask
82108
109+instance (Monad m, Routed t r m) => Routed t r (ReaderT r' m)
110+
83111newtype RoutedT t r m a = RoutedT { unRoutedT :: ReaderT (Dynamic t r) m a }
84− deriving (Functor, Applicative, Monad, MonadFix, MonadTrans, NotReady t, MonadHold t, MonadSample t, PostBuild t, TriggerEvent t, HasJSContext, MonadIO, MonadReflexCreateTrigger t, HasDocument)
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
85133
86−instance Prerender js m => Prerender js (RoutedT t r m) where
87− prerenderClientDict = fmap (\Dict -> Dict) (prerenderClientDict :: Maybe (Dict (PrerenderClientConstraint js m)))
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)
88143
89144instance Requester t m => Requester t (RoutedT t r m) where
90145 type Request (RoutedT t r m) = Request m
@@ -136,10 +191,24 @@ instance (Monad m, MonadQuery t vs m) => MonadQuery t vs (RoutedT t r m) where
136191 askQueryResult = lift askQueryResult
137192 queryIncremental = lift . queryIncremental
138193
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+
139208runRoutedT :: RoutedT t r m a -> Dynamic t r -> m a
140209runRoutedT = runReaderT . unRoutedT
141210
142−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
143212mapRoutedT f = RoutedT . mapReaderT f . unRoutedT
144213
145214withRoutedT :: (Dynamic t r -> Dynamic t r') -> RoutedT t r' m a -> RoutedT t r m a
@@ -149,10 +218,48 @@ subRoute_ :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => (forall a. r
149218subRoute_ f = factorRouted $ strictDynWidget_ $ \(c :=> r') -> do
150219 runRoutedT (f c) r'
151220
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+
152225subRoute :: (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)
153226subRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
154227 runRoutedT (f c) r'
155228
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+
233+maybeRoute_ :: (MonadFix m, MonadHold t m, Adjustable t m) => m () -> RoutedT t r m () -> RoutedT t (Maybe r) m ()
234+maybeRoute_ n j = maybeRouted $ strictDynWidget_ $ \case
235+ Nothing -> n
236+ Just r -> runRoutedT j r
237+
238+maybeRoute :: (MonadFix m, MonadHold t m, Adjustable t m) => m a -> RoutedT t r m a -> RoutedT t (Maybe r) m (Dynamic t a)
239+maybeRoute n j = maybeRouted $ strictDynWidget $ \case
240+ Nothing -> n
241+ Just r -> runRoutedT j r
242+
243+{-
244+maybeRoute :: (MonadFix m, MonadHold t m, GEq r, Adjustable t m) => m a -> RoutedT t r m a -> RoutedT t (Maybe r) m a
245+maybeRoute f = factorRouted $ strictDynWidget $ \(c :=> r') -> do
246+ runRoutedT (f c) r'
247+-}
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+
156263dsumValueCoercion :: Coercion f g -> Coercion (DSum k f) (DSum k g)
157264dsumValueCoercion Coercion = Coercion
158265
@@ -162,7 +269,15 @@ dynamicIdentityCoercion = unsafeCoerce (Coercion :: Coercion (Identity ()) ()) -
162269factorRouted :: (Reflex t, MonadFix m, MonadHold t m, GEq f) => RoutedT t (DSum f (Dynamic t)) m a -> RoutedT t (DSum f Identity) m a
163270factorRouted r = RoutedT $ ReaderT $ \d -> do
164271 d' <- factorDyn d
165− runRoutedT r $ (coerceWith (dynamicCoercion $ dsumValueCoercion dynamicIdentityCoercion) d')
272+ runRoutedT r $ coerceWith (dynamicCoercion $ dsumValueCoercion dynamicIdentityCoercion) d'
273+
274+maybeRouted :: (Reflex t, MonadFix m, MonadHold t m) => RoutedT t (Maybe (Dynamic t a)) m b -> RoutedT t (Maybe a) m b
275+maybeRouted r = RoutedT $ ReaderT $ \d -> do
276+ d' <- maybeDyn d
277+ runRoutedT r d'
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
166281
167282-- | WARNING: The input 'Dynamic' must be fully constructed when this is run
168283strictDynWidget :: (MonadSample t m, MonadHold t m, Adjustable t m) => (a -> m b) -> RoutedT t a m (Dynamic t b)
@@ -177,6 +292,182 @@ strictDynWidget_ f = RoutedT $ ReaderT $ \r -> do
177292 (_, _) <- runWithReplace (f r0) $ f <$> updated r
178293 pure ()
179294
295+newtype SetRouteT t r m a = SetRouteT { unSetRouteT :: EventWriterT t (Endo r) m a }
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
308+
309+mapSetRouteT :: (forall x. m x -> n x) -> SetRouteT t r m a -> SetRouteT t r n a
310+mapSetRouteT f (SetRouteT x) = SetRouteT (mapEventWriterT f x)
311+
312+runSetRouteT :: (Reflex t, Monad m) => SetRouteT t r m a -> m (a, Event t (Endo r))
313+runSetRouteT = runEventWriterT . unSetRouteT
314+
315+class Reflex t => SetRoute t r m | m -> t r where
316+ setRoute :: Event t 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+
321+ setRoute = modifyRoute . fmap const
322+
323+instance (Reflex t, Monad m) => SetRoute t r (SetRouteT t r m) where
324+ modifyRoute = SetRouteT . tellEvent . fmap Endo
325+
326+instance (Monad m, SetRoute t r m) => SetRoute t r (RoutedT t r' m)
327+
328+instance (Monad m, SetRoute t r m) => SetRoute t r (ReaderT r' m)
329+
330+instance (PerformEvent t m, Prerender js t m, Monad m, Reflex t) => Prerender js t (SetRouteT t r m) where
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
338+
339+instance Requester t m => Requester t (SetRouteT t r m) where
340+ type Request (SetRouteT t r m) = Request m
341+ type Response (SetRouteT t r m) = Response m
342+ requesting = SetRouteT . requesting
343+ requesting_ = SetRouteT . requesting_
344+
345+instance (Monad m, SetRoute t r m) => SetRoute t r (RequesterT t req rsp m)
346+
347+#ifndef ghcjs_HOST_OS
348+deriving instance MonadJSM m => MonadJSM (SetRouteT t r m)
349+#endif
350+
351+instance PerformEvent t m => PerformEvent t (SetRouteT t r m) where
352+ type Performable (SetRouteT t r m) = Performable m
353+ performEvent = lift . performEvent
354+ performEvent_ = lift . performEvent_
355+
356+instance MonadRef m => MonadRef (SetRouteT t r m) where
357+ type Ref (SetRouteT t r m) = Ref m
358+ newRef = lift . newRef
359+ readRef = lift . readRef
360+ writeRef r = lift . writeRef r
361+
362+instance HasJS x m => HasJS x (SetRouteT t r m) where
363+ type JSX (SetRouteT t r m) = JSX m
364+ liftJS = lift . liftJS
365+
366+instance PrimMonad m => PrimMonad (SetRouteT t r m ) where
367+ type PrimState (SetRouteT t r m) = PrimState m
368+ primitive = lift . primitive
369+
370+instance HasConfigs m => HasConfigs (SetRouteT t r m)
371+
372+instance (MonadHold t m, Adjustable t m) => Adjustable t (SetRouteT t r m) where
373+ runWithReplace a0 a' = SetRouteT $ runWithReplace (coerce a0) $ coerceEvent a'
374+ traverseIntMapWithKeyWithAdjust f a0 a' = SetRouteT $ traverseIntMapWithKeyWithAdjust (coerce f) (coerce a0) $ coerce a'
375+ traverseDMapWithKeyWithAdjust f a0 a' = SetRouteT $ traverseDMapWithKeyWithAdjust (\k v -> coerce $ f k v) (coerce a0) $ coerce a'
376+ traverseDMapWithKeyWithAdjustWithMove f a0 a' = SetRouteT $ traverseDMapWithKeyWithAdjustWithMove (\k v -> coerce $ f k v) (coerce a0) $ coerce a'
377+
378+instance (Monad m, MonadQuery t vs m) => MonadQuery t vs (SetRouteT t r m) where
379+ tellQueryIncremental = lift . tellQueryIncremental
380+ askQueryResult = lift askQueryResult
381+ queryIncremental = lift . queryIncremental
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+
180471runRouteViewT
181472 :: forall t m r a.
182473 ( TriggerEvent t m
@@ -186,18 +477,28 @@ runRouteViewT
186477 , MonadJSM (Performable m)
187478 , MonadFix m
188479 )
189− => (ValidEncoder (Either Text) r PageName)
190− -> (Text -> r) -- ^ 404 page
191− -> RoutedT t r (EventWriterT t (Endo r) m) a
480+ => Encoder Identity Identity r PageName
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
192486 -> m a
193−runRouteViewT routeValidEncoder error404 a = do
194− rec historyState <- manageHistory $ HistoryCommand_PushState <$> setState
195− let route :: Dynamic t r
196− route = fmap (runIdentity . _validEncoder_decode (catchValidEncoder error404 $ pageNameValidEncoder . routeValidEncoder) . (uriPath &&& uriQuery) . _historyItem_uri) historyState
197− (result, changeState) <- runEventWriterT $ runRoutedT a route
198− let f oldRoute change =
487+runRouteViewT routeEncoder switchover useHash a = do
488+ rec historyState <- manageHistory' switchover $ HistoryCommand_PushState <$> setState
489+ let theEncoder = pageNameEncoder . hoistParse (pure . runIdentity) routeEncoder
490+ -- NB: The can only fail if the uriPath doesn't begin with a '/' or if the uriQuery
491+ -- is nonempty, but begins with a character that isn't '?'. Since we don't expect
492+ -- this ever to happen, we'll just handle it by failing completely with 'error'.
493+ route :: Dynamic t r
494+ route = fmap (errorLeft . tryDecode theEncoder . (adaptedUriPath useHash &&& uriQuery) . _historyItem_uri) historyState
495+ where
496+ errorLeft (Left e) = error (T.unpack e)
497+ errorLeft (Right x) = x
498+ (result, changeState) <- runRouteToUrlT (runSetRouteT $ runRoutedT a route) $ (\(p, q) -> T.pack $ p <> q) . encode theEncoder
499+ let f (currentHistoryState, oldRoute) change =
199500 let newRoute = appEndo change oldRoute
200− (newPath, newQuery) = _validEncoder_encode (pageNameValidEncoder . routeValidEncoder) newRoute
501+ (newPath, newQuery) = encode theEncoder newRoute
201502 in HistoryStateUpdate
202503 { _historyStateUpdate_state = DOM.SerializedScriptValue jsNull
203504 -- We always provide "" as the title. On Firefox, Chrome, and
@@ -211,10 +512,151 @@ runRouteViewT routeValidEncoder error404 a = do
211512 -- we can change this function later to accommodate.
212513 -- See: https://github.com/whatwg/html/issues/2174
213514 , _historyStateUpdate_title = ""
214− , _historyStateUpdate_uri = Just $ nullURI
215− { uriPath = newPath
216− , uriQuery = newQuery
515+ , _historyStateUpdate_uri = Just $ setAdaptedUriPath useHash newPath $ (_historyItem_uri currentHistoryState)
516+ { uriQuery = newQuery
217517 }
218518 }
219− setState = attachWith f (current route) changeState
519+ setState = attachWith f ((,) <$> current historyState <*> current route) changeState
220520 return result
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+
645+-- On ios due to sandboxing when loading the page from a file adapt the
646+-- path to be based on the hash.
647+
648+adaptedUriPath :: Bool -> URI -> String
649+adaptedUriPath = \case
650+ True -> hashToPath . uriFragment
651+ False -> uriPath
652+
653+setAdaptedUriPath :: Bool -> String -> URI -> URI
654+setAdaptedUriPath useHash s u = case useHash of
655+ True -> u { uriFragment = pathToHash s }
656+ False -> u { uriPath = s }
657+
658+pathToHash :: String -> String
659+pathToHash = ('#' :) . fromMaybe "" . L.stripPrefix "/"
660+
661+hashToPath :: String -> String
662+hashToPath = ('/' :) . fromMaybe "" . L.stripPrefix "#"
lib/route/src/Obelisk/Route/TH.hs+4−5
@@ -1,8 +1,9 @@
11module Obelisk.Route.TH (deriveRouteComponent) where
22
3+import Data.Constraint.Extras.TH
34import Data.GADT.Show.TH
45import Data.GADT.Compare.TH
5−import Data.Universe.TH
6+import Data.Universe.Some.TH
67import Language.Haskell.TH
78
89-- | 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)
1112 [ deriveGShow
1213 , deriveGEq
1314 , deriveGCompare
14− , deriveShowTagIdentity
15− , deriveEqTagIdentity
16− , deriveOrdTagIdentity
17− , deriveSomeUniverse
15+ , deriveUniverseSome
16+ , deriveArgDict
1817 ]
lib/run/obelisk-run.cabal+13−4
@@ -10,9 +10,12 @@ library
1010 attoparsec
1111 , base
1212 , bytestring
13+ , containers
14+ , cookie
1315 , dependent-sum
1416 , dependent-sum-template
1517 , ghcjs-dom
18+ , HsOpenSSL
1619 , http-client
1720 , http-reverse-proxy
1821 , http-types
@@ -22,23 +25,29 @@ library
2225 , modern-uri
2326 , mtl
2427 , network
28+ , obelisk-asset-serve-snap
2529 , obelisk-backend
26− , obelisk-executable-config
27− , obelisk-executable-config-inject
30+ , obelisk-executable-config-lookup
2831 , obelisk-frontend
2932 , obelisk-route
3033 , process
3134 , ref-tf
3235 , reflex
33− , reflex-dom
36+ , reflex-dom-core
3437 , snap-core
3538 , streaming-commons
3639 , text
40+ , time
3741 , universe
42+ , utf8-string
3843 , wai
3944 , wai-websockets
4045 , warp
46+ , warp-tls
4147 , websockets
4248 exposed-modules:
4349 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+135−64
@@ -1,17 +1,17 @@
1+{-# LANGUAGE CPP #-}
2+#if defined(IPROUTE_SUPPORTED)
3+{-# LANGUAGE TemplateHaskell #-}
4+#endif
5+
16{-# LANGUAGE ConstraintKinds #-}
2−{-# LANGUAGE EmptyCase #-}
3−{-# LANGUAGE EmptyDataDecls #-}
47{-# LANGUAGE FlexibleContexts #-}
58{-# LANGUAGE FlexibleInstances #-}
69{-# LANGUAGE GADTs #-}
7−{-# LANGUAGE KindSignatures #-}
810{-# LANGUAGE LambdaCase #-}
911{-# LANGUAGE MultiParamTypeClasses #-}
1012{-# LANGUAGE OverloadedStrings #-}
1113{-# LANGUAGE Rank2Types #-}
12−{-# LANGUAGE RecursiveDo #-}
1314{-# LANGUAGE ScopedTypeVariables #-}
14−{-# LANGUAGE TemplateHaskell #-}
1515{-# LANGUAGE TypeFamilies #-}
1616{-# LANGUAGE UndecidableInstances #-}
1717{-# OPTIONS_GHC -fno-warn-orphans #-} -- Due to instance HasJS x (EventWriterT t w m)
@@ -25,19 +25,22 @@ import Control.Exception
2525import Control.Lens ((%~), (^?), _Just, _Right)
2626import qualified Data.Attoparsec.ByteString.Char8 as A
2727import Data.ByteString (ByteString)
28+import qualified Data.ByteString as BS
2829import qualified Data.ByteString.Char8 as BSC
29−import qualified Data.ByteString.Lazy as LBS
3030import qualified Data.ByteString.Lazy.Char8 as BSLC
31−import Data.Dependent.Sum (DSum (..))
31+import qualified Data.ByteString.UTF8 as BSUTF8
3232import Data.Functor.Identity
33−import Data.Functor.Sum
3433import Data.List (uncons)
34+import Data.Map (Map)
35+import qualified Data.Map as Map
3536import Data.Maybe
3637import Data.Semigroup ((<>))
3738import Data.Streaming.Network (bindPortTCP)
39+import Data.String (fromString)
3840import Data.Text (Text)
3941import qualified Data.Text as T
40−import Data.Text.Encoding
42+import qualified Data.Text.Encoding as T
43+import Data.Time.Clock (getCurrentTime, addUTCTime)
4144import Language.Javascript.JSaddle.Run (syncPoint)
4245import Language.Javascript.JSaddle.WebSockets
4346import Network.HTTP.Client (Manager, defaultManagerSettings, newManager)
@@ -47,107 +50,165 @@ import Network.Socket
4750import Network.Wai (Application)
4851import qualified Network.Wai as W
4952import Network.Wai.Handler.Warp
53+import Network.Wai.Handler.WarpTLS
5054import Network.Wai.Handler.Warp.Internal (settingsHost, settingsPort)
5155import Network.WebSockets (ConnectionOptions)
5256import Network.WebSockets.Connection (defaultConnectionOptions)
53−import Obelisk.ExecutableConfig (get)
54−import Obelisk.ExecutableConfig.Inject (injectExecutableConfigs)
57+import qualified Obelisk.Asset.Serve.Snap as Snap
58+import Obelisk.Backend
5559import Obelisk.Frontend
5660import 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
5765import Reflex.Dom.Core
66+import Snap.Core (Snap)
5867import System.Environment
5968import System.IO
6069import System.Process
6170import Text.URI (URI)
6271import qualified Text.URI as URI
6372import Text.URI.Lens
64−import Snap.Core (writeText)
65−import Obelisk.Backend
73+import Web.Cookie
74+
75+#if defined(IPROUTE_SUPPORTED)
76+import qualified System.Which
77+#endif
6678
6779run
6880 :: Int -- ^ Port to run the backend
69− -> Backend fullRoute frontendRoute -- ^ Backend
81+ -> ([Text] -> Snap ()) -- ^ Static asset handler
82+ -> Backend backendRoute frontendRoute -- ^ Backend
7083 -> Frontend (R frontendRoute) -- ^ Frontend
7184 -> IO ()
72−run port backend frontend = do
85+run port serveStaticAsset backend frontend = do
7386 prettifyOutput
7487 let handleBackendErr (e :: IOException) = hPutStrLn stderr $ "backend stopped; make a change to your code to reload - error " <> show e
7588 --TODO: Use Obelisk.Backend.runBackend; this will require separating the checking and running phases
7689 case checkEncoder $ _backend_routeEncoder backend of
7790 Left e -> hPutStrLn stderr $ "backend error:\n" <> T.unpack e
7891 Right validFullEncoder -> do
79− backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $ do
80− _backend_run backend $ \serveRoute -> do
81− runSnapWithCommandLineArgs $ do
92+ publicConfigs <- getPublicConfigs
93+ backendTid <- forkIO $ handle handleBackendErr $ withArgs ["--quiet", "--port", show port] $
94+ _backend_run backend $ \serveRoute ->
95+ runSnapWithCommandLineArgs $
8296 getRouteWith validFullEncoder >>= \case
83− Left e -> writeText e
84− Right r -> case r of
85− InL backendRoute :=> Identity a -> serveRoute $ backendRoute :/ a
86− InR obeliskRoute :=> Identity a -> serveDefaultObeliskApp frontend $ obeliskRoute :/ a
97+ Identity r -> case r of
98+ FullRoute_Backend backendRoute :/ a -> serveRoute $ backendRoute :/ 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+
87105 let conf = defRunConfig { _runConfig_redirectPort = port }
88− runWidget conf frontend validFullEncoder `finally` killThread backendTid
89−
90−getConfigRoute :: IO (Maybe URI)
91−getConfigRoute = get "config/common/route" >>= \case
92− Just r -> case URI.mkURI $ T.strip r of
93− Just route -> pure $ Just route
94− Nothing -> do
95− putStrLn $ "Route is invalid: " <> show r
96− pure Nothing
97− Nothing -> pure Nothing
98−
99−defAppUri :: URI
100−defAppUri = fromMaybe (error "defAppUri") $ URI.mkURI "http://127.0.0.1:8000"
101−
102−runWidget :: RunConfig -> Frontend (R route) -> ValidEncoder (Either Text) (R (Sum backendRoute (ObeliskRoute route))) PageName -> IO ()
103−runWidget conf frontend validFullEncoder = do
104− uri <- fromMaybe defAppUri <$> getConfigRoute
106+ runWidget conf publicConfigs frontend validFullEncoder `finally` killThread backendTid
107+
108+-- Convenience wrapper to handle path segments for 'Snap.serveAsset'
109+runServeAsset :: FilePath -> [Text] -> Snap ()
110+runServeAsset rootPath = Snap.serveAsset "" rootPath . T.unpack . T.intercalate "/"
111+
112+getConfigRoute :: Map Text ByteString -> Either Text URI
113+getConfigRoute configs = case Map.lookup "common/route" configs of
114+ Just r ->
115+ let stripped = T.strip (T.decodeUtf8 r)
116+ in case URI.mkURI stripped of
117+ Just route -> Right route
118+ Nothing -> Left $ "Couldn't parse route as URI; value read was: " <> T.pack (show stripped)
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)
120+
121+runWidget
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
105129 let port = fromIntegral $ fromMaybe 80 $ uri ^? uriAuthority . _Right . authPort . _Just
106130 redirectHost = _runConfig_redirectHost conf
107131 redirectPort = _runConfig_redirectPort conf
108132 beforeMainLoop = do
109133 putStrLn $ "Frontend running on " <> T.unpack (URI.render uri)
110134 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
111158 bracket
112159 (bindPortTCPRetry settings (logPortBindErr port) (_runConfig_retryTimeout conf))
113160 close
114161 (\skt -> do
115162 man <- newManager defaultManagerSettings
116− app <- obeliskApp defaultConnectionOptions frontend validFullEncoder uri $ fallbackProxy redirectHost redirectPort man
117− runSettingsSocket settings skt app)
163+ app <- obeliskApp configs defaultConnectionOptions frontend validFullEncoder uri $ fallbackProxy redirectHost redirectPort man
164+ runner settings skt app)
118165
119166obeliskApp
120− :: forall route backendRoute. ConnectionOptions
121− -> Frontend (R route)
122− -> ValidEncoder (Either Text) (R (Sum backendRoute (ObeliskRoute route))) PageName
167+ :: forall frontendRoute backendRoute
168+ . Map Text ByteString
169+ -> ConnectionOptions
170+ -> Frontend (R frontendRoute)
171+ -> Encoder Identity Identity (R (FullRoute backendRoute frontendRoute)) PageName
123172 -> URI
124173 -> Application
125174 -> IO Application
126−obeliskApp opts frontend validFullEncoder uri backend = do
127− let entryPoint = do
128− runFrontend validFullEncoder frontend
175+obeliskApp configs opts frontend validFullEncoder uri backend = do
176+ let mode = FrontendMode
177+ { _frontendMode_hydrate = True
178+ , _frontendMode_adjustRoute = False
179+ }
180+ entryPoint = do
181+ runFrontendWithConfigsAndCurrentRoute mode configs validFullEncoder frontend
129182 syncPoint
130183 jsaddlePath <- URI.mkPathPiece "jsaddle"
131184 let jsaddleUri = BSLC.fromStrict $ URI.renderBs $ uri & uriPath %~ (<>[jsaddlePath])
132− Right (jsaddleWarpRouteValidEncoder :: ValidEncoder (Either Text) (R JSaddleWarpRoute) PageName) <- return $ checkEncoder jsaddleWarpRouteEncoder
185+ Right (jsaddleWarpRouteValidEncoder :: Encoder Identity (Either Text) (R JSaddleWarpRoute) PageName) <- return $ checkEncoder jsaddleWarpRouteEncoder
133186 jsaddle <- jsaddleWithAppOr opts entryPoint $ \_ sendResponse -> sendResponse $ W.responseLBS H.status500 [("Content-Type", "text/plain")] "obeliskApp: jsaddle got a bad URL"
134− return $ \req sendResponse -> case _validEncoder_decode validFullEncoder (W.pathInfo req, mempty) of --TODO: Query strings
135− Left e -> sendResponse $ W.responseLBS H.status404 [("Content-Type", "text/plain")] $ LBS.fromStrict $ encodeUtf8 e
136− Right r -> case r of
137− InR (ObeliskRoute_Resource ResourceRoute_JSaddleWarp) :=> Identity jsaddleRoute -> case jsaddleRoute of
187+ return $ \req sendResponse -> case tryDecode validFullEncoder $ byteStringsToPageName (BS.dropWhile (== (fromIntegral $ fromEnum '/')) $ W.rawPathInfo req) (BS.drop 1 $ W.rawQueryString req) of
188+ Identity r -> case r of
189+ FullRoute_Frontend (ObeliskRoute_Resource ResourceRoute_JSaddleWarp) :/ jsaddleRoute -> case jsaddleRoute of
138190 JSaddleWarpRoute_JavaScript :/ () -> sendResponse $ W.responseLBS H.status200 [("Content-Type", "application/javascript")] $ jsaddleJs' (Just jsaddleUri) False
139191 _ -> flip jsaddle sendResponse $ req
140− { W.pathInfo = fst $ _validEncoder_encode jsaddleWarpRouteValidEncoder jsaddleRoute
192+ { W.pathInfo = fst $ encode jsaddleWarpRouteValidEncoder jsaddleRoute
141193 }
142− InR (ObeliskRoute_App appRouteComponent) :=> Identity appRouteRest -> do
143− html <- renderJsaddleFrontend (appRouteComponent :/ appRouteRest) frontend
144− sendResponse $ W.responseLBS H.status200 [("Content-Type", "text/html")] $ BSLC.fromStrict html
194+ FullRoute_Frontend (ObeliskRoute_App appRouteComponent) :/ appRouteRest -> do
195+ let cookies = maybe [] parseCookies $ lookup (fromString "Cookie") (W.requestHeaders req)
196+ routeToUrl (k :/ v) = renderObeliskRoute validFullEncoder $ FullRoute_Frontend (ObeliskRoute_App k) :/ v
197+ html <- renderJsaddleFrontend configs cookies routeToUrl (appRouteComponent :/ appRouteRest) frontend
198+ sendResponse $ W.responseLBS H.status200 [("Content-Type", staticRenderContentType)] $ BSLC.fromStrict html
145199 _ -> backend req sendResponse
146200
147−renderJsaddleFrontend :: route -> Frontend route -> IO ByteString
148−renderJsaddleFrontend r f =
201+renderJsaddleFrontend
202+ :: Map Text ByteString
203+ -> Cookies
204+ -> (route -> Text)
205+ -> route
206+ -> Frontend route
207+ -> IO ByteString
208+renderJsaddleFrontend configs cookies urlEnc r f =
149209 let jsaddleScript = elAttr "script" ("src" =: "/jsaddle/jsaddle.js") blank
150− 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
151212
152213-- | like 'bindPortTCP' but reconnects on exception
153214bindPortTCPRetry :: Settings
@@ -164,12 +225,22 @@ logPortBindErr p e = getProcessIdForPort p >>= \case
164225 Nothing -> putStrLn $ "runWidget: " <> show e
165226 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."]
166227
228+ssPath :: Maybe String
229+ssPath =
230+#if defined(IPROUTE_SUPPORTED)
231+ Just $(System.Which.staticWhich "ss")
232+#else
233+ Nothing
234+#endif
235+
167236getProcessIdForPort :: Int -> IO (Maybe Int)
168−getProcessIdForPort port = do
169− xs <- lines <$> readProcess "ss" ["-lptn", "sport = " <> show port] mempty
170− case uncons xs of
171− Just (_, x:_) -> return $ A.maybeResult $ A.parse parseSsPid $ BSC.pack x
172− _ -> return Nothing
237+getProcessIdForPort port = case ssPath of
238+ Just ss -> do
239+ xs <- lines <$> readProcess ss ["-lptn", "sport = " <> show port] mempty
240+ case uncons xs of
241+ Just (_, x:_) -> return $ A.maybeResult $ A.parse parseSsPid $ BSC.pack x
242+ _ -> return Nothing
243+ _ -> return Nothing
173244
174245parseSsPid :: A.Parser Int
175246parseSsPid = do
lib/selftest/obelisk-selftest.cabal+7−3
@@ -9,17 +9,21 @@ library
99 hs-source-dirs: src
1010 build-depends:
1111 base
12+ , bytestring
13+ , aeson
1214 , containers
1315 , directory
16+ , filepath
1417 , hspec
1518 , http-client
1619 , http-types
1720 , HUnit
18− , obelisk-cliapp
21+ , network
22+ , obelisk-executable-config-lookup
1923 , obelisk-run
24+ , which
2025 , process
21− , network
22− , shelly
26+ , shelly >= 1.9.0
2327 , temporary
2428 , text
2529 exposed-modules:
lib/selftest/src/Obelisk/SelfTest.hs+517−195
@@ -1,252 +1,451 @@
1+{-# LANGUAGE DoAndIfThenElse #-}
2+{-# LANGUAGE EmptyCase #-}
13{-# LANGUAGE LambdaCase #-}
24{-# LANGUAGE OverloadedStrings #-}
35{-# LANGUAGE PatternGuards #-}
46{-# LANGUAGE ScopedTypeVariables #-}
7+{-# LANGUAGE TemplateHaskell #-}
58{-# LANGUAGE TypeApplications #-}
9+{-# LANGUAGE ViewPatterns #-}
610module Obelisk.SelfTest where
711
8−import Control.Exception (bracket, throw)
12+import Control.Concurrent (threadDelay)
13+import Control.Exception (bracket, throw, try)
914import Control.Monad
1015import Control.Monad.IO.Class
16+import qualified Data.Aeson as Aeson
17+import qualified Data.Aeson.Types as Aeson
1118import Data.Bool (bool)
19+import qualified Data.ByteString.Lazy as LBS
20+import Data.Foldable (for_)
1221import Data.Function (fix)
13−import Data.Semigroup (Semigroup, (<>))
22+import Data.List (isInfixOf)
23+import qualified Data.Map as Map
24+import Data.Semigroup ((<>))
1425import qualified Data.Set as Set
1526import Data.String
1627import Data.Text (Text)
1728import qualified Data.Text as T
29+import qualified Data.Text.Encoding as T
1830import qualified Data.Text.IO as T
1931import qualified Network.HTTP.Client as HTTP
2032import qualified Network.HTTP.Types as HTTP
2133import qualified Network.Socket as Socket
2234import Shelly
23−import System.Directory (withCurrentDirectory)
35+import System.Directory (getCurrentDirectory, withCurrentDirectory, getDirectoryContents)
2436import System.Environment
2537import System.Exit (ExitCode (..))
26−import System.Info
27−import System.IO (Handle, hClose)
38+import System.FilePath (addTrailingPathSeparator)
39+import qualified System.Info
40+import System.IO (Handle, hClose, hIsEOF, hGetContents)
2841import System.IO.Temp
2942import System.Process (readProcessWithExitCode)
30−import System.Timeout
43+import System.Which (staticWhich)
3144import Test.Hspec
3245import Test.HUnit.Base
3346
34−import Obelisk.CliApp hiding (runCli)
35−import qualified Obelisk.CliApp as CliApp
47+import Obelisk.ExecutableConfig.Lookup (getConfigs)
3648import Obelisk.Run (getConfigRoute)
3749
3850data ObRunState
3951 = ObRunState_Init
4052 | ObRunState_Startup
41− | ObRunState_BackendStarted Text -- Port of backend
53+ | ObRunState_BackendStarted
4254 deriving (Eq, Show)
4355
44−doubleQuotes :: (IsString a, Semigroup a) => a -> a
45−doubleQuotes s = "\"" <> s <> "\""
56+cpPath :: FilePath
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"]
4694
4795commit :: Text -> Sh ()
48−commit msg = void $ run "git"
49− [ "commit"
96+commit msg = void $ run gitPath $ gitUserConfig <> [ "commit"
5097 , "--no-gpg-sign"
5198 , "--allow-empty"
5299 , "-m"
53− , doubleQuotes msg
100+ , msg
54101 ]
55102
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−
61103tshow :: Show a => a -> Text
62104tshow = T.pack . show
63105
64106-- | 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.
69107shellyOb :: MonadIO m => (Sh a -> Sh a) -> Sh a -> m a
70−shellyOb f obTest = shelly $ f $ do
71− obTest `catch_sh` \(e :: RunFailed) -> do
72− obStderr <- lastStderr
73− if T.isInfixOf "export NIX_REMOTE" obStderr
74− then do
75− runCli $ do
76− putLog Notice "Detected NIX_REMOTE suggestion in stderr of failed ob"
77− putLog Warning "Retrying this test with NIX_REMOTE=daemon"
78− setenv "NIX_REMOTE" "daemon"
79− f obTest
80− else throw e
108+shellyOb f obTest = shelly $ f obTest
109+
110+-- Set "ob" in a single place so it can be replaced with a
111+-- link to obelisk in the nix store in the future,
112+-- and avoid PATH hacking before calling this script.
113+ob :: FilePath
114+ob = "ob"
115+
116+augmentWithVerbosity :: (String -> [Text] -> a) -> String -> Bool -> [Text] -> a
117+augmentWithVerbosity runner executable isVerbose args = runner executable $ (if isVerbose then ("-v" :) else id) args
118+
119+isolatedGitShell :: Bool -> FilePath -> (([Text] -> Sh Text) -> Sh a) -> IO a
120+isolatedGitShell isVerbose dir f = shelly $ bool silently verbosely isVerbose $ do
121+ setenv "HOME" "/dev/null"
122+ setenv "GIT_CONFIG_NOSYSTEM" "1"
123+ _ <- git ["init"]
124+ _ <- git ["config", "user.name", "SelfTest"]
125+ _ <- git ["config", "user.email", "self@test"]
126+ f git
127+ where
128+ git args = run gitPath $ ["-C", toTextIgnore dir] <> args
129+
130+-- | Copies a git repo to a new location and "resets" the git history to include
131+-- exactly one commit with all files added. It then restricts writing and reading
132+-- for group and user to make the repo ideal for being a valid git remote for thunks.
133+--
134+-- Using this allows dirty repos to be used as git remotes during the test since 'git clone'ing
135+-- a dirty repo will not include the uncommitted changes.
136+copyForGitRemote :: Bool -> FilePath -> FilePath -> IO ()
137+copyForGitRemote isVerbose origDir copyDir = isolatedGitShell isVerbose copyDir $ \git -> do
138+ run_ rsyncPath
139+ [ "-r", "--no-perms", "--no-owner", "--no-group", "--exclude", ".git"
140+ , toTextIgnore (addTrailingPathSeparator origDir), toTextIgnore copyDir
141+ ]
142+ _ <- git ["add", "--all"]
143+ _ <- git ["commit", "-m", "Copy repo"]
144+ run_ chmodPath ["-R", "u-w,g-rw,o-rw", toTextIgnore copyDir] -- Freeze this state
81145
82146main :: IO ()
83147main = do
84148 -- Note: you can pass hspec arguments as well, eg: `-m <pattern>`
85− isVerbose <- (elem "-v") <$> getArgs
149+ isVerbose <- elem "-v" <$> getArgs
86150 unless isVerbose $
87151 putStrLn "Tests may take longer to run if there are unbuilt derivations: use -v for verbose output"
88− let verbosity = bool silently verbosely isVerbose
89− obeliskImpl <- fromString <$> getEnv "OBELISK_IMPL"
152+
153+ obeliskImplDirtyReadOnly <- getCurrentDirectory
90154 httpManager <- HTTP.newManager HTTP.defaultManagerSettings
91− withSystemTempDirectory "blank-project" $ \blankProject ->
92− hspec $ do
93− let shelly_ = void . shellyOb verbosity
94−
95− inProj :: Sh a -> IO ()
96− inProj = shelly_ . chdir (fromString blankProject)
97−
98− inTmp :: (Shelly.FilePath -> Sh a) -> IO ()
99− inTmp f = shelly_ . withSystemTempDirectory "ob-init" $ (chdir <*> f) . fromString
100−
101− assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
102− assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
103−
104− revParseHead = T.strip <$> run "git" ["rev-parse", "HEAD"]
105−
106− commitAll = do
107− run_ "git" ["add", "."]
108− commit "checkpoint"
109− revParseHead
110−
111− thunk = ".obelisk/impl"
112− update = run "ob" ["thunk", "update", thunk] >> commitAll
113− pack = run "ob" ["thunk", "pack", thunk] >> commitAll
114− unpack = run "ob" ["thunk", "unpack", thunk] >> commitAll
115−
116− diff a b = run "git" ["diff", a, b]
117−
118− describe "ob init" $ do
119− it "works with default impl" $ inTmp $ \_ -> run "ob" ["init"]
120− it "works with master branch impl" $ inTmp $ \_ -> run "ob" ["init", "--branch", "master"]
121− it "works with symlink" $ inTmp $ \_ -> run "ob" ["init", "--symlink", obeliskImpl]
122−
123− it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
124− void $ errExit False $ run "ob" ["init", "--symlink", "/dev/null"]
125− ls tmp >>= liftIO . assertEqual "" []
126−
127− it "produces a valid route config" $ inTmp $ \tmp -> do
128− run_ "ob" ["init"]
129− liftIO $ withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ getConfigRoute `shouldNotReturn` Nothing
130−
131− describe "ob run" $ do
132− it "works in root directory" $ inTmp $ \_ -> do
133− run_ "ob" ["init"]
134− testObRunInDir Nothing httpManager
135− it "works in sub directory" $ inTmp $ \_ -> do
136− run_ "ob" ["init"]
137− testObRunInDir (Just "frontend") httpManager
138−
139− describe "obelisk project" $ parallel $ do
140− it "can build obelisk command" $ shelly_ $ run "nix-build" ["-A", "command" , obeliskImpl]
141− it "can build obelisk skeleton" $ shelly_ $ run "nix-build" ["-A", "skeleton", obeliskImpl]
142− it "can build obelisk shell" $ shelly_ $ run "nix-build" ["-A", "shell", obeliskImpl]
143− -- See https://github.com/obsidiansystems/obelisk/issues/101
144− -- it "can build everything" $ shelly_ $ run "nix-build" [obeliskImpl]
145−
146− describe "blank initialized project" $ do
147− it "can be created" $ inProj $ do
148− run_ "ob" ["init"]
149− run_ "git" ["init"]
150− commitAll
151−
152− it "can build ghc.backend" $ inProj $ do
153− run "nix-build" ["--no-out-link", "-A", "ghc.backend"]
154− it "can build ghcjs.frontend" $ inProj $ do
155− run "nix-build" ["--no-out-link", "-A", "ghcjs.frontend"]
156−
157− if os == "darwin"
158− then it "can build ios" $ inProj $ run "nix-build" ["--no-out-link", "-A", "ios.frontend" ]
159− else it "can build android" $ inProj $ run "nix-build" ["--no-out-link", "-A", "android.frontend"]
160−
161− forM_ ["ghc", "ghcjs"] $ \compiler -> do
162− let
163− shell = "shells." <> compiler
164− inShell cmd' = run "nix-shell" ["-A", fromString shell, "--run", cmd']
165− it ("can enter " <> shell) $ inProj $ inShell "exit"
166− it ("can build in " <> shell) $ inProj $ inShell $ "cabal new-build --" <> fromString compiler <> " all"
167−
168− it "can build reflex project" $ inProj $ do
169− run "nix-build" []
170−
171− it "has idempotent thunk update" $ inProj $ do
172− u <- update
173− uu <- update
174− assertRevEQ u uu
175−
176− describe "ob thunk pack/unpack" $ do
177− it "has thunk pack and unpack inverses" $ inProj $ do
178− e <- commitAll
179− eu <- unpack
180− eup <- pack
181− eupu <- unpack
182− _ <- pack
183−
184− assertRevEQ e eup
185− assertRevEQ eu eupu
186− assertRevNE e eu
187−
188− it "can pack and unpack plain git repos" $ do
189− shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
190− let repo = toTextIgnore $ dir </> ("repo" :: String)
191− run_ "git" ["clone", "https://github.com/haskell/process.git", repo]
192− origHash <- chdir (fromText repo) revParseHead
193−
194− run_ "ob" ["thunk", "pack", repo]
195− packedFiles <- Set.fromList <$> ls (fromText repo)
196− liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
197− ["default.nix", "github.json", ".attr-cache" :: String]
198−
199− run_ "ob" ["thunk", "unpack", repo]
200− chdir (fromText repo) $ do
201− unpackHash <- revParseHead
202− assertRevEQ origHash unpackHash
203−
204− testThunkPack $ fromText repo
205−
206− it "aborts thunk pack when there are uncommitted files" $ inProj $ do
207− void $ unpack
208− testThunkPack (blankProject </> thunk)
155+
156+ withSystemTempDirectory "obelisk-repo-git-remote" $ \copyDir -> do
157+ copyForGitRemote isVerbose obeliskImplDirtyReadOnly copyDir
158+ main' isVerbose httpManager copyDir
159+
160+main' :: Bool -> HTTP.Manager -> FilePath -> IO ()
161+main' isVerbose httpManager obeliskRepoReadOnly = withInitCache $ \initCache -> hspec $ parallel $ do
162+ let
163+ inTmpObInit' dirname f = inTmp' dirname $ \dir -> do
164+ run_ cpPath ["-rT", fromString initCache, toTextIgnore dir]
165+ f dir
166+ inTmpObInit = inTmpObInit' defaultTmpDirName
167+
168+ -- To be used in tests that change the obelisk impl directory
169+ inTmpObInitWithImplCopy f = inTmpObInit $ \dir ->
170+ withObeliskImplClean $ \(fromString -> implClean) -> do
171+ run_ rmPath [thunk]
172+ run_ lnPath ["-s", implClean, thunk]
173+ f dir
174+
175+ describe "ob init" $ parallel $ do
176+ it "works with default impl" $ inTmp $ \_ -> runOb ["init"]
177+ it "works with master branch impl" $ inTmp $ \_ -> runOb ["init", "--branch", "master"]
178+ it "works with symlink" $ inTmp $ \_ -> runOb ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
179+ it "doesn't silently overwrite existing files" $ inTmp $ \_ -> do
180+ let p force = errExit False $ do
181+ run_ ob $ "--no-handoff" : "-v" : "init" : ["--force"|force]
182+ (== 0) <$> lastExitCode
183+
184+ True <- p False
185+ False <- p False
186+ True <- p True
187+ pure ()
188+
189+ it "doesn't create anything when given an invalid impl" $ inTmp $ \tmp -> do
190+ void $ errExit False $ runOb ["init", "--symlink", "/dev/null"]
191+ ls tmp >>= liftIO . assertEqual "" []
192+
193+ it "produces a valid route config" $ inTmpObInit $ \tmp -> liftIO $
194+ withCurrentDirectory (T.unpack $ toTextIgnore tmp) $ do
195+ configs <- getConfigs
196+ return (either (const Nothing) Just $ getConfigRoute configs) `shouldNotReturn` Nothing
197+
198+ it "can unpack and repack .obelisk/impl after init with master branch impl" $ inTmp $ \_ -> do
199+ runOb_ ["init", "--branch", "master"]
200+ runOb_ ["thunk", "unpack", ".obelisk/impl"]
201+ runOb_ ["thunk", "pack", ".obelisk/impl"]
202+
203+ -- These tests fail with "Could not find module 'Obelisk.Generated.Static'"
204+ -- when not run by 'nix-build --attr selftest'
205+ describe "ob run" $ {- NOT parallel $ -} do
206+ it "works in root directory" $ inTmpObInit $ \_ -> testObRunInDir' Nothing httpManager
207+ it "works in sub directory" $ inTmpObInit $ \_ -> testObRunInDir' (Just "frontend") httpManager
208+
209+ describe "ob repl" $ do
210+ it "accepts stdin commands" $ inTmpObInit $ \_ -> do
211+ setStdin "print 3\n:q"
212+ output <- runOb ["repl"]
213+ liftIO $ assertBool "" $
214+ [ "*Obelisk.Run Obelisk.Run Frontend Backend> 3"
215+ , "*Obelisk.Run Obelisk.Run Frontend Backend> Leaving GHCi."
216+ ] `isInfixOf` T.lines (T.strip output)
217+ it "works with custom Prelude" $ inTmpObInit $ \_ -> do
218+ writefile "common/src/Prelude.hs"
219+ "{-# LANGUAGE PackageImports #-} module Prelude (module X) where import \"base\" Prelude as X"
220+ setStdin ":q"
221+ output <- runOb ["repl"]
222+ liftIO $ assertBool "" $
223+ "*Obelisk.Run Obelisk.Run Frontend Backend> Leaving GHCi." `T.isInfixOf` output
224+
225+ describe "obelisk project" $ parallel $ do
226+ it "can build obelisk command" $ inTmpObInit $ \_ -> nixBuild ["-A", "command" , toTextIgnore obeliskRepoReadOnly]
227+ it "can build obelisk skeleton" $ inTmpObInit $ \_ -> nixBuild ["-A", "skeleton", toTextIgnore obeliskRepoReadOnly]
228+ it "can build obelisk shell" $ inTmpObInit $ \_ -> nixBuild ["-A", "shell", toTextIgnore obeliskRepoReadOnly]
229+ it "can build everything" $ inTmpObInit $ \_ -> nixBuild [toTextIgnore obeliskRepoReadOnly]
230+
231+ describe "blank initialized project" $ parallel $ do
232+
233+ it "can build ghc.backend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghc.backend"]
234+ it "can build ghcjs.frontend" $ inTmpObInit $ \_ -> nixBuild ["-A", "ghcjs.frontend"]
235+
236+ if System.Info.os == "darwin"
237+ then it "can build ios" $ inTmpObInit $ \_ -> nixBuild ["-A", "ios.frontend"]
238+ else it "can build android after accepting license" $ inTmpObInit $ \dir -> do
239+ let defaultNixPath = dir </> ("default.nix" :: FilePath)
240+ writefile defaultNixPath
241+ =<< T.replace
242+ "# config.android_sdk.accept_license = false;"
243+ "config.android_sdk.accept_license = true;"
244+ <$> readfile defaultNixPath
245+ nixBuild ["-A", "android.frontend"]
246+
247+ forM_ ["ghc", "ghcjs"] $ \compiler -> do
248+ let
249+ shellName = "shells." <> compiler
250+ inShell cmd' = run_ "nix-shell" ["default.nix", "-A", fromString shellName, "--run", cmd']
251+ it ("can enter " <> shellName) $ inTmpObInit $ \_ -> inShell "exit"
252+ -- NOTE: We override the temporary directory name because cabal has a bug preventing new-build from working
253+ -- in a path that has unicode characters.
254+ it ("can build in " <> shellName) $ inTmpObInit' "test" $ \_ -> inShell $
255+ T.pack cabalPath <> " --version; " <> T.pack cabalPath <> " new-build --" <> T.pack compiler <> " all"
256+
257+ it "has idempotent thunk update" $ inTmpObInitWithImplCopy $ \_ -> do
258+ _ <- pack
259+ u <- update
260+ uu <- update
261+ assertRevEQ u uu
262+
263+ it "can run 'ob doc'" $ inTmpObInit $ \_ -> runOb_ ["doc", "reflex"]
264+
265+ describe "ob thunk pack/unpack" $ parallel $ do
266+ it "has thunk pack and unpack inverses" $ inTmpObInitWithImplCopy $ \_ -> do
267+
268+ _ <- pack
269+ e <- commitAll
270+ eu <- unpack
271+ eup <- pack
272+ eupu <- unpack
273+ _ <- pack
274+
275+ assertRevEQ e eup
276+ assertRevEQ eu eupu
277+ assertRevNE e eu
278+
279+ it "unpacks the correct branch" $ withTmp $ \dir -> do
280+ let branch = "master"
281+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch]
282+ runOb_ ["thunk", "pack", toTextIgnore dir]
283+ runOb_ ["thunk", "unpack", toTextIgnore dir]
284+ branch' <- run gitPath ["-C", toTextIgnore $ dir </> unpackedDirName, "rev-parse", "--abbrev-ref", "HEAD"]
285+ liftIO $ assertEqual "" branch (T.strip branch')
286+
287+ it "can pack and unpack plain git repos" $
288+ shelly_ $ withSystemTempDirectory "git-repo" $ \dir -> do
289+ let repo = toTextIgnore $ dir </> ("repo" :: FilePath)
290+ run_ gitPath ["clone", "https://github.com/haskell/process.git", repo]
291+ origHash <- chdir (fromText repo) revParseHead
292+
293+ runOb_ ["thunk", "pack", repo]
294+ packedFiles <- Set.fromList <$> ls (fromText repo)
295+ liftIO $ assertEqual "" packedFiles $ Set.fromList $ (repo </>) <$>
296+ ["default.nix", "thunk.nix", "github.json" :: FilePath]
297+
298+ runOb_ ["thunk", "unpack", repo]
299+ chdir (fromText repo </> unpackedDirName) $ do
300+ unpackHash <- revParseHead
301+ assertRevEQ origHash unpackHash
302+
303+ testThunkPack' $ fromText repo
304+
305+ it "aborts thunk pack when there are uncommitted files" $ inTmpObInitWithImplCopy $ \dir -> do
306+ testThunkPack' (dir </> thunk)
307+
308+ it "works on legacy git thunks" $ testLegacyGitThunks isVerbose
309+
310+ describe "ob thunk update --branch" $ parallel $ do
311+ it "can change a thunk to the latest version of a desired branch" $ withTmp $ \dir -> do
312+ let branch1 = "master"
313+ branch2 = "develop"
314+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", branch1]
315+ runOb_ ["thunk" , "pack", toTextIgnore dir]
316+ runOb_ ["thunk", "update", toTextIgnore dir, "--branch", branch2]
317+
318+ it "doesn't create anything when given an invalid branch" $ withTmp $ \dir -> do
319+ let checkDir dir' = liftIO $ getDirectoryContents $ T.unpack $ toTextIgnore dir'
320+ run_ gitPath ["clone", "https://github.com/reflex-frp/reflex.git", toTextIgnore dir, "--branch", "master"]
321+ runOb_ ["thunk" , "pack", toTextIgnore dir]
322+ startingContents <- checkDir dir
323+ void $ errExit False $ runOb ["thunk", "update", toTextIgnore dir, "--branch", "dumble-palooza"]
324+ checkDir dir >>= liftIO . assertEqual "" startingContents
325+
326+ describe "ob shell" $ parallel $ do
327+ it "works with --" $ inTmpObInit $ \_ -> do
328+ output <- runOb ["shell", "--", "ghc-pkg", "list"]
329+ liftIO $ assertBool "Unexpected output from ob shell" $ ("Cabal-" `T.isInfixOf` output) && ("ghc-" `T.isInfixOf` output)
330+
331+ describe "ob hoogle" $ {- NOT parallel -} do
332+ it "starts a hoogle server on the given port" $ inTmpObInit $ \_ -> do
333+ [p0] <- liftIO $ getFreePorts 1
334+ maskExitSuccess $ runHandle "ob" ["hoogle", "--port", T.pack (show p0)] $ \stdout -> flip fix Nothing $ \loop -> \case
335+ Nothing -> do -- Still waiting for initial signal that the server has started
336+ ln <- liftIO $ T.hGetLine stdout
337+ let search = "Server starting on port " <> T.pack (show p0)
338+ case search `T.isInfixOf` ln of
339+ False -> loop Nothing -- keep waiting
340+ True -> loop $ Just 10
341+ Just (n :: Int) -> do -- Server has started and we have n attempts left
342+ let req uri = liftIO $ try @HTTP.HttpException $ HTTP.parseRequest uri >>= flip HTTP.httpLbs httpManager
343+ req ("http://127.0.0.1:" <> show p0) >>= \case
344+ Right r | HTTP.responseStatus r == HTTP.ok200 -> exit 0
345+ e -> if n <= 0
346+ then errorExit $ "Request to hoogle server failed: " <> T.pack (show e)
347+ else liftIO (threadDelay (1*10^(6 :: Int))) *> loop (Just $ n - 1)
348+ where
349+ verbosity = bool silently verbosely isVerbose
350+ nixBuild args = run nixBuildPath ("--no-out-link" : args)
351+
352+ runOb_ = augmentWithVerbosity run_ ob isVerbose
353+ runOb = augmentWithVerbosity run ob isVerbose
354+ testObRunInDir' = augmentWithVerbosity testObRunInDir ob isVerbose ["run"]
355+ testThunkPack' = augmentWithVerbosity testThunkPack ob isVerbose []
356+
357+ withObeliskImplClean f =
358+ withSystemTempDirectory "obelisk-impl-clean" $ \obeliskImpl -> do
359+ void . shellyOb verbosity $ do
360+ dirtyFiles <- T.strip <$> run gitPath ["-C", toTextIgnore obeliskRepoReadOnly, "diff", "--stat"]
361+ () <- when (dirtyFiles /= "") $ error "SelfTest does not work correctly with dirty obelisk repos as remote"
362+ run_ gitPath ["clone", "file://" <> toTextIgnore obeliskRepoReadOnly, toTextIgnore obeliskImpl]
363+ f obeliskImpl
364+
365+ withInitCache f =
366+ withSystemTempDirectory "init Cache λ" $ \initCache -> do
367+ -- Setup the ob init cache
368+ void . shellyOb verbosity $ chdir initCache $ do
369+ runOb_ ["init", "--symlink", toTextIgnore obeliskRepoReadOnly]
370+ run_ gitPath ["init"]
371+
372+ f initCache
373+
374+ shelly_ = void . shellyOb verbosity
375+
376+ defaultTmpDirName = "test λ"
377+
378+ inTmp' :: FilePath -> (FilePath -> Sh a) -> IO ()
379+ inTmp' dirname f = withTmp' dirname (chdir <*> f)
380+ inTmp = inTmp' defaultTmpDirName
381+
382+ withTmp' dirname f = shelly_ . withSystemTempDirectory dirname $ f . fromString
383+ withTmp = withTmp' defaultTmpDirName
384+
385+ assertRevEQ a b = liftIO . assertEqual "" "" =<< diff a b
386+ assertRevNE a b = liftIO . assertBool "" . (/= "") =<< diff a b
387+
388+ revParseHead = T.strip <$> run gitPath ["rev-parse", "HEAD"]
389+
390+ commitAll = do
391+ run_ gitPath ["add", "."]
392+ commit "checkpoint"
393+ revParseHead
394+
395+ thunk = ".obelisk/impl"
396+ update = runOb ["thunk", "update", thunk] *> commitAll
397+ pack = runOb ["thunk", "pack", thunk] *> commitAll
398+ unpack = runOb ["thunk", "unpack", thunk] *> commitAll
399+
400+ diff a b = run gitPath ["diff", a, b]
401+
402+
403+maskExitSuccess :: Sh () -> Sh ()
404+maskExitSuccess = handle_sh (\case ExitSuccess -> pure (); e -> throw e)
209405
210406-- | Run `ob run` in the given directory (maximum of one level deep)
211−testObRunInDir :: Maybe Shelly.FilePath -> HTTP.Manager -> Sh ()
212−testObRunInDir mdir httpManager = handle_sh (\case ExitSuccess -> pure (); e -> throw e) $ do
407+testObRunInDir :: String -> [Text] -> Maybe FilePath -> HTTP.Manager -> Sh ()
408+testObRunInDir executable extraArgs mdir httpManager = maskExitSuccess $ do
409+ [p0, p1] <- liftIO $ getFreePorts 2
213410 let uri p = "http://localhost:" <> T.pack (show p) <> "/" -- trailing slash required for comparison
214− writefile "config/common/route" . uri =<< liftIO getFreePort -- Use a free port initially
215− maybe id chdir mdir $ runHandle "ob" ["run"] $ \stdout -> do
216− freePort <- liftIO getFreePort
217− (_, firstUri) <- handleObRunStdout httpManager stdout
218− let newUri = uri freePort
411+ writefile "config/common/route" $ uri p0
412+ maybe id chdir mdir $ runHandles executable extraArgs [] $ \_stdin stdout stderr -> do
413+ firstUri <- handleObRunStdout httpManager stdout stderr
414+ let newUri = uri p1
219415 when (firstUri == newUri) $ errorExit $
220416 "Startup URI (" <> firstUri <> ") is the same as test URI (" <> newUri <> ")"
221417 maybe id (\_ -> chdir "..") mdir $ alterRouteTo newUri stdout
222− (_, runningUri) <- handleObRunStdout httpManager stdout
418+ runningUri <- handleObRunStdout httpManager stdout stderr
223419 if runningUri /= newUri
224420 then errorExit $ "Reloading failed: expected " <> newUri <> " but got " <> runningUri
225421 else exit 0
226422
227−testThunkPack :: Shelly.FilePath -> Sh ()
228−testThunkPack path' = withTempFile (T.unpack $ toTextIgnore path') "test-file" $ \file handle -> do
229− let pack' = readProcessWithExitCode "ob" ["thunk", "pack", T.unpack $ toTextIgnore path'] ""
230− ensureThunkPackFails q = liftIO $ pack' >>= \case
231− (code, out, err)
232− | code == ExitSuccess -> fail "ob thunk pack succeeded when it should have failed"
233− | q `T.isInfixOf` T.pack (out <> err) -> pure ()
234− | otherwise -> fail $ "ob thunk pack failed for an unexpected reason: " <> show out <> "\nstderr: " <> err
235− git = chdir path' . run "git"
423+testThunkPack :: String -> [Text] -> FilePath -> Sh ()
424+testThunkPack executable args path' = withTempFile repoDir "test-file" $ \file handle -> do
425+ let
426+ pack' = readProcessWithExitCode executable (["thunk", "pack", path'] ++ map T.unpack args) ""
427+ ensureThunkPackFails q = liftIO $ pack' >>= \case
428+ (code, out, err)
429+ | code == ExitSuccess -> fail $ "ob thunk pack succeeded when it should have failed with error '" <> show q <> "'"
430+ | q `T.isInfixOf` T.pack (out <> err) -> pure ()
431+ | otherwise -> fail $ "ob thunk pack failed for an unexpected reason, expecting '" <> show q <> "', received: " <> show out <> "\nstderr: " <> err
432+ git = chdir repoDir . run_ gitPath
236433 -- Untracked files
237434 ensureThunkPackFails "Untracked files"
238− void $ git ["add", T.pack file]
435+ git ["add", T.pack file]
239436 -- Uncommitted files (staged)
240437 ensureThunkPackFails "unsaved"
241− chdir path' $ commit "test commit"
438+ chdir repoDir $ commit "test commit"
242439 -- Non-pushed commits in any branch
243− ensureThunkPackFails "not been pushed"
440+ ensureThunkPackFails "not yet pushed"
244441 -- Uncommitted files (unstaged)
245442 liftIO $ T.hPutStrLn handle "test file" >> hClose handle
246443 ensureThunkPackFails "modified"
247444 -- Existing stashes
248− void $ git ["stash"]
445+ git $ gitUserConfig <> [ "stash" ]
249446 ensureThunkPackFails "has stashes"
447+ where
448+ repoDir = path' </> unpackedDirName
250449
251450-- | Blocks until a non-empty line is available
252451hGetLineSkipBlanks :: MonadIO m => Handle -> m Text
@@ -266,39 +465,162 @@ alterRouteTo uri stdout = do
266465 "Reloading failed: " <> T.pack (show t)
267466
268467-- | Handle stdout of `ob run`: check that the frontend and backend servers are started correctly
269−handleObRunStdout :: HTTP.Manager -> Handle -> Sh (Text, Text)
270−handleObRunStdout httpManager stdout = flip fix ObRunState_Init $ \loop state -> do
271− liftIO (T.hGetLine stdout) >>= \t -> case state of
468+handleObRunStdout :: HTTP.Manager -> Handle -> Handle -> Sh Text
469+handleObRunStdout httpManager stdout stderr = flip fix (ObRunState_Init, []) $ \loop (state, msgs) -> do
470+ isEOF <- liftIO $ hIsEOF stdout
471+ if isEOF
472+ then handleObRunError msgs
473+ else liftIO (T.hGetLine stdout) >>= \t -> case state of
272474 ObRunState_Init
273− | "Running test..." `T.isPrefixOf` t -> loop ObRunState_Startup
475+ | "Running test..." `T.isPrefixOf` t -> loop (ObRunState_BackendStarted, msgs)
274476 ObRunState_Startup
275− | t == "backend stopped; make a change to your code to reload" -> loop ObRunState_Startup
276− | Just port <- "Backend running on port " `T.stripPrefix` t -> loop $ ObRunState_BackendStarted port
477+ | t == "backend stopped; make a change to your code to reload" -> loop (ObRunState_Startup, msgs)
478+ -- | Just port <- "Backend running on port " `T.stripPrefix` t -> loop $ ObRunState_BackendStarted port
277479 | not (T.null t) -> errorExit $ "Startup: " <> t -- If theres any other output here, startup failed
278− ObRunState_BackendStarted port
480+ ObRunState_BackendStarted
279481 | Just uri <- "Frontend running on " `T.stripPrefix` t -> do
280− obRunCheck httpManager stdout port uri
281− pure (port, uri)
482+ obRunCheck httpManager stdout uri
483+ pure uri
282484 | not (T.null t) -> errorExit $ "Started: " <> t -- If theres any other output here, startup failed
283− _ -> 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
284491
285492-- | Make requests to frontend/backend servers to check they are working properly
286−obRunCheck :: HTTP.Manager -> Handle -> Text -> Text -> Sh ()
287−obRunCheck httpManager stdout backendPort frontendUri = do
493+obRunCheck :: HTTP.Manager -> Handle -> Text -> Sh ()
494+obRunCheck httpManager _stdout frontendUri = do
288495 let req uri = liftIO $ HTTP.parseRequest (T.unpack uri) >>= flip HTTP.httpLbs httpManager
289496 req frontendUri >>= \r -> when (HTTP.responseStatus r /= HTTP.ok200) $ errorExit $
290497 "Request to frontend server failed: " <> T.pack (show r)
291− void $ req $ "http://localhost:" <> backendPort
292− liftIO (timeout 1000000 $ T.hGetLine stdout) >>= \case
293− Just t | "127.0.0.1" `T.isPrefixOf` t -> pure () -- Backend request logged
294− x -> errorExit $ "Couldn't get backend request log: " <> T.pack (show x)
295498
296−getFreePort :: IO Socket.PortNumber
297−getFreePort = Socket.withSocketsDo $ do
499+getFreePorts :: Int -> IO [Socket.PortNumber]
500+getFreePorts 0 = pure []
501+getFreePorts n = Socket.withSocketsDo $ do
298502 addr:_ <- Socket.getAddrInfo (Just Socket.defaultHints) (Just "127.0.0.1") (Just "0")
299− bracket (open addr) Socket.close Socket.socketPort
503+ bracket (open addr) Socket.close $ \s -> (:) <$> Socket.socketPort s <*> getFreePorts (n - 1)
300504 where
301505 open addr = do
302506 sock <- Socket.socket (Socket.addrFamily addr) (Socket.addrSocketType addr) (Socket.addrProtocol addr)
303507 Socket.bind sock (Socket.addrAddress addr)
304508 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 @@
11name: obelisk-snap-extras
22version: 0.1
3−synopsys: Extra functionality for Snap that should be considered for upstreaming
3+synopsis: Extra functionality for Snap that should be considered for upstreaming
44license: BSD3
55build-type: Simple
66cabal-version: >=1.2
@@ -12,10 +12,9 @@ library
1212 , base
1313 , bytestring
1414 , snap-core
15− , unix
1615 , directory
1716 , filepath
1817 , text
1918 exposed-modules:
2019 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 @@
22module Obelisk.Snap.Extras
33 ( cachePermanently
44 , doNotCache
5+ , ensureSecure
56 , serveFileIfExists
67 , serveFileIfExistsAs
78 ) where
89
910import Control.Monad.IO.Class
1011import Data.ByteString (ByteString)
11−import Data.Monoid
1212import Data.String
1313import Snap.Core
1414import Snap.Util.FileServe
@@ -17,7 +17,7 @@ import System.Directory
1717-- | Set response header for "permanent" caching
1818cachePermanently :: MonadSnap m => m ()
1919cachePermanently = do
20− modifyResponse $ setHeader "Cache-Control" "public, max-age=315360000"
20+ modifyResponse $ setHeader "Cache-Control" "public, max-age=315360000, immutable"
2121 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"
2222
2323-- | 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+7−41
@@ -1,44 +1,10 @@
1−{ self ? import ./. {}
2−, pkgs ? self.nixpkgs
3−}:
4−
5−with pkgs;
6−
71{
8− inherit (self) command;
9− built-skeleton = (import ./skeleton {}).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− verify-migration = runCommand "verify-migration" {
24− nativeBuildInputs = [
25− self.command
26− nix # obelisk uses `nix-hash`
27− ];
28− } ''
29− set -e
30− # Fix permissions so `removePathForcibly` works on copied-to-tmp paths
31− cp -a ${self.pathGit} $TMPDIR/obelisk
32− cd $TMPDIR/obelisk
33− chmod -R u+w .
34−
35− (set -x;
36− ob internal hash;
37− ob internal verify-migration;
38− )
2+ supportedSystems ? [ "x86_64-linux" "x86_64-darwin" ]
3+}:
4+rec {
5+ recurseForDerivations = true;
6+ build = import ./all-builds.nix { inherit supportedSystems; };
7+ test = import ./all-tests.nix { inherit supportedSystems; };
398
40− mkdir -p $out
41− touch $out/done
42− '';
43− };
9+ inherit (build) metaCache;
4410}
scripts/ghcid-this-libdeleted−4
@@ -1,4 +0,0 @@
1−#!/usr/bin/env bash
2−set -euo pipefail
3−
4−nix-shell ../.. -A haskellPackageSets.ghc.obelisk-$(basename $PWD).env --run "cabal configure ; ghcid -W -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
61.attr-cache
2+.cabal-sandbox
3+*.hi
4+*.o
5+cabal.project.local
6+cabal.sandbox.config
7+ctags
8+dist-newstyle/
9+dist/
710ghcid-output.txt
11+profile/
12+result
13+result-*
14+tags
15+TAGS
skeleton/backend/backend.cabal+3−6
@@ -11,22 +11,19 @@ library
1111 , common
1212 , frontend
1313 , obelisk-backend
14+ , obelisk-route
1415 exposed-modules:
1516 Backend
16− ghc-options: -Wall
17+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
1718
1819executable backend
1920 main-is: main.hs
2021 hs-source-dirs: src-bin
22+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -threaded -fno-show-valid-hole-fits
2123 if impl(ghcjs)
2224 buildable: False
2325 build-depends: base
2426 , backend
2527 , common
2628 , frontend
27− , lens
28− , modern-uri
2929 , obelisk-backend
30− , obelisk-executable-config
31− , obelisk-executable-config-inject
32− , text
skeleton/backend/src-bin/main.hs+3−17
@@ -1,20 +1,6 @@
1−{-# LANGUAGE OverloadedStrings #-}
2−import Control.Exception
3−import Control.Lens
4−import Data.Maybe
5−import Data.Text.Encoding
6−import Obelisk.ExecutableConfig (get)
7−import System.Environment
8−import qualified Text.URI as URI
9−import Text.URI.Lens
10−
111import Backend
2+import Frontend
3+import Obelisk.Backend
124
135main :: IO ()
14−main = do
15− Just route <- get "common/route"
16− port <- case URI.mkURI route of
17− Left err -> fail $ show err
18− Right uri -> return $ fromMaybe 8000 $ uri ^? uriAuthority . _Right . authPort . _Just
19− withArgs ["--port", show port] backend
20−
6+main = runBackend backend frontend
skeleton/backend/src/Backend.hs+6−6
@@ -1,10 +1,10 @@
11module Backend where
22
3−import Common.Api
4−import Frontend
5−import qualified Obelisk.Backend as Ob
3+import Common.Route
4+import Obelisk.Backend
65
7−backend :: IO ()
8−backend = Ob.backend Ob.def
9− { Ob._backendConfig_head = fst frontend
6+backend :: Backend BackendRoute FrontendRoute
7+backend = Backend
8+ { _backend_run = \serve -> serve $ const $ return ()
9+ , _backend_routeEncoder = fullRouteEncoder
1010 }
skeleton/cabal.project+1
@@ -1,2 +1,3 @@
11optional-packages:
22 *
3+write-ghc-environment-files: never
skeleton/common/common.cabal+5−1
@@ -6,6 +6,10 @@ build-type: Simple
66library
77 hs-source-dirs: src
88 build-depends: base
9−
9+ , obelisk-route
10+ , mtl
11+ , text
1012 exposed-modules:
1113 Common.Api
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 @@
11module Common.Api where
22
33commonStuff :: String
4−commonStuff = "here is a common string"
4+commonStuff = "Here is a string defined in Common.Api"
skeleton/common/src/Common/Route.hsnew file+47
@@ -0,0 +1,47 @@
1+{-# LANGUAGE EmptyCase #-}
2+{-# LANGUAGE FlexibleContexts #-}
3+{-# LANGUAGE FlexibleInstances #-}
4+{-# LANGUAGE GADTs #-}
5+{-# LANGUAGE KindSignatures #-}
6+{-# LANGUAGE LambdaCase #-}
7+{-# LANGUAGE MultiParamTypeClasses #-}
8+{-# LANGUAGE OverloadedStrings #-}
9+{-# LANGUAGE RankNTypes #-}
10+{-# LANGUAGE TemplateHaskell #-}
11+{-# LANGUAGE TypeFamilies #-}
12+module Common.Route where
13+
14+{- -- You will probably want these imports for composing Encoders.
15+import Prelude hiding (id, (.))
16+import Control.Category
17+-}
18+
19+import Data.Text (Text)
20+import Data.Functor.Identity
21+
22+import Obelisk.Route
23+import Obelisk.Route.TH
24+
25+data BackendRoute :: * -> * where
26+ -- | Used to handle unparseable routes.
27+ BackendRoute_Missing :: BackendRoute ()
28+ -- You can define any routes that will be handled specially by the backend here.
29+ -- i.e. These do not serve the frontend, but do something different, such as serving static files.
30+
31+data FrontendRoute :: * -> * where
32+ FrontendRoute_Main :: FrontendRoute ()
33+ -- This type is used to define frontend routes, i.e. ones for which the backend will serve the frontend.
34+
35+fullRouteEncoder
36+ :: Encoder (Either Text) Identity (R (FullRoute BackendRoute FrontendRoute)) PageName
37+fullRouteEncoder = mkFullRouteEncoder
38+ (FullRoute_Backend BackendRoute_Missing :/ ())
39+ (\case
40+ BackendRoute_Missing -> PathSegment "missing" $ unitEncoder mempty)
41+ (\case
42+ FrontendRoute_Main -> PathEnd $ unitEncoder mempty)
43+
44+concat <$> mapM deriveRouteComponent
45+ [ ''BackendRoute
46+ , ''FrontendRoute
47+ ]
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
2−, iosSdkVersion ? "10.2"
1+{ system ? builtins.currentSystem
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+ }
316}:
4−with import ./.obelisk/impl { inherit system iosSdkVersion; };
17+with obelisk;
518project ./. ({ ... }: {
619 android.applicationId = "systems.obsidian.obelisk.examples.minimal";
720 android.displayName = "Obelisk Minimal Example";
skeleton/devel/Devel.hsdeleted−10
@@ -1,10 +0,0 @@
1−module Devel where
2−
3−import Obelisk.Run
4−
5−import Backend
6−import Frontend
7−
8−main :: Int -> IO ()
9−main port = run port backend frontend
10−
skeleton/frontend/frontend.cabal+14−7
@@ -7,23 +7,30 @@ library
77 hs-source-dirs: src
88 build-depends: base
99 , common
10+ , obelisk-frontend
11+ , obelisk-route
12+ , jsaddle
1013 , reflex-dom
11− , static
14+ , obelisk-executable-config-lookup
15+ , obelisk-generated-static
1216 , text
1317 exposed-modules:
1418 Frontend
15− ghc-options: -Wall
19+ ghc-options: -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -O -fno-show-valid-hole-fits
1620
1721executable frontend
1822 main-is: main.hs
1923 hs-source-dirs: src-bin
2024 build-depends: base
2125 , common
26+ , obelisk-frontend
27+ , obelisk-route
2228 , reflex-dom
23− , static
24− , text
29+ , obelisk-generated-static
2530 , frontend
26− --TODO: Make these ghc-options optional
27− ghc-options: -threaded
31+ ghc-options: -threaded -O -Wall -Wredundant-constraints -Wincomplete-uni-patterns -Wincomplete-record-updates -fno-show-valid-hole-fits
32+ if impl(ghcjs)
33+ ghc-options: -dedupe
34+ cpp-options: -DGHCJS_BROWSER
2835 if os(darwin)
29− ghc-options: -dynamic
36+ ghc-options: -dynamic
skeleton/frontend/src-bin/main.hs+7−2
@@ -1,5 +1,10 @@
1−import Reflex.Dom
21import Frontend
2+import Common.Route
3+import Obelisk.Frontend
4+import Obelisk.Route.Frontend
5+import Reflex.Dom
36
47main :: IO ()
5−main = mainWidget $ snd frontend
8+main = do
9+ let Right validFullEncoder = checkEncoder fullRouteEncoder
10+ run $ runFrontend validFullEncoder frontend
skeleton/frontend/src/Frontend.hs+37−8
@@ -1,19 +1,48 @@
11{-# LANGUAGE DataKinds #-}
22{-# LANGUAGE OverloadedStrings #-}
33{-# LANGUAGE TypeApplications #-}
4+
45module Frontend where
56
7+import Control.Monad
68import qualified Data.Text as T
9+import qualified Data.Text.Encoding as T
10+import Language.Javascript.JSaddle (eval, liftJSM)
11+
12+import Obelisk.Frontend
13+import Obelisk.Configs
14+import Obelisk.Route
15+import Obelisk.Generated.Static
16+
717import Reflex.Dom.Core
818
919import Common.Api
10−import Static
11−
12−frontend :: (StaticWidget x (), Widget x ())
13−frontend = (head', body)
14− where
15− head' = el "title" $ text "Obelisk Minimal Example"
16− body = do
17− text "Welcome to Obelisk!"
20+import Common.Route
21+
22+
23+-- This runs in a monad that can be run on the client or the server.
24+-- To run code in a pure client or pure server context, use one of the
25+-- `prerender` functions.
26+frontend :: Frontend (R FrontendRoute)
27+frontend = Frontend
28+ { _frontend_head = do
29+ el "title" $ text "Obelisk Minimal Example"
30+ elAttr "link" ("href" =: static @"main.css" <> "type" =: "text/css" <> "rel" =: "stylesheet") blank
31+ , _frontend_body = do
32+ el "h1" $ text "Welcome to Obelisk!"
1833 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+
1941 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 ()
48+ }
skeleton/static/main.cssnew file+3
@@ -0,0 +1,3 @@
1+p {
2+ color: red;
3+}