rqrcode.cr

A 1:1 Crystal port of whitesmith/rqrcode 2.2.0 (+ the core of rqrcode_core 1.2.0) — QR code encoding and rendering to HTML/ANSI/SVG/PNG. Suite: 83 examples, 0 failures; the oracle replays matrices, errors and render output recorded from the real gems, 1:1.

Installation

dependencies:
  rqrcode_cr:
    github: OrelSokolov/rqrcode.cr

shards install

No external dependencies (the PNG renderer replaces chunky_png, see below).

Usage

require "rqrcode_cr"

qr = RQRCode::QRCode.new("https://example.com")

qr.as_html
qr.as_ansi(dark: "█", light: " ")
qr.as_svg(module_size: 6, use_path: true)
qr.as_png(size: 240, border_modules: 4)  # => PNG blob
qr.checked?(0, 0)
qr.modules

# multi-segment input
core = RQRCodeCore::QRCode.new([
  {data: "123", mode: :number},
  {data: "abc", mode: :byte_8bit},
])

Feature comparison vs rqrcode 2.2.0 / rqrcode_core 1.2.0

Encoding (rqrcode_core)

Rendering (rqrcode)

Quirks preserved intentionally (oracle-confirmed)

• as_png(..., border:) is effectively ignored (border_modules wins).
• Integer division in demerit_points_4.
• get_mask compares > instead of >=.

Deviations & Crystal-specific notes

• Options are named arguments instead of Ruby trailing-hash (extract_options! → def to_s(dark = "x", ...)); as_png keeps **options because the "passed or not" distinction selects the sizing algorithm.
• Int#between? is a monkeypatch (Ruby builtin, absent from the Crystal stdlib).
• The unreachable :mode_multi branch of QRSegment in the writer is omitted.

PNG without chunky_png

RQRCode::Export::PNG::Image is a minimal chunky_png replacement: an RGBA canvas with new/[]=/save/to_s/resize/width/height. Resize is an exact port of chunky_png's resample_nearest_neighbor (Bresenham error accumulation, not floor scaling). The encoder writes 8-bit grayscale (chunky_png writes 1-bit — files are larger but valid, verified with the ChunkyPNG decoder). CRC32 is a built-in table (not exported by the Crystal stdlib).

Testing

ruby oracle/cases.rb > oracle/expected.yml   # re-record against the real gems
crystal spec                                  # 83 examples

• spec/oracle_spec.cr — 57 cases recorded from the real gems: matrices (v1–v40, all L/M/Q/H levels, all modes, multi-segment, UTF-8), errors (class + message), HTML/ANSI/SVG (rect + path)/PNG (pixel geometry of both sizing algorithms + resize).
• spec/rqrcode_spec.cr — 26 unit tests on the API (QRMath, QRUtil, RS blocks, QRSegment, buffer, renderers), ported from README/API scenarios (the originals ship no test files in the gem package).