ladle 0.1.0

data/lib/ladle/version.rb

@@ -0,0 +1,5 @@
+module Ladle
+  ##
+  # The current version number for Ladle.
+  VERSION = "0.1.0"
+end

data/spec/ladle/animals.ldif

@@ -0,0 +1,28 @@
+version: 1
+
+dn: ou=animals,dc=example,dc=net
+objectClass: top
+objectClass: organizationalUnit
+ou: animals
+
+dn: uid=aa927,ou=animals,dc=example,dc=net
+objectClass: top
+objectClass: person
+objectClass: organizationalPerson
+objectClass: inetOrgPerson
+cn: Ada Aardvark
+sn: Aardvark
+givenName: Ada
+mail: ada@example.net
+uid: aa927
+
+dn: uid=bb954,ou=animals,dc=example,dc=net
+objectClass: top
+objectClass: person
+objectClass: organizationalPerson
+objectClass: inetOrgPerson
+cn: Bob Badger
+sn: Badger
+givenName: Bob
+mail: badger@example.net
+uid: bb954

data/spec/ladle/server_spec.rb

@@ -0,0 +1,306 @@
+require File.expand_path("../../spec_helper.rb", __FILE__)
+
+require 'net/ldap'
+
+describe Ladle, "::Server" do
+  def create_server(opts = {})
+    Ladle::Server.new({ :quiet => true, :tmpdir => tmpdir }.merge(opts))
+  end
+
+  before do
+    @server = create_server
+  end
+
+  after do
+    @server.stop
+
+    left_over_pids = `ps`.split("\n").grep(/net.detailedbalance.ladle.Main/).
+      collect { |line| line.split(/\s+/)[0].to_i }
+    left_over_pids.each { |pid|
+      $stderr.puts "Killing leftover process #{pid}"
+      Process.kill 15, pid
+    }
+    left_over_pids.should be_empty
+  end
+
+  describe "initialization of" do
+    def preserve_and_wipe_env(*env_vars)
+      @old_env = env_vars.inject({}) { |e, k| e[k] = ENV[k]; e }
+      @old_env.keys.each { |k| ENV[k] = nil }
+    end
+
+    def restore_env
+      @old_env.each { |k, v| ENV[k] = v }
+    end
+
+    describe ":port" do
+      it "defaults to 3897" do
+        Ladle::Server.new.port.should == 3897
+      end
+
+      it "can be overridden" do
+        Ladle::Server.new(:port => 4200).port.should == 4200
+      end
+    end
+
+    describe ":domain" do
+      it "defaults to dc=example,dc=org" do
+        Ladle::Server.new.domain.should == "dc=example,dc=org"
+      end
+
+      it "can be overridden" do
+        Ladle::Server.new(:domain => "dc=northwestern,dc=edu").domain.
+          should == "dc=northwestern,dc=edu"
+      end
+
+      it "rejects a domain that doesn't start with 'dc='" do
+        lambda { Ladle::Server.new(:domain => "foo") }.
+          should raise_error("The domain component must start with 'dc='.  'foo' does not.")
+      end
+    end
+
+    describe ":ldif" do
+      it "defaults to lib/ladle/default.ldif" do
+        Ladle::Server.new.ldif.should =~ %r{lib/ladle/default.ldif$}
+      end
+
+      it "can be overridden" do
+        ldif_file = "#{tmpdir}/foo.ldif"
+        FileUtils.touch ldif_file
+        Ladle::Server.new(:ldif => ldif_file).ldif.should == ldif_file
+      end
+
+      it "fails if the file can't be read" do
+        lambda { Ladle::Server.new(:ldif => "foo/bar.ldif") }.
+          should raise_error("Cannot read specified LDIF file foo/bar.ldif.")
+      end
+    end
+
+    describe ":verbose" do
+      it "defaults to false" do
+        Ladle::Server.new.verbose?.should be_false
+      end
+
+      it "can be overridden" do
+        Ladle::Server.new(:verbose => true).verbose?.should be_true
+      end
+    end
+
+    describe ":quiet" do
+      it "defaults to false" do
+        Ladle::Server.new.quiet?.should be_false
+      end
+
+      it "can be overridden" do
+        Ladle::Server.new(:quiet => true).quiet?.should be_true
+      end
+    end
+
+    describe ":timeout" do
+      it "defaults to 15 seconds" do
+        Ladle::Server.new.timeout.should == 15
+      end
+
+      it "can be overridden" do
+        Ladle::Server.new(:timeout => 27).timeout.should == 27
+      end
+    end
+
+    describe ":tmpdir" do
+      before do
+        preserve_and_wipe_env("TMPDIR", "TEMPDIR")
+      end
+
+      after do
+        restore_env
+      end
+
+      it "defaults to TMPDIR if set" do
+        ENV["TMPDIR"] = tmpdir('foo')
+        Ladle::Server.new.tmpdir.should == tmpdir('foo')
+      end
+
+      it "defaults to TEMPDIR if set" do
+        ENV["TEMPDIR"] = tmpdir('baz')
+        Ladle::Server.new.tmpdir.should == tmpdir('baz')
+      end
+
+      it "prefers the explicitly provided value" do
+        ENV["TMPDIR"] = tmpdir('quux')
+        ENV["TEMPDIR"] = tmpdir('bar')
+        Ladle::Server.new(:tmpdir => tmpdir('zap')).tmpdir.
+          should == tmpdir('zap')
+      end
+
+      it "must exist" do
+        lambda { Ladle::Server.new(:tmpdir => 'whatever') }.
+          should raise_error(/Tmpdir "whatever" does not exist./)
+      end
+
+      it "must be specified somehow" do
+        lambda { Ladle::Server.new }.
+          should raise_error(/Cannot guess tmpdir from the environment.  Please specify it./)
+      end
+    end
+
+    describe ":java" do
+      before do
+        preserve_and_wipe_env("JAVA_HOME")
+      end
+
+      after do
+        restore_env
+      end
+
+      it "relies on the path with no JAVA_HOME" do
+        Ladle::Server.new.java_bin.should == "java"
+      end
+
+      it "defaults to JAVA_HOME/bin/java if available" do
+        ENV["JAVA_HOME"] = tmpdir('myjdk')
+        Ladle::Server.new.java_bin.should == "#{tmpdir}/myjdk/bin/java"
+      end
+
+      it "can be overridden" do
+        Ladle::Server.new(:java_bin => File.join(tmpdir('openjdk'), "jre")).java_bin.
+          should == "#{tmpdir}/openjdk/jre"
+      end
+    end
+  end
+
+  describe "running" do
+    def should_be_running
+      lambda { TCPSocket.new('localhost', @server.port) }.
+        should_not raise_error
+    end
+
+    it "blocks until the server is up" do
+      @server.start
+      should_be_running
+    end
+
+    it "returns the server object" do
+      @server.start.should be(@server)
+    end
+
+    it "is safe to invoke twice (in the same thread)" do
+      @server.start
+      lambda { @server.start }.should_not raise_error
+    end
+
+    it "can be stopped then started again" do
+      @server.start
+      @server.stop
+      @server.start
+      lambda { TCPSocket.new('localhost', @server.port) }.
+        should_not raise_error
+    end
+
+    it "throws an exception when the server doesn't start up" do
+      old_stderr, $stderr = $stderr, StringIO.new
+
+      @server = create_server(:more_args => ["--fail", "before_start"])
+      lambda { @server.start }.should raise_error(/LDAP server failed to start/)
+      $stderr.string.should == "ApacheDS process failed: FATAL: Expected failure for testing\n"
+
+      $stderr = old_stderr
+    end
+
+    it "times out after the specified interval" do
+      @server = create_server(:timeout => 3, :more_args => %w(--fail hang))
+      lambda { @server.start }.
+        should raise_error(/LDAP server startup did not complete within 3 seconds/)
+    end
+
+    it "should use the specified port" do
+      @server = create_server(:port => 45678).start
+      should_be_running
+    end
+
+    it "uses the specified tmpdir" do
+      target = tmpdir('baz')
+      @server = create_server(:tmpdir => target).start
+      Dir["#{target}/ladle-server-*"].size.should == 1
+    end
+
+    it "cleans up the tmpdir afterward" do
+      target = tmpdir('quux')
+      @server = create_server(:tmpdir => target).start
+      @server.stop
+      Dir["#{target}/ladle-server-*"].size.should == 0
+    end
+  end
+
+  describe "data" do
+    before do
+      pending "Net::LDAP doesn't work on 1.9" if RUBY_VERSION =~ /1.9/
+    end
+
+    def with_ldap
+      @server.start
+      Net::LDAP.open(ldap_parameters) do |ldap|
+        return yield ldap
+      end
+    end
+
+    def ldap_search(filter, base=nil)
+      with_ldap { |ldap|
+        ldap.search(
+          :base => base || 'dc=example,dc=org',
+          :filter => filter
+        )
+      }
+    end
+
+    def ldap_parameters
+      @ldap_parameters ||= {
+        :host => 'localhost', :port => @server.port,
+        :auth => { :method => :anonymous }
+      }
+    end
+
+    describe "the default set" do
+      it "has 26 people" do
+        ldap_search(Net::LDAP::Filter.pres('uid')).should have(26).people
+      end
+
+      it "has 1 group" do
+        ldap_search(Net::LDAP::Filter.pres('ou')).should have(1).group
+      end
+
+      it "has given names" do
+        ldap_search(Net::LDAP::Filter.pres('uid')).
+          select { |res| !res[:givenname] || res[:givenname].empty? }.should == []
+      end
+
+      it "has e-mail addresses" do
+        ldap_search(Net::LDAP::Filter.pres('uid')).
+          select { |res| !res[:mail] || res[:mail].empty? }.should == []
+      end
+
+      it "can be searched by value" do
+        ldap_search(Net::LDAP::Filter.eq(:givenname, 'Josephine')).
+          collect { |res| res[:uid].first }.should == %w(jj243)
+      end
+    end
+
+    describe "with a provided set" do
+      before do
+        @server = create_server(
+          :domain => "dc=example,dc=net",
+          :ldif => File.expand_path("../animals.ldif", __FILE__)
+        )
+      end
+
+      it "has the groups provided by the other LDIF" do
+        ldap_search(Net::LDAP::Filter.pres('ou'), 'dc=example,dc=net').
+          collect { |result| result[:ou].first }.should == ["animals"]
+      end
+
+      it "has the individuals provided by the other LDIF" do
+        ldap_search(Net::LDAP::Filter.pres('uid'), 'dc=example,dc=net').
+          collect { |result| result[:givenname].first }.sort.should == %w(Ada Bob)
+      end
+    end
+  end
+end

data/spec/ladle/version_spec.rb

@@ -0,0 +1,11 @@
+require File.expand_path("../../spec_helper.rb", __FILE__)
+
+describe Ladle, "::VERSION" do
+  it "exists" do
+    lambda { Ladle::VERSION }.should_not raise_error
+  end
+
+  it "has 3 or 4 dot separated parts" do
+    Ladle::VERSION.split('.').size.should be_between(3, 4)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+require 'bundler'
+Bundler.setup
+
+require 'rspec'
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+
+require 'ladle'
+
+module Ladle::RSpec
+  module Tmpdir
+    def tmpdir(path=nil)
+      @tmpdir ||= File.expand_path("../../tmp/specs", __FILE__)
+      full = path ? File.join(@tmpdir, path) : @tmpdir
+      FileUtils.mkdir_p full
+      full
+    end
+
+    def rm_tmpdir
+      if @tmpdir
+        FileUtils.rm_rf @tmpdir
+      end
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.include(Ladle::RSpec::Tmpdir)
+  config.after do
+    rm_tmpdir
+  end
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification 
+name: ladle
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Rhett Sutphin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-21 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: open4
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  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: 15
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rdiscount
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: ruby-net-ldap
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 0
+        - 4
+        version: 0.0.4
+  type: :development
+  version_requirements: *id005
+description: Provides an embedded LDAP server for BDD.  The embedded server is built with ApacheDS.
+email: 
+- rhett@detailedbalance.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/ladle/apacheds/antlr-2.7.6.jar
+- lib/ladle/apacheds/apacheds-core-1.0.2.jar
+- lib/ladle/apacheds/apacheds-core-shared-1.0.2.jar
+- lib/ladle/apacheds/apacheds-kerberos-shared-1.0.2.jar
+- lib/ladle/apacheds/apacheds-protocol-changepw-1.0.2.jar
+- lib/ladle/apacheds/apacheds-protocol-kerberos-1.0.2.jar
+- lib/ladle/apacheds/apacheds-protocol-ldap-1.0.2.jar
+- lib/ladle/apacheds/apacheds-protocol-ntp-1.0.2.jar
+- lib/ladle/apacheds/apacheds-protocol-shared-1.0.2.jar
+- lib/ladle/apacheds/apacheds-server-jndi-1.0.2.jar
+- lib/ladle/apacheds/apacheds-server-main-1.0.2.jar
+- lib/ladle/apacheds/apacheds-server-ssl-1.0.2.jar
+- lib/ladle/apacheds/backport-util-concurrent-2.2.jar
+- lib/ladle/apacheds/commons-cli-1.0.jar
+- lib/ladle/apacheds/commons-collections-3.2.jar
+- lib/ladle/apacheds/commons-io-1.4.jar
+- lib/ladle/apacheds/commons-lang-2.1.jar
+- lib/ladle/apacheds/jcl-over-slf4j-1.5.6.jar
+- lib/ladle/apacheds/jdbm-1.0.jar
+- lib/ladle/apacheds/log4j-1.2.14.jar
+- lib/ladle/apacheds/mina-core-1.0.2.jar
+- lib/ladle/apacheds/mina-filter-ssl-1.0.2.jar
+- lib/ladle/apacheds/shared-asn1-0.9.5.5.jar
+- lib/ladle/apacheds/shared-asn1-codec-0.9.5.5.jar
+- lib/ladle/apacheds/shared-ldap-0.9.5.5.jar
+- lib/ladle/apacheds/slf4j-api-1.5.6.jar
+- lib/ladle/apacheds/slf4j-log4j12-1.5.6.jar
+- lib/ladle/apacheds/spring-beans-1.2.8.jar
+- lib/ladle/apacheds/spring-context-1.2.8.jar
+- lib/ladle/apacheds/spring-core-1.2.8.jar
+- lib/ladle/apacheds/xercesImpl-2.0.2.jar
+- lib/ladle/default.ldif
+- lib/ladle/java/net/detailedbalance/ladle/LadleFatalException.class
+- lib/ladle/java/net/detailedbalance/ladle/LadleFatalException.java
+- lib/ladle/java/net/detailedbalance/ladle/Main$1.class
+- lib/ladle/java/net/detailedbalance/ladle/Main.class
+- lib/ladle/java/net/detailedbalance/ladle/Main.java
+- lib/ladle/java/net/detailedbalance/ladle/Server.class
+- lib/ladle/java/net/detailedbalance/ladle/Server.java
+- lib/ladle/jruby_process.rb
+- lib/ladle/Ladle.iml
+- lib/ladle/ruby_process.rb
+- lib/ladle/server.rb
+- lib/ladle/version.rb
+- lib/ladle.rb
+- spec/ladle/animals.ldif
+- spec/ladle/server_spec.rb
+- spec/ladle/version_spec.rb
+- spec/spec_helper.rb
+- CHANGELOG.md
+- README.md
+- ASL20-LICENSE
+- LICENSE
+- NOTICE
+has_rdoc: true
+homepage: http://github.com/rsutphin/ladle
+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: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Dishes out steaming helpings of LDAP for fluid testing
+test_files: 
+- spec/ladle/animals.ldif
+- spec/ladle/server_spec.rb
+- spec/ladle/version_spec.rb
+- spec/spec_helper.rb