{-# LANGUAGE PatternGuards #-} module GF.Command.Commands ( allCommands, lookCommand, exec, isOpt, options, flags, needsTypeCheck, CommandInfo, CommandOutput ) where import PGF import PGF.CId import PGF.Linearize import PGF.VisualizeTree import PGF.Macros import PGF.Data ---- import PGF.Morphology import PGF.Printer import PGF.Probabilistic -- (getProbsFromFile,prProbabilities,defaultProbabilities) import PGF.Generate (generateRandomFrom) ---- import GF.Compile.Export import GF.Compile.ExampleBased import GF.Infra.Option (noOptions, readOutputFormat) import GF.Infra.UseIO import GF.Data.ErrM ---- import GF.Command.Abstract import GF.Command.Messages import GF.Text.Lexing import GF.Text.Transliterations import GF.Quiz import GF.Command.TreeOperations ---- temporary place for typecheck and compute import GF.Data.Operations import Data.List import Data.Maybe import qualified Data.Map as Map import System.Cmd import Text.PrettyPrint import Data.List (sort) import Debug.Trace import System.Random (newStdGen) ---- type CommandOutput = ([Expr],String) ---- errors, etc data CommandInfo = CommandInfo { exec :: [Option] -> [Expr] -> IO CommandOutput, synopsis :: String, syntax :: String, explanation :: String, longname :: String, options :: [(String,String)], flags :: [(String,String)], examples :: [String], needsTypeCheck :: Bool } emptyCommandInfo :: CommandInfo emptyCommandInfo = CommandInfo { exec = \_ ts -> return (ts,[]), ---- synopsis = "", syntax = "", explanation = "", longname = "", options = [], flags = [], examples = [], needsTypeCheck = True } lookCommand :: String -> Map.Map String CommandInfo -> Maybe CommandInfo lookCommand = Map.lookup commandHelpAll :: PGFEnv -> [Option] -> String commandHelpAll pgf opts = unlines [commandHelp (isOpt "full" opts) (co,info) | (co,info) <- Map.assocs (allCommands pgf)] commandHelp :: Bool -> (String,CommandInfo) -> String commandHelp full (co,info) = unlines $ [ co ++ ", " ++ longname info, synopsis info] ++ if full then [ "", "syntax:" ++++ " " ++ syntax info, "", explanation info, "options:" ++++ unlines [" -" ++ o ++ "\t" ++ e | (o,e) <- options info], "flags:" ++++ unlines [" -" ++ o ++ "\t" ++ e | (o,e) <- flags info], "examples:" ++++ unlines [" " ++ s | s <- examples info] ] else [] -- for printing with txt2tags formatting commandHelpTags :: Bool -> (String,CommandInfo) -> String commandHelpTags full (co,info) = unlines $ [ "#VSPACE","","#NOINDENT", lit co ++ " = " ++ lit (longname info) ++ ": " ++ "//" ++ synopsis info ++ ".//"] ++ if full then [ "","#TINY","", explanation info, "- Syntax: ``" ++ syntax info ++ "``", "- Options:\n" ++++ unlines [" | ``-" ++ o ++ "`` | " ++ e | (o,e) <- options info], "- Flags:\n" ++++ unlines [" | ``-" ++ o ++ "`` | " ++ e | (o,e) <- flags info], "- Examples:\n```" ++++ unlines [" " ++ s | s <- examples info], "```", "", "#NORMAL", "" ] else [] where lit s = "``" ++ s ++ "``" type PGFEnv = (PGF, Map.Map Language Morpho) -- this list must no more be kept sorted by the command name allCommands :: PGFEnv -> Map.Map String CommandInfo allCommands env@(pgf, mos) = Map.fromList [ ("!", emptyCommandInfo { synopsis = "system command: escape to system shell", syntax = "! SYSTEMCOMMAND", examples = [ "! ls *.gf -- list all GF files in the working directory" ], needsTypeCheck = False }), ("?", emptyCommandInfo { synopsis = "system pipe: send value from previous command to a system command", syntax = "? SYSTEMCOMMAND", examples = [ "gt | l | ? wc -- generate, linearize, word-count" ], needsTypeCheck = False }), ("aw", emptyCommandInfo { longname = "align_words", synopsis = "show word alignments between languages graphically", explanation = unlines [ "Prints a set of strings in the .dot format (the graphviz format).", "The graph can be saved in a file by the wf command as usual.", "If the -view flag is defined, the graph is saved in a temporary file", "which is processed by graphviz and displayed by the program indicated", "by the flag. The target format is postscript, unless overridden by the", "flag -format." ], exec = \opts es -> do let grph = if null es then [] else graphvizAlignment pgf (head es) if isFlag "view" opts || isFlag "format" opts then do let file s = "_grph." ++ s let view = optViewGraph opts ++ " " let format = optViewFormat opts writeFile (file "dot") grph system $ "dot -T" ++ format ++ " " ++ file "dot" ++ " > " ++ file format ++ " ; " ++ view ++ file format return void else return $ fromString grph, examples = [ "gr | aw -- generate a tree and show word alignment as graph script", "gr | vt -view=\"open\" -- generate a tree and display alignment on a Mac" ], options = [ ], flags = [ ("format","format of the visualization file (default \"png\")"), ("view","program to open the resulting file (default \"open\")") ] }), ("cc", emptyCommandInfo { longname = "compute_concrete", syntax = "cc (-all | -table | -unqual)? TERM", synopsis = "computes concrete syntax term using a source grammar", explanation = unlines [ "Compute TERM by concrete syntax definitions. Uses the topmost", "module (the last one imported) to resolve constant names.", "N.B.1 You need the flag -retain when importing the grammar, if you want", "the definitions to be retained after compilation.", "N.B.2 The resulting term is not a tree in the sense of abstract syntax", "and hence not a valid input to a Tree-expecting command.", "This command must be a line of its own, and thus cannot be a part", "of a pipe." ], options = [ ("all","pick all strings (forms and variants) from records and tables"), ("table","show all strings labelled by parameters"), ("unqual","hide qualifying module names") ], needsTypeCheck = False }), ("dc", emptyCommandInfo { longname = "define_command", syntax = "dc IDENT COMMANDLINE", synopsis = "define a command macro", explanation = unlines [ "Defines IDENT as macro for COMMANDLINE, until IDENT gets redefined.", "A call of the command has the form %IDENT. The command may take an", "argument, which in COMMANDLINE is marked as ?0. Both strings and", "trees can be arguments. Currently at most one argument is possible.", "This command must be a line of its own, and thus cannot be a part", "of a pipe." ], needsTypeCheck = False }), ("dg", emptyCommandInfo { longname = "dependency_graph", syntax = "dg (-only=MODULES)?", synopsis = "print module dependency graph", explanation = unlines [ "Prints the dependency graph of source modules.", "Requires that import has been done with the -retain flag.", "The graph is written in the file _gfdepgraph.dot", "which can be further processed by Graphviz (the system command 'dot').", "By default, all modules are shown, but the -only flag restricts them", "by a comma-separated list of patterns, where 'name*' matches modules", "whose name has prefix 'name', and other patterns match modules with", "exactly the same name. The graphical conventions are:", " solid box = abstract, solid ellipse = concrete, dashed ellipse = other", " solid arrow empty head = of, solid arrow = **, dashed arrow = open", " dotted arrow = other dependency" ], flags = [ ("only","list of modules included (default: all), literally or by prefix*") ], examples = [ "dg -only=SyntaxEng,Food* -- shows only SyntaxEng, and those with prefix Food" ], needsTypeCheck = False }), ("dt", emptyCommandInfo { longname = "define_tree", syntax = "dt IDENT (TREE | STRING | \"<\" COMMANDLINE)", synopsis = "define a tree or string macro", explanation = unlines [ "Defines IDENT as macro for TREE or STRING, until IDENT gets redefined.", "The defining value can also come from a command, preceded by \"<\".", "If the command gives many values, the first one is selected.", "A use of the macro has the form %IDENT. Currently this use cannot be", "a subtree of another tree. This command must be a line of its own", "and thus cannot be a part of a pipe." ], examples = [ ("dt ex \"hello world\" -- define ex as string"), ("dt ex UseN man_N -- define ex as string"), ("dt ex < p -cat=NP \"the man in the car\" -- define ex as parse result"), ("l -lang=LangSwe %ex | ps -to_utf8 -- linearize the tree ex") ], needsTypeCheck = False }), ("e", emptyCommandInfo { longname = "empty", synopsis = "empty the environment" }), ("eb", emptyCommandInfo { longname = "example_based", syntax = "eb (-probs=FILE | -lang=LANG)* -file=FILE.gfe", synopsis = "converts .gfe files to .gf files by parsing examples to trees", explanation = unlines [ "Reads FILE.gfe and writes FILE.gf. Each expression of form", "'%ex CAT QUOTEDSTRING' in FILE.gfe is replaced by a syntax tree.", "This tree is the first one returned by the parser; a biased ranking", "can be used to regulate the order. If there are more than one parses", "the rest are shown in comments, with probabilities if the order is biased.", "The probabilities flag and configuration file is similar to the commands", "gr and rt. Notice that the command doesn't change the environment,", "but the resulting .gf file must be imported separately." ], flags = [ ("file","the file to be converted (suffix .gfe must be given)"), ("lang","the language in which to parse"), ("probs","file with probabilities to rank the parses") ], exec = \opts _ -> do let file = optFile opts mprobs <- optProbs opts pgf let conf = configureExBased pgf (optMorpho opts) mprobs (optLang opts) (file',ws) <- parseExamplesInGrammar conf file if null ws then return () else putStrLn ("unknown words: " ++ unwords ws) return (fromString ("wrote " ++ file')), needsTypeCheck = False }), ("gr", emptyCommandInfo { longname = "generate_random", synopsis = "generate random trees in the current abstract syntax", syntax = "gr [-cat=CAT] [-number=INT]", examples = [ "gr -- one tree in the startcat of the current grammar", "gr -cat=NP -number=16 -- 16 trees in the category NP", "gr -lang=LangHin,LangTha -cat=Cl -- Cl, both in LangHin and LangTha", "gr -probs=FILE -- generate with bias", "gr (AdjCN ? (UseN ?)) -- generate trees of form (AdjCN ? (UseN ?))" ], explanation = unlines [ "Generates a list of random trees, by default one tree.", "If a tree argument is given, the command completes the Tree with values to", "all metavariables in the tree. The generation can be biased by probabilities,", "given in a file in the -probs flag." ], flags = [ ("cat","generation category"), ("lang","uses only functions that have linearizations in all these languages"), ("number","number of trees generated"), ("probs", "file with biased probabilities (format 'f 0.4' one by line)") ], exec = \opts xs -> do let pgfr = optRestricted opts gen <- newStdGen mprobs <- optProbs opts pgfr let mt = mexp xs ts <- return $ generateRandomFrom mt mprobs gen pgfr (optType opts) returnFromExprs $ take (optNum opts) ts }), ("gt", emptyCommandInfo { longname = "generate_trees", synopsis = "generates a list of trees, by default exhaustive", explanation = unlines [ "Generates all trees of a given category, with increasing depth.", "By default, the depth is 4, but this can be changed by a flag.", "If a Tree argument is given, the command completes the Tree with values", "to all metavariables in the tree." ], flags = [ ("cat","the generation category"), ("depth","the maximum generation depth"), ("lang","excludes functions that have no linearization in this language"), ("number","the number of trees generated") ], examples = [ "gt -- all trees in the startcat, to depth 4", "gt -cat=NP -number=16 -- 16 trees in the category NP", "gt -cat=NP -depth=2 -- trees in the category NP to depth 2", "gt (AdjCN ? (UseN ?)) -- trees of form (AdjCN ? (UseN ?))" ], exec = \opts xs -> do let pgfr = optRestricted opts let dp = return $ valIntOpts "depth" 4 opts let mt = mexp xs let ts = generateAllDepth mt pgfr (optType opts) dp returnFromExprs $ take (optNumInf opts) ts }), ("h", emptyCommandInfo { longname = "help", syntax = "h (-full)? COMMAND?", synopsis = "get description of a command, or a the full list of commands", explanation = unlines [ "Displays information concerning the COMMAND.", "Without argument, shows the synopsis of all commands." ], options = [ ("changes","give a summary of changes from GF 2.9"), ("coding","give advice on character encoding"), ("full","give full information of the commands"), ("license","show copyright and license information") ], exec = \opts ts -> let msg = case ts of _ | isOpt "changes" opts -> changesMsg _ | isOpt "coding" opts -> codingMsg _ | isOpt "license" opts -> licenseMsg [t] -> let co = getCommandOp (showExpr [] t) in case lookCommand co (allCommands env) of ---- new map ??!! Just info -> commandHelp True (co,info) _ -> "command not found" _ -> commandHelpAll env opts in return (fromString msg), needsTypeCheck = False }), ("i", emptyCommandInfo { longname = "import", synopsis = "import a grammar from source code or compiled .pgf file", explanation = unlines [ "Reads a grammar from File and compiles it into a GF runtime grammar.", "If a grammar with the same concrete name is already in the state", "it is overwritten - but only if compilation succeeds.", "The grammar parser depends on the file name suffix:", " .gf normal GF source", " .gfo compiled GF source", " .pgf precompiled grammar in Portable Grammar Format" ], options = [ -- ["prob", "retain", "gfo", "src", "no-cpu", "cpu", "quiet", "verbose"] ("retain","retain operations (used for cc command)"), ("src", "force compilation from source"), ("v", "be verbose - show intermediate status information") ], needsTypeCheck = False }), ("l", emptyCommandInfo { longname = "linearize", synopsis = "convert an abstract syntax expression to string", explanation = unlines [ "Shows the linearization of a Tree by the grammars in scope.", "The -lang flag can be used to restrict this to fewer languages.", "A sequence of string operations (see command ps) can be given", "as options, and works then like a pipe to the ps command, except", "that it only affect the strings, not e.g. the table labels.", "These can be given separately to each language with the unlexer flag", "whose results are prepended to the other lexer flags. The value of the", "unlexer flag is a space-separated list of comma-separated string operation", "sequences; see example." ], examples = [ "l -langs=LangSwe,LangNor no_Utt -- linearize tree to LangSwe and LangNor", "gr -lang=LangHin -cat=Cl | l -table -to_devanagari -to_utf8 -- hindi table", "l -unlexer=\"LangSwe=to_utf8 LangHin=to_devanagari,to_utf8\" -- different lexers" ], exec = \opts -> return . fromStrings . optLins opts, options = [ ("all","show all forms and variants, one by line (cf. l -list)"), ("bracket","show tree structure with brackets and paths to nodes"), ("groups","all languages, grouped by lang, remove duplicate strings"), ("list","show all forms and variants, comma-separated on one line (cf. l -all)"), ("multi","linearize to all languages (default)"), ("table","show all forms labelled by parameters"), ("treebank","show the tree and tag linearizations with language names") ] ++ stringOpOptions, flags = [ ("lang","the languages of linearization (comma-separated, no spaces)"), ("unlexer","set unlexers separately to each language (space-separated)") ] }), ("ma", emptyCommandInfo { longname = "morpho_analyse", synopsis = "print the morphological analyses of all words in the string", explanation = unlines [ "Prints all the analyses of space-separated words in the input string,", "using the morphological analyser of the actual grammar (see command pg)" ], exec = \opts -> case opts of _ | isOpt "missing" opts -> return . fromString . unwords . morphoMissing (optMorpho opts) . concatMap words . toStrings _ -> return . fromString . unlines . map prMorphoAnalysis . concatMap (morphos opts) . concatMap words . toStrings , flags = [ ("lang","the languages of analysis (comma-separated, no spaces)") ], options = [ ("missing","show the list of unknown words in the input") ] }), ("mq", emptyCommandInfo { longname = "morpho_quiz", synopsis = "start a morphology quiz", syntax = "mq (-cat=CAT)? (-probs=FILE)? TREE?", exec = \opts xs -> do let lang = optLang opts let typ = optType opts mprobs <- optProbs opts pgf let mt = mexp xs morphologyQuiz mt mprobs pgf lang typ return void, flags = [ ("lang","language of the quiz"), ("cat","category of the quiz"), ("number","maximum number of questions"), ("probs","file with biased probabilities for generation") ] }), ("p", emptyCommandInfo { longname = "parse", synopsis = "parse a string to abstract syntax expression", explanation = unlines [ "Shows all trees returned by parsing a string in the grammars in scope.", "The -lang flag can be used to restrict this to fewer languages.", "The default start category can be overridden by the -cat flag.", "See also the ps command for lexing and character encoding.", "", "The -openclass flag is experimental and allows some robustness in ", "the parser. For example if -openclass=\"A,N,V\" is given, the parser", "will accept unknown adjectives, nouns and verbs with the resource grammar." ], exec = \opts ts -> returnFromExprsPar opts ts $ concatMap (par opts) $ toStrings ts, flags = [ ("cat","target category of parsing"), ("lang","the languages of parsing (comma-separated, no spaces)"), ("openclass","list of open-class categories for robust parsing") ] }), ("pg", emptyCommandInfo { ----- longname = "print_grammar", synopsis = "print the actual grammar with the given printer", explanation = unlines [ "Prints the actual grammar, with all involved languages.", "In some printers, this can be restricted to a subset of languages", "with the -lang=X,Y flag (comma-separated, no spaces).", "The -printer=P flag sets the format in which the grammar is printed.", "N.B.1 Since grammars are compiled when imported, this command", "generally shows a grammar that looks rather different from the source.", "N.B.2 This command is slightly obsolete: to produce different formats", "the batch compiler gfc is recommended, and has many more options." ], exec = \opts _ -> prGrammar opts, flags = [ --"cat", ("lang", "select languages for the some options (default all languages)"), ("printer","select the printing format (see gfc --help)") ], options = [ ("cats", "show just the names of abstract syntax categories"), ("fullform", "print the fullform lexicon"), ("missing","show just the names of functions that have no linearization"), ("words", "print the list of words") ] }), ("ph", emptyCommandInfo { longname = "print_history", synopsis = "print command history", explanation = unlines [ "Prints the commands issued during the GF session.", "The result is readable by the eh command.", "The result can be used as a script when starting GF." ], examples = [ "ph | wf -file=foo.gfs -- save the history into a file" ] }), ("ps", emptyCommandInfo { longname = "put_string", syntax = "ps OPT? STRING", synopsis = "return a string, possibly processed with a function", explanation = unlines [ "Returns a string obtained from its argument string by applying", "string processing functions in the order given in the command line", "option list. Thus 'ps -f -g s' returns g (f s). Typical string processors", "are lexers and unlexers, but also character encoding conversions are possible.", "The unlexers preserve the division of their input to lines.", "To see transliteration tables, use command ut." ], examples = [ "l (EAdd 3 4) | ps -code -- linearize code-like output", "ps -lexer=code | p -cat=Exp -- parse code-like input", "gr -cat=QCl | l | ps -bind -- linearization output from LangFin", "ps -to_devanagari \"A-p\" -- show Devanagari in UTF8 terminal", "rf -file=Hin.gf | ps -env=quotes -to_devanagari -- convert translit to UTF8", "rf -file=Ara.gf | ps -from_utf8 -env=quotes -from_arabic -- convert UTF8 to transliteration" ], exec = \opts -> let (os,fs) = optsAndFlags opts in return . fromString . stringOps (envFlag fs) (map prOpt os) . toString, options = stringOpOptions, flags = [ ("env","apply in this environment only") ] }), ("pt", emptyCommandInfo { longname = "put_tree", syntax = "ps OPT? TREE", synopsis = "return a tree, possibly processed with a function", explanation = unlines [ "Returns a tree obtained from its argument tree by applying", "tree processing functions in the order given in the command line", "option list. Thus 'pt -f -g s' returns g (f s). Typical tree processors", "are type checking and semantic computation." ], examples = [ "pt -compute (plus one two) -- compute value" ], exec = \opts -> returnFromExprs . takeOptNum opts . treeOps opts, options = treeOpOptions pgf, flags = [("number","take at most this many trees")] ++ treeOpFlags pgf }), ("q", emptyCommandInfo { longname = "quit", synopsis = "exit GF interpreter" }), ("rf", emptyCommandInfo { longname = "read_file", synopsis = "read string or tree input from a file", explanation = unlines [ "Reads input from file. The filename must be in double quotes.", "The input is interpreted as a string by default, and can hence be", "piped e.g. to the parse command. The option -tree interprets the", "input as a tree, which can be given e.g. to the linearize command.", "The option -lines will result in a list of strings or trees, one by line." ], options = [ ("lines","return the list of lines, instead of the singleton of all contents"), ("tree","convert strings into trees") ], exec = \opts _ -> do let file = valStrOpts "file" "_gftmp" opts let exprs [] = ([],empty) exprs ((n,s):ls) | null s = exprs ls exprs ((n,s):ls) = case readExpr s of Just e -> let (es,err) = exprs ls in case inferExpr pgf e of Right (e,t) -> (e:es,err) Left tcerr -> (es,text "on line" <+> int n <> colon $$ nest 2 (ppTcError tcerr) $$ err) Nothing -> let (es,err) = exprs ls in (es,text "on line" <+> int n <> colon <+> text "parse error" $$ err) returnFromLines ls = case exprs ls of (es, err) | null es -> return ([], render (err $$ text "no trees found")) | otherwise -> return (es, render err) s <- readFile file case opts of _ | isOpt "lines" opts && isOpt "tree" opts -> returnFromLines (zip [1..] (lines s)) _ | isOpt "tree" opts -> returnFromLines [(1,s)] _ | isOpt "lines" opts -> return (fromStrings $ lines s) _ -> return (fromString s), flags = [("file","the input file name")] }), ("rt", emptyCommandInfo { longname = "rank_trees", synopsis = "show trees in an order of decreasing probability", explanation = unlines [ "Order trees from the most to the least probable, using either", "even distribution in each category (default) or biased as specified", "by the file given by flag -probs=FILE, where each line has the form", "'function probability', e.g. 'youPol_Pron 0.01'." ], exec = \opts ts -> do mprobs <- optProbs opts pgf let probs = maybe (defaultProbabilities pgf) id mprobs let tds = rankTreesByProbs probs ts if isOpt "v" opts then putStrLn $ unlines [showExpr [] t ++ "\t--" ++ show d | (t,d) <- tds] else return () returnFromExprs $ map fst tds, flags = [ ("probs","probabilities from this file (format 'f 0.6' per line)") ], options = [ ("v","show all trees with their probability scores") ], examples = [ "p \"you are here\" | rt -probs=probs | pt -number=1 -- most probable result", "se utf8 -- set encoding to utf8 (default)" ] }), ("tq", emptyCommandInfo { longname = "translation_quiz", syntax = "tq -from=LANG -to=LANG (-cat=CAT)? (-probs=FILE)? TREE?", synopsis = "start a translation quiz", exec = \opts xs -> do let from = valCIdOpts "from" (optLang opts) opts let to = valCIdOpts "to" (optLang opts) opts let typ = optType opts let mt = mexp xs mprobs <- optProbs opts pgf translationQuiz mt mprobs pgf from to typ return void, flags = [ ("from","translate from this language"), ("to","translate to this language"), ("cat","translate in this category"), ("number","the maximum number of questions"), ("probs","file with biased probabilities for generation") ], examples = [ ("tq -from=Eng -to=Swe -- any trees in startcat"), ("tq -from=Eng -to=Swe (AdjCN (PositA ?2) (UseN ?)) -- only trees of this form") ] }), ("se", emptyCommandInfo { longname = "set_encoding", synopsis = "set the encoding used in current terminal", syntax = "se ID", examples = [ "se cp1251 -- set encoding to cp1521", "se utf8 -- set encoding to utf8 (default)" ], needsTypeCheck = False }), ("sp", emptyCommandInfo { longname = "system_pipe", synopsis = "send argument to a system command", syntax = "sp -command=\"SYSTEMCOMMAND\", alt. ? SYSTEMCOMMAND", exec = \opts arg -> do let tmpi = "_tmpi" --- let tmpo = "_tmpo" writeFile tmpi $ toString arg let syst = optComm opts ++ " " ++ tmpi system $ syst ++ " <" ++ tmpi ++ " >" ++ tmpo s <- readFile tmpo return $ fromString s, flags = [ ("command","the system command applied to the argument") ], examples = [ "sp -command=\"wc\" \"foo\"", "gt | l | sp -command=\"grep \\\"who\\\"\" | sp -command=\"wc\"" ] }), ("ut", emptyCommandInfo { longname = "unicode_table", synopsis = "show a transliteration table for a unicode character set", exec = \opts _ -> do let t = concatMap prOpt (take 1 opts) let out = maybe "no such transliteration" characterTable $ transliteration t return $ fromString out, options = transliterationPrintNames }), ("vd", emptyCommandInfo { longname = "visualize_dependency", synopsis = "show word dependency tree graphically", explanation = unlines [ "Prints a dependency tree in the .dot format (the graphviz format, default)", "or the MaltParser/CoNLL format (flag -output=malt for training, malt_input)", "for unanalysed input.", "By default, the last argument is the head of every abstract syntax", "function; moreover, the head depends on the head of the function above.", "The graph can be saved in a file by the wf command as usual.", "If the -view flag is defined, the graph is saved in a temporary file", "which is processed by graphviz and displayed by the program indicated", "by the flag. The target format is png, unless overridden by the", "flag -format." ], exec = \opts es -> do let debug = isOpt "v" opts let file = valStrOpts "file" "" opts let outp = valStrOpts "output" "dot" opts mlab <- case file of "" -> return Nothing _ -> readFile file >>= return . Just . getDepLabels . lines let lang = optLang opts let grphs = unlines $ map (graphvizDependencyTree outp debug mlab Nothing pgf lang) es if isFlag "view" opts || isFlag "format" opts then do let file s = "_grphd." ++ s let view = optViewGraph opts ++ " " let format = optViewFormat opts writeFile (file "dot") grphs system $ "dot -T" ++ format ++ " " ++ file "dot" ++ " > " ++ file format ++ " ; " ++ view ++ file format return void else return $ fromString grphs, examples = [ "gr | vd -- generate a tree and show dependency tree in .dot", "gr | vd -view=open -- generate a tree and display dependency tree on a Mac", "gr -number=1000 | vd -file=dep.labels -output=malt -- generate training treebank", "gr -number=100 | vd -file=dep.labels -output=malt_input -- generate test sentences" ], options = [ ("v","show extra information") ], flags = [ ("file","configuration file for labels per fun, format 'fun l1 ... label ... l2'"), ("format","format of the visualization file (default \"png\")"), ("output","output format of graph source (default \"dot\")"), ("view","program to open the resulting file (default \"open\")") ] }), ("vp", emptyCommandInfo { longname = "visualize_parse", synopsis = "show parse tree graphically", explanation = unlines [ "Prints a parse tree the .dot format (the graphviz format).", "The graph can be saved in a file by the wf command as usual.", "If the -view flag is defined, the graph is saved in a temporary file", "which is processed by graphviz and displayed by the program indicated", "by the flag. The target format is png, unless overridden by the", "flag -format." ], exec = \opts es -> do let lang = optLang opts let grph = if null es then [] else graphvizParseTree pgf lang (head es) if isFlag "view" opts || isFlag "format" opts then do let file s = "_grph." ++ s let view = optViewGraph opts ++ " " let format = optViewFormat opts writeFile (file "dot") grph system $ "dot -T" ++ format ++ " " ++ file "dot" ++ " > " ++ file format ++ " ; " ++ view ++ file format return void else return $ fromString grph, examples = [ "p \"John walks\" | vp -- generate a tree and show parse tree as .dot script", "gr | vp -view=\"open\" -- generate a tree and display parse tree on a Mac" ], options = [ ], flags = [ ("format","format of the visualization file (default \"png\")"), ("view","program to open the resulting file (default \"open\")") ] }), ("vt", emptyCommandInfo { longname = "visualize_tree", synopsis = "show a set of trees graphically", explanation = unlines [ "Prints a set of trees in the .dot format (the graphviz format).", "The graph can be saved in a file by the wf command as usual.", "If the -view flag is defined, the graph is saved in a temporary file", "which is processed by graphviz and displayed by the program indicated", "by the flag. The target format is postscript, unless overridden by the", "flag -format.", "With option -mk, use for showing library style function names of form 'mkC'." ], exec = \opts es -> if isOpt "mk" opts then return $ fromString $ unlines $ map (tree2mk pgf) es else do let funs = not (isOpt "nofun" opts) let cats = not (isOpt "nocat" opts) let grph = unlines (map (graphvizAbstractTree pgf (funs,cats)) es) -- True=digraph if isFlag "view" opts || isFlag "format" opts then do let file s = "_grph." ++ s let view = optViewGraph opts ++ " " let format = optViewFormat opts writeFile (file "dot") grph system $ "dot -T" ++ format ++ " " ++ file "dot" ++ " > " ++ file format ++ " ; " ++ view ++ file format return void else return $ fromString grph, examples = [ "p \"hello\" | vt -- parse a string and show trees as graph script", "p \"hello\" | vt -view=\"open\" -- parse a string and display trees on a Mac" ], options = [ ("mk", "show the tree with function names converted to 'mkC' with value cats C"), ("nofun","don't show functions but only categories"), ("nocat","don't show categories but only functions") ], flags = [ ("format","format of the visualization file (default \"png\")"), ("view","program to open the resulting file (default \"open\")") ] }), ("wf", emptyCommandInfo { longname = "write_file", synopsis = "send string or tree to a file", exec = \opts arg -> do let file = valStrOpts "file" "_gftmp" opts if isOpt "append" opts then appendFile file (toString arg) else writeFile file (toString arg) return void, options = [ ("append","append to file, instead of overwriting it") ], flags = [("file","the output filename")] }), ("ai", emptyCommandInfo { longname = "abstract_info", syntax = "ai IDENTIFIER or ai EXPR", synopsis = "Provides an information about a function, an expression or a category from the abstract syntax", explanation = unlines [ "The command has one argument which is either function, expression or", "a category defined in the abstract syntax of the current grammar. ", "If the argument is a function then ?its type is printed out.", "If it is a category then the category definition is printed.", "If a whole expression is given it prints the expression with refined", "metavariables and the type of the expression." ], exec = \opts arg -> do case arg of [EFun id] -> case Map.lookup id (funs (abstract pgf)) of Just fd -> return $ fromString $ render (ppFun id fd) Nothing -> case Map.lookup id (cats (abstract pgf)) of Just hyps -> do return $ fromString $ render (ppCat id hyps $$ if null (functionsToCat pgf id) then empty else space $$ vcat [ppFun fid (ty,0,Just []) | (fid,ty) <- functionsToCat pgf id]) Nothing -> do putStrLn ("unknown category of function identifier "++show id) return void [e] -> case inferExpr pgf e of Left tcErr -> error $ render (ppTcError tcErr) Right (e,ty) -> do putStrLn ("Expression: "++showExpr [] e) putStrLn ("Type: "++showType [] ty) return void _ -> do putStrLn "a single identifier or expression is expected from the command" return void, needsTypeCheck = False }) ] where par opts s = case optOpenTypes opts of [] -> concat [parse pgf lang (optType opts) s | lang <- optLangs opts] open_typs -> concat [parseWithRecovery pgf lang (optType opts) open_typs s | lang <- optLangs opts] void = ([],[]) optLins opts ts = case opts of _ | isOpt "groups" opts -> map (unlines . snd) $ groupResults [[(lang, linear opts lang t) | lang <- optLangs opts] | t <- ts] _ -> map (optLin opts) ts optLin opts t = unlines $ case opts of _ | isOpt "treebank" opts -> (showCId (abstractName pgf) ++ ": " ++ showExpr [] t) : [showCId lang ++ ": " ++ linear opts lang t | lang <- optLangs opts] _ -> [linear opts lang t | lang <- optLangs opts] linear :: [Option] -> CId -> Expr -> String linear opts lang = let unl = unlex opts lang in case opts of _ | isOpt "all" opts -> unlines . concat . intersperse [[]] . map (map (unl . snd)) . tabularLinearizes pgf lang _ | isOpt "list" opts -> commaList . concat . intersperse [[]] . map (map (unl . snd)) . tabularLinearizes pgf lang _ | isOpt "table" opts -> unlines . concat . intersperse [[]] . map (map (\(p,v) -> p+++":"+++unl v)) . tabularLinearizes pgf lang _ | isOpt "bracket" opts -> unlines . markLinearizes pgf lang _ -> unl . linearize pgf lang unlex opts lang = stringOps Nothing (getUnlex opts lang ++ map prOpt opts) ---- getUnlex opts lang = case words (valStrOpts "unlexer" "" opts) of lexs -> case lookup lang [(mkCId la,tail le) | lex <- lexs, let (la,le) = span (/='=') lex, not (null le)] of Just le -> chunks ',' le _ -> [] commaList [] = [] commaList ws = concat $ head ws : map (", " ++) (tail ws) -- Proposed logic of coding in unlexing: -- - If lang has no coding flag, or -to_utf8 is not in opts, just opts are used. -- - If lang has flag coding=utf8, -to_utf8 is ignored. -- - If lang has coding=other, and -to_utf8 is in opts, from_other is applied first. -- THIS DOES NOT WORK UNFORTUNATELY - can't use the grammar flag properly unlexx opts lang = {- trace (unwords optsC) $ -} stringOps Nothing optsC where ---- optsC = case lookConcrFlag pgf (mkCId lang) (mkCId "coding") of Just (LStr "utf8") -> filter (/="to_utf8") $ map prOpt opts Just (LStr other) | isOpt "to_utf8" opts -> let cod = ("from_" ++ other) in cod : filter (/=cod) (map prOpt opts) _ -> map prOpt opts optRestricted opts = restrictPGF (\f -> and [hasLin pgf la f | la <- optLangs opts]) pgf optLangs opts = case valStrOpts "lang" "" opts of "" -> languages pgf lang -> map completeLang (chunks ',' lang) completeLang la = let cla = (mkCId la) in if elem cla (languages pgf) then cla else (mkCId (showCId (abstractName pgf) ++ la)) optLang opts = head $ optLangs opts ++ [wildCId] optOpenTypes opts = case valStrOpts "openclass" "" opts of "" -> [] cats -> mapMaybe readType (chunks ',' cats) optProbs opts pgfr = case valStrOpts "probs" "" opts of "" -> return Nothing file -> do ps <- getProbsFromFile file pgf ---- pgfr! -- putStrLn $ prProbabilities ps return $ Just ps optFile opts = valStrOpts "file" "_gftmp" opts optType opts = let str = valStrOpts "cat" (showCId $ lookStartCat pgf) opts in case readType str of Just ty -> case checkType pgf ty of Left tcErr -> error $ render (ppTcError tcErr) Right ty -> ty Nothing -> error ("Can't parse '"++str++"' as type") optComm opts = valStrOpts "command" "" opts optViewFormat opts = valStrOpts "format" "png" opts optViewGraph opts = valStrOpts "view" "open" opts optNum opts = valIntOpts "number" 1 opts optNumInf opts = valIntOpts "number" 1000000000 opts ---- 10^9 takeOptNum opts = take (optNumInf opts) fromExprs es = (es,unlines (map (showExpr []) es)) fromStrings ss = (map (ELit . LStr) ss, unlines ss) fromString s = ([ELit (LStr s)], s) toStrings = map showAsString toString = unwords . toStrings returnFromExprs es = return $ case es of [] -> ([], "no trees found") _ -> fromExprs es returnFromExprsPar opts ts es = return $ case es of [] -> ([], "no trees found" ++ missingWordMsg (optMorpho opts) (concatMap words (toStrings ts)) ) _ -> fromExprs es prGrammar opts | isOpt "cats" opts = return $ fromString $ unwords $ map showCId $ categories pgf | isOpt "fullform" opts = return $ fromString $ concatMap (morpho "" prFullFormLexicon) $ optLangs opts | isOpt "missing" opts = return $ fromString $ unlines $ [unwords (showCId la:":": map showCId cs) | la <- optLangs opts, let cs = missingLins pgf la] | isOpt "words" opts = return $ fromString $ concatMap (morpho "" prAllWords) $ optLangs opts | otherwise = do fmt <- readOutputFormat (valStrOpts "printer" "pgf_pretty" opts) return $ fromString $ concatMap snd $ exportPGF noOptions fmt pgf morphos opts s = [(s,morpho [] (\mo -> lookupMorpho mo s) la) | la <- optLangs opts] morpho z f la = maybe z f $ Map.lookup la mos optMorpho opts = morpho (error "no morpho") id (head (optLangs opts)) mexp xs = case xs of t:_ -> Just t _ -> Nothing -- ps -f -g s returns g (f s) stringOps menv opts s = foldr (menvop . app) s (reverse opts) where app f = maybe id id (stringOp f) menvop op = maybe op (\ (b,e) -> opInEnv b e op) menv envFlag fs = case valStrOpts "env" "global" fs of "quotes" -> Just ("\"","\"") _ -> Nothing treeOps opts s = foldr app s (reverse opts) where app (OOpt op) | Just (Left f) <- treeOp pgf op = f app (OFlag op (VId x)) | Just (Right f) <- treeOp pgf op = f (mkCId x) app _ = id showAsString t = case t of ELit (LStr s) -> s _ -> "\n" ++ showExpr [] t --- newline needed in other cases than the first stringOpOptions = sort $ [ ("bind","bind tokens separated by Prelude.BIND, i.e. &+"), ("chars","lexer that makes every non-space character a token"), ("from_cp1251","decode from cp1251 (Cyrillic used in Bulgarian resource)"), ("from_utf8","decode from utf8 (default)"), ("lextext","text-like lexer"), ("lexcode","code-like lexer"), ("lexmixed","mixture of text and code (code between $...$)"), ("to_cp1251","encode to cp1251 (Cyrillic used in Bulgarian resource)"), ("to_html","wrap in a html file with linebreaks"), ("to_utf8","encode to utf8 (default)"), ("unlextext","text-like unlexer"), ("unlexcode","code-like unlexer"), ("unlexmixed","mixture of text and code (code between $...$)"), ("unchars","unlexer that puts no spaces between tokens"), ("unwords","unlexer that puts a single space between tokens (default)"), ("words","lexer that assumes tokens separated by spaces (default)") ] ++ concat [ [("from_" ++ p, "from unicode to GF " ++ n ++ " transliteration"), ("to_" ++ p, "from GF " ++ n ++ " transliteration to unicode")] | (p,n) <- transliterationPrintNames] treeOpOptions pgf = [(op,expl) | (op,(expl,Left _)) <- allTreeOps pgf] treeOpFlags pgf = [(op,expl) | (op,(expl,Right _)) <- allTreeOps pgf] translationQuiz :: Maybe Expr -> Maybe Probabilities -> PGF -> Language -> Language -> Type -> IO () translationQuiz mex mprobs pgf ig og typ = do tts <- translationList mex mprobs pgf ig og typ infinity mkQuiz "Welcome to GF Translation Quiz." tts morphologyQuiz :: Maybe Expr -> Maybe Probabilities -> PGF -> Language -> Type -> IO () morphologyQuiz mex mprobs pgf ig typ = do tts <- morphologyList mex mprobs pgf ig typ infinity mkQuiz "Welcome to GF Morphology Quiz." tts -- | the maximal number of precompiled quiz problems infinity :: Int infinity = 256 prFullFormLexicon :: Morpho -> String prFullFormLexicon mo = unlines (map prMorphoAnalysis (fullFormLexicon mo)) prAllWords :: Morpho -> String prAllWords mo = unwords [w | (w,_) <- fullFormLexicon mo] prMorphoAnalysis :: (String,[(Lemma,Analysis)]) -> String prMorphoAnalysis (w,lps) = unlines (w:[showCId l ++ " : " ++ p | (l,p) <- lps])