georgeh/php-beerxml

BeerXML parser and generator

1.0.0 2013-05-16 17:16 UTC

This package is not auto-updated.

Last update: 2024-04-22 09:23:22 UTC


README

Build Status Coverage Status

A PHP parser and generator for the BeerXML 1.0 standard.

Usage

Full API documentation is at http://georgeh.github.io/php-beerxml/

The unit tests in the tests/ directory provides some good examples as well.

Parser

$parser = new \BeerXML\Parser();
$result = $parser->parse(file_get_contents('http://www.beerxml.com/recipes.xml'));
foreach ($result as $recipe) {
    /** @var $recipe \BeerXML\Record\Recipe **/
    echo "Found beer recipe " . $recipe->getName() . "\n";
}

If you don't want to use the basic record classes from the BeerXML\Record namespace (say, you want to add some ABV math or some Doctrine annotations so your recipe can easily save to a database) it's possible to specify the classes that get generated. You'll need to implement the BeerXML\Parser\I*Writer interfaces in your classes, then subclass BeerXML\Parser\RecordFactory to have it create your classes. Once you've got your objects set up, you can pass it into the constructor of BeerXML\Parser

Generator

$recipe = new \BeerXML\Record\Recipe();
$recipe->setName('My Brew');

$generator = new \BeerXML\Generator();
$generator->addRecord($recipe);
$xml = $generator->render();
echo $xml;

BeerXML\Generator will accept any record that implements the BeerXML\Generator\I*Reader interfaces.

Records

There are a record classes for all the record types in the BeerXML specification that contain getter and setter methods. They implement the extended "Display" interfaces for the parser and generator, which means that include getters and setters from Appendix A of the spec. They do not include any math or compute any fields, as that is outside the scope of this project.

$recipe = new \BeerXML\Record\Recipe();
$recipe->setName('Imperial Session');
$recipe->setOg(1.105);
$recipe->setFg(1.002);
$recipe->setIbu(99);

Installation

Requires PHP 5.3.0 or higher.

The easiest way is to install php-beerxml with Composer.

Create a file named composer.json in your project root:

{
    "require": {
        "georgeh/php-beerxml": "*",
    }
}

Then, run the following commands:

$ curl -s http://getcomposer.org/installer | php
$ php composer.phar install

If you don't use Composer, you can directly download the sources and configure it with your PSR-0 compatible autoloader.

License

This software is free to use under the MIT license, but if you are happy with it I wouldn't mind one of your homebrews.

Copyright (c) 2013 George Hotelling

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Devtroit