aviary 1.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+.bundle/
+Gemfile.lock
+pkg/
+

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2011 Tate Johnson <tate@tatey.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.md

@@ -0,0 +1,110 @@
+# Aviary
+
+Aviary generates a static photo gallery using Twitter hashtags.
+
+Twitter is a fantastic resource for discovering photos of events as they unfold. Searching by hastag means you have to do the filtering. Commentary and relinking drown new and interesting photos. In the days the water rose during the 2011 Brisbane floods I wished there was a way to see all the photos without the noise. Now there is.
+
+See the wiki for a [listing of galleries](https://github.com/tatey/aviary/wiki/galleries).
+
+## Getting Started
+
+Install Aviary at the command prompt if you haven't yet
+
+    gem install aviary
+    
+At the command prompt, create a new Aviary template
+
+    aviary new bird
+
+Change directory and for search tweets tagged with `bird` that have photos
+
+    cd bird/
+    aviary search bird
+     
+Build the static photo gallery
+
+    aviary build
+    
+Preview
+
+    cd _site/
+    gem install asdf
+    asdf .
+    open http://localhost:9292/index.htm
+
+## Dependencies
+
+* Ruby 1.8.7, 1.9.2
+* SQLite3 
+
+### Runtime
+
+* Base58
+* DataMapper (Core, SQLite Adapter, Migrations and Validations)
+* Nokoigir
+* Twitter
+
+### Development
+
+* Bundler
+* MiniTest
+* Webmock
+
+## Customising the Template
+
+When you create a new aviary you'll notice `_assets/` and `template.erb` are automatically generated for you. Aviary uses these files and directories to generate the static photo gallery. 
+
+Linking back to Aviary is not required, although it is appreciated. 
+
+### template.erb
+
+Pages are plain ERB templates. You get access to the photos and pagination for the current page. You can control the number of photos per page by using `aviary build --per-page=NUM`.
+
+`image_hosts` is a collection of photos for the current page. 
+
+    <% image_hosts.each do |image_host| %>
+      <a href="<%= image_host.href %>"><img src="<%= image_host.src %>"></a>
+      <p><%= image_host.status.from_user %> said <%= h image_host.status.text %></p>
+    <% end >
+
+`paginator` is for finding where you are. 
+
+    <% if paginator.prev_page? %>
+      <a href="/page<%= paginator.prev_page %>/">Previous</a>
+    <% end %>
+    <% if paginator.next_page? %>
+      <a href="/page<%= paginator.next_page %>/">Next</a>
+    <% end %>
+
+`h` escapes content which may be unsafe, such as a user's status text.
+
+    <%= h "<script>" %>
+    
+    ...becomes
+      
+    &lt;script&gt;
+
+### _assets
+
+Anything inside the `_assets` directory is recursively copied into the root of the destination directory. 
+
+Examples:
+
+    ~/bird/_assets/aviary.css -> ~/bird/_site/aviary.css
+    ~/bird/_assets/images/status.png -> ~/bird/_site/images/status.png
+    
+Be careful not to name any of your assets with the following names:
+    
+* _assets/index.htm
+* _assets/page1
+* _assets/page2
+* ...
+* _assets/pageN
+
+## Why the Name?
+
+Aviary is defined as "A large cage for keeping birds in". Replace cage with "photo gallery" and birds with "tweets".
+
+## Copyright
+
+Copyright © 2010 Tate Johnson. Aviary is released under the MIT license. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/*_test.rb'
+end
+
+task :default => :test

data/aviary.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/aviary/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = 'aviary'
+  s.version     = Aviary::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Tate Johnson']
+  s.email       = ['tate@tatey.com']
+  s.homepage    = 'https://github.com/tatey/aviary'
+  s.summary     = %q{A static photo gallery generator for Twitter}
+  s.description = %q{Aviary generates a static photo gallery using Twitter hashtags}
+
+  s.rubyforge_project = s.name
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+  
+  s.add_development_dependency('bundler', '~> 1.0.10')
+  s.add_development_dependency('webmock', '~> 1.6.2')
+  s.add_development_dependency('minitest', '~> 2.0.2')
+
+  s.add_runtime_dependency('base58', '~> 0.1')
+  s.add_runtime_dependency('dm-core', '~> 1.0.2')
+  s.add_runtime_dependency('dm-sqlite-adapter', '~> 1.0.2')
+  s.add_runtime_dependency('dm-migrations', '~> 1.0.2')
+  s.add_runtime_dependency('dm-validations', '~> 1.0.2')
+  s.add_runtime_dependency('nokogiri', '~> 1.4.4')
+  s.add_runtime_dependency('twitter', '~> 1.1.2')
+end

data/bin/aviary

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby
+
+$: << File.join(File.dirname(__FILE__), '..', 'lib')
+
+require 'optparse'
+require 'aviary'
+
+command = nil
+options = {}
+help    = <<-HELP
+Aviary generates a static photo gallery from Twitter hashtags.
+
+Usage:
+  aviary new    HASHTAG                # Setup files and directories
+  aviary search HASHTAG [options...]   # Search tagged tweets with photos
+  aviary build          [options...]   # Build gallery
+  
+Help:
+  aviary <command> --help
+
+HELP
+
+case ARGV[0]
+when 'new'
+  if ARGV.size == 2 && ARGV[1] != "--help"
+    options[:source]  = File.join(Dir.pwd, ARGV[1])
+    options[:hashtag] = ARGV[1]
+    command           = proc { |config| Aviary::Generator.new(config) }
+  else
+    puts "Invalid argument. Try `aviary new HASHTAG`"
+    exit 1
+  end
+when 'search'
+  OptionParser.new do |o|  
+    o.banner = 'Usage: aviary search HASHTAG [options...]'
+    
+    o.on('--source DIR', 'Path to source') do |arg|
+      options[:source] = arg
+    end
+    
+    o.on('--flickr-api-key KEY', 'Use photos hosted on Flickr') do |arg|
+      options[:flickr_api_key] = arg
+    end
+    
+    o.on('--limit NUM', Integer, 'Number of pages to search (100 statuses per page)') do |arg|
+      options[:limit] = arg
+    end
+
+    o.parse!(ARGV)
+  end
+      
+  if ARGV.size == 2
+    options[:hashtag] = ARGV[1]
+    command           = proc { |config| Aviary::Search.new(config) }
+  else
+    puts "Invalid argument. Run `aviary search --help` for assistance."
+    exit 1
+  end
+when 'build'
+  OptionParser.new do |o|  
+    o.banner = 'Usage: aviary build [options...]'
+    
+    o.on('--destination DIR', 'Path to generated gallery') do |arg|
+      options[:dest] = arg
+    end
+
+    o.on('--source DIR', 'Path to source') do |arg|
+      options[:source] = arg
+    end
+    
+    o.on('--per-page NUM', Integer, 'Number of photos per page') do |arg|
+      options[:per_page] = arg
+    end
+
+    o.parse!(ARGV)
+  end
+  
+  command = proc { |config| Aviary::Site.new(config) }
+when '--help'
+  puts help
+  exit 0
+else
+  puts "Invalid command. Run `aviary --help` for assistance."
+  exit 1
+end
+
+command.call(Aviary::Configuration.new(:default, options)).process

data/generator/_assets/aviary.css

@@ -0,0 +1,95 @@
+html, body {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  background: #222222;
+  font-family: 'Helvetica Neue', 'Helvetica', 'Arial', sans-serif;
+  color: #fff;
+  text-align: center;
+  text-shadow: -1px -1px 1px #000;
+}
+
+body {
+  width: 750px;
+  margin: 0 auto;
+}
+
+h1 {
+  margin-bottom: 0;
+  font-size: 30pt;
+  font-weight: normal;
+}
+
+a {
+  color: #fff;
+  text-decoration: none;
+}
+
+p a {
+  border-bottom: 1px solid #fff;
+}
+
+a.button {
+  display: inline-block;
+  margin: 20px 5px 50px 5px;
+  padding: 10px 20px;
+  background: #333;
+  background: -webkit-gradient(linear, 0% 0%, 0% 100%, from(#444), to(#333));
+  background: -moz-linear-gradient(0% 100% 90deg, #333, #444);
+  -webkit-border-radius: 5px;
+  -moz-border-radius: 5px;
+  -webkit-box-shadow: inset 0 1px 0 0 #555;
+  -moz-box-shadow: inset 0 1px 0 0 #555;
+  border: 1px solid #111;
+  font-size: 18pt;
+  text-decoration: none;
+  color: #fff;
+}
+
+  a.button:active, a.button:hover {
+    background: #444;
+    background: -webkit-gradient(linear, 0% 0%, 0% 100%, from(#555), to(#444));
+    background: -moz-linear-gradient(0% 100% 90deg, #444, #555);
+  }
+
+ul {
+  margin: 0;
+  padding: 0;
+  list-style-type: none;
+}
+
+  ul li {
+    padding: 35px 0;
+  }
+    
+    ul li img.photo {
+      border: none;
+      -webkit-box-shadow: 0 0 25px #111;
+      -moz-box-shadow: 0 0 25px #111;
+      -webkit-transform: scale(1);
+      -webkit-transition-timing-function: ease-out;
+      -webkit-transition-duration: 100ms;      
+      -moz-transform: scale(1);
+      -moz-transition-timing-function: ease-out;
+      -moz-transition-duration: 100ms;      
+    }
+    
+    ul li img.photo:hover {
+      -webkit-transform: scale(1.05);
+      -webkit-transition-timing-function: ease-out;
+      -webkit-transition-duration: 100ms;
+      -moz-transform: scale(1.05);
+      -moz-transition-timing-function: ease-out;
+      -moz-transition-duration: 100ms;
+    }
+  
+blockquote p {
+  width: 500px;
+  margin: 0 auto;
+  color: #aaa;
+}
+
+p#author {
+  font-size: 10pt;
+  color: #aaa;
+}

data/generator/_assets/aviary.js

@@ -0,0 +1,38 @@
+(function($) {
+  $(document).ready(function() {
+    // Remove photos that failed to load after 20 seconds.
+    window.setTimeout(function() {
+      $('img.photo:hidden')
+        .closest('li')
+        .fadeOut(function() {
+          $(this)
+            .remove();
+        });
+    }, 20000);
+        
+    $('li').each(function(i, el) {
+      var $el = $(el);
+      // Hide contents of each list element.
+      $el
+        .children()
+        .hide();
+      // Prepend the loader.
+      $el
+        .prepend($('<img>', {src: '/loader.gif', className: 'loader'}));
+      // When the photo loads, remove the loader and show the photo.
+      $el
+        .find('img.photo')
+        .load(function() {
+          $el
+            .children('img.loader')
+            .fadeOut(function() {
+              $(this)
+                .remove();
+              $el
+                .children()
+                .fadeIn();
+            });
+        });
+    });
+  });
+})(jQuery);

data/generator/template.erb

@@ -0,0 +1,45 @@
+<!DOCTYPE html> 
+<html lang="en"> 
+  <head> 
+    <meta name="generator" content="Aviary <%= Aviary::VERSION %> - https://github.com/tatey/aviary">
+    <meta charset="utf-8"> 
+    <title>#{{hashtag}}</title> 
+    <link type="text/css" rel="stylesheet" href="/aviary.css">
+    <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.5.0/jquery.min.js"></script>
+    <script type="text/javascript" src="/aviary.js"></script>
+  </head>
+  <body>
+    <h1><a href="/">#{{hashtag}}</a></h1>
+    <p>
+      A raw collection of photos tweeted with <a href="http://twitter.com/search/%23{{hashtag}}">#{{hashtag}}</a>
+    </p>
+    <ul>
+      <% image_hosts.each do |image_host| %>
+        <li>
+          <a href="<%= image_host.href %>">
+            <img class="photo" src="<%= image_host.src %>">
+          </a>
+          <blockquote>
+            <p>
+              <%= h image_host.status.text %>
+              <cite>
+                <a href="http://twitter.com/<%= image_host.status.from_user %>/status/<%= image_host.status.id %>">
+                  @<%= image_host.status.from_user %>
+                </a>
+              </cite>
+            </p>
+          </blockquote>
+        </li>
+      <% end %>
+    </ul>
+    <% if paginator.prev_page? %>
+      <a class="button" id="prev" href="/page<%= paginator.prev_page %>/" title="Previous">&#9668;</a>
+    <% end %>
+    <% if paginator.next_page? %>
+      <a class="button" id="next" href="/page<%= paginator.next_page %>/" title="Next">&#9658;</a>
+    <% end %>
+    <p id="author">
+      Generated by <a href="https://github.com/tatey/aviary">Aviary</a>
+    </p>
+  </body> 
+</html>