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,43 @@
from __future__ import annotations
from calc.parser import Num, BinOp, Unary, Node
class EvalError(Exception):
pass
def evaluate(node: Node) -> int | float:
"""Walk the AST and return the numeric result."""
if isinstance(node, Num):
return node.value
if isinstance(node, Unary):
val = evaluate(node.operand)
if node.op == '-':
return -val
raise EvalError(f"unknown unary operator: {node.op!r}")
if isinstance(node, BinOp):
left = evaluate(node.left)
right = evaluate(node.right)
if node.op == '+':
return left + right
if node.op == '-':
return left - right
if node.op == '*':
return left * right
if node.op == '/':
if right == 0:
raise EvalError("division by zero")
return left / right
raise EvalError(f"unknown binary operator: {node.op!r}")
raise EvalError(f"unknown node type: {type(node)!r}")
def fmt_result(v: int | float) -> str:
"""Format a result for display.
Rule: whole-valued floats (e.g. 2.0 from 4/2) print without a trailing .0;
non-whole floats print normally; integers print as integers.
"""
if isinstance(v, float) and v.is_integer():
return str(int(v))
return str(v)

View File

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

View File

@ -0,0 +1,107 @@
from __future__ import annotations
from dataclasses import dataclass
from typing import Union
class ParseError(Exception):
pass
@dataclass
class Num:
value: Union[int, float]
def __repr__(self) -> str:
return f"Num({self.value!r})"
@dataclass
class BinOp:
op: str
left: "Node"
right: "Node"
def __repr__(self) -> str:
return f"BinOp({self.op!r}, {self.left!r}, {self.right!r})"
@dataclass
class Unary:
op: str
operand: "Node"
def __repr__(self) -> str:
return f"Unary({self.op!r}, {self.operand!r})"
Node = Union[Num, BinOp, Unary]
class _Parser:
def __init__(self, tokens: list) -> None:
self._tokens = tokens
self._pos = 0
def _peek(self):
return self._tokens[self._pos]
def _consume(self, kind: str = None):
tok = self._tokens[self._pos]
if kind is not None 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:
if self._peek().kind == "EOF":
raise ParseError("empty input")
node = self._expr()
if self._peek().kind != "EOF":
tok = self._peek()
raise ParseError(
f"unexpected token {tok.kind!r} ({tok.value!r}) after expression"
)
return node
def _expr(self) -> Node:
node = self._term()
while self._peek().kind in ("PLUS", "MINUS"):
op = self._consume().value
node = BinOp(op, node, self._term())
return node
def _term(self) -> Node:
node = self._unary()
while self._peek().kind in ("STAR", "SLASH"):
op = self._consume().value
node = BinOp(op, node, self._unary())
return node
def _unary(self) -> Node:
if self._peek().kind == "MINUS":
self._consume()
return Unary("-", self._unary())
return self._primary()
def _primary(self) -> Node:
tok = self._peek()
if tok.kind == "NUMBER":
self._consume()
return Num(tok.value)
if tok.kind == "LPAREN":
self._consume()
node = self._expr()
if self._peek().kind != "RPAREN":
raise ParseError("unclosed parenthesis")
self._consume()
return node
raise ParseError(
f"unexpected token {tok.kind!r} ({tok.value!r})"
)
def parse(tokens: list) -> Node:
"""Parse a token list produced by calc.lexer.tokenize into an AST."""
return _Parser(tokens).parse()

View File

@ -0,0 +1,95 @@
import unittest
from calc.lexer import tokenize
from calc.parser import parse
from calc.evaluator import evaluate, EvalError, fmt_result
def ev(src: str):
return evaluate(parse(tokenize(src)))
class TestArithmetic(unittest.TestCase):
"""D1 — basic arithmetic, precedence, parens, unary minus"""
def test_precedence(self):
self.assertEqual(ev("2+3*4"), 14)
def test_parens(self):
self.assertEqual(ev("(2+3)*4"), 20)
def test_left_assoc_sub(self):
self.assertEqual(ev("8-3-2"), 3)
def test_unary_minus_leading(self):
self.assertEqual(ev("-2+5"), 3)
def test_unary_minus_mul(self):
self.assertEqual(ev("2*-3"), -6)
class TestDivision(unittest.TestCase):
"""D2 — true division and division by zero"""
def test_true_division(self):
self.assertAlmostEqual(ev("7/2"), 3.5)
def test_division_by_zero_raises_eval_error(self):
with self.assertRaises(EvalError):
ev("1/0")
def test_division_by_zero_no_bare_exception(self):
"""ZeroDivisionError must not escape the evaluator API."""
try:
ev("1/0")
except EvalError:
pass
except ZeroDivisionError:
self.fail("ZeroDivisionError escaped the evaluator API")
class TestResultType(unittest.TestCase):
"""D3 — whole-valued floats display as int, non-whole as float"""
def test_whole_division_value(self):
# 4/2 = 2.0 in Python; must equal 2
self.assertEqual(ev("4/2"), 2)
def test_non_whole_division_value(self):
self.assertAlmostEqual(ev("7/2"), 3.5)
def test_int_arithmetic_returns_int(self):
self.assertIsInstance(ev("2+3"), int)
self.assertIsInstance(ev("2*3"), int)
self.assertIsInstance(ev("8-3"), int)
def test_fmt_whole_float(self):
self.assertEqual(fmt_result(2.0), "2")
def test_fmt_non_whole_float(self):
self.assertEqual(fmt_result(3.5), "3.5")
def test_fmt_int(self):
self.assertEqual(fmt_result(14), "14")
def test_fmt_negative(self):
self.assertEqual(fmt_result(-6), "-6")
class TestMisc(unittest.TestCase):
"""Additional coverage"""
def test_neg_times_neg(self):
self.assertEqual(ev("-2*-3"), 6)
def test_complex_expr(self):
self.assertEqual(ev("(1+2)*(3+4)"), 21)
def test_unary_in_paren(self):
self.assertEqual(ev("-(3)"), -3)
def test_double_unary(self):
self.assertEqual(ev("--5"), 5)
if __name__ == "__main__":
unittest.main()

View File

@ -0,0 +1,118 @@
import unittest
from calc.lexer import tokenize, Token, LexError
def kinds(src):
return [t.kind for t in tokenize(src)]
def tok(src):
return [(t.kind, t.value) for t in tokenize(src)]
class TestNumbers(unittest.TestCase):
def test_integer(self):
tokens = tokenize("42")
self.assertEqual(len(tokens), 2)
self.assertEqual(tokens[0], Token('NUMBER', 42))
self.assertEqual(tokens[1], Token('EOF', None))
self.assertIsInstance(tokens[0].value, int)
def test_float_standard(self):
tokens = tokenize("3.14")
self.assertEqual(tokens[0], Token('NUMBER', 3.14))
self.assertIsInstance(tokens[0].value, float)
def test_float_leading_dot(self):
tokens = tokenize(".5")
self.assertEqual(tokens[0], Token('NUMBER', 0.5))
self.assertIsInstance(tokens[0].value, float)
def test_float_trailing_dot(self):
tokens = tokenize("10.")
self.assertEqual(tokens[0], Token('NUMBER', 10.0))
self.assertIsInstance(tokens[0].value, float)
def test_zero(self):
tokens = tokenize("0")
self.assertEqual(tokens[0], Token('NUMBER', 0))
class TestOperatorsAndParens(unittest.TestCase):
def test_plus(self):
self.assertIn(Token('PLUS', '+'), tokenize("+"))
def test_minus(self):
self.assertIn(Token('MINUS', '-'), tokenize("-"))
def test_star(self):
self.assertIn(Token('STAR', '*'), tokenize("*"))
def test_slash(self):
self.assertIn(Token('SLASH', '/'), tokenize("/"))
def test_lparen(self):
self.assertIn(Token('LPAREN', '('), tokenize("("))
def test_rparen(self):
self.assertIn(Token('RPAREN', ')'), tokenize(")"))
def test_expression(self):
self.assertEqual(
kinds("1+2*3"),
['NUMBER', 'PLUS', 'NUMBER', 'STAR', 'NUMBER', 'EOF']
)
def test_complex_expression(self):
self.assertEqual(
kinds("3.5*(1-2)"),
['NUMBER', 'STAR', 'LPAREN', 'NUMBER', 'MINUS', 'NUMBER', 'RPAREN', 'EOF']
)
class TestWhitespaceAndErrors(unittest.TestCase):
def test_whitespace_skipped(self):
self.assertEqual(
kinds(" 12 + 3 "),
['NUMBER', 'PLUS', 'NUMBER', 'EOF']
)
t = tokenize(" 12 + 3 ")
self.assertEqual(t[0].value, 12)
self.assertEqual(t[1].kind, 'PLUS')
self.assertEqual(t[2].value, 3)
def test_tab_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("$")
def test_letter_raises_lexerror(self):
with self.assertRaises(LexError):
tokenize("x")
def test_lexerror_message_has_char_and_pos(self):
try:
tokenize("1 @ 2")
self.fail("Expected LexError")
except LexError as e:
msg = str(e)
self.assertIn('@', msg)
self.assertIn('2', msg) # position 2
def test_eof_always_last(self):
tokens = tokenize("1+2")
self.assertEqual(tokens[-1].kind, 'EOF')
def test_empty_string(self):
tokens = tokenize("")
self.assertEqual(tokens, [Token('EOF', None)])
if __name__ == '__main__':
unittest.main()

View File

@ -0,0 +1,142 @@
import unittest
from calc.lexer import tokenize
from calc.parser import parse, ParseError, Num, BinOp, Unary
def p(src: str):
return parse(tokenize(src))
class TestPrecedence(unittest.TestCase):
"""D1 — * and / bind tighter than + and -"""
def test_add_mul(self):
# 1+2*3 → BinOp('+', Num(1), BinOp('*', Num(2), Num(3)))
tree = p("1+2*3")
self.assertEqual(tree, BinOp("+", Num(1), BinOp("*", Num(2), Num(3))))
def test_mul_add(self):
# 2*3+1 → BinOp('+', BinOp('*', Num(2), Num(3)), Num(1))
tree = p("2*3+1")
self.assertEqual(tree, BinOp("+", BinOp("*", Num(2), Num(3)), Num(1)))
def test_sub_div(self):
# 6-4/2 → BinOp('-', Num(6), BinOp('/', Num(4), Num(2)))
tree = p("6-4/2")
self.assertEqual(tree, BinOp("-", Num(6), BinOp("/", Num(4), Num(2))))
class TestLeftAssociativity(unittest.TestCase):
"""D2 — same-precedence operators associate left"""
def test_subtraction(self):
# 8-3-2 → BinOp('-', BinOp('-', Num(8), Num(3)), Num(2))
tree = p("8-3-2")
self.assertEqual(tree, BinOp("-", BinOp("-", Num(8), Num(3)), Num(2)))
def test_division(self):
# 8/4/2 → BinOp('/', BinOp('/', Num(8), Num(4)), Num(2))
tree = p("8/4/2")
self.assertEqual(tree, BinOp("/", BinOp("/", Num(8), Num(4)), Num(2)))
def test_addition(self):
# 1+2+3 → BinOp('+', BinOp('+', Num(1), Num(2)), Num(3))
tree = p("1+2+3")
self.assertEqual(tree, BinOp("+", BinOp("+", Num(1), Num(2)), Num(3)))
def test_multiplication(self):
# 2*3*4 → BinOp('*', BinOp('*', Num(2), Num(3)), Num(4))
tree = p("2*3*4")
self.assertEqual(tree, BinOp("*", BinOp("*", Num(2), Num(3)), Num(4)))
class TestParentheses(unittest.TestCase):
"""D3 — parens override precedence"""
def test_paren_add_then_mul(self):
# (1+2)*3 → BinOp('*', BinOp('+', Num(1), Num(2)), Num(3))
tree = p("(1+2)*3")
self.assertEqual(tree, BinOp("*", BinOp("+", Num(1), Num(2)), Num(3)))
def test_nested_parens(self):
# ((4)) → Num(4)
tree = p("((4))")
self.assertEqual(tree, Num(4))
def test_paren_complex(self):
# 2*(3+4) → BinOp('*', Num(2), BinOp('+', Num(3), Num(4)))
tree = p("2*(3+4)")
self.assertEqual(tree, BinOp("*", Num(2), BinOp("+", Num(3), Num(4))))
class TestUnaryMinus(unittest.TestCase):
"""D4 — unary minus"""
def test_simple_unary(self):
# -5 → Unary('-', Num(5))
tree = p("-5")
self.assertEqual(tree, Unary("-", Num(5)))
def test_unary_paren(self):
# -(1+2) → Unary('-', BinOp('+', Num(1), Num(2)))
tree = p("-(1+2)")
self.assertEqual(tree, Unary("-", BinOp("+", Num(1), Num(2))))
def test_unary_in_binop(self):
# 3 * -2 → BinOp('*', Num(3), Unary('-', Num(2)))
tree = p("3 * -2")
self.assertEqual(tree, BinOp("*", Num(3), Unary("-", Num(2))))
def test_double_unary(self):
# --5 → Unary('-', Unary('-', Num(5)))
tree = p("--5")
self.assertEqual(tree, Unary("-", Unary("-", Num(5))))
class TestErrors(unittest.TestCase):
"""D5 — malformed input raises ParseError"""
def test_trailing_operator(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_before_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_mismatched_parens(self):
with self.assertRaises(ParseError):
p("(1+2")
class TestAtoms(unittest.TestCase):
"""Basic atoms parse cleanly"""
def test_single_int(self):
self.assertEqual(p("42"), Num(42))
def test_single_float(self):
self.assertEqual(p("3.14"), Num(3.14))
def test_single_in_parens(self):
self.assertEqual(p("(7)"), Num(7))
if __name__ == "__main__":
unittest.main()