libreqos-python-workflow

name	libreqos-python-workflow
description	Shared LibreQoS workflow for Python orchestration, scheduler, integrations, and helper scripts under src/. Use when changing LibreQoS.py, scheduler.py, integration*.py, integrationCommon.py, Python helpers, or Python tests around shaping and generated config files.

LibreQoS Python Workflow

Use this skill for Python work under src/.

Scope

• Main Python shaper entrypoint: src/LibreQoS.py
• Scheduler/orchestration: src/scheduler.py
• Shared importer graph/output logic: src/integrationCommon.py
• Importers and helper scripts: src/integration*.py, src/lqTools.py, src/configMigrator.py, src/csvToNetworkJSON.py, src/cidrToHosts.py, src/mikrotikFindIPv6.py
• Python tests: src/test_*.py, src/bakery_integration_test.py, src/testGraph.py

Architecture

• LibreQoS.py is the live shaper/orchestrator. It validates inputs, builds queueing state, coordinates TC/XDP work through liblqos_python, and writes runtime artifacts such as queuingStructure.json, statsByCircuit.json, and statsByParentNode.json.
• scheduler.py runs integrations, applies overrides, updates scheduler status for the Web UI, and triggers full or partial refreshes.
• integrationCommon.py is the shared graph/output layer for integrations and writes network.json and ShapedDevices.csv.
• Python in this repo is operational glue around and installed runtime files, not an isolated app package.