Maintaining the Codebase

Babel maintainers are expected to handle the following tasks as they arise:

• Reviewing and merging pull requests
• Triaging new issues

Dependencies

A number of tasks that are typically associated with maintenance are partially or fully automated.

• WhiteSource Renovate (Python library dependencies and GitHub Actions)
• Custom GitHub Action (Nix dependencies)

poetry

Occasionally you may need to lock poetry dependencies. Edit pyproject.toml as needed, then run:

poetry lock --no-update

Adding Examples

If you're not a maintainer, please open an issue asking us to add your example.

Requirements

You need the ability to write to the gs://babel-examples GCS bucket to add an example.

Instructions

Make sure you're in the root of the babel git repository.

Assuming your file is called example.csv:

1. Add a gzip-compressed CSV file with the path babel/examples/data/example.csv.gz.
2. Add a file named babel/examples/descriptions/example that contains a description of your example. One line is best, but not necessary.
3. Run one of the following from the git root of a babel clone:
4. python babel/examples/gen_registry.py (doesn't include R dependenices)
5. nix run '.#gen-examples' (includes R dependenices)

Release

Babel is released on PyPI and Conda Forge.

PyPIconda-forge

Releases to PyPI are handled automatically using semantic release.

To trigger a release use the Release GitHub Action.

The conda-forge package is maintained as a conda-forge feedstock.

After a release to PyPI, the conda-forge bot automatically updates the babel-data package.

---

Last update: March 8, 2023