Project: specstar-support-random

This package provides useful macros for generating random objects for testing. Matchers

random_text

Example:

describe 'upcase' do
  it 'should upcase the string.' do
    string = random_text.downcase
    upcase(string).should == string.upcase
  end
end

random_email

Example:

describe 'send_email' do
  it 'should send an email to the specified recipient' do
    recipient = random_email
    email = send_email(recipient, 'Hello')
    email.to.should == recipient
  end
end

random_time

Example:

describe 'previous_day' do
  it 'should return the timestamp 24 hours prior to the given timestamp.' do
    timestamp = random_time
    previous_day(timestamp).should == timestamp - 24.hours
  end
end

random_date

Example:

describe 'record_date' do
  it 'should return the date 3 days before the given date.' do
    release_date = random_date
    record_date(release_date).should == release_date - 3.days
  end
end

random_domain

Example:

describe 'browser' do
  it 'should resolve the specified domain.' do
    domain = random_domain
    browser(domain)
    agent.should have_received(:resolve).with(domain)
  end
end

random_exception

Example:

describe 'backtrace' do
  it 'should print the backtrace of the given exception.' do
    exception = random_exception
    backtrace(exception).should == exception.backtrace.join("\n")
  end
end

random_hash

Example:

describe 'backtrace' do
  it 'should stringify keys." do
    hash = random_hash.symbolize_keys
   	stringify(hash).should == hash.stringify_keys
  end
end

random_hexadecimal

Example:

random_hexadecimal - Produces a random string of up to 64 hexadecimal characters. random_number(max_length: 1000) - Produces a random string of up to 1000 hexadecimal characters. random_number(min_length: 10) - Produces a random string of at least 10 hexadecimal characters. random_number(length: 32) - Produces a random string of exactly 32 hexadecimal characters.

random_number

Example:

random_number - Produces a random number between 0 and 1e9. random_number(max: 1000) - Produces a random number between 0 and 1000. random_number(max: 10, except: 5) - Produces a random number between 0 and 10 except 5.

random_query

Generates a random query parameter of a URL.

random_url

Generates a random URL. You can override the domain, scheme, fragment or query to be nil or a specific value.

Example:

describe 'crawl' do
  it 'should download the specified url.' do
    url = random_url(fragment: nil, query: 'foo=bar')
    crawl(url)
    agent.should have_received(:get).with(url)
  end
end

Using

To make these macros available in your specs, do the following:

Gemfile

group :test do
  ...
  gem 'specstar-support-random'
  ...
end

spec/spec_helper.rb

require 'specstar/support/random'
...

Related Tools

You may also want to consider the following gems to help with your specs:

specstar-controllers: Matchers for checking that the filters and layouts in a controller have been defined correctly. Learn more here. All released gems are here.
specstar-models: Matchers for checking that the attributes, validations and associations of a model have been defined correctly. Learn more here. All released gems are here.