Merge pull request #19 from chadicus/master

Version 3

Author: chadicus

.coveralls.yml

@@ -1,4 +1,3 @@
 service_name: travis-ci
-src_dir: .
 coverage_clover: clover.xml
 json_path: coveralls-upload.json

.gitattributes

@@ -0,0 +1,13 @@
+# Enforce Unix newlines
+* text=lf
+
+# Exclude unused files
+# see: https://redd.it/2jzp6k
+/tests              export-ignore
+/.github            export-ignore
+/.gitattributes     export-ignore
+/.gitignore         export-ignore
+/.*.yml             export-ignore
+/phpcs.xml          export-ignore
+/phpunit.xml.dist   export-ignore
+/README.md          export-ignore

.github/CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contribution Guidelines
+We welcome you to report [issues](/../../issues) or submit [pull requests](/../../pulls).  While the below guidelines are necessary to get code merged, you can
+submit pull requests that do not adhere to them and we will try to take care of them in our spare time.  We are a smallish group of developers,
+though, so if you can make sure the build is passing 100%, that would be very useful.
+
+We recommend including details of your particular usecase(s) with any issues or pull requests.  We love to hear how our libraries are being used
+and we can get things merged in quicker when we understand its expected usage.
+
+## Pull Requests
+Code changes should be sent through [GitHub Pull Requests](/../../pulls).  Before submitting the pull request, make sure that phpunit reports success
+by running:
+```sh
+./vendor/bin/phpunit
+```
+And there are not coding standard violations by running
+```sh
+./vendor/bin/phpcs
+```
+
+## Builds
+Our [Travis build](https://travis-ci.org/traderinteractive/util-file-php) executes [PHPUnit](http://www.phpunit.de) and uses [Coveralls](https://coveralls.io/) to enforce code coverage.
+While the build does not strictly enforce 100% code coverage, it will not allow coverage to drop below its current percentage.
+[Scrutinizer](https://scrutinizer-ci.com/) is used to ensure code quality and enforce the [coding standard](http://www.php-fig.org/psr/psr-2/).

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,6 @@
+## Expected Behavior
+
+## Actual Behavior
+
+## Steps to reproduce the behavior
+

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+Fixes # .
+
+#### What does this PR do?
+
+#### Checklist
+- [ ] Pull request contains a clear definition of changes
+- [ ] Tests (either unit, integration, or acceptance) written and passing
+- [ ] Relevant documentation produced and/or updated

.gitignore

@@ -1,4 +1,6 @@
 /vendor/
 /coverage/
 /clover.xml
-/nbproject/private/
+/nbproject/private/
+composer.lock
+phpunit.xml

.scrutinizer.yml

@@ -1,19 +1,19 @@
 filter:
     excluded_paths:
         - 'vendor/*'
-        - 'tests/*'
 before_commands:
     - 'composer install'
 tools:
     php_analyzer: true
     php_mess_detector: true
     php_code_sniffer:
         config:
-            standard: PSR1
+            standard: PSR2
     sensiolabs_security_checker: true
     php_loc:
         excluded_dirs:
             - vendor
-            - tests
     php_pdepend: true
     php_sim: true
+build_failure_conditions:
+    - 'issues.label("coding-style").new.exists'

.travis.yml

@@ -1,8 +1,19 @@
 language: php
 php:
   - 7.0
-  - 5.6
+  - 7.1
+  - 7.2
+  - nightly
+env:
+  - PREFER_LOWEST="--prefer-lowest --prefer-stable"
+  - PREFER_LOWEST=""
+matrix:
+  fast_finish: true
+  allow_failures:
+     - php: nightly
 before_script:
   - printf "\n" | pecl install imagick
-script: ./build.php
-after_script: ./vendor/bin/coveralls -v
+  - composer update $PREFER_LOWEST
+script:
+  - ./vendor/bin/phpunit --coverage-clover clover.xml
+after_success: ./vendor/bin/coveralls -v

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013 Dominion Enterprises
+Copyright (c) 2017 Trader Interactive
 
 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

README.md

@@ -1,10 +1,55 @@
 # image-util-php
-[![Build Status](http://img.shields.io/travis/dominionenterprises/image-util-php.svg?style=flat)](https://travis-ci.org/dominionenterprises/image-util-php)
-[![Scrutinizer Code Quality](http://img.shields.io/scrutinizer/g/dominionenterprises/image-util-php.svg?style=flat)](https://scrutinizer-ci.com/g/dominionenterprises/image-util-php/)
-[![Code Coverage](http://img.shields.io/coveralls/dominionenterprises/image-util-php.svg?style=flat)](https://coveralls.io/r/dominionenterprises/image-util-php)
 
-[![Latest Stable Version](http://img.shields.io/packagist/v/dominionenterprises/image-util.svg?style=flat)](https://packagist.org/packages/dominionenterprises/image-util)
-[![Total Downloads](http://img.shields.io/packagist/dt/dominionenterprises/image-util.svg?style=flat)](https://packagist.org/packages/dominionenterprises/image-util)
-[![License](http://img.shields.io/packagist/l/dominionenterprises/image-util.svg?style=flat)](https://packagist.org/packages/dominionenterprises/image-util)
+[![Build Status](https://travis-ci.org/traderinteractive/image-util-php.svg?branch=master)](https://travis-ci.org/traderinteractive/image-util-php)
+[![Code Quality](https://scrutinizer-ci.com/g/traderinteractive/image-util-php/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/traderinteractive/image-util-php/?branch=master)
+[![Coverage Status](https://coveralls.io/repos/github/traderinteractive/image-util-php/badge.svg?branch=master)](https://coveralls.io/github/traderinteractive/image-util-php?branch=master)
 
-General Image Utility Library 
+[![Latest Stable Version](https://poser.pugx.org/traderinteractive/image-util/v/stable)](https://packagist.org/packages/traderinteractive/image-util)
+[![Latest Unstable Version](https://poser.pugx.org/traderinteractive/image-util/v/unstable)](https://packagist.org/packages/traderinteractive/image-util)
+[![License](https://poser.pugx.org/traderinteractive/image-util/license)](https://packagist.org/packages/traderinteractive/image-util)
+
+[![Total Downloads](https://poser.pugx.org/traderinteractive/image-util/downloads)](https://packagist.org/packages/traderinteractive/image-util)
+[![Monthly Downloads](https://poser.pugx.org/traderinteractive/image-util/d/monthly)](https://packagist.org/packages/traderinteractive/image-util)
+[![Daily Downloads](https://poser.pugx.org/traderinteractive/image-util/d/daily)](https://packagist.org/packages/traderinteractive/image-util)
+
+General Image Utility Library
+
+## Requirements
+
+image-util-php requires PHP 7.0 (or later).
+
+## Composer
+To add the library as a local, per-project dependency use [Composer](http://getcomposer.org)! Simply add a dependency on
+`traderinteractive/image-util` to your project's `composer.json` file such as:
+
+```sh
+composer require traderinteractive/image-util
+```
+
+## Documentation
+
+Found in the [source](src) itself, take a look!
+
+## Contact
+
+Developers may be contacted at:
+
+ * [Pull Requests](https://github.com/traderinteractive/image-util-php/pulls)
+ * [Issues](https://github.com/traderinteractive/image-util-php/issues)
+
+## Project Build
+
+With a checkout of the code get [Composer](http://getcomposer.org) in your PATH and run:
+
+```sh
+./vendor/bin/phpunit
+./vendor/bin/phpcs
+```
+
+There is also a [docker](http://www.docker.com/)-based [fig](http://www.fig.sh/) configuration that will execute the build inside a docker container.  This is an easy way to build the application:
+
+```sh
+fig run build
+```
+
+For more information on our build process, read through out our [Contribution Guidelines](.github/CONTRIBUTING.md).