Copyright	Copyright (C) 2004-2008 John Goerzen
License	Either LGPL or BSD3, as specified in the COPYRIGHT file.
Maintainer	John Goerzen <jgoerzen@complete.org>
Stability	provisional
Portability	portable
Safe Haskell	None
Language	Haskell98

Data.ConfigFile.Types

Description

Internal types for Data.ConfigFile. This module is not intended to be used directly by your programs.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Synopsis

Documentation

typeCPOptions = Map OptionSpec String Source

Storage of options.

typeCPData = Map SectionSpec CPOptions Source

The main data storage type (storage of sections).

PLEASE NOTE: This type is exported only for use by other modules under Data.ConfigFile. You should NEVER access the FiniteMap in a ConfigParser directly. This type may change in future releases of MissingH, which could break your programs. Please retrict yourself to the interface in ConfigFile.

dataCPErrorData Source

Possible ConfigParser errors.

Constructors

ParseError String	Parse error
SectionAlreadyExists SectionSpec	Attempt to create an already-existing ection
NoSection SectionSpec	The section does not exist
NoOption OptionSpec	The option does not exist
OtherProblem String	Miscellaneous error
InterpolationError String	Raised by `interpolatingAccess` if a request was made for a non-existant option

Instances

Eq CPErrorDataSource
Ord CPErrorDataSource
Show CPErrorDataSource
Error CPErrorSource

typeCPError = (CPErrorData, String) Source

Indicates an error occurred. The String is an explanation of the location of the error.

dataConfigParser Source

This is the main record that is used by ConfigFile.

Constructors

ConfigParser

Fields

content :: CPData: The data itself
optionxform :: OptionSpec -> OptionSpec: How to transform an option into a standard representation
defaulthandler :: ConfigParser -> SectionSpec -> OptionSpec -> Either CPError String: Function to look up an option, considering a default value if usedefault is True; or ignoring a default value otherwise. The option specification is assumed to be already transformed.
usedefault :: Bool: Whether or not to seek out a default action when no match is found.
accessfunc :: ConfigParser -> SectionSpec -> OptionSpec -> Either CPError String: Function that is used to perform lookups, do optional interpolation, etc. It is assumed that accessfunc will internally call defaulthandler to do the underlying lookup. The option value is not assumed to be transformed.

typeSectionSpec = String Source

Names of sections

typeOptionSpec = String Source

Names of options

typeParseOutput = [(String, [(String, String)])] Source

Internal output from parser