blogger 0.5.0

data/History.txt

@@ -0,0 +1,8 @@
+=== 0.5.0 / 2009-03-24
+
+* First release
+
+  * Full access to the Blogger API
+  * 6 markup/markdown gems supported
+  * punch + pie
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/blogger.rb
+lib/google_auth.rb
+lib/helpers.rb
+test/test_blogger.rb

data/README.txt

@@ -0,0 +1,89 @@
+= blogger
+
+* http://beforefilter.blogspot.com/
+
+== DESCRIPTION:
+
+The Blogger module provides services related to Blogger, and only blogger. The
+GData gem is great, but it provides a much lower-level interface to Google's
+Blogger API. With the Blogger gem, you have full access to the Blogger API, 
+with easy to use classes, and it integrates with 6 different markup/markdown 
+gems! What's more, you won't have to muck around with XML.
+
+Sure, XML is easy. But why waste time messing around with it? With just 3 or 4
+lines of Blogger.gem code, you'll be able to take a markdown-formatted string
+and post it as a blog post, with categories, and comments.
+
+You can also search through all of your comments, old posts, and pretty much
+anything you can do at the blogger.com website, you can do with this gem.
+
+== FEATURES/PROBLEMS:
+
+* Full implementation of the Blogger API with simple to use classes
+* Support for 6 different markup/markdown gems, some compiled and some pure ruby
+* You'll never touch XML!
+* ETags not fully respected yet, however
+
+
+== SYNOPSIS:
+
+If you know your blog_id, then you can use this code:
+
+    require 'rubygems'
+    require 'blogger'
+    
+    account     = Blogger::Account.new("username","password")
+    new_post    = Blogger::Post.new(:title      => "New Post", 
+                                    :content    => "This is an *awesome* post",
+                                    :formatter  => :rdiscount,
+                                    :categories => ["coolness", "awesomeness"])
+    account.post(blog_id,post)
+    
+Otherwise, you'll need your username. You can perform
+
+    account  = Blogger::Account.new(user_id,"username","password")
+    new_post = Blogger::Post.new(:title => "New Post", 
+                                 :content => "This is an *awesome* post")
+    accounts.blogs.first.post(new_post)
+    
+and after that, throw a comment onto your new post:
+
+    new_post.comment(:title     => "New Comment!",
+                     :content   => "_freaking_ sweet",
+                     :formatter => :bluecloth)
+
+See the docs for different possibilities. The entirety of Google's Blogger API
+is implemented.
+
+== REQUIREMENTS:
+
+* atom-utils
+
+== INSTALL:
+
+* sudo gem install blogger --include-dependencies
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Michael J. Edgar
+
+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/Rakefile

@@ -0,0 +1,76 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/blogger.rb'
+
+Hoe.new('blogger', Blogger::VERSION) do |p|
+  # p.rubyforge_name = 'bloggerx' # if different than lowercase project name
+  p.developer('Michael J. Edgar', 'edgar@triqweb.com')
+  p.extra_deps << ['atom-tools', '>= 2.0.1']
+  p.remote_rdoc_dir = ''
+  desc 'Post your blog announcement to blogger.'
+  task :post_blogger do
+    require 'net/http'
+    require 'net/https'
+    p.with_config do |config, path|
+      break unless config['blogs']
+      subject, title, body, urls = p.announcement
+      #body += "\n\n#{urls}"
+      
+      config['blogs'].each do |site|
+        next unless site['url'] =~ /www\.blogger\.com/
+        google_email = site['user']
+        google_passwd = site['password']
+        source = 'beforefilter.blogspot.com-rubypost'
+
+        http = Net::HTTP.new('www.google.com', 443)
+        http.use_ssl = true
+        login_url = '/accounts/ClientLogin'
+
+        # Setup HTTPS request post data to obtain authentication token.
+        data = 'Email=' + google_email +'&Passwd=' + google_passwd + '&source=' + source + '&service=blogger'
+        headers = {
+          'Content-Type' => 'application/x-www-form-urlencoded'
+        }
+
+        # Submit HTTPS post request
+        resp, data = http.post(login_url, data, headers)
+
+        unless resp.code.eql? '200' 
+          puts "Error during authentication, blog at #{site['url']}, ##{site['blog_id']}: #{resp.message}\n"
+        else 
+
+          # Parse for the authentication token.
+          authToken = data.split("\n").map {|l| l.split("=")}.assoc("Auth")[1]
+
+          headers = {
+            'Authorization' => 'GoogleLogin auth=' + authToken,
+            'Content-Type' => 'application/atom+xml'
+          }
+
+          data = <<-EOF
+          <entry xmlns='http://www.w3.org/2005/Atom'>
+            <title type='text'>#{title}</title>
+            <content type='xhtml'>
+              <div xmlns="http://www.w3.org/1999/xhtml">
+                #{body}
+              </div>
+            </content>
+            #{p.blog_categories.inject("") {|acc,cat| acc + "<category scheme=\"http://www.blogger.com/atom/ns#\" term=\"#{cat}\" />\n"}}
+          </entry>
+          EOF
+          
+          http = Net::HTTP.new('www.blogger.com')
+          path = '/feeds/' + site['blog_id'] + '/posts/default'
+
+          resp, data = http.post(path, data, headers)
+          puts "Error while posting, blog at #{site['url']}, ##{site['blog_id']}: #{resp.message}" unless resp.code == 200
+          # Expect resp.code == 200 and resp.message == 'OK' for a successful.
+        end
+      end
+    end
+  end
+end
+
+# vim: syntax=Ruby

data/lib/blogger.rb

@@ -0,0 +1,543 @@
+require File.dirname(__FILE__)+'/google_auth.rb'
+require 'atom/feed' 
+require File.dirname(__FILE__)+'/helpers.rb'
+module Blogger
+  VERSION = '0.5.0'
+  class PostingError < StandardError # :nodoc:
+  end
+  
+  # = Formattable
+  # This mixin provides a number of formatters to any object with a content method. A large number of
+  # formatters are provided to acommodate those who are hosting on servers that limit their gem usage.
+  #
+  # The available formatters are:
+  #
+  # [:raw] content is passed directly into the post, with no formatting.
+  # [:redcloth] content is parsed as textile (using RedCloth[http://redcloth.org/] gem)
+  # [:bluecloth] content is parsed as textile (using BlueCloth[http://www.deveiate.org/projects/BlueCloth] gem)
+  # [:rdiscount] content is parsed as markdown (using rdiscount[http://tomayko.com/writings/ruby-markdown-libraries-real-cheap-for-you-two-for-price-of-one] gem)
+  # [:peg_markdown] content is parsed as markdown (using peg_markdown[http://tomayko.com/writings/ruby-markdown-libraries-real-cheap-for-you-two-for-price-of-one] gem)
+  # [:maruku] content is parsed as markdown (using maruku[http://maruku.rubyforge.org/] gem)
+  # [:haml] content is parsed as haml[http://haml.hamptoncatlin.com/]
+  
+  module Formattable
+    # Specifies how the content will be formatted. Can be any of the following:
+    #
+    # [:raw] content is passed directly into the post
+    # [:redcloth] content is parsed as textile (using RedCloth gem)
+    # [:bluecloth] content is parsed as textile (using BlueCloth gem)
+    # [:rdiscount] content is parsed as markdown (using rdiscount gem)
+    # [:peg_markdown] content is parsed as markdown (using peg_markdown gem)
+    # [:maruku] content is parsed as markdown (using maruku gem)
+    # [:haml] content is parsed as haml
+    #
+    # Note that these aren't all offered for the hell of it - some people have access to
+    # compiled gems, and some don't - some don't even get easy access to new
+    # pure Ruby gems on their server
+    attr_accessor   :formatter
+    
+    def format_content #:nodoc:
+      send("format_#{@formatter}".to_sym)
+    end
+    
+    def format_raw #:nodoc:
+      @content
+    end
+    
+    def format_redcloth #:nodoc:
+      require 'redcloth'
+      RedCloth.new(@content).to_html
+    end
+    
+    def format_bluecloth #:nodoc:
+      require 'bluecloth'
+      BlueCloth.new(@content).to_html
+    end
+    
+    def format_rdiscount #:nodoc:
+      require 'rdiscount'
+      RDiscount.new(@content).to_html
+    end
+    
+    def format_peg_markdown #:nodoc:
+      require 'peg_markdown'
+      PEGMarkdown.new(@content).to_html
+    end
+    
+    def format_maruku #:nodoc:
+      require 'maruku'
+      Maruku.new(@content).to_html
+    end
+    
+    def format_haml #:nodoc:
+      require 'haml'
+      Haml::Engine.new(@content).render
+    end
+    
+    ACCEPTABLE_FORMATTERS = [:raw, :rdiscount, :redcloth, :bluecloth, :peg_markdown, :maruku, :haml]
+    
+    def formatter=(format)  # :nodoc:
+      raise ArgumentError.new("Invalid formatter: #{format.inspect}") unless ACCEPTABLE_FORMATTERS.include?(format)
+      @formatter = format
+    end
+  end
+  
+  # = Account
+  #
+  # The Account class is how you interface with your Blogger.com account. You just
+  # need to know your username (google email address), password, and blog ID, and
+  # you're good to go. 
+  #
+  # Connect by creating a new Account as such:
+  #
+  #    account = Blogger::Account.new('username','password')
+  #
+  # You can make sure you're authenticated by calling account.authenticated?
+  #
+  # Example usage:
+  #
+  #    post = Blogger::Post.new(:title => "Sweet post", :categories = ["awesome", "sweet"])
+  #    post.draft = true
+  #    post.content = "I'll fill this in later"
+  #    Blogger::Account.new('username','password').post(blogid,post)
+  #
+  class Account
+
+    attr_accessor :username
+    attr_accessor :password
+    attr_accessor :auth_token
+    attr_accessor :user_id
+    
+    # Returns the blogs in this account. pass +true+ to force a reload.
+    def blogs(force_reload=false)
+      return @blogs if @blogs && !force_reload
+      retrieve_blogs
+    end
+    
+    # Returns the blog with the given ID
+    def blog_for_id(id)
+      blogs.select{|b| b.id.eql? id}.first
+    end
+    
+    # Creates a new Account object, and authenticates if the usename and password are
+    # provided.
+    def initialize(*args)
+      @user_id, @username, @password = args[0], "", ""  if args.size == 1 && args[0] =~ /^[0-9]+$/
+      @username, @password           = args[0], args[1] if args.size == 2
+      @user_kid, @username, @password = args[0], args[1], args[2] if args.size == 3
+      authenticate unless @username.empty? || @password.empty?
+      self
+    end
+    
+    # Downloads the list of all the user's blogs and stores the relevant information.
+    def retrieve_blogs(user_id="")
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless authenticated?
+      
+      user_id = (user_id.empty?) ? @user_id : user_id
+      
+      path = "/feeds/#{user_id}/blogs"   
+      resp = GoogleAuth.get(path, @auth_token)
+      feed = Atom::Feed.parse resp.body
+      
+      @blogs = []
+      feed.entries.each do |entry|
+        blog = Blogger::Blog.new(:atom => entry, :account => self)
+        @blogs << blog
+      end
+      @blogs
+    end
+    
+    # Re-authenticates (or authenticates if we didn't provide the user/pass earlier)
+    def authenticate(_username = "", _password = "")
+      username = (_username.empty?) ? @username : _username
+      password = (_password.empty?) ? @password : _password
+      
+      @auth_token = GoogleAuth::authenticate(username, password)
+      @authenticated = !( @auth_token.nil? )
+    end
+    
+    # Are we authenticated successfully? This method won't detect timeouts.
+    def authenticated?
+      @authenticated
+    end
+    
+    # Posts the provided post to the blog with the given ID. You can find your blog
+    # id by going to your blogger dashboard and selecting your blog - you'll find an
+    # address such as this in your bar:
+    #      http://www.blogger.com/posts.g?blogID=6600774877855692384 <-- your blog id
+    #
+    # Then just create a Blogger::Post, pass that in as well, and you're done!
+    #
+    def post(blog_id, post)
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless authenticated?
+
+      path = "/feeds/#{blog_id}/posts/default"
+      data = post.to_s
+      
+      resp = GoogleAuth.post(path, data, @auth_token)
+      
+      raise Blogger::PostingError.new("Error while posting to blog_id #{blog_id}: #{resp.message}") unless resp.code.eql? '201'
+      # Expect resp.code == 200 and resp.message == 'OK' for a successful.
+      Post.new(:atom => Atom::Entry.parse(resp.body), :blog => blog_for_id(blog_id))
+    end
+  end
+  
+  # = Blog
+  # Encapsulates a Blog retrieved from your user account. This class can be used
+  # for searching for posts, or for uploading posts via the +post+ method. Blog
+  # objects are only safely retrieved via the Blogger::Account class, either via
+  # Account#blogs or Account#blog_for_id.
+  #
+  class Blog
+    attr_accessor :title
+    attr_accessor :id
+    attr_accessor :authors
+    attr_accessor :published
+    attr_accessor :updated
+    attr_accessor :account
+    def initialize(opts = {}) #:nodoc:
+      entry = opts[:atom]
+      @authors = []
+      @title = entry.title.html.strip
+      @id = $2 if entry.id =~ /tag:blogger\.com,1999:user\-([0-9]+)\.blog\-([0-9]+)$/
+      entry.authors.each do |author|
+        @authors << author
+      end
+      @updated = entry.updated
+      @published = entry.published
+      @account = opts[:account] if opts[:account]
+    end
+    
+    # Uploads the provided post to this blog. Requires that you be logged into your
+    # blogger account via the Blogger::Account class.
+    def post(post)
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @account.authenticated?
+
+      path = "/feeds/#{@id}/posts/default"
+      data = post.to_s
+      
+      resp = GoogleAuth.post(path, data, @account.auth_token)
+      
+      raise Blogger::PostingError.new("Error while posting to blog_id #{@id}: #{resp.message}") unless resp.code.eql? '201'
+      post.parse Atom::Entry.parse(resp.body)
+    end
+    
+    def posts(force_reload = false)
+      return @posts if @posts && !(force_reload)
+      retrieve_posts
+    end
+    
+    # Downloads all the posts for this blog.
+    def retrieve_posts
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @account.authenticated?
+      
+      path = "/feeds/#{@id}/posts/default"
+      
+      resp = GoogleAuth.get(path, @account.auth_token)
+      
+      raise Blogger::RetrievalError.new("Error while retrieving posts for blog id ##{@id}: #{resp.message}") unless resp.code.eql? '200'
+      feed = Atom::Feed.parse(resp.body)
+      
+      @posts = []
+      feed.entries.each do |entry|
+        @posts << Post.new(:atom => entry, :blog => self)
+      end
+      @posts
+    end
+  end
+    
+  # = Post
+  # The post is the representation of a post on your blogger.com blog. It can handle
+  # the title, content, categories, and draft status of the post. These are used for
+  # uploading posts (just set the information to your liking) or retrieving them
+  # (read from the structure)
+  #
+  # Example:
+  #
+  #    post = Blogger::Post.new(:title => "Sweet post", :categories = ["awesome", "sweet"])
+  #    post.draft = true
+  #    post.content = "I'll fill this in later"
+  #    Blogger::Account.new('username','password').post(blogid,post)
+  #
+  class Post
+    # the id of the post
+    attr_accessor :id #:nodoc:
+    # the title of the post
+    attr_accessor :title
+    # the content of the post
+    attr_accessor :content 
+    # the categories of the post - array of strings
+    attr_accessor :categories 
+    # whether or not the post is a draft
+    attr_accessor :draft 
+    # list of all the comments on this post
+    attr_accessor :comments
+    # reference to the blog we belong to
+    attr_accessor :blog #:nodoc:
+    attr_accessor :etag #:nodoc:
+    
+    # Pass in a hash containing pre-set values if you'd like, including
+    #    * :title  -  the title of the post
+    #    * :content - the content of the post, either marked up or not
+    #    * :categories - a list of categories, or just one string as a category
+    #    * :draft - boolean, whether the post is a draft or not
+    #    * :formatter - the formatter to use. :raw, :bluecloth, :redcloth, :peg_markdown, :maruku, :haml or :rdiscount
+    #    * :blog - the blog this post belongs to
+    #
+    def initialize(opts = {})
+      @categories = []
+      if opts[:atom]
+        parse opts[:atom]
+      else
+        opts.each do |key, value|
+          next if key =~ /blog/
+          instance_variable_set("@#{key}".to_sym, value)
+        end
+      end
+      @blog = opts[:blog]
+      @categories = [@categories] unless @categories.is_a? Array
+      @formatter = (opts[:formatter]) ? opts[:formatter] : :raw
+    end
+    
+    def parse(entry) #:nodoc:
+      @atom = entry
+      @full_id = entry.id
+      @id = $2 if entry.id =~ /^tag:blogger\.com,1999:blog\-([0-9]+)\.post\-([0-9]+)$/
+      @title = entry.title.html.strip
+      @content = entry.content.html
+      @categories = entry.categories.map {|c| c.term}
+      @draft = entry.draft?
+      @etag = entry.etag
+      self
+    end
+    
+    # Saves any local changes to the post, and submits them to blogger.
+    def save
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @blog.account.authenticated?
+      
+      update_base_atom(@atom)
+      path = "/feeds/#{@blog.id}/posts/default/#{@id}"
+      
+      data = @atom.to_s.clean_atom_junk
+      
+      puts path+"\n\n"
+      puts data+"\n\n"
+      
+      
+      resp = GoogleAuth.put(path,data,@blog.account.auth_token, @etag)
+      
+      raise Blogger::PostingError.new("Error while updating post \"#{@title}\": #{resp.message}") unless resp.code.eql? '200'
+      
+      parse Atom::Entry.parse(resp.body)
+    end
+    alias_method :push, :save
+    
+    # Deletes the post from your blog.
+    def delete
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @blog.account.authenticated?
+      
+      path = "/feeds/#{@blog.id}/posts/default/#{@id}"
+      
+      resp = GoogleAuth.delete(path,@blog.account.auth_token, @etag)
+      
+      raise Blogger::PostingError.new("Error while deleting post \"#{@title}\": #{resp.message}") unless resp.code.eql? '200'
+      @blog.posts.delete self
+      self
+    end
+    
+    def update_base_atom(entry) #:nodoc:
+      entry.title = @title
+      
+      @categories.each do |cat|
+        atom_cat = Atom::Category.new
+        atom_cat.term = cat
+        atom_cat.scheme = 'http://www.blogger.com/atom/ns#'
+        entry.categories << atom_cat
+      end
+      
+      content = Atom::Content.new(format_content)
+      content.type = 'xhtml'
+      entry.content = content
+      entry.content.type = 'xhtml'
+      
+      entry.draft = @draft
+      entry
+    end
+      
+    
+    # Reloads the post from blogger.com, using ETags for efficiency.
+    def reload
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @blog.account.authenticated?
+      
+      path = "/feeds/#{@blog.id}/posts/default/#{@id}"
+      
+      resp = GoogleAuth.get(path, @blog.account.auth_token, @etag)
+      
+      raise Blogger::RetrievalError.new("Error while reloading post \"#{@title}\": #{resp.message}") unless resp.code.eql?('200') || resp.code.eql?('304')
+      unless resp.code.eql? '304'
+        parse Atom::Entry.parse(resp.body)
+      end
+      self
+    end
+    
+    # Returns whether the post is a draft or not
+    def draft?
+      @draft
+    end
+    
+    # Converts the post to an atom entry in string form. Internally used.
+    def to_s
+      entry = Atom::Entry.new
+      update_base_atom(entry)
+      
+      entry.to_s
+    end
+    
+    # Uploads this post to the provided blog.
+    def post_to(blog)
+      blog.post self
+    end
+    
+    include Formattable
+    
+    def inspect #:nodoc:
+      {:title => @title, :content => @content, :categories => @categories, :draft => @draft}.to_yaml
+    end
+    
+    # Submits a comment to this post. You can use 2 methods of submitting your comment:
+    #
+    #    my_comment = Comment.new(:title => "cool", :content => "I *loved* this post!", :formatter => :rdiscount)
+    #    mypost.comment(my_comment)
+    #
+    # or, more easily
+    #
+    #    mypost.comment(:title => "cool", :content => "I *loved* this post!", :formatter => :rdiscount)
+    #
+    # The currently authenticated user will be the comment author. This is a limitation of Blogger (and
+    # probably a good one!)
+    def comment(*args)
+      comm = (args[0].is_a? Blogger::Comment) ? args[0] : Blogger::Comment.new(args[0])
+      comm.post = self
+      
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @blog.account.authenticated?
+
+      path = "/feeds/#{@blog.id}/#{@id}/comments/default"
+      data = comm.to_s
+      
+      puts data+"\n\n"
+      
+      resp = GoogleAuth.post(path, data, @blog.account.auth_token)
+      
+      raise Blogger::PostingError.new("Error while commenting to post #{@title}: #{resp.message}") unless resp.code.eql? '201'
+      comm.parse Atom::Entry.parse(resp.body)
+    end
+    
+    # Returns all comments from the post. Passing +true+ to this method will cause a forced re-download of comments
+    def comments(force_download=false)
+      return @comments if @comments && !(force_download)
+      retrieve_comments
+    end
+    
+    # Downloads all comments from the post, and returns them ass Blogger::Comment objects.
+    def retrieve_comments
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @blog.account.authenticated?
+      
+      path = "/feeds/#{@blog.id}/#{@id}/comments/default"
+      
+      resp = GoogleAuth.get(path, @blog.account.auth_token)
+      
+      raise Blogger::RetrievalError.new("Error while retrieving comments for post id ##{@id}: #{resp.message}") unless resp.code.eql? '200'
+      feed = Atom::Feed.parse(resp.body)
+      
+      @comments = []
+      feed.entries.each do |entry|
+        @comments << Comment.new(:atom => entry, :post => self)
+      end
+      @comments
+    end
+  end
+  
+  # = Comment
+  # Represents a comment on a Blogger blog. Currently, Blogger only supports titles and contents
+  # for comments. The currently authenticated user will be used as the poster. To post a comment
+  # in response to a blogger post, simply use something like the following:
+  #
+  #    my_comment = Comment.new(:title => "cool", :content => "I *loved* this post!", :formatter => :rdiscount)
+  #    mypost.comment(my_comment)
+  #
+  # or, more easily
+  #
+  #    mypost.comment(:title => "cool", :content => "I *loved* this post!", :formatter => :rdiscount)
+  #
+  class Comment
+    # title of the comment
+    attr_accessor :title
+    # content of the comment, possibly in a markdown/textile format
+    attr_accessor :content
+    # the blog this comment belongs to (for already posted comments)
+    attr_accessor :post
+    # the comment's ID (for deletion)
+    attr_accessor :id
+    
+    # Creates a new comment. You can pass the following options:
+    #    * :title  -  the title of the comment
+    #    * :content - the content of the comment, either marked up or not
+    #    * :formatter - the formatter to use. :raw, :bluecloth, :redcloth, :peg_markdown, :maruku, :haml or :rdiscount
+    def initialize(opts={})
+      if opts[:atom]
+        parse(opts[:atom])
+      else
+        opts.each do |key, value|
+          next if key =~ /blog/
+          instance_variable_set("@#{key}".to_sym, value)
+        end
+      end
+      @post = opts[:post]
+      @formatter = :raw
+    end
+    
+    def parse(atom) #:nodoc:
+      @id = $2 if atom.id =~ /^tag:blogger\.com,1999:blog\-([0-9]+)\.post\-([0-9]+)$/
+      @title = atom.title
+      @content = atom.content
+    end
+    
+    include Formattable
+    
+    # formats the comment as an atom entry
+    def to_s
+      entry = Atom::Entry.new
+      entry.title = @title
+
+      content = Atom::Content.new(format_content)
+      content.type = 'html'
+      entry.content = content
+      entry.content.type = 'html'
+
+      entry.to_s
+    end
+    
+    # Deletes the comment from your blog.
+    def delete
+      NotLoggedInError.new("You aren't logged into Blogger.").raise unless @post.blog.account.authenticated?
+      
+      path = "/feeds/#{@post.blog.id}/#{@post.id}/comments/default/#{@id}"
+      
+      resp = GoogleAuth.delete(path,@post.blog.account.auth_token, @etag)
+      
+      raise Blogger::PostingError.new("Error while deleting comment \"#{@title}\": #{resp.message}") unless resp.code.eql? '200'
+      @post.comments.delete self
+      
+      self
+    end
+    
+    # Submits the comment to the provided post. Must be an actual post object, not an ID.
+    def post_to(post)
+      post.comment(self)
+    end
+    
+    def inspect #:nodoc:
+      {:title => @title, :content => @subject}.to_yaml
+    end
+  end
+end

data/lib/google_auth.rb

@@ -0,0 +1,74 @@
+require 'net/http'
+require 'net/https'
+class GoogleAuth
+  
+  class AuthenticationFailedError < StandardError; end
+  class NotLoggedInError < StandardError; end
+  
+  GA_SOURCE = 'beforefilter.blogspot.com-rubypost'
+  GA_GOOGLE = 'www.google.com'
+  GA_SERVICE = '/accounts/ClientLogin'
+  
+  def self.authenticate(username, password, print_debug = false)
+    http = Net::HTTP.new(GA_GOOGLE, 443)
+    http.use_ssl = true
+    login_url = GA_SERVICE
+
+    # Setup HTTPS request post data to obtain authentication token.
+    data = 'Email=' + username +'&Passwd=' + password + '&source=' + GA_SOURCE + '&service=blogger'
+    headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
+
+    # Submit HTTPS post request
+    response, data = http.post(login_url, data, headers)
+    pp response.inspect if print_debug
+    pp data.inspect     if print_debug
+    unless response.code.eql? '200' 
+      raise AuthenticationFailedError.new("Error during authentication: #{resp.message}")
+    else
+      data.split("\n").map {|l| l.split("=")}.assoc("Auth")[1]
+    end
+  end
+  
+  def self.default_headers(token)
+    {
+      'Authorization' => 'GoogleLogin auth=' + token,
+      'Content-Type' => 'application/atom+xml',
+      'GData-Version' => '2'
+    }
+  end
+  
+  def self.get(path, token, etag = nil)
+    headers = self.default_headers(token)
+    headers.merge!('If-None-Match' => "#{etag}") if etag
+    
+    http = Net::HTTP.new('www.blogger.com')
+    
+    http.get(path, headers)
+  end
+  
+  
+  def self.delete(path, token, etag = nil)
+    headers = self.default_headers(token)
+    
+    http = Net::HTTP.new('www.blogger.com')
+    req  = Net::HTTP::Delete.new(path, headers)
+    http.request(req)
+  end
+  
+  def self.put(path, data, token, etag = nil)
+    headers = self.default_headers(token)
+    
+    http = Net::HTTP.new('www.blogger.com')
+    req  = Net::HTTP::Put.new(path, headers)
+    http.request(req, data)
+  end
+  
+  def self.post(path, data, token)
+    headers = self.default_headers(token)
+    
+    http = Net::HTTP.new('www.blogger.com')
+    
+    http.post(path, data, headers)
+  end
+  
+end

data/lib/helpers.rb

@@ -0,0 +1,18 @@
+require 'atom/feed' 
+class ::String
+  
+  # atom/feed fudges up the atom feed google gives us so we have to manually insert some stuff
+  def clean_atom_junk
+    str = self
+    str = str.sub(/ xmlns/," xmlns:gd='http://schemas.google.com/g/2005' xmlns") unless str =~ /xmlns:gd/
+    "<?xml version='1.0' encoding='utf-8'?>" + str.gsub(/ etag='.*?' /," ")
+  end
+end
+
+
+module Atom
+  GD = "http://schemas.google.com/g/2005"
+  class Entry < Atom::Element
+    attrb ["gd", Atom::GD], "etag"
+  end
+end

data/test/test_blogger.rb

@@ -0,0 +1,8 @@
+require "test/unit"
+require "blogger"
+
+class TestBlogger < Test::Unit::TestCase
+  def test_sanity
+    flunk "write tests or I will kneecap you"
+  end
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: blogger
+version: !ruby/object:Gem::Version 
+  version: 0.5.0
+platform: ruby
+authors: 
+- Michael J. Edgar
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-25 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: atom-tools
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.11.0
+    version: 
+description: The Blogger module provides services related to Blogger, and only blogger. The GData gem is great, but it provides a much lower-level interface to Google's Blogger API. With the Blogger gem, you have full access to the Blogger API,  with easy to use classes, and it integrates with 6 different markup/markdown  gems! What's more, you won't have to muck around with XML.  Sure, XML is easy. But why waste time messing around with it? With just 3 or 4 lines of Blogger.gem code, you'll be able to take a markdown-formatted string and post it as a blog post, with categories, and comments.  You can also search through all of your comments, old posts, and pretty much anything you can do at the blogger.com website, you can do with this gem.
+email: 
+- edgar@triqweb.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/blogger.rb
+- lib/google_auth.rb
+- lib/helpers.rb
+- test/test_blogger.rb
+has_rdoc: true
+homepage: http://beforefilter.blogspot.com/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: blogger
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: The Blogger module provides services related to Blogger, and only blogger
+test_files: 
+- test/test_blogger.rb