posterous_api 0.1.0

data/.infinity_test

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+infinity_test do
+  use :test_framework => :rspec
+end

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--autotest
+--require fuubar --format Fuubar

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create 1.9.2@posterous_api

data/Gemfile

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+source :rubygems
+
+gem 'httparty', '0.6.1'
+gem 'jeweler'
+
+group :test do
+  gem 'rspec', '2.1.0'
+  gem 'fakeweb', '1.3.0'
+  gem 'infinity_test', '1.0.2'
+  gem 'fuubar'
+end

data/Gemfile.lock

@@ -0,0 +1,44 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    fakeweb (1.3.0)
+    fuubar (0.0.2)
+      rspec (~> 2.0)
+      rspec-instafail (~> 0.1.4)
+      ruby-progressbar (~> 0.0.9)
+    git (1.2.5)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    infinity_test (1.0.2)
+      notifiers (>= 1.1.0)
+      watchr (>= 0.7)
+    jeweler (1.5.1)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    notifiers (1.1.0)
+    rake (0.8.7)
+    rspec (2.1.0)
+      rspec-core (~> 2.1.0)
+      rspec-expectations (~> 2.1.0)
+      rspec-mocks (~> 2.1.0)
+    rspec-core (2.1.0)
+    rspec-expectations (2.1.0)
+      diff-lcs (~> 1.1.2)
+    rspec-instafail (0.1.4)
+    rspec-mocks (2.1.0)
+    ruby-progressbar (0.0.9)
+    watchr (0.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  fakeweb (= 1.3.0)
+  fuubar
+  httparty (= 0.6.1)
+  infinity_test (= 1.0.2)
+  jeweler
+  rspec (= 2.1.0)

data/Rakefile

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "posterous_api"
+    gemspec.summary = ""
+    gemspec.description = ""
+    gemspec.email = "tomasdestefi@gmail.com"
+    gemspec.homepage = "http://github.com/tomas-stefano/posterous_api"
+    gemspec.authors = ["Tomas D'Stefano"]
+
+    gemspec.add_dependency('httparty', '>= 0.6.1')
+
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts("-" * 80)
+  puts "Jeweler not available. Install it with:
+  [sudo] gem install jeweler"
+  puts("-" * 80)
+end

data/Readme.markdown

@@ -0,0 +1,27 @@
+# Posterous API
+
+Posterous API is a extraction from Reblog application (that is not ready in production, but will be =] )
+
+## Install 
+
+    gem install posterous_api
+
+## Require
+
+    require 'posterous_api'
+
+## Using
+
+    user = Posterous::User.new('my_user@email.com', 'my_password')
+    
+    user.blogs #	=> return all blogs from posterous
+    
+    users.posts_from :blog => 'site_id'
+    
+    user.tasgs_from :blog => 'site_id'
+
+# More Features
+
+Just read the source code man!
+
+=p

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:major: 0
+:minor: 1
+:patch: 0
+:build: 

data/lib/posterous_api.rb

@@ -0,0 +1,9 @@
+require 'httparty'
+
+module Posterous
+  autoload :BaseURI, 'posterous_api/base_uri'
+  autoload :User, 'posterous_api/user'
+  autoload :Connection, 'posterous_api/connection'
+  autoload :NewAPI, 'posterous_api/new_api'
+  autoload :OldAPI, 'posterous_api/old_api'
+end

data/lib/posterous_api/base_uri.rb

@@ -0,0 +1,10 @@
+module Posterous
+  module BaseURI
+    
+    # Base URI for the Posterous API
+    #
+    def base_uri
+      @base_uri ||= "http://posterous.com/api"
+    end
+  end
+end

data/lib/posterous_api/connection.rb

@@ -0,0 +1,25 @@
+module Posterous
+  module Connection
+    
+    def get(uri, options={})
+      klass = options[:klass] || HTTParty
+      klass.get(uri, { :basic_auth => credentials }.merge(options))
+    end
+        
+    def post(uri, options={})
+      klass = options[:klass] || HTTParty
+      klass.post(uri, {:basic_auth => credentials}.merge(options))
+    end
+    
+    def put(uri, options)
+      klass = options[:klass] || HTTParty
+      klass.put(uri, :basic_auth => credentials)
+    end
+
+    def delete(uri, klass=HTTParty)
+      klass = options[:klass] || HTTParty
+      klass.delete(uri, :basic_auth => credentials)
+    end
+
+  end
+end

data/lib/posterous_api/new_api.rb

@@ -0,0 +1,44 @@
+module Posterous
+  module NewAPI
+    include BaseURI
+
+    # The get sites uri to get all the sites from a user
+    #
+    # Fields:
+    #   None
+    #
+    def get_sites_uri
+      @get_sites_uri ||= "#{base_uri}/2/users/me/sites"
+    end
+
+    # Get the primary site from a user
+    #
+    def user_primary_site_uri 
+      @user_primary_site_uri ||= "#{base_uri}/api/2/users/me/sites/primary"
+    end
+
+    # Create a site url
+    #
+    def create_site_uri
+      @create_site_uri ||= "#{base_uri}/api/2/users/me/sites"
+    end
+
+    # Get a User Uri
+    #
+    def get_a_user_uri
+      @get_a_user_uri ||= "#{base_uri}/api/2/users/me"
+    end
+
+    # Public posts uri from your primary site
+    #
+    def public_posts_from_primary_site_uri
+      @public_posts_from_primary_site_uri ||= "#{base_uri}/api/2/users/me/sites/primary/posts/public"
+    end
+
+    # The auth token uri to get the token
+    #
+    def auth_token_uri
+      @auth_token_uri ||= "#{base_uri}/2/auth/token"
+    end
+  end
+end

data/lib/posterous_api/old_api.rb

@@ -0,0 +1,65 @@
+# Old API of Posterous:
+
+# http://posterous.com/api/reading
+
+module Posterous
+  module OldAPI
+    include BaseURI
+    
+    def get_all_sites_uri
+      @get_all_sites_uri ||= "#{base_uri}/getsites"
+    end
+    
+    # The get tags uri to get all the tags
+    #
+    # Fields:
+    #  "site_id" - Optional. Id of the site to read from
+    #  "hostname" - Optional. Subdomain of the site to read from
+    #
+    def get_tags_uri
+      @get_tags_uri ||= "#{base_uri}/gettags"
+    end
+
+    # The read posts uri to get all the posts from a site
+    #
+    #  Fields:
+    #  "site_id" - Optional. Id of the site to read from
+    #  "hostname" - Optional. Subdomain of the site to read from
+    #  "num_posts" - Optional. How many posts you want. Default is 10, max is 50
+    #  "page" - Optional. What 'page' you want (based on num_posts). Default is 1
+    #  "tag" - Optional
+    #
+    def read_posts_uri
+      @read_posts_uri ||= "#{base_uri}/readposts"
+    end
+
+    #  Fields:
+    #    "site_id" - Optional. Id of the site to post to. If not supplied, posts to the user's default site
+    #    "media" - Optional. File data for single file.
+    #    "media[]" - Optional. File data for multiple file upload. Can be specified multiple times.
+    #    "title" - Optional. Title of post
+    #    "body" - Optional. Body of post
+    #    "autopost" - Optional. 0 or 1.
+    #    "private" - Optional. 0 or 1.
+    #    "date" - Optional. In GMT. Any parsable format. Cannot be in the future.
+    #    "tags" - Optional. Comma separate tags
+    #    "source" - Optional. The name of your application or website
+    #    "sourceLink" - Optional. Link to your application or website
+    #
+    def new_post_uri
+      @new_post_uri ||= "#{base_uri}/newpost"
+    end
+
+    #  Fields:
+    #    "post_id" - Id of the post to update.
+    #    "media" - Optional. File data for single file. Will append to post.
+    #    "media[]" - Optional. File data for multiple file upload. Can be specified multiple times. Will append to post.
+    #    "title" - Optional. Title of post. Will update post if present.
+    #    "body" - Optional. Body of post. Will update post if present.
+    #
+    def update_post_uri
+      @update_post_uri ||= "#{base_uri}/updatepost"
+    end
+    
+  end
+end

data/lib/posterous_api/user.rb

@@ -0,0 +1,61 @@
+module Posterous
+  class User
+    attr_accessor :email, :password
+    include Connection
+    include OldAPI
+    
+    # http://posterous.com/api/posting
+    
+    # Initialize of a Client with email and password
+    #
+    def initialize(email, password)
+      @email = email
+      @password = password
+    end
+    
+    # Return the credentials to use with the old API
+    #
+    # user.credentials
+    #
+    def credentials
+      { :username => @email, :password => @password }
+    end
+    
+    # Return all the sites for that user
+    #
+    # user.blogs
+    #
+    def blogs
+      get(get_all_sites_uri)
+    end
+    
+    # Return all the posts from a blog
+    #
+    # user.posts_from :blog => '123456'
+    #
+    def posts_from(options={})
+      get(read_posts_uri, { :site_id => options[:blog]})
+    end
+    alias :posts :posts_from
+    
+    # Return all the tags from a blog
+    #
+    # user.tags_from :blog => '123456'
+    #
+    def tags_from(options={})
+      get(get_tags_uri, { :site_id => options[:blog]})
+    end
+    
+    # Create a new post in a blog
+    #
+    # user.create_post_for :blog => '123456', :title => 'My title', :body => 'Body'
+    #
+    def create_post_for(options)
+      site_id = options[:blog]
+      options.delete(:blog)
+      options[:site_id] = site_id
+      post(new_post_uri, options)
+    end
+
+  end
+end

data/posterous_api.gemspec

@@ -0,0 +1,74 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{posterous_api}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tomas D'Stefano"]
+  s.date = %q{2010-11-20}
+  s.description = %q{}
+  s.email = %q{tomasdestefi@gmail.com}
+  s.files = [
+    ".infinity_test",
+    ".rspec",
+    ".rvmrc",
+    "Gemfile",
+    "Gemfile.lock",
+    "Rakefile",
+    "Readme.markdown",
+    "VERSION.yml",
+    "lib/posterous_api.rb",
+    "lib/posterous_api/base_uri.rb",
+    "lib/posterous_api/connection.rb",
+    "lib/posterous_api/new_api.rb",
+    "lib/posterous_api/old_api.rb",
+    "lib/posterous_api/user.rb",
+    "posterous_api.gemspec",
+    "spec/posterous_api/base_uri_spec.rb",
+    "spec/posterous_api/connection_spec.rb",
+    "spec/posterous_api/new_api_spec.rb",
+    "spec/posterous_api/old_api_spec.rb",
+    "spec/posterous_api/posterous_api_spec.rb",
+    "spec/posterous_api/user_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/faker_response.rb"
+  ]
+  s.homepage = %q{http://github.com/tomas-stefano/posterous_api}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{}
+  s.test_files = [
+    "spec/posterous_api/base_uri_spec.rb",
+    "spec/posterous_api/connection_spec.rb",
+    "spec/posterous_api/new_api_spec.rb",
+    "spec/posterous_api/old_api_spec.rb",
+    "spec/posterous_api/posterous_api_spec.rb",
+    "spec/posterous_api/user_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/faker_response.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, ["= 0.6.1"])
+      s.add_runtime_dependency(%q<jeweler>, [">= 0"])
+      s.add_runtime_dependency(%q<httparty>, [">= 0.6.1"])
+    else
+      s.add_dependency(%q<httparty>, ["= 0.6.1"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<httparty>, [">= 0.6.1"])
+    end
+  else
+    s.add_dependency(%q<httparty>, ["= 0.6.1"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<httparty>, [">= 0.6.1"])
+  end
+end
+

data/spec/posterous_api/base_uri_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+module Posterous
+  describe BaseURI do
+    include BaseURI
+    describe '#base_uri' do
+      it "should return the base uri" do
+        base_uri.should == "http://posterous.com/api"
+      end
+    end
+  end
+end

data/spec/posterous_api/connection_spec.rb

@@ -0,0 +1,6 @@
+require 'spec_helper'
+
+module Posterous
+  describe Connection do
+  end
+end

data/spec/posterous_api/new_api_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+module Posterous
+  describe NewAPI do
+    include NewAPI
+
+    it "should return the auth token uri" do
+      auth_token_uri.should == "#{@base_uri}/2/auth/token"
+    end
+
+    context 'in sites' do
+
+      it "should return the get sites uri" do
+        get_sites_uri.should == "#{@base_uri}/2/users/me/sites"
+      end
+
+      it "should return a uri from users primary site" do
+        user_primary_site_uri.should == "#{@base_uri}/api/2/users/me/sites/primary"
+      end
+
+      it "should return a uri from create a site" do
+        create_site_uri.should == "#{@base_uri}/api/2/users/me/sites"
+      end
+
+    end
+
+    context 'in users' do
+
+      it "should return a uri to get a user" do
+        get_a_user_uri.should == "#{@base_uri}/api/2/users/me"
+      end
+
+    end
+
+    context 'in posts' do
+
+      it "should return the public posts from the primary site uri" do
+        public_posts_from_primary_site_uri.should == "#{@base_uri}/api/2/users/me/sites/primary/posts/public"
+      end
+
+    end
+    
+  end
+end

data/spec/posterous_api/old_api_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+module Posterous
+  describe OldAPI do
+    include OldAPI
+    context 'blogs' do
+      it "should return the get all blogs uri" do
+        get_all_sites_uri.should == "#{@base_uri}/getsites"
+      end
+    end
+    
+    context 'posts' do
+      it "should return the read posts uri" do
+        read_posts_uri.should == "#{@base_uri}/readposts"
+      end
+
+      it "should return the get tags uri" do
+        get_tags_uri.should == "#{@base_uri}/gettags"
+      end
+
+      it "should return the new post uri" do
+        new_post_uri.should == "#{@base_uri}/newpost"
+      end
+
+      it "should return the update post uri" do
+        update_post_uri.should == "#{@base_uri}/updatepost"
+      end
+      
+    end
+  end
+end

data/spec/posterous_api/posterous_api_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Posterous do
+end

data/spec/posterous_api/user_spec.rb

@@ -0,0 +1,88 @@
+require 'spec_helper'
+
+FakeWeb.allow_net_connect = false
+
+module Posterous
+  describe User do
+    let(:user) { Posterous::User.new('fake_email@gmail.com', 'secret')}
+    let(:batman) { Posterous::User.new('batman@gmail.com', 'super_secret') }
+    include FakerResponse
+    
+    describe '#initialize' do
+      
+      it "should storage the email of the user" do
+        Posterous::User.new('my_email@gmail.com', 'password').email.should == "my_email@gmail.com"
+      end
+      
+      it "should storage the password for user" do
+        Posterous::User.new('my_email@gmail.com', 'secret').password.should == 'secret'
+      end
+      
+    end
+    
+    describe '#credentials' do
+      it "should return a instance of Hash" do
+        user.credentials.should be_instance_of(Hash)
+      end
+      
+      it "should return a username in the key" do
+        user.credentials.should have_key(:username)
+      end
+      
+      it "should have the email in the username value" do
+        user.credentials.should have_value(user.email)
+      end
+      
+      it "should return a username in the key" do
+        user.credentials.should have_key(:password)
+      end
+      
+      it "should have the password in the email value" do
+        user.credentials.should have_value(user.password)
+      end
+    end
+    
+    describe '#blogs' do
+      
+      it "should call the Httparty" do
+        mock_sites(user)
+        user.blogs
+      end
+    end
+    
+    describe '#posts' do
+      
+      it "should return a post from a site in a instance of Array" do
+        mock_posts(user, '12345')
+        user.posts_from(:blog => '12345')
+      end
+      
+    end
+
+    describe '#tags_from' do
+      it "should pass to HTTParty the uri and the site id" do
+        mock_tags(user, '126789')
+        user.tags_from(:blog => '126789')
+      end
+    end
+
+    describe '#create_post_for' do
+      
+      it "should call the Httparty get method with the right uri" do
+        mock_create_post(user, :blog => '12345', :title => 'Just the title', :body => 'The body of the post!')
+        user.create_post_for :blog => '12345', :title => 'Just the title', :body => 'The body of the post!'
+      end
+      
+    end
+
+    describe '#get' do
+      
+      it "should get all the blogs from user" do
+        mock_sites(batman)
+        batman.get(batman.get_all_sites_uri).should == 'response'
+      end
+      
+    end
+    
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rspec'
+require 'posterous_api'
+require 'fakeweb'
+require 'support/faker_response'
+
+RSpec.configure do |config|
+  config.include FakerResponse
+end

data/spec/support/faker_response.rb

@@ -0,0 +1,43 @@
+
+module FakerResponse
+  def blogs_response
+    { 
+      "rsp" => {       
+        "site" => [ 
+          { "id" => "2165389", "name" => "testandoreblog's posterous" }
+        ] }
+     }
+  end
+  
+  def mock_sites(user)
+    HTTParty.should_receive(:get).with(user.get_all_sites_uri, 
+        :basic_auth => { :username => user.email, :password => user.password
+          }).and_return('response')
+  end
+  
+  def mock_posts(user, blog_id)
+    HTTParty.should_receive(:get).with(user.read_posts_uri, 
+        :basic_auth => { :username => user.email, :password => user.password},
+        :site_id => blog_id
+    ).and_return('response')
+  end
+  
+  def mock_tags(user, blog_id)
+    HTTParty.should_receive(:get).with(user.get_tags_uri, 
+        :basic_auth => { :username => user.email, :password => user.password},
+        :site_id => blog_id
+    ).and_return('response')      
+  end
+  
+  def mock_create_post(user, options)
+    blog = options[:blog]
+    options.delete(:blog)
+    HTTParty.should_receive(:post).with(user.new_post_uri, 
+        {:basic_auth => { :username => user.email, :password => user.password},
+        :site_id => blog,
+        :title => nil,
+        :body => nil }.merge(options)
+    ).and_return('response')    
+  end
+  
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification 
+name: posterous_api
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tomas D'Stefano
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-20 00:00:00 -02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *id003
+description: ""
+email: tomasdestefi@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .infinity_test
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- Readme.markdown
+- VERSION.yml
+- lib/posterous_api.rb
+- lib/posterous_api/base_uri.rb
+- lib/posterous_api/connection.rb
+- lib/posterous_api/new_api.rb
+- lib/posterous_api/old_api.rb
+- lib/posterous_api/user.rb
+- posterous_api.gemspec
+- spec/posterous_api/base_uri_spec.rb
+- spec/posterous_api/connection_spec.rb
+- spec/posterous_api/new_api_spec.rb
+- spec/posterous_api/old_api_spec.rb
+- spec/posterous_api/posterous_api_spec.rb
+- spec/posterous_api/user_spec.rb
+- spec/spec_helper.rb
+- spec/support/faker_response.rb
+has_rdoc: true
+homepage: http://github.com/tomas-stefano/posterous_api
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: ""
+test_files: 
+- spec/posterous_api/base_uri_spec.rb
+- spec/posterous_api/connection_spec.rb
+- spec/posterous_api/new_api_spec.rb
+- spec/posterous_api/old_api_spec.rb
+- spec/posterous_api/posterous_api_spec.rb
+- spec/posterous_api/user_spec.rb
+- spec/spec_helper.rb
+- spec/support/faker_response.rb