python | pyparsing，一个强大的 Python 库！

本文来源公众号“python”，仅用于学术分享，侵权删，干货满满。

原文链接：pyparsing，一个强大的 Python 库！

大家好，今天为大家分享一个强大的 Python 库 - pyparsing。

Github地址：https://github.com/pyparsing/pyparsing

在处理文本解析任务时，正则表达式往往难以应对复杂的语法结构。Python的pyparsing库提供了一种优雅的方式来构建语法解析器，它使用声明式的语法定义方式，让开发者能够轻松处理各种复杂的文本格式。从简单的配置文件到复杂的编程语言，pyparsing都能够胜任，是文本解析领域的强大工具。

安装

基础安装

使用pip包管理器进行安装：

pip install pyparsing

基本功能

基础解析元素

pyparsing提供了丰富的基础解析元素，用于构建复杂的语法规则。这些元素包括Word、Literal、nums等，可以组合使用来匹配各种文本模式。通过这些基础元素，可以轻松构建出强大的解析器。

from pyparsing import Word, alphas, nums, Literal, OneOrMore

# 定义基本解析器
word = Word(alphas)  # 匹配字母
number = Word(nums)  # 匹配数字
plus = Literal("+")  # 匹配加号

# 组合解析器
expr = number + plus + number

# 测试解析
result = expr.parseString("123+456")
print(result)  # ['123', '+', '456']

# 使用OneOrMore匹配多个元素
words = OneOrMore(word)
result = words.parseString("hello world python")
print(result)  # ['hello', 'world', 'python']

组合与运算符

pyparsing支持丰富的组合操作，可以使用运算符来组合不同的解析规则。通过这些组合操作，可以构建出复杂的语法结构，处理各种文本格式。

from pyparsing import Word, alphas, nums, Combine, Optional

# 定义数字和标识符解析器
integer = Word(nums)
identifier = Word(alphas)

# 组合解析器
phone_number = Combine(Word(nums, exact=3) + "-" + Word(nums, exact=4))
name_with_title = Optional("Mr.") + identifier

# 测试解析
print(phone_number.parseString("123-4567"))  # ['123-4567']
print(name_with_title.parseString("Mr.John"))  # ['Mr.', 'John']
print(name_with_title.parseString("Mary"))    # ['Mary']

递归语法

pyparsing能够优雅地处理递归语法结构，这在处理嵌套结构时非常有用。通过forward声明，可以定义相互引用的语法规则。

from pyparsing import Word, alphas, nums, Forward, Group

# 定义递归表达式
expr = Forward()
atom = Word(alphas) | Group("(" + expr + ")")
expr << atom + Optional("+") + Optional(expr)

# 测试嵌套结构
test = "a+(b+c)"
result = expr.parseString(test)
print(result)  # ['a', '+', ['(', 'b', '+', 'c', ')']]

高级功能

语法动作

pyparsing允许为解析规则添加动作函数，在匹配成功时自动执行。这些动作可以用来转换解析结果或执行其他操作，使解析过程更加灵活。

from pyparsing import Word, nums, Combine, Group

# 定义解析动作
def convert_to_number(tokens):
    return int(tokens[0])

def process_sum(tokens):
    return sum(tokens)

# 创建带动作的解析器
number = Word(nums).setParseAction(convert_to_number)
sum_expr = Group(number + OneOrMore(Literal("+") + number)).setParseAction(process_sum)

# 测试解析和动作
result = sum_expr.parseString("12+34+56")
print(result[0])  # 输出: 102

错误处理

pyparsing提供了强大的错误处理机制，可以生成详细的错误信息，帮助定位和解决解析问题。通过自定义错误处理，可以提供更好的用户体验。

from pyparsing import Word, nums, ParseException

# 定义带验证的解析器
def validate_number(tokens):
    num = int(tokens[0])
    if num < 0 or num > 100:
        raise ParseException("Number must be between 0 and 100")
    return num

number = Word(nums).setParseAction(validate_number)

# 测试错误处理
try:
    result = number.parseString("150")
except ParseException as e:
    print(f"解析错误: {e}")

实际应用场景

配置文件解析

pyparsing非常适合用于解析各种格式的配置文件，可以轻松处理层级结构和复杂的配置项。

from pyparsing import Word, alphas, nums, Group, Dict, OneOrMore

class ConfigParser:
    def __init__(self):
        # 定义基本元素
        identifier = Word(alphas + "_")
        value = Word(alphas + nums + "_./")
        
        # 定义配置项格式
        config_item = Group(identifier + "=" + value)
        section = Group("[" + identifier + "]" + 
                       OneOrMore(config_item))
        
        # 完整配置文件格式
        self.config = OneOrMore(section)
    
    def parse_file(self, text):
        return self.config.parseString(text)

# 使用示例
config_text = """
[database]
host = localhost
port = 5432
name = mydb

[server]
host = 0.0.0.0
port = 8080
"""

parser = ConfigParser()
result = parser.parse_file(config_text)
print(result.asList())

数学表达式解析

pyparsing可以用于构建数学表达式解析器，支持运算符优先级和括号嵌套。

from pyparsing import Word, nums, Forward, Group, Suppress, Optional, oneOf

class ExpressionParser:
    def __init__(self):
        # 定义数字
        number = Word(nums).setParseAction(lambda t: float(t[0]))
        
        # 定义表达式
        expr = Forward()
        
        # 定义运算符
        operator = oneOf("+ - * /")
        
        # 定义括号表达式
        parenthesis = Group(
            Suppress("(") + expr + Suppress(")")
        )
        
        # 定义原子表达式
        atom = number | parenthesis
        
        # 完整表达式定义
        expr << atom + Optional(operator + expr)
        
        self.parser = expr
    
    def parse(self, text):
        return self.parser.parseString(text)

# 使用示例
parser = ExpressionParser()
result = parser.parse("2 * (3 + 4)")
print(result)

总结

Python pyparsing库为文本解析提供了一个强大而灵活的解决方案。通过其声明式的语法定义方式，开发者可以构建出清晰、可维护的解析器。从基本的文本匹配到复杂的语法结构，pyparsing都能够优雅地处理。它的错误处理机制和语法动作特性，让开发者能够构建出健壮的解析应用。对于需要处理复杂文本格式的Python开发者来说，pyparsing是一个值得投入时间学习的工具库。

THE END !

文章结束，感谢阅读。您的点赞，收藏，评论是我继续更新的动力。大家有推荐的公众号可以评论区留言，共同学习，一起进步。