Enter the app era with ruby on rails (rubyday)
1 like4,984 views
The document discusses how to build mobile apps by developing an API using Ruby on Rails. It demonstrates creating RESTful APIs for user authentication (signup, login), managing to-do lists and list items. It shows how to test the APIs with Cucumber and RSpec. It also describes using ActiveAdmin to build an admin interface and Backbone.js to build JavaScript apps that interact with the Rails-built API, leveraging features like the asset pipeline. The presentation encourages developing mobile apps by focusing on the API layer in Rails and using JavaScript for the frontends.
![Signup API
Scenario: signup fails with a wrong password_confirmation
When I call "/users.json" in POST with:
"""
{
"user": {
"email": "hello@abc.org",
"password": "abcde",
"password_confirmation": "abcde1"
}
}
"""
Then the JSON should be:
"""
{
"errors": { "password": ["doesn't match confirmation"] }
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-25-320.jpg)
![Lists API
Feature: Lists API
As a MCDO developer
In order to develop apps
I want to manage a user's lists
Background:
Given I login succesfully with user "aaa@abc.org"
Scenario: Default lists
When I call "/lists.json" in GET
Then the JSON should be:
"""
{
"lists": [{
"id": 1,
"name": "Personal",
"link": "http://www.example.com/lists/1",
"items_link": "http://www.example.com/lists/1/items"
}]
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-35-320.jpg)
![Lists API
Scenario: Creating a list should add it to the index
Given I call "/lists.json" in POST with:
"""
{
"list": {
"name": "foobar"
}
}
"""
When I call "/lists.json" in GET
Then the JSON should be:
"""
{
"lists": [{
"id": 2,
"name": "foobar",
"link": "http://www.example.com/lists/2",
"items_link": "http://www.example.com/lists/2/items"
}, {
"id": 1,
"name": "Personal",
"link": "http://www.example.com/lists/1",
"items_link": "http://www.example.com/lists/1/items"
}]
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-37-320.jpg)
![Lists API
Scenario: Removing a list (and the index is empty)
Given I call "/lists/1.json" in DELETE
When I call "/lists.json"
Then the JSON should be:
"""
{
"lists": []
}
"""
Scenario: Updating a list's name
When I call "/lists/1.json" in PUT with:
"""
{
"list": {
"name": "foobar"
}
}
"""
Then the JSON should be:
"""
{
"name": "foobar",
"items_link": "http://www.example.com/lists/1/items"
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-38-320.jpg)
![Lists API
Scenario: Removing a list (and the index is empty)
Given I call "/lists/1.json" in DELETE
When I call "/lists.json"
Then the JSON should be:
"""
{
"lists": []
}
"""
Let’s see some code!
Scenario: Updating a list's name
When I call "/lists/1.json" in PUT with:
"""
{
"list": {
"name": "foobar"
}
}
"""
Then the JSON should be:
"""
{
"name": "foobar",
"items_link": "http://www.example.com/lists/1/items"
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-39-320.jpg)
![Items API
Feature: Manage a list's items
As a developer
In order to manipulate the list's item
I want to access them through APIs
Background:
Given I login succesfully with user "aaa@abc.org"
Scenario: Default items
When I call "/lists/1/items.json" in GET
Then the JSON should be:
"""
{
"items": [{
"name": "Insert your items!",
"position": 0
}],
"list_link": "http://www.example.com/lists/1"
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-41-320.jpg)
![Items API
Scenario: Moving an element to the top
Given I call "/lists/1/items.json" in POST with:
...
And I call "/lists/1/items.json" in POST with:
...
When I call "/lists/1/items/2/move.json" in PUT with:
"""
{
"position": 0
}
"""
Then the JSON should be:
"""
{
"items": [{
"name": "b",
"position": 0
}, {
"name": "Insert your items!",
"position": 1
}, {
"name": "c",
"position": 2
}],
"list_link": "http://www.example.com/lists/1"
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-42-320.jpg)
![Items API
Scenario: Moving an element to the top
Given I call "/lists/1/items.json" in POST with:
...
And I call "/lists/1/items.json" in POST with:
...
When I call "/lists/1/items/2/move.json" in PUT with:
"""
{
"position": 0
}
Let’s see some code!
"""
Then the JSON should be:
"""
{
"items": [{
"name": "b",
"position": 0
}, {
"name": "Insert your items!",
"position": 1
}, {
"name": "c",
"position": 2
}],
"list_link": "http://www.example.com/lists/1"
}
"""](https://image.slidesharecdn.com/entertheapperawithrubyonrailsrubyday-120618091416-phpapp01/85/Enter-the-app-era-with-ruby-on-rails-rubyday-43-320.jpg)
More Related Content
What's hot (20)
Viewers also liked (18)
Similar to Enter the app era with ruby on rails (rubyday) (20)
Recently uploaded (20)
Enter the app era with ruby on rails (rubyday)
- 1. Enter the App Era with Ruby on Rails @matteocollina
- 2. How is built an App? http://www.flickr.com/photos/dschulian/3173331821/
- 3. Code Icons by Fasticon
- 4. Code Run Icons by Fasticon
- 5. Code Run Server Icons by Fasticon
- 6. Code Run Server Icons by Fasticon
- 7. Code Run Server Icons by Fasticon
- 8. Code I need to serve Run Server my data to Web and Mobile Apps Icons by Fasticon
- 9. We need an API
- 10. We need an API Who has APIs?
- 11. Who has APIs?
- 12. Who has APIs?
- 13. Who has APIs? And many many others..
- 14. We will develop an API
- 15. We need to be fast! http://www.flickr.com/photos/oneaustin/1261907803
- 16. We have just twenty minutes http://www.flickr.com/photos/oneaustin/1261907803
- 17. What do we want to build? http://www.flickr.com/photos/oberazzi/318947873/
- 18. Another tool for nerds? http://www.flickr.com/photos/eyesontheroad/2260731457/
- 19. Another Todo List? http://www.flickr.com/photos/eyesontheroad/2260731457/
- 21. Enter MCDo. The first Todo List delivered as a REST API
- 22. The first Todo List delivered as a REST API
- 24. Signup API Feature: Signup API As a MCDO developer In order to develop apps I want to register new users Scenario: Succesful signup When I call "/users.json" in POST with: """ { "user": { "email": "[email protected]", "password": "abcde", "password_confirmation": "abcde" } } """ Then the JSON should be: """ { "id": 1, "email": "[email protected]" } """
- 25. Signup API Scenario: signup fails with a wrong password_confirmation When I call "/users.json" in POST with: """ { "user": { "email": "[email protected]", "password": "abcde", "password_confirmation": "abcde1" } } """ Then the JSON should be: """ { "errors": { "password": ["doesn't match confirmation"] } } """
- 26. How?
- 28. How? Ruby on Rails Let’s see some code! Cucumber RSpec JSON-spec
- 30. Login API Feature: Login API As a MCDO developer In order to develop apps I want to login with an existing user Background: Given there is the following user: | email | password | password_confirmation | | [email protected] | aa | aa | Scenario: Succesful login When I call "/session.json" in POST with: """ { "email": "[email protected]", "password": "aa" } """ Then the JSON should be: """ { "status": "authenticated" } """
- 31. Login API Scenario: Failed login When I call "/session.json" in POST with: """ { "email": "[email protected]", "password": "bb" } """ Then the JSON should be: """ { "status": "not authenticated" } """
- 32. Login API Scenario: Validating an active session Given I call "/session.json" in POST with: """ { "email": "[email protected]", "password": "aa" } """ When I call "/session.json" in GET Then the JSON should be: """ { "status": "authenticated" } """
- 33. Login API Scenario: Validating an active session Given I call "/session.json" in POST with: """ { "email": "[email protected]", "password": "aa" } Let’s see some code! """ When I call "/session.json" in GET Then the JSON should be: """ { "status": "authenticated" } """
- 35. Lists API Feature: Lists API As a MCDO developer In order to develop apps I want to manage a user's lists Background: Given I login succesfully with user "[email protected]" Scenario: Default lists When I call "/lists.json" in GET Then the JSON should be: """ { "lists": [{ "id": 1, "name": "Personal", "link": "http://www.example.com/lists/1", "items_link": "http://www.example.com/lists/1/items" }] } """
- 36. Lists API Scenario: Creating a list When I call "/lists.json" in POST with: """ { "list": { "name": "foobar" } } """ Then the JSON should be: """ { "name": "foobar", "items_link": "http://www.example.com/lists/1/items" } """
- 37. Lists API Scenario: Creating a list should add it to the index Given I call "/lists.json" in POST with: """ { "list": { "name": "foobar" } } """ When I call "/lists.json" in GET Then the JSON should be: """ { "lists": [{ "id": 2, "name": "foobar", "link": "http://www.example.com/lists/2", "items_link": "http://www.example.com/lists/2/items" }, { "id": 1, "name": "Personal", "link": "http://www.example.com/lists/1", "items_link": "http://www.example.com/lists/1/items" }] } """
- 38. Lists API Scenario: Removing a list (and the index is empty) Given I call "/lists/1.json" in DELETE When I call "/lists.json" Then the JSON should be: """ { "lists": [] } """ Scenario: Updating a list's name When I call "/lists/1.json" in PUT with: """ { "list": { "name": "foobar" } } """ Then the JSON should be: """ { "name": "foobar", "items_link": "http://www.example.com/lists/1/items" } """
- 39. Lists API Scenario: Removing a list (and the index is empty) Given I call "/lists/1.json" in DELETE When I call "/lists.json" Then the JSON should be: """ { "lists": [] } """ Let’s see some code! Scenario: Updating a list's name When I call "/lists/1.json" in PUT with: """ { "list": { "name": "foobar" } } """ Then the JSON should be: """ { "name": "foobar", "items_link": "http://www.example.com/lists/1/items" } """
- 41. Items API Feature: Manage a list's items As a developer In order to manipulate the list's item I want to access them through APIs Background: Given I login succesfully with user "[email protected]" Scenario: Default items When I call "/lists/1/items.json" in GET Then the JSON should be: """ { "items": [{ "name": "Insert your items!", "position": 0 }], "list_link": "http://www.example.com/lists/1" } """
- 42. Items API Scenario: Moving an element to the top Given I call "/lists/1/items.json" in POST with: ... And I call "/lists/1/items.json" in POST with: ... When I call "/lists/1/items/2/move.json" in PUT with: """ { "position": 0 } """ Then the JSON should be: """ { "items": [{ "name": "b", "position": 0 }, { "name": "Insert your items!", "position": 1 }, { "name": "c", "position": 2 }], "list_link": "http://www.example.com/lists/1" } """
- 43. Items API Scenario: Moving an element to the top Given I call "/lists/1/items.json" in POST with: ... And I call "/lists/1/items.json" in POST with: ... When I call "/lists/1/items/2/move.json" in PUT with: """ { "position": 0 } Let’s see some code! """ Then the JSON should be: """ { "items": [{ "name": "b", "position": 0 }, { "name": "Insert your items!", "position": 1 }, { "name": "c", "position": 2 }], "list_link": "http://www.example.com/lists/1" } """
- 44. Do we need an admin panel?
- 45. Do we need an admin panel?
- 46. Do we need an admin panel? Put in your Gemfile: gem 'activeadmin' gem 'meta_search', '>= 1.1.0.pre' Then run: $ bundle install $ rails g active_admin:install $ rails g active_admin:resource users $ rails g active_admin:resource lists $ rails g active_admin:resource items $ rake db:migrate
- 47. Do we need an admin panel? Put in your Gemfile: Let’s see some code! gem 'activeadmin' gem 'meta_search', '>= 1.1.0.pre' Then run: $ bundle install $ rails g active_admin:install $ rails g active_admin:resource users $ rails g active_admin:resource lists $ rails g active_admin:resource items $ rake db:migrate
- 48. Build a JS App!
- 49. Do you like Spaghetti Code? JavaScript Apps are often a mess We mix logic with presentation with persistance. Packaging is hard. http://www.flickr.com/photos/mpirotta/4944504834
- 50. What we want http://www.flickr.com/photos/bob_u/208396193
- 51. Rethinking MVC MVC pattern was introduced with Smalltalk too many years ago. In “true” MVC the “View” updates itself when the model changes. We could not port it to the Rails world. http://www.flickr.com/photos/wbaiv/2554954565
- 52. Build a JS App the Rails Way! Backbone.js: MVC in the browser Rails asset pipeline concatenate and minifies our JS automatically We can even write our app in CoffeeScript: it works out of the box.
- 53. Build a JS App the Rails Way! Backbone.js: MVC in the browser to Rails asset pipeline concatenate the code.. again? and minifies our JS automatically We can even write our app in CoffeeScript: it works out of the box.
- 55. We are late, the #rubyday crew are kicking me out! http://www.flickr.com/photos/oneaustin/1261907803
- 56. TL;DR http://www.flickr.com/photos/evilaugust/3307382858
- 57. TL;DR Mobile Apps need an API Ruby on Rails is good for writing APIs You can build nice admin interfaces with ActiveAdmin You can craft Javascript Apps easily using the asset pipeline.
- 58. Any Questions?
- 60. www.mavigex.com www.wemobi.it
- 61. Thank You!
Editor's Notes
- #2: \n
- #3: \n
- #4: \n
- #5: \n
- #6: \n
- #7: \n
- #8: \n
- #9: \n
- #10: \n
- #11: \n
- #12: \n
- #13: \n
- #14: \n
- #15: \n
- #16: \n
- #17: \n
- #18: \n
- #19: \n
- #20: \n
- #21: \n
- #22: \n
- #23: \n
- #24: \n
- #25: \n
- #26: \n
- #27: \n
- #28: \n
- #29: \n
- #30: \n
- #31: \n
- #32: \n
- #33: \n
- #34: \n
- #35: \n
- #36: \n
- #37: \n
- #38: \n
- #39: \n
- #40: \n
- #41: \n
- #42: \n
- #43: \n
- #44: \n
- #45: \n
- #46: \n
- #47: \n
- #48: \n
- #49: \n
- #50: \n
- #51: \n
- #52: \n
- #53: \n
- #54: \n
- #55: \n
- #56: \n
- #57: \n
- #58: \n
- #59: \n
- #60: \n
- #61: \n