= muddyit_fu

== Installation

  sudo gem install gemcutter
  sudo gem tumble
  sudo gem install muddyit_fu

== Getting started

muddy.it uses oauth to manage it's api access. 

See http://blog.muddy.it/2009/11/getting-started-with-muddy for details on how to
use the API.

== Example muddyit.yml

  ---
  consumer_key: "YOUR_CONSUMER_KEY"
  consumer_secret: "YOUR_CONSUMER_SECRET"
  access_token: "YOUR_ACCESS_TOKEN"
  access_token_secret: "YOUR_ACCESS_TOKEN_SECRET"

== Retrieving all sites

  require 'muddyit_fu'
  muddyit = Muddyit.new('muddyit.yml')
  muddyit.sites.find(:all).each do |site|
    puts "#{site.label} : #{site.token}"
  end

== Retrieving a single site

  require 'muddyit_fu'
  muddyit = Muddyit.new('muddyit.yml')
  puts muddyit.sites.find('a0ret4').label

== Categorisation request

  require 'muddyit_fu'
  muddyit = Muddyit.new('muddyit.yml')
  site = muddyit.sites.first
  site.pages.create({:uri => 'http://news.bbc.co.uk/1/hi/uk_politics/8011321.stm'}, {:minium_confidence => 0.2})

== View categorised pages

  require 'muddyit_fu'
  muddyit =  Muddyit.new(:consumer_key => 'aaa',
                         :consumer_secret => 'bbb',
                         :access_token => 'ccc',
                         :access_token_secret => 'ddd')
  site = muddyit.sites.first
  site.pages.find(:all) do |page|
    puts page.title
    page.entities.each do |entity|
      puts entity.uri
    end
  end

== View all pages containing 'Gordon Brown'

  require 'muddyit_fu'
  muddyit = Muddyit.new('muddyit.yml')
  site = muddyit.sites.find(:all).first
  site.pages.find_by_entity('http://dbpedia.org/resource/Gordon_Brown') do |page|
    puts page.identifier
  end

== Find related entities for 'Gordon Brown'

  require 'muddyit_fu'
  muddyit = Muddyit.new('muddyit.yml')
  site = muddyit.sites.find(:all).first
  puts "Related entity\tOccurance
  site.entities.find_related('http://dbpedia.org/resource/Gordon_Brown').each do |entry|
    puts "#{entry[:enity].uri}\t#{entry[:count]}"
  end

== Find related content for : http://news.bbc.co.uk/1/hi/uk_politics/7878418.stm

  require 'muddyit_fu'
  muddyit = Muddyit.new('muddyit.yml')
  site = muddyit.sites.find(:all).first
  page = site.pages.find(:all, :uri => 'http://news.bbc.co.uk/1/hi/uk_politics/7878418.stm').first
  puts "Our page : #{page.title}\n\n"
  page.related_content.each do |results|
    puts "#{results[:page].title} #{results[:count]}"
  end

== Contact

  Author: Rob Lee
  Email: support [at] muddy.it
  Main Repository: http://github.com/rattle/muddyit_fu/tree/master