ruser 2.0.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5ab812ef94b94d2bb1ed0fe509a7dc8bbd159e9b
-  data.tar.gz: 2240ea986ae78949f2db71bad85c4b5a76425434
+  metadata.gz: a093290642c49a0499ceda520e1ccb099b5acd31
+  data.tar.gz: 9bda021d3d1811cfea8d9e70eed0e08616876e78
 SHA512:
-  metadata.gz: d517ab1f1b5ea28236341b0f4de48a92f2d6c0b9b259db5abb25db452180fee1e512634188e5ba55a9da1eb61154a897c94909dc2d5a9946b5b75f94e5efa0af
-  data.tar.gz: cead44f2201b54fd8aeaa7c2d9925cc89db1981a5ff89ffebaa545c0de597fdcd662ec0e205e4b2e487178bb852f7bdd42f5407c983f6468ba9cc6aa42c2643f
+  metadata.gz: 4045cc4241063f1f5b0e0624b2ab673818b5e6b66c7dc02ed1485e39e070c101fdc12bec2f3a3e2e8cb862ba60e5dbdd088eb329af3cda4bef2c8b44cb779650
+  data.tar.gz: 020d69b5f8de2377059da9848b6833b0de19f3f84db191b3128a467379674148e4e7f8622b0afbbc5a5b2d448747237307e9920bb95caa543dfff0fb4c5a71ec

data/LICENSE

@@ -1,9 +1,9 @@
 The MIT License (MIT)
 
-Copyright © 2014 Simple App Group LLC <info@simpleappgroup.com>
+Copyright © 2014 Joshua Kendall <me@joshuakendall.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -2,8 +2,7 @@
 
 RUser is a simple Ruby Gem to communicate with the randomuser.me API.
 
-[![Build Status](https://travis-ci.org/simpleappgroup/ruser.png)](https://travis-ci.org/simpleappgroup/ruser) [![Coverage Status](https://coveralls.io/repos/simpleappgroup/ruser/badge.png?branch=master)](https://coveralls.io/r/simpleappgroup/ruser?branch=master) [![Code Climate](https://codeclimate.com/github/simpleappgroup/ruser.png)](https://codeclimate.com/github/simpleappgroup/ruser) [![Dependency Status](https://gemnasium.com/simpleappgroup/ruser.svg)](https://gemnasium.com/simpleappgroup/ruser)
-
+[![Build Status](https://travis-ci.org/jtkendall/ruser.png)](https://travis-ci.org/jtkendall/ruser) [![Coverage Status](https://coveralls.io/repos/jtkendall/ruser/badge.png?branch=master)](https://coveralls.io/r/jtkendall/ruser?branch=master) [![Code Climate](https://codeclimate.com/github/jtkendall/ruser.png)](https://codeclimate.com/github/jtkendall/ruser)
 
 ## Installation
 
@@ -11,35 +10,49 @@ RUser is a simple Ruby Gem to communicate with the randomuser.me API.
 
 or in your Gemfile
 
-    gem 'ruser'
+    gem 'ruser', '~> 3.0'
 
 
 ## Documentation
 
-[rdoc.info/github/simpleappgroup/ruser](http://rdoc.info/github/simpleappgroup/ruser)
+[rdoc.info/github/jtkendall/ruser](http://rdoc.info/github/jtkendall/ruser)
+
+## Changes from 2.x
+
+From version 3.0.0 and forward we are now returning a `nidt` and `nidn` variable instead of a `ssn` variable. This is to allow users to properly associate national id numbers with their national id types. So a user in the US will have a standard SSN as the `nidn` value and "SSN" as the `nidt` value. This makes it easier to call `user.nidt` and `user.nidn` to get the proper information instead of calling `user.ssn` when the user might actually have a PPS instead of a SSN.
+
+Also new in version 3.0.0:
+
+- Removed `name` object. Name parts (Title, First Name, Last Name) are now available as object.first_name instead of object.name.first_name
+- Removed `location` object. Address parts (Street, City, State, Zip Code) are now available as object.street instead of object.location.street
+- Changed `zip_code` to `postal` since not everyone calls them zip codes and not every country uses them.
+- Removed `picture`. Picture has been replaced with `profile_large_url`, `profile_medium_url`, and `profile_thumbnail_url`.
+- Added `nationality`. With the RandomUser API now supporting different nationalities this variable was added.
+- Updated to support API version `0.7`
+- Removed the dependency of `multi_json`
+- Removed the dependency of `hashie`
+- Removed the dependency of `rest-client`
 
 ## Quickstart
 
 Using RUser in it's simplest form is as easy as calling:
 
     require 'ruser'
-	
-	user = RUser.new.first
 
-	puts "This user is a #{user.gender} named #{user.name.first_name}!"
+	user = RUser.new
+
+	puts "This user is a #{user.gender} named #{user.first_name}!"
 
 Then you can access any of the following user attributes:
 
 - gender
-- name
- - first\_name
- - last\_name
- - title
-- location
- - street
- - city
- - state
- - zipcode
+- first\_name
+- last\_name
+- title
+- street
+- city
+- state
+- postal
 - email
 - username
 - password
@@ -51,38 +64,42 @@ Then you can access any of the following user attributes:
 - dob
 - phone
 - cell
-- ssn
-- picture
+- nidn
+- nidt
+- profile_large_url
+- profile_medium_url
+- profile_thumbnail_url
+- nationality
 - seed
 
-If you want to request a female or male user specifically, specify the `:gender` key in the options hash passed to `new`:
+If you want to request a female or male user specifically, specify the `gender:` key in the options hash passed to `new`:
 
     require 'ruser'
-	
-	woman = RUser.new({:gender => 'female'})
 
-	man = RUser.new({:gender => 'male'})
+	woman = RUser.new({ gender: 'female' })
+
+	man = RUser.new({ gender: 'male' })
 
-If you want to request a specific user by their seed, specify the `:seed` key in the options hash passed to `new`:
+If you want to request a specific user by their seed, specify the `seed:` key in the options hash passed to `new`:
 
     require 'ruser'
-	
-	lazyWolf = RUser.new({:seed => 'lazyWolf'})
 
-If you would like more than one user supply the `:results` key in the options hash passed to `new`:
+	lazyWolf = RUser.new({ seed: 'lazyWolf' })
+
+If you would like more than one user supply the `results:` key in the options hash passed to `new`:
 
     require 'ruser'
-	
-	results = RUser.new({:results => 3})
 
-The maximum number of results is 40, any number larger than that will default to 40. You can pass the `:gender` key along with results to return x number of male or female users:
+	results = RUser.new( results: => 3 })
+
+The maximum number of results is 2000. Any number larger than that will return only 2000, unless you have a [RandomAPI](http://randomapi.com) API key. With an API key you can return up to 10000 results per request, just pass your `key:` with your optinos. You can pass the `gender:` key along with results to return x number of male or female users:
 
 	results = RUser.new({ :results => 3, :gender => 'female' })
 
 
 ## Contributing & Development
 
-    $ git clone https://github.com/simpleappgroup/ruser && cd ruser
+    $ git clone https://github.com/jtkendall/ruser && cd ruser
     $ bundle install
 
 * Fork the project.
@@ -93,4 +110,4 @@ The maximum number of results is 40, any number larger than that will default to
 
 ## License & Copyright
 
-See LICENSE for details.
+See LICENSE for details.

data/lib/ruser.rb

@@ -1,4 +1,8 @@
+# RUser is a simple Ruby Gem to communicate with the randomuser.me API.
 module RUser
+  require 'json'
+  require 'net/http'
+  require 'uri'
   require 'ruser/version'
   require 'ruser/api'
   require 'ruser/person'
@@ -9,7 +13,8 @@ module RUser
   #
   # @option options [String] :gender (nil) the user's gender
   # @option options [String] :seed (nil) the user's unique seed value
-  # @option options [String] :limit (1) the number of results to return
+  # @option options [Integer] :results (1) the number of results to return
+  # @option options [String] :nat (nil) the user's nationality
   #
   # @example Create a random user
   #   Person.new()
@@ -17,35 +22,40 @@ module RUser
   #   Person.new({:gender => 'male'})
   # @example Create a female user
   #   Person.new({:gender => 'female'})
+  # @example Create a random user with a specific nationality
+  #   Person.new({:nat => 'US'})
   # @example Create a specific user from a seed
   #   Person.new({:seed => 'lazyWolf'})
   # @example Create three users
-  #   Person.new({:results=> 3})
+  #   Person.new({:results => 3})
   # @example Create three male users
-  #   Person.new({:results=> 3. :gender => 'male'})
+  #   Person.new({:results => 3. :gender => 'male'})
   # @return [Person]
   def self.new(options = {})
-    if options.has_key?('results')
-      if options[:results] > 40
-        options[:results] = 40
-      end
-    end
+    params = options.map { |k, v| "#{k}=#{v}" } || ''
 
-    params = options.map { |k,v| "#{k}=#{v}" }
+    json = JSON.parse(Net::HTTP.get(URI([
+      RUser::Api::URL,
+      RUser::Api::VERSION,
+      '',
+      '?' + params.join('&')
+    ].join('/'))))
 
-    data = MultiJson.load(RestClient.get [
-      RUser::Api::Url,
-      RUser::Api::Version,
-      "?" + params.join('&')
-    ].join('/'))['results']
+    results(json)
+  end
 
+  # Handles results
+  #
+  # @param [Hash] data the data to be processed.
+  def self.results(data)
     results = []
-
-    data.each do |user|
-      results << RUser::Person.new(Hashie::Mash.new(user))
+    if data['results'].size > 1
+      data['results'].each do |user|
+        results << RUser::Person.new(user, data['nationality'], data['seed'])
+      end
+      results
+    else
+      RUser::Person.new(data['results'][0], data['nationality'], data['seed'])
     end
-
-    results
   end
-
-end
+end

data/lib/ruser/api.rb

@@ -1,11 +1,12 @@
+# frozen_string_literal: true
 module RUser
   # This module defines the RandomUser.me API constants used by classes.
-  # @author Simple App Group, LLC.
+  # @author Joshua Kendall
   module Api
     # The URL for the API.
-    Url = 'http://api.randomuser.me'
+    URL = 'http://api.randomuser.me'.freeze
 
     # The version of the API that is used.
-    Version = '0.4.1'
+    VERSION = '0.7'.freeze
   end
-end
+end

data/lib/ruser/person.rb

@@ -1,24 +1,43 @@
-require 'rest_client'
-require 'multi_json'
-require 'hashie'
-
 module RUser
   # This class allows the creation of new users from the RandomUser.me API.
-  # @author Simple App Group, LLC.
+  # @author Joshua Kendall
   class Person
+    KEYS = {
+      'zip' => 'postal',
+      'first' => 'first_name',
+      'last' => 'last_name',
+      'large' => 'profile_large_url',
+      'medium' => 'profile_medium_url',
+      'thumbnail' => 'profile_thumbnail_url'
+    }.freeze
+
+    NIDT = %w(TFN DNI HETU INSEE PPS BSN SSN NINO).freeze
 
     # @return [String] the user's gender, either male or female.
     attr_reader :gender
 
-    # As of version 1.1.0 the location hash now uses the key :zipcode instead of :zip, so that dot
-    # notation users don't end up using the Ruby Array zip method by calling user.location.zip.
-    # @return [Hash] the user's location including containing the :street, :city, :state, and :zipcode.
-    attr_reader :location
+    # @return [String] the user's title (Mr, Mrs, etc.).
+    attr_reader :title
+
+    # @return [String] the user's first name.
+    attr_reader :first_name
+
+    # @return [String] the user's last name.
+    attr_reader :last_name
 
-    # @return [Hash] the user's name including :title (Mr, Mrs, etc.), :first_name, and :last_name.
-    attr_reader :name
+    # @return [String] the user's street address.
+    attr_reader :street
 
-    # @return [String] the user's email address.
+    # @return [String] the user's city.
+    attr_reader :city
+
+    # @return [String] the user's state.
+    attr_reader :state
+
+    # @return [String] the user's zip code or postal code.
+    attr_reader :postal
+
+    # @return [String] the user's email.
     attr_reader :email
 
     # @return [String] the user's username.
@@ -30,19 +49,19 @@ module RUser
     # @return [String] the user's password salt.
     attr_reader :salt
 
-    # @return [String] the md5 hash of the user's salted password.
+    # @return [String] the user's md5 hash of the user's salted password.
     attr_reader :md5
 
-    # @return [String] the sha1 hash of the user's salted password.
+    # @return [String] the user's sha1 hash of the user's salted password.
     attr_reader :sha1
 
-    # @return [String] the sha256 hash of the user's salted password.
+    # @return [String] the user's sha256 hash of the user's salted password.
     attr_reader :sha256
 
-    # @return [String] the date of the user's registration.
+    # @return [String] the user's registration date.
     attr_reader :registered
 
-    # @return [String] the user's date of birth.
+    # @return [String] the user's birth date.
     attr_reader :dob
 
     # @return [String] the user's phone number.
@@ -51,47 +70,65 @@ module RUser
     # @return [String] the user's cell phone number.
     attr_reader :cell
 
-    # @return [String] the user's social security number.
-    attr_reader :ssn
+    # @return [String] the user's national Id number (SSN, PPS, HETU,, etc.).
+    attr_reader :nidn
+
+    # @return [String] the user's national Id type (SSN, PPS, HETU, NINO, etc.).
+    attr_reader :nidt
 
-    # @return [String] the user's profile picture url.
-    attr_reader :picture
+    # @return [String] the user's large profile photo url
+    attr_reader :profile_large_url
 
-    # @return [String] the user's unique seed which allows future calls for the same user.
+    # @return [String] the user's medium profile photo url
+    attr_reader :profile_medium_url
+
+    # @return [String] the user's thumbnail profile photo url
+    attr_reader :profile_thumbnail_url
+
+    # @return [String] the user's nationality
+    attr_reader :nationality
+
+    # @return [String] the user's unique seed which allows future calls.
     attr_reader :seed
 
     # Creates a new person object
     #
     # @param [Hash] data the data used to create the user
     # @return [Person]
-    def initialize(data)
-      @gender      = data.user.gender
-      @location    = Hashie::Mash.new({
-        "street"    => data.user.location.street,
-        "city"      => data.user.location.city,
-        "state"     => data.user.location.state,
-        "zipcode"   => data.user.location['zip']
-      })
-      @name        = Hashie::Mash.new({
-        "title"       => data.user.name.title,
-        "first_name"  => data.user.name['first'],
-        "last_name"   => data.user.name['last']
-      })
-      @email       = data.user.email
-      @username    = data.user.username
-      @password    = data.user.password
-      @salt        = data.user.salt
-      @md5         = data.user.md5
-      @sha1        = data.user.sha1
-      @sha256      = data.user.sha256
-      @registered  = data.user.registered
-      @dob         = data.user.dob
-      @phone       = data.user.phone
-      @cell        = data.user.cell
-      @ssn         = data.user.SSN
-      @picture     = data.user.picture
-      @seed        = data.seed
+    def initialize(data, nationality, seed)
+      @nationality = nationality
+      @seed = seed
+      convert(data)
+    end
+
+    # Converts a hash to instance variables
+    #
+    # @param [Hash] data the data used to create the instance variables
+    def convert(data)
+      data.each do |k, v|
+        k = KEYS[k] if KEYS.include?(k)
+        v = v.to_s if k.eql? 'zip'
+
+        if NIDT.include?(k)
+          instance_variable_set('@nidt', k)
+          k = 'nidn'
+          v = v.to_s
+        end
+
+        var_set(k, v)
+      end
     end
 
+    # Sets all instance variables
+    #
+    # @param [String] k the key used to create the instance variables
+    # @param [String] v the value used to create the instance variables
+    def var_set(k, v)
+      varget = proc { instance_variable_get("@#{k}") }
+      varset = proc { |y| instance_variable_set("@#{k}", y) }
+      v.is_a?(Hash) ? convert(v) : instance_variable_set("@#{k}", v)
+      self.class.send(:define_method, k, varget)
+      self.class.send(:define_method, "#{k}=", varset)
+    end
   end
-end
+end

data/lib/ruser/version.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module RUser
-  Version = '2.0.1'
-end
+  VERSION = '3.0.0'.freeze
+end

data/spec/features/api_spec.rb

@@ -0,0 +1,16 @@
+require 'ruser'
+require 'spec_helper'
+
+# API Health Test
+# Verifies that the API has not changed.
+describe 'API' do
+  # URL
+  it 'should have the proper url' do
+    expect(RUser::Api::URL).to eq('http://api.randomuser.me')
+  end
+
+  # Version
+  it 'should have the proper version' do
+    expect(RUser::Api::VERSION).to eq('0.7')
+  end
+end

data/spec/features/gender_spec.rb

@@ -0,0 +1,22 @@
+require 'ruser'
+require 'spec_helper'
+
+# Gender Health Test
+# Verifies that we can receive a valid person with a gender field,
+# and that the schema has not changed.
+describe 'Gender' do
+  it 'should be a male user' do
+    user = RUser.new(gender: 'male')
+    expect(user.gender).to eq('male')
+  end
+
+  it 'should be a female user' do
+    user = RUser.new(gender: 'female')
+    expect(user.gender).to eq('female')
+  end
+
+  it 'should be a gendered user' do
+    user = RUser.new
+    expect(user.gender).to be_instance_of(String)
+  end
+end

data/spec/features/seed_spec.rb

@@ -0,0 +1,31 @@
+require 'ruser'
+require 'spec_helper'
+
+# Seed Health Test
+# Verifies that we can receive a valid user with a specific seed and that the
+# schema has not changed.
+describe 'Seed' do
+  before do
+    @user = RUser.new(seed: '73ee20ff00e034b404')
+  end
+
+  it 'should have a reusable seed' do
+    expect(@user.seed).to be_instance_of(String)
+  end
+
+  it 'should have the first name carol' do
+    expect(@user.first_name).to eql('carol')
+  end
+
+  it 'should have the last name williamson' do
+    expect(@user.last_name).to eql('williamson')
+  end
+
+  it 'should be a female user' do
+    expect(@user.gender).to eql('female')
+  end
+
+  it 'should have the seed 73ee20ff00e034b404' do
+    expect(@user.seed).to eql('73ee20ff00e034b404')
+  end
+end

data/spec/features/user_spec.rb

@@ -0,0 +1,114 @@
+require 'ruser'
+require 'spec_helper'
+
+# User Health Test
+# Verifies that we can receive a valid user and that the schema has not changed.
+describe 'User' do
+  before do
+    @user = RUser.new
+  end
+
+  it 'should have a gender' do
+    expect(@user.gender).to be_instance_of(String)
+  end
+
+  it 'should have a title' do
+    expect(@user.title).to be_instance_of(String)
+  end
+
+  it 'should have a first name' do
+    expect(@user.first_name).to be_instance_of(String)
+  end
+
+  it 'should have a last name' do
+    expect(@user.last_name).to be_instance_of(String)
+  end
+
+  it 'should have a street address' do
+    expect(@user.street).to be_instance_of(String)
+  end
+
+  it 'should have a city' do
+    expect(@user.city).to be_instance_of(String)
+  end
+
+  it 'should have a state' do
+    expect(@user.state).to be_instance_of(String)
+  end
+
+  it 'should have a zip or postal code' do
+    expect(@user.postal).to be_instance_of(String)
+  end
+
+  it 'should have an email' do
+    expect(@user.email).to be_instance_of(String)
+  end
+
+  it 'should have a username' do
+    expect(@user.username).to be_instance_of(String)
+  end
+
+  it 'should have a password' do
+    expect(@user.password).to be_instance_of(String)
+  end
+
+  it 'should have a password salt' do
+    expect(@user.salt).to be_instance_of(String)
+  end
+
+  it 'should have a md5 hash of the password' do
+    expect(@user.md5).to be_instance_of(String)
+  end
+
+  it 'should have a sha1 hash of the password' do
+    expect(@user.sha1).to be_instance_of(String)
+  end
+
+  it 'should have a sha256 hash of the password' do
+    expect(@user.sha256).to be_instance_of(String)
+  end
+
+  it 'should have a registration date' do
+    expect(@user.registered).to be_instance_of(Fixnum)
+  end
+
+  it 'should have a date of birth' do
+    expect(@user.dob).to be_instance_of(Fixnum)
+  end
+
+  it 'should have a phone number' do
+    expect(@user.phone).to be_instance_of(String)
+  end
+
+  it 'should have a cell phone number' do
+    expect(@user.cell).to be_instance_of(String)
+  end
+
+  it 'should have a national Id number' do
+    expect(@user.nidn).to be_instance_of(String)
+  end
+
+  it 'should have a national Id type' do
+    expect(@user.nidt).to be_instance_of(String)
+  end
+
+  it 'should have a large profile photo url' do
+    expect(@user.profile_large_url).to be_instance_of(String)
+  end
+
+  it 'should have a medium profile photo url' do
+    expect(@user.profile_medium_url).to be_instance_of(String)
+  end
+
+  it 'should have a thumbnail profile photo url' do
+    expect(@user.profile_thumbnail_url).to be_instance_of(String)
+  end
+
+  it 'should have a nationality' do
+    expect(@user.nationality).to be_instance_of(String)
+  end
+
+  it 'should have a reusable seed' do
+    expect(@user.seed).to be_instance_of(String)
+  end
+end

data/spec/spec_helper.rb

@@ -1,10 +1,20 @@
 require 'rubygems'
 require 'simplecov'
 require 'coveralls'
+require 'codeclimate-test-reporter'
+require 'webmock/rspec'
+require 'support/fakerandomuser'
 
 SimpleCov.start
 Coveralls.wear!
 
+WebMock.disable_net_connect!(allow: 'codeclimate.com')
+
+CodeClimate::TestReporter.start
+
 RSpec.configure do |config|
-  config.order = "random"
-end
+  config.order = 'random'
+  config.before(:each) do
+    stub_request(:get, /api.randomuser.me/).to_rack(FakeRandomUser)
+  end
+end

data/spec/support/fakerandomuser.rb

@@ -0,0 +1,19 @@
+require 'sinatra/base'
+
+class FakeRandomUser < Sinatra::Base
+  get '/0.7/' do
+    if params[:gender] && params[:gender].eql?('male')
+      json_response 200, 'male.json'
+    else
+      json_response 200, 'female.json'
+    end
+  end
+
+  private
+
+  def json_response(response_code, file_name)
+    content_type :json
+    status response_code
+    File.open(File.dirname(__FILE__) + '/fixtures/' + file_name, 'rb').read
+  end
+end

data/spec/support/fixtures/female.json

@@ -0,0 +1,40 @@
+{
+    "results": [
+        {
+            "user": {
+                "gender": "female",
+                "name": {
+                    "title": "ms",
+                    "first": "carol",
+                    "last": "williamson"
+                },
+                "location": {
+                    "street": "3953 grove road",
+                    "city": "york",
+                    "state": "clwyd",
+                    "zip": "AK4 7JW"
+                },
+                "email": "carol.williamson@example.com",
+                "username": "redgorilla103",
+                "password": "lucky13",
+                "salt": "EF8KWSja",
+                "md5": "cd36642a91f62188d7561ce35fce7011",
+                "sha1": "6d0b0e0c4fd58bdf11f7fdb6586188b40a70dd1c",
+                "sha256": "40bac4c83318ed54fe6556f5b2eef3980e7cc733308e85bf5f24603cd037ee01",
+                "registered": 1284008234,
+                "dob": 1087588856,
+                "phone": "015395 78637",
+                "cell": "0745-845-025",
+                "NINO": "SE 18 99 09 K",
+                "picture": {
+                    "large": "https://randomuser.me/api/portraits/women/24.jpg",
+                    "medium": "https://randomuser.me/api/portraits/med/women/24.jpg",
+                    "thumbnail": "https://randomuser.me/api/portraits/thumb/women/24.jpg"
+                }
+            }
+        }
+    ],
+    "nationality": "GB",
+    "seed": "73ee20ff00e034b404",
+    "version": "0.7"
+}

data/spec/support/fixtures/male.json

@@ -0,0 +1,40 @@
+{
+    "results": [
+        {
+            "user": {
+                "gender": "male",
+                "name": {
+                    "title": "mr",
+                    "first": "adolfo",
+                    "last": "peña"
+                },
+                "location": {
+                    "street": "3157 paseo de extremadura",
+                    "city": "gandía",
+                    "state": "la rioja",
+                    "zip": 82066
+                },
+                "email": "adolfo.peña@example.com",
+                "username": "beautifulduck210",
+                "password": "magelan",
+                "salt": "q1QQAlu3",
+                "md5": "046dbdd1995e141afdef4f1245b4cf84",
+                "sha1": "df43fb4a7f088c97b9ba9265e072326824b4a490",
+                "sha256": "fc5bef9fdbc9559ef56bcc01ad7cb6a968847494bc86589a4f5d7f6dda4a44bf",
+                "registered": 1061858115,
+                "dob": 1142231427,
+                "phone": "988-432-692",
+                "cell": "697-947-659",
+                "DNI": "82222742-B",
+                "picture": {
+                    "large": "https://randomuser.me/api/portraits/men/57.jpg",
+                    "medium": "https://randomuser.me/api/portraits/med/men/57.jpg",
+                    "thumbnail": "https://randomuser.me/api/portraits/thumb/men/57.jpg"
+                }
+            }
+        }
+    ],
+    "nationality": "ES",
+    "seed": "88e0778bf400620201",
+    "version": "0.7"
+}

metadata

@@ -1,59 +1,87 @@
 --- !ruby/object:Gem::Specification
 name: ruser
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 3.0.0
 platform: ruby
 authors:
 - Josh Kendall
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-17 00:00:00.000000000 Z
+date: 2016-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: multi_json
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
-  type: :runtime
+        version: '3.4'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '3.4'
 - !ruby/object:Gem::Dependency
-  name: hashie
+  name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.3'
-  type: :runtime
+        version: '1.4'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.3'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
-  name: rest-client
+  name: codeclimate-test-reporter
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :runtime
+        version: '0.4'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.22'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.36'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.36'
 description: A gem to interact with the randomuser.me API.
-email: josh@simpleappgroup.com
+email: me@joshuakendall.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -64,10 +92,15 @@ files:
 - lib/ruser/api.rb
 - lib/ruser/person.rb
 - lib/ruser/version.rb
-- spec/functional/api_spec.rb
-- spec/functional/ruser_spec.rb
+- spec/features/api_spec.rb
+- spec/features/gender_spec.rb
+- spec/features/seed_spec.rb
+- spec/features/user_spec.rb
 - spec/spec_helper.rb
-homepage: http://github.com/simpleappgroup/ruser
+- spec/support/fakerandomuser.rb
+- spec/support/fixtures/female.json
+- spec/support/fixtures/male.json
+homepage: http://github.com/jtkendall/ruser
 licenses:
 - MIT
 metadata: {}
@@ -87,7 +120,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Random User Generator API

data/spec/functional/api_spec.rb

@@ -1,127 +0,0 @@
-require 'ruser'
-require 'spec_helper'
-
-# API Health Test
-# Verifies that the API has not changed.
-describe 'API' do
-
-  describe '.health' do
-    before do
-      @user = RUser.new().first
-    end
-
-    # Gender
-    it 'should have a gender string' do
-      expect(@user.gender).to be_instance_of(String)
-    end
-
-    # Location Hash
-    it 'should have a location hash' do
-      expect(@user.location).to be_instance_of(Hashie::Mash)
-    end
-
-    it 'should have a street address in the location hash' do
-      expect(@user.location.street).to be_instance_of(String)
-    end
-
-    it 'should have a city in the location hash' do
-      expect(@user.location.city).to be_instance_of(String)
-    end
-
-    it 'should have a state in the location hash' do
-      expect(@user.location.state).to be_instance_of(String)
-    end
-
-    it 'should have a zipcode in the location hash' do
-      expect(@user.location.zipcode).to be_instance_of(String)
-    end
-
-    # Name Hash
-    it 'should have a name hash' do
-      expect(@user.name).to be_instance_of(Hashie::Mash)
-    end
-
-    it 'should have a title in the name hash' do
-      expect(@user.name.title).to be_instance_of(String)
-    end
-
-    it 'should have a first name in the name hash' do
-      expect(@user.name.first_name).to be_instance_of(String)
-    end
-
-    it 'should have a last name in the name hash' do
-      expect(@user.name.last_name).to be_instance_of(String)
-    end
-
-    # Email Address
-    it 'should have a email address string' do
-      expect(@user.email).to be_instance_of(String)
-    end
-
-    # Username
-    it 'should have a username string' do
-      expect(@user.username).to be_instance_of(String)
-    end
-
-    # Password
-    it 'should have a password string' do
-      expect(@user.password).to be_instance_of(String)
-    end
-
-    # Salt
-    it 'should have a salt string' do
-      expect(@user.salt).to be_instance_of(String)
-    end
-
-    # MD5
-    it 'should have a md5 string' do
-      expect(@user.sha1).to be_instance_of(String)
-    end
-
-    # SHA1
-    it 'should have a sha1 string' do
-      expect(@user.sha1).to be_instance_of(String)
-    end
-
-    # SHA256
-    it 'should have a sha56 string' do
-      expect(@user.sha256).to be_instance_of(String)
-    end
-
-    # Registered
-    it 'should have a registered string' do
-      expect(@user.registered).to be_instance_of(String)
-    end
-
-    # DOB
-    it 'should have a date of birth string' do
-      expect(@user.dob).to be_instance_of(String)
-    end
-
-    # Phone
-    it 'should have a phone string' do
-      expect(@user.phone).to be_instance_of(String)
-    end
-
-    # Cell
-    it 'should have a cell phone string' do
-      expect(@user.cell).to be_instance_of(String)
-    end
-
-    # SSN
-    it 'should have a ssn string' do
-      expect(@user.ssn).to be_instance_of(String)
-    end
-
-    # Picture
-    it 'should have a picture string' do
-      expect(@user.picture).to be_instance_of(String)
-    end
-
-    # Seed
-    it 'should have a seed string' do
-      expect(@user.seed).to be_instance_of(String)
-    end
-  end
-
-end

data/spec/functional/ruser_spec.rb

@@ -1,54 +0,0 @@
-require 'ruser'
-require 'spec_helper'
-
-describe 'RUser' do
-
-  describe '.man' do
-    before do
-      @man = RUser.new({ :gender => 'male' }).first
-    end
-
-    it 'should return a male user' do
-      expect(@man.gender).to eql('male')
-    end
-  end
-
-  describe '.woman' do
-    before do
-      @woman = RUser.new({ :gender => 'female' }).first
-    end
-
-    it 'should return a female user' do
-      expect(@woman.gender).to eql('female')
-    end
-  end
-
-  describe '.random' do
-    before do
-      @user = RUser.new().first
-    end
-
-    it 'should return a gendered user' do
-      expect(@user.gender).to be_instance_of(String)
-    end
-  end
-
-  describe '.seed' do
-    before do
-     @user = RUser.new({ :seed => 'lazyWolf' }).first
-    end
-
-    it 'should have the first name alberto' do
-      expect(@user.name.first_name).to eql('alberto')
-    end
-
-    it 'should have the last name holland' do
-      expect(@user.name.last_name).to eql('holland')
-    end
-
-    it 'should return a male user' do
-      expect(@user.gender).to eql('male')
-    end
-  end
-
-end