dm-rest-adapter 0.9.10 → 0.9.11

Sign up to get free protection for your applications and to get access to all the features.
Files changed (105) hide show
  1. data/History.txt +7 -1
  2. data/Manifest.txt +9 -87
  3. data/README.markdown +47 -0
  4. data/README.txt +44 -0
  5. data/Rakefile +5 -5
  6. data/config/database.rb.example +8 -0
  7. data/dm-rest-adapter.gemspec +34 -0
  8. data/lib/rest_adapter.rb +10 -246
  9. data/lib/rest_adapter/adapter.rb +291 -0
  10. data/lib/rest_adapter/connection.rb +76 -0
  11. data/lib/rest_adapter/exceptions.rb +66 -0
  12. data/lib/rest_adapter/formats.rb +16 -0
  13. data/lib/rest_adapter/version.rb +2 -4
  14. data/spec/connection_spec.rb +130 -0
  15. data/spec/crud_spec.rb +250 -0
  16. data/spec/spec_helper.rb +1 -6
  17. data/tasks/spec.rb +1 -1
  18. metadata +16 -94
  19. data/fixtures/book_service/README +0 -256
  20. data/fixtures/book_service/Rakefile +0 -10
  21. data/fixtures/book_service/app/controllers/application.rb +0 -15
  22. data/fixtures/book_service/app/controllers/books_controller.rb +0 -85
  23. data/fixtures/book_service/app/controllers/shelves_controller.rb +0 -89
  24. data/fixtures/book_service/app/helpers/application_helper.rb +0 -3
  25. data/fixtures/book_service/app/helpers/books_helper.rb +0 -2
  26. data/fixtures/book_service/app/helpers/shelf_helper.rb +0 -2
  27. data/fixtures/book_service/app/models/book.rb +0 -6
  28. data/fixtures/book_service/app/models/shelf.rb +0 -5
  29. data/fixtures/book_service/app/views/books/edit.html.erb +0 -20
  30. data/fixtures/book_service/app/views/books/index.html.erb +0 -22
  31. data/fixtures/book_service/app/views/books/new.html.erb +0 -19
  32. data/fixtures/book_service/app/views/books/show.html.erb +0 -13
  33. data/fixtures/book_service/app/views/layouts/books.html.erb +0 -17
  34. data/fixtures/book_service/app/views/shelves/edit.html.erb +0 -16
  35. data/fixtures/book_service/app/views/shelves/index.html.erb +0 -20
  36. data/fixtures/book_service/app/views/shelves/new.html.erb +0 -15
  37. data/fixtures/book_service/app/views/shelves/show.html.erb +0 -7
  38. data/fixtures/book_service/config/boot.rb +0 -109
  39. data/fixtures/book_service/config/database.yml +0 -19
  40. data/fixtures/book_service/config/environment.rb +0 -67
  41. data/fixtures/book_service/config/environments/development.rb +0 -17
  42. data/fixtures/book_service/config/environments/production.rb +0 -22
  43. data/fixtures/book_service/config/environments/test.rb +0 -22
  44. data/fixtures/book_service/config/initializers/inflections.rb +0 -10
  45. data/fixtures/book_service/config/initializers/mime_types.rb +0 -5
  46. data/fixtures/book_service/config/initializers/new_rails_defaults.rb +0 -15
  47. data/fixtures/book_service/config/routes.rb +0 -44
  48. data/fixtures/book_service/db/development.sqlite3 +0 -0
  49. data/fixtures/book_service/db/migrate/20080608165526_create_books.rb +0 -15
  50. data/fixtures/book_service/db/migrate/20080621171551_create_shelves.rb +0 -13
  51. data/fixtures/book_service/db/migrate/20080629143033_create_fake_books_and_shelves.rb +0 -20
  52. data/fixtures/book_service/db/schema.rb +0 -28
  53. data/fixtures/book_service/public/404.html +0 -30
  54. data/fixtures/book_service/public/422.html +0 -30
  55. data/fixtures/book_service/public/500.html +0 -30
  56. data/fixtures/book_service/public/dispatch.cgi +0 -10
  57. data/fixtures/book_service/public/dispatch.fcgi +0 -24
  58. data/fixtures/book_service/public/dispatch.rb +0 -10
  59. data/fixtures/book_service/public/favicon.ico +0 -0
  60. data/fixtures/book_service/public/images/rails.png +0 -0
  61. data/fixtures/book_service/public/index.html +0 -274
  62. data/fixtures/book_service/public/javascripts/application.js +0 -2
  63. data/fixtures/book_service/public/javascripts/controls.js +0 -963
  64. data/fixtures/book_service/public/javascripts/dragdrop.js +0 -972
  65. data/fixtures/book_service/public/javascripts/effects.js +0 -1120
  66. data/fixtures/book_service/public/javascripts/prototype.js +0 -4225
  67. data/fixtures/book_service/public/robots.txt +0 -5
  68. data/fixtures/book_service/public/stylesheets/scaffold.css +0 -53
  69. data/fixtures/book_service/script/about +0 -3
  70. data/fixtures/book_service/script/console +0 -3
  71. data/fixtures/book_service/script/dbconsole +0 -3
  72. data/fixtures/book_service/script/destroy +0 -3
  73. data/fixtures/book_service/script/generate +0 -3
  74. data/fixtures/book_service/script/performance/benchmarker +0 -3
  75. data/fixtures/book_service/script/performance/profiler +0 -3
  76. data/fixtures/book_service/script/performance/request +0 -3
  77. data/fixtures/book_service/script/plugin +0 -3
  78. data/fixtures/book_service/script/process/inspector +0 -3
  79. data/fixtures/book_service/script/process/reaper +0 -3
  80. data/fixtures/book_service/script/process/spawner +0 -3
  81. data/fixtures/book_service/script/runner +0 -3
  82. data/fixtures/book_service/script/server +0 -3
  83. data/fixtures/book_service/test/fixtures/books.yml +0 -9
  84. data/fixtures/book_service/test/fixtures/shelves.yml +0 -7
  85. data/fixtures/book_service/test/functional/books_controller_test.rb +0 -45
  86. data/fixtures/book_service/test/functional/shelf_controller_test.rb +0 -8
  87. data/fixtures/book_service/test/test_helper.rb +0 -38
  88. data/fixtures/book_service/test/unit/book_test.rb +0 -8
  89. data/fixtures/book_service/test/unit/shelf_test.rb +0 -8
  90. data/spec/create_spec.rb +0 -21
  91. data/spec/delete_spec.rb +0 -22
  92. data/spec/read_spec.rb +0 -101
  93. data/spec/update_spec.rb +0 -36
  94. data/stories/all.rb +0 -5
  95. data/stories/crud/create +0 -39
  96. data/stories/crud/delete +0 -9
  97. data/stories/crud/read +0 -36
  98. data/stories/crud/stories.rb +0 -18
  99. data/stories/crud/update +0 -44
  100. data/stories/helper.rb +0 -19
  101. data/stories/resources/helpers/book.rb +0 -7
  102. data/stories/resources/helpers/story_helper.rb +0 -2
  103. data/stories/resources/steps/read.rb +0 -35
  104. data/stories/resources/steps/using_rest_adapter.rb +0 -99
  105. data/tasks/stories.rb +0 -5
@@ -1,256 +0,0 @@
1
- == Welcome to Rails
2
-
3
- Rails is a web-application framework that includes everything needed to create
4
- database-backed web applications according to the Model-View-Control pattern.
5
-
6
- This pattern splits the view (also called the presentation) into "dumb" templates
7
- that are primarily responsible for inserting pre-built data in between HTML tags.
8
- The model contains the "smart" domain objects (such as Account, Product, Person,
9
- Post) that holds all the business logic and knows how to persist themselves to
10
- a database. The controller handles the incoming requests (such as Save New Account,
11
- Update Product, Show Post) by manipulating the model and directing data to the view.
12
-
13
- In Rails, the model is handled by what's called an object-relational mapping
14
- layer entitled Active Record. This layer allows you to present the data from
15
- database rows as objects and embellish these data objects with business logic
16
- methods. You can read more about Active Record in
17
- link:files/vendor/rails/activerecord/README.html.
18
-
19
- The controller and view are handled by the Action Pack, which handles both
20
- layers by its two parts: Action View and Action Controller. These two layers
21
- are bundled in a single package due to their heavy interdependence. This is
22
- unlike the relationship between the Active Record and Action Pack that is much
23
- more separate. Each of these packages can be used independently outside of
24
- Rails. You can read more about Action Pack in
25
- link:files/vendor/rails/actionpack/README.html.
26
-
27
-
28
- == Getting Started
29
-
30
- 1. At the command prompt, start a new Rails application using the <tt>rails</tt> command
31
- and your application name. Ex: rails myapp
32
- 2. Change directory into myapp and start the web server: <tt>script/server</tt> (run with --help for options)
33
- 3. Go to http://localhost:3000/ and get "Welcome aboard: You're riding the Rails!"
34
- 4. Follow the guidelines to start developing your application
35
-
36
-
37
- == Web Servers
38
-
39
- By default, Rails will try to use Mongrel and lighttpd if they are installed, otherwise
40
- Rails will use WEBrick, the webserver that ships with Ruby. When you run script/server,
41
- Rails will check if Mongrel exists, then lighttpd and finally fall back to WEBrick. This ensures
42
- that you can always get up and running quickly.
43
-
44
- Mongrel is a Ruby-based webserver with a C component (which requires compilation) that is
45
- suitable for development and deployment of Rails applications. If you have Ruby Gems installed,
46
- getting up and running with mongrel is as easy as: <tt>gem install mongrel</tt>.
47
- More info at: http://mongrel.rubyforge.org
48
-
49
- If Mongrel is not installed, Rails will look for lighttpd. It's considerably faster than
50
- Mongrel and WEBrick and also suited for production use, but requires additional
51
- installation and currently only works well on OS X/Unix (Windows users are encouraged
52
- to start with Mongrel). We recommend version 1.4.11 and higher. You can download it from
53
- http://www.lighttpd.net.
54
-
55
- And finally, if neither Mongrel or lighttpd are installed, Rails will use the built-in Ruby
56
- web server, WEBrick. WEBrick is a small Ruby web server suitable for development, but not
57
- for production.
58
-
59
- But of course its also possible to run Rails on any platform that supports FCGI.
60
- Apache, LiteSpeed, IIS are just a few. For more information on FCGI,
61
- please visit: http://wiki.rubyonrails.com/rails/pages/FastCGI
62
-
63
-
64
- == Apache .htaccess example
65
-
66
- # General Apache options
67
- AddHandler fastcgi-script .fcgi
68
- AddHandler cgi-script .cgi
69
- Options +FollowSymLinks +ExecCGI
70
-
71
- # If you don't want Rails to look in certain directories,
72
- # use the following rewrite rules so that Apache won't rewrite certain requests
73
- #
74
- # Example:
75
- # RewriteCond %{REQUEST_URI} ^/notrails.*
76
- # RewriteRule .* - [L]
77
-
78
- # Redirect all requests not available on the filesystem to Rails
79
- # By default the cgi dispatcher is used which is very slow
80
- #
81
- # For better performance replace the dispatcher with the fastcgi one
82
- #
83
- # Example:
84
- # RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
85
- RewriteEngine On
86
-
87
- # If your Rails application is accessed via an Alias directive,
88
- # then you MUST also set the RewriteBase in this htaccess file.
89
- #
90
- # Example:
91
- # Alias /myrailsapp /path/to/myrailsapp/public
92
- # RewriteBase /myrailsapp
93
-
94
- RewriteRule ^$ index.html [QSA]
95
- RewriteRule ^([^.]+)$ $1.html [QSA]
96
- RewriteCond %{REQUEST_FILENAME} !-f
97
- RewriteRule ^(.*)$ dispatch.cgi [QSA,L]
98
-
99
- # In case Rails experiences terminal errors
100
- # Instead of displaying this message you can supply a file here which will be rendered instead
101
- #
102
- # Example:
103
- # ErrorDocument 500 /500.html
104
-
105
- ErrorDocument 500 "<h2>Application error</h2>Rails application failed to start properly"
106
-
107
-
108
- == Debugging Rails
109
-
110
- Sometimes your application goes wrong. Fortunately there are a lot of tools that
111
- will help you debug it and get it back on the rails.
112
-
113
- First area to check is the application log files. Have "tail -f" commands running
114
- on the server.log and development.log. Rails will automatically display debugging
115
- and runtime information to these files. Debugging info will also be shown in the
116
- browser on requests from 127.0.0.1.
117
-
118
- You can also log your own messages directly into the log file from your code using
119
- the Ruby logger class from inside your controllers. Example:
120
-
121
- class WeblogController < ActionController::Base
122
- def destroy
123
- @weblog = Weblog.find(params[:id])
124
- @weblog.destroy
125
- logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
126
- end
127
- end
128
-
129
- The result will be a message in your log file along the lines of:
130
-
131
- Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1
132
-
133
- More information on how to use the logger is at http://www.ruby-doc.org/core/
134
-
135
- Also, Ruby documentation can be found at http://www.ruby-lang.org/ including:
136
-
137
- * The Learning Ruby (Pickaxe) Book: http://www.ruby-doc.org/docs/ProgrammingRuby/
138
- * Learn to Program: http://pine.fm/LearnToProgram/ (a beginners guide)
139
-
140
- These two online (and free) books will bring you up to speed on the Ruby language
141
- and also on programming in general.
142
-
143
-
144
- == Debugger
145
-
146
- Debugger support is available through the debugger command when you start your Mongrel or
147
- Webrick server with --debugger. This means that you can break out of execution at any point
148
- in the code, investigate and change the model, AND then resume execution!
149
- You need to install ruby-debug to run the server in debugging mode. With gems, use 'gem install ruby-debug'
150
- Example:
151
-
152
- class WeblogController < ActionController::Base
153
- def index
154
- @posts = Post.find(:all)
155
- debugger
156
- end
157
- end
158
-
159
- So the controller will accept the action, run the first line, then present you
160
- with a IRB prompt in the server window. Here you can do things like:
161
-
162
- >> @posts.inspect
163
- => "[#<Post:0x14a6be8 @attributes={\"title\"=>nil, \"body\"=>nil, \"id\"=>\"1\"}>,
164
- #<Post:0x14a6620 @attributes={\"title\"=>\"Rails you know!\", \"body\"=>\"Only ten..\", \"id\"=>\"2\"}>]"
165
- >> @posts.first.title = "hello from a debugger"
166
- => "hello from a debugger"
167
-
168
- ...and even better is that you can examine how your runtime objects actually work:
169
-
170
- >> f = @posts.first
171
- => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
172
- >> f.
173
- Display all 152 possibilities? (y or n)
174
-
175
- Finally, when you're ready to resume execution, you enter "cont"
176
-
177
-
178
- == Console
179
-
180
- You can interact with the domain model by starting the console through <tt>script/console</tt>.
181
- Here you'll have all parts of the application configured, just like it is when the
182
- application is running. You can inspect domain models, change values, and save to the
183
- database. Starting the script without arguments will launch it in the development environment.
184
- Passing an argument will specify a different environment, like <tt>script/console production</tt>.
185
-
186
- To reload your controllers and models after launching the console run <tt>reload!</tt>
187
-
188
- == dbconsole
189
-
190
- You can go to the command line of your database directly through <tt>script/dbconsole</tt>.
191
- You would be connected to the database with the credentials defined in database.yml.
192
- Starting the script without arguments will connect you to the development database. Passing an
193
- argument will connect you to a different database, like <tt>script/dbconsole production</tt>.
194
- Currently works for mysql, postgresql and sqlite.
195
-
196
- == Description of Contents
197
-
198
- app
199
- Holds all the code that's specific to this particular application.
200
-
201
- app/controllers
202
- Holds controllers that should be named like weblogs_controller.rb for
203
- automated URL mapping. All controllers should descend from ApplicationController
204
- which itself descends from ActionController::Base.
205
-
206
- app/models
207
- Holds models that should be named like post.rb.
208
- Most models will descend from ActiveRecord::Base.
209
-
210
- app/views
211
- Holds the template files for the view that should be named like
212
- weblogs/index.html.erb for the WeblogsController#index action. All views use eRuby
213
- syntax.
214
-
215
- app/views/layouts
216
- Holds the template files for layouts to be used with views. This models the common
217
- header/footer method of wrapping views. In your views, define a layout using the
218
- <tt>layout :default</tt> and create a file named default.html.erb. Inside default.html.erb,
219
- call <% yield %> to render the view using this layout.
220
-
221
- app/helpers
222
- Holds view helpers that should be named like weblogs_helper.rb. These are generated
223
- for you automatically when using script/generate for controllers. Helpers can be used to
224
- wrap functionality for your views into methods.
225
-
226
- config
227
- Configuration files for the Rails environment, the routing map, the database, and other dependencies.
228
-
229
- db
230
- Contains the database schema in schema.rb. db/migrate contains all
231
- the sequence of Migrations for your schema.
232
-
233
- doc
234
- This directory is where your application documentation will be stored when generated
235
- using <tt>rake doc:app</tt>
236
-
237
- lib
238
- Application specific libraries. Basically, any kind of custom code that doesn't
239
- belong under controllers, models, or helpers. This directory is in the load path.
240
-
241
- public
242
- The directory available for the web server. Contains subdirectories for images, stylesheets,
243
- and javascripts. Also contains the dispatchers and the default HTML files. This should be
244
- set as the DOCUMENT_ROOT of your web server.
245
-
246
- script
247
- Helper scripts for automation and generation.
248
-
249
- test
250
- Unit and functional tests along with fixtures. When using the script/generate scripts, template
251
- test files will be generated for you and placed in this directory.
252
-
253
- vendor
254
- External libraries that the application depends on. Also includes the plugins subdirectory.
255
- If the app has frozen rails, those gems also go here, under vendor/rails/.
256
- This directory is in the load path.
@@ -1,10 +0,0 @@
1
- # Add your own tasks in files placed in lib/tasks ending in .rake,
2
- # for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
3
-
4
- require(File.join(File.dirname(__FILE__), 'config', 'boot'))
5
-
6
- require 'rake'
7
- require 'rake/testtask'
8
- require 'rake/rdoctask'
9
-
10
- require 'tasks/rails'
@@ -1,15 +0,0 @@
1
- # Filters added to this controller apply to all controllers in the application.
2
- # Likewise, all the methods added will be available for all controllers.
3
-
4
- class ApplicationController < ActionController::Base
5
- helper :all # include all helpers, all the time
6
-
7
- # See ActionController::RequestForgeryProtection for details
8
- # Uncomment the :secret if you're not using the cookie session store
9
- protect_from_forgery # :secret => 'fb23937b455a775732b021a8db838ba7'
10
-
11
- # See ActionController::Base for details
12
- # Uncomment this to filter the contents of submitted sensitive data parameters
13
- # from your application log (in this case, all fields with names like "password").
14
- # filter_parameter_logging :password
15
- end
@@ -1,85 +0,0 @@
1
- class BooksController < ApplicationController
2
- # GET /books
3
- # GET /books.xml
4
- def index
5
- @books = Book.find(:all)
6
-
7
- respond_to do |format|
8
- format.html # index.html.erb
9
- format.xml { render :xml => @books }
10
- end
11
- end
12
-
13
- # GET /books/1
14
- # GET /books/1.xml
15
- def show
16
- @book = Book.find(params[:id])
17
-
18
- respond_to do |format|
19
- format.html # show.html.erb
20
- format.xml { render :xml => @book }
21
- end
22
- end
23
-
24
- # GET /books/new
25
- # GET /books/new.xml
26
- def new
27
- @book = Book.new
28
-
29
- respond_to do |format|
30
- format.html # new.html.erb
31
- format.xml { render :xml => @book }
32
- end
33
- end
34
-
35
- # GET /books/1/edit
36
- def edit
37
- @book = Book.find(params[:id])
38
- end
39
-
40
- # POST /books
41
- # POST /books.xml
42
- def create
43
- @book = Book.new(params[:book])
44
-
45
- respond_to do |format|
46
- if @book.save
47
- flash[:notice] = 'Book was successfully created.'
48
- format.html { redirect_to(@book) }
49
- format.xml { render :xml => @book, :status => :created, :location => @book }
50
- else
51
- format.html { render :action => "new" }
52
- format.xml { render :xml => @book.errors, :status => :unprocessable_entity }
53
- end
54
- end
55
- end
56
-
57
- # PUT /books/1
58
- # PUT /books/1.xml
59
- def update
60
- @book = Book.find(params[:id])
61
-
62
- respond_to do |format|
63
- if @book.update_attributes(params[:book])
64
- flash[:notice] = 'Book was successfully updated.'
65
- format.html { redirect_to(@book) }
66
- format.xml { head :ok }
67
- else
68
- format.html { render :action => "edit" }
69
- format.xml { render :xml => @book.errors, :status => :unprocessable_entity }
70
- end
71
- end
72
- end
73
-
74
- # DELETE /books/1
75
- # DELETE /books/1.xml
76
- def destroy
77
- @book = Book.find(params[:id])
78
- @book.destroy
79
-
80
- respond_to do |format|
81
- format.html { redirect_to(books_url) }
82
- format.xml { head :ok }
83
- end
84
- end
85
- end
@@ -1,89 +0,0 @@
1
- class ShelvesController < ApplicationController
2
- # GET /shelves
3
- # GET /shelves.xml
4
- def index
5
- @shelves = Shelf.find(:all)
6
-
7
- respond_to do |format|
8
- format.html # index.html.erb
9
- format.xml { render :xml => @shelves.to_xml(:include => :books) }
10
- end
11
- end
12
-
13
- # GET /shelves/1
14
- # GET /shelves/1.xml
15
- def show
16
- @shelf = Shelf.find(params[:id])
17
-
18
- respond_to do |format|
19
- format.html # show.html.erb
20
- format.xml { render :xml => @shelf.to_xml(:include => :books) }
21
- end
22
- end
23
-
24
- # GET /shelves/new
25
- # GET /shelves/new.xml
26
- def new
27
- @shelf = Shelf.new
28
-
29
- respond_to do |format|
30
- format.html # new.html.erb
31
- format.xml { render :xml => @shelf }
32
- end
33
- end
34
-
35
- # GET /shelves/1/edit
36
- def edit
37
- @shelf = Shelf.find(params[:id], :include => :books)
38
- respond_to do |format|
39
- format.xml { render :xml => @shelf }
40
- format.html
41
- end
42
- end
43
-
44
- # POST /shelves
45
- # POST /shelves.xml
46
- def create
47
- @shelf = Shelf.new(params[:shelf])
48
-
49
- respond_to do |format|
50
- if @shelf.save
51
- flash[:notice] = 'Shelf was successfully created.'
52
- format.html { redirect_to(@shelf) }
53
- format.xml { render :xml => @shelf, :status => :created, :location => @shelf }
54
- else
55
- format.html { render :action => "new" }
56
- format.xml { render :xml => @shelf.errors, :status => :unprocessable_entity }
57
- end
58
- end
59
- end
60
-
61
- # PUT /shelves/1
62
- # PUT /shelves/1.xml
63
- def update
64
- @shelf = Shelf.find(params[:id])
65
-
66
- respond_to do |format|
67
- if @shelf.update_attributes(params[:shelf])
68
- flash[:notice] = 'Shelf was successfully updated.'
69
- format.html { redirect_to(@shelf) }
70
- format.xml { head :ok }
71
- else
72
- format.html { render :action => "edit" }
73
- format.xml { render :xml => @shelf.errors, :status => :unprocessable_entity }
74
- end
75
- end
76
- end
77
-
78
- # DELETE /shelves/1
79
- # DELETE /shelves/1.xml
80
- def destroy
81
- @shelf = Shelf.find(params[:id])
82
- @shelf.destroy
83
-
84
- respond_to do |format|
85
- format.html { redirect_to(shelves_url) }
86
- format.xml { head :ok }
87
- end
88
- end
89
- end