Skip to content
Ruby lib for fetching public Yahoo group data
Ruby
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
test
.gitignore
.travis.yml
Gemfile
LICENSE
README.md
Rakefile
yahoo-group-data.gemspec

README.md

Build Status

yahoo-group-data gem

Yahoo doesn't provide an API to it's publicly available group info, so this gem covers that gap. Use it to find information about a Yahoo group such as name, description and relevant email addresses.

Example

require 'yahoo-group-data'

g = YahooGroupData.new("http://tech.groups.yahoo.com/group/OneStopCOBOL/")

name = g.name
description = g.description
num_members = g.num_members

p = g.post_email
s = g.subscribe_email
u = g.unsubscribe_email
o = g.unsubscribe_email

json = g.to_json

Available instance methods

These should be relatively self-explanatory. Where the data is unnavailable (for instance the group name if no group was found) the return value will be nil

Boolean values:

  • not_found?
  • private?
  • age_restricted?
  • no_data? (true if any of the above are true, othersise false. Here for convenience)

String values

  • name
  • description
  • post_email
  • subscribe_email
  • owner_email
  • unsubscribe_email
  • language
  • category
  • to_json

Other values

  • num_members (Integer)
  • founded (Date)

Requirements

It's tested with Ruby 1.9.3, it probably works with older versions.

Installation

Add this line to your application's Gemfile:

gem 'yahoo-group-data'

And then execute:

$ bundle

Or install it yourself as:

$ gem install yahoo-group-data

Contributing

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

pull requests with tests are more likely to be accepted

Testing

Rather than distribute a load of Yahoo's HTML pages with the gem there's a rake task to get the ones that are needed. Run:

$ rake fetch_yahoo_pages

after that:

$ rake test

Because of the dynamic nature of Yahoo groups it's quite possible that the number of members a group has in groups.yml will have diverged with the number of members in reality when you pull down the pages using "rake fetch_yahoo_pages". If you see any of these divergences just update groups.yml appropriately.

If you find a group the gem fails on

Tell me about it, or (in preference) update the gem (Hint: start by adding an entry to the groups.yml file), see contributing instructions above.

Authors

Something went wrong with that request. Please try again.