Fix changelog tool

Author: Carsons-Eels

docs/CHANGELOG.md

@@ -12,16 +12,15 @@ Test fixtures for use by clients are available for each release on the [Github r
 
 #### `fill`
 
-- 🐞 Allow `evmone` to fill Prague and Osaka blockchain tests (mainly modified deposit contract tests) ([#1689](https://github.com/ethereum/execution-specs/pull/1689))
+- 🐞 Allow `evmone` to fill Prague and Osaka blockchain tests (mainly modified deposit contract tests) ([#1689](https://github.com/ethereum/execution-specs/pull/1689)).
 
 #### `consume`
 
 - 🐞 Fix a bug with `consume sync` tests where some clients don't have JSON-RPC immediately available after syncing and can't yet serve the synced block ([#1670](https://github.com/ethereum/execution-specs/pull/1670)).
 
 ### 📋 Misc
 
-- 🐞 WELDed the EEST tox environments relevant 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))
+- 🐞 WELDed the EEST tox environments relevant to producing documentation into EELS, and added a tool to cleanly add codespell whitelist entries. ([#1695](https://github.com/ethereum/execution-specs/pull/1659)).
 
 ### 🧪 Test Cases
 

packages/testing/pyproject.toml

@@ -120,6 +120,7 @@ groupstats = "execution_testing.cli.show_pre_alloc_group_stats:main"
 extract_config = "execution_testing.cli.extract_config:extract_config"
 compare_fixtures = "execution_testing.cli.compare_fixtures:main"
 modify_static_test_gas_limits = "execution_testing.cli.modify_static_test_gas_limits:main"
+validate_changelog = "execution_testing.cli.tox_helpers:validate_changelog"
 
 [tool.setuptools.packages.find]
 where = ["src"]

packages/testing/src/execution_testing/cli/tox_helpers.py

@@ -55,6 +55,17 @@ def write_github_summary(
             f.write("```\n")
 
 
+def find_project_root() -> Path:
+    """Locate the root directory of this project."""
+    # Search upwards from file location
+    script_dir = Path(__file__).resolve().parent
+    for parent in [script_dir, *script_dir.parents]:
+        if (parent / "EIP_AUTHORS_MANUAL.md").exists():
+            return parent
+
+    raise FileNotFoundError("Unable to locate project root directory!")
+
+
 @click.command(
     context_settings={
         "ignore_unknown_options": True,
@@ -215,7 +226,8 @@ def validate_changelog() -> None:
     - A period (.) for regular entries
     - A colon (:) for section headers that introduce lists
     """
-    changelog_path = Path("docs/CHANGELOG.md")
+    project_root = find_project_root()
+    changelog_path = Path(project_root / "docs/CHANGELOG.md")
 
     if not changelog_path.exists():
         click.echo(f"❌ Changelog file not found: {changelog_path}")

tox.ini

@@ -113,13 +113,15 @@ commands =
 
 [testenv:changelog]
 description = Validate EEST changelog entries
-extras = docs
-package = editable
-commands = python -c "import packages.testing.src.execution_testing.cli.tox_helpers; packages.testing.src.execution_testing.cli.tox_helpers.validate_changelog()"
+dependency_groups = docs
+changedir = {toxinidir}/packages/testing
+allowlist_externals = uv
+commands_pre = uv pip install -e {toxinidir}/packages/testing
+commands = validate_changelog
 
 [testenv:mkdocs]
 description = Build EEST documentation with mkdocs
-extras = docs,lint,test
+dependency_groups = docs,lint
 setenv =
     GEN_TEST_DOC_VERSION = "tox"
     # Required for `cairosvg` so tox can find `libcairo-2`?
@@ -132,15 +134,14 @@ commands =
 
 [testenv:markdownlint]
 description = Lint EEST markdown files (markdownlint)
-extras = docs
+dependency_groups = 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:check-docs]
 description = Runs all documentation checks (spellcheck, markdownlint, mkdocs)
-extras =
-    {[testenv:test-docs]extras}
-    doc
+dependency_groups =
+    {[testenv:test-docs]dependency_groups}
 package = editable
 setenv =
     {[testenv:test-docs]setenv}