Embedded Codes (Códigos Embutidos) em views

Embedded Codes ou Códigos embutidos são instruções, objetos ou qualquer outra coisa que é inserido dentro de um documento. Por exemplo um gráfico Excel inserido dentro de um arquivo do Word.

Os arquivos de visão do RoR, basicamente são compostos por instruções HTML e pedaços de código em Ruby. O que define a parte que contém a expressão Ruby são tags para blocos especiais, conforme a tabela abaixo:

<%= %> É um dos códigos mais comum. Contém expressões em Ruby que serão substituídas pelo resultado na construção do HTML acrescido por uma quebra de linha.

<%= -%> Idêntico ao anterior, porém não acrescenta uma quebra de linha.

<% %> Contém uma expressão em Ruby cujo resultado não gera uma saída em HTML. Acrescenta uma quebra de linha.

<% -%> Idêntico ao anterior, porém sem acrescentar uma quebra de linha.

<%# %> Insere um comentário. O comando será ignorado e não exibido.

Plugin Brazilian Rails

Neste post eu comentei que era mais fácil trabalhar com Rails utilizando a convenção em inglês. Nas andanças da net, achei este plugin que – entre outras coisas – traduz a pluralização do Rails para o português.

Tentei instalá-lo no RADRails, mas obtive falha. Creio que se meu ambiente de desenvolvimento não fosse Windows seria mais fácil. Como necessito trabalhar com este ambiente, minha solução foi ir para o Console e tentar instalar o plugin via prompt. Ocorre que não está muito claro como se faz isso.

No site existe dois exemplos:
O primeiro é para instalação em Rails 2.1 (ainda não lançado – enquanto escrevo este post).
ruby script/plugin install git://github.com/tapajos/brazilian-rails.git

O segundo é para instalação em versões anteriores:
ruby script/plugin install svn://rubyforge.org/var/svn/brazilian-rails

Ambos comandos acima não funcionaram em Windows. Mas consegui a dica correta. No console, vá até o diretório do projeto criado e digite:
ruby script/plugin install http://brazilian-rails.rubyforge.org/svn/

Outra dica importante que não está clara: Para utilizar o plugin, abra o arquivo enviroment.rb que está no subdiretório config da aplicação, e acrescente o comando require ‘inflector_portuguese’ após o bloco Rails::initializer.run END. O código ficará parecido com este:

# Be sure to restart your server when you modify this file
(...)
# Specifies gem version of Rails to use when vendor/rails is not present
RAILS_GEM_VERSION = '2.0.2' unless defined? RAILS_GEM_VERSION
# Bootstrap the Rails environment, frameworks, and default configuration
require File.join(File.dirname(__FILE__), 'boot')

Rails::Initializer.run do |config|
# Settings in config/environments/* take precedence over those specified here.
# Application configuration should go into files in config/initializers
(...)
config.action_controller.session = {
:session_key => '_App_session',
:secret => '88bc...c62e'
}
# Use the database for sessions instead of the cookie-based default,
(...)
# config.active_record.default_timezone = :utc
end
require 'inflector_portuguese'

Salve o arquivo. Agora, você já pode criar classes com pluralização em português.

Em futuros artigos, tentarei explorar as outras funcionalidades do Brazilian-Rails.

Guias de referência rápida

Fuçando na web me deparei com estas preciosidades:Rails Migrations Cheatsheet 1.2.0 e Form Helpers Cheatsheet 1.2.0. Ambos devidamente impressos e colados estrategicamente ao lado da mesa. 😉

Programar em inglês ou desativar a pluralização?

Em um outro post eu comentei sobre como conhecer bem as convenções do Rails. Bem, este post irá aprofundar um pouco mais no assunto ao abordar as pluralizações.

Pluralização é uma das convenções do Rails para quando você cria por exemplo, um modelo. Por “padrão”, o Rails se encarregará de criar toda a estrutura necessária ao modelo, então o modelo deve ser um nome no singular, a tabela criada estará no plural, o modelo estará no singular, mas com a primeira letra capitalizada (maiúscula), etc.

Esta convenção é de fato uma mão na roda, porém ela só é efetiva quando desenvolvemos usando o inglês. Quando aplicado a gramática portuguesa, ela se torna um problema já que Rails não tem suporte a outras línguas.

A tabela abaixo demonstra a pluralização do modelo carro para todos os métodos gerados pelo Rails:

Método  	Resultado
camelize 	Carro
classify 	Carro
demodulize 	carro
foreign_key 	carro_id
humanize 	Carro
pluralize 	carros
singularize 	carro
tableize 	carros
titleize 	Carro
underscore 	carro

Tudo lindo correto? Errado. Vamos pluralizar agora o modelo injeção:

A primeira coisa é eliminar o cedilha e acentuações o que resulta em injecao:

Método  	Resultado
camelize 	Injecao
classify 	Injecao
demodulize 	injecao
foreign_key 	injecao_id
humanize 	Injecao
pluralize 	injecaos
singularize 	injecao
tableize 	injecaos
titleize 	Injecao
underscore 	injecao

Em vermelho o problema, Rails não reconhece a gramática portuguesa, logo a pluralização não resulta na forma correta injecoes (injeções).

Para verificar como o Rails trabalha com a pluralização visite o: nubyonrails.

Existem maneiras de desativar a pluralização e fazer a programação “na marra”, mas isso gera um custo adicional desnecessário ao desenvolvedor além de quebrar o conceito do framework que é o de focar o desenvolvimento apenas naquilo que é fundamental.

E, traduzindo o modelo, não irá garantir que os campos que são controlados pelo Rails como “id”, “created_at”, “updated_at” entre outros, também serão traduzidos, ou seja, você terá que mantê-los ou novamente, dedicar tempo a esta tarefa.

Por fim, qual dos códigos abaixo é o de mais fácil compreensão?

1: @liner = Liner.find_by_code "001"
2: @liner = Liner.find_by_codigo "001"
3: @armador = Armador.find_by_code "001"
4: @armador = Armador.find_by_codigo "001"

Se você domina o inglês, obviamente irá optar pela primeira opção. Se você é adepto do português irá escolher a opção 4 (depois de desabilitar a pluralização), só que isso implica em ter o seu código funções pseudo-traduzidas pois o “find_by” não é traduzido. Ah! Mas então, para evitar isso, você pode partir para a solução 3, ter todos os campos escritos em inglês, o que não parece lógico já que não existe nenhum grande esforço adicional em também ter o modelo traduzido.

Portanto, a melhor solução é continuar usando a pluralização e traduzir seus campos para o inglês. Quem sabe, com o tempo que você vai ganhar no desenvolvimento, você consegue finalmente se inscrever naquele curso de inglês? 🙂

Recomendação de leitura

Nem só de Internet vive o desenvolvedor. Livros são essenciais para complementar os estudos em uma linguagem. Meu atual livro de cabeceira é o Rails Solutions – Ruby on Rails Made Easy de Justin Williams ainda sem tradução para o português. De leitura fácil e com exemplos práticos ele aborda os princípios básicos do RoR, passando pela introdução a linguagem, princípios e fundamentos, instalação em diversas plataformas, recomendação de ferramentas de edição, síntaxe básica, classes e objetos, modelos, migrações, controllers, visões, AJAX, autenticações, plug-ins, processo de controle de transferência para a produção com o Capistrano e finalmente como bônus, a criação e controle testes.

O livro não aborda a última versão do Rails (2). Poucos comandos precisam ser adaptados, mas nada muito complexo. Uma rápida visita ao Google resolve as incompatibilidades.

Conteúdo
Introduction to Ruby on Rails
Installing Rails
Ruby for Rails Developers
Getting Started with Rails
More Advanced Rails
Formatting Data
Introduction to Ajax
Bringing Forms to Life with Ajax
Uploading Files and Sending Attachments
User Authentication and Session Management
Customizing Rails Views
Using Rails Plug-ins and Engines
Deploying with Capistrano

Uma prévia do livro pode ser visto no Google Books.

Maiores infomações, visite o site do Amazon.

Muita atenção nas convenções

Um dos motivos do Rails ser tão produtivo é o fato dele trabalhar com convenções. Com isso, abstrai-se do desenvolvedor a necessidade desta tarefa, ganhando – muito – tempo. Dentre as convenções, uma refere-se a criação dos atributos de um modelo, gerando na migração, os campos nas tabelas. Note esta migração criada por mim:


create_table :liners do |t|
t.column :Codigo, :string, :limit => 3
t.column :Descricao, :string, :limit => 30
t.timestamps
end

add_index(:liners, :Codigo, :unique => true)

Se você já é um veterano de Rails, já deve ter percebido o que está errado. Ok. pare por aqui e pule para o próximo post. Agora, se você é como eu, um novato de pouco mais de 48h na linguagem, continue lendo.

A migração funcionou bem, a tabela foi criada, assim como os campos. O sistema também correspondeu as expectativas até que eu acrescentei a seguinte validação na classe:

validates_uniqueness_of :Codigo

Esta validação evita a criação de registros que contenham o mesmo “código” como valor. Porém, sempre que eu tentava testar o formulário com esta validação habilitada, lá vinha uma mensagem de exceção StatementError de meu Banco de Dados, informando que a coluna codigo não existe.

Como não? Ela (a coluna) está lá! Certo? Outras validações como validates_presence_of :Codigo também está lá na classe e funciona! O que está errado?
A resposta é que não observei a convenção. Os campos no Rails devem estar em totalmente em minúsculas.

Uma rápida alteração no Banco de Dados e em todas as partes da aplicação para codigo e tudo voltou ao normal.

Ainda existe um outro problema nesta minha codificação. O fato dos atributos estarem escritos em português ao invés de inglês, mas isso é um problema para ser discutido em outro momento.

Ou seja, as convenções são uma mão na roda no ganho da produtividade, porém exige do desenvolvedor (principalmente o iniciante) o seu preço: Conhecê-las intimamente.

Instalação do Rails debaixo de um Proxy

A dica a seguir é para sistemas Windows.

Uma vez baixado e instalado o Ruby, normalmente um dos próximos passos é a instalação do Rails. Se você estiver numa rede que exige passar por um Proxy para acessar a Internet, provavelmente receberá como resposta um erro após o comando:

gem install rails --include-dependencies

Para que o gem reconheça o servidor do proxy digite no prompt do DOS:

set http_proxy=http://endereço IP:Porta

onde: Endereço IP é o endereço do Proxy e Porta o número do serviço HTTP.

Feito isso, execute o comando de instalação do Rails novamente e seja feliz 😉