Skip to content

refactor: Enhance Meade command parsing and response handling#291

Merged
andre-stefanov merged 51 commits into
developfrom
feature/meade-parser
May 26, 2026
Merged

refactor: Enhance Meade command parsing and response handling#291
andre-stefanov merged 51 commits into
developfrom
feature/meade-parser

Conversation

@andre-stefanov
Copy link
Copy Markdown
Member

Refactor the Meade command parser and response system for improved organization and maintainability. Introduce new command handlers, enhance unit test coverage, and update documentation to clarify layer responsibilities. This update aims to streamline command processing and ensure robust handling of various Meade commands.

andre-stefanov and others added 26 commits May 15, 2026 22:19
- Introduced MeadeParser.hpp to define enums and structures for parsing Meade commands.
- Implemented parsing functions for various command types including Get, Set, Movement, and more.
- Created unit tests in test_MeadeParser.cpp to validate the parsing logic and ensure correct command classification.
- Added assertions for valid and invalid command inputs, covering all command families and their respective payloads.
- Moved MeadeParser related code into a new 'meade' namespace for better organization.
- Added comprehensive unit tests for MeadeParser functionality, covering various command parsing scenarios.
- Implemented assertions for valid and invalid command parsing, ensuring robustness of the parser.
- Included tests for all command families, including Get, Set, Sync, Movement, Home, Quit, Slew Rate, Focus, and Extra commands.
- Implemented MeadeResponse class for type-safe Meade replies with fixed capacity.
- Defined response shapes using zero-size tag types in the response namespace.
- Created makeResponse overloads for various response shapes.
- Added traits for mapping command kinds to response tags.
- Implemented entry points for responding to different command families.
- Developed unit tests to validate response shapes and command bindings, ensuring correct wire formatting.
- Consolidated response trait mappings into a single primary template `Response<K>`, replacing multiple family-specific templates.
- Updated entry point function from `respondGet<K>` and `respondSet<K>` to a unified `respond<K>`.
- Adjusted macro definitions for binding command kinds to response tags to accommodate the new structure.
- Modified unit tests to reflect changes in response function calls and ensure consistent behavior across all command kinds.
- Removed MeadeGet command parsing and related tests from MeadeParser unit tests.
- Introduced new unit tests for MeadeGet command handling in test_MeadeGetDispatcher.cpp.
- Added comprehensive wire-byte tests for Meade Get-family commands in test_MeadeGet.cpp.
- Updated MeadeResponse tests to remove redundant Get command assertions.
- Ensured all tests maintain coverage for command routing and response formatting.
- Removed the MeadeSetCommandKind enum and associated MeadeSetParseResult structure from MeadeParser.hpp.
- Introduced IMeadeSetHandlers interface for handling Meade Set commands, with methods for each command type.
- Implemented handleMeadeSet function to parse and dispatch Meade Set commands directly, returning a MeadeResponse.
- Updated MeadeResponse to remove bindings related to MeadeSetCommandKind.
- Added unit tests for the new handleMeadeSet functionality, covering various command scenarios and edge cases.
- Removed obsolete unit tests related to the old Meade Set command parsing.
- Implement tests for Meade Focus dispatcher covering commands such as continuous motion, MoveBy, speed settings, GetPosition, SetPosition, GetState, and Stop.
- Add tests for Meade GPS dispatcher to validate GPS acquisition commands and payload handling.
- Create tests for Meade Home dispatcher to verify park, slew-to-home, unpark, and setting Az/Alt home commands.
- Introduce tests for Meade Init dispatcher to ensure proper handling of serial control commands.
- Develop tests for Meade Movement dispatcher to cover slew, tracking, guide pulse, and stepper movement commands.
- Add tests for Meade SetSlewRate dispatcher to validate mapping of slew rates to commands.
- Implement tests for Meade SyncControl dispatcher to check synchronization commands and responses.
- Remove outdated MeadeResponse tests as they are no longer needed.
- Removed #include "core/MeadeResponse.hpp" from multiple unit test files.
- Updated includes to only reference "core/MeadeParser.hpp" where applicable.
@andre-stefanov andre-stefanov requested review from ClutchplateDude and julianneswinoga and removed request for julianneswinoga May 19, 2026 12:49
Comment thread src/core/meade/MeadeParser.cpp
andre-stefanov and others added 9 commits May 25, 2026 20:52
- Changed command handlers (e.g., handleMeadeGps, handleMeadeHome, etc.) to accept a reference to an existing MeadeResponse object instead of returning a new one.
- Updated response writing functions to fill the provided MeadeResponse object, improving memory efficiency.
- Adjusted unit tests to accommodate the new function signatures and ensure proper response handling.
- Renamed response creation functions to fill*Response to better reflect their purpose.
- Replaced Unity test framework with Google Test in all Meade unit test files.
- Updated assertions from Unity style to Google Test style (e.g., TEST_ASSERT_EQUAL_STRING to EXPECT_STREQ).
- Removed unnecessary test registration functions and streamlined test structure.
- Modified main test file to initialize and run all tests using Google Test.
@andre-stefanov andre-stefanov force-pushed the feature/meade-parser branch from 0d3b5e1 to eb154fa Compare May 25, 2026 19:39
Comment thread src/core/meade/MeadeParser.hpp Outdated
Copy link
Copy Markdown
Member

@ClutchplateDude ClutchplateDude left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok, good start to refactoring :-)

@andre-stefanov andre-stefanov merged commit 6b0edcb into develop May 26, 2026
@andre-stefanov andre-stefanov deleted the feature/meade-parser branch May 26, 2026 18:54
@andre-stefanov andre-stefanov restored the feature/meade-parser branch May 27, 2026 05:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants