cabello/selector

Extract information from JSON, StdClass in a fashionable way

dev-master 2013-09-27 15:18 UTC

This package is not auto-updated.

Last update: 2024-10-26 15:34:15 UTC


README

Disclaimer

If you found this project but think it's incomplete or doesn't meet your needs, try Property Access.

Problem

Imagine that you have a StdClass (possibly created by a json_decode) instance full of attributes you want to retrieve. So you do something like this:

$username = $photo->owner->username;

What happens if username is undefined and/or owner?

$username = isset($photo) && isset($photo->owner) && isset($photo->owner->username)
          ? $photo->owner->username
          : 'anonymous';

Imagine this kind of logic spread all over your codebase. What a mess!

Solution

Selector turns the horrible code above into this:

$photoSelector = Selector($photo);
$username      = $photoSelector->getOne('owner.username', 'anonymous');

You never have to worry again about checking if the StdClass have the properties you need, and as a plus you receive several ways of retrieving data.

Features

Selector

Selector::getOne

Description

Parameters

Return Values

Examples

Example #1

The above example will output:

Example #2

The above example will output:

Selector::getAll

Description

Parameters

Return Values

Examples

Example #1

The above example will output:

Example #2

The above example will output:

Selector::findOne

Description

Parameters

Return Values

Examples

Example #1

The above example will output:

Example #2

The above example will output:

Selector::findAll

Description

Parameters

Return Values

Examples

Example #1

The above example will output:

Example #2

The above example will output:

Selector::getDictionary

Description

Parameters

Return Values

Examples

Example #1

The above example will output:

Example #2

The above example will output:

Developer

Assuming you have composer.phar installed, it's simple to contribute to Selector, fork, clone your repository and run:

cd selector # your clone folder
composer.phar install --dev
vendor/bin/phpunit tests

And you are ready to write new tests, contributions and sending pull requests. :octocat: