This repo maintains the lists of repositories defining ROS distributions.
It is the implementation of REP 141
How to submit pull requests
When submitting pull requests it is expected that they pass the unit tests for formatting. The unit tests enforce alphabetization of elements and a consistant formatting to keep merging as clean as possible.
To run the tests run nosetests
in the root of the repository. They require the rosdistro library,
available on Ubuntu with the ROS repositories as python-rosdistro or via pip as rosdistro.
There is a tool rosdistro_reformat
which will fix most formatting errors such as alphabetization and correct formatting.
A Quick Overview of How to Use this Repository
To add your project to our build farm, fork this repository, modify the .yaml files, and give us a pull request.
For Fuerte and older the ROS packages are maintained in the subfolder releases
and doc
.
For Groovy and newer the ROS packages are maintained in the subfolder named after the ROS distribution.
Mappings for dependencies are maintained in the rosdep
subfolder.
To create jobs on our build farm to build Debian sourcedeb and binarydeb packages add your bloom (or git-buildpackage compatible) repository to the ROSDISTRO/release.yaml
file (or releases/ROSDISTRO.yaml
for Fuerte and older).
Please keep the alphabetic order of the list.
You can use the script scripts/add_release_repo.py
to perform the insertion.
To create jobs on our build farm to perform continuous integration of your repository on every commit add your source repository to the ROSDISTRO/source.yaml
file (or releases/ROSDISTRO-devel.yaml
for Fuerte and older).
Please keep the alphabetic order of the list.
You can use the script scripts/add_devel_repo.py
to perform the insertion.
Files and directories:
- index.yaml: list of ROS distributions (Groovy and newer) with references to their release, source and doc files
- ROSDISTRO: the release, source and doc files of the ROS distribution and their corresponding build files
- releases: list of released resources (e.g. GBP distro files) and targets configuration (Fuerte and older)
- rosdep: rosdep YAML files and default configuration
- scripts: support scripts