www.aleph1.co.uk Git - yaffs-website/blob - vendor/easyrdf/easyrdf/lib/EasyRdf/Parser/Rapper.php

   1 <?php
   2
   3 /**
   4  * EasyRdf
   5  *
   6  * LICENSE
   7  *
   8  * Copyright (c) 2009-2013 Nicholas J Humfrey.  All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright notice,
  15  *    this list of conditions and the following disclaimer in the documentation
  16  *    and/or other materials provided with the distribution.
  17  * 3. The name of the author 'Nicholas J Humfrey" may be used to endorse or
  18  *    promote products derived from this software without specific prior
  19  *    written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  31  * POSSIBILITY OF SUCH DAMAGE.
  32  *
  33  * @package    EasyRdf
  34  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  35  * @license    http://www.opensource.org/licenses/bsd-license.php
  36  */
  37
  38 /**
  39  * Class to parse RDF using the 'rapper' command line tool.
  40  *
  41  * @package    EasyRdf
  42  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  43  * @license    http://www.opensource.org/licenses/bsd-license.php
  44  */
  45 class EasyRdf_Parser_Rapper extends EasyRdf_Parser_Json
  46 {
  47     private $rapperCmd = null;
  48
  49     const MINIMUM_RAPPER_VERSION = '1.4.17';
  50
  51     /**
  52      * Constructor
  53      *
  54      * @param string $rapperCmd Optional path to the rapper command to use.
  55      * @return object EasyRdf_Parser_Rapper
  56      */
  57     public function __construct($rapperCmd = 'rapper')
  58     {
  59         $result = exec("$rapperCmd --version 2>/dev/null", $output, $status);
  60         if ($status != 0) {
  61             throw new EasyRdf_Exception(
  62                 "Failed to execute the command '$rapperCmd': $result"
  63             );
  64         } elseif (version_compare($result, self::MINIMUM_RAPPER_VERSION) < 0) {
  65             throw new EasyRdf_Exception(
  66                 "Version ".self::MINIMUM_RAPPER_VERSION." or higher of rapper is required."
  67             );
  68         } else {
  69             $this->rapperCmd = $rapperCmd;
  70         }
  71     }
  72
  73     /**
  74       * Parse an RDF document into an EasyRdf_Graph
  75       *
  76       * @param object EasyRdf_Graph $graph   the graph to load the data into
  77       * @param string               $data    the RDF document data
  78       * @param string               $format  the format of the input data
  79       * @param string               $baseUri the base URI of the data being parsed
  80       * @return integer             The number of triples added to the graph
  81       */
  82     public function parse($graph, $data, $format, $baseUri)
  83     {
  84         parent::checkParseParams($graph, $data, $format, $baseUri);
  85
  86         $json = EasyRdf_Utils::execCommandPipe(
  87             $this->rapperCmd,
  88             array(
  89                 '--quiet',
  90                 '--input', $format,
  91                 '--output', 'json',
  92                 '--ignore-errors',
  93                 '--input-uri', $baseUri,
  94                 '--output-uri', '-', '-'
  95             ),
  96             $data
  97         );
  98
  99         // Parse in the JSON
 100         return parent::parse($graph, $json, 'json', $baseUri);
 101     }
 102 }