Add RPC interfaces, exceptions, and example (#233)

* Refs #23079. Add rpc interfaces to python bindings.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Add rpc exceptions to python bindings.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Add calculator IDL and example python code.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Generate code with fastddsgen.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Build new example.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Add new example to regeneration script.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Move generated code to a different folder.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Add readme for RPC example.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

* Refs #23079. Move HelloWorld generated code to a different folder.

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

---------

Signed-off-by: Miguel Company <miguelcompany@eprosima.com>

Author: MiguelCompany

fastdds_python/src/swig/fastdds.i

@@ -241,3 +241,5 @@ namespace xtypes {
 %include "fastdds/dds/domain/DomainParticipant.i"
 %include "fastdds/dds/domain/DomainParticipantFactory.i"
 %include "fastdds/dds/xtypes/type_representation/TypeObject.i"
+%include "fastdds/dds/rpc/interfaces.i"
+%include "fastdds/dds/rpc/exceptions.i"

fastdds_python/src/swig/fastdds/dds/rpc/exceptions.i

@@ -0,0 +1,34 @@
+// Copyright 2025 Proyectos y Sistemas de Mantenimiento SL (eProsima).
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+%{
+#include "fastdds/dds/rpc/exceptions.hpp"
+%}
+
+// Base class should be included first
+%include "fastdds/dds/rpc/exceptions/RpcException.hpp"
+// Include first level inheritance
+%include "fastdds/dds/rpc/exceptions/RpcBrokenPipeException.hpp"
+%include "fastdds/dds/rpc/exceptions/RpcFeedCancelledException.hpp"
+%include "fastdds/dds/rpc/exceptions/RpcOperationError.hpp"
+%include "fastdds/dds/rpc/exceptions/RpcTimeoutException.hpp"
+// This is the base class for second level inheritance
+%include "fastdds/dds/rpc/RemoteExceptionCode_t.hpp"
+%include "fastdds/dds/rpc/exceptions/RpcRemoteException.hpp"
+// Include second level inheritance
+%include "fastdds/dds/rpc/exceptions/RemoteInvalidArgumentError.hpp"
+%include "fastdds/dds/rpc/exceptions/RemoteOutOfResourcesError.hpp"
+%include "fastdds/dds/rpc/exceptions/RemoteUnknownExceptionError.hpp"
+%include "fastdds/dds/rpc/exceptions/RemoteUnknownOperationError.hpp"
+%include "fastdds/dds/rpc/exceptions/RemoteUnsupportedError.hpp"

fastdds_python/src/swig/fastdds/dds/rpc/interfaces.i

@@ -0,0 +1,19 @@
+// Copyright 2025 Proyectos y Sistemas de Mantenimiento SL (eProsima).
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+%{
+#include "fastdds/dds/rpc/interfaces.hpp"
+%}
+
+%include "fastdds/dds/rpc/interfaces/RpcStatusCode.hpp"

fastdds_python_examples/CMakeLists.txt

@@ -20,4 +20,5 @@ project(FastDdsPythonExamples)
 # Examples subdirectory
 ###############################################################################
 
-add_subdirectory(HelloWorldExample)
+add_subdirectory(HelloWorldExample/generated_code)
+add_subdirectory(RPCExample/generated_code)

…xamples/HelloWorldExample/CMakeLists.txt …rldExample/generated_code/CMakeLists.txtfastdds_python_examples/HelloWorldExample/CMakeLists.txt renamed to fastdds_python_examples/HelloWorldExample/generated_code/CMakeLists.txt fastdds_python_examples/HelloWorldExample/CMakeLists.txt renamed to fastdds_python_examples/HelloWorldExample/generated_code/CMakeLists.txt

@@ -1,4 +1,18 @@
 
+# Copyright 2025 Proyectos y Sistemas de Mantenimiento SL (eProsima).
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
 cmake_minimum_required(VERSION 3.20)
 
 # SWIG: use standard target name.
@@ -69,7 +83,7 @@ set(${PROJECT_NAME}_MODULE
     )
 
 set(${PROJECT_NAME}_MODULE_FILES
-    ${PROJECT_NAME}.i
+    HelloWorld.i
     )
 
 SET_SOURCE_FILES_PROPERTIES(

…xamples/HelloWorldExample/HelloWorld.hpp …rldExample/generated_code/HelloWorld.hppfastdds_python_examples/HelloWorldExample/HelloWorld.hpp renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorld.hpp fastdds_python_examples/HelloWorldExample/HelloWorld.hpp renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorld.hpp

@@ -16,7 +16,7 @@
  * @file HelloWorld.hpp
  * This header file contains the declaration of the described types in the IDL file.
  *
- * This file was generated by the tool fastddsgen.
+ * This file was generated by the tool fastddsgen (version: 4.1.0).
  */
 
 #ifndef FAST_DDS_GENERATED__HELLOWORLD_HPP

…_examples/HelloWorldExample/HelloWorld.i …WorldExample/generated_code/HelloWorld.ifastdds_python_examples/HelloWorldExample/HelloWorld.i renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorld.i fastdds_python_examples/HelloWorldExample/HelloWorld.i renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorld.i

@@ -16,7 +16,7 @@
  * @file HelloWorld.i
  * This header file contains the SWIG interface of the described types in the IDL file.
  *
- * This file was generated by the tool fastddsgen.
+ * This file was generated by the tool fastddsgen (version: 4.1.0).
  */
 
 %module(moduleimport="if __import__('os').name == 'nt': import win32api; win32api.LoadLibrary('HelloWorld.dll')\nif __package__ or '.' in __name__:\n    from . import _HelloWorldWrapper\nelse:\n    import _HelloWorldWrapper") HelloWorld
@@ -49,7 +49,6 @@
 
 %{
 #include "HelloWorld.hpp"
-
 #include <fastdds/dds/core/LoanableSequence.hpp>
 %}
 
@@ -121,7 +120,6 @@ namespace swig {
 
 // Include the class interfaces
 %include "HelloWorld.hpp"
-
 // Include the corresponding TopicDataType
 %include "HelloWorldPubSubTypes.i"
 

…s/HelloWorldExample/HelloWorldCdrAux.hpp …mple/generated_code/HelloWorldCdrAux.hppfastdds_python_examples/HelloWorldExample/HelloWorldCdrAux.hpp renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorldCdrAux.hpp fastdds_python_examples/HelloWorldExample/HelloWorldCdrAux.hpp renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorldCdrAux.hpp

@@ -16,14 +16,13 @@
  * @file HelloWorldCdrAux.hpp
  * This source file contains some definitions of CDR related functions.
  *
- * This file was generated by the tool fastddsgen.
+ * This file was generated by the tool fastddsgen (version: 4.1.0).
  */
 
 #ifndef FAST_DDS_GENERATED__HELLOWORLDCDRAUX_HPP
 #define FAST_DDS_GENERATED__HELLOWORLDCDRAUX_HPP
 
 #include "HelloWorld.hpp"
-
 constexpr uint32_t HelloWorld_max_cdr_typesize {268UL};
 constexpr uint32_t HelloWorld_max_key_cdr_typesize {0UL};
 

…s/HelloWorldExample/HelloWorldCdrAux.ipp …mple/generated_code/HelloWorldCdrAux.ippfastdds_python_examples/HelloWorldExample/HelloWorldCdrAux.ipp renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorldCdrAux.ipp fastdds_python_examples/HelloWorldExample/HelloWorldCdrAux.ipp renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorldCdrAux.ipp

@@ -16,7 +16,7 @@
  * @file HelloWorldCdrAux.ipp
  * This source file contains some declarations of CDR related functions.
  *
- * This file was generated by the tool fastddsgen.
+ * This file was generated by the tool fastddsgen (version: 4.1.0).
  */
 
 #ifndef FAST_DDS_GENERATED__HELLOWORLDCDRAUX_IPP

…loWorldExample/HelloWorldPubSubTypes.cxx …generated_code/HelloWorldPubSubTypes.cxxfastdds_python_examples/HelloWorldExample/HelloWorldPubSubTypes.cxx renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorldPubSubTypes.cxx fastdds_python_examples/HelloWorldExample/HelloWorldPubSubTypes.cxx renamed to fastdds_python_examples/HelloWorldExample/generated_code/HelloWorldPubSubTypes.cxx

@@ -16,7 +16,7 @@
  * @file HelloWorldPubSubTypes.cpp
  * This header file contains the implementation of the serialization functions.
  *
- * This file was generated by the tool fastddsgen.
+ * This file was generated by the tool fastddsgen (version: 4.1.0).
  */
 
 #include "HelloWorldPubSubTypes.hpp"
@@ -56,7 +56,7 @@ bool HelloWorldPubSubType::serialize(
         SerializedPayload_t& payload,
         DataRepresentationId_t data_representation)
 {
-    const HelloWorld* p_type = static_cast<const HelloWorld*>(data);
+    const ::HelloWorld* p_type = static_cast<const ::HelloWorld*>(data);
 
     // Object that manages the raw buffer.
     eprosima::fastcdr::FastBuffer fastbuffer(reinterpret_cast<char*>(payload.data), payload.max_size);
@@ -95,7 +95,7 @@ bool HelloWorldPubSubType::deserialize(
     try
     {
         // Convert DATA to pointer of your type
-        HelloWorld* p_type = static_cast<HelloWorld*>(data);
+        ::HelloWorld* p_type = static_cast<::HelloWorld*>(data);
 
         // Object that manages the raw buffer.
         eprosima::fastcdr::FastBuffer fastbuffer(reinterpret_cast<char*>(payload.data), payload.length);
@@ -129,7 +129,7 @@ uint32_t HelloWorldPubSubType::calculate_serialized_size(
             eprosima::fastcdr::CdrVersion::XCDRv1 :eprosima::fastcdr::CdrVersion::XCDRv2);
         size_t current_alignment {0};
         return static_cast<uint32_t>(calculator.calculate_serialized_size(
-                    *static_cast<const HelloWorld*>(data), current_alignment)) +
+                    *static_cast<const ::HelloWorld*>(data), current_alignment)) +
                 4u /*encapsulation*/;
     }
     catch (eprosima::fastcdr::exception::Exception& /*exception*/)
@@ -140,13 +140,13 @@ uint32_t HelloWorldPubSubType::calculate_serialized_size(
 
 void* HelloWorldPubSubType::create_data()
 {
-    return reinterpret_cast<void*>(new HelloWorld());
+    return reinterpret_cast<void*>(new ::HelloWorld());
 }
 
 void HelloWorldPubSubType::delete_data(
         void* data)
 {
-    delete(reinterpret_cast<HelloWorld*>(data));
+    delete(reinterpret_cast<::HelloWorld*>(data));
 }
 
 bool HelloWorldPubSubType::compute_key(
@@ -159,7 +159,7 @@ bool HelloWorldPubSubType::compute_key(
         return false;
     }
 
-    HelloWorld data;
+    ::HelloWorld data;
     if (deserialize(payload, static_cast<void*>(&data)))
     {
         return compute_key(static_cast<void*>(&data), handle, force_md5);
@@ -178,7 +178,7 @@ bool HelloWorldPubSubType::compute_key(
         return false;
     }
 
-    const HelloWorld* p_type = static_cast<const HelloWorld*>(data);
+    const ::HelloWorld* p_type = static_cast<const ::HelloWorld*>(data);
 
     // Object that manages the raw buffer.
     eprosima::fastcdr::FastBuffer fastbuffer(reinterpret_cast<char*>(key_buffer_),