Initial commit

Author: tommy-muehle

.travis.yml

@@ -0,0 +1,20 @@
+language: php
+sudo: false
+php:
+  - 5.5
+  - 5.6
+  - 7.0
+  - hhvm
+  - nightly
+matrix:
+  allow_failures:
+    - php: nightly
+    - php: hhvm
+before_install:
+  - composer selfupdate
+install:
+  - composer install --no-interaction --prefer-source
+script:
+  - ./vendor/bin/phpunit
+notifications:
+  email: false

CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contributing
+
+## Workflow
+
+* Fork the project
+* Make your bug fix or feature addition
+* Add tests for it. This is important so we don't break it in a future version unintentionally
+* Send a pull request
+
+## Attention
+
+Please make sure that you have set up your user name and email address for use with Git. 
+Strings such as silly nick name <root@localhost> look really stupid in the commit history of a project.
+
+Pull requests must be based on the current stable branch (master).

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Tommy Mühle
+
+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

@@ -1 +1,60 @@
-# tooly-composer-script
+# tooly-composer-script
+
+[![Build Status](https://travis-ci.org/tommy-muehle/tooly-composer-script.svg?branch=master)](https://travis-ci.org/tommy-muehle/tooly-composer-script)
+
+With the tooly [composer-script](https://getcomposer.org/doc/articles/scripts.md) aka hook you can manage needed phar files, such as phpunit, in your composer.json.
+Every phar file will be saved in the [composer binary directory](https://getcomposer.org/doc/articles/vendor-binaries.md).
+
+## Example
+
+For an quick example look at the [composer.json](composer.json#L48-L57) here.
+ 
+## Install
+
+To use the script just do the following single command:
+
+```
+composer require tm/tooly-composer-script
+```
+
+*Note:*
+There are no further dependencies in this library. Only PHP.
+
+## Usage
+
+The composer.json scheme has a part "extra" which is used for the script.
+Its described [here](https://getcomposer.org/doc/04-schema.md#extra).
+
+In this part you can add your needed phar tools under the key "tools".
+
+```
+...
+"extra": {
+    ...
+    "tools": {
+      "phpunit": {
+        "url": "https://phar.phpunit.de/phpunit-4.8.9.phar",
+        "only-dev": true
+      },
+      "phpcpd": {
+        "url": "https://phar.phpunit.de/phpcpd-2.0.4.phar",
+        "only-dev": true
+      }
+    }
+    ...
+  }
+...
+```
+
+After you add the name of the tool as key, you need only one further parameter. The *"url"*.
+The url can be a link to a specific version, such as x.y.z, or a link to the latest version for this phar.
+
+Every time you update or install with composer the phar tools are checked. You are asked if you want to overwrite
+the existing phar if the remote and local phar has not the same checksum. 
+
+The *"only-dev"* parameter is optional. Its default true and means that this phar is only needed in developing mode.
+So the command ```composer [install|update] --no-dev``` ignores this phar tool.
+
+## Contributing
+
+Please refer to [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to contribute.

composer.json

@@ -0,0 +1,59 @@
+{
+  "name": "tm/tooly-composer-script",
+  "description": "Simple composer script to manage phar files.",
+  "keywords": [
+    "composer",
+    "composer-script",
+    "phar-management",
+    "composer-phar"
+  ],
+  "homepage": "https://github.com/tommy-muehle/tooly-composer-script",
+  "authors": [
+    {
+      "name": "Tommy Muehle",
+      "email": "tommy.muehle@gmail.com",
+      "homepage": "https://tommy-muehle.de"
+    }
+  ],
+  "support": {
+    "email": "tommy.muehle@gmail.com",
+    "issues": "https://github.com/tommy-muehle/tooly-composer-script/issues",
+    "docs": "https://github.com/tommy-muehle/tooly-composer-script/blob/master/README.md",
+    "source": "https://github.com/tommy-muehle/tooly-composer-script/tree/master"
+  },
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "Tooly\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Tooly\\": "src/",
+      "Tooly\\Tests\\": "tests/"
+    }
+  },
+  "require": {
+    "php": ">=5.5.0"
+  },
+  "require-dev": {
+    "composer/composer": "1.*",
+    "mikey179/vfsstream": "1.6.*"
+  },
+  "scripts": {
+    "post-install-cmd": "Tooly\\ScriptHandler::installPharTools",
+    "post-update-cmd": "Tooly\\ScriptHandler::installPharTools"
+  },
+  "extra": {
+    "tools": {
+      "phpunit": {
+        "url": "https://phar.phpunit.de/phpunit-4.8.9.phar",
+        "only-dev": true
+      },
+      "phpcpd": {
+        "url": "https://phar.phpunit.de/phpcpd-2.0.4.phar",
+        "only-dev": true
+      }
+    }
+  }
+}