/usr/share/doc/libghc-language-python-doc/html/Language-Python-Version2-Parser.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Language.Python.Version2.Parser</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Language-Python-Version2-Parser.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Language-Python-Version2-Parser.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">language-python-0.4.1: Parsing and pretty printing of Python code.</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Copyright</th><td>(c) 2009 Bernie Pope </td></tr><tr><th>License</th><td>BSD-style</td></tr><tr><th>Maintainer</th><td>bjpop@csse.unimelb.edu.au</td></tr><tr><th>Stability</th><td>experimental</td></tr><tr><th>Portability</th><td>ghc</td></tr><tr><th>Safe Haskell</th><td>None</td></tr><tr><th>Language</th><td>Haskell98</td></tr></table><p class="caption">Language.Python.Version2.Parser</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Parsing modules</a></li><li><a href="#g:2">Parsing statements</a></li><li><a href="#g:3">Parsing expressions</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>A parser for Python version 2.x programs. Parsers are provided for 
 modules, statements, and expressions. The parsers produce comment tokens
 in addition to the abstract syntax tree.</p><p>See: </p><ul><li><a href="http://www.python.org/doc/2.6/reference/index.html">http://www.python.org/doc/2.6/reference/index.html</a> for an overview of the language. </li><li><a href="http://www.python.org/doc/2.6/reference/grammar.html">http://www.python.org/doc/2.6/reference/grammar.html</a> for the full grammar.</li><li><a href="http://www.python.org/doc/2.6/reference/toplevel_components.html">http://www.python.org/doc/2.6/reference/toplevel_components.html</a> for a description of 
 the various Python top-levels, which correspond to the parsers provided here.</li></ul></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><a href="#v:parseModule">parseModule</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a> -&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a> -&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-Either.html#t:Either">Either</a> <a href="Language-Python-Common-ParseError.html#t:ParseError">ParseError</a> (<a href="Language-Python-Common-AST.html#t:ModuleSpan">ModuleSpan</a>, [<a href="Language-Python-Common-Token.html#t:Token">Token</a>])</li><li class="src short"><a href="#v:parseStmt">parseStmt</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a> -&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a> -&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-Either.html#t:Either">Either</a> <a href="Language-Python-Common-ParseError.html#t:ParseError">ParseError</a> ([<a href="Language-Python-Common-AST.html#t:StatementSpan">StatementSpan</a>], [<a href="Language-Python-Common-Token.html#t:Token">Token</a>])</li><li class="src short"><a href="#v:parseExpr">parseExpr</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a> -&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a> -&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-Either.html#t:Either">Either</a> <a href="Language-Python-Common-ParseError.html#t:ParseError">ParseError</a> (<a href="Language-Python-Common-AST.html#t:ExprSpan">ExprSpan</a>, [<a href="Language-Python-Common-Token.html#t:Token">Token</a>])</li></ul></div><div id="interface"><h1 id="g:1">Parsing modules</h1><div class="top"><p class="src"><a name="v:parseModule" class="def">parseModule</a> <a href="src/Language-Python-Version2-Parser.html#parseModule" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a></td><td class="doc"><p>The input stream (python module source code). </p></td></tr><tr><td class="src">-&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a></td><td class="doc"><p>The name of the python source (filename or input device). </p></td></tr><tr><td class="src">-&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-Either.html#t:Either">Either</a> <a href="Language-Python-Common-ParseError.html#t:ParseError">ParseError</a> (<a href="Language-Python-Common-AST.html#t:ModuleSpan">ModuleSpan</a>, [<a href="Language-Python-Common-Token.html#t:Token">Token</a>])</td><td class="doc"><p>An error or the abstract syntax tree (AST) of the python module and comment tokens.</p></td></tr></table></div><div class="doc"><p>Parse a whole Python source file. Return comments in addition to the parsed module.</p></div></div><h1 id="g:2">Parsing statements</h1><div class="top"><p class="src"><a name="v:parseStmt" class="def">parseStmt</a> <a href="src/Language-Python-Version2-Parser.html#parseStmt" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a></td><td class="doc"><p>The input stream (python statement source code). </p></td></tr><tr><td class="src">-&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a></td><td class="doc"><p>The name of the python source (filename or input device). </p></td></tr><tr><td class="src">-&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-Either.html#t:Either">Either</a> <a href="Language-Python-Common-ParseError.html#t:ParseError">ParseError</a> ([<a href="Language-Python-Common-AST.html#t:StatementSpan">StatementSpan</a>], [<a href="Language-Python-Common-Token.html#t:Token">Token</a>])</td><td class="doc"><p>An error or maybe the abstract syntax tree (AST) of zero or more python statements, plus comments.</p></td></tr></table></div><div class="doc"><p>Parse one compound statement, or a sequence of simple statements. Generally used for interactive input, such as from the command line of an interpreter. Return comments in addition to the parsed statements.</p></div></div><h1 id="g:3">Parsing expressions</h1><div class="top"><p class="src"><a name="v:parseExpr" class="def">parseExpr</a> <a href="src/Language-Python-Version2-Parser.html#parseExpr" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a></td><td class="doc"><p>The input stream (python statement source code). </p></td></tr><tr><td class="src">-&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-String.html#t:String">String</a></td><td class="doc"><p>The name of the python source (filename or input device). </p></td></tr><tr><td class="src">-&gt; <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.8.2.0/Data-Either.html#t:Either">Either</a> <a href="Language-Python-Common-ParseError.html#t:ParseError">ParseError</a> (<a href="Language-Python-Common-AST.html#t:ExprSpan">ExprSpan</a>, [<a href="Language-Python-Common-Token.html#t:Token">Token</a>])</td><td class="doc"><p>An error or maybe the abstract syntax tree (AST) of the python expression, plus comment tokens.</p></td></tr></table></div><div class="doc"><p>Parse an expression. Generally used as input for the 'eval' primitive. Return comments in addition to the parsed expression.</p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.16.1</p></div></body></html>
libghc-language-python-doc 0.4.1-4 / usr / share / doc / libghc-language-python-doc / html / Language-Python-Version2-Parser.html
