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


-- | Like `optparse-generic`, but with `TemplateHaskell` for faster builds
--   
--   Please see the README on GitHub at
--   <a>https://github.com/MercuryTechnologies/optparse-th#readme</a>
@package optparse-th
@version 0.1.0.0


-- | This module is designed to provide a <tt>TemplateHaskell</tt>
--   alternative to <a>Options.Generic</a>.
module Options.TH

-- | This function derives <a>ParseRecord</a> for you without incurring a
--   <a>Generic</a> dependency.
--   
--   The main barrier here to fully supporting the library is that the API
--   for <a>ParseRecord</a> does not expose the function that provides
--   modifiers by default. So we can provide an instance of
--   <a>ParseRecord</a>, but we can't provide a replacement of
--   <a>parseRecordWithModifiers</a>, because that function is defined as a
--   top-level that delegates directly to the generic.
--   
--   <pre>
--   parseRecordWithModifiers
--       :: (Generic a, GenericParseRecord (Rep a))
--       =&gt; Modifiers
--       -&gt; Parser
--   parseRecordWithModifiers modifiers =
--       fmap GHC.Generics.to (genericParseRecord modifiers)
--   </pre>
--   
--   This means that we need to shift the options to the compile-time site,
--   instead of the runtime site.
--   
--   Likewise, we cannot provide an instance of <a>Unwrappable</a>, because
--   it's not a class - it's a type alias for <a>Generic</a> stuff. So we
--   need to create a separate top-level function that does the unwrap.
deriveParseRecord :: Modifiers -> Name -> Q [Dec]