-- Hoogle documentation, generated by Haddock -- See Hoogle, http://www.haskell.org/hoogle/ -- | Parsing and pretty printing of Python code. -- -- language-python is a Haskell library for lexical analysis, parsing and -- pretty printing Python code. It supports versions 2.x and 3.x of -- Python. @package language-python @version 0.5.2 -- | Conversion to/from escaped characters in strings. Note: currently does -- not support escaped Unicode character names. -- -- See: -- -- module Language.Python.Common.StringEscape -- | Convert escaped sequences of characters into real characters in -- a normal Python string. unescapeString :: String -> String unescapeRawString :: String -> String -- | The set of valid octal digits in Python. octalDigits :: String -- | The set of valid hex digits in Python. hexDigits :: String -- | Convenience class for pretty printing combinators. module Language.Python.Common.Pretty -- | All types which can be transformed into a Doc. class Pretty a pretty :: Pretty a => a -> Doc -- | Transform values into strings. prettyText :: Pretty a => a -> String -- | Print just the prefix of something prettyPrefix :: Pretty a => Int -> a -> Doc -- | Conditionally wrap parentheses around an item. parensIf :: Pretty a => (a -> Bool) -> a -> Doc perhaps :: Pretty a => Maybe a -> Doc -> Doc -- | A list of things separated by commas. commaList :: Pretty a => [a] -> Doc instance Language.Python.Common.Pretty.Pretty GHC.Base.String instance Language.Python.Common.Pretty.Pretty GHC.Types.Int instance Language.Python.Common.Pretty.Pretty GHC.Integer.Type.Integer instance Language.Python.Common.Pretty.Pretty GHC.Types.Double instance Language.Python.Common.Pretty.Pretty GHC.Types.Bool instance Language.Python.Common.Pretty.Pretty a => Language.Python.Common.Pretty.Pretty (GHC.Base.Maybe a) -- | Source location information for the Python lexer and parser. This -- module provides single-point locations and spans, and conversions -- between them. module Language.Python.Common.SrcLocation -- | A location for a syntactic entity from the source code. The location -- is specified by its filename, and starting row and column. data SrcLocation Sloc :: !String -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> SrcLocation [sloc_filename] :: SrcLocation -> !String [sloc_row] :: SrcLocation -> {-# UNPACK #-} !Int [sloc_column] :: SrcLocation -> {-# UNPACK #-} !Int NoLocation :: SrcLocation -- | Source location spanning a contiguous section of a file. data SrcSpan -- | A span which starts and ends on the same line. SpanCoLinear :: !String -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> SrcSpan [span_filename] :: SrcSpan -> !String [span_row] :: SrcSpan -> {-# UNPACK #-} !Int [span_start_column] :: SrcSpan -> {-# UNPACK #-} !Int [span_end_column] :: SrcSpan -> {-# UNPACK #-} !Int -- | A span which starts and ends on different lines. SpanMultiLine :: !String -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> SrcSpan [span_filename] :: SrcSpan -> !String [span_start_row] :: SrcSpan -> {-# UNPACK #-} !Int [span_start_column] :: SrcSpan -> {-# UNPACK #-} !Int [span_end_row] :: SrcSpan -> {-# UNPACK #-} !Int [span_end_column] :: SrcSpan -> {-# UNPACK #-} !Int -- | A span which is actually just one point in the file. SpanPoint :: !String -> {-# UNPACK #-} !Int -> {-# UNPACK #-} !Int -> SrcSpan [span_filename] :: SrcSpan -> !String [span_row] :: SrcSpan -> {-# UNPACK #-} !Int [span_column] :: SrcSpan -> {-# UNPACK #-} !Int -- | No span information. SpanEmpty :: SrcSpan -- | Types which have a span. class Span a where getSpan x = SpanEmpty getSpan :: Span a => a -> SrcSpan -- | Create a new span which encloses two spanned things. spanning :: (Span a, Span b) => a -> b -> SrcSpan -- | Make a span from two locations. Assumption: either the arguments are -- the same, or the left one preceeds the right one. mkSrcSpan :: SrcLocation -> SrcLocation -> SrcSpan -- | Combines two SrcSpan into one that spans at least all the -- characters within both spans. Assumes the "file" part is the same in -- both inputs combineSrcSpans :: SrcSpan -> SrcSpan -> SrcSpan -- | Construct the initial source location for a file. initialSrcLocation :: String -> SrcLocation -- | Make a point span from the start of a span spanStartPoint :: SrcSpan -> SrcSpan -- | Increment the column of a location. incColumn :: Int -> SrcLocation -> SrcLocation -- | Decrement the column of a location, only if they are on the same row. decColumn :: Int -> SrcLocation -> SrcLocation -- | Increment the line number (row) of a location by one. incLine :: Int -> SrcLocation -> SrcLocation -- | Increment the column of a location by one tab stop. incTab :: SrcLocation -> SrcLocation -- | Get the column of the end of a span. endCol :: SrcSpan -> Int -- | Get the row of the end of a span. endRow :: SrcSpan -> Int -- | Get the column of the start of a span. startCol :: SrcSpan -> Int -- | Get the row of the start of a span. startRow :: SrcSpan -> Int instance Data.Data.Data Language.Python.Common.SrcLocation.SrcSpan instance GHC.Show.Show Language.Python.Common.SrcLocation.SrcSpan instance GHC.Classes.Ord Language.Python.Common.SrcLocation.SrcSpan instance GHC.Classes.Eq Language.Python.Common.SrcLocation.SrcSpan instance Data.Data.Data Language.Python.Common.SrcLocation.SrcLocation instance GHC.Show.Show Language.Python.Common.SrcLocation.SrcLocation instance GHC.Classes.Ord Language.Python.Common.SrcLocation.SrcLocation instance GHC.Classes.Eq Language.Python.Common.SrcLocation.SrcLocation instance Language.Python.Common.Pretty.Pretty Language.Python.Common.SrcLocation.SrcLocation instance Language.Python.Common.SrcLocation.Span a => Language.Python.Common.SrcLocation.Span [a] instance Language.Python.Common.SrcLocation.Span a => Language.Python.Common.SrcLocation.Span (GHC.Base.Maybe a) instance (Language.Python.Common.SrcLocation.Span a, Language.Python.Common.SrcLocation.Span b) => Language.Python.Common.SrcLocation.Span (Data.Either.Either a b) instance (Language.Python.Common.SrcLocation.Span a, Language.Python.Common.SrcLocation.Span b) => Language.Python.Common.SrcLocation.Span (a, b) instance Language.Python.Common.SrcLocation.Span Language.Python.Common.SrcLocation.SrcSpan instance Language.Python.Common.Pretty.Pretty Language.Python.Common.SrcLocation.SrcSpan instance Language.Python.Common.SrcLocation.Span Language.Python.Common.SrcLocation.SrcLocation -- | Lexical tokens for the Python lexer. Contains the superset of tokens -- from version 2 and version 3 of Python (they are mostly the same). module Language.Python.Common.Token -- | Lexical tokens. data Token -- | Indentation: increase. IndentToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Indentation: decrease. DedentToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Newline. NewlineToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Line join (backslash at end of line). LineJoinToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Single line comment. CommentToken :: !SrcSpan -> !String -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String -- | Identifier. IdentifierToken :: !SrcSpan -> !String -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String -- | Literal: string. StringToken :: !SrcSpan -> !String -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String -- | Literal: byte string. ByteStringToken :: !SrcSpan -> !String -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String -- | Literal: unicode string, version 2 only. UnicodeStringToken :: !SrcSpan -> !String -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String -- | Literal: integer. IntegerToken :: !SrcSpan -> !String -> !Integer -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String [token_integer] :: Token -> !Integer -- | Literal: long integer. Version 2 only. LongIntegerToken :: !SrcSpan -> !String -> !Integer -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String [token_integer] :: Token -> !Integer -- | Literal: floating point. FloatToken :: !SrcSpan -> !String -> !Double -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String [token_double] :: Token -> !Double -- | Literal: imaginary number. ImaginaryToken :: !SrcSpan -> !String -> !Double -> Token [token_span] :: Token -> !SrcSpan [token_literal] :: Token -> !String [token_double] :: Token -> !Double -- | Keyword: 'def'. DefToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'while'. WhileToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'if'. IfToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'True'. TrueToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'False'. FalseToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'Return'. ReturnToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'try'. TryToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'except'. ExceptToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'raise'. RaiseToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'in'. InToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'is'. IsToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'lambda'. LambdaToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'class'. ClassToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'finally'. FinallyToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'None'. NoneToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'for'. ForToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'from'. FromToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'global'. GlobalToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'with'. WithToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'as'. AsToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'elif'. ElifToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'yield'. YieldToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'assert'. AssertToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'import'. ImportToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'pass'. PassToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'break'. BreakToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'continue'. ContinueToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'del'. DeleteToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'else'. ElseToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'not'. NotToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: boolean conjunction 'and'. AndToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: boolean disjunction 'or'. Version 3.x only: OrToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'nonlocal' (Python 3.x only) Version 2.x only: NonLocalToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'print'. (Python 2.x only) PrintToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Keyword: 'exec'. (Python 2.x only) ExecToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: at sign '@'. AtToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: left round bracket '('. LeftRoundBracketToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: right round bracket ')'. RightRoundBracketToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: left square bracket '['. LeftSquareBracketToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: right square bracket ']'. RightSquareBracketToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: left curly bracket '{'. LeftBraceToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: right curly bracket '}'. RightBraceToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: dot (full stop) '.'. DotToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: comma ','. CommaToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: semicolon ';'. SemiColonToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: colon ':'. ColonToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: ellipses (three dots) '...'. EllipsisToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: right facing arrow '->'. RightArrowToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: assignment '='. AssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: plus assignment '+='. PlusAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: minus assignment '-='. MinusAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: multiply assignment '*=' MultAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: divide assignment '/='. DivAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: modulus assignment '%='. ModAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: power assignment '**='. PowAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: binary-and assignment '&='. BinAndAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: binary-or assignment '|='. BinOrAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: binary-xor assignment '^='. BinXorAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: binary-left-shift assignment '<<='. LeftShiftAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: binary-right-shift assignment '>>='. RightShiftAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: floor-divide assignment '//='. FloorDivAssignToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Delimiter: back quote character '`\'. BackQuoteToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: plus '+'. PlusToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: minus: '-'. MinusToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: multiply '*'. MultToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: divide '/'. DivToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: greater-than '>'. GreaterThanToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: less-than '<'. LessThanToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: equals '=='. EqualityToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: greater-than-or-equals '>='. GreaterThanEqualsToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: less-than-or-equals '<='. LessThanEqualsToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: exponential '**'. ExponentToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: binary-or '|'. BinaryOrToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: binary-xor '^'. XorToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: binary-and '&'. BinaryAndToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: binary-shift-left '<<'. ShiftLeftToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: binary-shift-right '>>'. ShiftRightToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: modulus '%'. ModuloToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: floor-divide '//'. FloorDivToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: tilde '~'. TildeToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: not-equals '!='. NotEqualsToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Operator: not-equals '<>'. Version 2 only. NotEqualsV2Token :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | End of file EOFToken :: !SrcSpan -> Token [token_span] :: Token -> !SrcSpan -- | Produce a string from a token containing detailed information. Mainly -- intended for debugging. debugTokenString :: Token -> String -- | Produce a string from a token which is suitable for printing as Python -- concrete syntax. Invisible tokens yield an empty string. tokenString :: Token -> String -- | Test if a token contains its literal source text. hasLiteral :: Token -> Bool -- | Classification of tokens data TokenClass Comment :: TokenClass Number :: TokenClass Identifier :: TokenClass Punctuation :: TokenClass Bracket :: TokenClass Layout :: TokenClass Keyword :: TokenClass String :: TokenClass Operator :: TokenClass Assignment :: TokenClass classifyToken :: Token -> TokenClass instance GHC.Classes.Ord Language.Python.Common.Token.TokenClass instance GHC.Classes.Eq Language.Python.Common.Token.TokenClass instance GHC.Show.Show Language.Python.Common.Token.TokenClass instance Data.Data.Data Language.Python.Common.Token.Token instance GHC.Show.Show Language.Python.Common.Token.Token instance GHC.Classes.Ord Language.Python.Common.Token.Token instance GHC.Classes.Eq Language.Python.Common.Token.Token instance Language.Python.Common.SrcLocation.Span Language.Python.Common.Token.Token -- | Representation of the Python abstract syntax tree (AST). The -- representation is a superset of versions 2.x and 3.x of Python. In -- many cases they are identical. The documentation in this module -- indicates where they are different. -- -- All the data types have a (polymorphic) parameter which allows the AST -- to be annotated by an arbitrary type (for example source locations). -- Specialised instances of the types are provided for source spans. For -- example Module a is the type of modules, and -- ModuleSpan is the type of modules annoted with source span -- information. -- -- Note: there are cases where the AST is more liberal than the formal -- grammar of the language. Therefore some care must be taken when -- constructing Python programs using the raw AST. module Language.Python.Common.AST -- | Convenient access to annotations in annotated types. class Annotated t -- | Given an annotated type, project out its annotation value. annot :: Annotated t => t annot -> annot -- | A module (Python source file). -- -- newtype Module annot -- | A module is just a sequence of top-level statements. Module :: [Statement annot] -> Module annot type ModuleSpan = Module SrcSpan -- | Identifier. data Ident annot Ident :: !String -> annot -> Ident annot [ident_string] :: Ident annot -> !String [ident_annot] :: Ident annot -> annot type IdentSpan = Ident SrcSpan -- | A compound name constructed with the dot operator. type DottedName annot = [Ident annot] type DottedNameSpan = DottedName SrcSpan -- | Statements. -- -- data Statement annot -- | Import statement. Import :: [ImportItem annot] -> annot -> Statement annot -- | Items to import. [import_items] :: Statement annot -> [ImportItem annot] [stmt_annot] :: Statement annot -> annot -- | From ... import statement. FromImport :: ImportRelative annot -> FromItems annot -> annot -> Statement annot -- | Module to import from. [from_module] :: Statement annot -> ImportRelative annot -- | Items to import. [from_items] :: Statement annot -> FromItems annot [stmt_annot] :: Statement annot -> annot -- | While loop. While :: Expr annot -> Suite annot -> Suite annot -> annot -> Statement annot -- | Loop condition. [while_cond] :: Statement annot -> Expr annot -- | Loop body. [while_body] :: Statement annot -> Suite annot -- | Else clause. [while_else] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | For loop. For :: [Expr annot] -> Expr annot -> Suite annot -> Suite annot -> annot -> Statement annot -- | Loop variables. [for_targets] :: Statement annot -> [Expr annot] -- | Loop generator. [for_generator] :: Statement annot -> Expr annot -- | Loop body [for_body] :: Statement annot -> Suite annot -- | Else clause. [for_else] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | Function definition. Fun :: Ident annot -> [Parameter annot] -> Maybe (Expr annot) -> Suite annot -> annot -> Statement annot -- | Function name. [fun_name] :: Statement annot -> Ident annot -- | Function parameter list. [fun_args] :: Statement annot -> [Parameter annot] -- | Optional result annotation. [fun_result_annotation] :: Statement annot -> Maybe (Expr annot) -- | Function body. [fun_body] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | Class definition. Class :: Ident annot -> [Argument annot] -> Suite annot -> annot -> Statement annot -- | Class name. [class_name] :: Statement annot -> Ident annot -- | Class argument list. In version 2.x this is only ArgExprs. [class_args] :: Statement annot -> [Argument annot] -- | Class body. [class_body] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | Conditional statement (if-elif-else). Conditional :: [(Expr annot, Suite annot)] -> Suite annot -> annot -> Statement annot -- | Sequence of if-elif conditional clauses. [cond_guards] :: Statement annot -> [(Expr annot, Suite annot)] -- | Possibly empty unconditional else clause. [cond_else] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | Assignment statement. Assign :: [Expr annot] -> Expr annot -> annot -> Statement annot -- | Entity to assign to. [assign_to] :: Statement annot -> [Expr annot] -- | Expression to evaluate. [assign_expr] :: Statement annot -> Expr annot [stmt_annot] :: Statement annot -> annot -- | Augmented assignment statement. AugmentedAssign :: Expr annot -> AssignOp annot -> Expr annot -> annot -> Statement annot -- | Entity to assign to. [aug_assign_to] :: Statement annot -> Expr annot -- | Assignment operator (for example '+='). [aug_assign_op] :: Statement annot -> AssignOp annot -- | Expression to evaluate. [aug_assign_expr] :: Statement annot -> Expr annot [stmt_annot] :: Statement annot -> annot -- | Decorated definition of a function or class. Decorated :: [Decorator annot] -> Statement annot -> annot -> Statement annot -- | Decorators. [decorated_decorators] :: Statement annot -> [Decorator annot] -- | Function or class definition to be decorated. [decorated_def] :: Statement annot -> Statement annot [stmt_annot] :: Statement annot -> annot -- | Return statement (may only occur syntactically nested in a function -- definition). Return :: Maybe (Expr annot) -> annot -> Statement annot -- | Optional expression to evaluate and return to caller. [return_expr] :: Statement annot -> Maybe (Expr annot) [stmt_annot] :: Statement annot -> annot -- | Try statement (exception handling). Try :: Suite annot -> [Handler annot] -> Suite annot -> Suite annot -> annot -> Statement annot -- | Try clause. [try_body] :: Statement annot -> Suite annot -- | Exception handlers. [try_excepts] :: Statement annot -> [Handler annot] -- | Possibly empty else clause, executed if and when control flows off the -- end of the try clause. [try_else] :: Statement annot -> Suite annot -- | Possibly empty finally clause. [try_finally] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | Raise statement (exception throwing). Raise :: RaiseExpr annot -> annot -> Statement annot [raise_expr] :: Statement annot -> RaiseExpr annot [stmt_annot] :: Statement annot -> annot -- | With statement (context management). With :: [(Expr annot, Maybe (Expr annot))] -> Suite annot -> annot -> Statement annot -- | Context expression(s) (yields a context manager). [with_context] :: Statement annot -> [(Expr annot, Maybe (Expr annot))] -- | Suite to be managed. [with_body] :: Statement annot -> Suite annot [stmt_annot] :: Statement annot -> annot -- | Pass statement (null operation). Pass :: annot -> Statement annot [stmt_annot] :: Statement annot -> annot -- | Break statement (may only occur syntactically nested in a for or while -- loop, but not nested in a function or class definition within that -- loop). Break :: annot -> Statement annot [stmt_annot] :: Statement annot -> annot -- | Continue statement (may only occur syntactically nested in a for or -- while loop, but not nested in a function or class definition or -- finally clause within that loop). Continue :: annot -> Statement annot [stmt_annot] :: Statement annot -> annot -- | Del statement (delete). Delete :: [Expr annot] -> annot -> Statement annot -- | Items to delete. [del_exprs] :: Statement annot -> [Expr annot] [stmt_annot] :: Statement annot -> annot -- | Expression statement. StmtExpr :: Expr annot -> annot -> Statement annot [stmt_expr] :: Statement annot -> Expr annot [stmt_annot] :: Statement annot -> annot -- | Global declaration. Global :: [Ident annot] -> annot -> Statement annot -- | Variables declared global in the current block. [global_vars] :: Statement annot -> [Ident annot] [stmt_annot] :: Statement annot -> annot -- | Nonlocal declaration. Version 3.x only. NonLocal :: [Ident annot] -> annot -> Statement annot -- | Variables declared nonlocal in the current block (their binding comes -- from bound the nearest enclosing scope). [nonLocal_vars] :: Statement annot -> [Ident annot] [stmt_annot] :: Statement annot -> annot -- | Assertion. Assert :: [Expr annot] -> annot -> Statement annot -- | Expressions being asserted. [assert_exprs] :: Statement annot -> [Expr annot] [stmt_annot] :: Statement annot -> annot -- | Print statement. Version 2 only. Print :: Bool -> [Expr annot] -> Bool -> annot -> Statement annot -- | Optional chevron (>>) [print_chevron] :: Statement annot -> Bool -- | Arguments to print [print_exprs] :: Statement annot -> [Expr annot] -- | Does it end in a comma? [print_trailing_comma] :: Statement annot -> Bool [stmt_annot] :: Statement annot -> annot -- | Exec statement. Version 2 only. Exec :: Expr annot -> Maybe (Expr annot, Maybe (Expr annot)) -> annot -> Statement annot -- | Expression to exec. [exec_expr] :: Statement annot -> Expr annot -- | Global and local environments to evaluate the expression within. [exec_globals_locals] :: Statement annot -> Maybe (Expr annot, Maybe (Expr annot)) [stmt_annot] :: Statement annot -> annot type StatementSpan = Statement SrcSpan -- | A block of statements. A suite is a group of statements controlled by -- a clause, for example, the body of a loop. -- -- type Suite annot = [Statement annot] type SuiteSpan = Suite SrcSpan -- | Formal parameter of function definitions and lambda expressions. -- -- data Parameter annot -- | Ordinary named parameter. Param :: Ident annot -> Maybe (Expr annot) -> Maybe (Expr annot) -> annot -> Parameter annot -- | Parameter name. [param_name] :: Parameter annot -> Ident annot -- | Optional annotation. [param_py_annotation] :: Parameter annot -> Maybe (Expr annot) -- | Optional default value. [param_default] :: Parameter annot -> Maybe (Expr annot) [param_annot] :: Parameter annot -> annot -- | Excess positional parameter (single asterisk before its name in the -- concrete syntax). VarArgsPos :: Ident annot -> Maybe (Expr annot) -> annot -> Parameter annot -- | Parameter name. [param_name] :: Parameter annot -> Ident annot -- | Optional annotation. [param_py_annotation] :: Parameter annot -> Maybe (Expr annot) [param_annot] :: Parameter annot -> annot -- | Excess keyword parameter (double asterisk before its name in the -- concrete syntax). VarArgsKeyword :: Ident annot -> Maybe (Expr annot) -> annot -> Parameter annot -- | Parameter name. [param_name] :: Parameter annot -> Ident annot -- | Optional annotation. [param_py_annotation] :: Parameter annot -> Maybe (Expr annot) [param_annot] :: Parameter annot -> annot -- | Marker for the end of positional parameters (not a parameter itself). EndPositional :: annot -> Parameter annot [param_annot] :: Parameter annot -> annot -- | Tuple unpack. Version 2 only. UnPackTuple :: ParamTuple annot -> Maybe (Expr annot) -> annot -> Parameter annot -- | The tuple to unpack. [param_unpack_tuple] :: Parameter annot -> ParamTuple annot -- | Optional default value. [param_default] :: Parameter annot -> Maybe (Expr annot) [param_annot] :: Parameter annot -> annot type ParameterSpan = Parameter SrcSpan -- | Tuple unpack parameter. Version 2 only. data ParamTuple annot -- | A variable name. ParamTupleName :: Ident annot -> annot -> ParamTuple annot [param_tuple_name] :: ParamTuple annot -> Ident annot [param_tuple_annot] :: ParamTuple annot -> annot -- | A (possibly nested) tuple parameter. ParamTuple :: [ParamTuple annot] -> annot -> ParamTuple annot [param_tuple] :: ParamTuple annot -> [ParamTuple annot] [param_tuple_annot] :: ParamTuple annot -> annot type ParamTupleSpan = ParamTuple SrcSpan -- | Decorator. data Decorator annot Decorator :: DottedName annot -> [Argument annot] -> annot -> Decorator annot -- | Decorator name. [decorator_name] :: Decorator annot -> DottedName annot -- | Decorator arguments. [decorator_args] :: Decorator annot -> [Argument annot] [decorator_annot] :: Decorator annot -> annot type DecoratorSpan = Decorator SrcSpan -- | Augmented assignment operators. data AssignOp annot -- | '+=' PlusAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '-=' MinusAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '*=' MultAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '/=' DivAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '%=' ModAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '*=' PowAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '&=' BinAndAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '|=' BinOrAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '^=' BinXorAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '<<=' LeftShiftAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '>>=' RightShiftAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot -- | '//=' FloorDivAssign :: annot -> AssignOp annot [assignOp_annot] :: AssignOp annot -> annot type AssignOpSpan = AssignOp SrcSpan -- | Expressions. -- -- data Expr annot -- | Variable. Var :: Ident annot -> annot -> Expr annot [var_ident] :: Expr annot -> Ident annot [expr_annot] :: Expr annot -> annot -- | Literal integer. Int :: Integer -> String -> annot -> Expr annot [int_value] :: Expr annot -> Integer [expr_literal] :: Expr annot -> String [expr_annot] :: Expr annot -> annot -- | Long literal integer. Version 2 only. LongInt :: Integer -> String -> annot -> Expr annot [int_value] :: Expr annot -> Integer [expr_literal] :: Expr annot -> String [expr_annot] :: Expr annot -> annot -- | Literal floating point number. Float :: Double -> String -> annot -> Expr annot [float_value] :: Expr annot -> Double [expr_literal] :: Expr annot -> String [expr_annot] :: Expr annot -> annot -- | Literal imaginary number. Imaginary :: Double -> String -> annot -> Expr annot [imaginary_value] :: Expr annot -> Double [expr_literal] :: Expr annot -> String [expr_annot] :: Expr annot -> annot -- | Literal boolean. Bool :: Bool -> annot -> Expr annot [bool_value] :: Expr annot -> Bool [expr_annot] :: Expr annot -> annot -- | Literal 'None' value. None :: annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Ellipsis '...'. Ellipsis :: annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Literal byte string. ByteStrings :: [String] -> annot -> Expr annot [byte_string_strings] :: Expr annot -> [String] [expr_annot] :: Expr annot -> annot -- | Literal strings (to be concatentated together). Strings :: [String] -> annot -> Expr annot [strings_strings] :: Expr annot -> [String] [expr_annot] :: Expr annot -> annot -- | Unicode literal strings (to be concatentated together). Version 2 -- only. UnicodeStrings :: [String] -> annot -> Expr annot [unicodestrings_strings] :: Expr annot -> [String] [expr_annot] :: Expr annot -> annot -- | Function call. Call :: Expr annot -> [Argument annot] -> annot -> Expr annot -- | Expression yielding a callable object (such as a function). [call_fun] :: Expr annot -> Expr annot -- | Call arguments. [call_args] :: Expr annot -> [Argument annot] [expr_annot] :: Expr annot -> annot -- | Subscription, for example 'x [y]'. Subscript :: Expr annot -> Expr annot -> annot -> Expr annot [subscriptee] :: Expr annot -> Expr annot [subscript_expr] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Slicing, for example 'w [x:y:z]'. SlicedExpr :: Expr annot -> [Slice annot] -> annot -> Expr annot [slicee] :: Expr annot -> Expr annot [slices] :: Expr annot -> [Slice annot] [expr_annot] :: Expr annot -> annot -- | Conditional expresison. CondExpr :: Expr annot -> Expr annot -> Expr annot -> annot -> Expr annot -- | Expression to evaluate if condition is True. [ce_true_branch] :: Expr annot -> Expr annot -- | Boolean condition. [ce_condition] :: Expr annot -> Expr annot -- | Expression to evaluate if condition is False. [ce_false_branch] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Binary operator application. BinaryOp :: Op annot -> Expr annot -> Expr annot -> annot -> Expr annot [operator] :: Expr annot -> Op annot [left_op_arg] :: Expr annot -> Expr annot [right_op_arg] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Unary operator application. UnaryOp :: Op annot -> Expr annot -> annot -> Expr annot [operator] :: Expr annot -> Op annot [op_arg] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot Dot :: Expr annot -> Ident annot -> annot -> Expr annot [dot_expr] :: Expr annot -> Expr annot [dot_attribute] :: Expr annot -> Ident annot [expr_annot] :: Expr annot -> annot -- | Anonymous function definition (lambda). Lambda :: [Parameter annot] -> Expr annot -> annot -> Expr annot [lambda_args] :: Expr annot -> [Parameter annot] [lambda_body] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Tuple. Can be empty. Tuple :: [Expr annot] -> annot -> Expr annot [tuple_exprs] :: Expr annot -> [Expr annot] [expr_annot] :: Expr annot -> annot -- | Generator yield. Yield :: Maybe (YieldArg annot) -> annot -> Expr annot -- | Optional Yield argument. [yield_arg] :: Expr annot -> Maybe (YieldArg annot) [expr_annot] :: Expr annot -> annot -- | Generator. Generator :: Comprehension annot -> annot -> Expr annot [gen_comprehension] :: Expr annot -> Comprehension annot [expr_annot] :: Expr annot -> annot -- | List comprehension. ListComp :: Comprehension annot -> annot -> Expr annot [list_comprehension] :: Expr annot -> Comprehension annot [expr_annot] :: Expr annot -> annot -- | List. List :: [Expr annot] -> annot -> Expr annot [list_exprs] :: Expr annot -> [Expr annot] [expr_annot] :: Expr annot -> annot -- | Dictionary. Dictionary :: [DictMappingPair annot] -> annot -> Expr annot [dict_mappings] :: Expr annot -> [DictMappingPair annot] [expr_annot] :: Expr annot -> annot -- | Dictionary comprehension. Version 3 only. DictComp :: Comprehension annot -> annot -> Expr annot [dict_comprehension] :: Expr annot -> Comprehension annot [expr_annot] :: Expr annot -> annot -- | Set. Set :: [Expr annot] -> annot -> Expr annot [set_exprs] :: Expr annot -> [Expr annot] [expr_annot] :: Expr annot -> annot -- | Set comprehension. Version 3 only. SetComp :: Comprehension annot -> annot -> Expr annot [set_comprehension] :: Expr annot -> Comprehension annot [expr_annot] :: Expr annot -> annot -- | Starred expression. Version 3 only. Starred :: Expr annot -> annot -> Expr annot [starred_expr] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | Parenthesised expression. Paren :: Expr annot -> annot -> Expr annot [paren_expr] :: Expr annot -> Expr annot [expr_annot] :: Expr annot -> annot -- | String conversion (backquoted expression). Version 2 only. StringConversion :: Expr annot -> annot -> Expr annot [backquoted_expr] :: Expr annot -> Expr annot [expr_anot] :: Expr annot -> annot type ExprSpan = Expr SrcSpan -- | Operators. data Op annot -- | 'and' And :: annot -> Op annot [op_annot] :: Op annot -> annot -- | 'or' Or :: annot -> Op annot [op_annot] :: Op annot -> annot -- | 'not' Not :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '**' Exponent :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '<' LessThan :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '>' GreaterThan :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '==' Equality :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '>=' GreaterThanEquals :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '<=' LessThanEquals :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '!=' NotEquals :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '<>'. Version 2 only. NotEqualsV2 :: annot -> Op annot [op_annot] :: Op annot -> annot -- | 'in' In :: annot -> Op annot [op_annot] :: Op annot -> annot -- | 'is' Is :: annot -> Op annot [op_annot] :: Op annot -> annot -- | 'is not' IsNot :: annot -> Op annot [op_annot] :: Op annot -> annot -- | 'not in' NotIn :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '|' BinaryOr :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '^' Xor :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '&' BinaryAnd :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '<<' ShiftLeft :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '>>' ShiftRight :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '*' Multiply :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '+' Plus :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '-' Minus :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '/' Divide :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '//' FloorDivide :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '~' (bitwise inversion of its integer argument) Invert :: annot -> Op annot [op_annot] :: Op annot -> annot -- | '%' Modulo :: annot -> Op annot [op_annot] :: Op annot -> annot type OpSpan = Op SrcSpan -- | Arguments to function calls, class declarations and decorators. data Argument annot -- | Ordinary argument expression. ArgExpr :: Expr annot -> annot -> Argument annot -- | Argument expression. [arg_expr] :: Argument annot -> Expr annot [arg_annot] :: Argument annot -> annot -- | Excess positional argument. ArgVarArgsPos :: Expr annot -> annot -> Argument annot -- | Argument expression. [arg_expr] :: Argument annot -> Expr annot [arg_annot] :: Argument annot -> annot -- | Excess keyword argument. ArgVarArgsKeyword :: Expr annot -> annot -> Argument annot -- | Argument expression. [arg_expr] :: Argument annot -> Expr annot [arg_annot] :: Argument annot -> annot -- | Keyword argument. ArgKeyword :: Ident annot -> Expr annot -> annot -> Argument annot -- | Keyword name. [arg_keyword] :: Argument annot -> Ident annot -- | Argument expression. [arg_expr] :: Argument annot -> Expr annot [arg_annot] :: Argument annot -> annot type ArgumentSpan = Argument SrcSpan -- | Slice compenent. data Slice annot SliceProper :: Maybe (Expr annot) -> Maybe (Expr annot) -> Maybe (Maybe (Expr annot)) -> annot -> Slice annot [slice_lower] :: Slice annot -> Maybe (Expr annot) [slice_upper] :: Slice annot -> Maybe (Expr annot) [slice_stride] :: Slice annot -> Maybe (Maybe (Expr annot)) [slice_annot] :: Slice annot -> annot SliceExpr :: Expr annot -> annot -> Slice annot [slice_expr] :: Slice annot -> Expr annot [slice_annot] :: Slice annot -> annot SliceEllipsis :: annot -> Slice annot [slice_annot] :: Slice annot -> annot type SliceSpan = Slice SrcSpan data DictMappingPair annot DictMappingPair :: (Expr annot) -> (Expr annot) -> DictMappingPair annot type DictMappingPairSpan = DictMappingPair SrcSpan data YieldArg annot -- | Yield from a generator (Version 3 only) YieldFrom :: (Expr annot) -> annot -> YieldArg annot -- | Yield value of an expression YieldExpr :: (Expr annot) -> YieldArg annot type YieldArgSpan = YieldArg SrcSpan -- | An entity imported using the 'import' keyword. -- -- data ImportItem annot ImportItem :: DottedName annot -> Maybe (Ident annot) -> annot -> ImportItem annot -- | The name of module to import. [import_item_name] :: ImportItem annot -> DottedName annot -- | An optional name to refer to the entity (the 'as' name). [import_as_name] :: ImportItem annot -> Maybe (Ident annot) [import_item_annot] :: ImportItem annot -> annot type ImportItemSpan = ImportItem SrcSpan -- | An entity imported using the 'from ... import' construct. -- -- data FromItem annot FromItem :: Ident annot -> Maybe (Ident annot) -> annot -> FromItem annot -- | The name of the entity imported. [from_item_name] :: FromItem annot -> Ident annot -- | An optional name to refer to the entity (the 'as' name). [from_as_name] :: FromItem annot -> Maybe (Ident annot) [from_item_annot] :: FromItem annot -> annot type FromItemSpan = FromItem SrcSpan -- | Items imported using the 'from ... import' construct. data FromItems annot -- | Import everything exported from the module. ImportEverything :: annot -> FromItems annot [from_items_annot] :: FromItems annot -> annot -- | Import a specific list of items from the module. FromItems :: [FromItem annot] -> annot -> FromItems annot [from_items_items] :: FromItems annot -> [FromItem annot] [from_items_annot] :: FromItems annot -> annot type FromItemsSpan = FromItems SrcSpan -- | A reference to the module to import from using the 'from ... import' -- construct. data ImportRelative annot ImportRelative :: Int -> Maybe (DottedName annot) -> annot -> ImportRelative annot [import_relative_dots] :: ImportRelative annot -> Int [import_relative_module] :: ImportRelative annot -> Maybe (DottedName annot) [import_relative_annot] :: ImportRelative annot -> annot type ImportRelativeSpan = ImportRelative SrcSpan -- | Exception handler. data Handler annot Handler :: ExceptClause annot -> Suite annot -> annot -> Handler annot [handler_clause] :: Handler annot -> ExceptClause annot [handler_suite] :: Handler annot -> Suite annot [handler_annot] :: Handler annot -> annot type HandlerSpan = Handler SrcSpan -- | Exception clause. data ExceptClause annot ExceptClause :: Maybe (Expr annot, Maybe (Expr annot)) -> annot -> ExceptClause annot [except_clause] :: ExceptClause annot -> Maybe (Expr annot, Maybe (Expr annot)) [except_clause_annot] :: ExceptClause annot -> annot type ExceptClauseSpan = ExceptClause SrcSpan -- | The argument for a raise statement. data RaiseExpr annot -- | Optional expression to evaluate, and optional 'from' clause. -- Version 3 only. RaiseV3 :: (Maybe (Expr annot, Maybe (Expr annot))) -> RaiseExpr annot -- | Version 2 only. RaiseV2 :: (Maybe (Expr annot, Maybe (Expr annot, Maybe (Expr annot)))) -> RaiseExpr annot type RaiseExprSpan = RaiseExpr SrcSpan -- | Comprehension. In version 3.x this can be used for lists, sets, -- dictionaries and generators. data Comprehension e annot data Comprehension annot Comprehension :: ComprehensionExpr annot -> CompFor annot -> annot -> Comprehension annot [comprehension_expr] :: Comprehension annot -> ComprehensionExpr annot [comprehension_for] :: Comprehension annot -> CompFor annot [comprehension_annot] :: Comprehension annot -> annot type ComprehensionSpan = Comprehension SrcSpan data ComprehensionExpr annot ComprehensionExpr :: (Expr annot) -> ComprehensionExpr annot ComprehensionDict :: (DictMappingPair annot) -> ComprehensionExpr annot type ComprehensionExprSpan = ComprehensionExpr SrcSpan -- | Comprehension 'for' component. data CompFor annot CompFor :: [Expr annot] -> Expr annot -> Maybe (CompIter annot) -> annot -> CompFor annot [comp_for_exprs] :: CompFor annot -> [Expr annot] [comp_in_expr] :: CompFor annot -> Expr annot [comp_for_iter] :: CompFor annot -> Maybe (CompIter annot) [comp_for_annot] :: CompFor annot -> annot type CompForSpan = CompFor SrcSpan -- | Comprehension guard. data CompIf annot CompIf :: Expr annot -> Maybe (CompIter annot) -> annot -> CompIf annot [comp_if] :: CompIf annot -> Expr annot [comp_if_iter] :: CompIf annot -> Maybe (CompIter annot) [comp_if_annot] :: CompIf annot -> annot type CompIfSpan = CompIf SrcSpan -- | Comprehension iterator (either a 'for' or an 'if'). data CompIter annot IterFor :: CompFor annot -> annot -> CompIter annot [comp_iter_for] :: CompIter annot -> CompFor annot [comp_iter_annot] :: CompIter annot -> annot IterIf :: CompIf annot -> annot -> CompIter annot [comp_iter_if] :: CompIter annot -> CompIf annot [comp_iter_annot] :: CompIter annot -> annot type CompIterSpan = CompIter SrcSpan instance GHC.Base.Functor Language.Python.Common.AST.Module instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Module annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Module annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Module annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Module annot) instance GHC.Base.Functor Language.Python.Common.AST.Handler instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Handler annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Handler annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Handler annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Handler annot) instance GHC.Base.Functor Language.Python.Common.AST.Statement instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Statement annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Statement annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Statement annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Statement annot) instance GHC.Base.Functor Language.Python.Common.AST.AssignOp instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.AssignOp annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.AssignOp annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.AssignOp annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.AssignOp annot) instance GHC.Base.Functor Language.Python.Common.AST.RaiseExpr instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.RaiseExpr annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.RaiseExpr annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.RaiseExpr annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.RaiseExpr annot) instance GHC.Base.Functor Language.Python.Common.AST.Decorator instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Decorator annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Decorator annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Decorator annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Decorator annot) instance GHC.Base.Functor Language.Python.Common.AST.ExceptClause instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.ExceptClause annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.ExceptClause annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.ExceptClause annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.ExceptClause annot) instance GHC.Base.Functor Language.Python.Common.AST.Parameter instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Parameter annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Parameter annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Parameter annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Parameter annot) instance GHC.Base.Functor Language.Python.Common.AST.Argument instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Argument annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Argument annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Argument annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Argument annot) instance GHC.Base.Functor Language.Python.Common.AST.ComprehensionExpr instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.ComprehensionExpr annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.ComprehensionExpr annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.ComprehensionExpr annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.ComprehensionExpr annot) instance GHC.Base.Functor Language.Python.Common.AST.CompIf instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.CompIf annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.CompIf annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.CompIf annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.CompIf annot) instance GHC.Base.Functor Language.Python.Common.AST.CompIter instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.CompIter annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.CompIter annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.CompIter annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.CompIter annot) instance GHC.Base.Functor Language.Python.Common.AST.CompFor instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.CompFor annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.CompFor annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.CompFor annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.CompFor annot) instance GHC.Base.Functor Language.Python.Common.AST.Comprehension instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Comprehension annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Comprehension annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Comprehension annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Comprehension annot) instance GHC.Base.Functor Language.Python.Common.AST.YieldArg instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.YieldArg annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.YieldArg annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.YieldArg annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.YieldArg annot) instance GHC.Base.Functor Language.Python.Common.AST.DictMappingPair instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.DictMappingPair annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.DictMappingPair annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.DictMappingPair annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.DictMappingPair annot) instance GHC.Base.Functor Language.Python.Common.AST.Slice instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Slice annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Slice annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Slice annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Slice annot) instance GHC.Base.Functor Language.Python.Common.AST.Expr instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Expr annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Expr annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Expr annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Expr annot) instance GHC.Base.Functor Language.Python.Common.AST.Op instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Op annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Op annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Op annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Op annot) instance GHC.Base.Functor Language.Python.Common.AST.ParamTuple instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.ParamTuple annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.ParamTuple annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.ParamTuple annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.ParamTuple annot) instance GHC.Base.Functor Language.Python.Common.AST.ImportRelative instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.ImportRelative annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.ImportRelative annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.ImportRelative annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.ImportRelative annot) instance GHC.Base.Functor Language.Python.Common.AST.FromItems instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.FromItems annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.FromItems annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.FromItems annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.FromItems annot) instance GHC.Base.Functor Language.Python.Common.AST.FromItem instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.FromItem annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.FromItem annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.FromItem annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.FromItem annot) instance GHC.Base.Functor Language.Python.Common.AST.ImportItem instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.ImportItem annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.ImportItem annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.ImportItem annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.ImportItem annot) instance GHC.Base.Functor Language.Python.Common.AST.Ident instance Data.Data.Data annot => Data.Data.Data (Language.Python.Common.AST.Ident annot) instance GHC.Show.Show annot => GHC.Show.Show (Language.Python.Common.AST.Ident annot) instance GHC.Classes.Ord annot => GHC.Classes.Ord (Language.Python.Common.AST.Ident annot) instance GHC.Classes.Eq annot => GHC.Classes.Eq (Language.Python.Common.AST.Ident annot) instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.IdentSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Ident instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ImportItemSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.ImportItem instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.FromItemSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.FromItem instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.FromItemsSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.FromItems instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ImportRelativeSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.ImportRelative instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.StatementSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Statement instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.DecoratorSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Decorator instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ParameterSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Parameter instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ParamTupleSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.ParamTuple instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ArgumentSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Argument instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.HandlerSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Handler instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ExceptClauseSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.ExceptClause instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ComprehensionSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Comprehension instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ComprehensionExprSpan instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.CompForSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.CompFor instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.CompIfSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.CompIf instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.CompIterSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.CompIter instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.ExprSpan instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.YieldArgSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Expr instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.DictMappingPairSpan instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.SliceSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Slice instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.OpSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.Op instance Language.Python.Common.SrcLocation.Span Language.Python.Common.AST.AssignOpSpan instance Language.Python.Common.AST.Annotated Language.Python.Common.AST.AssignOp -- | Pretty printing of the Python abstract syntax (version 2.x and 3.x). module Language.Python.Common.PrettyAST instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Module a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Ident a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.ImportItem a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.FromItem a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.FromItems a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.ImportRelative a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Statement a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Handler a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.ExceptClause a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.RaiseExpr a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Decorator a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Parameter a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.ParamTuple a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Argument a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Comprehension a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.ComprehensionExpr a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.CompFor a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.CompIf a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.CompIter a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Expr a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.YieldArg a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.DictMappingPair a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Slice a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.Op a) instance Language.Python.Common.Pretty.Pretty (Language.Python.Common.AST.AssignOp a) -- | Pretty printing of tokens. Note the output is intended for displaying -- in messages to the user, and may not be valid Python syntax. For -- instance the pretty printing is useful for displaying parser error -- messages, but not useful for producing concrete Python source. module Language.Python.Common.PrettyToken instance Language.Python.Common.Pretty.Pretty Language.Python.Common.Token.Token -- | Error values for the lexer and parser. module Language.Python.Common.ParseError data ParseError -- | An error from the parser. Token found where it should not be. Note: -- tokens contain their own source span. UnexpectedToken :: Token -> ParseError -- | An error from the lexer. Character found where it should not be. UnexpectedChar :: Char -> SrcLocation -> ParseError -- | A generic error containing a string message. No source location. StrError :: String -> ParseError instance GHC.Show.Show Language.Python.Common.ParseError.ParseError instance GHC.Classes.Ord Language.Python.Common.ParseError.ParseError instance GHC.Classes.Eq Language.Python.Common.ParseError.ParseError instance Control.Monad.Trans.Error.Error Language.Python.Common.ParseError.ParseError -- | Pretty printing of parse errors. module Language.Python.Common.PrettyParseError instance Language.Python.Common.Pretty.Pretty Language.Python.Common.ParseError.ParseError -- | Monad support for Python parser and lexer. module Language.Python.Common.ParserMonad type P a = StateT ParseState (Either ParseError) a execParser :: P a -> ParseState -> Either ParseError a execParserKeepComments :: P a -> ParseState -> Either ParseError (a, [Token]) runParser :: P a -> ParseState -> Either ParseError (a, ParseState) thenP :: P a -> (a -> P b) -> P b returnP :: a -> P a setLocation :: SrcLocation -> P () getLocation :: P SrcLocation getInput :: P String setInput :: String -> P () getLastToken :: P Token setLastToken :: Token -> P () setLastEOL :: SrcSpan -> P () getLastEOL :: P SrcSpan data ParseError -- | An error from the parser. Token found where it should not be. Note: -- tokens contain their own source span. UnexpectedToken :: Token -> ParseError -- | An error from the lexer. Character found where it should not be. UnexpectedChar :: Char -> SrcLocation -> ParseError -- | A generic error containing a string message. No source location. StrError :: String -> ParseError data ParseState ParseState :: !SrcLocation -> !String -> !Token -> [Int] -> [Int] -> [Token] -> !SrcSpan -> [Token] -> ParseState [location] :: ParseState -> !SrcLocation [input] :: ParseState -> !String [previousToken] :: ParseState -> !Token [startCodeStack] :: ParseState -> [Int] [indentStack] :: ParseState -> [Int] [parenStack] :: ParseState -> [Token] [lastEOL] :: ParseState -> !SrcSpan [comments] :: ParseState -> [Token] initialState :: SrcLocation -> String -> [Int] -> ParseState pushStartCode :: Int -> P () popStartCode :: P () getStartCode :: P Int getIndent :: P Int pushIndent :: Int -> P () popIndent :: P () getIndentStackDepth :: P Int getParen :: P (Maybe Token) pushParen :: Token -> P () popParen :: P () getParenStackDepth :: P Int addComment :: Token -> P () getComments :: P [Token] spanError :: Span a => a -> String -> P b instance GHC.Show.Show Language.Python.Common.ParserMonad.ParseState -- | Lexical analysis for Python version 3.x programs. See: -- http://www.python.org/doc/3.1/reference/lexical_analysis.html. module Language.Python.Version3.Lexer -- | Parse a string into a list of Python Tokens, or return an error. lex :: String -> String -> Either ParseError [Token] -- | Try to lex the first token in an input string. Return either a parse -- error or a pair containing the next token and the rest of the input -- after the token. lexOneToken :: String -> String -> Either ParseError (Token, String) -- | Lex a sequence of tokens. lexer :: P [Token] initLexState :: String -> String -> ParseState -- | A parser for Python version 3.x programs. Parsers are provided for -- modules, statements, and expressions. The parsers produce comment -- tokens in addition to the abstract syntax tree. -- -- See: -- -- module Language.Python.Version3.Parser -- | Parse a whole Python source file. Return comments in addition to the -- parsed module. parseModule :: String -> String -> Either ParseError (ModuleSpan, [Token]) -- | 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. parseStmt :: String -> String -> Either ParseError ([StatementSpan], [Token]) -- | Parse an expression. Generally used as input for the 'eval' primitive. -- Return comments in addition to the parsed expression. parseExpr :: String -> String -> Either ParseError (ExprSpan, [Token]) -- | A convenient re-export of the parser and lexer for version 3.x of -- Python. -- -- See: -- -- module Language.Python.Version3 -- | Lexical analysis for Python version 2.x programs. See: -- http://www.python.org/doc/2.6/reference/lexical_analysis.html. module Language.Python.Version2.Lexer -- | Parse a string into a list of Python Tokens, or return an error. lex :: String -> String -> Either ParseError [Token] -- | Try to lex the first token in an input string. Return either a parse -- error or a pair containing the next token and the rest of the input -- after the token. lexOneToken :: String -> String -> Either ParseError (Token, String) -- | 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. -- -- See: -- -- module Language.Python.Version2.Parser -- | Parse a whole Python source file. Return comments in addition to the -- parsed module. parseModule :: String -> String -> Either ParseError (ModuleSpan, [Token]) -- | 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. parseStmt :: String -> String -> Either ParseError ([StatementSpan], [Token]) -- | Parse an expression. Generally used as input for the 'eval' primitive. -- Return comments in addition to the parsed expression. parseExpr :: String -> String -> Either ParseError (ExprSpan, [Token]) -- | A convenient re-export of the parser and lexer for version 2.x of -- Python. -- -- See: -- -- module Language.Python.Version2 -- | Convenient re-export of common code, which works with both version 2.x -- and 3.x of Python. module Language.Python.Common