require "timeout"
require "net/http"
require "uri"
# A simple client for the Oso URL shortener.
class Oso
include Timeout
# Raised for any error.
Error = Class.new StandardError
# Duh.
VERSION = "1.0.0"
# :nodoc:
def self.instance
@instance ||= new
end
# A static helper if you don't want to create new instances of the
# Oso class. Set the OSO_URL environment variable to
# control the server location. See +initialize+ for more
# information.
def self.shorten *args
instance.shorten(*args)
end
# A URI. Where does the Oso server live? If unspecified during
# initialization it'll default to the contents of the
# OSO_URL environment variable. If that's unset, it's
# "http://localhost:9292".
attr_reader :url
# Create a new instance, optionally specifying the server +url+. See
# the +url+ property for defaults and fallbacks.
def initialize url = nil
url = url || ENV["OSO_URL"] || "http://localhost:9292"
url = "http://#{url}" unless /^http/ =~ url
@url = URI.parse url
@url.path = "/" if @url.path.empty?
end
# Create a short URL for +url+. Pass a :life option
# (integer, in seconds) to control how long the short URL will be
# active. Pass a :limit option to control how many times
# the URL can be hit before it's deactivated. Pass a :name
# option to explicitly set the shortened URL.
#
# +shorten+ will raise an Oso::Error if network or server
# conditions keep +url+ from being shortened in one second.
def shorten url, options = {}
params = options.merge url: url
params[:life] &&= params[:life].to_i
params[:limit] &&= params[:limit].to_i
timeout 1, Oso::Error do
begin
res = Net::HTTP.post_form @url, params
rescue Errno::ECONNREFUSED
raise Oso::Error, "Connection to #@url refused."
rescue Timeout::Error
raise Oso::Error, "Connection to #@url timed out."
rescue Errno::EINVAL, Errno::ECONNRESET, EOFError => e
raise Oso::Error, "Connection to #@url failed. (#{e.class.name})"
rescue Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError => e
raise Oso::Error, "#@url provided a bad response. (#{e.class.name})"
end
case res.code.to_i
when 201 then return res.body
else raise Oso::Error, "Unsuccessful shorten #{res.code}: #{res.body}"
end
end
end
end