Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Taming BIG Rails Applications with Component Based Architecture

Taming BIG Rails Applications with Component Based Architecture

Starting a new Rails app is a fun adventure. It’s a wide open pasture of conventions. Then it gets to a point. We all know what that point is. It’s when running the test suite takes a few minutes. It’s when you have to think hard about where new functionality goes. It’s when you have to add yet another method to the user object. It’s when tracking down bugs takes half your day.

How do you tame your large Rails application? How do you always keep your test suite small? How do you build your application in such a way that refactoring is straight forward?

We will take a look at concrete steps we can take to break down and refactor our BIG Rails application into smaller gems and engines so we can be happy once more.

Jamie Wright
PRO

August 26, 2014
Tweet

More Decks by Jamie Wright

Other Decks in Programming

Transcript

  1. BIG
    Rails Applications
    Taming

    View Slide

  2. @jwright

    View Slide

  3. A Story

    View Slide

  4. View Slide

  5. 4795 lines of code
    108 classes
    23 controllers
    66 models
    1:38 test time

    View Slide

  6. Directory
    Structure

    View Slide

  7. View Slide

  8. View Slide

  9. View Slide

  10. View Slide

  11. View Slide

  12. View Slide

  13. View Slide

  14. View Slide

  15. View Slide

  16. View Slide

  17. Search
    Market Product
    Search Results
    Product Photos
    Market Photos
    Market Culture
    Product List
    Sign Up
    Sign In
    Password Reset
    Profile
    Payment Processing
    Purchase History
    Ticket Selector
    Cart
    Checkout
    Orders
    Reservations

    View Slide

  18. OneGiant
    App

    View Slide

  19. TooMuch
    for your
    head

    View Slide

  20. New
    Functionality??

    View Slide

  21. Small
    Large
    apps
    app
    a lot
    one

    View Slide

  22. Rails
    Engines

    View Slide

  23. rails plugin new [name] —mountable

    View Slide

  24. > app
    > config
    > db
    > lib
    > log
    > vendor
    > engine_name

    View Slide

  25. > Gemfile
    > Rakefile
    > app
    > bin
    > config
    > lib
    > test
    > engine_name

    View Slide

  26. Build
    Walls

    View Slide

  27. Gives
    Box
    you a
    to talk about

    View Slide

  28. More
    Maintainable

    View Slide

  29. Example

    View Slide

  30. View Slide

  31. View Slide

  32. app/models/review.rb

    View Slide

  33. app/models/offer.rb

    View Slide

  34. db/migrate/_create_reviews.rb

    View Slide

  35. spec/integration/models/review_spec.rb

    View Slide

  36. app/views/tours/_reviews.html.erb

    View Slide

  37. app/views/tours/_review.html.erb

    View Slide

  38. 1. Namespace

    View Slide

  39. Ebert

    View Slide

  40. mkdir app/models/ebert
    mv app/models/review.rb app/models/ebert

    View Slide

  41. app/models/ebert.rb

    View Slide

  42. app/models/ebert/review.rb

    View Slide

  43. app/models/offer.rb

    View Slide

  44. mkdir spec/integration/models/ebert
    mv spec/integration/models/review_spec.rb
    spec/integration/models/ebert

    View Slide

  45. spec/integration/models/ebert/review_spec.rb

    View Slide

  46. spec/factories/reviews.rb

    View Slide

  47. 2. Concern

    View Slide

  48. app/models/offer.rb

    View Slide

  49. app/models/ebert/reviewable.rb

    View Slide

  50. app/models/ebert.rb

    View Slide

  51. app/models/offer.rb

    View Slide

  52. app/models/ebert/review.rb

    View Slide

  53. app/models/ebert/review.rb

    View Slide

  54. app/models/ebert.rb

    View Slide

  55. 3. Engine

    View Slide

  56. mkdir components
    rails plugin new ebert —mountable
    mv ebert components

    View Slide

  57. > Gemfile
    > Rakefile
    > app
    > bin
    > config
    > lib
    > spec
    > ebert
    > app
    > components

    View Slide

  58. Gemfile

    View Slide

  59. mv app/models/ebert/review.rb
    components/ebert/app/models/ebert

    View Slide

  60. mv app/models/ebert/reviewable.rb
    components/ebert/app/models/ebert

    View Slide

  61. components/ebert/lib/ebert.rb

    View Slide

  62. components/ebert/lib/ebert/engine.rb

    View Slide

  63. mv app/views/tours/_reviews.html.erb
    components/ebert/app/views/ebert
    mv app/views/tours/_review.html.erb
    components/ebert/app/views/ebert

    View Slide

  64. app/views/tours/show.html.erb
    <%= render partial: ‘ebert/reviews’ %>

    View Slide

  65. rm -rf app/models/ebert
    rm app/models/ebert.rb

    View Slide

  66. 4. Move Tests

    View Slide

  67. components/ebert/ebert.gemspec

    View Slide

  68. mv spec/integration/models/ebert/review_spec.rb
    components/ebert/spec/integration/models/ebert/

    View Slide

  69. mv db/migrate/_create_reviews.rb
    components/ebert/db/migrate

    View Slide

  70. components/ebert/lib/ebert/engine.rb

    View Slide

  71. Fin

    View Slide

  72. Considerations

    View Slide

  73. rake bundle:all

    View Slide

  74. rake test:suite:all

    View Slide

  75. gem ‘search’, path: ‘components/search’

    View Slide

  76. Way of the
    Future

    View Slide

  77. /features
    Wrapper App
    Common
    Search
    Markets Products Registration Reservations
    API
    Orders
    User
    Photos
    Ebert

    View Slide

  78. Resources

    View Slide

  79. http://bit.ly/1onMOOf
    Midwest Ruby Conf 2013 - Component Based
    Architecture in Rails [video]

    View Slide

  80. http://bit.ly/1tAMguy
    Rocky Mountain Ruby 2013 - How I
    Architected my Big Rails App [video]

    View Slide

  81. http://bit.ly/1BZXYTn
    GitHub - The Next Big Thing [code]

    View Slide

  82. http://bit.ly/VMnVFb
    Pivotal Labs - Rails Application Suites
    [blog]

    View Slide

  83. Thank You

    View Slide