ruby-activeldap 0.8.1 → 0.8.2

data/CHANGES

@@ -1,3 +1,6 @@
+0.8.2:
+  * Added Net::LDAP support!
+  * Loads of bug fixes and enhancements -- see SVN for a complete history!
 0.8.1:
   * used Dependencies.load_paths.
   * check whether attribute name is available or not.
@@ -28,6 +31,8 @@
   * API TRANSITION: Base#write is now deprecated. Please use Base#save
   * API TRANSITION: Added SaveError exception (which is a subclass of WriteError for now)
   * API TRANSITION: Base.connect() is now deprecated. Please use Base.establish_connection()
+  * API TRANSITION: Base.close() is now deprecated. Please use Base.remove_connection()
+  * API TRANSITION: :bind_format and :user of Base.establish_connection() are now deprecated. Please use :bind_dn
   * Added update_attribute(name, value) to update one attribute and save immediately
   * #delete -> #destroy
   * Base.destroy_all

data/Manifest.txt

@@ -1,33 +1,99 @@
-Rakefile
-LICENSE
-TODO
-COPYING
 CHANGES
-README
+COPYING
+LICENSE
 Manifest.txt
-lib/active_ldap/adaptor/ldap.rb
-lib/active_ldap/adaptor/base.rb
-lib/active_ldap/association/has_many_wrap.rb
-lib/active_ldap/association/has_many.rb
-lib/active_ldap/association/proxy.rb
+README
+Rakefile
+TODO
+benchmark/bench-al.rb
+examples/config.yaml.example
+examples/example.der
+examples/example.jpg
+examples/groupadd
+examples/groupdel
+examples/groupls
+examples/groupmod
+examples/lpasswd
+examples/objects/group.rb
+examples/objects/ou.rb
+examples/objects/user.rb
+examples/ouadd
+examples/useradd
+examples/useradd-binary
+examples/userdel
+examples/userls
+examples/usermod
+examples/usermod-binary-add
+examples/usermod-binary-add-time
+examples/usermod-binary-del
+examples/usermod-lang-add
+lib/active_ldap.rb
+lib/active_ldap/adapter/base.rb
+lib/active_ldap/adapter/ldap.rb
+lib/active_ldap/adapter/ldap_ext.rb
+lib/active_ldap/adapter/net_ldap.rb
+lib/active_ldap/adapter/net_ldap_ext.rb
+lib/active_ldap/association/belongs_to.rb
 lib/active_ldap/association/belongs_to_many.rb
 lib/active_ldap/association/collection.rb
-lib/active_ldap/association/belongs_to.rb
-lib/active_ldap/validations.rb
-lib/active_ldap/command.rb
-lib/active_ldap/callbacks.rb
-lib/active_ldap/ldap.rb
-lib/active_ldap/timeout_stub.rb
-lib/active_ldap/timeout.rb
+lib/active_ldap/association/has_many.rb
+lib/active_ldap/association/has_many_wrap.rb
+lib/active_ldap/association/proxy.rb
+lib/active_ldap/associations.rb
 lib/active_ldap/attributes.rb
-lib/active_ldap/object_class.rb
+lib/active_ldap/base.rb
+lib/active_ldap/callbacks.rb
+lib/active_ldap/command.rb
+lib/active_ldap/configuration.rb
 lib/active_ldap/connection.rb
-lib/active_ldap/associations.rb
-lib/active_ldap/user_password.rb
+lib/active_ldap/distinguished_name.rb
+lib/active_ldap/ldap_error.rb
+lib/active_ldap/object_class.rb
 lib/active_ldap/schema.rb
-lib/active_ldap/configuration.rb
-lib/active_ldap/base.rb
-lib/active_ldap.rb
-benchmark/bench-al.rb
-rails/plugin/active_ldap/init.rb
+lib/active_ldap/timeout.rb
+lib/active_ldap/timeout_stub.rb
+lib/active_ldap/user_password.rb
+lib/active_ldap/validations.rb
 rails/plugin/active_ldap/README
+rails/plugin/active_ldap/generators/scaffold_al/scaffold_al_generator.rb
+rails/plugin/active_ldap/generators/scaffold_al/templates/ldap.yml
+rails/plugin/active_ldap/init.rb
+test/TODO
+test/al-test-utils.rb
+test/command.rb
+test/config.yaml.sample
+test/run-test.rb
+test/test-unit-ext.rb
+test/test-unit-ext/always-show-result.rb
+test/test-unit-ext/priority.rb
+test/test_adapter.rb
+test/test_associations.rb
+test/test_attributes.rb
+test/test_base.rb
+test/test_base_per_instance.rb
+test/test_bind.rb
+test/test_callback.rb
+test/test_connection.rb
+test/test_connection_per_class.rb
+test/test_dn.rb
+test/test_find.rb
+test/test_groupadd.rb
+test/test_groupdel.rb
+test/test_groupls.rb
+test/test_groupmod.rb
+test/test_lpasswd.rb
+test/test_object_class.rb
+test/test_reflection.rb
+test/test_schema.rb
+test/test_user.rb
+test/test_user_password.rb
+test/test_useradd-binary.rb
+test/test_useradd.rb
+test/test_userdel.rb
+test/test_userls.rb
+test/test_usermod-binary-add-time.rb
+test/test_usermod-binary-add.rb
+test/test_usermod-binary-del.rb
+test/test_usermod-lang-add.rb
+test/test_usermod.rb
+test/test_validation.rb

data/README

@@ -40,6 +40,28 @@ INSTALL
   - Run -
     sudo rake install
 
+RAILS
+
+There is a small rails plugin included that allows the use of a file named
+'ldap.yml' in the config directory of your rails app. This file has a similar
+function to the 'database.yml' file that allows you to set your database 
+connection settings per environment. Similarly, the ldap.yml file allows 
+settings to be set for development, test, and production environments. For 
+instance, the development entry would look something like the following:
+
+          development:
+            host: 127.0.0.1
+            port: 389
+            base: dc=localhost
+            bind_dn: cn=admin,dc=localhost
+            password: secret
+
+
+To install, simply copy the rails/plugin/active_ldap folder into the
+vendor/plugins directory of your rails application and create config/ldap.yml.
+When your application starts up, the plugin will call #establish_connection
+using the parameters specified for your current environment.
+          
 
 LICENCE
 

data/Rakefile

@@ -2,21 +2,22 @@
 
 require 'rubygems'
 require 'hoe'
-$:<<'./lib'
+$LOAD_PATH.unshift('./lib')
 require 'active_ldap'
 
-Hoe.new('ruby-activeldap', ActiveLdap::VERSION) do |project|
+project = Hoe.new('ruby-activeldap', ActiveLdap::VERSION) do |project|
   project.rubyforge_name = 'ruby-activeldap'
   project.author = ['Will Drewry', 'Kouhei Sutou']
   project.email = ['will@alum.bu.edu', 'kou@cozmixng.org']
   project.summary = 'Ruby/ActiveLdap is a object-oriented API to LDAP'
   project.url = 'http://rubyforge.org/projects/ruby-activeldap/'
-  project.test_globs = ['test/**']
+  project.test_globs = ['test/test_*.rb']
   project.changes = project.paragraphs_of('CHANGES', 0..1).join("\n\n")
-  project.extra_deps = [['log4r','>= 1.0.4'], 'activerecord']
+  project.extra_deps = [['log4r', '>= 1.0.4'], 'activerecord']
   project.spec_extras = {
     :requirements => ['ruby-ldap >= 0.8.2', '(Open)LDAP server'],
-    :autorequire => 'active_ldap'
+    :autorequire => 'active_ldap',
+    :executables => [],
   }
   project.description = String.new(<<-EOF)
     'Ruby/ActiveLdap' is a ruby extension library which provides a clean
@@ -27,11 +28,43 @@ Hoe.new('ruby-activeldap', ActiveLdap::VERSION) do |project|
   EOF
 end
 
+# fix Hoe's incorrect guess.
+project.spec.executables.clear
+project.bin_files = project.spec.files.grep(/^bin/)
+
+# fix Hoe's install and uninstall task.
+task(:install).instance_variable_get("@actions").clear
+task(:uninstall).instance_variable_get("@actions").clear
+
+task :install do
+  [
+   [project.lib_files, "lib", Hoe::RUBYLIB, 0444],
+   [project.bin_files, "bin", File.join(Hoe::PREFIX, 'bin'), 0555]
+  ].each do |files, prefix, dest, mode|
+    FileUtils.mkdir_p dest unless test ?d, dest
+    files.each do |file|
+      base = File.dirname(file.sub(/^#{prefix}#{File::SEPARATOR}/, ''))
+      _dest = File.join(dest, base)
+      FileUtils.mkdir_p _dest unless test ?d, _dest
+      install file, _dest, :mode => mode
+    end
+  end
+end
+
+desc 'Uninstall the package.'
+task :uninstall do
+  Dir.chdir Hoe::RUBYLIB do
+    rm_f project.lib_files.collect {|f| f.sub(/^lib#{File::SEPARATOR}/, '')}
+  end
+  Dir.chdir File.join(Hoe::PREFIX, 'bin') do
+    rm_f project.bin_files.collect {|f| f.sub(/^bin#{File::SEPARATOR}/, '')}
+  end
+end
+
+
 desc 'Tag the repository for release.'
 task :tag do
   system "svn copy -m 'New release tag' https://ruby-activeldap.googlecode.com/svn/trunk https://ruby-activeldap.googlecode.com/svn/tags/r#{ActiveLdap::VERSION}"
 end
 
-
-
-# vim: syntax=Ruby
+# vim: syntax=ruby

data/TODO

@@ -1,4 +1,4 @@
-- Fix case sensitivity in object classes
+- Test  SASL bind.
 - Add result pagination via LDAP::Controls
 - serialize & serialized_attributes
 - schema mgmt - how does AR handle it?
@@ -9,9 +9,6 @@ http://api.rubyonrails.com/classes/ActiveRecord/Base.html#M000865
   ActiveLdap exception. I think we need to develop an
   application using ActiveLdap.
 - support Ruby/GetText.
-- support Net::LDAP as LDAP backend after Net::LDAP
-  supports START_TLS. (I made a patch and submitted to the
-  bug tracker of Net::LDAP)
 - Add locking around Timeout.alarm() to ensure a multithreaded ruby
   app doesn't hit any race conditions
 - Add AR matching exceptions:
@@ -24,5 +21,3 @@ http://api.rubyonrails.com/classes/ActiveRecord/Base.html#M000865
 * MultiparameterAssignmentErrors
 * AttributeAssignmentError
 * RecordNotSaved
-
-

data/examples/config.yaml.example

@@ -0,0 +1,5 @@
+host: 127.0.0.1
+method: :tls
+base: dc=localdomain
+bind_dn: cn=admin,dc=localdomain
+#adapter: net-ldap

data/examples/groupadd

@@ -0,0 +1,41 @@
+#!/usr/bin/ruby -W0
+
+base = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+$LOAD_PATH << File.join(base, "lib")
+$LOAD_PATH << File.join(base, "examples")
+
+require 'active_ldap'
+require 'objects/user'
+require 'objects/group'
+
+argv, opts, options = ActiveLdap::Command.parse_options do |opts, options|
+  opts.banner += " GROUP_NAME"
+end
+
+if argv.size == 1
+  name = argv.shift
+else
+  $stderr.puts opts
+  exit 1
+end
+
+pwb = Proc.new do |user|
+  ActiveLdap::Command.read_password("[#{user}] Password: ")
+end
+
+ActiveLdap::Base.establish_connection(:password_block => pwb,
+                                      :allow_anonymous => false)
+
+if Group.exists?(name)
+  $stderr.puts("Group #{name} already exists.")
+  exit 1
+end
+
+group = Group.new(name)
+group.gid_number = 9000
+
+unless group.save
+  puts "failed"
+  puts group.errors.full_messages
+  exit 1
+end

data/examples/groupdel

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby -W0
+
+base = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+$LOAD_PATH << File.join(base, "lib")
+$LOAD_PATH << File.join(base, "examples")
+
+require 'active_ldap'
+require 'objects/user'
+require 'objects/group'
+
+argv, opts, options = ActiveLdap::Command.parse_options do |opts, options|
+  opts.banner += " GROUP_NAME"
+end
+
+if argv.size == 1
+  name = argv.shift
+else
+  $stderr.puts opts
+  exit 1
+end
+
+pwb = Proc.new do |user|
+  ActiveLdap::Command.read_password("[#{user}] Password: ")
+end
+
+ActiveLdap::Base.establish_connection(:password_block => pwb,
+                                      :allow_anonymous => false)
+
+
+unless Group.exists?(name)
+  $stderr.puts("Group #{name} doesn't exist.")
+  exit 1
+end
+
+Group.destroy(name)

data/examples/groupls

@@ -0,0 +1,49 @@
+#!/usr/bin/ruby -W0
+
+base = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+$LOAD_PATH << File.join(base, "lib")
+$LOAD_PATH << File.join(base, "examples")
+
+require 'active_ldap'
+require 'objects/user'
+require 'objects/group'
+
+argv, opts, options = ActiveLdap::Command.parse_options do |opts, options|
+  opts.banner += " GROUP_NAME"
+end
+
+if argv.size == 1
+  name = argv.shift
+else
+  $stderr.puts opts
+  exit 1
+end
+
+pwb = Proc.new do |user|
+  ActiveLdap::Command.read_password("[#{user}] Password: ")
+end
+
+ActiveLdap::Base.establish_connection(:password_block => pwb,
+                                      :allow_anonymous => false)
+
+unless Group.exists?(name)
+  $stderr.puts("Group #{name} doesn't exist.")
+  exit 1
+end
+
+group = Group.find(name)
+
+members = []
+group.primary_members.each do |mem|
+  members << "#{mem.uid}[#{mem.uidNumber}]"
+end
+
+group.members.each do |mem|
+  if mem.new_entry?
+    members << "#{mem.uid}[????]"
+  else
+    members << "#{mem.uid}[#{mem.uidNumber}]"
+  end
+end
+
+puts("#{group.id}(#{group.gid_number}): #{members.join(', ')}")

data/examples/groupmod

@@ -0,0 +1,42 @@
+#!/usr/bin/ruby -W0
+
+base = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+$LOAD_PATH << File.join(base, "lib")
+$LOAD_PATH << File.join(base, "examples")
+
+require 'active_ldap'
+require 'objects/user'
+require 'objects/group'
+
+argv, opts, options = ActiveLdap::Command.parse_options do |opts, options|
+  opts.banner += " GROUP_NAME GID_NUMBER"
+end
+
+if argv.size == 2
+  name, gid = argv
+else
+  $stderr.puts opts
+  exit 1
+end
+
+pwb = Proc.new do |user|
+  ActiveLdap::Command.read_password("[#{user}] Password: ")
+end
+
+ActiveLdap::Base.establish_connection(:password_block => pwb,
+                                      :allow_anonymous => false)
+
+
+unless Group.exists?(name)
+  $stderr.puts("Group #{name} doesn't exist.")
+  exit 1
+end
+
+group = Group.find(name)
+group.gid_number = gid
+
+unless group.save
+  puts "failed"
+  puts group.errors.full_messages
+  exit 1
+end