twirly 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b86de10909408a53057c24b43e80e4aa4571210e
+  data.tar.gz: b0e2b8147f27984508f06004a5da88107974024b
+SHA512:
+  metadata.gz: 9f55d1970f03619c1f4acc5ca736fcc7624f5e2242894ac23aa870846f075a7d137699a1dd3396ec67d6caf40cb9eb2cebc31431025558d2cbb9b8a083da602a
+  data.tar.gz: 7da2d6f230b75976a1bf1d36fecc1510eeb8212b5065133bb39878a952fabceef03684da99a0dade4d7c925673ad87e89bf825f2290ae93c87f30ff2abfd3bcc

data/.gitignore

@@ -0,0 +1,4 @@
+tags
+twirly.yml
+public
+twirly-*.gem

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,122 @@
+PATH
+  remote: .
+  specs:
+    twirly (0.0.1)
+      awesome_print
+      json (~> 1.8.1)
+      liquid
+      ruby-trello
+      thor
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (4.1.1)
+      activesupport (= 4.1.1)
+      builder (~> 3.1)
+    activesupport (4.1.1)
+      i18n (~> 0.6, >= 0.6.9)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.1)
+      tzinfo (~> 1.1)
+    addressable (2.3.6)
+    ast (1.1.0)
+    awesome_print (1.2.0)
+    builder (3.2.2)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    factory_girl (4.4.0)
+      activesupport (>= 3.0.0)
+    fakefs (0.5.1)
+    faker (1.3.0)
+      i18n (~> 0.5)
+    ffi (1.9.3)
+    formatador (0.2.4)
+    guard (2.6.1)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      pry (>= 0.9.12)
+      thor (>= 0.18.1)
+    guard-rspec (4.2.9)
+      guard (~> 2.1)
+      rspec (>= 2.14, < 4.0)
+    i18n (0.6.9)
+    json (1.8.1)
+    liquid (3.0.0)
+    listen (2.7.5)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.5)
+    method_source (0.8.2)
+    mime-types (2.4.3)
+    minitest (5.3.4)
+    netrc (0.9.0)
+    oauth (0.4.7)
+    parser (2.1.7)
+      ast (~> 1.1)
+      slop (~> 3.4, >= 3.4.5)
+    powerpack (0.0.9)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-nav (0.2.3)
+      pry (~> 0.9.10)
+    pry-remote (0.1.8)
+      pry (~> 0.9)
+      slop (~> 3.0)
+    rainbow (2.0.0)
+    rake (10.1.1)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.4)
+      ffi (>= 0.5.0)
+    rest-client (1.7.2)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.8)
+    rspec-expectations (2.14.5)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.6)
+    rubocop (0.18.1)
+      json (>= 1.7.7, < 2)
+      parser (~> 2.1.3)
+      powerpack (~> 0.0.6)
+      rainbow (>= 1.99.1, < 3.0)
+    ruby-trello (1.1.2)
+      activemodel (>= 3.2.0)
+      addressable (~> 2.3)
+      json
+      oauth (~> 0.4.5)
+      rest-client (~> 1.7.2)
+    slop (3.4.7)
+    thor (0.19.1)
+    thread_safe (0.3.3)
+    timers (1.1.0)
+    tzinfo (1.1.0)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  factory_girl
+  fakefs
+  faker
+  guard-rspec
+  pry
+  pry-nav
+  pry-remote
+  rake
+  rspec (~> 2.14.1)
+  rubocop
+  twirly!

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright 2014 Dimitris Zorbas / zorbash
+
+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,56 @@
+## Twirly
+
+[![Gem version](https://badge.fury.io/rb/twirly.png)](http://badge.fury.io/rb/twirly)
+
+Twirly is a cli tool which converts [Trello](http://trello.com) cards to
+articles for use with ruby static site generators like 
+[middleman](http://middlemanapp.com/), [jekyll](http://jekyllrb.com/), [nanoc](http://nanoc.ws/)
+
+## Usage
+
+Add it to the `Gemfile` of the static site project.
+
+`gem 'twirly'`
+
+For a list of available commands run `twirly help`
+For help on a command run `twirly help some_command`
+
+## Setup
+
+It requires a `twirly.yml` file to be present in the project root.
+
+Example:
+
+```yaml
+trello_key: 'deadc2592ce753b3bad'
+trello_secret: 'deaddc5712771bad'
+organization: 'some_organization'
+publishing_board: 'iPAnh67A'
+```
+
+## Pull
+
+Convert all cards having a 'published' label to articles
+
+`twirly pull`
+
+## Pick
+
+Convert a specific card (identified by short_id) to article
+
+`twirly pick`
+
+## Fetch User
+
+Create a page for a board user
+
+`twirly fetch_user zorbash`
+
+# Author
+
+[zorbash](https://github.com/zorbash)
+
+# Licence
+Released under the MIT License. See the
+[LICENSE](https://github.com/Zorbash/twirly/blob/master/LICENSE) file
+for further details.

data/bin/twirly

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# coding: utf-8
+
+require 'twirly'
+
+Twirly::CLI.start(ARGV)

data/config/initializers/trello.rb

@@ -0,0 +1,4 @@
+Trello.configure do |config|
+  config.developer_public_key = Twirly::SETTINGS[:trello_key]
+  config.member_token         = Twirly::SETTINGS[:trello_secret]
+end

data/lib/twirly/cli.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+module Twirly
+  class CLI < ::Thor
+    package_name 'twirly'
+
+    desc 'pull', 'Fetch latest published posts'
+    def pull
+      Twirly::Commands::Pull.new(args, options).run
+    end
+
+    desc 'pick', 'Fetch post by short id'
+    def pick(id)
+      Twirly::Commands::Pick.new(args, options).run
+    end
+
+    desc 'fetch_user', 'Fetch user by username'
+    def fetch_user(username)
+      Twirly::Commands::FetchUser.new(args, options).run
+    end
+  end
+end

data/lib/twirly/commands/base.rb

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+module Twirly
+  module Commands
+    class Base
+      attr_accessor :args, :options
+
+      def initialize(args, options)
+        @args = args
+        @options = options.dup.symbolize_keys
+      end
+    end
+  end
+end

data/lib/twirly/commands/fetch_user.rb

@@ -0,0 +1,9 @@
+module Twirly
+  module Commands
+    class FetchUser < Base
+      def run
+        (Twirly::Compiler.new).fetch_user Twirly::User.find_by_username(args.first)
+      end
+    end
+  end
+end

data/lib/twirly/commands/pick.rb

@@ -0,0 +1,9 @@
+module Twirly
+  module Commands
+    class Pick < Base
+      def run
+        (Twirly::Compiler.new).pick Twirly::Post.find(args.first.to_i)
+      end
+    end
+  end
+end

data/lib/twirly/commands/pull.rb

@@ -0,0 +1,9 @@
+module Twirly
+  module Commands
+    class Pull < Base
+      def run
+        (Twirly::Compiler.new).pull
+      end
+    end
+  end
+end

data/lib/twirly/commands.rb

@@ -0,0 +1,6 @@
+module Twirly::Commands
+  autoload :Base, 'twirly/commands/base'
+  autoload :Pull, 'twirly/commands/pull'
+  autoload :Pick, 'twirly/commands/pick'
+  autoload :FetchUser, 'twirly/commands/fetch_user'
+end

data/lib/twirly/compiler.rb

@@ -0,0 +1,26 @@
+module Twirly
+  class Compiler
+    def pull
+      Twirly::Post.published.each do |post|
+        output_path = File.join Twirly.source_dir, "#{post.slug}.html.md.erb"
+        puts "Creating #{output_path}"
+
+        File.open(output_path, 'w') { |out| out << post.to_md }
+      end
+    end
+
+    def pick(post)
+      output_path = File.join Twirly.source_dir, "#{post.slug}.html.md.erb"
+      puts "Creating #{output_path}"
+
+      File.open(output_path, 'w') { |out| out << post.to_md }
+    end
+
+    def fetch_user(user)
+      output_path = File.join Twirly.source_dir, 'users', "#{user.username}.html.md.erb"
+      puts "Creating #{output_path}"
+
+      File.open(output_path, 'w') { |out| out << user.to_md }
+    end
+  end
+end

data/lib/twirly/helpers/youtube.rb

@@ -0,0 +1,37 @@
+module Twirly
+  module Helpers
+    # Exposes a tag for liquid templates with the
+    # following syntax
+    #
+    # {% youtube width height value %}
+    class Youtube < Liquid::Tag
+      def initialize(name, variables, tokens)
+        super
+        _parse_variables(variables)
+      end
+
+      def render(context)
+        <<-VIDEO.strip_heredoc.strip
+        <div class="embed-video-container">
+          <iframe width="#{@width}" height="#{@height}"
+                  src="http://www.youtube.com/embed/#{@id}">
+          </iframe>
+        </div>
+        VIDEO
+      end
+
+      def _parse_variables(variables)
+        parsed_variables = variables.split(' ')
+        if parsed_variables.size == 3
+          @width  = parsed_variables[0]
+          @height = parsed_variables[1]
+          @id     = parsed_variables[2]
+        else
+          @id     = parsed_variables.first
+          @width  = 320
+          @height = 280
+        end
+      end
+    end
+  end
+end

data/lib/twirly/helpers.rb

@@ -0,0 +1,3 @@
+module Twirly::Helpers
+  autoload :Youtube, 'twirly/helpers/youtube'
+end

data/lib/twirly/post.rb

@@ -0,0 +1,81 @@
+module Twirly
+  class Post < SimpleDelegator
+    include Twirly::Serializers::Post
+
+    define_method(:alias_attribute, &Trello::Card.method(:alias_attribute).to_proc)
+
+    alias :card :__getobj__
+
+    alias_attribute :title, :name
+    alias_attribute :updated_at, :last_activity_date
+    alias_attribute :created_at, :due
+    alias_attribute :published_at, :due
+    alias_attribute :card_id, :short_id
+
+    def category; card.list.name end
+
+    def tags
+      labels.map(&:name).reject { |label| label == 'published' }
+    end
+
+    def existing_front_matter
+      @existing_front_matter ||= card.desc.scan(/(---.*---)/mi).flatten.first
+    end
+
+    def processed_front_matter
+      @processed_front_matter =
+      begin
+        matter = YAML::load(existing_front_matter || '{}')
+        matter[:title] = title
+        matter[:slug] = slug
+        matter[:category] = category
+        matter[:date] = short_published_at
+        matter[:tags] = tags.join(', ')
+        matter[:authors] = authors.map(&:username).join(', ')
+        matter[:attachments] = attachments.map(&:url).join(', ') if card.attachments.any?
+        matter
+      end
+    end
+
+    def body
+      @body ||= Liquid::Template.parse(card.desc.sub(/---.*---/mi, '').strip).render
+    end
+
+    def short_published_at
+      published_at.strftime('%Y-%m-%d')
+    end
+
+    def published?
+      published_at && card.labels.any? { |label| label.name == 'published' }
+    end
+
+    def slug
+      "#{short_published_at}-#{title.parameterize}-#{card_id}"
+    end
+
+    def authors
+      members.map { |member| Twirly::User.new(member) }
+    end
+
+    def front_matter
+      "#{processed_front_matter.to_yaml}\n---"
+    end
+
+    def to_md
+      "#{front_matter}\n\n#{body}"
+    end
+
+    class << self
+      def published
+        Twirly.board.cards.map { |card|
+          post = Post.new(card)
+          if post.published? then post else nil end
+        }.compact.sort { |p1, p2| p2.published_at <=> p1.published_at }
+      end
+
+      def find(id)
+        Post.new(Twirly.board.cards.find { |card| card.short_id == id })
+      end
+    end
+  end
+end

data/lib/twirly/serializers/post.rb

@@ -0,0 +1,21 @@
+module Twirly
+  module Serializers
+    module Post
+      def as_json
+        { post: {
+            card_id:       card_id,
+            title:         title,
+            category:      category,
+            tags:          tags,
+            updated_at:    updated_at,
+            published_at:  published_at
+          }
+        }
+      end
+
+      def to_json
+        as_json.to_json
+      end
+    end
+  end
+end

data/lib/twirly/serializers/user.rb

@@ -0,0 +1,20 @@
+module Twirly
+  module Serializers
+    module User
+      def as_json
+        { user: {
+            id:         id,
+            username:   username,
+            full_name:  full_name,
+            bio:        bio,
+            avatar_url: avatar_url,
+          }
+        }
+      end
+
+      def to_json
+        as_json.to_json
+      end
+    end
+  end
+end

data/lib/twirly/serializers.rb

@@ -0,0 +1,6 @@
+module Twirly
+  module Serializers
+    autoload :Post, 'twirly/serializers/post'
+    autoload :User, 'twirly/serializers/user'
+  end
+end

data/lib/twirly/user.rb

@@ -0,0 +1,31 @@
+module Twirly
+  class User < SimpleDelegator
+    include Twirly::Serializers::User
+
+    alias :member :__getobj__
+
+    def front_matter
+      "#{attributes.to_yaml}\n---"
+    end
+
+    def to_md
+      "#{front_matter}\n\n#{bio}"
+    end
+
+    class << self
+      def all
+        Twirly.board.members.map do |member|
+          user = User.new(member)
+          user.refresh!
+          user
+        end
+      end
+
+      def find_by_username(username)
+        user = User.new(Twirly.board.members.find { |member| member.username == username })
+        user.refresh!
+        user
+      end
+    end
+  end
+end

data/lib/twirly/version.rb

@@ -0,0 +1,3 @@
+module Twirly
+  VERSION = '0.0.1'
+end

data/lib/twirly.rb

@@ -0,0 +1,45 @@
+# coding: utf-8
+
+require 'delegate'
+require 'yaml'
+require 'thor'
+require 'active_support/hash_with_indifferent_access'
+require 'active_support/core_ext'
+
+require 'twirly/version'
+
+autoload :Trello,      'trello'
+autoload :Liquid,      'liquid'
+autoload :FileUtils,   'file_utils'
+
+I18n.enforce_available_locales = false
+
+module Twirly
+  begin
+    SETTINGS = YAML.load_file('twirly.yml').deep_symbolize_keys
+  rescue Errno::ENOENT
+    puts 'twirly.yml was not found, please add one'
+  end
+
+  def self.board
+    @board ||= Trello::Board.find(SETTINGS[:publishing_board])
+  end
+
+  def self.source_dir(dir = './')
+    @source ||= (SETTINGS[:source_dir] || File.expand_path(dir))
+  end
+
+  autoload :Post,         'twirly/post'
+  autoload :User,         'twirly/user'
+  autoload :Compiler,     'twirly/compiler'
+  autoload :CLI,          'twirly/cli'
+  autoload :Commands,     'twirly/commands'
+  autoload :Helpers,      'twirly/helpers'
+  autoload :Serializers,  'twirly/serializers'
+end
+
+# Load all initializers
+Dir[File.join(File.expand_path('../../', __FILE__),
+    'config/initializers/*')].sort.each(&method(:require))
+
+Liquid::Template.register_tag('youtube', Twirly::Helpers::Youtube)

data/spec/cli_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Twirly::CLI do
+  describe '#pull' do
+    it 'runs Twirly::Commands::Pull' do
+      Twirly::Commands::Pull.any_instance.should_receive(:run)
+      Twirly::CLI.start %w(pull)
+    end
+  end
+
+  describe '#pick' do
+    it 'runs Twirly::Commands::Pick' do
+      Twirly::Commands::Pick.any_instance.should_receive(:run)
+      Twirly::CLI.start %w(pick 42)
+    end
+  end
+
+  describe '#fetch_user' do
+    it 'runs Twirly::Commands::FetchUser' do
+      Twirly::Commands::FetchUser.any_instance.should_receive(:run)
+      Twirly::CLI.start %w(fetch_user zorbash)
+    end
+  end
+end

data/spec/commands/fetch_user_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Twirly::Commands::FetchUser do
+  describe '#run' do
+    let(:args) { ['zorbash'] }
+
+    before do
+      Twirly::User.stub(:find_by_username).and_return(create(:user))
+    end
+
+    it 'calls Twirly::Compiler#fetch_user' do
+      Twirly::Compiler.any_instance.should_receive :fetch_user
+      (Twirly::Commands::FetchUser.new(args, {})).run
+    end
+  end
+end

data/spec/commands/pick_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Twirly::Commands::Pull do
+  describe '#run' do
+    let(:args) { ['42'] }
+
+    before do
+      Twirly::Post.stub(:find).and_return(create(:post))
+    end
+
+    it 'calls Twirly::Compiler#pick' do
+      Twirly::Compiler.any_instance.should_receive :pick
+      (Twirly::Commands::Pick.new(args, {})).run
+    end
+  end
+end

data/spec/commands/pull_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+
+describe Twirly::Commands::Pull do
+  describe '#run' do
+    it 'calls Twirly::Compiler#pull' do
+      Twirly::Compiler.any_instance.should_receive :pull
+      (Twirly::Commands::Pull.new([], {})).run
+    end
+  end
+end

data/spec/dummy/.bowerrc

@@ -0,0 +1,3 @@
+{
+  "directory": "vendor/assets/bower_components"
+}

data/spec/dummy/.gitignore

@@ -0,0 +1 @@
+.sass-cache