preposterous 0.0.2

data/.gitignore

@@ -0,0 +1 @@
+pkg/*

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2010 Ray Hernandez 
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,23 @@
+= preposterous 
+
+I'm hoping that I will stick to this and it will become a very functional Ruby based API for the Posterous(http://posterous.com) service.
+
+= what works?
+
+Right now it can get a list of posterous sites and post to posterous sites. 
+Media uploads are working for posting.
+
+== examples
+  
+See the post.rb example in the examples directory.
+
+http://github.com/hernan43/preposterous/tree/master/examples/post.rb
+
+== copyright?
+
+Since I've never really done anything like this, I am going to use John Nunemaker's(http://github.com/jnunemaker) Twitter gem(http://github.com/jnunemaker/twitter) design as an influence.
+
+Also when I say "influence" I mean this is basically a really jacked up fork of the jnunemaker twitter gem.
+
+Copyright (c) 2010 Ray Hernandez. See LICENSE for details.
+

data/Rakefile

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "preposterous"
+    gem.summary = %Q{a wrapper library for the Posterous API}
+    gem.description = %Q{This gem supports posting and listing sites on Posterous}
+    gem.email = "hernan43@gmail.com"
+    gem.homepage = "http://github.com/hernan43/preposterous"
+    gem.authors = ["Ray Hernandez"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end

data/VERSION.yml

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

data/examples/.gitignore

@@ -0,0 +1,5 @@
+dont_git_me.rb
+*.jpg
+*.png
+*.ppt
+*.xls

data/examples/post.rb

@@ -0,0 +1,54 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'preposterous')
+
+#
+# creating a posterous object
+#
+
+# all requests need to be authenticated
+# this creates your client object and sets up 
+# your posterous object for actions
+client = Preposterous::HTTPAuth.new("my@email.addre.ss", "password")
+posterous = Preposterous::Base.new(client)
+
+#
+# get and print a list of your posterous sites
+#
+posterous.getsites.each do |site|
+  puts "#{site['id']} #{site['url']}"
+end
+
+#
+# standard post w/no files
+#
+
+# initialize the fields
+# field names are here: http://posterous.com/api/posting
+fields = {
+  :site_id => 99999999,
+  :title => "This is my post",
+  :body => "This is some boring text for my autogenerated post."    
+}
+
+# perform the actual post
+posterous.newpost(fields, *files)
+
+#
+# standard post w/files
+#
+
+# initialize array of files
+files = [
+  File.open("file_one.png"),
+  File.open("file_two.png")
+]
+
+# initialize fields
+fields = {
+  :site_id => 1313830,
+  :title => "Check out these sweet pics",
+  :body => "I love these pics."    
+}
+
+# perform the actual post
+posterous.newpost(fields, *files)

data/lib/preposterous/base.rb

@@ -0,0 +1,82 @@
+module Preposterous
+  class Base
+    extend Forwardable
+    def_delegators :client, :get, :post
+    
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def getsites
+      response = perform_get("/api/getsites")
+      # parse out sites? not sure how I want the API to look
+      # for this. I have a couple of competing ideas...
+      response["site"] if not response.nil?
+    end
+
+    def newpost(fields={}, *files)
+      # create options hash
+      options = {:fields => fields}
+      options = build_multipart_bodies(*files).merge(options) if files
+
+      response = perform_post("/api/newpost", options)
+      # return post attrs
+      response["post"] if not response.nil?
+    end
+
+    # TODO: write readposts method
+    def readposts
+    end    
+
+    # TODO: write update method
+    def updatepost
+    end    
+
+    # TODO: write comment method
+    def newcomment
+    end    
+
+    # TODO: write gettags method
+    def gettags
+    end    
+
+    protected
+
+    CRLF = "\r\n"
+    def build_multipart_bodies(*files)
+      boundary = Time.now.to_i.to_s(16)
+      body = ""
+      files.each do |file|
+        esc_key = "media[]"
+        body << "--#{boundary}#{CRLF}"
+        if file.respond_to?(:read)
+          body << "Content-Disposition: form-data; name=\"#{esc_key}\"; filename=\"#{File.basename(file.path)}\"#{CRLF}"
+          body << "Content-Type: #{MIME::Types.type_for(file.path)[0].to_s}#{CRLF*2}"
+          body << file.read
+        else
+          body << "Content-Disposition: form-data; name=\"#{esc_key}\"#{CRLF*2}#{file}"
+        end
+        body << CRLF
+      end
+      body << "--#{boundary}--#{CRLF*2}"
+      {
+        :body => body,
+        :headers => {"Content-Type" => "multipart/form-data; boundary=#{boundary}"}
+      }
+    end
+
+
+    private
+
+    def perform_get(path, options={})
+      Preposterous::Request.get(self, path, options)
+    end
+
+    def perform_post(path, options={})
+      Preposterous::Request.post(self, path, options)
+    end
+
+  end
+end

data/lib/preposterous/httpauth.rb

@@ -0,0 +1,32 @@
+module Preposterous
+  class HTTPAuth
+    include HTTParty
+    format :xml
+
+    attr_reader :username, :password, :options
+
+    def initialize(username, password, options={})
+      @username, @password = username, password
+      @options = {:ssl => false}.merge(options)
+      # posterous' API URL is http://posterous.com/api
+      options[:api_endpoint] ||= "posterous.com"
+      self.class.base_uri "http#{'s' if options[:ssl]}://#{options[:api_endpoint]}"
+    end
+
+    def get(uri, headers={})
+      self.class.get(uri, :headers => headers, :basic_auth => basic_auth)
+    end
+
+    def post(uri, body={}, headers={})
+      self.class.post(uri, :body => body, :headers => headers, :basic_auth => basic_auth)
+    end
+
+    private
+
+    def basic_auth
+      {:username => @username, :password => @password}
+    end
+
+  end
+end
+

data/lib/preposterous/request.rb

@@ -0,0 +1,54 @@
+module Preposterous
+  class Request
+    extend Forwardable
+    def_delegators :client, :get, :post
+  
+    attr_reader :client, :method, :path, :options
+    
+    def self.get(client, path, options={})
+      new(client, :get, path, options).perform
+    end
+
+    def self.post(client, path, options={})
+      new(client, :post, path, options).perform
+    end
+
+    def initialize(client, method, path, options={})
+      @client, @method, @path, @options = client, method, path, options
+    end
+
+    def uri
+      @uri ||= begin
+        uri = URI.parse(path)
+        if options[:fields] && options[:fields] != {}
+          uri.query = to_query(options[:fields])
+        end
+
+        uri.to_s
+      end
+    end
+
+    def perform
+      Preposterous.make_friendly(send("perform_#{method}"))
+    end
+
+    private
+
+    def perform_get
+      get(uri, options[:headers])
+    end
+
+    def perform_post
+      post(uri, options[:body], options[:headers])
+    end
+
+    def to_query(options)
+      options.inject([]) do |collection, opt|
+        collection << "#{CGI.escape opt[0].to_s}=#{CGI.escape opt[1].to_s}"
+        collection
+      end * '&'
+    end
+
+  end
+end
+

data/lib/preposterous.rb

@@ -0,0 +1,20 @@
+require 'httparty'
+require 'forwardable'
+require 'cgi'
+require 'mime/types'
+
+module Preposterous
+  
+  # TODO: Add exceptions based on errors listed at: http://posterous.com/api/posting
+
+  def self.make_friendly(response)
+    Crack::XML.parse(response.body)["rsp"] if not response.nil?
+  end
+
+end
+
+# bring in all of the files in the lib dir
+directory = File.expand_path(File.dirname(__FILE__))
+require File.join(directory, "preposterous", "base")
+require File.join(directory, "preposterous", "httpauth")
+require File.join(directory, "preposterous", "request")

data/preposterous.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{preposterous}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ray Hernandez"]
+  s.date = %q{2010-05-07}
+  s.description = %q{This gem supports posting and listing sites on Posterous}
+  s.email = %q{hernan43@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "examples/.gitignore",
+     "examples/post.rb",
+     "lib/preposterous.rb",
+     "lib/preposterous/base.rb",
+     "lib/preposterous/httpauth.rb",
+     "lib/preposterous/request.rb",
+     "preposterous.gemspec"
+  ]
+  s.homepage = %q{http://github.com/hernan43/preposterous}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{a wrapper library for the Posterous API}
+  s.test_files = [
+    "examples/post.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: preposterous
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Ray Hernandez
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-07 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: This gem supports posting and listing sites on Posterous
+email: hernan43@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- examples/.gitignore
+- examples/post.rb
+- lib/preposterous.rb
+- lib/preposterous/base.rb
+- lib/preposterous/httpauth.rb
+- lib/preposterous/request.rb
+- preposterous.gemspec
+has_rdoc: true
+homepage: http://github.com/hernan43/preposterous
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: a wrapper library for the Posterous API
+test_files: 
+- examples/post.rb