Add topic_id returned by storage to the TopicMetadata

- Rationale.
 To be able to distinguish topics by unique topic ID rather than by
 topic name in the future.

Signed-off-by: Michael Orlov <michael.orlov@apex.ai>

rosbag2_compression/test/rosbag2_compression/test_sequential_compression_reader.cpp

@@ -54,7 +54,7 @@ class SequentialCompressionReaderTest : public Test
     rcpputils::fs::remove_all(tmp_dir_);
     storage_options_.uri = tmp_dir_.string();
     topic_with_type_ = rosbag2_storage::TopicMetadata{
-      "topic", "test_msgs/BasicTypes", storage_serialization_format_, {}, ""};
+      0, "topic", "test_msgs/BasicTypes", storage_serialization_format_, {}, ""};
     auto topics_and_types = std::vector<rosbag2_storage::TopicMetadata>{topic_with_type_};
     auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
     message->topic_name = topic_with_type_.name;

rosbag2_compression/test/rosbag2_compression/test_sequential_compression_writer.cpp

@@ -258,7 +258,7 @@ TEST_F(SequentialCompressionWriterTest, writer_creates_correct_metadata_relative
 
   tmp_dir_storage_options_.max_bagfile_size = 1;
   writer_->open(tmp_dir_storage_options_);
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;
@@ -301,7 +301,7 @@ TEST_F(SequentialCompressionWriterTest, writer_call_metadata_update_on_open_and_
 
   EXPECT_CALL(*storage_, update_metadata(_)).Times(2);
   writer_->open(tmp_dir_storage_options_);
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;
@@ -340,7 +340,7 @@ TEST_F(SequentialCompressionWriterTest, writer_call_metadata_update_on_bag_split
 
   EXPECT_CALL(*storage_, update_metadata(_)).Times(4);
   writer_->open(tmp_dir_storage_options_);
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;
@@ -388,7 +388,7 @@ TEST_P(SequentialCompressionWriterTest, writer_writes_with_compression_queue_siz
   initializeWriter(compression_options);
 
   writer_->open(tmp_dir_storage_options_);
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;
@@ -441,7 +441,7 @@ TEST_P(SequentialCompressionWriterTest, writer_sets_threads_priority)
     std::make_unique<FakeCompressionFactory>(detected_thread_priority));
 
   writer_->open(tmp_dir_storage_options_);
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;

rosbag2_cpp/test/rosbag2_cpp/fake_data.cpp

@@ -34,6 +34,7 @@ void write_sample_split_bag(
 
   writer.create_topic(
   {
+    0,
     topic_name,
     "test_msgs/msg/ByteMultiArray",
     "cdr",

rosbag2_cpp/test/rosbag2_cpp/test_info.cpp

@@ -86,7 +86,7 @@ TEST_P(ParametrizedTemporaryDirectoryFixture, read_metadata_supports_version_2)
   {
     const auto actual_first_topic = metadata.topics_with_message_count[0];
     const auto expected_first_topic =
-      rosbag2_storage::TopicInformation{{"topic1", "type1", "rmw1", {}, ""}, 100};
+      rosbag2_storage::TopicInformation{{0, "topic1", "type1", "rmw1", {}, ""}, 100};
 
     EXPECT_EQ(actual_first_topic.topic_metadata, expected_first_topic.topic_metadata);
     EXPECT_EQ(actual_first_topic.message_count, expected_first_topic.message_count);
@@ -95,7 +95,7 @@ TEST_P(ParametrizedTemporaryDirectoryFixture, read_metadata_supports_version_2)
   {
     const auto actual_second_topic = metadata.topics_with_message_count[1];
     const auto expected_second_topic =
-      rosbag2_storage::TopicInformation{{"topic2", "type2", "rmw2", {}, ""}, 200};
+      rosbag2_storage::TopicInformation{{0, "topic2", "type2", "rmw2", {}, ""}, 200};
 
     EXPECT_EQ(actual_second_topic.topic_metadata, expected_second_topic.topic_metadata);
     EXPECT_EQ(actual_second_topic.message_count, expected_second_topic.message_count);
@@ -192,7 +192,7 @@ TEST_P(ParametrizedTemporaryDirectoryFixture, read_metadata_supports_version_6)
   {
     const auto actual_first_topic = metadata.topics_with_message_count[0];
     const auto expected_first_topic =
-      rosbag2_storage::TopicInformation{{"topic1", "type1", "rmw1", {}, ""}, 100};
+      rosbag2_storage::TopicInformation{{0, "topic1", "type1", "rmw1", {}, ""}, 100};
 
     EXPECT_EQ(actual_first_topic.topic_metadata, expected_first_topic.topic_metadata);
     EXPECT_EQ(actual_first_topic.message_count, expected_first_topic.message_count);
@@ -201,7 +201,7 @@ TEST_P(ParametrizedTemporaryDirectoryFixture, read_metadata_supports_version_6)
   {
     const auto actual_second_topic = metadata.topics_with_message_count[1];
     const auto expected_second_topic =
-      rosbag2_storage::TopicInformation{{"topic2", "type2", "rmw2", {}, ""}, 200};
+      rosbag2_storage::TopicInformation{{0, "topic2", "type2", "rmw2", {}, ""}, 200};
 
     EXPECT_EQ(actual_second_topic.topic_metadata, expected_second_topic.topic_metadata);
     EXPECT_EQ(actual_second_topic.message_count, expected_second_topic.message_count);
@@ -262,7 +262,7 @@ TEST_P(
   EXPECT_THAT(read_metadata.topics_with_message_count, SizeIs(2u));
   auto actual_first_topic = read_metadata.topics_with_message_count[0];
   rosbag2_storage::TopicInformation expected_first_topic =
-  {{"topic1", "type1", "rmw1", {}, ""}, 100};
+  {{0, "topic1", "type1", "rmw1", {}, ""}, 100};
   EXPECT_THAT(
     actual_first_topic.topic_metadata.name,
     Eq(expected_first_topic.topic_metadata.name));
@@ -275,7 +275,7 @@ TEST_P(
   EXPECT_THAT(actual_first_topic.message_count, Eq(expected_first_topic.message_count));
   auto actual_second_topic = read_metadata.topics_with_message_count[1];
   rosbag2_storage::TopicInformation expected_second_topic =
-  {{"topic2", "type2", "rmw2", {}, ""}, 200};
+  {{0, "topic2", "type2", "rmw2", {}, ""}, 200};
   EXPECT_THAT(
     actual_second_topic.topic_metadata.name,
     Eq(expected_second_topic.topic_metadata.name));

rosbag2_cpp/test/rosbag2_cpp/test_multifile_reader.cpp

@@ -53,7 +53,7 @@ class MultifileReaderTest : public Test
     auto metadata = get_metadata();
 
     auto topic_with_type = rosbag2_storage::TopicMetadata{
-      "topic", "test_msgs/BasicTypes", storage_serialization_format_, {}, ""};
+      0, "topic", "test_msgs/BasicTypes", storage_serialization_format_, {}, ""};
     auto topics_and_types = std::vector<rosbag2_storage::TopicMetadata>{topic_with_type};
     metadata.topics_with_message_count.push_back({topic_with_type, 10});
 

rosbag2_cpp/test/rosbag2_cpp/test_sequential_writer.cpp

@@ -130,7 +130,7 @@ TEST_F(
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = "test_topic";
   writer_->open(storage_options_, {input_format, storage_serialization_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
   writer_->write(message);
 }
 
@@ -147,7 +147,7 @@ TEST_F(SequentialWriterTest, write_does_not_use_converters_if_input_and_output_f
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = "test_topic";
   writer_->open(storage_options_, {storage_serialization_format, storage_serialization_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
   writer_->write(message);
 }
 
@@ -175,7 +175,7 @@ TEST_F(SequentialWriterTest, sequantial_writer_call_metadata_update_on_open_and_
 
   std::string rmw_format = "rmw_format";
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;
@@ -204,7 +204,7 @@ TEST_F(SequentialWriterTest, sequantial_writer_call_metadata_update_on_bag_split
 
   std::string rmw_format = "rmw_format";
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({test_topic_name, test_topic_type, "", {}, ""});
+  writer_->create_topic({0, test_topic_name, test_topic_type, "", {}, ""});
 
   auto message = std::make_shared<rosbag2_storage::SerializedBagMessage>();
   message->topic_name = test_topic_name;
@@ -283,7 +283,7 @@ TEST_F(SequentialWriterTest, bagfile_size_is_checked_on_every_write) {
   storage_options_.max_bagfile_size = max_bagfile_size;
 
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0; i < counter; ++i) {
     writer_->write(message);
@@ -333,7 +333,7 @@ TEST_F(SequentialWriterTest, writer_splits_when_storage_bagfile_size_gt_max_bagf
   storage_options_.max_bagfile_size = max_bagfile_size;
 
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0; i < message_count; ++i) {
     writer_->write(message);
@@ -411,7 +411,7 @@ TEST_F(
   storage_options_.snapshot_mode = false;
 
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   auto timeout = std::chrono::seconds(2);
   for (auto i = 1u; i < message_count; ++i) {
@@ -491,7 +491,7 @@ TEST_F(SequentialWriterTest, do_not_use_cache_if_cache_size_is_zero) {
   storage_options_.max_cache_size = max_cache_size;
 
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0u; i < counter; ++i) {
     writer_->write(message);
@@ -525,7 +525,7 @@ TEST_F(SequentialWriterTest, snapshot_mode_write_on_trigger)
     msg_content.c_str(), msg_length);
 
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0u; i < 100; ++i) {
     writer_->write(message);
@@ -561,7 +561,7 @@ TEST_F(SequentialWriterTest, snapshot_mode_not_triggered_no_storage_write)
     msg_content.c_str(), msg_length);
 
   writer_->open(storage_options_, {rmw_format, rmw_format});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0u; i < 100; ++i) {
     writer_->write(message);
@@ -630,7 +630,7 @@ TEST_F(SequentialWriterTest, split_event_calls_callback)
   writer_->add_event_callbacks(callbacks);
 
   writer_->open(storage_options_, {"rmw_format", "rmw_format"});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0; i < message_count; ++i) {
     writer_->write(message);
@@ -689,7 +689,7 @@ TEST_F(SequentialWriterTest, split_event_calls_on_writer_close)
   writer_->add_event_callbacks(callbacks);
 
   writer_->open(storage_options_, {"rmw_format", "rmw_format"});
-  writer_->create_topic({"test_topic", "test_msgs/BasicTypes", "", {}, ""});
+  writer_->create_topic({0, "test_topic", "test_msgs/BasicTypes", "", {}, ""});
 
   for (auto i = 0; i < message_count; ++i) {
     writer_->write(message);

rosbag2_cpp/test/rosbag2_cpp/test_storage_without_metadata_file.cpp

@@ -52,18 +52,10 @@ class StorageWithoutMetadataFileTest : public Test
 
 TEST_F(StorageWithoutMetadataFileTest, open_uses_storage_id_from_storage_options) {
   {
-    auto topic_with_type = rosbag2_storage::TopicMetadata{
-      "topic",
-      "test_msgs/BasicTypes",
-      kRmwFormat,
-      {},
-      ""
-    };
-
-    auto topic_information = rosbag2_storage::TopicInformation{
-      topic_with_type,
-      1
-    };
+    auto topic_with_type =
+      rosbag2_storage::TopicMetadata{0, "topic", "test_msgs/BasicTypes", kRmwFormat, {}, ""};
+
+    auto topic_information = rosbag2_storage::TopicInformation{topic_with_type, 1};
 
     rosbag2_storage::BagMetadata metadata;
     metadata.relative_file_paths = {"TestPath"};

rosbag2_examples/rosbag2_examples_cpp/src/data_generator_executable.cpp

@@ -34,6 +34,7 @@ int main(int, char **)
 
   writer_->create_topic(
   {
+    0,
     "synthetic",
     "example_interfaces/msg/Int32",
     rmw_get_serialization_format(),

rosbag2_examples/rosbag2_examples_cpp/src/data_generator_node.cpp

@@ -35,6 +35,7 @@ class DataGenerator : public rclcpp::Node
 
     writer_->create_topic(
     {
+      0,
       "synthetic",
       "example_interfaces/msg/Int32",
       rmw_get_serialization_format(),

rosbag2_examples/rosbag2_examples_py/rosbag2_examples_py/data_generator_executable.py

@@ -28,6 +28,7 @@ def main(args=None):
     writer.open(storage_options, converter_options)
 
     topic_info = rosbag2_py._storage.TopicMetadata(
+        id=0,
         name='synthetic',
         type='example_interfaces/msg/Int32',
         serialization_format='cdr')

rosbag2_examples/rosbag2_examples_py/rosbag2_examples_py/data_generator_node.py

@@ -33,6 +33,7 @@ def __init__(self):
         self.writer.open(storage_options, converter_options)
 
         topic_info = rosbag2_py._storage.TopicMetadata(
+            id=0,
             name='synthetic',
             type='example_interfaces/msg/Int32',
             serialization_format='cdr')

rosbag2_examples/rosbag2_examples_py/rosbag2_examples_py/simple_bag_recorder.py

@@ -31,6 +31,7 @@ def __init__(self):
         self.writer.open(storage_options, converter_options)
 
         topic_info = rosbag2_py._storage.TopicMetadata(
+            id=0,
             name='chatter',
             type='std_msgs/msg/String',
             serialization_format='cdr')

rosbag2_py/src/rosbag2_py/_storage.cpp

@@ -209,12 +209,15 @@ PYBIND11_MODULE(_storage, m) {
 
   pybind11::class_<rosbag2_storage::TopicMetadata>(m, "TopicMetadata")
   .def(
-    pybind11::init<std::string, std::string, std::string, std::vector<rclcpp::QoS>, std::string>(),
+    pybind11::init<int64_t, std::string, std::string, std::string, std::vector<rclcpp::QoS>,
+    std::string>(),
+    pybind11::arg("id"),
     pybind11::arg("name"),
     pybind11::arg("type"),
     pybind11::arg("serialization_format"),
     pybind11::arg("offered_qos_profiles") = std::vector<rclcpp::QoS>(),
     pybind11::arg("type_description_hash") = "")
+  .def_readwrite("id", &rosbag2_storage::TopicMetadata::id)
   .def_readwrite("name", &rosbag2_storage::TopicMetadata::name)
   .def_readwrite("type", &rosbag2_storage::TopicMetadata::type)
   .def_readwrite(

rosbag2_py/test/test_compression.py

@@ -82,6 +82,7 @@ def test_sequential_compression(tmp_path, storage_id):
 
     topic_name = '/chatter'
     topic_metadata = TopicMetadata(
+        id=0,
         name=topic_name,
         type='std_msgs/msg/String',
         serialization_format='cdr')

rosbag2_py/test/test_sequential_writer.py

@@ -34,7 +34,7 @@ def create_topic(writer, topic_name, topic_type, serialization_format='cdr'):
     :return:
     """
     topic_name = topic_name
-    topic = rosbag2_py.TopicMetadata(name=topic_name, type=topic_type,
+    topic = rosbag2_py.TopicMetadata(id=0, name=topic_name, type=topic_type,
                                      serialization_format=serialization_format)
 
     writer.create_topic(topic)

rosbag2_py/test/test_storage.py

@@ -58,6 +58,7 @@ def test_storage_filter_ctor(self):
 
     def test_topic_metadata_ctor(self):
         topic_metadata = TopicMetadata(
+            id=0,
             name='topic',
             type='msgs/Msg',
             serialization_format='format'
@@ -67,6 +68,7 @@ def test_topic_metadata_ctor(self):
     def test_topic_information_ctor(self):
         topic_information = TopicInformation(
             topic_metadata=TopicMetadata(
+                id=0,
                 name='topic',
                 type='msgs/Msg',
                 serialization_format='format'),
@@ -85,6 +87,7 @@ def test_bag_metadata_ctor_named_args(self):
             message_count=12)
         topic_information = TopicInformation(
             topic_metadata=TopicMetadata(
+                id=0,
                 name='topic',
                 type='msgs/Msg',
                 serialization_format='format'),

rosbag2_storage/include/rosbag2_storage/topic_metadata.hpp

@@ -24,6 +24,7 @@ namespace rosbag2_storage
 
 struct TopicMetadata
 {
+  int64_t id = 0;  // Topic id returned by storage
   std::string name;
   std::string type;
   std::string serialization_format;
@@ -33,7 +34,8 @@ struct TopicMetadata
 
   bool operator==(const rosbag2_storage::TopicMetadata & rhs) const
   {
-    return name == rhs.name &&
+    return id == rhs.id &&
+           name == rhs.name &&
            type == rhs.type &&
            serialization_format == rhs.serialization_format &&
            type_description_hash == rhs.type_description_hash;