fe2a6db786
rust / build / test / clippy / fmt (push) Has been cancelled
Layout:
- src/ .NET 10 x64 reference: MxNativeCodec, MxNativeClient,
MxAsbClient, probes, tests, harnesses. Executable spec.
- design/ Architectural plan for the Rust port (M0–M6), error
model, protocol invariants, risks (R1–R16), adversarial
review log (review.md).
- rust/ Rust workspace. M0 skeleton + M1 codec parity.
mxaccess-codec: 215 unit tests + 2 cross-implementation
parity tests (byte-identical against .NET reference).
Other crates are M0 stubs awaiting M2+.
- captures/ Frida + netsh + pcap evidence per CLAUDE.md
("captures are evidence, not throwaway logs").
- analysis/ Decompiled C# (frida/proxy/decompiled-*),
Ghidra exports for native DLLs (`exports/` only —
working state at `projects/` and AVEVA's input
binaries at `input/` are gitignored).
- docs/ Reverse-engineering reference docs.
- tools/ Setup-LiveProbeEnv.ps1 (Infisical credential fetcher),
Compute-Crc.ps1 (.NET parity helper).
- .github/workflows/ Rust CI: fmt + build + test + clippy on Windows.
- LICENSE MIT (Joseph Doherty, 2026).
Verified:
- cargo test --workspace → 217 passed (215 unit + 2 .NET parity), 0 failed
- cargo clippy --workspace -- -D warnings → clean
- cargo fmt --all -- --check → clean
- cargo publish --dry-run -p mxaccess-codec → packages cleanly
Excluded from history (see .gitignore):
- **/bin, **/obj, **/target — build artifacts
- analysis/ghidra/projects/ — Ghidra working state (regenerable)
- analysis/ghidra/input/ — AVEVA proprietary DLLs (vendor IP)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
83 lines
2.1 KiB
C#
83 lines
2.1 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using System.ComponentModel;
|
|
using System.Globalization;
|
|
using System.Linq;
|
|
using System.Runtime.InteropServices;
|
|
|
|
namespace ArchestrAServices.Common;
|
|
|
|
public static class ThrowHelper
|
|
{
|
|
[AttributeUsage(AttributeTargets.Parameter)]
|
|
private sealed class ValidatedNotNullAttribute : Attribute
|
|
{
|
|
}
|
|
|
|
public static void ThrowIfArgumentNull<T>([ValidatedNotNull] T argument, string argumentName) where T : class
|
|
{
|
|
if (argument == null)
|
|
{
|
|
throw new ArgumentNullException(argumentName);
|
|
}
|
|
}
|
|
|
|
public static void ThrowIfArgumentNullOrEmpty<T>([ValidatedNotNull] IEnumerable<T> argument, string argumentName)
|
|
{
|
|
if (argument == null)
|
|
{
|
|
throw new ArgumentNullException(argumentName);
|
|
}
|
|
if (!argument.Any())
|
|
{
|
|
throw new ArgumentException("Value must not be empty.", argumentName);
|
|
}
|
|
}
|
|
|
|
public static void ThrowIfArgumentNullOrWhiteSpace([ValidatedNotNull] string argument, string argumentName)
|
|
{
|
|
if (argument == null)
|
|
{
|
|
throw new ArgumentNullException(argumentName);
|
|
}
|
|
if (string.IsNullOrWhiteSpace(argument))
|
|
{
|
|
throw new ArgumentException("Value must not be empty or only whitespace.", argumentName);
|
|
}
|
|
}
|
|
|
|
public static void ThrowIfArgumentOutOfRange(bool outOfRange, string argumentName)
|
|
{
|
|
if (outOfRange)
|
|
{
|
|
throw new ArgumentOutOfRangeException(argumentName, "Value out of range.");
|
|
}
|
|
}
|
|
|
|
public static void ThrowArgumentException(bool invalid, string argumentName, [Localizable(false)] string message)
|
|
{
|
|
if (invalid)
|
|
{
|
|
throw new ArgumentException(message, argumentName);
|
|
}
|
|
}
|
|
|
|
public static void ThrowInvalidOperation([Localizable(false)] string message)
|
|
{
|
|
throw new InvalidOperationException(message);
|
|
}
|
|
|
|
public static void ThrowIfServiceIsNull<T>([ValidatedNotNull] T service) where T : class
|
|
{
|
|
if (service == null)
|
|
{
|
|
throw new InvalidOperationException(string.Format(CultureInfo.InvariantCulture, "Service {0} is not available", new object[1] { typeof(T).FullName }));
|
|
}
|
|
}
|
|
|
|
public static void ThrowIfHResultError(int code)
|
|
{
|
|
Marshal.ThrowExceptionForHR(code);
|
|
}
|
|
}
|