fastly 0.5

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+run_test.sh
+doc/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in fastly.gemspec
+gemspec

data/README.md

@@ -0,0 +1,59 @@
+Fastly - client library for interacting with the Fastly web acceleration service
+
+# Example
+ 
+    fastly = Net::Fastly.new(%login_opts);
+
+    current_user     = fastly.current_user;
+    current_customer = fastly.current_customer;
+
+    user     = fastly.get_user(current_user.id);
+    customer = fastly.get_customer(current_customer.id);
+
+    puts "Name: #{user.name}"
+    puts "Works for #{user.customer.name}"
+    puts "Which is the same as #{customer.name}"
+    puts "Which has the owner #{customer.owner.name}"
+
+    # Let's see which services we have defined
+    customer.list_services.each do |service|
+        puts service.id
+        puts service.name
+        service.versions.each do |version
+            puts "\t#{version.number}"
+    end
+
+    service        = fastly.create_service(:name => "MyFirstService");
+    latest_version = service.version;
+
+    # Create a domain and a backend for the service ...
+    domain         = fastly.create_domain(:service_id => service.id, :version => latest_version.number, :name => "www.example.com");
+    backend        = fastly.create_backend(:service_id => service.id, :version => latest_version.number, :ipv4 => "127.0.0.1", :port => 80);
+
+    # ... and activate it. You're now hosted on Fastly.
+    latest_version.activate
+
+    # Let's take a peek at the VCL that Fastly generated for us
+    vcl = latest_version.generated_vcl;
+    puts "Generated VCL file is:\n#{vcl.content}"
+
+    # Now let's create a new version ...
+    new_version    = latest_version.clone;
+    # ... add a new backend ...
+    new_backend    = fastly.create_backend(:service_id => service.id, :version => new_version.number, :ipv4 => "192.168.0.1", :port => 8080);
+    # ... and upload some custome vcl (presuming we have permissions)
+    new_version.upload_vcl(vcl_name, File.read(vcl_file));    
+
+    new_version.activate;
+
+# Copyright
+ 
+Copyright 2011 - Fastly Inc
+
+Mail support at fastly dot com if you have problems.
+ 
+# Developers
+
+http://github.com/fastly/fastly-ruby
+
+http://www.fastly.com/documentation

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/bin/fastly_upload_vcl

@@ -0,0 +1,67 @@
+#!/bin/env ruby
+
+##
+# fastly_upload_vcl - upload raw VCL files to Fastly
+#
+# Author::   Fastly Inc <support@fastly.com>
+# Copyright:: Copyright (c) 2011 Fastly Inc
+# License::   Distributes under the same terms as Ruby
+#
+# = USAGE
+# 
+#     fastly_upload_vcl <options> <service id or name> <path to vcl file>
+# 
+# = CONFIGURATION
+# 
+# You can either have a config file in either ~/.fastly or /etc/fastly with
+# 
+#     api_key = <key>
+#     
+# or a config file with
+# 
+#     user     = <login>
+#     password = <password>
+# 
+# Alternatively you can pass in any of those options on the command line
+# 
+#     fastly_upload_vcl --api_key  <key> <service id or name> <path to vcl file>
+#     fastly_upload_vcl --user <login> --password <password> <service id or name> <path to vcl file>
+# 
+
+require 'rubygems'
+require 'fastly'
+
+# :nodoc:
+def die(message)
+  warn message
+  exit -1
+end
+
+params      = Fastly.get_options("#{ENV['HOME']}/.fastly", "/etc/fastly")
+
+service_id  = ARGV.shift || die("You must pass in a service id")
+vcl_file    = ARGV.shift || die("You must pass in a vcl file")
+
+die("Couldn't find any of the config files - #{configs.join(',')}") unless params.keys.size>0
+die("Couldn't find vcl file #{vcl_file}") unless File.file?(vcl_file)
+
+fastly  = Fastly.new(params) 
+service = fastly.get_service(service_id) || die("Couldn't find service #{service_id}")
+old     = service.version
+updated = old.clone
+puts "Uploading #{vcl_file} and bumping version from #{old.number} to #{updated.number}"
+begin
+  name    = File.basename(vcl_file, ".vcl")
+  content = File.new(vcl_file, "r").read
+  vcl     = updated.vcl(name)
+  if vcl
+    vcl.content = content
+    vcl.save!
+  else
+    updated.upload_vcl(name, content)
+  end
+  updated.activate!
+rescue => e
+  die("Couldn't upload and activate vcl: #{e}")
+end
+puts "Done!"

data/fastly.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "fastly"
+
+Gem::Specification.new do |s|
+  s.name        = "fastly"
+  s.version     = Fastly::VERSION
+  s.authors     = ["Fastly Inc"]
+  s.email       = ["support@fastly.com"]
+  s.homepage    = "http://github.com/fastly/fastly-ruby"
+  s.summary     = %q{Client library for the Fastly acceleration system}
+  s.description = %q{Client library for the Fastly acceleration system}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency 'json'
+  s.add_dependency 'curb', '>=0.7.15'
+  s.add_dependency 'curb-fu', '>=0.6.1'
+  s.add_dependency 'rdoc', '>=3.11'
+end

data/lib/fastly.rb

@@ -0,0 +1,357 @@
+# Author::   Fastly Inc <support@fastly.com>
+# Copyright:: Copyright (c) 2011 Fastly Inc
+# License::   Distributes under the same terms as Ruby
+
+# A client library for interacting with the Fastly web acceleration service
+class Fastly
+  # The current version of the library
+  VERSION = "0.5"
+
+  require 'fastly/fetcher'
+  require 'fastly/client'
+
+  require 'fastly/base'
+  require 'fastly/belongs_to_service_and_version'
+  require 'fastly/backend'
+  require 'fastly/customer'
+  require 'fastly/director'  
+  require 'fastly/domain'
+  require 'fastly/invoice'
+  require 'fastly/match'
+  require 'fastly/origin'
+  require 'fastly/service'
+  require 'fastly/settings'
+  require 'fastly/user'
+  require 'fastly/vcl'
+  require 'fastly/version'
+
+  include Fastly::Fetcher
+
+  # Create a new Fastly client. Options are
+  # 
+  # user:: your Fastly login
+  # password:: your Fastly password
+  # api_key:: your Fastly api key
+  # 
+  # You only need to pass in C<api_key> OR C<user> and C<password>. 
+  # 
+  # Some methods require full username and password rather than just auth token.
+  def initialize(opts)
+    self.client(opts)
+    self
+  end
+
+  # Whether or not we're authed at all by either username & password or API key
+  def authed?
+    client.authed?
+  end
+
+  # Whether or not we're fully (username and password) authed
+  # Some methods require full username and password rather than just auth token
+  def fully_authed?
+    client.authed? # for now
+    #client.fully_authed?
+  end
+
+  # Return a Customer object representing the customer of the current logged in user.
+  def current_customer
+    raise Fastly::FullAuthRequired unless self.fully_authed?
+    @current_customer ||= get(Customer)
+  end
+
+  # Return a User object representing the current logged in user.
+  def current_user
+    raise Fastly::FullAuthRequired unless self.fully_authed?
+    @current_user ||= get(User)
+  end
+
+  # Return a hash representing all commands available.
+  #
+  # Useful for information.
+  def commands 
+    client.get('/commands')
+  end
+
+  # Purge the specified path from your cache.
+  def purge(path)
+    res = client.post("/purge/#{path}")
+    #res = client.post("/purge/", :path => path)
+  end
+
+
+  [User, Customer, Backend, Director, Domain, Match, Origin, Service, VCL, Version].each do |klass|   
+    type = klass.to_s.downcase.split("::")[-1]
+    # self.send :define_method, "list_#{type}s".to_sym do
+    #   list(klass)
+    # end
+
+    self.send :define_method, "get_#{type}".to_sym do |*args|
+      get(klass, *args)
+    end
+
+    self.send :define_method, "create_#{type}".to_sym do |obj|
+      create(klass, obj)
+    end
+
+    self.send :define_method, "update_#{type}".to_sym do |obj|
+      update(klass, obj)
+    end
+
+    self.send :define_method, "delete_#{type}".to_sym do |obj|
+      delete(klass, obj)
+    end
+  end
+
+
+  # :method: create_version(opts)
+  # opts must contain a service_id param
+
+  ## 
+  # :method: create_backend(opts)
+  # opts must contain service_id, version and name params
+
+  ## 
+  # :method: create_director(opts)
+  # opts must contain service_id, version and name params
+
+  ##
+  # :method: reate_domain(opts)
+  # opts must contain service_id, version and name params
+
+  ##
+  # :method: create_match(opts)
+  # opts must contain service_id, version and name params
+
+  ##
+  # :method: create_origin(opts)
+  # opts must contain service_id, version and name params
+
+  ##
+  # :method: create_vcl(opts)
+  # opts must contain service_id, version and name params
+
+  ##
+  # :method: get_user(id)
+  # Get a User
+
+  ## 
+  # :method: get_customer(id)
+  # Get a customer
+
+  ## 
+  # :method: get_service(id)
+  # Get a Service
+
+  ##
+  # :method: get_version(service_id, number)
+  # Get a Version
+
+  ##
+  # :method: get_backend(service_id, number, name)
+  # Get a backend
+
+  ## 
+  # :method: get_director(service_id, number, name)
+  # Get a Director
+
+  ## 
+  # :method: get_domain(service_id, number, name)
+  # Get a Domain
+
+  ## 
+  # :method: get_match(service_id, number, name)
+  # Get a Match
+
+  ## 
+  # :method: get_origin(service_id, number, name)
+  # Get an Origin
+
+  ## 
+  # :method: get_vcl(service_id, number, name)
+  # Get a VCL
+
+  ## 
+  # :method: get_version(service_id, number, name)
+  # Get a Version
+
+  ## 
+  # :method: get_settings(service_id, number, name)
+  # Get a Settings
+
+  ##
+  # :method: update_user(user)
+  # You can also call
+  #    user.save!
+
+  ## 
+  # :method: update_customer(customer)
+  # You can also call
+  #    customer.save!
+
+  ## 
+  # :method: update_service(service)
+  # You can also call
+  #    service.save!
+
+  ## 
+  # :method: update_version(version)
+  # You can also call
+  #    version.save!
+
+  ## 
+  # :method: update_backend(backend)
+  # You can also call
+  #    backend.save!
+
+  ## 
+  # :method: update_director(director)
+  # You can also call
+  #    director.save!
+
+  ## 
+  # :method: update_domain(domain)
+  # You can also call
+  #    domain.save!
+
+  ## 
+  # :method: update_match(match)
+  # You can also call
+  #    match.save!
+
+  ## 
+  # :method: update_origin(origin)
+  # You can also call
+  #    origin.save!
+
+  ## 
+  # :method: update_vcl(vcl)
+  # You can also call
+  #    vcl.save!
+
+  ## 
+  # :method: update_version(version)
+  # You can also call
+  #    version.save!
+
+  ## 
+  # :method: update_settings(settings)
+  # You can also call
+  #    settings.save!
+
+
+  ## 
+  # :method: delete_user(user) 
+  # You can also call
+  #    user.delete!
+
+  ## 
+  # :method: delete_customer(customer)
+  # You can also call
+  #    customer.delete!
+
+  ## 
+  # :method: delete_service(service)
+  # You can also call
+  #    service.delete!
+
+
+  ## 
+  # :method: delete_version(version)
+  # You can also call
+  #    version.delete!
+
+
+  ## 
+  # :method:delete_backend(backend)
+  # You can also call
+  #    backend.delete!
+
+
+  ##  
+  # :method: delete_director(backend)
+  # You can also call
+  #    backend.delete!
+
+
+  ## 
+  # :method: delete_domain(domain
+  # You can also call
+  #    domain.delete!
+
+
+  ## 
+  # :method: delete_match(match)
+  # You can also call
+  #    match.delete!(match)
+
+
+  ## 
+  # :method: delete_origin(origin)
+  # You can also call
+  #    origin.delete!
+
+
+  ## 
+  # :method: delete_vcl(vcl)
+  # You can also call
+  #    vcl.delete!
+
+
+  ## 
+  # :method: delete_version(version)
+  # You can also call
+  #    version.delete!
+
+
+
+  ##
+  # Attempts to load various config options in the form
+  # 
+  #    <key> = <value>
+  # 
+  # From a file.
+  # 
+  # Skips whitespace and lines starting with C<#>.
+  #
+  def self.load_config(file)
+    options = {}
+    return options unless File.exist?(file)
+
+    File.open(file, "r") do |infile|
+      while (line = infile.gets.chomp) do
+        next if     line =~ /^#/;
+        next if     line =~ /^\s*$/;
+        next unless line =~ /=/;
+        line.strip!
+        key, val = line.split(/\s*=\s*/, 2)
+        options[key] = val;
+      end
+    end
+    options;
+  end
+
+  ##
+  # Tries to load options from the file[s] passed in using, 
+  # C<load_options>, stopping when it finds the first one.
+  # 
+  # Then it overrides those options with command line options 
+  # of the form
+  # 
+  #     --<key>=<value>
+  #
+  def self.get_options(files)
+    options = {}
+    files.each do |file|
+      next unless File.exist?(file)
+      options = load_options(file)
+      break
+    end
+
+    while (ARGV.size>0 && ARGV[0] =~ /^-+(\w+)\=(\w+)$/) do
+      options[$1] = $2;
+      @ARGV.shift;
+    end
+    raise"Couldn't find options from command line arguments or #{files.join(', ')}" unless options.size>0
+    options;
+  end
+end