gotta get down on friday

Author: igorw

.gitignore

@@ -0,0 +1 @@
+vendor

CHANGELOG.md

@@ -0,0 +1,3 @@
+### 1.0.0 (2014-09-19)
+
+  * Initial release

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Igor Wiedler
+
+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.

README.md

@@ -0,0 +1,26 @@
+# retry
+
+A tiny library for retrying failing operations.
+
+Since the network is reliable, things should always work. Am I right? For those cases when they don't, there is *retry*.
+
+```php
+<?
+use function igorw\retry;
+
+// retry an operation up to 5 times
+$user = retry(5, function () use ($id) {
+    return User::find($id);
+});
+
+// here is why you want to start using HHVM
+$user = retry(5, () ==> User::find($id));
+
+// this is probably a bad idea
+$user = retry(INF, () ==> {
+    throw new RuntimeException('never gonna give you up');
+});
+?>
+```
+
+I know. You're welcome.

composer.json

@@ -0,0 +1,21 @@
+{
+    "name": "igorw/retry",
+    "description": "A tiny library for retrying failing operations.",
+    "keywords": ["failure"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Igor Wiedler",
+            "email": "igor@wiedler.ch"
+        }
+    ],
+    "require": {
+        "php": ">=5.4"
+    },
+    "autoload": {
+        "files": ["src/retry.php"]
+    },
+    "extra": {
+        "branch-alias": { "dev-master": "1.0-dev" }
+    }
+}

phpunit.xml.dist

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<phpunit backupGlobals="false"
+         colors="true"
+         bootstrap="vendor/autoload.php"
+>
+    <testsuites>
+        <testsuite name="unit">
+            <directory>./tests/</directory>
+        </testsuite>
+    </testsuites>
+
+    <filter>
+        <whitelist>
+            <directory>./src/</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/retry.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace igorw;
+
+class FailingTooHardException extends \Exception {}
+
+function retry($retries, callable $fn)
+{
+    beginning:
+    try {
+        return $fn();
+    } catch (\Exception $e) {
+        if (!$retries) {
+            throw new FailingTooHardException('', 0, $e);
+        }
+        $retries--;
+        goto beginning;
+    }
+}

tests/RetryTest.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace igorw;
+
+class RetryTest extends \PHPUnit_Framework_TestCase
+{
+    function testRetryWithoutFailing()
+    {
+        $i = 0;
+        $value = retry(1, function () use (&$i) {
+            $i++;
+            return 5;
+        });
+        $this->assertSame(1, $i);
+        $this->assertSame(5, $value);
+    }
+
+    function testRetryFailingOnce()
+    {
+        $i = 0;
+        $failed = false;
+        $value = retry(1, function () use (&$i, &$failed) {
+            $i++;
+            if (!$failed) {
+                $failed = true;
+                throw new \RuntimeException('roflcopter');
+            }
+            return 5;
+        });
+        $this->assertSame(2, $i);
+        $this->assertSame(5, $value);
+    }
+
+    function testRetryFailingTooHard()
+    {
+        $e = null;
+        $i = 0;
+        try {
+            retry(1, function () use (&$i) {
+                $i++;
+                throw new \RuntimeException('rofl');
+            });
+        } catch (\Exception $e) {
+        }
+
+        $this->assertInstanceof('igorw\FailingTooHardException', $e);
+        $this->assertInstanceof('RuntimeException', $e->getPrevious());
+        $this->assertSame('rofl', $e->getPrevious()->getMessage());
+        $this->assertSame(2, $i);
+    }
+
+    function testRetryManyTimes()
+    {
+        $e = null;
+        $i = 0;
+        try {
+            retry(1000, function () use (&$i, &$failed) {
+                $i++;
+                throw new \RuntimeException('dogecoin');
+            });
+        } catch (\Exception $e) {
+        }
+
+        $this->assertInstanceof('igorw\FailingTooHardException', $e);
+        $this->assertInstanceof('RuntimeException', $e->getPrevious());
+        $this->assertSame('dogecoin', $e->getPrevious()->getMessage());
+        $this->assertSame(1001, $i);
+    }
+}