mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
c50729badf
The methods were never executed because DEBUG was never defined in normal builds and the only way to create nodes is through generated factory methods which provide the same safety `validate` was supposed to ensure at the interface level.
85 lines
2.8 KiB
Python
85 lines
2.8 KiB
Python
from __future__ import print_function
|
|
import sys # noqa: I201
|
|
from kinds import SYNTAX_BASE_KINDS, kind_to_type, lowercase_first_word
|
|
|
|
|
|
def error(msg):
|
|
print('error: ' + msg, file=sys.stderr)
|
|
sys.exit(-1)
|
|
|
|
|
|
class Node(object):
|
|
"""
|
|
A Syntax node, possibly with children.
|
|
If the kind is "SyntaxCollection", then this node is considered a Syntax
|
|
Collection that will expose itself as a typedef rather than a concrete
|
|
subclass.
|
|
"""
|
|
|
|
def __init__(self, name, description=None, kind=None, traits=None,
|
|
children=None, element=None, element_name=None,
|
|
element_choices=None, omit_when_empty=False):
|
|
self.syntax_kind = name
|
|
self.swift_syntax_kind = lowercase_first_word(name)
|
|
self.name = kind_to_type(self.syntax_kind)
|
|
self.description = description
|
|
|
|
self.traits = traits or []
|
|
self.children = children or []
|
|
self.base_kind = kind
|
|
if self.base_kind == 'SyntaxCollection':
|
|
self.base_type = 'Syntax'
|
|
else:
|
|
self.base_type = kind_to_type(self.base_kind)
|
|
|
|
if self.base_kind not in SYNTAX_BASE_KINDS:
|
|
error("unknown base kind '%s' for node '%s'" %
|
|
(self.base_kind, self.syntax_kind))
|
|
|
|
self.omit_when_empty = omit_when_empty
|
|
self.collection_element = element or ""
|
|
# If there's a preferred name for the collection element that differs
|
|
# from its supertype, use that.
|
|
self.collection_element_name = element_name or self.collection_element
|
|
self.collection_element_type = kind_to_type(self.collection_element)
|
|
self.collection_element_choices = element_choices or []
|
|
|
|
def is_base(self):
|
|
"""
|
|
Returns `True` if this node declares one of the base syntax kinds.
|
|
"""
|
|
return self.syntax_kind in SYNTAX_BASE_KINDS
|
|
|
|
def is_syntax_collection(self):
|
|
"""
|
|
Returns `True` if this node is a subclass of SyntaxCollection.
|
|
"""
|
|
return self.base_kind == "SyntaxCollection"
|
|
|
|
def requires_validation(self):
|
|
"""
|
|
Returns `True` if this node should have a `validate` method associated.
|
|
"""
|
|
return self.is_buildable()
|
|
|
|
def is_unknown(self):
|
|
"""
|
|
Returns `True` if this node is an `Unknown` syntax subclass.
|
|
"""
|
|
return "Unknown" in self.syntax_kind
|
|
|
|
def is_buildable(self):
|
|
"""
|
|
Returns `True` if this node should have a builder associated.
|
|
"""
|
|
return not self.is_base() and \
|
|
not self.is_unknown() and \
|
|
not self.is_syntax_collection()
|
|
|
|
def shall_be_omitted_when_empty(self):
|
|
"""
|
|
Returns 'True' if this node shall not be created while parsing if it
|
|
has no children.
|
|
"""
|
|
return self.omit_when_empty
|