Package and deploy a phar during the build

Author: jakzal

.gitignore

@@ -1,4 +1,5 @@
 /.php_cs.cache
+/box.json
 /build/
 /composer.lock
 /vendor/

.travis.yml

@@ -1,15 +1,25 @@
 language: php
-
 matrix:
-    include:
-        - php: 7.1
-        - php: 7.2
-          env: deps=low
-    fast_finish: true
-
-before_script:
-  - phpenv config-rm xdebug.ini
-  - if [[ $deps = low ]]; then make update-min; else make install; fi
-
+  include:
+  - php: 7.1
+    env: EXECUTE_DEPLOYMENT=true
+  - php: 7.2
+    env: deps=low
+  fast_finish: true
+before_install:
+- phpenv config-rm xdebug.ini
+install:
+- if [[ $deps = low ]]; then make update-min; else make install; fi
 script:
-  - if [[ $deps = low ]]; then make test-min; else make test; fi
+- if [[ $deps = low ]]; then make test-min; else make test; fi
+- make package
+deploy:
+  provider: releases
+  api_key:
+    secure: bcQjAVuB0a/aMXFZ/dMeiiaipDDJQUmmwaHBMyRwZgTjd1m3ruz+D1vHUGCH8CBSEBf97aKh4mpzqllC0/DoKSZVUK8wf3elZv3Aw2q5RlmiXoigtNscBYxc9rCpqvoy1p8ituwQjKfEubRgAIBTpIiunEsbOfjV2jTHOpKUcz1+TiNCuS7JMbcnB0xIvKCz9EKvzbxIlrIaZ6erKRGwU2GqSnmchfimANyJZJbAYZD68BSetAWnCGhIunblr7c7abDBY72bphsJdAkAkaIvV8x8CABX52m+Uq5ceTVXvcltHWinht/lRehyvJH7TAJSi+arRGCKQPOGGvzKjH3Y7tkbm3KdR/gKQ5E0U1iK/7Dm3wp1AWQB3FGfRN20nccqIDpO/7MCwH0NE3eLGNLlMzVFuX9+iLz3a5i4Emnm2KY9YoLgHGvswyFcPUZrWbI0Q7unmyKQ3HPqUMpLaMU40Tt68KiG2+T4bPSjE8ZqdPpwFoE8OmNXLral/oOWueaMpSNpyatULaFt8rG0WLOG+LOSc6Ket2IU4mmQ3zo6a8zgnEIBatTxpzYnwiE21j0GzsNUIXVeHDQ3DVDANM5Lv3J3tiIEJVkJfvNC6T3WvT7FOITVhVUU9OLXBwAtrOesXmVlyAv+0IxLL48IIvmcp2hkIX7mVd8kCLFk8/T6Njg=
+  file: build/zalas-phpunit-globals-extension.phar
+  skip_cleanup: true
+  on:
+    tags: true
+    repo: jakzal/phpunit-globals
+    condition: "$EXECUTE_DEPLOYMENT"

Makefile

@@ -15,6 +15,10 @@ update-min:
 	composer update --prefer-stable --prefer-lowest
 .PHONY: update-min
 
+update-no-dev:
+	composer update --prefer-stable --no-dev
+.PHONY: update-no-dev
+
 test: vendor cs phpunit
 .PHONY: test
 
@@ -33,12 +37,39 @@ phpunit: tools/phpunit
 	tools/phpunit
 .PHONY: phpunit
 
+clean:
+	rm -rf build
+.PHONY: clean
+
+package: tools/box
+	$(eval VERSION=$(shell git describe --abbrev=0 --tags 2> /dev/null | sed -e 's/^v//' || echo 'dev'))
+	@rm -rf build/phar && mkdir -p build/phar
+
+	cp -r src LICENSE composer.json build/phar
+	sed -e 's/@@version@@/$(VERSION)/g' manifest.xml.in > build/phar/manifest.xml
+
+	cd build/phar && \
+	  composer remove phpunit/phpunit --no-update && \
+	  composer config platform.php 7.1 && \
+	  composer update --no-dev -o -a
+
+	tools/box compile
+
+	@rm -rf build/phar
+.PHONY: package
+
 vendor: install
 
 vendor/bin/phpunit: install
 
+tools: tools/php-cs-fixer tools/phpunit tools/box
+.PHONY: tools
+
 tools/phpunit: vendor/bin/phpunit
 	ln -sf ../vendor/bin/phpunit tools/phpunit
 
 tools/php-cs-fixer:
 	curl -Ls http://cs.sensiolabs.org/download/php-cs-fixer-v2.phar -o tools/php-cs-fixer && chmod +x tools/php-cs-fixer
+
+tools/box:
+	curl -Ls https://github.com/humbug/box/releases/download/3.0.0-beta.0/box.phar -o tools/box && chmod +x tools/box

README.md

@@ -14,10 +14,27 @@ and brought to the original state after each test case has finished.
 
 ## Installation
 
+### Composer
+
 ```bash
 composer require --dev zalas/phpunit-globals
 ```
 
+### Phar
+
+The extension is also distributed as a PHAR, which can be downloaded from the most recent
+[Github Release](https://github.com/jakzal/phpunit-globals/releases).
+
+Put the extension in your PHPUnit extensions directory.
+Remember to instruct PHPUnit to load extensions in your `phpunit.xml`:
+
+```xml
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/7.0/phpunit.xsd"
+         extensionsDirectory="tools/phpunit.d"
+>
+</phpunit>
+```
+
 ## Usage
 
 Enable the globals listener in your PHPUnit configuration:

box.json.dist

@@ -0,0 +1,15 @@
+{
+    "base-path": "build/phar",
+    "output": "../zalas-phpunit-globals-extension.phar",
+    "compression": "GZ",
+    "directories": ["."],
+    "dump-autoload": true,
+    "exclude-composer-files": true,
+    "check-requirements": false,
+    "main": "vendor/autoload.php",
+    "banner": [
+        "This file is part of the zalas/phpunit-globals project.",
+        "",
+        "(c) Jakub Zalas <[email protected]>"
+    ]
+}

manifest.xml.in

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<phar xmlns="https://phar.io/xml/manifest/1.0">
+    <contains name="zalas/phpunit-globals" version="@@version@@" type="extension">
+        <extension for="phpunit/phpunit" compatible="^7.0"/>
+    </contains>
+
+    <copyright>
+        <author name="Jakub Zalas" email="[email protected]"/>
+        <license type="MIT" url="https://github.com/jakzal/phpunit-globals/blob/master/LICENSE"/>
+    </copyright>
+
+    <requires>
+        <php version="^7.1"/>
+    </requires>
+</phar>