Merge branch 'main' into 1626-configurable-batch-size-and-max-wait-li…

…mit-for-targets

.github/ISSUE_TEMPLATE/bug.yml

@@ -15,7 +15,7 @@ body:
     attributes:
       label: Singer SDK Version
       description: Version of the library you are using
-      placeholder: "0.34.0"
+      placeholder: "0.34.1"
     validations:
       required: true
   - type: checkboxes

.github/dependabot.yml

@@ -20,3 +20,7 @@ updates:
       interval: weekly
     reviewers: [meltano/engineering]
     labels: [deps]
+    groups:
+      actions:
+        patterns:
+          - "*"

.github/workflows/codeql-analysis.yml

@@ -36,12 +36,10 @@ jobs:
         # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
 
     steps:
-    - name: Checkout repository
-      uses: actions/[email protected]
+    - uses: actions/checkout@v4
 
     # Initializes the CodeQL tools for scanning.
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+    - uses: github/codeql-action/init@v3
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -54,8 +52,7 @@ jobs:
 
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
+    - uses: github/codeql-action/autobuild@v3
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
@@ -67,5 +64,4 @@ jobs:
     #   echo "Run, Build Application using script"
     #   ./location_of_script_within_repo/buildscript.sh
 
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+    - uses: github/codeql-action/analyze@v3

.github/workflows/codspeed.yml

@@ -4,7 +4,21 @@ on:
   push:
     branches:
       - "main"
+    paths:
+      - "singer_sdk/**"
+      - "tests/**"
+      - "noxfile.py"
+      - "poetry.lock"
+      - "pyproject.toml"
+      - ".github/workflows/codspeed.yml"
   pull_request:
+    paths:
+      - "singer_sdk/**"
+      - "tests/**"
+      - "noxfile.py"
+      - "poetry.lock"
+      - "pyproject.toml"
+      - ".github/workflows/codspeed.yml"
   # `workflow_dispatch` allows CodSpeed to trigger backtest
   # performance analysis in order to generate initial data.
   workflow_dispatch:
@@ -13,13 +27,10 @@ jobs:
   benchmarks:
     runs-on: ubuntu-latest
     steps:
-    - name: Check out the repository
-      uses: actions/[email protected]
-
-    - name: Setup Python
-      uses: actions/[email protected]
+    - uses: actions/checkout@v4
+    - uses: actions/setup-python@v5
       with:
-        python-version: 3.11
+        python-version: 3.12
         architecture: x64
 
     - name: Install poetry
@@ -37,8 +48,7 @@ jobs:
         --with benchmark
         --all-extras
 
-    - name: Run benchmarks
-      uses: CodSpeedHQ/action@v2
+    - uses: CodSpeedHQ/action@v2
       with:
         token: ${{ secrets.CODSPEED_TOKEN }}
         run: pytest tests/ --codspeed

.github/workflows/constraints.txt

@@ -1,6 +1,6 @@
-pip==23.3.1
+pip==23.3.2
 poetry==1.7.1
 poetry-plugin-export==1.6.0
-pre-commit==3.5.0
+pre-commit==3.6.0
 nox==2023.4.22
 nox-poetry==1.0.3

.github/workflows/cookiecutter-e2e.yml

@@ -33,9 +33,7 @@ jobs:
           - { python-version: "3.11",  os: "ubuntu-latest" }
 
     steps:
-    - name: Check out the repository
-      uses: actions/[email protected]
-
+    - uses: actions/checkout@v4
     - name: Upgrade pip
       env:
         PIP_CONSTRAINT: .github/workflows/constraints.txt
@@ -52,8 +50,7 @@ jobs:
         poetry --version
         poetry self show plugins
 
-    - name: Setup Python ${{ matrix.python-version }}
-      uses: actions/[email protected]
+    - uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
         architecture: x64
@@ -77,10 +74,10 @@ jobs:
       run: |
         nox --python=${{ matrix.python-version }} --session=test_cookiecutter
 
-    - name: Upload build artifacts
+    - uses: actions/upload-artifact@v4
       if: always()
-      uses: actions/upload-artifact@v3
       with:
+        name: cookiecutter-${{ matrix.os }}-py${{ matrix.python-version }}
         path: |
           /tmp/tap-*
           /tmp/target-*

.github/workflows/dependency-review.yml

@@ -12,11 +12,8 @@ jobs:
   dependency-review:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout the repository
-        uses: actions/[email protected]
-
-      - name: GitHub dependency vulnerability check
+      - uses: actions/checkout@v4
+      - uses: actions/dependency-review-action@v3
         if: ${{ github.event_name == 'pull_request_target' }}
-        uses: actions/[email protected]
         with:
           fail-on-severity: high

.github/workflows/release.yml

@@ -17,10 +17,10 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4.1.1
+      uses: actions/checkout@v4
 
     - name: Set up Python
-      uses: actions/setup-python@v4.7.1
+      uses: actions/setup-python@v5
       with:
         python-version: "3.11"
 

.github/workflows/test.yml

@@ -47,16 +47,15 @@ jobs:
       matrix:
         session: [tests]
         os: ["ubuntu-latest", "macos-latest", "windows-latest"]
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
-        sqlalchemy: ["2.*"]
+        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
+        sqlalchemy: ["2"]
         include:
-        - { session: tests,   python-version: "3.11", os: "ubuntu-latest", sqlalchemy: "1.*" }
-        - { session: doctest, python-version: "3.11", os: "ubuntu-latest", sqlalchemy: "2.*" }
-        - { session: mypy,    python-version: "3.11",  os: "ubuntu-latest", sqlalchemy: "2.*" }
+        - { session: tests,   python-version: "3.11", os: "ubuntu-latest", sqlalchemy: "1" }
+        - { session: doctest, python-version: "3.11", os: "ubuntu-latest", sqlalchemy: "2" }
+        - { session: mypy,    python-version: "3.11",  os: "ubuntu-latest", sqlalchemy: "2" }
 
     steps:
-    - name: Check out the repository
-      uses: actions/[email protected]
+    - uses: actions/checkout@v4
 
     - name: Install Poetry
       env:
@@ -67,8 +66,7 @@ jobs:
         poetry --version
         poetry self show plugins
 
-    - name: Setup Python ${{ matrix.python-version }}
-      uses: actions/[email protected]
+    - uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
         architecture: x64
@@ -96,11 +94,10 @@ jobs:
       run: |
         nox --verbose
 
-    - name: Upload coverage data
+    - uses: actions/upload-artifact@v4
       if: always() && (matrix.session == 'tests')
-      uses: actions/[email protected]
       with:
-        name: coverage-data
+        name: coverage-data-nox_${{ matrix.session }}-${{ matrix.os }}-py${{ matrix.python-version }}_sqlalchemy_${{ matrix.sqlalchemy }}
         path: ".coverage.*"
 
   tests-external:
@@ -119,8 +116,7 @@ jobs:
       SAMPLE_TAP_GOOGLE_ANALYTICS_VIEW_ID: ${{ secrets.SAMPLE_TAP_GOOGLE_ANALYTICS_VIEW_ID }}
 
     steps:
-    - name: Check out the repository
-      uses: actions/[email protected]
+    - uses: actions/checkout@v4
 
     - name: Install Poetry
       env:
@@ -131,8 +127,7 @@ jobs:
         poetry --version
         poetry self show plugins
 
-    - name: Setup Python
-      uses: actions/[email protected]
+    - uses: actions/setup-python@v5
       with:
         python-version: ${{ env.NOXPYTHON }}
         architecture: x64
@@ -163,8 +158,7 @@ jobs:
     runs-on: ubuntu-latest
     needs: tests
     steps:
-    - name: Check out the repository
-      uses: actions/[email protected]
+    - uses: actions/checkout@v4
 
     - name: Install Poetry
       env:
@@ -175,8 +169,7 @@ jobs:
         poetry --version
         poetry self show plugins
 
-    - name: Set up Python
-      uses: actions/[email protected]
+    - uses: actions/setup-python@v5
       with:
         python-version: '3.11'
         cache: 'pip'
@@ -187,10 +180,10 @@ jobs:
         pip install --constraint=.github/workflows/constraints.txt pip
         pip --version
 
-    - name: Download coverage data
-      uses: actions/[email protected]
+    - uses: actions/download-artifact@v4
       with:
-        name: coverage-data
+        pattern: coverage-data-*
+        merge-multiple: true
 
     - name: Install Nox
       env:
@@ -208,8 +201,7 @@ jobs:
       run: |
         nox --session=coverage -- xml
 
-    - name: Upload coverage report
-      uses: codecov/[email protected]
+    - uses: codecov/codecov-action@v3
       with:
         fail_ci_if_error: true
         token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/version_bump.yml

@@ -36,12 +36,11 @@ jobs:
       discussions: write    # to create a discussion
 
     steps:
-    - uses: actions/checkout@v4.1.1
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
 
-    - name: Set up Python
-      uses: actions/[email protected]
+    - uses: actions/setup-python@v5
       with:
         python-version: "3.11"
         architecture: x64

.pre-commit-config.yaml

@@ -38,14 +38,14 @@ repos:
         )$
 
 - repo: https://github.com/python-jsonschema/check-jsonschema
-  rev: 0.27.2
+  rev: 0.27.3
   hooks:
   - id: check-dependabot
   - id: check-github-workflows
   - id: check-readthedocs
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.1.6
+  rev: v0.1.11
   hooks:
   - id: ruff
     args: [--fix, --exit-non-zero-on-fix, --show-fixes]
@@ -60,7 +60,7 @@ repos:
       )$
 
 - repo: https://github.com/pycqa/flake8
-  rev: 6.1.0
+  rev: 7.0.0
   hooks:
   - id: flake8
     additional_dependencies:

CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v0.34.1 (2023-12-19)
+
+### 🐛 Fixes
+
+- [#2118](https://github.com/meltano/sdk/issues/2118) Output JSONPath expression with match count message -- _**Thanks @mjsqu!**_
+- [#2107](https://github.com/meltano/sdk/issues/2107) Respect forced replication method when retrieving state
+- [#2094](https://github.com/meltano/sdk/issues/2094) Use `nulls_first` when available to order `NULL` results in incremental SQL streams
+
+### ⚙️ Under the Hood
+
+- [#1733](https://github.com/meltano/sdk/issues/1733) Test with Python 3.12 🐍
+- [#2095](https://github.com/meltano/sdk/issues/2095) Use `CursorResult.mappings()` in SQL streams
+- [#2092](https://github.com/meltano/sdk/issues/2092) Use `datetime.fromisoformat` in other places
+- [#2090](https://github.com/meltano/sdk/issues/2090) Explicitly use `T` iso date separator
+
+### 📚 Documentation Improvements
+
+- [#2111](https://github.com/meltano/sdk/issues/2111) Fix broken requests documentation links -- _**Thanks @mjsqu!**_
+
 ## v0.34.0 (2023-12-05)
 
 ## v0.34.0rc1 (2023-12-05)

cookiecutter/mapper-template/{{cookiecutter.mapper_id}}/.github/workflows/{% if cookiecutter.include_ci_files == 'GitHub' %}test.yml{%endif%}

@@ -12,11 +12,11 @@ jobs:
       GITHUB_TOKEN: {{ '${{secrets.GITHUB_TOKEN}}' }}
     strategy:
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python {{ '${{ matrix.python-version }}' }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: {{ '${{ matrix.python-version }}' }}
     - name: Install Poetry

cookiecutter/mapper-template/{{cookiecutter.mapper_id}}/.pre-commit-config.yaml

@@ -14,19 +14,19 @@ repos:
   - id: trailing-whitespace
 
 - repo: https://github.com/python-jsonschema/check-jsonschema
-  rev: 0.27.2
+  rev: 0.27.3
   hooks:
   - id: check-dependabot
   - id: check-github-workflows
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.1.6
+  rev: v0.1.11
   hooks:
   - id: ruff
     args: [--fix, --exit-non-zero-on-fix, --show-fixes]
   - id: ruff-format
 
 - repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v1.7.1
+  rev: v1.8.0
   hooks:
   - id: mypy