Welcome to parsy’s documentation!

These are the docs for parsy 2.1. Check the History and release notes for significant changes.

Contents:

• Installation
• Overview
  • Other Python projects
• Tutorial
  • Building an ISO 8601 parser
  • Using previously parsed values
  • Alternatives and backtracking
  • Custom data structures
  • Learn more
• API reference
  • Parsing primitives
    • string()
    • regex()
    • test_char()
    • test_item()
    • char_from()
    • string_from()
    • match_item()
    • eof
    • success()
    • fail()
    • from_enum()
    • peek()
    • Pre-built parsers
      • any_char
      • whitespace
      • letter
      • digit
      • decimal_digit
      • line_info
      • index
    • Forward declarations
      • forward_declaration
  • Parser methods, operators and combinators
    • Parser methods
      • Parser
    • Parser operators
      • | operator
      • << operator
      • >> operator
      • + operator
      • * operator
    • Parser combinators
      • alt()
      • seq()
    • Other combinators
  • Generating a parser
    • generate()
    • Motivation and examples
      • Alternative syntax to combinators
      • Building complex objects
      • Using values already parsed
      • Implementing recursive definitions
  • Creating new Parser instances
    • Result objects
      • Result
• Howto’s, cookbooks and examples
  • Separate lexing/tokenization phases
    • Turtle Logo
    • Calculator
  • Other examples
    • SQL SELECT statement parser
    • JSON parser
• History and release notes
  • 2.1 - 2023-02-22
  • 2.0 - 2022-09-08
  • 1.4.0 - 2021-11-15
  • 1.3.0 - 2019-08-03
  • 1.2.0 - 2017-11-15
  • 1.1.0 - 2017-11-05
  • 1.0.0 - 2017-10-10
  • 0.9.0 - 2017-09-28
  • 0.0.4 - 2014-12-28
• Contributing to parsy

Indices and tables

• Index

• Module Index

• Search Page