ucb_ldap 2.0.0.pre1 → 2.0.0.pre3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 80b10ceb4a7cdc53a3f27dd0d6ee6d4c0612ab2a
+  data.tar.gz: b2114b162809fdb4061ae5342590c0e7bb1218a6
+SHA512:
+  metadata.gz: 764e80435a8f6f51ad3e8ad785239b7b460da025901f4c9266b2800dcb5f98c562f9105f5c89f829a9b4e093aaee99bb0a70af3089c48e2042006e7b7d12fe7f
+  data.tar.gz: 1f1a5747a32e69a44d196dcabc7135d02aea586b1876d7cdce079ad908b5fe4dc917c60beb94407f56dd027761aece85d9840753466305dbe4dff2b4c0d58b3e

data/.gitignore

@@ -0,0 +1,21 @@
+*.iml
+*.idea
+.idea
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+spec/binds.yml

data/CHANGELOG

@@ -1,135 +1,137 @@
-= UCB::LDAP Changelog
-
-== Version 2.0.0, April 4, 2012
-* Switch from ruby-net-ldap to net-ldap (UCB::LDAP should now work with ruby-1.9.x)
-
-== Version 1.4.2, August 3, 2010
-* Remove hack that tried to persist the net-ldap connection instance as this cause problems
-with leaving countless file descriptors open when run under JRuby.
-* Updated bundled schema.yml file
-
-== Version 1.2.1, January 22, 2008
-
-* fixed bug: include UCB::LDAP call at top level that corrupted namespace
-* fixed rspec tests to use production ldap server to verify Org structure
-
-
-== Version 1.2.0, September 20, 2007
-
-* fixed UCB::LDAP::Person.student_not_registered? which was broken
-* added support for new entities
-  * Affiliation
-  * Service
-  * StudentTerm
-* added handling of timestamp attributes
-* various additions and clean-up to the various employee_*, student_*, affiliate_* methods 
-  including handling of expiration
-* fetches schema from url rather than file packaged with gem
-* made UCB::LDAP::Person searches exclude test entries by default
-* Rails applications can use UCB::LDAP.bind_for_rails() to get environment-specific binds
-
-== Version 1.1.1, August 2, 2007
-
-* fixed bug around deleting LDAP entries.
-
-== Version 1.1.0, August 1, 2007
-
-* added Org#level_<n>_code and Org#level_<n>_name where <n> is 1-6.  Returns the
-  org node's level "n" code/name
-* added option to Org.flattened_tree() to restrict levels returned.
-
-== Version 1.0.1, July 25, 2007
-
-* do a better job trapping dropped connections in UCB::LDAP.connection_open?
-* added Person#test? to check for test entries
-
-== Version 1.0.0
-
-* got complete schema info for attributes
-* replaced attribute synonyms in favor of explicit methods
-* added support for ldap updates
-* added support for new entities (if your bind supports it):
-  * appointment
-  * address
-
-== Version 0.8.1, May 18, 2007
-
-* added Person#dept_org (synonym for Person#deptid)
-* added Person#dept_name
-
-== Version 0.8.0, April 27, 2007
-
-* added support for privileged binds via UCB::LDAP::authenticate()
-
-== Version 0.7.0, January 16, 2007
-
-* updated: UCB::LDAP::Entry.search to use Net::LDAP::Filter objects: this fixed the
-   problem with embedded whitespace
-* updated UCB::LDAP::Person.person_by_uid() to work with an Integer or a String
-   and UCB::LDAP::Person.persons_by_uids() to work with an Array of Integers or Strings.
-* updated: UCB::LDAP::Person.student? to utilize the new LDAP v2 ou structure
-* added: UCB::LDAP::Person.student_registered?, UCB::LDAP::Person.student_not_registered?
-* deprecated: UCB::LDAP::Person.student_summer?, UCB::LDAP::Person.student_summer_only?,
-   UCB::LDAP::Person.spring?, UCB::LDAP::Person.fall?. Except for UCB::LDAP::Person.student_summer_only?,
-   these methods may be added in later versions of UCB::LDAP::Person.  Note: accessing these 
-   attributes will required a privileged bind.
- * changed UCB::LDAP::Entry to only allow filter options in hash form: :filter => {:uid => 12345}
- * updated documentations
- * updated unit tests. 
-
-== Version 0.6.0, January 10, 2007
-
-* Added loading/caching of all nodes
-* Added calculation of all child nodes
-* Added UCB::LDAP::Org.flattened_tree()
-* Added UCB::LDAP::Person.org_node()
-
-== Version 0.5.0, December 20, 2006
-
-* Added following methods to Org:
-  * child_nodes
-  * parent_node
-  * parent_nodes
-  * persons
-  
-== Version 0.4.0, December 14, 2006
-
-* Added Person.persons_by_uids to return array of Person for given
-  array of uids.
-* Changed implementation of Person.person_by_uid to use new Person.persons_by_uid.
-
-== Version 0.3.1, December 13, 2006
-
-* Added SchemaAttribute class and methods to load schema
-  attributes in UCB::LDAP.  Did not make use of the schema
-  attributes.
-  
-== Version 0.3.0, October 20, 2006
-
-* Moved to SVN
-* Reorganized doc directory
-
-== Version 0.2.2, October 12, 2006
-
-* Made more "booleans" actually return <tt>true</tt> and <tt>false</tt>
-  rather than expressions that evaluate to <tt>true</tt> and <tt>false</tt>.
-  
-* Added TODO[link:files/TODO.html].
-
-* Some documentation updates.  
-
-== Version 0.2.1, October 10, 2006
-
-* Changed module name and namespace from UcbLdap to UCB::LDAP.
-* Fixed so UCB::LDAP::Entry and subclasses can be marshalled,
-  otherwise can't store in a Rails session.
-
-== Version 0.2.0, October 9, 2006
-
-* Packaged as a Ruby Gem.
-* Converted underlying code to use Net::LDAP instead of LDAP.
-* Added support for searching the org unit tree.
-
-== Version 0.1.0, October 5, 2006
-
-* Initial release.
+# UCB::LDAP Changelog
+
+## Version 2.0.0.pre3, June 8, 2013
+* Reorganize file layout
+* Fix bug where credentials get switched when building org tree
+* Update default ldap hosts to new ldap host names
+
+## Version 2.0.0.pre1, April 4, 2012
+* Switch from ruby-net-ldap to net-ldap (`UCB::LDAP` should now work with ruby-1.9.x)
+
+## Version 1.4.2, August 3, 2010
+* Remove hack that tried to persist the net-ldap connection instance as this cause problems
+with leaving countless file descriptors open when run under JRuby.
+* Updated bundled schema.yml file
+
+## Version 1.2.1, January 22, 2008
+
+* fixed bug: include `UCB::LDAP` call at top level that corrupted namespace
+* fixed rspec tests to use production ldap server to verify Org structure
+
+
+## Version 1.2.0, September 20, 2007
+
+* fixed `UCB::LDAP::Person.student_not_registered?` which was broken
+* added support for new entities
+  * Affiliation
+  * Service
+  * StudentTerm
+* added handling of timestamp attributes
+* various additions and clean-up to the various employee_*, student_*, affiliate_* methods
+  including handling of expiration
+* fetches schema from url rather than file packaged with gem
+* made `UCB::LDAP::Person` searches exclude test entries by default
+* Rails applications can use `UCB::LDAP.bind_for_rails` to get environment-specific binds
+
+## Version 1.1.1, August 2, 2007
+
+* fixed bug around deleting LDAP entries.
+
+## Version 1.1.0, August 1, 2007
+
+* added Org#level_<n>_code and Org#level_<n>_name where <n> is 1-6.  Returns the
+  org node's level "n" code/name
+* added option to Org.flattened_tree() to restrict levels returned.
+
+## Version 1.0.1, July 25, 2007
+
+* do a better job trapping dropped connections in UCB::LDAP.connection_open?
+* added Person#test? to check for test entries
+
+## Version 1.0.0
+
+* got complete schema info for attributes
+* replaced attribute synonyms in favor of explicit methods
+* added support for ldap updates
+* added support for new entities (if your bind supports it):
+  * appointment
+  * address
+
+## Version 0.8.1, May 18, 2007
+
+* added Person#dept_org (synonym for Person#deptid)
+* added Person#dept_name
+
+## Version 0.8.0, April 27, 2007
+
+* added support for privileged binds via UCB::LDAP::authenticate()
+
+## Version 0.7.0, January 16, 2007
+
+* updated: UCB::LDAP::Entry.search to use Net::LDAP::Filter objects: this fixed the
+   problem with embedded whitespace
+* updated UCB::LDAP::Person.person_by_uid() to work with an Integer or a String
+   and UCB::LDAP::Person.persons_by_uids() to work with an Array of Integers or Strings.
+* updated: UCB::LDAP::Person.student? to utilize the new LDAP v2 ou structure
+* added: UCB::LDAP::Person.student_registered?, UCB::LDAP::Person.student_not_registered?
+* deprecated: UCB::LDAP::Person.student_summer?, UCB::LDAP::Person.student_summer_only?,
+   UCB::LDAP::Person.spring?, UCB::LDAP::Person.fall?. Except for UCB::LDAP::Person.student_summer_only?,
+   these methods may be added in later versions of UCB::LDAP::Person.  Note: accessing these
+   attributes will required a privileged bind.
+ * changed UCB::LDAP::Entry to only allow filter options in hash form: :filter => {:uid => 12345}
+ * updated documentations
+ * updated unit tests.
+
+## Version 0.6.0, January 10, 2007
+
+* Added loading/caching of all nodes
+* Added calculation of all child nodes
+* Added UCB::LDAP::Org.flattened_tree()
+* Added UCB::LDAP::Person.org_node()
+
+## Version 0.5.0, December 20, 2006
+
+* Added following methods to Org:
+  * child_nodes
+  * parent_node
+  * parent_nodes
+  * persons
+
+## Version 0.4.0, December 14, 2006
+
+* Added Person.persons_by_uids to return array of Person for given
+  array of uids.
+* Changed implementation of Person.person_by_uid to use new Person.persons_by_uid.
+
+## Version 0.3.1, December 13, 2006
+
+* Added SchemaAttribute class and methods to load schema
+  attributes in UCB::LDAP.  Did not make use of the schema
+  attributes.
+
+## Version 0.3.0, October 20, 2006
+
+* Moved to SVN
+* Reorganized doc directory
+
+## Version 0.2.2, October 12, 2006
+
+* Made more "booleans" actually return <tt>true</tt> and <tt>false</tt>
+  rather than expressions that evaluate to <tt>true</tt> and <tt>false</tt>.
+* Some documentation updates.
+
+## Version 0.2.1, October 10, 2006
+
+* Changed module name and namespace from UcbLdap to UCB::LDAP.
+* Fixed so UCB::LDAP::Entry and subclasses can be marshalled,
+  otherwise can't store in a Rails session.
+
+## Version 0.2.0, October 9, 2006
+
+* Packaged as a Ruby Gem.
+* Converted underlying code to use Net::LDAP instead of LDAP.
+* Added support for searching the org unit tree.
+
+## Version 0.1.0, October 5, 2006
+
+* Initial release.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ucb_ldap.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 sahglie
+
+MIT License
+
+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.

data/{README → README.md}

@@ -1,80 +1,82 @@
-=UC Berkeley LDAP
-
-UCB::LDAP is a wrapper module around Net::LDAP intended to simplify searching the UC Berkeley 
-LDAP directory: http://directory.berkeley.edu
-
-==Introduction to LDAP
-If you are blissfully ignorant of LDAP, you should familiarize yourself with some of the basics.
-Here is a great online resource: http://www.zytrax.com/books/ldap
-
-The RDoc for the ruby-net-ldap Gem (http://rubyfurnace.com/docs/ruby-net-ldap-0.0.4/classes/Net/LDAP.html) also has a good introduction to LDAP. 
-
-
-==Examples
-
-===General Search
-
-Search the directory specifying tree base and
-filter, getting back generic UCB::LDAP::Entry instances:
-
-  entries = UCB::LDAP.search(:base => "ou=people,dc=berkeley,dc=edu", :filter => {:uid => 123}
-
-  entry.uid             #=> '123'
-  entry.givenname       #=> 'John'
-  entry.sn              #=> 'Doe'
-
-See UCB::LDAP::Entry for more information.
-
-===Person Search
-
-Search the Person tree getting back UCB::LDAP::Person instances:
-
-  person = UCB::LDAP::Person.find_by_uid("123")
-  
-  person.firstname           #=> "John"
-  person.affiliations        #=> ['EMPLOYEE-TYPE-STAFF']
-  person.employee?           #=> true
-  person.employee_staff?     #=> true
-  person.employee_academic?  #=> false
-  person.student?            #=> false
-
-See UCB::LDAP::Person for more information.
-
-===Org Unit Search
-
-Search the Org Unit tree getting back UCB::LDAP::Org instances:
-
-  dept = UCB::LDAP::Org.org_by_ou 'jkasd'
-  
-  dept.deptid         #=> "JKASD"
-  dept.name           #=> "Administrative Systems Dept"
-
-See UCB::LDAP::Org for more information.
-
-===Privileged Binds
-
-If you want access the directory anonomously, no credentials are required.
-If you want to access via a privileged bind, authenticate before querying:
-
-  p = UCB::LDAP::Person.find_by_uid("123")
-  p.non_public_attr    #=> NoMethodError
-  
-  UCB::LDAP.authenticate("mybind", "mypassword")
-  p = UCB::LDAP::Person.find_by_uid("123")
-  p.non_public_attr    #=> "some value"
-  
-=== Privileged Binds and Rails
-
-See UCB::LDAP.bind_for_rails()
-
-==Dependencies
-
-* Net::LDAP
-* Ruby 1.8.5 or better
-
-==Authors
-
-Steven Hansen runner@berkeley.edu
-Lucas Rockwell
-Steve Downey
-
+#UC Berkeley LDAP
+
+UCB::LDAP is a wrapper module around Net::LDAP intended to simplify searching the UC Berkeley
+LDAP directory: http://directory.berkeley.edu
+
+##Introduction to LDAP
+If you are blissfully ignorant of LDAP, you should familiarize yourself with some of the basics.
+Here is a great online resource: http://www.zytrax.com/books/ldap
+
+The RDoc for the ruby-net-ldap Gem (http://rubyfurnace.com/docs/ruby-net-ldap-0.0.4/classes/Net/LDAP.html) also has a good introduction to LDAP.
+
+
+##Examples
+
+###General Search
+
+Search the directory specifying tree base and filter, getting back generic `UCB::LDAP::Entry` instances:
+
+```ruby
+  entries = UCB::LDAP.search(:base => "ou=people,dc=berkeley,dc=edu", :filter => {:uid => 123})
+  entry.uid             #=> '123'
+  entry.givenname       #=> 'John'
+  entry.sn              #=> 'Doe'
+```
+
+See `UCB::LDAP::Entry` for more information.
+
+###Person Search
+
+Search the Person tree getting back UCB::LDAP::Person instances:
+
+```ruby
+  person = UCB::LDAP::Person.find_by_uid("123")
+  person.firstname           #=> "John"
+  person.affiliations        #=> ['EMPLOYEE-TYPE-STAFF']
+  person.employee?           #=> true
+  person.employee_staff?     #=> true
+  person.employee_academic?  #=> false
+  person.student?            #=> false
+```
+
+See `UCB::LDAP::Person` for more information.
+
+###Org Unit Search
+
+Search the Org Unit tree getting back `UCB::LDAP::Org` instances:
+
+``` ruby
+  dept = UCB::LDAP::Org.org_by_ou('jkasd')
+  dept.deptid         #=> "JKASD"
+  dept.name           #=> "Administrative Systems Dept"
+```
+
+See `UCB::LDAP::Org` for more information.
+
+###Privileged Binds
+
+If you want access the directory anonymously, no credentials are required.
+If you want to access via a privileged bind, authenticate before querying:
+
+```ruby
+  p = UCB::LDAP::Person.find_by_uid("123")
+  p.non_public_attr    #=> NoMethodError
+
+  UCB::LDAP.authenticate("mybind", "mypassword")
+  p = UCB::LDAP::Person.find_by_uid("123")
+  p.non_public_attr    #=> "some value"
+```
+
+###Privileged Binds and Rails
+
+See `UCB::LDAP.bind_for_rails`
+
+##Dependencies
+
+* Net::LDAP
+* Ruby 1.9.2 or better
+
+##Maintainers
+
+* Steven Hansen
+* Steve Downey