Brummel
26fb3459d8
The runtime print path now writes exactly the bytes of its
argument with no implicit trailing newline. `io/print_str` is
byte-faithful; authors who want a newline emit `(do io/print_str
"\n")` themselves.
## Codegen
`crates/ailang-codegen/src/lib.rs`:
- Module preamble: `@puts(ptr)` → `@fputs(ptr, ptr)` plus
`@stdout = external global ptr` (libc's `FILE *stdout`).
- Effect-op lowering for `io/print_str`: emit
`getelementptr +8` then `load ptr, ptr @stdout` then
`call/tail call i32 @fputs(ptr bytes, ptr fp)`. Identical
bytes-pointer GEP, distinct sink.
- The pinned IR-shape test renames from
`print_str_calls_puts_with_bytes_pointer` to
`print_str_calls_fputs_with_bytes_pointer_and_stdout` and now
asserts: bytes-GEP present, stdout-load present, both module-
preamble declarations present, and no `@puts(` call anywhere
in the emitted IR.
## Why this shape, and not the alternatives
- *Rename `io/print_str` to `io/println_str` (issue #29 option 2)*
— kept the auto-newline, just relabelled it. AILang's design
bias is explicit-over-implicit (CLAUDE.md: implicit conversions
cut). Auto-newline is a hidden runtime augmentation; the rename
would have preserved it. Rejected.
- *Append `\n` inside the polymorphic `print` (Show-mediated)
function in `examples/prelude.ail`* — would have been a one-line
fix. Rejected: `print` is the Show-mediated formatter, not a
newline emitter; baking a newline into it would have re-imposed
the same implicit-augmentation problem one layer up, breaking
callers that legitimately want pure-bytes output.
## Fixture / test sweep
30 `.ail` fixtures whose owning tests asserted line-separated
stdout now emit explicit `(do io/print_str "\n")` after each
print. Tests that asserted on multi-line stdout (`show_print_e2e`,
`floats_e2e`, `str_concat_e2e`, `eq_ord_e2e`, several `print_*`
smoke tests) had their fixtures sweetened the same way; assertions
themselves remain the canonical observable output. Fixtures that
never relied on the newline (no test ever read the absence of one)
were left untouched.
## Migrated metadata
- `crates/ailang-core/tests/hash_pin.rs`: the `ordering_match::main`
canonical hash is refreshed (`b65a7f834703ffb4` →
`8ed47b4062ce00f5`). The comment now names both successive
corpus migrations honestly: the per-type-print-retirement (which
moved `(do io/print_int x)` to `(app print x)`) AND this
fputs swap (which wrapped that with `(seq ... (do io/print_str
"\n"))`).
- `design/contracts/str-abi.md`: the consumer-ABI table now lists
`@fputs` as the print sink. A prose paragraph documents the
byte-faithful semantics and references this issue.
- `examples/ordering_match.prose.txt`: regenerated from the
updated `ordering_match.ail`.
- `crates/ail/tests/snapshots/{hello,sum,max3,list,ws_main}.ll`:
IR snapshots regenerated via `UPDATE_SNAPSHOTS=1`.
- Stale `@puts` comments in `runtime/str.c`,
`crates/ail/tests/{e2e,show_print_e2e,print_no_leak_pin}.rs`
replaced with `@fputs`.
## Verification
- `cargo test -p ail --test print_str_no_auto_newline_e2e` — both
RED tests from commit c8ecfa3 now pass.
- `cargo test --workspace` — 90 test groups GREEN, 0 failures.
- `cargo build --workspace` — GREEN.
- No new clippy lints (24 warnings pre-existing in
`crates/ailang-core/src/lib.rs:129`).
- Stats: `bench/orchestrator-stats/2026-05-21-iter-bugfix-print-
str-fputs.json` — 1/1 tasks, 0 re-loops, 0 review loops.
## Empirical evidence cited
Caught in the 2026-05-21 Qwen3-Coder naming-A/B run
(`experiments/2026-05-21-naming-ab/runs/r1/`): every cohort wrote
`(do io/print_str "...\n")` with explicit `\n` and got doubled
newlines, failing the `t3_main_prints` stdout match across all
three cohorts. The empirical LLM-natural form already assumes the
new (post-this-commit) semantics — confirming the
feature-acceptance test in CLAUDE.md.
closes #29
60 lines
2.4 KiB
Plaintext
60 lines
2.4 KiB
Plaintext
; Equality dispatch via the prelude.Eq class for Int/Bool/Str/Unit.
|
|
; Each `(app eq x y)` call resolves to the matching primitive Eq
|
|
; instance, lowered via try_emit_primitive_instance_body in the
|
|
; codegen:
|
|
; Int → icmp eq i64
|
|
; Bool → icmp eq i1
|
|
; Str → @ail_str_eq (strcmp-based)
|
|
; Unit → constant i1 true (single-inhabitant type)
|
|
;
|
|
; Float has no Eq instance; partial-Float comparison is done via
|
|
; the explicit float_eq / float_lt / etc. fns (see
|
|
; design/contracts/float-semantics.md).
|
|
;
|
|
; This fixture exercises all four supported types, both directly via
|
|
; `(app eq ...)` and indirectly via the lit-pattern desugar (which
|
|
; rewrites `(pat-lit "hi")` → `(if (eq sv "hi") body fall_k)` and
|
|
; therefore inherits the same class-dispatch path).
|
|
;
|
|
; Expected stdout (one per line):
|
|
; true ; (eq 5 5)
|
|
; false ; (eq 5 6)
|
|
; false ; (eq true false)
|
|
; true ; (eq true true)
|
|
; true ; (eq "hi" "hi")
|
|
; false ; (eq "hi" "ho")
|
|
; true ; (eq () ())
|
|
; 1 ; classify_str "hi" (lit-pattern hits 1 arm)
|
|
; 2 ; classify_str "ho" (lit-pattern hits 2 arm)
|
|
; 0 ; classify_str "??" (default arm)
|
|
;
|
|
; Driver routes through the polymorphic `print` helper (Show Bool / Show Int).
|
|
|
|
(module eq_demo
|
|
|
|
(fn classify_str
|
|
(doc "Lit-pattern over Str; exercises build_eq's class-dispatch lowering for non-Int.")
|
|
(type (fn-type (params (con Str)) (ret (con Int))))
|
|
(params s)
|
|
(body
|
|
(match s
|
|
(case (pat-lit "hi") 1)
|
|
(case (pat-lit "ho") 2)
|
|
(case _ 0))))
|
|
|
|
(fn main
|
|
(doc "Drive eq at Int/Bool/Str/Unit; then drive classify_str.")
|
|
(type (fn-type (params) (ret (con Unit)) (effects IO)))
|
|
(params)
|
|
(body
|
|
(seq (seq (app print (app eq 5 5)) (do io/print_str "\n"))
|
|
(seq (seq (app print (app eq 5 6)) (do io/print_str "\n"))
|
|
(seq (seq (app print (app eq true false)) (do io/print_str "\n"))
|
|
(seq (seq (app print (app eq true true)) (do io/print_str "\n"))
|
|
(seq (seq (app print (app eq "hi" "hi")) (do io/print_str "\n"))
|
|
(seq (seq (app print (app eq "hi" "ho")) (do io/print_str "\n"))
|
|
(seq (seq (app print (app eq (lit-unit) (lit-unit))) (do io/print_str "\n"))
|
|
(seq (seq (app print (app classify_str "hi")) (do io/print_str "\n"))
|
|
(seq (seq (app print (app classify_str "ho")) (do io/print_str "\n"))
|
|
(seq (app print (app classify_str "??")) (do io/print_str "\n"))))))))))))))
|