net-dnd 1.1.2

data/spec/dnd/session_spec.rb

@@ -0,0 +1,254 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+require 'net/dnd/session'
+
+module Net ; module DND
+
+  describe Session, "when created with a bad host" do
+
+    before(:each) do
+      @connection = flexmock("Bad Connection")
+      @connection.should_receive(:open?).once.and_return(false)
+      @connection.should_receive(:error).once.and_return("Could not connect to DND server")
+      flexmock(Connection).should_receive(:new).once.and_return(@connection)
+    end
+
+    it "should raise a Connection Error" do
+      lambda { Session.new('my.badhost.com') }.should raise_error(ConnectionError)
+    end
+  end
+
+  describe Session, "when created with a good host" do
+
+    before(:each) do
+      @connection = flexmock("Good Connection")
+      @connection.should_receive(:open?).twice.and_return(true)
+      flexmock(Connection).should_receive(:new).once.and_return(@connection)
+      @session = Session.new('my.goodhost.com')
+    end
+
+    it do
+      @session.should be_open
+    end
+  end
+
+  describe Session, "after closing down" do
+
+    before(:each) do
+      @connection = flexmock("Good Connection")
+      @connection.should_receive(:open?).times(3).and_return(true, true, false)
+      flexmock(Connection).should_receive(:new).once.and_return(@connection)
+      @response = flexmock(Response)
+      @connection.should_receive(:send).once.and_return(@response)
+      @session = Session.new('my.goodhost.com')
+      @session.close
+    end
+
+    it "should not be open" do
+      @session.should_not be_open
+    end
+  end
+
+  describe "a connected session", :shared => true do
+    before(:each) do
+      @connection = flexmock("Good Connection")
+      @connection.should_receive(:open?).twice.and_return(true)
+      flexmock(Connection).should_receive(:new).once.and_return(@connection)
+    end
+  end
+
+  describe "a good response", :shared => true do
+    before(:each) do
+      @response = flexmock(Response)
+      @connection.should_receive(:send).once.and_return(@response)
+      @response.should_receive(:ok?).once.and_return(true)
+      @session = Session.new('my.goodhost.com')
+    end
+  end
+
+  describe Session, "when setting fields with an unknown field" do
+
+    it_should_behave_like "a connected session"
+
+    before(:each) do
+      @response = flexmock(Response)
+      @connection.should_receive(:send).once.and_return(@response)
+      @response.should_receive(:ok?).once.and_return(false)
+      @response.should_receive(:error).once.and_return('unknown.')
+      @session = Session.new('my.goodhost.com')
+      @field_list = ['unknown']
+    end
+
+    it "should raise a Field Not Found error" do
+      lambda { @session.set_fields(@field_list) }.
+        should raise_error(FieldNotFound, "unknown.")
+    end
+  end
+
+  describe Session, "when setting fields with a bad field_list" do
+
+    it_should_behave_like "a connected session"
+    it_should_behave_like "a good response"
+
+    before(:each) do
+      @field_list = ['ssn']
+      @items = ['ssn N N']
+      @response.should_receive(:items).once.and_return(@items)
+      @ssn_field = flexmock("a bad field")
+      @ssn_field.should_receive(:read_all?).once.and_return(false)
+      @ssn_field.should_receive(:to_s).once.and_return('ssn')
+      flexmock(Field).should_receive(:from_field_line).once.and_return(@ssn_field)
+    end
+
+    it "should raise a Field Access Denied error" do
+      lambda { @session.set_fields(@field_list) }.
+        should raise_error(FieldAccessDenied, "#{@field_list[0]} is not world readable.")
+    end
+  end
+
+  describe Session, "when setting fields with a good field_list" do
+
+    it_should_behave_like "a connected session"
+    it_should_behave_like "a good response"
+
+    before(:each) do
+      name_field = flexmock("a name field")
+      name_field.should_receive(:read_all?).once.and_return(true)
+      name_field.should_receive(:to_sym).once.and_return(:name)
+      nickname_field = flexmock("a nickname field")
+      nickname_field.should_receive(:read_all?).once.and_return(true)
+      nickname_field.should_receive(:to_sym).once.and_return(:nickname)
+      flexmock(Field).should_receive(:from_field_line).twice.and_return(name_field, nickname_field)
+      @response.should_receive(:items).once.and_return(['name N A', 'nickname U A'])
+      @session.set_fields(['name', 'nickname'])
+    end
+
+    it "should have [:name, :nickname] as the fields attribute" do
+      @session.fields.should == [:name, :nickname]
+    end
+  end
+
+  describe "mock items for a started session", :shared => true do
+    before(:each) do
+      name_field = flexmock("a name field")
+      name_field.should_receive(:read_all?).once.and_return(true)
+      name_field.should_receive(:to_sym).once.and_return(:name)
+      nickname_field = flexmock("a nickname field")
+      nickname_field.should_receive(:read_all?).once.and_return(true)
+      nickname_field.should_receive(:to_sym).once.and_return(:nickname)
+      flexmock(Field).should_receive(:from_field_line).twice.and_return(name_field, nickname_field)
+      @fields_resp = flexmock(Response)
+      @fields_resp.should_receive(:items).once.and_return(['name N A', 'nickname U A'])
+      @connection = flexmock("A Started Connection")
+      @connection.should_receive(:open?).times(3).and_return(true)
+      flexmock(Connection).should_receive(:new).once.and_return(@connection)
+    end
+  end
+
+  describe Session, "performing a find with no profiles returned" do
+
+    it_should_behave_like "mock items for a started session"
+
+    before(:each) do
+      @find_resp = flexmock(Response)
+      @find_resp.should_receive(:ok?).once.and_return(true)
+      @find_resp.should_receive(:items).once.and_return([])
+      @connection.should_receive(:send).twice.and_return(@fields_resp, @find_resp)
+      @session = Session.start('my.goodhost.com', ['name', 'nickname'])
+      @profiles = @session.find("Nothing returned")
+    end
+
+    it "should return an empty array" do
+      @profiles.should == []
+    end
+
+  end
+
+  describe Session, "performing a find with one profile returned" do
+
+    it_should_behave_like "mock items for a started session"
+
+    before(:each) do
+      @find_resp = flexmock(Response)
+      @find_resp.should_receive(:ok?).once.and_return(true)
+      @find_resp.should_receive(:items).once.and_return([['Joe D. User', 'joey jdu']])
+      @joe = flexmock("Joe's Profile")
+      flexmock(Profile).should_receive(:new).once.and_return(@joe)
+      @connection.should_receive(:send).twice.and_return(@fields_resp, @find_resp)
+      @session = Session.start('my.goodhost.com', ['name', 'nickname'])
+      @profiles = @session.find("Joe User")
+    end
+
+    it "should return a single item array of profiles" do
+      @profiles.length.should == 1
+    end
+
+    it "should return Joe's profile as the first item" do
+      @profiles[0].should equal(@joe)
+    end
+  end
+
+  describe Session, "performing a find with multiple profiles returned" do
+
+    it_should_behave_like "mock items for a started session"
+
+    before(:each) do
+      @joe = flexmock("Joe's Profile")
+      @jane = flexmock("Jane's Profile")
+      flexmock(Profile).should_receive(:new).twice.and_return(@joe, @jane)
+      @find_resp = flexmock(Response)
+      @find_resp.should_receive(:ok?).once.and_return(true)
+      @find_resp.should_receive(:items).once.
+                and_return([['Joe D. User', 'joey jdu'],['Jane P. User', 'janey jpu']])
+      @connection.should_receive(:send).twice.and_return(@fields_resp, @find_resp)
+      @session = Session.start('my.goodhost.com', ['name', 'nickname'])
+      @profiles = @session.find("User")
+    end
+
+    it "should return a 2 item array of profiles" do
+      @profiles.length.should == 2
+    end
+
+    it "should return Jane's profile as the second item" do
+      @profiles[1].should equal(@jane)
+    end
+  end
+
+  describe Session, "performing an bad single find" do
+
+    it_should_behave_like "mock items for a started session"
+
+    before(:each) do
+      @find_resp = flexmock(Response)
+      @find_resp.should_receive(:ok?).once.and_return(true)
+      @find_resp.should_receive(:items).once.and_return([])
+      @connection.should_receive(:send).twice.and_return(@fields_resp, @find_resp)
+      @session = Session.start('my.goodhost.com', ['name', 'nickname'])
+      @profile = @session.find("Nothing", :one)
+    end
+
+    it "should return nil for the profile object" do
+      @profile.should be_nil
+    end
+  end
+
+  describe Session, "performing a good single find" do
+
+    it_should_behave_like "mock items for a started session"
+
+    before(:each) do
+      @find_resp = flexmock(Response)
+      @find_resp.should_receive(:ok?).once.and_return(true)
+      @find_resp.should_receive(:items).twice.and_return([['Joe D. User', 'joey jdu']])
+      @joe = flexmock("Joe's Profile")
+      flexmock(Profile).should_receive(:new).once.and_return(@joe)
+      @connection.should_receive(:send).twice.and_return(@fields_resp, @find_resp)
+      @session = Session.start('my.goodhost.com', ['name', 'nickname'])
+      @profile = @session.find("Joe User", :one)
+    end
+
+    it "should return Joe's profile" do
+      @profile.should equal(@joe)
+    end
+  end
+
+end ; end

data/spec/dnd/user_spec_spec.rb

@@ -0,0 +1,70 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+require 'net/dnd/user_spec'
+
+module Net ; module DND
+  
+  describe UserSpec, "- with a normal (i.e. name) specifier" do
+    before :each do
+      @name = "Joe D. User"
+      @spec = UserSpec.new @name
+    end
+    
+    it "should report a specifier type of :name" do
+      @spec.type.should == :name
+    end
+    
+    it "should return just the supplied specifier when coerced to a string" do
+      @spec.to_s.should == @name
+    end
+  end
+    
+  describe UserSpec, "- with a UID specifier" do
+    before :each do
+      @uid = "123456"
+      @spec = UserSpec.new @uid
+    end
+    
+    it "should report a specifier type of :uid" do
+      @spec.type.should == :uid
+    end
+    
+    it "should return the specifier, with leading \"#\", when coerced to a string" do
+      @spec.to_s.should == "##{@uid}"
+    end
+
+    it "should return the correct inspection string" do
+      @spec.inspect.should match(/<Net::DND::UserSpec specifier="\d+" type=\:.+>/)
+    end
+  end
+    
+  describe UserSpec, "- a standard DID specifier" do
+    before :each do
+      @did = "12345A"
+      @spec = UserSpec.new @did
+    end
+    
+    it "should report a specifier type of :did" do
+      @spec.type.should == :did
+    end
+    
+    it "should return the specifier, with leading \"#*\", when coerced to a string" do
+      @spec.to_s.should == "#*#{@did}"
+    end
+  end
+    
+  describe UserSpec, "- with a non-standard DID specifier" do
+    before :each do
+      @did = "Z12345"
+      @spec = UserSpec.new @did
+    end
+    
+    it "should report a specifier type of :did" do
+      @spec.type.should == :did
+    end
+    
+    it "should return the specifier, with leading \"#*\", when coerced to a string" do
+      @spec.to_s.should == "#*#{@did}"
+    end
+  end
+  
+end ; end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+$LOAD_PATH.unshift "#{File.dirname(__FILE__)}/../lib"
+require 'rubygems'
+require 'spec'
+
+Spec::Runner.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  config.mock_with :flexmock
+  # config.mock_with :rr
+end

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification 
+name: net-dnd
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 1
+  - 2
+  version: 1.1.2
+platform: ruby
+authors: 
+- Brian V. Hughes
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-22 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 1
+        - 0
+        - 10
+        version: 1.0.10
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 2
+        - 5
+        - 0
+        version: 2.5.0
+  type: :development
+  version_requirements: *id002
+description: Ruby library for DND lookups.
+email: 
+- brianvh@dartmouth.edu
+executables: 
+- dndwho
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/dndwho
+- lib/net/dnd.rb
+- lib/net/dnd/connection.rb
+- lib/net/dnd/errors.rb
+- lib/net/dnd/expires.rb
+- lib/net/dnd/field.rb
+- lib/net/dnd/profile.rb
+- lib/net/dnd/response.rb
+- lib/net/dnd/session.rb
+- lib/net/dnd/user_spec.rb
+- lib/net/dnd/version.rb
+- net-dnd.gemspec
+- spec/dnd/connection_spec.rb
+- spec/dnd/field_spec.rb
+- spec/dnd/profile_spec.rb
+- spec/dnd/response_spec.rb
+- spec/dnd/session_spec.rb
+- spec/dnd/user_spec_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/brianvh/net-dnd/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 21
+      segments: 
+      - 1
+      - 3
+      - 7
+      version: 1.3.7
+requirements: []
+
+rubyforge_project: net-dnd
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: net-dnd-1.1.2
+test_files: 
+- spec/dnd/connection_spec.rb
+- spec/dnd/field_spec.rb
+- spec/dnd/profile_spec.rb
+- spec/dnd/response_spec.rb
+- spec/dnd/session_spec.rb
+- spec/dnd/user_spec_spec.rb
+- spec/spec_helper.rb