barby 0.6.2 → 0.6.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 25c48f523056303c71f3477a056906f12613bde3
-  data.tar.gz: 1860f349c37684539345aef410f09a570a50f319
+SHA256:
+  metadata.gz: 64d74091ea1f3aa79457c34878fc3b0d6f4c805dbb985d12eb372f29a7837e36
+  data.tar.gz: a8a61c1af0a401a1b36bc675653d2063e569443d434a57b5a2d95c7abfc1d193
 SHA512:
-  metadata.gz: a793a5c6a5a5fba522ec2300ec703a3340edd5c45d249b9ca5d2056c2460555e6f4944c0cc4d9ccb8863f6a068a1aa2083f5f5181820d0c70b7a79d2c9cf2799
-  data.tar.gz: f7acba5a08dea02a79c1620a2b4743e1b77a1f53469d83bf4d58229c5f5e618dc3f89959d2e858b8dbf80c0fef7ef33cfe211f5bdf28d750d9e578178d4bda6d
+  metadata.gz: 99143c0bf41695fa1416956073bcb6c9d7257c677fa36337638f890681665bacd51c4b04cd3412008592c8f23e4130fec74363eb425c776f8c827bf360d07c5b
+  data.tar.gz: d1b1f6aa2a63484b00f79bd184bef605b75850152dd54600b7eb25434f114c45c6994ce725af7535edefb8a536fc93f3e42c7d4bd2547c6f88d8da90d0947f8f

data/.gitignore

@@ -0,0 +1,2 @@
+*.swp
+Gemfile.lock

data/CHANGELOG

@@ -1,3 +1,11 @@
+* 0.6.7
+
+* RMagick outputter should use line command for lines [joshuaflanagan]
+
+* 0.6.6
+
+* Add support for Codabar symbology [labocho]
+
 * 0.6.1
 
 * Fix single-pixel error with RMagick [James Brink]

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/README.md

@@ -0,0 +1,108 @@
+# Barby
+Barby is a Ruby library that generates barcodes in a variety of symbologies.
+
+Its functionality is split into _barcode_ and "_outputter_" objects:
+  * [`Barby::Barcode` objects] [symbologies] turn data into a binary representation for a given symbology.
+  * [`Barby::Outputter`] [outputters] then takes this representation and turns it into images, PDF, etc.
+
+You can easily add a symbology without having to worry about graphical
+representation. If it can be represented as the usual 1D or 2D matrix of
+lines or squares, outputters will do that for you.
+
+Likewise, you can easily add an outputter for a format that doesn't have one
+yet, and it will work with all existing symbologies.
+
+For more information, check out [the Barby wiki][wiki].
+
+
+### New require policy
+
+Barcode symbologies are no longer required automatically, so you'll have to
+require the ones you need.
+
+If you need EAN-13, `require 'barby/barcode/ean_13'`. Full list of symbologies and filenames below.
+
+## Example
+
+```ruby
+require 'barby'
+require 'barby/barcode/code_128'
+require 'barby/outputter/ascii_outputter'
+
+barcode = Barby::Code128B.new('BARBY')
+
+puts barcode.to_ascii #Implicitly uses the AsciiOutputter
+
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+## #    #  #   # ##   # #   ##   ##   # ### #   # ##   ### ## #   ## ### ### ##   ### # ##
+          B          A          R          B          Y
+```
+
+## Supported symbologies
+
+```ruby
+require 'barby/barcode/<filename>'
+```
+
+| Name                                | Filename              | Dependencies                       |
+| ----------------------------------- | --------------------- | ---------------------------------- |
+| Code 25                             | `code_25`             | ─                                  |
+| ├─ Interleaved                      | `code_25_interleaved` | ─                                  |
+| └─ IATA                             | `code_25_iata`        | ─                                  |
+| Code 39                             | `code_39`             | ─                                  |
+| └─ Extended                         | `code_39`             | ─                                  |
+| Code 93                             | `code_93`             | ─                                  |
+| Code 128 (A, B, and C)              | `code_128`            | ─                                  |
+| └─ GS1 128                          | `gs1_128`             | ─                                  |
+| EAN-13                              | `ean_13`              | ─                                  |
+| ├─ Bookland                         | `bookland`            | ─                                  |
+| └─ UPC-A                            | `ean_13`              | ─                                  |
+| EAN-8                               | `ean_8`               | ─                                  |
+| UPC/EAN supplemental, 2 & 5 digits  | `upc_supplemental`    | ─                                  |
+| QR Code                             | `qr_code`             | `rqrcode`                          |
+| DataMatrix (Semacode)               | `data_matrix`         | `semacode` or `semacode-ruby19`    |
+| PDF417                              | `pdf_417`             | JRuby                              |
+
+
+## Outputters
+
+```ruby
+require 'barby/outputter/<filename>_outputter'
+```
+
+| filename    | dependencies  |
+| ----------- | ------------- |
+| `ascii`     | ─             |
+| `cairo`     | cairo         |
+| `html`      | ─             |
+| `pdfwriter` | ─             |
+| `png`       | chunky_png    |
+| `prawn`     | prawn         |
+| `rmagick`   | rmagick       |
+| `svg`       | ─             |
+
+### Formats supported by outputters
+
+* Text (mostly for testing)
+* PNG, JPEG, GIF
+* PS, EPS
+* SVG
+* PDF
+* HTML
+
+---
+
+For more information, check out [the Barby wiki][wiki].
+
+
+  [wiki]: https://github.com/toretore/barby/wiki
+  [symbologies]: https://github.com/toretore/barby/wiki/Symbologies
+  [outputters]: https://github.com/toretore/barby/wiki/Outputters

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rake'
+require 'rake/testtask'
+require 'rdoc/task'
+
+Rake::TestTask.new do |t|
+  t.libs = ['lib','test']
+  t.test_files = Dir.glob("test/**/*_test.rb").sort
+  t.verbose = true
+end
+
+RDoc::Task.new do |rdoc|
+  rdoc.main = "README"
+  rdoc.rdoc_files.include("README", "lib")
+  rdoc.rdoc_dir = 'doc'
+end

data/barby.gemspec

@@ -0,0 +1,31 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "barby/version"
+
+Gem::Specification.new do |s|
+  s.name        = "barby"
+  s.version     = Barby::VERSION::STRING
+  s.platform    = Gem::Platform::RUBY
+  s.summary     = "The Ruby barcode generator"
+  s.email       = "toredarell@gmail.com"
+  s.homepage    = "http://toretore.github.com/barby"
+  s.description = "Barby creates barcodes."
+  s.authors     = ['Tore Darell']
+
+  s.rubyforge_project = "barby"
+
+  s.extra_rdoc_files  = ["README.md"]
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.test_files.delete("test/outputter/rmagick_outputter_test.rb")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths     = ["lib"]
+
+  s.add_development_dependency "minitest",        "~> 5.11"
+  s.add_development_dependency "bundler",         "~> 1.16"
+  s.add_development_dependency "rake",            "~> 10.0"
+  s.add_development_dependency "semacode-ruby19", "~> 0.7"
+  s.add_development_dependency "rqrcode",         "~> 0.10"
+  s.add_development_dependency "prawn",           "~> 2.2"
+  s.add_development_dependency "cairo",           "~> 1.15"
+end

data/lib/barby/barcode.rb

@@ -17,7 +17,7 @@ module Barby
   #   '101100111000111100001'
   #  end
   # end
-  # 
+  #
   # require 'barby/outputter/ascii_outputter'
   # puts StaticBarcode.new.to_ascii(:height => 3)
   #
@@ -33,8 +33,8 @@ module Barby
   #   end
   # end
   class Barcode
-  
-    
+
+
     #Every barcode must have an encoding method. This method returns
     #a string containing a series of 1 and 0, representing bars and
     #spaces. One digit is the width of one "module" or X dimension.

data/lib/barby/barcode/bookland.rb

@@ -132,7 +132,6 @@ module Barby
       end
 
       def inspect
-        klass = (self.class.ancestors + [self.class.name]).join(':')
         "#<#{self.class}:0x#{'%014x' % object_id} #{formatted_isbn}>"
       end
 

data/lib/barby/barcode/codabar.rb

@@ -0,0 +1,82 @@
+require "barby/barcode"
+
+module Barby
+  # https://en.wikipedia.org/wiki/Codabar
+  class Codabar < Barcode1D
+    BLACK_NARROW_WIDTH = 1
+    WHITE_NARROW_WIDTH = 2
+    WIDE_WIDTH_RATE = 3
+    SPACING = 5 # must be equal to or wider than white narrow width
+    CHARACTERS = "0123456789-$:/.+ABCD".freeze
+    # even: black, odd: white
+    # 0: narrow, 1: wide
+    BINARY_EXPRESSION = [
+      "0000011", # 0
+      "0000110", # 1
+      "0001001", # 2
+      "1100000", # 3
+      "0010010", # 4
+      "1000010", # 5
+      "0100001", # 6
+      "0100100", # 7
+      "0110000", # 8
+      "1001000", # 9
+      "0001100", # -
+      "0011000", # $
+      "1000101", # :
+      "1010001", # /
+      "1010100", # .
+      "0010101", # +
+      "0011010", # A
+      "0101001", # B
+      "0001011", # C
+      "0001110", # D
+    ].each(&:freeze)
+    CHARACTER_TO_BINARY = Hash[CHARACTERS.chars.zip(BINARY_EXPRESSION)].freeze
+    FORMAT = /\A[ABCD][0123456789\-\$:\/\.\+]+[ABCD]\z/.freeze
+    ONE = "1".freeze
+    ZERO = "0".freeze
+
+    attr_accessor :data, :black_narrow_width, :white_narrow_width, :wide_width_rate, :spacing
+
+    def initialize(data)
+      self.data = data
+      raise ArgumentError, 'data not valid' unless valid?
+
+      self.black_narrow_width = BLACK_NARROW_WIDTH
+      self.white_narrow_width = WHITE_NARROW_WIDTH
+      self.wide_width_rate = WIDE_WIDTH_RATE
+      self.spacing = SPACING
+    end
+
+    def encoding
+      data.chars.map{|c| binary_to_bars(CHARACTER_TO_BINARY[c]) }.join(ZERO * spacing)
+    end
+
+    def valid?
+      data =~ FORMAT
+    end
+
+    private
+    def binary_to_bars(bin)
+      bin.chars.each_with_index.map{|c, i|
+        black = i % 2 == 0
+        narrow = c == ZERO
+
+        if black
+          if narrow
+            ONE * black_narrow_width
+          else
+            ONE * (black_narrow_width * wide_width_rate).to_i
+          end
+        else
+          if narrow
+            ZERO * white_narrow_width
+          else
+            ZERO * (white_narrow_width * wide_width_rate).to_i
+          end
+        end
+      }.join
+    end
+  end
+end

data/lib/barby/barcode/code_128.rb

@@ -18,6 +18,14 @@ module Barby
   #As an example, here's one that starts out as type A and then switches to B and then C:
   #
   #  Code128A.new("ABC123\306def\3074567")
+  #
+  #
+  #GS1-128/EAN-128/UCC-128
+  #
+  #To make a GS1-128 code, prefix the data with FNC1 and the Application Identifier:
+  #
+  #  #AI=00, data=12345
+  #  Code128.new("#{Code128::FNC1}0012345")
   class Code128 < Barcode1D
 
     FNC1 = "\xc1"
@@ -175,7 +183,7 @@ module Barby
 
 
     def type=(type)
-      type.upcase!
+      type = type.upcase
       raise ArgumentError, 'type must be A, B or C' unless type =~ /^[ABC]$/
       @type = type
     end
@@ -230,7 +238,8 @@ module Barby
     #there are no more extras, the barcode ends with that object.
     #Most barcodes probably don't change charsets and don't have extras.
     def extra
-      @extra
+      return @extra if defined?(@extra)
+      @extra = nil
     end
 
     #Set the extra for this barcode. The argument is a string starting with the
@@ -396,6 +405,9 @@ module Barby
     LOWR_RE = /[a-z]/
     DGTS_RE = /\d{4,}/
 
+    # pairs of digits and FNC1 characters
+    CODEC_CHARS_RE = /(?:\d{2}|#{FNC1}){2,}/
+
     class << self
 
 
@@ -415,7 +427,7 @@ module Barby
       #shortest encoding possible
       def apply_shortest_encoding_for_data(data)
         extract_codec(data).map do |block|
-          if possible_codec_segment?(block)
+          if codec_segment?(block)
             "#{CODEC}#{block}"
           else
             if control_before_lowercase?(block)
@@ -445,25 +457,15 @@ module Barby
       #  #                                        C       A or B  C         A or B
       #  extract_codec("12345abc678910DEF11") => ["1234", "5abc", "678910", "DEF11"]
       def extract_codec(data)
-        segments = data.split(/(\d{4,})/).reject(&:empty?)
-        segments.each_with_index do |s,i|
-          if possible_codec_segment?(s) && s.size.odd?
-            if i == 0
-              if segments[1]
-                segments[1].insert(0, s.slice!(-1))
-              else
-                segments[1] = s.slice!(-1)
-              end
-            else
-              segments[i-1].insert(-1, s.slice!(0)) if segments[i-1]
-            end
-          end
-        end
-        segments
+        data.split(/
+          (^(?:#{CODEC_CHARS_RE})) # matches digits that appear at the beginning of the barcode
+          |
+          ((?:#{CODEC_CHARS_RE})(?!\d)) # matches digits that appear later in the barcode
+        /x).reject(&:empty?)
       end
 
-      def possible_codec_segment?(data)
-        data =~ /\A\d{4,}\Z/
+      def codec_segment?(data)
+        data =~ /\A#{CODEC_CHARS_RE}\Z/
       end
 
       def control_character?(char)

data/lib/barby/barcode/code_25.rb

@@ -28,11 +28,14 @@ module Barby
       9 => [N,W,N,W,N]
     }
 
-    attr_accessor :data, :narrow_width, :wide_width, :space_width, :include_checksum
+    attr_accessor :include_checksum
+    attr_writer :narrow_width, :wide_width, :space_width
+    attr_reader :data
+
 
-  
     def initialize(data)
       self.data = data
+      @narrow_width, @wide_width, @space_width = nil
     end
 
 
@@ -105,7 +108,7 @@ module Barby
     #Mod10
     def checksum
       evens, odds = even_and_odd_digits
-      sum = odds.inject(0){|sum,d| sum + d } + evens.inject(0){|sum,d| sum + (d*3) }
+      sum = odds.inject(0){|s,d| s + d } + evens.inject(0){|s,d| s + (d*3) }
       sum %= 10
       sum.zero? ? 0 : 10-sum
     end

data/lib/barby/barcode/code_25_interleaved.rb

@@ -14,9 +14,9 @@ module Barby
 
 
     def digit_pairs(d=nil)
-      (d || digits).inject [] do |ary,d|
+      (d || digits).inject [] do |ary,i|
         ary << [] if !ary.last || ary.last.size == 2
-        ary.last << d
+        ary.last << i
         ary
       end
     end

data/lib/barby/barcode/code_39.rb

@@ -87,7 +87,8 @@ module Barby
     START_ENCODING = [N,W,N,N,W,N,W,N,N] # *
     STOP_ENCODING  = [N,W,N,N,W,N,W,N,N] # *
 
-    attr_accessor :data, :spacing, :narrow_width, :wide_width, :extended, :include_checksum
+    attr_accessor :data, :extended, :include_checksum
+    attr_writer :spacing, :narrow_width, :wide_width
     
     # Do not surround "data" with the mandatory "*" as is this is done automically for you.
     # So instead of passing "*123456*" as "data", just pass "123456".

data/lib/barby/barcode/data_matrix.rb

@@ -7,7 +7,7 @@ module Barby
   #Uses the semacode library (gem install semacode) to encode DataMatrix barcodes
   class DataMatrix < Barcode2D
 
-    attr_accessor :data
+    attr_reader :data
 
 
     def initialize(data)