pycep-parser

What it is and what it does

pycep-parser is a Python library that parses Azure Bicep files—a domain-specific language for defining Azure infrastructure—into an abstract syntax tree (AST) using the Lark parser framework. It lets you programmatically read and analyze Bicep templates rather than treating them as opaque text, enabling tooling, validation, and transformation workflows.

The package is actively maintained and supports modern Python versions (3.10–3.14). Its three runtime dependencies are all lightweight and widely used. However, the documentation notes that support is still incomplete for some Bicep features (custom data types with decorators, union types in objects, and certain built-in functions like CIDR and Lambda), so it may not parse every valid Bicep file yet.

Use it for:

• Validate Bicep templates programmatically before deployment to catch syntax or structural errors early.
• Extract metadata from Bicep files (parameters, outputs, resource definitions) for documentation or inventory tools.
• Build linting or code-quality tools that analyze Bicep templates for best practices and compliance.
• Integrate Bicep parsing into CI/CD pipelines to gate deployments on template analysis results.
• Generate reports or visualizations of infrastructure defined in Bicep files.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses Azure Bicep infrastructure-as-code files into a structured representation using Lark, enabling programmatic analysis and manipulation of Bicep templates.

Yes, if you need to parse Bicep files programmatically. The package is actively maintained, has low install friction, carries a permissive license, and has no known vulnerabilities. Be aware that support for some Bicep language features is still incomplete; check the capabilities documentation to confirm it handles your template syntax before relying on it in production.

Install

pycep-parser on PyPI

pip install pycep-parser

uv add pycep-parser

poetry add pycep-parser

Installing pycep-parser

Before you install

Low friction install with three lightweight runtime dependencies (lark, regex, typing-extensions). Active maintenance with a release within the last week and ongoing development; requires Python 3.10 or later.

License in practice

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart

pip install pycep-parser

from pycep_parser import parse_file

ast = parse_file('template.bicep')

Requires Python 3.10 or later; Lark 1.1.2 or later must be available.

Verify before relying

• Whether the parser handles all current Bicep language features or only a subset (docs reference incomplete support for decorators, union types, and some functions).
• Performance characteristics when parsing large or complex Bicep templates.
• Whether the AST output is stable across releases or subject to breaking changes.

Package facts

Evidence: pycep_parser-0.7.1-py3-none-any.whl

Keywords: bicep, lark, parser

Tags

More Markup packages