ruby-activeldap 0.8.2 → 0.8.3

data/README

@@ -1,85 +0,0 @@
-Ruby/ActiveLdap -- ruby library for object-oriented LDAP interction
-Copyright (C) 2004-2006 Will Drewry <will@alum.bu.edu>, Kouhei Sutou <kou@cozmixng.org>
-Contributors:
- * Dick Davies <rasputnik@hellooperator.net>
- * Nathan Kinder <quicksilver02@mac.com>
- * Patrick Cole <pac@independent.com.au>
- * Google Inc.
-
-DESCRIPTION
-'Ruby/ActiveLdap' is a ruby extension library which provides a clean objected
-oriented interface to the Ruby/LDAP[0] library.  It was inspired by
-ActivRecord[2]. This is not nearly as clean or as flexible as ActiveRecord, but
-it is still trivial to define new objects and manipulate them with minimal
-difficulty.
-
-For example and usage - read the rdoc in doc/ from lib/activeldap.rb.
-It is also available on the web at:
-
-http://ruby-activeldap.rubyforge.org/
-
-PREREQUISITES
-
-  * Ruby 1.8.x [1]
-  * Ruby/LDAP [0]
-  * Log4r [4]
-  * ActiveRecord [2]
-  * (Optional) Ruby/LDAP+GSSAPI [3]
-  * An LDAP server compatible with Ruby/LDAP: OpenLDAP, etc
-
-
-NOTES
-
-  * Only GSSAPI SASL support exists due to Ruby/LDAP limitations
-  * The API is subject to change as this package slowly approaches 1.0.0
-
-
-INSTALL
-
-  - Edit active_ldap/configuration.rb with your LDAP preferences
-  - 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
-
-This program is free software; you can redistribute it and/or modify it.  It is
-dual licensed under Ruby's license and under the terms of the GNU General
-Public License as published by the Free Software Foundation; either version 2,
-or (at your option) any later version.
-
-Please see the file LICENSE for the terms of the licence.
-
-
-REFERENCES
-
-[0] - http://ruby-ldap.sourceforge.net
-[1] - http://www.ruby-lang.org
-[2] - http://activerecord.rubyonrails.org
-[3] - http://caliban.org/files/redhat/RPMS/i386/ruby-ldap-0.8.2-4.i386.rpm
-[4] - http://log4r.sourceforge.net/
-
-
-

data/Rakefile

@@ -1,70 +0,0 @@
-# -*- ruby -*-
-
-require 'rubygems'
-require 'hoe'
-$LOAD_PATH.unshift('./lib')
-require 'active_ldap'
-
-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/test_*.rb']
-  project.changes = project.paragraphs_of('CHANGES', 0..1).join("\n\n")
-  project.extra_deps = [['log4r', '>= 1.0.4'], 'activerecord']
-  project.spec_extras = {
-    :requirements => ['ruby-ldap >= 0.8.2', '(Open)LDAP server'],
-    :autorequire => 'active_ldap',
-    :executables => [],
-  }
-  project.description = String.new(<<-EOF)
-    'Ruby/ActiveLdap' is a ruby extension library which provides a clean
-    objected oriented interface to the Ruby/LDAP library.  It was inspired
-    by ActiveRecord. This is not nearly as clean or as flexible as
-    ActiveRecord, but it is still trivial to define new objects and manipulate
-    them with minimal difficulty.
-  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

data/TODO

@@ -1,23 +0,0 @@
-- Test  SASL bind.
-- Add result pagination via LDAP::Controls
-- serialize & serialized_attributes
-- schema mgmt - how does AR handle it?
-- columns() -- ?
-http://api.rubyonrails.com/classes/ActiveRecord/Base.html#M000865
-- provide full documentation for new API.
-- handle all exception raised from Ruby/LDAP and wrap as
-  ActiveLdap exception. I think we need to develop an
-  application using ActiveLdap.
-- support Ruby/GetText.
-- Add locking around Timeout.alarm() to ensure a multithreaded ruby
-  app doesn't hit any race conditions
-- Add AR matching exceptions:
-* ActiveRecordError -- ActiveLdapError as base
-* AssociationTypeMismatch
-* SerializationTypeMismatch
-* ConnectionNotEstablished
-* RecordNotFound
-* LdapActionInvalid - like StatementInvalid
-* MultiparameterAssignmentErrors
-* AttributeAssignmentError
-* RecordNotSaved

data/benchmark/bench-al.rb

@@ -1,152 +0,0 @@
-base = File.dirname(__FILE__)
-$LOAD_PATH.unshift(File.expand_path(base))
-$LOAD_PATH.unshift(File.expand_path(File.join(base, "..", "lib")))
-
-require "active_ldap"
-require "benchmark"
-
-LDAP_SERVER = "127.0.0.1"
-LDAP_PORT = 389
-LDAP_BASE = ENV["LDAP_BASE"] || "dc=localdomain"
-LDAP_PREFIX = "ou=People"
-LDAP_USER = nil
-LDAP_PASSWORD = nil
-
-class ALUser < ActiveLdap::Base
-  ldap_mapping :dn_attribute => 'uid', :prefix => LDAP_PREFIX,
-               :classes => ['posixAccount', 'person']
-end
-
-# === search_al
-#
-def search_al
-  count = 0
-  ALUser.find(:all).each do |e|
-    count += 1
-  end
-  return count
-end # -- search_al
-
-def search_al_without_object_creation
-  count = 0
-  ALUser.search.each do |e|
-    count += 1
-  end
-  return count
-end
-
-# === search_ldap
-#
-def search_ldap(conn)
-  count = 0
-  conn.search("#{LDAP_PREFIX},#{LDAP_BASE}",
-              LDAP::LDAP_SCOPE_SUBTREE,
-              "(uid=*)") do |e|
-    count += 1
-  end
-  count
-end # -- search_ldap
-
-def populate_base
-  suffixes = []
-  ActiveLdap::Base.base.split(/,/).reverse_each do |suffix|
-    prefix = suffixes.join(",")
-    suffixes.unshift(suffix)
-    name, value = suffix.split(/=/, 2)
-    next unless name == "dc"
-    dc_class = Class.new(ActiveLdap::Base)
-    dc_class.ldap_mapping :dn_attribute => "dc",
-                          :prefix => "",
-                          :scope => :base,
-                          :classes => ["top", "dcObject", "organization"]
-    dc_class.instance_variable_set("@base", prefix)
-    next if dc_class.exists?(value, :prefix => "dc=#{value}")
-    dc = dc_class.new(value)
-    dc.o = dc.dc
-    dc.save
-  end
-
-  if ActiveLdap::Base.search.empty?
-    raise "Can't populate #{ActiveLdap::Base.base}"
-  end
-end
-
-def populate_users
-  ou_class = Class.new(ActiveLdap::Base)
-  ou_class.ldap_mapping :dn_attribute => "ou",
-                        :prefix => "",
-                        :classes => ["top", "organizationalUnit"]
-  ou_class.new(LDAP_PREFIX.split(/=/)[1]).save!
-
-  100.times do |i|
-    name = i.to_s
-    user = ALUser.new(name)
-    user.uid_number = 100000 + i
-    user.gid_number = 100000 + i
-    user.cn = name
-    user.sn = name
-    user.home_directory = "/nonexistent"
-    user.save!
-  end
-end
-
-def populate
-  populate_base
-  populate_users
-end
-
-# === main(argv)
-#
-def main(argv)
-  # Connect with AL
-  #
-  config = {
-    :host => LDAP_SERVER,
-    :port => LDAP_PORT,
-    :base => LDAP_BASE,
-  }
-
-  do_populate = LDAP_USER && LDAP_PASSWORD
-
-  if do_populate
-    config[:bind_dn] = LDAP_USER
-    config[:password] = LDAP_PASSWORD
-  end
-  ActiveLdap::Base.establish_connection(config)
-
-  if do_populate
-    puts "populating..."
-    dumped_data = ActiveLdap::Base.dump(:scope => :sub)
-    ActiveLdap::Base.delete_all(nil, :scope => :sub)
-    populate
-  end
-
-  # Standard connection
-  #
-  conn = LDAP::Conn.new(LDAP_SERVER, LDAP_PORT)
-  al_count = 0
-  al_count_without_object_creation = 0
-  ldap_count = 0
-  Benchmark.bm(10) do |x|
-    x.report("AL") { al_count = search_al }
-    x.report("AL(No Obj)") do
-      al_count_without_object_creation = search_al_without_object_creation
-    end
-    x.report("LDAP") { ldap_count = search_ldap(conn) }
-  end
-  print "Entries processed by Ruby/ActiveLdap: #{al_count}\n"
-  print "Entries processed by Ruby/ActiveLdap (without object creation)" +
-        ": #{al_count_without_object_creation}\n"
-  print "Entries processed by Ruby/LDAP: #{ldap_count}\n"
-
-  0
-ensure
-  if do_populate
-    ActiveLdap::Base.delete_all(nil, :scope => :sub)
-    ActiveLdap::Base.load(dumped_data)
-  end
-end
-
-if $0 == __FILE__ then
- exit(main(ARGV) || 1)
-end

data/examples/config.yaml.example

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

data/examples/groupadd

@@ -1,41 +0,0 @@
-#!/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

@@ -1,35 +0,0 @@
-#!/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

@@ -1,49 +0,0 @@
-#!/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(', ')}")