Skip to content

Laravel 5 wrapper for the jmespath.php library

License

Notifications You must be signed in to change notification settings

LorensoD/laravel-jmespath

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

laravel-jmespath

A Laravel 8 wrapper for use of the jmespath.php library. The jmespath.php library is an implementation of the JMESPath specification.

This package also provides Artisan commands to pre-compile and manage your JMESPath expressions.

Thanks to pakages developed by libtek libtek/laravel-jmespath and ofumbi ofumbi/laravel-jmespath.

Use this package carefully, actually, I only update dependencies to allow your installation on my projects.

Installation

Install through composer

$ composer require neftaio/laravel-jmespath

Add Service Provider

In config/app.php, add the service provider to the $providers array:

'providers' => [
    // ...
    Neftaio\Jmes\JmesServiceProvider::class,
],

Add alias

In config/app.php, add the facade to the $aliases array:

'aliases' => [
    // ...
    'Jmes' => Neftaio\Jmes\Facades\Jmes::class,
],

Publish the configuration file

If you'd like to modify the default configuration values or define expressions to pre-compile, publish the package config file:

php artisan vendor:publish --provider="Neftaio\Jmes\JmesServiceProvider"

This will create a jmes.php file in your config directory.

Usage

With facade:

$result = Jmes::search($expression, $data);

Helper function:

$result = jmes($expression, $data);

Search Collection: // Returns array or string

$names = collect($data);
$result = $names->search($expression);

Artisan commands

Two Artisan commands are available with the package:

jmes:compile

This compiles and caches JMESPath expressions. Expressions can be sourced in multiple ways:

  1. Running the command with no options or arguments will look for expressions in the jmes.php config file:

    php artisan jmes:compile
  2. Passing a single expression to the command:

    php artisan jmes:compile 'foo.*.baz'
  3. Setting the -c or --cli option will prompt for expressions to be added manually:

    php artisan jmes:compile --cli
    
     Please enter a JMESPath expression:
     > foo.*.baz

jmes:clear

This will delete any previously compiled expressions:

php artisan jmes:clear

Pass -h or --help to either command to view its usage.

About

Laravel 5 wrapper for the jmespath.php library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%