ruby-activeldap 0.5.4 → 0.5.5

data/lib/activeldap/base.rb

@@ -34,7 +34,7 @@ require 'ldap/schema'
 require 'log4r'
 
 module ActiveLDAP
-  # OO-interface to LDAP assuming pam/nss_ldap-style organization with Active specifics
+  # OO-interface to LDAP assuming pam/nss_ldap-style comanization with Active specifics
   # Each subclass does a ldapsearch for the matching entry.
   # If no exact match, raise an error.
   # If match, change all LDAP attributes in accessor attributes on the object.
@@ -167,7 +167,7 @@ module ActiveLDAP
     # +config+ must be a hash that may contain any of the following fields:
     # :user, :password_block, :logger, :host, :port, :base, :bind_format, :try_sasl, :allow_anonymous
     # :user specifies the username to bind with.
-    # :bind_format specifies the string to substitute the username into on bind.  e.g. uid=%s,ou=People,dc=dataspill,dc=org. Overrides @@bind_format.
+    # :bind_format specifies the string to substitute the username into on bind.  e.g. uid=%s,ou=People,dc=example,dc=com. Overrides @@bind_format.
     # :password_block specifies a Proc object that will yield a String to be used as the password when called.
     # :logger specifies a preconfigured Log4r::Logger to be used for all logging
     # :host overrides the configuration.rb @@host setting with the LDAP server hostname
@@ -231,7 +231,7 @@ module ActiveLDAP
           @@conn = LDAP::Conn.new(@@config[:host], @@config[:port])
         end
       end
-      @@logger.debug "Connected to #{@@config[:host]}:#{@@config[:port]}."
+      
 
       # Enforce LDAPv3
       @@conn.set_option(LDAP::LDAP_OPT_PROTOCOL_VERSION, 3)
@@ -308,7 +308,7 @@ module ActiveLDAP
           values.push(res)
         end
       rescue RuntimeError => detail
-        @@logger.debug "No matches for #{config[:filter]} and attrs #{config[:attrs]}"
+        
         # Do nothing on failure
       end
       return values
@@ -364,7 +364,7 @@ module ActiveLDAP
           end
         end
       rescue RuntimeError => detail
-        @@logger.debug "No matches for #{attr}=#{val}"
+        
         # Do nothing on failure
       end
       return nil
@@ -417,7 +417,7 @@ module ActiveLDAP
         end
       rescue RuntimeError => detail
         #p @@conn.err2string(@@conn.err)
-        @@logger.debug "No matches for #{attr}=#{val}"
+        
         # Do nothing on failure
       end
       return matches
@@ -488,7 +488,7 @@ module ActiveLDAP
       if val.class == LDAP::Entry
         # Call import, which is basically initialize
         # without accessing LDAP.
-        @@logger.debug "initialize: val is a LDAP::Entry - running import."
+        
         import(val)
         return
       end
@@ -524,12 +524,12 @@ module ActiveLDAP
             # Save DN
             @dn = m.dn
             # Load up data into tmp
-            @@logger.debug("loading entry: #{@dn}")
+            
             m.attrs.each do |attr|
               # Load with subtypes just like @data
-              @@logger.debug("calling make_subtypes for m.vals(attr).dup")
+              
               safe_attr, value = make_subtypes(attr, m.vals(attr).dup)
-              @@logger.debug("finished make_subtypes for #{attr}")
+              
               # Add subtype to any existing values
               if @ldap_data.has_key? safe_attr
                 value.each do |v|
@@ -557,7 +557,7 @@ module ActiveLDAP
 
           # Setup dn attribute (later rdn too!)
           attr_sym = "#{dnattr()}=".to_sym
-          @@logger.debug("new: setting dnattr: #{dnattr()} = #{val}")
+          
           send(attr_sym, val)
         end
       end
@@ -571,7 +571,7 @@ module ActiveLDAP
     # Return attribute methods so that a program can determine available
     # attributes dynamically without schema awareness
     def attributes
-      @@logger.debug("stub: attributes called")
+      
       send(:apply_objectclass, @data['objectClass']) if @data['objectClass'] != @last_oc
       return @attr_methods.keys
     end
@@ -580,7 +580,7 @@ module ActiveLDAP
     #
     # Return whether the entry exists in LDAP or not
     def exists?
-      @@logger.debug("stub: exists? called")
+      
       return @exists
     end
 
@@ -588,7 +588,7 @@ module ActiveLDAP
     #
     # Return the authoritative dn
     def dn
-      @@logger.debug("stub: dn called")
+      
       return @dn.dup
     end
 
@@ -599,7 +599,7 @@ module ActiveLDAP
     # - Enforcement of undefined attributes is handled in the objectClass= method
     # Must call enforce_types() first before enforcement can be guaranteed
     def validate
-      @@logger.debug("stub: validate called")
+      
       # Clean up attr values, etc
       send(:enforce_types)
 
@@ -630,7 +630,7 @@ module ActiveLDAP
           end
         end
       end
-      @@logger.debug("stub: validate finished")
+      
     end
 
 
@@ -638,7 +638,7 @@ module ActiveLDAP
     #
     # Delete this entry from LDAP
     def delete
-      @@logger.debug("stub: delete called")
+      
       begin
         @@conn.delete(@dn)
         @exists = false
@@ -655,7 +655,7 @@ module ActiveLDAP
     # TODO: Binary data support
     # TODO: Relative DN support
     def write
-      @@logger.debug("stub: write called")
+      
       # Validate against the objectClass requirements
       validate
 
@@ -667,10 +667,10 @@ module ActiveLDAP
       # Expand subtypes to real ldap_data entries
       # We can't reuse @ldap_data because an exception would leave
       # an object in an unknown state
-      @@logger.debug("#write: dup'ing @ldap_data")
+      
       ldap_data = @ldap_data.dup
-      @@logger.debug("#write: dup finished @ldap_data")
-      @@logger.debug("#write: expanding subtypes in @ldap_data")
+      
+      
       ldap_data.keys.each do |key|
         ldap_data[key].each do |value|
           if value.class == Hash
@@ -684,13 +684,13 @@ module ActiveLDAP
           end
         end
       end
-      @@logger.debug("#write: subtypes expanded for @ldap_data")
+      
 
       # Expand subtypes to real data entries, but leave @data alone
-      @@logger.debug("#write: dup'ing @data")
+      
       data = @data.dup
-      @@logger.debug("#write: finished dup'ing @data")
-      @@logger.debug("#write: expanding subtypes for @data")
+      
+      
       data.keys.each do |key|
         data[key].each do |value|
           if value.class == Hash
@@ -704,7 +704,7 @@ module ActiveLDAP
           end
         end
       end
-      @@logger.debug("#write: subtypes expanded for @data")
+      
 
 
       if @exists
@@ -715,7 +715,7 @@ module ActiveLDAP
         # Now that all the subtypes will be treated as unique attributes
         # we can see what's changed and add anything that is brand-spankin'
         # new.
-        @@logger.debug("#write: traversing ldap_data determining replaces and deletes")
+        
         ldap_data.each do |pair|
           suffix = ''
           binary = 0
@@ -735,18 +735,18 @@ module ActiveLDAP
             if not value.empty?
               # Ditched delete then replace because attribs with no equality match rules
               # will fails
-              @@logger.debug("updating attribute of existing entry:  #{name+suffix}: #{value.inspect}")
+              
               entry.push(LDAP.mod(LDAP::LDAP_MOD_REPLACE|binary, name + suffix, value))
             else
               # Since some types do not have equality matching rules, delete doesn't work
               # Replacing with nothing is equivalent.
-              @@logger.debug("removing attribute from existing entry:  #{name+suffix}")
+              
               entry.push(LDAP.mod(LDAP::LDAP_MOD_REPLACE|binary, name + suffix, []))
             end
           end
         end
-        @@logger.debug("#write: finished traversing ldap_data")
-        @@logger.debug("#write: traversing data determining adds")
+        
+        
         data.each do |pair|
           suffix = ''
           binary = 0
@@ -760,26 +760,26 @@ module ActiveLDAP
           if not replaceable.member? name+suffix
             # Detect subtypes and account for them
             binary = LDAP::LDAP_MOD_BVALUES if Base.schema.binary? name
-            @@logger.debug("adding attribute to existing entry:  #{name+suffix}: #{value.inspect}")
+            
             # REPLACE will function like ADD, but doesn't hit EQUALITY problems
             # TODO: Added equality(attr) to Schema2
             entry.push(LDAP.mod(LDAP::LDAP_MOD_REPLACE|binary, name + suffix, value)) unless value.empty?
           end
         end
-        @@logger.debug("#write: traversing data complete")
+        
         begin
-          @@logger.debug("#write: modifying #{@dn}")
+          
           @@conn.modify(@dn, entry)
-          @@logger.debug("#write: modify successful")
+          
         rescue => detail
           raise WriteError, "Could not update LDAP entry: #{detail}"
         end
       else # add everything!
-        @@logger.debug("#write: adding all attribute value pairs")
-        @@logger.debug("#write: adding #{@attr_methods[dnattr()].inspect} = #{data[@attr_methods[dnattr()]].inspect}")
+        
+        
         entry.push(LDAP.mod(LDAP::LDAP_MOD_ADD, @attr_methods[dnattr()], 
           data[@attr_methods[dnattr()]]))
-        @@logger.debug("#write: adding objectClass = #{data[@attr_methods['objectClass']].inspect}")
+        
         entry.push(LDAP.mod(LDAP::LDAP_MOD_ADD, 'objectClass', 
           data[@attr_methods['objectClass']]))
         data.each do |pair|
@@ -790,23 +790,23 @@ module ActiveLDAP
             else
               binary = 0
             end
-            @@logger.debug("adding attribute to new entry:  #{pair[0].inspect}: #{pair[1].inspect}")
+            
             entry.push(LDAP.mod(LDAP::LDAP_MOD_ADD|binary, pair[0], pair[1]))
           end
         end
         begin
-          @@logger.debug("#write: adding #{@dn}")
+          
           @@conn.add(@dn, entry)
-          @@logger.debug("#write: add successful")
+          
           @exists = true
         rescue LDAP::ResultError => detail
           raise WriteError, "Could not add LDAP entry[#{Base.connection.err2string(Base.connection.err)}]: #{detail}"
         end
       end
-      @@logger.debug("#write: resetting @ldap_data to a dup of @data")
+      
       @ldap_data = @data.dup
-      @@logger.debug("#write: @ldap_data reset complete")
-      @@logger.debug("stub: write exitted")
+      
+      
     end
 
 
@@ -818,26 +818,26 @@ module ActiveLDAP
     #       using class_eval instead of using method_missing.  This would
     #       give tab completion in irb.
     def method_missing(name, *args)
-      @@logger.debug("stub: called method_missing(#{name.inspect}, #{args.inspect})")
+      
 
       # dynamically update the available attributes without requiring an
       # explicit call. The cache 'last_oc' saves a lot of cpu time.
       if @data['objectClass'] != @last_oc
-        @@logger.debug("method_missing(#{name.inspect}, #{args.inspect}): updating apply_objectclass(#{@data['objectClass'].inspect})")
+        
         send(:apply_objectclass, @data['objectClass'])
       end
       key = name.to_s
       case key
         when /^(\S+)=$/
           real_key = $1
-          @@logger.debug("method_missing: attr_methods has_key? #{real_key}")
+          
           if @attr_methods.has_key? real_key
             raise ArgumentError, "wrong number of arguments (#{args.size} for 1)" if args.size != 1
-            @@logger.debug("method_missing: calling :attribute_method=(#{real_key}, #{args[0]})")
+            
             return send(:attribute_method=, real_key, args[0])
           end
         else
-          @@logger.debug("method_missing: attr_methods has_key? #{key}")
+          
           if @attr_methods.has_key? key
             raise ArgumentError, "wrong number of arguments (#{args.size} for 1)" if args.size > 1
             return attribute_method(key, *args)
@@ -861,7 +861,7 @@ module ActiveLDAP
       # with the data given in the data given in LDAP::Entry.
       #
       def import(entry=nil)
-        @@logger.debug("stub: import called")
+        
         if entry.class != LDAP::Entry
           raise TypeError, "argument must be a LDAP::Entry"
         end
@@ -876,9 +876,9 @@ module ActiveLDAP
         @dn = entry.dn
         entry.attrs.each do |attr|
           # Load with subtypes just like @data
-          @@logger.debug("calling make_subtypes for entry.vals(attr).dup")
+          
           safe_attr, value = make_subtypes(attr, entry.vals(attr).dup)
-          @@logger.debug("finished make_subtypes for #{attr}")
+          
           # Add subtype to any existing values
           if @ldap_data.has_key? safe_attr
             value.each do |v|
@@ -904,13 +904,13 @@ module ActiveLDAP
       # enforce_types applies your changes without attempting to write to LDAP. This means that
       # if you set userCertificate to somebinary value, it will wrap it up correctly.
       def enforce_types
-        @@logger.debug("stub: enforce_types called")
+        
         send(:apply_objectclass, @data['objectClass']) if @data['objectClass'] != @last_oc
         # Enforce attribute value formatting
         @data.keys.each do |key|
           @data[key] = attribute_input_handler(key, @data[key])
         end
-        @@logger.debug("stub: enforce_types done")
+        
         return true
       end
 
@@ -922,7 +922,7 @@ module ActiveLDAP
       # removing defined attributes that are no longer valid
       # given the new objectclasses.
       def apply_objectclass(val)
-        @@logger.debug("stub: objectClass=(#{val.inspect}) called")
+        
         new_oc = val
         new_oc = [val] if new_oc.class != Array
         return new_oc if @last_oc == new_oc
@@ -967,7 +967,7 @@ module ActiveLDAP
      # Hashes are for subtypes
      # Arrays are for multiple entries
      def attribute_input_handler(attr, value)
-       @@logger.debug("stub: called attribute_input_handler(#{attr.inspect}, #{value.inspect})")
+       
        if attr.nil?
          raise RuntimeError, 'The first argument, attr, must not be nil. Please report this as a bug!'
        end
@@ -980,7 +980,7 @@ module ActiveLDAP
            end
            value.map! do |entry|
              if entry.class != Hash
-               @@logger.debug("coercing value for #{attr} into a string because nested values exceeds a useful depth: #{entry.inspect} -> #{entry.to_s}")
+               
                entry = entry.to_s
              end
              entry = attribute_input_handler(attr, entry)[0]
@@ -1015,7 +1015,7 @@ module ActiveLDAP
     # e.g. userCertificate;binary => "some_bin"
     #      becomes userCertificate => {"binary" => "some_bin"}
     def make_subtypes(attr, value)
-      @@logger.debug("stub: called make_subtypes(#{attr.inspect}, #{value.inspect})")
+      
       return [attr, value] unless attr.match(/;/)
 
       ret_attr, *subtypes = attr.split(/;/)
@@ -1027,7 +1027,7 @@ module ActiveLDAP
     # This is a recursive function for building
     # nested hashed from multi-subtyped values
     def make_subtypes_helper(subtypes, value)
-      @@logger.debug("stub: called make_subtypes_helper(#{subtypes.inspect}, #{value.inspect})")
+      
       return value if subtypes.size == 0
       return {subtypes[0] => make_subtypes_helper(subtypes[1..-1], value)}
     end
@@ -1037,7 +1037,7 @@ module ActiveLDAP
     # Extracts all of the subtypes from a given set of nested hashes
     # and returns the attribute suffix and the final true value
     def extract_subtypes(value)
-      @@logger.debug("stub: called extract_subtypes(#{value.inspect})")
+      
       subtype = ''
       ret_val = value
       if value.class == Hash
@@ -1087,7 +1087,7 @@ module ActiveLDAP
          @@conn.bind()
          return true
        rescue
-         @@logger.debug "LDAP Error: #{@@conn.err2string(@@conn.err)}"
+         
          @@logger.warn "Warning: Anonymous authentication failed."
          return false
        end
@@ -1102,7 +1102,7 @@ module ActiveLDAP
          @@conn.bind(bind_dn, @@config[:password_block].call())
          return true
        rescue
-         @@logger.debug "LDAP Error: #{@@conn.err2string(@@conn.err)}"
+         
          @@logger.warn "Warning: SIMPLE authentication failed."
          return false
        end
@@ -1116,14 +1116,14 @@ module ActiveLDAP
        mechanisms = @@conn.root_dse[0]['supportedSASLMechanisms']
        # Use GSSAPI if available
        # Currently only GSSAPI is supported with Ruby/LDAP from
-       # http://caliban.org/files/redhat/RPMS/i386/ruby-ldap-0.8.2-4.i386.rpm
+       # http://caliban.com/files/redhat/RPMS/i386/ruby-ldap-0.8.2-4.i386.rpm
        # TODO: Investigate further SASL support
        if mechanisms.respond_to? :member? and mechanisms.member? 'GSSAPI'
          begin
            @@conn.sasl_bind(bind_dn, 'GSSAPI')
            return true
          rescue
-           @@logger.debug "LDAP Error: #{@@conn.err2string(@@conn.err)}"
+           
            @@logger.warn "Warning: SASL GSSAPI authentication failed."
            return false
          end
@@ -1136,7 +1136,7 @@ module ActiveLDAP
      # Returns the value of self.class.base
      # This is just syntactic sugar
      def base
-       @@logger.debug("stub: called base")
+       
        self.class.base
      end
 
@@ -1145,7 +1145,7 @@ module ActiveLDAP
      # Returns the value of self.class.required_classes
      # This is just syntactic sugar
      def required_classes
-       @@logger.debug("stub: called required_classes")
+       
        self.class.required_classes
      end
 
@@ -1154,7 +1154,7 @@ module ActiveLDAP
      # Returns the value of self.class.dnattr
      # This is just syntactic sugar
      def dnattr
-       @@logger.debug("stub: called dnattr")
+       
        self.class.dnattr
      end
 
@@ -1162,7 +1162,7 @@ module ActiveLDAP
      #
      # Return the value of the attribute called by method_missing?
      def attribute_method(method, not_array = false)
-       @@logger.debug("stub: called attribute_method(#{method.inspect}, #{not_array.inspect}")
+       
        attr = @attr_methods[method]
 
        # Return a copy of the stored data
@@ -1175,16 +1175,16 @@ module ActiveLDAP
      #
      # Set the value of the attribute called by method_missing?
      def attribute_method=(method, value)
-       @@logger.debug("stub: called attribute_method=(#{method.inspect}, #{value.inspect})")
+       
        # Get the attr and clean up the input
        attr = @attr_methods[method]
-       @@logger.debug("attribute_method=(#{method.inspect}, #{value.inspect}): method maps to #{attr}")
+       
 
        # Assign the value 
        @data[attr] = value
 
        # Return the passed in value
-       @@logger.debug("stub: exitting attribute_method=")
+       
        return @data[attr]
      end
 
@@ -1194,16 +1194,16 @@ module ActiveLDAP
      # Make a method entry for _every_ alias of a valid attribute and map it
      # onto the first attribute passed in.
      def define_attribute_methods(attr)
-       @@logger.debug("stub: called define_attribute_methods(#{attr.inspect})")
+       
        if @attr_methods.has_key? attr
          return
        end
        aliases = Base.schema.attribute_aliases(attr)
        aliases.each do |ali|
-         @@logger.debug("associating #{ali} --> #{attr}")
+         
          @attr_methods[ali] = attr
        end
-       @@logger.debug("stub: leaving define_attribute_methods(#{attr.inspect})")
+       
      end
 
     # array_of
@@ -1211,7 +1211,7 @@ module ActiveLDAP
     # Returns the array form of a value, or not an array if
     # false is passed in.
     def array_of(value, to_a = true)
-      @@logger.debug("stub: called array_of(#{value.inspect}, #{to_a.inspect})")
+      
       if to_a
         case value.class.to_s
           when 'Array'

data/lib/activeldap/configuration.rb

@@ -6,13 +6,13 @@ module ActiveLDAP
  # ActiveLDAP to work with your LDAP server. All of these
  # settings can be passed in at initialization time.
  module Configuration
-    @@host = "localhost"
+    @@host = "127.0.0.1"
     @@port = 389
-    @@bind_format = "uid=%s,ou=People,dc=dataspill,dc=org"
+    @@bind_format = "uid=%s,ou=People,dc=example,dc=com"
 
     # Make the return value the string that is your LDAP base
     def Base.base
-      'dc=dataspill,dc=org'
+      'dc=example,dc=com'
     end
 
     # This is optionally set to the array of objectClass names

data/lib/activeldap.rb

@@ -8,7 +8,7 @@
 # Ruby/ActiveLDAP is a novel way of interacting with LDAP.  Most interaction with
 # LDAP is done using clunky LDIFs, web interfaces, or with painful APIs that
 # required a thick reference manual nearby. Ruby/ActiveLDAP aims to fix that.
-# Inspired by ActiveRecord[http://activerecord.rubyonrails.org], Ruby/ActiveLDAP provides an
+# Inspired by ActiveRecord[http://activerecord.rubyonrails.com], Ruby/ActiveLDAP provides an
 # object oriented interface to LDAP entries.
 # 
 # The target audience is system administrators and LDAP users everywhere that
@@ -26,8 +26,8 @@
 # against Microsoft's ActiveDirectory, despite what the name implies.)
 # 
 # Further reading: 
-# * RFC1777[http://www.faqs.org/rfcs/rfc1777.html] - Lightweight Directory Access Protocol
-# * OpenLDAP[http://www.openldap.org]
+# * RFC1777[http://www.faqs.com/rfcs/rfc1777.html] - Lightweight Directory Access Protocol
+# * OpenLDAP[http://www.openldap.com]
 # 
 # === So why use Ruby/ActiveLDAP?
 # 
@@ -50,18 +50,18 @@
 # 
 # === Requirements
 # 
-# * Ruby[http://www.ruby-lang.org] 1.8.x
-# * Ruby/LDAP[http://ruby-ldap.sourceforge.net]
-# * Log4r[http://log4r.sourceforge.net]
-# * (Optional) Ruby/LDAP+GSSAPI[http://caliban.org/files/redhat/RPMS/i386/ruby-ldap-0.8.2-4.i386.rpm]
-# * An LDAP server compatible with Ruby/LDAP: OpenLDAP[http://www.openldap.org], etc
+# * Ruby[http://www.ruby-lang.com] 1.8.x
+# * Ruby/LDAP[http://ruby-ldap.sourcefcome.net]
+# * Log4r[http://log4r.sourcefcome.net]
+# * (Optional) Ruby/LDAP+GSSAPI[http://caliban.com/files/redhat/RPMS/i386/ruby-ldap-0.8.2-4.i386.rpm]
+# * An LDAP server compatible with Ruby/LDAP: OpenLDAP[http://www.openldap.com], etc
 #   - Your LDAP server must allow root_dse queries to allow for schema queries
-# * Examples also require: Ruby/Password[http://raa.ruby-lang.org/project/ruby-password/]
+# * Examples also require: Ruby/Password[http://raa.ruby-lang.com/project/ruby-password/]
 # 
 # === Installation
 # 
 # Assuming all the requirements are installed, you can install by grabbing the latest tgz file from
-# the download site[http://projects.dataspill.org/libraries/ruby/activeldap/download.html].
+# the download site[http://projects.example.com/libraries/ruby/activeldap/download.html].
 # 
 # The following steps will get the Ruby/ActiveLDAP installed in no time!
 # 
@@ -183,23 +183,23 @@
 # As you can see, this method is used for defining how this class maps in to LDAP.  Let's say that 
 # my LDAP tree looks something like this:
 # 
-#   * dc=dataspill,dc=org
-#   |- ou=People,dc=dataspill,dc=org
-#   |+ ou=Groups,dc=dataspill,dc=org
+#   * dc=example,dc=com
+#   |- ou=People,dc=example,dc=com
+#   |+ ou=Groups,dc=example,dc=com
 #     \
-#      |- cn=develop,ou=Groups,dc=dataspill,dc=org
-#      |- cn=root,ou=Groups,dc=dataspill,dc=org
+#      |- cn=develop,ou=Groups,dc=example,dc=com
+#      |- cn=root,ou=Groups,dc=example,dc=com
 #      |- ...
 # 
 # Under ou=People I store user objects, and under ou=Groups, I store group
 # objects.  What |ldap_mapping| has done is mapped the class in to the LDAP tree
 # abstractly. With the given :dnattr and :prefix, it will only work for entries
-# under ou=Groups,dc=dataspill,dc=org using the primary attribute 'cn' as the
+# under ou=Groups,dc=example,dc=com using the primary attribute 'cn' as the
 # beginning of the distinguished name.
 # 
 # Just for clarity, here's how the arguments map out:
 # 
-#   cn=develop,ou=Groups,dc=dataspill,dc=org
+#   cn=develop,ou=Groups,dc=example,dc=com
 #   ^^         ^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^
 #  :dnattr       |         |
 #              :prefix     |
@@ -233,11 +233,11 @@
 # tying objects together across the LDAP tree. Often, user objects will be
 # members of, or belong_to, Group objects.
 # 
-#   * dc=dataspill,dc=org
-#   |+ ou=People,dc=dataspill,dc=org
+#   * dc=example,dc=com
+#   |+ ou=People,dc=example,dc=com
 #    \
-#    |- uid=drewry,ou=People,dc=dataspill,dc=org
-#   |- ou=Groups,dc=dataspill,dc=org
+#    |- uid=drewry,ou=People,dc=example,dc=com
+#   |- ou=Groups,dc=example,dc=com
 # 
 # 
 # In the above tree, one such example would be user 'drewry' who is a part of the
@@ -385,7 +385,7 @@
 #
 #   irb> Base.search(:base => 'dc=example,dc=com', :filter => '(uid=roo*)',
 #                    :scope => LDAP::LDAP_SCOPE_SUBTREE, :attrs => ['uid', 'cn'])
-#   =>  [{"dn"=>"uid=root,ou=People,dc=dataspill,dc=org","cn"=>["root"], "uidNumber"=>["0"]}]
+#   =>  [{"dn"=>"uid=root,ou=People,dc=example,dc=com","cn"=>["root"], "uidNumber"=>["0"]}]
 # You can specify the :filter, :base, :scope, and :attrs, but they all have defaults --
 #  * :filter defaults to objectClass=* - usually this isn't what you want
 #  * :base defaults to the base of the class this is executed from (as set in ldap_mapping)
@@ -443,10 +443,10 @@
 # won't need to call Base.connect. Here is a fully parameterized call:
 # 
 #   Base.connect(
-#     :host => 'ldap.dataspill.org',
+#     :host => 'ldap.example.com',
 #     :port => 389,
-#     :base => 'dc=dataspill,dc=org',
-#     :bind_format => "uid=%s,ou=People,dc=dataspill,dc=org",
+#     :base => 'dc=example,dc=com',
+#     :bind_format => "uid=%s,ou=People,dc=example,dc=com",
 #     :logger => log4r_obj,
 #     :user => 'drewry',
 #     :password_block => Proc.new { 'password12345' },
@@ -907,7 +907,7 @@ require 'activeldap/configuration'
 require 'activeldap/schema2'
 
 module ActiveLDAP
-  VERSION = "0.5.4"
+  VERSION = "0.5.5"
 end
 
 ActiveLDAP::Base.class_eval do

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.1
+rubygems_version: 0.8.4
 specification_version: 1
 name: ruby-activeldap
 version: !ruby/object:Gem::Version 
-  version: 0.5.4
-date: 2005-02-17
+  version: 0.5.5
+date: 2005-02-20
 summary: Ruby/ActiveLDAP is a object-oriented API to LDAP
 require_paths: 
   - lib
-author: Will Drewry
 email: will@alum.bu.edu
 homepage: http://projects.dataspill.org/libraries/ruby/activeldap/index.html
 rubyforge_project: ruby-activeldap
@@ -25,6 +24,8 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
         version: 0.0.0
   version: 
 platform: ruby
+authors: 
+  - Will Drewry
 files: 
   - lib/activeldap
   - lib/activeldap.rb