Skip to content

binary

binary

Arithmetic expression token.

BinaryOperator

Bases: MacroExpressionToken

Operation with two operands.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
class BinaryOperator(MacroExpressionToken):
    """Operation with two operands."""

    def __init__(
        self,
        string: str,
        location: int,
        left: MacroExpressionToken,
        right: MacroExpressionToken,
    ) -> None:
        super().__init__(string, location)
        self.left = left
        self.right = right
        self.operator: Callable[[Any, Any], Any] = add
        self.sign = "+"

    @classmethod
    def new(
        cls,
        string: str,
        location: int,
        tokens: ParseResults,
    ) -> Self:
        """Create instance of this class.

        Created to be used as callback in `ParserElement.set_parse_action()`.
        """
        left, right = tokens[0]
        return cls(
            string,
            location,
            MacroExpressionToken.ensure_type(left),
            MacroExpressionToken.ensure_type(right),
        )

    def to_parser2_expression(self, context: Parser2Context) -> Expression2:
        """Convert to `Expression2` descendant class."""
        raise NotImplementedError

    def evaluate_numeric(self, macro_context: MacroContext, state: State) -> Offset:
        """Evaluate numeric value of this macro expression."""
        left = self.left.evaluate_numeric(macro_context, state)
        right = self.right.evaluate_numeric(macro_context, state)
        output = self.operator(left, right)

        if not isinstance(output, Offset):
            raise InvalidArithmeticExpressionError

        return output

    def get_gerber_code(
        self,
        indent: str = "",
        endline: str = "\n",
    ) -> str:
        """Get gerber code from iterable of tokens."""
        return (
            f"{self.left.get_gerber_code(indent=indent, endline=endline)}{self.sign}"
            f"{self.right.get_gerber_code(indent=indent, endline=endline)}"
        )

    def __str__(self) -> str:
        return f"{super().__str__()}::[{self.left}, {self.right}]"

new classmethod 

new(
    string: str, location: int, tokens: ParseResults
) -> Self

Create instance of this class.

Created to be used as callback in ParserElement.set_parse_action().

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
@classmethod
def new(
    cls,
    string: str,
    location: int,
    tokens: ParseResults,
) -> Self:
    """Create instance of this class.

    Created to be used as callback in `ParserElement.set_parse_action()`.
    """
    left, right = tokens[0]
    return cls(
        string,
        location,
        MacroExpressionToken.ensure_type(left),
        MacroExpressionToken.ensure_type(right),
    )

to_parser2_expression 

to_parser2_expression(
    context: Parser2Context,
) -> Expression2

Convert to Expression2 descendant class.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
61
62
63
def to_parser2_expression(self, context: Parser2Context) -> Expression2:
    """Convert to `Expression2` descendant class."""
    raise NotImplementedError

evaluate_numeric 

evaluate_numeric(
    macro_context: MacroContext, state: State
) -> Offset

Evaluate numeric value of this macro expression.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
65
66
67
68
69
70
71
72
73
74
def evaluate_numeric(self, macro_context: MacroContext, state: State) -> Offset:
    """Evaluate numeric value of this macro expression."""
    left = self.left.evaluate_numeric(macro_context, state)
    right = self.right.evaluate_numeric(macro_context, state)
    output = self.operator(left, right)

    if not isinstance(output, Offset):
        raise InvalidArithmeticExpressionError

    return output

get_gerber_code 

get_gerber_code(
    indent: str = "", endline: str = "\n"
) -> str

Get gerber code from iterable of tokens.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
76
77
78
79
80
81
82
83
84
85
def get_gerber_code(
    self,
    indent: str = "",
    endline: str = "\n",
) -> str:
    """Get gerber code from iterable of tokens."""
    return (
        f"{self.left.get_gerber_code(indent=indent, endline=endline)}{self.sign}"
        f"{self.right.get_gerber_code(indent=indent, endline=endline)}"
    )

MultiplicationOperator

Bases: BinaryOperator

Operation with two operands.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
class MultiplicationOperator(BinaryOperator):
    """Operation with two operands."""

    def __init__(
        self,
        string: str,
        location: int,
        left: MacroExpressionToken,
        right: MacroExpressionToken,
    ) -> None:
        super().__init__(string, location, left, right)
        self.operator: Callable[[Any, Any], Any] = mul
        self.sign = "x"

    def to_parser2_expression(self, context: Parser2Context) -> Expression2:
        """Convert to `Expression2` descendant class."""
        return context.macro_expressions.multiplication(
            lhs=self.left.to_parser2_expression(context),
            rhs=self.right.to_parser2_expression(context),
        )

to_parser2_expression 

to_parser2_expression(
    context: Parser2Context,
) -> Expression2

Convert to Expression2 descendant class.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
105
106
107
108
109
110
def to_parser2_expression(self, context: Parser2Context) -> Expression2:
    """Convert to `Expression2` descendant class."""
    return context.macro_expressions.multiplication(
        lhs=self.left.to_parser2_expression(context),
        rhs=self.right.to_parser2_expression(context),
    )

DivisionOperator

Bases: BinaryOperator

Operation with two operands.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
class DivisionOperator(BinaryOperator):
    """Operation with two operands."""

    def __init__(
        self,
        string: str,
        location: int,
        left: MacroExpressionToken,
        right: MacroExpressionToken,
    ) -> None:
        super().__init__(string, location, left, right)
        self.operator: Callable[[Any, Any], Any] = truediv
        self.sign = "/"

    def to_parser2_expression(self, context: Parser2Context) -> Expression2:
        """Convert to `Expression2` descendant class."""
        return context.macro_expressions.division(
            lhs=self.left.to_parser2_expression(context),
            rhs=self.right.to_parser2_expression(context),
        )

to_parser2_expression 

to_parser2_expression(
    context: Parser2Context,
) -> Expression2

Convert to Expression2 descendant class.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
127
128
129
130
131
132
def to_parser2_expression(self, context: Parser2Context) -> Expression2:
    """Convert to `Expression2` descendant class."""
    return context.macro_expressions.division(
        lhs=self.left.to_parser2_expression(context),
        rhs=self.right.to_parser2_expression(context),
    )

AdditionOperator

Bases: BinaryOperator

Operation with two operands.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
class AdditionOperator(BinaryOperator):
    """Operation with two operands."""

    def __init__(
        self,
        string: str,
        location: int,
        left: MacroExpressionToken,
        right: MacroExpressionToken,
    ) -> None:
        super().__init__(string, location, left, right)
        self.operator: Callable[[Any, Any], Any] = add
        self.sign = "+"

    def to_parser2_expression(self, context: Parser2Context) -> Expression2:
        """Convert to `Expression2` descendant class."""
        return context.macro_expressions.addition(
            lhs=self.left.to_parser2_expression(context),
            rhs=self.right.to_parser2_expression(context),
        )

to_parser2_expression 

to_parser2_expression(
    context: Parser2Context,
) -> Expression2

Convert to Expression2 descendant class.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
149
150
151
152
153
154
def to_parser2_expression(self, context: Parser2Context) -> Expression2:
    """Convert to `Expression2` descendant class."""
    return context.macro_expressions.addition(
        lhs=self.left.to_parser2_expression(context),
        rhs=self.right.to_parser2_expression(context),
    )

SubtractionOperator

Bases: BinaryOperator

Operation with two operands.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
class SubtractionOperator(BinaryOperator):
    """Operation with two operands."""

    def __init__(
        self,
        string: str,
        location: int,
        left: MacroExpressionToken,
        right: MacroExpressionToken,
    ) -> None:
        super().__init__(string, location, left, right)
        self.operator: Callable[[Any, Any], Any] = sub
        self.sign = "-"

    def to_parser2_expression(self, context: Parser2Context) -> Expression2:
        """Convert to `Expression2` descendant class."""
        return context.macro_expressions.subtraction(
            lhs=self.left.to_parser2_expression(context),
            rhs=self.right.to_parser2_expression(context),
        )

to_parser2_expression 

to_parser2_expression(
    context: Parser2Context,
) -> Expression2

Convert to Expression2 descendant class.

Source code in src/pygerber/gerberx3/tokenizer/tokens/macro/expressions/binary.py 
171
172
173
174
175
176
def to_parser2_expression(self, context: Parser2Context) -> Expression2:
    """Convert to `Expression2` descendant class."""
    return context.macro_expressions.subtraction(
        lhs=self.left.to_parser2_expression(context),
        rhs=self.right.to_parser2_expression(context),
    )