Sondaggio

• Quanti conoscono i template di Rails?

Vuoi creare un progetto Rails?

• All'inizio pensi che questo sia sufficiente
• $ rails mycoolproject
• e configurare database.yml
• Sbagliato!

C'è tanto lavoro da fare!

• Probabilmente aggiungiamo will_paginate
• config.gem "will_paginate", :source => "http://gemcutter.org"
• Hoptoad? TzInfo?
• config.gem "hoptoad_notifier"
  config.gem "tzinfo"

restful_authentication?

• script/plugin install da github
• config.gem "rubyist-aasm", :lib => "aasm"
• script/generate authenticated user sessions ...
• Aggiungere rotte e risorse per users e sessions
• rake db:migrate
• Finito?

mongrel_rails start

• http://localhost/users/signup
• We're sorry, but something went wrong
• Dimenticato qualcosa?

Ah già!

• include AuthenticatedSystem in ApplicationController
• E quando non ci arriverà la mail di attivazione...
• config.active_record.observers = :user_observer

Si sbaglia e si perde tempo

• Capita solo a me? Spero di sì ma non ci credo. Faccio bene?
• Ci sono tante altre configurazioni da fare
• Ci sono tante possibilità di sbagliare
• Ripeterle tutte le volte è diabolico
• Non è DRY

La soluzione: i Templates

• $ vi basic_app.rb

gem "will_paginate", :source => "http://gemcutter.org"
gem "tzinfo"
gem "rubyist-aasm", :lib => "aasm"
rake("gems:install", :sudo => true)
plugin "restful_authentication",
  :git => "git://github.com/technoweenie/restful-authentication.git"
run './script/generate authenticated user session \
  --include-activation --aasm --rspec'
environment "config.active_record.observers = :user_observer"
rake("db:create") # ma c'è lo user?  
rake("db:migrate")

• $ rails mycoolproject -d postgresql
      -m basic_app.rb

Tuttavia

• Si scrive troppo
• Ci sono configurazioni ricorrenti da fare a mano o da automatizzare scrivendo codice
• Usciti a fine 2008 e al momento non avevo progetti da iniziare
• Me li sono dimenticati!

La soluzione fai da te

• Fa meno cose rispetto ai template ma le fa più in fretta
• Configura tutto fino in fondo
• Opera ad un livello di astrazione sopra ai template
• Curiosi?

TAV For Rails

• $ vi make_mycoolproject.rb

require "tav_for_rails"
include TavForRails
rails = TavForRails::Project.create("mycoolproject",
                         :database => "postgresql")
rails.add "WillPaginate"
rails.add "Aasm"
rails.add "TzInfo"
rails.install_gems
rails.add "RestfulAuthentication"

• $ ruby make_mycoolproject.rb

Magia!

• Ogni add fa tutte le configurazioni
• Project.create crea sia il db che l'utente per la connessione
• Dimostrazione!

Stato del progetto

• C'è un'API (diversa dai template) per aggiungere moduli che installano e configurano gemme, plugin, files in lib e modificano i file dell'applicazione
• Sono supportati will_paginate, restful_authentication, tzinfo, aasm, hoptoad, get_text
• Si scarica da github.com/pmontrasio/tav_for_rails

Esempio di API: add "RestfulAuthentication"

class RestfulAuthentication
  def add(args = "")
    Utils.git_clone("git://github.com/technoweenie/restful-authentication.git 
                     restful_authentication", :directory => "vendor/plugins")
    Utils.generate("authenticated user sessions --include-activation --stateful
                    --aasm #{args}")
    Utils.add_routes("  map.activate '/activate/:activation_code',
         :controller => 'users', :action => 'activate', :activation_code => nil\n
         map.resources :users, :member => { :suspend => :put, :unsuspend => :put,
         :purge => :delete }")
    Utils.db_migrate
    Utils.add_to_rails_initializer("  config.active_record.observers = :user_observer")
    Utils.copy_to_lib("restful_authentication", "authenticated_system.rb")
    Utils.add_to_application_controller("  include AuthenticatedSystem")
  end
end

• L'API di TAV for Rails è al livello di astrazione dei template

Wishlist

• Cambiare API e spostarlo "sopra" ai template
• Farne una gemma
• Verificare che installi le ultime versioni
• Trovare chi ci aggiunga i moduli che gli interessano

Volontari per partire?

Riferimenti

• Codice
• git clone git://github.com/pmontrasio/tav_for_rails.git
• Questa presentazione
• http://connettiva.eu/tav_for_rails
• Email
• paolopaolomontrasio.com

• Rails Templates
• http://bit.ly/14Kh3
• Strappy (un bel template)
• http://bit.ly/aA3IJe