on 2cabd50 help sign in
.github/workflows/haskell.ymldeleted−47
since splitsnapshots
unifiedsplit
@@ -1,47 +0,0 @@
1−name: github-action
2−
3−on: [push, pull_request]
4−
5−jobs:
6− build:
7− strategy:
8− matrix:
9− ghc: ['8.0.2', '8.2.2', '8.4.4', '8.6.5', '8.8.4', '8.10.2']
10− os: ['ubuntu-latest', 'macos-latest']
11− exclude:
12− # There are some linker warnings in 802 on darwin that
13− # cause compilation to fail
14− # See https://github.com/NixOS/nixpkgs/issues/25139
15− - ghc: '8.0.2'
16− os: 'macos-latest'
17− runs-on: ${{ matrix.os }}
18−
19− name: GHC ${{ matrix.ghc }} on ${{ matrix.os }}
20− steps:
21− - uses: actions/checkout@v2
22− - uses: actions/setup-haskell@v1
23− with:
24− ghc-version: ${{ matrix.ghc }}
25− - name: Cache
26− uses: actions/cache@v1
27− env:
28− cache-name: cache-cabal
29− with:
30− path: ~/.cabal
31− key: ${{ runner.os }}-${{ matrix.ghc }}-build-${{ env.cache-name }}-${{ hashFiles('**/*.cabal') }}-${{ hashFiles('**/cabal.project') }}
32− restore-keys: |
33− ${{ runner.os }}-${{ matrix.ghc }}-build-${{ env.cache-name }}-
34− ${{ runner.os }}-${{ matrix.ghc }}-build-
35− ${{ runner.os }}-${{ matrix.ghc }}-
36− ${{ runner.os }}
37−
38− - name: Install dependencies
39− run: |
40− cabal update
41− cabal build --only-dependencies --enable-tests --enable-benchmarks
42− - name: Build
43− run: cabal build --enable-tests --enable-benchmarks all
44− - name: Run tests
45− run: cabal test --enable-tests all
46− - name: Build Docs
47− run: cabal haddock
.travis.ymlnew file+171
@@ -0,0 +1,171 @@
1+# This Travis job script has been generated by a script via
2+#
3+# haskell-ci '--config=cabal.haskell-ci' 'cabal.project'
4+#
5+# For more information, see https://github.com/haskell-CI/haskell-ci
6+#
7+# version: 0.3.20190814
8+#
9+language: c
10+dist: xenial
11+sudo: required
12+git:
13+ # whether to recursively clone submodules
14+ submodules: false
15+cache:
16+ directories:
17+ - $HOME/.cabal/packages
18+ - $HOME/.cabal/store
19+before_cache:
20+ - rm -fv $CABALHOME/packages/hackage.haskell.org/build-reports.log
21+ # remove files that are regenerated by 'cabal update'
22+ - rm -fv $CABALHOME/packages/hackage.haskell.org/00-index.*
23+ - rm -fv $CABALHOME/packages/hackage.haskell.org/*.json
24+ - rm -fv $CABALHOME/packages/hackage.haskell.org/01-index.cache
25+ - rm -fv $CABALHOME/packages/hackage.haskell.org/01-index.tar
26+ - rm -fv $CABALHOME/packages/hackage.haskell.org/01-index.tar.idx
27+ - rm -rfv $CABALHOME/packages/head.hackage
28+matrix:
29+ include:
30+ - compiler: ghcjs-8.4
31+ addons: {"apt":{"sources":["hvr-ghc"],"packages":["cabal-install-3.0"]}}
32+ - compiler: ghc-8.8.1
33+ addons: {"apt":{"sources":["hvr-ghc"],"packages":["ghc-8.8.1","cabal-install-3.0"]}}
34+ - compiler: ghc-8.6.5
35+ addons: {"apt":{"sources":["hvr-ghc"],"packages":["ghc-8.6.5","cabal-install-2.4"]}}
36+ - compiler: ghc-8.4.4
37+ addons: {"apt":{"sources":["hvr-ghc"],"packages":["ghc-8.4.4","cabal-install-2.4"]}}
38+ - compiler: ghc-8.2.2
39+ addons: {"apt":{"sources":["hvr-ghc"],"packages":["ghc-8.2.2","cabal-install-2.4"]}}
40+ - compiler: ghc-8.0.2
41+ addons: {"apt":{"sources":["hvr-ghc"],"packages":["ghc-8.0.2","cabal-install-2.4"]}}
42+before_install:
43+ - |
44+ if [ "$TRAVIS_OS_NAME" = "linux" ]; then
45+ sudo add-apt-repository -y ppa:hvr/ghcjs;
46+ curl -s https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo apt-key add -
47+ sudo apt-add-repository 'https://deb.nodesource.com/node_8.x xenial main'
48+ sudo apt-get update;
49+ sudo apt-get install $CC cabal-install-3.0 nodejs;
50+ fi
51+ - HC=$(echo "/opt/$CC/bin/ghc" | sed 's/-/\//')
52+ - WITHCOMPILER="-w $HC"
53+ - |
54+ if echo $CC | grep -q ghcjs; then
55+ GHCJS=true
56+ HC=${HC}js
57+ WITHCOMPILER="--ghcjs ${WITHCOMPILER}js"
58+ else
59+ GHCJS=false;
60+ fi
61+ - if $GHCJS ; then sudo apt-get install -y ghc-8.4.4 ; fi
62+ - if $GHCJS ; then PATH="/opt/ghc/8.4.4/bin:$PATH" ; fi
63+ - HCPKG="$HC-pkg"
64+ - unset CC
65+ - CABAL=/opt/ghc/bin/cabal
66+ - CABALHOME=$HOME/.cabal
67+ - export PATH="$CABALHOME/bin:$PATH"
68+ - TOP=$(pwd)
69+ - "HCNUMVER=$(${HC} --numeric-version|perl -ne '/^(\\d+)\\.(\\d+)\\.(\\d+)(\\.(\\d+))?$/; print(10000 * $1 + 100 * $2 + ($3 == 0 ? $5 != 1 : $3))')"
70+ - echo $HCNUMVER
71+ - CABAL="$CABAL -vnormal+nowrap+markoutput"
72+ - set -o pipefail
73+ - |
74+ echo 'function blue(s) { printf "\033[0;34m" s "\033[0m " }' >> .colorful.awk
75+ echo 'BEGIN { state = "output"; }' >> .colorful.awk
76+ echo '/^-----BEGIN CABAL OUTPUT-----$/ { state = "cabal" }' >> .colorful.awk
77+ echo '/^-----END CABAL OUTPUT-----$/ { state = "output" }' >> .colorful.awk
78+ echo '!/^(-----BEGIN CABAL OUTPUT-----|-----END CABAL OUTPUT-----)/ {' >> .colorful.awk
79+ echo ' if (state == "cabal") {' >> .colorful.awk
80+ echo ' print blue($0)' >> .colorful.awk
81+ echo ' } else {' >> .colorful.awk
82+ echo ' print $0' >> .colorful.awk
83+ echo ' }' >> .colorful.awk
84+ echo '}' >> .colorful.awk
85+ - cat .colorful.awk
86+ - |
87+ color_cabal_output () {
88+ awk -f $TOP/.colorful.awk
89+ }
90+ - echo text | color_cabal_output
91+install:
92+ - ${CABAL} --version
93+ - echo "$(${HC} --version) [$(${HC} --print-project-git-commit-id 2> /dev/null || echo '?')]"
94+ - node --version
95+ - echo $GHCJS
96+ - TEST=--enable-tests
97+ - BENCH=--enable-benchmarks
98+ - BENCH=--disable-benchmarks
99+ - HEADHACKAGE=false
100+ - rm -f $CABALHOME/config
101+ - |
102+ echo "verbose: normal +nowrap +markoutput" >> $CABALHOME/config
103+ echo "remote-build-reporting: anonymous" >> $CABALHOME/config
104+ echo "write-ghc-environment-files: always" >> $CABALHOME/config
105+ echo "remote-repo-cache: $CABALHOME/packages" >> $CABALHOME/config
106+ echo "logs-dir: $CABALHOME/logs" >> $CABALHOME/config
107+ echo "world-file: $CABALHOME/world" >> $CABALHOME/config
108+ echo "extra-prog-path: $CABALHOME/bin" >> $CABALHOME/config
109+ echo "symlink-bindir: $CABALHOME/bin" >> $CABALHOME/config
110+ echo "installdir: $CABALHOME/bin" >> $CABALHOME/config
111+ echo "build-summary: $CABALHOME/logs/build.log" >> $CABALHOME/config
112+ echo "store-dir: $CABALHOME/store" >> $CABALHOME/config
113+ echo "install-dirs user" >> $CABALHOME/config
114+ echo " prefix: $CABALHOME" >> $CABALHOME/config
115+ echo "repository hackage.haskell.org" >> $CABALHOME/config
116+ echo " url: http://hackage.haskell.org/" >> $CABALHOME/config
117+ - cat $CABALHOME/config
118+ - rm -fv cabal.project cabal.project.local cabal.project.freeze
119+ - travis_retry ${CABAL} v2-update -v
120+ - if $GHCJS ; then (cd /tmp && ${CABAL} v2-install -w ghc-8.4.4 happy) ; fi
121+ # Generate cabal.project
122+ - rm -rf cabal.project cabal.project.local cabal.project.freeze
123+ - touch cabal.project
124+ - |
125+ echo "packages: ." >> cabal.project
126+ - |
127+ - cat cabal.project || true
128+ - cat cabal.project.local || true
129+ - if [ -f "./configure.ac" ]; then (cd "." && autoreconf -i); fi
130+ - ${CABAL} v2-freeze $WITHCOMPILER ${TEST} ${BENCH} | color_cabal_output
131+ - "cat cabal.project.freeze | sed -E 's/^(constraints: *| *)//' | sed 's/any.//'"
132+ - rm cabal.project.freeze
133+script:
134+ - DISTDIR=$(mktemp -d /tmp/dist-test.XXXX)
135+ # Packaging...
136+ - ${CABAL} v2-sdist all | color_cabal_output
137+ # Unpacking...
138+ - mv dist-newstyle/sdist/*.tar.gz ${DISTDIR}/
139+ - cd ${DISTDIR} || false
140+ - find . -maxdepth 1 -type f -name '*.tar.gz' -exec tar -xvf '{}' \;
141+ - find . -maxdepth 1 -type f -name '*.tar.gz' -exec rm '{}' \;
142+ - PKGDIR_patch="$(find . -maxdepth 1 -type d -regex '.*/patch-[0-9.]*')"
143+ # Generate cabal.project
144+ - rm -rf cabal.project cabal.project.local cabal.project.freeze
145+ - touch cabal.project
146+ - |
147+ echo "packages: ${PKGDIR_patch}" >> cabal.project
148+ - |
149+ - cat cabal.project || true
150+ - cat cabal.project.local || true
151+ # Building...
152+ # this builds all libraries and executables (without tests/benchmarks)
153+ - ${CABAL} v2-build $WITHCOMPILER --disable-tests --disable-benchmarks all | color_cabal_output
154+ # Building with tests and benchmarks...
155+ # build & run tests, build benchmarks
156+ - ${CABAL} v2-build $WITHCOMPILER ${TEST} ${BENCH} all | color_cabal_output
157+ # Testing...
158+ - if ! $GHCJS ; then ${CABAL} v2-test $WITHCOMPILER ${TEST} ${BENCH} all | color_cabal_output ; fi
159+ # cabal check...
160+ - (cd ${PKGDIR_patch} && ${CABAL} -vnormal check)
161+ # haddock...
162+ - if ! $GHCJS ; then ${CABAL} v2-haddock $WITHCOMPILER ${TEST} ${BENCH} all | color_cabal_output ; fi
163+ # Constraint sets
164+ - rm -rf cabal.project.local
165+ # Constraint set old-these
166+ - if $GHCJS || ! $GHCJS && [ $HCNUMVER -lt 80800 ] ; then ${CABAL} v2-build $WITHCOMPILER --disable-tests --disable-benchmarks --constraint='these <1' all | color_cabal_output ; fi
167+ # Constraint set old-witherable
168+ - ${CABAL} v2-build $WITHCOMPILER --disable-tests --disable-benchmarks --constraint='witherable <0.3.2' all | color_cabal_output
169+
170+# REGENDATA ["--config=cabal.haskell-ci","cabal.project"]
171+# EOF
ChangeLog.md+7−27
@@ -1,40 +1,20 @@
1# Revision history for patch
1# Revision history for patch
2
2
3−## Unreleased
4−
5−* New dep of `data-orphans` for old GHC to get instances honestly instead of
6− via `monoidal-containers`.
7−
8−## 0.0.5.0 - 2021-12-17
9−
10−* `Additive` now lives in `Data.Semigroup.Additive`, but is still reexported
11− from `Data.Patch` for compatability.
12−
13−* Rewrite `PatchMapWithMove` in terms of `PatchMapWithPatchingMove`.
14− Care is taken to make this not a breaking change.
15− In particular, `PatchMapWithMove` is a newtype of `PatchMapWithPatchingMove`, as is the `NodeInfo` and `From` of `PatchMapWithPatchingMove`'s versions of those.
16− There are complete constructor and field patterns too, and everything is
17− exported under the newtype as real constructors and fields would be.
18−
19−## 0.0.4.0 - 2021-04-20
20−
21−* Enable PolyKinds
22−
23−## 0.0.3.2 - 2020-11-06
3+## 0.0.3.2
24
4
25* Update version bounds
5* Update version bounds
26
6
27−## 0.0.3.1 - 2020-02-05
7+## 0.0.3.1
28
8
29* Replace `fromJust` with something easier to debug.
9* Replace `fromJust` with something easier to debug.
30
10
31−## 0.0.3.0 - 2020-02-05
11+## 0.0.3.0
32
12
33* Create `PatchMapWithPatchingMove` variant which supports moves with a patch.
13* Create `PatchMapWithPatchingMove` variant which supports moves with a patch.
34
14
35* Create `DecidablyEmpty` subclass of `Monoid`.
15* Create `DecidablyEmpty` subclass of `Monoid`.
36
16
37−## 0.0.2.0 - 2020-01-17
17+## 0.0.2.0
38
18
39* Consistently provide:
19* Consistently provide:
40
20
@@ -46,16 +26,16 @@
46
26
47 for `PatchMap`, `PatchIntMap`, and `PatchMapWithMove`.
27 for `PatchMap`, `PatchIntMap`, and `PatchMapWithMove`.
48
28
49−## 0.0.1.0 - 2020-01-09
29+## 0.0.1.0
50
30
51* Support older GHCs with `split-these` flag.
31* Support older GHCs with `split-these` flag.
52
32
53* Additional instances for the `Group` class for basic types.
33* Additional instances for the `Group` class for basic types.
54
34
55−## 0.0.0.1 - 2020-01-08
35+## 0.0.0.1
56
36
57* Remove unneeded dependencies
37* Remove unneeded dependencies
58
38
59−## 0.0.0.0 - 2020-01-08
39+## 0.0.0.0
60
40
61* Extract patching functionality from Reflex.
41* Extract patching functionality from Reflex.
cabal.haskell-cinew file+14
@@ -0,0 +1,14 @@
1+distribution: xenial
2+benchmarks: False
3+unconstrained: False
4+installed: -all
5+
6+-- https://github.com/haskell/cabal/issues/6106
7+install-dependencies: False
8+
9+constraint-set old-these
10+ ghc: <8.8
11+ constraints: these <1
12+
13+constraint-set old-witherable
14+ constraints: witherable <0.3.2
patch.cabal+4−9
@@ -1,5 +1,5 @@
1Name: patch
1Name: patch
2−Version: 0.0.5.0
2+Version: 0.0.3.2
3Synopsis: Data structures for describing changes to other data structures.
3Synopsis: Data structures for describing changes to other data structures.
4Description:
4Description:
5 Data structures for describing changes to other data structures.
5 Data structures for describing changes to other data structures.
@@ -33,7 +33,7 @@ flag split-these
33library
33library
34 hs-source-dirs: src
34 hs-source-dirs: src
35 default-language: Haskell2010
35 default-language: Haskell2010
36− build-depends: base >= 4.9 && < 4.15
36+ build-depends: base >= 4.9 && < 4.14
37 , constraints-extras >= 0.3 && < 0.4
37 , constraints-extras >= 0.3 && < 0.4
38 , containers >= 0.6 && < 0.7
38 , containers >= 0.6 && < 0.7
39 , dependent-map >= 0.3 && < 0.5
39 , dependent-map >= 0.3 && < 0.5
@@ -41,10 +41,7 @@ library
41 , lens >= 4.7 && < 5
41 , lens >= 4.7 && < 5
42 , semigroupoids >= 4.0 && < 6
42 , semigroupoids >= 4.0 && < 6
43 , transformers >= 0.5.6.0 && < 0.6
43 , transformers >= 0.5.6.0 && < 0.6
44− , witherable >= 0.3 && < 0.5
44+ , witherable >= 0.3 && < 0.4
45−
46− if impl(ghc < 8.6) -- really, if base < 8.12
47− build-depends: base-orphans >= 0.8 && < 0.9
48
45
49 exposed-modules: Data.Functor.Misc
46 exposed-modules: Data.Functor.Misc
50 , Data.Monoid.DecidablyEmpty
47 , Data.Monoid.DecidablyEmpty
@@ -56,10 +53,8 @@ library
56 , Data.Patch.Map
53 , Data.Patch.Map
57 , Data.Patch.MapWithMove
54 , Data.Patch.MapWithMove
58 , Data.Patch.MapWithPatchingMove
55 , Data.Patch.MapWithPatchingMove
59− , Data.Semigroup.Additive
60
56
61 ghc-options: -Wall -fwarn-redundant-constraints -fwarn-tabs
57 ghc-options: -Wall -fwarn-redundant-constraints -fwarn-tabs
62− default-extensions: PolyKinds
63
58
64 if flag(split-these)
59 if flag(split-these)
65 build-depends: these >= 1 && <1.2
60 build-depends: these >= 1 && <1.2
@@ -91,7 +86,7 @@ test-suite hlint
91 , directory
86 , directory
92 , filepath
87 , filepath
93 , filemanip
88 , filemanip
94− , hlint (< 2.1 || >= 2.2.2) && < 3.3
89+ , hlint (< 2.1 || >= 2.2.2) && < 3
95 if impl(ghcjs)
90 if impl(ghcjs)
96 buildable: False
91 buildable: False
97
92
src/Data/Patch.hs+14−3
@@ -23,7 +23,6 @@ import Data.Semigroup (Semigroup (..))
23#endif
23#endif
24import GHC.Generics
24import GHC.Generics
25
25
26−import Data.Semigroup.Additive as X
27import Data.Patch.Class as X
26import Data.Patch.Class as X
28import Data.Patch.DMap as X hiding (getDeletions)
27import Data.Patch.DMap as X hiding (getDeletions)
29import Data.Patch.DMapWithMove as X
28import Data.Patch.DMapWithMove as X
@@ -46,6 +45,9 @@ class (Semigroup q, Monoid q) => Group q where
46 (~~) :: q -> q -> q
45 (~~) :: q -> q -> q
47 r ~~ s = r <> negateG s
46 r ~~ s = r <> negateG s
48
47
48+-- | An 'Additive' 'Semigroup' is one where (<>) is commutative
49+class Semigroup q => Additive q where
50+
49-- | The elements of an 'Additive' 'Semigroup' can be considered as patches of their own type.
51-- | The elements of an 'Additive' 'Semigroup' can be considered as patches of their own type.
50newtype AdditivePatch p = AdditivePatch { unAdditivePatch :: p }
52newtype AdditivePatch p = AdditivePatch { unAdditivePatch :: p }
51
53
@@ -56,15 +58,19 @@ instance Additive p => Patch (AdditivePatch p) where
56instance (Ord k, Group q) => Group (MonoidalMap k q) where
58instance (Ord k, Group q) => Group (MonoidalMap k q) where
57 negateG = fmap negateG
59 negateG = fmap negateG
58
60
61+instance (Ord k, Additive q) => Additive (MonoidalMap k q)
62+
59-- | Trivial group.
63-- | Trivial group.
60instance Group () where
64instance Group () where
61 negateG _ = ()
65 negateG _ = ()
62 _ ~~ _ = ()
66 _ ~~ _ = ()
67+instance Additive ()
63
68
64-- | Product group. A Pair of groups gives rise to a group
69-- | Product group. A Pair of groups gives rise to a group
65instance (Group a, Group b) => Group (a, b) where
70instance (Group a, Group b) => Group (a, b) where
66 negateG (a, b) = (negateG a, negateG b)
71 negateG (a, b) = (negateG a, negateG b)
67 (a, b) ~~ (c, d) = (a ~~ c, b ~~ d)
72 (a, b) ~~ (c, d) = (a ~~ c, b ~~ d)
73+instance (Additive a, Additive b) => Additive (a, b)
68
74
69-- See https://gitlab.haskell.org/ghc/ghc/issues/11135#note_111802 for the reason Compose is not also provided.
75-- See https://gitlab.haskell.org/ghc/ghc/issues/11135#note_111802 for the reason Compose is not also provided.
70-- Base does not define Monoid (Compose f g a) so this is the best we can
76-- Base does not define Monoid (Compose f g a) so this is the best we can
@@ -72,24 +78,29 @@ instance (Group a, Group b) => Group (a, b) where
72instance Group (f (g a)) => Group ((f :.: g) a) where
78instance Group (f (g a)) => Group ((f :.: g) a) where
73 negateG (Comp1 xs) = Comp1 (negateG xs)
79 negateG (Comp1 xs) = Comp1 (negateG xs)
74 Comp1 xs ~~ Comp1 ys = Comp1 (xs ~~ ys)
80 Comp1 xs ~~ Comp1 ys = Comp1 (xs ~~ ys)
81+instance Additive (f (g a)) => Additive ((f :.: g) a)
75
82
76-- | Product of groups, Functor style.
83-- | Product of groups, Functor style.
77instance (Group (f a), Group (g a)) => Group ((f :*: g) a) where
84instance (Group (f a), Group (g a)) => Group ((f :*: g) a) where
78 negateG (a :*: b) = negateG a :*: negateG b
85 negateG (a :*: b) = negateG a :*: negateG b
79 (a :*: b) ~~ (c :*: d) = (a ~~ c) :*: (b ~~ d)
86 (a :*: b) ~~ (c :*: d) = (a ~~ c) :*: (b ~~ d)
87+instance (Additive (f a), Additive (g a)) => Additive ((f :*: g) a)
80
88
81-- | Trivial group, Functor style
89-- | Trivial group, Functor style
82instance Group (Proxy x) where
90instance Group (Proxy x) where
83 negateG _ = Proxy
91 negateG _ = Proxy
84 _ ~~ _ = Proxy
92 _ ~~ _ = Proxy
93+instance Additive (Proxy x)
85
94
86-- | Const lifts groups into a functor.
95-- | Const lifts groups into a functor.
87deriving instance Group a => Group (Const a x)
96deriving instance Group a => Group (Const a x)
88−
97+instance Additive a => Additive (Const a x)
89−-- | Identity lifts groups pointwise (at only one point)
98+-- | Ideitnty lifts groups pointwise (at only one point)
90deriving instance Group a => Group (Identity a)
99deriving instance Group a => Group (Identity a)
100+instance Additive a => Additive (Identity a)
91
101
92-- | Functions lift groups pointwise.
102-- | Functions lift groups pointwise.
93instance Group b => Group (a -> b) where
103instance Group b => Group (a -> b) where
94 negateG f = negateG . f
104 negateG f = negateG . f
95 (~~) = liftA2 (~~)
105 (~~) = liftA2 (~~)
106+instance Additive b => Additive (a -> b)
src/Data/Patch/Class.hs+2−4
@@ -1,11 +1,9 @@
1{-# LANGUAGE CPP #-}
1{-# LANGUAGE CPP #-}
2−{-# LANGUAGE ScopedTypeVariables #-}
3{-# LANGUAGE TypeFamilies #-}
2{-# LANGUAGE TypeFamilies #-}
4-- | The interface for types which represent changes made to other types
3-- | The interface for types which represent changes made to other types
5module Data.Patch.Class where
4module Data.Patch.Class where
6
5
7import Data.Functor.Identity
6import Data.Functor.Identity
8−import Data.Kind (Type)
9import Data.Maybe
7import Data.Maybe
10#if !MIN_VERSION_base(4,11,0)
8#if !MIN_VERSION_base(4,11,0)
11import Data.Semigroup (Semigroup(..))
9import Data.Semigroup (Semigroup(..))
@@ -17,7 +15,7 @@ import Data.Proxy
17-- If an instance of 'Patch' is also an instance of 'Semigroup', it should obey
15-- If an instance of 'Patch' is also an instance of 'Semigroup', it should obey
18-- the law that @applyAlways (f <> g) == applyAlways f . applyAlways g@.
16-- the law that @applyAlways (f <> g) == applyAlways f . applyAlways g@.
19class Patch p where
17class Patch p where
20− type PatchTarget p :: Type
18+ type PatchTarget p :: *
21 -- | Apply the patch @p a@ to the value @a@. If no change is needed, return
19 -- | Apply the patch @p a@ to the value @a@. If no change is needed, return
22 -- 'Nothing'.
20 -- 'Nothing'.
23 apply :: p -> PatchTarget p -> Maybe (PatchTarget p)
21 apply :: p -> PatchTarget p -> Maybe (PatchTarget p)
@@ -32,7 +30,7 @@ instance Patch (Identity a) where
32 apply (Identity a) _ = Just a
30 apply (Identity a) _ = Just a
33
31
34-- | 'Proxy' can be used as a 'Patch' that does nothing.
32-- | 'Proxy' can be used as a 'Patch' that does nothing.
35−instance forall (a :: Type). Patch (Proxy a) where
33+instance Patch (Proxy a) where
36 type PatchTarget (Proxy a) = a
34 type PatchTarget (Proxy a) = a
37 apply ~Proxy _ = Nothing
35 apply ~Proxy _ = Nothing
38
36
src/Data/Patch/DMapWithMove.hs+2−2
@@ -220,8 +220,8 @@ moveDMapKey src dst = case src `geq` dst of
220-- @
220-- @
221-- let aMay = DMap.lookup a dmap
221-- let aMay = DMap.lookup a dmap
222-- bMay = DMap.lookup b dmap
222-- bMay = DMap.lookup b dmap
223−-- in maybe id (DMap.insert a) (bMay <> aMay)
223+-- in maybe id (DMap.insert a) (bMay `mplus` aMay)
224−-- . maybe id (DMap.insert b) (aMay <> bMay)
224+-- . maybe id (DMap.insert b) (aMay `mplus` bMay)
225-- . DMap.delete a . DMap.delete b $ dmap
225-- . DMap.delete a . DMap.delete b $ dmap
226-- @
226-- @
227swapDMapKey :: GCompare k => k a -> k a -> PatchDMapWithMove k v
227swapDMapKey :: GCompare k => k a -> k a -> PatchDMapWithMove k v
src/Data/Patch/MapWithMove.hs+181−206
@@ -2,150 +2,97 @@
2{-# LANGUAGE DeriveTraversable #-}
2{-# LANGUAGE DeriveTraversable #-}
3{-# LANGUAGE FlexibleContexts #-}
3{-# LANGUAGE FlexibleContexts #-}
4{-# LANGUAGE FlexibleInstances #-}
4{-# LANGUAGE FlexibleInstances #-}
5−{-# LANGUAGE GeneralizedNewtypeDeriving #-}
6{-# LANGUAGE LambdaCase #-}
5{-# LANGUAGE LambdaCase #-}
7{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE PatternGuards #-}
7{-# LANGUAGE PatternGuards #-}
9−{-# LANGUAGE PatternSynonyms #-}
10{-# LANGUAGE ScopedTypeVariables #-}
8{-# LANGUAGE ScopedTypeVariables #-}
11−{-# LANGUAGE StandaloneDeriving #-}
12{-# LANGUAGE TemplateHaskell #-}
9{-# LANGUAGE TemplateHaskell #-}
13{-# LANGUAGE TypeApplications #-}
10{-# LANGUAGE TypeApplications #-}
14{-# LANGUAGE TypeFamilies #-}
11{-# LANGUAGE TypeFamilies #-}
15−{-# LANGUAGE ViewPatterns #-}
16
12
17-- | 'Patch'es on 'Map' that can insert, delete, and move values from one key to
13-- | 'Patch'es on 'Map' that can insert, delete, and move values from one key to
18-- another
14-- another
19−module Data.Patch.MapWithMove
15+module Data.Patch.MapWithMove where
20− ( PatchMapWithMove
21− ( PatchMapWithMove
22− , unPatchMapWithMove
23− , ..
24− )
25− , patchMapWithMove
26− , patchMapWithMoveInsertAll
27− , insertMapKey
28− , moveMapKey
29− , swapMapKey
30− , deleteMapKey
31− , unsafePatchMapWithMove
32− , patchMapWithMoveNewElements
33− , patchMapWithMoveNewElementsMap
34− , patchThatSortsMapWith
35− , patchThatChangesAndSortsMapWith
36− , patchThatChangesMap
37
16
38− -- * Node Info
39− , NodeInfo
40− ( NodeInfo
41− , _nodeInfo_to
42− , _nodeInfo_from
43− , ..
44− )
45− , bitraverseNodeInfo
46− , nodeInfoMapFrom
47− , nodeInfoMapMFrom
48− , nodeInfoSetTo
49−
50− -- * From
51− , From
52− ( From_Insert
53− , From_Delete
54− , From_Move
55− , ..
56− )
57− , bitraverseFrom
58−
59− -- * To
60− , To
61− ) where
62−
63−import Data.Coerce
64−import Data.Kind (Type)
65import Data.Patch.Class
17import Data.Patch.Class
66−import Data.Patch.MapWithPatchingMove (PatchMapWithPatchingMove(..), To)
67−import qualified Data.Patch.MapWithPatchingMove as PM -- already a transparent synonym
68
18
69−import Control.Lens
19+import Control.Lens hiding (from, to)
20+import Data.Align (align)
21+import Data.Foldable
22+import Data.Function
70import Data.List
23import Data.List
71import Data.Map (Map)
24import Data.Map (Map)
72import qualified Data.Map as Map
25import qualified Data.Map as Map
73−import Data.Proxy
26+import Data.Maybe
74#if !MIN_VERSION_base(4,11,0)
27#if !MIN_VERSION_base(4,11,0)
75import Data.Semigroup (Semigroup (..))
28import Data.Semigroup (Semigroup (..))
76#endif
29#endif
77−import Data.Traversable (foldMapDefault)
30+import Data.Set (Set)
31+import qualified Data.Set as Set
32+import Data.These (These(..))
78
33
79-- | Patch a Map with additions, deletions, and moves. Invariant: If key @k1@
34-- | Patch a Map with additions, deletions, and moves. Invariant: If key @k1@
80-- is coming from @From_Move k2@, then key @k2@ should be going to @Just k1@,
35-- is coming from @From_Move k2@, then key @k2@ should be going to @Just k1@,
81-- and vice versa. There should never be any unpaired From/To keys.
36-- and vice versa. There should never be any unpaired From/To keys.
82−newtype PatchMapWithMove k (v :: Type) = PatchMapWithMove'
37+newtype PatchMapWithMove k v = PatchMapWithMove
83− { -- | Extract the underlying 'PatchMapWithPatchingMove k (Proxy v)'
38+ { -- | Extract the internal representation of the 'PatchMapWithMove'
84− unPatchMapWithMove' :: PatchMapWithPatchingMove k (Proxy v)
39+ unPatchMapWithMove :: Map k (NodeInfo k v)
85 }
40 }
86 deriving ( Show, Read, Eq, Ord
41 deriving ( Show, Read, Eq, Ord
87−-- Haddock cannot handle documentation here before GHC 8.6
42+ , Functor, Foldable, Traversable
88− ,
89−#if __GLASGOW_HASKELL__ >= 806
90− -- | Compose patches having the same effect as applying the
91− -- patches in turn: @'applyAlways' (p <> q) == 'applyAlways' p .
92− -- 'applyAlways' q@
93−#endif
94− Semigroup
95− , Monoid
96 )
43 )
97
44
98−pattern Coerce :: Coercible a b => a -> b
45+-- | Holds the information about each key: where its new value should come from,
99−pattern Coerce x <- (coerce -> x)
46+-- and where its old value should go to
100− where Coerce x = coerce x
47+data NodeInfo k v = NodeInfo
101−
48+ { _nodeInfo_from :: !(From k v)
102−{-# COMPLETE PatchMapWithMove #-}
49+ -- ^ Where do we get the new value for this key?
103−pattern PatchMapWithMove :: Map k (NodeInfo k v) -> PatchMapWithMove k v
50+ , _nodeInfo_to :: !(To k)
104−-- | Extract the representation of the 'PatchMapWithMove' as a map of
51+ -- ^ If the old value is being kept (i.e. moved rather than deleted or
105−-- 'NodeInfo'.
52+ -- replaced), where is it going?
106−unPatchMapWithMove :: PatchMapWithMove k v -> Map k (NodeInfo k v)
53+ }
107−pattern PatchMapWithMove { unPatchMapWithMove } = PatchMapWithMove' (PatchMapWithPatchingMove (Coerce unPatchMapWithMove))
54+ deriving (Show, Read, Eq, Ord, Functor, Foldable, Traversable)
108−
109−_PatchMapWithMove
110− :: Iso
111− (PatchMapWithMove k0 v0)
112− (PatchMapWithMove k1 v1)
113− (Map k0 (NodeInfo k0 v0))
114− (Map k1 (NodeInfo k1 v1))
115−_PatchMapWithMove = iso unPatchMapWithMove PatchMapWithMove
116
55
117−instance Functor (PatchMapWithMove k) where
56+-- | Describe how a key's new value should be produced
118− fmap f = runIdentity . traverse (Identity . f)
57+data From k v
58+ = From_Insert v -- ^ Insert the given value here
59+ | From_Delete -- ^ Delete the existing value, if any, from here
60+ | From_Move !k -- ^ Move the value here from the given key
61+ deriving (Show, Read, Eq, Ord, Functor, Foldable, Traversable)
119
62
120−instance Foldable (PatchMapWithMove k) where
63+-- | Describe where a key's old value will go. If this is 'Just', that means
121− foldMap = foldMapDefault
64+-- the key's old value will be moved to the given other key; if it is 'Nothing',
65+-- that means it will be deleted.
66+type To = Maybe
122
67
123−instance Traversable (PatchMapWithMove k) where
68+makeWrapped ''PatchMapWithMove
124− traverse =
125− _PatchMapWithMove .
126− traverse .
127− traverse
128
69
129instance FunctorWithIndex k (PatchMapWithMove k)
70instance FunctorWithIndex k (PatchMapWithMove k)
130instance FoldableWithIndex k (PatchMapWithMove k)
71instance FoldableWithIndex k (PatchMapWithMove k)
131instance TraversableWithIndex k (PatchMapWithMove k) where
72instance TraversableWithIndex k (PatchMapWithMove k) where
132 itraverse = itraversed . Indexed
73 itraverse = itraversed . Indexed
133− itraversed =
74+ itraversed = _Wrapped .> itraversed <. traversed
134− _PatchMapWithMove .>
135− itraversed <.
136− traverse
137
75
138-- | Create a 'PatchMapWithMove', validating it
76-- | Create a 'PatchMapWithMove', validating it
139patchMapWithMove :: Ord k => Map k (NodeInfo k v) -> Maybe (PatchMapWithMove k v)
77patchMapWithMove :: Ord k => Map k (NodeInfo k v) -> Maybe (PatchMapWithMove k v)
140−patchMapWithMove = fmap PatchMapWithMove' . PM.patchMapWithPatchingMove . coerce
78+patchMapWithMove m = if valid then Just $ PatchMapWithMove m else Nothing
79+ where valid = forwardLinks == backwardLinks
80+ forwardLinks = Map.mapMaybe _nodeInfo_to m
81+ backwardLinks = Map.fromList $ catMaybes $ flip fmap (Map.toList m) $ \(to, v) ->
82+ case _nodeInfo_from v of
83+ From_Move from -> Just (from, to)
84+ _ -> Nothing
141
85
142-- | Create a 'PatchMapWithMove' that inserts everything in the given 'Map'
86-- | Create a 'PatchMapWithMove' that inserts everything in the given 'Map'
143patchMapWithMoveInsertAll :: Map k v -> PatchMapWithMove k v
87patchMapWithMoveInsertAll :: Map k v -> PatchMapWithMove k v
144−patchMapWithMoveInsertAll = PatchMapWithMove' . PM.patchMapWithPatchingMoveInsertAll
88+patchMapWithMoveInsertAll m = PatchMapWithMove $ flip fmap m $ \v -> NodeInfo
89+ { _nodeInfo_from = From_Insert v
90+ , _nodeInfo_to = Nothing
91+ }
145
92
146-- | Make a @'PatchMapWithMove' k v@ which has the effect of inserting or updating a value @v@ to the given key @k@, like 'Map.insert'.
93-- | Make a @'PatchMapWithMove' k v@ which has the effect of inserting or updating a value @v@ to the given key @k@, like 'Map.insert'.
147insertMapKey :: k -> v -> PatchMapWithMove k v
94insertMapKey :: k -> v -> PatchMapWithMove k v
148−insertMapKey k v = PatchMapWithMove' $ PM.insertMapKey k v
95+insertMapKey k v = PatchMapWithMove . Map.singleton k $ NodeInfo (From_Insert v) Nothing
149
96
150-- |Make a @'PatchMapWithMove' k v@ which has the effect of moving the value from the first key @k@ to the second key @k@, equivalent to:
97-- |Make a @'PatchMapWithMove' k v@ which has the effect of moving the value from the first key @k@ to the second key @k@, equivalent to:
151--
98--
@@ -153,160 +100,188 @@ insertMapKey k v = PatchMapWithMove' $ PM.insertMapKey k v
153-- 'Map.delete' src (maybe map ('Map.insert' dst) (Map.lookup src map))
100-- 'Map.delete' src (maybe map ('Map.insert' dst) (Map.lookup src map))
154-- @
101-- @
155moveMapKey :: Ord k => k -> k -> PatchMapWithMove k v
102moveMapKey :: Ord k => k -> k -> PatchMapWithMove k v
156−moveMapKey src dst = PatchMapWithMove' $ PM.moveMapKey src dst
103+moveMapKey src dst
104+ | src == dst = mempty
105+ | otherwise =
106+ PatchMapWithMove $ Map.fromList
107+ [ (dst, NodeInfo (From_Move src) Nothing)
108+ , (src, NodeInfo From_Delete (Just dst))
109+ ]
157
110
158-- |Make a @'PatchMapWithMove' k v@ which has the effect of swapping two keys in the mapping, equivalent to:
111-- |Make a @'PatchMapWithMove' k v@ which has the effect of swapping two keys in the mapping, equivalent to:
159--
112--
160-- @
113-- @
161-- let aMay = Map.lookup a map
114-- let aMay = Map.lookup a map
162-- bMay = Map.lookup b map
115-- bMay = Map.lookup b map
163−-- in maybe id (Map.insert a) (bMay <> aMay)
116+-- in maybe id (Map.insert a) (bMay `mplus` aMay)
164−-- . maybe id (Map.insert b) (aMay <> bMay)
117+-- . maybe id (Map.insert b) (aMay `mplus` bMay)
165-- . Map.delete a . Map.delete b $ map
118-- . Map.delete a . Map.delete b $ map
166-- @
119-- @
167swapMapKey :: Ord k => k -> k -> PatchMapWithMove k v
120swapMapKey :: Ord k => k -> k -> PatchMapWithMove k v
168−swapMapKey src dst = PatchMapWithMove' $ PM.swapMapKey src dst
121+swapMapKey src dst
122+ | src == dst = mempty
123+ | otherwise =
124+ PatchMapWithMove $ Map.fromList
125+ [ (dst, NodeInfo (From_Move src) (Just src))
126+ , (src, NodeInfo (From_Move dst) (Just dst))
127+ ]
169
128
170-- |Make a @'PatchMapWithMove' k v@ which has the effect of deleting a key in the mapping, equivalent to 'Map.delete'.
129-- |Make a @'PatchMapWithMove' k v@ which has the effect of deleting a key in the mapping, equivalent to 'Map.delete'.
171deleteMapKey :: k -> PatchMapWithMove k v
130deleteMapKey :: k -> PatchMapWithMove k v
172−deleteMapKey = PatchMapWithMove' . PM.deleteMapKey
131+deleteMapKey k = PatchMapWithMove . Map.singleton k $ NodeInfo From_Delete Nothing
173
132
174-- | Wrap a @'Map' k (NodeInfo k v)@ representing patch changes into a @'PatchMapWithMove' k v@, without checking any invariants.
133-- | Wrap a @'Map' k (NodeInfo k v)@ representing patch changes into a @'PatchMapWithMove' k v@, without checking any invariants.
175--
134--
176-- __Warning:__ when using this function, you must ensure that the invariants of 'PatchMapWithMove' are preserved; they will not be checked.
135-- __Warning:__ when using this function, you must ensure that the invariants of 'PatchMapWithMove' are preserved; they will not be checked.
177unsafePatchMapWithMove :: Map k (NodeInfo k v) -> PatchMapWithMove k v
136unsafePatchMapWithMove :: Map k (NodeInfo k v) -> PatchMapWithMove k v
178−unsafePatchMapWithMove = coerce PM.unsafePatchMapWithPatchingMove
137+unsafePatchMapWithMove = PatchMapWithMove
179
138
180-- | Apply the insertions, deletions, and moves to a given 'Map'
139-- | Apply the insertions, deletions, and moves to a given 'Map'
181instance Ord k => Patch (PatchMapWithMove k v) where
140instance Ord k => Patch (PatchMapWithMove k v) where
182 type PatchTarget (PatchMapWithMove k v) = Map k v
141 type PatchTarget (PatchMapWithMove k v) = Map k v
183− apply (PatchMapWithMove' p) = apply p
142+ apply (PatchMapWithMove p) old = Just $! insertions `Map.union` (old `Map.difference` deletions) --TODO: return Nothing sometimes --Note: the strict application here is critical to ensuring that incremental merges don't hold onto all their prerequisite events forever; can we make this more robust?
143+ where insertions = flip Map.mapMaybeWithKey p $ \_ ni -> case _nodeInfo_from ni of
144+ From_Insert v -> Just v
145+ From_Move k -> Map.lookup k old
146+ From_Delete -> Nothing
147+ deletions = flip Map.mapMaybeWithKey p $ \_ ni -> case _nodeInfo_from ni of
148+ From_Delete -> Just ()
149+ _ -> Nothing
184
150
185-- | Returns all the new elements that will be added to the 'Map'.
151-- | Returns all the new elements that will be added to the 'Map'.
186patchMapWithMoveNewElements :: PatchMapWithMove k v -> [v]
152patchMapWithMoveNewElements :: PatchMapWithMove k v -> [v]
187−patchMapWithMoveNewElements = PM.patchMapWithPatchingMoveNewElements . unPatchMapWithMove'
153+patchMapWithMoveNewElements = Map.elems . patchMapWithMoveNewElementsMap
188
154
189-- | Return a @'Map' k v@ with all the inserts/updates from the given @'PatchMapWithMove' k v@.
155-- | Return a @'Map' k v@ with all the inserts/updates from the given @'PatchMapWithMove' k v@.
190patchMapWithMoveNewElementsMap :: PatchMapWithMove k v -> Map k v
156patchMapWithMoveNewElementsMap :: PatchMapWithMove k v -> Map k v
191−patchMapWithMoveNewElementsMap = PM.patchMapWithPatchingMoveNewElementsMap . unPatchMapWithMove'
157+patchMapWithMoveNewElementsMap (PatchMapWithMove p) = Map.mapMaybe f p
158+ where f ni = case _nodeInfo_from ni of
159+ From_Insert v -> Just v
160+ From_Move _ -> Nothing
161+ From_Delete -> Nothing
192
162
193-- | Create a 'PatchMapWithMove' that, if applied to the given 'Map', will sort
163-- | Create a 'PatchMapWithMove' that, if applied to the given 'Map', will sort
194-- its values using the given ordering function. The set keys of the 'Map' is
164-- its values using the given ordering function. The set keys of the 'Map' is
195-- not changed.
165-- not changed.
196patchThatSortsMapWith :: Ord k => (v -> v -> Ordering) -> Map k v -> PatchMapWithMove k v
166patchThatSortsMapWith :: Ord k => (v -> v -> Ordering) -> Map k v -> PatchMapWithMove k v
197−patchThatSortsMapWith cmp = PatchMapWithMove' . PM.patchThatSortsMapWith cmp
167+patchThatSortsMapWith cmp m = PatchMapWithMove $ Map.fromList $ catMaybes $ zipWith g unsorted sorted
168+ where unsorted = Map.toList m
169+ sorted = sortBy (cmp `on` snd) unsorted
170+ f (to, _) (from, _) = if to == from then Nothing else
171+ Just (from, to)
172+ reverseMapping = Map.fromList $ catMaybes $ zipWith f unsorted sorted
173+ g (to, _) (from, _) = if to == from then Nothing else
174+ let Just movingTo = Map.lookup to reverseMapping
175+ in Just (to, NodeInfo (From_Move from) $ Just movingTo)
198
176
199-- | Create a 'PatchMapWithMove' that, if applied to the first 'Map' provided,
177-- | Create a 'PatchMapWithMove' that, if applied to the first 'Map' provided,
200-- will produce a 'Map' with the same values as the second 'Map' but with the
178-- will produce a 'Map' with the same values as the second 'Map' but with the
201-- values sorted with the given ordering function.
179-- values sorted with the given ordering function.
202−patchThatChangesAndSortsMapWith :: (Ord k, Ord v) => (v -> v -> Ordering) -> Map k v -> Map k v -> PatchMapWithMove k v
180+patchThatChangesAndSortsMapWith :: forall k v. (Ord k, Ord v) => (v -> v -> Ordering) -> Map k v -> Map k v -> PatchMapWithMove k v
203patchThatChangesAndSortsMapWith cmp oldByIndex newByIndexUnsorted = patchThatChangesMap oldByIndex newByIndex
181patchThatChangesAndSortsMapWith cmp oldByIndex newByIndexUnsorted = patchThatChangesMap oldByIndex newByIndex
204 where newList = Map.toList newByIndexUnsorted
182 where newList = Map.toList newByIndexUnsorted
205 newByIndex = Map.fromList $ zip (fst <$> newList) $ sortBy cmp $ snd <$> newList
183 newByIndex = Map.fromList $ zip (fst <$> newList) $ sortBy cmp $ snd <$> newList
206
184
207-- | Create a 'PatchMapWithMove' that, if applied to the first 'Map' provided,
185-- | Create a 'PatchMapWithMove' that, if applied to the first 'Map' provided,
208-- will produce the second 'Map'.
186-- will produce the second 'Map'.
209−patchThatChangesMap :: (Ord k, Ord v) => Map k v -> Map k v -> PatchMapWithMove k v
187+patchThatChangesMap :: forall k v. (Ord k, Ord v) => Map k v -> Map k v -> PatchMapWithMove k v
210−patchThatChangesMap oldByIndex newByIndex = PatchMapWithMove' $
188+patchThatChangesMap oldByIndex newByIndex = patch
211− PM.patchThatChangesMap oldByIndex newByIndex
189+ where invert :: Map k v -> Map v (Set k)
212−
190+ invert = Map.fromListWith (<>) . fmap (\(k, v) -> (v, Set.singleton k)) . Map.toList
213−--
191+ -- In the places where we use unionDistinct, a non-distinct key indicates a bug in this function
214−-- NodeInfo
192+ unionDistinct :: forall k' v'. Ord k' => Map k' v' -> Map k' v' -> Map k' v'
215−--
193+ unionDistinct = Map.unionWith (error "patchThatChangesMap: non-distinct keys")
216−
194+ unionPairDistinct :: (Map k (From k v), Map k (To k)) -> (Map k (From k v), Map k (To k)) -> (Map k (From k v), Map k (To k))
217−-- | Holds the information about each key: where its new value should come from,
195+ unionPairDistinct (oldFroms, oldTos) (newFroms, newTos) = (unionDistinct oldFroms newFroms, unionDistinct oldTos newTos)
218−-- and where its old value should go to
196+ -- Generate patch info for a single value
219−newtype NodeInfo k (v :: Type) = NodeInfo' { unNodeInfo' :: PM.NodeInfo k (Proxy v) }
197+ -- Keys that are found in both the old and new sets will not be patched
220−
198+ -- Keys that are found in only the old set will be moved to a new position if any are available; otherwise they will be deleted
221−deriving instance (Show k, Show p) => Show (NodeInfo k p)
199+ -- Keys that are found in only the new set will be populated by moving an old key if any are available; otherwise they will be inserted
222−deriving instance (Read k, Read p) => Read (NodeInfo k p)
200+ patchSingleValue :: v -> Set k -> Set k -> (Map k (From k v), Map k (To k))
223−deriving instance (Eq k, Eq p) => Eq (NodeInfo k p)
201+ patchSingleValue v oldKeys newKeys = foldl' unionPairDistinct mempty $ align (toList $ oldKeys `Set.difference` newKeys) (toList $ newKeys `Set.difference` oldKeys) <&> \case
224−deriving instance (Ord k, Ord p) => Ord (NodeInfo k p)
202+ This oldK -> (mempty, Map.singleton oldK Nothing) -- There's nowhere for this value to go, so we know we are deleting it
225−
203+ That newK -> (Map.singleton newK $ From_Insert v, mempty) -- There's nowhere fo this value to come from, so we know we are inserting it
226−{-# COMPLETE NodeInfo #-}
204+ These oldK newK -> (Map.singleton newK $ From_Move oldK, Map.singleton oldK $ Just newK)
227−pattern NodeInfo :: To k -> From k v -> NodeInfo k v
205+ -- Run patchSingleValue on a These. Missing old or new sets are considered empty
228−_nodeInfo_to :: NodeInfo k v -> To k
206+ patchSingleValueThese :: v -> These (Set k) (Set k) -> (Map k (From k v), Map k (To k))
229−_nodeInfo_from :: NodeInfo k v -> From k v
207+ patchSingleValueThese v = \case
230−pattern NodeInfo { _nodeInfo_to, _nodeInfo_from } = NodeInfo'
208+ This oldKeys -> patchSingleValue v oldKeys mempty
231− PM.NodeInfo
209+ That newKeys -> patchSingleValue v mempty newKeys
232− { PM._nodeInfo_to = _nodeInfo_to
210+ These oldKeys newKeys -> patchSingleValue v oldKeys newKeys
233− , PM._nodeInfo_from = Coerce _nodeInfo_from
211+ -- Generate froms and tos for all values, then merge them together
234− }
212+ (froms, tos) = foldl' unionPairDistinct mempty $ Map.mapWithKey patchSingleValueThese $ align (invert oldByIndex) (invert newByIndex)
235−
213+ patch = unsafePatchMapWithMove $ align froms tos <&> \case
236−_NodeInfo
214+ This from -> NodeInfo from Nothing -- Since we don't have a 'to' record for this key, that must mean it isn't being moved anywhere, so it should be deleted.
237− :: Iso
215+ That to -> NodeInfo From_Delete to -- Since we don't have a 'from' record for this key, it must be getting deleted
238− (NodeInfo k0 v0)
216+ These from to -> NodeInfo from to
239− (NodeInfo k1 v1)
240− (PM.NodeInfo k0 (Proxy v0))
241− (PM.NodeInfo k1 (Proxy v1))
242−_NodeInfo = iso unNodeInfo' NodeInfo'
243−
244−instance Functor (NodeInfo k) where
245− fmap f = runIdentity . traverse (Identity . f)
246−
247−instance Foldable (NodeInfo k) where
248− foldMap = foldMapDefault
249−
250−instance Traversable (NodeInfo k) where
251− traverse = bitraverseNodeInfo pure
252−
253−bitraverseNodeInfo
254− :: Applicative f
255− => (k0 -> f k1)
256− -> (v0 -> f v1)
257− -> NodeInfo k0 v0 -> f (NodeInfo k1 v1)
258−bitraverseNodeInfo fk fv = fmap NodeInfo'
259− . PM.bitraverseNodeInfo fk (\ ~Proxy -> pure Proxy) fv
260− . coerce
261
217
262-- | Change the 'From' value of a 'NodeInfo'
218-- | Change the 'From' value of a 'NodeInfo'
263nodeInfoMapFrom :: (From k v -> From k v) -> NodeInfo k v -> NodeInfo k v
219nodeInfoMapFrom :: (From k v -> From k v) -> NodeInfo k v -> NodeInfo k v
264−nodeInfoMapFrom f = coerce $ PM.nodeInfoMapFrom (unFrom' . f . From')
220+nodeInfoMapFrom f ni = ni { _nodeInfo_from = f $ _nodeInfo_from ni }
265
221
266-- | Change the 'From' value of a 'NodeInfo', using a 'Functor' (or
222-- | Change the 'From' value of a 'NodeInfo', using a 'Functor' (or
267-- 'Applicative', 'Monad', etc.) action to get the new value
223-- 'Applicative', 'Monad', etc.) action to get the new value
268−nodeInfoMapMFrom
269− :: Functor f
270− => (From k v -> f (From k v))
271− -> NodeInfo k v -> f (NodeInfo k v)
224+nodeInfoMapMFrom :: Functor f => (From k v -> f (From k v)) -> NodeInfo k v -> f (NodeInfo k v)
272−nodeInfoMapMFrom f = fmap NodeInfo'
225+nodeInfoMapMFrom f ni = fmap (\result -> ni { _nodeInfo_from = result }) $ f $ _nodeInfo_from ni
273− . PM.nodeInfoMapMFrom (fmap unFrom' . f . From')
274− . coerce
275
226
276-- | Set the 'To' field of a 'NodeInfo'
227-- | Set the 'To' field of a 'NodeInfo'
277nodeInfoSetTo :: To k -> NodeInfo k v -> NodeInfo k v
228nodeInfoSetTo :: To k -> NodeInfo k v -> NodeInfo k v
278−nodeInfoSetTo = coerce . PM.nodeInfoSetTo
229+nodeInfoSetTo to ni = ni { _nodeInfo_to = to }
279−
230+
280−--
231+-- |Helper data structure used for composing patches using the monoid instance.
281−-- From
232+data Fixup k v
282−--
233+ = Fixup_Delete
283−
234+ | Fixup_Update (These (From k v) (To k))
284−-- | Describe how a key's new value should be produced
235+
285−newtype From k (v :: Type) = From' { unFrom' :: PM.From k (Proxy v) }
236+-- |Compose patches having the same effect as applying the patches in turn: @'applyAlways' (p <> q) == 'applyAlways' p . 'applyAlways' q@
286−
237+instance Ord k => Semigroup (PatchMapWithMove k v) where
287−{-# COMPLETE From_Insert, From_Delete, From_Move #-}
238+ PatchMapWithMove ma <> PatchMapWithMove mb = PatchMapWithMove m
288−
239+ where
289−-- | Insert the given value here
240+ connections = Map.toList $ Map.intersectionWithKey (\_ a b -> (_nodeInfo_to a, _nodeInfo_from b)) ma mb
290−pattern From_Insert :: v -> From k v
241+ h :: (k, (Maybe k, From k v)) -> [(k, Fixup k v)]
291−pattern From_Insert v = From' (PM.From_Insert v)
242+ h (_, (mToAfter, editBefore)) = case (mToAfter, editBefore) of
292−
243+ (Just toAfter, From_Move fromBefore)
293−-- | Delete the existing value, if any, from here
244+ | fromBefore == toAfter
294−pattern From_Delete :: From k v
245+ -> [(toAfter, Fixup_Delete)]
295−pattern From_Delete = From' PM.From_Delete
246+ | otherwise
296−
247+ -> [ (toAfter, Fixup_Update (This editBefore))
297−-- | Move the value here from the given key
248+ , (fromBefore, Fixup_Update (That mToAfter))
298−pattern From_Move :: k -> From k v
249+ ]
299−pattern From_Move k = From' (PM.From_Move k Proxy)
250+ (Nothing, From_Move fromBefore) -> [(fromBefore, Fixup_Update (That mToAfter))] -- The item is destroyed in the second patch, so indicate that it is destroyed in the source map
300−
251+ (Just toAfter, _) -> [(toAfter, Fixup_Update (This editBefore))]
301−bitraverseFrom
252+ (Nothing, _) -> []
302− :: Applicative f
253+ mergeFixups _ Fixup_Delete Fixup_Delete = Fixup_Delete
303− => (k0 -> f k1)
254+ mergeFixups _ (Fixup_Update a) (Fixup_Update b)
304− -> (v0 -> f v1)
255+ | This x <- a, That y <- b
305− -> From k0 v0 -> f (From k1 v1)
256+ = Fixup_Update $ These x y
306−bitraverseFrom fk fv = fmap From'
257+ | That y <- a, This x <- b
307− . PM.bitraverseFrom fk (\ ~Proxy -> pure Proxy) fv
258+ = Fixup_Update $ These x y
308− . coerce
259+ mergeFixups _ _ _ = error "PatchMapWithMove: incompatible fixups"
309−
260+ fixups = Map.fromListWithKey mergeFixups $ concatMap h connections
310−makeWrapped ''PatchMapWithMove
261+ combineNodeInfos _ nia nib = NodeInfo
311−makeWrapped ''NodeInfo
262+ { _nodeInfo_from = _nodeInfo_from nia
312−makeWrapped ''From
263+ , _nodeInfo_to = _nodeInfo_to nib
264+ }
265+ applyFixup _ ni = \case
266+ Fixup_Delete -> Nothing
267+ Fixup_Update u -> Just $ NodeInfo
268+ { _nodeInfo_from = fromMaybe (_nodeInfo_from ni) $ getHere u
269+ , _nodeInfo_to = fromMaybe (_nodeInfo_to ni) $ getThere u
270+ }
271+ m = Map.differenceWithKey applyFixup (Map.unionWithKey combineNodeInfos ma mb) fixups
272+ getHere :: These a b -> Maybe a
273+ getHere = \case
274+ This a -> Just a
275+ These a _ -> Just a
276+ That _ -> Nothing
277+ getThere :: These a b -> Maybe b
278+ getThere = \case
279+ This _ -> Nothing
280+ These _ b -> Just b
281+ That b -> Just b
282+
283+--TODO: Figure out how to implement this in terms of PatchDMapWithMove rather than duplicating it here
284+-- |Compose patches having the same effect as applying the patches in turn: @'applyAlways' (p <> q) == 'applyAlways' p . 'applyAlways' q@
285+instance Ord k => Monoid (PatchMapWithMove k v) where
286+ mempty = PatchMapWithMove mempty
287+ mappend = (<>)
src/Data/Patch/MapWithPatchingMove.hs+66−139
@@ -13,45 +13,12 @@
13
13
14-- | 'Patch'es on 'Map' that can insert, delete, and move values from one key to
14-- | 'Patch'es on 'Map' that can insert, delete, and move values from one key to
15-- another
15-- another
16−module Data.Patch.MapWithPatchingMove
16+module Data.Patch.MapWithPatchingMove where
17− ( PatchMapWithPatchingMove (..)
18− , patchMapWithPatchingMove
19− , patchMapWithPatchingMoveInsertAll
20− , insertMapKey
21− , moveMapKey
22− , swapMapKey
23− , deleteMapKey
24− , unsafePatchMapWithPatchingMove
25− , patchMapWithPatchingMoveNewElements
26− , patchMapWithPatchingMoveNewElementsMap
27− , patchThatSortsMapWith
28− , patchThatChangesAndSortsMapWith
29− , patchThatChangesMap
30−
31− -- * Node Info
32− , NodeInfo (..)
33− , bitraverseNodeInfo
34− , nodeInfoMapFrom
35− , nodeInfoMapMFrom
36− , nodeInfoSetTo
37−
38− -- * From
39− , From(..)
40− , bitraverseFrom
41−
42− -- * To
43− , To
44−
45− -- TODO internals module
46− , Fixup (..)
47− ) where
48
17
49import Data.Patch.Class
18import Data.Patch.Class
50
19
51import Control.Lens hiding (from, to)
20import Control.Lens hiding (from, to)
52import Control.Lens.TH (makeWrapped)
21import Control.Lens.TH (makeWrapped)
53−import Data.Align (align)
54−import Data.Foldable (toList)
55import Data.Function
22import Data.Function
56import Data.List
23import Data.List
57import Data.Map (Map)
24import Data.Map (Map)
@@ -61,8 +28,8 @@ import Data.Maybe
61import Data.Semigroup (Semigroup (..))
28import Data.Semigroup (Semigroup (..))
62#endif
29#endif
63import Data.Monoid.DecidablyEmpty
30import Data.Monoid.DecidablyEmpty
64−import Data.Set (Set)
31+import Data.Patch.MapWithMove (PatchMapWithMove (..))
65−import qualified Data.Set as Set
32+import qualified Data.Patch.MapWithMove as MapWithMove
66import Data.These (These (..))
33import Data.These (These (..))
67
34
68-- | Patch a Map with additions, deletions, and moves. Invariant: If key @k1@
35-- | Patch a Map with additions, deletions, and moves. Invariant: If key @k1@
@@ -86,6 +53,57 @@ deriving instance ( Ord k
86 , Patch p
53 , Patch p
87 ) => DecidablyEmpty (PatchMapWithPatchingMove k p)
54 ) => DecidablyEmpty (PatchMapWithPatchingMove k p)
88
55
56+-- | Holds the information about each key: where its new value should come from,
57+-- and where its old value should go to
58+data NodeInfo k p = NodeInfo
59+ { _nodeInfo_from :: !(From k p)
60+ -- ^ Where do we get the new value for this key?
61+ , _nodeInfo_to :: !(To k)
62+ -- ^ If the old value is being kept (i.e. moved rather than deleted or
63+ -- replaced), where is it going?
64+ }
65+deriving instance (Show k, Show p, Show (PatchTarget p)) => Show (NodeInfo k p)
66+deriving instance (Read k, Read p, Read (PatchTarget p)) => Read (NodeInfo k p)
67+deriving instance (Eq k, Eq p, Eq (PatchTarget p)) => Eq (NodeInfo k p)
68+deriving instance (Ord k, Ord p, Ord (PatchTarget p)) => Ord (NodeInfo k p)
69+
70+bitraverseNodeInfo
71+ :: Applicative f
72+ => (k0 -> f k1)
73+ -> (p0 -> f p1)
74+ -> (PatchTarget p0 -> f (PatchTarget p1))
75+ -> NodeInfo k0 p0 -> f (NodeInfo k1 p1)
76+bitraverseNodeInfo fk fp fpt (NodeInfo from to) = NodeInfo
77+ <$> bitraverseFrom fk fp fpt from
78+ <*> traverse fk to
79+
80+-- | Describe how a key's new value should be produced
81+data From k p
82+ = From_Insert (PatchTarget p) -- ^ Insert the given value here
83+ | From_Delete -- ^ Delete the existing value, if any, from here
84+ | From_Move !k !p -- ^ Move the value here from the given key, and apply the given patch
85+
86+bitraverseFrom
87+ :: Applicative f
88+ => (k0 -> f k1)
89+ -> (p0 -> f p1)
90+ -> (PatchTarget p0 -> f (PatchTarget p1))
91+ -> From k0 p0 -> f (From k1 p1)
92+bitraverseFrom fk fp fpt = \case
93+ From_Insert pt -> From_Insert <$> fpt pt
94+ From_Delete -> pure From_Delete
95+ From_Move k p -> From_Move <$> fk k <*> fp p
96+
97+deriving instance (Show k, Show p, Show (PatchTarget p)) => Show (From k p)
98+deriving instance (Read k, Read p, Read (PatchTarget p)) => Read (From k p)
99+deriving instance (Eq k, Eq p, Eq (PatchTarget p)) => Eq (From k p)
100+deriving instance (Ord k, Ord p, Ord (PatchTarget p)) => Ord (From k p)
101+
102+-- | Describe where a key's old value will go. If this is 'Just', that means
103+-- the key's old value will be moved to the given other key; if it is 'Nothing',
104+-- that means it will be deleted.
105+type To = Maybe
106+
89-- | Create a 'PatchMapWithPatchingMove', validating it
107-- | Create a 'PatchMapWithPatchingMove', validating it
90patchMapWithPatchingMove
108patchMapWithPatchingMove
91 :: Ord k => Map k (NodeInfo k p) -> Maybe (PatchMapWithPatchingMove k p)
109 :: Ord k => Map k (NodeInfo k p) -> Maybe (PatchMapWithPatchingMove k p)
@@ -136,8 +154,8 @@ moveMapKey src dst
136-- @
154-- @
137-- let aMay = Map.lookup a map
155-- let aMay = Map.lookup a map
138-- bMay = Map.lookup b map
156-- bMay = Map.lookup b map
139−-- in maybe id (Map.insert a) (bMay <> aMay)
157+-- in maybe id (Map.insert a) (bMay `mplus` aMay)
140−-- . maybe id (Map.insert b) (aMay <> bMay)
158+-- . maybe id (Map.insert b) (aMay `mplus` bMay)
141-- . Map.delete a . Map.delete b $ map
159-- . Map.delete a . Map.delete b $ map
142-- @
160-- @
143swapMapKey
161swapMapKey
@@ -231,68 +249,18 @@ patchThatChangesAndSortsMapWith cmp oldByIndex newByIndexUnsorted = patchThatCha
231-- will produce the second 'Map'.
249-- will produce the second 'Map'.
232-- Note: this will never produce a patch on a value.
250-- Note: this will never produce a patch on a value.
233patchThatChangesMap
251patchThatChangesMap
234− :: forall k p
235− . (Ord k, Ord (PatchTarget p), Monoid p)
252+ :: (Ord k, Ord (PatchTarget p), Monoid p)
236 => Map k (PatchTarget p) -> Map k (PatchTarget p) -> PatchMapWithPatchingMove k p
253 => Map k (PatchTarget p) -> Map k (PatchTarget p) -> PatchMapWithPatchingMove k p
237−patchThatChangesMap oldByIndex newByIndex = patch
254+patchThatChangesMap oldByIndex newByIndex = fromMapWithMove $ MapWithMove.patchThatChangesMap oldByIndex newByIndex
238− where invert :: Map k (PatchTarget p) -> Map (PatchTarget p) (Set k)
255+
239− invert = Map.fromListWith (<>) . fmap (\(k, v) -> (v, Set.singleton k)) . Map.toList
256+fromMapWithMove :: Monoid p => PatchMapWithMove k (PatchTarget p) -> PatchMapWithPatchingMove k p
240− -- In the places where we use unionDistinct, a non-distinct key indicates a bug in this function
257+fromMapWithMove p = PatchMapWithPatchingMove $ unPatchMapWithMove p <&> \n -> NodeInfo
241− unionDistinct :: forall k' v'. Ord k' => Map k' v' -> Map k' v' -> Map k' v'
242− unionDistinct = Map.unionWith (error "patchThatChangesMap: non-distinct keys")
243− unionPairDistinct :: (Map k (From k v), Map k (To k)) -> (Map k (From k v), Map k (To k)) -> (Map k (From k v), Map k (To k))
244− unionPairDistinct (oldFroms, oldTos) (newFroms, newTos) = (unionDistinct oldFroms newFroms, unionDistinct oldTos newTos)
245− -- Generate patch info for a single value
246− -- Keys that are found in both the old and new sets will not be patched
247− -- Keys that are found in only the old set will be moved to a new position if any are available; otherwise they will be deleted
248− -- Keys that are found in only the new set will be populated by moving an old key if any are available; otherwise they will be inserted
249− patchSingleValue :: PatchTarget p -> Set k -> Set k -> (Map k (From k p), Map k (To k))
250− patchSingleValue v oldKeys newKeys = foldl' unionPairDistinct mempty $ align (toList $ oldKeys `Set.difference` newKeys) (toList $ newKeys `Set.difference` oldKeys) <&> \case
251− This oldK -> (mempty, Map.singleton oldK Nothing) -- There's nowhere for this value to go, so we know we are deleting it
252− That newK -> (Map.singleton newK $ From_Insert v, mempty) -- There's nowhere fo this value to come from, so we know we are inserting it
253− These oldK newK -> (Map.singleton newK $ From_Move oldK mempty, Map.singleton oldK $ Just newK)
254− -- Run patchSingleValue on a These. Missing old or new sets are considered empty
255− patchSingleValueThese :: PatchTarget p -> These (Set k) (Set k) -> (Map k (From k p), Map k (To k))
256− patchSingleValueThese v = \case
257− This oldKeys -> patchSingleValue v oldKeys mempty
258− That newKeys -> patchSingleValue v mempty newKeys
259− These oldKeys newKeys -> patchSingleValue v oldKeys newKeys
260− -- Generate froms and tos for all values, then merge them together
261− (froms, tos) = foldl' unionPairDistinct mempty $ Map.mapWithKey patchSingleValueThese $ align (invert oldByIndex) (invert newByIndex)
262− patch = unsafePatchMapWithPatchingMove $ align froms tos <&> \case
263− This from -> NodeInfo from Nothing -- Since we don't have a 'to' record for this key, that must mean it isn't being moved anywhere, so it should be deleted.
264− That to -> NodeInfo From_Delete to -- Since we don't have a 'from' record for this key, it must be getting deleted
265− These from to -> NodeInfo from to
266−
267−--
268−-- NodeInfo
269−--
270−
271−-- | Holds the information about each key: where its new value should come from,
272−-- and where its old value should go to
273−data NodeInfo k p = NodeInfo
274− { _nodeInfo_from :: !(From k p)
258+ { _nodeInfo_from = case MapWithMove._nodeInfo_from n of
275− -- ^ Where do we get the new value for this key?
259+ MapWithMove.From_Insert v -> From_Insert v
260+ MapWithMove.From_Delete -> From_Delete
261+ MapWithMove.From_Move k -> From_Move k mempty
276− , _nodeInfo_to :: !(To k)
262+ , _nodeInfo_to = MapWithMove._nodeInfo_to n
277− -- ^ If the old value is being kept (i.e. moved rather than deleted or
278− -- replaced), where is it going?
279 }
263 }
280−deriving instance (Show k, Show p, Show (PatchTarget p)) => Show (NodeInfo k p)
281−deriving instance (Read k, Read p, Read (PatchTarget p)) => Read (NodeInfo k p)
282−deriving instance (Eq k, Eq p, Eq (PatchTarget p)) => Eq (NodeInfo k p)
283−deriving instance (Ord k, Ord p, Ord (PatchTarget p)) => Ord (NodeInfo k p)
284−
285−-- | Traverse the 'NodeInfo' over the key, patch, and patch target. Because of
286−-- the type families here, this doesn't it any bi- or tri-traversal class.
287−bitraverseNodeInfo
288− :: Applicative f
289− => (k0 -> f k1)
290− -> (p0 -> f p1)
291− -> (PatchTarget p0 -> f (PatchTarget p1))
292− -> NodeInfo k0 p0 -> f (NodeInfo k1 p1)
293−bitraverseNodeInfo fk fp fpt (NodeInfo from to) = NodeInfo
294− <$> bitraverseFrom fk fp fpt from
295− <*> traverse fk to
296
264
297-- | Change the 'From' value of a 'NodeInfo'
265-- | Change the 'From' value of a 'NodeInfo'
298nodeInfoMapFrom
266nodeInfoMapFrom
@@ -310,47 +278,6 @@ nodeInfoSetTo
310 :: To k -> NodeInfo k v -> NodeInfo k v
278 :: To k -> NodeInfo k v -> NodeInfo k v
311nodeInfoSetTo to ni = ni { _nodeInfo_to = to }
279nodeInfoSetTo to ni = ni { _nodeInfo_to = to }
312
280
313−--
314−-- From
315−--
316−
317−-- | Describe how a key's new value should be produced
318−data From k p
319− = From_Insert (PatchTarget p) -- ^ Insert the given value here
320− | From_Delete -- ^ Delete the existing value, if any, from here
321− | From_Move !k !p -- ^ Move the value here from the given key, and apply the given patch
322−
323−deriving instance (Show k, Show p, Show (PatchTarget p)) => Show (From k p)
324−deriving instance (Read k, Read p, Read (PatchTarget p)) => Read (From k p)
325−deriving instance (Eq k, Eq p, Eq (PatchTarget p)) => Eq (From k p)
326−deriving instance (Ord k, Ord p, Ord (PatchTarget p)) => Ord (From k p)
327−
328−-- | Traverse the 'From' over the key, patch, and patch target. Because of
329−-- the type families here, this doesn't it any bi- or tri-traversal class.
330−bitraverseFrom
331− :: Applicative f
332− => (k0 -> f k1)
333− -> (p0 -> f p1)
334− -> (PatchTarget p0 -> f (PatchTarget p1))
335− -> From k0 p0 -> f (From k1 p1)
336−bitraverseFrom fk fp fpt = \case
337− From_Insert pt -> From_Insert <$> fpt pt
338− From_Delete -> pure From_Delete
339− From_Move k p -> From_Move <$> fk k <*> fp p
340−
341−--
342−-- To
343−--
344−
345−-- | Describe where a key's old value will go. If this is 'Just', that means
346−-- the key's old value will be moved to the given other key; if it is 'Nothing',
347−-- that means it will be deleted.
348−type To = Maybe
349−
350−--
351−-- Fixup
352−--
353−
354-- | Helper data structure used for composing patches using the monoid instance.
281-- | Helper data structure used for composing patches using the monoid instance.
355data Fixup k v
282data Fixup k v
356 = Fixup_Delete
283 = Fixup_Delete
src/Data/Semigroup/Additive.hsdeleted−54
@@ -1,54 +0,0 @@
1−{-# LANGUAGE CPP #-}
2−{-# LANGUAGE TypeOperators #-}
3−{-# LANGUAGE TypeFamilies #-}
4−-- |
5−-- Module:
6−-- Data.Semigroup.Additive
7−-- Description:
8−-- This module defines a class for commutative semigroups, until it is moved
9−-- to another library.
10−module Data.Semigroup.Additive
11− ( Additive
12− ) where
13−
14−import Data.Functor.Const (Const (..))
15−import Data.Functor.Identity
16−import Data.Proxy
17−#if !MIN_VERSION_base(4,12,0)
18−-- for :*: and :.: semigroup instances
19−import Data.Orphans ()
20−#endif
21−#if !MIN_VERSION_base(4,11,0)
22−import Data.Semigroup (Semigroup (..))
23−#endif
24−import GHC.Generics
25−
26−-- | An 'Additive' 'Semigroup' is one where (<>) is commutative
27−class Semigroup q => Additive q where
28−
29−-- | Trivial additive semigroup.
30−instance Additive ()
31−
32−-- | Product additive semigroup.
33−-- A Pair of additive semigroups gives rise to a additive semigroup
34−instance (Additive a, Additive b) => Additive (a, b)
35−
36−-- See https://gitlab.haskell.org/ghc/ghc/issues/11135#note_111802 for the reason Compose is not also provided.
37−-- Base does not define Monoid (Compose f g a) so this is the best we can
38−-- really do for functor composition.
39−instance Additive (f (g a)) => Additive ((f :.: g) a)
40−
41−-- | Product of additive semigroups, Functor style.
42−instance (Additive (f a), Additive (g a)) => Additive ((f :*: g) a)
43−
44−-- | Trivial additive semigroup, Functor style
45−instance Additive (Proxy x)
46−
47−-- | Const lifts additive semigroups into a functor.
48−instance Additive a => Additive (Const a x)
49−
50−-- | Identity lifts additive semigroups pointwise (at only one point)
51−instance Additive a => Additive (Identity a)
52−
53−-- | Functions lift additive semigroups pointwise.
54−instance Additive b => Additive (a -> b)