feat: first version

Author: joshuanapoli

README.md

@@ -0,0 +1,63 @@
+# Python Poetry Test Action
+
+Test Poetry-based projects using ruff, mypy, and pytest.
+
+1. Install Python
+2. Installs Poetry
+3. Installs dependencies
+4. Runs `ruff check` on source directories
+5. Runs `ruff format --check` on source directories
+6. Runs `mypy` on source directories
+7. Runs `pytest`
+
+## Inputs
+
+| Input | Description | Required | Default |
+|-------|-------------|----------|---------|
+| `python-version` | Python version to use | No | `3.14` |
+| `poetry-version` | Poetry version to install | No | `2.2.1` |
+| `src-dirs` | Source directories for linting (space-separated) | No | `src tests` |
+
+## Usage
+
+```yaml
+steps:
+  - name: Checkout
+    uses: actions/checkout@v6
+
+  - name: Test with Poetry
+    uses: CVector-Energy/python-test@main
+```
+
+### With custom Python version
+
+```yaml
+steps:
+  - name: Checkout
+    uses: actions/checkout@v6
+
+  - name: Test with Poetry
+    uses: CVector-Energy/python-test@main
+    with:
+      python-version: "3.12"
+```
+
+### Matrix testing
+
+```yaml
+jobs:
+  test:
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.14"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Test with Poetry
+        uses: your-org/python-test@main
+        with:
+          python-version: ${{ matrix.python-version }}
+```

action.yml

@@ -0,0 +1,72 @@
+name: Test
+description: Setup Poetry and run ruff, mypy, and pytest for Python projects
+
+inputs:
+  python-version:
+    description: Python version to use
+    required: false
+    default: "3.14"
+  poetry-version:
+    description: Poetry version to install
+    required: false
+    default: "2.2.1"
+  src-dirs:
+    description: Source directories for linting (space-separated)
+    required: false
+    default: "src tests"
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Python ${{ inputs.python-version }}
+      id: setup
+      uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Load cached Poetry installation
+      id: cached-poetry
+      uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+      with:
+        path: ~/.local
+        key: poetry-${{ inputs.poetry-version }}
+
+    - name: Install Poetry
+      uses: snok/install-poetry@76e04a911780d5b312d89783f7b1cd627778900a # v1.4.1
+      with:
+        version: ${{ inputs.poetry-version }}
+        virtualenvs-path: ~/.venv
+
+    - name: Load cached venv
+      id: venv
+      uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+      with:
+        path: ~/.venv
+        key: venv-${{ runner.os }}-${{ steps.setup.outputs.python-version }}-${{ hashFiles('**/poetry.lock') }}
+        restore-keys: |
+          venv-${{ runner.os }}-${{ steps.setup.outputs.python-version }}-
+
+    - name: Sync dependencies
+      if: steps.venv.outputs.cache-hit != 'true'
+      shell: bash
+      run: poetry sync --no-interaction --no-root
+
+    - name: Install project
+      shell: bash
+      run: poetry install --no-interaction --only-root
+
+    - name: Run ruff check
+      shell: bash
+      run: poetry run ruff check ${{ inputs.src-dirs }}
+
+    - name: Run ruff format check
+      shell: bash
+      run: poetry run ruff format --check ${{ inputs.src-dirs }}
+
+    - name: Run mypy
+      shell: bash
+      run: poetry run mypy ${{ inputs.src-dirs }}
+
+    - name: Run pytest
+      shell: bash
+      run: poetry run pytest