Skip to content

Commit 10c89eb

Browse files
Claire WangmaryaB-osr
andauthored
add ros2doctor README (#318)
* add README Signed-off-by: claireyywang <[email protected]> * update sentence to new line Signed-off-by: claireyywang <[email protected]> * Update grammer Co-Authored-By: Marya Belanger <[email protected]> Signed-off-by: claireyywang <[email protected]> * Update grammer Co-Authored-By: Marya Belanger <[email protected]> Signed-off-by: claireyywang <[email protected]> * Update grammer Co-Authored-By: Marya Belanger <[email protected]> Signed-off-by: claireyywang <[email protected]> * Update grammar Co-Authored-By: Marya Belanger <[email protected]> Signed-off-by: claireyywang <[email protected]>
1 parent 19df922 commit 10c89eb

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

ros2doctor/README.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# ros2doctor
2+
3+
This folder contains the source code for ros2doctor.
4+
It is one of the ROS 2 command line interface tools included with a standard install of any ROS 2 distro.
5+
`ros2doctor` is similar to `roswtf` from ROS 1.
6+
It will examine your ROS 2 setup, such as distribution, platform, network interface, etc., and look for potential issues in a running ROS 2 system.
7+
8+
## Usage
9+
10+
Run `ros2 doctor` or `ros2 wtf`(alias) to conduct checks.
11+
12+
Run `ros2 doctor -h/--help` to print all available command extensions.
13+
14+
Run `ros2 doctor -r/--report` to see details of checks.
15+
16+
## Add New Checks
17+
18+
To add your own checks or information to report, use [Python entry points](https://setuptools.readthedocs.io/en/latest/pkg_resources.html#entry-points) to add modules to `setup.py`. See example below:
19+
20+
```python
21+
entry_points={
22+
'ros2doctor.checks': [
23+
'check_platform = ros2doctor.api.platform:check_platform',
24+
],
25+
'ros2doctor.report': [
26+
'report_platform = ros2doctor.api.platform:print_platform_info',
27+
'report_ros_distro = ros2doctor.api.platform:print_ros2_info',
28+
],
29+
}
30+
```

0 commit comments

Comments
 (0)