Add necessary content for circup packaging

Author: malcolm-sparkfun

.github/workflows/build.yml

@@ -0,0 +1,28 @@
+name: Build CI
+
+on: [pull_request, push]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Set up Python 3
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.x
+    - name: Versions
+      run: |
+        python3 --version
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+    - name: Fetch correct submodule shas
+      run: git submodule foreach 'git fetch --tags --depth 1 origin $sha1 && git checkout -q $sha1'
+    - name: Install deps
+      run: |
+        sudo apt-get install -y gettext gawk
+        pip install -r requirements.txt
+    - name: Library version
+      run: git describe --dirty --always --tags
+    - name: Build assets
+      run: ./build.sh

.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release Actions
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  upload-release-assets:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Translate Repo Name For Build Tools filename_prefix
+      id: repo-name
+      run: |
+        echo "repo-name=$(
+        echo ${{ github.repository }} |
+        awk -F '\/' '{ print tolower($2) }' |
+        tr '_' '-'
+        )" >> $GITHUB_OUTPUT
+    - name: Set up Python 3
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.x
+    - name: Versions
+      run: |
+        python3 --version
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+    - name: Fetch correct submodule shas
+      run: git submodule foreach 'git fetch --tags --depth 1 origin $sha1 && git checkout -q $sha1'
+    - name: Install deps
+      run: |
+        sudo apt-get install -y gettext gawk
+        pip install -r requirements.txt
+    - name: Build assets
+      run: circuitpython-build-bundles --filename_prefix ${{ steps.repo-name.outputs.repo-name }} --library_location qwiic/drivers --library_depth 1 --package_folder_prefix "Qwiic, qwiic, Pi"
+    - name: Upload Release Assets
+      uses: shogo82148/actions-upload-release-asset@v1
+      with:
+        asset_path: "bundles/*"
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        upload_url: ${{ github.event.release.upload_url }}

README.txt

@@ -0,0 +1,4 @@
+This README pertains to the CircuitPython bundle generated by the SparkFun Qwiic_Py repository.
+
+
+TODO: flesh out circuitpython details

build.sh

@@ -0,0 +1,33 @@
+#! /bin/bash
+
+# The MIT License (MIT)
+#
+# Copyright (c) 2021 Scott Shawcroft for Adafruit Industries
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+# This script builds the bundle
+
+set -e
+
+# This script gets executed in "test" steps for non-release builds. See the "Build assets" step in release.yml for the build of actual release artifacts
+# Gather the package submods that are supported in CircuitPython and create a comma-separated string to pass to circuitpython-build-bundles
+# CIRCUP_DIRS="$(paste -sd ',' circuitpython_support.txt | sed 's/,/, /g')"
+# echo "FOUND CIRCUP DIRS: ${CIRCUP_DIRS}"
+circuitpython-build-bundles --filename_prefix qwiic-py --library_location qwiic/drivers --library_depth 1 --package_folder_prefix "Qwiic, qwiic, Pi"

requirements.txt

@@ -0,0 +1,2 @@
+circuitpython-build-tools
+setuptools

update-submodules.sh

@@ -0,0 +1,28 @@
+#! /bin/bash
+
+# The MIT License (MIT)
+#
+# Copyright (c) 2016 Scott Shawcroft for Adafruit Industries
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+# This script updates all submodules to the latest tag (hopefully release).
+git submodule update
+git submodule foreach git fetch
+git submodule foreach "tag=\$(git rev-list --tags --max-count=1); git checkout -q \$tag"