Combined p1_capture, p1_filter, and p1_print utilities.

.github/workflows/release_build.yml

@@ -318,6 +318,7 @@ jobs:
         gzip fusion-engine-client-docs.tar
 
     - name: Upload Artifact
+      if: ${{ !env.ACT }}
       uses: actions/upload-artifact@v4
       with:
         name: fusion-engine-client-docs.tar.gz
@@ -327,36 +328,51 @@ jobs:
   test_python:
     name: Python Unit Tests
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13']
     defaults:
       run:
         working-directory: python
     steps:
     - uses: actions/checkout@v2
 
     - name: Setup Python
-      uses: actions/setup-python@v2
+      if: ${{ !env.ACT }}
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.x'
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+        cache-dependency-path: |
+          python/requirements.txt
+          python/requirements-dev.txt
+
+    - name: Setup Python (local)
+      if: ${{ env.ACT }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
 
     - name: Install Python Requirements
       run: |
-        pip install -r requirements.txt
-        pip install pytest
+        pip install -r requirements.txt -r requirements-dev.txt
 
     - name: Run Unit Tests
       run: |
         python -m pytest
 
     - name: Build A Python Distribution
+      if: ${{ !env.ACT }}
       run: |
         pip install build twine
         python -m build
         twine check dist/*
 
     - name: Upload Artifact
+      if: ${{ !env.ACT }}
       uses: actions/upload-artifact@v4
       with:
-        name: python_dist
+        name: python_dist-${{ matrix.python-version }}
         path: python/dist
 
   # Check autogenerated signal definitions.
@@ -370,7 +386,7 @@ jobs:
     - uses: actions/checkout@v2
 
     - name: Setup Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
         python-version: '3.x'
 

.gitignore

@@ -19,6 +19,9 @@ venv*/
 .vscode
 *.code-workspace
 
+# AI settings.
+.claude/
+
 # P1 binary files.
 *.p1bin
 *.p1log

python/README.md

@@ -18,23 +18,24 @@ FusionEngine message specification.
 
 ### Requirements
 
-- Python 3.6 or later
+- Python 3.8 or later
 
 ### Applications
 
 - [p1_capture](fusion_engine_client/applications/p1_capture.py) - Connect to a FusionEngine device in real time over
-  serial, TCP, UDP, or UNIX domain socket, and display incoming FusionEngine contents and/or log the incoming data to
-  disk
+  serial, TCP, UDP, WebSocket, or UNIX domain socket, or read from a file or log on disk. Display a summary of the
+  FusionEngine messages in the data stream or their contents, and optionally logs data to disk.
+  - Messages can be filtered by type or time.
+  - Supports stdin/stdout for inline data filtering via pipe.
+  - Supports extracting sensor or RTK corrections data from diagnostic FusionEngine `InputDataWrapper` messages.
 - [p1_display](fusion_engine_client/applications/p1_display.py) - Generate plots of vehicle trajectory, GNSS signal
-  status, wheel speed measurements, etc. from a file of logged FusionEngine messages
+  status, wheel speed measurements, etc. from a file of logged FusionEngine messages.
 - [p1_extract](fusion_engine_client/applications/p1_extract.py) - Extract FusionEngine messages from a binary file
-  containing multiple data streams (e.g., interleaved RTCM and FusionEngine messages)
-- [p1_filter](fusion_engine_client/applications/p1_filter.py) - Filter an incoming FusionEngine data stream, outputting
-  a new FusionEngine stream containing only the requested messages
+  containing multiple data streams (e.g., interleaved RTCM and FusionEngine messages).
+- [p1_filter](fusion_engine_client/applications/p1_filter.py) - Legacy alias for `p1_capture`
 - [p1_lband_extract](fusion_engine_client/applications/p1_lband_extract.py) - Extract L-band data bits contained from a
   log of FusionEngine `LBandFrameMessage` messages
-- [p1_print](fusion_engine_client/applications/p1_print.py) - Print the contents of FusionEngine messages found in a
-  binary file to the console
+- [p1_print](fusion_engine_client/applications/p1_print.py) - Legacy alias for `p1_capture`.
 
 ### Directory Structure
   - `python/` - Python source files
@@ -100,7 +101,7 @@ FusionEngine message specification.
 
 #### Install From PyPI
 
-1. Install Python (3.6 or later) and pip.
+1. Install Python (3.8 or later) and pip.
 2. Install the `fusione-engine-client` module, including all analysis and data processing tools:
    ```bash
    python3 -m pip install fusion-engine-client
@@ -121,7 +122,7 @@ FusionEngine message specification.
 
 #### Install From Source (Use In Another Python Project)
 
-1. Install Python (3.6 or later) and pip.
+1. Install Python (3.8 or later) and pip.
 2. Clone a copy of this repository:
    ```bash
    git clone https://github.com/PointOneNav/fusion-engine-client.git
@@ -149,7 +150,7 @@ FusionEngine message specification.
 
 #### Install From Source (Development)
 
-1. Install Python (3.6 or later) and pip.
+1. Install Python (3.8 or later) and pip.
 2. Clone a copy of this repository:
    ```bash
    git clone https://github.com/PointOneNav/fusion-engine-client.git