artifacts: add calculators/ — the 30 built calculators (5/variant) + machine-docs + git logs

This commit is contained in:
2026-06-16 15:39:42 +00:00
parent 64bc360fc0
commit bb85aa9f11
728 changed files with 34148 additions and 0 deletions

View File

@ -0,0 +1,42 @@
from calc.parser import Num, BinOp, Unary, parse
from calc.lexer import tokenize
class EvalError(Exception):
pass
def evaluate(node) -> int | float:
"""Walk the AST and return an int or float.
Result type rule: if the result is a whole number (no fractional part),
return int; otherwise return float.
"""
if isinstance(node, Num):
return node.value
if isinstance(node, Unary):
val = evaluate(node.operand)
if node.op == '-':
return _coerce(-val)
raise EvalError(f"unknown unary op {node.op!r}")
if isinstance(node, BinOp):
left = evaluate(node.left)
right = evaluate(node.right)
if node.op == '+':
return _coerce(left + right)
if node.op == '-':
return _coerce(left - right)
if node.op == '*':
return _coerce(left * right)
if node.op == '/':
if right == 0:
raise EvalError("division by zero")
return _coerce(left / right)
raise EvalError(f"unknown binary op {node.op!r}")
raise EvalError(f"unknown AST node {type(node).__name__!r}")
def _coerce(val: int | float) -> int | float:
if isinstance(val, float) and val == int(val):
return int(val)
return val

View File

@ -0,0 +1,50 @@
from dataclasses import dataclass
from typing import Union
class LexError(Exception):
pass
@dataclass
class Token:
kind: str
value: Union[int, float, str, None]
def __repr__(self):
return f"{self.kind}({self.value!r})"
_SINGLE = {
'+': 'PLUS',
'-': 'MINUS',
'*': 'STAR',
'/': 'SLASH',
'(': 'LPAREN',
')': 'RPAREN',
}
def tokenize(src: str) -> list:
tokens = []
i = 0
n = len(src)
while i < n:
ch = src[i]
if ch in (' ', '\t'):
i += 1
elif ch in _SINGLE:
tokens.append(Token(_SINGLE[ch], ch))
i += 1
elif ch.isdigit() or ch == '.':
j = i
while j < n and (src[j].isdigit() or src[j] == '.'):
j += 1
raw = src[i:j]
value = float(raw) if '.' in raw else int(raw)
tokens.append(Token('NUMBER', value))
i = j
else:
raise LexError(f"unexpected character {ch!r} at position {i}")
tokens.append(Token('EOF', None))
return tokens

View File

@ -0,0 +1,109 @@
from dataclasses import dataclass
from typing import Any
class ParseError(Exception):
pass
@dataclass
class Num:
value: Any
def __repr__(self):
return f"Num({self.value!r})"
@dataclass
class BinOp:
op: str
left: Any
right: Any
def __repr__(self):
return f"BinOp({self.op!r}, {self.left!r}, {self.right!r})"
@dataclass
class Unary:
op: str
operand: Any
def __repr__(self):
return f"Unary({self.op!r}, {self.operand!r})"
class _Parser:
def __init__(self, tokens):
self._tokens = tokens
self._pos = 0
def _peek(self):
return self._tokens[self._pos]
def _consume(self, kind=None):
tok = self._tokens[self._pos]
if kind and tok.kind != kind:
raise ParseError(f"expected {kind}, got {tok.kind!r} ({tok.value!r})")
self._pos += 1
return tok
def parse(self):
node = self._expr()
tok = self._peek()
if tok.kind != 'EOF':
raise ParseError(f"unexpected token {tok.kind!r} ({tok.value!r})")
return node
def _expr(self):
# expr → term (('+' | '-') term)*
node = self._term()
while self._peek().kind in ('PLUS', 'MINUS'):
op = self._consume().value
right = self._term()
node = BinOp(op, node, right)
return node
def _term(self):
# term → unary (('*' | '/') unary)*
node = self._unary()
while self._peek().kind in ('STAR', 'SLASH'):
op = self._consume().value
right = self._unary()
node = BinOp(op, node, right)
return node
def _unary(self):
# unary → '-' unary | primary
if self._peek().kind == 'MINUS':
op = self._consume().value
operand = self._unary()
return Unary(op, operand)
return self._primary()
def _primary(self):
tok = self._peek()
if tok.kind == 'NUMBER':
self._consume()
return Num(tok.value)
if tok.kind == 'LPAREN':
self._consume('LPAREN')
node = self._expr()
self._consume('RPAREN')
return node
if tok.kind == 'EOF':
raise ParseError("unexpected end of input")
raise ParseError(f"unexpected token {tok.kind!r} ({tok.value!r})")
def parse(tokens) -> Any:
"""Parse a token list from calc.lexer.tokenize into an AST.
AST node types:
Num(value) — numeric literal
BinOp(op, left, right) — binary operation; op in {'+','-','*','/'}
Unary(op, operand) — unary minus; op == '-'
Raises ParseError on malformed input.
"""
return _Parser(tokens).parse()

View File

@ -0,0 +1,55 @@
import unittest
from calc.lexer import tokenize
from calc.parser import parse
from calc.evaluator import evaluate, EvalError
def calc(s):
return evaluate(parse(tokenize(s)))
class TestArithmetic(unittest.TestCase):
def test_add_mul_precedence(self):
self.assertEqual(calc("2+3*4"), 14)
def test_paren_override(self):
self.assertEqual(calc("(2+3)*4"), 20)
def test_left_assoc_sub(self):
self.assertEqual(calc("8-3-2"), 3)
def test_unary_minus(self):
self.assertEqual(calc("-2+5"), 3)
def test_unary_in_mul(self):
self.assertEqual(calc("2*-3"), -6)
class TestDivision(unittest.TestCase):
def test_true_division(self):
self.assertAlmostEqual(calc("7/2"), 3.5)
def test_division_by_zero(self):
with self.assertRaises(EvalError):
calc("1/0")
def test_division_exact(self):
self.assertEqual(calc("4/2"), 2)
self.assertIsInstance(calc("4/2"), int)
class TestResultType(unittest.TestCase):
def test_whole_result_is_int(self):
self.assertIsInstance(calc("4/2"), int)
self.assertEqual(calc("4/2"), 2)
def test_fractional_result_is_float(self):
self.assertIsInstance(calc("7/2"), float)
self.assertAlmostEqual(calc("7/2"), 3.5)
def test_int_arithmetic_stays_int(self):
self.assertIsInstance(calc("2+3"), int)
if __name__ == '__main__':
unittest.main()

View File

@ -0,0 +1,94 @@
import unittest
from calc.lexer import tokenize, Token, LexError
def kinds(src):
return [t.kind for t in tokenize(src)]
def values(src):
return [(t.kind, t.value) for t in tokenize(src)]
class TestNumbers(unittest.TestCase):
def test_integer(self):
toks = tokenize("42")
self.assertEqual(toks[0], Token('NUMBER', 42))
self.assertIsInstance(toks[0].value, int)
self.assertEqual(toks[1].kind, 'EOF')
def test_float_decimal(self):
toks = tokenize("3.14")
self.assertEqual(toks[0], Token('NUMBER', 3.14))
self.assertIsInstance(toks[0].value, float)
def test_float_leading_dot(self):
toks = tokenize(".5")
self.assertAlmostEqual(toks[0].value, 0.5)
def test_float_trailing_dot(self):
toks = tokenize("10.")
self.assertEqual(toks[0].value, 10.0)
self.assertIsInstance(toks[0].value, float)
def test_eof_appended(self):
toks = tokenize("42")
self.assertEqual(toks[-1].kind, 'EOF')
class TestOperatorsAndParens(unittest.TestCase):
def test_all_operators(self):
self.assertEqual(kinds("+"), ['PLUS', 'EOF'])
self.assertEqual(kinds("-"), ['MINUS', 'EOF'])
self.assertEqual(kinds("*"), ['STAR', 'EOF'])
self.assertEqual(kinds("/"), ['SLASH', 'EOF'])
self.assertEqual(kinds("("), ['LPAREN', 'EOF'])
self.assertEqual(kinds(")"), ['RPAREN', 'EOF'])
def test_expression(self):
self.assertEqual(kinds("1+2*3"),
['NUMBER', 'PLUS', 'NUMBER', 'STAR', 'NUMBER', 'EOF'])
def test_complex_expr(self):
self.assertEqual(kinds("3.5*(1-2)"),
['NUMBER', 'STAR', 'LPAREN', 'NUMBER', 'MINUS', 'NUMBER', 'RPAREN', 'EOF'])
result = values("3.5*(1-2)")
self.assertAlmostEqual(result[0][1], 3.5)
self.assertEqual(result[3][1], 1)
self.assertEqual(result[5][1], 2)
class TestWhitespaceAndErrors(unittest.TestCase):
def test_spaces_skipped(self):
self.assertEqual(kinds(" 12 + 3 "),
['NUMBER', 'PLUS', 'NUMBER', 'EOF'])
toks = tokenize(" 12 + 3 ")
self.assertEqual(toks[0].value, 12)
self.assertEqual(toks[2].value, 3)
def test_tabs_skipped(self):
self.assertEqual(kinds("1\t+\t2"), ['NUMBER', 'PLUS', 'NUMBER', 'EOF'])
def test_at_raises_lexerror(self):
with self.assertRaises(LexError):
tokenize("1 @ 2")
def test_dollar_raises_lexerror(self):
with self.assertRaises(LexError):
tokenize("$10")
def test_letter_raises_lexerror(self):
with self.assertRaises(LexError):
tokenize("abc")
def test_lexerror_message_includes_char_and_pos(self):
try:
tokenize("1 @ 2")
except LexError as e:
msg = str(e)
self.assertIn('@', msg)
self.assertIn('2', msg) # position is 2
if __name__ == '__main__':
unittest.main()

View File

@ -0,0 +1,101 @@
import unittest
from calc.lexer import tokenize
from calc.parser import parse, ParseError, Num, BinOp, Unary
def p(src):
return parse(tokenize(src))
class TestPrecedence(unittest.TestCase):
def test_mul_over_add(self):
# 1+2*3 → BinOp('+', Num(1), BinOp('*', Num(2), Num(3)))
self.assertEqual(p('1+2*3'), BinOp('+', Num(1), BinOp('*', Num(2), Num(3))))
def test_div_over_sub(self):
# 10-6/2 → BinOp('-', Num(10), BinOp('/', Num(6), Num(2)))
self.assertEqual(p('10-6/2'), BinOp('-', Num(10), BinOp('/', Num(6), Num(2))))
def test_add_left_of_mul(self):
# 1*2+3 → BinOp('+', BinOp('*', Num(1), Num(2)), Num(3))
self.assertEqual(p('1*2+3'), BinOp('+', BinOp('*', Num(1), Num(2)), Num(3)))
class TestLeftAssociativity(unittest.TestCase):
def test_sub_left_assoc(self):
# 8-3-2 → BinOp('-', BinOp('-', Num(8), Num(3)), Num(2))
self.assertEqual(p('8-3-2'), BinOp('-', BinOp('-', Num(8), Num(3)), Num(2)))
def test_div_left_assoc(self):
# 8/4/2 → BinOp('/', BinOp('/', Num(8), Num(4)), Num(2))
self.assertEqual(p('8/4/2'), BinOp('/', BinOp('/', Num(8), Num(4)), Num(2)))
def test_add_left_assoc(self):
# 1+2+3 → BinOp('+', BinOp('+', Num(1), Num(2)), Num(3))
self.assertEqual(p('1+2+3'), BinOp('+', BinOp('+', Num(1), Num(2)), Num(3)))
class TestParentheses(unittest.TestCase):
def test_paren_overrides_mul(self):
# (1+2)*3 → BinOp('*', BinOp('+', Num(1), Num(2)), Num(3))
self.assertEqual(p('(1+2)*3'), BinOp('*', BinOp('+', Num(1), Num(2)), Num(3)))
def test_paren_overrides_div(self):
# 8/(2+2) → BinOp('/', Num(8), BinOp('+', Num(2), Num(2)))
self.assertEqual(p('8/(2+2)'), BinOp('/', Num(8), BinOp('+', Num(2), Num(2))))
def test_nested_parens(self):
# ((5)) → Num(5)
self.assertEqual(p('((5))'), Num(5))
class TestUnaryMinus(unittest.TestCase):
def test_simple_neg(self):
# -5 → Unary('-', Num(5))
self.assertEqual(p('-5'), Unary('-', Num(5)))
def test_neg_paren(self):
# -(1+2) → Unary('-', BinOp('+', Num(1), Num(2)))
self.assertEqual(p('-(1+2)'), Unary('-', BinOp('+', Num(1), Num(2))))
def test_mul_neg(self):
# 3 * -2 → BinOp('*', Num(3), Unary('-', Num(2)))
self.assertEqual(p('3 * -2'), BinOp('*', Num(3), Unary('-', Num(2))))
def test_double_neg(self):
# --5 → Unary('-', Unary('-', Num(5)))
self.assertEqual(p('--5'), Unary('-', Unary('-', Num(5))))
class TestErrors(unittest.TestCase):
def test_trailing_plus(self):
with self.assertRaises(ParseError):
p('1 +')
def test_unclosed_paren(self):
with self.assertRaises(ParseError):
p('(1')
def test_two_numbers(self):
with self.assertRaises(ParseError):
p('1 2')
def test_close_then_open(self):
with self.assertRaises(ParseError):
p(')(')
def test_empty_string(self):
with self.assertRaises(ParseError):
p('')
def test_only_operator(self):
with self.assertRaises(ParseError):
p('*')
def test_unclosed_paren_expr(self):
with self.assertRaises(ParseError):
p('(1+2')
if __name__ == '__main__':
unittest.main()