tRuTag 0.5.0

data/bin/makecloud.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/ruby
+# tRuTag
+# Distributed under the Ruby License
+# http://trutag.rubyforge.org
+# written by: Jamal Hansen jh@rubyyot.com
+
+# this script creates the tag cloud webpage from the tRuTag classes
+
+require 'tRuTag_full'
+
+outputfile = Trutag::find_home + "/tRuTagcloud.html"
+
+output_to_file = TRUE
+
+offline_mode = FALSE
+run_config = FALSE
+		
+# Parse our arguments
+if /-.*/.match(ARGV[0]) then
+	x = ARGV.shift
+	offline_mode = /.*o.*/i.match(x) != nil
+	run_config  = /.*c.*/i.match(x) != nil
+end
+	
+# read our config file
+params = Trutag::get_params_from_yaml(run_config)	
+	
+params['websites'].each_value { | v | 
+	v['isoffline']=offline_mode}
+
+output = Trutag::buildpage(params['websites'], !params['store_pwd'], params['style'])
+
+if params.fetch('output_to_file', TRUE)
+	f = File.new(params.fetch('output_file', outputfile), "w") 
+	f.print output
+	f.close
+	puts "Done."
+else
+	$stdout.print output
+end
+
+
+

data/bin/makecloudfromarray.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby
+# tRuTag
+# Distributed under the Ruby License
+# http://trutag.rubyforge.org
+# written by: Jamal Hansen jh@rubyyot.com
+
+# this script creates the tag cloud from the tRuTag classes
+# is is an example of a more lightweight applciation of tRuTag.
+# You will need to replace YOUR_USERNAME and YOUR_PWD with valid values
+
+require 'tRuTag'
+
+profiles = Hash.new
+
+# You can remove any of these lines or add them as you wish.
+profiles['43Things']={ 'type' => '43Things', 'username' => 'jh'}
+profiles['Unalog']={ 'type' => 'Yahoo2', 'username' => 'jh'}
+#profiles['Delicious']={ 'type' => 'Delicious', 'username' => 'YOUR_USERNAME', 'pwd' => 'YOUR_PWD'}
+
+profiles.each_value { |x| 
+	if x['username'] == 'YOUR_USERNAME'
+		raise(ArgumentError, "Please replace username and password with valid values.")
+	end}
+
+# This tells trutag where to link to when you click on the tag cloud
+profiles['target']={ 'type' => 'target', :controller => 'tag', :action => 'tag_click', :url => 'http://rubyyot.com'}
+
+# This script just spits it out.  If you want to see it in use look at http://rubyyot.com/tag
+$stdout.print Trutag::create_tag_cloud_for_rails_site(profiles)
+

data/css/tRuTag.css

@@ -0,0 +1,35 @@
+body {font-family:  helvetica, arial, sans-serif; font-size: 12px;}
+a:link, a:visited {color: #511;}
+#about {font-family: monospace;  font-size: 12px; color: #fee; background-color: #511;}
+#google {font-family: arial;  font-size: 16px;}
+#about a:link, a:visited {color: #bbf;}
+#site_select {position: absolute; top: 10px; left: 82%;}
+H2 {font-family: "Century Schoolbook L", serif;  font-size: 16px;}
+#cloud {border-right:2px dashed #000; width: 80%;}
+span.level0 { font-size: 10px; line-height:15px;}
+span.level1 { font-size: 12px; line-height:17px;}
+span.level2 { font-size: 14px; line-height:19px;}
+span.level3 { font-size: 16px; line-height:21px;}
+span.level4 { font-size: 18px; line-height:23px;}
+span.level5 { font-size: 20px; line-height:25px;}
+span.level6 { font-size: 22px; line-height:27px;}
+span.level7 { font-size: 24px; line-height:29px;}
+span.level8 { font-size: 26px; line-height:31px;}
+span.level9 { font-size: 28px; line-height:33px;}
+span.level10 { font-size: 30px; line-height:35px;}
+span.level11 { font-size: 32px; line-height:37px;}
+span.level12 { font-size: 34px; line-height:39px;}
+span.level13 { font-size: 36px; line-height:41px;}
+span.level14 { font-size: 36px; line-height:41px;}
+span.level15 { font-size: 36px; line-height:41px;}
+span.level16 { font-size: 36px; line-height:41px;}
+span.level17 { font-size: 36px; line-height:41px;}
+span.level18 { font-size: 36px; line-height:41px;}
+span.level19 { font-size: 38px; line-height:43px;}
+span.level20 { font-size: 40px; line-height:35px;}
+span.level21 { font-size: 42px; line-height:37px;}
+span.level22 { font-size: 44px; line-height:39px;}
+span.level23 { font-size: 46px; line-height:41px;}
+span.level24 { font-size: 48px; line-height:42px;}
+span.level25 { font-size: 50px; line-height:43px;}
+span a:hover {color: #000; background-color: #fee;}

data/doc/LICENSE.txt

@@ -0,0 +1,57 @@
+tRuTag is copyrighted free software by Jamal Hansen <jamal.hansen@gmail.com>.
+You can redistribute it and/or modify it under either the terms of the GPL, or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+	  with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory.  See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+

data/doc/README.txt

@@ -0,0 +1,100 @@
+tRuTag - The taggregator
+By: Jamal Hansen
+License: Ruby license
+Email: jh[at]rubyyot.com
+url: http://trutag.rubyforge.org
+
+
+What do I need?
+tRuTag is written in Ruby, so you will need to be able to run Ruby scripts.  If you are not able to run Ruby scripts or would like to know more about this scripting language you can find the information here: http://www.ruby-lang.org.  Otherwise you will need a computer with an Internet connection and a user account with at least one of the supported sites.  tRuTag has full support for del.icio.us, 43Things.com and other popular tag based sites.
+
+How to I run it?
+Well, once you have Ruby, to install tRuTag simply go to your commandline and type:
+gem install tRuTag
+to run the basic script run:
+makecloud.rb
+
+What is it?
+tRuTag was something I wrote because I was interested in tags and meta data, but was frustrated because tags end up clustered in a single site.  It is difficult to break out of that site and look at the whole internet.  I think that the whole purpose of tagging things is to be able to group them not by site, but by idea.
+
+What sites are supported?
+Well there are two types of support offered by tRuTag.  The first is Input/Output, which means that if you supply the necessary information tRuTag will retrieve your tags and let you look up tags on the site.  These sites as of v0.3 are:
+
+Site			Input Required
+======================================================================
+43things.com		username
+43places.com		username
+del.icio.us		username, password
+Jots.com		username, password
+Yahoo! My Web 2.0	username
+Dinnerbuzz.com		username
+Tagzania.com		username
+Unalog			username
+Flickr			username
+
+Also supported are the internationalized versions of 43Things which are
+
+Site			Input Required
+======================================================================
+Cosas43.com		username
+Cose43.com		username
+Choses43.com		username
+Dinge43.com		username
+Coisas43.com		username
+
+
+The second type of support is on the output page.  If you have an entry in your config file for a site without user information it will include the site in the options for the tag cloud output.  These sites as of v0.3 include all of the input sites and:
+
+Site
+======================================================================
+AllConsuming.net
+Technorati
+Photobucket
+Google
+Simpy
+Blinklist.com
+Furl (you will need to log in manually)
+GutenTag (creative-mobs.com)
+Hatena (b.hatena.ne.jp)
+Del.irio.us 
+Webshots (s.phpspot.org)	
+Livemark.jp
+Podcast.net
+Upcoming.org
+Colr.org
+TagCentral
+Consumating
+Blogmarks
+Wists
+SmugMug
+Foundcity
+Swik
+
+What does it do?
+tRuTag will aggregate the tags from your accounts on various websites.  tRuTag will then generate a webpage (I use it as my homepage) that contains a tag cloud of all your tags from all your sites.  You can then choose your target site (the input sites and others including Technocrati.com and Google are available) and click on the desired tag and be taken to the tag page for the site you selected.
+
+How do I config?
+As of this version a config script is run if one does not already exist.  You will see it the first time you run makecloud.rb.  It will be created in your home directory as .tRuTag.  As I run a Linux system, I'm not sure exactly where that will be under windows.  If you would like to run config again simply run makecloud with the -c option
+
+Passwords
+Passwords are a sensitive issue and one that I did not want to take lightly.  If you decide to use a website that needs a password (del.icio.us, Jots) you have options available to you.
+
+1) Save them to your config file.  You will be prompted for this option in the config script.
+2) Omit them from your config file and be prompted for them when you run makecloud.rb
+3) Omit them from your config file and pass them in as command line arguments.  If you enter them manually a couple times, you will know the order they are in simply pas them in as arguments to makecloud.rb.
+4) If you are using tRuTag in your own application you can pass in the passwords directly.  See makecloudfromarray for an example.
+
+
+Options
+There are 2 command line options available for makecloud.rb.  If you use an argument that is not preceeded with a '-' it will assume that you are passing it passwords to your sites.
+
+-o is offline mode and it will look for XML tag files on another location.  This is really for advanced use only
+-c will run the config script before generating the file.
+
+Acknowledgements
+To my wife and kids for letting me spend hours at a time on the PC.
+To everyone downloading this script and writing about it in your blogs.
+To Pat Eyler for r43 and listening to stupid questions.  
+To Scott Raymond for flickr.
+
+I hope this explains the script.  If you have questions or problems please feel free to email me: jh[at]rubyyot.com

data/doc/RoRwrapper

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby
+# tRuTag
+# Distributed under the Ruby License
+# http://trutag.rubyforge.org
+# written by: Jamal Hansen <jh@rubyyot.com>
+
+# Wrapper for RoR, add this code to app\helpers\application_helper.rb
+
+module ApplicationHelper
+	require 'tRuTag'
+	
+	def self.append_features(controller)
+		controller.ancestors.include?(ActionController::Base) ?
+			controller.add_template_helper(self) : super
+	end
+	
+	def build_trutag_cloud(profile_array, outputClass)
+		# hash_array is an array of hashes for instance to use Yahoo2 and del.icio.us you would use
+		# @profiles = Array.new()
+		# @profiles.push Profiles.new({ 'type' => 'Yahoo2', 'username' => 'YOUR_USER_NAME'})
+		# @profiles.push Profiles.new({ 'type' => 'Delicious', 'username' => 'YOUR_USER_NAME', 'pwd' => 'YOUR_PASSWORD'})
+		
+		Trutag::create_tag_cloud_for_site(profiles, Profile.new({ 'type' => outputClass }))
+	end
+	
+	def get_trutag_about(div_id)
+		Trutag.getAbout(div_id)
+	end
+end

data/lib/tRuTag.rb

@@ -0,0 +1,413 @@
+#!/usr/bin/ruby
+# tRuTag
+# Distributed under the Ruby License
+# http://trutag.rubyforge.org
+# written by: Jamal Hansen jh@rubyyot.com
+
+
+require 'net/http'
+require 'rexml/document'
+require 'xmlrpc/client'
+require 'cgi'
+require 'rubygems'
+require 'yaml'
+	
+module Trutag
+	$version = "0.5.0"
+	$agent = "tRuTag v" + $version
+	
+	#This is the default user config file
+	$configfile='.tRuTag'
+	# This this determines how quickly the scale of the font is increased in the css
+	$css_level_ratio = 5
+	$css_level_max = 25
+	# This is the default url
+	$default_url = "#"
+	$offline=FALSE
+	$websites_file=File.dirname(__FILE__) + '/websites.yml'
+
+	def Trutag::get_profile(classname)
+		if classname == "" || classname == nil
+			classname ='Technorati'
+		end
+		
+		Profile.new({ "type" => classname })
+	end
+	
+	def Trutag::create_tag_cloud_for_rails_site(params)
+		tbin=Hash.new()
+		sites = YAML::load(File.open($websites_file))
+		params.each { | k, i | 
+		if k != 'target' then
+			#This should be a hash of site data such as :
+			#{ 'type' => 'Delicious', 'username' => 'foo', 'pwd' => 'bar' }
+			if !sites.has_key?(k)
+				loggit(2, %{no entry for #{k} in websites.yml})
+			end
+		
+			i.update(sites[k])
+			i['tbin']=tbin	
+			Profile.new(i)
+		end }
+		
+		# Now we should have a hash of all of our tags.  Let make it happen!
+		Trutag.make_rails_cloud_from_tag_hash(tbin, params['target'])
+	end
+
+	def Trutag::make_rails_cloud_from_tag_hash(tbin, target)
+		output = ""
+		tbin.each { | key, value | 
+			output << TagCloudMaker.all_tags_rails_href(key, value, target)}
+		output
+	end
+
+	
+	def Trutag::getAbout(div_id)
+		TagCloudMaker.about(div_id)
+	end
+	
+	def Trutag::loggit(severity, message)
+		severities=['message', 'warning', 'error']
+		
+		if message != ""
+			$stderr.print %{tRuTag #{severities[severity]}: #{message}\n\tDescription:#{$!}\n}
+		else
+			$stderr.print %{tRuTag #{severities[severity]}: #{$!}\n}
+		end
+	end
+end
+
+	
+class TagCloudMaker	
+	def TagCloudMaker.tag(name, other)
+		%{<#{name}#{other}>#{yield}</#{name}>}
+	end
+	
+	def TagCloudMaker.all_tags_rails_href(tag, count, phash)
+		if phash.has_key?(:url)
+			addStyle(tag, count, phash) {%{<a href="#{phash[:url]}/#{phash[:controller]}/#{phash[:action]}/#{CGI.escapeElement(tag)}" title="#{tag} : #{count} tag(s)" rel="tag">#{tag}</a>}}
+		else
+			addStyle(tag, count, phash) {%{<a href="##{tag}" onclick="go('#{tag}')" title="#{tag} : #{count} tag(s)">#{tag}</a>}}
+		end
+	end
+	
+	def TagCloudMaker.addStyle(tag, count, phash)
+		style = phash.fetch('style', 'cloud')
+		
+		case style
+			when 'sun'
+				%{<span class="level#{TagCloudMaker.find_level(count)}" style="position: absolute; left:#{Integer((rand*9) * (rand*9))}%; top:#{Integer((rand*10) * (rand*10))}%;">#{yield}</span> }
+			when 'pile'
+				%{<span class="level#{TagCloudMaker.find_level(count)}" style="position: absolute; left:#{Integer((rand*20) + (rand*20) + (rand*20) + (rand*20))}%; top:#{Integer((rand*20) + (rand*20) + (rand*20) + (rand*20) + (rand*20))}%;">#{yield}</span> }
+			when 'pile'
+				%{<span class="level#{TagCloudMaker.find_level(count)}" style="position: absolute; left:#{Integer((rand*20) + (rand*20) + (rand*20) + (rand*20))}%; top:#{Integer((rand*20) + (rand*20) + (rand*20) + (rand*20) + (rand*20))}%;">#{yield}</span> }
+			else
+				%{<span class="level#{TagCloudMaker.find_level(count)}">#{yield}</span> }	
+		end			
+	end
+
+	def TagCloudMaker.find_level(count)
+		out = Integer(count)./($css_level_ratio)
+		if out > $css_level_max
+			out = $css_level_max
+		end
+		String (out)
+	end
+
+	def TagCloudMaker.space_to_plus(input, space_replacement)
+		input.gsub(/ /, space_replacement)
+	end
+	
+	def TagCloudMaker.about(div_id)
+		%{<div id="#{div_id}"><H2>About</H2>This page was created with the help of <a href="http://tRuTag.rubyforge.org">#{$agent}</a> an open source project created by <a href="mailto:jh[at]rubyyot[dot]com">Jamal Hansen</div>}
+	end
+end
+
+class Profile
+	# To create a profile object you will need to pass in a hash containing the following:
+	# type: classname of the corresponding site
+	# username: username if this is for input
+	# pwd: if it is necessary for the site.
+	# offline: (optional) The XML file to use instad of the URL
+	attr_reader :tbin
+	
+	def initialize(prohash)
+		begin
+			# Funny I think this started as a case statement and then went to a const_get now it's a case statement again.
+			# In any case this is creating the Site object based on the data passed to us.
+			case prohash['type'] 
+				when '43Things', '43Cosas', '43Cose', '43Choses', '43Dinge', '43Coisas'
+					@site = RobotCoop.new(prohash)	
+				when 'Yahoo2'
+					@site = Y2.new(prohash)
+				when 'Jots'
+					@site = Jts.new(prohash)
+				when 'Flickr'
+					@site = Flkr.new(prohash)
+				else
+					@site = Site.new(prohash)
+			end
+		rescue ArgumentError
+			Trutag::loggit(2, %{#{$!}})
+		end	
+				
+		if prohash.fetch('mode', 0) == 1
+			begin
+				add_tags(prohash['tbin'])
+			rescue SocketError
+				Trutag::loggit(2, %{IO failed: #{@site.attrib['sitename']}})
+			rescue Timeout::Error
+				Trutag::loggit(2, %{Timeout:#{@site.attrib['sitename']}})	
+			rescue
+				Trutag::loggit(2, %{})	
+			end
+		end
+	end
+	
+	def space_replace(tag)
+		TagCloudMaker.space_to_plus(tag, @site.attrib['space_replacement'])
+	end
+	
+	def add_tags(tbin)
+		if tbin == nil
+			tbin = Hash.new
+		end
+		
+		begin
+			@site.add_tags(tbin)
+		rescue SocketError
+			Trutag::loggit(2, %{IO failed: #{@site.attrib['sitename']} #{$!}})
+		end
+	end
+	
+	def base_all_tags_url
+		%{http://#{@site.attrib['url']}#{@site.attrib['all_tags_path']}} 
+	end
+	
+
+	def method_missing( name, *args )
+		begin
+			@site.__send__( name, *args )
+		rescue NoMethodError
+			Trutag::loggit(1, %{Could not find method Site.#{name}})
+		end
+	end
+end
+
+class Site
+	# This is a base class, you will want to instantiate a class that inherits from site.
+	#
+	# To create a site object you will need to pass in a hash containing the following:
+	# username: username if this is for input
+	# pwd: if it is necessary for the site.
+	# offline: (optional) The XML file to use instad of the URL
+	
+	attr_reader :attrib
+	
+	def initialize(params)
+		#$stderr.print params['sitename'] + "\n"
+		params.delete_if{ | k, v | v=="" || v==nil }	 
+
+		
+		@attrib={ 'url' => %{www.#{params['sitename']}.com}, 'validcode' => %{200},
+				 'needsauth' => %{401}, 'all_tags_path' => %{/tag/}, 'all_tags_path_post_tag' => "",
+				 'xmlelement' => %{feed/tags/tag}, 'space_replacement' => '+'}
+			
+		@attrib.update(params)		
+		
+		#$stderr.print(%{#{@attrib['sitename']} is using #{self.class} })
+	end
+	
+	def add_tags(tbin)
+		required_attribute('username')
+		required_attribute('tag_api_page')
+		required_attribute('xmlelement')
+		required_attribute('parse_tags')
+
+		#get the UML
+		uml_page=get_uml
+						
+		#parse the UML
+		begin
+			doc=REXML::Document.new uml_page
+		rescue Exception, REXML::ParseException
+			Trutag::loggit(2, %{Error parsing XML from: #{@attrib['sitename']}})				
+		end
+		
+		if doc != nil
+			# parse tags is found in websites.yml
+			# example ofthe string parsetags: {tbin[@attrib['tel'].text.downcase] = tbin.fetch(@attrib['tel'].text.downcase, 0) + Integer(@attrib['tel'].attributes['count'])}
+			# Ruby rocks!
+			
+			doc.elements.each(@attrib['xmlelement']) do |element|
+			eval @attrib['parse_tags']
+			end
+		end
+	end
+	
+	def get_uml
+		if  @attrib.fetch('isoffline', FALSE)
+			if @attrib.has_key?('offline')
+				if File.exist?(@attrib['offline'])
+					data = File.open(@attrib['offline'], "r") 
+				else
+					Trutag::loggit(1, %{#@attrib['offline'] does not exist})
+				end
+			else
+				Trutag::loggit(0, %{No offline file configured for class: #{self.class}})			
+			end
+		else
+			required_attribute('url')
+			required_attribute('needsauth')
+			required_attribute('validcode')
+			required_attribute('username')	
+			required_attribute('tag_api_page')
+			
+			data = Net::HTTP.start(@attrib['url']) { |http|
+				subpage = @attrib['tag_api_page']
+			
+				if @attrib.has_key?('api_key')
+					subpage = subpage.gsub(/<api_key>/, @attrib['api_key'])
+				end
+				
+				if @attrib.has_key?('username')
+					subpage = subpage.gsub(/<username>/, @attrib['username'])
+				end	
+				
+				req = Net::HTTP::Get.new(subpage,  {"tRuTag" => $agent})
+				
+				if http.request(req).code == @attrib['needsauth'] then
+					required_attribute('pwd')
+					req.basic_auth(@attrib['username'], @attrib['pwd'])
+				end
+				
+				if http.request(req).code != @attrib['validcode'] then
+					Trutag::loggit(1, %{Received response: #{http.request(req).code} - #{http.request(req).message} from #{@attrib['sitename']}})
+				end
+
+				http.request(req).body
+			}	
+		end
+		data
+	end
+	
+	def required_attribute(attribute)
+		if @attrib != nil
+			if !@attrib.has_key?(attribute) || @attrib[attribute] == nil
+				raise ArgumentError, %{#{@attrib['sitename']} requires attribute: #{attribute}}, caller
+			end
+		else
+			raise ArgumentError, %{#{self.class} @attrib == nil}	
+		end
+	end
+end
+
+# for robot coop sites
+class RobotCoop  < Site
+	# By default the config.xml file uses the text API Key of 1234.  Please replace this with your own API Key
+	def initialize(params)
+		#we could be a number of sites so lets require the truth
+		if !params.has_key?('url') || !params.has_key?('sitename') then
+			raise ArgumentError,  %{Your RobotCoop site requires a sitename and url attribute}
+		end
+		super
+	end
+	
+	def add_tags(tbin)
+		require_gem 'r43'
+		required_attribute('api_key')
+		required_attribute('username')
+			
+		if @attrib.has_key?('international') && @attrib['international'] != nil
+			conn = R43::Connection.new(@attrib['api_key'], @attrib['international'])
+		else
+			conn = R43::Connection.new(@attrib['api_key'])	
+		end 
+			
+		tags = conn.get_persons_tags(@attrib['username'])
+		tags.each { |i| tbin[i.name.downcase] = tbin.fetch(i.name.downcase, 0) + Integer(i.count)}
+	end
+end
+
+class Y2 < Site
+	def add_tags(tbin)
+		required_attribute("validcode")
+		required_attribute("username")
+		required_attribute("api_key")
+	
+		if !@attrib.fetch('isoffline', FALSE) 
+			@tagstotal=1;@tagsreturned=1;@first=0;
+			
+			Net::HTTP.start(%{api.search.yahoo.com}, 80) { |http|
+				def nextrequest
+					# I'm not too excited about this looping mechanism.  There must be a better way, probably much easier as well.
+					while !@stop
+						yield
+						@first += @tagsreturned
+					end
+				end
+				
+				@stop=FALSE
+				nextrequest {
+
+					@response = http.get(%{/MyWebService/V1/tagSearch?appid=#{attrib['api_key']}&yahooid=#{attrib['username']}&results=50&start=#{@first+@tagsreturned}})
+					
+					if @response.code==@attrib['validcode']
+						doc=REXML::Document.new @response.body
+						@tagstotal=doc.elements[1].attributes["totalResultsAvailable"]
+						@tagsreturned=doc.elements[1].attributes["totalResultsReturned"]
+						@first=doc.elements[1].attributes["firstResultPosition"]
+						
+						doc.elements[1].each do |element|
+							tbin[element[0].text.downcase] = (tbin.fetch(element[0].text.downcase, 0) + Integer(element[1].text))
+						end
+
+						@stop = (@tagsreturned+@first >= @tagstotal)
+					else
+						@stop=TRUE
+						Trutag::loggit(1, %{Received response: #{@response.code} - #{@response.message} from #{@attrib['sitename']}})
+					end
+				}
+				
+
+				
+			}
+		end
+		
+		
+	end
+end
+
+class Jts < Site
+	def add_tags(tbin)
+		required_attribute('username')
+		required_attribute('pwd')
+		
+		if !@attrib.fetch('isoffline', FALSE)
+			# Make an object to represent the XML-RPC server.
+			server = XMLRPC::Client.new( "www.jots.com", "/xmlrpc.cgi")
+			
+			# Call the remote server and get our result
+			result = server.call('jots.getAccountTags', @attrib['username'], @attrib['pwd'])
+			
+			# Convert the array to a hash
+			result.each { |x| tbin[x.downcase] = (tbin.fetch(x, 0) + 1) }
+		end
+	end
+end
+
+class Flkr < Site
+	def add_tags(tbin)
+		#using Flickr api wrapper
+		# gem install flickr
+		required_attribute('email')
+		
+		require_gem 'flickr'
+	
+		flickr = Flickr.new                        
+		user = flickr.users(@attrib['email'])
+		user.tags.each { |x| tbin[x.downcase] = tbin.fetch(x.downcase, 0) +1 }
+	end
+end
+
+#Simpy: { type: Simpy, sitename: Simpy, tag_api_page: /simpy/api/rest/GetTags.do?, all_tags_path: '/simpy/User.do?username=#{@attrib[''username'']}&src=trutag&q=', mode: 0, parse_tags: 'tbin[element.attributes[''tag''].downcase] = ( tbin.fetch(element.attributes[''tag''].downcase, 0) + Integer(element.attributes[''count'']))' }