Imported upstream version '3.6.1' of 'upstream'

.editorconfig

@@ -0,0 +1,17 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 100
+
+# Use 4 spaces for the Python files
+[*.py]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false

.github/workflows/main.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  industrial_ci:
+    strategy:
+      matrix:
+        env:
+          - {ROS_DISTRO: humble, ROS_REPO: testing}
+          - {ROS_DISTRO: humble, ROS_REPO: main}
+          - {ROS_DISTRO: iron, ROS_REPO: testing}
+          - {ROS_DISTRO: iron, ROS_REPO: main}
+          - {ROS_DISTRO: rolling, ROS_REPO: testing}
+          - {ROS_DISTRO: rolling, ROS_REPO: main}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v1
+      - uses: 'ros-industrial/industrial_ci@master'
+        env: ${{matrix.env}}

LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2014, Southwest Research Institute® (SwRI®)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of Southwest Research Institute® (SwRI®) nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,77 @@
+marti\_common
+![CI](https://github.com/swri-robotics/marti_common/workflows/CI/badge.svg)
+![CI](https://github.com/swri-robotics/marti_common/workflows/CI/badge.svg?branch=dashing-devel)
+[![ROS2 Build Farm Build Status](http://build.ros2.org/buildStatus/icon?job=Ddev__marti_common__ubuntu_bionic_amd64)](http://build.ros2.org/job/Ddev__marti_common__ubuntu_bionic_amd64/)
+=============
+
+This repository provides various utility packages created at [Southwest Reseach Institute](http://www.swri.org)'s [Intelligent Vehicle Systems](http://www.swri.org/4org/d10/isd/ivs/default.htm) section for working with [Robot Operating System(ROS)](http://www.ros.org).  This branch adds support for ROS 2 Dashing and newer releases.  Most packages from ROS 1 have been ported, but a few have been removed due to being unnecessary or redundant, and some functionality is not implemented yet.
+
+Overview
+--------
+
+What's changed in the ROS 2 port?
+
+Removed packages:
+1. `marti_data_structures`  
+    Nothing used this and it only contained a linked list
+2. `swri_nodelet`  
+    Obsolete due to ROS 2's component mechanism
+3. `swri_rospy`  
+    Unnecessary in ROS 2
+4. `swri_string_util`  
+    Equivalent functionality is provided by boost
+5. `swri_yaml_util`  
+    This package only existed in order to bridge nodes between ROS Hydro and ROS Indigo; use `yaml-cpp` directly now
+
+Package migration notes:
+1. `swri_image_util`  
+    `replace_colors_node` has not been ported yet due to extensive changes in how ROS parameters work
+2. `swri_roscpp`
+    1. Many parameter-related classes have been removed; they are unnecessary due to `roscpp::Node::delcare_parameter` providing equivalent functionality now
+    2. Topic services have not been ported yet
+3. `swri_transform_util`  
+    `initialize_origin.py` does not publish a tf frame due to tf2 Python bindings not being fully functional in ROS 2 Dashing
+4. Launch files
+    Launch files have not yet been migrated to ROS 2
+
+Also note that many features have not been tested yet.  Please open an issue if you try to use something and it doesn't work.
+
+Installation (ROS Foxy, Galactic, Humble)
+------------
+
+If you have installed ROS 2, you can install any of the packages in this repository with apt-get:
+
+    sudo apt-get install ros-${ROS_DISTRO}-<package>
+
+Building From Source (ROS Foxy, Galactic, Humble)
+------------
+
+These directions assume you have already set up rosdep. See the [rosdep documentation](http://wiki.ros.org/rosdep) on the ROS wiki for help setting up rosdep.
+
+1. If you don't have a colcon workspace, create one:
+
+    ```bash
+    mkdir $HOME/workspace/src
+    cd $HOME/workspace/src
+    ```
+
+2. Check out the source code
+
+    ```bash
+    cd $HOME/workspace/src
+    git clone https://github.com/swri-robotics/marti_common.git
+    ```
+
+3. Install dependencies:
+
+    ```bash
+    # (In the root of this repository)
+    rosdep install --from-paths . --ignore-src
+    ```
+
+4. Build
+
+    ```bash
+    cd $HOME/workspace
+    colcon build
+    ```

swri_cli_tools/CHANGELOG.rst

@@ -0,0 +1,176 @@
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Changelog for package swri_cli_tools
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+3.6.1 (2023-09-11)
+------------------
+* Fixing Buildfarm Issues (`#716 <https://github.com/swri-robotics/marti_common/issues/716>`_)
+  * Cleaning up code to fix build farm errors
+* Contributors: David Anthony
+
+3.6.0 (2023-08-22)
+------------------
+
+3.5.4 (2023-08-14)
+------------------
+
+3.5.3 (2023-06-07)
+------------------
+* Adding missing python dependency (`#708 <https://github.com/swri-robotics/marti_common/issues/708>`_)
+* Contributors: David Anthony
+
+3.5.2 (2023-05-30)
+------------------
+* Add CLI Tools to ROS 2 (`#701 <https://github.com/danthony06/marti_common/issues/701>`_)
+  * Add ability to document running system for either all nodes or a set of nodes.
+* Contributors: David Anthony
+
+3.5.1 (2022-11-29)
+------------------
+
+3.5.0 (2022-10-11)
+------------------
+
+3.4.2 (2022-10-10)
+------------------
+
+3.4.1 (2022-04-21)
+------------------
+
+3.4.0 (2021-11-17)
+------------------
+
+3.3.2 (2020-11-24)
+------------------
+
+3.3.1 (2020-08-19)
+------------------
+
+3.3.0 (2020-07-15)
+------------------
+
+3.2.1 (2020-06-10)
+------------------
+
+3.2.0 (2020-05-13)
+------------------
+
+3.1.0 (2020-03-30)
+------------------
+
+3.0.5 (2020-03-10)
+------------------
+
+3.0.4 (2020-03-05)
+------------------
+
+3.0.3 (2019-11-11 16:58)
+------------------------
+
+3.0.2 (2019-11-11 14:33)
+------------------------
+
+3.0.1 (2019-11-11 09:36)
+------------------------
+
+3.0.0 (2019-11-08)
+------------------
+
+2.10.0 (2019-09-04)
+-------------------
+
+2.9.0 (2019-05-23)
+------------------
+
+2.8.0 (2019-02-06)
+------------------
+
+2.7.3 (2019-01-03)
+------------------
+
+2.7.2 (2018-12-20)
+------------------
+
+2.7.1 (2018-12-14)
+------------------
+
+2.7.0 (2018-12-04)
+------------------
+
+2.6.0 (2018-11-03)
+------------------
+
+2.5.0 (2018-10-12)
+------------------
+
+2.4.0 (2018-10-09)
+------------------
+
+2.3.0 (2018-05-25)
+------------------
+
+2.2.1 (2018-05-11)
+------------------
+
+2.2.0 (2018-02-12)
+------------------
+
+2.1.0 (2018-01-26)
+------------------
+
+2.0.0 (2017-12-18)
+------------------
+
+1.2.0 (2017-10-13)
+------------------
+
+1.1.0 (2017-08-31)
+------------------
+
+1.0.0 (2017-08-02)
+------------------
+
+0.3.0 (2017-06-20)
+------------------
+
+0.0.14 (2017-04-11)
+-------------------
+
+0.0.13 (2016-10-23)
+-------------------
+
+0.0.12 (2016-08-14)
+-------------------
+
+0.0.11 (2016-05-13)
+-------------------
+
+0.0.10 (2016-05-12)
+-------------------
+
+0.0.9 (2016-03-04)
+------------------
+
+0.0.8 (2016-01-06)
+------------------
+
+0.0.7 (2015-11-18)
+------------------
+
+0.0.6 (2015-11-17)
+------------------
+
+0.0.5 (2015-09-27 15:27)
+------------------------
+
+0.0.4 (2015-09-27 11:35)
+------------------------
+
+0.0.3 (2015-09-26)
+------------------
+
+0.0.2 (2015-09-25 15:00)
+------------------------
+
+0.0.1 (2015-09-25 09:06)
+------------------------

swri_cli_tools/package.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0"?>
+<?xml-model href="http://download.ros.org/schema/package_format3.xsd" schematypens="http://www.w3.org/2001/XMLSchema"?>
+<package format="3">
+  <name>swri_cli_tools</name>
+  <version>3.6.1</version>
+  <description>Command line tools for introspecting ROS systems</description>
+
+  <maintainer email="[email protected]">Southwest Research Institute</maintainer>
+  <author email="[email protected]">David Anthony</author>
+
+  <license>BSD 3 Clause</license>
+
+  <depend>marti_introspection_msgs</depend>
+  <depend>python3-natsort</depend>
+  <depend>rcl_interfaces</depend>
+  <depend>rclpy</depend>
+  <depend>ros2cli</depend>
+
+  <test_depend>ament_copyright</test_depend>
+  <test_depend>ament_flake8</test_depend>
+  <test_depend>ament_pep257</test_depend>
+  <test_depend>ament_xmllint</test_depend>
+
+  <export>
+    <build_type>ament_python</build_type>
+  </export>
+</package>

swri_cli_tools/setup.py

@@ -0,0 +1,45 @@
+import os
+from setuptools import find_packages, setup
+
+package_name = 'swri_cli_tools'
+
+setup(
+    name=package_name,
+    version='3.6.1',
+    packages=find_packages(exclude=['test']),
+    data_files=[
+        ('share/ament_index/resource_index/packages', ['resource/' + package_name]),
+        (os.path.join('share', package_name), ['package.xml']),
+    ],
+    install_requires=['ros2cli', 'setuptools'],
+    zip_safe=True,
+    author='David Anthony',
+    author_email='[email protected]',
+    maintainer='Southwest Research Institute',
+    maintainer_email='[email protected]',
+    url='https://github.com/swri-robotics/marti_common',
+    keywords=['ROS'],
+    classifiers=[
+        'Environment :: Console',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: BSD 3 Clause',
+        'Programming Language :: Python',
+        'Topic :: Software Development',
+    ],
+    description='SwRI CLI tools provide additional command line tools for introspecting ROS systems.',
+    long_description="""\
+swri_cli_tools provides command line tools for introspecting and documenting ROS systems""",
+    license='BSD 3 Clause',
+    tests_require=['pytest'],
+    entry_points={
+        'ros2cli.command': [
+            'swri = swri_cli_tools.command.swri:SwriCommand',
+        ],
+        'ros2cli.extension_point': [
+            'swri_cli_tools.verb = swri_cli_tools.verb:VerbExtension',
+        ],
+        'swri_cli_tools.verb': [
+            'document = swri_cli_tools.verb.document:DocumentVerb',
+        ],
+    },
+)