56 lines
2.4 KiB
Markdown
56 lines
2.4 KiB
Markdown
# Repository snapshot: 2026-09-29 r4
|
|
|
|
This repository contains the tested r4 source baseline, tests, packaging scripts,
|
|
project documentation, and the two verified x86 status/probe bridge executables.
|
|
The Verify execution logic is unchanged by this Git import.
|
|
|
|
## Reproduce source tests on Windows
|
|
|
|
Use Python 3.12 and install the project and developer test dependencies:
|
|
|
|
```powershell
|
|
python -m pip install -e .
|
|
python -m pip install pytest pytest-qt
|
|
python -m pytest -q
|
|
python -m compileall -q src tests
|
|
```
|
|
|
|
For an isolated checkout, set `$env:PYTHONPATH = (Resolve-Path ./src).Path` so
|
|
test subprocesses import that checkout rather than another editable installation.
|
|
The repository's `.gitattributes` preserves CRLF (`* -text`); use
|
|
`git -c core.whitespace=cr-at-eol diff --check` to check whitespace in a clean
|
|
clone without reporting the preserved CR bytes as trailing whitespace.
|
|
|
|
The source import was verified with 336 pytest cases. Tests use fake local files
|
|
and replace the production Mentor COM/process boundary where required; they do
|
|
not establish field success against a live network library.
|
|
|
|
The legacy PowerShell fixture-based tests refer to real Mentor sample libraries.
|
|
Those local samples are intentionally excluded from Git; do not substitute them
|
|
with production projects merely to run a smoke test.
|
|
|
|
## Build the Windows package
|
|
|
|
Install PyInstaller, then use the existing packaging entrypoint:
|
|
|
|
```powershell
|
|
python -m pip install pyinstaller
|
|
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\packaging\Build-CbbRefreshVerify.ps1 -OutputDirectory dist
|
|
```
|
|
|
|
Runtime Mentor EE7.9.5EE, licensing and network-library access are supplied by the
|
|
field machine, not by this repository. The optional sibling replacement-tool
|
|
logging package is not committed here; the application has a standalone logging
|
|
fallback. Building the x86 C++ bridges from source requires the MSVC/MFC toolchain
|
|
described in tools/status_bridge/README.md; prebuilt tested bridges are included.
|
|
|
|
## Excluded local artifacts
|
|
|
|
Raw field logs, captured evidence, actual Mentor sample libraries/projects,
|
|
transient data, compiler caches, source backups and packaged distributions are
|
|
ignored. Existing local files are preserved; ignoring them is not deletion.
|
|
|
|
The tested package manifest and field-test instructions are retained in
|
|
`docs/releases`. The Windows installation ZIP remains a separate build artifact,
|
|
not a Git source file. No secrets or credentials are written into this repository.
|