philnash-bitly 0.1.0

data/History.txt

@@ -0,0 +1,6 @@
+=== 0.1.0 / 2009-01-26
+
+* 1 major enhancement
+
+  * First release
+

data/README.txt

@@ -0,0 +1,58 @@
+= bitly
+
+== DESCRIPTION:
+
+A Ruby API for bit.ly
+
+http://code.google.com/p/bitly-api/wiki/ApiDocumentation
+
+== USAGE:
+
+Create a Bitly client using your username and api key as follows:
+
+bitly = Bitly.new(username, api_key)
+
+You can then use that client to shorten or expand urls or return more information or statistics as so:
+
+bitly.shorten('http://www.google.com')
+bitly.expand('wQaT')
+bitly.info('http://bit.ly/wQaT')
+bitly.stats('http://bit.ly/wQaT')
+
+Each can be used in all the methods described in the API docs, the shorten function, for example, takes a url or an array of urls.
+
+All four functions return a Bitly::Url object (or an array of Bitly::Url objects if you supplied an array as the input). You can then get all the information required from that object.
+
+u = bitly.shorten('http://www.google.com') #=> Bitly::Url
+
+u.long_url #=> "http://www.google.com"
+u.short_url #=> "http://bit.ly/Ywd1"
+u.user_hash #=> "Ywd1"
+u.hash #=> "2V6CFi"
+u.info #=> a ruby hash of the JSON returned from the API
+u.stats #=> a ruby hash of the JSON returned from the API
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Phil Nash
+
+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/Rakefile

@@ -0,0 +1,16 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'rake'
+require 'echoe'
+require './lib/bitly.rb'
+
+Echoe.new('bitly', Bitly::VERSION) do |p|
+  p.description = "Use the bit.ly API to shorten or expand URLs"
+  p.url = "http://github.com/philnash/bitly"
+  p.author = "Phil Nash"
+  p.email = "philnash@gmail.com"
+  p.development_dependencies = []
+end
+
+# vim: syntax=Ruby

data/bitly.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bitly}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Phil Nash"]
+  s.date = %q{2009-01-26}
+  s.description = %q{Use the bit.ly API to shorten or expand URLs}
+  s.email = %q{philnash@gmail.com}
+  s.extra_rdoc_files = ["lib/bitly/client.rb", "lib/bitly/url.rb", "lib/bitly/utils.rb", "lib/bitly/version.rb", "lib/bitly.rb", "README.txt"]
+  s.files = ["History.txt", "lib/bitly/client.rb", "lib/bitly/url.rb", "lib/bitly/utils.rb", "lib/bitly/version.rb", "lib/bitly.rb", "Rakefile", "README.txt", "test/test_bitly.rb", "Manifest", "bitly.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/philnash/bitly}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Bitly", "--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{bitly}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Use the bit.ly API to shorten or expand URLs}
+  s.test_files = ["test/test_bitly.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/bitly/client.rb

@@ -0,0 +1,151 @@
+require 'rubygems'
+require 'net/http'
+require 'uri'
+require 'json'
+
+module Bitly
+  API_URL     = 'http://api.bit.ly/'
+  API_VERSION = '2.0.1'
+  # login = 'philnash'
+  # api_key = 'R_7776acc394294b2b0ad2c261a91c483d'
+
+  def self.new(login, api_key)
+    Bitly::Client.new(login,api_key)
+  end
+
+  class Client
+    
+    include Bitly::Utils
+    
+    def initialize(login,api_key)
+      @login = login
+      @api_key = api_key
+    end
+    
+    def shorten(input)
+      if input.is_a? String
+        request = create_url "shorten", :longUrl => input
+        result = get_result(request)
+        result = {:long_url => input}.merge result[input]
+        Bitly::Url.new(@login,@api_key,result)
+      elsif input.is_a? Array
+        request = create_url "shorten"
+        request.query << "&" + input.map { |long_url| "longUrl=#{URI.encode(long_url)}" }.join("&") unless input.nil?
+        result = get_result(request)
+        input.map do |long_url|
+          new_url = {:long_url => long_url}.merge result[long_url]
+          long_url = Bitly::Url.new(@login,@api_key,new_url)
+        end
+      else
+        raise ArgumentError
+      end
+    end
+    
+    def expand(input)
+      if input.is_a? String
+        if input.include? "bit.ly/"
+          hash = input.gsub(/^.*bit.ly\//,'')
+          request = create_url "expand", :hash => hash
+          result = get_result(request)
+          result = { :short_url => input, :hash => hash }.merge result[hash]
+        else
+          request = create_url "expand", :hash => input
+          result = get_result(request)
+          result = { :hash => input, :short_url => "http://bit.ly/#{input}" }.merge result[input]
+        end
+        Bitly::Url.new(@login,@api_key,result)        
+      elsif input.is_a? Array
+        request = create_url "expand", :hash => input.join(',')
+        result = get_result(request)
+        input.map do |hsh|
+          new_url = {:hash => hsh, :short_url => "http://bit.ly/#{hsh}"}.merge result[hsh]
+          hsh = Bitly::Url.new(@login,@api_key,new_url)
+        end
+      else
+        raise ArgumentError
+      end
+    end
+    
+    def info(input)
+      if input.is_a? String
+        if input.include? "bit.ly/"
+          hash = input.gsub(/^.*bit.ly\//,'')
+          request = create_url 'info', :hash => hash
+          result = get_result(request)
+          result = { :short_url => "http://bit.ly/#{hash}", :hash => hash }.merge result[hash]
+        else
+          request = create_url 'info', :hash => input
+          result = get_result(request)
+          result = { :short_url => "http://bit.ly/#{input}", :hash => input }.merge result[input]
+        end
+        Bitly::Url.new(@login,@api_key,result)
+      elsif input.is_a? Array
+        request = create_url "info", :hash => input.join(',')
+        result = get_result(request)
+        input.map do |hsh|
+          new_url = {:hash => hsh, :short_url => "http://bit.ly/#{hsh}"}.merge result[hsh]
+          hsh = Bitly::Url.new(@login,@api_key,:info => new_url)
+        end
+      end
+    end
+    
+    def stats(input)
+      if input.is_a? String
+        if input.include? "bit.ly/"
+          hash = input.gsub(/^.*bit.ly\//,'')
+          request = create_url 'stats', :hash => hash
+          result = get_result(request)
+          result = { :short_url => "http://bit.ly/#{hash}", :hash => hash }.merge result
+        else
+          request = create_url 'stats', :hash => input
+          result = get_result(request)
+          result = { :short_url => "http://bit.ly/#{input}", :hash => input }.merge result
+        end
+        Bitly::Url.new(@login,@api_key,:stats => result)
+      else
+        raise ArgumentError
+      end
+    end
+    
+  end
+  
+end
+
+class BitlyError < StandardError
+  attr_reader :code
+  alias :msg :message
+  def initialize(msg, code, req)
+    @code = code
+    super("'#{req}' - #{msg}")
+  end
+end
+
+
+# How it should work
+# ==================
+# bitly = Bitly::Base.new('philnash','R_7776acc394294b2b0ad2c261a91c483d')
+# bitly.shorten("http://www.google.com")
+# #=> Bitly::Url
+# bitly.shorten(["http://www.google.com","http://cnn.com"])
+# #=> [Bitly::Url,Bitly::Url]
+# 
+# bitly.expand("http://bit.ly/wIRm")
+# #=> Bitly::Url
+# bitly.expand("wIRm")
+# #=> Bitly::Url
+# bitly.expand(["wIRm","sdfsd"])
+# #=> [Bitly::Url,Bitly::Url]
+#
+# bitly.info("http://bit.ly/wIRm") || bitly.info("wIRm")
+# #=> b = Bitly::Url
+# #=> b.info #=> hash of data back from info
+# bitly.info(['wIRm','qsads'])
+# #=> [Bitly::Url, Bitly::Url]
+# also, with any url = Bitly::Url
+# url.info #=> hash of info data
+
+# bitly.stats("http://bit.ly/wIRm") || bitly.stats("wIRm")
+# #=> b = Bitly::Url
+# #=> b.stats #=> hash of stats
+# also, any url = Bitly::Url
+# url.stats #=> hash of stats

data/lib/bitly/url.rb

@@ -0,0 +1,54 @@
+module Bitly
+  
+  class Url
+    include Bitly::Utils
+    
+    VARIABLES = ['long_url', 'short_url', 'hash', 'user_hash', 'short_keyword_url']
+    
+    def initialize(login,api_key,obj=nil)
+      unless obj.nil?
+        instance_variablise(obj, VARIABLES)
+        @info = obj[:info] if obj[:info]
+        @stats = obj[:stats] if obj[:stats]
+      end
+      @login = login
+      @api_key = api_key
+    end
+    
+    def info
+      if @info.nil?
+        if @hash
+          request = create_url "info", :hash => @hash
+          result = get_result(request)[@hash]
+          instance_variablise(result, VARIABLES)
+          @info = result
+        elsif @short_url
+          hash = @short_url.gsub(/^.*bit.ly\//,'')
+          request = create_url "info", :hash => hash
+          result = get_result(request)[hash]
+          instance_variablise(result, VARIABLES)
+          @info = result
+        else
+          nil
+        end
+      else
+        @info
+      end
+    end
+    
+    def stats
+      if @stats.nil?
+        if @hash
+          request = create_url "stats", :hash => @hash
+        elsif @short_url
+          request = create_url "stats", :shortUrl => @short_url
+        end
+        @stats = get_result(request)
+      else
+        @stats
+      end
+    end
+    
+  end
+
+end

data/lib/bitly/utils.rb

@@ -0,0 +1,49 @@
+module Bitly
+  module Utils
+    private
+    def underscore(camel_cased_word) # stolen from rails
+      camel_cased_word.to_s.gsub(/::/, '/').
+      gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+      gsub(/([a-z\d])([A-Z])/,'\1_\2').
+      tr("-", "_").
+      downcase
+    end
+    
+    def attr_define(k,v)
+      instance_variable_set("@#{k}", v)
+      meta = class << self; self; end
+      meta.class_eval { attr_reader k.to_sym }
+    end
+
+    def instance_variablise(obj,variables)
+      if obj.is_a? Hash
+        obj.each do |k,v|
+          if v.is_a? Hash
+            instance_variablise(v,variables)
+          else
+            attr_define(underscore(k),v) if variables.include?(underscore(k))
+          end
+        end
+      end
+    end
+    
+    def create_url(resource="",args={})
+      args = args.merge({:login => @login, :apiKey => @api_key, :version => API_VERSION})
+      url = URI.join(API_URL,resource)
+      long_urls = args.delete(:long_urls)
+      url.query = args.map { |k,v| "%s=%s" % [URI.encode(k.to_s), URI.encode(v.to_s)] }.join("&")
+      url.query << "&" + long_urls.map { |long_url| "longUrl=#{URI.encode(long_url)}" }.join("&") unless long_urls.nil?
+      url
+    end
+    
+    def get_result(request)
+      result = JSON.parse(Net::HTTP.get(request))
+      if result['statusCode'] == "OK"
+        result = result['results']
+      else
+        raise BitlyError.new(result['errorMessage'],result['errorCode'],'expand')
+      end
+    end
+    
+  end
+end

data/lib/bitly/version.rb

@@ -0,0 +1,3 @@
+module Bitly
+  VERSION = '0.1.0'
+end

data/lib/bitly.rb

@@ -0,0 +1,6 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'bitly/utils'
+require 'bitly/client'
+require 'bitly/url'
+require 'bitly/version'

data/test/test_bitly.rb

@@ -0,0 +1,41 @@
+require 'test/unit'
+require 'bitly'
+
+class TestBitly < Test::Unit::TestCase
+  
+  def setup
+    @api_key = 'R_7776acc394294b2b0ad2c261a91c483d'
+    @login = 'philnash'
+    @bitly = Bitly.new(@login,@api_key)
+  end
+  
+  # not a good test, but it makes sure things are working for now.
+  def test_returns_short_url
+    url = @bitly.shorten("http://google.com")
+    assert_equal url.class, Bitly::Url
+    assert_equal url.long_url, "http://google.com"
+    assert_equal url.short_url, "http://bit.ly/wQaT"
+    urls = @bitly.shorten(["http://google.com","http://cnn.com"])
+    assert_equal urls[0].long_url, "http://google.com"
+    assert_equal urls[0].short_url, "http://bit.ly/wQaT"
+  end
+  
+  def test_returns_a_long_url
+    urls = @bitly.expand(["2bYgqR","1RmnUT"])
+    assert_equal urls[0].class, Bitly::Url
+    assert_equal urls[0].long_url, "http://cnn.com"
+    assert_equal urls[0].hash, "2bYgqR"
+    assert_equal urls[1].long_url, "http://google.com"
+    assert_equal urls[1].hash, "1RmnUT"
+    url = @bitly.expand("http://bit.ly/wQaT")
+    assert_equal url.class, Bitly::Url
+    assert_equal url.short_url, "http://bit.ly/wQaT"
+    assert_equal url.long_url, "http://google.com/"
+    assert_equal url.hash, "wQaT"
+    url2 = @bitly.expand("wQaT")
+    assert_equal url2.class, Bitly::Url
+    assert_equal url2.hash, "wQaT"
+    assert_equal url2.short_url, "http://bit.ly/wQaT"
+    assert_equal url2.long_url, "http://google.com/"
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: philnash-bitly
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Phil Nash
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-26 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Use the bit.ly API to shorten or expand URLs
+email: philnash@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- lib/bitly/client.rb
+- lib/bitly/url.rb
+- lib/bitly/utils.rb
+- lib/bitly/version.rb
+- lib/bitly.rb
+- README.txt
+files: 
+- History.txt
+- lib/bitly/client.rb
+- lib/bitly/url.rb
+- lib/bitly/utils.rb
+- lib/bitly/version.rb
+- lib/bitly.rb
+- Rakefile
+- README.txt
+- test/test_bitly.rb
+- Manifest
+- bitly.gemspec
+has_rdoc: true
+homepage: http://github.com/philnash/bitly
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Bitly
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: bitly
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Use the bit.ly API to shorten or expand URLs
+test_files: 
+- test/test_bitly.rb