Copyright | Isaac Jones 2003-2004 Duncan Coutts 2007 |
---|---|
License | BSD3 |
Maintainer | cabal-devel@haskell.org |
Portability | portable |
Safe Haskell | None |
Language | Haskell2010 |
Defines the Flag
type and it's Monoid
instance, see
http://www.haskell.org/pipermail/cabal-devel/2007-December/001509.html
for an explanation.
Split off from Distribution.Simple.Setup to break import cycles.
Synopsis
- data Flag a
- allFlags :: [Flag Bool] -> Flag Bool
- toFlag :: a -> Flag a
- fromFlag :: WithCallStack (Flag a -> a)
- fromFlagOrDefault :: a -> Flag a -> a
- flagToMaybe :: Flag a -> Maybe a
- flagToList :: Flag a -> [a]
- maybeToFlag :: Maybe a -> Flag a
- class BooleanFlag a where
Documentation
All flags are monoids, they come in two flavours:
- list flags eg
--ghc-option=foo --ghc-option=bar
gives us all the values ["foo", "bar"]
- singular value flags, eg:
--enable-foo --disable-foo
gives us Just False
So this Flag type is for the latter singular kind of flag.
Its monoid instance gives us the behaviour where it starts out as
NoFlag
and later flags override earlier ones.
Instances
Functor Flag Source # | |
Applicative Flag Source # | |
Bounded a => Bounded (Flag a) Source # | |
Enum a => Enum (Flag a) Source # | |
Defined in Distribution.Simple.Flag | |
Eq a => Eq (Flag a) Source # | |
Read a => Read (Flag a) Source # | |
Show a => Show (Flag a) Source # | |
Generic (Flag a) Source # | |
Semigroup (Flag a) Source # | |
Monoid (Flag a) Source # | |
Binary a => Binary (Flag a) Source # | |
Structured a => Structured (Flag a) Source # | |
Defined in Distribution.Simple.Flag | |
type Rep (Flag a) Source # | |
Defined in Distribution.Simple.Flag type Rep (Flag a) = D1 ('MetaData "Flag" "Distribution.Simple.Flag" "Cabal-3.2.0.0-inplace" 'False) (C1 ('MetaCons "Flag" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 a)) :+: C1 ('MetaCons "NoFlag" 'PrefixI 'False) (U1 :: Type -> Type)) |
fromFlag :: WithCallStack (Flag a -> a) Source #
fromFlagOrDefault :: a -> Flag a -> a Source #
flagToMaybe :: Flag a -> Maybe a Source #
flagToList :: Flag a -> [a] Source #
maybeToFlag :: Maybe a -> Flag a Source #