Trailblazer Presentations @Paris.rb

A quick overview of Trailblazer, the missing architecture for Rails.

Transcript

1. TRAILBLAZER se débarasser des modèles obèses, des ifs imbriqués 
 dans les vues et les contrôleurs
 et pleins d’autres chouettes choses
2. BAC L Ecole de Management Directeur Artistique Publicité Co-fondateur d’Air Detox Prépa HEC
3. Freelance Dev Wordpress Symfony2 Ruby on Rails
4. Pourquoi on utilise rails ?
5. Scaffolding? Simplicité? Scalabilité? Vitesse? Conventions?
7. Scaffolding? Simplicité? Scalabilité? Vitesse? Conventions?
8. Pourquoi on utilise rails ? we❤ruby pleins d’autres l’utilisent Activerecord has_many scopes
9. Mon code d’avant…
10. Il fallait venir à la conf pour voir mon bad code ;)
11. MODEL VIEW CONTROLLER
12. MODEL VIEW CONTROLLER Facades Decorators Helpers POROs … Service Objects
13. TRAILBLAZER
14. Trailblazer in a nutshell
15. Les contrôleurs deviennent de simples HTTP endpoints • authentification (si cookies) • request format • ils délèguent directement à l’opération
17. L’opération, contient toute
 la logique métier
18. Voir un truc Voir un index de trucs Commenter un truc Editer mon dashboard Thing::Index Thing::Show Comment::Create Dashboard::Update
19. C’est un high-level service object qui intègre (ou pas ^^) 
 un form object, des policies, des callbacks, un model…
21. Chaque opération valide les params à l’aide d’un Form Object (ou plusieurs)
24. Les modèles deviennent des bêbêtes Persistence Endpoints
26. L’opération à l’aide du Form va changer et persister le Model
28. Le Representer peut être utilisé pour les API dans un sens comme dans l’autre (parser ou présenter)
29. Le controller peut presenter une vue à l’ancienne ou déléguer à un ViewModel (aka Cell)
33. La fin du “Rails Callback Hell” class Thing < Activerecord::Base after_create :notify_author! def notify_author! self.users.each do |user| if … UserMailer.existing_author(user) else UserMailer.welcome_author(user) end end end
34. La fin du “Rails Callback Hell” form = User::Form.new(find_by(email: fragment["email"]) or User.new) # Le user n’existe pas form.persisted? => false form.save form.persisted? => true form.created? => true # Le user existe form.persisted? => true form.save form.persisted? => true form.created? => false
35. La fin du “Rails Callback Hell” def notify_authors! contract.users.collect do |user| if user.created? NewUserMailer.welcome_email(user.model) else ExistingUserMailer.added_email(user.model) end end end def process(params) validate(params[:thing]) do |f| f.save notify_authors! reset_authorships! end end
36. La fin du “Rails Callback Hell” class Thing::Create < Trailblazer::Operation callback do collection :users do on_add :notify_author! on_add :reset_authorship! end on_create :expire_cache! end on_add on_create on_change
38. class Thing < ActiveRecord::Base class Create < Trailblazer::Operation include Resolver policy Thing::Policy, :create? model Thing, :create builds -> (model, policy, params) do return self::Admin if policy.admin? return self::SignedIn if policy.signed_in? end ... class SignedIn < self end class Admin < SignedIn end end end
39. class Thing::Policy ... def signed_in? user.present? end def admin? signed_in? and user.email == "admin@trb.org" end
40. Thing::Create.().class #=> Thing::Create Thing::Create.(current_user: User.find(1)) #=> Thing::Create::SignedIn Thing::Create.(current_user: User.admin) #=> Thing::Create::Admin
41. it "creates valid admin" do op = Thing::Create.(thing: { name: "Rails" users: [{"email": "some@author.org"}] current_user: "admin@trb.org") thing = op.model thing.users.must_equal ["some@author.org", "admin@trb.org"] op.must_be_instance_of Thing::Create::Admin end
42. Tester avec TRB On utilise les opérations comme fixtures thing = Thing::Create.(thing: {name: "Rails", users: [{"email": "some@author.org"}]}).model op = Thing::Create.(thing: {name: "Rails", users: [{"email": « some@author.org"}]}) res, op = Thing::Create.run(thing: {name: "Rails", users: [{"email": « some@author.org »}]}) res sera true ou false op contiendra, par exemple les erreurs ou le model on le contract…
43. Tester avec TRB On teste à peine les contrôleurs test "POST /comments" do post "/comments", {comment: { body: "Awesome!" }}.to_json assert_redirect_to comment_path(operation.model) end
44. Tester avec TRB Mais on teste à fond les opérations… (Voir https://github.com/apotonick/ gemgem-trbrb/blob/chapter-08/test/ concepts/thing/operation_test.rb)
45. L’intégration des Cells avec les opérations Cell qui va bientôt pouvoir se passer d’ActionVieux API Hypermedia (rendering & deserialisation) Totalement découplé de Rails (Sinatra, Lotus…) L’intégration à venir avec une nouvelle gem call_sheet Pipelines in operations Dry-container integration Je n’ai pas parlé de
46. Créons un groupe d’entraide autour de TRB https://gitter.im/sebabouche/trailblazer-paris Le meilleur moyen d’apprendre, c’est comme toujours de pratiquer: • Créer une GEM
 Un FormBuilder complètement découplé de Rails • Améliorer une GEM
 Tyrant (github.com/apotonick/tyrant) • Travailler sur une sample app Lotus/TRB Et maintenant ?
47. Pour acheter le bouquin https://leanpub.com/trailblazer qui en plus d’être super pédagogique 
 sur pleins de concepts OOP 
 est vraiment marrant ! La dernière doc: http://trailblazer.to Chat global: https://gitter.im/trailblazer/chat
48. Merci ! @sebabouche (github, gitter) sebastien@nicolaidis.org nicolaidis.org (complètement out of date ^^)