feat: v2 implementation (EXPERIMENTAL)

.github/workflows/ci.yml

@@ -81,7 +81,7 @@ jobs:
           PRE_COMMIT_COLOR: always
 
       - name: Test
-        timeout-minutes: 20
+        timeout-minutes: 40
         run: pdm run test
 
       - name: Publish test reports

.gitignore

@@ -16,3 +16,5 @@ tmp/
 *.egg-info
 docs/build
 tests/**/*.xml
+pyrightconfig.json
+.env

docs/conf.py

@@ -7,6 +7,35 @@
 
 sys.path.insert(0, str(Path(__file__).parent / "src"))
 
+# --- Monkey-patch sphinx_github_style lexer (upstream bug: IndexError on last token) -----------
+import sphinx_github_style.lexer as _lexer
+from pygments.lexers.python import PythonLexer as _PythonLexer
+from pygments.token import Keyword, Name
+
+
+def _patched_get_tokens_unprocessed(self, text):  # type: ignore[no-untyped-def]
+    tokens = list(_PythonLexer.get_tokens_unprocessed(self, text))
+    last = len(tokens) - 1
+    for token_idx, (index, token, value) in enumerate(tokens):
+        if token is Name.Builtin and value in _lexer.BUILTINS["classes"]:
+            if token_idx < last and tokens[token_idx + 1][-1] == "(":
+                yield index, Name.Builtin, value
+            else:
+                yield index, Name.Builtin.Pseudo, value
+        elif token is Name:
+            if value[0].isupper():
+                yield index, Name.Class, value
+            elif token_idx < last and tokens[token_idx + 1][-1] == "(":
+                yield index, Keyword.Pseudo, value
+            else:
+                yield index, Name, value
+        else:
+            yield index, token, value
+
+
+_lexer.GitHubLexer.get_tokens_unprocessed = _patched_get_tokens_unprocessed
+# --- End monkey-patch --------------------------------------------------------------------------
+
 nitpicky = True
 project = "python-erc7730"
 copyright = "2024, Ledger"

docs/pages/usage_cli.md

@@ -73,6 +73,8 @@ checked 61 descriptor files, some errors found ❌
 
 It can be called with single files or directories, in which case all descriptors will be checked.
 
+Use `--skip-abi-validation` to disable external ABI comparisons against Etherscan (useful for offline runs or faster local checks).
+
 ### `erc7730 generate`
 
 The `generate` command bootstraps a new descriptor file from ABIs or message schemas:

pyproject.toml

@@ -80,7 +80,7 @@ dev = [
     "pytest-unordered>=0.6.1",
     "pytest-raises>=0.11",
     "prettydiff[terminal]>=0.1.0",
-    "sphinx>=8.1.0",
+    "sphinx>=8.1.0,<8.2",
     "sphinxcontrib-apidoc>=0.5.0",
     "sphinxcontrib-typer>=0.5.0",
     "sphinxcontrib-mermaid>=0.9.2",