treequel 1.0.0

data/ChangeLog

@@ -0,0 +1,354 @@
+117[tip]   e98fb34df0c0   2009-08-13 16:43 -0700   ged
+  Adding Branchset#to_hash
+
+116   e18bfe831135   2009-08-13 16:16 -0700   ged
+  Updated build system.
+
+115   a8927110eaa6   2009-08-13 15:57 -0700   ged
+  Fixed the display in the company directory example template.
+
+114   dddcad307b99   2009-08-13 15:53 -0700   ged
+  * Adding some more examples, updating the README.
+
+113   c8fc81f20772   2009-08-13 13:28 -0700   ged
+  Some cleanup and additions for release.
+
+112   e352bc86498a   2009-08-13 11:06 -0700   ged
+  Bumping version for release.
+
+111   73775f828f6b   2009-08-13 09:35 -0700   ged
+  Fixes for Ruby 1.9.1.
+
+110   af19a52bb21a   2009-08-13 07:38 -0700   ged
+  More work on the ldap-monitor example.
+
+109   809044df70bd   2009-08-12 10:04 -0700   ged
+  * Removing unused deveiate-theme stylesheet.
+
+108   633687b023c4   2009-08-12 08:02 -0700   ged
+  Committing CSS I forgot to commit with the last rev
+
+107   f9551821eced   2009-08-11 20:59 -0700   ged
+  * Added another real-world example and added a bit more work to the web monitor app.
+
+106   85dadbaf70a9   2009-08-11 08:54 -0700   ged
+  * Added my nascent LDAP web monitor sinatra app under examples/
+
+105   c8c4db6916f1   2009-08-10 23:53 -0700   ged
+  Stripped SVN constants and headers.
+
+104   3624f71a141d   2009-08-10 14:42 -0700   ged
+  * More manual work
+
+103   1b0eaa8f5a64   2009-08-10 08:11 -0700   ged
+  Fixes for the manual footer
+
+102   72833e18e4f8   2009-08-10 07:59 -0700   ged
+  * Removing Branch#order, since the client-library sort attribute and function don't do
+
+101   bacf91784530   2009-08-05 13:26 -0700   ged
+  * Manual headings have a bit more top-margin.
+
+100:99,98   b53d391399ce   2009-08-03 14:18 -0700   ged
+  Merged f9ac0e1fa95f
+
+99:97   afeff031274d   2009-08-03 14:17 -0700   ged
+  * Finished conversion of the manual to client-side syntax-highlighting instead of
+
+98   f9ac0e1fa95f   2009-08-03 08:41 -0700   ged
+  * Adding a prompt mode to the .irbrc for manual example generation.
+
+97   1ddf7d4212c7   2009-08-01 08:31 -0700   ged
+  * Added details about Branchset#filter, #scope, #limit, and #select
+
+96   6b5358420802   2009-07-31 08:29 -0700   ged
+  Updated build system
+
+95:94,92   a5e715f5f877   2009-07-31 08:13 -0700   ged
+  Merged. Someday I'll get the hang of this.
+
+94:93,91   395b7bf6f248   2009-07-28 06:11 -0700   ged
+  Merged with 34cc97817266
+
+93:89   89f74035c67d   2009-07-28 06:10 -0700   ged
+  Manual rewording, .hgignore updates
+
+92   46e6dce0c011   2009-07-29 13:28 -0700   ged
+  * Adding coverage cache to the ignorefile.
+
+91   34cc97817266   2009-07-27 12:06 -0700   ged
+  Updated build system
+
+90:86,89   daf0e44c41ac   2009-07-27 11:58 -0700   ged
+  Merging work from gont
+
+89:83,88   b7a919b2ad5d   2009-07-24 21:07 -0700   ged
+  Merging build system fixes
+
+88   620807d4c6d5   2009-07-24 21:05 -0700   ged
+  Updated build system
+
+87:85   f631900a9ad8   2009-07-24 19:33 -0700   ged
+  Removing subrepo, as it doesn't work quite the way I'd hoped.
+
+86:83   fc3c3bac2c22   2009-07-24 17:27 -0700   ged
+  Unlinking the subrepo, as it doesn't behave well enough quite yet.
+
+85   65236b2101e5   2009-07-24 11:22 -0700   ged
+  Initial commit of Mercurial-based tasks
+
+84   76e4c3cc308b   2009-07-23 08:51 -0700   ged
+  Started converting svn-specific helpers and tasks to vcs-agnostic ones
+
+83   8be8e94f829d   2009-07-21 18:10 -0700   ged
+  Adding experimental .hgsub for the rake tasklibs
+
+82   7bd626d9f0cd   2009-07-21 15:44 +0000   mahlon
+  Manual updates for Branches, Branchsets, and Directory.base.
+
+81   8ca3428f711e   2009-07-21 12:51 +0000   ged
+  * Treequel::Branch
+
+80   15bfd9785019   2009-07-21 00:16 +0000   ged
+  * Fixing Treequel::Branch#copy, which was mistakenly using a modrdn to copy.
+
+79   74b7a9bca977   2009-07-20 22:22 +0000   ged
+  * Treequel::Branch: Don't freeze non-Arrays in the cached attribute values hash.
+
+78   3e4105c3ebaa   2009-07-20 17:30 +0000   ged
+  * Made the Hash merge function a module_function instead of a constant
+
+77   7a62ac4c346b   2009-07-20 13:20 +0000   ged
+  * Added the ability to include operational attributes in Treequel::Branch at the
+
+76   206b077875e5   2009-07-19 18:36 +0000   ged
+  Adding missing wrap.png for the manual
+
+75   1505adefc436   2009-07-18 06:28 +0000   ged
+  * Make ObjectClass#sup return the corresponding ObjectClass instance.
+
+74   12ec14055953   2009-07-17 22:53 +0000   ged
+  Cleaned up the manual syntax-highlighting a bunch. Red logo!
+
+73   8c8193c00a6a   2009-07-17 17:59 +0000   ged
+  Use client-side highlighting instead of Ultraviolet.
+
+72   1e2391e73329   2009-07-17 15:40 +0000   mahlon
+  * Wrap branch rdn attributes in an array for easy mungin' and merging.
+
+71   96e0654c8652   2009-07-17 13:27 +0000   ged
+  * Manual work.
+
+70   3e2835dbe859   2009-07-17 05:14 +0000   ged
+  * Logo and other manual work
+
+69   cf1c7d481519   2009-07-17 03:00 +0000   ged
+  * Treequel::Branch
+
+68   bf47d67f76f1   2009-07-16 17:04 +0000   mahlon
+  * Wrap branch rdn attributes in an array for easy mungin' and merging.
+
+67   7d8dc70f5fe1   2009-07-15 15:50 +0000   ged
+  * Order attributes by their key when composing a multi-value RDN from a pair + a Hash for
+
+66   f21be0277b19   2009-07-15 00:41 +0000   ged
+  Adding logo
+
+65   e434f63779e5   2009-07-13 17:48 +0000   ged
+  * Updated build system
+
+64   f2b47be064b6   2009-07-08 17:38 +0000   ged
+  * A bit more hacking on the OHM experiment.
+
+63   57360b9b8143   2009-07-03 00:57 +0000   ged
+  * Treequel::Branch
+
+62   1c3bd5a2a4f0   2009-07-02 15:22 +0000   ged
+  * Adding experimental Arrow service that uses Treequel to return ou=People records.
+
+61   1853efa345e2   2009-06-30 15:31 +0000   ged
+  Removing the call to `Time.today` from the specs, as it requires the loading of 'time'.
+
+60   e5a2a960c89d   2009-06-30 15:08 +0000   ged
+  * Added Treequel::Branch#to_ufn
+
+59   9759280f111a   2009-06-29 17:00 +0000   ged
+  * Adding the beginnings of an experimental object-mapping (tree-based ORM analogue) for LDAP
+
+58   bc236240ca46   2009-06-27 00:43 +0000   ged
+  Updated HTML logger formatter to the latest.
+
+57   35d0872f8b7f   2009-06-25 18:49 +0000   ged
+  * Renamed Treequel::Branch#modify to #merge
+
+56   30445a043298   2009-06-24 14:15 +0000   ged
+  Fixed some LAIKA references in the manual.
+
+55   6cc39e6befdb   2009-06-23 19:34 +0000   ged
+  * Fixed docs on the binding arguments for Treequel::Directory#initialize.
+
+54   3a204e54603e   2009-06-23 14:57 +0000   ged
+  * Added delegation to the connection wrapper.
+
+53   6defed90cfcc   2009-06-22 17:09 +0000   ged
+  * Fixed RDoc headers.
+
+52   cdbb80f015b6   2009-06-18 18:45 +0000   ged
+  * Updated the build system.
+
+51   6da5c8ac1752   2009-06-18 15:29 +0000   ged
+  * Adding BranchCollection class.
+
+50   8713fc4b41a9   2009-06-17 18:42 +0000   ged
+  * Updated build system
+
+49   d33d81ff8327   2009-06-11 22:17 +0000   ged
+  Adding the beginnings of a manual.
+
+48   99d1553532f1   2009-06-11 22:11 +0000   ged
+  * Treequel::Branch:
+
+47   3cf7a6589f40   2009-06-11 03:51 +0000   ged
+  * Fetch the default baseDN from the directory's root DSE instead of just using
+
+46   decd99bd99e9   2009-06-09 22:54 +0000   ged
+  * Added Branch#to_ldif
+
+45   b27a2eb78d02   2009-06-08 17:53 +0000   ged
+  * Added datatype conversions for some of the default syntaxes to Directory.
+
+44   4c2477eb2a68   2009-06-04 03:55 +0000   ged
+  * Treequel::Branch
+
+43   b02d86bf9162   2009-06-02 15:42 +0000   ged
+  * Finished hooking up LDAPSyntax to AttributeType.
+
+42   7617a4b44fd9   2009-06-01 16:17 +0000   ged
+  * Finished implementation of matchingRuleUses and ldapSyntaxes.
+
+41   99fd606993ac   2009-06-01 14:27 +0000   ged
+  * Checkpoint commit of Treequel::Schema::LDAPSyntax class.
+
+40   3dd18fa1c7fc   2009-05-29 20:57 +0000   ged
+  * Adding Treequel::Schema::MatchingRule.
+
+39   cb93500e5d98   2009-05-29 15:28 +0000   ged
+  * Treequel::Branch -- Changed the 'value' and 'attribute' attributes to 'rdn_value' and
+
+38   fb415faaeddb   2009-05-29 02:49 +0000   ged
+  * Added custom #inspect methods for Schema and Directory.
+
+37   aaef0c5c4703   2009-05-23 21:44 +0000   ged
+  * Updated build system
+
+36   3132d19804a1   2009-05-20 19:08 +0000   ged
+  * Treequel::Branch
+
+35   e43f57f0f04c   2009-05-19 08:01 +0000   ged
+  Include the superior class's name in Treequel::Schema::ObjectClass#inspect output.
+
+34   3ebeec1eacf6   2009-05-19 00:13 +0000   ged
+  * Treequel::Branch
+
+33   c615693a11e0   2009-05-18 21:10 +0000   ged
+  * Finished up Treequel::Branch#[]=
+
+32   72cd36c693ca   2009-05-18 14:56 +0000   mahlon
+  * If a user/pass is supplied via the directory connect URI, bind immediately.
+
+31   a9bcbecb60f3   2009-05-16 00:03 +0000   ged
+  * Treequel::Branch
+
+30   72ccdbdccd8d   2009-05-15 16:52 +0000   ged
+  * Treequel::Branch:
+
+29   34bce6d3ec1a   2009-05-14 18:43 +0000   ged
+  * Finished the initial implementation of the Sequel::Schema::AttributeType class.
+
+28   3a222b303870   2009-05-13 16:38 +0000   ged
+  * Replaced the plain Treequel::Directory#schema method with the one that
+
+27   4946985217e9   2009-05-13 01:00 +0000   ged
+  * Renamed Treequel::Branch#attr_pair to #rdn.
+
+26   da533735fb9f   2009-05-12 14:22 +0000   ged
+  * Unified must/may oids into @must_oids and @may_oids to distinguish between them and
+
+25   44a3834ff324   2009-05-11 23:09 +0000   ged
+  * Added name, desc, kind, must, and may attribute normalization to
+
+24   1d9b831d1579   2009-05-11 16:49 +0000   ged
+  Checkpoint commit:
+
+23   9a1ba6888856   2009-05-11 13:21 +0000   ged
+  Checkpoint commit:
+
+22   fc25616368b8   2009-05-08 01:08 +0000   ged
+  More work on parsing objectClasses.
+
+21   2378ca43e383   2009-05-07 19:44 +0000   ged
+  Checkpoint commit -- converting schema regexps to match the BNF in RFC 4512 instead of the one from 2252.
+
+20   feedf3cfda8b   2009-04-29 16:59 +0000   ged
+  * Added more RFC2252 regexp patterns to constants.rb.
+
+19   f2fef4dea785   2009-04-24 17:03 +0000   ged
+  * Starting work on schema support.
+
+18   fa68642a4c6b   2009-04-22 16:21 +0000   ged
+  * Fixed .filter( :attribute => value )
+
+17   d009a339d2cd   2009-04-22 13:24 +0000   ged
+  * Started filter support for Sequel expressions
+
+16   cb0752ae5ce9   2009-04-21 01:57 +0000   ged
+  More filter work.
+
+15   53fef8079a4e   2009-04-20 16:32 +0000   ged
+  Finished up initial filter work.
+
+14   621dbbe99418   2009-04-18 08:05 +0000   ged
+  * Committing yesterday's work on substring filters before I fall asleep.
+
+13   b71338a3b66f   2009-04-16 16:31 +0000   ged
+  * Started work on substring item filter syntax and class.
+
+12   27d7a681eb00   2009-04-16 01:08 +0000   ged
+  Checkpoint of more filter work.
+
+11   53cf56feaad8   2009-04-15 15:41 +0000   ged
+  Committing this morning's work.
+
+10   ba1440c71f01   2009-04-13 20:15 +0000   ged
+  Checkpoint commit of this morning's work.
+
+9   e8fd5884c22f   2009-04-10 16:01 +0000   ged
+  Checkpoint commit.
+
+8   6924adc0feb2   2009-04-09 15:58 +0000   ged
+  Checkpoint commit.
+
+7   0c1438a9105a   2009-03-30 15:27 +0000   ged
+  Checkpoint commit.
+
+6   5f3f334406cf   2009-03-18 00:54 +0000   ged
+  * Finished Treequel::Branch.new_from_dn
+
+5   83d533b2987d   2009-03-10 16:49 +0000   ged
+  * Checkpoint of the morning's work.
+
+4   27b230b291a3   2009-03-10 05:10 +0000   ged
+  * Snapshot of today's work.
+
+3   f73835204ddc   2009-03-09 20:05 +0000   ged
+  * Committing the morning's work.
+
+2   7709b9520686   2009-03-09 13:44 +0000   ged
+  * Updated build system
+
+1   d8e78b6b4088   2009-03-07 04:37 +0000   ged
+  * Started an initial spike and installed build system.
+
+0   b21f833298d6   2008-12-05 19:28 +0000   ged
+  Creating repo
+

data/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2008-2009, Michael Granger and Mahlon E. Smith
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author/s, nor the names of the project's
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README

@@ -0,0 +1,66 @@
+= Treequel - an honest LDAP library
+
+Treequel is an LDAP toolkit for Ruby. It is intended to allow quick, easy
+access to LDAP directories in a manner consistent with LDAP's hierarchical,
+free-form nature. 
+
+It's inspired by and modeled after Sequel (http://sequel.rubyforge.org/), a
+kick-ass database library.
+
+
+== Examples
+
+Here are a few short examples to whet your appetite:
+
+  # Connect to the directory at the specified URL
+  dir = Treequel.directory( 'ldap://ldap.company.com/dc=company,dc=com' )
+
+  # Get a list of email addresses of every person in the directory (as
+  # long as people are under ou=people)
+  dir.ou( :people ).filter( :mail ).map( :mail ).flatten
+
+  # Get a list of all IP addresses for all hosts in any ou=hosts group
+  # in the whole directory:
+  dir.filter( :ou => :hosts ).collection.filter( :ipHostNumber ).
+    map( :ipHostNumber ).flatten
+
+  # Get all people in the directory in the form of a hash of names 
+  # keyed by email addresses
+  dir.ou( :people ).filter( :mail ).to_hash( :mail, :cn )
+
+More elaborate examples of real-world usage can be found in the examples/ 
+directory in the distribution. You can also browse them in a web browser 
+via the project page:
+
+  http://deveiate.org/projects/Treequel/browser/examples
+
+
+== Contributing
+
+You can check out the current development source with Mercurial from the
+following URL:
+
+    http://repo.deveiate.org/Treequel
+
+You can submit bug reports, suggestions, and read more about future plans at
+the project page:
+
+    http://deveiate.org/projects/Treequel
+
+
+== License
+
+See the included LICENSE file for licensing details.
+
+
+== Authors
+
+* Michael Granger
+* Mahlon E. Smith
+
+
+== Contributors
+
+A special thanks to Ben Bleything, who was part of the initial brainstorm that
+led to the creation of this library.
+

data/Rakefile

@@ -0,0 +1,345 @@
+#!rake
+#
+# Treequel rakefile
+#
+# Based on various other Rakefiles, especially one by Ben Bleything
+#
+# Copyright (c) 2007-2009 The FaerieMUD Consortium
+#
+# Authors:
+#  * Michael Granger <ged@FaerieMUD.org>
+#  * Mahlon E. Smith <mahlon@martini.nu>
+#
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname.new( __FILE__ ).dirname
+
+	libdir = basedir + "lib"
+	extdir = basedir + "ext"
+
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+	$LOAD_PATH.unshift( extdir.to_s ) unless $LOAD_PATH.include?( extdir.to_s )
+}
+
+begin
+	require 'readline'
+	include Readline
+rescue LoadError
+	# Fall back to a plain prompt
+	def readline( text )
+		$stderr.print( text.chomp )
+		return $stdin.gets
+	end
+end
+
+require 'rbconfig'
+require 'rake'
+require 'rake/testtask'
+require 'rake/packagetask'
+require 'rake/clean'
+# require 'rake/191_compat.rb'
+
+$dryrun = false
+
+### Config constants
+BASEDIR       = Pathname.new( __FILE__ ).dirname.relative_path_from( Pathname.getwd )
+BINDIR        = BASEDIR + 'bin'
+LIBDIR        = BASEDIR + 'lib'
+EXTDIR        = BASEDIR + 'ext'
+DOCSDIR       = BASEDIR + 'docs'
+PKGDIR        = BASEDIR + 'pkg'
+DATADIR       = BASEDIR + 'data'
+
+MANUALDIR     = DOCSDIR + 'manual'
+
+PROJECT_NAME  = 'Treequel'
+PKG_NAME      = PROJECT_NAME.downcase
+PKG_SUMMARY   = 'An honest LDAP library'
+
+# Cruisecontrol stuff
+CC_BUILD_LABEL     = ENV['CC_BUILD_LABEL']
+CC_BUILD_ARTIFACTS = ENV['CC_BUILD_ARTIFACTS'] || 'artifacts'
+
+VERSION_FILE  = LIBDIR + 'treequel.rb'
+if VERSION_FILE.exist? && buildrev = ENV['CC_BUILD_LABEL']
+	PKG_VERSION = VERSION_FILE.read[ /VERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/, 1 ] + '.' + buildrev
+elsif VERSION_FILE.exist?
+	PKG_VERSION = VERSION_FILE.read[ /VERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/, 1 ]
+else
+	PKG_VERSION = '0.0.0'
+end
+
+PKG_FILE_NAME = "#{PKG_NAME.downcase}-#{PKG_VERSION}"
+GEM_FILE_NAME = "#{PKG_FILE_NAME}.gem"
+
+# Universal VCS constants
+DEFAULT_EDITOR  = 'vi'
+COMMIT_MSG_FILE = 'commit-msg.txt'
+FILE_INDENT     = " " * 12
+LOG_INDENT      = " " * 3
+
+CHANGELOG     = BASEDIR + 'ChangeLog'
+EXTCONF       = EXTDIR + 'extconf.rb'
+
+ARTIFACTS_DIR = Pathname.new( CC_BUILD_ARTIFACTS )
+
+TEXT_FILES    = Rake::FileList.new( %w[Rakefile ChangeLog README LICENSE] )
+BIN_FILES     = Rake::FileList.new( "#{BINDIR}/*" )
+LIB_FILES     = Rake::FileList.new( "#{LIBDIR}/**/*.rb" )
+EXT_FILES     = Rake::FileList.new( "#{EXTDIR}/**/*.{c,h,rb}" )
+DATA_FILES    = Rake::FileList.new( "#{DATADIR}/**/*" )
+
+SPECDIR       = BASEDIR + 'spec'
+SPECLIBDIR    = SPECDIR + 'lib'
+SPEC_FILES    = Rake::FileList.new( "#{SPECDIR}/**/*_spec.rb", "#{SPECLIBDIR}/**/*.rb" )
+
+TESTDIR       = BASEDIR + 'tests'
+TEST_FILES    = Rake::FileList.new( "#{TESTDIR}/**/*.tests.rb" )
+
+RAKE_TASKDIR  = BASEDIR + 'rake'
+RAKE_TASKLIBS = Rake::FileList.new( "#{RAKE_TASKDIR}/*.rb" )
+PKG_TASKLIBS  = Rake::FileList.new( "#{RAKE_TASKDIR}/{191_compat,helpers,packaging,rdoc,testing}.rb" )
+PKG_TASKLIBS.include( "#{RAKE_TASKDIR}/manual.rb" ) if MANUALDIR.exist?
+
+RAKE_TASKLIBS_URL = 'http://repo.deveiate.org/rake-tasklibs'
+
+LOCAL_RAKEFILE = BASEDIR + 'Rakefile.local'
+
+EXTRA_PKGFILES = Rake::FileList.new
+EXTRA_PKGFILES.include( "#{BASEDIR}/examples/**/*.{rb,erb,css,png}" )
+
+RELEASE_FILES = TEXT_FILES + 
+	SPEC_FILES + 
+	TEST_FILES + 
+	BIN_FILES +
+	LIB_FILES + 
+	EXT_FILES + 
+	DATA_FILES + 
+	RAKE_TASKLIBS +
+	EXTRA_PKGFILES
+
+
+RELEASE_FILES << LOCAL_RAKEFILE.to_s if LOCAL_RAKEFILE.exist?
+
+COVERAGE_MINIMUM = ENV['COVERAGE_MINIMUM'] ? Float( ENV['COVERAGE_MINIMUM'] ) : 85.0
+RCOV_EXCLUDES = 'spec,tests,/Library/Ruby,/var/lib,/usr/local/lib'
+RCOV_OPTS = [
+	'--exclude', RCOV_EXCLUDES,
+	'--xrefs',
+	'--save',
+	'--callsites',
+	#'--aggregate', 'coverage.data' # <- doesn't work as of 0.8.1.2.0
+  ]
+
+
+### Load some task libraries that need to be loaded early
+if !RAKE_TASKDIR.exist?
+	$stderr.puts "It seems you don't have the build task directory. Shall I fetch it "
+	ans = readline( "for you? [y]" )
+	ans = 'y' if !ans.nil? && ans.empty?
+
+	if ans =~ /^y/i
+		$stderr.puts "Okay, fetching #{RAKE_TASKLIBS_URL} into #{RAKE_TASKDIR}..."
+		system 'hg', 'clone', RAKE_TASKLIBS_URL, RAKE_TASKDIR
+		if ! $?.success?
+			fail "Damn. That didn't work. Giving up; maybe try manually fetching?"
+		end
+	else
+		$stderr.puts "Then I'm afraid I can't continue. Best of luck."
+		fail "Rake tasklibs not present."
+	end
+
+	RAKE_TASKLIBS.include( "#{RAKE_TASKDIR}/*.rb" )
+end
+
+require RAKE_TASKDIR + 'helpers.rb'
+
+# Define some constants that depend on the 'svn' tasklib
+if hg = which( 'hg' )
+	id = IO.read('|-') or exec hg, 'id', '-q'
+	PKG_BUILD = id.chomp
+else
+	PKG_BUILD = 0
+end
+SNAPSHOT_PKG_NAME = "#{PKG_FILE_NAME}.#{PKG_BUILD}"
+SNAPSHOT_GEM_NAME = "#{SNAPSHOT_PKG_NAME}.gem"
+
+# Documentation constants
+RDOCDIR = DOCSDIR + 'api'
+RDOC_OPTIONS = [
+	'-w', '4',
+	'-HN',
+	'-i', '.',
+	'-m', 'README',
+	'-t', PKG_NAME,
+	'-W', 'http://deveiate.org/projects/Treequel/browser/'
+  ]
+
+# Release constants
+SMTP_HOST = 'mail.faeriemud.org'
+SMTP_PORT = 465 # SMTP + SSL
+
+# Project constants
+PROJECT_HOST = 'deveiate'
+PROJECT_PUBDIR = '/usr/local/www/public/code'
+PROJECT_DOCDIR = "#{PROJECT_PUBDIR}/#{PKG_NAME}"
+PROJECT_SCPPUBURL = "#{PROJECT_HOST}:#{PROJECT_PUBDIR}"
+PROJECT_SCPDOCURL = "#{PROJECT_HOST}:#{PROJECT_DOCDIR}"
+
+# Rubyforge stuff
+RUBYFORGE_GROUP = 'deveiate'
+RUBYFORGE_PROJECT = 'treequel'
+
+# Gem dependencies: gemname => version
+DEPENDENCIES = {
+	'ruby-ldap' => '>= 0.9.9',
+}
+
+# Developer Gem dependencies: gemname => version
+DEVELOPMENT_DEPENDENCIES = {
+	'rake'        => '>= 0.8.7',
+	'rcodetools'  => '>= 0.7.0.0',
+	'rcov'        => '>= 0.8.1.2.0',
+	'rdoc'        => '>= 2.4.3',
+	'RedCloth'    => '>= 4.0.3',
+	'rspec'       => '>= 1.2.6',
+	'rubyforge'   => '>= 0',
+	'termios'     => '>= 0',
+	'text-format' => '>= 1.0.0',
+	'tmail'       => '>= 1.2.3.1',
+}
+
+# Non-gem requirements: packagename => version
+REQUIREMENTS = {
+	'ldap' => '>=0',
+}
+
+# RubyGem specification
+GEMSPEC   = Gem::Specification.new do |gem|
+	gem.name              = PKG_NAME.downcase
+	gem.version           = PKG_VERSION
+
+	gem.summary           = PKG_SUMMARY
+	gem.description       = [
+		"A library for interacting with LDAP (modeled after Sequel). It is an attempt to remove",
+		"the impedence mismatch of trying to treat LDAP as if it's a relational database, and",
+		"instead embrace its hierarchical, free-form nature.",
+  	  ].join( "\n" )
+
+	gem.authors           = "Michael Granger, Mahlon E. Smith"
+	gem.email             = ["ged@FaerieMUD.org", "mahlon@martini.nu"]
+	gem.homepage          = 'http://deveiate.org/projects/Treequel'
+	gem.rubyforge_project = RUBYFORGE_PROJECT
+
+	gem.has_rdoc          = true
+	gem.rdoc_options      = RDOC_OPTIONS
+	gem.extra_rdoc_files  = %w[ChangeLog README LICENSE]
+
+	gem.bindir            = BINDIR.relative_path_from(BASEDIR).to_s
+	gem.executables       = BIN_FILES.select {|pn| File.executable?(pn) }.
+	                            collect {|pn| File.basename(pn) }
+	gem.require_paths << EXTDIR.relative_path_from( BASEDIR ).to_s if EXTDIR.exist?
+
+	if EXTCONF.exist?
+		gem.extensions << EXTCONF.relative_path_from( BASEDIR ).to_s
+	end
+
+	gem.files             = RELEASE_FILES
+	gem.test_files        = SPEC_FILES
+
+	DEPENDENCIES.each do |name, version|
+		version = '>= 0' if version.length.zero?
+		gem.add_runtime_dependency( name, version )
+	end
+
+	# # Developmental dependencies don't work as of RubyGems 1.2.0
+	# unless Gem::Version.new( Gem::RubyGemsVersion ) <= Gem::Version.new( "1.2.0" )
+	# 	DEVELOPMENT_DEPENDENCIES.each do |name, version|
+	# 		version = '>= 0' if version.length.zero?
+	# 		gem.add_development_dependency( name, version )
+	# 	end
+	# end
+	
+	REQUIREMENTS.each do |name, version|
+		gem.requirements << [ name, version ].compact.join(' ')
+	end
+end
+
+$trace = Rake.application.options.trace ? true : false
+$dryrun = Rake.application.options.dryrun ? true : false
+
+
+# Load any remaining task libraries
+RAKE_TASKLIBS.each do |tasklib|
+	next if tasklib.to_s =~ %r{/helpers\.rb$}
+	begin
+		trace "  loading tasklib %s" % [ tasklib ]
+		import tasklib
+	rescue ScriptError => err
+		fail "Task library '%s' failed to load: %s: %s" %
+			[ tasklib, err.class.name, err.message ]
+		trace "Backtrace: \n  " + err.backtrace.join( "\n  " )
+	rescue => err
+		log "Task library '%s' failed to load: %s: %s. Some tasks may not be available." %
+			[ tasklib, err.class.name, err.message ]
+		trace "Backtrace: \n  " + err.backtrace.join( "\n  " )
+	end
+end
+
+# Load any project-specific rules defined in 'Rakefile.local' if it exists
+import LOCAL_RAKEFILE if LOCAL_RAKEFILE.exist?
+
+
+#####################################################################
+###	T A S K S 	
+#####################################################################
+
+### Default task
+task :default  => [:clean, :local, :spec, :rdoc, :package]
+
+### Task the local Rakefile can append to -- no-op by default
+task :local
+
+
+### Task: clean
+CLEAN.include 'coverage'
+CLOBBER.include 'artifacts', 'coverage.info', PKGDIR
+
+### Task: changelog
+file CHANGELOG do |task|
+	log "Updating #{task.name}"
+
+	changelog = make_changelog()
+	File.open( task.name, 'w' ) do |fh|
+		fh.print( changelog )
+	end
+end
+
+
+### Task: cruise (Cruisecontrol task)
+desc "Cruisecontrol build"
+task :cruise => [:clean, 'spec:quiet', :package] do |task|
+	raise "Artifacts dir not set." if ARTIFACTS_DIR.to_s.empty?
+	artifact_dir = ARTIFACTS_DIR.cleanpath + (CC_BUILD_LABEL || Time.now.strftime('%Y%m%d-%T'))
+	artifact_dir.mkpath
+
+	coverage = BASEDIR + 'coverage'
+	if coverage.exist? && coverage.directory?
+		$stderr.puts "Copying coverage stats..."
+		FileUtils.cp_r( 'coverage', artifact_dir )
+	end
+
+	$stderr.puts "Copying packages..."
+	FileUtils.cp_r( FileList['pkg/*'].to_a, artifact_dir )
+end
+
+
+desc "Update the build system to the latest version"
+task :update_build do
+	log "Updating the build system"
+	run 'hg', '-R', RAKE_TASKDIR, 'pull', '-u'
+	log "Updating the Rakefile"
+	sh 'rake', '-f', RAKE_TASKDIR + 'Metarakefile'
+end
+