saltext.vcf 1.0.0__tar.gz

saltext_vcf-1.0.0/.codecov.yml

@@ -0,0 +1,25 @@
+---
+coverage:
+  status:
+    project:
+      default: false
+      app:
+        informational: true
+        paths:
+          - src/
+      tests:
+        informational: true
+        paths:
+          - tests/
+    patch:
+      default: false
+      app:
+        informational: true
+        paths:
+          - src/
+      tests:
+        informational: true
+        paths:
+          - tests/
+github_checks:
+  annotations: false

saltext_vcf-1.0.0/.copier-answers.yml

@@ -0,0 +1,33 @@
+# Autogenerated. Do not edit this by hand, use `copier update`.
+---
+_commit: 0.9.0
+_src_path: https://github.com/lkubb/salt-extension-copier
+author: VCF Platform Engineering
+author_email: vcf-platform@broadcom.net
+coc_contact: vcf-platform@broadcom.net
+copyright_begin: 2025
+deploy_docs: rolling
+docs_url: https://salt-extensions.github.io/saltext-vcf/
+integration_name: VMware
+license: apache
+loaders:
+  - module
+  - state
+max_salt_version: '3007'
+no_saltext_namespace: false
+os_support:
+  - Linux
+  - macOS
+  - Windows
+package_name: vcf
+project_name: vcf
+python_requires: '3.10'
+relax_pylint: false
+salt_version: '3006'
+source_url: https://github.com/salt-extensions/saltext-vcf
+ssh_fixtures: false
+summary: Salt Extension for VMware VCF infrastructure management (vCenter, NSX, SDDC
+  Manager, VCF Operations, VKS, VMSP)
+test_containers: false
+tracker_url: https://github.com/salt-extensions/saltext-vcf/issues
+url: https://github.com/salt-extensions/saltext-vcf

saltext_vcf-1.0.0/.coveragerc

@@ -0,0 +1,44 @@
+[run]
+branch = True
+cover_pylib = False
+relative_files = True
+parallel = True
+concurrency = multiprocessing
+
+omit =
+  .nox/*
+  setup.py
+
+[report]
+# Regexes for lines to exclude from consideration
+exclude_also =
+    # Don't complain about missing debug-only code:
+    def __repr__
+
+    # Don't complain if tests don't hit defensive assertion code:
+    raise AssertionError
+    raise NotImplementedError
+
+    # Don't complain if non-runnable code isn't run:
+    if 0:
+    if False:
+    if __name__ == .__main__.:
+    if TYPE_CHECKING:
+    @(abc\.)?abstractmethod
+
+    # Add markers which exclude statements in between.
+    # Requires coverage>=7.6.0.
+    no cover: start(?s:.)*?no cover: stop
+
+omit =
+  .nox/*
+  setup.py
+
+ignore_errors = True
+
+[paths]
+source =
+  saltext/vcf
+  src/saltext/vcf
+testsuite =
+  tests/

saltext_vcf-1.0.0/.envrc.example

@@ -0,0 +1,7 @@
+layout_saltext() {
+    VIRTUAL_ENV="$(python3 tools/initialize.py --print-venv)"
+    PATH_add "$VIRTUAL_ENV/bin"
+    export VIRTUAL_ENV
+}
+
+layout_saltext

saltext_vcf-1.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,48 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[BUG]"
+labels: bug, needs-triage
+assignees: ''
+
+---
+
+**Description**
+A clear and concise description of what the bug is.
+
+**Setup**
+(Please provide relevant configs and/or SLS files (be sure to remove sensitive info. There is no general set-up of Salt.)
+
+Please be as specific as possible and give set-up details.
+
+- [ ] on-prem machine
+- [ ] VM (Virtualbox, KVM, etc. please specify)
+- [ ] VM running on a cloud service, please be explicit and add details
+- [ ] container (Kubernetes, Docker, containerd, etc. please specify)
+- [ ] or a combination, please be explicit
+- [ ] jails if it is FreeBSD
+- [ ] classic packaging
+- [ ] onedir packaging
+- [ ] used bootstrap to install
+
+
+**Steps to Reproduce the behavior**
+(Include debug logs if possible and relevant)
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Versions Report**
+<details><summary>salt --versions-report</summary>
+(Provided by running salt --versions-report. Please also mention any differences in master/minion versions.)
+
+```yaml
+PASTE HERE
+```
+</details>
+
+**Additional context**
+Add any other context about the problem here.

saltext_vcf-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Salt Community Slack
+    url: https://saltstackcommunity.slack.com/
+    about: Please ask and answer questions here.
+  - name: Salt-Users Forum
+    url: https://groups.google.com/forum/#!forum/salt-users
+    about: Please ask and answer questions here.
+  - name: Salt on LiberaChat
+    url: https://web.libera.chat/#salt
+    about: Please ask and answer questions here.
+  - name: Security vulnerabilities
+    email: saltproject-security.pdl@broadcom.com
+    about: Please report security vulnerabilities here.

saltext_vcf-1.0.0/.github/ISSUE_TEMPLATE/docs.md

@@ -0,0 +1,23 @@
+---
+name: Docs
+about: Issue related to Salt Documentation
+title: "[DOCS]"
+labels: documentation, needs-triage
+assignees: ''
+
+---
+
+**Description**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Suggested Fix**
+What did you expect to see in the documentation that is missing or needs updating?
+
+**Type of documentation**
+This could be module documentation or a guide.
+
+**Location or format of documentation**
+Insert page URL if applicable.
+
+**Additional context**
+Add any other context or screenshots here.

saltext_vcf-1.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[FEATURE REQUEST]"
+labels: feature, needs-triage
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

saltext_vcf-1.0.0/.github/ISSUE_TEMPLATE/tech-debt.md

@@ -0,0 +1,13 @@
+---
+name: Tech Debt
+about: Issue is related to tech debt. This includes compatibility changes for newer versions of software and OSes that salt interacts with.
+title: "[TECH DEBT]"
+labels: tech-debt
+assignees: ''
+
+---
+
+### Description of the tech debt to be addressed, include links and screenshots
+
+### Versions Report
+(Provided by running `salt --versions-report`. Please also mention any differences in master/minion versions.)

saltext_vcf-1.0.0/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,11 @@
+### Description of Issue
+<!-- Note: Please direct questions to the salt-users google group, Slack, IRC, etc. Only post issues and feature requests here -->
+
+### Setup
+(Please provide relevant configs and/or SLS files (Be sure to remove sensitive info).)
+
+### Steps to Reproduce Issue
+(Include debug logs if possible and relevant.)
+
+### Versions Report
+(Provided by running `salt --versions-report`. Please also mention any differences in master/minion versions.)

saltext_vcf-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+### What does this PR do?
+
+### What issues does this PR fix or reference?
+Fixes:
+
+### Previous Behavior
+Remove this section if not relevant
+
+### New Behavior
+Remove this section if not relevant
+
+### Merge requirements satisfied?
+**[NOTICE] Bug fixes or new features require tests.**
+<!-- Please review the [salt-extensions](https://salt-extensions.github.io/salt-extension-copier/topics/testing/writing.html) and [Salt test documentation](https://docs.saltproject.io/en/master/topics/tutorials/writing_tests.html) for details on how to implement tests for your changes. -->
+- [ ] Docs
+- [ ] Changelog - https://salt-extensions.github.io/salt-extension-copier/topics/documenting/changelog.html#procedure
+- [ ] Tests written/updated
+
+### Commits signed with GPG?
+Yes/No
+
+Please review [Salt's Contributing Guide](https://docs.saltproject.io/en/master/topics/development/contributing.html) for best practices.
+
+See GitHub's [page on GPG signing](https://help.github.com/articles/signing-commits-using-gpg/) for more information about signing commits with GPG.

saltext_vcf-1.0.0/.github/actions/upload-exitstatus/action.yml

@@ -0,0 +1,32 @@
+---
+name: upload-exitstatus
+description: Upload a job's status as an artifact
+inputs:
+  artifact_prefix:
+    required: false
+    default: exitstatus-
+  name:
+    required: false
+    default: ''
+
+runs:
+  using: composite
+
+  steps:
+
+      - name: Set Exit Status
+        if: always()
+        env:
+          OUTFILE: exitstatus/${{ inputs.name == '' && github.job || inputs.name }}
+        shell: bash
+        run: |
+          mkdir exitstatus
+          echo "${{ job.status }}" > "$OUTFILE"
+
+      - name: Upload Exit Status
+        if: always()
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f  # v7.0.0
+        with:
+          name: ${{ inputs.artifact_prefix }}${{ inputs.name == '' && github.job || inputs.name }}
+          path: exitstatus
+          if-no-files-found: error

saltext_vcf-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+---
+name: CI
+
+on:
+  workflow_call:
+
+jobs:
+  get-changed-files:
+    name: Get Changed Files
+    uses: ./.github/workflows/get-changed-files.yml
+    permissions:
+      contents: read
+      pull-requests: read  # for dorny/paths-filter to read pull requests
+
+  pre-commit:
+    name: Pre-Commit
+    needs:
+      - get-changed-files
+    uses: ./.github/workflows/pre-commit-action.yml
+    with:
+      changed-files: ${{ needs.get-changed-files.outputs.changed-files }}
+    permissions:
+      contents: read
+
+  test:
+    name: Test
+    needs:
+      - pre-commit
+    uses: ./.github/workflows/test-action.yml
+
+  docs:
+    name: Docs
+    needs:
+      - pre-commit
+    uses: ./.github/workflows/docs-action.yml
+    permissions:
+      contents: read
+
+  build-python-package:
+    name: Python Package
+    needs:
+      - pre-commit
+    uses: ./.github/workflows/package-action.yml
+    permissions:
+      contents: read

saltext_vcf-1.0.0/.github/workflows/deploy-docs-action.yml

@@ -0,0 +1,75 @@
+---
+name: Publish Documentation
+
+on:
+  workflow_call:
+    inputs:
+      # This is the name of the regular artifact that should
+      # be transformed into a GitHub Pages deployment.
+      artifact-name:
+        type: string
+        required: false
+        default: html-docs
+
+
+permissions:
+  actions: read  # For downloading artifacts of other runs when called via workflow_run trigger
+  pages: write
+  id-token: write
+
+jobs:
+
+  # The released docs are not versioned currently, only the latest ones are deployed.
+  #
+  # Versioning support would require either (better):
+  #   * Rebuilding docs for all versions when a new release is made
+  #   * Version selector support in `furo`: https://github.com/pradyunsg/furo/pull/500
+  #
+  # or (more basic):
+  #   * using the `gh-pages` branch and peaceiris/actions-gh-pages
+  #     to be able to deploy to subdirectories. The implementation via
+  #     actions/deploy-pages always replaces the directory root.
+
+  Deploy-Docs-GH-Pages:
+    name: Publish Docs to GitHub Pages
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-24.04
+
+    steps:
+
+      - name: Download built docs
+        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
+        with:
+          name: ${{ inputs.artifact-name }}
+          path: html-docs
+          github-token: ${{ github.token }}
+          run-id: ${{ github.event_name == 'workflow_run' && github.event.workflow_run.id || github.run_id }}
+
+      - name: Upload GitHub Pages artifact
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b  # v4.0.0
+        with:
+          name: html-docs-pages
+          path: html-docs
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e  # v4.0.5
+        with:
+          artifact_name: html-docs-pages
+
+      - name: Delete GitHub Pages artifact
+        if: always()
+        uses: geekyeggo/delete-artifact@7ee91e82b4a7f3339cd8b14beace3d826a2aac39  # v5.1.0
+        with:
+          name: html-docs-pages
+          failOnError: false
+
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+
+      - name: Upload Exit Status
+        if: always()
+        uses: ./.github/actions/upload-exitstatus

saltext_vcf-1.0.0/.github/workflows/deploy-package-action.yml

@@ -0,0 +1,148 @@
+---
+name: Release Salt Extension Python Package
+
+on:
+  workflow_run:
+    types:
+      - completed
+    workflows:
+      - Auto PR Releases
+      - Tagged Releases
+
+jobs:
+  get_version:
+    name: Get package version
+    runs-on: ubuntu-24.04
+    if: github.event.workflow_run.conclusion == 'success'
+    permissions:
+      actions: read
+    outputs:
+      version: ${{ steps.extract-version.outputs.version }}
+
+    steps:
+      - name: Download expected version
+        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
+        with:
+          name: version.txt
+          path: ${{ runner.temp }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          run-id: ${{ github.event.workflow_run.id }}
+
+      - name: Download Python Package Artifacts
+        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
+        with:
+          name: salt-extension-packages
+          path: dist
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          run-id: ${{ github.event.workflow_run.id }}
+
+      - name: Extract and verify package version
+        id: extract-version
+        run: |-
+          wheel_file="$(find dist -name '*.whl' | head -n 1)"
+          test -n "$wheel_file" || exit 1
+          unzip "$wheel_file" -d "$RUNNER_TEMP/extract"
+          dist_info="$(find "$RUNNER_TEMP/extract" -type d -name '*.dist-info' | head -n 1)"
+          test -n "$dist_info" || exit 1
+          package_version="$(sed -n 's/^Version:\s*\(\S*\)$/\1/p' "$dist_info/METADATA")"
+          test -n "$package_version" || exit 1
+          expected_version="$(cat "$RUNNER_TEMP/version.txt" | head -n 1)"
+          echo "Detected package version: $package_version"
+          echo "Expected version: $expected_version"
+          test "$package_version" = "$expected_version" || exit 1
+          echo "version=$expected_version" >> "$GITHUB_OUTPUT"
+
+  test_release:
+    name: Publish Python Package to Test PyPI
+    runs-on: ubuntu-24.04
+    needs:
+      - get_version
+    permissions:
+      actions: read
+      id-token: write
+
+    steps:
+      - name: Download Python Package Artifacts
+        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
+        with:
+          name: salt-extension-packages
+          path: dist
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          run-id: ${{ github.event.workflow_run.id }}
+
+      - name: Publish distribution to Test PyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        with:
+          attestations: ${{ secrets.TEST_PYPI_API_TOKEN == '' }}
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+          repository-url: https://test.pypi.org/legacy/
+          verbose: ${{ runner.debug == '1' }}
+
+  pypi_release:
+    name: Publish Python Package to PyPI
+    runs-on: ubuntu-24.04
+    needs:
+      - test_release
+    permissions:
+      actions: read
+      id-token: write
+    environment:
+      name: release
+      url: https://pypi.org/p/saltext.vcf
+
+    steps:
+      - name: Download Python Package Artifacts
+        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
+        with:
+          name: salt-extension-packages
+          path: dist
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          run-id: ${{ github.event.workflow_run.id }}
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        with:
+          attestations: ${{ secrets.PYPI_API_TOKEN == '' }}
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          verbose: ${{ runner.debug == '1' }}
+
+  docs_release:
+    name: Deploy Docs
+    uses: ./.github/workflows/deploy-docs-action.yml
+    needs:
+      - pypi_release
+      - get_version
+    permissions:
+      actions: read
+      pages: write
+      id-token: write
+
+  gh_release:
+    name: Create GitHub release
+    runs-on: ubuntu-24.04
+    needs:
+      - pypi_release
+      - get_version
+    permissions:
+      actions: read
+      contents: write
+
+    steps:
+      - name: Download Python Package Artifacts
+        uses: actions/download-artifact@70fc10c6e5e1ce46ad2ea6f2b72d43f7d47b13c3  # v8.0.0
+        with:
+          name: salt-extension-packages
+          path: dist
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          run-id: ${{ github.event.workflow_run.id }}
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ needs.get_version.outputs.version }}
+        run: |
+          gh release create "v${{ needs.get_version.outputs.version }}" \
+              --repo="$GITHUB_REPOSITORY" \
+              --title="${GITHUB_REPOSITORY#*/} $VERSION" \
+              --generate-notes \
+              dist/*

saltext_vcf-1.0.0/.github/workflows/docs-action.yml

@@ -0,0 +1,51 @@
+---
+name: Build Documentation
+
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  Docs:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python 3.10 For Nox
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: "3.10"
+
+      - name: Install Nox
+        run: |
+          python -m pip install --upgrade pip
+          pip install "nox==$NOX_VERSION" "uv==$UV_VERSION"
+        env:
+          NOX_VERSION: '2026.2.9'
+          UV_VERSION: '0.10.11'
+
+      - name: Install Doc Requirements
+        run: |
+          nox --force-color -e docs --install-only
+
+      - name: Build Docs
+        env:
+          SKIP_REQUIREMENTS_INSTALL: true
+        run: |
+          nox --force-color -e docs
+
+      - name: Upload built docs as artifact
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f  # v7.0.0
+        with:
+          name: html-docs
+          path: docs/_build/html
+
+      - name: Upload Exit Status
+        if: always()
+        uses: ./.github/actions/upload-exitstatus

saltext_vcf-1.0.0/.github/workflows/get-changed-files.yml

@@ -0,0 +1,53 @@
+---
+on:
+  workflow_call:
+    outputs:
+      changed-files:
+        description: "Changed file JSON output from dorny/paths-filter"
+        value: ${{ jobs.get-changed-files.outputs.changed-files }}
+
+permissions:
+  contents: read  # for dorny/paths-filter to fetch a list of changed files
+  pull-requests: read  # for dorny/paths-filter to read pull requests
+
+jobs:
+  get-changed-files:
+    name: Get Changed Files
+    runs-on: ubuntu-24.04
+    outputs:
+      changed-files: ${{ toJSON(steps.changed-files.outputs) }}
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+
+      - name: Get Changed Files
+        id: changed-files
+        uses: dorny/paths-filter@de90cc6fb38fc0963ad72b210f1f284cd68cea36  # v3.0.2
+        with:
+          token: ${{ github.token }}
+          list-files: escape
+          filters: |-
+            repo:
+              - added|modified:
+                - '**'
+            deleted:
+              - deleted:
+                - '**'
+            pre-commit:
+              - added|modified|deleted:
+                - .pre-commit-hooks/**
+                - .pre-commit-config.y?(a)ml
+                - .pylintrc
+                - pyproject.toml
+            # If files in this filter change, a test release to TestPyPI
+            # should be attempted. This is currently not implemented yet.
+            release:
+              - added|modified|deleted:
+                - .copier-answers.y?(a)ml
+                - .github/workflows/**
+                - CHANGELOG.md
+                - pyproject.toml
+                - setup.py
+
+      - name: Echo Changed Files Output
+        run: echo "${{ toJSON(steps.changed-files.outputs) }}"