Showcase

The showcase is a single runnable file that demonstrates every major Frankie feature from v1.0 through v1.12.

It is the fastest way to see the whole language in one place.

frankiec run examples/showcase.fk

---

What It Covers

The showcase is divided into 38 numbered sections, one per feature area. Each section is self-contained and prints its own output.

#	Section	Introduced
1	Error Handling — begin / rescue / ensure	v1.0
2	Nil Safety — &. operator	v1.7
3	String Templates — template()	v1.7
4	File System — file_mkdir, dir_list, file_copy	v1.7
5	Regex — matches, match_all, sub, gsub, =~	v1.0
6	File I/O — file_read, file_write, file_lines, file_append	v1.0
7	Collections & Iterators — select, reject, map, reduce, each_with_object	v1.1
8	Compound Assignment — +=, -=, *=, //=, **=	v1.6
9	R-style Statistics — mean, stdev, median, pipe \|>	v1.0
10	JSON & CSV	v1.3
11	SQLite Database	v1.2
12	DateTime	v1.3
13	Randomness — rand_int, shuffle, sample	v1.5
14	Constants & Loop Control — next, break, break value	v1.5
15	Mini Log Analyser — a real-world composition	v1.0
16	Lambdas — ->(x) { }, .call, higher-order functions	v1.8
17	Hash Merge Operator \|	v1.8
18	group_by	v1.8
19	each_slice and each_cons	v1.8
20	Record Types — record Point(x, y)	v1.9
21	Hash .dig — safe deep access	v1.9
22	zip() — pair two vectors	v1.9
23	frankiec fmt and frankiec docs	v1.9
24	String & Vector * repetition	v1.10
25	Heredoc <<~TEXT	v1.10
26	times() standalone + flatten(depth) + map_with_index + pp	v1.10
27	encode / decode	v1.10
28	Implicit Return	v1.11
29	String .replace()	v1.11
30	String .format(hash)	v1.11
31	.zip_with — pair-wise transform	v1.11
32	Multiple Return Values	v1.11
33	String .gsub with Block	v1.12
34	Hash .map_hash	v1.12
35	round(x, n)	v1.12
36	Vector .product(other)	v1.12
37	String .chars	v1.12
38	rescue FileNotFoundError from file I/O	v1.12

---

A Taste

Here is a small excerpt from sections 7, 9, and 16 to show the feel:

# ── 7. Collections & Iterators ──
data = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

evens = data.select do |x| x % 2 == 0 end
puts evens   # [2, 4, 6, 8, 10]

squared = data.map do |x| x * x end
puts squared   # [1, 4, 9, 16, 25, 36, 49, 64, 81, 100]

total = data.reduce(0) do |acc, x| acc + x end
puts total   # 55

# ── 9. R-style Statistics ──
nums = [23, 45, 12, 67, 34, 89, 56]
puts mean(nums)      # 46.57...
puts stdev(nums)     # 24.99...
puts median(nums)    # 45
nums |> sum |> puts  # 326

# ── 16. Lambdas ──
double = ->(x) { x * 2 }
add    = ->(a, b) { a + b }
puts double.call(5)    # 10
puts add.call(3, 4)    # 7

def apply(fn, val)
  fn.call(val)
end
puts apply(double, 9)  # 18

---

Running Specific Sections

The showcase runs from top to bottom as a single program. To run just one section, copy the relevant lines into a new file or into the REPL:

frankiec repl

Then paste any section and press Enter.