tumblargh 0.1.0

data/.gitignore

@@ -0,0 +1,2 @@
+coverage/
+pkg/

data/.rspec

@@ -0,0 +1 @@
+

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+
+gem 'activesupport', '>= 3.1'
+gem 'treetop'
+gem 'nokogiri'
+gem 'api_cache'
+
+
+group :development do
+  gem 'autotest-standalone'
+  gem 'jeweler'
+  gem 'rake'
+  gem 'rspec'
+  gem 'simplecov'
+end

data/Gemfile.lock

@@ -0,0 +1,52 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.2)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    api_cache (0.2.3)
+    autotest-standalone (4.5.9)
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    i18n (0.6.0)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.6)
+    multi_json (1.1.0)
+    nokogiri (1.5.2)
+    polyglot (0.3.3)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    simplecov (0.6.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 3.1)
+  api_cache
+  autotest-standalone
+  jeweler
+  nokogiri
+  rake
+  rspec
+  simplecov
+  treetop

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Jason Webster, MetaLab Design Ltd.
+
+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.md

@@ -0,0 +1,84 @@
+# Tumblargh
+## Groan-less Tumblr theme development
+
+### What is this thing, and why should I care?
+
+If you've ever had to build a Tumblr theme, you've probably cried out in pain 
+while tweaking locally, copying, pasting into the theme editor, saving, switching
+tabs and finally refreshing and waiting for your tesing blog to reload.
+
+Tumblargh aims to reduce suffering involved with building a theme by offering 
+a way to fully develop, lint and test Tumblr themes locally, with real posts 
+from any existing Tumblog.
+
+### Getting Started
+
+You'll need to get an OAuth consumer key for the Tumblr v2 API to use remote data
+with Tumblargh. Registration is simple enough, just go to http://www.tumblr.com/oauth/apps
+and fill out the form. Any time Tumblargh asks for your API key, it'll be the 
+OAuth Consumer key provided there.
+
+#### Middleman
+
+The recommended way to use tumblargh is in conjuction with 
+[Middleman](http://middlemanapp.com/).
+
+> Middleman is a static site generator based on Sinatra. Providing dozens of 
+templating languages (Haml, Sass, Compass, Slim, CoffeeScript, and more).
+
+Tumblargh includes a simple Middleman extension that turns any Middleman project
+into a local Tumblr theme building machine.
+
+Tumblargh will automatically parse any html files served by Middleman, and 
+populate them with content from the Tumblr of your choosing. It will not
+parse any HTML during Middleman's build process. The output of`middleman build` 
+is ready for use on your blog, or submission to the Tumblr theme store.
+
+To get up an running with Middleman, first create a new Middleman project:
+
+```
+$ middleman init MY_PROJECT_NAME
+```
+
+If one does not already exist, create a Gemfile and add the following as needed:
+
+```ruby
+source "http://rubygems.org"
+
+gem 'middleman'
+gem 'tumblargh', :git => 'git://github.com/jasonwebster/tumblargh.git'
+```
+
+Note that there has not yet been an official release of tumblargh to RubyGems,
+so currently, specifying the gem via git is necessary.
+
+Run `bundle install`.
+
+The bare minimum setup in your Middleman config.rb is:
+
+```ruby
+require 'tumblargh'
+require 'middleman/features/tumblargh'
+
+activate :tumblargh
+
+set_tumblr_api_key 'API KEY' # This is your OAuth consumer key
+set_tumblr_blog 'staff.tumblr.com'
+```
+
+It is highly recommended to run the Middleman server via `bundle exec`.
+
+#### Rack
+
+See `examples/config.ru` for a minimal Rack setup, ready to go with `rackup` or
+your Ruby server of choice.
+
+### Known issues & planned features
+
+- Source attribution `{block:ContentSource}`
+- Your likes `{block:Likes}`
+- Twitter integration `{block:Twitter}`
+- Custom page support
+
+
+

data/Rakefile

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'rspec/core/rake_task'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end
+
+desc "Generate code coverage"
+RSpec::Core::RakeTask.new(:coverage) do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+end
+
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r tumblargh.rb"
+end
+
+
+require 'jeweler'
+Jeweler::Tasks.new do |s|
+  s.name        = 'tumblargh'
+  s.summary     = 'Groan-less Tumblr theme development.'
+  s.description = `cat README.md`
+  s.authors     = ['Jason Webster']
+  s.email       = 'jason@metalabdesign.com'
+  s.homepage    = 'http://github.com/jasonwebster/tumblargh'
+
+  s.files        = `git ls-files`.split("\n")
+  s.require_path = 'lib'
+end
+
+Jeweler::RubygemsDotOrgTasks.new
+
+
+

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/examples/confg.ru

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'bundler/setup'
+
+require 'tumblargh'
+
+Tumblargh::API::set_api_key 'YOUR_TUMBLR_API_KEY'
+
+map "/" do
+
+  app = proc do |env|
+    html = Tumblargh::render_file('my_theme.html', 'willw.tumblr.com')
+
+    [200, { "Content-Type" => "text/html" }, html.lines]
+  end
+
+  run app
+end

data/examples/middleman_config.rb

@@ -0,0 +1,7 @@
+require 'tumblargh'
+require 'middleman/features/tumblargh'
+
+
+activate :tumblargh
+set_tumblr_api_key 'API KEY'
+set_tumlbr_blog 'staff.tumblr.com'

data/lib/middleman/features/tumblargh.rb

@@ -0,0 +1,41 @@
+require 'rack/tumblargh'
+
+module Middleman::Features::Tumblargh
+
+  class << self
+
+    def registered(app)
+      options = {}
+      app.set(:tumblr_options, options)
+      app.extend(ClassMethods)
+
+      unless app.build?
+        app.use(Rack::Tumblargh, options)
+
+        ['/tweets.js', %r{/api.*}].each do |route|
+          app.get route do
+            redirect "http://#{app.tumblr_options[:blog]}#{request.path}?#{request.query_string}"
+          end
+        end
+
+        app.page '/post/:id*', :proxy => '/index.html'
+      end
+    end
+
+    alias :included :registered
+
+    module ClassMethods
+      def tumblr_api_key=(key)
+        Tumblargh::API::set_api_key(key)
+      end
+
+      def tumblr_blog=(blog=nil)
+        tumblr_options[:blog] = blog
+      end
+
+      alias_method :set_tumblr_api_key, :tumblr_api_key=
+      alias_method :set_tumblr_blog, :tumblr_blog=
+    end
+
+  end
+end

data/lib/rack/tumblargh.rb

@@ -0,0 +1,51 @@
+module Rack
+  class Tumblargh
+    Tumblargh = ::Tumblargh
+
+    def initialize(app, options={})
+      @app = app
+      @options = options
+      @options[:blog] = 'staff.tumblr.com' if @options[:blog].nil?
+    end
+
+    attr_reader :options
+
+    def call(env)
+      status, headers, response = @app.call(env)
+
+      if should_parse?(status, headers)
+
+        content = response.respond_to?(:body) ? response.body : response
+        render_opts = { :permalink => permalink?(env['PATH_INFO']) }
+
+        headers.delete('Content-Length')
+        response = Rack::Response.new(
+          render(content, render_opts),
+          status,
+          headers
+        )
+        response.finish
+        response.to_a
+      else
+        [status, headers, response]
+      end
+    end
+
+  private
+
+    def permalink?(path)
+      !! path.match(/^\/post\/\d+/)
+    end
+
+    def should_parse?(status, headers)
+      status == 200 && 
+      headers["Content-Type"] && 
+      headers["Content-Type"].include?("text/html")
+    end
+
+    def render(content, opts)
+      Tumblargh::render_html(content.first, options[:blog], opts)
+    end
+
+  end
+end

data/lib/tumblargh.rb

@@ -0,0 +1,60 @@
+require 'active_support'
+require 'active_support/core_ext/hash/indifferent_access'
+require 'active_support/core_ext/string/conversions'
+require 'active_support/core_ext/time/conversions'
+require 'active_support/inflector'
+
+module Tumblargh
+
+  autoload :API,       'tumblargh/api'
+  autoload :Node,      'tumblargh/node'
+  autoload :Parser,    'tumblargh/parser'
+  autoload :Renderer,  'tumblargh/renderer'
+  autoload :Resource,  'tumblargh/resource'
+
+  class << self
+
+    attr_accessor :config
+
+    def render_file(file, blog, options={})
+      render(:file, file, blog, options)
+    end
+
+    def render_html(string, blog, options={})
+      render(:html, string, blog, options)
+    end
+
+    private
+
+    def render(setter, theme, blog, options)
+      parser = Parser.new
+      parser.send("#{setter}=", theme)
+
+      blog = create_blog blog
+
+      options = parser.options.merge(options)
+
+      Renderer::Document.new(parser.tree, blog, options).render
+    end
+
+    def create_blog(blog)
+      if blog.is_a? Resource::Blog
+        blog
+      elsif blog.is_a? Hash
+        create_blog_from_hash blog
+      elsif File.exists? blog
+        json = ActiveSupport::JSON.decode(open(blog).read)
+        create_blog_from_hash json
+      else
+        Resource::Blog.new(blog)
+      end
+    end
+
+    def create_blog_from_hash(hash)
+      hash = hash["response"] if hash.key? "response"
+      Resource::Blog.new("#{hash["blog"]["name"]}.tumblr.com", hash)
+    end
+
+  end
+
+end

data/lib/tumblargh/api.rb

@@ -0,0 +1,60 @@
+require 'active_support'
+require 'active_support/core_ext/hash/indifferent_access'
+require 'active_support/core_ext/object/to_query'
+require 'active_support/json'
+
+require 'api_cache'
+require 'open-uri'
+
+module Tumblargh
+  module API
+
+    API_ROOT = 'http://api.tumblr.com/v2/blog/'
+
+    @enabled = true
+
+    class << self
+
+      attr_accessor :api_key
+      alias_method :set_api_key, :api_key=
+
+      def fetch(path, query={})
+        raise "API is disabled" unless enabled?
+
+        query = query.merge(:api_key => api_key).to_query
+        url = "#{API_ROOT}#{path}?#{query}"
+        resp = APICache.get(url) { open(url).read }
+        ActiveSupport::JSON.decode(resp)['response']
+      end
+
+      def blog(domain)
+        fetch("#{domain}/info")['blog']
+      end
+
+      def posts(domain, query={})
+        fetch("#{domain}/posts")['posts']
+      end
+
+      def notes(domain, query)
+        query.merge!(:notes_info => 'true')
+        fetch("#{domain}/posts", query)['posts'][0]['notes']
+      end
+
+
+      def enable!
+        @enabled = true
+      end
+
+      def disable!
+        @enabled = false
+      end
+
+      def enabled?
+        @enabled
+      end
+
+    end
+
+
+  end
+end