設計と実装をRailsでシームレスに行う(API仕様書)
目的
API仕様書のメンテコストをなくす
実装に前倒しで着手する
前提
フレームワークにRailsを使用する
Railsの環境構築を行う
手順
1. Gemfileにgemを指定する
2. spec/request/xxxx_spec.rbにテストケースを書く
3. AUTODOC=1 bundle exec rspec spec/requests/xxxx_spec.rbを実行する
1. Gemfileにgemを指定する
group :development do
gem 'autodoc'
end
2. spec/request/xxxx_spec.rbにテストケースを書く
require 'rails_helper'
RSpec.describe "Api::V1::Users", type: :request, autodoc: true do
describe "GET /api/v1/users/:id" do
it "ユーザー詳細API" do
get api_v1_user_path(1)
expect(response).to have_http_status(200)
end
end
describe "PUT /api/v1/users/:id" do
it "ユーザー編集API" do
require 'json'
file = File.read("#{Rails.root}/sample-json/users-update.json")
params = JSON.parse(file)
put api_v1_user_path(1), params: params, as: :json
expect(response).to have_http_status(200)
end
end
end
3. AUTODOC=1 bundle exec rspec spec/requests/xxxx_spec.rbを実行する
この記事が気に入ったらサポートをしてみませんか?