[libvirt] [test-API PATCH v2] add new template file in docs

[Guannan Ren]

---
 docs/testcase.conf.templ |   70 ++++++++++++++++++++++++++++++++++++++++++++++
 docs/testcase.py.templ   |   48 +++++++++++++++++++++++++++++++
 2 files changed, 118 insertions(+), 0 deletions(-)
 create mode 100644 docs/testcase.conf.templ
 create mode 100644 docs/testcase.py.templ

diff --git a/docs/testcase.conf.templ b/docs/testcase.conf.templ
new file mode 100644
index 0000000..1ca351b
--- /dev/null
+++ b/docs/testcase.conf.templ
@@ -0,0 +1,70 @@
+# single line comments looks like this
+
+/*
+  Multiline comments look like this.
+  The lines enclosed by the C style comments will
+  be skipped by parser.py
+*/
+
+###############################################################
+# Indentation:
+# An indent level is four spaces, do not use tabs to indent.
+#
+
+# .----------- testcase: The first line contains the module name and the test case name separated by a colon and is not indented.
+# |
+domain:undefine
+
+#     .-------- options: Indent options by an indent level(four spaces)
+#     |
+    guestname
+
+#           .---- value: Indent Values by two indent levels(eight spaces)
+#          |
+        fedoraVM
+
+################################################################
+#
+# Keywords:  'clean', 'times', 'sleep', '{start_loop, end_loop}'
+#
+
+# 'clean': invoke the clean function in previous testcase
+clean
+
+# 'times': repeat testcase 'repos/domain/install_linux_cdrom.py' N times
+domain:install_linux_cdrom times 2
+    guestname
+       fedoraVM
+    memory
+       1024
+    vcpu
+       1
+
+# 'sleep 5': pause the run of testing for N seconds.
+sleep 5
+
+# The pair of 'start_loop' and 'end_loop' will
+# run the testcases between them N loops
+domain:start start_loop
+    guestname
+        fedoraVM
+
+domain:destroy end_loop 3
+    guestname
+        fedoraVM
+
+################################################################
+#
+# Options: 'times', 'cleanup'
+# always be the last line of testcase config file
+#
+
+#         .---------------------- repeat the above testcases n more times.
+#         |       .-------------- invoke the clean function in all of above testcases
+#         |       |
+options times=2 cleanup=enable
+
+# python libvirt-test-api.py -t repos/domain/undefine.py repos/domain/install_linux_cdrom.py \
+#                                repos/domain/start.py repos/domain/destroy.py
+#
+# The command generates a template of tescase file like above
diff --git a/docs/testcase.py.templ b/docs/testcase.py.templ
new file mode 100644
index 0000000..eae108f
--- /dev/null
+++ b/docs/testcase.py.templ
@@ -0,0 +1,48 @@
+#! /usr/bin/env python
+# How to write a new testcase
+
+# If testcase wants to use the connection object offered
+# by the framework or share variables between testcases
+# import sharedmod module.
+from src import sharedmod
+
+# parameters supported by the testcase in the two global variables:
+# required_params, tuple with a ',' at the end of last element.
+# optional_params, a dictionary with option and value pairs
+# Both variables are mandatory.
+required_params = ('guestname',)
+optional_params = {'vcpu', 1,
+                   'memory', 1048576,
+                  }
+
+# The check function is optional. This is for some testcases that
+# need to check whether specific hardware is present on box or
+# testing environment is good before testing.
+# Return value 0 means check pass, 1 means to skip the
+# testcase during running.
+def TESTCASE_check(params):
+    logger = params['logger']
+    ...
+    return 0
+
+# This is the main testing function, The function name must be
+# the same as the file name of the testcase. params['logger'] is
+# provided by framework for logging.
+# Return value 0 means the success of testing, 1 means testing failure.
+# It is mandatory.
+def TESTCASE(params):
+    logger = params['logger']
+    ...
+    return 0
+
+# The clean function is optional. This is for testcases that dirtied
+# testing environment after executed. If keyword 'clean' is set
+# just below the testcase in testcase config file, the clean function
+# defined in the testcase.py will be invoked by framework to do the
+# cleaning job.
+# Return value is optional too, 1 means clean failure, but will not
+# stop the run of testing.
+def TESTCASE_clean(params):
+    logger = params['logger']
+    ...
+    return 0
-- 
1.7.7.5