feat[tool]: improvements to AST annotation (#3829)

this commit enriches the annotated AST output so that links between
nodes are explicit and consumers of the AST do not need to "guess" about
relationships.

- link to the type declaration node for user types
- add `sha256sum` field for `Module` nodes
- add fields on `Import*` nodes so that they can be linked directly to
  `Module` nodes (including `sha256sum`, so that changes in dependencies
  can be detected)
- add improved type information (including parsed out metadata, like
  array length) consistently across all types.

misc/refactors:
- add `to_dict()` for type objects
- removed some dead code - `compare_nodes` was only used in a couple of
  tests, and node equality could be used there instead. (node equality
  is not super well-defined, but we could revisit that later).

tests/unit/ast/nodes/test_binary.py

@@ -18,7 +18,7 @@ def x():
     """
     )
 
-    assert vy_ast.compare_nodes(expected, mutated)
+    assert expected == mutated
 
 
 def test_binary_length():

tests/unit/ast/nodes/test_compare_nodes.py

@@ -7,36 +7,32 @@ def test_compare_different_node_clases():
     right = vyper_ast.body[0].value
 
     assert left != right
-    assert not vy_ast.compare_nodes(left, right)
 
 
 def test_compare_different_nodes_same_class():
     vyper_ast = vy_ast.parse_to_ast("[1, 2]")
     left, right = vyper_ast.body[0].value.elements
 
     assert left != right
-    assert not vy_ast.compare_nodes(left, right)
 
 
 def test_compare_different_nodes_same_value():
     vyper_ast = vy_ast.parse_to_ast("[1, 1]")
     left, right = vyper_ast.body[0].value.elements
 
     assert left != right
-    assert vy_ast.compare_nodes(left, right)
 
 
-def test_compare_complex_nodes_same_value():
-    vyper_ast = vy_ast.parse_to_ast("[{'foo':'bar', 43:[1,2,3]}, {'foo':'bar', 43:[1,2,3]}]")
-    left, right = vyper_ast.body[0].value.elements
+def test_compare_similar_node():
+    # test equality without node_ids
+    left = vy_ast.Int(value=1)
+    right = vy_ast.Int(value=1)
 
-    assert left != right
-    assert vy_ast.compare_nodes(left, right)
+    assert left == right
 
 
 def test_compare_same_node():
     vyper_ast = vy_ast.parse_to_ast("42")
     node = vyper_ast.body[0].value
 
     assert node == node
-    assert vy_ast.compare_nodes(node, node)

tests/unit/ast/nodes/test_from_node.py

@@ -24,13 +24,6 @@ def test_kwargs():
     assert new_node.value == 666
 
 
-def test_compare_nodes():
-    old_node = vy_ast.parse_to_ast("foo = 42")
-    new_node = vy_ast.Int.from_node(old_node, value=666)
-
-    assert not vy_ast.compare_nodes(old_node, new_node)
-
-
 def test_new_node_has_no_parent():
     old_node = vy_ast.parse_to_ast("foo = 42")
     new_node = vy_ast.Int.from_node(old_node, value=666)