Http::Test

The http-test ruby gem lets you define HTTP API tests in ruby code. Note that the server can be implemented any way you want, as long as it is either available on a proper URL, or can be started in non-daemonized mode with a single command.

Running HTTP tests against a remove server

require_relative "./test_helper"

class RemoteHttpTest < HttpTest::TestCase
  url_base "http://jsonplaceholder.typicode.com"

  def test_get
    GET "/posts/1"
    assert_equal(200, response.status)
    assert_equal(1, response["userId"])
  end

  def test_head
    HEAD "/posts/1"
    assert_equal(200, response.status)
    assert(response.body.empty?)
  end

  def test_post
    POST "/posts", title: "test title", body: "test body"
    assert_equal(201, response.status)
    assert_equal("test title", response["title"])
  end

  def test_put
    PUT "/posts/1", title: "new title"
    assert_equal(200, response.status)
  end

  def test_delete
    DELETE "/posts/1"
    assert_equal(200, response.status)
  end
end

Running HTTP tests against a local server

test-http can also be used to run tests against a local test server. For this, the you must define a command to start the server. For this mode you must define a command to start the server in a non-daemonized mode.

class LocalHttpTest < HttpTest::TestCase
  test_server "#{File.dirname(__FILE__)}/local-http"
  ...
end

Limitations:

• The command should read the PORT to listen on from the "PORT" environment value.
• Currently the only supported port is 4444. Expect this to change to a randomized port number.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/radiospiel/http-test.

License

The gem is available as open source under the terms of the MIT License.