Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mathieutu/exporter
Export the attributes you need from all your objects and arrays.
https://github.com/mathieutu/exporter
api arrays laravel objects resources symfony transformer
Last synced: 1 day ago
JSON representation
Export the attributes you need from all your objects and arrays.
- Host: GitHub
- URL: https://github.com/mathieutu/exporter
- Owner: mathieutu
- Created: 2018-01-04T07:34:06.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-07T04:10:40.000Z (3 months ago)
- Last Synced: 2024-12-15T13:06:06.597Z (8 days ago)
- Topics: api, arrays, laravel, objects, resources, symfony, transformer
- Language: PHP
- Homepage:
- Size: 1.21 MB
- Stars: 43
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Exporter: Export the attributes you need from all your objects and arrays.
## Installation
Require this package with composer:
```bash
composer require mathieutu/exporter
```
## Use cases
Because pictures are worth thousands words:
The Exporter package let you write this:
instead of that:
For example, I use it a lot with Laravel Eloquent Resources, or as an easier alternative of Symfony Normalizer:
## Usage
Use the `\MathieuTu\Exporter\Exporter` trait on your classes.
You also can use directly the `\MathieuTu\Exporter\ExporterService::exportFrom($exportable, $attributes)` static method on basic arrays or objects, or if you can't add the trait.
You can export from arrays, objects with `ArrayAccess` interface, or any standard objects.
The response will be a [Laravel Collection](https://laravel.com/docs/collections) (but you absolutely don't need Laravel, **this package is totally framework agnostic**).
If you don't know how to use collections, you can **use it exactly like an array**, or use `toArray()` method to get a real one.
### Examples
_(You can find all this examples and more in the [package tests](./tests/ExporterServiceTest.php))_
For the examples, and to cover all the possible ways to use this package, we'll consider this object as input:
```php
$object = new class
{
use \MathieuTu\Exporter\Exporter;
public $foo = 'testFoo';
private $bar = ['bar1' => 'testBar1', 'bar2' => 'testBar2', 'bar3' => 'testBar3'];
public $baz = [
(object) ['baz1' => 'baz1A', 'baz2' => 'baz2A', 'baz3' => 'baz3A'],
(object) ['baz1' => 'baz1B', 'baz2' => 'baz2B', 'baz3' => 'baz3B'],
(object) ['baz1' => 'baz1C', 'baz2' => 'baz2C', 'baz3' => 'baz3C'],
];
public function testWithParam(string $param): string
{
return 'test' . $param;
}
public function test(): string
{
return 'test' . date("l");
}
public function getBar(): array
{
return $this->bar;
}
};
```
and a standard array as output (in comment), instead of a Collection (result from the `$collection->toArray()` method).
#### Export public and private (with getter) root attributes
```php
$object->export(['foo']); // ['foo' => testFoo]
$object->export(['foo', 'bar']);
/*
[
'foo' => testFoo,
'bar' => ['bar1' => 'testBar1', 'bar2' => 'testBar2'],
]
*/
```
#### Export from nested array/object
- ##### In an array:
```php
$object->export(['bar' => ['bar2', 'bar3']]);
/*
[
'bar' => [
'bar2' => testBar2',
'bar3' => testBar3',
],
]
*/
```
- ##### Only one attribute:
```php
$object->export(['bar' => 'bar1']); // ['bar' => 'testBar1']
```
- ##### With dot notation:
```php
$object->export(['bar.bar1']); // ['bar.bar1' => 'testBar1']
```
- ##### Using a wildcard to export from lists:
```php
$object->export(['baz' => ['*' => ['baz1', 'baz3']]]);
/*
[
'baz' => [
['baz1' => 'baz1A', 'baz3' => 'baz3A'],
['baz1' => 'baz1B', 'baz3' => 'baz3B'],
['baz1' => 'baz1C', 'baz3' => 'baz3C'],
],
]
*/
```
#### Set an alias as key:
```php
$object->export(['foo', 'bar.bar2 as secondBar']);
/*
[
'foo' => testFoo,
'secondBar' => 'testBar2',
]
*/
```
#### Export result of a function
```php
$object->export(['testWithParam(Mathieu)']); // ['testWithParam' => testMathieu]
$object->export(['test()']); // ['test' => testFriday]
```
### License
This Exporter package is an open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).
### Contributing
Issues and PRs are obviously welcomed and encouraged, both for bugs and new features as well as documentation.
Each piece of code added should be fully tested, but we can do that all together, so please don't be afraid by that.