Release v2.0.0

.docker/development/php/cli/Dockerfile

@@ -0,0 +1,8 @@
+FROM php:8.0-cli-alpine AS builder
+
+RUN set -ex && apk update && apk upgrade --available
+
+COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
+RUN set -ex && install-php-extensions json-stable xdebug-stable
+
+FROM builder AS console

.github/CODEOWNERS

@@ -0,0 +1,37 @@
+# This is a comment.
+# Each line is a file pattern followed by one or more owners.
+
+# These owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence,
+# @global-owner1 and @global-owner2 will be requested for
+# review when someone opens a pull request.
+*       @contributors
+
+# Order is important; the last matching pattern takes the most
+# precedence. When someone opens a pull request that only
+# modifies JS files, only @js-owner and not the global
+# owner(s) will be requested for a review.
+# *.js    @js-owner
+
+# You can also use email addresses if you prefer. They'll be
+# used to look up users just like we do for commit author
+# emails.
+# *.go [email protected]
+
+# In this example, @doctocat owns any files in the build/logs
+# directory at the root of the repository and any of its
+# subdirectories.
+# /build/logs/ @doctocat
+
+# The `docs/*` pattern will match files like
+# `docs/getting-started.md` but not further nested files like
+# `docs/build-app/troubleshooting.md`.
+# docs/*  [email protected]
+
+# In this example, @octocat owns any file in an apps directory
+# anywhere in your repository.
+# apps/ @octocat
+
+# In this example, @doctocat owns any file in the `/docs`
+# directory in the root of your repository.
+# /docs/ @doctocat

CONTRIBUTING.md → .github/CONTRIBUTING.md

@@ -6,39 +6,53 @@ We accept contributions via pull requests on [GitHub](http://github.com/icehawk/
 
 ## Issues
 
-- Please report issues here on [GitHub](http://github.com/icehawk/icehawk/forms)
+- Please report issues here on [GitHub](http://github.com/icehawk/forms)
 
 ## Pull Requests
 
 - **Add tests!** - Your patch will not be accepted if it does not have tests.
 
 - **Document any change in behaviour** - Make sure the documentation in `README.md` and the `CHANGELOG.md` is kept up-to-date.
 
-- **Consider our release cycle** - We follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.
+- **Consider our release cycle** - We follow [SemVer v2.0.0](http://semver.org). Randomly breaking public APIs is not an option.
 
 - **Create topic branches** - Do not ask us to pull from your master branch.
 
 - **One pull request per feature** - If you want to do more than one thing, please send multiple pull requests.
 
 - **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
 
+---
 
-## Running tests
+## Install development environment
 
-```bash
-$ php vendor/bin/phpunit.phar -c build/
-```
+### What you need
 
-This includes a code coverage report in HTML and Clover XML.
+* [docker](https://docs.docker.com/get-docker/)
+* [docker-compose](https://docs.docker.com/compose/install/)
+* [GNU make](https://www.gnu.org/software/make/)
 
-## Analyze code
+### Install development environment
 
-```bash
-$ php vendor/bin/phpmetrics.phar --report-html=build/logs/phpmetrics src/
-```
+* Clone repository
+  ```bash
+  git clone https://github.com/icehawk/forms
+  ```
 
-## Create API documentation
+* Run `make install-dev`
 
-```bash
-$ php vendor/bin/phpdox.phar -f build/phpdox.xml
-```
+### Update development environment
+
+* Run `make update` 
+* This updates: 
+  * Docker image builds
+  * PHAR tools via PHIVE
+  * composer dependencies
+
+### Run tests
+
+* Run `make tests`
+* This executes:
+  * PHP linting
+  * PHPStan
+  * PHPUnit incl. coverage report to `tests/clover.xml`

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,19 @@
+## Expected Behavior
+
+
+## Actual Behavior
+
+
+## Steps to Reproduce the Problem
+
+1.
+2.
+3.
+
+## Specifications
+
+- Package version:
+- Platform/OS:
+- Subsystem:
+
+## Further comments

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+Fixes #`<issue-number>`
+
+## Proposed Changes
+
+-
+-
+-
+
+## Further comments

.github/workflows/qa.yml

@@ -0,0 +1,69 @@
+name: QA
+
+on:
+  push:
+    branches:
+      - master
+      - development
+      - "v1.x-*"
+      - "feature/*"
+      - "issue/*"
+    tags:
+      - 'v*.*.*'
+  pull_request:
+
+jobs:
+  run-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Install tools via PHIVE
+        run: make install-tools
+
+      - name: Check for PHP parse errors
+        run: make phplint
+
+      - name: Composer install
+        run: make composer-install-dev
+
+      - name: Run PHPStan
+        run: make phpstan
+
+      - name: Run PHPUnit
+        run: make phpunit
+
+      - name: Archive code coverage results
+        uses: actions/upload-artifact@v2
+        with:
+          name: clover-report
+          path: tests/clover.xml
+
+  release:
+    runs-on: ubuntu-latest
+    needs:
+      - run-tests
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Extract version
+        id: data
+        run: |
+          # Strip git ref prefix from version
+          RELEASE_VERSION=$(echo "${{ github.ref }}" | sed -e 's,.*/\(.*\),\1,')
+
+          # Strip "v" prefix from tag name
+          [[ "${{ github.ref }}" == "refs/tags/"* ]] && RELEASE_VERSION=$(echo $RELEASE_VERSION | sed -e 's/^v//')
+
+          echo $RELEASE_VERSION
+          echo "##[set-output name=version;]$RELEASE_VERSION"
+
+      - name: Create release
+        uses: softprops/action-gh-release@v1
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          name: Version ${{ steps.data.outputs.version }}
+          body_path: CHANGELOG.md
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,13 +1,8 @@
-.idea
-
-# vagrant
-.vagrant/
-vagrant
-
-# composer
-vendor/
-
-# locally generated docs
-build/api/
-build/phpdox/
-build/logs/
+/.idea
+/.tools/*
+/vendor/
+/composer.lock
+/tests/.coverage-cache
+/tests/clover.xml
+/tests/.phpunit.result.cache
+!.gitkeep

.phive/phars.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phive xmlns="https://phar.io/phive">
+  <phar name="phpunit" version="^9.5.13" installed="9.5.13" location="./.tools/phpunit.phar" copy="true"/>
+  <phar name="phpstan" version="^1.4.2" installed="1.4.2" location="./.tools/phpstan.phar" copy="true"/>
+  <phar name="composer" version="^2.2.5" installed="2.2.5" location="./.tools/composer.phar" copy="true"/>
+</phive>

.tools/.gitkeep

@@ -0,0 +1 @@
+# Keep this directory