Committed differences between official repo and the published 0.5 gem.

Author: Phil Toland

History.txt

@@ -6,6 +6,7 @@
   * Added [preliminary (still undocumented) support for SASL authentication.
   * Supported several constructs from the server side of the LDAP protocol.
   * Added a "consuming" String#read_ber! method.
+  * Added some support for SNMP data-handling.
   * Belatedly added a patch contributed by Kouhei Sutou last October.
     The patch adds start_tls support.
   * Added Net::LDAP#search_subschema_entry
@@ -43,8 +44,6 @@
   * 04Sep07, Changed four error classes to inherit from StandardError rather
     Exception, in order to be friendlier to irb. Suggested by Kouhei.
   * Ensure connections are closed. Thanks to Kristian Meier.
-  * An LDAP::Entry should return an empty array when accessing a nonexistent
-    attribute via a method call. Mirrors index lookup behaviour.
   * Minor bug fixes here and there.
 
 === Net::LDAP 0.0.4 / 2006-08-15

Manifest.txt

@@ -4,6 +4,7 @@ LICENSE
 Manifest.txt
 README.txt
 Rakefile
+Release-Announcement
 lib/net/ber.rb
 lib/net/ldap.rb
 lib/net/ldap/dataset.rb
@@ -12,6 +13,7 @@ lib/net/ldap/filter.rb
 lib/net/ldap/pdu.rb
 lib/net/ldap/psw.rb
 lib/net/ldif.rb
+lib/net/snmp.rb
 pre-setup.rb
 setup.rb
 test/common.rb
@@ -20,6 +22,7 @@ test/test_entry.rb
 test/test_filter.rb
 test/test_ldif.rb
 test/test_password.rb
+test/test_snmp.rb
 test/testdata.ldif
 tests/NOTICE.txt
 tests/testldap.rb

README.txt

@@ -6,16 +6,13 @@
 
 Pure Ruby LDAP library.
 
-A LDAP client library written in pure Ruby. 
-
 == FEATURES/PROBLEMS:
 
 The Lightweight Directory Access Protocol (LDAP) is an Internet protocol
 for accessing distributed directory services.
 
-Net::LDAP is a feature-complete LDAP support library written in pure Ruby.
-It supports most LDAP client features and a subset of server features as
-well.
+Net::LDAP is an LDAP support library written in pure Ruby. It supports
+most LDAP client features and a subset of server features as well.
 
 * Standards-based (going for RFC 4511)
 * Portable: 100% Ruby
@@ -26,7 +23,7 @@ See Net::LDAP for documentation and usage samples.
 
 == REQUIREMENTS:
 
-Net::LDAP requires Ruby 1.8.6 or better. Note that 1.9 is not yet supported.
+Net::LDAP requires Ruby 1.8.2 or better.
 
 == INSTALL:
 
@@ -36,7 +33,7 @@ libraries.
 You can install the RubyGems version of Net::LDAP available from the
 usual sources.
 
-* gem install ruby-net-ldap
+* gem install net-ldap
 
 If using the packaged (.tgz) version; it can be installed with:
 

Rakefile

@@ -9,9 +9,10 @@ $LOAD_PATH.unshift( "#{File.dirname(__FILE__)}/lib" )
 # Pull in local 'net/ldap' as opposed to an installed version.
 require 'net/ldap'
 
-Hoe.spec 'ruby-net-ldap' do
-	developer 'Emiel van de Laar', '[email protected]'
-	developer 'Francis Cianfrocca', '[email protected]'
+Hoe.new('net-ldap', Net::LDAP::VERSION) do |p|
+	p.rubyforge_name = 'net-ldap'
+	p.developer('Francis Cianfrocca', '[email protected]')
+	p.developer('Emiel van de Laar', '[email protected]')
 end
 
-# vim: syntax=ruby
+# vim: syntax=Ruby

Release-Announcement

@@ -0,0 +1,95 @@
+We're pleased to announce version 0.0.4 of Net::LDAP, the pure-Ruby LDAP library.
+
+This version adds an implementation of Net::LDAP#bind_as, which allows
+you to authenticate users who log into your applications using simple
+identifiers like email addresses and simple usernames. Thanks to Simon Claret
+for suggesting the original implementation in his page on the Rails-Wiki,
+and for valuable comments and help with testing.
+
+We have un-deprecated Net::LDAP#modify, which can be useful with
+LDAP servers that observe non-standard transactional and concurrency
+semantics in LDAP Modify operations. Note: this is a documentation change,
+not a code change. Thanks to Justin Forder for providing the rationale
+for this change.
+
+We added a larger set of special characters which may appear in RFC-2254
+standard search filters. Thanks to Andre Nathan for this patch.
+
+We fixed a bug that was preventing Net::LDAP#open from being called more
+than once on the same object.
+
+
+Net::LDAP is a feature-complete LDAP client which can access as much as
+possible of the functionality of the most-used LDAP server implementations.
+This library does not wrap any existing native-code LDAP libraries, creates no
+Ruby extensions, and has no dependencies external to Ruby.
+
+If anyone wants to contribute suggestions, insights or (especially)
+code, please email me at garbagecat10 .. .. gmail.com.
+
+= What is Net::LDAP for Ruby?
+This library provides a pure-Ruby implementation of an LDAP client.
+It can be used to access any server which implements the LDAP protocol.
+
+Net::LDAP is intended to provide full LDAP functionality while hiding
+the more arcane aspects of the LDAP protocol itself, so as to make the
+programming interface as Ruby-like as possible.
+
+In particular, this means that there is no direct dependence on the
+structure of the various "traditional" LDAP clients. This is a ground-up
+rethinking of the LDAP API.
+
+Net::LDAP is based on RFC-2251, which specifies the Lightweight Directory
+Access Protocol, as amended and extended by subsequent RFCs and by the more
+widely-used directory implementations.
+
+Homepage::  http://rubyforge.org/projects/net-ldap/
+Download::  http://rubyforge.org/frs/?group_id=143
+Copyright:: 2006 by Francis Cianfrocca
+
+== LICENCE NOTES
+Please read the file LICENCE for licensing restrictions on this library. In
+the simplest terms, this library is available under the same terms as Ruby
+itself.
+
+== Requirements and Installation
+Net::LDAP requires Ruby 1.8.2 or better.
+
+Net::LDAP can be installed with:
+
+ % ruby setup.rb
+
+Alternatively, you can use the RubyGems version of Net::LDAP available
+as ruby-net-ldap-0.0.2.gem from the usual sources.
+
+== Whet your appetite:
+    require 'net/ldap'
+    
+    ldap = Net::LDAP.new :host => server_ip_address,
+         :port => 389,
+         :auth => {
+               :method => :simple,
+               :username => "cn=manager,dc=example,dc=com",
+               :password => "opensesame"
+         }
+  
+    filter = Net::LDAP::Filter.eq( "cn", "George*" )
+    treebase = "dc=example,dc=com"
+    
+    ldap.search( :base => treebase, :filter => filter ) do |entry|
+      puts "DN: #{entry.dn}"
+      entry.each do |attribute, values|
+        puts "   #{attribute}:"
+        values.each do |value|
+          puts "      --->#{value}"
+        end
+      end
+    end
+    
+    p ldap.get_operation_result
+
+== Net::LDAP 0.0.2: May 3, 2006
+* Fixed malformation in distro tarball and gem.
+* Improved documentation.
+* Supported "paged search control."
+

lib/net/ber.rb

@@ -145,35 +145,27 @@ module BERParser
     # of this one.
     #
     def read_ber syntax=nil
-      # don't bother with this line, since IO#getc by definition returns nil on eof.
+      # don't bother with this line, since IO#getbyte by definition returns nil on eof.
       #return nil if eof?
 
-      id = getc or return nil  # don't trash this value, we'll use it later
+      id = getbyte or return nil  # don't trash this value, we'll use it later
       #tag = id & 31
       #tag < 31 or raise BerError.new( "unsupported tag encoding: #{id}" )
       #tagclass = TagClasses[ id >> 6 ]
       #encoding = (id & 0x20 != 0) ? :constructed : :primitive
 
-      n = getc
+      n = getbyte
       lengthlength,contentlength = if n <= 127
         [1,n]
       else
         # Replaced the inject because it profiles hot.
-        #j = (0...(n & 127)).inject(0) {|mem,x| mem = (mem << 8) + getc}
+        #j = (0...(n & 127)).inject(0) {|mem,x| mem = (mem << 8) + getbyte}
         j = 0
         read( n & 127 ).each_byte {|n1| j = (j << 8) + n1}
         [1 + (n & 127), j]
       end
 
-      # Read 'value'... 
-      newobj = "" # Buffer to collect 'value' data. 
-      length = contentlength 
- 
-      while ( length > 0 ) # There is more to read. 
-        data = read( length ) 
-        length -= data.length 
-        newobj << data 
-      end 
+      newobj = read contentlength
 
       # This exceptionally clever and clear bit of code is verrrry slow.
       objtype = (syntax && syntax[id]) || BuiltinSyntax[id]
@@ -554,7 +546,8 @@ def to_ber_oid
 
   private
   def to_ber_seq_internal code
-    s = self.to_s
+    s = ''
+    self.each{|x| s = s + x}
     [code].pack('C') + s.length.to_ber_length_encoding + s
   end