Add benchmark support

In order to verify changes to functions that might affect performance.

Also runs benchmarks during builds for easy comparison.

Refs #1

.travis.yml

@@ -13,11 +13,12 @@ matrix:
 
 before_script:
   - travis_retry composer self-update
-  - travis_retry composer require phpunit/phpunit
+  - travis_retry composer require phpunit/phpunit phpbench/phpbench
   - travis_retry composer update ${COMPOSER_FLAGS} --no-interaction --prefer-source
 
 script:
-  - vendor/bin/phpunit
+  - composer test
+  - composer bench
 
 after_script:
   - bash -c '[[ -f "build/logs/clover.xml" ]] && wget https://scrutinizer-ci.com/ocular.phar'

benchmarks/ArrayBench.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace Equip;
+
+class ArrayBench
+{
+    public function benchHead()
+    {
+        return \Equip\head($this->words());
+    }
+
+    public function benchTail()
+    {
+        return \Equip\tail($this->words());
+    }
+
+    private function words()
+    {
+        // 100 random words
+        return [
+            'B-G',
+            'Elavil',
+            'Gal',
+            'Heilbronn',
+            'Jawing',
+            'Northumbria',
+            'Polycarp',
+            'Suyog',
+            'Thessalians',
+            'Yemenis',
+            'adheres',
+            'anacardic',
+            'anastasis',
+            'arised',
+            'averseness',
+            'awright',
+            'bandgaps',
+            'bareboat',
+            'beader',
+            'bearishness',
+            'boxlike',
+            'buddha',
+            'chain-bearer',
+            'chartists',
+            'clickjack',
+            'cogence',
+            'colorways',
+            'conundrums',
+            'correlate',
+            'cultist',
+            'directum',
+            'disparity',
+            'dribble',
+            'earth-closet',
+            'embank',
+            'ethnographically',
+            'evokers',
+            'exclaimed',
+            'favela',
+            'foodist',
+            'grenadilla',
+            'gunning',
+            'hearthrug',
+            'humpy',
+            'indels',
+            'indeterminant',
+            'inelastic',
+            'innateness',
+            'intering',
+            'interlay',
+            'ire',
+            'izar',
+            'jaden',
+            'jest',
+            'joshing',
+            'leader',
+            'leave-taking',
+            'levitical',
+            'liveryman',
+            'loggias',
+            'lubricous',
+            'luxuria',
+            'main-hatch',
+            'mealie',
+            'minigolf',
+            'misgives',
+            'moneyspinning',
+            'nanomachine',
+            'narrativized',
+            'nepetalactone',
+            'omosternum',
+            'onry',
+            'oppidans',
+            'outproduced',
+            'palpal',
+            'parallelled',
+            'paresseuse',
+            'phlebotomy',
+            'poignant',
+            'poinsettias',
+            'psychedelia',
+            'redoute',
+            'saxhorn',
+            'schottische',
+            'semifluid',
+            'sheepishness',
+            'someways',
+            'striped',
+            'thessalonica',
+            'ticca',
+            'timekiller',
+            'typosquatters',
+            'unclenching',
+            'undersupplying',
+            'unforeseeable',
+            'unreckonable',
+            'untaxed',
+            'ushers',
+            'vivers',
+            'whf'
+        ];
+    }
+}

composer.json

@@ -14,14 +14,22 @@
     },
     "require-dev": {
     },
+    "suggest": {
+        "phpunit/phpunit": "Install globally to run unit tests",
+        "phpbench/phpbench": "Install globally to run benchmarks"
+    },
     "autoload": {
         "files": [
             "src/array.php"
         ]
     },
     "autoload-dev": {
         "psr-4": {
-            "Equip\\as\\": "tests/"
+            "Equip\\Assist\\": "tests/"
         }
+    },
+    "scripts": {
+        "bench": "phpbench run --report=aggregate --revs=100 --iterations=5",
+        "test": "phpunit"
     }
 }

phpbench.json.dist

@@ -0,0 +1,4 @@
+{
+    "bootstrap": "vendor/autoload.php",
+    "path": "benchmarks"
+}