hledger-lib-1.30: A reusable library providing the core functionality of hledger

Safe Haskell | Safe-Inferred
Language | Haskell2010

Hledger.Data.RawOptions

Description

hledger's cmdargs modes parse command-line arguments to an intermediate format, RawOpts (an association list), rather than a fixed ADT like CliOpts. This allows the modes and flags to be reused more easily by hledger commands/scripts in this and other packages.

Synopsis

- data RawOpts
- setopt :: String -> String -> RawOpts -> RawOpts
- setboolopt :: String -> RawOpts -> RawOpts
- unsetboolopt :: String -> RawOpts -> RawOpts
- appendopts :: [(String, String)] -> RawOpts -> RawOpts
- boolopt :: String -> RawOpts -> Bool
- toggleopt :: String -> RawOpts -> Bool
- choiceopt :: (String -> Maybe a) -> RawOpts -> Maybe a
- collectopts :: ((String, String) -> Maybe a) -> RawOpts -> [a]
- stringopt :: String -> RawOpts -> String
- maybestringopt :: String -> RawOpts -> Maybe String
- listofstringopt :: String -> RawOpts -> [String]
- intopt :: String -> RawOpts -> Int
- posintopt :: String -> RawOpts -> Int
- maybeintopt :: String -> RawOpts -> Maybe Int
- maybeposintopt :: String -> RawOpts -> Maybe Int
- maybecharopt :: String -> RawOpts -> Maybe Char
- overRawOpts :: ([(String, String)] -> [(String, String)]) -> RawOpts -> RawOpts

# Documentation

data RawOpts Source #

The result of running cmdargs: an association list of option names to string values.

#### Instances

Instances details

Show RawOpts Source # |
Instance details Defined in Hledger.Data.RawOptions Methods showsPrec :: Int -> RawOpts -> ShowS Source # show :: RawOpts -> String Source # showList :: [RawOpts] -> ShowS Source #
Default RawOpts Source # |
Instance details Defined in Hledger.Data.RawOptions Methods def :: RawOpts #

setopt :: String -> String -> RawOpts -> RawOpts Source #

setboolopt :: String -> RawOpts -> RawOpts Source #

unsetboolopt :: String -> RawOpts -> RawOpts Source #

appendopts :: [(String, String)] -> RawOpts -> RawOpts Source #

boolopt :: String -> RawOpts -> Bool Source #

Is the named flag present ?

toggleopt :: String -> RawOpts -> Bool Source #

Like boolopt, except if the flag is repeated on the command line it toggles the value. An even number of repetitions is equivalent to none.

choiceopt Source #

Arguments

:: (String -> Maybe a) | "parser" that returns `Just` value for valid choice
-> RawOpts | actual options where to look for flag
-> Maybe a | exclusive choice among those returned as `Just` from "parser"

From a list of RawOpts, get the last one (ie the right-most on the command line) for which the given predicate returns a Just value. Useful for exclusive choice flags like --daily|--weekly|--quarterly...

    >>> import Safe (readMay)
    >>> choiceopt Just (RawOpts [("a",""), ("b",""), ("c","")])
    Just "c"
    >>> choiceopt (const Nothing) (RawOpts [("a","")])
    Nothing
    >>> choiceopt readMay (RawOpts [("LT",""),("EQ",""),("Neither","")]) :: Maybe Ordering
    Just EQ

collectopts :: ((String, String) -> Maybe a) -> RawOpts -> [a] Source #

Collects processed and filtered list of options preserving their order

    >>> collectopts (const Nothing) (RawOpts [("x","")])
    []
    >>> collectopts Just (RawOpts [("a",""),("b","")])
    [("a",""),("b","")]

stringopt :: String -> RawOpts -> String Source #

maybestringopt :: String -> RawOpts -> Maybe String Source #

listofstringopt :: String -> RawOpts -> [String] Source #

intopt :: String -> RawOpts -> Int Source #

Reads the named option's Int argument. If not present it will return 0. An argument that is too small or too large will raise an error.

posintopt :: String -> RawOpts -> Int Source #

Reads the named option's natural-number argument. If not present it will return 0. An argument that is negative or too large will raise an error.

maybeintopt :: String -> RawOpts -> Maybe Int Source #

Reads the named option's Int argument, if it is present. An argument that is too small or too large will raise an error.

maybeposintopt :: String -> RawOpts -> Maybe Int Source #

Reads the named option's natural-number argument, if it is present. An argument that is negative or too large will raise an error.

maybecharopt :: String -> RawOpts -> Maybe Char Source #

overRawOpts :: ([(String, String)] -> [(String, String)]) -> RawOpts -> RawOpts Source #