Merge #2127 to implement Poetry, pytest, and tox

Closes #2111 as its feature branch was the base of this PR's branch
Closes #2133 as no longer necessary
Closes #2147 as no longer necessary

Author: ppfeister

.github/CODEOWNERS

@@ -1,11 +1,15 @@
 ### REPOSITORY
 /.github/CODEOWNERS @sdushantha
+./github/FUNDING.yml @sdushantha
 /LICENSE @sdushantha
 
 ### PACKAGING
 # Changes made to these items without code owner approval may negatively
-# impact packaging pipelines. Code owners may need time to verify or adapt.
+# impact packaging pipelines.
 /pyproject.toml @ppfeister @sdushantha
-/setup.cfg @ppfeister @sdushantha
-/setup.py @ppfeister
-/*.spec @ppfeister
+
+### REGRESSION
+/.github/workflows/regression.yml @ppfeister
+/tox.ini @ppfeister
+/pytest.ini @ppfeister
+/tests/ @ppfeister

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [ sdushantha, ppfeister, matheusfelipeog ]

.github/workflows/main.yml

@@ -0,0 +1,40 @@
+name: Regression Testing
+
+on:
+  pull_request:
+    branches: [ master ]
+  push:
+    branches: [ master ]
+
+jobs:
+  tox-matrix:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false # We want to know what version it fails on
+      matrix:
+        os: [
+          ubuntu-latest,
+          windows-latest,
+          macos-latest,
+        ]
+        python-version: [
+          '3.8',
+          '3.9',
+          '3.10',
+          '3.11',
+          '3.12',
+        ]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up environment ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install tox and related dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+          pip install tox-gh-actions
+      - name: Run tox
+        run: tox

.github/workflows/nightly.yml

@@ -1,8 +1,9 @@
-# Virtual Environment
+# Virtual Environments
 venv/
 bin/
 lib/
 pyvenv.cfg
+poetry.lock
 
 # Editor Configurations
 .vscode/
@@ -14,8 +15,9 @@ __pycache__/
 # Pip
 src/
 
-# Pip / PyProject Devel & Installation
+# Devel, Build, and Installation
 *.egg-info/
+dist/**
 
 # Jupyter Notebook
 .ipynb_checkpoints

.github/workflows/pull_request.yml

@@ -68,7 +68,7 @@ Sherlock.  This invocation hides the progress text that Sherlock normally
 outputs, and instead shows the verbose output of the tests.
 
 ```console
-$ cd sherlock/sherlock
+# Assumes current working directory is respository root
 $ python3 -m unittest tests.all --verbose
 ```
 

.github/workflows/regression.yml

@@ -37,13 +37,24 @@ Python
 pipx install sherlock-project
 ```
 
-### Build python package from source (useful for contributors)
+### Build live package from source (useful for contributors)
+
+Building an editable (or live) package links the entry point to your current directory, rather than to the standard install location. This is often useful when working with the code base, as changes are reflected immediately without reinstallation.
+
+Note that the version number will be 0.0.0 for pipx local builds unless manually changed in the pyproject file (it will prompt the user for an update).
 
 ```bash
-# pipx is recommended, but pip may suffice if pipx is unavailable
-git clone https://github.com/sherlock-project/sherlock.git
-cd sherlock
-pipx install .
+# Assumes repository cloned, and current working directory is repository root
+pipx install -e .
+```
+
+### Run package from source (without installing)
+
+If you'd rather not install directly to your system, you can import the module at runtime with `-m`.
+
+```bash
+# Assumes repository cloned, and current working directory is repository root
+python3 -m sherlock user123 user789
 ```
 
 <h2>

.gitignore

@@ -27,11 +27,11 @@
 [![PyPI - Version](https://img.shields.io/pypi/v/sherlock-project?logo=PyPi&label=PyPI&color=darkgreen)][ext_pypi] [![Docker Image Version](https://img.shields.io/docker/v/sherlock/sherlock?sort=semver&logo=docker&label=Docker&color=darkgreen)][docs_docker] [![homebrew version](https://img.shields.io/homebrew/v/sherlock?logo=Homebrew&color=darkgreen)][ext_brew]
 
 
-| Method | Command | Notes |
+| | Command | Notes |
 | - | - | - |
-| pypi | `pipx install sherlock-project` | `pip` may be used in place of `pipx` |
-| brew | `brew install sherlock` | Community supported |
-| docker | `docker pull sherlock/sherlock` | |
+| PyPI | `pipx install sherlock-project` | `pip` may be used in place of `pipx` |
+| Homebrew | `brew install sherlock` | Community supported |
+| Docker | `docker pull sherlock/sherlock` | |
 
 ### Alternative guides and methods
 
@@ -133,15 +133,10 @@ Original Creator - [Siddharth Dushantha](https://github.com/sdushantha)
 
 [docs_install]: /docs/INSTALL.md
 [docs_docker]: /docs/INSTALL.md#docker
-[docs_docker_dockerhub]: /docs/INSTALL.md#docker
-[docs_docker_compose]: /docs/INSTALL.md#using-compose
-[docs_docker_source]: /docs/INSTALL.md#build-image-from-source-useful-for-contributors
 [docs_py]: /docs/INSTALL.md#python
-[docs_py_build]: /docs/INSTALL.md#build-python-package-from-source-useful-for-contributors
 [docs_contrib]: /docs/CONTRIBUTING.md
 [docs_contrib_adding_targets]: /docs/CONTRIBUTING.md#adding-targets
 [docs_contrib_removing_targets]: /docs/CONTRIBUTING.md#removing-targets
 [docs_contrib_restoring_targets]: /docs/CONTRIBUTING.md#restoring-targets
 [ext_pypi]: https://pypi.org/project/sherlock-project/
 [ext_brew]: https://formulae.brew.sh/formula/sherlock
-