Py Idiomatic Regex (AKA iregex)
An easier way to write regex in Python using OOP instead of strings.
Makes the code much easier to read and understand while still using Regex under the hood.
Very easy to use, entirely contained within two files consts.py and regex.py.
Installation
pip install iregex
Examples
Imagine a regex to match variable names in most common languages.
They must start with an alphabetical character, then for the second character on they can contain numbers and underscores as well.
The regex for this would be:
[a-zA-Z][_\w]*
And in python you would compile this like so:
import re
re.compile(r"[a-zA-Z][_\w]*")
In this library the code would be:
from iregex import Regex, ALPHA, ALPHA_NUMERIC, AnyChar, ZeroOrMore
(ALPHA + ZeroOrMore(AnyChar("_", ALPHA_NUMERIC))).compile()
Note: If you would like to use the regex library instead of re do this instead.
import regex
from iregex import Regex, ALPHA, ALPHA_NUMERIC, AnyChar, ZeroOrMore
regex.compile(str(ALPHA + ZeroOrMore(AnyChar("_", ALPHA_NUMERIC))))
We do this to prevent the need for additional dependencies.
Just take a look at the documentation for the Regex class to get an idea of all the methods you can use!
You chain methods together for sequential operations and nest literals for nested operations.
PyParsing
A lot of people will ask why use this over PyParsing? I actually had never heard of pyparsing before writing this library and sense have made updates that are inspired by pyparsing. The main reason I might use this over pyparsing is to stay specifically inside the Regex space using either the builtin re or regex library which can sometimes be faster than pyparsing. This library operates almost entirely on strings, which is a lot simpler than what pyparsing is doing under the hood. But please, use both!
Contributions
Please make a contribution, this library is still growing!
Please download poetry and run poetry install to set up your build environment.
We use mypy (so be sure to type your code), flake8, and black so be sure to use pre-commit install before your first push to comply with git pre-commit standards. Otherwise your pull request will not make it past TravisCI.
Always pytest your code and make PR's with good code coverage.
25 Sep 4, 2022
307 Jan 7, 2023
3 Jan 30, 2022
41 Jan 4, 2023
48 Dec 18, 2022
3 Jul 14, 2022
0 Jun 22, 2022
22 Sep 8, 2022
4 Mar 18, 2022
6.2k Dec 29, 2022
6k Jan 06, 2023
36 Dec 11, 2022
134 Dec 30, 2022
3 Feb 15, 2022
4 Feb 02, 2022
310 Aug 22, 2022
2 Jan 10, 2022
2 Jan 23, 2022
10 Aug 19, 2022
3 Feb 04, 2022
67 Jan 10, 2022
1.8k Dec 31, 2022
1 Dec 18, 2022
18 Jan 06, 2023
10 Oct 03, 2021
2.8k Jan 02, 2023
7 Dec 25, 2022
1 Jul 11, 2022
6 Oct 02, 2022