This repository contains the source code of the base constituent parser which supports the following languages:

• English
• Spanish
• Italian
• French

The parser takes KAF documents (with elements as it needs tokenized text) as standard input and outputs constituent syntactic analysis in KAF or treebank format. It also provides an option of outputting the constituent heads, as defined by Collins PhD thesis.

• Java 1.7 or newer
• Ruby 1.9.2 or newer

Development requirements:

• Maven
• Bundler

Installing as a regular Gem:

gem install opener-constituent-parser-base

Using Bundler:

gem 'opener-constituent-parser-base',
  :git    => '[email protected]:opener-project/constituent-parser-base.git',
  :branch => 'master'

Using specific install:

gem install specific_install
gem specific_install opener-constituent-parser-base \
   -l https://github.com/opener-project/constituent-parser-base.git

cat some_input_file.kaf | constituent-parser-base

First make sure all the required dependencies are installed:

bundle install

Then compile the required Java code:

bundle exec rake compile

For this you'll need to have Java 1.7 and Maven installed. These requirements are verified for you before the Rake task calls Maven.

To run the tests (which are powered by Cucumber), simply run the following:

bundle exec rake

This will take care of verifying the requirements, installing the required Java packages and running the tests.

For more information on the available Rake tasks run the following:

bundle exec rake -T

This repository comes in two parts: a collection of Java source files and Ruby source files. The Java code can be found in the core/ directory, everything else will be Ruby source code.