migrate whitelist tool to ethereum_spec_tools, update markdown files, touch up whitelist, clean up tox

Author: Carsons-Eels

README.md

@@ -2,7 +2,7 @@
 
 [![GitPOAP Badge](https://public-api.gitpoap.io/v1/repo/ethereum/execution-specs/badge)](https://www.gitpoap.io/gh/ethereum/execution-specs)
 [![codecov](https://codecov.io/gh/ethereum/execution-specs/graph/badge.svg?token=0LQZO56RTM)](https://codecov.io/gh/ethereum/execution-specs)
-[![Python Specification](https://github.com/ethereum/execution-specs/actions/workflows/test.yaml/badge.svg)](https://github.com/ethereum/execution-specs/actions/workflows/test.yaml)
+[![Python Specification](https://github.com/ethereum/execution-specs/workflows/test.yaml/badge.svg)](https://github.com/ethereum/execution-specs/workflows/test.yaml)
 
 ## Description
 
@@ -67,16 +67,26 @@ The Ethereum specification is maintained as a Python library, for better integra
 
 Requires Python 3.11+
 
-### Building
+### Building Specification Doucumentation
 
-Building the documentation is most easily done through [`tox`](https://tox.readthedocs.io/en/latest/):
+Building the spec documentation is most easily done through [`tox`](https://tox.readthedocs.io/en/latest/):
 
 ```bash
-uvx --with=tox-uv tox -e docs
+uvx --with=tox-uv tox -e spec-docs
 ```
 
 The path to the generated HTML will be printed to the console.
 
+### Browsing Updated Documentation
+
+To view the updated local documentation, run:
+
+```bash
+uv run mkdocs serve
+```
+
+then connect to `localhost:8000` in a browser
+
 ## License
 
 The Ethereum Execution Layer Specification code is licensed under the [Creative Commons Zero v1.0 Universal](/execution-specs/LICENSE.md).

docs/CHANGELOG.md

@@ -20,6 +20,9 @@ Test fixtures for use by clients are available for each release on the [Github r
 
 ### 📋 Misc
 
+- 🐞 WELDed the EEST tox environments relevent to producing documentation into EELS. ([#1695](https://github.com/ethereum/execution-specs/pull/1659))
+- 🔀 Merged codespell dictionaries for EEST/EELS and added a new tool to cleanly add words to the whitelist while keeping it organized. ([#1695](https://github.com/ethereum/execution-specs/pull/1659))
+
 ### 🧪 Test Cases
 
 - 🐞 Fix BALs opcode OOG test vectors by updating the Amsterdam commit hash in specs and validating appropriately on the testing side ([#2293](https://github.com/ethereum/execution-spec-tests/pull/2293)).

pyproject.toml

@@ -231,6 +231,7 @@ ethereum-spec-sync = "ethereum_spec_tools.sync:main"
 ethereum-spec-new-fork = "ethereum_spec_tools.new_fork.cli:main"
 ethereum-spec-patch = "ethereum_spec_tools.patch_tool:main"
 ethereum-spec-evm = "ethereum_spec_tools.evm_tools:main"
+whitelist = "ethereum_spec_tools.whitelist:main"
 
 [project.entry-points."docc.plugins"]
 "ethereum_spec_tools.docc.discover" = "ethereum_spec_tools.docc:EthereumDiscover"
@@ -392,10 +393,8 @@ skip = [                        # Don't check these files/folders
     "*.coverage*",
     "__pycache__",
     ".ruff_cache",
-    "fixtures.*",
     "tests/fixtures",
     "tests/json_infra/fixtures",
-    "eest_tests",
     "src/ethereum_spec_tools/evm_tools/t8n" # Temporary while being re-written
 ]
 count = true                    # Display counts of errors

tox.ini

@@ -117,7 +117,7 @@ commands =
         --optimized \
         tests/json_infra
 
-[testenv:doc]
+[testenv:spec-docs]
 basepython = python3
 extras = doc
 commands =
@@ -149,36 +149,15 @@ extras = docs
 package = editable
 commands = python -c "import packages.testing.src.execution_testing.cli.tox_helpers; packages.testing.src.execution_testing.cli.tox_helpers.markdownlint()"
 
-[testenv:eest-docs]
-description = Alias that runs EEST documentation checks (spellcheck, markdownlint, mkdocs)
+[testenv:check-docs]
+description = Runs all documentation checks (spellcheck, markdownlint, mkdocs)
 extras =
-    {[testenv:markdownlint]extras}
-    {[testenv:mkdocs]extras}
-package = editable
-setenv =
-    {[testenv:mkdocs]setenv}
-commands =
-    {[testenv:st-spellcheck]commands}
-    {[testenv:markdownlint]commands}
-    {[testenv:mkdocs]commands}
-
-[testenv:docs]
-description = Alias that runs all documentation checks (spellcheck, markdownlint, mkdocs)
-extras =
-    {[testenv:markdownlint]extras}
-    {[testenv:mkdocs]extras}
+    {[testenv:test-docs]extras}
     doc
 package = editable
 setenv =
-    {[testenv:mkdocs]setenv}
+    {[testenv:test-docs]setenv}
 commands =
     codespell -I whitelist.txt docs
     {[testenv:markdownlint]commands}
     {[testenv:mkdocs]commands}
-    {[testenv:doc]commands}
-
-[testenv:whitelist]
-description = Add words to the whitelist
-skip_install = true
-allowlist_externals = python
-commands = python {toxinidir}/scripts/add_to_whitelist.py {posargs}