Skip to content

API reference generator #1078

API reference generator

API reference generator #1078

name: API reference generator
on:
workflow_dispatch:
inputs:
name:
description: "Manual trigger"
schedule:
- cron: '0 6 * * *'
jobs:
generate_rmw_api_reference:
runs-on: ubuntu-latest
container: ros:iron
steps:
- uses: actions/checkout@v3
- run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
- name: Get date
id: date
run: echo "::set-output name=date::$(date +'%d-%m-%Y %H:%M')"
- name: Update libraries
shell: bash
run: |
apt update
apt install -y doxygen wget git unzip cmake
pushd /
wget https://github.com/matusnovak/doxybook2/releases/download/v1.3.3/doxybook2-linux-amd64-v1.3.3.zip
unzip doxybook2-linux-amd64-v1.3.3.zip -d doxybook2
mkdir -p ros2_ws/src; cd ros2_ws
git clone -b ros2 https://github.com/eProsima/Micro-CDR src/Micro-CDR
git clone -b ros2 https://github.com/eProsima/Micro-XRCE-DDS-Client src/Micro-XRCE-DDS-Client
git clone -b iron https://github.com/micro-ROS/rosidl_typesupport_microxrcedds src/rosidl_typesupport_microxrcedds
git clone -b iron https://github.com/micro-ROS/rmw-microxrcedds src/rmw-microxrcedds
source /opt/ros/$ROS_DISTRO/setup.bash
colcon build --packages-up-to rmw_microxrcedds --cmake-args -DBUILD_DOCUMENTATION=ON
popd
/doxybook2/bin/doxybook2 --input /ros2_ws/build/rmw_microxrcedds/doc/xml --output _includes/rmw_doc -c utils/doxy_config -t utils/doxy_templates
- name: Create Pull Request
uses: peter-evans/create-pull-request@v4
with:
commit-message: micro-ROS RMW API reference auto-update ${{ steps.date.outputs.date }}
title: micro-ROS RMW API reference auto-update ${{ steps.date.outputs.date }}
body: This PR is autogenerated and updates the micro-ROS RMW API reference. Close and reopen to trigger CI.
branch: autoupdate_micro_ros_rmw_api_reference
delete-branch: true
base: master
generate_utils_api_reference:
runs-on: ubuntu-latest
container: ros:iron
steps:
- uses: actions/checkout@v3
- run: git config --global --add safe.directory "$GITHUB_WORKSPACE"
- name: Get date
id: date
run: echo "::set-output name=date::$(date +'%d-%m-%Y %H:%M')"
- name: Update libraries
shell: bash
run: |
apt update
apt install -y doxygen wget git unzip cmake ros-iron-osrf-testing-tools-cpp
pushd /
wget https://github.com/matusnovak/doxybook2/releases/download/v1.3.3/doxybook2-linux-amd64-v1.3.3.zip
unzip doxybook2-linux-amd64-v1.3.3.zip -d doxybook2
mkdir -p ros2_ws/src; cd ros2_ws
git clone -b iron https://github.com/micro-ROS/micro_ros_utilities src/micro_ros_utilities
source /opt/ros/$ROS_DISTRO/setup.bash
colcon build --packages-up-to micro_ros_utilities --cmake-args -DBUILD_DOCUMENTATION=ON
popd
/doxybook2/bin/doxybook2 --input /ros2_ws/build/micro_ros_utilities/doc/xml --output _includes/utils_doc -c utils/doxy_config -t utils/doxy_templates
- name: Create Pull Request
uses: peter-evans/create-pull-request@v4
with:
commit-message: micro-ROS Utils API reference auto-update ${{ steps.date.outputs.date }}
title: micro-ROS Utils API reference auto-update ${{ steps.date.outputs.date }}
body: This PR is autogenerated and updates the micro-ROS Utils API reference. Close and reopen to trigger CI.
branch: autoupdate_micro_ros_utils_api_reference
delete-branch: true
base: master