New Version 2 codebase (#169)

initial v2 code commit
---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

.config/dictionary.txt

@@ -0,0 +1,17 @@
+autouse
+basepython
+cidrblock
+delenv
+devel
+endgroup
+envtmpdir
+envtmpdir
+fileh
+nocolor
+passenv
+setenv
+testenv
+toxfile
+toxinidir
+workdir
+xdist

.config/requirements-dev.txt

@@ -0,0 +1,6 @@
+black
+pytest
+ruff
+pre-commit
+mypy
+types-pyyaml

.config/requirements-test.txt

@@ -0,0 +1,6 @@
+coverage
+devpi_process
+pre-commit
+pytest
+pytest_mock
+pytest-xdist

.config/requirements.in

@@ -0,0 +1,5 @@
+pytest
+pytest-ansible>=3.1.0
+pytest-xdist
+pyyaml
+tox>4.4.8

.darglint

@@ -0,0 +1,7 @@
+[darglint]
+# NOTE: All `darglint` styles except for `sphinx` hit ridiculously low
+# NOTE: performance on some of the in-project Python modules.
+# Refs:
+# * https://github.com/terrencepreilly/darglint/issues/186
+docstring_style = sphinx
+strictness = full

.flake8

@@ -0,0 +1,56 @@
+[flake8]
+
+builtins = _
+
+# Print the total number of errors:
+count = true
+
+# Don't even try to analyze these:
+extend-exclude =
+  # No need to traverse egg info dir
+  *.egg-info,
+  # tool cache dirs
+  *_cache
+  # project env vars
+  .env,
+  # GitHub configs
+  .github,
+  # Cache files of MyPy
+  .mypy_cache,
+  # Cache files of pytest
+  .pytest_cache,
+  # Temp dir of pytest-testmon
+  .tmontmp,
+  # Occasional virtualenv dir
+  .venv
+  # VS Code
+  .vscode,
+  # Temporary build dir
+  build,
+  # This contains sdists and wheels of ansible-navigator that we don't want to check
+  dist,
+  # Metadata of `pip wheel` cmd is autogenerated
+  pip-wheel-metadata,
+  # adjacent venv
+  venv
+  # project tox directory
+  .tox
+
+# IMPORTANT: avoid using ignore option, always use extend-ignore instead
+# Completely and unconditionally ignore the following errors:
+extend-ignore = F, E203
+
+# Accessibility/large fonts and PEP8 unfriendly:
+max-line-length = 100
+
+# Allow certain violations in certain files:
+# Please keep both sections of this list sorted, as it will be easier for others to find and add entries in the future
+per-file-ignores =
+  # The following ignores have been researched and should be considered permanent
+  # each should be preceeded with an explanation of each of the error codes
+  # If other ignores are added for a specific file in the section following this,
+  # these will need to be added to that line as well.
+
+
+# Count the number of occurrences of each error/warning code and print a report:
+statistics = true

.github/workflows/run.yml

@@ -0,0 +1,70 @@
+name: tox-ansible
+
+on:
+  pull_request:
+    branches:
+      - main
+      - "releases/**"
+      - "stable/**"
+  workflow_call:
+
+jobs:
+  tox-matrix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3.5.0
+        with:
+          ref: ${{github.event.pull_request.head.ref}}
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install tox-ansible, includes tox
+        run: python -m pip install git+https://github.com/tox-dev/tox-ansible.git@uplift_v2
+
+      - name: Generate matrix
+        id: generate-matrix
+        run: |
+          python -m tox --ansible --gh-matrix --conf tox-ansible.ini
+
+    outputs:
+      envlist: ${{ steps.generate-matrix.outputs.envlist }}
+
+  test:
+    needs: tox-matrix
+    strategy:
+      fail-fast: false
+      matrix:
+        entry: ${{ fromJson(needs.tox-matrix.outputs.envlist) }}
+    name: ${{ matrix.entry.name }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3.5.0
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.entry.python }}
+
+      - name: Install deps
+        run: python -m pip install -r test-requirements.txt
+
+      - name: Run tox test
+        run: python -m tox --ansible -e ${{ matrix.entry.name }} --conf tox-ansible.ini
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  test_passed:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - run: >-
+          python -c "assert set([
+          '${{ needs.test.result }}',
+          ]) == {'success'}"