thor - rsla - 13oct2009

Plataforma Tecnologia, José Valim 2009

@josevalimhttp://[email protected]

Geradores de código com Thor

Quem sou?

Desenvolvedor líder naPlataforma Tecnologia

22 anos, Engenheiro pela Escola Politécnica

Desenvolvedor rubyhá quase 3 anos

Google Summer of Code Student e contribuidor

ativo do Rails Core

Inherited Resources

Inherited ResourcesRails Footnotes

Remarkable

RemarkableFormtastic

O que está errado com os geradores do Rails 2.x?

script/generate scaffold

script/generate scaffold

ActiveRecordTestUnit

ERB

script/generate rspec_scaffold

script/generate rspec_scaffold

ActiveRecordRspecERB

script/generate dm_scaffold

script/generate dm_scaffold

DataMapperTestUnit

ERB

script/generate dm_rspec_scaffold

script/generate dm_rspec_scaffold

DataMapperRspecERB

Agnosticismo?

Remarkable + Inherited Resources +

Formtastic

Formtastic

=

Formtastic

=

script/generate remarkable_inherited_formta

stic_scaffold

Formtastic

=

script/generate remarkable_inherited_formta

stic_scaffoldFAIL?

script/generate nifty_scaffoldscript/generate dry_scaffold

Pouca reutilização de código

Sem divisão de responsabilidades

Por quê Thor?

class AppGenerator < Thor::Group def create_app_folders empty_directory “app/models” empty_directory “app/controllers” end

def copy_config_files copy_file “config/routes.rb” endend

Execute tudo...AppGenerator.start

ou selecione!app_tasks = AppGenerator.newapp_tasks.create_app_foldersapp_tasks.copy_config_files

Herança

module Rails::Generators class ScaffoldGenerator < ResourceGenerator # generation endend

Argumentos

script/generate scaffold User name:string --no-layout -o datamapper -t rspec

self.class_name

self.attributes

Opções

self.options[:orm]#=> “datamapper”

self.options.layout? #=> false

:type => :string--orm=activerecord

:type => :numeric--rails=3.0

:type => :boolean--layout --no-helpers

:type => :array--actions=index new create

:type => :hash--actions=name:string age:index

:required, :desc, :optional

Invocações

class ResourceGenerator < Thor::Group def run_dependencies invoke ModelGenerator invoke ControllerGenerator invoke “testunit:resource” endend

class ResourceGenerator < Thor::Group def run_dependencies invoke ModelGenerator invoke ControllerGenerator invoke “testunit:resource” endend

invoke ModelGenerator

invoke ModelGenerator

ModelGenerator.start

invoke ModelGenerator!=

ModelGenerator.start

Shell

Gerencia input e output

Thor::Shell::Basic

Thor::Shell::BasicApenas para Windows

Thor::Shell::Color

Thor::Shell::Web

Thor::Shell::Web

?

Qual a diferença entre geradores de código e tarefas (como rake)?

Geradores de código são um grupo de tarefas

class Alphabet < Thor def a print :a end

def b print :b endend

$ thor alphabet:a #=> “a”$ thor alphabet:b #=> “b”

class Alphabet < Thor::Group def a print :a end

$ thor alphabet #=> “ab”

class Alphabet < Thor::Group def a print :a end

$ thor alphabet #=> “ab”

Thor

Thor=

Rake

Thor=

Rake + Sake

Thor=

Rake + Sake +Rubigen

Thor=

Rake + Sake +Rubigen +

RailsTemplates

Thor::Actions==

RailsTemplates

create_file “users_helper.rb”, <<-END module UsersHelper endEND

copy_file “doc/README”, “doc/README”copy_file “doc/README”

Thor.source_root

Dir.pwd

get “http://pastie.org/2.txt”, “pastie.rb”

get “http://pastie.org/2.txt” do |content| content =~ /class (\w)+/ “#{$1 || 'content'}.rb”end

http://pastie.org/2.txt

template “doc/README”, “doc/README”template “doc/README.tt”

chmod “script/*”, 755

prepend_file “environments/test.rb” “config.gem \"rspec\"”

prepend_file “environments/test.rb” do “config.gem \"rspec\"”end

append_file “environments/test.rb” “config.gem \"rspec\"”

append_file “environments/test.rb” do “config.gem \"rspec\"”end

flag = "Rails::Initializer.run do |config|\n"

inject_into_file "config/environment.rb", "config.gem :thor", :after => flag

inject_into_class “users_controller.rb” UsersController, “before_filter :authenticate”

remove_file “doc/README”

empty_directory “doc”

directory “script”, “script”directory “script”

inside “doc” do copy_file “README”end

apply "http://gist.github.com/103208.txt"

run “ln -s ~/edge rails”

Actions específicas do Rails em:

Rails::Generators::Actions

Thor unifica APIs de geradores de código, tarefas

e templates do Rails

Rails::Generators

module Rails::Generators class ControllerGenerator < NamedBase argument :actions, :type => :array, :default => [] check_class_collision :suffix => "Controller"

def create_controller_files destination = File.join('app/controllers', class_path, "#{file_name}_controller.rb")

template 'controller.rb', destination end

hook_for :template_engine, :test_framework, :helper endend

hook_for :test_framework

hook_for :test_framework--test_framework=rspec

hook_for :test_framework--test_framework=rspec

invoke “rspec:controller”

Thorfile

Thor::RakeCompat

require File.join(File.dirname(__FILE__), 'config', 'boot')

require 'rake/testtask'require 'rake/rdoctask'require 'thor/rake_compat'

class Default < Thor include Thor::RakeCompat require 'rails/tasks'end

Show me the code!

?!

blog.plataformatec.com.br

thor - rsla - 13oct2009

Technology