Add initial project layout

Author: pcolby

.github/dependabot.yaml

@@ -0,0 +1,7 @@
+version: 2
+
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: daily

.github/workflows/test.yaml

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: 2024 Paul Colby <[email protected]>
+# SPDX-License-Identifier: MIT
+
+name: CI
+
+on:
+  - push
+  - pull_request
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: yamllint .
+
+  test-defaults:
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./
+      - run: linuxdeploy-x86_64.AppImage --list-plugins
+    strategy:
+      matrix:
+        os:
+          - ubuntu-20.04
+          - ubuntu-22.04
+          - ubuntu-24.04
+      fail-fast: false
+
+  test-options:
+    runs-on: ${{ matrix.os }}
+    env:
+      INSTALL_DIR: ${{ \todo }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Test defaults
+        uses: ./
+        with:
+      - name: Check result
+        run: "${DIR}/linuxdeploy-x86_64.AppImage" --list-plugins
+        # \todo check other stuff too.
+        with:
+          dir: ..
+    strategy:
+      matrix:
+        os:
+          - ubuntu-20.04
+          - ubuntu-22.04
+          - ubuntu-24.04
+      fail-fast: false

.yamllint.yaml

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2024 Paul Colby <[email protected]>
+# SPDX-License-Identifier: MIT
+
+extends: default
+
+rules:
+  comments:
+    min-spaces-from-content: 1
+  document-start:
+    present: false
+  line-length:
+    max: 120
+  truthy:
+    check-keys: false

LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2024 Paul Colby
+
+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,62 @@
+# `install-linuxdeploy-action`
+
+[![CI](https://github.com/pcolby/install-linuxdeploy-action/actions/workflows/test.yaml/badge.svg?branch=main)](
+  https://github.com/pcolby/pcolby/install-linuxdeploy-action/actions/workflows/test.yaml)
+
+GitHub Action for installing [linuxdeploy] with optional plugins.
+
+## Usage
+
+```yaml
+- uses: pcolby/install-linuxdeploy-action@v1
+```
+
+## Options
+
+### `arch`
+
+The target architecture to install [linuxdeploy] for. This can be any architecture that [linuxdeploy] releases binaries
+for, but typically you'd want to leave it to default to `x86_64`.
+
+### `dir`
+
+The target directory to install [linuxdeploy] to. Defaults to `${GITHUB_WORKSPACE}/linuxdeploy`.
+
+### `install-deps`
+
+Whether or not to install known `apt` dependencies. Defaults to `true`.
+
+### `plugins`
+
+Space-separated list of optional [linuxdeploy] plugins to install. Any plugins directly listed in the
+[Awesome linuxdeploy!] listing should be supported, such as `appimage` and `qt`.
+
+### `set-env`
+
+Whether or not to update the `$PATH` environment variable to include the installation `dir`. Defaults to `true`.
+
+### `version`
+
+The [linuxdeploy] version to install, as well as the _default_ version for any `plugins` entries that don't specify a
+version.
+
+> [!IMPORTANT]
+> Currently this defaults to `continuous`, as [linuxdeploy] currently has no official stable release, but at some point
+> this will likely default to the most recent, current, tested stable [linuxdeploy] version.
+
+### Example with all options
+
+```
+- name: Install linuxdeploy
+  uses: pcolby/install-linuxdeploy-action@v1
+  with:
+    arch: x86_64
+    dir: ${{ github.workspace }}/linuxdeploy
+    install-deps: true
+    plugins: qt
+    set-env: true
+    version: continuous
+```
+
+[Awesome linuxdeploy!]: https://github.com/linuxdeploy/awesome-linuxdeploy
+[linuxdeploy]: https://github.com/linuxdeploy/linuxdeploy

action.yaml

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: 2024 Paul Colby <[email protected]>
+# SPDX-License-Identifier: MIT
+
+name: Summarize Test Results
+
+author: Paul Colby
+
+description: Summarise TAP (Test Anything Protocol) test results
+
+inputs:
+  arch:
+    description: Target architecture to install linuxdeploy
+    default: x86_64
+  dir:
+    description: Target directory to install linuxdeploy
+    required: false
+  install-deps:
+    description: Install known OS dependencies
+    default: true
+  plugins:
+    description: Additional linuxdeploy plugins to install
+    required: false
+  set-env:
+    description: Add the installed directory to the $PATH environment variable
+    default: true
+  version:
+    description: Version of linudeploy to install
+    default: continuous
+
+runs:
+  using: composite
+  steps:
+    - run: |
+        set -o errexit -o noclobber -o nounset -o pipefail
+        [[ ${INPUTS_INSTALL_DEPS}" = 'false' ]] || echo '\todo: install dependencies'
+        # \todo Build URLs list, and binaries list (using arch, plugins, version)
+        curl --create-dirs --location --output-dir "${INPUTS_DIR}" --remote-name-all "${urls[@}}"
+        chmod a+x "${binaries}"
+        [[ "${INPUTS_SET_ENV}" = 'false' ]] || tee -a "${GITHUB_PATH}" <<< "${INPUTS_DIR}"
+      shell: bash
+      env:
+        INPUTS_ARCH: ${{ inputs.arch }}
+        INPUTS_DIR: ${{ inputs.dir }}
+        INPUTS_INSTALL_DEPS: ${{ inputs.install-deps }}
+        INPUTS_PLUGINS: ${{ inputs.plugins }}
+        INPUTS_SET_ENV: ${{ inputs.set-env }}
+        INPUTS_VERSION: ${{ inputs.version }}
+
+branding:
+  color: green
+  icon: package