zpl_render 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05e06eca743b13623cd089ca67956463df7ddeccba669ac184028669a1df1367
-  data.tar.gz: d30efa23e8265c64b11a3586cbb547f3dfe57e526eb1dfdaa277f127d65c7942
+  metadata.gz: 35e8a77278d37facd472debd3fbf7183523bd2f6405d63e164a1e8082e1c3a8e
+  data.tar.gz: 1d4dc9f4bc62465b679dfe571d5ad0cc07014e0f29ce2efe4ea5527983c3e134
 SHA512:
-  metadata.gz: 8a2deff01c66b826be88bb43a2fafc457a735911b530b91b3523c349d1b85881947f46afc10807053fb8cdf3bc61c6f9df945d7798c49ef53946ea1a5183bf02
-  data.tar.gz: 0c26655758c3d6e790ad68b886e53c5a3932fe295391108bd6e6d7a7bddd5abb5140a899738e2822fbb3ab57a8f023f911f25809f917750aaa5878da9d498ada
+  metadata.gz: 35f48bba0d33863848b0296d4a3add758d8e8882f931bec640c55eef956a729ee8834ef327301b1b377134fd90c0d25f3e15d29df064446aef583d50c19e6eca
+  data.tar.gz: '09bd166c9440ff3cbfe1c0abb21a0583e494fd741eafd7e4db18cd5de3a44d84ec29b0c8d9598574fb6426db9672e5c5090f6364f7f6527e15e44c19dd8a1814'

data/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-07-31
+
+### Added
+
+- Base64-encoded ZPL input: pass `base64: true` to `render` / `to_png` /
+  `to_pngs` / `to_pdf` (CLI: `--base64`) to decode the payload before
+  rendering, for labels stored base64-encoded in databases or WMS
+  exports. Accepts standard and URL-safe alphabets, tolerates
+  whitespace/newlines and missing padding, and raises `ZplRender::Error`
+  for invalid input. `ZplRender.decode_base64` is public for recovering
+  the raw `.zpl`.
+
+### Fixed
+
+- The release workflow's rubygems.org publish step is idempotent: it
+  skips when the version already exists instead of failing.
+
 ## [0.1.0] - 2026-07-31
 
 Initial release.
@@ -45,5 +62,6 @@ Initial release.
 - CI matrix for Ruby 3.0-3.4 (GitHub Actions and GitLab CI) with real
   scanner round-trip verification.
 
-[Unreleased]: https://github.com/wqsaali/zpl_render/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/wqsaali/zpl_render/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/wqsaali/zpl_render/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/wqsaali/zpl_render/releases/tag/v0.1.0

data/README.md

@@ -42,6 +42,11 @@ ZplRender.to_png(zpl, warnings: warnings)
 
 # Strict mode: raise on the first problem instead of warning
 ZplRender.to_png(zpl, strict: true)
+
+# Base64-encoded ZPL (e.g. from a database column or WMS export):
+# decoded automatically before rendering
+ZplRender.to_png(b64_payload, base64: true)
+zpl = ZplRender.decode_base64(b64_payload) # or recover the raw .zpl
 ```
 
 ## Errors
@@ -61,6 +66,7 @@ silently drop label content.
 zpl_render label.zpl -o label.png          # PNG at 203 dpi, 4x6"
 zpl_render label.zpl -o label.pdf -d 12    # PDF at 300 dpi
 cat label.zpl | zpl_render -o out.png -W 4 -H 2
+zpl_render --base64 label.b64 -o label.png # Base64-encoded ZPL input
 ```
 
 ## Barcode accuracy

data/exe/zpl_render

@@ -20,6 +20,7 @@ parser = OptionParser.new do |opts|
   opts.on("-H", "--height INCHES", Float, "Label height in inches (default 6)") { |v| options[:height] = v }
   opts.on("-s", "--scale N", Integer, "Integer upscale for PNG output (default 1)") { |v| options[:scale] = v }
   opts.on("--strict", "Fail on the first problem instead of warning") { options[:strict] = true }
+  opts.on("-b", "--base64", "Input is Base64-encoded ZPL") { options[:base64] = true }
   opts.on("-q", "--quiet", "Suppress warnings") { options[:quiet] = true }
   opts.on("-v", "--version", "Print version") do
     puts ZplRender::VERSION
@@ -41,11 +42,11 @@ begin
   bytes = if File.extname(output).casecmp(".pdf").zero?
             ZplRender.to_pdf(zpl, dpmm: options[:dpmm], width_in: options[:width],
                                   height_in: options[:height], strict: options[:strict],
-                                  warnings: warnings)
+                                  base64: options[:base64], warnings: warnings)
           else
             ZplRender.to_png(zpl, dpmm: options[:dpmm], width_in: options[:width],
                                   height_in: options[:height], scale: options[:scale],
-                                  strict: options[:strict], warnings: warnings)
+                                  strict: options[:strict], base64: options[:base64], warnings: warnings)
           end
 rescue ZplRender::Error => e
   warn "error: #{e.message}"

data/lib/zpl_render/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ZplRender
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/zpl_render.rb

@@ -34,36 +34,64 @@ module ZplRender
 
   module_function
 
+  # Decode a Base64-encoded ZPL payload into the ZPL string. Accepts the
+  # standard and URL-safe alphabets, tolerates whitespace/newlines and
+  # missing padding, and raises ZplRender::Error when the input is not
+  # base64 or does not decode to ZPL. Useful when labels are stored
+  # base64-encoded (WMS exports, database columns, API payloads).
+  def decode_base64(data)
+    raise Error, "base64 input must be a String (got #{data.class})" unless data.respond_to?(:to_str)
+
+    compact = data.to_str.gsub(/\s+/, "").tr("-_", "+/")
+    compact += "=" * ((4 - compact.length % 4) % 4)
+    unless !compact.empty? && compact.match?(%r{\A[A-Za-z0-9+/]+={0,2}\z}) && (compact.length % 4).zero?
+      raise Error, "input is not valid base64"
+    end
+
+    zpl = begin
+      compact.unpack1("m0")
+    rescue ArgumentError => e
+      raise Error, "input is not valid base64: #{e.message}"
+    end
+    zpl.force_encoding(Encoding::UTF_8)
+    zpl.force_encoding(Encoding::BINARY) unless zpl.valid_encoding?
+    raise Error, "decoded base64 does not contain any ZPL commands" unless zpl.match?(/[\^~]/)
+
+    zpl
+  end
+
   # Render every ^XA..^XZ format to a Canvas (dot matrix).
-  def render(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, strict: false, warnings: nil)
+  # Pass base64: true when +zpl+ is a Base64-encoded ZPL payload.
+  def render(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, strict: false, base64: false, warnings: nil)
     raise Error, "zpl must be a String (got #{zpl.class})" unless zpl.respond_to?(:to_str)
 
+    zpl = base64 ? decode_base64(zpl) : zpl.to_str
     renderer = Renderer.new(dpmm: dpmm, width_in: width_in, height_in: height_in, strict: strict)
-    labels = renderer.render(zpl.to_str)
+    labels = renderer.render(zpl)
     warnings.concat(renderer.warnings) if warnings
     labels
   end
 
   # PNG bytes for the first label.
-  def to_png(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, scale: 1, strict: false, warnings: nil)
+  def to_png(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, scale: 1, strict: false, base64: false, warnings: nil)
     labels = render(zpl, dpmm: dpmm, width_in: width_in, height_in: height_in,
-                         strict: strict, warnings: warnings)
+                         strict: strict, base64: base64, warnings: warnings)
     raise Error, "no ^XA..^XZ label formats found" if labels.empty?
 
     Output::Png.encode(labels.first, scale: scale)
   end
 
   # PNG bytes for every label.
-  def to_pngs(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, scale: 1, strict: false, warnings: nil)
+  def to_pngs(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, scale: 1, strict: false, base64: false, warnings: nil)
     render(zpl, dpmm: dpmm, width_in: width_in, height_in: height_in,
-                strict: strict, warnings: warnings)
+                strict: strict, base64: base64, warnings: warnings)
       .map { |canvas| Output::Png.encode(canvas, scale: scale) }
   end
 
   # PDF bytes, one page per label, at exact physical size.
-  def to_pdf(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, strict: false, warnings: nil)
+  def to_pdf(zpl, dpmm: 8, width_in: 4.0, height_in: 6.0, strict: false, base64: false, warnings: nil)
     labels = render(zpl, dpmm: dpmm, width_in: width_in, height_in: height_in,
-                         strict: strict, warnings: warnings)
+                         strict: strict, base64: base64, warnings: warnings)
     raise Error, "no ^XA..^XZ label formats found" if labels.empty?
 
     Output::Pdf.encode(labels, dpmm: dpmm)

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: zpl_render
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Waqas Ali
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
 date: 2026-07-31 00:00:00.000000000 Z
@@ -105,7 +105,7 @@ metadata:
   source_code_uri: https://github.com/wqsaali/zpl_render
   bug_tracker_uri: https://github.com/wqsaali/zpl_render/issues
   changelog_uri: https://github.com/wqsaali/zpl_render/blob/main/CHANGELOG.md
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -120,8 +120,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 3.4.19
+signing_key: 
 specification_version: 4
 summary: Render ZPL II label programs to PNG and PDF, with scanner-accurate barcodes.
 test_files: []