summaryrefslogtreecommitdiffstats
path: root/tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst
diff options
context:
space:
mode:
authorzhipengh <zhipengh512@gmail.com>2015-12-22 15:04:53 +0800
committerzhipengh <zhipengh512@gmail.com>2015-12-22 15:04:53 +0800
commitb678c5bfea0f1b142c2a4a5bdee1e3309a021887 (patch)
tree493ec289254370057daaaded00fd1b4761783c86 /tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst
parent828f613ea0c3e334eacf3f7857252246708d1c88 (diff)
JIRA:PARSER-15 Provide Standalone Heat-Translator Liberty Pypi Packages
Diffstat (limited to 'tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst')
-rw-r--r--tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst b/tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst
new file mode 100644
index 0000000..2b822a8
--- /dev/null
+++ b/tosca2heat/tosca-parser-0.3.0/doc/source/usage.rst
@@ -0,0 +1,16 @@
+=====
+Usage
+=====
+
+The TOSCA Parser can be used as a library by any client program, for example,
+OpenStack heat-translator uses it to translate TOSCA to Heat Orchestration
+Template (HOT).
+
+For an easy reference on how TOSCA Parser can be used programmatically or to
+test that the a TOSCA template passes validation, refer to the tosca_parser.py
+test program which is located at the root level of the project. Alternatively,
+you can install 0.3.0 or higher PyPI release of TOSCA-Parser as available at the
+https://pypi.python.org/pypi/tosca-parser and test use the parser via CLI
+entry point as::
+ tosca-parser --template-file=toscaparser/tests/data/tosca_helloworld.yaml
+The value to the --template-file is required to be a relative or an absolute path.