yaffs.net Git - yaffs-website/blob - vendor/easyrdf/easyrdf/lib/EasyRdf/Serialiser/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 serialise an EasyRdf_Graph to RDF
  40  * using the 'rapper' command line tool.
  41  *
  42  * Note: the built-in N-Triples serialiser is used to pass data to Rapper.
  43  *
  44  * @package    EasyRdf
  45  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  46  * @license    http://www.opensource.org/licenses/bsd-license.php
  47  */
  48 class EasyRdf_Serialiser_Rapper extends EasyRdf_Serialiser_Ntriples
  49 {
  50     private $rapperCmd = null;
  51
  52     /**
  53      * Constructor
  54      *
  55      * @param string $rapperCmd Optional path to the rapper command to use.
  56      * @return object EasyRdf_Serialiser_Rapper
  57      */
  58     public function __construct($rapperCmd = 'rapper')
  59     {
  60         $result = exec("$rapperCmd --version 2>/dev/null", $output, $status);
  61         if ($status != 0) {
  62             throw new EasyRdf_Exception(
  63                 "Failed to execute the command '$rapperCmd': $result"
  64             );
  65         } else {
  66             $this->rapperCmd = $rapperCmd;
  67         }
  68     }
  69
  70     /**
  71      * Serialise an EasyRdf_Graph to the RDF format of choice.
  72      *
  73      * @param EasyRdf_Graph $graph   An EasyRdf_Graph object.
  74      * @param string        $format  The name of the format to convert to.
  75      * @param array         $options
  76      * @return string The RDF in the new desired format.
  77      */
  78     public function serialise($graph, $format, array $options = array())
  79     {
  80         parent::checkSerialiseParams($graph, $format);
  81
  82         $ntriples = parent::serialise($graph, 'ntriples');
  83
  84         // Hack to produce more concise RDF/XML
  85         if ($format == 'rdfxml') {
  86             $format = 'rdfxml-abbrev';
  87         }
  88
  89         return EasyRdf_Utils::execCommandPipe(
  90             $this->rapperCmd,
  91             array(
  92                 '--quiet',
  93                 '--input', 'ntriples',
  94                 '--output', $format,
  95                 '-', 'unknown://'
  96             ),
  97             $ntriples
  98         );
  99     }
 100 }