sierra-research 1.3.5__tar.gz → 1.3.11__tar.gz

{sierra-research-1.3.5 → sierra_research-1.3.11}/.github/actions/publish/action.yml

@@ -11,12 +11,12 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/checkout@v3
     - uses: ./.github/actions/sierra-setup
     - name: Build package
       shell: bash
       run: |
         python3 -m build
+        cd docs && make linkcheck
 
     - name: Set tag
       if: github.ref == 'refs/heads/devel'
@@ -37,7 +37,7 @@ runs:
 
       uses: pypa/gh-action-pypi-publish@release/v1
       with:
-        skip_existing: true
+        skip-existing: true
         user: __token__
         password: ${{ inputs.testpypi-token }}
         repository_url: https://test.pypi.org/legacy/

sierra_research-1.3.11/.github/actions/sample-project-setup/action.yml

@@ -0,0 +1,168 @@
+name: 'Setup SIERRA sample project'
+description: 'Setup SIERRA project for CI and testing'
+inputs:
+  platform:  # id of input
+    description: 'The SIERRA platform to setup for'
+    required: true
+  rosdistro:
+    description: 'The version of ROS to test with'
+    default: 'noetic'
+
+runs:
+  using: 'composite'
+  steps:
+    ############################################################################
+    # Common setup
+    ############################################################################
+    - name: Setup python (all OSes)
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Clone sample project
+      shell: bash
+      working-directory: ${{ github.workspace }} # Needed to match with scripts/argos-integration-tests.sh
+
+      run: |
+        if [ ! -d sierra-sample-project ]; then
+        git clone https://github.com/jharwell/sierra-sample-project.git
+        cd sierra-sample-project
+        else
+        cd sierra-sample-project
+        git pull
+        fi
+        git checkout devel
+
+    - name: Get number of CPU cores
+      uses: SimenB/github-actions-cpu-cores@v1
+      id: cpu-cores
+
+    - uses: kenchan0130/actions-system-info@master
+      id: system-info
+
+    - name: Cache build files
+      uses: hendrikmuhs/ccache-action@v1.2
+      with:
+        key: ${{ runner.os }}-${{ steps.system-info.outputs.release }}-build-objects
+        verbose: 0
+
+    ############################################################################
+    # ARGoS setup
+    ############################################################################
+    - uses: nick-fields/retry@v2
+      name: Install ARGoS deps (OSX)
+      if: runner.os == 'macOS'
+      with:
+        timeout_minutes: 10000
+        max_attempts: 3
+        shell: bash
+        command: |
+          # 2023/01/16: Caching doesn't work reliably, for reasons unknown :-(.
+          #
+          # The {xquartz, mactex, qt} deps are not required as long as the ARGoS
+          # integration tests for OSX don't run stage 4+ or try to do video
+          # capture. Installing them takes ~30 min in github actions, so cutting
+          # this particular corner saves a TON of time.
+          #
+          # Note that by omitting Xquartz you MUST also omit Qt, otherwise CI
+          # fails (I think ARGoS segfaults).
+          brew install pkg-config cmake libpng freeimage lua
+
+    - name: Install and cache ARGoS dependencies (Linux)
+      if: runner.os == 'Linux'
+      uses: awalsh128/cache-apt-pkgs-action@latest
+      with:
+        packages: libfreeimage-dev libfreeimageplus-dev qtbase5-dev freeglut3-dev libxi-dev libxmu-dev liblua5.3-dev lua5.3 libgraphviz-dev ccache
+        version: ${{ runner.os }}
+
+    - name: Install ARGoS
+      if: inputs.platform == 'argos'
+      shell: bash
+      run: |
+        git clone https://github.com/ilpincy/argos3.git
+        cd argos3
+
+        mkdir -p build && cd build
+        cmake \
+          -DCMAKE_C_COMPILER_LAUNCHER=ccache \
+          -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
+          -DARGOS_DOCUMENTATION=OFF \
+          ../src
+        make -j ${{ steps.cpu-cores.outputs.count }}
+        sudo make install
+
+    - name: Build SIERRA project for ARGoS
+      if: inputs.platform == 'argos'
+      shell: bash
+      working-directory: ${{ github.workspace }} # Needed to match with scripts/argos-integration-tests.sh
+
+      run: |
+        cd sierra-sample-project/argos
+        mkdir -p build && cd build
+        cmake \
+          -DCMAKE_C_COMPILER_LAUNCHER=ccache \
+          -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
+          -DARGOS_INSTALL_DIR=/usr/local \
+          ..
+        make -j ${{ steps.cpu-cores.outputs.count }}
+
+    ############################################################################
+    # ROS1+Gazebo setup
+    ############################################################################
+    - name: Install ROS1 platform dependency
+      if: inputs.platform == 'ros1gazebo'
+      uses: ros-tooling/setup-ros@v0.7
+      with:
+        required-ros-distributions: ${{ inputs.rosdistro }}
+
+    - name: Install SIERRA ROSbridge system dependencies (Linux)
+      if: inputs.platform == 'ros1gazebo'
+      uses: awalsh128/cache-apt-pkgs-action@latest
+      with:
+        packages: ros-${{ inputs.rosdistro }}-desktop-full ros-${{ inputs.rosdistro }}-turtlebot3-description ros-${{ inputs.rosdistro }}-turtlebot3-msgs ros-${{ inputs.rosdistro }}-turtlebot3-gazebo ros-${{ inputs.rosdistro }}-turtlebot3-bringup python${{ matrix.python-version }} python${{ matrix.python-version }}-dev python${{ matrix.python-version }}-venv python3-apt python3-cairo intltool python3-wheel python3-rospkg python3-empy
+        version: ${{ runner.os }}
+
+    - name: Install SIERRA ROSbridge python dependencies (Linux)
+      if: inputs.platform == 'ros1gazebo'
+      shell: bash
+      run: |
+        # 2023/1/18: You still need install these even after installing stuff
+        # with apt AND if the sysem python matches your current python. I don't
+        # know why.
+        pip3 install empy \
+                     rospkg \
+                     wheel \
+                     pyparsing \
+                     pyqt5 \
+                     pysip \
+                     numpy \
+                     matplotlib \
+                     pyyaml \
+                     psutil \
+                     defusedxml \
+                     pyparsing \
+                     pydev \
+                     pyopengl \
+                     opencv-python \
+                     catkin_tools
+
+    - name: Install SIERRA ROSBridge dependency (ubuntu)
+      if: inputs.platform == 'ros1gazebo'
+      shell: bash
+      run: |
+        source /opt/ros/${{ inputs.rosdistro }}/setup.bash
+
+        git clone https://github.com/jharwell/sierra_rosbridge.git
+        cd sierra_rosbridge
+        git checkout devel
+        catkin init
+        catkin config --extend /opt/ros/${{ inputs.rosdistro }}
+        catkin config --install -DCMAKE_INSTALL_PREFIX=$HOME/.local
+        catkin build
+
+    ############################################################################
+    # ROS1+Robot setup
+    ############################################################################
+
+    # None needed for the moment--stage 1 XML generation only.

{sierra-research-1.3.5 → sierra_research-1.3.11}/.github/actions/sierra-setup/action.yml

@@ -1,45 +1,53 @@
 name: 'Setup SIERRA'
 description: 'Setup SIERRA for CI and testing'
-# inputs:
-  # who-to-greet:  # id of input
-  #   description: 'Who to greet'
-  #   required: true
-  #   default: 'World'
-# outputs:
-#   time: # id of output
-#     description: 'The time we greeted you'
 runs:
   using: 'composite'
   steps:
 
+    ############################################################################
+    # Common setup
+    ############################################################################
+    - name: Setup python (all OSes)
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Install python packages (all OSes)
+      shell: bash
+      run: |
+        python3 -m pip install wheel
+        python3 -m pip install -r docs/requirements.txt
+
+    - uses: kenchan0130/actions-system-info@master
+      id: system-info
+
     ############################################################################
     # Ubuntu setup
     ############################################################################
-    - name: Setup python (ubuntu)
-      uses: actions/setup-python@v4
+    - name: Install+cache system packages (ubuntu)
       if: runner.os == 'Linux'
+      uses: awalsh128/cache-apt-pkgs-action@latest
       with:
-        python-version: ${{ matrix.python-version }}
+        packages: parallel cm-super dvipng pssh ffmpeg xvfb
+        version: ${{ runner.os }}
 
-    - name: Install system deps (ubuntu)
+    # 2024/09/24: Needed because caching + texlive don't play well
+    # together. There IS an "install texlive" action, but that requires manual
+    # specification of all packages needed, and it seem easier to just use the
+    # package manager to recursively pull in everything I would need.
+    - name: Install system packages (redundant, ubuntu)
       if: runner.os == 'Linux'
       shell: bash
       run: |
-        sudo apt-get update
-        sudo apt-get install parallel cm-super texlive-fonts-recommended
-        sudo apt-get install texlive-latex-extra dvipng pssh ffmpeg xvfb
-        python3 -m pip install --upgrade pip
-        python3 -m pip install wheel
+        sudo apt-get install -y texlive-fonts-recommended texlive-latex-extra
 
     ############################################################################
     # OSX setup
     ############################################################################
-
-    - name: Setup python (OSX)
-      uses: actions/setup-python@v4
+    - name: Enable homebrew (OSX)
       if: runner.os == 'macOS'
-      with:
-        python-version: ${{ matrix.python-version }}
+      uses: Homebrew/actions/setup-homebrew@master
 
     - uses: nick-fields/retry@v2
       name: Install system deps (OSX)
@@ -49,14 +57,7 @@ runs:
         max_attempts: 3
         shell: bash
         command: |
-          # 2023/01/16: || true needed because homebrew installation of whatever
-          # dependencies these packages requires manual intervention to fix, and I
-          # don't have a mac.
-          brew update && brew install parallel pssh ffmpeg
-          brew update && brew install --cask mactex
-          brew update && brew install --cask xquartz
-          python -m pip install --upgrade pip
-          python -m pip install wheel
+          brew install parallel pssh
 
     ############################################################################
     # SIERRA install
@@ -64,7 +65,6 @@ runs:
     - name: Install SIERRA
       shell: bash
       run: |
-        python -m pip install -r docs/requirements.txt
         cd docs && make man && cd ..
         python3 -m pip install .
         python3 -m pip install .[devel]

sierra_research-1.3.11/.github/workflows/analysis-top.yml

@@ -0,0 +1,37 @@
+name: Analysis Top-level
+
+# Run:
+#
+# - Every month. Scheduling helps keep drift/issues with updates
+#   to runners at bay.
+# - On pushes.
+on:
+  push:
+    paths:
+      - 'sierra/**'
+
+  schedule:
+    - cron: '0 0 1 * *'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  analyze-ci-ubuntu-2004:
+    uses: ./.github/workflows/analyze-nox.yml
+    secrets: inherit
+    with:
+      os: ubuntu-20.04
+
+  analyze-ci-ubuntu-2204:
+    uses: ./.github/workflows/analyze-nox.yml
+    secrets: inherit
+    with:
+      os: ubuntu-22.04
+
+  analyze-ci-osx:
+    uses: ./.github/workflows/analyze-nox.yml
+    secrets: inherit
+    with:
+      os: macos-13

sierra_research-1.3.11/.github/workflows/analyze-nox.yml

@@ -0,0 +1,47 @@
+name: OS Static Analysis
+
+on:
+  workflow_call:
+    inputs:
+      os:
+        required: True
+        type: string
+
+jobs:
+  nox:
+    runs-on: ${{ inputs.os }}
+    strategy:
+      matrix:
+        os:
+          - ${{ inputs.os }}
+
+        # 2024/08/26: Test the earliest and latest supported version, to speed
+        # up CI.
+        python-version:
+          - 3.8
+          - 3.11
+
+        session:
+          - lint
+          - docs
+          - analyze_pytype
+          - analyze_mypy
+
+        exclude:
+          - python-version: 3.11
+            os: ubuntu-20.04
+
+          - python-version: 3.8
+            os: ubuntu-22.04
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: ./.github/actions/sierra-setup
+      - uses: kenchan0130/actions-system-info@master
+        id: system-info
+
+      - name: Run nox
+        run: |
+          nox \
+            --pythons ${{ matrix.python-version }} \
+            --sessions ${{ matrix.session }}