etlplus 0.7.1__tar.gz

etlplus-0.7.1/.coveragerc

@@ -0,0 +1,21 @@
+# .coveragerc
+# ETLPlus
+#
+# Copyright © 2025 Dagitali LLC. All rights reserved.
+#
+# An optional pytest-cov configuration file. Limits coverage measurement to the
+# ETLPlus package and ignore test modules.
+#
+# See:
+# 1. https://pytest-cov.readthedocs.io/en/latest/config.html
+
+[run]
+source = etlplus
+branch = true
+omit =
+    tests/*
+    */tests/*
+
+[report]
+skip_covered = true
+show_missing = true

etlplus-0.7.1/.editorconfig

@@ -0,0 +1,156 @@
+# .editorconfig
+# ETLPlus
+#
+# Copyright © 2025 Dagitali LLC. All rights reserved.
+#
+# The EditorConfig file. Defines coding styles and a collection of text editor
+# plugins that enable editors to read the file format and adhere to defined
+# styles. Helps maintain consistent coding styles for multiple developers
+# working on the same project across various editors and IDEs.
+#
+# See:
+# 1. https://editorconfig.org/#file-format-details
+# 2. https://github.com/jokeyrhyme/standard-editorconfig
+
+# Top-most EditorConfig file
+root = true
+
+# Defaults
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Bazel
+# https://bazel.build/
+# https://github.com/bazelbuild/buildtools/blob/master/BUILD.bazel
+[*.{bazel,bzl}]
+indent_size = 4
+indent_style = space
+
+# CSS
+# https://google.github.io/styleguide/htmlcssguide.xml#General_Formatting_Rules
+# http://cssguidelin.es/#syntax-and-formatting
+[*.css]
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+
+# GNU Make
+# https://www.gnu.org/software/make/manual/html_node/Recipe-Syntax.html
+[Makefile,*.mk]
+indent_style = tab
+
+# Go
+# https://golang.org/cmd/gofmt/
+[{go.mod,*.go}]
+indent_style = tab
+
+# GraphQL
+# https://graphql.org/learn/
+# https://prettier.io
+[*.graphql]
+indent_size = 2
+indent_style = space
+
+# HTML
+# https://google.github.io/styleguide/htmlcssguide.xml#General_Formatting_Rules
+[*.{htm,html}]
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+
+# Java
+# https://google.github.io/styleguide/javaguide.html#s4.2-block-indentation
+[*.java]
+indent_size = 2
+indent_style = space
+
+# JavaScript, JSON, JSX, JavaScript Modules, TypeScript
+# https://github.com/feross/standard
+# https://prettier.io
+[*.{cjs,js,json,jsx,mjs,ts,tsx}]
+indent_size = 2
+indent_style = space
+
+# Kotlin
+# https://android.github.io/kotlin-guides/style.html#indentation
+[*.{kt,kts}]
+indent_size = 4
+indent_style = space
+
+# LESS
+# https://github.com/less/less-docs#less-standards
+[*.less]
+indent_size = 2
+indent_style = space
+
+# Lua
+# http://lua-users.org/wiki/LuaStyleGuide
+[*.{lua,luacheckrc}]
+indent_size = 2
+indent_style = space
+
+# PHP
+# http://www.php-fig.org/psr/psr-2/
+[*.php]
+indent_size = 4
+indent_style = space
+
+# Python
+# https://www.python.org/dev/peps/pep-0008/#code-lay-out
+[*.py]
+indent_size = 4
+indent_style = space
+
+# Ruby
+# http://www.caliban.org/ruby/rubyguide.shtml#indentation
+[*.rb]
+indent_size = 2
+indent_style = space
+
+# Rust
+# https://github.com/rust-lang/rust/blob/master/src/doc/style/style/whitespace.md
+[*.rs]
+indent_size = 4
+indent_style = space
+insert_final_newline = false
+trim_trailing_whitespace = true
+
+# SASS
+# https://sass-guidelin.es/#syntax--formatting
+[*.{sass,scss}]
+indent_size = 2
+indent_style = space
+
+# Shell
+# https://google.github.io/styleguide/shell.xml#Indentation
+[*.{bash,sh,zsh}]
+indent_size = 2
+indent_style = space
+
+# Svelte
+# https://github.com/sveltejs/svelte/blob/master/.editorconfig
+[*.svelte]
+indent_size = 2
+indent_style = tab
+
+# TOML
+# https://github.com/toml-lang/toml/tree/master/examples
+[*.toml]
+indent_size = 2
+indent_style = space
+
+# Vue.js
+# https://eslint.vuejs.org/rules/html-indent.html
+# https://eslint.vuejs.org/rules/script-indent.html
+[*.vue]
+indent_size = 2
+indent_style = space
+
+# YAML
+# http://yaml.org/spec/1.2/2009-07-21/spec.html#id2576668
+[*.{yaml,yml}]
+indent_size = 2
+indent_style = space

etlplus-0.7.1/.gitattributes

@@ -0,0 +1,13 @@
+# .gitattributes
+# ETLPlus
+#
+# Copyright © 2025 Dagitali LLC. All rights reserved.
+#
+# An optional Git configuration file. Defines attributes per pathname.
+#
+# See:
+# 1. https://fileinfo.com/extension/gitattributes
+# 2. https://git-scm.com/docs/gitattributes
+
+# Auto detect text files and perform LF normalization
+* text=auto

etlplus-0.7.1/.github/actions/python-bootstrap/action.yml

@@ -0,0 +1,42 @@
+# action.yml
+# ETLPlus
+#
+# Copyright © 2025 Dagitali LLC. All rights reserved.
+#
+# A GitHub Actions action to set up Python and install Python package
+# dependencies.
+#
+# Notes
+# - External GitHub Actions action references are each pinned to specific SHA
+#   to limit supply-chain risk.
+
+---
+
+name: Setup Python and Install Dependencies
+
+description: >-
+  Sets up the requested Python runtime, upgrades pip, and installs the provided
+  dependency list to keep workflow jobs consistent.
+
+inputs:
+  python-version:
+    description: Python version to install via actions/setup-python
+    required: true
+  python-bootstrap:
+    description: Arguments passed to "pip install"
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # Pinned v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Upgrade pip
+      shell: bash
+      run: python -m pip install --upgrade pip
+
+    - name: Install dependencies
+      shell: bash
+      run: pip install ${{ inputs.python-bootstrap }}

etlplus-0.7.1/.github/workflows/ci.yml

@@ -0,0 +1,160 @@
+# ci.yml
+# ETLPlus
+#
+# Copyright © 2025 Dagitali LLC. All rights reserved.
+#
+# A GitHub Actions workflow configuration file for Continuous Integration (CI).
+#
+# Notes
+# - The workflow includes jobs for linting, testing, building distributions,
+#   and publishing releases to GitHub and PyPI.
+# - The workflow is hardened by removing global permissions and setting per-job
+#   scopes.
+# - To harden workflow security, global permissions are absent, and per-job
+#   permissions are set as needed.
+# - External GitHub Actions action references are each pinned to specific SHA
+#   to limit supply-chain risk.
+
+---
+
+name: CI
+
+on:
+  push:
+    branches:
+      # GitFlow branches
+      - main
+      - develop
+      - '**/feature/**'
+      - '**/bugfix/**'
+      - '**/release/**'
+      - '**/hotfix/**'
+
+      # Extended branches
+      - '**/chore/**'
+      - '**/ci/**'
+      - '**/docs/**'
+    tags: [ 'v*.*.*' ]
+  pull_request:
+    branches: [ main, develop ]
+
+permissions: {}
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy: &python-matrix
+      matrix:
+        python-version: ['3.13', '3.14']
+    permissions: &permissions_read
+      contents: read
+    steps:
+      - &checkout_step
+        name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # Pinned v4
+        with:
+          fetch-depth: 0
+      - uses: ./.github/actions/python-bootstrap
+        with:
+          python-version: ${{ matrix.python-version }}
+          python-bootstrap: ".[dev]"
+      - name: Ruff check
+        run: |
+          ruff version
+          ruff check .
+          ruff format --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy: *python-matrix
+    permissions: *permissions_read
+    steps:
+      - *checkout_step
+      - uses: ./.github/actions/python-bootstrap
+        with:
+          python-version: ${{ matrix.python-version }}
+          python-bootstrap: "-e .[dev,yaml]"
+      - name: Run tests (with coverage)
+        run: |
+          pytest -q \
+            --cov \
+            --cov-branch \
+            --cov-config=.coveragerc \
+            --cov-report=term-missing \
+            --cov-report=xml \
+            tests/
+
+      - name: Upload coverage reports to Codecov
+        if: matrix.python-version == '3.13'
+        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de  # Pinned v5.5.2
+        with:
+          fail_ci_if_error: true
+          files: coverage.xml
+          flags: unit
+          name: etlplus
+          token: ${{ secrets.CODECOV_TOKEN }}  # Omit for public repo
+          verbose: true
+
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    if: &release_tag_condition >
+      startsWith(github.ref, 'refs/tags/v') ||
+      startsWith(github.ref, 'refs/tags/rc')
+    needs: [lint, test]
+    permissions: *permissions_read
+    steps:
+      - *checkout_step
+      - uses: ./.github/actions/python-bootstrap
+        with:
+          python-version: '3.13'
+          python-bootstrap: build
+      - name: Build distributions
+        run: |
+          python -m build
+      - name: Upload distributions
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # Pinned v4
+        with:
+          name: dist-artifacts
+          path: dist/*
+          if-no-files-found: error
+
+  release:
+    name: Publish GitHub Release
+    runs-on: ubuntu-latest
+    if: *release_tag_condition
+    needs: build
+    permissions:
+      contents: write
+    steps:
+      - *checkout_step
+      - &download_dist_step
+        name: Download distributions
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # Pinned v4
+        with:
+          name: dist-artifacts
+          path: dist
+      - name: Publish GitHub release
+        uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b  # Pinned v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    if: *release_tag_condition
+    needs: build
+    permissions:
+      contents: read
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/project/etlplus/
+    steps:
+      - *checkout_step
+      - *download_dist_step
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e  # Pinned v1
+        with:
+          verbose: true