Si desean saber mas sobre el proyecto pueden visitar http://boriscy.github.com/motoEx/, y si desean descargarlo y usarlo visiten http://github.com/boriscy/motoEx es un proyecto de Software Libre

Comentarles que esta versión del framework rails, corre bajo ruby 1.8.7 y preferentemente 1.9.X, ya que la velocidad de ejecución de código es mas alta que en las versiones de ruby 1.8.x.

Para probar las nuevas características de rails 3.0 solo escriban en la consola:

gem install tzinfo builder memcache-client rack rack-test rack-mount erubis mail text-format thor bundler i18n
gem install rails --pre

Informacion detallada de los cambios

Video tutorial para realizar la migración de una aplicación existente a rails 3

Ahora no hay excusas de aprender rails

Instalación en Linux

Solo ejecuten

$ sudo gem install rvm

Despues de haberse instalado la gema entonces ejecuten

$ rvm-install

Presenta una serie de opciones, si no les funciona es por que el path de sus gemas en  “~” no existe, deben editar su archivo ~/.bash_profile y ~/.bashrc, y añadan lo siguiente al final de estos archivos.

PATH=$PATH:~/.gem/ruby/1.8/bin
export $PATH

Entonces deben abrir una nueva ventana de consola ejecuten el comando rvm-install para ver como funciona. Ahora instalemos Ruby 1.9.1

$ rvm install 1.9.1

Instala Ruby 1.9.1 y el tiempo de instalación depende de la velocidad de su internet y la velocidad de su máquina. Una ves finalizada la instalación ejecuten.

$ rvm 1.9.1
$ ruby -v
ruby 1.9.1p243 (2009-07-16 revision 24175) [x86_64-linux]
$ which ruby
\/home/wayne/.rvm/ruby-1.9.1-p243/bin/ruby

Listo ya tienen Ruby 1.9.1, es posible instalarse otras versiones de Ruby como Jruby, IronRuby, etc, solo vean el sitio web para mas detalles. Una nota importante es de que cada ves que ejecuten el comando rvm 1.9.1 solo estara activa en la ventana que ejecutaron este comando si desean que la versión se mantenga como la versión por defecto ejecuten.

 $ rvm 1.9.1 --default

Si desean regresar a como eran las cosas antes de ejecutar este comando ejecutan

$ rvm system --default

Como instalar otras versiones

Si desean instalar otras versiones deben cumplir con las dependencias http://rvm.beginrescueend.com/requirements/. Por ejemplo para poder instalar jRuby en Debian:

$ sudo aptitude install sun-java6-bin sun-java6-jre sun-java6-jdk
$ rvm install jruby

Para Gentoo:

$ sudo emerge dev-java/sun-jdk dev-java/sun-jre-bin
$ rvm install jruby

bueno si hacen click en el vinculo tendrán mas detalles

1. lo guardan como lib/custom_form_builder.rb
2. En el config/environment.rb al final escriben include ‘custom_form_builder’
3. Aumenten al final del archivo config/initializers/formtastic.rb Formtastic::SemanticFormHelper.builder = MyCustomFormBuilder

$(document).ready(function() {
    // Define the dateFormat for the datepicker
    $.datepicker._defaults.dateFormat = 'dd M yy';

    /**
     * Sets the date for each select with the date selected with datepicker
     */
    $('input.ui-date-text').live("change", function() {
        var sels = $(this).siblings("select:lt(3)");
        var d = $.datepicker.parseDate($.datepicker._defaults.dateFormat, $(this).val() );

        $(sels[0]).val(d.getFullYear());
        $(sels[1]).val(d.getMonth() + 1);
        $(sels[2]).val(d.getDate());
    });

    /**
     * Replaces the date or datetime field with jquey-ui datepicker
     */
    $(’.date, .datetime’).each(function(i, el) {
        var input = document.createElement(’input’);
        $(input).attr({’type’: ‘text’, ‘class’: ‘ui-date-text’});
        // Insert the input:text before the first select
        $(el).find(”select:first”).before(input);
        $(el).find(”select:lt(3)”).hide();
        // Set the input with the value of the selects
        var values = [];
        $(input).siblings(”select:lt(3)”).each(function(i, el) {
            var val = $(el).val();
            if(val != ”)
                values.push(val);
        });
        if( values.length > 1) {
            d = new Date(values[0], parseInt(values[1]) - 1, values[2]);
            $(input).val( $.datepicker.formatDate($.datepicker._defaults.dateFormat, d) );
        }

        $(input).datepicker();
    });
});

Aunque hay un problema con el Internet Explorer (solo probe con IE7), cuando uno cambia la fecha sin usar el datepicker sino escribiendola esta no es guardada correctamente, haber si lo resulven y lo testean con varios browsers.

class Archivo < ActiveRecord::Base

  before_create :adicionar_usuario

  belongs_to :usuario
  has_many :hojas

  validates_associated :usuario
  validates_presence_of :nombre
  validates_format_of :archivo_excel_file_name, :with => /\A^.+\.xls$\Z/i, :message => 'Solo se permite archivos excel ".xls"'

  attr_accessible :archivo_excel, :nombre, :descripcion

  has_attached_file :archivo_excel, :path => "archivos/:id/:basename.xls"

 # Validacion de tipos de contenido para excel
  validates_attachment_content_type :archivo_excel, :content_type => ['application/vnd.ms-excel'],
                        :message => ‘Solo se permite archivos Excel’
 #’application/x-msexcel’,'application/ms-excel’, ‘application/msexcel’, ‘application/x-excel’

  validates_attachment_presence :archivo_excel, :message => “Debe ingresar un archivo excel”

protected
  def adicionar_usuario
    self.usuario = UsuarioSession.find.record
  end

end

Además estoy usando Authlogic para hacer la autenticación, junto con shoulda. El test del modelo es de la siguiente forma:

require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')

describe Archivo do

  it{should belong_to(:usuario)}
  it{should validate_presence_of(:nombre)}

  before(:each) do

    archivo = File.join(RAILS_ROOT, 'ejemplos/VentasPrecio2000-2008.xls')
    up = ActionController::UploadedStringIO.new
    up.original_path = archivo
    up.content_type = 'application/vnd.ms-excel'
    @archivo_params = {
      :nombre => 'Excel',
      :archivo_excel => up
    }
    @usuario_mock = mock_model(Usuario, :id => 1, :nombre => 'Juan')
    Usuario.stub!(:find).with(kind_of(Fixnum)).and_return(@usuario_mock)
    @us = mock("record", :record => @usuario_mock)
    UsuarioSession.stub!(:find).and_return(@us)
  end

  def create_archivo
    @archivo = Archivo.create(@archivo_params)
  end

  it "debe crear" do
    a = Archivo.create!(@archivo_params)
  end

  it "debe guardar el usuario" do
    create_archivo()
    @archivo.usuario.id.should == 1
  end
end

Lo importante aquí está en cuando defino el before(:each) del test rspec, en el cual creo un mock ActionController::UploadedStringIO.new, despues defino la ruta y el tipo de content_type para el archivo que hago upload. Esta es la clave para poder hacer el subida del archivo y de que pase el test.

El problema para testear con Cucumber era mucho mas simple pero me llevo algún tiempo darme cuenta de ello (mi amigo Felix Carreño lo hizo), lo que sucedía era que Webrat tiene un comando para poder subir archivos en el cual solo se pasa el archivo que se desea subir y este asigna al file_field que uno define en el formulario, pero además uno debe indicar el tipo de conten_type, para que el test funcione y pase la validación de contenido de paperclip, osea solo es necesario hacerlo de esta forma:

#Archivo que uso para mi test
archivo = File.join(RAILS_ROOT, "ejemplos/VentasPrecio2000-2008.xls")
attach_file "archivo[archivo_excel]“, archivo, ‘application/vnd.ms-excel’

  authlogic:
    error_messages:
      login_blank: "no debe estar en blanco"
      login_not_found: "no es válido"
      login_invalid: "solo debe ingresar letras, números y -_@ sin espacios"
      consecutive_failed_logins_limit_exceeded: "Se sobrepaso el número consecutivo de logins, la cuenta fue desactivada"
      email_invalid: "debe ser un email válido."
      password_blank: "no debe estar en blanco"
      password_invalid: "no es válido"
      not_active: "Su cuenta no esta activa"
      not_confirmed: "Su cuenta no ha sido confirmada"
      not_approved: "Su cuenta no fue aprovada"
      no_authentication_details: "Usted no proveio ningún detalle para la autentu¡icación."
    models:
      user_session: "UsuarioSession (o lo que este usando)"
    attributes:
      user_session: # "(or whatever name you are using)"
        login: "login"
        email: "email"
        password: "contraseña"
        remember_me: "recuerdame"

recuerden mantenre los dos espacios de tabulación debido que debe estar dentro de “es”. Tambien estaba probando y haciendo algunas modificaciones a mi modelo para que authlogic funcione como yo queria entonces hice lo siguiente:

class Usuario < ActiveRecord::Base
  acts_as_authentic do |config|
    config.login_field = :login
    config.merge_validates_format_of_login_field_options(:with => /\A^[a-z-_0-9@]+$\Z/i)
    config.merge_validates_length_of_login_field_options(:within => 4..20)
  end
end

Lo cual nos permite definir otras validaciones en Authlogic.

Testeo de Authlogic

En caso de que deseen testear su código en Rspec o Cucumber con authlogic solo deben adicionar lo siguiente para Rspec en spec/spec_helper.rb o para Cucumber en features/support/env.rb

require "authlogic/test_case"
include Authlogic::TestCase

Entonces ahora esto permite realizar los test, pero no debemos olvidar crear la sesión en Authlogic de la siguiente forma:

# Agreguen los campos necesarios para su usuario
@usuario = Usuario.create(:login => 'usuario', :password => 'demo123', :password_confirmation => 'demo123')
UsuarioSession.create(@usuario)

sudo gem install less

Less nos permite transformar archivos .less a CSS y es posible realizar herencia, operaciones o tener variables, por ejempo este CSS

#header {
  color: #4D926F;
}
h2 {
  color: #4D926F;
}

se convierte en less en esto

@brand_color: #4D926F;
#header {
  color: @brand_color;
}
h2 {
  color: @brand_color;
}

O si tenemos que acceder a las largas rutas de css

#header {
  color: red;
}
#header a {
  font-weight: bold;
  text-decoration: none;
}

se convierte en esto

#header {
  color: red;
  a {
    font-weight: bold;
    text-decoration: none;
  }
}

Tambien podemos tener herencia o (mixins) como en Ruby, por ejemplo este CSS

#header {
  -moz-border-radius: 8px;
  -webkit-border-radius: 8px;
  border-radius: 8px;
}
#footer {
  -moz-border-radius: 8px;
  -webkit-border-radius: 8px;
  border-radius: 8px;
}

se convierte en

.rounded_corners {
  -moz-border-radius: 8px;
  -webkit-border-radius: 8px;
  border-radius: 8px;
}
#header {
  .rounded_corners;
}
#footer {
  .rounded_corners;
}

Tambien se pueden realizar operaciones lo cual nos permitiria convertir este CSS

#header {
  color: #333;
  border-left: 1px;
  border-right: 2px;
}
#footer {
  color: #222;
}

en esto

@the-border: 1px;
@base-color: #111;
#header {
  color: @base-color * 3;
  border-left: @the-border;
  border-right: @the-border * 2;
}
#footer {
  color: @base-color + #111;
}

Y finalmente para que se genere el archivo de CSS lo que se hace es ejecutar el siguiente comando

lessc style.less

Para poder tener mas información visiten su sitio web http://lesscss.org/

gem install ruby-debug

Una ves instalada la gema si creamos una aplicación rails queremos que esta gema solo funcione en nuestro entorno de desarrollo y test, entonces dirijanse en su aplicacion editen los archivos config/enviroments/development.rb, config/enviroments/test.rb, y aumenten la siguiente linea al final

config.gem 'ruby-debug'

Lo cual permitirá que funcione ruby-debug, en caso de que esten en algún otro Framework como Sinatra lo único que tienen que hacer es aumentar en la primera línea

require 'ruby-debug'

para poder utilizar ruby-debug lo que hay que hacer es lo siguiente, dado que tengamos el código en algún archivo para que pogamos un punto de control lo hacemos así:

def index
  @menus = Menu.all :order => "fecha DESC"
  debugger # Punto de control
  respond_to do |format|
    format.html
    format.xml {render :xml => @menus}
  end
end

enonces debo ejecutar script/server vamos a la dirección donde se ejecutará nuestro código con el navegador y volvemos donde ejecutamos el script/server, me mostrará lo siguiente:

Redirected to http://localhost:3000/menus
Completed in 32ms (DB: 1) | 302 Found [http://localhost/session]
/home/boris/rails/mayasg/app/controllers/menus_controller.rb:7
respond_to do |format|
(rdb:1)

Donde muestra (rdb:1) intoducimos list y nos mostrará el código donde esta parado, si introducimos irb y luego @menus nos devolvera la variable, como en modo consola solo que estamos debugueando y tenemos acceso a variables como session, params, etc. para salir del modo consola escribimos exit, para poder ver la lista de comandos introducimos help, para poder ver donde estamos introducimos where, para moverse en el debug ingresan step, para ver la lista de hilos introduces thread list, introduciendo var local les presentará las variables locales, y si introduces var global les mostrará un listado de las variables globales finalmente para poder continuar el script introducimos cont.

Esperó les sirva de algo este tutor saludos hasta un proximo tutor o artículo.