siyelo-blogify 0.1.2

data/CHANGELOG

@@ -0,0 +1,12 @@
+== 0.1.1
+
+* initial commit
+
+* enhancements
+  * n/a
+
+* bug fix
+  * n/a
+
+* deprecation
+  * none

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2010 Siyelo. http://www.siyelo.com
+
+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,94 @@
+== Blogify
+
+A Rails engine for embedding Posterous blog extracts
+
+== Dependencies
+
+Blogify needs;
+
+  glennr-posterous (may also work with the original posterous gem)
+  httparty (a requirement of the posterous gem)
+  rufus-scheduler (for caching the blog posts in the background)
+
+== Installation
+
+All gems are on gemcutter, so you need to add gemcutter to your sources if you havent yet:
+
+  sudo gem sources -a http://gemcutter.org/
+
+Install required gem if you dont already have them
+
+  sudo gem install httparty
+  sudo gem install glennr-posterous
+  sudo gem install rufus-scheduler
+
+Install the blogify gem:
+
+  sudo gem install siyelo-blogify
+
+Configure gems inside your app:
+
+  config.gem 'httparty'
+  config.gem 'glennr-posterous', :lib => "posterous"
+  config.gem 'rufus-scheduler'
+  config.gem 'siyelo-blogify', :lib => "blogify"
+
+Run the generator:
+
+	ruby script/generate blogify_install
+
+And you're ready to go. The generator will install an initializer which describes ALL Blogify's configuration options, so be sure to take a look at it.
+
+== Basic Usage
+
+Once the rufus scheduler task is running, it will go off and cache your last N (BlogPost.post_limit) blog posts locally
+
+Inside your relevant controller, all you need to do is read the cached posts from your database.
+
+  @blog_posts = BlogPost.find(:all, :limit => BLOG_POST_LIMIT)
+
+And render them in your view as you wish
+
+For convenience, some partials are included
+
+  = render :partial => '/blog_posts/list', :locals => { :blog_posts => @news_posts }
+
+== Advanced Usage
+
+Blogify can also work with multiple Posterous blogs. The BlogPost model is compatible with STI, so all you need to do is subclass it. E.g. in app/models/news_post.rb
+
+  def NewsPost < BlogPost
+  ...
+  end
+
+You'll need to set up your rufus cron task to cache the relevant blog posts
+
+  scheduler.every '1h' do
+    ...
+    NewsPost.cache_posts( 'some_other_posterous_user', 5)
+  end
+
+And the controller/views work pretty much the same
+
+  @news_posts = NewsPost.find(:all, :limit => BLOG_POST_LIMIT)
+
+== TODO
+
+Please refer to TODO file.
+
+== Maintainers
+
+* Glenn Roberts
+
+== Contributors
+
+Check them in the CHANGELOG or do `git shortlog -s -n` in the cloned repository.
+
+== Bugs and Feedback
+
+If you discover any bugs or want to drop a line, feel free to create an issue on
+GitHub.
+
+http://github.com/siyelo/blogify/issues
+
+MIT License. Copyright 2010. Siyelo Software CC. http://www.siyelo.com

data/Rakefile

@@ -0,0 +1,44 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "siyelo-blogify"
+    gem.summary = %Q{A Rails engine for embedding Posterous blog extracts}
+    gem.description = %Q{A Rails engine for embedding Posterous blog extracts}
+    gem.email = "glenn.roberts@siyelo.com"
+    gem.homepage = "http://github.com/siyelo/siyelo-blogify"
+    gem.authors = ["Glenn Roberts"]
+    gem.add_development_dependency "glennr-posterous", ">= 0.1.7"
+    gem.add_development_dependency "httparty", '>=0.5.0'
+    gem.add_development_dependency 'rufus-scheduler', '>=2.0.3'
+    gem.files =  FileList["[A-Z]*", "{app,config,generators,lib}/**/*", "init.rb"]
+    # 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
+
+desc 'Run Blogify unit tests.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for Blogify.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Blogify'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc 'Default: run unit tests.'
+task :default => :test

data/TODO

@@ -0,0 +1,3 @@
+
+write tests
+test the app with the posterous gem (not glennr-posterous)

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/app/helpers/blog_posts_helper.rb

@@ -0,0 +1,9 @@
+module BlogPostsHelper
+
+  def pluralize_if(count, string)
+    result = "#{count.to_s} #{string.pluralize}"
+    result = "#{count.to_s} #{string}" if count == 1
+    result
+  end
+
+end

data/app/models/blog_post.rb

@@ -0,0 +1,62 @@
+class BlogPost < ActiveRecord::Base
+
+  cattr_accessor :default_posterous_user
+  @@default_posterous_user = nil
+
+  cattr_accessor :read_timeout
+  @@read_timeout = 5.seconds
+
+  cattr_accessor :post_limit
+  @@post_limit = 3
+
+  cattr_accessor :debug
+  @@debug = false
+
+  attr_accessible :title, :body, :url, :comment_count, :posted
+
+
+  def self.cache_posts( posterous_user = default_posterous_user, count = post_limit )
+    posts = self.read_posts( posterous_user, count)
+    self.update_posts(posts)
+  end
+
+  protected
+
+    def self.read_posts( posterous_user, count )
+      posts = []
+      begin
+        timeout(read_timeout) do
+          reader = Posterous::Reader.new(posterous_user, nil, count)
+          posts = reader.response
+          if !reader.response[0]      # then we only got one result
+            posts = [reader.response]  # force it into an hash of hashes
+          end
+        end
+      rescue TimeoutError
+        logger.warn("Timeout accessing Posterous Blog: #{$!}, #{$@}")
+      rescue
+        logger.warn("Error accessing Posterous blog: #{$!}")
+      end
+
+      posts
+    end
+
+    def self.update_posts(posts)
+      unless posts.empty?
+        old_posts = self.find(:all, :order => 'created_at')
+
+        posts.each do |p|
+          b = self.new( :title          => p['title'],
+                        :body           => p['body'],
+                        :url            => p['link'],
+                        :comment_count  => p['commentsCount'].to_i,
+                        :posted         => p['date'].to_date)
+
+          b.save
+          # expire oldest
+          old_posts.pop.destroy unless old_posts.empty?
+        end
+      end
+    end
+
+end

data/app/views/blog_posts/_list.html.haml

@@ -0,0 +1,13 @@
+- posts = []
+- posts = blog_posts if !blog_posts.nil?
+
+.blog_posts
+  - posts.each do |p|
+    - comment_count = p.comment_count.to_i
+    .post
+      .top
+        %p
+          %span.gray= time_ago_in_words(p.posted) + " ago"
+          = link_to pluralize_if(comment_count,"comment"), p.url
+      .bottom
+        %p= link_to h(p.title), p.url

data/app/views/blog_posts/_long_list.html.haml

@@ -0,0 +1,15 @@
+- posts = []
+- posts = blog_posts if !blog_posts.nil?
+
+.blog_posts
+  - posts.each do |p|
+    - comment_count = p.comment_count.to_i
+    .post
+      .top
+        %p= link_to h(p.title), p.url
+      .body
+        %p= h(Sanitize.clean(p.body.first(300))) + "...  " + link_to("Read More", p.url)
+      .bottom
+        = link_to pluralize_if(comment_count,"comment"), p.url
+        %span= " | "
+        %span.gray= time_ago_in_words(p.posted) + " ago"

data/generators/blogify_install/USAGE

@@ -0,0 +1,4 @@
+To copy a Blogify initializer & migration & partials to your Rails App, with some configuration values, just do:
+
+    script/generate blogify_install
+

data/generators/blogify_install/blogify_install_generator.rb

@@ -0,0 +1,15 @@
+
+class BlogifyInstallGenerator < Rails::Generator::Base
+
+  def manifest
+    record do |m|
+
+      m.migration_template 'migration.rb', 'db/migrate', :migration_file_name => "blogify_create_blog_posts"
+
+      m.directory "config/initializers"
+      m.template  "blogify.rb", "config/initializers/blogify.rb"
+
+    end
+  end
+
+end

data/generators/blogify_install/templates/README

@@ -0,0 +1,13 @@
+
+===============================================================================
+
+Some setup you must do manually if you haven't yet:
+
+  1. Ensure you have defined your Posterous user name in config/blogify.rb
+
+  2. Run rake db:migrate to create the BlogPosts table.
+  
+Note: the initializer creates its own Rufus scheduler task - so if you have
+other Rufus tasks, you may want to consolidate them.
+
+===============================================================================

data/generators/blogify_install/templates/blogify.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'rufus/scheduler'
+
+# BlogPost.default_posterous_user = 'CHANGEME'
+
+scheduler = Rufus::Scheduler.start_new(:frequency => 900.0)
+
+scheduler.every '1h' do
+  BlogPost.cache_posts
+  #BlogPostSubclass.cache_posts( 'some_other_posterous_user', 5)
+end

data/generators/blogify_install/templates/migration.rb

@@ -0,0 +1,18 @@
+class BlogifyCreateBlogPosts < ActiveRecord::Migration
+  def self.up
+    create_table :blog_posts do |t|
+      t.string    :type
+      t.string    :title
+      t.text      :body
+      t.integer   :comment_count
+      t.string    :url
+      t.date      :posted
+
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :blog_posts
+  end
+end

data/generators/blogify_views/USAGE

@@ -0,0 +1,3 @@
+To copy the view partials from blogify to your app just run the following command:
+
+    script/generate blogify_views

data/generators/blogify_views/blogify_views_generator.rb

@@ -0,0 +1,21 @@
+class BlogifyViewsGenerator < Rails::Generator::Base
+
+  def initialize(*args)
+    super
+    @source_root = options[:source] || File.join(spec.path, '..', '..')
+  end
+
+  def manifest
+    record do |m|
+      m.directory "app/views"
+
+      Dir[File.join(@source_root, "app", "views", "**/*.haml")].each do |file|
+        file = file.gsub(@source_root, "")[1..-1]
+
+        m.directory  File.dirname(file)
+        m.file       file, file
+      end
+    end
+  end
+
+end

data/init.rb

@@ -0,0 +1 @@
+require 'blogify'

data/lib/blogify.rb

@@ -0,0 +1,21 @@
+begin
+  require 'posterous'
+rescue
+  gem 'glennr-posterous'
+  require 'posterous'
+end
+
+begin
+  require 'rufus/scheduler'
+rescue
+  gem 'rufus-scheduler'
+  require 'rufus/scheduler'
+end
+
+begin
+  require 'httparty'
+rescue
+  gem 'httparty'
+  require 'httparty'
+end
+

data/test/performance/browsing_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+require 'performance_test_help'
+
+# Profiling results for each test method are written to tmp/performance.
+class BrowsingTest < ActionController::PerformanceTest
+  def test_homepage
+    get '/'
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,38 @@
+ENV["RAILS_ENV"] = "test"
+require File.expand_path(File.dirname(__FILE__) + "/../config/environment")
+require 'test_help'
+
+class ActiveSupport::TestCase
+  # Transactional fixtures accelerate your tests by wrapping each test method
+  # in a transaction that's rolled back on completion.  This ensures that the
+  # test database remains unchanged so your fixtures don't have to be reloaded
+  # between every test method.  Fewer database queries means faster tests.
+  #
+  # Read Mike Clark's excellent walkthrough at
+  #   http://clarkware.com/cgi/blosxom/2005/10/24#Rails10FastTesting
+  #
+  # Every Active Record database supports transactions except MyISAM tables
+  # in MySQL.  Turn off transactional fixtures in this case; however, if you
+  # don't care one way or the other, switching from MyISAM to InnoDB tables
+  # is recommended.
+  #
+  # The only drawback to using transactional fixtures is when you actually 
+  # need to test transactions.  Since your test is bracketed by a transaction,
+  # any transactions started in your code will be automatically rolled back.
+  self.use_transactional_fixtures = true
+
+  # Instantiated fixtures are slow, but give you @david where otherwise you
+  # would need people(:david).  If you don't want to migrate your existing
+  # test cases which use the @david style and don't mind the speed hit (each
+  # instantiated fixtures translates to a database query per test method),
+  # then set this back to true.
+  self.use_instantiated_fixtures  = false
+
+  # Setup all fixtures in test/fixtures/*.(yml|csv) for all tests in alphabetical order.
+  #
+  # Note: You'll currently still have to declare fixtures explicitly in integration tests
+  # -- they do not yet inherit this setting
+  fixtures :all
+
+  # Add more helper methods to be used by all tests here...
+end

data/test/unit/blog_post_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class BlogPostTest < ActiveSupport::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: siyelo-blogify
+version: !ruby/object:Gem::Version 
+  version: 0.1.2
+platform: ruby
+authors: 
+- Glenn Roberts
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-08 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: glennr-posterous
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.7
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rufus-scheduler
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.3
+    version: 
+description: A Rails engine for embedding Posterous blog extracts
+email: glenn.roberts@siyelo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- TODO
+files: 
+- CHANGELOG
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- TODO
+- VERSION
+- app/helpers/blog_posts_helper.rb
+- app/models/blog_post.rb
+- app/views/blog_posts/_list.html.haml
+- app/views/blog_posts/_long_list.html.haml
+- generators/blogify_install/USAGE
+- generators/blogify_install/blogify_install_generator.rb
+- generators/blogify_install/templates/README
+- generators/blogify_install/templates/blogify.rb
+- generators/blogify_install/templates/migration.rb
+- generators/blogify_views/USAGE
+- generators/blogify_views/blogify_views_generator.rb
+- init.rb
+- lib/blogify.rb
+has_rdoc: true
+homepage: http://github.com/siyelo/siyelo-blogify
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Rails engine for embedding Posterous blog extracts
+test_files: 
+- test/performance/browsing_test.rb
+- test/test_helper.rb
+- test/unit/blog_post_test.rb