Taxon Expression Language (TEL)

WARNING

This grammar is still under development and can be change at will. If you want to use it, please consult your decision with data blending team in #fdev-data-glossary channel.

Release process

To release a new version of the library, follow these steps:

• In your PR, update version in setup.py and add entry to CHANGELOG.md
• After merge, tag the commit with version number from setup.py. For example git tag v0.1.1. You can also do this by creating a new release.
• This triggers a Jenkins pipeline which runs tests, linters and uploads the package to Artifactory

Introduction

This repository contains formal definition of grammar for TEL written in ANTLR v4. It can generate following components in both python and JavaScript to handle parsing string expressions:

• lexer - splits string expression into tokens
• parser - connects tokens into parse tree (similar to AST)
• visitor - class which helps to traverse generated parse tree

Grammar definition

Current documentation on the language is available here.

How to use it

make image-java

It builds local docker image to run ANTLR commands. You need to run this command before you may run ANTLR-related make commands.

make image-python

It builds local docker image to run python tests. This image is used to run tests on the current grammar.

make build-code-python

It generates all components in python language

make build-code-js

It generates all components in JavaScript language

make test

Runs tests on the current version of grammar.