Lab 5: NetArchTest dependency and naming rules#22
Open
nik-bykoff wants to merge 6 commits intolenagrin:masterfrom
Open
Lab 5: NetArchTest dependency and naming rules#22nik-bykoff wants to merge 6 commits intolenagrin:masterfrom
nik-bykoff wants to merge 6 commits intolenagrin:masterfrom
Conversation
- Move SONAR_PROJECT_KEY/SONAR_ORGANIZATION into workflow env block with explicit setup instructions for fork-based usage. - Update README with student header, fork/upstream links and a table of all eight lab reports. - Replace SonarCloud badges with placeholders for nik-bykoff fork. - Add docs/labs/lab-01.md report describing manual SonarCloud steps, CI workflow layout and verification checklist. - Ignore local .env files to prevent accidental token leaks.
- Rename NetSdrClient.Disconect to Disconnect (typo) and update callers/tests. - Remove stray semicolon in StartIQAsync and unused JSType using-statics. - Make responseTaskSource thread-safe via Interlocked.Exchange + TrySetResult. - Replace Aggregate-on-empty-may-throw log formatting with string.Join in three places. - Rewrite GetSamples from O(n^2) IEnumerable.Count loop to O(n) for-loop with reusable byte[4] buffer. - Replace MD5-based UdpClientWrapper.GetHashCode with HashCode.Combine and add Equals override. - Make TcpClientWrapper._cts nullable, mark _host/_port readonly, drop unused exception variable names. - All eight existing unit tests still pass; compiler warnings dropped from 18 to 15 (rest are EchoTcpServer or NuGet).
- Add coverlet.msbuild to NetSdrClientAppTests with PrivateAssets=all. - Add four NetSdrClient tests (ChangeFrequency, idempotent IQ flag, listener startup, no-op when disconnected). - Add six NetSdrMessageHelper tests covering control-item/data-item roundtrip and GetSamples edge cases (8/16 bit, empty body, oversized width). - Fix latent bug in TranslateMessage where Enum.IsDefined was called with ushort while ControlItemCodes underlying type is int. - Re-enable Tests with coverage step in CI workflow with opencover output and Program exclusion. - 18/18 tests passing locally; coverage of NetSdrClientApp module: line 45.86%, branch 26.92%, method 48.48%.
- Add internal HexFormatter.ToSpaceSeparatedHex used by TCP send log, TCP receive log and UDP samples log. - Replace TcpClientWrapper.SendMessageAsync(byte[]) and SendMessageAsync(string) overloads with thin wrappers around private SendCoreAsync(byte[]). - Collapse identical UdpClientWrapper.StopListening and Exit into StopCore via thin delegating wrappers. - 18/18 tests still pass; behavior unchanged.
- Add NetSdrClient.ArchTests project (NUnit + NetArchTest.Rules 1.3.2) with reference to NetSdrClientApp.
- Encode four architecture rules:
* Messages namespace must not depend on Networking.
* Networking namespace must not depend on Messages.
* Interfaces in Networking namespace start with I.
* Wrapper classes in Networking namespace are sealed.
- Run is intentionally red on this commit (TcpClientWrapper is not sealed) to demonstrate ArchTest catching a real violation; the green fix follows in the next commit.
- Mark TcpClientWrapper and UdpClientWrapper as sealed to satisfy NetworkingWrappers_ShouldBeSealed. - Move UdpClientWrapper and IUdpClient into the NetSdrClientApp.Networking namespace so they are scoped by the architectural rules. - All four ArchTests now pass; existing 18 unit tests remain green. - Adds docs/labs/lab-05.md describing the red-then-green CI demo.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Encode architectural conventions as executable tests. PR has two commits on purpose:
Lab 5 (red)introducesNetSdrClient.ArchTests(NUnit +NetArchTest.Rules1.3.2) with four rules. CI is intentionally red:NetworkingWrappers_ShouldBeSealedflagsTcpClientWrapper.Lab 5 (green)sealsTcpClientWrapperandUdpClientWrapperand movesUdpClientWrapper/IUdpClientinto theNetSdrClientApp.Networkingnamespace so they are in scope of the rules. CI turns green again.Architecture rules
Messages_ShouldNotDependOn_NetworkingNetSdrClientApp.Messages) cannot reference transport.Networking_ShouldNotDependOn_MessagesInterfaces_InNetworking_ShouldStartWithII*interface naming convention.NetworkingWrappers_ShouldBeSealed*Wrappertypes in transport are sealed.Why two commits
The lab explicitly asks to demonstrate that ArchTest catches a real violation (red CI), then is fixed (green CI). Final state of the PR is green; both runs are visible in the Actions tab.
Test plan
dotnet test NetSdrClient.ArchTests/...reports 4/4 passing onlab-05-arch-rulesHEAD.dotnet test NetSdrClient.sln -c Releasereports 18 unit tests + 4 arch tests all passing.Discipline / Author