B9.Environment

An Environment contains textual key value pairs, relavant for string template substitution.

The variables are passed to the B9 build either via command line, OS environment variables or configuration file.

Since: 0.5.62

Documentation

data Environment

A map of textual keys to textual values.

Since: 0.5.62

Instances

Eq Environment

Defined in B9.Environment

Methods

(==) :: Environment -> Environment -> Bool

(/=) :: Environment -> Environment -> Bool

Data Environment

Defined in B9.Environment

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Environment -> c Environment

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Environment

toConstr :: Environment -> Constr

dataTypeOf :: Environment -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c Environment)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Environment)

gmapT :: (forall b. Data b => b -> b) -> Environment -> Environment

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Environment -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Environment -> r

gmapQ :: (forall d. Data d => d -> u) -> Environment -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> Environment -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> Environment -> m Environment

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Environment -> m Environment

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Environment -> m Environment

Show Environment

Defined in B9.Environment

Methods

showsPrec :: Int -> Environment -> ShowS

show :: Environment -> String

showList :: [Environment] -> ShowS

Generic Environment

Defined in B9.Environment

Associated Types

type Rep Environment :: Type -> Type

Methods

from :: Environment -> Rep Environment x

to :: Rep Environment x -> Environment

Semigroup Environment

Defined in B9.Environment

Methods

(<>) :: Environment -> Environment -> Environment

sconcat :: NonEmpty Environment -> Environment

stimes :: Integral b => b -> Environment -> Environment

Monoid Environment

Defined in B9.Environment

Methods

mempty :: Environment

mappend :: Environment -> Environment -> Environment

mconcat :: [Environment] -> Environment

NFData Environment

Defined in B9.Environment

Methods

rnf :: Environment -> ()

Monad m => MonadReader Environment (ContentGeneratorT m)

Defined in B9.Artifact.Content

Methods

ask :: ContentGeneratorT m Environment

local :: (Environment -> Environment) -> ContentGeneratorT m a -> ContentGeneratorT m a

reader :: (Environment -> a) -> ContentGeneratorT m a

type Rep Environment

Defined in B9.Environment

type Rep Environment = D1 (MetaData "Environment" "B9.Environment" "b9-0.5.63-7s6MhXL8SGnDZDbvlqlj2V" False) (C1 (MetaCons "MkEnvironment" PrefixI True) (S1 (MetaSel (Just "nextPosition") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Int) :*: S1 (MetaSel (Just "fromEnvironment") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 (HashMap Text Text))))

fromStringPairs :: [(String, String)] -> Environment

Create an Environment from a list of pairs (Strings)

Since: 0.5.62

addStringBinding :: MonadThrow m => (String, String) -> Environment -> m Environment

Insert a value into an Environment.

Since: 0.5.62

insertPositionalArguments :: [Text] -> Environment -> Environment

If environment variables arg_1 .. arg_n are bound and a list of k additional values are passed to this function, store them with keys arg_(n+1) .. arg_(n+k).

Note that the Environment contains an index of the next position.

Since: 0.5.62

type EnvironmentReaderT m a = ReaderT Environment m a

A monad transformer providing a MonadReader instance for Environment

Since: 0.5.62

type MonadEnvironment m = MonadReader Environment m

A constraint on a monad m ensuring (read-only) access to an Environment

Since: 0.5.62

runEnvironmentReaderT :: Environment -> EnvironmentReaderT m a -> m a

Run a ReaderT of Environment.

Since: 0.5.62

askEnvironment :: MonadEnvironment m => m Environment

Get the current Environment

Since: 0.5.62

localEnvironment :: MonadEnvironment m => (Environment -> Environment) -> m a -> m a

Run a computation with a modified Environment

Since: 0.5.62

lookupOrThrow :: (MonadThrow m, MonadEnvironment m) => Text -> m Text

Lookup a key for a value.

throwM a KeyNotFound Exception if no value with the given key exists in the Environment.

@Since 0.5.62

lookupEither :: MonadEnvironment m => Text -> m (Either KeyNotFound Text)

Lookup a key for a value.

Return Either Left KeyNotFound, if no value with the given key exists in the Environment, or Right the value.

@Since 0.5.62

data KeyNotFound

An Exception thrown by lookupOrThrow indicating that a key does not exist.

@Since 0.5.62

Constructors

MkKeyNotFound Text Environment

Instances

Show KeyNotFound

Defined in B9.Environment

Methods

showsPrec :: Int -> KeyNotFound -> ShowS

show :: KeyNotFound -> String

showList :: [KeyNotFound] -> ShowS

Exception KeyNotFound

Defined in B9.Environment

Methods

toException :: KeyNotFound -> SomeException

fromException :: SomeException -> Maybe KeyNotFound

displayException :: KeyNotFound -> String

data DuplicateKey

An Exception thrown by addBinding indicating that a key already exists.

@Since 0.5.62

Constructors

MkDuplicateKey

Fields

• duplicateKey :: Text
• duplicateKeyOldValue :: Text
• duplicateKeyNewValue :: Text

Instances

Show DuplicateKey

Defined in B9.Environment

Methods

showsPrec :: Int -> DuplicateKey -> ShowS

show :: DuplicateKey -> String

showList :: [DuplicateKey] -> ShowS

Exception DuplicateKey

Defined in B9.Environment

Methods

toException :: DuplicateKey -> SomeException

fromException :: SomeException -> Maybe DuplicateKey

displayException :: DuplicateKey -> String