andylolz/everypolitician-popolo

Parse EveryPolitician-flavoured Popolo data, and navigate it with PHP

everypolitician-popolo for PHP

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

This is a port of the Python package everypolitician-popolo-python to PHP, which itself is a port of the Ruby gem everypolitician-popolo to Python., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require andylolz/everypolitician-popolo, <sub>(*4)</sub>

## Usage

You can download a Popolo file manually from [EveryPolitician](http://everypolitician.org/).

The following example uses [Åland Lagting](https://github.com/everypolitician/everypolitician-data/raw/master/data/Aland/Lagting/ep-popolo-v1.0.json)
(which is the legislature of the Åland islands, available as
JSON data from the [EveryPolitician page for Åland](http://everypolitician.org/aland/)).

First you'll need to require the library and read in a file from disk.

``` php
use \EveryPolitician\EveryPoliticianPopolo\Popolo;
$popolo = Popolo::fromFilename('ep-popolo-v1.0.json');

All Popolo classes used by EveryPolitician are implemented:, <sub>(*5)</sub>

• Person
• Organization
• Area
• Event
• Membership

There are methods defined for each property on a class, e.g. for a Person:, <sub>(*6)</sub>

``` php count($popolo->persons); // 60 $person = $popolo->persons->first; echo $person->id; // e3aab23e-a883-4763-be0d-92e5936024e2 echo $person->name; // Aaltonen Carina echo $person->image; // http://www.lagtinget.ax/files/aaltonen_carina.jpg echo $person->wikidata; // Q4934081, <sub>(*7)</sub>

You can also find individual records or collections based on their
attributes:

``` php
echo $popolo->persons->get(["name" => "Aaltonen Carina"]); // <Person: Aaltonen Carina>

$organizations = $popolo->organizations->filter(["classification" => "party"]);
foreach ($organizations as $organization) {
    echo $organization;
}
// <Organization: Liberalerna>
// <Organization: Liberalerna på Åland r.f.>
// <Organization: Moderat Samling>
// <Organization: Moderat Samling på Åland r.f.>
// <Organization: Moderat samling>
// <Organization: Moderaterna på Åland>
// <Organization: Obunden Samling>
// <Organization: Obunden Samling på Åland>
// <Organization: Ålands Framtid>
// <Organization: Ålands Socialdemokrater>
// <Organization: Ålands framtid>
// <Organization: Ålands socialdemokrater>
// <Organization: Åländsk Center>
// <Organization: Åländsk Center r.f.>
// <Organization: Åländsk Demokrati>
// <Organization: Åländsk center>

Change log

Please see CHANGELOG for information on what has changed recently., <sub>(*8)</sub>

Testing

bash $ composer test, <sub>(*9)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*10)</sub>

Credits

• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*11)</sub>