gecko-dev/third_party/python/glean_parser
Alessio Placitelli 0afdad78d1 Bug 1675534 - Update glean-parser to v1.29.0. r=chutten
This version bump is required by the Rust glean-core version
bump to v33.3.3.

Depends on D96834

Differential Revision: https://phabricator.services.mozilla.com/D96835
2020-11-12 15:54:13 +00:00
..
.circleci Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
.github Bug 1664306 - Bump vendored glean_parser version to 1.28.5 r=janerik 2020-09-22 15:21:55 +00:00
glean_parser Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
tools Bug 1635260 - Update vendored glean_parser to 1.28.0 r=janerik 2020-07-29 16:53:10 +00:00
.editorconfig
.flake8
.gitignore
.swiftlint.yml
AUTHORS.rst
CODE_OF_CONDUCT.md
CONTRIBUTING.rst Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
HISTORY.rst Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
LICENSE
MANIFEST.in
Makefile Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
PKG-INFO Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
README.rst Bug 1635260 - Update vendored glean_parser to 1.28.0 r=janerik 2020-07-29 16:53:10 +00:00
requirements_dev.txt Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00
setup.cfg
setup.py Bug 1675534 - Update glean-parser to v1.29.0. r=chutten 2020-11-12 15:54:13 +00:00

README.rst

============
Glean Parser
============

Parser tools for Mozilla's Glean telemetry.

Features
--------

Parses the ``metrics.yaml`` files for the Glean telemetry SDK and produces
output for various integrations.

Documentation
-------------

The full documentation is available `here <https://mozilla.github.io/glean_parser/>`__.

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
-----

.. code-block:: console

  $ glean_parser --help

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

.. code-block:: console

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

Check a Glean ping against the ping schema:

.. code-block:: console

  $ glean_parser check < ping.json