Data.Vinyl.FromTuple

Concise vinyl record construction from tuples up to size 8. An example record construction using ElField for named fields: fieldRec (y =: b) :: FieldRec '[ '("x", Bool), '("y", Char) ]

Documentation

type family TupleToRecArgs f t = (r :: (u -> *, [u])) | r -> t where ...

Convert a tuple of types formed by the application of a common type constructor to a tuple of the common type constructor and a list of the types to which it is applied in the original tuple. E.g. TupleToRecArgs f (f a, f b) ~ (f, [a,b]).

Equations

TupleToRecArgs f (f a, f b, f c, f d, f e, f z, f g, f h) = '(f, [a, b, c, d, e, z, g, h])

TupleToRecArgs f (f a, f b, f c, f d, f e, f z, f g) = '(f, [a, b, c, d, e, z, g])

TupleToRecArgs f (f a, f b, f c, f d, f e, f z) = '(f, [a, b, c, d, e, z])

TupleToRecArgs f (f a, f b, f c, f d, f e) = '(f, [a, b, c, d, e])

TupleToRecArgs f (f a, f b, f c, f d) = '(f, [a, b, c, d])

TupleToRecArgs f (f a, f b, f c) = '(f, [a, b, c])

TupleToRecArgs f (f a, f b) = '(f, [a, b])

TupleToRecArgs f () = '(f, '[])

type family UncurriedRec (t :: (u -> *, [u])) = r | r -> t where ...

Apply the Rec type constructor to a type-level tuple of its arguments.

Equations

UncurriedRec '(f, ts) = Rec f ts

type family UncurriedXRec (t :: (u -> *, [u])) = r | r -> t where ...

Apply the XRec type constructor to a type-level tuple of its arguments.

Equations

UncurriedXRec '(f, ts) = XRec f ts

class TupleXRec f t where

Convert between an XRec and an isomorphic tuple.

Methods

xrecTuple :: XRec f t -> ListToHKDTuple f t

Convert an XRec to a tuple. Useful for pattern matching on an entire record.

xrecX :: ListToHKDTuple f t -> XRec f t

Build an XRec from a tuple.

Instances

TupleXRec (f :: u -> Type) (a ': (b ': (c ': (d ': (e ': (z ': (g ': (h ': ([] :: [u])))))))) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': (c ': (d ': (e ': (z ': (g ': (h ': [])))))))) -> ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': (z ': (g ': (h ': []))))))))

xrecX :: ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': (z ': (g ': (h ': [])))))))) -> XRec f (a ': (b ': (c ': (d ': (e ': (z ': (g ': (h ': []))))))))

TupleXRec (f :: u -> Type) (a ': (b ': (c ': (d ': (e ': (z ': (g ': ([] :: [u]))))))) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': (c ': (d ': (e ': (z ': (g ': []))))))) -> ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': (z ': (g ': [])))))))

xrecX :: ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': (z ': (g ': []))))))) -> XRec f (a ': (b ': (c ': (d ': (e ': (z ': (g ': [])))))))

TupleXRec (f :: u -> Type) (a ': (b ': (c ': (d ': (e ': (z ': ([] :: [u])))))) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': (c ': (d ': (e ': (z ': [])))))) -> ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': (z ': []))))))

xrecX :: ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': (z ': [])))))) -> XRec f (a ': (b ': (c ': (d ': (e ': (z ': []))))))

TupleXRec (f :: u -> Type) (a ': (b ': (c ': (d ': (e ': ([] :: [u]))))) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': (c ': (d ': (e ': []))))) -> ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': [])))))

xrecX :: ListToHKDTuple f (a ': (b ': (c ': (d ': (e ': []))))) -> XRec f (a ': (b ': (c ': (d ': (e ': [])))))

TupleXRec (f :: u -> Type) (a ': (b ': (c ': (d ': ([] :: [u])))) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': (c ': (d ': [])))) -> ListToHKDTuple f (a ': (b ': (c ': (d ': []))))

xrecX :: ListToHKDTuple f (a ': (b ': (c ': (d ': [])))) -> XRec f (a ': (b ': (c ': (d ': []))))

TupleXRec (f :: u -> Type) (a ': (b ': (c ': ([] :: [u]))) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': (c ': []))) -> ListToHKDTuple f (a ': (b ': (c ': [])))

xrecX :: ListToHKDTuple f (a ': (b ': (c ': []))) -> XRec f (a ': (b ': (c ': [])))

TupleXRec (f :: u -> Type) (a ': (b ': ([] :: [u])) :: [u])

Defined in Data.Vinyl.FromTuple

Methods

xrecTuple :: XRec f (a ': (b ': [])) -> ListToHKDTuple f (a ': (b ': []))

xrecX :: ListToHKDTuple f (a ': (b ': [])) -> XRec f (a ': (b ': []))

type family ListToHKDTuple (f :: u -> *) (ts :: [u]) :: * where ...

Equations

ListToHKDTuple f '[] = HKD f ()

ListToHKDTuple f '[a, b] = (HKD f a, HKD f b)

ListToHKDTuple f '[a, b, c] = (HKD f a, HKD f b, HKD f c)

ListToHKDTuple f '[a, b, c, d] = (HKD f a, HKD f b, HKD f c, HKD f d)

ListToHKDTuple f '[a, b, c, d, e] = (HKD f a, HKD f b, HKD f c, HKD f d, HKD f e)

ListToHKDTuple f '[a, b, c, d, e, z] = (HKD f a, HKD f b, HKD f c, HKD f d, HKD f e, HKD f z)

ListToHKDTuple f '[a, b, c, d, e, z, g] = (HKD f a, HKD f b, HKD f c, HKD f d, HKD f e, HKD f z, HKD f g)

ListToHKDTuple f '[a, b, c, d, e, z, g, h] = (HKD f a, HKD f b, HKD f c, HKD f d, HKD f e, HKD f z, HKD f g, HKD f h)

ListToHKDTuple f x = TypeError (Text "Tuples are only supported up to size 8")

ruple :: (IsoXRec f ts, TupleXRec f ts) => Rec f ts -> ListToHKDTuple f ts

Convert a Rec to a tuple going through HKD to reduce syntactic noise. Useful for pattern matching on an entire Rec.

xrec :: (IsoXRec f t, TupleXRec f t) => ListToHKDTuple f t -> Rec f t

Build a Rec from a tuple passing through XRec. This admits the most concise syntax for building a Rec. For example, xrec ("joe", 23) :: Rec Identity '[String, Int].

class TupleRec f t where

Build a Rec from a tuple. An example would be building a value of type Rec f '[a,b] from a tuple of values with type '(f a, f b).

Methods

record :: t -> UncurriedRec (TupleToRecArgs f t)

Instances

TupleRec (f :: u -> Type) ()

Defined in Data.Vinyl.FromTuple

Methods

record :: () -> UncurriedRec (TupleToRecArgs f ())

TupleRec (f :: u -> Type) (f a, f b)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b) -> UncurriedRec (TupleToRecArgs f (f a, f b))

TupleRec (f :: u -> Type) (f a, f b, f c)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b, f c) -> UncurriedRec (TupleToRecArgs f (f a, f b, f c))

TupleRec (f :: u -> Type) (f a, f b, f c, f d)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b, f c, f d) -> UncurriedRec (TupleToRecArgs f (f a, f b, f c, f d))

TupleRec (f :: u -> Type) (f a, f b, f c, f d, f e)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b, f c, f d, f e) -> UncurriedRec (TupleToRecArgs f (f a, f b, f c, f d, f e))

TupleRec (f :: u -> Type) (f a, f b, f c, f d, f e, f z)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b, f c, f d, f e, f z) -> UncurriedRec (TupleToRecArgs f (f a, f b, f c, f d, f e, f z))

TupleRec (f :: u -> Type) (f a, f b, f c, f d, f e, f z, f g)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b, f c, f d, f e, f z, f g) -> UncurriedRec (TupleToRecArgs f (f a, f b, f c, f d, f e, f z, f g))

TupleRec (f :: u -> Type) (f a, f b, f c, f d, f e, f z, f g, f h)

Defined in Data.Vinyl.FromTuple

Methods

record :: (f a, f b, f c, f d, f e, f z, f g, f h) -> UncurriedRec (TupleToRecArgs f (f a, f b, f c, f d, f e, f z, f g, f h))

fieldRec :: TupleRec ElField t => t -> UncurriedRec (TupleToRecArgs ElField t)

Build a FieldRec from a tuple of ElField values.

namedArgs :: (TupleRec ElField t, ss ~ Snd (TupleToRecArgs ElField t), RecSubset Rec rs (Snd (TupleToRecArgs ElField t)) (RImage rs ss), UncurriedRec (TupleToRecArgs ElField t) ~ Rec ElField ss, RecSubsetFCtx Rec ElField) => t -> Rec ElField rs

Build a FieldRec from a tuple and rcast it to another record type that is a subset of the constructed record. This is useful for re-ordering fields. For example, namedArgs (age =: 23) can supply arguments for a function expecting a record of arguments with its fields in the opposite order.

withDefaults :: (RMap rs, RApply rs, ss ⊆ rs, RMap ss, RecApplicative rs) => Rec f rs -> Rec f ss -> Rec f rs

Override a record with fields from a possibly narrower record. A typical use is to supply default values as the first argument, and overrides for those defaults as the second.