barby 0.6.2 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 25c48f523056303c71f3477a056906f12613bde3
-  data.tar.gz: 1860f349c37684539345aef410f09a570a50f319
+  metadata.gz: 8062a4f8a077022c7b52a7fc23d73886bbdf9e96
+  data.tar.gz: 80ab18bc484c11d6044b5c7aa683dc65f316b359
 SHA512:
-  metadata.gz: a793a5c6a5a5fba522ec2300ec703a3340edd5c45d249b9ca5d2056c2460555e6f4944c0cc4d9ccb8863f6a068a1aa2083f5f5181820d0c70b7a79d2c9cf2799
-  data.tar.gz: f7acba5a08dea02a79c1620a2b4743e1b77a1f53469d83bf4d58229c5f5e618dc3f89959d2e858b8dbf80c0fef7ef33cfe211f5bdf28d750d9e578178d4bda6d
+  metadata.gz: e99ce1411282a91273107da8b5ef1963baaa7b04c107132c33dedb463669d77172968dfc6d357c480ce633b7db79c24f62f49ff91de8bf9a9192d428c099c5b2
+  data.tar.gz: 0ff28cc5b9eac5a16bfe2eacde4b3dcd275d57840e28d3aeecdc3cf8d4a9189e97ed53efb5d2aa00676af355560016fdc9e211fab06db963a5f0af3868654c49

data/README.md

@@ -0,0 +1,107 @@
+# 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`    |
+| 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/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/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

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)

data/lib/barby/barcode/ean_13.rb

@@ -129,7 +129,7 @@ module Barby
     def weighted_sum
       odds, evens = odd_and_even_numbers
       odds.map!{|n| n * 3 }
-      sum = (odds+evens).inject(0){|s,n| s+n }
+      (odds+evens).inject(0){|s,n| s+n }
     end
 
     #Mod10

data/lib/barby/barcode/gs1_128.rb

@@ -3,18 +3,22 @@ require 'barby/barcode/code_128'
 module Barby
 
 
+  #DEPRECATED - Use the Code128 class directly instead:
+  #
+  #  Code128.new("#{Code128::FNC1}#{application_identifier}#{data}")
+  #
   #AKA EAN-128, UCC-128
   class GS1128 < Code128
 
     attr_accessor :application_identifier
 
     def initialize(data, type, ai)
+      warn "DEPRECATED: The GS1128 class has been deprecated, use Code128 directly instead (called from #{caller[0]})"
       self.application_identifier = ai
       super(data, type)
     end
 
 
-    #TODO: Not sure this is entirely right
     def data
       FNC1+application_identifier+super
     end

data/lib/barby/barcode/qr_code.rb

@@ -41,6 +41,7 @@ module Barby
 
     def initialize(data, options={})
       self.data = data
+      @level, @size = nil
       options.each{|k,v| send("#{k}=", v) }
       raise(ArgumentError, "data too large") unless size
     end

data/lib/barby/outputter/cairo_outputter.rb

@@ -23,6 +23,11 @@ module Barby
     attr_writer :x, :y, :xdim, :height, :margin
 
 
+    def initialize(*)
+      super
+      @x, @y, @xdim, @height, @margin = nil
+    end
+
     #Render the barcode onto a Cairo context
     def render_to_cairo_context(context, options={})
       if context.respond_to?(:have_current_point?) and

data/lib/barby/outputter/png_outputter.rb

@@ -10,8 +10,12 @@ module Barby
 
     register :to_png, :to_image, :to_datastream
 
-    attr_accessor :xdim, :ydim, :width, :height, :margin
+    attr_writer :xdim, :ydim, :width, :height, :margin
 
+    def initialize(*)
+      super
+      @xdim, @height, @margin = nil
+    end
 
     #Creates a PNG::Canvas object and renders the barcode on it
     def to_image(opts={})

data/lib/barby/outputter/prawn_outputter.rb

@@ -7,9 +7,14 @@ module Barby
 
     register :to_pdf, :annotate_pdf
 
-    attr_accessor :xdim, :ydim, :x, :y, :height, :margin, :unbleed
+    attr_writer :xdim, :ydim, :x, :y, :height, :margin, :unbleed
 
 
+    def initialize(*)
+      super
+      @xdim, @ydim, @x, @y, @height, @margin, @unbleed = nil
+    end
+
     def to_pdf(opts={})
       doc_opts = opts.delete(:document) || {}
       doc_opts[:page_size] ||= 'A4'

data/lib/barby/outputter/rmagick_outputter.rb

@@ -1,5 +1,5 @@
 require 'barby/outputter'
-require 'RMagick'
+require 'rmagick'
 
 module Barby
 
@@ -8,11 +8,16 @@ module Barby
   #
   #Registers the to_png, to_gif, to_jpg and to_image methods
   class RmagickOutputter < Outputter
-  
+
     register :to_png, :to_gif, :to_jpg, :to_image
 
-    attr_accessor :height, :xdim, :ydim, :margin
+    attr_writer :height, :xdim, :ydim, :margin
+
 
+    def initialize(*)
+      super
+      @height, @xdim, @ydim, @margin = nil
+    end
 
     #Returns a string containing a PNG image
     def to_png(*a)
@@ -28,15 +33,15 @@ module Barby
     def to_jpg(*a)
       to_blob('jpg', *a)
     end
-    
+
     def to_blob(format, *a)
       img = to_image(*a)
       blob = img.to_blob{|i| i.format = format }
-      
+
       #Release the memory used by RMagick explicitly. Ruby's GC
       #isn't aware of it and can't clean it up automatically
       img.destroy! if img.respond_to?(:destroy!)
-      
+
       blob
     end
 

data/lib/barby/outputter/svg_outputter.rb

@@ -22,6 +22,11 @@ module Barby
     attr_writer :title, :xdim, :ydim, :height, :rmargin, :lmargin, :tmargin, :bmargin, :xmargin, :ymargin, :margin
 
 
+    def initialize(*)
+      super
+      @title, @xdim, @ydim, @height, @rmargin, @lmargin, @tmargin, @bmargin, @xmargin, @ymargin, @margin = nil
+    end
+
     def to_svg(opts={})
       with_options opts do
         case opts[:use]

data/lib/barby/version.rb

@@ -2,7 +2,7 @@ module Barby #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 6
-    TINY  = 2
+    TINY  = 3
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

metadata

@@ -1,25 +1,25 @@
 --- !ruby/object:Gem::Specification
 name: barby
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.3
 platform: ruby
 authors:
 - Tore Darell
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-15 00:00:00.000000000 Z
+date: 2016-04-20 00:00:00.000000000 Z
 dependencies: []
 description: Barby creates barcodes.
 email: toredarell@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README
+- README.md
 files:
 - CHANGELOG
 - LICENSE
-- README
+- README.md
 - bin/barby
 - lib/barby.rb
 - lib/barby/barcode.rb
@@ -43,7 +43,6 @@ files:
 - lib/barby/outputter/html_outputter.rb
 - lib/barby/outputter/pdfwriter_outputter.rb
 - lib/barby/outputter/png_outputter.rb
-- lib/barby/outputter/point_matrix.rb
 - lib/barby/outputter/prawn_outputter.rb
 - lib/barby/outputter/rmagick_outputter.rb
 - lib/barby/outputter/svg_outputter.rb
@@ -54,15 +53,7 @@ files:
 homepage: http://toretore.github.com/barby
 licenses: []
 metadata: {}
-post_install_message: |2+
-
-  *** NEW REQUIRE POLICY ***"
-  Barby no longer require all barcode symbologies by default. You'll have
-  to require the ones you need. For example, if you need EAN-13,
-  require 'barby/barcode/ean_13'; For a full list of symbologies and their
-  filenames, see README.
-  ***
-
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -78,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: barby
-rubygems_version: 2.2.2
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: The Ruby barcode generator

data/README

@@ -1,93 +0,0 @@
-*** NEW REQUIRE POLICY ***
-
-Barcode symbologies are no longer requires 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.
-
-***
-
-For more information, check out the Barby wiki at https://github.com/toretore/barby/wiki
-
-Barby is a Ruby library that generates barcodes in a variety of symbologies.
-Its functionality is split into barcode and "outputter" objects. Barcode
-objects turn data into a binary representation for a given symbology.
-Outputters then take 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.
-
-See Barby::Barcode and Barby::Outputter for more information.
-
- 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:
-
-Name - filename - dependencies
-
-require 'barby/barcode/<filename>'
-
-* Code 25 - code_25
-  * Interleaved - code_25_interleaved
-  * IATA - code_25_iata
-* Code 39 - code_39
-* Code 93 - code_93
-* Code 128 - 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
-* PDF417 - pdf_417 - java (JRuby)
-
-
-Formats supported by outputters:
-
-* Text (mostly for testing)
-* PNG, JPEG, GIF
-* PS, EPS
-* SVG
-* PDF
-* HTML
-
-
-Outputters:
-
-filename (dependencies)
-
-require 'barby/outputter/<filename>_outputter'
-
-* ascii
-* cairo (cairo)
-* html
-* pdfwriter
-* png (chunky_png)
-* prawn (prawn)
-* rmagick (RMagick)
-* svg

data/lib/barby/outputter/point_matrix.rb

@@ -1,211 +0,0 @@
-require 'barby/outputter'
-
-module Barby
-
-  class Outputter
-
-
-    #A collection of rows - an array of arrays
-    class PointMatrix < Array
-
-      DEFAULT_XDIM = 1.0
-      DEFAULT_YDIM = 1.0
-
-      attr_writer :xdim, :ydim
-
-
-      def initialize(*a, &b)
-        # new([[t,f,t,f], [f,t,f,t], ...])
-        if a[0].is_a?(Array) && a[0][0].is_a?(Array) && [true,false].include?(a[0][0][0])
-          a[0] = a[0].map{|r| PointRow.new(self, r) }
-        # new(['1010', '0101', ...])
-        elsif a[0].is_a?(Array) && a[0][0].is_a?(String)
-          a[0] = a[0].map{|s| PointRow.new(self, s) }
-        end
-
-        super(*a, &b)
-      end
-
-
-      def xdim
-        @xdim || DEFAULT_XDIM
-      end
-
-      def ydim
-        @ydim || DEFAULT_YDIM
-      end
-
-
-      def width
-        inject(0){|m,r| r.width > m ? r.width : m }
-      end
-
-      def height
-        inject(0){|s,r| s + r.height }
-      end
-
-
-      def to_s
-        map{|r| r.to_s }
-      end
-
-      def inspect
-        to_s
-      end
-
-
-      def dup
-        self.class.new(map{|r| r.dup })
-      end
-
-
-    end
-
-
-    class PointRow < Array
-
-      attr_reader :matrix
-      attr_accessor :xdim, :ydim
-
-
-      def initialize(*a, &b)
-        raise ArgumentError, 'PointRow must belong to a PointMatrix' unless a[0].is_a?(PointMatrix)
-        @matrix = a.shift
-
-        #Assume called with [t,f,t,f,..]
-        if a[0].is_a?(Array) && [true, false].include?(a[0][0])
-          a[0] = a[0].map{|b| Point.new(self, b) }
-        #Assume called with '1010..'
-        elsif a[0].is_a?(String)
-          a[0] = a[0].split(//).map{|s| Point.new(self, s == '1') }
-        end
-
-        super(*a, &b)
-      end
-
-
-      def booleans
-        map{|p| p.active? }
-      end
-
-
-      def xdim
-        @xdim || matrix.xdim
-      end
-
-      def ydim
-        @ydim || matrix.ydim
-      end
-
-
-      def width
-        inject(0){|s,p| s + p.width }
-      end
-
-      def height
-        inject(0){|m,p| p.height > m ? p.height : m }
-      end
-
-
-      def to_s
-        inject(''){|s,p| s << (p.active ? '1' : '0') }
-      end
-
-      def inspect
-        to_s
-      end
-
-      def ==(other)
-        super #Just to say explicitly that equality should behave like in an array
-      end
-
-
-      def dup
-        self.class.new(matrix, map{|p| p.dup })
-      end
-
-    end
-
-
-    class Point
-
-      attr_reader :row, :active
-      attr_writer :width, :height, :color, :active
-      alias active? active
-
-
-      def initialize(row, active, opts={})
-        @row = row
-        self.active = active
-      end
-
-
-      def color
-        @color || (active ? Color.new(0,0,0) : nil)
-      end
-
-      def width
-        @width || row.xdim
-      end
-
-      def height
-        @height || row.ydim
-      end
-
-
-      def ==(other)
-        active == other.active &&
-        width == other.width &&
-        height == other.height &&
-        color == other.color
-      end
-
-
-    end
-
-
-    #TODO Add alpha
-    class Color
-
-      MIN_VALUE = 0
-      MAX_VALUE = 255
-
-      attr_reader :red, :blue, :green
-
-      def initialize(r, b, g)
-        self.red, self.blue, self.green = r, b, g
-      end
-
-
-      def red=(r)
-        set_color(:red, r)
-      end
-
-      def blue=(b)
-        set_color(:blue, b)
-      end
-
-      def green=(g)
-        set_color(:green, g)
-      end
-
-
-      def ==(other)
-        other.red == red && other.blue == blue && other.green == green
-      end
-
-
-    private
-
-      def set_color(name, value)
-        raise ArgumentError, "Value must be between 0-255" if value < MIN_VALUE || value > MAX_VALUE
-        instance_variable_set("@#{name}", value)
-      end
-
-
-    end
-
-
-  end
-
-end