fastly 0.5

data/lib/fastly/fetcher.rb

@@ -0,0 +1,56 @@
+class Fastly 
+  # :nodoc:
+  class AuthRequired < RuntimeError; end
+  # :nodoc:
+  class FullAuthRequired <  Fastly::AuthRequired; end
+  # :nodoc: 
+  class Error < RuntimeError; end
+  # :nodoc:
+  class Unauthorized < AuthRequired; end 
+      
+  module Fetcher # :nodoc: all 
+
+    # Get the current Fastly::Client
+    def client(opts={})
+      opts[:base_url]  ||= 'api.fastly.com'
+      opts[:base_port] ||= 80
+      @client ||= Fastly::Client.new(opts)
+    end
+    
+    def list(klass, opts={})
+      raise Fastly::FullAuthRequired unless self.fully_authed?
+      list = client.get(klass.list_path, opts)
+      return [] if list.nil?
+      list.map { |hash| klass.new(hash, self) }
+    end
+
+    def get(klass, *args)
+      raise Fastly::FullAuthRequired unless self.fully_authed?
+      if [User, Customer].include?(klass) && args.empty?
+        hash = client.get("/current_#{klass.path}")
+      else
+        hash = client.get(klass.get_path(*args))
+      end
+      return nil if hash.nil?
+      return klass.new(hash, self)
+    end
+    
+    def create(klass, opts)
+      raise Fastly::FullAuthRequired unless self.fully_authed?
+      hash = client.post(klass.post_path(opts),opts)
+      return klass.new(hash, self)
+    end
+
+    def update(klass, obj)
+      raise Fastly::FullAuthRequired unless self.fully_authed?
+      hash = client.put(klass.put_path(obj), obj.as_hash)
+      return klass.new(hash, self)
+    end
+
+    def delete(klass, obj)
+      raise Fastly::FullAuthRequired unless self.fully_authed?
+      return client.delete(klass.delete_path(obj))
+    end
+
+  end
+end

data/lib/fastly/invoice.rb

@@ -0,0 +1,95 @@
+class Fastly
+  # An invoice for a time period
+  class Invoice < Base
+    attr_accessor :service_id, :service_name, :start_time, :end_time, :total, :regions
+    
+    ## 
+    # :attr: service_id
+    # 
+    # The id of the service this invoice is for
+    # 
+
+    ## 
+    # :attr: service_name
+    # 
+    # The id of the service this invoice is for
+    # 
+
+    ## 
+    # :attr: start_time
+    # 
+    # The earliest date and time this invoice covers
+    # 
+
+    ## 
+    # :attr: end_time
+    # 
+    # The latest date and time this invoice covers
+    # 
+
+    ## 
+    # :attr: total
+    # 
+    # The total for this invoice in US dollars
+    # 
+
+    ## 
+    # :attr: regions
+    # 
+    # A hash reference with all the different regions and their subtotals
+    
+    private
+    
+    def self.get_path(*args)
+      opts = args.size>0 ? args[0] : {}
+      url  = "/billing"
+      if opts.has_key?(:service_id)
+        url += "/service/#{opts[:service_id]}"
+      end
+      if opts.has_key?(:year) && opts.has_key?(:month)
+        url += "/year/#{opts[:year]}/month/#{opts[:month]}"
+      end
+      url
+    end
+    
+    def self.list_path(*args)
+      get_path(*args)
+    end
+    
+    def self.post_path 
+      raise "You can't POST to an invoice"
+    end
+    
+    def self.put_path
+      raise "You can't PUT to an invoice"
+    end
+    
+    def self.delete_path
+      raise "You can't DELETE to an invoice"
+    end
+    
+    def save!
+      raise "You can't save an invoice"
+    end
+    
+    def delete!
+      raise "You can't delete an invoice"
+    end
+  end
+  
+
+  # Return an array of Invoice objects representing invoices for all services.
+  # 
+  # If a year and month are passed in returns the invoices for that whole month. 
+  # 
+  # Otherwise it returns the invoices for the current month so far.
+  def list_invoices(year=nil, month=nil)
+    opts = {}
+    unless year.nil? || month.nil?
+      opts[:year]  = year
+      opts[:month] = month
+    end
+    list(Fastly::Invoice, opts)
+  end
+  
+end

data/lib/fastly/match.rb

@@ -0,0 +1,77 @@
+class Fastly
+  # An object that allows matching on requests and dispatching to different methods
+  class Match < BelongsToServiceAndVersion
+    attr_accessor :service_id, :name, :comment, :pattern, :priority, :on_recv, :on_lookup, :on_fetch, :on_deliver, :on_miss, :on_hit
+
+    ## 
+    # :attr: service_id
+    # 
+    # The id of the service this belongs to.
+    # 
+
+    ## 
+    # :attr: version
+    # 
+    # The number of the version this belongs to.
+    # 
+
+    ## 
+    # :attr: name
+    # 
+    # The name of this match.
+    # 
+
+    ## 
+    # :attr: pattern
+    # 
+    # The matching pattern.
+    # 
+
+    ## 
+    # :attr: on_recv
+    # 
+    # What VCL action to execute before we lookup the object.
+    # 
+
+    ## 
+    # :attr: on_lookup
+    # 
+    # What VCL action to execute during a lookup.
+    # 
+
+    ## 
+    # :attr: on_fetch 
+    # 
+    # What to execute after we have the header.
+    # 
+
+    ## 
+    # :attr: on_miss
+    # 
+    # What to execute on a cache miss
+    # 
+
+    ## 
+    # :attr: on_hit
+    # 
+    # What to execute on a cache hit.
+    # 
+
+    ## 
+    # :attr: on_deliver
+    # 
+    # What to execute just before delivering the object.
+    # 
+
+    ## 
+    # :attr: priority
+    # 
+    # The ordering of the match object
+    # 
+
+    ## 
+    # :attr: comment 
+    # 
+    # a free form comment field
+  end
+end

data/lib/fastly/origin.rb

@@ -0,0 +1,23 @@
+class Fastly
+  # A logical group of directors - for example the asset server directors from all your DCNs
+  class Origin < BelongsToServiceAndVersion
+    attr_accessor :service_id, :name, :comment
+
+    ## 
+    # :attr: service_id
+    # 
+    # The id of the service this belongs to.
+    # 
+
+    ## 
+    # :attr: version
+    # 
+    # The number of the version this belongs to.
+    # 
+
+    ## 
+    # :attr: name
+    # 
+    # The domain name of this domain
+  end
+end

data/lib/fastly/service.rb

@@ -0,0 +1,112 @@
+class Fastly
+  # Represents something you want to serve - this can be, for example, a whole web site, a Wordpress site, or just your image servers
+  class Service < Base
+    attr_accessor :id, :customer, :name, :comment
+    @versions = []
+    
+    ## 
+    # :attr: id
+    # 
+    # The id of the service
+    # 
+
+    ## 
+    # :attr: customer
+    # 
+    # The id of the customer this belongs to
+    # 
+
+    ## 
+    # :attr: name
+    # 
+    # The name of this service
+    # 
+
+    ## 
+    # :attr: comment 
+    # 
+    # a free form comment field
+
+    
+    ## 
+    #
+    # Get a hash of stats from different data centers.
+    # 
+    # Type can be one of
+    # * minutely
+    # * hourly
+    # * daily
+    # * all
+    def stats(type=:all)
+      raise Fastly::FullAuthRequired unless fetcher.fully_authed?
+      raise Fastly::Error "Unknown stats type #{type}" unless [:minutely,:hourly,:daily,:all].include?(type.to_sym)
+      hash = fetcher.client.get(Fastly::Service.get_path(self.id)+"/stats/#{type}")
+      return hash
+    end
+
+    # Return a Invoice object representing the invoice for this service
+    # 
+    # If a year and month are passed in returns the invoice for that whole month. 
+    # 
+    # Otherwise it returns the invoice for the current month so far.
+    def invoice(year=nil, month=nil)
+      raise Fastly::FullAuthRequired unless fetcher.fully_authed?
+      opts = { :service_id => self.id }
+      unless year.nil? || month.nil?
+        opts[:year]  = year
+        opts[:month] = month
+      end
+      fetcher.get(Fastly::Invoice, opts)
+    end
+
+    # Purge all assets from this service.
+    def purge_all
+      raise  Fastly::AuthRequired unless self.authed?
+      res = client.put(get_path(self.id)+"/purge_all")
+    end
+
+    # Set all the versions that this service has had.
+    def versions=(versions)
+      @versions = versions
+    end
+
+    # Get a sorted array of all the versions that this service has had.
+    def versions
+      raise  Fastly::FullAuthRequired unless fetcher.fully_authed?
+      versions = []
+      @versions.each_pair { |number, version|
+        versions.push Fastly::Version.new({ :number => number, :service_id => self.id, :comment => version['comment'] || "" }, fetcher)
+      }
+      versions.sort {|a,b| a.number.to_i <=> b.number.to_i }
+    end
+
+    # Get an individual Version object. By default returns the latest version
+    def version(number=-1)
+      raise  Fastly::FullAuthRequired unless fetcher.fully_authed?
+      versions[number]
+    end
+
+  end
+
+  # Get a list of all the services that the current customer has.
+  def list_services(opts={})
+     list(Fastly::Service, opts)
+  end
+
+  # Search all the services that the current customer has.
+  # 
+  # In general you'll want to do
+  # 
+  #   services = fastly.search_services(:name => name)
+  # 
+  # or
+  # 
+  #   service = fastly.search_services(:name => name, :version => number)  
+  def search_services(opts)
+    raise  Fastly::FullAuthRequired unless self.fully_authed?
+    klass = Fastly::Service
+    hash  = client.get(klass.post_path+"/search", opts)
+    return nil if hash.nil?
+    klass.new(hash, self)
+  end
+end

data/lib/fastly/settings.rb

@@ -0,0 +1,69 @@
+class Fastly
+  # Represent arbitary key value settings for a given Version
+  class Settings < Base
+    attr_accessor :service_id, :version, :settings
+    ## 
+    # :attr: service_id
+    # 
+    # The id of the service this belongs to.
+    # 
+
+    ## 
+    # :attr: version
+    # 
+    # The number of the version this belongs to.
+    # 
+
+    ##
+    # :attr: service
+    #
+    # Return a hash containing key/value pairs of settings
+    #
+    
+
+    # :nodoc:
+    def self.get_path(service, number)
+      "/service/#{service}/version/#{number}/settings"
+    end
+
+    # :nodoc:
+    def self.put_path(obj)
+      get_path(obj.service_id, obj.version)
+    end
+
+    # :nodoc:
+    def self.list_path(opts={})
+      raise "You can't list settings"
+    end
+
+    # :nodoc:
+    def self.post_path 
+      raise "You can't POST to an invoice"
+    end
+
+    # :nodoc:
+    def self.delete_path
+      raise "You can't DELETE to an invoice"
+    end
+    
+    # :nodoc:
+    def delete!
+      raise "You can't delete an invoice"
+    end
+    
+    # :nodoc:
+    def as_hash 
+      settings
+    end
+  end
+  
+  # Get the Settings object for the specified Version
+  def get_settings(service, number)
+    get(Fastly::Settings, service, number)
+  end
+
+  # Update the Settings object for the specified Version
+  def update_settings(opts={})
+    update(Fastly::Settings, opts)
+  end
+end

data/lib/fastly/user.rb

@@ -0,0 +1,62 @@
+class Fastly
+  # A representation of a User in Fastly
+  class User < Base
+    attr_accessor :id, :name, :login, :customer_id, :role, :password
+    ## 
+    # :attr: id
+    # 
+    # The id of this user
+    # 
+
+    ## 
+    # :attr: name
+    # 
+    # The name of this user 
+    # 
+
+    ## 
+    # :attr: customer_id
+    # 
+    # The id of the customer this user belongs to
+    # 
+
+    ## 
+    # :attr: role
+    # 
+    # The role this user has (one of admin, owner, superuser, user, engineer, billing)
+    
+    
+    # Get the Customer object this user belongs to
+    def customer 
+      @customer ||= fetcher.get(Customer, self.customer_id)
+    end
+    
+    # Whether or not this User is the owner of the Customer they belong to
+    def owner?
+      customer.owner_id == id
+    end
+
+    # :nodoc:
+    PRIORITIES = {
+      :admin      => 1,
+      :owner      => 10,
+      :superuser  => 10,
+      :user       => 20,
+      :engineer   => 30,
+      :billing    => 30,
+    }
+
+    # Does this User have sufficient permissions to perform the given role
+    def can_do?(test_role)
+      test_priority = PRIORITIES[test_role.to_sym] || 1000
+      my_priority = PRIORITIES[self.role.to_sym] || 1000
+
+      if test_priority == my_priority
+        test_role.to_s == :owner ? owner? : test_role.to_sym == self.role.to_sym
+      else
+        my_priority < test_priority
+      end
+    end
+    
+  end
+end