rel8-1.0.0.0: src/Rel8/Table/Name.hs
{-# language FlexibleContexts #-}
{-# language NamedFieldPuns #-}
{-# language ScopedTypeVariables #-}
{-# language TypeApplications #-}
{-# language TypeFamilies #-}
{-# language ViewPatterns #-}
module Rel8.Table.Name
( namesFromLabels
, namesFromLabelsWith
, showExprs
, showLabels
, showNames
)
where
-- base
import Data.Foldable ( fold )
import Data.Functor.Const ( Const( Const ), getConst )
import Data.List.NonEmpty ( NonEmpty, intersperse )
import Prelude
-- opaleye
import qualified Opaleye.Internal.HaskellDB.PrimQuery as Opaleye
-- rel8
import Rel8.Expr ( Expr, Col( E ) )
import Rel8.Expr.Opaleye ( toPrimExpr )
import Rel8.Kind.Labels ( renderLabels )
import Rel8.Schema.HTable ( htabulate, htabulateA, hfield, hspecs )
import Rel8.Schema.Name ( Name( Name ), Col( N ) )
import Rel8.Schema.Spec ( SSpec(..) )
import Rel8.Table ( Table, Columns, Context, fromColumns, toColumns )
-- | Construct a table in the 'Name' context containing the names of all
-- columns. Nested column names will be combined with @/@.
--
-- See also: 'namesFromLabelsWith'.
namesFromLabels :: Table Name a => a
namesFromLabels = namesFromLabelsWith go
where
go = fold . intersperse "/"
-- | Construct a table in the 'Name' context containing the names of all
-- columns. The supplied function can be used to transform column names.
--
-- This function can be used to generically derive the columns for a
-- 'TableSchema'. For example,
--
-- @
-- myTableSchema :: TableSchema (MyTable Name)
-- myTableSchema = TableSchema
-- { columns = namesFromLabelsWith last
-- }
-- @
--
-- will construct a 'TableSchema' where each columns names exactly corresponds
-- to the name of the Haskell field.
namesFromLabelsWith :: Table Name a
=> (NonEmpty String -> String) -> a
namesFromLabelsWith f = fromColumns $ htabulate $ \field ->
case hfield hspecs field of
SSpec {labels} -> N (Name (f (renderLabels labels)))
showExprs :: Table Expr a => a -> [(String, Opaleye.PrimExpr)]
showExprs as = case (namesFromLabels, toColumns as) of
(names, exprs) -> getConst $ htabulateA $ \field ->
case (hfield names field, hfield exprs field) of
(N (Name name), E expr) -> Const [(name, toPrimExpr expr)]
showLabels :: forall a. Table (Context a) a => a -> [NonEmpty String]
showLabels _ = getConst $
htabulateA @(Columns a) $ \field -> case hfield hspecs field of
SSpec {labels} -> Const [renderLabels labels]
showNames :: forall a. Table Name a => a -> [String]
showNames (toColumns -> names) = getConst $
htabulateA @(Columns a) $ \field -> case hfield names field of
N (Name name) -> Const [name]