ruby-zint-es 1.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 92fde3cbd7c7505839dd00d583b3049d6f422da2865930391ecc1b8dda152961
+  data.tar.gz: a27b0d4c92f1b9ebb141e979657d2013e51a8cae39230d3b47fbc79794058ecf
+SHA512:
+  metadata.gz: 6dd2ffece6670eede302bfea50669f9bdd0b493d04dd126adb57fbbfa1cc67091d26484977465ae4cdf9617b6f7ec871cf50f94ff8e82d6008533b3d277e3684
+  data.tar.gz: 492f659304defdd87f05176ebb7da4da01e976474855f542b81942364cb33989267bf50f61dfdcddff69dcf99acd9852b2e611de404269bf8551c48ae4f3a5d1

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.standard.yml

@@ -0,0 +1,5 @@
+parallel: true
+format: progress
+ruby_version: 2.6
+ignore:
+  - 'ext/ruby-zint/tmp/**/*'

data/.yardopts

@@ -0,0 +1,9 @@
+--readme          README.md
+--title           'Ruby FFI binding for libzint'
+--exclude         '/ext.ruby-zint/'
+--no-private
+--charset utf-8
+lib/**/*.rb
+-
+README.md
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,18 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in ruby-zint.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "rspec", "~> 3.0"
+
+gem "simplecov", require: false
+
+gem "chunky_png"
+
+gem "byebug"
+
+gem "standard", "~> 1.3"
+
+gem "mini_portile2"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 Elias Fröhner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,114 @@
+# ruby-zint
+
+[![CI](https://github.com/api-walker/ruby-zint/actions/workflows/main.yml/badge.svg)](https://github.com/api-walker/ruby-zint/actions/workflows/main.yml)
+
+This gem is a Ruby FFI binding for the [libzint](http://www.zint.org.uk) barcode generation library.
+
+See the [documentation](https://rubydoc.info/github/api-walker/ruby-zint) for a full API description.
+
+## Installation
+
+By default ruby-zint first tries to use libzint installed on the system.
+If libzint can't be found or if it isn't a supported version, then the zint version, bundled into the gem, is compiled and used.
+Both install methods can be enforced by using `--enable-system-libzint` or `--disable-system-libzint` options, see below.
+
+### With libzint source code (recommended)
+First install CMake with your package manager (e. g. `apt install cmake`).
+
+Afterwards install the gem and force builtin libzint:
+
+```
+$ gem install ruby-zint -- --disable-system-libzint
+```
+
+### With system libraries
+
+Install the libzint binary with your package manager (e. g. `apt install zint` or perhaps `brew install zint`).
+
+Other platforms require building [from source](https://www.zint.org.uk/manual/chapter/2).
+
+**NOTE:** It is assumed that you are using libzint with the version [2.12](https://sourceforge.net/projects/zint/files/zint/2.12.0/).
+
+Then install this gem and enforce system libzint:
+
+```
+$ gem install ruby-zint -- --enable-system-libzint
+```
+
+### Gemfile
+
+Include `gem "ruby-zint"` in your Gemfile.
+Optionally set the install option by running bundler like so:
+
+```
+bundle config build.ruby-zint --enable-system-libzint
+```
+
+### PNG support
+
+Please install libpng (e. g. `apt install libpng-dev`) before installing the gem if you want to use the PNG format.
+
+## Usage
+
+```ruby
+require "zint"
+
+barcode = Zint::Barcode.new(value: "Test", symbology: Zint::BARCODE_CODE128)
+
+# Export to file
+barcode.to_file(path: "out.png")
+
+# Export file to memory
+barcode.to_memory_file(extension: ".png")
+
+# Write from Bitmap to own canvas
+require "chunky_png"
+png = ChunkyPNG::Image.new(bitmap.width, bitmap.height, ChunkyPNG::Color::TRANSPARENT)
+white = ChunkyPNG::Color("white")
+black = ChunkyPNG::Color("black")
+
+bitmap = barcode.to_bitmap
+bitmap.pixels.each do |pixel|
+  png.compose_pixel(pixel.x, pixel.y, (pixel.colour == "1") ? black : white)
+end
+
+png.save("out.png")
+
+# Use vector export
+vec = Zint::Qr.new(value: "Test").to_vector
+png = ChunkyPNG::Image.new(vec.width.to_i, vec.height.to_i, ChunkyPNG::Color::WHITE)
+vec.each_rectangle do |rec|
+  png.rect(rec.x.to_i, rec.y.to_i,
+      rec.x.to_i+rec.width.to_i-1, rec.y.to_i+rec.height.to_i-1,
+      ChunkyPNG::Color::BLACK, ChunkyPNG::Color::BLACK)
+end
+png.save("out.png")
+
+# See also manual: https://zint.org.uk/manual/chapter/5#buffering-symbols-in-memory-vector
+
+# Use file as input
+barcode = Zint::Barcode.new(input_file: "/tmp/test.txt")
+barcode.to_file(path: "out.png")
+
+# Use of comfort classes
+
+# EAN
+ean_barcode = Zint::Eanx.new(value: "012345678912")
+ean_barcode.to_file(path: "ean.png")
+
+# Code128
+code_128_barcode = Zint::Code128.new(value: "012345678912")
+code_128_barcode.to_file(path: "code_128.png")
+
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/api-walker/ruby-zint.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Credits
+The project is based on the work and ideas of Angel Pizarro's [zint](https://github.com/delagoya/zint). I would also like to say a big thank you to [Lars Kanis](https://github.com/larskanis) for his great contributions.

data/Rakefile

@@ -0,0 +1,20 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require_relative "lib/zint/zint_recipe"
+
+CLOBBER.include "pkg"
+CLEAN.include "ports"
+CLEAN.include "tmp"
+CLEAN.include "ext/ruby-zint/tmp"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+task default: %i[spec standard]
+
+task gem: :build
+task :compile do
+  sh "ruby -C ext/ruby-zint extconf.rb --disable-system-libzint"
+  sh "make -C ext/ruby-zint install RUBYARCHDIR=../../lib"
+end

data/ext/ruby-zint/extconf.rb

@@ -0,0 +1,86 @@
+# #!/usr/bin/env ruby
+
+require "rubygems"
+require "ffi"
+require "fileutils"
+
+if RUBY_PLATFORM.match?(/java/)
+  # JRuby's C extension support is disabled by default, so we can not use it
+
+  # Implement very simple verions of mkmf-helpers used below
+  def enable_config(name, default = nil)
+    if ARGV.include?("--enable-#{name}")
+      true
+    elsif ARGV.include?("--disable-#{name}")
+      false
+    else
+      default
+    end
+  end
+
+  def arg_config(name)
+    ARGV.include?(name)
+  end
+else
+  require "mkmf"
+end
+
+if RUBY_PLATFORM.match?(/darwin/)
+  ENV["SDKROOT"] ||= `xcrun --sdk macosx --show-sdk-path`.chomp
+end
+
+def do_help
+  print <<~HELP
+    usage: ruby #{$0} [options]
+        --enable-system-libzint / --disable-system-libzint
+          Force use of system or builtin libzint library.
+          Default is to prefer system libraries and fallback to builtin.
+  HELP
+  exit! 0
+end
+
+do_help if arg_config("--help")
+
+def libzint_usable?
+  m = Module.new do
+    extend FFI::Library
+
+    ffi_lib(%w[libzint.so.2.12 libzint zint])
+    attach_function(:ZBarcode_Version, [], :int32)
+  end
+
+  (21200...21300) === m.ZBarcode_Version
+rescue LoadError
+  false
+end
+
+def build_bundled_libzint
+  puts "Build"
+  require_relative "../../lib/zint/zint_recipe"
+
+  recipe = Zint::ZintRecipe.new
+  recipe.cook_and_activate
+  recipe.path
+end
+
+unless enable_config("system-libzint", libzint_usable?)
+  # Unable to load libzint library on this system,
+  # so we build our bundled version:
+  libzint_path = build_bundled_libzint
+end
+
+# Create a Makefile which copies the libzint library files to the gem's lib dir.
+File.open("Makefile", "wb") do |mf|
+  mf.puts <<~EOT
+    RUBYARCHDIR = #{RbConfig::MAKEFILE_CONFIG["sitearchdir"].dump}
+    all:
+    clean:
+    install:
+  EOT
+
+  if libzint_path
+    mf.puts <<-EOT
+	cp -r #{libzint_path.dump}/*/libzint* $(RUBYARCHDIR)
+    EOT
+  end
+end

data/lib/ruby-zint.rb

@@ -0,0 +1 @@
+require "zint"

data/lib/zint/aus_post.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Australia Post 4-State Barcode
+  class AusPost < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_AUSPOST, **kwargs)
+    end
+  end
+end

data/lib/zint/aus_redirect.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Australia Post Redirection
+  class AusRedirect < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_AUSREDIRECT, **kwargs)
+    end
+  end
+end

data/lib/zint/aus_reply.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Australia Post Reply Paid
+  class AusReply < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_AUSREPLY, **kwargs)
+    end
+  end
+end

data/lib/zint/aus_route.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Australia Post Routing
+  class AusRoute < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_AUSROUTE, **kwargs)
+    end
+  end
+end

data/lib/zint/azrune.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Aztec Runes
+  class Azrune < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_AZRUNE, **kwargs)
+    end
+  end
+end

data/lib/zint/aztec.rb

@@ -0,0 +1,8 @@
+module Zint
+  # Aztec Code
+  class Aztec < Barcode
+    def initialize(value: nil, input_file: nil, **kwargs)
+      super(value: value, input_file: input_file, symbology: Zint::BARCODE_AZTEC, **kwargs)
+    end
+  end
+end