Skip to content

Workflows

We recommend these typical development recipes and loops.

Create a branch

Powershell
# Get upstream changes
git switch main
git pull

# Create a new branch from main
git switch --create users/__YOU__/__NEW_TOPIC__

# Or update an existing branch
# 1. Switch to your branch
#    git switch users/__YOU__/__EXISTING_TOPIC__
# 2. Rebase or merge
#    A. Replay and resolve your changes on the latest main
#       git rebase origin/main
#    B. Merge and resolve your changes with the latest main
#       git merge origin/main

# Install dependency updates
uv sync

# Run the program
uv run qtpy-datalogger [OPTIONS]

PC dev loop

Monitor the messages sent between sensor nodes and the host
uv run qtpy-datalogger server --observe
Powershell
# ✍️ Save source code changes

# Run the new code
uv run qtpy-datalogger [OPTIONS]

# Run the tests
uv run poe test

# Run the analyzers
uv run poe lint

# Apply the safe analyzer fixes
uv run poe fix

QT Py dev loop

  Connect the QT Py to your workstation with USB

Monitor the messages sent between sensor nodes and the host
uv run qtpy-datalogger server --observe
Monitor the main run loop on the sensor node
uv run qtpy-datalogger connect --port COMxx
Powershell
# ✍️ Save source code changes

# Update the code on the QT Py
uv run qtpy-datalogger equip --newer-files-only

# When changes require new support libraries
uv run qtpy-datalogger equip [--force]

# Run new code
uv run qtpy-datalogger [OPTIONS]

# Run the tests
uv run poe test

# Run the analyzers
uv run poe lint

# Apply the safe analyzer fixes
uv run poe fix

Documentation dev loop

Powershell
# Build the documentation site
uv run poe docs

# Locally serve the documentation site
uv run zensical serve

# Confirm and observe changes in the site
start http://localhost:8000

# ✍️ Save documentation changes