Add an example of documenting file uploads

Author: oestrich

README.md

@@ -699,6 +699,10 @@ If you are not using Rake:
 $ rspec spec/acceptance --format RspecApiDocumentation::ApiFormatter
 ```
 
+## Uploading a file
+
+For an example on uploading a file see `examples/spec/acceptance/upload_spec.rb`.
+
 ## Gotchas
 
 - rspec_api_documentation relies on a variable `client` to be the test client. If you define your own `client` please configure rspec_api_documentation to use another one, see Configuration above.

example/app/controllers/uploads_controller.rb

@@ -0,0 +1,5 @@
+class UploadsController < ApplicationController
+  def create
+    head 201
+  end
+end

example/config/routes.rb

@@ -1,5 +1,7 @@
 Rails.application.routes.draw do
   resources :orders
 
+  resources :uploads, :only => :create
+
   mount Raddocs::App => "/docs", :anchor => false
 end

example/spec/acceptance/uploads_spec.rb

@@ -0,0 +1,13 @@
+require 'acceptance_helper'
+
+resource "Uploads" do
+  post "/uploads" do
+    parameter :file, "New file to upload"
+
+    let(:file) { Rack::Test::UploadedFile.new("spec/fixtures/file.png", "image/png") }
+
+    example_request "Uploading a new file" do
+      expect(status).to eq(201)
+    end
+  end
+end