====HowTo Start Development in Parser====

**Add Your Credentials:**

First of all you need to authorize yourself with opnfv gerrit.

Go to https://gerrit.opnfv.org/gerrit/#/admin/projects/parser , for first time set up there will prompt a setup page. What you need to do is copy&paste your ssh info to fill into the blank, and then fill out the committer agreement at the bottom, then you are good to go :)

**JIRA Setup:**

We use JJIRA for ISSUE Tracking, so it is better before you push your patches you register the corresponding issue with JIRA

[[http://jira.opnfv.org | Create an issue in JIRA ]]:

{{:parser:parser_setup.png?300|}}

{{:parser:parser_jira.png?300|}}

**Basic Git Ops For Set Up:**

Next you will need to set up your basic env locally in order to work, I will present my procedure as an example. For seasoned devs, this should be very basic and simple.

[[https://wiki.opnfv.org/developer | OPNFV Dev general setup]]

Note: Install Both git and git-review.

If you are not familiar with git, mimic the procedure shown below:

[[https://gist.github.com/hannibalhuang/15871a332ecd271f16ff | Parser Setup Intro]]

         zhipengh@zhipeng-pc:~/Workspace$ git clone ssh://zhipengh@gerrit.opnfv.org:29418/parser && scp -p -P 29418 zhipengh@gerrit.opnfv.org:hooks/commit-msg parser/.git/hooks/
         zhipengh@zhipeng-pc:~/Workspace$ cd parser/
         zhipengh@zhipeng-pc:~/Workspace/parser$ git review -s
         Creating a git remote called "gerrit" that maps to:
	           ssh://zhipengh@gerrit.opnfv.org:29418/parser.git
         zhipengh@zhipeng-pc:~/Workspace/parser$ mkdir yang2tosca/
         zhipengh@zhipeng-pc:~/Workspace/parser$ vim yang2tosca/README.md
         zhipengh@zhipeng-pc:~/Workspace/parser$ mkdir tosca2heat/
         zhipengh@zhipeng-pc:~/Workspace/parser$ vim tosca2heat/README.md
         zhipengh@zhipeng-pc:~/Workspace/parser$ mkdir docs/
         zhipengh@zhipeng-pc:~/Workspace/parser$ vim docs/intro.md
         zhipengh@zhipeng-pc:~/Workspace/parser$ git add . 
         zhipengh@zhipeng-pc:~/Workspace/parser$ git commit --signoff --all -m "JIRA:PARSER-1 -Basic Setup For Parser Gerrit Repo"
         [master 4de48c5] JIRA:PARSER-1 -Basic Setup For Parser Gerrit Repo
         3 files changed, 3 insertions(+)
         create mode 100644 docs/intro.md
         create mode 100644 tosca2heat/README.md
         create mode 100644 yang2tosca/README.md
         zhipengh@zhipeng-pc:~/Workspace/parser$ git review
         remote: 
         remote: Processing changes: new: 1, refs: 1, done    
         remote: 
         remote: New Changes:
         remote:   https://gerrit.opnfv.org/gerrit/170
         remote: 
         To ssh://zhipengh@gerrit.opnfv.org:29418/parser.git
         * [new branch]      HEAD -> refs/publish/master

Note: if gives error on email mismatch, then do :

         git config user.email yournewemail@example.org
         git commit --amend --reset-author

The screen shot for the first Parser patch:

{{:parser:parser_gerrit_review_first.png?300|}}

Patch merged into master

{{:parser:parser_merged.png?300|}}