tessella 0.3.0

data/examples/gradient.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# examples/gradient.rb: a Raster built in Ruby -- no image file --
+# drawn in three styles, side by side.
+require "tessella"
+
+w = h = 48
+luma = (0...h).flat_map do |y|
+    (0...w).map { |x| Math.hypot(x - 24, y - 24) < 22 ? x / 47.0 : 0 }
+end
+raster = Tessella::Raster.new(width: w, height: h, luma: luma)
+figs = %i[ramp blocks quadrant].map do |style|
+    Tessella.caption(Tessella.image(raster, style: style, width: 16),
+                     text: style.to_s)
+end
+puts Tessella.beside(*figs, gap: 3)

data/examples/growth.txt

@@ -0,0 +1,6 @@
+n t
+1 0.69
+10 2.40
+100 4.62
+1000 6.91
+10000 9.21

data/examples/hosts.csv

@@ -0,0 +1,4 @@
+host,cpu,io,net
+web,40,15,20
+db,25,50,5
+cache,10,5,30

data/examples/icmp.txt

@@ -0,0 +1,3 @@
+Type:8
+Code:8
+Checksum:16

data/examples/ipv4.txt

@@ -0,0 +1,12 @@
+Version:4
+IHL:4
+DSCP:6
+ECN:2
+Total Length:16
+Identification:16
+Flags:3
+Fragment Offset:13
+TTL:8
+Protocol:8
+Header Checksum:16
+Source Address:32

data/examples/kinds.csv

@@ -0,0 +1,4 @@
+kind,canvas,notes
+line,braille,"joins points, one series per column"
+bar,none,"negative values split at zero"
+stem,none,"back-to-back with two columns"

data/examples/langs.csv

@@ -0,0 +1,4 @@
+lang,loc
+ruby,12
+c,30
+rust,7.5

data/examples/lint.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# examples/lint.rb: the lint from Ruby -- a figure tessella draws is
+# clean by construction; a hand-drawn one is reported line by line,
+# and the rulers show where its verticals stopped agreeing.
+require "tessella"
+
+chart = Tessella.bar(%w[ruby c rust], [12, 30, 7.5], width: 30)
+puts "chart: #{Tessella.lint(chart.to_s, geometry: true).clean?}"
+
+report = Tessella.lint(File.read("broken.txt"), geometry: true)
+report.findings.each { puts "broken.txt:#{it.line}: #{it.message}" }
+
+Tessella.lint(File.read("table-drift.txt")).rulers.each do |r|
+    puts "line #{r.line}: verticals #{r.verticals.inspect}"
+end

data/examples/load.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# examples/load.rb: a bar chart and a table side by side, framed and
+# captioned -- composition of any two figures.
+require "tessella"
+
+rows = Tessella::Table.parse(File.read("langs.csv"))
+labels = rows.drop(1).map(&:first)
+values = rows.drop(1).map { Integer(it[1], exception: false) || it[1].to_f }
+plot = Tessella.bar(labels, values, width: 20)
+table = Tessella.table(rows, style: :rounded)
+fig = Tessella.beside(plot, table, gap: 2, align: :middle)
+puts Tessella.caption(Tessella.frame(fig, title: "Load"),
+                      text: "Figure 1: lines of code, in thousands")

data/examples/login.txt

@@ -0,0 +1,10 @@
+participant Browser
+participant Server
+participant DB
+Browser -> Server: POST /login
+Server -> DB: SELECT user
+DB --> Server: row
+Server -> Server: check hash
+note over Server,DB: bcrypt, cost 12
+Server ->> DB: log attempt
+Server --> Browser: 200 + cookie

data/examples/neg.csv

@@ -0,0 +1,4 @@
+delta,v
+a,-6
+b,3
+c,0

data/examples/normal.txt

@@ -0,0 +1,200 @@
+0.359
+-0.404
+0.202
+0.263
+-0.634
+1.031
+-1.092
+1.528
+0.897
+-0.984
+0.266
+-0.215
+-2.427
+2.111
+-2.14
+-0.896
+0.517
+1.054
+-0.446
+0.403
+0.759
+-0.049
+-0.363
+0.354
+-2.747
+0.946
+0.731
+-0.633
+0.047
+0.123
+-0.239
+-0.412
+1.426
+0.975
+0.171
+2.28
+-0.604
+-0.104
+0.606
+-2.56
+0.775
+0.97
+-0.471
+1.004
+-0.514
+-0.57
+-1.967
+-1.14
+0.752
+-0.573
+-0.364
+0.125
+0.311
+-1.164
+-0.211
+-0.678
+-1.011
+1.042
+-0.279
+-0.524
+-0.513
+1.118
+-0.504
+0.607
+-0.381
+1.137
+0.319
+-0.507
+1.723
+0.481
+-1.187
+-0.212
+-0.275
+0.271
+-0.628
+0.505
+0.096
+-1.14
+0.001
+0.374
+1.142
+-0.223
+-0.851
+-0.753
+-0.116
+0.144
+-0.204
+-0.781
+-0.957
+0.337
+0.992
+0.496
+-2.77
+0.113
+-1.416
+0.44
+0.136
+-1.38
+1.337
+0.385
+1.06
+1.493
+0.917
+-1.842
+-0.018
+-0.744
+-0.748
+-1.115
+1.359
+0.917
+-1.422
+-1.406
+-1.274
+-0.047
+0.089
+-1.385
+-0.118
+-0.489
+1.294
+-1.361
+0.587
+0.934
+1.386
+0.721
+-0.713
+-0.631
+0.519
+-0.866
+0.138
+-1.498
+1.705
+0.192
+-0.797
+-0.549
+0.717
+0.088
+1.926
+-0.439
+-0.303
+1.604
+-2.083
+0.138
+1.159
+-0.507
+-1.472
+-1.016
+-2.708
+0.768
+-0.029
+0.032
+0.779
+0.175
+1.007
+2.001
+-0.128
+-0.452
+1.958
+-0.383
+1.335
+-1.437
+-1.855
+-1.555
+-0.928
+-0.402
+-1.175
+0.568
+0.596
+0.846
+-1.87
+0.826
+1.457
+-0.204
+-0.857
+1.07
+-0.845
+-0.752
+-0.336
+1.838
+-0.352
+-0.658
+-0.471
+-0.333
+-1.922
+1.922
+-1.032
+-0.932
+-2.194
+-1.048
+-0.606
+0.345
+0.521
+-0.633
+-0.633
+0.401
+-0.406
+-1.679
+0.058
+-0.895
+1.116
+-0.543

data/examples/note.txt

@@ -0,0 +1,2 @@
+ruby is 12 kLOC
+c is the bulk

data/examples/notes-fixed.md

@@ -0,0 +1,17 @@
+# Notes
+
+| kind | canvas |
+|------|--------|
+| line | braille |
+
+The pipeline, redrawn for the web:
+
+```text
+┌───────┐     ┌───────┐
+│ parse │────▸│ draw  │
+└───────┘     └───┬───┘
+                  │
+              ┌───┴───┐
+              │ print │
+              └───────┘
+```

data/examples/notes.md

@@ -0,0 +1,17 @@
+# Notes
+
+| kind | canvas |
+|------|--------|
+| line | braille |
+
+The pipeline, as drawn by hand:
+
+```text
+┌───────┐     ┌───────┐
+│ parse │────▶│ draw  │
+└───────┘     └───┬───┘
+                   │
+               ┌───┴───┐
+               │ print │
+               └───────┘
+```

data/examples/ohlc.txt

@@ -0,0 +1,7 @@
+date open high low close
+2026-11-02 100 104 98 103
+2026-11-03 103 107 101 102
+2026-11-04 102 103 95 96
+2026-11-05 96 99 94 98
+2026-11-06 98 105 97 104
+2026-11-09 104 106 102 104

data/examples/os.csv

@@ -0,0 +1,10 @@
+os,share
+linux,41
+macos,22
+windows,18
+freebsd,9
+openbsd,4
+netbsd,2
+haiku,2
+plan9,1
+qnx,1

data/examples/outline.txt

@@ -0,0 +1,8 @@
+tessella
+  lib            # the library
+    tessella.rb  # the entry
+    tessella
+      cli
+  exe
+    tessella     # the command
+  test

data/examples/plot.txt

@@ -0,0 +1,5 @@
+        ┌                    ┐
+   ruby ┤██████▍········· 12
+      c ┤████████████████ 30
+   rust ┤████············ 7.5
+        └                    ┘

data/examples/refusals.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# examples/refusals.rb: what the library refuses, and how it says so.
+require "tessella"
+
+[
+    -> { Tessella.line([1, 2, 3], [1, 2]) },
+    -> { Tessella.bar(%w[a b], [1, Float::NAN]) },
+    -> { Tessella.line([1, 2], width: 0) },
+    -> { Tessella.line([1, 2], colour: true) },
+    -> { Tessella.tree("a\n   b\n  c") },
+    -> { Tessella.frame("é", ascii: true) }
+].each do |call|
+    call.call
+rescue ArgumentError => e
+    puts "#{e.class}: #{e.message}"
+end

data/examples/report.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+# examples/report.sh -- a chart and a table drawn from one CSV, set
+# side by side, framed and captioned: compose reads one block from
+# stdin, so the others go through a temp directory.
+# usage: sh report.sh [file.csv]   (default langs.csv)
+set -eu
+
+cd -- "$(dirname -- "$0")" || exit 1
+csv=${1:-langs.csv}
+
+tmpdir=
+cleanup() { [ -z "$tmpdir" ] || rm -rf -- "$tmpdir"; }
+trap cleanup EXIT INT HUP TERM
+tmpdir=$(mktemp -d "${TMPDIR:-/tmp}/report.XXXXXX") || exit 1
+
+tessella chart --kind bar --width 20 -- "$csv" > "$tmpdir/chart"
+tessella table --style rounded -- "$csv" > "$tmpdir/table"
+tessella compose beside --gap 2 --align middle \
+    "$tmpdir/chart" "$tmpdir/table" |
+    tessella compose frame --title Load - |
+    tessella compose caption --text "Source: $csv" -

data/examples/rfc.sh

@@ -0,0 +1,22 @@
+#!/bin/sh
+# examples/rfc.sh -- an RFC-style section: a message exchange and the
+# header it carries, both ASCII, stacked under a rule and indented
+# three columns, as an RFC sets its figures.
+# usage: sh rfc.sh
+set -eu
+
+cd -- "$(dirname -- "$0")" || exit 1
+
+tmpdir=
+cleanup() { [ -z "$tmpdir" ] || rm -rf -- "$tmpdir"; }
+trap cleanup EXIT INT HUP TERM
+tmpdir=$(mktemp -d "${TMPDIR:-/tmp}/rfc.XXXXXX") || exit 1
+
+printf 'Client -> Server: Echo Request\nServer --> Client: Echo Reply\n' |
+    tessella seq --ascii > "$tmpdir/seq"
+tessella bitfield icmp.txt |
+    tessella compose caption --ascii --text 'Figure 1: ICMP header' - \
+    > "$tmpdir/header"
+tessella compose stack --ascii --gap 1 --rule '-' --center \
+    "$tmpdir/seq" "$tmpdir/header" |
+    tessella compose indent --ascii --prefix '   ' --max-width 72 -

data/examples/samples.txt

@@ -0,0 +1,7 @@
+a b c
+1 2 3
+2 4 5
+3 4 6
+4 5 6
+5 9 7
+2 3 30

data/examples/sizes.tsv

@@ -0,0 +1,3 @@
+name	size
+lib	7876
+test	5120

data/examples/spi.txt

@@ -0,0 +1,6 @@
+clk:  p.......
+cs:   10.....1
+mosi: x=.=.=.x | A0 D0 D1
+miso: z..=.=.z | R0 R1
+---
+irq:  0....1.0

data/examples/status.sh

@@ -0,0 +1,23 @@
+#!/bin/sh
+# examples/status.sh -- telling bad data (exit 1) from a bad call
+# (exit 2) in a script: draw what can be drawn, report the rest.
+# usage: sh status.sh
+set -eu
+
+cd -- "$(dirname -- "$0")" || exit 1
+
+draw() {
+    # shellcheck disable=SC3043 # local: every target sh has it
+    local status
+    status=0
+    tessella chart --kind bar --width 20 "$@" 2>/dev/null || status=$?
+    case $status in
+        0) ;;
+        1) printf '%s: bad data, skipped\n' "$*" ;;
+        *) printf '%s: bad call (exit %s)\n' "$*" "$status" ;;
+    esac
+}
+
+draw langs.csv
+draw bad.csv
+draw --bins 3 langs.csv

data/examples/stem.txt

@@ -0,0 +1,12 @@
+12
+15
+21
+23
+23
+27
+31
+34
+38
+45
+47
+52

data/examples/table-drift.txt

@@ -0,0 +1,4 @@
+┌──┬──┐
+│a │b │
+│c  │d │
+└──┴──┘

data/examples/temps.txt

@@ -0,0 +1,31 @@
+date temp
+2026-10-01 12.0
+2026-10-02 13.5
+2026-10-03 14.9
+2026-10-04 16.1
+2026-10-05 17.0
+2026-10-06 17.7
+2026-10-07 18.0
+2026-10-08 17.9
+2026-10-09 17.5
+2026-10-10 16.7
+2026-10-11 15.6
+2026-10-12 14.3
+2026-10-13 12.8
+2026-10-14 11.4
+2026-10-15 9.9
+2026-10-16 8.6
+2026-10-17 7.5
+2026-10-18 6.6
+2026-10-19 6.1
+2026-10-20 6.0
+2026-10-21 6.2
+2026-10-22 6.8
+2026-10-23 7.8
+2026-10-24 9.0
+2026-10-25 10.3
+2026-10-26 11.8
+2026-10-27 13.3
+2026-10-28 14.7
+2026-10-29 15.9
+2026-10-30 16.9

data/examples/trig.sh

@@ -0,0 +1,13 @@
+#!/bin/sh
+# examples/trig.sh -- data made on the spot by awk, piped straight
+# into a chart: a header row names the two series.
+# usage: sh trig.sh
+set -eu
+
+awk 'BEGIN {
+    print "x sin cos"
+    for (i = 0; i <= 100; i++)
+        printf "%g %g %g\n", i / 10, sin(i / 10), cos(i / 10)
+}' |
+    tessella chart --title trig --xlabel x --width 30 --height 6 \
+        --canvas block

data/examples/trig.txt

@@ -0,0 +1,102 @@
+x sin cos
+0.0 0.0 1.0
+0.1 0.09983341664682815 0.9950041652780258
+0.2 0.19866933079506122 0.9800665778412416
+0.3 0.2955202066613396 0.955336489125606
+0.4 0.3894183423086505 0.9210609940028851
+0.5 0.479425538604203 0.8775825618903728
+0.6 0.5646424733950355 0.8253356149096782
+0.7 0.6442176872376911 0.7648421872844884
+0.8 0.7173560908995228 0.6967067093471654
+0.9 0.7833269096274834 0.6216099682706644
+1.0 0.8414709848078965 0.5403023058681398
+1.1 0.8912073600614354 0.4535961214255773
+1.2 0.9320390859672264 0.3623577544766734
+1.3 0.963558185417193 0.26749882862458735
+1.4 0.9854497299884603 0.16996714290024081
+1.5 0.9974949866040544 0.0707372016677029
+1.6 0.9995736030415051 -0.029199522301288815
+1.7 0.9916648104524686 -0.12884449429552486
+1.8 0.9738476308781951 -0.2272020946930871
+1.9 0.9463000876874145 -0.3232895668635035
+2.0 0.9092974268256817 -0.4161468365471424
+2.1 0.8632093666488737 -0.5048461045998576
+2.2 0.8084964038195901 -0.5885011172553458
+2.3 0.74570521217672 -0.6662760212798244
+2.4 0.6754631805511506 -0.7373937155412458
+2.5 0.5984721441039564 -0.8011436155469337
+2.6 0.5155013718214642 -0.8568887533689473
+2.7 0.4273798802338298 -0.9040721420170612
+2.8 0.33498815015590466 -0.9422223406686583
+2.9 0.23924932921398198 -0.9709581651495907
+3.0 0.1411200080598672 -0.9899924966004454
+3.1 0.04158066243329049 -0.9991351502732795
+3.2 -0.058374143427580086 -0.9982947757947531
+3.3 -0.15774569414324865 -0.9874797699088649
+3.4 -0.25554110202683167 -0.9667981925794609
+3.5 -0.35078322768961984 -0.9364566872907963
+3.6 -0.44252044329485246 -0.896758416334147
+3.7 -0.5298361409084934 -0.848100031710408
+3.8 -0.6118578909427193 -0.7909677119144165
+3.9 -0.6877661591839741 -0.7259323042001399
+4.0 -0.7568024953079282 -0.6536436208636119
+4.1 -0.8182771110644108 -0.5748239465332685
+4.2 -0.8715757724135882 -0.4902608213406994
+4.3 -0.9161659367494549 -0.40079917207997545
+4.4 -0.9516020738895161 -0.30733286997841935
+4.5 -0.977530117665097 -0.2107957994307797
+4.6 -0.9936910036334645 -0.112152526935054
+4.7 -0.9999232575641008 -0.01238866346289056
+4.8 -0.9961646088358406 0.08749898343944727
+4.9 -0.9824526126243325 0.18651236942257576
+5.0 -0.9589242746631385 0.28366218546322625
+5.1 -0.9258146823277321 0.37797774271298107
+5.2 -0.8834546557201531 0.4685166713003771
+5.3 -0.8322674422239008 0.5543743361791615
+5.4 -0.7727644875559871 0.6346928759426347
+5.5 -0.7055403255703919 0.70866977429126
+5.6 -0.6312666378723208 0.7755658785102502
+5.7 -0.5506855425976376 0.8347127848391598
+5.8 -0.4646021794137566 0.8855195169413194
+5.9 -0.373876664830236 0.9274784307440359
+6.0 -0.27941549819892586 0.960170286650366
+6.1 -0.18216250427209502 0.9832684384425847
+6.2 -0.0830894028174964 0.9965420970232175
+6.3 0.0168139004843506 0.9998586363834151
+6.4 0.11654920485049364 0.9931849187581926
+6.5 0.21511998808781552 0.9765876257280235
+6.6 0.3115413635133787 0.9502325919585293
+6.7 0.4048499206165983 0.9143831482353194
+6.8 0.49411335113860894 0.8693974903498248
+6.9 0.5784397643882002 0.8157251001253568
+7.0 0.6569865987187891 0.7539022543433046
+7.1 0.7289690401258765 0.6845466664428059
+7.2 0.7936678638491531 0.6083513145322546
+7.3 0.8504366206285648 0.5260775173811045
+7.4 0.8987080958116269 0.43854732757439036
+7.5 0.9379999767747389 0.3466353178350258
+7.6 0.9679196720314865 0.25125984258225487
+7.7 0.9881682338770004 0.15337386203786435
+7.8 0.998543345374605 0.05395542056264886
+7.9 0.998941341839772 -0.04600212563953695
+8.0 0.9893582466233818 -0.14550003380861354
+8.1 0.9698898108450863 -0.2435441537357911
+8.2 0.9407305566797726 -0.3391548609838362
+8.3 0.9021718337562933 -0.43137684497062084
+8.4 0.8545989080882805 -0.5192886541166856
+8.5 0.7984871126234903 -0.6020119026848236
+8.6 0.7343970978741133 -0.6787200473200125
+8.7 0.662969230082182 -0.7486466455973999
+8.8 0.5849171928917617 -0.811093014061656
+8.9 0.5010208564578846 -0.8654352092411123
+9.0 0.4121184852417566 -0.9111302618846769
+9.1 0.3190983623493521 -0.9477216021311119
+9.2 0.22288991410024592 -0.974843621404164
+9.3 0.1244544235070617 -0.9922253254526034
+9.4 0.024775425453357765 -0.9996930420352065
+9.5 -0.0751511204618093 -0.9971721561963784
+9.6 -0.1743267812229814 -0.9846878557941267
+9.7 -0.2717606264109442 -0.9623648798313097
+9.8 -0.3664791292519284 -0.9304262721047533
+9.9 -0.4575358937753214 -0.8891911526253609
+10.0 -0.5440211108893698 -0.8390715290764524

data/examples/week.txt

@@ -0,0 +1,8 @@
+day 0h 3h 6h 9h 12h 15h 18h 21h
+mon 10 14 18 72 76 63 67 21
+tue 23 10 14 68 72 76 63 17
+wed 19 23 10 64 68 72 76 13
+thu 15 19 23 60 64 68 72 26
+fri 11 15 19 73 60 64 68 22
+sat 0 0 0 39 43 30 34 0
+sun 0 0 0 35 39 43 30 0

data/examples/wide.txt

@@ -0,0 +1,2 @@
+name     size
+日本語   12

data/exe/tessella

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/tessella/cli"
+
+exit Tessella::CLI.run(ARGV, stdin: $stdin, stdout: $stdout, stderr: $stderr)