summaryrefslogtreecommitdiffstats
path: root/tosca2heat/tosca-parser/doc/source/usage.rst
diff options
context:
space:
mode:
authorjulien zhang <zhang.jun3g@zte.com.cn>2016-04-22 08:43:26 +0000
committerGerrit Code Review <gerrit@172.30.200.206>2016-04-22 08:43:26 +0000
commit2fa4785aa218cf655f3405d832d2200d64fd033e (patch)
tree0061edccecca9a99aa9a50c6c0e2783c07370112 /tosca2heat/tosca-parser/doc/source/usage.rst
parent56c2a5d3ba6193c9a98870a264bc5e3aca19a086 (diff)
parentc8201c119ec686e79797721156767685fe848aca (diff)
Merge "Update tosca lib to version 0.5"
Diffstat (limited to 'tosca2heat/tosca-parser/doc/source/usage.rst')
-rw-r--r--tosca2heat/tosca-parser/doc/source/usage.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/tosca2heat/tosca-parser/doc/source/usage.rst b/tosca2heat/tosca-parser/doc/source/usage.rst
new file mode 100644
index 0000000..2b822a8
--- /dev/null
+++ b/tosca2heat/tosca-parser/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.