Additional Features: Type Hints, Lazy Evaluation, New Top Level Interfaces

[ncilfone]

What does this PR do?

• adds some stubs to the underlying decorator that should help with type hinting in VSCode (via pylance/pyright).

• changed packaging to reflect the stubs and partial type info

• Additional interfaces to spock that make more sense:

ConfigArgBuilder --> SpockBuilder -- Can now be imported from top-level @spock decorator now importable from the top-level

from spock import spock
from spock import SpockBuilder

Lazy Evaluation

• the @spock decorator now has a boolean flag that allows inherited classes to not be @spock decorated -- will automatically cast parent classes to a spock class by traversing the MRO
• the ConfigArgBuilder now takes a keyword argument that will attempt to lazily handle dependencies between @spock decorated classes thus preventing the need for every @spock decorated classes to be passed into *args within the method

Checklist

• [x] Did you adhere to PEP-8 standards?
• [x] Did you run black and isort prior to submitting your PR?
• [x] Does your PR pass all existing unit tests?
• [x] Did you add associated unit tests for any additional functionality?
• [x] Did you provide documentation (Google Docstring format) whenever possible, even for simple functions or classes?

[coveralls]

Pull Request Test Coverage Report for Build 1713859267

Warning: This coverage report may be inaccurate.

This pull request's base commit is no longer the HEAD commit of its target branch. This means it includes changes from outside the original pull request, including, potentially, unrelated coverage changes.

• For more information on this, see Tracking coverage changes with pull request builds.
• To avoid this issue with future PRs, see these Recommended CI Configurations.
• For a quick fix, rebase this PR at GitHub. Your next report should be accurate.

Details

• 101 of 106 (95.28%) changed or added relevant lines in 9 files are covered.
• 13 unchanged lines in 2 files lost coverage.
• Overall coverage increased (+0.3%) to 95.133%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
spock/addons/tune/config.py	8	9	88.89%
spock/backend/config.py	41	42	97.62%
spock/graph.py	32	33	96.97%
spock/backend/field_handlers.py	4	6	66.67%
<!--	Total:	101	106	95.28%	-->

Files with Coverage Reduction	New Missed Lines	%
spock/graph.py	4	93.15%
spock/builder.py	9	94.25%
<!--	Total:	13		-->

Totals
Change from base Build 1684561768:	0.3%
Covered Lines:	1681
Relevant Lines:	1767

---

💛 - Coveralls