Presentation at the Atlanta Ruby User's Group, Sep 2011 for the Intermodal Gem (http://github.com/hosh/intermodal)

1. Intermodal

2. Ho-Sheng Hsiao Github: github.com/hosh Twitter: hosheng

3. Rails Stopped Innovating

4. 500,000 Android Activated per day Source: bit.ly/500k-android-activtions

5. Computer

8. 500,000 Android Activated per day Source: bit.ly/500k-android-activtions

9. Computer

13. Rails Stopped Innovating

14. Web

16. Web

18. Platforms iOS Android Blackberry Windows 8 HP/Palm WebOS

19. Cross Platform jQuery Mobile Sencha Backbone.js Spine.js PhoneGap Titanium

20. Rails?

21. API

22. API=Machine Legibility

23. Write the API First

24. Write the API First No Server-Side HTML

25. Write the API First No Templates

26. Write the API First Just Endpoints

27. Write the API First REST

28. RESTful Endpoints RESTful CRUD

30. GET /posts/1.json

31. PUT /posts/1.json

32. DELETE /posts/1.json

34. GET /authors/1.json

35. PUT /authors/1.json

36. DELETE /authors/1.json

38. resources :postsresources :authors

40. GET /posts/1.json

41. PUT /posts/1.json

42. DELETE /posts/1.json

44. GET /authors/1.json

45. PUT /authors/1.json

46. DELETE /authors/1.json

48. Intermodal DSL for API

49. Intermodal Not Scaffolding

50. Intermodal Three Common Patterns

51. Intermodal Resources

52. resources :posts

54. GET /posts/1.json

55. PUT /posts/1.json

56. DELETE /posts/1.json

58. # One-to-Many# Post has_many :comments# Comment belongs_to :postnested_resources:post, :comments

60. GET /posts/1/comments/1.json

61. PUT /posts/1/comments/1.json

62. DELETE /posts/1/comments/1.json

64. # Many-to-Many# Post has_many :authors # :through => :contributions# Author has_many :posts# :through => :contributionslink_resources_from:post, :to =>:authors

66. GET /posts/1/authors.json

67. PUT /posts/1/authors.json

69. presentation_for:postsdo presents :id presents :title presents :content presents :authors => ->(p) { p.authors.map(&:id) }end

70. JSON

71. { “post”: { “id”: 1, “title”: “Hello World”, “content”: “Best of Times, Worst of Times”, “authors”: [1,2,3] }}

72. XML

73. <post> <id>1</id> <title>1</title> <content>Best of Times, Worst of Times</content> <authors> <author>1</author> <author>2</author> <author>3</author> </authors></post>

74. Intermodal Acceptors

75. acceptance_for:postsdo accepts :title accepts :contentend

76. acceptance_for:postsdo accepts :title accepts :contentend# Does not accept :id# Does not accept :authors

77. acceptance_for:postsdo accepts :title accepts :contentend# Passes only :title and :content# from params to#Post#update_attributes

78. Intermodal Testing

79. Intermodal Test the API Not the Controller

80. Intermodal Send Rack Request

82. GET /posts/1.json

83. PUT /posts/1.json

84. DELETE /posts/1.json

87. GET /posts/1.json 200 OK

88. PUT /posts/1.json 200 OK

89. DELETE /posts/1.json 200 OK

91. GET /posts/1.json utf8 json

92. PUT /posts/1.json utf8 json

93. DELETE /posts/1.json utf8 json

95. GET /posts/1.json Read

96. PUT /posts/1.json Update

97. DELETE /posts/1.json Delete

99. resources ’posts' dogiven_create_attributes:title => 'New Post', :account_id=> 1 given_update_attributes:name => 'Updated Post’expects_resource_crudend

100. Intermodal CRUD specs for Nested Resource

101. resources [:posts, :comments] dogiven_create_attributes:title => 'New Comment', :account_id=> 1 given_update_attributes:name => 'Updated Comment’expects_resource_crudend

102. Intermodal CRUD specs for Linked Resource

103. link_resource:post, :to => :authors, :with => Contributiondolet(:model_collection) do contributions post.authors.to_author_idsendlet(:unlinked_targets) { Author.make(3, :account => account) }expects_crud_for_linked_resourceend

104. Caveats

105. Extracted from Production

106. Yes, but …

107. Caveats Installation sucks No independent specs Non-existent documentation No Rails 3.1 support (yet) No Ruby 1.9.2 support (yet)

108. Rails Stopped Innovating?

109. github.com/hosh/intermodal Questions? Ho-Sheng Hsiao