From 374ad482811eb1ee0eb0db49a23ab12318010c46 Mon Sep 17 00:00:00 2001
From: "Bocklage, Jens" <Jens_Bocklage@mentor.com>
Date: Fri, 7 Oct 2016 12:02:01 +0200
Subject: [PATCH] Add new command line test descriptions for the provided D-Bus
 interfaces.

Signed-off-by: Bocklage, Jens <Jens_Bocklage@mentor.com>
---
 HomeScreen/test/commandlinetests.txt |  36 -----
 test/commandlinetests.txt            | 301 +++++++++++++++++++++++++++++++++++
 2 files changed, 301 insertions(+), 36 deletions(-)
 delete mode 100644 HomeScreen/test/commandlinetests.txt
 create mode 100644 test/commandlinetests.txt

diff --git a/HomeScreen/test/commandlinetests.txt b/HomeScreen/test/commandlinetests.txt
deleted file mode 100644
index da6458e..0000000
--- a/HomeScreen/test/commandlinetests.txt
+++ /dev/null
@@ -1,36 +0,0 @@
-Command line tests
-
-Preconditions:
-- HomeScreen app is running
-
-[Test] Popup Interface
-[Command Line] dbus-send --session --type=method_call --dest=org.agl.homescreen /Popup org.agl.popup.showPopup int32:1 string:"TEST"
-[Expected Behavior] A popup is shown with the text "TEST" and an "OK" button
----------------------------------------------------------------------------------------------------------------------
-[Test] Status Bar Interface
-[Command Line] dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.getAvailablePlaceholders
-[Expected Behavior] The list of available placeholders is returned:
-   array [
-      int32 1
-      int32 2
-      int32 3
-      int32 4
-      int32 5
-   ]
-
-[Command Line] dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.setStatusIcon int32:1 string:"/home/...PUT_YOUR_TEST_PNG_HERE....png"
-The value range for the int32 is 1 to 5.
-[Expected Behavior] The picture is shown in the status bar in the placeholder 1 (to 5)
-
-[Command Line] dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.getStatusIcon int32:1 
-The value range for the int32 is 1 to 5.
-[Expected Behavior] The picture URI of placeholder 1 (to 5)
-
-[Command Line] dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.setStatusText int32:1 string:"hello"
-The value range for the int32 is 1 to 5.
-[Expected Behavior] The text "hello" is shown in the status bar in the placeholder 1 (to 5)
-
-[Command Line] dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.getStatusText int32:1 
-The value range for the int32 is 1 to 5.
-[Expected Behavior] The text of placeholder 1 (to 5)
-
diff --git a/test/commandlinetests.txt b/test/commandlinetests.txt
new file mode 100644
index 0000000..ff2bf7b
--- /dev/null
+++ b/test/commandlinetests.txt
@@ -0,0 +1,301 @@
+Command line tests
+
+Precondition for all test is, that the D-Bus session is launched:
+$export `dbus-launch`
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.appframework
+
+Method:
+      <method name="getAvailableAppNames">
+        <arg name="names" type="as" direction="out"/>
+      </method>
+
+Preconditions:
+- HomeScreenAppFrameworkBinderTizen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreenappframeworkbindertizen /AppFramework org.agl.appframework.getAvailableAppNames
+
+Method:
+      <method name="launchApp">
+        <arg name="name" type="s" direction="in"/>
+        <arg name="pid" type="i" direction="out"/>
+      </method>
+
+Preconditions:
+- HomeScreenAppFrameworkBinderTizen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreenappframeworkbindertizen /AppFramework org.agl.appframework.launchApp string:"org.tizen.amhelloworld"
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.daynightmode
+
+Signal:
+    <signal name="dayNightMode">
+      <arg name="mode" type="i" direction="out"/>
+    </signal>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+no command line test available right now
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.homescreen
+
+Method:
+    <method name="hardKeyPressed">
+      <arg name="key" type="i" direction="in"/> <!-- using the inputevent.hpp InputEvent::HardKey type -->
+    </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /HomeScreen org.agl.homescreen.hardKeyPressed int32:0
+
+Method:
+    <method name="setToFullscreen">
+      <arg name="pid" type="i" direction="in"/>
+    </method>
+
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /HomeScreen org.agl.homescreen.setToFullscreen int32:0
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.inputevent
+
+Method:
+    <method name="hardKeyPressed">
+      <arg name="key" type="i" direction="in"/>
+    </method>
+
+Preconditions:
+- HomeScreen app is running
+- InputEventManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.inputeventmanager /InputEvent org.agl.inputevent.hardKeyPressed int32:0
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.popup
+
+Method:
+    <method name="showPopup">
+      <arg name="type" type="i" direction="in"/>
+      <arg name="text" type="s" direction="in"/>
+    </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --dest=org.agl.homescreen /Popup org.agl.popup.showPopup int32:1 string:"TEST"
+
+Method:
+    <method name="showPopupComboBox">
+      <arg name="text" type="s" direction="in"/>
+      <arg name="choices" type="as" direction="in"/>
+    </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --dest=org.agl.homescreen /Popup org.agl.popup.showPopupComboBox string:"TEST" array:string:"test1","test2"
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.proximity
+
+Method:
+    <method name="setObjectDetected">
+      <arg name="detected" type="b" direction="in"/>
+    </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --dest=org.agl.homescreen /Proximity org.agl.proximity.setObjectDetected boolean:true
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.statusbar
+
+Method:
+      <method name="getAvailablePlaceholders">
+        <arg name="placeholderIndexes" type="ai" direction="out"/>
+        <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QList&lt;int&gt;"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.getAvailablePlaceholders
+
+Method:
+      <method name="getStatusText">
+        <arg name="placeholderIndex" type="i" direction="in"/>
+        <arg name="text" type="s" direction="out"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.getStatusText int32:1
+
+Method:
+      <method name="getStatusIcon">
+        <arg name="placeholderIndex" type="i" direction="in"/>
+        <arg name="iconURI" type="s" direction="out"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.getStatusIcon int32:1
+
+Method:
+      <method name="setStatusText">
+        <arg name="placeholderIndex" type="i" direction="in"/>
+        <arg name="text" type="s" direction="in"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.setStatusText int32:1 string:"Test1"
+
+Method:
+      <method name="setStatusIcon">
+        <arg name="placeholderIndex" type="i" direction="in"/>
+        <arg name="iconURI" type="s" direction="in"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.homescreen /StatusBar org.agl.statusbar.setStatusIcon int32:1 string:"<path to png file here>"
+
+---------------------------------------------------------------------------------------------------------------------
+Interface:
+org.agl.windowmanager
+
+Method:
+      <method name="addLayout">
+        <arg name="layoutId" type="i" direction="in"/>
+        <arg name="layoutName" type="s" direction="in"/>
+        <arg name="surfaceAreas" type="a(iiii)" direction="in"/>
+        <annotation name="org.qtproject.QtDBus.QtTypeName.In2" value="QList&lt;SimpleRect&gt;"/>
+        <arg name="error" type="i" direction="out"/>
+      </method>
+
+Preconditions:
+- WindowManager app is running
+
+Test:
+it is not possible to send isa(iiii) via the dbus-send tool.
+
+Method:
+      <method name="getAvailableLayouts">
+        <arg name="numberOfAppSurfaces" type="i" direction="in"/>
+        <arg name="layoutIds" type="ai" direction="out"/>
+        <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QList&lt;int&gt;"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.getAvailableLayouts int32:1
+
+
+
+Method:
+      <method name="setLayoutById">
+        <arg name="layoutId" type="i" direction="in"/>
+      </method>
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.getAvailableLayouts int32:1
+
+Method:
+      <method name="setLayoutByName">
+        <arg name="layoutName" type="s" direction="in"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.setLayoutByName string:"name"
+
+Method:
+      <method name="getLayout">
+        <arg name="layoutId" type="i" direction="out"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.getLayout
+
+Method:
+      <method name="setSurfaceToLayoutArea">
+        <arg name="surfaceId" type="i" direction="in"/>
+        <arg name="layoutAreaId" type="i" direction="in"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.setSurfaceToLayoutArea int32:1123 int32:1
+
+Method:
+      <method name="getAvailableSurfaces">
+        <arg name="surfacesAndPids" type="a(ii)" direction="out"/>
+        <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QList&lt;SimplePoint&gt;"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.getAvailableSurfaces
+
+Method:
+      <method name="getLayoutName">
+        <arg name="layoutId" type="i" direction="in"/>
+        <arg name="layoutName" type="s" direction="out"/>
+      </method>
+
+Preconditions:
+- HomeScreen app is running
+- WindowManager app is running
+
+Test:
+$dbus-send --session --type=method_call --print-reply --dest=org.agl.windowmanager /windowmanager org.agl.windowmanager.getLayoutName int32:1
+
-- 
2.16.6