Delete extra author tag and add comments #887
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: main | |
# Controls when the action will run. | |
on: | |
push: | |
branches: [ '**' ] | |
pull_request: | |
branches: [ main ] | |
release: | |
# A release, pre-release, or draft of a release is published. | |
types: [ published ] | |
# Allows you to run this workflow manually from the Actions tab. | |
workflow_dispatch: | |
# A workflow run is made up of one or more jobs that can run sequentially or in parallel. | |
jobs: | |
# The introduction just shows some useful informations. | |
intro: | |
# The type of runner that the job will run on. | |
runs-on: ubuntu-latest | |
# Steps represent a sequence of tasks that will be executed as part of the job. | |
steps: | |
- run: echo "The job was automatically triggered by a ${{ github.event_name }} event." | |
- run: echo "The name of the branch is ${{ github.ref }} and the repository is ${{ github.repository }}." | |
# Build all targets | |
build: | |
# The type of runner that the job will run on. | |
runs-on: ubuntu-latest | |
needs: intro | |
strategy: | |
matrix: | |
environment: ["CalibTarget", "ConvoyFollowerTarget", "ConvoyLeaderTarget", "LineFollowerTarget", "LineFollowerSimpleTarget", "RemoteControlTarget", "SensorFusionTarget"] | |
# Steps represent a sequence of tasks that will be executed as part of the job. | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v4 | |
- name: Cache pip | |
uses: actions/cache@v4 | |
with: | |
path: ~/.cache/pip | |
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} | |
restore-keys: | | |
${{ runner.os }}-pip- | |
- name: Cache PlatformIO | |
uses: actions/cache@v4 | |
with: | |
path: ~/.platformio | |
key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }} | |
- name: Set up Python | |
uses: actions/setup-python@v5 | |
with: | |
python-version: '3.9' | |
- name: Install PlatformIO | |
run: | | |
python -m pip install --upgrade pip | |
pip install --upgrade platformio | |
- name: Compile ${{ matrix.environment }} firmware | |
run: platformio run --environment ${{ matrix.environment }} | |
# Perform static checks and test | |
check: | |
# The type of runner that the job will run on. | |
runs-on: ubuntu-latest | |
needs: intro | |
strategy: | |
matrix: | |
environment: ["CalibTarget", "ConvoyFollowerTarget", "ConvoyLeaderTarget", "LineFollowerTarget", "LineFollowerSimpleTarget", "RemoteControlTarget", "SensorFusionTarget", "TestSim"] | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v4 | |
- name: Cache pip | |
uses: actions/cache@v4 | |
with: | |
path: ~/.cache/pip | |
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} | |
restore-keys: | | |
${{ runner.os }}-pip- | |
- name: Cache PlatformIO | |
uses: actions/cache@v4 | |
with: | |
path: ~/.platformio | |
key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }} | |
- name: Set up Python | |
uses: actions/setup-python@v5 | |
with: | |
python-version: '3.9' | |
- name: Install PlatformIO | |
run: | | |
python -m pip install --upgrade pip | |
pip install --upgrade platformio | |
- name: Perform static checks on ${{ matrix.environment }} | |
run: platformio check --environment ${{ matrix.environment }} --fail-on-defect=medium --fail-on-defect=high | |
# Perform tests | |
test: | |
# The type of runner that the job will run on. | |
runs-on: ubuntu-latest | |
needs: intro | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v4 | |
- name: Cache pip | |
uses: actions/cache@v4 | |
with: | |
path: ~/.cache/pip | |
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} | |
restore-keys: | | |
${{ runner.os }}-pip- | |
- name: Cache PlatformIO | |
uses: actions/cache@v4 | |
with: | |
path: ~/.platformio | |
key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }} | |
- name: Set up Python | |
uses: actions/setup-python@v5 | |
with: | |
python-version: '3.9' | |
- name: Install PlatformIO | |
run: | | |
python -m pip install --upgrade pip | |
pip install --upgrade platformio | |
- name: Run tests on native environment | |
run: platformio test --environment TestSim -vvv | |
# Build documentation | |
doc: | |
# The type of runner that the job will run on. | |
runs-on: ubuntu-latest | |
needs: intro | |
strategy: | |
matrix: | |
environment: ["CalibTarget", "ConvoyFollowerTarget", "ConvoyLeaderTarget", "LineFollowerTarget", "LineFollowerSimpleTarget", "RemoteControlTarget", "SensorFusionTarget", "CalibSim", "ConvoyFollowerSim", "ConvoyLeaderSim", "LineFollowerSim", "LineFollowerSimpleSim", "ReinforcementLearningSim", "RemoteControlSim", "SensorFusionSim"] | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v4 | |
- name: Cache pip | |
uses: actions/cache@v4 | |
with: | |
path: ~/.cache/pip | |
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} | |
restore-keys: | | |
${{ runner.os }}-pip- | |
- name: Cache PlatformIO | |
uses: actions/cache@v4 | |
with: | |
path: ~/.platformio | |
key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }} | |
- name: Set up Python | |
uses: actions/setup-python@v5 | |
with: | |
python-version: '3.9' | |
- name: Install PlatformIO | |
run: | | |
python -m pip install --upgrade pip | |
pip install --upgrade platformio | |
- name: Set up graphviz | |
uses: ts-graphviz/setup-graphviz@v2 | |
- name: Set up doxygen and generate documentation for ${{ matrix.environment }} | |
uses: mattnotmitt/[email protected] | |
with: | |
working-directory: './doc/doxygen' | |
doxyfile-path: './${{ matrix.environment }}Doxyfile' | |
- name: Print doxygen warnings | |
if: ${{ failure() }} | |
run: cat ./doc/doxygen/doxygen_warnings.txt | |
# Lint Python code | |
lint: | |
# The type of runner that the job will run on. | |
runs-on: ubuntu-latest | |
needs: intro | |
strategy: | |
matrix: | |
python-version: ["3.9", "3.10", "3.11"] | |
# Steps represent a sequence of tasks that will be executed as part of the job. | |
steps: | |
- name: Checkout repository | |
uses: actions/checkout@v4 | |
- name: Set up Python ${{ matrix.python-version }} | |
uses: actions/setup-python@v5 | |
with: | |
python-version: ${{ matrix.python-version }} | |
- name: Install dependencies | |
run: | | |
pip install pylint | |
- name: Analysing the code with pylint | |
run: | | |
pylint ./webots/controllers/*/*.py |