Provide phar download and document phar installation

Author: pyrech

.github/actions/phar/action.yaml

@@ -0,0 +1,29 @@
+name: 'Build the PHAR'
+description: 'Build the PHAR for the current commit'
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: '8.1'
+
+    - name: Install dependencies (lib)
+      run: composer install --prefer-dist --no-progress --no-dev --optimize-autoloader --classmap-authoritative
+      shell: bash
+
+    - name: Install dependencies (PHAR builder)
+      run: composer install --prefer-dist --no-progress --optimize-autoloader --classmap-authoritative
+      shell: bash
+      working-directory: tools/phar
+
+    - name: Compile PHAR
+      run: vendor/bin/box compile
+      shell: bash
+      working-directory: tools/phar
+
+    - name: Ensure PHAR is OK
+      run: build/jolinotif.phar
+      shell: bash
+      working-directory: tools/phar

.github/workflows/build-phar.yaml

@@ -0,0 +1,26 @@
+name: Build the PHAR
+
+on:
+  push:
+    branches: [ "main" ]
+
+permissions:
+  contents: read
+
+jobs:
+  phar:
+    name: Create a PHAR and upload it as an artifact
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Build the PHAR
+        uses: ./.github/actions/phar
+
+      - name: Upload the PHAR
+        uses: actions/upload-artifact@v3
+        with:
+          name: 'jolinotif'
+          path: tools/phar/build/castor.phar
+          if-no-files-found: error

.github/workflows/ci.yml renamed to .github/workflows/ci.yaml

@@ -0,0 +1,35 @@
+name: Attach PHAR to the release
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  contents: write
+
+jobs:
+  phar_release:
+    name: Create a PHAR and upload it
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Build the PHAR
+        uses: ./.github/actions/phar
+
+      - name: Get release
+        id: get_release
+        uses: bruceadams/[email protected]
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+
+      - name: Upload release binary
+        uses: actions/[email protected]
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        with:
+          upload_url: ${{ steps.get_release.outputs.upload_url }}
+          asset_path: ./tools/phar/build/jolinotif.phar
+          asset_name: jolinotif.phar
+          asset_content_type: application/octet-stream

.github/workflows/release.yaml

@@ -2,7 +2,9 @@
 
 ## Installation
 
-Install package globally:
+There is two ways to install JoliNotif for a CLI usage.
+
+### Install package globally with Composer
 
 ```bash
 $ composer global require jolicode/jolinotif
@@ -19,6 +21,15 @@ $ echo "export PATH=~/.composer/vendor/bin:$PATH" >> ~/.bashrc
 $ source ~/.bashrc
 ```
 
+### Download the PHAR executable
+
+You can download the latest version of JoliNotif as a PHAR file from the [releases
+page](https://github.com/jolicode/JoliNotif/releases):
+
+```bash
+curl https://github.com/jolicode/JoliNotif/releases/latest/download/jolinotif.phar && sudo mv jolinotif.phar /usr/local/bin/jolinotif
+```
+
 ## Usage
 
 ```bash

doc/05-cli-usage.md

@@ -0,0 +1,2 @@
+/vendor/
+/build/

tools/phar/.gitignore

@@ -1,8 +1,7 @@
 {
-    "chmod": "0755",
+    "base-path": "../../",
     "directories": [
         "bin",
-        "example",
         "src"
     ],
     "files": [
@@ -21,7 +20,6 @@
         }
     ],
     "git-version": "package_version",
-    "main": "example/index.php",
-    "output": "build/jolinotif.phar",
-    "stub": true
+    "main": "jolinotif",
+    "output": "tools/phar/build/jolinotif.phar"
 }

box.json renamed to tools/phar/box.json

@@ -0,0 +1,21 @@
+{
+  "name": "jolicode/jolinotif-phar",
+  "description": "Tooling for building JoliNotif PHAR",
+  "type": "project",
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Loïck Piera",
+      "email": "[email protected]"
+    }
+  ],
+  "require": {
+    "humbug/box": "^4.3.8",
+    "humbug/php-scoper": "^0.18.3"
+  },
+  "config": {
+    "optimize-autoloader": true,
+    "preferred-install": "dist",
+    "sort-packages": true
+  }
+}