Metadata-Version: 1.1
Name: bourbaki.regex
Version: 0.1.0
Summary: UNKNOWN
Home-page: https://github.com/bourbaki-py/regex
Author: Matthew Hawthorn
Author-email: hawthorn.matthew@gmail.com
License: Apache License 2.0
Description: # Regular expressions made readable
        
        ## Introduction
        
        `bourbaki.regex` provides an interface for constructing arbitrarily complex 
        regular expressions using standard Python syntax.
        
        The goals of the package are the following:
        
          - allow the user to be as terse as possible while not sacrificing readability
          - support the full range of constructs available in the standard library regex engine (`re` module)
          - be extensible and modular to support more advanced constructs in the future, 
            as for instance provided by the `regex` module
          - handle minutiae such as handling backreferences (inferring the correct group index)
          - raise meaningful errors at compile time, such as named group collisions, nonexistent
            backreferences, and lookbehind assertions that are not fixed-length.
        
        ## Usage
        
        There are a few base constructors from which all expression patterns can be built:
        
          - `bourbaki.regex.C`: Character class constructor.
            `C['a':'z', 'A-Z', '0':'9']` for instance is equivalent to the raw regular expression `r'[a-zA-Z0-9]`
          - `bourbaki.regex.L/Literal`: Literal string match.  This handles escaping special characters that are reserved for 
            regular expression syntax.
            For example `L('*foo[bar]*')` is equivalent to the raw regular expression `r'\*foo\[bar\]\*'`
            (note the '\' escapes)
          
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
