= Synopsis

A ruby library for ADL parser which includes cADL and dADL parser.

= Requirements

* Ruby 1.8 or later.
* Yaparc Library 0.2.2 or later.
* Tested in Ruby 1.8.6.
* if you use Ruby 1.6, you should prepare racc runtime environment and some adjustment.

= Usage

The script 'bin/adl_validator.rb' validates given ADL files.

  Usage: bin/adl_validator.rb [file_name|http://location.to.adl]+ [options]
      -v, --verbose                    display verbose message(Not Implemented Yet)
      -h, --help                       display this help

In order to validate an ADL file on your local machine, just give the file name as an argument as follows.

 $ bin/adl_validator.rb tests/openEHR-EHR-CLUSTER.exam-chest.v1.adl
 =>
 Accepted 'tests/openEHR-EHR-CLUSTER.exam-chest.v1.adl'

If you want to validate a remote ADL file on the web, specify its URL location.

 $ bin/adl_validator.rb http://svn.openehr.org/knowledge/archetypes/dev/adl/openehr/ehr/cluster/openEHR-EHR-CLUSTER.auscultation-chest.v1.adl
 =>
 Accepted 'http://svn.openehr.org/knowledge/archetypes/dev/adl/openehr/ehr/cluster/openEHR-EHR-CLUSTER.auscultation-chest.v1.adl'

In addition, you can try unit testing.

 $ rake test

= Files and Paths

* Path
+ bin --+--- adl_validator.rb
+ lib --+--- parser.rb
        +--- parser.y
        +--- validator.rb
        +--- shell.rb

* bin/adl_validator.rb
The command-line ADL validator.

* lib/parser.rb
This is the key library for ADL parsing. This parser algorithm is LALR implemented in racc library.
This file contains one module and one class first generated by racc from grammertical definition of parser.y.
Main class is ADLParser that scans ADL and parses both cADL and dADL.

= License

This product is under openEHR Open Source Software License

The openEHR Foundation uses the Mozilla Tri-license 1.1 on all software copyrighted to the Foundation. This licence essentially provides the user a choice of licence conditions under which to operate with any given piece of software, being: the Mozilla Public licence (MPL), and the Free Software Foundation GNU General Public Licence (GPL) and Lesser GNU Public Licence (LGPL). See the Mozilla relicensing FAQ for details of this license. This in no way constrains the way in which software created by other organisations is licenced.