|
1 | | -{- |
2 | | -Welcome to your new Dhall package-set! |
3 | | -
|
4 | | -Below are instructions for how to edit this file for most use |
5 | | -cases, so that you don't need to know Dhall to use it. |
6 | | -
|
7 | | -## Warning: Don't Move This Top-Level Comment! |
8 | | -
|
9 | | -Due to how `dhall format` currently works, this comment's |
10 | | -instructions cannot appear near corresponding sections below |
11 | | -because `dhall format` will delete the comment. However, |
12 | | -it will not delete a top-level comment like this one. |
13 | | -
|
14 | | -## Use Cases |
15 | | -
|
16 | | -Most will want to do one or both of these options: |
17 | | -1. Override/Patch a package's dependency |
18 | | -2. Add a package not already in the default package set |
19 | | -
|
20 | | -This file will continue to work whether you use one or both options. |
21 | | -Instructions for each option are explained below. |
22 | | -
|
23 | | -### Overriding/Patching a package |
24 | | -
|
25 | | -Purpose: |
26 | | -- Change a package's dependency to a newer/older release than the |
27 | | - default package set's release |
28 | | -- Use your own modified version of some dependency that may |
29 | | - include new API, changed API, removed API by |
30 | | - using your custom git repo of the library rather than |
31 | | - the package set's repo |
32 | | -
|
33 | | -Syntax: |
34 | | -Replace the overrides' "{=}" (an empty record) with the following idea |
35 | | -The "//" or "⫽" means "merge these two records and |
36 | | - when they have the same value, use the one on the right:" |
37 | | -------------------------------- |
38 | | -let override = |
39 | | - { packageName = |
40 | | - upstream.packageName // { updateEntity1 = "new value", updateEntity2 = "new value" } |
41 | | - , packageName = |
42 | | - upstream.packageName // { version = "v4.0.0" } |
43 | | - , packageName = |
44 | | - upstream.packageName // { repo = "https://www.example.com/path/to/new/repo.git" } |
45 | | - } |
46 | | -------------------------------- |
47 | | -
|
48 | | -Example: |
49 | | -------------------------------- |
50 | | -let overrides = |
51 | | - { halogen = |
52 | | - upstream.halogen // { version = "master" } |
53 | | - , halogen-vdom = |
54 | | - upstream.halogen-vdom // { version = "v4.0.0" } |
55 | | - } |
56 | | -------------------------------- |
57 | | -
|
58 | | -### Additions |
59 | | -
|
60 | | -Purpose: |
61 | | -- Add packages that aren't already included in the default package set |
62 | | -
|
63 | | -Syntax: |
64 | | -Replace the additions' "{=}" (an empty record) with the following idea: |
65 | | -------------------------------- |
66 | | -let additions = |
67 | | - { "package-name" = |
68 | | - mkPackage |
69 | | - [ "dependency1" |
70 | | - , "dependency2" |
71 | | - ] |
72 | | - "https://example.com/path/to/git/repo.git" |
73 | | - "tag ('v4.0.0') or branch ('master')" |
74 | | - , "package-name" = |
75 | | - mkPackage |
76 | | - [ "dependency1" |
77 | | - , "dependency2" |
78 | | - ] |
79 | | - "https://example.com/path/to/git/repo.git" |
80 | | - "tag ('v4.0.0') or branch ('master')" |
81 | | - , etc. |
82 | | - } |
83 | | -------------------------------- |
84 | | -
|
85 | | -Example: |
86 | | -------------------------------- |
87 | | -let additions = |
88 | | - { benchotron = |
89 | | - mkPackage |
90 | | - [ "arrays" |
91 | | - , "exists" |
92 | | - , "profunctor" |
93 | | - , "strings" |
94 | | - , "quickcheck" |
95 | | - , "lcg" |
96 | | - , "transformers" |
97 | | - , "foldable-traversable" |
98 | | - , "exceptions" |
99 | | - , "node-fs" |
100 | | - , "node-buffer" |
101 | | - , "node-readline" |
102 | | - , "datetime" |
103 | | - , "now" |
104 | | - ] |
105 | | - "https://github.com/hdgarrood/purescript-benchotron.git" |
106 | | - "v7.0.0" |
107 | | - } |
108 | | -------------------------------- |
109 | | --} |
110 | | - |
111 | 1 | let mkPackage = |
112 | 2 | https://raw.githubusercontent.com/purescript/package-sets/psc-0.13.3-20190831/src/mkPackage.dhall sha256:0b197efa1d397ace6eb46b243ff2d73a3da5638d8d0ac8473e8e4a8fc528cf57 |
113 | 3 |
|
|
0 commit comments