tessella 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ce17185ecd27997f771fd86221023064a69a3e971f552b8c7c91b4c6e40f526
-  data.tar.gz: 7e18eafac46af4fda371abe27c1e0f2d0ebf617380e6a0b7a6fb9fb2c8c4ef75
+  metadata.gz: 1d193803deddaeae8e0bc86469a9e041a9e03b90a13da001d17d26f3a5b90be3
+  data.tar.gz: 016f01a20153c54d3856f007483d341d5f4ba1ede0b6c058821c035677556cb5
 SHA512:
-  metadata.gz: 1a5b056fba4777b82cb7083f35f31587b29ad3d9d5a0eced8c978708afe47a3fcf27b413fd0aa3dea0a3c7d4213541b3b5c2fdd09e7ebac09cf5d0e26f942606
-  data.tar.gz: 852fd9065708c73371b95226b9a3f11803df800c144ff7200d6a799b176e77b76a007a88a903fa621e990f43978e0a323945eb37a693d3cff87e853f3570861a
+  metadata.gz: 83e1a6f644364f63241cdc2d6150da86d6fd08355f4916f15a48fed9257e605d0c91829cbc7528377604b17dd81b5e061ea421b9bf79654ef04167d3a9993cff
+  data.tar.gz: db56487e22198b30f470967f937098e249e8b6b641496bf57a94ae97a58b3cfd45d56e417a2b0de4aa2bf22858cd0f3d957969a355d668a975a0351d953e24c6

data/README.md

@@ -25,14 +25,14 @@ decisions behind them.
 
 ## Install
 
-tessella is not on rubygems.org, and it has no public remote. Install
-it from a checkout of this repository:
+tessella is on [rubygems.org](https://rubygems.org/gems/tessella):
 
 ```bash
-cd tessella
-make install
+gem install tessella
 ```
 
+From a checkout of this repository
+([github.com/sdalu/tessella](https://github.com/sdalu/tessella)),
 `make install` builds the gem and installs it for this user (`gem
 install --user-install --local`). `make uninstall` removes it again.
 Running `exe/tessella` directly out of a checkout, without installing,

data/doc/getting-started.md

@@ -2,13 +2,13 @@
 
 ## Install
 
-tessella is not on rubygems.org. Install it from a checkout:
-
 ```sh
-cd tessella
-make install      # builds the gem, installs it for this user
+gem install tessella
 ```
 
+Or from a checkout of
+[github.com/sdalu/tessella](https://github.com/sdalu/tessella):
+`make install` builds the gem and installs it for this user, and
 `make uninstall` removes it. Without installing, `exe/tessella` runs
 straight out of the checkout, and `ruby -I lib` finds the library.
 It needs Ruby 3.4 and nothing else.

data/doc/seq.md

@@ -29,7 +29,9 @@ One statement per line; blank lines and `#` comments are skipped.
 A name is a run of letters, digits, `_`, `.` or `-`, not ending in
 `-`, so `A-->B` reads as a reply with or without blanks. Participants
 take their columns in the order they are declared, or first appear;
-columns widen to fit every label, never truncating one.
+columns widen to fit every label, never truncating one. A message
+that skips participants carries its label in the gap beside its
+sender, so the label never covers a lifeline the arrow passes.
 
 ```text
 $ cat login.txt
@@ -64,9 +66,9 @@ $ tessella seq login.txt
      │              │  │ check hash  │
      │              │◄─┘             │
      │              │                │
-     │              ┌────────────────┐
+     │              ├────────────────┤
      │              │bcrypt, cost 12 │
-     │              └────────────────┘
+     │              ├────────────────┤
      │              │                │
      │              │  log attempt   │
      │              │──────────────►►│
@@ -109,9 +111,9 @@ $ tessella seq --numbered --footer login.txt
      │                 │  │ 4. check hash  │
      │                 │◄─┘                │
      │                 │                   │
-     │                 ┌───────────────────┐
+     │                 ├───────────────────┤
      │                 │  bcrypt, cost 12  │
-     │                 └───────────────────┘
+     │                 ├───────────────────┤
      │                 │                   │
      │                 │  5. log attempt   │
      │                 │─────────────────►►│

data/lib/tessella/seq.rb

@@ -28,9 +28,9 @@ module Tessella
                     \s*:\s*(.*)\z/x
 
         UNI_G = { h: "─", v: "│", tl: "┌", tr: "┐", bl: "└", br: "┘",
-                  td: "┬", tu: "┴", dash: "┄" }.freeze
+                  td: "┬", tu: "┴", tr_: "├", tl_: "┤", dash: "┄" }.freeze
         ASC_G = { h: "-", v: "|", tl: "+", tr: "+", bl: "+", br: "+",
-                  td: "+", tu: "+", dash: "-" }.freeze
+                  td: "+", tu: "+", tr_: "+", tl_: "+", dash: "-" }.freeze
 
         def self.bad!(lineno, msg)
             raise ArgumentError, "line #{lineno}: #{msg}"
@@ -228,11 +228,16 @@ module Tessella
             label = label_text(stmt)
             return grow_right!(state, i, self_loop_need(label)) if i == j
 
-            lo, hi = [i, j].minmax
+            seg = label_gap(i, j)
             required = Width.of(label) + 2
-            ensure_width!(state, lo, hi, required, -1)
+            ensure_width!(state, seg, seg + 1, required, -1)
         end
 
+        # The gap a message's label sits in: the one beside its
+        # sender, so a message that skips participants never writes
+        # its label over a lifeline it passes.
+        def self.label_gap(from, to) = from < to ? from : from - 1
+
         def self.widen_note!(state, participants, stmt)
             idx = stmt[:names].map { participants.index(it) }.sort
             if idx.size == 1
@@ -374,7 +379,7 @@ module Tessella
         end
 
         def self.arrow_rows(lay, spec, label, style)
-            lo, hi = spec.values_at(:lo, :hi)
+            lo, hi = spec[:label]
             lr = lifeline_row(lay, style)
             interior = hi - lo - 1
             start = lo + 1 + centered_start(interior, Width.of(label))
@@ -435,12 +440,36 @@ module Tessella
             span_note(idx.first, idx.last, positions)
         end
 
+        # A note's box drawn over the lifelines: where a lifeline
+        # meets its top or bottom edge, the edge takes a junction
+        # (├ ┤ at a corner, ┴ ┬ along an edge), so the lifeline
+        # ends and resumes at a stroke rather than butting a plain
+        # corner or edge.
         def self.overlay_rows(lay, style, rows, left)
             canvas = rows.map { lifeline_row(lay, style) }
             rows.each_with_index { |s, r| place!(canvas[r], left, s) }
+            join_lifelines!(canvas, lay, note_joints(style))
             canvas.map(&:join)
         end
 
+        def self.join_lifelines!(canvas, lay, joints)
+            lay[:positions].each do |p|
+                junction!(canvas.first, p[:center], joints[:top])
+                junction!(canvas.last, p[:center], joints[:bottom])
+            end
+        end
+
+        def self.note_joints(style)
+            { top: { style[:tl] => style[:tr_], style[:tr] => style[:tl_],
+                     style[:h] => style[:tu] },
+              bottom: { style[:bl] => style[:tr_], style[:br] => style[:tl_],
+                        style[:h] => style[:td] } }
+        end
+
+        def self.junction!(row, col, joints)
+            row[col] = joints.fetch(row[col], row[col])
+        end
+
         def self.note_rows(stmt, lay, participants, style)
             idx = stmt[:names].map { participants.index(it) }.sort
             spot = note_spot(idx, lay[:positions], stmt[:text])
@@ -461,8 +490,10 @@ module Tessella
             lo, hi = idx_pair.minmax
             dir = i < j ? :right : :left
             pos = lay[:positions]
+            seg = label_gap(i, j)
             spec = { lo: pos[lo][:center], hi: pos[hi][:center],
-                     kind: kind, dir: dir }
+                     kind: kind, dir: dir,
+                     label: [pos[seg][:center], pos[seg + 1][:center]] }
             arrow_rows(lay, spec, label, style)
         end
 

data/lib/tessella/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tessella
-    VERSION = "0.3.0"
+    VERSION = "0.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tessella
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Stephane D'Alu
@@ -9,8 +9,10 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: Line, scatter, stairs, bar, histogram, box, stem and density plots with
-  scaled axes, drawn in braille, block, dot or ASCII cells. No runtime dependency.
+description: Charts (line, scatter, bar, histogram, box, stem, density) on braille,
+  block or ASCII canvases, trees, tables, bit-field, timing and sequence diagrams,
+  meters and sparklines, composed side by side or framed, and a lint for text figures
+  in documents. No runtime dependency.
 executables:
 - tessella
 extensions: []
@@ -202,10 +204,15 @@ files:
 - lib/tessella/width_class.rb
 - lib/tessella/width_invisible.rb
 - lib/tessella/width_invisible_high.rb
+homepage: https://github.com/sdalu/tessella
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/sdalu/tessella
+  documentation_uri: https://github.com/sdalu/tessella/blob/main/doc/README.md
+  changelog_uri: https://github.com/sdalu/tessella/releases
+  bug_tracker_uri: https://github.com/sdalu/tessella/issues
 rdoc_options: []
 require_paths:
 - lib
@@ -222,5 +229,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.21
 specification_version: 4
-summary: Charts for a monospace grid, in Unicode or pure ASCII
+summary: Text figures for a monospace grid, in Unicode or pure ASCII
 test_files: []