Joseph Doherty
b330faff03
Make the service build, run, and install on Linux as a first-class target while keeping the Windows Service + Event Log behaviour intact. - Build: drop the hardcoded win-x64 RID — single-file publish now works for any RID. publish.ps1 gains -Rid; new publish.sh for Linux hosts. - Diagnostics: DiagnosticSinkSelector picks the Error+ sink per host — Windows Event Log under the SCM, local syslog under systemd (Serilog.Sinks.SyslogMessages), none for interactive runs. The EventLog truncation helper is extracted so it is testable cross-OS. - Host: Program.cs registers AddSystemd() alongside AddWindowsService(). - Config: a RID-conditioned appsettings template ships Windows or Unix paths; both templates are schema-validated by a test. - Install: systemd unit (Type=exec) plus install.sh / uninstall.sh. Also fixes two cross-platform bugs found while testing: install.ps1 and uninstall.ps1 used New-EventLog / Remove-EventLog (absent in PowerShell 7), and the E2E sim launcher hardcoded Windows venv paths. - Docs updated across README, CLAUDE.md, and docs/ for dual-platform. 413 tests pass on Windows; 374 (all non-simulator) on Linux. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
DL205 Modbus Simulator
Wraps the dl205.json pymodbus profile as a standalone launcher and as an xUnit managed lifecycle.
Manual launch
pwsh tests/sim/run-dl205-sim.ps1 -Port 5020
On first run the script creates a Python venv at tests/sim/.venv and installs:
pymodbus==3.13.0
aiohttp
(pymodbus 3.13.0 does not provide a [server] extra; the simulator is included in
the base package. aiohttp is required by the simulator's HTTP console.)
Re-runs detect the existing venv and skip provisioning (fast path, < 2 s to first packet).
Ctrl-C exits cleanly. The venv directory is gitignored.
Requirements
- Python 3.10+ on
PATH(tested with 3.13). The script also tries the Windowspylauncher. - Network access for first-run venv provisioning. Subsequent runs are fully offline.
Parameters
| Parameter | Default | Description |
|---|---|---|
-Profile |
dl205.json |
pymodbus JSON device profile |
-Port |
5020 |
TCP port the Modbus server binds |
xUnit integration
Test classes that need a live simulator declare:
[Collection(nameof(DL205SimulatorCollection))]
The DL205SimulatorFixture (in tests/Mbproxy.Tests/Sim/) spawns run-dl205-sim.ps1 via pwsh -NoProfile -File, polls for a TCP connection within 10 s, and exposes Host, Port, and LogTail. If Python is unavailable, SkipReason is populated and every test in the collection skips cleanly rather than failing.
Version pin
pymodbus[server]==3.13.0 — update this README and run-dl205-sim.ps1 together when re-pinning.