UcbGroups

Finds users that belong to a given ucb group

Installation

Add this line to your application's Gemfile:

gem 'ucb_groups'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ucb_groups

Usage

First, authenticate:

UcbGroups::LdapConn.authenticate(<username>,  <password>)

Then...

Get list of groups in namespace:

groups = UcbGroups::CampusGroup.find(<namespace>)
=> [CampusGroup, CampusGroup, ...]
group = groups.first
group.id
=> "academic-senate-faculty"
group.name
=> "Academic Senate Faculty"
group.description
=> "All ladder-ranked faculty"
group.namespace
=> "calmessages"

Find people in one or more groups:

finder = UcbGroups::MembershipFinder.new(<namespace>)
people = finder.find(:groups => [grp1, grp2])
=> [Person, Person, Person, ...]
person = people.first
person.uid
=> 666
person.first_name
=> "Joe"
person.last_name
=> "Smith"
person.public_email
=> "[email protected]"
person.official_email
=> "[email protected]"
person.orgs
=> "UCBKL-SCHOL-SCHSW-CSDEP"

Find people in groups and filter by org:

finder = UcbGroups::MembershipFinder.new(<namespace>)
people = finder.find(:groups => [grp1, grp2], :orgs => [:JKASD])
=> [Person, Person, Person, ...]

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request