Glean Parser

Parser tools for Mozilla’s Glean telemetry.

Features

Contains various utilities for handling metrics.yaml and pings.yaml for the Glean SDKs. This includes producing generated code for various integrations, linting and coverage testing.

Documentation

Requirements

  • Python 3.6 (or later)

The following library requirements are installed automatically when glean_parser is installed by pip.

  • appdirs

  • Click

  • diskcache

  • Jinja2

  • jsonschema

  • PyYAML

Additionally on Python 3.6:

  • iso8601

Usage

$ glean_parser --help

Read in metrics.yaml, translate to Kotlin format, and output to output_dir:

$ glean_parser translate -o output_dir -f kotlin metrics.yaml

Check a Glean ping against the ping schema:

$ glean_parser check < ping.json