1 | import { curry, map } from 'ramda';
|
---|
2 |
|
---|
3 | // This implementation was highly inspired by the implementations
|
---|
4 | // in ramda-lens library.
|
---|
5 | //
|
---|
6 | // https://github.com/ramda/ramda-lens
|
---|
7 |
|
---|
8 | // isomorphic :: ((a -> b), (b -> a)) -> Isomorphism
|
---|
9 | // Isomorphism = x -> y
|
---|
10 | const isomorphic = (to, from) => {
|
---|
11 | const isomorphism = (x) => to(x);
|
---|
12 | isomorphism.from = from;
|
---|
13 | return isomorphism;
|
---|
14 | };
|
---|
15 |
|
---|
16 | // isomorphisms :: ((a -> b), (b -> a)) -> (a -> b)
|
---|
17 | const isomorphisms = (to, from) =>
|
---|
18 | isomorphic(
|
---|
19 | curry((toFunctorFn, target) => map(from, toFunctorFn(to(target)))),
|
---|
20 | curry((toFunctorFn, target) => map(to, toFunctorFn(from(target))))
|
---|
21 | );
|
---|
22 |
|
---|
23 | // from :: Isomorphism -> a -> b
|
---|
24 | const from = curry((isomorphism, x) => isomorphism.from(x));
|
---|
25 |
|
---|
26 | /**
|
---|
27 | * Defines an isomorphism that will work like a lens. It takes two functions.
|
---|
28 | * The function that converts and the function that recovers.
|
---|
29 | *
|
---|
30 | * @func lensIso
|
---|
31 | * @memberOf RA
|
---|
32 | * @since {@link https://char0n.github.io/ramda-adjunct/1.19.0|1.19.0}
|
---|
33 | * @category Relation
|
---|
34 | * @typedef Lens s a = Functor f => (a -> f a) -> s -> f s
|
---|
35 | * @sig (s -> a) -> (a -> s) -> Lens s a
|
---|
36 | * @param {!function} to The function that converts
|
---|
37 | * @param {!function} from The function that recovers
|
---|
38 | * @return {!function} The isomorphic lens
|
---|
39 | * @see {@link http://ramdajs.com/docs/#lens|R.lens}
|
---|
40 | *
|
---|
41 | * @example
|
---|
42 | *
|
---|
43 | * const lensJSON = RA.lensIso(JSON.parse, JSON.stringify);
|
---|
44 | *
|
---|
45 | * R.over(lensJSON, assoc('b', 2), '{"a":1}'); //=> '{"a":1,"b":2}'
|
---|
46 | * R.over(RA.lensIso.from(lensJSON), R.replace('}', ',"b":2}'), { a: 1 }); // => { a: 1, b: 2 }
|
---|
47 | */
|
---|
48 | const lensIso = curry(isomorphisms);
|
---|
49 | lensIso.from = from;
|
---|
50 |
|
---|
51 | export default lensIso;
|
---|