Repository navigation
Expand file tree
/
Copy pathhugo.toml
More file actions
84 lines (79 loc) · 9.99 KB
/
Copy pathhugo.toml
File metadata and controls
84 lines (79 loc) · 9.99 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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
baseURL = "https://go-embedded-ruby.github.io/"
title = "go-embedded-ruby"
disableKinds = ["taxonomy", "term", "RSS", "sitemap", "404"]
[markup.goldmark.renderer]
unsafe = true
# The design -- layouts/partials/styles.html, theme-toggle.html,
# fork-ribbon.html and icons/{github,book}.html -- comes from the shared Hugo
# module github.com/go-fleettools/landingkit, not from copies here: the copies
# drifted. Its version is pinned in go.mod (Renovate bumps it), and kit.go
# keeps `go mod tidy` from deleting that requirement. A file of the same name
# under layouts/partials/ would silently override the module's.
[module]
[[module.imports]]
path = "github.com/go-fleettools/landingkit"
[params.brand]
# Generated by go-fleettools/landingkit from static/img/logo.svg: the colours are
# READ from the logo's gradient, never chosen. Do not add other keys:
# neutrals (backgrounds, surfaces, greys) belong to the shared sheet.
# Contrast: base on white 8.08:1, bright on the dark background 5.29:1.
base = "#9b1c2e"
deep = "#5f111c"
bright = "#f0475a"
shadow = "rgba(155,28,46,.7)"
glow = "rgba(155,28,46,.6)"
wash = "rgba(155,28,46,.10)"
washDeep = "rgba(95,17,28,.06)"
chipBg = "#fde9eb"
chipBorder = "#fac8ce"
chipFg = "#5f111c"
chipBgDark = "rgba(240,71,90,.14)"
chipBorderDark = "rgba(240,71,90,.32)"
chipFgDark = "#f79aa4"
statsEnd = "#fbd3d7"
bandText = "#fde2e5"
[[params.phases]]
name = "Phase 0 — Vertical slice"
status = "ready"
blurb = "Lexer → parser → compiler → bytecode VM, end to end. Integers, floats, strings, locals, arithmetic, if/unless, while/until, statement modifiers, def + recursion. Runs `puts 1 + 2` and `fib(20)`."
[[params.phases]]
name = "Phase 1 — Object model & dispatch"
status = "ready"
blurb = "Classes, modules, inheritance, mutable method tables, `@ivars`, `new`/`initialize`, constants, `include` mixins, `super`, blocks & `yield`, `block_given?`, method_missing — the live object model that makes monkey-patching free."
[[params.phases]]
name = "Phase 2 — Core types & mixins"
status = "ready"
blurb = "Integer (with **Bignum** promotion + arbitrary-precision literals, **radix literals** `0x`/`0o`/`0b`/`0d`, **bitwise/shift** `<< >> & | ^ ~`), Float, mutable String, Symbol (incl. **operator-method symbols** `:+`/`:<<`/`:[]=`), Array, ordered Hash, Range (incl. beginless/endless). Full argument system (optional/`*splat`/keyword/`**rest`/`&block`), Proc/lambda/stabby `->(){}`, `Symbol#to_proc`, class methods, `attr_accessor`, `Struct`. Comparable and Enumerable written once, in embedded Ruby."
[[params.phases]]
name = "Phase 3 — Control flow & Fiber"
status = "ready"
blurb = "Exception hierarchy, `raise`/`rescue`/`ensure`/`else`/`retry` (block- and method-level), non-local `break`/`next`, `Kernel#loop`, and the eager **Enumerator** — every blockless iterator returns one, with `next`/`peek`/`rewind`/`with_index`/`to_a` and full Enumerable chaining, plus **Enumerator::Lazy** (`lazy`) for deferred chains over finite or infinite (`Float::INFINITY`) sources, and **Fiber** — cooperative coroutines on goroutines (`Fiber.new`/`resume`/`Fiber.yield`/`alive?`)."
[[params.phases]]
name = "Phase 4 — Metaprogramming"
status = "ready"
blurb = "`define_method`, `instance_eval`/`instance_exec`, `class_eval`/`module_eval`/`class_exec`, `send`/`public_send`, `respond_to?`, `instance_variable_get`/`set`/`defined?`, `tap`/`then`, the hooks `included`/`inherited`/`method_added`/`extended`, `define_singleton_method`/`extend` and `def obj.foo` syntax, **`@@class variables`**, **`$global variables`**, string `eval`, **`Binding`** (`binding`/`Binding#eval`/`eval(str, binding)` + `local_variable_get`/`set`/`local_variables`/`receiver` — eval against a captured frame's locals), and **`prepend`** with an ancestor-chain `super` (walks included/prepended modules and the singleton chain; `Module#ancestors`/`include?`, `Kernel` modelled)."
[[params.phases]]
name = "Phase 5 — Full front-end"
status = "ready"
blurb = "Interpolation, keyword args, endless methods (`def foo = expr`), beginless/endless ranges, the stabby lambda, multiple assignment, full pattern matching `case/in` (value/bind/class/array/hash/find/pin/alternative, guards, one-line `=>`/`in`), safe navigation `&.`, numbered params (`_1`/`it`), modifier `rescue`, heredocs (`<<`/`<<-`/`<<~`, interpolating and literal), `%w`/`%i` arrays and the `%q`/`%Q`/`%W`/`%I` literals already landed."
[[params.phases]]
name = "Phase 6 — Standard library"
status = "active"
blurb = "Regexp bridge landed: `/re/imx` literals, `Regexp`/`MatchData`, `=~`/`match`/`scan`/`gsub`/`sub`/`split` and the match globals, on the pure-Go Onigmo engine (go-ruby-regexp org). `Time`/`Date`/`BigDecimal`, `Set`/`Bag`, and the Go-native leaves `JSON`/`Digest`/`Base64`, **`File`** (path helpers + read/write/stat, `Errno::ENOENT`), a bit-exact **`Random`** (seeded MT19937), **`Zlib`** (crc32/adler32 + Deflate/Inflate) a **byte-exact `Marshal`** (`dump`/`load`, on the pure-Go go-ruby-marshal engine) **`Thread`/`Mutex`/`Queue`** on an emulated GVL (MRI memory model, race-free), **`IO`/`StringIO`** (`$stdout`/`$stderr` as objects, output capture) **`Dir`** (entries/glob/mkdir/chdir) and **`File.open` streams** (`File < IO`, modes `r`/`w`/`a`/`+`, block form auto-flush/close, `readlines`/`foreach`) landed too."
[[params.phases]]
name = "Phase 7 — Build toolchain"
status = "ready"
blurb = "rbgo build landed: AOT method compilation to native Go (unboxed int64 kernels beat MRI+YJIT ~4×), and **closed-world builds** (`rbgo build --closed`) that bake the program in as bytecode, load the prelude from frozen bytecode, and drop the lexer/parser/compiler — a smaller, self-contained binary that runs with no source file."
[[params.phases]]
name = "Phase 8 — Conformance & performance"
status = "active"
blurb = "Since July the work has been **runtime** conformance, measured against [ruby/spec](https://github.com/ruby/spec)'s `language/` + `core/` suites: **23,672 examples pass** — the total that `BASELINE` sums to on `main` (re-recorded 2026-11-03 at Ruby 4.0.9, on the pinned runner that enforces it; 2,202 of 2,206 spec files produce a result, the other 4 recorded as FILEFAIL). One file, `core/random/bytes_spec.rb`, draws 8 or 9 passing examples from run to run; on 2026-11-04 its row was pinned to **8**, its floor, rather than to the 9 that re-recording happened to observe — a baseline recorded at a high draw turns the next ordinary run red, gated in CI by a **per-file baseline** — one record per spec file, so a file that regresses is named rather than absorbed. It replaced a single shrink-only floor, which needed a margin wider than the largest spec file and was therefore blind to any regression smaller than that: the floor had climbed from 6,000 when the ratchet first landed on 2026-08-03 to 22,475, while sitting 211 below the measured total. **Only `language/` and `core/` are swept** — ruby/spec's `library/`, `optional/` and `security/` trees are not run at all, so this is not a percentage of Ruby. Two of the recent jumps were fixes to the **measurement** rather than the interpreter — the mspec shim, and a parser upgrade that made 13 previously-unparseable spec files visible — and those are gains in what the measurement can *see*, not in what the VM can *do*. Earlier, a conformance campaign brought the pure-Go **front-end** to ~**100% of all valid Ruby** parsed across Rails + Puppet (99.96% of files; 2 misses are syntax-error fixtures MRI rejects) and **parse + compile** of **Rails 99.82% / Puppet 100%**, with **0 over-permissive** — and RuboCop 99.7%, Sinatra/Jekyll/Thor/Kramdown/dry-struct 100%, RSpec DSL 10/10. On the runtime side, that road is now underway: **the real `puppet apply` CLI runs end-to-end** on a pure-Go CGO=0 `rbgo` — `require \"puppet\"` boots Puppet 8.11.0 (all pure-Ruby gem deps on the path), and the genuine `Puppet::Util::CommandLine` → `Puppet::Application::Apply` path (real `OptionParser`, all types + providers, settings catalog applied to disk, then the user catalog via the transaction/RAL) converges `notify`, `file` and `exec` resources (the `exec` provider runs commands via pure-Go process execution with `onlyif`/`unless`/`creates`/`path` guards), emits real Puppet output (`Notice: hi from rbgo cli`) and exits 0 with the YAML run report round-tripped. Broader resource **providers** are the active next milestone (`user`/`group` provider-ready; `package`/`service` need a host package manager/systemd + root). rbgo is also increasingly composed from the standalone pure-Go **go-ruby-* family** — **178 modules across 176 orgs are now bound into rbgo as native modules** (parser, regexp, erb, marshal, yaml, format, optparse, strscan, json, date, … a selection is on the landing page), each its own 100%-coverage 6-arch org. (`Set` is not among them: it is implemented in-tree, over rbgo's own Hash.) Of the six 64-bit arches, amd64 and arm64 are tested on every pull request, as is 32-bit 386 (since v0.8.2; 32-bit arm runs nightly under qemu), and since v0.8.3 every pull request also compiles rbgo for every GOOS/GOARCH Go supports, plan9 included since v0.8.5 (vetted, not run: there is no Plan 9 kernel in CI); riscv64, loong64, ppc64le and s390x are validated on a **nightly schedule** — under qemu, and natively on the GCC Compile Farm plus an IBM LinuxONE s390x host — not on the pull-request path. On performance, a 6-runtime suite (rbgo/rbgo+AOT vs MRI/YJIT/JRuby/TruffleRuby): **rbgo+AOT beats MRI+YJIT on integer-bound kernels — measured here at 8.7× on the tight-loop benchmark and 2.0× on recursive `fib(35)`** (darwin/arm64, whole-process wall time); plus inline method caches, small-integer interning (a small-int loop drops from ~245k allocations to 1) and capture-tracked frame recycling (~14% faster on fib)."
# The hero's buttons, rendered by landingkit's cta.html in the kit's order.
[[params.cta]]
kind = "docs"
href = "https://github.com/go-embedded-ruby/ruby"
label = "Get started →"
[[params.cta]]
kind = "link"
href = "/performance/"
label = "See the benchmarks"