API V2

.clang-format

@@ -0,0 +1,11 @@
+# .clang-format
+Language: Proto
+BasedOnStyle: Google
+
+ColumnLimit: 0
+AlignConsecutiveAssignments: Consecutive
+AlignTrailingComments:
+  Kind: Never
+SpacesBeforeTrailingComments: 1
+IndentWidth: 2
+UseTab: Never

.github/workflows/build.yml

@@ -0,0 +1,75 @@
+name: Build
+on:
+  pull_request:
+  push:
+    branches: [master]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+
+      - name: Tool Dependencies
+        uses: jdx/mise-action/@v2
+
+      - name: Lib Dependencies
+        run: |
+          pip install protobuf
+          pip install setuptools==75.3.4
+          go install github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc@v1.5.1
+          npm ci
+
+      - name: Env Debug Info
+        continue-on-error: true # this is a purely informational step
+        run: |
+          protoc --version      # provided by: mise
+          protolint -v          # provided by: mise
+          go version            # provided by: mise
+          # this line doesn't work, not sure why
+          # which protoc-gen-doc  # provided by: go install ...
+          python --version      # provided by: mise
+          pip --version         # provided by: mise
+          pip list              # provided by: pip install ...
+          node --version        # provided by: mise
+          npm --version         # provided by: mise
+
+      - name: Build JS
+        run: bin/build-js
+
+      - name: Build Arduino
+        run: bin/build-arduino
+
+      - name: Build Python
+        run: bin/build-python
+
+      - name: Build Documentation
+        run: bin/build-docs
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: javascript-wrapper
+          path: ./js_out
+          if-no-files-found: error
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: arduino-wrapper
+          path: ./arduino_out
+          if-no-files-found: error
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-wrapper
+          path: ./python_out
+          if-no-files-found: error
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: documentation
+          path: ./docs_out
+          if-no-files-found: error
+
+      - name: Lint
+        run: bin/lint

.gitignore

@@ -1,7 +1,26 @@
+## WipperSnapper_Protobuf stuff
+
+# submodule
+nanopb/
+
+# npm libs for buf-es
+node_modules/
+
+# built wrapper artifacts
+python_out
+js_out
+arduino_out/
+
+
+## Generic stuff
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
 *$py.class
+.DS_Store
+
+.vscode/
 
 # C extensions
 *.so
@@ -25,8 +44,6 @@ share/python-wheels/
 .installed.cfg
 *.egg
 MANIFEST
-python_out
-js_out
 
 # PyInstaller
 #  Usually these files are written by a python script from a template
@@ -139,4 +156,5 @@ dmypy.json
 # Cython debug symbols
 cython_debug/
 
-.DS_Store
+
+/.vs

.tool-versions

@@ -0,0 +1,5 @@
+nodejs 22
+python 3.13
+protoc 33.0
+protolint 0.56.4
+go 1.25

README.md

@@ -4,7 +4,7 @@ Protocol buffer messages for use with [Adafruit.io WipperSnapper](http://io.adaf
 
 [Documentation](https://adafruit.github.io/Wippersnapper_Protobuf/)
 
-# This code is for research and educational purposes only
+## This code is for research and educational purposes only
 
 We use this repository internally for [Adafruit.io WipperSnapper](http://io.adafruit.com/wippersnapper) and published it here. It is not supported, documented, or guaranteed to work outside of WipperSnapper whatsoever! 
 
@@ -16,7 +16,8 @@ If you would like to request a component or feature to be added into WipperSnapp
 
 This repository includes an automated script for generating the required protocol buffer wrapper messages.
 
-Nanopb header files for Arduino may also be generated by installing `protoc`, cloning this repository, and invoking:
+Nanopb header files for Arduino may also be generated by installing `protoc`, cloning this repository, and invoking 
+
 ```
 git submodule init
 git submodule update

bin/build-arduino

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+# vars
+: ${OUT_PATH=arduino_out}
+
+# move to the directory above this file
+cd "${0%/*}/.."
+
+# include helpful functions
+source "./bin/functions.sh"
+
+clean
+activate_mise
+ensure protoc
+ensure_nanopb_submodule
+
+# invoke protoc for arduino output
+protoc \
+  --plugin=nanopb/generator/protoc-gen-nanopb \
+  --proto_path=./proto/wippersnapper \
+  --proto_path=./nanopb/generator/proto \
+  --nanopb_opt=-I./proto/wippersnapper --nanopb_opt=-t \
+  --nanopb_out=$OUT_PATH \
+  ./proto/wippersnapper/*.proto
+
+completed_message "Arduino"