======Calabash XProc Extension Module======
The Calabash xproc implementation is supported as an extension module to xmlsh.  This allows running xproc pipelines from within the same JVM as xmlsh and using native xmlsh syntax.   For example, input and output ports in xproc are supported via named ports in xmlsh.

=====Download=====
Calabash extension module is on sourceforge in the calabsh_ext package under xmlsh.
Download the latest binary from [[https://sourceforge.net/projects/xmlsh/files/]].  Look under the "calabash_ext" folder.

This module requires at least version 1.1.8 of xmlsh

=====Installation=====

To run this module you must include the supplied calabash_ext.jar
as well as the following jar files required for calabas


calabash.jar
	Calabash runtime from http://xmlcalabash.com/download/
	
Calabash optionally uses the following additional files beyond what is included in xmlsh

commons-httpclient-3.1.jar
commons-loggin-1.1.1.jar
commons-logging-api-1.1.1.jar
commons-codec-1.3.jar

See http://hc.apache.org/httpclient-3.x/dependencies.html for list of dependancies
For HTTP support include the Commons HTTP client from http://hc.apache.org/downloads.cgi
Also requires the commons logging jar from http://commons.apache.org/downloads/download_logging.cgi
Also requries common codec from http://commons.apache.org/downloads/download_codec.cgi


isorelax.jar
For relax-ng support, ISO Relax from http://sourceforge.net/projects/iso-relax/

Other jar's may be needed for optional components, see the calabash web site for details
msv.jar
tagsoup-1.2.jar

For PDF support  you may need a free or commercial license for RenderX XEP from http://services.renderx.com/Content/tools/xep.html
xep.jar 


Place above jar files in the same directory as calabash_ext.jar and module.xml
Alternatively you can edit module.xml and change the paths to the Dependant jars.

=====Importing=====

Import the calabash extension in xmlsh with an "import module" statement
The module can be found using the XMODPATH variable or explicitly by specifying the module.xml file

e.g.
   XMODPATH=/usr/local/xmlsh/ext
   import module calabash
   
or
   import module /usr/local/xmlsh/ext/calabash/module.xml
 
the following commands are supported
  xproc
  

Example.
Assuming that XMODPATH refers to a directory which includes the "calabash" directory which in turn includes the module.xml and the dependant jars.

%%
$ import module calabash
%%

Or you can use a prefix for the module
%%
$ import module c=calabash
%%



=====Configuring =====
If you want to configure calabash, you can do so as documented in the Calabash Home page.
It runs fine without any configuration.

=====Running=====
Your now ready to run xproc from within xmlsh.

The following commands are supported
	- [[CalabashXproc xproc]]

----
[[Modules Extension Modules]]