Apuntes de Rails

Migrando el blog a Octopress

2012-05-20T20:15:00+02:00

Hacía siglos que no escribía en este blog, al principio pensé que era sólo que no tenía nada que escribir, pero después me di cuenta que una de las cosas que más pereza me daba de ponerme a escribir algo era usar una interfaz web para publicar, que además iba bastante lenta en el hosting donde tenía el blog. Había migrado el blog del Simplelog original a Drupal hacía unos cuantos meses, incluso hice la migración de Drupal 6 a Drupal 7, pero no me decidía a escribir nada.

Últimantente le he cogido el gustillo a Git como control de verisones y a editar ficheros en Vim y pensé que me resultaría más cómodo usar un gestor de blogs como Octopress para publicar. En Octopress los posts son ficheros que editas con cualquier editor y el sitio web se genera como html estático que luego subes a algún sitio, en mi caso a Heroku. Además puedes ver cómo queda todo en local antes de subirlo al servidor.

Así que me puse manos a la obra y aquí está el blog con Octopress, con un theme de Alessandro Melandri, que ya iré modificando más a mi gusto, y los comentarios con Disqus, ya que al pasar a un blog con html estático la gestión de comentarios hay que externalizarla.

Los comentarios de los posts antiguos los he dejado como comentarios estáticos dentro de cada post, porque no me parecía buena idea importarlos a Disqus con los datos (p.ej. email) de gente que cuando hizo el comentario no lo hizo ahí, y yo no soy nadie para darle el email de otra persona a un servicio externo.

Creo que con este cambio le daré un poco más de vidilla al blog.

Desactivar servicios en el arranque de Ubuntu

2012-05-20T17:39:00+02:00

Últimamente he instalado muchos servicios nuevos en mi portátil para ir probando, pero que no uso a diario, como PostgreSQL, Redis, MongoDB, CouchDB, etc. y no quiero que se arranquen automáticamente al inicio para que no consuman recursos innecesarios si no los estoy usando. Como siempre google tiene la respuesta y esta vez estaba en http://superuser.com/a/418012.

sudo update-rc.d mysql disable 2

This will rename the sym link to start with ‘K’ and the service won’t start-up on boot. You can then re-enable it at any time if you do decide you want it to start-up on boot.

Presentaciones de la Conferencia Rails 2011

2012-05-20T14:51:00+02:00

Estaba esperando a que se publicasen los vídeos de la Conferencia Rails 2011 para hacer un post con los enlaces, pero como parece que los vídeos se retrasan y que ya no habrá más ediciones de la conferencia, dejo aquí un enlace al gist en el que recopilé en su momento los enlaces a las presentaciones de las charlas que se dieron.

Conferencia Rails 2010

2010-11-14T20:34:00+01:00

La semana pasada tuvo lugar la 5ª Conferencia Rails, la 4º a la que asisto.

Este año ha habido un sólo track y además la conferencia se ha hecho más internacional y todas las charlas fueron en inglés. Lo de un único track me ha gustado bastante, así no hay dilemas a la hora de escoger a qué charla asistir y supongo que es más fácil para la organización gestionar sólo una sala. Sobre el idioma, a los hispanos prefiero escucharlos en español, pero la verdad es que me da igual, siempre que los ponentes no tengan un acento de esos complicados de pillar (el año pasado hubo un par que me costaba seguir).

Pronto estarán disponibles los vídeos pero mientras hago aquí una lista de las slides publicadas hasta ahora para encontrarlas más fácilmente.

[ACTUALIZACIÓN] Videos publicados en http://globalplaza.org/spaces/conferencia-rails/events/conferencia-rails-2010

Charlas

How do I do what I do? (and why) (Raúl Murciano)

Dexy (Ana Nelson)
Slides: http://www.slideshare.net/ananelson/dexy-on-rails

To Localise or not to Localise, that is the question (Elizabeth Sánchez, Carlos Hernández)

Meet CouchDB (Esti Álvarez)
Slides: http://www.slideshare.net/estialvarez/meet-couch-db

Node.js & Ruby (Christian Kvalheim)
Slides: http://www.slideshare.net/christkv/nodejs-and-ruby

Derailed Cucumber (Alan Kennedy & Borja Arias)

CQRS Diet (Luismi Cavallé)
Slides: http://www.slideshare.net/cavalle/the-cqrs-diet

Powerful UX (Lori M. Olson)
Slides: http://www.slideshare.net/wndxlori/powerful-ux-not-just-for-desktops-anymore

Geospatial capabilities in Ruby (Javier de la Torre, Fernando Blat)
Slides: http://www.slideshare.net/jatorre/geospatial-capabilities-on-ruby

Swallowing the Pair Programming Pill (Jim ‘Big Tiger’ Remsik)

Neo4j (Pablo Delgado)
Slides: http://www.slideshare.net/pablete/neo4j-for-ruby-and-rails
Code: https://github.com/pablete/conferenciarails2010

HTML5 WebSockets, Ruby and NodeJS (Pedro Palazón)
Slides (pdf): http://tinyurl.com/37zxoo9

Documenting From The Trenches (Xavier Noria)

Simple Data Visualization with JS (Eli Kroumova)
Slides: https://github.com/elika/code_cr2010/raw/master/slides.pdf
Code: http://github.com/elika/code_cr2010

Rails is not Enough (Javier Ramírez)
Slides: http://www.slideshare.net/supercoco9/rails-is-not-enough-by-javier-ramirez-at-conferencia-rails-2010-in-madrid-spain

Lightning Talks Productivity Tips for Rails Developers (Alberto Perdomo)
Social Stream (Antonio Tapiador)

Workshops Compass and the 960 Framework (Juanjo Andrés Prado) https://github.com/aentos/workshop_compass

Process Automation (Jorge Dias) http://mrdias.com/2010/11/04/conferencia-rails-workshop.html

RejectConf
http://www.slideshare.net/sergio.gil/the-total-ide
http://www.slideshare.net/linkingpaths/you-dont-get-8000-customers-without-working-like-a-mule
http://prezi.com/srl5u25videa/conversaciones-entre-platon-aristoteles-y-amigos-sobre-software/

Migración de ficheros de FileColumn a Paperclip

2010-10-30T10:49:00+02:00

Dejo aquí una chuletilla para migrar los attachments de FileColumn a Paperclip que tenía por ahí guardada desde hace meses.

En este caso lo hice en la migración pero se puede hacer en una tarea rake, o directamente desde la consola. Una vez que tienes los campos necesarios para Paperclip, y los datos del attachment definidos en el modelo, puedes hacer:

Modelo.all.each do |f| 
  f.fichero = File.open("#{RAILS_ROOT}/public/modelo/fichero/#{f.id}/#{f.fichero_viejo}",'rb')
  f.save
end

Se puede mejorar mucho, pero como era sólo una vez esto me sirvió, lo dejo aquí por si a alguien más le sirve como punto de partida.

class FdsAPaperclip ActiveRecord::Migration                                                                                                                
  def self.up
    rename_column :fds, :fichero, :fichero_viejo
    add_column :fds, :fichero_file_name, :string
    add_column :fds, :fichero_content_type, :string
    add_column :fds, :fichero_file_size,    :integer
    add_column :fds, :fichero_updated_at,   :datetime

    Fds.all.each do |f| 
      f.fichero = File.open("#{RAILS_ROOT}/public/fds/fichero/#{f.id}/#{f.fichero_viejo}",'rb')
      f.save
    end 

  end 

  def self.down
    rename_column :fds, :fichero_viejo, :fichero
    remove_column :fds, :fichero, :fichero_file_name
    remove_column :fds, :fichero_content_type
    remove_column :fds, :fichero_file_size
    remove_column :fds, :fichero_updated_at
  end 
end

Borrar sesiones viejas en Rails 2.3 con ActiveRecordStore

2009-06-24T16:59:00+02:00

Tarea rake para borrar las sesiones que no se han utilizado en las ultimas 3 horas.

desc "Borrar de la base de datos la sesiones que han expirado ."
task :delete_old_sessions => :environment do
 sesiones = ActiveRecord::SessionStore::Session.find(:all, :conditions => ['updated_at < ?', 3.hours.ago])
 sesiones.each {|s| s.delete}
end

Instalación de Feedzirra en Ubuntu 8.04

2009-05-15T23:14:00+02:00

Feedzirra en un parser de feeds muy rápido, basado en nokogiri y libxml.

Primero hay que instalar nokogiri:

sudo aptitude install libxslt-dev libxml2 libxml2-dev
sudo gem install nokogiri

y luego feedzirra:

sudo apt-get install libcurl4-openssl-dev
sudo gem install pauldix-feedzirra -s http://gems.github.com

Instalación de Rails y Passenger en Ubuntu 8.04 (Hardy)

2009-03-11T11:37:00+01:00

Instalación de ruby:

sudo apt-get install build-essential 
sudo apt-get install ruby rdoc ri irb libopenssl-ruby1.8 ruby1.8-dev

Instalación de rubygems desde las fuentes, porque los paquetes para Ubuntu no están disponibles para la última versión:

cd /usr/local/src/
sudo wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz
sudo tar xzfv rubygems-1.3.1.tgz
cd rubygems-1.3.1
sudo ruby setup.rb

sudo ln -s /usr/bin/gem1.8 /usr/bin/gem

Ahora puedes borrar los ficheros que has descargado en/usr/local/src/ si quieres.

Instalación de sqlite3 (opción por defecto a partir de rails 2 para la base de datos):

sudo apt-get install sqlite3 libsqlite3-dev
sudo gem install sqlite3-ruby

Instalación de Rails:

sudo gem install rails

Instalación de apache y mysql:

sudo apt-get install apache2 
sudo apt-get install mysql-server mysql-client libmysqlclient15-dev

sudo gem install mysql

Para usar virtual hosts en apache quitar la linea

NameVirtualHost *

de /etc/apache2/sites-available/default

Cambiar la primera linea por <VirtualHost *:80>

En /etc/apache2/apache2.conf poner

NameVirtualHost *:80

<IfModule mod_ssl.c>
    NameVirtualHost *:443
</IfModule>

antes de

# Include of directories ignores editors' and dpkg's backup files,
# see README.Debian for details.

# Include generic snippets of statements
Include /etc/apache2/conf.d/

# Include the virtual host configurations:
Include /etc/apache2/sites-enabled/

Crear /var/www/default y mover ahí el index.html que hay en /var/www

Cambiar el DocumentRoot de /etc/apache2/sites-available/default al nuevo directorio.

Instalación de Passenger (a.k.a mod_rails):

sudo gem install passenger
sudo passenger-install-apache2-module

Y seguir las instrucciones. No te olvides de poner las tres líneas que te dice Passenger en el fichero de configuración de apache /etc/apache2/apache2.conf (yo lo pongo antes de lo del VirtualHost del párrafo anterior).

Otra opción de instalación para Ubuntu Hardy 8.04 es el paquete que ha hecho BrightBox.

Luego en el virtual host para la aplicación Rails pones como DocumentRoot la ruta al directorio public de la aplicación y ya está. Si quieres afinar más la configuración mírate la guía de usuario de Passenger.

Euruko 2009 en Barcelona, 9-10 de mayo

2008-12-10T19:15:00+01:00

Pues sí, ya tenemos fechas oficiales para la próxima Euruko (European Ruby Conference), será el fin de semana del 9-10 de Mayo de 2009 en Barcelona, en el Citilab.

Nos vemos por allí.

Actualizar RubyGems a la versión 1.3.1

2008-12-02T13:50:00+01:00

La versión 1.1 y la 1.2 de RubyGems tienen problemas para actualizarse, si después de ejecutar

$ sudo gem update --system

ves un “Nothing to update”, prueba a instalar y ejecutar la gema rubygems-update:

$ sudo gem install rubygems-update
$ sudo update_rubygems

Y a correr :)

Cierre del plazo de inscripción para la Conferencia Rails 2008

2008-10-30T14:54:00+01:00

Como la mayoría ya sabréis, la Conferencia Rails 2008 será los próximos días 13 y 14 de noviembre en Madrid, en la Escuela de Teleco.

Para cerrar temas de catering, sobre todo para la cena del jueves, desde el equipo de organización necesitamos cerrar las inscripciones y los pagos el próximo día 5 de noviembre (el día 5 tendría que estar ya el pago en nuestra cuenta), para que de tiempo a organizarlo todo.

Así que si vas a venir y todavía no te has apuntado, ¿a qué esperas? Ya sabemos que estas cosas se suelen dejar para el final, pero necesitamos tener cerrado el número de asistentes cuanto antes.

Si lo que pasa es que no lo tienes claro puedes mirar el calendario de charlas y terminar de convencerte de que no te lo puedes perder ;)

Migrar los repositorios svn a otro servidor

2008-08-12T18:16:00+02:00

Ya sé que lo que más mola ahora es Git, pero de momento en Dabne seguimos manteniendo nuestros repositorios de código en Subversion, mientras vamos trasteando con Git y valorando si cambiar del todo o seguir con un híbrido de svn + git.

El caso es que esta semana he tenido que mover los repos a un nuevo servidor y así es cómo lo he hecho.

En el servidor donde están los repos hay que hacer un ‘dump’ de cada uno de ellos, copiarlos al servidor 2, y cargarlos en un repo nuevo recién creadito.

Sería así:

serv1$ svnadmin dump nombre_repo > nombre_repo.dump

Se copian los ficheros .dump al servidor 2 y se hace:

serv2$ svnadmin create nombre_repo
serv2$ svnadmin load nombre_repo < nombre_repo.dump

Como tenía varios he probado a hacerlo con un scriptcillo en ruby directamente desde la línea de comandos:

serv1$ ruby -e "Dir.foreach('.'){|x| system \"svnadmin dump #{x} > #{x}.dump\"}"

serv2$ ruby -e "Dir.glob('*.dump'){|x| system \"svnadmin create #{x.split('.')[0]} \"}"
serv2$ ruby -e "Dir.glob('*.dump'){|x| system \"svnadmin load #{x.split('.')[0]} < #{x} \"}"

Si la url del repositorio cambia luego en cada copia de trabajo hay que ejecutar:

$ svn switch --relocate url_antigua url_nueva

Cuidado con lo que va delante de relocate que son dos -, no uno de esos largos.

Esta vez he configurado el acceso a los repositorios con apache2 por https, pero eso queda para otro post.

Recuperar contraseñas con restful_authentication

2008-04-07T22:41:00+02:00

Continuación del post anterior para recuperar las contraseñas olvidadas.

Crear una migration para añadir un campo reset_code al modelo User

$  script/generate migration password_reset_code


class PasswordResetCode < ActiveRecord::Migration
  def self.up
    add_column "users", "password_reset_code", :string, :limit => 40
  end

  def self.down
    remove_column "users", "password_reset_code" 
  end
end

Añanir los siguientes métodos a app/models/user.rb


  def forgot_password
    @forgotten_password = true
    self.make_password_reset_code
  end

  def reset_password
    # First update the password_reset_code before setting the 
    # reset_password flag to avoid duplicate email notifications.
    update_attributes(:password_reset_code => nil)
    @reset_password = true
  end

  def recently_reset_password?
    @reset_password
  end

  def recently_forgot_password?
    @forgotten_password
  end

  protected

  def make_password_reset_code
    self.password_reset_code = Digest::SHA1.hexdigest( Time.now.to_s.split(//).sort_by {rand}.join )
  end

Crear los modelos user_notifier.rb y user_observer.rb


# app/models/user_observer.rb
class UserObserver < ActiveRecord::Observer
  
  def after_save(user)
    UserNotifier.deliver_forgot_password(user) if user.recently_forgot_password?
    UserNotifier.deliver_reset_password(user) if user.recently_reset_password?
  end
end


# app/models/user_notifier.rb
class UserNotifier < ActionMailer::Base

  def forgot_password(user)
    setup_email(user)
    @subject    += 'Contraseña olvidada'
    @body[:url]  = "#{HOST}/passwords/reset_password/#{user.password_reset_code}" 
  end

  def reset_password(user)
    setup_email(user)
    @subject    += 'Su contraseña ha sido reseteada.'
  end

  protected
  def setup_email(user)
    @recipients  = "#{user.email}"
    @from        = "notifier@midominio.com"
    @subject     = "[midominio.com] "
    @sent_on     = Time.now
    @body[:user] = user
  end
end

En app/views/user_notifier/ crear los ficheros forgot_password.html.erb y reset_password.html.erb

# app/views/user_notifier/forgot_password.html.erb
<%= @user.login %>, pinche en el enlace para resetear su contraseña

<%= @url %>


# app/views/user_notifier/reset_password.html.erb
<%= @user.login %>, su contraseña ha sido reseteada.

En config/environment.rb añadir el observer:

# Activate observers that should always be running
# config.active_record.observers = :cacher, :garbage_collector
config.active_record.observers = :user_observer

Crear un controlador para gestionar las contrseñas olvidadas y los reseteos:


# app/controllers/passwords_controller.rb
class PasswordsController < ApplicationController
   
  skip_filter :login_required
   
  def forgot_password
    return unless request.post?
    if @user = User.find_by_email(params[:email])
      @user.forgot_password
      @user.save
      redirect_to(login_path)
      flash[:notice] = "Hemos envíado un enlace para resetear la contraseña a su correo electrónico." 
    else
      flash[:error] = "No se ha encontrado ningún usuario con esa dirección de correo electrónico." 
    end
  end

  def reset_password 
    return unless request.post?
    @user = User.find_by_password_reset_code(params[:id]) if params[:id]
    if @user.nil? 
      flash[:error] = "Código inválido."
      return
    end
    return if @user unless params[:password]
    begin
      if (params[:password] == params[:password_confirmation])
        @user.password_confirmation = params[:password_confirmation]
        @user.password = params[:password]              
        @user.reset_password
        @user.save!
        flash[:notice] = "Su contraseña ha sido reseteada, ya puede entrar con la nueva contraseña."
        redirect_back_or_default(login_path)                  
      else
        flash[:error] = "Las contraseñas no coinciden."
      end
    
      rescue ActiveRecord::RecordInvalid
        flash[:error] = "Por favor introduzca información válida."
      end
    end

end

En app/views/passwords/


# app/views/passwords/forgot_password.html.erb
¿Olvidó su contraseña? 
<% form_tag url_for(:action => 'forgot_password') do %>
    Correo electrónico: 

    <%= text_field_tag :email, "", :size => 50 %>
    <%= submit_tag 'Recuperar contraseña' %>
<% end %>


# app/views/passwords/reset_password.html.erb
Resetear contraseña
<% form_tag url_for(:action => "reset_password") do %>
    Contraseña: 

    <%= password_field_tag :password %>
    Confirmar contraseña

    <%= password_field_tag :password_confirmation %>
    <%= submit_tag "Resetear contraseña" %>    
<% end %>

Autenticación de usuarios con restful_authentication

2008-04-07T19:55:00+02:00

Pasos para crear una aplicación rails con autenticación de usuarios.

Crear la aplicación rails:

$ rails myapp
$ cd myapp

Instalar el plugin restful_authentication:

$  script/plugin install http://svn.techno-weenie.net/projects/plugins/restful_authentication/

Generar el sistema de autenticación:

$ script/generate authenticated user session
$ rake db:migrate

En config/routes.rb añadir lo siguiente antes de las rutas por defecto (las dos últimas)

map.resources :users
map.resource  :session, :controller => 'session'

map.signup '/signup', :controller => 'users', :action => 'new'
map.login  '/login', :controller => 'session', :action => 'new'
map.logout '/logout', :controller => 'session', :action => 'destroy'

En app/controllers/application_controller.rb poner la línea siguiente, que viene en los controladores user_controller.rb y session_controller.rb que ha creado el plugin.

include AuthenticatedSystem

Poniendolo en application_controller.rb hacemos que la autenticación esté disponible para todos los controladores.

Ahora en los controladores para los que queramos restringir el acceso a usuarios autenticados tendremos que poner un filtro:

before_filter :login_required

A este filtro le podemos poner parámetros para indicarle que sólo se aplique a algunas acciones o que se aplique a todas excepto a algunas, por ejemplo:

before_filter :login_required, :only => [:create, :destroy]
before_filter :login_required, :except => [:index, :show]

En mi caso últimamente es habitual que necesite controlar el acceso a toda la aplicación salvo a unas pocas acciones por lo que pongo el before_filter en application_controller.rb y luego pongo un skip_before_filter donde sea necesario, que en este caso es en users_controller.rb y session_controller.rb para permitir crear nuevos usuarios y hacer login, que en realidad es crear una nueva session. Por tanto en estos dos controladores pongo:

skip_before_filter :login_required, :only => [:new, :create]

Si además hay una portada de la aplicación pública también habrá que aplicarle esto.

Para hacer que el registro sea con activación de usuarios por email, ver este otro post.

Mostrando el contenido del flash en Rails de forma compacta

2008-04-07T19:44:00+02:00

No me acuerdo de dónde lo copié la primera vez, pero desde entonces ha ido pasando siempre de un proyecto a otro, porque es la forma que más me gusta de hacerlo.

En app/views/layouts/application.html.erb:

<% flash.each do |key, msg| -%>
  <%= content_tag :div, msg, :class => key, :id => 'flash' %>
<% end -%>

Esto crea un div con id flash y class la clave del hash, que normalmente será error o notice.

Luego en la css pones los estilos correspondientes y ya queda mucho mejor.


   #flash {
    padding: 0.5em;
    font-weight: bold;
   }
   .notice {
     background-color: #fff;
     color: #333;
     border: 1px solid green; 
   }
   .error {
     background-color: #ff6666;
     color: #333;
     border: 1px solid red; 
   }

Bogofilter y Evolution en Ubuntu 7.10

2008-03-30T10:54:00+02:00

Ayer, entre caja y caja, estuve actualizando la Ubuntu de mi pc de sobremesa de la 7.04 a la 7.10 y ya con la 7.10 Gutsy Gibbon funcionando me di cuenta que bogofilter, el filtro antispam que tenía funcionando antes en Evolution no estaba funcionando, ni siquiera actualizaba la bd de aprendizaje.

Después de googlear un poco y ver este bugreport me acorde que cuanod lo había instalado en el portátil, que ya tenía Ubuntu 7.10, además de los pasos normales, había tenido que activar el plugin de antispam en Editar -> Preferencias -> Opciones de Correo -> Spam.

En la versión anterior sólo había que instalar el paquete bogofilter (sudo apt-get install bogofilter), activar el plugin de bogofilter en Evolution y desactivar el de spamassasin para que no generara conflictos ( en Editar -> Complementos), reiniciar Evolution y emnpezar a enseñarle qué mensajes son spam marcándolos como tal. También hace falta marcar alguno como no spam para que empiece a aprender, yo para esto marqué algunos mensajes que no eran spam como spam y luego desde la carpeta de spam los volví a marcar como no spam. Además al principio (unos días) hay que revisar la carpeta de spam para localizar falsos positivos y marcarlos como no spam para que aprenda. Bogofilter aprende rápidoy después de unos días ya no suele falsos positivos.

Cambiar el tamaño por defecto de los text_field y text_area

2008-03-12T15:41:00+01:00

Por fin he descubierto cómo se cambia el tamaño por defecto de los text_field y los text_area en Rails:

ActionView::Helpers::InstanceTag::DEFAULT_FIELD_OPTIONS = { "size" => 80 }
ActionView::Helpers::InstanceTag::DEFAULT_TEXT_AREA_OPTIONS = { "cols" => 80, "rows" => 10 }

Así en vez de modificar los tamaños de los campos uno a uno en los formularios puedo poner por defecto en el environment el valor que más uso y sólo especificarlo en las excepciones.

Llevaba tiempo buscándolo :)

Programación ágil con Ruby on Rails

2008-01-28T22:13:00+01:00

Se nos había pasado, poner por aquí, el último artículo que publicamos hace unas semanas en la revista de Sólo Programadores sobre Ruby on Rails donde explicamos como hacer una sencilla aplicación de encuentros digitales.

“La aplicación que vamos a desarrollar a lo largo del artículo sirve para gestionar encuentros digitales. Como es sabido, los encuentros digitales se organizan en sitios web, y permiten a los visitantes formular preguntas que, en un día y hora señalados, serán respondidas por un única persona, habitualmente famosa. Finalizado el encuentro, la lista de preguntas y respuestas queda disponible para su posterior lectura. Por regla general las preguntas son filtradas o moderadas, según su pertinencia, y solo pueden ser respondidas por el famoso/a en cuestión.”

Se puede descargar el pdf de la web de Dabne.

Orden por defecto de los elementos de una asociación

2008-01-17T20:41:00+01:00

Un ejemplo:

Tenemos talleres de formación y para cada taller puede haber varias sesiones en diferentes fechas.


class Sesion < ActiveRecord::Base
   belongs_to :taller
end


class Taller < ActiveRecord::Base
   has_many :sesiones, :order => 'fecha'   
end

Así cuando hagas @taller.sesiones, por defecto estarán ordenadas por fecha.

Rake task para generar diagramas con RailRoad

2007-12-28T17:55:00+01:00

Hoy estaba usando RailRoad para generar los diagramas de modelos y de controladores de un proyecto Rails en el que estoy trabajando y he visto que en la página de RailRoad venía el código (gracias a Thomas Ritz) de una tarea rake que genera los diagramas en svg y los deja en el directorio doc de la aplicación.

Como también quería que generase los diagramas en png la he modificado para que los incluya. Queda así (lib/tasks/diagrams.rake):


# Rake task tomada de la página de Railroad (http://railroad.rubyforge.org/)
# Gracias a Thomas Ritz por el código (http://www.galaxy-ritz.de/)
# Modificada por Amaia Castro (amaia@dabne.net) para incluir la generación de 
# diagramas en png.

namespace :doc do
  namespace :diagram do
    task :models do
      sh “railroad -i -l -a -m -M | dot -Tsvg | sed ‘s/font-size:14.00/font-size:11.00/g’ > doc/models.svg”
    end
    task :models_png do
      sh “railroad -i -l -a -m -M | dot -Tpng | sed ‘s/font-size:14.00/font-size:11.00/g’ > doc/models.png”
    end

    task :controllers do
      sh “railroad -i -l -C | neato -Tsvg | sed ‘s/font-size:14.00/font-size:11.00/g’ > doc/controllers.svg”
    end
    task :controllers_png do
      sh “railroad -i -l -C | neato -Tpng | sed ‘s/font-size:14.00/font-size:11.00/g’ > doc/controllers.png”
    end
  end

  task :diagrams_svg => %w(diagram:models diagram:controllers)
  task :diagrams_png => %w(diagram:models_png diagram:controllers_png)
  task :diagrams => %w(diagram:models diagram:models_png diagram:controllers diagram:controllers_png)
end

Para que funcione hay que tener instalada la gem railroad y, en Ubuntu (y otros linux supongo), el paquete graphviz, que es el que contiene dot y neato, para hacer la conversion de DOT a svg o png.

Luego en nuestra aplicación rails ejecutar rake doc:diagrams para generar todos los diagramas o rake doc:diagram:models para generar el de modelos en svg, por ejemplo.