.github/FUNDING.yml

@@ -1,12 +1 @@
-# These are supported funding model platforms
-
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: abatilo
-open_collective: # Replace with a single Open Collective username
-ko_fi: abatilo
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: abatilo
-otechie: # Replace with a single Otechie username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
+custom: ['https://www.buymeacoffee.com/abatilo']

.github/workflows/ci.yml

@@ -10,13 +10,13 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.6, 3.7, 3.8]
-        poetry-version: [1.0, 1.0.10]
-        os: [ubuntu-18.04, macos-latest, windows-latest]
+        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        poetry-version: ["latest", "1.2.2", "1.3.2", "1.4.2", "1.5.1", "1.6.1"]
+        os: [ubuntu-22.04, macos-latest, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
       - name: Run image
@@ -25,13 +25,28 @@ jobs:
           poetry-version: ${{ matrix.poetry-version }}
       - name: View poetry --help
         run: poetry --help
+  ci-all:
+    runs-on: ubuntu-latest
+    needs: [ci]
+    steps:
+      - run: |
+          echo "All matrix jobs have completed successfully!"
   release:
     if: github.event_name == 'push'
-    needs: ci
+    needs: ci-all
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@master
       - name: Generate release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: npx semantic-release
+      - name: Update major tag
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git tag -d v2
+          git push --delete origin v2
+          git push origin :refs/tags/v2
+          git tag v2
+          git push --tags

.github/workflows/lint-pr.yml

@@ -10,6 +10,6 @@ jobs:
   main:
     runs-on: ubuntu-latest
     steps:
-      - uses: amannn/action-semantic-pull-request@v1.2.0
+      - uses: amannn/action-semantic-pull-request@v5.4.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -10,12 +10,16 @@ GitHub Actions for Python projects using poetry
 ## Getting started
 
 ### Breaking changes for v2
-We've drastically simplified this GitHub Action for v2. This is no longer a
-Docker action that runs as its own container, it's just a simplified way for
-you to install poetry. This action now makes an assumption that you've already
-setup Python via `setup-python` or some other way. Since we're installing poetry directly to your environment, this also means that you can cache your dependencies more easily since everything is running on the host runner instead of an isolated container environment.
+
+We've drastically simplified this GitHub Action for v2.
+This is no longer a Docker action that runs as its own container,
+it's just a simplified way for you to install poetry.
+This action now makes an assumption that you've already setup Python via `setup-python` or some other way.
+Since we're installing poetry directly to your environment,
+this also means that you can cache your dependencies more easily since everything is running on the host runner instead of an isolated container environment.
 
 ### Create your workflow
+
 ```yaml
 name: CI
 on: pull_request
@@ -25,30 +29,85 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.6, 3.7, 3.8]
-        poetry-version: [1.0, 1.0.10]
-        os: [ubuntu-18.04, macos-latest, windows-latest]
+        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        poetry-version: ["1.2.2", "1.7.1"]
+        os: [ubuntu-22.04, macos-latest, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
       - name: Run image
-        uses: abatilo/actions-poetry@v2.0.0
+        uses: abatilo/actions-poetry@v2
         with:
           poetry-version: ${{ matrix.poetry-version }}
       - name: View poetry --help
         run: poetry --help
 ```
 
+### Workflow example: cache the virtual environment
+
+It is possible to combine `actions/poetry` with [actions/cache](https://github.com/actions/cache) to speed up the installation of dependencies.
+The recipe is:
+
+1. to ask `poetry` to create a virtual environment inside the project:
+it creates a local `.venv/` folder that can be cached
+2. to create a cache key that involves the contents of the `poetry.lock` file:
+if the contents change (meaning that dependencies have changed), then the cache needs to be invalidated and recreated
+
+For the 1st step, you either need:
+
+- to have a `poetry.toml` file at the root of your project with these 2 settings:
+
+```ini
+[virtualenvs]
+create = true
+in-project = true
+```
+
+- or to run the following commands in the github actions to create the `poetry.toml` file:
+
+```sh
+poetry config virtualenvs.create true --local
+poetry config virtualenvs.in-project true --local
+```
+
+Here is an example of how the steps must be declared:
+
+```yaml
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Python
+        uses: actions/setup-python@v4
+        # see details (matrix, python-version, python-version-file, etc.)
+        # https://github.com/actions/setup-python
+      - name: Install poetry
+        uses: abatilo/actions-poetry@v2
+      - name: Setup a local virtual environment (if no poetry.toml file)
+        run: |
+          poetry config virtualenvs.create true --local
+          poetry config virtualenvs.in-project true --local
+      - uses: actions/cache@v3
+        name: Define a cache for the virtual environment based on the dependencies lock file
+        with:
+          path: ./.venv
+          key: venv-${{ hashFiles('poetry.lock') }}
+      - name: Install the project dependencies
+        run: poetry install
+      - name: Run the automated tests (for example)
+        run: poetry run pytest -v
+```
+
 ## License
 
 [MIT License - abatilo/actions-poetry]
 
 [MIT License - abatilo/actions-poetry]: https://github.com/abatilo/actions-poetry/blob/master/LICENSE
 
-
 ## About the author
 
 - [abatilo's homepage](https://www.aaronbatilo.dev/)

action.yml

@@ -7,11 +7,31 @@ branding:
 inputs:
   poetry-version:
     description: "The version of poetry to install"
-    required: true
-    default: "1.0"
+    required: false
+    default: "latest"
+  poetry-plugins:
+    description: "The whitespace/newline-separated list of poetry plugins to install."
+    required: false
+    default: ""
 runs:
   using: "composite"
   steps:
     - run: |
-        pip install poetry==${{ inputs.poetry-version }}
+        pip install --user pipx
+        pipx ensurepath
+      shell: bash
+    - if: ${{ inputs.poetry-version == 'latest' }}
+      run: |
+        pipx install poetry
+      shell: bash
+    - if: ${{ inputs.poetry-version != 'latest' }}
+      run: |
+        pipx install poetry==${{ inputs.poetry-version }}
+      shell: bash
+    - if: ${{ inputs.poetry-plugins != '' }}
+      run: |
+        ALL_PLUGINS=$(echo "${{ inputs.poetry-plugins }}")
+        for PLUGIN in $ALL_PLUGINS; do
+          poetry self add $PLUGIN
+        done
       shell: bash