initial commit

Author: briskt

.gitignore

@@ -0,0 +1,3 @@
+*.env
+.idea
+/vendor/

LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 SIL International, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

Makefile

@@ -0,0 +1,7 @@
+test:
+	docker-compose run test composer install
+	docker-compose run test ./vendor/bin/phpunit tests/
+
+testhost:
+	composer install --ignore-platform-reqs
+	bash -c "vendor/bin/phpunit tests/"

README.md

@@ -0,0 +1,54 @@
+# SIL PHP Utilities
+
+A collection of utility classes share among SIL International PHP projects.
+
+## Build Status
+
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/silinternational/php-env/badges/quality-score.png?b=develop)](https://scrutinizer-ci.com/g/silinternational/php-utils/?branch=master)
+[![Build Status](https://scrutinizer-ci.com/g/silinternational/php-env/badges/build.png?b=develop)](https://scrutinizer-ci.com/g/silinternational/php-utils/build-status/master)
+
+## Setup
+
+1. Clone this repo.
+1. Copy `local.env.dist` to `local.env` and update github.com token as 
+   appropriate.
+1. Run `make test` to install dependencies and run PHPUnit tests.
+   
+### Makefile script
+
+There is a Makefile in place to simplify common tasks.
+- `make test` - does `composer install` and runs phpunit tests
+
+___
+
+## Sil/Arrays
+
+Utility class for manipulating arrays.
+
+### Classes in Sil/Arrays namespace
+
+1. __ArrayCollapse__: `use Sil\Array\ArrayCollapse;`
+
+### Class `ArrayCollapse`
+
+Util class containing a method to collapse a multi-dimensional array into a
+single-dimensional array. Array keys are combined using a dot to separate
+levels of the array. For instance:
+
+```
+[
+    'a' => [
+        'x' => 'data1',
+    ],
+    'b' => 'data2',
+]
+```
+
+will be collapsed to
+
+```
+[
+    'a.x' => 'data1',
+    'b' => 'data2',
+]
+```

composer.json

@@ -0,0 +1,15 @@
+{
+    "name": "silinternational/php-utils",
+    "description": "PHP library including various utility classes",
+    "type": "library",
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {"Sil\\PhpUtils\\": "src/"}
+    },
+    "require": {
+        "php": ">=7.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^6.1"
+    }
+}