posterous 0.2.0

data/.gitignore

@@ -0,0 +1,7 @@
+Gemfile.lock
+.bundle
+test.log
+.DS_Store
+config/flowb.yml
+spec/postly.yml
+pkg/

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+--format=nested

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.2@postly

data/Gemfile

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

data/README.md

@@ -0,0 +1,65 @@
+# Posterous #
+
+## Installation ##
+
+    gem install posterous
+    
+## Basic Usage ##
+    
+    require 'posterous'
+    
+    Posterous.config = {
+      'username' => <username>,
+      'password' => <password>,
+      'api_token' => '<api_token>'
+    }
+    
+    include Posterous
+    
+    ### Sites ###
+    p Site.all
+    p Site.primary
+    p Site.find('twoism')
+    
+    ### Posts ###
+    p Site.primary.posts
+    p Site.primary.posts.create(:title => 'New Post', :body => 'From posterous API', :media => [File.open('/path/to/file')])
+
+    
+## Interactive Console Usage ##
+
+  In your terminal type...
+  
+    $ posterous
+    
+  You will then be walked through the setup process. Type `newb` to get some help.
+    
+    ****************************************************************************************************
+    Hi <username>, welcome to the Posterous API Console! For help type `newb`.
+    ****************************************************************************************************
+    > newb
+    
+    # Get your primary site
+    > Site.primary
+    => <#<Posterous::Site:0x000001013e9b88> ... }>
+
+    # Get all your sites
+    > Site.all
+    => [<#<Posterous::Site:0x000001013e9b88> ... }>]
+
+    # Get any public site
+    > Site.find('twoism')
+    => <#<Posterous::Site:0x000001013e9b88> ... }>
+
+    # Get some posts
+    > s = Site.primary
+    > s.posts(:page => 1)
+    => [<#<Posterous::Post:0x0000010138ced8> ... }>]
+
+    # Create a post and add a comment to it
+    > s = Site.primary
+    > post = s.posts.create(:title => 'Woo Hoo!')
+     => <#<Posterous::Post:0x00000101398670> 
+    > post.comments.create(:body => 'Kittens are radical!')
+    => <#<Posterous::Comment:0x0000010135f758> ... }>
+    

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require "rspec/core/rake_task"
+task :spec do
+  RSpec::Core::RakeTask.new(:core) do |spec|
+    spec.pattern = 'spec/**/*_spec.rb'
+    spec.rspec_opts = ['--backtrace']
+  end
+end
+
+task :default => :spec

data/autotest/discovery.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/bin/posterous

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+
+RC_PATH   = "#{ENV['HOME']}/.posterousrc"
+HELP_DOC  = <<DOC
+## API Help ##
+
+# Get your primary site
+> Site.primary
+=> <#<Posterous::Site:0x000001013e9b88> ... }>
+
+# Get all your sites
+> Site.all
+=> [<#<Posterous::Site:0x000001013e9b88> ... }>]
+
+# Get any public site
+> Site.find('twoism')
+=> <#<Posterous::Site:0x000001013e9b88> ... }>
+
+# Get some posts
+> s = Site.primary
+> s.posts(:page => 1)
+=> [<#<Posterous::Post:0x0000010138ced8> ... }>]
+
+# Create a post and add a comment to it
+> s = Site.primary
+> post = s.posts.create(:title => 'Woo Hoo!')
+ => <#<Posterous::Post:0x00000101398670> 
+> post.comments.create(:body => 'Kittens are radical!')
+=> <#<Posterous::Comment:0x0000010135f758> ... }>
+DOC
+
+def newb
+  puts HELP_DOC
+end
+
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+%w{posterous irb}.each { |f| require f }
+
+rc  = File.open(RC_PATH,File::RDWR|File::APPEND|File::CREAT)
+yml = YAML.load_file(rc)
+
+if yml.is_a?(Hash)
+  cfg = yml
+else
+  cfg = {}
+  puts "Email Address:"
+  cfg['username'] = gets.chomp
+  puts "Password:"
+  cfg['password'] = gets.chomp
+  puts "Api Token:"
+  cfg['api_token'] = gets.chomp
+  rc.puts cfg.to_yaml
+end
+
+rc.close
+
+Posterous.config = cfg
+
+include Posterous
+
+@user = User.me
+puts "*"*100
+puts "Hi #{@user.nickname}, welcome to the Posterous API Console! For help type `newb`.\n"
+puts "*"*100
+
+IRB.setup(nil)
+irb = IRB::Irb.new
+
+IRB.conf[:MAIN_CONTEXT] = irb.context
+
+irb.context.evaluate("require 'irb/completion'", 0)
+
+trap("SIGINT") do
+  irb.signal_handle
+end
+
+catch(:IRB_EXIT) do
+  irb.eval_input
+end

data/lib/posterous/association_proxy.rb

@@ -0,0 +1,39 @@
+module Posterous
+  class AssociationProxy
+    attr_reader :klass, :proxied
+
+    instance_methods.each { |m| undef_method m unless m.to_s =~ /^(?:nil\?|send|object_id|to_a)$|^__|^respond_to|proxy_/ }
+    
+    def initialize proxied, klass, association_type, *args
+      @association_klass  = klass
+      @proxied            = proxied
+      @association        = nil
+
+      @association_klass.finder_opts[klass.parent_resource] = proxied.id
+      @association_klass.finder_opts.merge!(@proxied.finder_opts)
+
+      load_method   =  association_type == :many ? :all : :load
+      @association  = @association_klass.send(load_method, *args)
+    end
+
+    def method_missing sym, *args, &block
+      [@association_klass, @association].each do |assoc|
+        return assoc.send(sym, *args, &block) if assoc.respond_to?(sym)
+      end
+      super(sym, *args, &block)
+    end
+    
+    def respond_to?(*args)
+      [@association, @association_klass].any?{|a| a.respond_to?(*args) }
+    end
+
+    def new
+      @association_klass.new
+    end
+
+    def inspect
+      @association.inspect
+    end
+     
+  end
+end

data/lib/posterous/connection.rb

@@ -0,0 +1,52 @@
+module Posterous
+  module Connection
+
+    ConnectionError = Class.new(StandardError)
+
+    extend self
+
+    def http
+      Typhoeus::Request
+    end
+
+    def default_options
+      @default_options ||= { 
+        :username => Posterous.config['username'], 
+        :password => Posterous.config['password']
+      }
+    end
+
+    def default_params
+      @default_params ||= { :api_token => Posterous.config['api_token'] }
+    end
+
+    def parse json
+      parsed = JSON.parse json
+      parsed.delete('comments')
+      return parsed.map{|r| r.delete('comments'); OpenStruct.new(r) } if parsed.is_a?(Array)
+      OpenStruct.new(parsed)
+    rescue
+      nil
+    end
+
+    [:get, :post, :put, :delete].each do |verb|
+      define_method verb do |path, params={}|
+        puts "POSTLY :: #{verb.upcase} #{path} #{params}\n\n" if ENV['POSTLY_DEBUG']
+
+        response  = http.send(verb, "#{Posterous::BASE_API_URL}#{path}", 
+                      default_options.merge!(:params => default_params.merge!(params)))
+        result    = parse(response.body)
+        
+        puts "POSTLY :: #{response.body}\n\n" if ENV['POSTLY_DEBUG']
+
+        unless [200,201].include?(response.code)
+          msg = result.nil? ? response.body : "#{result.error} #{result.message}"
+          raise ConnectionError, msg 
+        end
+
+        result
+      end
+    end
+
+  end
+end

data/lib/posterous/inheritable.rb

@@ -0,0 +1,70 @@
+module Posterous
+  module Inheritable
+
+    def self.included klass
+      klass.class_eval do
+        extend ClassMethods
+        include InstanceMethods
+
+        inherited_attributes :finder_opts, :parent_resource, :resource_path
+        @finder_opts ||= {} 
+      end  
+    end
+
+    module ClassMethods
+      def inherited_attributes(*args)
+        @inherited_attributes ||= [:inherited_attributes]
+        @inherited_attributes += args
+        args.each do |arg|
+          class_eval %(
+            class << self; attr_accessor :#{arg} end
+          )
+        end
+        @inherited_attributes
+      end
+
+      def inherited(subclass)
+        @inherited_attributes.each do |inheritable_attribute|
+          instance_var = "@#{inheritable_attribute}"
+          subclass.instance_variable_set(instance_var, instance_variable_get(instance_var))
+        end
+      end
+
+      def resource path
+        @resource_path = path
+      end
+
+      def parent sym
+        @parent_resource = sym
+      end
+
+      def many collection_name, klass
+        define_method collection_name do |*args|
+          AssociationProxy.new self, klass, :many, *args
+        end
+      end
+
+      def one collection_name, klass
+        define_method collection_name do |*args|
+          AssociationProxy.new self, klass, :one, *args
+        end
+      end
+
+    end
+
+    module InstanceMethods
+      def resource_path
+        self.class.resource_path
+      end
+
+      def parent_resource
+        self.class.parent_resource
+      end
+      
+      def finder_opts
+        self.class.finder_opts
+      end
+    end
+
+  end
+end

data/lib/posterous/model.rb

@@ -0,0 +1,115 @@
+module Posterous
+  class Model
+    include Inheritable
+    extend Connection
+    
+    attr_reader :struct
+
+    # Get a collection for a model
+    #
+    # Site.posts.all(:page => 1)
+    def self.all params={}
+      result = get( parsed_resource_url, params )
+      result.collect{|s| self.new(s) }
+    end
+
+    # Get a model from a collection by its id.
+    #
+    # Site.primary.posts.find(123)
+    # Site.find(123)
+    def self.find mid
+      new get( parsed_resource_url + "/#{mid}")
+    end
+
+    # loads the model data from the server and
+    # instantiates a new instance of its class
+    #
+    # Site.primary.profile.load
+    def self.load
+      new get(parsed_resource_url) rescue self.new(OpenStruct.new)
+    end
+
+    # Used to scope query params for a given model
+    #
+    # Posterous::ExternalSite => external_site
+    def self.param_scope
+      underscore(self.to_s.split('::').last).to_sym
+    end
+
+    def param_scope
+      self.class.param_scope
+    end
+    
+    # lifted from ActiveSupport.
+    def self.underscore(camel_cased_word)
+      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
+
+    # Creates a new model with the given params.
+    # Converts a :media array into a hash to make
+    # the Rails app happy.
+    #
+    # Site.primary.posts.create(:title => 'Awesome!', :media => [File.open('../some/path')])
+    def self.create params={}
+      media_array = params.delete(:media)
+      media       = Hash[media_array.each_with_index.map{|v,i| [i,v] }] unless media_array.nil?
+
+      new post(parsed_resource_url, param_scope => params, :media => media)
+    end
+    
+    def save
+      return if hash_for_update.empty?
+      @struct = self.class.post(parsed_resource_url + "/#{self.id}", { param_scope => hash_for_update, '_method' => 'put' } )
+      changed_fields.clear
+    end
+
+    def destroy
+      self.class.delete(parsed_resource_url + "/#{self.id}")
+    end
+
+    def reload
+      self.class.find(self.id)
+    end
+
+    def self.parsed_resource_url
+      resource_path.gsub(/:\w+/) {|sym| finder_opts[sym.sub(/:/,'').to_sym] }
+    end
+
+    def parsed_resource_url
+      self.class.parsed_resource_url     
+    end
+        
+    def initialize struct
+      @struct = struct
+    end
+
+    def changed_fields
+      @changed_fields ||= []
+    end
+
+    def hash_for_update
+      Hash[changed_fields.collect{ |f| [f, self.send(f)] }]
+    end
+
+    def respond_to? *args
+      struct.respond_to?(*args) || super
+    end
+
+    def method_missing sym, *args, &block
+      if struct.respond_to? sym
+        changed_fields.push(sym.to_s.sub('=','').to_sym) if sym.to_s =~ /=/
+        return struct.send(sym,*args)
+      end
+      super(sym, *args, &block)
+    end   
+
+    def inspect
+      "<#{self} #{struct.send(:table).to_s}>"
+    end
+
+  end
+end

data/lib/posterous/models/comment.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class Comment < Posterous::Model
+    parent    :post_id
+    resource  "/sites/:site_id/posts/:post_id/comments"
+  end
+end

data/lib/posterous/models/external_site.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class ExternalSite < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/external_sites"
+  end
+end

data/lib/posterous/models/like.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class Like < Posterous::Model
+    parent    :post_id
+    resource  "/sites/:site_id/posts/:post_id/likes"
+  end
+end

data/lib/posterous/models/link.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class Link < Posterous::Model
+    parent    :link_category_id
+    resource  "/sites/:site_id/link_categories/:link_category_id/links"
+  end
+end

data/lib/posterous/models/link_category.rb

@@ -0,0 +1,8 @@
+module Posterous
+  class LinkCategory < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/link_categories"
+
+    many :links, Link
+  end
+end

data/lib/posterous/models/page.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class Page < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/pages"
+  end
+end

data/lib/posterous/models/post.rb

@@ -0,0 +1,9 @@
+module Posterous
+  class Post < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/posts"
+
+    many      :comments, Comment
+    many      :likes,    Like
+  end
+end

data/lib/posterous/models/profile.rb

@@ -0,0 +1,20 @@
+module Posterous
+  class Profile < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/profile"
+
+    def self.param_scope
+      'site_profile'
+    end
+
+    def save
+      return if hash_for_update.empty?
+      @struct = self.class.post(parsed_resource_url, { param_scope => hash_for_update, '_method' => 'put' } )
+      changed_fields.clear
+    end
+
+    def destroy
+      self.class.delete(parsed_resource_url)
+    end
+  end
+end

data/lib/posterous/models/site.rb

@@ -0,0 +1,22 @@
+module Posterous
+  class Site < Posterous::Model
+    resource "/sites"
+
+    one  :profile,          Profile
+    many :tags,             Tag
+    many :posts,            Post
+    many :pages,            Page
+    many :link_categories,  LinkCategory    
+    many :external_sites,   ExternalSite
+    many :subscribers,      Subscriber
+
+    def self.primary
+      find('primary')
+    end
+
+    def photos
+      self.class.get(parsed_resource_url + "#{self.id}/photos")
+    end
+    
+  end
+end

data/lib/posterous/models/subscriber.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class Subscriber < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/subscribers"
+  end
+end

data/lib/posterous/models/subscription.rb

@@ -0,0 +1,10 @@
+module Posterous
+  class Subscription < Posterous::Model
+    parent    :user_id
+    resource  "/users/:user_id/subscriptions"
+
+    def self.posts params={}
+      get(parsed_resource_url + '/posts',params).collect{|p| Post.new(p) }
+    end
+  end
+end

data/lib/posterous/models/tag.rb

@@ -0,0 +1,6 @@
+module Posterous
+  class Tag < Posterous::Model
+    parent    :site_id
+    resource  "/sites/:site_id/tags"
+  end
+end

data/lib/posterous/models/user.rb

@@ -0,0 +1,19 @@
+module Posterous
+  class User < Posterous::Model
+    resource  "/users"
+    many :subscriptions, Subscription
+
+    def self.me
+      find('me')
+    end
+
+    def favorites
+      self.class.get("/users/#{self.id}/favorites").collect{|f| Post.new(f) }
+    end
+
+    def likes
+      self.class.get("/users/#{self.id}/likes").collect{|f| Like.new(f) }
+    end
+  end
+end
+

data/lib/posterous/version.rb

@@ -0,0 +1,3 @@
+module Posterous
+  VERSION = "0.2.0"
+end

data/lib/posterous.rb

@@ -0,0 +1,39 @@
+%w[typhoeus yaml json ostruct].each { |lib| require lib }
+
+module Posterous
+  BASE_API_URL = 'http://posterous.com/api/v2'
+
+  extend self
+
+  attr_reader :config
+
+  autoload :Connection,         'posterous/connection'
+  autoload :Inheritable,        'posterous/inheritable'
+  autoload :Model,              'posterous/model'
+  autoload :Tag,                'posterous/models/tag'
+  autoload :User,               'posterous/models/user'
+  autoload :Site,               'posterous/models/site'
+  autoload :Profile,            'posterous/models/profile'
+  autoload :Post,               'posterous/models/post'
+  autoload :Page,               'posterous/models/page'
+  autoload :Comment,            'posterous/models/comment'
+  autoload :Like,               'posterous/models/like'
+  autoload :Link,               'posterous/models/link'
+  autoload :LinkCategory,       'posterous/models/link_category'
+  autoload :ExternalSite,       'posterous/models/external_site'
+  autoload :Subscriber,         'posterous/models/subscriber'
+  autoload :Subscription,       'posterous/models/subscription'
+  autoload :AssociationProxy,   'posterous/association_proxy'
+
+
+  def config=(cfg)
+    @config = case
+      when cfg.is_a?(File)
+        YAML.load_file(cfg)
+      when cfg.is_a?(Hash)
+        cfg
+      else
+        raise ArgumentError, 'Invalid Config'
+    end
+  end
+end

data/posterous.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "posterous/version"
+
+Gem::Specification.new do |s|
+  s.name        = "posterous"
+  s.version     = Posterous::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Christopher Burnett @twoism"]
+  s.email       = ["signalstatic@gmail.com"]
+  s.homepage    = "http://github.com/posterous/posterous-gem"
+  s.summary     = %q{Ruby wrapper for the Posterous REST API}
+  s.description = %q{Official Ruby wrapper for the Posterous REST API}
+
+  s.rubyforge_project = "posterous"
+
+  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 'typhoeus'
+  s.add_dependency 'json'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'ZenTest'
+  s.add_development_dependency 'autotest-growl'
+  s.add_development_dependency 'autotest-fsevent'
+end