Darcs.Util.CommandLine

|A parser for commandlines, returns an arg list and expands format strings given in a translation table. Additionally the commandline can end with "%<" specifying that the command expects input on stdin.

Some tests for the parser.

formatTable = [('s',"<insert subject here>"),
               ('a',"<insert author here>")]

testParser :: (Show a, Eq a) => Parser a -> String -> a -> a
testParser p s ok = case parse p "" s of
                    Left e -> error $ "Parser failed with: " ++ (show e)
                    Right res -> if res == ok
                                 then res
                                 else error $ "Parser failed: got "
                                        ++ (show res) ++ ", expected "
                                        ++ (show ok)

testCases = [("a b",(["a","b"], False)),
             ("a b %<",(["a","b"], True)),
             ("a b %< ",(["a","b"], True)),
             ("\"arg0 contains spaces \\\"quotes\\\"\" b",
              (["arg0 contains spaces \"quotes\"","b"],False)),
             ("a %s %<",(["a","<insert subject here>"], True))]

runTests = map (uncurry $ testParser (commandline formatTable)) testCases

Documentation

parseCmd :: FTable -> String -> Either ParseError ([String], Bool)

parse a commandline returning a list of strings (intended to be used as argv) and a bool value which specifies if the command expects input on stdin format specifiers with a mapping in ftable are accepted and replaced by the given strings. E.g. if the ftable is [(s,"Some subject")], then "%s" is replaced by "Some subject"

addUrlencoded :: FTable -> FTable

for every mapping (c,s), add a mapping with uppercase c and the urlencoded string s