PR2 · knorth55 · Nov 15, 2021 · Dec 24, 2021 · Dec 24, 2021
diff --git a/README.md b/README.md
@@ -1,181 +1,45 @@
-app_manager [![Build Status](https://travis-ci.com/PR2/app_manager.svg?branch=kinetic-devel)](https://travis-ci.org/PR2/app_manager)
-====================================================================================================================================
+# app_manager
+
+[![Build Status](https://travis-ci.com/PR2/app_manager.svg?branch=kinetic-devel)](https://travis-ci.org/PR2/app_manager)
+
+## app_manager
 
 A package for making launch file an application
 
-## Installation
+For detailed information, please read [app_manager](app_manager/README.md).
+
+## app_scheduler
+
+Scheduler for `app_manager`
+
+For detailed information, please read [app_scheduler](app_scheduler/README.md).
+
+## app_recorder
+
+Recorder plugin for `app_manager`
 
-Run `sudo apt-get install ros-$ROS_DISTRO-app-manager`
+For detailed information, please read [app_recorder](app_recorder/README.md).
 
-## Usage
+## app_uploader
 
-The `app_manager` node loads information of available application from `.installed` files.
-`.installed` file is a yaml file that defines installed applications in a package like below:
+Uploader plugin for `app_manager`
 
-```yaml
-# package_root/apps/app.installed
-apps:
-- app: pkg_name/app_name1
-  display: sample app
-- app: pkg_name/app_name2
-  display: another sample app
-```
+For detailed information, please read [app_uploader](app_uploader/README.md).
 
-Once `.installed` file is defined, you have to notify the location of the files to `app_manager` by either of two ways:
+## app_notifier
 
-1. Give the locations as arguments
+Notifier plugin for `app_manager`
 
-One way to notify the location is to add `--applist` argument with `rosrun`.
+For detailed information, please read [app_notifier](app_notifier/README.md).
 
-```bash
-rosrun app_manager app_manager --applist `rospack find package_root`/apps
-```
+## app_notification_saver
 
-This is useful for testing one small `.installed` file or a demonstration.
+Notification saver plugin for `app_manager`
 
-2. Register as export attributes
+For detailed information, please read [app_notification_saver](app_notification_saver/README.md).
 
-Another way to notify the location is to define them in `<export>` tag in `package.xml`.
+## app_publisher
 
-```xml
-<!-- package_root/package.xml -->
-<package>
-  ...
-  <run_depend>app_manager</run_depend>
-  ...
-  <export>
-    <app_manager app_dir="${prefix}/apps"/>
-  </export>
-</package>
-```
+Publisher plugin for `app_manager`
 
-And launch `app_manager` without any argument:
-
-```bash
-rosrun app_manager app_manager
-```
-
-`app_manager` node automatically searches all `.installed` files and register as available applications.
-
-Applications can be filtered by platform defined in each `.app` file.
-If you set the parameter `/robot/type` to `pr2`, then apps for platform `pr2` will be available.
-
-```bash
-rosparam set /robot/type pr2
-```
-
-
-## APIs
-
-All topics/services are advertised under the namespace specified by the parameter `/robot/name`.
-
-### Publishing Topics
-
-- `app_list`: List available/running applications
-- `application/app_status`: Current status of app manager
-
-### Services
-
-- `list_apps`: List available/running applications
-- `start_app`: Start an available application
-- `stop_app`: Stop a runniing application
-- `reload_app_list`: Reload installed applications from `*.installed`) file.
-
-
-## Examples
-
-Start default roscore
-```
-$ roscore
-
-```
-
-and start another roscore for app_manager from another Terminal
-
-```
-$ roscore -p 11312
-```
-
-Start app_manager
-```
-$ rosrun app_manager app_manager --applist `rospack find app_manager`/test/applist1 _interface_master:=http://localhost:11312
-```
-Make sure that it founds the apps
-```
-[INFO] [1575604033.724035]: 1 apps found in /home/user/catkin_ws/src/app_manager/test/applist1/apps1.installed
-```
-
-Use service calls to list and start apps.
-```
-$ rosservice call robot/list_apps
-running_apps: []
-available_apps:
-  -
-    name: "app_manager/appA"
-    display_name: "Android Joystick"
-    icon:
-      format: ''
-      data: []
-    client_apps: []
-$ rosservice call /robot/start_app app_manager/appA
-started: True
-error_code: 0
-message: "app [app_manager/appA] started"
-namespace: "/robot/application"
-```
-
-## Plugins
-
-You can define `app_manager` plugins as below in app file such as `test.app`.
-
-```yaml
-# app definitions
-display: Test app
-platform: all
-launch: test_app_manager/test_app.xml
-interface: test_app_manager/test_app.interface
-# plugin definitions
-plugins:
-  - name: mail_notifier_plugin  # name to identify this plugin
-    type: app_notifier/mail_notifier_plugin  # plugin type
-    launch_args:  # arguments for plugin launch file
-      foo: hello
-    launch_arg_yaml: /etc/mail_notifier_launch_arg.yaml  # argument yaml file for plugin launch file
-    # in this case, these arguments will be passed.
-    # {"hoge": 100, "fuga": 30, "bar": 10} will be passed to start plugin
-    # {"hoge": 50, "fuga": 30} will be passed to stop plugin
-    plugin_args:  # arguments for plugin function
-      hoge: 10
-      fuga: 30
-    start_plugin_args:  # arguments for start plugin function
-      hoge: 100  # arguments for start plugin function arguments (it overwrites plugin_args hoge: 10 -> 100)
-      bar: 10
-    stop_plugin_args:  # arguments for stop plugin function
-      hoge: 50  # arguments for stop plugin function arguments (it overwrites plugin_args hoge: 10 -> 50)
-    plugin_arg_yaml: /etc/mail_notifier_plugin_arg.yaml  # argument yaml file for plugin function arguments
-  - name: rosbag_recorder_plugin  # another plugin
-    type app_recorder/rosbag_recorder_plugin
-    launch_args:
-      rosbag_path: /tmp
-      rosbag_title: test.bag
-      compress: true
-      rosbag_topic_names:
-        - /rosout
-        - /tf
-        - /tf_static
-plugin_order: # plugin running orders. if you don't set field, plugin will be run in order in plugins field
-  start_plugin_order:  # start plugin running order
-    - rosbag_recorder_plugin  # 1st plugin name
-    - mail_notifier_plugin  #2nd plugin name
-  stop_plugin_order:  # start plugin running order
-    - rosbag_recorder_plugin
-    - mail_notifier_plugin
-```
-
-Sample plugin repository is [knorth55/app_manager_utils](https://github.com/knorth55/app_manager_utils).
-
-For more detailed information, please read [#25](https://github.com/PR2/app_manager/pull/25).
-
-## Maintainer
-
-Yuki Furuta <<[email protected]>>
+For detailed information, please read [app_publisher](app_publisher/README.md).
diff --git a/CHANGELOG.rst → app_manager/CHANGELOG.rst b/CHANGELOG.rst → app_manager/CHANGELOG.rst
diff --git a/CMakeLists.txt → app_manager/CMakeLists.txt b/CMakeLists.txt → app_manager/CMakeLists.txt
diff --git a/app_manager/README.md b/app_manager/README.md
@@ -0,0 +1,181 @@
+app_manager [![Build Status](https://travis-ci.com/PR2/app_manager.svg?branch=kinetic-devel)](https://travis-ci.org/PR2/app_manager)
+====================================================================================================================================
+
+A package for making launch file an application
+
+## Installation
+
+Run `sudo apt-get install ros-$ROS_DISTRO-app-manager`
+
+## Usage
+
+The `app_manager` node loads information of available application from `.installed` files.
+`.installed` file is a yaml file that defines installed applications in a package like below:
+
+```yaml
+# package_root/apps/app.installed
+apps:
+- app: pkg_name/app_name1
+  display: sample app
+- app: pkg_name/app_name2
+  display: another sample app
+```
+
+Once `.installed` file is defined, you have to notify the location of the files to `app_manager` by either of two ways:
+
+1. Give the locations as arguments
+
+One way to notify the location is to add `--applist` argument with `rosrun`.
+
+```bash
+rosrun app_manager app_manager --applist `rospack find package_root`/apps
+```
+
+This is useful for testing one small `.installed` file or a demonstration.
+
+2. Register as export attributes
+
+Another way to notify the location is to define them in `<export>` tag in `package.xml`.
+
+```xml
+<!-- package_root/package.xml -->
+<package>
+  ...
+  <run_depend>app_manager</run_depend>
+  ...
+  <export>
+    <app_manager app_dir="${prefix}/apps"/>
+  </export>
+</package>
+```
+
+And launch `app_manager` without any argument:
+
+```bash
+rosrun app_manager app_manager
+```
+
+`app_manager` node automatically searches all `.installed` files and register as available applications.
+
+Applications can be filtered by platform defined in each `.app` file.
+If you set the parameter `/robot/type` to `pr2`, then apps for platform `pr2` will be available.
+
+```bash
+rosparam set /robot/type pr2
+```
+
+
+## APIs
+
+All topics/services are advertised under the namespace specified by the parameter `/robot/name`.
+
+### Publishing Topics
+
+- `app_list`: List available/running applications
+- `application/app_status`: Current status of app manager
+
+### Services
+
+- `list_apps`: List available/running applications
+- `start_app`: Start an available application
+- `stop_app`: Stop a runniing application
+- `reload_app_list`: Reload installed applications from `*.installed`) file.
+
+
+## Examples
+
+Start default roscore
+```
+$ roscore
+
+```
+
+and start another roscore for app_manager from another Terminal
+
+```
+$ roscore -p 11312
+```
+
+Start app_manager
+```
+$ rosrun app_manager app_manager --applist `rospack find app_manager`/test/applist1 _interface_master:=http://localhost:11312
+```
+Make sure that it founds the apps
+```
+[INFO] [1575604033.724035]: 1 apps found in /home/user/catkin_ws/src/app_manager/test/applist1/apps1.installed
+```
+
+Use service calls to list and start apps.
+```
+$ rosservice call robot/list_apps
+running_apps: []
+available_apps:
+  -
+    name: "app_manager/appA"
+    display_name: "Android Joystick"
+    icon:
+      format: ''
+      data: []
+    client_apps: []
+$ rosservice call /robot/start_app app_manager/appA
+started: True
+error_code: 0
+message: "app [app_manager/appA] started"
+namespace: "/robot/application"
+```
+
+## Plugins
+
+You can define `app_manager` plugins as below in app file such as `test.app`.
+
+```yaml
+# app definitions
+display: Test app
+platform: all
+launch: test_app_manager/test_app.xml
+interface: test_app_manager/test_app.interface
+# plugin definitions
+plugins:
+  - name: mail_notifier_plugin  # name to identify this plugin
+    type: app_notifier/mail_notifier_plugin  # plugin type
+    launch_args:  # arguments for plugin launch file
+      foo: hello
+    launch_arg_yaml: /etc/mail_notifier_launch_arg.yaml  # argument yaml file for plugin launch file
+    # in this case, these arguments will be passed.
+    # {"hoge": 100, "fuga": 30, "bar": 10} will be passed to start plugin
+    # {"hoge": 50, "fuga": 30} will be passed to stop plugin
+    plugin_args:  # arguments for plugin function
+      hoge: 10
+      fuga: 30
+    start_plugin_args:  # arguments for start plugin function
+      hoge: 100  # arguments for start plugin function arguments (it overwrites plugin_args hoge: 10 -> 100)
+      bar: 10
+    stop_plugin_args:  # arguments for stop plugin function
+      hoge: 50  # arguments for stop plugin function arguments (it overwrites plugin_args hoge: 10 -> 50)
+    plugin_arg_yaml: /etc/mail_notifier_plugin_arg.yaml  # argument yaml file for plugin function arguments
+  - name: rosbag_recorder_plugin  # another plugin
+    type app_recorder/rosbag_recorder_plugin
+    launch_args:
+      rosbag_path: /tmp
+      rosbag_title: test.bag
+      compress: true
+      rosbag_topic_names:
+        - /rosout
+        - /tf
+        - /tf_static
+plugin_order: # plugin running orders. if you don't set field, plugin will be run in order in plugins field
+  start_plugin_order:  # start plugin running order
+    - rosbag_recorder_plugin  # 1st plugin name
+    - mail_notifier_plugin  #2nd plugin name
+  stop_plugin_order:  # start plugin running order
+    - rosbag_recorder_plugin
+    - mail_notifier_plugin
+```
+
+Sample plugin repository is [knorth55/app_manager_utils](https://github.com/knorth55/app_manager_utils).
+
+For more detailed information, please read [#25](https://github.com/PR2/app_manager/pull/25).
+
+## Maintainer
+
+Yuki Furuta <<[email protected]>>
diff --git a/bin/appmaster → app_manager/bin/appmaster b/bin/appmaster → app_manager/bin/appmaster
diff --git a/bin/rosget → app_manager/bin/rosget b/bin/rosget → app_manager/bin/rosget
diff --git a/launch/app_manager.launch → app_manager/launch/app_manager.launch b/launch/app_manager.launch → app_manager/launch/app_manager.launch
diff --git a/msg/App.msg → app_manager/msg/App.msg b/msg/App.msg → app_manager/msg/App.msg
diff --git a/msg/AppInstallationState.msg → app_manager/msg/AppInstallationState.msg b/msg/AppInstallationState.msg → app_manager/msg/AppInstallationState.msg
diff --git a/msg/AppList.msg → app_manager/msg/AppList.msg b/msg/AppList.msg → app_manager/msg/AppList.msg
diff --git a/msg/AppStatus.msg → app_manager/msg/AppStatus.msg b/msg/AppStatus.msg → app_manager/msg/AppStatus.msg
diff --git a/msg/ClientApp.msg → app_manager/msg/ClientApp.msg b/msg/ClientApp.msg → app_manager/msg/ClientApp.msg
diff --git a/msg/ExchangeApp.msg → app_manager/msg/ExchangeApp.msg b/msg/ExchangeApp.msg → app_manager/msg/ExchangeApp.msg
diff --git a/msg/Icon.msg → app_manager/msg/Icon.msg b/msg/Icon.msg → app_manager/msg/Icon.msg
diff --git a/msg/KeyValue.msg → app_manager/msg/KeyValue.msg b/msg/KeyValue.msg → app_manager/msg/KeyValue.msg
diff --git a/msg/StatusCodes.msg → app_manager/msg/StatusCodes.msg b/msg/StatusCodes.msg → app_manager/msg/StatusCodes.msg
diff --git a/package.xml → app_manager/package.xml b/package.xml → app_manager/package.xml
diff --git a/scripts/app_manager → app_manager/scripts/app_manager b/scripts/app_manager → app_manager/scripts/app_manager
diff --git a/scripts/test_app.py → app_manager/scripts/test_app.py b/scripts/test_app.py → app_manager/scripts/test_app.py
diff --git a/setup.py → app_manager/setup.py b/setup.py → app_manager/setup.py
diff --git a/src/app_manager/__init__.py → app_manager/src/app_manager/__init__.py b/src/app_manager/__init__.py → app_manager/src/app_manager/__init__.py
diff --git a/src/app_manager/app.py → app_manager/src/app_manager/app.py b/src/app_manager/app.py → app_manager/src/app_manager/app.py
diff --git a/src/app_manager/app_list.py → app_manager/src/app_manager/app_list.py b/src/app_manager/app_list.py → app_manager/src/app_manager/app_list.py
diff --git a/src/app_manager/app_manager.py → app_manager/src/app_manager/app_manager.py b/src/app_manager/app_manager.py → app_manager/src/app_manager/app_manager.py
diff --git a/src/app_manager/app_manager_plugin.py → ...ger/src/app_manager/app_manager_plugin.py b/src/app_manager/app_manager_plugin.py → ...ger/src/app_manager/app_manager_plugin.py
diff --git a/src/app_manager/exceptions.py → app_manager/src/app_manager/exceptions.py b/src/app_manager/exceptions.py → app_manager/src/app_manager/exceptions.py
diff --git a/src/app_manager/exchange.py → app_manager/src/app_manager/exchange.py b/src/app_manager/exchange.py → app_manager/src/app_manager/exchange.py
diff --git a/src/app_manager/master_sync.py → app_manager/src/app_manager/master_sync.py b/src/app_manager/master_sync.py → app_manager/src/app_manager/master_sync.py
diff --git a/srv/GetAppDetails.srv → app_manager/srv/GetAppDetails.srv b/srv/GetAppDetails.srv → app_manager/srv/GetAppDetails.srv
diff --git a/srv/GetInstallationState.srv → app_manager/srv/GetInstallationState.srv b/srv/GetInstallationState.srv → app_manager/srv/GetInstallationState.srv
diff --git a/srv/InstallApp.srv → app_manager/srv/InstallApp.srv b/srv/InstallApp.srv → app_manager/srv/InstallApp.srv
diff --git a/srv/ListApps.srv → app_manager/srv/ListApps.srv b/srv/ListApps.srv → app_manager/srv/ListApps.srv
diff --git a/srv/StartApp.srv → app_manager/srv/StartApp.srv b/srv/StartApp.srv → app_manager/srv/StartApp.srv
diff --git a/srv/StopApp.srv → app_manager/srv/StopApp.srv b/srv/StopApp.srv → app_manager/srv/StopApp.srv
diff --git a/srv/UninstallApp.srv → app_manager/srv/UninstallApp.srv b/srv/UninstallApp.srv → app_manager/srv/UninstallApp.srv
diff --git a/test/appA.app → app_manager/test/appA.app b/test/appA.app → app_manager/test/appA.app
diff --git a/test/applist0/.gitignore → app_manager/test/applist0/.gitignore b/test/applist0/.gitignore → app_manager/test/applist0/.gitignore
diff --git a/test/applist1/apps1.installed → app_manager/test/applist1/apps1.installed b/test/applist1/apps1.installed → app_manager/test/applist1/apps1.installed
diff --git a/test/applistbad/bad.installed → app_manager/test/applistbad/bad.installed b/test/applistbad/bad.installed → app_manager/test/applistbad/bad.installed
diff --git a/test/applistbad/bad2.installed → app_manager/test/applistbad/bad2.installed b/test/applistbad/bad2.installed → app_manager/test/applistbad/bad2.installed
diff --git a/test/empty.interface → app_manager/test/empty.interface b/test/empty.interface → app_manager/test/empty.interface
diff --git a/test/plugin/__init__.py → app_manager/test/plugin/__init__.py b/test/plugin/__init__.py → app_manager/test/plugin/__init__.py
diff --git a/test/plugin/package.xml → app_manager/test/plugin/package.xml b/test/plugin/package.xml → app_manager/test/plugin/package.xml
diff --git a/test/plugin/plugin.installed → app_manager/test/plugin/plugin.installed b/test/plugin/plugin.installed → app_manager/test/plugin/plugin.installed
diff --git a/test/plugin/plugin.yaml → app_manager/test/plugin/plugin.yaml b/test/plugin/plugin.yaml → app_manager/test/plugin/plugin.yaml
diff --git a/test/plugin/sample_node.py → app_manager/test/plugin/sample_node.py b/test/plugin/sample_node.py → app_manager/test/plugin/sample_node.py
diff --git a/test/plugin/sample_node.xml → app_manager/test/plugin/sample_node.xml b/test/plugin/sample_node.xml → app_manager/test/plugin/sample_node.xml
diff --git a/test/plugin/test_plugin.app → app_manager/test/plugin/test_plugin.app b/test/plugin/test_plugin.app → app_manager/test/plugin/test_plugin.app
diff --git a/test/plugin/test_plugin.interface → ...manager/test/plugin/test_plugin.interface b/test/plugin/test_plugin.interface → ...manager/test/plugin/test_plugin.interface
diff --git a/test/plugin/test_plugin.py → app_manager/test/plugin/test_plugin.py b/test/plugin/test_plugin.py → app_manager/test/plugin/test_plugin.py
diff --git a/test/resources/example-min.launch → ...manager/test/resources/example-min.launch b/test/resources/example-min.launch → ...manager/test/resources/example-min.launch
diff --git a/test/test1.interface → app_manager/test/test1.interface b/test/test1.interface → app_manager/test/test1.interface
diff --git a/test/test_app.py → app_manager/test/test_app.py b/test/test_app.py → app_manager/test/test_app.py
diff --git a/test/test_app.test → app_manager/test/test_app.test b/test/test_app.test → app_manager/test/test_app.test
diff --git a/test/test_app_list.py → app_manager/test/test_app_list.py b/test/test_app_list.py → app_manager/test/test_app_list.py
diff --git a/test/test_plugin.py → app_manager/test/test_plugin.py b/test/test_plugin.py → app_manager/test/test_plugin.py
diff --git a/test/test_plugin.test → app_manager/test/test_plugin.test b/test/test_plugin.test → app_manager/test/test_plugin.test
diff --git a/test/test_start_fail.py → app_manager/test/test_start_fail.py b/test/test_start_fail.py → app_manager/test/test_start_fail.py
diff --git a/test/test_start_fail.test → app_manager/test/test_start_fail.test b/test/test_start_fail.test → app_manager/test/test_start_fail.test
diff --git a/test/test_stop_app.py → app_manager/test/test_stop_app.py b/test/test_stop_app.py → app_manager/test/test_stop_app.py