Best Practices
and Gems
Best Practices
are important.
Style
- Don't use tab characters. Please. Use two spaces instead.
- Use snake_case for method and variable names, CamelCase for class and module names.
- Use space characters around operators and
{ braces }
-
test = "string interpolation" "Use #{test} when possible."
Which of these will Sam not cry about?
-
a = "really" "This" + a + "sucks"
-
b = {hello: "World"}
-
VariableTwo = 1 * 2
-
def some_method "foobar" end
Every file should have a purpose.
- Put unused files out of their misery.
- create.html.erb, user_fixtures.yml, etc.
- Pay attention to generated files.
Routing
- Technically, Rails allows you to define whatever routes you want.
- But, how helpful is
get "/users/hello", to: "AdminController#goodbye",
as: :foobar
Routing
- Keep things as resourceful as possible!
resources :students
# GET /students students#index
# GET /students/new students#new
# POST /students students#create
# GET /students/:id students#show
# GET /students/:id/edit students#edit
# PATCH/PUT /students/:id students#update
# DELETE /students/:id students#destroy
resources :students, only: [:show]
# GET /students/:id students#show
Routing
- Use member and collection to define more actions
resources :emails do
# POST /emails/:id/archive emails#archive
member do
post :archive
end
# GET /emails/archived emails#archived
collection do
get :archived
end
end
Gems
Development
- These will make development 10x better.
- Will be included on all homeworks and projects from now on.
Development
- pry + pry-byebug
- Amazing debugging
- quiet_assets
- Better server logs
- annotate
- Annotates models
- spring
- Really fast commands
- better_errors
- Awesome error pages
- guard
- Watches for file changes
In action.
simple_form
- As the name says, really simple forms!
- https://github.com/plataformatec/simple_form/
<%= form_for @student do |f| %>
<%= f.label :name %>
<%= f.text_field :name %>
<%= f.label :email %>
<%= f.text_field :email %>
<%= f.label :phone %>
<%= f.text_field :phone %>
<%= f.submit %>
<% end %>
<%= simple_form_for @student do |f| %>
<%= f.input :name %>
<%= f.input :email %>
<%= f.input :phone %>
<%= f.button :submit %>
<% end %>
slim-rails
- Slim is a really nice replacement for ERB
- https://github.com/slim-template/slim-rails
<h1>Hey everyone!</h1>
<p>This is the <%= @somevar %> page.</p>
<%= simple_form_for @student do |f| %>
<%= f.input :name %>
<%= f.input :email %>
<%= f.input :phone %>
<%= f.button :submit %>
<% end %>
<div class="some-class" id="this-div">
We can do this easily in Slim.
</div>
<% if 5 * 4 == 20 %>
<div attr="yup">I can multiply.</div>
<% end %>
h1 Hey everyone!
p This is the #{@somevar} page.
= simple_form_for @student do |f|
= f.input :name
= f.input :email
= f.input :phone
= f.button :submit
.some-class#this-div
| We can do this easily in Slim.
- if 5 * 4 == 20
div attr="yup" I can multiply
home.html.erb
home.html.slim
Go forth
and be productive.
Fall 2015 - Week 5 (continued): Gems
By Rails Decal
Fall 2015 - Week 5 (continued): Gems
- 1,026