{:elf => "Blog"}

Olá, pessoal, uma forma de se gerar documentos PDF usando Ruby é utilizar o pdf-writer, é uma gem que pode ser usada tanto em Rails e Ruby, nessa primeira parte vamos conhecer o básico , criar alguns exemplos e ver como o negocio funciona, não iremos ver tudo da gem(é obvio) bem que para isso tem o manual no site(99 páginas em Inglês), nesse post não iremos interar com o Rails, somente Ruby.

1 – Instalação

Para instalar o pdf-writer temos dois caminhos, 1) Instalar via RubyGems(recomendo) e 2) Instalar manualmente usando o pacote. Recomendo via rubygems pois ele irá reconhecer as dependências que o pdf-writer tem, já a segunda você irá ter que instalar a dependencia, ou transaction-simple ou colors-tools.

Via RubyGems:

sudo gem install pdf-writer

Via “package”

wget http://rubyforge.org/frs/download.php/33972/pdf-writer.1.1.8.tar.gz
tar -xvzf pdf-writer.1.1.8.tar.gz
cd pdf_writer-1.1.8
sudo ruby setup.rb

agora instale o transaction-simple ou colors-tools da mesma forma.
Mas acho melhor a primeiro opção

2 – Criando um Exemplo Muito Simples.

Vamos criar um exemplo “Hello PDF::Writer” para não ficar “Hello World” , crie arquivo chamado teste_pdf1.pfd com o seguinte conteúdo:

require "rubygems"
require "pdf/writer"

pdf = PDF::Writer.new
pdf.text("Hello PDF::Writer", :font_size => 35)
pdf.save_as("file1.pdf")

Isto produz:

Fizemos dois requires ali no começo, com rubygems e pdf/writer, após fizemos a chamada de PDF::Writer, logo depois “escrevemos” no documento  o texto “Hello PDF::Writer” e definimos o tamanho da fonte para 35 pontos, então por ultimo salvamos o documento como file1.pdf.

3 – Fontes e Posições.

Para configurar  o tipo de fonte usada você pode usar  pdf.select_font “Times-Roman” por exemplo, opções de posição , :left, :right, :absolute_left, :absolute_right, vamos a um exemplo:

require "rubygems"
require "pdf/writer"

pdf = PDF::Writer.new
pdf.select_font "Courier-BoldOblique"
pdf.text("Hello PDF::Writer", :font_size => 35, :left => 100)
pdf.save_as("file2.pdf")

Isto produz:

Justificações:
Com as seguinte quatro formas de justificação:

pdf.text("Hello Ruby!", :justification => :left)
pdf.text("Hello Ruby!", :justification => :right)
pdf.text(“Hello Ruby!", :justification => :center)
pdf.text("Hello Ruby", :justification => :full)

4 – Espaçamento entre Linhas

Você pode configurar o espaço entre determindas linhas do texto por exemplo:

require "rubygems"
require "pdf/writer"

pdf = PDF::Writer.new
pdf.select_font "Courier-BoldOblique"
pdf.text("Hello PDF::Writer", :font_size => 35, :left => 100)
pdf.text("Ola Mundo Cruel!", :font_size => 35, :left => 100, :spacing => 5)
pdf.save_as("file3.pdf")

5 – Documento final

Para finalizar esse post vamos criar um “documento real” com um simples texto, usando o que vimos nesse post.

require "rubygems"
require "pdf/writer"

pdf = PDF::Writer.new

BODY = <<-'EOS'
Benjamin Franklin (January 17, 1706 [O.S. January 6, 1705]   April 17, 1790) was one of the Founding Fathers of the United States of America. A noted polymath, Franklin was a leading author and printer, satirist, political theorist, politician, scientist, inventor, civic activist, statesman, and diplomat. As a scientist, he was a major figure in the Enlightenment and the history of physics for his discoveries and theories regarding electricity. He invented the lightning rod, bifocals, the Franklin stove, a carriage odometer, and a musical instrument. He formed both the first public lending library in America and first fire department in Pennsylvania. He was an early proponent of colonial unity and as a political writer and activist he, more than anyone, invented the idea of an American nation[1] and as a diplomat during the American Revolution, he secured the French alliance that helped to make independence possible.
Franklin is credited as being foundational to the roots of American values and character, a marriage of the practical and democratic Puritan values of thrift, hard work, education, community spirit, self-governing institutions, and opposition to authoritarianism both political and religious, with the scientific and tolerant values of the Enlightenment. In the words of Henry Steele Commager, "In Franklin could be merged the virtues of Puritanism without its defects, the illumination of the Enlightenment without its heat."[2] To Walter Isaacson, this makes Franklin, "the most accomplished American of his age and the most influential in inventing the type of society America would become."
EOS

corpo = BODY.split($/).join(" ").squeeze(" ")

pdf.text("Benjamin Franklin", :font_size => 20, :justification => :center)
pdf.move_pointer(36)
pdf.text(corpo, :font_size => 12, :justification => :full)
pdf.move_pointer(50)
pdf.text("Fonte: Wikipedia", :font_size => 10, :left => 370)
pdf.save_as("final.pdf")

Bom para começo é isso, logo irei postar algo mais sobre o pdf-writer, obviamente isso é muito mas muito básico.

Pequena Intro.

Hashes é uma coleção de pares (chave-valor), cada elemento da lista é um par, que contém uma chave que representa um valor. São semelhantes aos Arrays, porém se diferem desses por terem atribuição arbritária, chaves são qualquer tipo de objeto e não um int(inteiro) igual os Array.
Hashes em outra linguagem também são chamados de dicionários, e logo você vai ver porque ?.
Hashes tem valor padrão que é retornado se tentar acessar chaves que não existam, esse valor é nil.
Com essa pequena teoria sobre hashes em mente vamos fazer alguns exemplo, como sempre abra o IRB.

1 – Criando um hashe

h = {"choice"=>"escolha", "cloak"=>"capa", "stuffy"=>"abafado"}
=> {"stuffy"=>"abafado", "cloak"=>"capa", "choice"=>"escolha"}

Acima criamos um hashe simples contendo três palavras em inglês que suas traduções.
Bom como visto acima aqui não temos índices e sim chaves, vamos acessar as chaves desse hashe.
Antes vamos ver todos os métodos para manipulação de hashes, então usamos h.methods( onde h é o hashe que criamos a cima).

1.1 – Métodos

irb(main):003:0> h.methods
=> ["select", "[]=", "inspect", "each_value", "fetch", "clone", "values_at", "public_methods", "partition
", "display", "empty?", "instance_variable_defined?", "update", "shift", "to_yaml_properties", "equal?",
"freeze", "has_value?", "clear", "grep", "rehash", "to_yaml", "taguri", "indices", "methods", "respond_to
?", "reject", "each_key", "taguri=", "dup", "delete", "instance_variables", "yaml_initialize", "member?",
 "__id__", "find", "method", "eql?", "value?", "to_hash", "each_with_index", "id", "to_yaml_style", "inde
x", "collect", "singleton_methods", "send", "each_pair", "all?", "taint", "delete_if", "length", "entries
", "merge!", "frozen?", "instance_variable_get", "include?", "__send__", "instance_of?", "merge", "detect
", "to_a", "store", "zip", "type", "protected_methods", "instance_eval", "object_id", "map", "any?", "=="
, "values", "===", "size", "sort", "instance_variable_set", "default", "min", "kind_of?", "extend", "find
_all", "to_s", "default=", "default_proc", "key?", "each", "hash", "class", "reject!", "replace", "inject
", "tainted?", "keys", "=~", "private_methods", "invert", "nil?", "untaint", "sort_by", "has_key?", "max"
, "[]", "is_a?", "indexes"]
irb(main):004:0>

Veremos algo assim, uma grande lista de métodos que estão disponíveis para o uso, ali no meio(coloquei em negrito) temos o método Keys, ele nos mostra todas as chaves do nosso hashe, então vamos usá-lo.

1.2 – Chaves

h.keys
=> ["stuffy", "cloak", "choice"]

E está ai as três chaves que nosso hashe contém.

1.3 – Acessando Valores.

h["choice"]
=> "escolha"

Acho que não precisa explicar né ?

Temos outro método chamado values, como o primeiro que agente viu era chamado keys e você viu o que ele retornou, imagino que você já saiba o que este retorna:

h.values
=> ["abafado", "capa", "escolha"]

OHHHH, retornou os valores.

Com esses dois conceitos de keys e valeus em mente vamos fazer um loop para acessar todos os valores:

h.keys.each do |chave|
 puts "#{chave}  = #{h[chave]}"
end

stuffy  = abafado
cloak  = capa
choice  = escolha

2 – Adicionando novos elementos

Podemos adicionar novos elementos em um hashe, para isso temos dois métodos o merge e o merge!, listados na lista acima, vamos fazer dois exemplo usando os dois métodos é ver o que acontece.

numeros = {"1"=>"um","2"=>"dois","3"=>"tres"}
=> {"1"=>"um", "2"=>"dois", "3"=>"tres"}

Com merge

numeros.merge( {"4"=>"quatro"} )
=> {"1"=>"um", "2"=>"dois", "3"=>"tres", "4"=>"quatro"}
numeros
=> {"1"=>"um", "2"=>"dois", "3"=>"tres"}

Com merge!

numeros.merge!( {"4"=>"quatro"} )
=> {"1"=>"um", "2"=>"dois", "3"=>"tres", "4"=>"quatro"}
numeros
=> {"1"=>"um", "2"=>"dois", "3"=>"tres", "4"=>"quatro"}

Viu? Podemos concluir então que o primeiro método( merge ) não altera o hashe original, e o segundo já faz as alterações diretamente no original “gravando” as mudanças.

3 – Melhorando um pouco.

Esses exemplo acima, como você pode notar as chaves e os valores são representados com strings, isso não é bom, isso é feio, existe um tipo no ruby chamado symbol(símbolos), eles são representando com dois-pontos( : ) antes do nome, por exemplo :home.
Então vamos mudar nosso modo de criar hashe e usar symbols.

nums = {:um=>"1", :dois=>"2"}
=> {:um=>"1", :dois=>"2"}

Se você já andou mexendo com o Rails muito provavelmente você encontrou símbolos para tudo quanto é lado.
Então porque usar símbolos?
• São mais bonitos que Strings.
• O código fica melhor para ler
• Você economizara memória
• São usadas muito no Rails

Bom chegamos ao final, obviamente isso não é tudo, recomendo olhar a documentação do Ruby, e ir testando todos os métodos no IRB, novamente se alguém vier a ler isso e achar erros, me informe através dos comentários, ficaria feliz se quem ler esse post deixar um comentário dizendo o que achou.
Abraço a todos.