prawml 0.1.1

data/.gitignore

@@ -0,0 +1,19 @@
+tmp
+spec/reports
+.bundle
+*.gem
+InstalledFiles
+*.rbc
+.config
+rdoc
+_yardoc
+test/version_tmp
+lib/bundler/man
+prawml.sublime-project
+doc/
+coverage
+.yardoc
+prawml.sublime-workspace
+Gemfile.lock
+test/tmp
+pkg

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in prawml.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Wanderson Policarpo
+
+MIT License
+
+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,71 @@
+# Prawml
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'prawml'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install prawml
+
+## Usage
+
+Describe in an yaml file the fields and its xpos, ypos and style/type options:
+
+```yaml
+# example.yml
+text1:
+  - [250, 680, {style: bold, align: center, size: 96, font: 'Helvetica'}]
+  - [220, 0]
+text2: [415, 660, {style: italic, size: 16,align: right, color: '123456'}]
+barcode1: [100, 15, {type: 'barcode', symbology: 'code_25_interleaved'}]
+```
+PDF generation example:
+
+```ruby
+pdf = Prawml::PDF.new('path_to_yaml/example.yml')
+pdf.generate({
+    :text1 => 'Prawml',
+    :text2 => 'The pdf generator',
+    :barcode1 => 'My little barcode string'
+}).render_file('example.pdf')
+```
+You can also pass an object that responds to methods described in YAML file.
+
+### Available options:
+
+* `type`: **text|image|barcode** *[text]*
+* `color`: **RGB color** *[00000]*
+* `fixed`: **A fixed text. Ignores values and renders the static text informed** *[false]*
+
+##### Text specific options:
+* `font`: **Any Prawn supported font can be used** *[Times-Roman]*
+* `align`: **left|center|right** *[left]*
+* `size`: **float** *[12]*
+* `style`: **bold|normal|italic|bold_italic** *[normal]*
+* `format`: **Formating hooks** (currency|date) *[false]*
+
+##### Barcode specific options:
+* `symbology`: **Symbologies available in barby gem [seen here](https://github.com/toretore/barby/wiki/Symbologies)** *[nil]*
+
+## Contributors
+
+1. Wanderson Policarpo (http://github.com/wpolicarpo)
+2. Edson Júnior (http://github.com/ebfjunior)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/prawml/version.rb

@@ -0,0 +1,3 @@
+module Prawml
+  VERSION = "0.1.1"
+end

data/lib/prawml.rb

@@ -0,0 +1,144 @@
+require "prawml/version"
+require "prawn"
+require "barby/outputter/prawn_outputter"
+require "active_support/inflector"
+require "active_support/core_ext"
+require "yaml"
+
+module Prawml
+
+  class PDF
+	
+    attr_reader :pdf    
+
+    SYMBOLOGIES = {
+      "bookland" => "Bookland",
+      "code_128" => "Code128",
+      "code_25" => "Code25",
+      "code_25_iata" => "Code25IATA",
+      "code_25_interleaved" => "Code25Interleaved",
+      "code_39" => "Code39",
+      "code_93" => "Code93",
+      "data_matrix" => "DataMatrix",
+      "ean_13" => "EAN13",
+      "ean_8" => "EAN8",
+      "gs1_128" => "GS1128",
+      "pdf_417" => "Pdf417",
+      "qr_code" => "QrCode",
+      "upc_supplemental" => "UPCSupplemental"
+    }
+
+    def initialize(yaml, options = {})
+        raise "You must pass a valid YAML file or a string with YAML to generate PDF." if yaml.empty?
+
+        begin
+          rules = File.open(yaml)
+        rescue
+          rules = yaml
+        end
+        @rules = YAML::load(rules)
+
+        @options = {
+          :page_size => "A4",
+          :page_layout => :portrait
+        }.merge options
+
+        template = @options[:template]
+        @options.delete(:template)
+	
+        @pdf = Prawn::Document.new @options
+
+        unless template.nil?
+          draw_image template[:path], [template[:x], template[:y], {:width => template[:width], :height => template[:height]}]
+        end
+    end
+
+    def generate(collection)
+        defaults = {
+            :style => :normal,
+            :size => 12,
+            :align => :left,
+            :format => false,
+            :font => 'Times-Roman',
+            :type => :text,
+            :color => '000000',
+            :fixed => false
+        }
+
+        @rules.each do |field, draws|
+            unless draws[0].is_a? Array
+              draws = [draws]
+            end
+
+            draws.each do |params|
+              params[2] = defaults.merge(params[2] || {})
+              params[2].symbolize_keys!
+              params[2][:style] = params[2][:style].to_sym
+
+              set_options params[2]
+
+	            value = collection.respond_to?(field.to_sym) ? collection.send(field.to_sym) : collection[field.to_sym]
+
+              send :"draw_#{params[2][:type]}", value, params unless value.nil?
+            end
+        end
+
+        @pdf
+    end
+
+    protected
+
+    def draw_text(text, params)
+        xpos, ypos, options = params
+
+        @pdf.draw_text text, :at => [align(text, xpos, options[:align]), ypos]
+    end
+
+    def draw_barcode(text, params)
+        xpos, ypos, options = params
+
+        begin
+          symbology = options[:symbology].to_s
+
+          require "barby/barcode/#{symbology}"
+
+          barby_module = "Barby::#{SYMBOLOGIES[symbology]}"
+
+          barcode = ActiveSupport::Inflector.constantize(barby_module).new(text)
+
+          outputter = Barby::PrawnOutputter.new(barcode)
+          outputter.annotate_pdf(@pdf, options.merge({:x => xpos, :y => ypos}))
+        rescue LoadError
+          raise "Symbology '#{symbology}' is not defined. Please see https://github.com/toretore/barby/wiki/Symbologies for more information on available symbologies."
+        end
+    end
+
+    def draw_image(image, params)
+      xpos, ypos, options = params
+
+      @pdf.image image, :at => [xpos, ypos], :width => options[:width], :height => options[:height]
+    end
+
+    private
+
+    def set_options(options)
+      @pdf.fill_color options[:color]
+      @pdf.font options[:font], options
+    end
+
+    def align(text, position, alignment)
+        font = @pdf.font
+        width = font.compute_width_of(text.to_s.parameterize)
+
+        case alignment.to_sym
+        when :center then
+            position - width/2
+        when :right then
+            position - width
+        else
+            position
+        end
+    end
+  end
+
+end

data/prawml.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/prawml/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Wanderson Policarpo", "Edson Júnior"]
+  gem.email         = ["wpolicarpo@gmail.com", "ejunior.batista@gmail.com"]
+  gem.description   = "Prawml is a Yaml DSL interpreted by ruby over Prawn gem to generate PDF files easily"
+  gem.summary       = "Yaml intends to help you generate PDF files writing only an yaml file."
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "prawml"
+  gem.require_paths = ["lib"]
+  gem.version       = Prawml::VERSION
+
+  gem.add_dependency "prawn"
+  gem.add_dependency "barby"
+  gem.add_dependency "activesupport", "~> 3.0"
+end
+

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: prawml
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Wanderson Policarpo
+- Edson Júnior
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: barby
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Prawml is a Yaml DSL interpreted by ruby over Prawn gem to generate PDF
+  files easily
+email:
+- wpolicarpo@gmail.com
+- ejunior.batista@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/prawml.rb
+- lib/prawml/version.rb
+- prawml.gemspec
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Yaml intends to help you generate PDF files writing only an yaml file.
+test_files: []