ns-yapi 0.2.1 → 0.3.0

data/Gemfile

@@ -1,14 +1,15 @@
 source 'http://rubygems.org'
 
 gem "httpclient", "~> 2.3.3"
+gem 'rake'
 
 gemspec
 
 group :test do
   gem 'rspec'
   gem 'simplecov'
-  gem 'rake'
   gem "webmock", "~> 1.11.0"
+  gem "timecop", "~> 0.6.1"
   gem 'mocha', require: 'mocha/api'
   gem 'coveralls', require: false
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ns-yapi (0.2.1)
+    ns-yapi (0.3.0)
       httpclient
       nokogiri
       nori
@@ -47,6 +47,7 @@ GEM
       simplecov-html (~> 0.7.1)
     simplecov-html (0.7.1)
     thor (0.18.1)
+    timecop (0.6.1)
     webmock (1.11.0)
       addressable (>= 2.2.7)
       crack (>= 0.3.2)
@@ -62,4 +63,5 @@ DEPENDENCIES
   rake
   rspec
   simplecov
+  timecop (~> 0.6.1)
   webmock (~> 1.11.0)

data/LICENSE.mkd

@@ -0,0 +1,7 @@
+Copyright (c) 2013 Zilverline / Stefan Hendriks
+
+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.

data/README.md

@@ -1,16 +1,15 @@
-Yet Another NS API [![Build Status](https://travis-ci.org/stefanhendriks/ns-api.png?branch=master)](https://travis-ci.org/stefanhendriks/ns-api) [![Coverage Status](https://coveralls.io/repos/stefanhendriks/ns-api/badge.png)](https://coveralls.io/r/stefanhendriks/ns-api) [![Dependency Status](https://gemnasium.com/stefanhendriks/ns-api.png)](https://gemnasium.com/stefanhendriks/ns-api)
+Yet Another NS API [![Build Status](https://travis-ci.org/stefanhendriks/ns-api.png?branch=master)](https://travis-ci.org/stefanhendriks/ns-api) [![Coverage Status](https://coveralls.io/repos/stefanhendriks/ns-api/badge.png)](https://coveralls.io/r/stefanhendriks/ns-api)
 ==================
 A Ruby client for the NS API.
 
 Goal
 ====
-I'd like to write a comprehensive, yet very thin implementation of the NS API. For now I have limited access therefor this gem is limited.
+I'd like to write a comprehensive, yet very thin implementation of the NS API.
 
-If you have credentials that work with the prices-api calls, and are willing to share them with me so I can expand this gem. Please contact me.
-
-You can also send me an example response, so I can work from there. Although I would like to see it working for real as well.
-
-Pull requests are welcome.
+Currently this gem supports
+* fetching all stations
+* fetching disruptions
+* fetching prices (you need to have a contract with NS for this)
 
 Usage
 =====
@@ -54,6 +53,15 @@ station.lat # 51.69048
 station.long # 5.29362
 ```
 
+If you find it too tedious ploughing through all objects in the array, you can also use the ```stations_short``` method. This will return a hash with the station code as key, the
+value is an array with the name and country of the station.
+
+```ruby
+client.stations_short
+ => {"HT"=>["'s-Hertogenbosch", "NL"], "HTO"=>["Hertogenbosch O.", "NL"], "HDE"=>["'t Harde", "NL"], "AHBF"=>["Aachen", "D"], "ARE"=>["Aachen R. Erde", "D"], "ASCH"=>["Aachen Schanz", "D"], "AW"=>["Aachen-West", "D"], "ATN"=>["Aalten", "NL"], "AC"=>["Abcoude", "NL"], "EAHS"=>["Ahaus", "D"], "AIME"=>["Aime-la-Plagne", "F"], "AIXTGV"=>["Aix-en-Provence", "F"], "AKM"=>["Akkrum", "NL"], "ALBERT"=>["Albertville", "F"], "ALESS"=>["Alessandria", "I"], "AMR"=>["Alkmaar", "NL"], "AMRN"=>["Alkmaar Noord", "NL"], "AML"=>["Almelo", "NL"], "AMRI"=>["Almelo de Riet", "NL"], "ALMB"=>["Almere Buiten", "NL"], "ALM"=>["Almere C.", "NL"], "ALMM"=>["Muziekwijk", "NL"], "ALMO"=>["Oostvaarders", "NL"], "ALMP"=>["Parkwijk", "NL"], "AMPO"=>["Poort", "NL"], "APN"=>["Alphen a/d Rijn", "NL"], "EABG"=>["Altenberge", "D"], "AMF"=>["Amersfoort", "NL"], "AMFS"=>["Schothorst", "NL"]....
+```
+
+
 Retrieve disruptions
 ====================
 ```ruby
@@ -72,3 +80,59 @@ disruptions = client.disruptions "Amsterdam"
 # will raise an NSClient::InvalidStationNameError error when station name is invalid
 client.disruptions "bla" # NSClient::InvalidStationNameError: Could not find a station with name 'bla'
 ```
+
+Retrieve prices
+===============
+Prices can be retrieved by using a valid ```from```,```to```,```via``` parameter. You can use the name of the station or the code. (as you can see above with the stations calls)
+
+```ruby
+# retrieving prices requires a from and to at minimum. Which assumes prices for today
+prices = client.prices from: "Amsterdam Centraal", to: "Purmerend"
+
+# if you'd rather retrieve prices for a specific date, this is an optional parameter. If not given, today is assumed.
+tomorrow = Date.today + 1.day
+prices_tomorrow = client.prices from: "Amsterdam Centraal", to: "Purmerend", date: tomorrow
+
+# you can specify a via option, this is also optional
+prices_via = client.prices from: "Amsterdam Centraal", to: "Purmerend", via: "Zaandam"
+
+# retrieve prices for tomorrow, via specific station
+prices_via_tomorrow = client.prices from: "Amsterdam Centraal", to: "Purmerend", via: "Zaandam", date: tomorrow
+
+# Using an invalid station name will result in a...
+# NSClient::InvalidStationNameError: 'Amsterdam' is not a valid station name
+prices = client.prices from: "Amsterdam", to "Purmerend"
+
+```
+
+Prices Response data
+--------------------
+A prices response is an object PricesResponse, which contains tariffunits (a measurement for cost-distance) and a hash with prices.
+
+Each key in this hash is the type of prices (ie 'Dagretour', or 'Enkele reis').
+
+In case different types would be added by the NS, than this API will simply add them to the hash, which makes it quite flexible.
+
+```ruby
+prices = client.prices from: "Amsterdam Centraal", to: "Purmerend"
+
+# show tarif units (tariefeenheden)
+prices.tariff_units # 10
+
+# show prices for "Dagretour", easy method
+dagretour_prices = prices.dagretour # is same as prices.products["Dagretour"]
+
+# first price for "Dagretour", contains three values
+dagretour_prices[0].type # vol tarief
+dagretour_prices[0].train_class # "2"
+dagretour_prices[0].amount # 2.40
+
+# show prices for "Enkele reis", easy method
+enkelereis_prices = prices.enkelereis
+```
+
+
+Copyright
+---------
+Copyright (c) 2013 Zilverline / Stefan Hendriks.
+See [LICENSE](https://github.com/zilverline/ns-api/blob/master/LICENSE.mkd) for details.

data/lib/model/prices_url.rb

@@ -0,0 +1,16 @@
+class PricesUrl
+
+  def initialize(url)
+    raise InvalidURL, "You must give an url, ie http://www.ns.nl/api" unless url
+    @url = url
+  end
+
+  def url (opts = {date: nil, from: "", to: "", date: nil})
+    opts[:date] = opts[:date].strftime("%d%m%Y") if opts[:date]
+    uri = URI.escape(opts.collect{|k,v| "#{k}=#{v}"}.join('&'))
+    "#{@url}?#{uri}"
+  end
+
+  class InvalidURL < StandardError
+  end
+end

data/lib/ns_client.rb

@@ -5,6 +5,8 @@ require 'nokogiri'
 
 require 'httpclient'
 
+require "addressable/uri"
+
 this = Pathname.new(__FILE__).realpath
 lib_path = File.expand_path("..", this)
 $:.unshift(lib_path)
@@ -42,17 +44,61 @@ class NSClient
   def initialize(username, password)
     @client = HTTPClient.new
     @client.set_auth("http://webservices.ns.nl", username, password)
+    @prices_url = PricesUrl.new("http://webservices.ns.nl/ns-api-prijzen-v2")
   end
 
   def stations
-    response = @client.get "http://webservices.ns.nl/ns-api-stations-v2"
+    parse_stations(get_xml("http://webservices.ns.nl/ns-api-stations-v2"))
+  end
+
+  def stations_short
+    parse_stations_as_map(get_xml("http://webservices.ns.nl/ns-api-stations-v2"))
+  end
+
+  def disruptions (query = nil)
+    response_xml = get_xml(disruption_url(query))
+    raise_error_when_response_is_error(response_xml)
+    parse_disruptions(response_xml)
+  end
+
+  def prices (opts = {from: nil, to: nil, via: nil, date: nil})
+    raise MissingParameter, "from and to station is required" if (opts[:from] == nil && opts[:to] == nil)
+    raise MissingParameter, "from station is required" unless opts[:from]
+    raise MissingParameter, "to station is required" unless opts[:to]
+    response_xml = get_xml(@prices_url.url(opts))
+    raise_error_when_response_is_error(response_xml)
+    parse_prices(response_xml)
+  end
+
+  def parse_prices(response_xml)
+    prices_response = PricesResponse.new
+    (response_xml/'/Producten').each do |products|
+      prices_response.tariff_units = (products/'./Tariefeenheden').text.to_i
+
+      (products/'Product').each do |product|
+        prices = []
+        (product/'Prijs').each do |price_element|
+          product_price = ProductPrice.new
+          product_price.type = price_element.attr("korting")
+          product_price.train_class = price_element.attr("klasse")
+          product_price.amount = price_element.text.gsub(",", ".").to_f
+          prices << product_price
+        end
+        name = product.attr('naam')
+        prices_response.products[name] = prices
+      end
+
+    end
+    prices_response
+  end
+
+  def parse_stations(response_xml)
     result = []
-    xdoc = Nokogiri.XML(response.content)
-    (xdoc/'/Stations/Station').each do |station|
+    (response_xml/'/Stations/Station').each do |station|
       s = Station.new
       s.code = (station/'./Code').text
       s.type = (station/'./Type').text
-      s.land = (station/'./Land').text
+      s.country = (station/'./Land').text
       s.short_name = (station/'./Namen/Kort').text
       s.name = (station/'./Namen/Middel').text
       s.long_name = (station/'./Namen/Lang').text
@@ -64,18 +110,20 @@ class NSClient
     result
   end
 
-  def disruptions (query = nil)
-    response = @client.get disruption_url(query)
-    result = {planned: [], unplanned: []}
-    xdoc = Nokogiri.XML(response.content)
-
-    (xdoc/'/error').each do |error|
-      message = (error/'./message').text
-      raise InvalidStationNameError, message
+  def parse_stations_as_map(response_xml)
+    result = {}
+    (response_xml/'/Stations/Station').each do |station|
+      code = (station/'./Code').text
+      name = (station/'./Namen/Middel').text
+      country = (station/'./Land').text
+      result[code] = [name, country]
     end
+    result
+  end
 
-    (xdoc/'/Storingen').each do |disruption|
-
+  def parse_disruptions(response_xml)
+    result = {planned: [], unplanned: []}
+    (response_xml/'/Storingen').each do |disruption|
       (disruption/'Ongepland/Storing').each do |unplanned|
         unplanned_disruption = UnplannedDisruption.new
         unplanned_disruption.id = (unplanned/'./id').text
@@ -101,34 +149,20 @@ class NSClient
     result
   end
 
-  def prices (opts = {from: nil, to: nil, via: nil, date: nil})
-    date = opts[:date]
-    response = @client.get "http://@webservices.ns.nl/ns-api-prijzen-v2?from=#{opts[:from]}&to=#{opts[:to]}&via=#{opts[:via]}&date=#{date.strftime("%d%m%Y")}"
-    xdoc = Nokogiri.XML(response.content)
-    prices_response = PricesResponse.new
-    (xdoc/'/Producten').each do |products|
-      prices_response.tariff_units = (products/'./Tariefeenheden').text.to_i
-
-      (products/'Product').each do |product|
-        prices = []
-        (product/'Prijs').each do |price_element|
-          product_price = ProductPrice.new
-          product_price.amount = price_element.text
-          prices << product_price
-        end
-        name = product.attr('naam')
-        prices_response.products[name] = prices
-      end
-
+  def raise_error_when_response_is_error(xdoc)
+    (xdoc/'/error').each do |error|
+      message = (error/'./message').text
+      raise InvalidStationNameError, message
     end
-    prices_response
   end
 
+  def get_xml(url)
+    response = @client.get url
+    Nokogiri.XML(response.content)
+  end
 
   def disruption_url(query)
-    if query
-      return "http://webservices.ns.nl/ns-api-storingen?station=#{query}"
-    end
+    return "http://webservices.ns.nl/ns-api-storingen?station=#{query}" if query
     "http://webservices.ns.nl/ns-api-storingen?actual=true"
   end
 
@@ -139,10 +173,19 @@ class NSClient
       @products = {}
       @tariff_units = 0
     end
+
+    def enkele_reis
+      products["Enkele reis"]
+    end
+
+    def dagretour
+      products["Dagretour"]
+    end
+
   end
 
   class ProductPrice
-    attr_accessor :discount, :class, :amount
+    attr_accessor :type, :train_class, :amount
   end
 
   class UnplannedDisruption
@@ -154,11 +197,13 @@ class NSClient
   end
 
   class Station
-    attr_accessor :code, :type, :land, :short_name, :name, :long_name, :uiccode, :synonyms, :lat, :long
+    attr_accessor :code, :type, :country, :short_name, :name, :long_name, :uiccode, :synonyms, :lat, :long
   end
 
   class InvalidStationNameError < StandardError
+  end
 
+  class MissingParameter < StandardError
   end
 
 end

data/ns.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |gem|
   gem.name          = "ns-yapi"
-  gem.version       = '0.2.1'
+  gem.version       = '0.3.0'
   gem.authors       = ["Stefan Hendriks"]
   gem.email         = ["stefanhen83@gmail.com"]
   gem.description   = %q{Yet Another (Ruby) NS API client}

data/spec/fixtures/prices_invalid_station_name.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ 
+<error>
+	<message>&#039;Amsterdam&#039; is not a valid station name</message>
+</error>

data/spec/model/prices_url_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe PricesUrl do
+
+  it "takes a fixed url as constructor argument" do
+    PricesUrl.new("www.somehost.com")
+  end
+
+  it "raises an error when no url is given" do
+    expect { PricesUrl.new(nil) }.to raise_error(PricesUrl::InvalidURL, "You must give an url, ie http://www.ns.nl/api")
+  end
+
+  let(:prices_url) { PricesUrl.new("hostname") }
+
+  it "uses given date" do
+    prices_url.url(date: Date.new(2013, 7, 12)).should == "hostname?date=12072013"
+  end
+
+  it "uses from" do
+    expected_from = "Amsterdam"
+    prices_url.url(from:"Amsterdam").should == "hostname?from=#{expected_from}"
+  end
+
+  it "uses to" do
+    expected_to = "Purmerend"
+    prices_url.url(to:"Purmerend").should == "hostname?to=#{expected_to}"
+  end
+
+  it "uses via" do
+    expected_via = "Zaandam"
+    prices_url.url(via:"Zaandam").should == "hostname?via=#{expected_via}"
+  end
+
+  it "uses any all variables for from/to/via" do
+    prices_url.url(from:"Purmerend",to: "Amsterdam", via:"Zaandam").should == "hostname?from=Purmerend&to=Amsterdam&via=Zaandam"
+  end
+
+  it "html encodes" do
+    prices_url.url(from:"Purmerend",to: "Amsterdam Centraal").should == "hostname?from=Purmerend&to=Amsterdam%20Centraal"
+  end
+
+  ANY_DATE = Date.new(2013, 8, 13)
+  ANY_DATE_STR = "13082013"
+
+end

data/spec/ns_client_spec.rb

@@ -26,12 +26,19 @@ describe NSClient do
       first_station.short_name.should == "H'bosch"
       first_station.name.should == "'s-Hertogenbosch"
       first_station.long_name.should == "'s-Hertogenbosch"
-      first_station.land.should == "NL"
+      first_station.country.should == "NL"
       first_station.uiccode.should == "8400319"
       first_station.lat.should == "51.69048"
       first_station.long.should == "5.29362"
     end
 
+    it "should retrieve a convenient hash with usable station names and codes for prices usage" do
+      stations = @client.stations_short
+      stations.size.should == 620
+      stations["HT"].should == ["'s-Hertogenbosch", "NL"]
+    end
+
+
   end
 
   context "Disruptions" do
@@ -105,6 +112,7 @@ describe NSClient do
   end
 
   context "Prices" do
+
     it "should retrieve prices for a trip" do
       stub_ns_client_request "http://username:password@webservices.ns.nl/ns-api-prijzen-v2?from=Purmerend&to=Amsterdam&via=Zaandam&date=17062013", load_fixture('prices.xml')
       date = Date.strptime('17-06-2013', '%d-%m-%Y')
@@ -113,17 +121,58 @@ describe NSClient do
       response.tariff_units.should == 10
       response.products.size.should == 2
 
-      enkele_reis = response.products["Enkele reis"]
-      enkele_reis.size.should == 6
+      response.enkele_reis.size.should == 6
+      response.dagretour.size.should == 6
     end
 
-    xit "should retrieve expected price data"
+    it "should retrieve expected price data" do
+      stub_ns_client_request "http://username:password@webservices.ns.nl/ns-api-prijzen-v2?from=Purmerend&to=Amsterdam&via=Zaandam&date=17062013", load_fixture('prices.xml')
+      date = Date.strptime('17-06-2013', '%d-%m-%Y')
+      response = @client.prices from: "Purmerend", to: "Amsterdam", via: "Zaandam", date: date
+      response.class.should == NSClient::PricesResponse
+      response.tariff_units.should == 10
+      response.products.size.should == 2
 
-    xit "assumes date is now, when not given"
-    xit "should treat via as optional parameter"
-    xit "should raise error when from is not given"
-    xit "should raise error when to is not given"
+      assert_price(response.enkele_reis[0], "vol tarief", "2", 2.4)
+      assert_price(response.enkele_reis[1], "reductie_20", "2", 1.90)
+      assert_price(response.enkele_reis[2], "reductie_40", "2", 1.40)
+      assert_price(response.enkele_reis[3], "vol tarief", "1", 4.10)
+      assert_price(response.enkele_reis[4], "reductie_20", "1", 3.3)
+      assert_price(response.enkele_reis[5], "reductie_40", "1", 2.5)
+    end
+
+    it "should raise error when from is not given" do
+      expect {
+        @client.prices from: nil, to: "Amsterdam"
+      }.to raise_error(NSClient::MissingParameter, "from station is required")
+    end
+
+    it "should raise an error when from is not a valid station name" do
+      date = Date.strptime('17-06-2013', '%d-%m-%Y')
+      stub_ns_client_request "http://username:password@webservices.ns.nl/ns-api-prijzen-v2?from=Amsterdam&to=Purmerend&date=17062013", load_fixture('prices_invalid_station_name.xml')
+      expect {
+        @client.prices from: "Amsterdam", to: "Purmerend", date: date
+      }.to raise_error(NSClient::InvalidStationNameError, "'Amsterdam' is not a valid station name")
+    end
+
+    it "should raise error when to is not given" do
+      expect {
+        @client.prices from: "Purmerend", to: nil
+      }.to raise_error(NSClient::MissingParameter, "to station is required")
+    end
+
+    it "should raise error complaining about from and to missing when both not given" do
+      expect {
+        @client.prices from: nil, to: nil
+      }.to raise_error(NSClient::MissingParameter, "from and to station is required")
+    end
+
+  end
 
+  def assert_price(element, expected_type, expected_train_class, expected_amount)
+    element.type.should == expected_type
+    element.train_class.should == expected_train_class
+    element.amount.should == expected_amount
   end
 
   def stub_ns_client_request(url, response)

data/spec/spec_helper.rb

@@ -4,22 +4,38 @@ SimpleCov.start
 require 'coveralls'
 Coveralls.wear!
 
+
 require 'httpclient'
 
 require 'mocha/api'
 require 'webmock/rspec'
-
+require 'timecop'
 
 spec_helper = Pathname.new(__FILE__).realpath
 lib_path  = File.expand_path("../../lib", spec_helper)
 $:.unshift(lib_path)
 
+##############################################################
+# Configure rspec
+
+RSpec.configure do |config|
+  config.order = "random"
+
+  config.after(:each) do
+    Timecop.return # make sure timecop is disabled after each test
+  end
+
+end
+
+# END
+##############################################################
 $ROOT = File.expand_path("../", lib_path)
 
 Dir.glob(File.join(lib_path, '/**/*.rb')).each do |file|
   require file
 end
 
+# helper methods for easier testing
 def load_fixture(filename)
   File.read(File.join($ROOT, "spec/fixtures/#{filename}"))
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ns-yapi
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-19 00:00:00.000000000 Z
+date: 2013-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient
@@ -71,7 +71,9 @@ files:
 - .travis.yml
 - Gemfile
 - Gemfile.lock
+- LICENSE.mkd
 - README.md
+- lib/model/prices_url.rb
 - lib/ns_client.rb
 - ns.gemspec
 - rakefile.rb
@@ -80,7 +82,9 @@ files:
 - spec/fixtures/disruptions_amsterdam.xml
 - spec/fixtures/no_disruptions.xml
 - spec/fixtures/prices.xml
+- spec/fixtures/prices_invalid_station_name.xml
 - spec/fixtures/stations.xml
+- spec/model/prices_url_spec.rb
 - spec/ns_client_spec.rb
 - spec/nsyapi_spec.rb
 - spec/spec_helper.rb
@@ -98,7 +102,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4220924222430246748
+      hash: -1397451197090581967
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -107,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4220924222430246748
+      hash: -1397451197090581967
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -120,7 +124,9 @@ test_files:
 - spec/fixtures/disruptions_amsterdam.xml
 - spec/fixtures/no_disruptions.xml
 - spec/fixtures/prices.xml
+- spec/fixtures/prices_invalid_station_name.xml
 - spec/fixtures/stations.xml
+- spec/model/prices_url_spec.rb
 - spec/ns_client_spec.rb
 - spec/nsyapi_spec.rb
 - spec/spec_helper.rb