Prepare v1.3.0 release

Author: clue

CHANGELOG.md

@@ -1,8 +1,19 @@
-# CHANGELOG
+# Changelog
 
-This file is a manually maintained list of changes for each release. Feel free
-to add your changes here when sending pull requests. Also send corrections if
-you spot any mistakes.
+## 1.3.0 (2018-06-10)
+
+*   Feature: Add `$timeout` parameter for `Factory::createClient()`
+    (#39 by @Elbandi and @clue)
+
+    ```php
+    // connect to Google, but wait no longer than 2.5s for connection
+    $socket = $factory->createClient('www.google.com:80', 2.5);
+    ```
+
+*   Improve test suite by adding PHPUnit to require-dev,
+    update test suite to test against legacy PHP 5.3 through PHP 7.2 and
+    optionally skip functional integration tests requiring internet.
+    (#26 by @ascii-soup, #28, #29, #37 and #38 by @clue)
 
 ## 1.2.0 (2015-03-18)
 

README.md

@@ -14,7 +14,7 @@ This lightweight library exposes this socket API in a modern way by providing a
   Uses a fluent interface so you can easily chain method calls.
   Error conditions will be signalled using `Exception`s instead of relying on cumbersome return codes.
 * **Lightweight, SOLID design** -
-  Provides a thin abstraction that is [*just good enough*](http://en.wikipedia.org/wiki/Principle_of_good_enough)
+  Provides a thin abstraction that is [*just good enough*](https://en.wikipedia.org/wiki/Principle_of_good_enough)
   and does not get in your way.
   This library is merely a very thin wrapper and has no other external dependencies.
 * **Good test coverage** -
@@ -108,7 +108,7 @@ $socket = $factory->createClient('icmp://192.168.0.1');
 
 The `createServer($address)` method can be used to create a server side (listening) socket bound to specific address/path
 (similar to how [`stream_socket_server()`](http://www.php.net/manual/en/function.stream-socket-server.php) works).
-It accepts the same addressing scheme as the [`createClient()`](#createClient) method.
+It accepts the same addressing scheme as the [`createClient()`](#createclient) method.
 
 ```php
 // create a TCP/IP stream connection socket server on port 1337
@@ -188,15 +188,20 @@ $socket->close();
 
 ## Install
 
-The recommended way to install this library is [through Composer](http://getcomposer.org).
-[New to Composer?](http://getcomposer.org/doc/00-intro.md)
+The recommended way to install this library is [through Composer](https://getcomposer.org).
+[New to Composer?](https://getcomposer.org/doc/00-intro.md)
 
 ```bash
-$ composer require clue/socket-raw:~1.2
+$ composer require clue/socket-raw:^1.3
 ```
 
 See also the [CHANGELOG](CHANGELOG.md) for details about version upgrades.
 
+This project aims to run on any platform and thus does not require any PHP
+extensions besides `ext-sockets` and supports running on legacy PHP 5.3 through
+current PHP 7+ and HHVM.
+It's *highly recommended to use PHP 7+* for this project.
+
 ## Tests
 
 To run the test suite, you first need to clone this repo and then install all
@@ -216,7 +221,7 @@ Note that the test suite contains tests for ICMP sockets which require root
 access on Unix/Linux systems. Therefor some tests will be skipped unless you run
 the following command to execute the full test suite:
 
-```php
+```bash
 $ sudo php vendor/bin/phpunit
 ```
 
@@ -230,4 +235,7 @@ $ php vendor/bin/phpunit --exclude-group internet
 
 ## License
 
-MIT
+This project is released under the permissive [MIT license](LICENSE).
+
+> Did you know that I offer custom development services and issuing invoices for
+  sponsorships of releases and for contributions? Contact me (@clue) for details.