net-ldap 0.1.1 → 0.2

data/.autotest

@@ -0,0 +1,11 @@
+require 'rubygems'
+#require 'redgreen/autotest'
+require 'autotest/timestamp'
+
+Autotest.add_hook :initialize do |autotest|
+  %w{.git .hg .DS_Store ._* tmp log doc}.each do |exception|
+    autotest.add_exception(exception)
+  end
+end
+
+# vim: syntax=ruby

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format documentation

data/Contributors.rdoc

@@ -0,0 +1,21 @@
+== Contributors
+
+Net::LDAP was originally developed by:
+
+* Francis Cianfrocca (garbagecat)
+
+Contributions since:
+
+* Emiel van de Laar (emiel)
+* Rory O'Connell (roryo)
+* Kaspar Schiess (kschiess)
+* Austin Ziegler (halostatue)
+* Dimitrij Denissenko (dim)
+* James Hewitt (jamstah)
+* Kouhei Sutou (kou)
+* Lars Tobias Skjong-Børsting (larstobi)
+* Rory O'Connell (roryo)
+* Tony Headford (tonyheadford)
+* Derek Harmel (derekharmel)
+* Erik Hetzner (egh)
+* nowhereman

data/Hacking.rdoc

@@ -0,0 +1,68 @@
+= Hacking on Net::LDAP
+
+We welcome your contributions to Net::LDAP. We accept most contributions, but
+there are ways to increase the chance of your patch being accepted quickly.
+
+== Licensing
+
+Net::LDAP 0.2 and later are be licensed under an MIT-style license; any
+contributions after 2010-04-20 must be under this license to be accepted.
+
+== Formatting
+
+* Your patches should be formatted like the rest of Net::LDAP.
+* We use a text wrap of 76–78 characters, especially for documentation
+  contents.
+* Operators should have spaces around them.
+* Method definitions should have parentheses around arguments (and no
+  parentheses if there are no arguments).
+* Indentation should be kept as flat as possible; this may mean being more
+  explicit with constants.
+
+
+We welcome your contributions to Net::LDAP. To increase the chances of your
+patches being accepted, we recommend that you follow the guidelines below:
+
+== Documentation
+
+* Documentation: {net-ldap}[http://net-ldap.rubyforge.org/]
+
+It is very important that, if you add new methods or objects, your code is
+well-documented. The purpose of the changes should be clearly described so that
+even if this is a feature we do not use, we can understand its purpose.
+
+We also encourage documentation-only contributions that improve the
+documentation of Net::LDAP.
+
+We encourage you to provide a good summary of your as a modification to
++History.rdoc+, and if you're not yet named as a contributor, include a
+modification to +Contributors.rdoc+ to add yourself.
+
+== Tests
+
+The Net::LDAP team uses RSpec for unit testing; all changes must have rspec
+tests for any new or changed features.
+
+Your changes should have been tested against at least one real LDAP server; the
+current tests are not sufficient to find all possible bugs. It's unlikely that
+they will ever be sufficient given the variations in LDAP server behaviour.
+
+If you're introducing a new feature, it would be preferred for you to provide
+us with a sample LDIF data file for importing into LDAP servers for testing.
+
+== Development Dependencies
+
+Net::LDAP uses several libraries during development, all of which can be
+installed using RubyGems.
+
+* *hoe*
+* *hoe-git*
+* *metaid*
+* *rspec*
+* *flexmock*
+
+== Participation
+
+* RubyForge: {net-ldap}[http://rubyforge.org/projects/net-ldap]
+* GitHub: {ruby-ldap/ruby-net-ldap}[https://github.com/ruby-ldap/ruby-net-ldap/]
+* Group: {ruby-ldap}[http://groups.google.com/group/ruby-ldap]

data/{History.txt → History.rdoc}

@@ -1,7 +1,71 @@
+=== Net::LDAP 0.2 / 2011-03-__
+* Major Enhancements:
+  * Net::LDAP::Filter changes:
+    * Filters can only be constructed using our custom constructors (eq, ge,
+      etc.). Cleaned up the code to reflect the private new.
+    * Fixed #to_ber to output a BER representation for :ne filters. Simplified
+      the BER construction for substring matching.
+    * Added Filter.join(left, right), Filter.intersect(left, right), and
+      Filter.negate(filter) to match Filter#&, Filter#|, and Filter#~@ to
+      prevent those operators from having problems with the private new.
+    * Added Filter.present and Filter.present? aliases for the method
+      previously only known as Filter.pres.
+    * Added Filter.escape to escape strings for use in filters, based on
+      rfc4515.
+    * Added Filter.equals, Filter.begins, Filter.ends and Filter.contains,
+      which automatically escape input for use in a filter string.
+    * Cleaned up Net::LDAP::Filter::FilterParser to handle branches better.
+      Fixed some of the regular expressions to be more canonically defined.
+    * Correctly handles single-branch branches.
+    * Cleaned up the string representation of Filter objects.
+    * Added experimental support for RFC4515 extensible matching (e.g.,
+      "(cn:caseExactMatch:=Fred Flintstone)"); provided by "nowhereman".
+  * Net::LDAP::DN class representing an automatically escaping/unescaping
+    distinguished name for LDAP queries.
+* Minor Enhancements:
+  * SSL capabilities will be enabled or disabled based on whether we can load
+    OpenSSL successfully or not.
+  * Moved the core class extensions extensions from being in the Net::LDAP
+    hierarchy to the Net::BER hierarchy as most of the methods therein are
+    related to BER-encoding values. This will make extracting Net::BER from
+    Net::LDAP easier in the future.
+  * Added some unit tests for the BER core extensions.
+  * Paging controls are only sent where they are supported.
+* Documentation Changes:
+  * Core class extension methods under Net::BER.
+  * Extensive changes to Net::BER documentation.
+  * Cleaned up some rdoc oddities, suppressed empty documentation sections
+    where possible.
+  * Added a document describing how to contribute to Net::LDAP most
+    effectively.
+  * Added a document recognizing contributors to Net::LDAP.
+* Extended unit testing:
+  * Added some unit tests for the BER core extensions.
+  * The LDIF test data file was split for Ruby 1.9 regexp support.
+  * Added a cruisecontrol.rb task.
+  * Converted some test/unit tests to specs.
+* Code clean-up:
+  * Made the formatting of code consistent across all files.
+  * Removed Net::BER::BERParser::TagClasses as it does not appear to be used.
+  * Replaced calls to #to_a with calls to Kernel#Array; since Ruby 1.8.3, the
+    default #to_a implementation has been deprecated and should be replaced
+    either with calls to Kernel#Array or [value].flatten(1).
+  * Modified #add and #modify to return a Pdu#result_code instead of a
+    Pdu#result. This may be changed in Net::LDAP 1.0 to return the full
+    Pdu#result, but if we do so, it will be that way for all LDAP calls
+    involving Pdu objects.
+  * Renamed Net::LDAP::Psw to Net::LDAP::Password with a corresponding filename
+    change.
+  * Removed the stub file lib/net/ldif.rb and class Net::LDIF.
+* Project Management:
+  * Changed the license from Ruby + GPL to MIT with the agreement of the
+    original author (Francis Cianfrocca) and the named contributors. Versions
+    prior to 0.2.0 are still available under the Ruby + GPL license.
+
 === Net::LDAP 0.1.1 / 2010-03-18
 * Fixing a critical problem with sockets.
 
-=== Net::LDAP 0.1.0 / 2010-03-17
+=== Net::LDAP 0.1 / 2010-03-17
 * Small fixes throughout, more to come.
 * Ruby 1.9 support added.
 * Ruby 1.8.6 and below support removed. If we can figure out a compatible way

data/License.rdoc

@@ -0,0 +1,29 @@
+== License
+
+This software is available under the terms of the MIT license.
+
+Copyright 2006–2011 by Francis Cianfrocca and other contributors.
+
+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.
+
+=== Notice of License Change
+
+Versions prior to 0.2 were under Ruby's dual license with the GNU GPL. With
+this release (0.2), Net::LDAP is now under the MIT license.

data/Manifest.txt

@@ -1,37 +1,48 @@
-COPYING
-History.txt
-LICENSE
+.autotest
+.rspec
+Contributors.rdoc
+Hacking.rdoc
+History.rdoc
+License.rdoc
 Manifest.txt
-README.txt
+README.rdoc
 Rakefile
+autotest/discover.rb
 lib/net-ldap.rb
 lib/net/ber.rb
 lib/net/ber/ber_parser.rb
+lib/net/ber/core_ext.rb
+lib/net/ber/core_ext/array.rb
+lib/net/ber/core_ext/bignum.rb
+lib/net/ber/core_ext/false_class.rb
+lib/net/ber/core_ext/fixnum.rb
+lib/net/ber/core_ext/string.rb
+lib/net/ber/core_ext/true_class.rb
 lib/net/ldap.rb
-lib/net/ldap/core_ext/all.rb
-lib/net/ldap/core_ext/array.rb
-lib/net/ldap/core_ext/bignum.rb
-lib/net/ldap/core_ext/false_class.rb
-lib/net/ldap/core_ext/fixnum.rb
-lib/net/ldap/core_ext/string.rb
-lib/net/ldap/core_ext/true_class.rb
 lib/net/ldap/dataset.rb
+lib/net/ldap/dn.rb
 lib/net/ldap/entry.rb
 lib/net/ldap/filter.rb
+lib/net/ldap/password.rb
 lib/net/ldap/pdu.rb
-lib/net/ldap/psw.rb
-lib/net/ldif.rb
 lib/net/snmp.rb
+net-ldap.gemspec
 spec/integration/ssl_ber_spec.rb
 spec/spec.opts
 spec/spec_helper.rb
 spec/unit/ber/ber_spec.rb
+spec/unit/ber/core_ext/string_spec.rb
+spec/unit/ldap/dn_spec.rb
+spec/unit/ldap/entry_spec.rb
+spec/unit/ldap/filter_spec.rb
+spec/unit/ldap_spec.rb
 test/common.rb
-test/test_ber.rb
 test/test_entry.rb
 test/test_filter.rb
+test/test_ldap_connection.rb
 test/test_ldif.rb
 test/test_password.rb
+test/test_rename.rb
 test/test_snmp.rb
 test/testdata.ldif
 testserver/ldapserver.rb

data/README.rdoc

@@ -0,0 +1,52 @@
+= Net::LDAP for Ruby
+
+== Description
+
+Net::LDAP for Ruby (also called net-ldap) implements client access for the
+Lightweight Directory Access Protocol (LDAP), an IETF standard protocol for
+accessing distributed directory services. Net::LDAP is written completely in
+Ruby with no external dependencies. It supports most LDAP client features and a
+subset of server features as well.
+
+Net::LDAP has been tested against modern popular LDAP servers including
+OpenLDAP and Active Directory. The current release is mostly compliant with
+earlier versions of the IETF LDAP RFCs (2251–2256, 2829–2830, 3377, and 3771).
+Our roadmap for Net::LDAP 1.0 is to gain full <em>client</em> compliance with
+the most recent LDAP RFCs (4510–4519, plus portions of 4520–4532).
+
+== Where
+
+* {RubyForge}[http://rubyforge.org/projects/net-ldap]
+* {GitHub}[https://github.com/ruby-ldap/ruby-net-ldap]
+* {ruby-ldap@googlegroups.com}[http://groups.google.com/group/ruby-ldap]
+* {Documentation}[http://net-ldap.rubyforge.org/]
+
+The Net::LDAP for Ruby documentation, project description, and main downloads
+can currently be found on {RubyForge}[http://rubyforge.org/projects/net-ldap].
+
+== Synopsis
+
+See Net::LDAP for documentation and usage samples.
+
+== Requirements
+
+Net::LDAP requires a Ruby 1.8.7 interpreter or better.
+
+== Install
+
+Net::LDAP is a pure Ruby library. It does not require any external libraries.
+You can install the RubyGems version of Net::LDAP available from the usual
+sources.
+
+  gem install net-ldap
+
+Simply require either 'net-ldap' or 'net/ldap'.
+
+For non-RubyGems installations of Net::LDAP, you can use Minero Aoki's
+{setup.rb}[http://i.loveruby.net/en/projects/setup/] as the layout of
+Net::LDAP is compliant. The setup installer is not included in the
+Net::LDAP repository.
+
+:include: Contributors.rdoc
+
+:include: License.rdoc

data/Rakefile

@@ -1,118 +1,74 @@
+# -*- ruby encoding: utf-8 -*-
+
 require "rubygems"
 require 'hoe'
 
-$LOAD_PATH.unshift('lib')
+Hoe.plugin :doofus
+Hoe.plugin :git
+Hoe.plugin :gemspec
 
-require 'net/ldap'
+Hoe.spec 'net-ldap' do |spec|
+  spec.rubyforge_name = spec.name
 
-PKG_NAME    = 'net-ldap'
-PKG_VERSION = Net::LDAP::VERSION
-PKG_DIST    = "#{PKG_NAME}-#{PKG_VERSION}"
-PKG_TAR     = "pkg/#{PKG_DIST}.tar.gz"
-MANIFEST    = File.read("Manifest.txt").split
-MINRUBY     = "1.8.7"
+  spec.developer("Francis Cianfrocca", "blackhedd@rubyforge.org")
+  spec.developer("Emiel van de Laar", "gemiel@gmail.com")
+  spec.developer("Rory O'Connell", "rory.ocon@gmail.com")
+  spec.developer("Kaspar Schiess", "kaspar.schiess@absurd.li")
+  spec.developer("Austin Ziegler", "austin@rubyforge.org")
 
-Hoe.plugin :git
+  spec.remote_rdoc_dir = ''
+  spec.rsync_args << ' --exclude=statsvn/'
 
-Hoe.spec PKG_NAME do
-  self.version = PKG_VERSION
-  self.rubyforge_name = PKG_NAME
+  spec.url = %W(http://net-ldap.rubyforge.org/ https://github.com/ruby-ldap/ruby-net-ldap)
 
-  developer "Francis Cianfrocca", "blackhedd@rubyforge.org"
-  developer "Emiel van de Laar", "gemiel@gmail.com"
-  developer "Rory O'Connell", "rory.ocon@gmail.com"
-  developer "Kaspar Schiess", "kaspar.schiess@absurd.li"
-  developer "Austin Ziegler", "austin@rubyforge.org" 
+  spec.history_file = 'History.rdoc'
+  spec.readme_file = 'README.rdoc'
 
-  self.remote_rdoc_dir = ''
-  rsync_args << ' --exclude=statsvn/'
+  spec.extra_rdoc_files = FileList["*.rdoc"].to_a
 
-  self.url = %W(http://net-ldap.rubyforge.org/ http://github.com/RoryO/ruby-net-ldap)
+  spec.extra_dev_deps << [ "hoe-git", "~> 1" ]
+  spec.extra_dev_deps << [ "hoe-gemspec", "~> 1" ]
+  spec.extra_dev_deps << [ "metaid", "~> 1" ]
+  spec.extra_dev_deps << [ "flexmock", "~> 0.9.0" ]
+  spec.extra_dev_deps << [ "rspec", "~> 2.0" ]
 
-  self.summary = "Pure Ruby LDAP support library with most client features and some server features."
-  self.changes = paragraphs_of(self.history_file, 0..1).join("\n\n")
-  self.description = paragraphs_of(self.readme_file, 2..2).join("\n\n")
+  spec.clean_globs << "coverage"
 
-  extra_dev_deps << [ "archive-tar-minitar", "~>0.5.1" ]
-  extra_dev_deps << [ "hanna", "~>0.1.2" ]
-  extra_dev_deps << [ "hoe-git", "~>1" ]
-  clean_globs << "coverage"
+  spec.spec_extras[:required_ruby_version] = ">= 1.8.7"
+  spec.multiruby_skip << "1.8.6"
+  spec.multiruby_skip << "1_8_6"
 
-  spec_extras[:required_ruby_version] = ">= #{MINRUBY}"
-  multiruby_skip << "1.8.6"
-  multiruby_skip << "1_8_6"
-
-  # This is a lie because I will continue to use Archive::Tar::Minitar.
-  self.need_tar        = false
+  spec.need_tar = true
 end
 
-desc "Build a Net-LDAP .tar.gz distribution."
-task :tar => [ PKG_TAR ]
-file PKG_TAR => [ :test ] do |t|
-  require 'archive/tar/minitar'
-  require 'zlib'
-  files = MANIFEST.map { |f|
-    fn = File.join(PKG_DIST, f)
-    tm = File.stat(f).mtime
-
-    if File.directory?(f)
-      { :name => fn, :mode => 0755, :dir => true, :mtime => tm }
-    else
-      mode = if f =~ %r{^bin}
-               0755
-             else
-               0644
-             end
-      data = File.read(f)
-      { :name => fn, :mode => mode, :data => data, :size => data.size,
-        :mtime => tm }
+# I'm not quite ready to get rid of this, but I think "rake git:manifest" is
+# sufficient.
+namespace :old do
+  desc "Build the manifest file from the current set of files."
+  task :build_manifest do |t|
+    require 'find'
+
+    paths = []
+    Find.find(".") do |path|
+      next if File.directory?(path)
+      next if path =~ /\.svn/
+        next if path =~ /\.git/
+        next if path =~ /\.hoerc/
+        next if path =~ /\.swp$/
+        next if path =~ %r{coverage/}
+      next if path =~ /~$/
+        paths << path.sub(%r{^\./}, '')
     end
-  }
 
-  begin
-    unless File.directory?(File.dirname(t.name))
-      require 'fileutils'
-      File.mkdir_p File.dirname(t.name)
-    end
-    tf = File.open(t.name, 'wb')
-    gz = Zlib::GzipWriter.new(tf)
-    tw = Archive::Tar::Minitar::Writer.new(gz)
-
-    files.each do |entry|
-      if entry[:dir]
-        tw.mkdir(entry[:name], entry)
-      else
-        tw.add_file_simple(entry[:name], entry) { |os|
-          os.write(entry[:data])
-        }
-      end
+    File.open("Manifest.txt", "w") do |f|
+      f.puts paths.sort.join("\n")
     end
-  ensure
-    tw.close if tw
-    gz.close if gz
+
+    puts paths.sort.join("\n")
   end
 end
-task :package => [ PKG_TAR ]
-
-desc "Build the manifest file from the current set of files."
-task :build_manifest do |t|
-  require 'find'
-
-  paths = []
-  Find.find(".") do |path|
-    next if File.directory?(path)
-    next if path =~ /\.svn/
-    next if path =~ /\.git/
-    next if path =~ /\.hoerc/
-    next if path =~ /\.swp$/
-    next if path =~ %r{coverage/}
-    next if path =~ /~$/
-    paths << path.sub(%r{^\./}, '')
-  end
 
-  File.open("Manifest.txt", "w") do |f|
-    f.puts paths.sort.join("\n")
-  end
+desc "Run a full set of integration and unit tests" 
+task :cruise => [:test, :spec]
 
-  puts paths.sort.join("\n")
-end
+# vim: syntax=ruby