Part 2 done

Author: Swader

composer.json

@@ -15,10 +15,11 @@
         }
     ],
     "require": {
-        "php" : ">=5.5.0"
+        "php" : ">=5.5.0",
+        "guzzlehttp/guzzle": "~5.0"
     },
     "require-dev": {
-        "phpunit/phpunit" : "4.*"
+        "phpunit/phpunit" : "~4"
     },
     "autoload": {
         "psr-4": {

phpunit.xml.dist

@@ -10,7 +10,7 @@
          processIsolation="false"
          stopOnFailure="false">
     <testsuites>
-        <testsuite name="League Test Suite">
+        <testsuite name="Diffbot Test Suite">
             <directory>tests</directory>
         </testsuite>
     </testsuites>

src/Abstracts/Api.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Swader\Diffbot\Abstracts;
+
+/**
+ * Class Api
+ * @package Swader\Diffbot\Abstracts
+ */
+abstract class Api
+{
+    /** @var int Timeout value in ms - defaults to 30s if empty */
+    private $timeout = 30000;
+
+    /**
+     * Setting the timeout will define how long Diffbot will keep trying
+     * to fetch the API results. A timeout can happen for various reasons, from
+     * Diffbot's failure, to the site being crawled being exceptionally slow, and more.
+     *
+     * @param int|null $timeout Defaults to 30000 even if not set
+     *
+     * @return $this
+     */
+    public function setTimeout($timeout = null)
+    {
+        if ($timeout === null) {
+            $timeout = 30000;
+        }
+        if (!is_int($timeout)) {
+            throw new \InvalidArgumentException('Parameter is not an integer');
+        }
+        if ($timeout < 0) {
+            throw new \InvalidArgumentException('Parameter is negative. Only positive timeouts accepted.');
+        }
+
+        $this->timeout = $timeout;
+        return $this;
+    }
+}

src/SkeletonClass.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace Swader\Diffbot\Test;
+
+use Swader\Diffbot\Abstracts\Api;
+
+class ApiTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * @return \PHPUnit_Framework_MockObject_MockObject
+     */
+    private function buildMock()
+    {
+        return $this->getMockForAbstractClass('Swader\Diffbot\Abstracts\Api');
+    }
+
+    public function testSetTimeout()
+    {
+        /** @var Api $mock */
+        $mock = $this->buildMock();
+
+        $validTimeouts = [
+            0,
+            1000,
+            2000,
+            3000,
+            3000000,
+            40000000,
+            null
+        ];
+
+        $invalidTimeouts = [
+            -298979879827,
+            -4983,
+            'abcef',
+            '',
+            false
+        ];
+
+        try {
+            $mock->setTimeout();
+        } catch (\InvalidArgumentException $e) {
+            $this->fail('Failed with supposedly valid (empty) timeout.');
+        }
+
+        foreach ($validTimeouts as $timeout) {
+            try {
+                $mock->setTimeout($timeout);
+            } catch (\InvalidArgumentException $e) {
+                $this->fail('Failed with supposedly valid timeout: ' . $timeout);
+            }
+        }
+
+        foreach ($invalidTimeouts as $timeout) {
+            try {
+                $mock->setTimeout($timeout);
+            } catch (\InvalidArgumentException $e) {
+                // Got expected exception
+                continue;
+            }
+            $this->fail('Failed, assumed invalid parameter was valid.');
+        }
+    }
+}

tests/Abstracts/ApiTest.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace Swader\Diffbot\Test;
+
+use Swader\Diffbot\Diffbot;
+use Swader\Diffbot\Exceptions\DiffbotException;
+
+/**
+ * @runTestsInSeparateProcesses
+ */
+class DiffbotTest extends \PHPUnit_Framework_TestCase
+{
+
+    private $invalidTokens = [
+        '',
+        'a',
+        'ab',
+        'abc',
+        1,
+        12,
+        123,
+        true,
+        array('token')
+    ];
+
+    private $validTokens = [
+        'token',
+        '123456789',
+        'akrwejhtn983z420qrzc8397r4'
+    ];
+
+    public function testStaticSetToken()
+    {
+        foreach ($this->invalidTokens as $value) {
+            try {
+                Diffbot::setToken($value);
+            } catch (\InvalidArgumentException $e) {
+                // Good, we got an exception!
+                continue;
+            }
+            $this->fail('Expected exception not raised on value: "' . $value . '".');
+        }
+
+        foreach ($this->validTokens as $value) {
+            Diffbot::setToken($value);
+        }
+    }
+
+    public function testInstantiation()
+    {
+        $exceptionTriggered = false;
+        try {
+            new Diffbot();
+        } catch (DiffbotException $e) {
+            // Great, got it!
+            $exceptionTriggered = true;
+        }
+        if (!$exceptionTriggered) {
+            $this->fail('Empty token did not produce exception!');
+        }
+
+        try {
+            Diffbot::setToken('token');
+            new Diffbot();
+        } catch (DiffbotException $e) {
+            $this->fail('Scenario failed!');
+        }
+
+        try {
+            new Diffbot('token');
+        } catch (DiffbotException $e) {
+            $this->fail('Scenario failed!');
+        }
+    }
+}