Initial version

Author: baschny

.gitignore

@@ -0,0 +1,2 @@
+/.idea
+*~

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Ernesto Baschny
+
+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

@@ -0,0 +1,81 @@
+baschny/action-php-composer
+===========================
+
+This GitHub action allows to run the latest composer on your source code.
+
+It uses the official composer docker image and allows efficient caching of
+downloaded assets.
+
+Input
+-----
+* `composer_version`: Major version to install. Basically any tag name from https://hub.docker.com/_/composer -
+   i.e. `1` or `2`. Defaults to `latest`.
+
+* `command`: The composer command to run, defaults to `install`. Set to `get_config` to only generate the output
+   variables of the composer setup (for use in cache, see example below)
+
+* `args`: Other command line arguments to pass to composer, defaults to `--optimize-autoloader --no-progress`
+
+Output
+------
+* `composer_cache_dir`: where the composer cache is located, in case you want to use `actions/cache`
+
+* `composer_major_version`: the detected major version of composer, useful to have a separate cache tag based on
+  this, since there can be slight differences in the caches between major versions.
+
+* `composer_version`: the exact composer version, in case you want to output this somewhere.
+
+Example Workflow
+----------------
+
+```yaml
+name: PHP Building Workflow
+
+on: [push]
+
+jobs:
+
+  composer_install:
+    runs-on: ubuntu-latest
+
+    env:
+      COMPOSER_VERSION: 1
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Get composer cache directory
+        id: composer_config
+        uses: baschny/action-php-composer
+        with:
+          composer_version: ${{ env.COMPOSER_VERSION }}
+          command: get_config
+
+      - name: Cache composer downloads
+        uses: actions/cache@v2
+        with:
+          path: ${{ steps.composer_config.outputs.composer_cache_dir }}
+          key: composer-v${{ steps.composer_config.outputs.composer_major_version }}
+
+      - name: Run composer install
+        uses: baschny/action-php-composer
+        with:
+          composer_version: ${{ env.COMPOSER_VERSION }}
+          command: install
+```
+
+License
+-------
+
+See LICENSE file.
+
+See also
+--------
+
+The idea came after some brainstorming in https://github.com/php-actions/composer.
+
+Author
+------
+
+Ernesto Baschny, cron IT GmbH

action.yml

@@ -0,0 +1,72 @@
+name: 'PHP Composer'
+description: 'Use the Composer CLI in your Github Actions.'
+
+inputs:
+  composer_version:
+    description: "What version of Composer to use"
+    default: latest
+    required: false
+
+  command:
+    description: "Composer command to run (or get_config to just get the output vars)"
+    required: true
+    default: install
+
+  args:
+    description: "Command line arguments to composer"
+    required: false
+    default: "--optimize-autoloader --no-progress"
+
+outputs:
+  composer_cache_dir:
+    description: "Where composer created its cache"
+    value: ${{ steps.composer_run.outputs.composer_cache_dir }}
+
+  composer_major_version:
+    description: "Major version of the composer run (can be used as part of the cache key)"
+    value: ${{ steps.composer_run.outputs.composer_major_version }}
+
+  composer_version:
+    description: "Exact version of the composer run"
+    value: ${{ steps.composer_run.outputs.composer_major_version }}
+
+runs:
+  using: "composite"
+  steps:
+    - env:
+        COMPOSER_VERSION: ${{ inputs.composer_version }}
+        COMPOSER_COMMAND: ${{ inputs.command }}
+        COMPOSER_ARGS: ${{ inputs.args }}
+      shell: bash
+      id: composer_run
+      run: |
+        set -e
+
+        # Make sure the latest version is available, pull it quietly
+        docker pull -q composer:${COMPOSER_VERSION}
+
+        # Extract the major version
+        DETECTED_VERSION=$(docker run --rm composer:${COMPOSER_VERSION} --version | perl -pe '($_)=/\b(\d+.\d+\.\d+)\b/;')
+        DETECTED_MAJOR_VERSION=$(docker run --rm composer:${COMPOSER_VERSION} --version | perl -pe '($_)=/\b(\d)\d*\.\d+\.\d+/;')
+        echo "::set-output name=composer_cache_dir::${RUNNER_WORKSPACE}/composer/cache"
+        echo "::set-output name=composer_major_version::${DETECTED_MAJOR_VERSION}"
+        echo "::set-output name=composer_version::${DETECTED_VERSION}"
+
+        case "${COMPOSER_COMMAND}" in
+          get_config)
+            exit
+            ;;
+
+          *)
+            echo "Running composer v${DETECTED_VERSION} with: $COMPOSER_COMMAND $COMPOSER_ARGS"
+            docker run --rm \
+              --volume ${RUNNER_WORKSPACE}/composer:/tmp \
+              --volume ${GITHUB_WORKSPACE}:/app \
+              -w /app \
+              composer:${COMPOSER_VERSION} $COMPOSER_COMMAND $COMPOSER_ARGS
+            ;;
+        esac
+
+branding:
+  icon: 'package'
+  color: 'purple'