feat: initial commit

Author: Steve Porter

.editorconfig

@@ -0,0 +1,15 @@
+; This file is for unifying the coding style for different editors and IDEs.
+; More information at http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_size = 4
+indent_style = space
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.gitignore

@@ -0,0 +1,9 @@
+*.project
+*.sublime-project
+*.sublime-workspace
+.DS_Store
+.idea/
+composer.lock
+composer.phar
+phpunit.phar
+vendor

.travis.yml

@@ -0,0 +1,18 @@
+language: php
+
+php:
+  - 7.0
+  - 7.1
+  - 7.2
+
+env:
+  matrix:
+    - COMPOSER_FLAGS="--prefer-lowest"
+    - COMPOSER_FLAGS=""
+
+before_script:
+  - travis_retry composer self-update
+  - travis_retry composer update ${COMPOSER_FLAGS} --no-interaction --prefer-source
+
+script:
+  - vendor/bin/phpunit

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to `laravel-recursive-collection` will be documented in this file
+
+## 1.0.0 - 2018-01-10
+- initial release

README.md

@@ -0,0 +1,65 @@
+Laravel Recursive Collection
+===============
+
+[![Latest Stable Version](http://img.shields.io/github/release/designmynight/laravel-recursive-collection.svg)](https://packagist.org/packages/designmynight/laravel-recursive-collection) [![Total Downloads](http://img.shields.io/packagist/dm/designmynight/laravel-recursive-collection.svg)](https://packagist.org/packages/designmynight/laravel-recursive-collection)
+
+A service provider to add support for for converting nested arrays and associve arrays into laravel collections
+
+Table of contents
+-----------------
+* [Installation](#installation)
+* [Example](#example)
+
+Installation
+------------
+
+Installation using composer:
+
+```sh
+composer require designmynight/laravel-recursive-collection
+```
+
+### Laravel version Compatibility
+
+ Laravel  | Package
+:---------|:----------
+ 5.5.x    | 1.0.x
+
+And add the service provider in `config/app.php`:
+
+```php
+DesignMyNight\Laravel\RecursiveCollectionServiceProvider::class,
+```
+
+For usage with [Lumen](http://lumen.laravel.com), add the service provider in `bootstrap/app.php`.
+
+```php
+$app->register(DesignMyNight\Laravel\RecursiveCollectionServiceProvider::class);
+```
+
+Example
+------------
+
+```
+$data = [
+    [
+        'name' => 'John Doe',
+        'email' => '[email protected]',
+        'bookings' => [
+            [
+                'venue' => 'Venue A',
+                'date' => '2000-01-01'
+                'guests' => 2
+            ],
+            [
+                'venue' => 'Venue B',
+                'date' => '2001-01-01'
+                'guests' => 2
+            ],
+        ],
+    ],
+];
+
+$collection = (new Collection($data))->recursive();
+$collection = collect($data)->recursive(); // Shorthand
+```

composer.json

@@ -0,0 +1,44 @@
+{
+    "name": "designmynight/laravel-recursive-collection",
+    "description": "A package to convert nested arrays and associative arrays into nested collections",
+    "homepage": "https://github.com/designmynight/laravel-recursive-collection",
+    "license": "MIT",
+    "keywords": [
+        "laravel",
+        "laravel-collection",
+        "laravel-recursive-collection",
+        "collection",
+        "designmynight"
+    ],
+    "require": {
+        "illuminate/support": "^5.5"
+    },
+    "autoload": {
+        "psr-4": {
+            "DesignMyNight\\Laravel\\": "src"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "DesignMyNight\\Laravel\\Tests\\": "tests"
+        }
+    },
+    "authors": [
+        {
+            "name": "Steve Porter",
+            "email": "[email protected]",
+            "role": "Developer"
+        }
+    ],
+    "extra": {
+        "laravel": {
+            "providers": [
+                "DesignMyNight\\Laravel\\RecursiveCollectionServiceProvider"
+            ]
+        }
+    },
+    "require-dev": {
+        "orchestra/testbench": "^3.5",
+        "phpunit/phpunit": "^6.5"
+    }
+}

phpunit.xml.dist

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit bootstrap="vendor/autoload.php"
+         backupGlobals="false"
+         backupStaticAttributes="false"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         verbose="true">
+    <testsuites>
+        <testsuite name="DesignMyNight Test Suite">
+            <directory>tests</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/RecursiveCollectionServiceProvider.php

@@ -0,0 +1,21 @@
+<?php
+namespace DesignMyNight\Laravel;
+
+use Illuminate\Support\Collection;
+use Illuminate\Support\ServiceProvider;
+
+class RecursiveCollectionServiceProvider extends ServiceProvider
+{
+    public function register()
+    {
+        Collection::macro('recursive', function () {
+            return $this->map(function ($value) {
+                if (is_array($value) || is_object($value)) {
+                    return (new Collection($value))->recursive();
+                }
+
+                return $value;
+            });
+        });
+    }
+}

tests/CollectionTest.php

@@ -0,0 +1,60 @@
+<?php
+namespace DesignMyNight\Laravel\Tests;
+
+use DesignMyNight\Laravel\Tests\TestCase;
+use Illuminate\Support\Collection;
+
+class CollectionTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function it_converts_nested_arrays_into_collections()
+    {
+        $collection = (new Collection([
+            [1, 2, 3],
+        ]))->recursive();
+
+        $this->assertInstanceOf(Collection::class, $collection[0]);
+    }
+
+    /**
+     * @test
+     */
+    public function it_converts_deep_nested_arrays_into_collections()
+    {
+        $collection = (new Collection([
+            [
+                [1, 2, 3],
+            ],
+        ]))->recursive();
+
+        $this->assertInstanceOf(Collection::class, $collection[0][0]);
+    }
+
+    /**
+     * @test
+     */
+    public function it_converts_nested_associative_arrays_into_collections()
+    {
+        $collection = (new Collection([
+            'a' => [1, 2, 3],
+        ]))->recursive();
+
+        $this->assertInstanceOf(Collection::class, $collection['a']);
+    }
+
+    /**
+     * @test
+     */
+    public function it_converts_deep_nested_associative_arrays_into_collections()
+    {
+        $collection = (new Collection([
+            'a' => [
+                'a' => [1, 2, 3],
+            ],
+        ]))->recursive();
+
+        $this->assertInstanceOf(Collection::class, $collection['a']['a']);
+    }
+}

tests/TestCase.php

@@ -0,0 +1,13 @@
+<?php
+namespace DesignMyNight\Laravel\Tests;
+
+use DesignMyNight\Laravel\RecursiveCollectionServiceProvider;
+use Orchestra\Testbench\TestCase as Orchestra;
+
+abstract class TestCase extends Orchestra
+{
+    protected function getPackageProviders($app)
+    {
+        return [RecursiveCollectionServiceProvider::class];
+    }
+}