Release v5.3

commschamp · Jan 11, 2025 · 87497f3 · 87497f3
2 parents e7394d2 + c932a1f
commit 87497f3
Show file tree

Hide file tree

Showing 189 changed files with 946 additions and 388 deletions.
diff --git a/.github/workflows/actions_build.yml b/.github/workflows/actions_build.yml
@@ -1,6 +1,11 @@
 name: Github Actions Build
 
-on: [push]
+on:
+  push:
+    branches:
+      - '**'
+    tags-ignore:
+      - '**'
 
 jobs:
 

diff --git a/doxygen/page_prot_stack.dox b/doxygen/page_prot_stack.dox
diff --git a/doxygen/page_use_prot.dox b/doxygen/page_use_prot.dox
@@ -84,6 +84,7 @@
 /// {
 ///     
 /// class Message : public comms::Message
+/// {
 ///     // comms::Field class with the same endian option. 
 ///     // Can (and should) be provided as a base class to all the
 ///     // fields.
@@ -2232,11 +2233,10 @@
 /// template <
 ///     typename TMessage, // common interface class defined by the application
 ///     typename TInputMessages = AllMessages<TMessage>, // Input messages that need to be recognised
-///     typename TAllocationOptions = comms::option::app::EmptyOption, // Extra options for comms::protocol::MsgIdLayer
-///     typename TPayloadOptions = comms::option::app::EmptyOption // Extra options for payload storage
+///     typename TAllocationOptions = comms::option::app::EmptyOption // Extra options for comms::protocol::MsgIdLayer
 /// >
 /// struct ProtocolStack : public 
-///     MySyncPrefix<TMessage, TInputMessages, TAllocationOptions, TPayloadOptions> 
+///     MySyncPrefix<TMessage, TInputMessages, TAllocationOptions> 
 /// {
 ///     COMMS_PROTOCOL_LAYERS_ACCESS(...);
 /// };
@@ -2259,16 +2259,12 @@
 /// possible to modify such behaviour by using @ref comms::option::app::InPlaceAllocation
 /// option. It will be explained in more details further below.
 ///
-/// The fourth template parameter (@b TPayloadOptions) is irrelevant in
-/// most cases. It has a meaning only when transport wrapping values are cached
-/// for further analysis. It will also be explained in more details further below.
-///
 /// @b NOTE, that @b ProtocolStack definition is actually an alias to one
 /// of the classes from @ref comms::protocol namespace. To get a detailed
 /// information on available public API please reference to one of them, for
 /// example @ref comms::protocol::SyncPrefixLayer.
 ///
-/// It may also happen, that the extra options (@b TAllocationOptions and @b TPayloadOptions)
+/// It may also happen, that the extra options (@b TAllocationOptions)
 /// are defined inside the recommended @b DefaultOptions structure and be
 /// passed to the layers definitions themselves. Such approach is undertaken by
 /// the **commsdsl2comms** code generator application from the 
@@ -2565,8 +2561,7 @@
 /// The layer class that is responsible to read/write payload data 
 /// (see @ref comms::protocol::MsgDataLayer) uses @ref comms::field::ArrayList
 /// to define a field that will store the payload when "caching" operations are
-/// performed. That's where the fourth template parameter (@b TPayloadOptions)
-/// to @b ProtocolStack definition comes in play. 
+/// performed. 
 /// In case the the input / output buffer outlives the @b AllFields
 /// object, consider passing @ref comms::option::app::OrigDataView option as the
 /// fourth template parameter to @b ProtocolStack definition, which will pass it to
@@ -2588,11 +2583,10 @@
 /// template <
 ///     typename TMessage, // common interface class defined by the application
 ///     typename TInputMessages = AllMessages<TMessage>, // Input messages that need to be recognised
-///     typename TAllocationOptions = comms::option::app::EmptyOption, // Extra options for MsgIdLayer
-///     typename TPayloadOptions = comms::option::app::EmptyOption // Extra options for payload storage
+///     typename TAllocationOptions = comms::option::app::EmptyOption // Extra options for MsgIdLayer
 /// >
 /// struct ProtocolStack : public 
-///     MySyncPrefix<TMessage, TInputMessages, TAllocationOptions, TPayloadOptions> 
+///     MySyncPrefix<TMessage, TInputMessages, TAllocationOptions> 
 /// {
 ///     COMMS_PROTOCOL_LAYERS_ACCESS(payload, id, size, checksum, sync);
 /// };
@@ -2606,11 +2600,10 @@
 /// template <
 ///     typename TMessage, // common interface class defined by the application
 ///     typename TInputMessages = AllMessages<TMessage>, // Input messages that need to be recognised
-///     typename TAllocationOptions = comms::option::app::EmptyOption, // Extra options for MsgIdLayer
-///     typename TPayloadOptions = comms::option::app::EmptyOption // Extra options for payload storage
+///     typename TAllocationOptions = comms::option::app::EmptyOption // Extra options for MsgIdLayer
 /// >
 /// struct ProtocolStack : public 
-///     MySyncPrefix<TMessage, TInputMessages, TAllocationOptions, TPayloadOptions> 
+///     MySyncPrefix<TMessage, TInputMessages, TAllocationOptions> 
 /// {
 ///     // Access to PAYLOAD layer
 ///     decltype(auto) layer_payload();
@@ -3131,11 +3124,10 @@
 /// template <
 ///     typename TMessage, // common interface class defined by the application
 ///     typename TInputMessages = AllMessages<TMessage>, // Input messages that need to be recognised
-///     typename TAllocationOptions = comms::option::app::EmptyOption, // Extra options for MsgIdLayer
-///     typename TPayloadOptions = comms::option::app::EmptyOption // Extra options for payload storage
+///     typename TAllocationOptions = comms::option::app::EmptyOption // Extra options for MsgIdLayer
 /// >
 /// struct ProtocolStack : public 
-///     MySizePrefix<TMessage, TInputMessages, TAllocationOptions, TPayloadOptions> 
+///     MySizePrefix<TMessage, TInputMessages, TAllocationOptions> 
 /// {
 ///     COMMS_PROTOCOL_LAYERS_ACCESS(payload, version, id, size);
 /// };

diff --git a/include/comms/Assert.h b/include/comms/Assert.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/CompileControl.h b/include/comms/CompileControl.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/EmptyHandler.h b/include/comms/EmptyHandler.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/ErrorStatus.h b/include/comms/ErrorStatus.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/Field.h b/include/comms/Field.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
@@ -111,6 +111,13 @@ class Field : public details::FieldBase<TOptions...>
         return false;
     }
 
+    /// @brief Check of whether the field class defines @b name() function
+    /// @return Always @b false
+    static constexpr bool hasName()
+    {
+        return false;
+    }     
+
 protected:
     /// @brief Write data into the output buffer.
     /// @details Use this function to write data to the the buffer

diff --git a/include/comms/GenericHandler.h b/include/comms/GenericHandler.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/GenericMessage.h b/include/comms/GenericMessage.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2017 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2017 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/Message.h b/include/comms/Message.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/MessageBase.h b/include/comms/MessageBase.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/MsgDispatcher.h b/include/comms/MsgDispatcher.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/MsgFactory.h b/include/comms/MsgFactory.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/MsgFactoryCreateFailureReason.h b/include/comms/MsgFactoryCreateFailureReason.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2022 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2022 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/cast.h b/include/comms/cast.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/comms.h b/include/comms/comms.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2014 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2014 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
@@ -28,6 +28,7 @@
 #include "comms/MsgDispatcher.h"
 #include "comms/GenericMessage.h"
 
-#include "comms/util/detect.h"
 #include "comms/util/assign.h"
+#include "comms/util/construct.h"
+#include "comms/util/detect.h"
 #include "comms/util/type_traits.h"
diff --git a/include/comms/details/DispatchMsgHelperType.h b/include/comms/details/DispatchMsgHelperType.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2020 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2020 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/DispatchMsgIdRetrieveHelper.h b/include/comms/details/DispatchMsgIdRetrieveHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/DispatchMsgLinearSwitchHelper.h b/include/comms/details/DispatchMsgLinearSwitchHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/DispatchMsgPolymorphicHelper.h b/include/comms/details/DispatchMsgPolymorphicHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/DispatchMsgStaticBinSearchHelper.h b/include/comms/details/DispatchMsgStaticBinSearchHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/FieldBase.h b/include/comms/details/FieldBase.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/FieldCastHelper.h b/include/comms/details/FieldCastHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageIdTypeRetriever.h b/include/comms/details/MessageIdTypeRetriever.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageImplBases.h b/include/comms/details/MessageImplBases.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageImplBuilder.h b/include/comms/details/MessageImplBuilder.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageImplOptionsParser.h b/include/comms/details/MessageImplOptionsParser.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageInterfaceBases.h b/include/comms/details/MessageInterfaceBases.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageInterfaceBuilder.h b/include/comms/details/MessageInterfaceBuilder.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MessageInterfaceOptionsParser.h b/include/comms/details/MessageInterfaceOptionsParser.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2015 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2015 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MsgDispatcherOptionsParser.h b/include/comms/details/MsgDispatcherOptionsParser.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MsgFactoryBase.h b/include/comms/details/MsgFactoryBase.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2017 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2017 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/MsgFactoryOptionsParser.h b/include/comms/details/MsgFactoryOptionsParser.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2017 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2017 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/ReadIteratorHelper.h b/include/comms/details/ReadIteratorHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/ValueAssignWrapper.h b/include/comms/details/ValueAssignWrapper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/WriteIteratorHelper.h b/include/comms/details/WriteIteratorHelper.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/base_detection.h b/include/comms/details/base_detection.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2017 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2017 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/bits_access.h b/include/comms/details/bits_access.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2016 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2016 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/detect.h b/include/comms/details/detect.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2017 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2017 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this

diff --git a/include/comms/details/dispatch_impl.h b/include/comms/details/dispatch_impl.h
@@ -1,5 +1,5 @@
 //
-// Copyright 2019 - 2024 (C). Alex Robenko. All rights reserved.
+// Copyright 2019 - 2025 (C). Alex Robenko. All rights reserved.
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this