-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Include the value of an environment variable at compile time
--   
--   Embed secrets (e.g. API keys) inside production artifacts at compile
--   time.
@package include-env
@version 0.4.0.0


-- | Include the value of an environment variable in the binary at compile
--   time.
--   
--   <h2>Rationale</h2>
--   
--   Users might want to embed secrets (e.g. API keys, database connection
--   strings) inside production artifacts without checking these into the
--   repository.
--   
--   <h2>Example</h2>
--   
--   <pre>
--   import IncludeEnv.TH (includeEnv)
--   
--   $(<a>includeEnv</a> "SHELL" "shl")
--   shl :: String
--   
--   main :: IO ()
--   main = putStrLn $ unwords ["your current shell :", shl]
--   </pre>
module IncludeEnv.TH

-- | Include the value of an environment variable at compile time.
--   
--   A fresh variable of type <a>String</a> is declared each time this is
--   computation is evaluated.
--   
--   Note : will crash with <a>error</a> if the environment variable is not
--   found.
includeEnv :: String -> String -> Q [Dec]

-- | Like <a>includeEnv</a> but only prints a warning if the environment
--   variable cannot be found.
--   
--   NB : If the lookup fails, the declared value will contain an _empty
--   string_ .
includeEnvLenient :: String -> String -> Q [Dec]

-- | Like <a>includeEnv</a> but produces a 'Maybe String'
--   
--   Use case : The program needs to be compiled against two different
--   environments that may have different sets of environment variables.
--   <a>includeEnvMaybe</a> lets you account for the results of multiple
--   such lookups at runtime.
includeEnvMaybe :: String -> Q Exp