summaryrefslogtreecommitdiffstats
path: root/nfvparser/src/main/python/README.md
diff options
context:
space:
mode:
authorZhaoxing <meng.zhaoxing1@zte.com.cn>2017-07-19 07:24:51 +0800
committerZhaoxing <meng.zhaoxing1@zte.com.cn>2017-07-19 07:45:28 +0800
commitdb87c4f77a730e571338c2bf7bfcc9fdc5272185 (patch)
tree54504cabbb5d319403edc8d123e39f437d2f331a /nfvparser/src/main/python/README.md
parent1a112663a18408161787f78f01d354a33f070957 (diff)
init nfvparser code
Change-Id: I8e264c87777e36c4a42f0aa42ab4ae66a1d59a0b Signed-off-by: Zhaoxing <meng.zhaoxing1@zte.com.cn>
Diffstat (limited to 'nfvparser/src/main/python/README.md')
-rw-r--r--nfvparser/src/main/python/README.md55
1 files changed, 55 insertions, 0 deletions
diff --git a/nfvparser/src/main/python/README.md b/nfvparser/src/main/python/README.md
new file mode 100644
index 0000000..4883bd1
--- /dev/null
+++ b/nfvparser/src/main/python/README.md
@@ -0,0 +1,55 @@
+========================
+Team and repository tags
+========================
+
+.. image:: http://governance.openstack.org/badges/tosca-parser.svg
+ :target: http://governance.openstack.org/reference/tags/index.html
+
+.. Change things from this point on
+
+===============
+TOSCA Parser
+===============
+
+Overview
+--------
+
+The TOSCA Parser is OPNFV project based on the OpenStack project and licensed under Apache 2. It is
+developed to parse nfv TOSCA simple Profile and TOSCA Simple Profile in YAML. It reads the TOSCA
+templates and creates an in-memory object or json file(for future) about graph of TOSCA nodes and
+their relationship.
+
+Architecture
+------------
+
+The TOSCA Parser takes TOSCA YAML template or TOSCA Cloud Service Archive (CSAR)
+file as an input, with optional input of dictionary of needed parameters with their
+values, and produces in-memory objects of different TOSCA elements with their
+relationship to each other. It also creates a graph of TOSCA node templates and their
+relationship.
+
+The ToscaTemplate class located in the toscaparser/tosca_template.py is an entry
+class of the parser and various functionality of parser can be used by initiating
+this class. In order to see an example usage of TOSCA Parser from a separate tool,
+refer to the OpenStack heat-translator class TranslateTemplate located in the
+translator/osc/v1/translate.py module. The toscaparser/shell.py module of tosca-parser
+also provides a good reference on how to invoke TOSCA Parser from Command Line Interface.
+
+The toscaparser/elements sub-directory contains various modules to handle
+various TOSCA type elements like node type, relationship type etc. The
+entity_type.py module is a parent of all type elements. The toscaparser
+directory contains various python module to handle service template including
+topology template, node templates, relationship templates etc. The
+entity_template.py is a parent of all template elements.
+
+
+How To Use
+----------
+Please refer to `doc/source/usage.rst <https://github.com/openstack/tosca-parser/blob/master/doc/source/usage.rst>`
+
+Project Info
+------------
+
+* License: Apache License, Version 2.0
+* Source: http://git.openstack.org/cgit/openstack/tosca-parser/
+