Class: Ucode::Glyphs::LastResort::Writer

Inherits:
Object
  • Object
show all
Includes:
Repo::AtomicWrites
Defined in:
lib/ucode/glyphs/last_resort/writer.rb

Overview

Writes one glyph.svg per codepoint in codepoints, sourcing the outline from the Last Resort UFO.

Single Renderer instance shared across the loop, so the parsed cmap and contents.plist are paid for once.

Idempotent: re-runs are no-ops via Repo::AtomicWrites (byte comparison; same content is skipped). Safe to re-run on the whole output tree.

Atomic: writes go through <path>.tmp + rename. A crash mid-write leaves either the old file or no file.

Block membership is the caller's responsibility — the Writer doesn't gate codepoints by assigned/unassigned. Last Resort placeholders exist for every codepoint in the cmap, including assigned ones, but the v0.2 pipeline only writes Last Resort SVGs for codepoints whose chart cell shows a placeholder box (see README "two pillars").

Instance Method Summary collapse

Methods included from Repo::AtomicWrites

#same_content?, #to_pretty_json, #write_atomic

Constructor Details

#initialize(output_root:, source:) ⇒ Writer

Returns a new instance of Writer.

Parameters:

  • output_root (String, Pathname)
  • source (Source) 


37
38
39
40
41
 
# File 'lib/ucode/glyphs/last_resort/writer.rb', line 37

def initialize(output_root:, source:)
  @output_root = Pathname.new(output_root)
  @source = source
  @renderer = Renderer.new(source)
end

Instance Method Details

#write_many(codepoints, block_lookup:) ⇒ Hash

Write glyph.svg for every codepoint in codepoints whose block is known, using the Last Resort outline.

Parameters:

  • codepoints (Array<Integer>, Enumerable<Integer>)
  • block_lookup (Proc, #call) —

    codepoint → block id string (e.g. "Basic_Latin"). Returns nil for codepoints without a block; those are skipped.

Returns:

  • (Hash) —

    tally { written:, skipped:, missing:, total: }



51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/ucode/glyphs/last_resort/writer.rb', line 51

def write_many(codepoints, block_lookup:)
  tally = { written: 0, skipped: 0, missing: 0, total: 0 }
  codepoints.each do |cp|
    tally[:total] += 1
    block_id = block_lookup.call(cp)
    if block_id.nil?
      tally[:missing] += 1
      next
    end

    result = @renderer.render(cp)
    if result.nil? || !result.ok?
      tally[:missing] += 1
      next
    end

    written = write_glyph(block_id, cp, result.svg)
    tally[written ? :written : :skipped] += 1
  end
  tally
end