propellor-4.9.0: property-based host configuration management in haskell

Safe HaskellNone
LanguageHaskell98

Propellor.PrivData

Synopsis

Documentation

withPrivData :: (IsContext c, IsPrivDataSource s, IncludesInfo metatypes ~ True) => s -> c -> (((PrivData -> Propellor Result) -> Propellor Result) -> Property metatypes) -> Property metatypes Source #

Allows a Property to access the value of a specific PrivDataField, for use in a specific Context or HostContext.

Example use:

withPrivData (PrivFile pemfile) (Context "joeyh.name") $ \getdata ->
    property "joeyh.name ssl cert" $ getdata $ \privdata ->
      liftIO $ writeFile pemfile (privDataVal privdata)
  where pemfile = "/etc/ssl/certs/web.pem"

Note that if the value is not available, the action is not run and instead it prints a message to help the user make the necessary private data available.

The resulting Property includes Info about the PrivDataField being used, which is necessary to ensure that the privdata is sent to the remote host by propellor.

withSomePrivData :: (IsContext c, IsPrivDataSource s, IncludesInfo metatypes ~ True) => [s] -> c -> ((((PrivDataField, PrivData) -> Propellor Result) -> Propellor Result) -> Property metatypes) -> Property metatypes Source #

filterPrivData :: Host -> PrivMap -> PrivMap Source #

Get only the set of PrivData that the Host's Info says it uses.

readPrivDataFile :: FilePath -> IO PrivMap Source #

type PrivMap = Map (PrivDataField, Context) String Source #

data PrivInfo Source #

Instances

Eq PrivInfo Source # 

Methods

(==) :: PrivInfo -> PrivInfo -> Bool

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

Ord PrivInfo Source # 

Methods

compare :: PrivInfo -> PrivInfo -> Ordering

(<) :: PrivInfo -> PrivInfo -> Bool

(<=) :: PrivInfo -> PrivInfo -> Bool

(>) :: PrivInfo -> PrivInfo -> Bool

(>=) :: PrivInfo -> PrivInfo -> Bool

max :: PrivInfo -> PrivInfo -> PrivInfo

min :: PrivInfo -> PrivInfo -> PrivInfo

Show PrivInfo Source # 

Methods

showsPrec :: Int -> PrivInfo -> ShowS

show :: PrivInfo -> String

showList :: [PrivInfo] -> ShowS

Monoid PrivInfo Source # 
IsInfo PrivInfo Source # 

forceHostContext :: String -> PrivInfo -> PrivInfo Source #

Sets the context of any privdata that uses HostContext to the provided name.