glean-parser

What it is and what it does

Glean Parser is a command-line tool and library for working with Mozilla's Glean telemetry framework. It reads telemetry configuration files in YAML format (metrics.yaml and pings.yaml) and translates them into generated code for various Glean SDK integrations—such as Kotlin—while also performing validation and linting against the Glean schema. The tool is built on common Python libraries (Jinja2 for templating, jsonschema for validation, PyYAML for config parsing) and exposes both CLI commands and a programmatic API.

It is typically used by teams instrumenting applications with Glean telemetry to validate their metric definitions before deployment and to generate the boilerplate code needed to integrate those metrics into their SDKs. The package is actively maintained and supports modern Python versions (3.9 through 3.13).

Use it for:

• Validate metrics.yaml and pings.yaml files against Glean schema before committing to a repository.
• Generate Kotlin code from telemetry configuration for Android applications using Glean.
• Lint telemetry definitions to catch configuration errors early in the development cycle.
• Integrate telemetry validation into CI/CD pipelines for Glean-instrumented projects.
• Check incoming Glean ping payloads against the ping schema for correctness.

Worth the install?

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

Parses and validates Glean telemetry configuration files (metrics.yaml and pings.yaml), generating code for various SDK integrations and performing linting checks.

Yes, if you are building or maintaining applications that use Mozilla's Glean telemetry framework. The package is actively maintained, has low install friction, and is production-stable. However, verify the license terms first, as the metadata does not clearly record the license under which it is distributed.

Install

glean-parser on PyPI

pip install glean-parser

uv add glean-parser

poetry add glean-parser

Installing glean-parser

Before you install

Low install friction with six common dependencies (click, diskcache, jinja2, jsonschema, platformdirs, pyyaml). Active maintenance with a release 24 days ago and last commit on 2026-08-11.

License in practice

License status is unclear—no SPDX identifier or raw license text is recorded in the package metadata. Verify the actual license terms before adopting in proprietary or restricted-license projects.

Quickstart

pip install glean-parser

glean_parser translate -o output_dir -f kotlin metrics.yaml
glean_parser check < ping.json

Requires Python 3.9 or later.

Verify before relying

• Actual license under which glean-parser is distributed (metadata shows unclear status).
• Whether the package is suitable for production telemetry pipelines outside Mozilla infrastructure.

Package facts

Evidence: glean_parser-20.2.0-py3-none-any.whl

Tags

More Quality Assurance packages