prathe-net-ldap 0.2.20110317223538

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.rdoc

@@ -0,0 +1,172 @@
+=== Net::LDAP 0.2.2 / 2011-03-26
+* Bug Fixes:
+  * Fixed the call to Net::LDAP.modify_ops from Net::LDAP#modify.
+
+=== Net::LDAP 0.2.1 / 2011-03-23
+* Bug Fixes:
+  * Net::LDAP.modify_ops was broken and is now fixed.
+
+=== Net::LDAP 0.2 / 2011-03-22
+* 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 / 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
+  to reintroduce this, we will.
+* New maintainers, new project repository location. Please see the README.txt.
+
+=== Net::LDAP 0.0.5 / 2009-03-xx
+* 13 minor enhancements:
+  * Added Net::LDAP::Entry#to_ldif
+  * Supported rootDSE searches with a new API.
+  * 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
+  * Added Net::LDAP::Filter#parse_ber, which constructs Net::LDAP::Filter
+    objects directly from BER objects that represent search filters in
+    LDAP SearchRequest packets.
+  * Added Net::LDAP::Filter#execute, which allows arbitrary processing
+    based on LDAP filters.
+  * Changed Net::LDAP::Entry so it can be marshalled and unmarshalled.
+    Thanks to an anonymous feature requester who only left the name
+    "Jammy."
+  * Added support for binary values in Net::LDAP::Entry LDIF conversions
+    and marshalling.
+  * Migrated to 'hoe' as the new project droid.
+* 14 bugs fixed:
+  * Silenced some annoying warnings in filter.rb. Thanks to "barjunk"
+    for pointing this out.
+  * Some fairly extensive performance optimizations in the BER parser.
+  * Fixed a bug in Net::LDAP::Entry::from_single_ldif_string noticed by
+    Matthias Tarasiewicz.
+  * Removed an erroneous LdapError value, noticed by Kouhei Sutou.
+  * Supported attributes containing blanks (cn=Babs Jensen) to
+    Filter#construct. Suggested by an anonymous Rubyforge user.
+  * Added missing syntactic support for Filter ANDs, NOTs and a few other
+    things.
+  * Extended support for server-reported error messages. This was provisionally
+    added to Net::LDAP#add, and eventually will be added to other methods.
+  * Fixed bug in Net::LDAP#bind. We were ignoring the passed-in auth parm.
+    Thanks to Kouhei Sutou for spotting it.
+  * Patched filter syntax to support octal \XX codes. Thanks to Kouhei Sutou
+    for the patch.
+  * Applied an additional patch from Kouhei.
+  * Allowed comma in filter strings, suggested by Kouhei.
+  * 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.
+  * Minor bug fixes here and there.
+
+=== Net::LDAP 0.0.4 / 2006-08-15
+* Undeprecated Net::LDAP#modify. Thanks to Justin Forder for
+  providing the rationale for this.
+* Added a much-expanded set of special characters to the parser
+  for RFC-2254 filters. Thanks to Andre Nathan.
+* Changed Net::LDAP#search so you can pass it a filter in string form.
+  The conversion to a Net::LDAP::Filter now happens automatically.
+* Implemented Net::LDAP#bind_as (preliminary and subject to change).
+  Thanks for Simon Claret for valuable suggestions and for helping test.
+* Fixed bug in Net::LDAP#open that was preventing #open from being
+  called more than one on a given Net::LDAP object.
+
+=== Net::LDAP 0.0.3 / 2006-07-26
+* Added simple TLS encryption.
+  Thanks to Garett Shulman for suggestions and for helping test.
+
+=== Net::LDAP 0.0.2 / 2006-07-12
+* Fixed malformation in distro tarball and gem.
+* Improved documentation.
+* Supported "paged search control."
+* Added a range of API improvements.
+* Thanks to Andre Nathan, andre@digirati.com.br, for valuable
+  suggestions.
+* Added support for LE and GE search filters.
+* Added support for Search referrals.
+* Fixed a regression with openldap 2.2.x and higher caused
+  by the introduction of RFC-2696 controls. Thanks to Andre
+  Nathan for reporting the problem.
+* Added support for RFC-2254 filter syntax.
+
+=== Net::LDAP 0.0.1 / 2006-05-01
+* Initial release.
+* Client functionality is near-complete, although the APIs
+  are not guaranteed and may change depending on feedback
+  from the community.
+* We're internally working on a Ruby-based implementation
+  of a full-featured, production-quality LDAP server,
+  which will leverage the underlying LDAP and BER functionality
+  in Net::LDAP.
+* Please tell us if you would be interested in seeing a public
+  release of the LDAP server.
+* Grateful acknowledgement to Austin Ziegler, who reviewed
+  this code and provided the release framework, including
+  minitar.

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

@@ -0,0 +1,49 @@
+.autotest
+.rspec
+Contributors.rdoc
+Hacking.rdoc
+History.rdoc
+License.rdoc
+Manifest.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/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/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_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
+testserver/testdata.ldif

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

@@ -0,0 +1,75 @@
+# -*- ruby encoding: utf-8 -*-
+
+require "rubygems"
+require 'hoe'
+
+Hoe.plugin :doofus
+Hoe.plugin :git
+Hoe.plugin :gemspec
+Hoe.plugin :rubyforge
+
+Hoe.spec 'net-ldap' do |spec|
+  spec.rubyforge_name = spec.name
+
+  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")
+
+  spec.remote_rdoc_dir = ''
+  spec.rsync_args << ' --exclude=statsvn/'
+
+  spec.url = %W(http://net-ldap.rubyforge.org/ https://github.com/ruby-ldap/ruby-net-ldap)
+
+  spec.history_file = 'History.rdoc'
+  spec.readme_file = 'README.rdoc'
+
+  spec.extra_rdoc_files = FileList["*.rdoc"].to_a
+
+  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" ]
+
+  spec.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.need_tar = true
+end
+
+# 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
+
+    File.open("Manifest.txt", "w") do |f|
+      f.puts paths.sort.join("\n")
+    end
+
+    puts paths.sort.join("\n")
+  end
+end
+
+desc "Run a full set of integration and unit tests" 
+task :cruise => [:test, :spec]
+
+# vim: syntax=ruby