ROS Support Library (RSL)

RSL is a collection of C++17 utilities for ROS projects.

Read the docs here.

Killer Features

• algorithm - Functions for inspecting collections
• monad.hpp - Functions and operators for monadic expressions
• no_discard.hpp - [[nodiscard]] for lambdas
• overload.hpp - Class template for easily visiting variants
• parameter_validators.hpp - Functions for validating rclcpp::Parameter
• queue.hpp - Thread-safe queue
• random.hpp - Modern C++ randomness made easy
• static_string.hpp - Static capacity string class
• static_vector.hpp - Static capacity vector class
• strong_type.hpp - Strong typedef class
• try.hpp - Macro to emulatate absl::CONFIRM or operator? from Rust

Changelog for package rsl

1.1.0 (2023-12-20)

• Fix [ament_target_dependencies]{.title-ref} integration
• Add [rsl::maybe_error]{.title-ref}
• Disable tests by default
• Stop using non-standard [M_PI]{.title-ref}
• Contributors: Chris Thrasher

1.0.1 (2023-12-06)

• Add more messages for assertion failures
• Document API changes from v0 to v1
• Contributors: Chris Thrasher

1.0.0 (2023-12-04)

• Add [rsl::StrongType]{.title-ref}
• Quote values in error messages
• Make doxygen a weak dependency
• Mark git as a test dependency
• Contributors: Andrew, Chris Thrasher, Michael Carroll, Tyler Weaver, andrea

0.2.2 (2023-03-23)

• Deprecate [rsl::lower_bounds]{.title-ref} and [rsl::upper_bounds]{.title-ref}
• Depend on ament_cmake_ros for SHARED default
• Upgrade with new pkgs to fix issue with ROS
• Update Catch2
• Contributors: Chris Thrasher, Tyler Weaver

0.2.1 (2022-11-29)

• Use constructors over factory functions when possible
• Implement [rsl::rng]{.title-ref} with [std::optional]{.title-ref}
• Fix bug when trying to seed rng from first call
• Make [rsl::rng()]{.title-ref} tests more strenuous Seeding on the first call tests a code path that hadn't yet been tested but is a valid use of the API.
• Change version of range-v3 to allow building on Ubuntu Focal (#73)
• Add missing header Fixes a build issue when using GCC 12
• Make it easy for users to override
• Update Catch2
• Add tests for [rsl::to_parameter_result_msg]{.title-ref}
• Contributors: Chris Thrasher, Tony Najjar, Tyler Weaver

0.2.0 (2022-11-15)

• New features
  • rclcpp::Parameter validator functions
  • Algorithms from parameter_traits
  • [rsl::StaticVector]{.title-ref} and [rsl::StaticString]{.title-ref}
• Doxygen site: https://picknikrobotics.github.io/RSL/files.html
  • Link to the docs from the README
  • Use doxygen-awesome documentation style
  • Deploy documentation website from CI
  • Add Doxygen comments for [rsl::Overload]{.title-ref}
  • Add Doxygen comments for [TRY]{.title-ref}
• Cleanups
  • Prevent unnecessary string copy
  • Ensure global constants do not violate the ODR
  • Hide [rsl::NoDiscard]{.title-ref} implementation details
  • Use more [[[nodiscard]]]{.title-ref}
  • Fix to_vector for vector<bool>
  • Ensure static container iterators are used
  • Default to building a shared library
  • Use generator-agnostic CMake commands
  • Remove C compiler settings
  • Don't require compiler extensions
  • Use more expressive path variable
  • Add clang-tidy integration and fix errors
  • Address clang-tidy findings
  • Update FindCatch2 module
  • Update Catch2
• Contributors: Chris Thrasher, Tyler Weaver

0.1.1 (2022-10-04)

• Fix CMake configuration warnings
• Contributors: Chris Thrasher

0.1.0 (2022-10-04)

• monad.hpp - Functions and operators for monadic expressions
• no_discard.hpp - [[[nodiscard]]]{.title-ref} for lambdas
• overload.hpp - Class template for easily visiting variants
• queue.hpp - Thread-safe queue
• random.hpp - Modern C++ randomness made easy
• try.hpp - Macro to emulatate absl::CONFIRM or operator? from Rust
• Contributors: Chris Thrasher, Tyler Weaver