merb-photos 0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Jamie Hoover
+
+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

@@ -0,0 +1,62 @@
+Prerequisite:
+
+http://github.com/uipoet/merb-ui/tree/master
+
+------------------------------------------------------------------------------
+
+Installation:
+
+1.) Install merb-photos gem.
+git clone git://github.com/uipoet/merb-photos.git
+cd merb-photos
+sudo rake install
+
+2.) Navigate to your merb application.
+cd ~/your_merb_app/
+
+3.) Add to your dependencies file.
+vim config/dependencies.rb
+a
+
+dependency 'merb-photos'
+
+esc : wq
+
+4.) Add options to your init file in the before_app_loads callback.
+vim config/init.rb
+a
+
+Merb::BootLoader.before_app_loads do
+  Merb::Slices::config[:merb_photos][:title] = 'Photos' #Title of the index page and/or tab.
+  Merb::Slices::config[:merb_photos][:flickr_user_name] = 'your_user_name' #Flickr user name.
+  Merb::Slices::config[:merb_photos][:flickr_api_key] = '********************************' #Flickr API key.
+  Merb::Slices::config[:merb_photos][:flickr_shared_secret] = '****************' #Flickr shared secret.
+end
+
+esc : wq
+
+5.) Add to your router file.
+vim config/router.rb
+a
+
+slice(:merb_photos)
+
+esc : wq
+
+6.) Start your merb application and browse.
+http://your_domain/photos
+
+------------------------------------------------------------------------------
+
+Advanced:
+
+# List all available tasks:
+rake -T slices:merb_photos
+
+# Put your application-level overrides in:
+host-app/slices/merb-photos/
+
+# Templates are located in this order:
+1. host-app/slices/merb-photos/app/views/*
+2. gems/merb-photos/app/views/*
+3. host-app/app/views/*

data/Rakefile

@@ -0,0 +1,69 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+require 'merb-core'
+require 'merb-core/tasks/merb'
+
+GEM_NAME = "merb-photos"
+AUTHOR = "uipoet"
+EMAIL = "dont.tase@me.com"
+HOMEPAGE = "http://uipoet.com/"
+SUMMARY = "Flickr photo gallery for Merb."
+GEM_VERSION = "0.1"
+
+spec = Gem::Specification.new do |s|
+  s.rubyforge_project = "mui"
+  s.name = GEM_NAME
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.add_dependency('merb-ui', '>= 0.1')
+  s.add_dependency('flickraw', '>= 0.5')
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README Rakefile) + Dir.glob("{lib,app,public}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Install the gem"
+task :install do
+  Merb::RakeHelper.install(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Uninstall the gem"
+task :uninstall do
+  Merb::RakeHelper.uninstall(GEM_NAME, :version => GEM_VERSION)
+end
+
+desc "Release the gem to rubyforge"
+task :release do
+  require 'rubyforge'
+#  require 'rake/contrib/rubyforgepublisher'
+  sh %{sudo rake package}
+  begin
+    sh %{rubyforge login}
+    sh %{rubyforge add_release #{AUTHOR} #{GEM_NAME} #{GEM_VERSION} pkg/#{GEM_NAME}-#{GEM_VERSION}.gem}
+  rescue Exception => e
+    puts "Release failed: #{e.message}"
+  end
+end
+
+desc "Create a gemspec file"
+task :gemspec do
+  File.open("#{GEM_NAME}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end
+
+require 'spec/rake/spectask'
+require 'merb-core/test/tasks/spectasks'
+desc 'Default: run spec examples'
+task :default => 'spec'

data/app/controllers/application.rb

@@ -0,0 +1,5 @@
+class MerbPhotos::Application < Merb::Controller
+  
+  controller_for_slice
+  
+end

data/app/controllers/photos.rb

@@ -0,0 +1,33 @@
+class MerbPhotos::Photos < MerbPhotos::Application
+
+  load_dependency 'flickraw'
+  
+  FlickRaw.api_key = MerbPhotos[:flickr_api_key]
+  FlickRaw.shared_secret = MerbPhotos[:flickr_shared_secret]
+
+  def index
+    @photosets = flickr.photosets.getList :user_id => user_id
+    photoset_id = params[:photoset_id] || @photosets.first.id
+    @photoset = flickr.photosets.getInfo(:photoset_id => photoset_id)
+    @photos = flickr.photosets.getPhotos(:photoset_id => photoset_id).photo
+    display @photosets
+  end
+
+  def photo
+    @photoset_id = params[:photoset_id]
+    @photo_id = params[:photo_id]
+    sizes = flickr.photos.getSizes(:photo_id => params[:photo_id])
+    @photo = sizes.find {|s| s.label == 'Medium'}
+    context = flickr.photosets.getContext(:photo_id => params[:photo_id], :photoset_id => params[:photoset_id])
+    @next_id = context.nextphoto.id unless context.nextphoto.id == 0
+    @previous_id = context.prevphoto.id unless context.prevphoto.id == 0
+    display(@photo, :layout => false)
+  end
+
+  private
+
+  def user_id
+    flickr.people.findByUsername(:username => MerbPhotos[:flickr_user_name]).nsid
+  end
+      
+end

data/app/helpers/application_helper.rb

@@ -0,0 +1,45 @@
+module Merb::MerbPhotos::ApplicationHelper
+
+  def merb_photos_button(options = {})
+    attributes = {}
+    attributes[:class] = 'mui_button mui_button_tone_neutral mui_click_window_open'
+    farm = options[:farm]
+    photo = options[:photo]
+    attributes[:id] = slice_url(:photo, :photo_id => photo.id, :photoset_id => @photoset.id)
+    image = mui_image(:url => "http://farm#{@photoset.farm}.static.flickr.com/#{photo.server}/#{photo.id}_#{photo.secret}_s.jpg", :height => 75, :width => 75)
+    attributes[:style] = 'float:left;margin:1em;'
+    tag(:button, image, attributes)
+  end
+  
+  def merb_photos_javascript
+    tag(:script, :src => slice_url(:javascript), :type => 'text/javascript')
+  end
+
+  def merb_photos_navigation
+    navigation = ''
+    navigation << mui_button(:name => 'previous', :title => '&larr;', :url => slice_url(:photo, :photo_id => @previous_id, :photoset_id => @photoset_id), :window => 'redirect') if @previous_id
+    navigation << mui_button(:name => 'next', :title => '&rarr;', :url => slice_url(:photo, :photo_id => @next_id, :photoset_id => @photoset_id), :window => 'redirect') if @next_id
+    navigation
+  end
+  
+  def merb_photos_photo
+    mui_image(:height => @photo.height, :url => merb_photos_source(@photo.source), :width => @photo.width)
+  end
+
+  def merb_photos_source(string)
+    string.gsub(/ |\\/, '')
+  end
+  
+  def merb_photos_tab(options = {})
+    photoset = options[:photoset]
+    image = mui_image(:url => "http://farm#{photoset.farm}.static.flickr.com/#{photoset.server}/#{photoset.primary}_#{photoset.secret}_s.jpg", :height => 75, :width => 75)
+    attributes = {}
+    attributes[:class] = 'mui_button mui_button_tone_neutral mui_click'
+    attributes[:class] << ' mui_selected' if photoset.id == @photoset.id
+    attributes[:id] = slice_url(:index, :photoset_id => photoset.id)
+    attributes[:style] = 'width:100%'
+    content = tag(:table, tag(:tr, tag(:td, image) + tag(:td, photoset.title)))
+    tag(:button, content, attributes)
+  end
+  
+end

data/app/helpers/global_helpers.rb

@@ -0,0 +1,7 @@
+module Merb::GlobalHelpers
+
+  def merb_photos_title
+    MerbPhotos[:title]
+  end
+  
+end

data/app/views/photos/index.html.erb

@@ -0,0 +1,14 @@
+<%= mui_grid(:columns => 2) do %>
+  <%= mui_cell(:width => '100%') do %>
+    <% @photos.each do |photo| %>
+      <%= merb_photos_button(:photo => photo) %>
+    <% end %>
+  <% end =%>
+  <%= mui_cell do %>
+    <%= mui_block(:type => 'tray') do %>
+      <% @photosets.each do |photoset| %>
+        <%= merb_photos_tab(:photoset => photoset) %>
+      <% end %>
+    <% end =%>
+  <% end =%>
+<% end =%>

data/app/views/photos/photo.html.erb

@@ -0,0 +1,5 @@
+<%= mui_window(:buttons => merb_photos_navigation) do %>
+  <%= mui_block do %>
+    <%= merb_photos_photo %>
+  <% end =%>
+<% end =%>

data/lib/merb-photos/merbtasks.rb

@@ -0,0 +1,103 @@
+namespace :slices do
+  namespace :merb_photos do
+  
+    desc "Install MerbPhotos"
+    task :install => [:preflight, :setup_directories, :copy_assets, :migrate]
+    
+    desc "Test for any dependencies"
+    task :preflight do # see slicetasks.rb
+    end
+  
+    desc "Setup directories"
+    task :setup_directories do
+      puts "Creating directories for host application"
+      MerbPhotos.mirrored_components.each do |type|
+        if File.directory?(MerbPhotos.dir_for(type))
+          if !File.directory?(dst_path = MerbPhotos.app_dir_for(type))
+            relative_path = dst_path.relative_path_from(Merb.root)
+            puts "- creating directory :#{type} #{File.basename(Merb.root) / relative_path}"
+            mkdir_p(dst_path)
+          end
+        end
+      end
+    end
+    
+    desc "Copy stub files to host application"
+    task :stubs do
+      puts "Copying stubs for MerbPhotos - resolves any collisions"
+      copied, preserved = MerbPhotos.mirror_stubs!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    
+    desc "Copy stub files and views to host application"
+    task :patch => [ "stubs", "freeze:views" ]
+  
+    desc "Copy public assets to host application"
+    task :copy_assets do
+      puts "Copying assets for MerbPhotos - resolves any collisions"
+      copied, preserved = MerbPhotos.mirror_public!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    
+    desc "Migrate the database"
+    task :migrate do # see slicetasks.rb
+    end
+    
+    desc "Freeze MerbPhotos into your app (only merb-photos/app)" 
+    task :freeze => [ "freeze:app" ]
+
+    namespace :freeze do
+      
+      desc "Freezes MerbPhotos by installing the gem into application/gems"
+      task :gem do
+        ENV["GEM"] ||= "merb-photos"
+        Rake::Task['slices:install_as_gem'].invoke
+      end
+      
+      desc "Freezes MerbPhotos by copying all files from merb-photos/app to your application"
+      task :app do
+        puts "Copying all merb-photos/app files to your application - resolves any collisions"
+        copied, preserved = MerbPhotos.mirror_app!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freeze all views into your application for easy modification" 
+      task :views do
+        puts "Copying all view templates to your application - resolves any collisions"
+        copied, preserved = MerbPhotos.mirror_files_for :view
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freeze all models into your application for easy modification" 
+      task :models do
+        puts "Copying all models to your application - resolves any collisions"
+        copied, preserved = MerbPhotos.mirror_files_for :model
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+      desc "Freezes MerbPhotos as a gem and copies over merb-photos/app"
+      task :app_with_gem => [:gem, :app]
+      
+      desc "Freezes MerbPhotos by unpacking all files into your application"
+      task :unpack do
+        puts "Unpacking MerbPhotos files to your application - resolves any collisions"
+        copied, preserved = MerbPhotos.unpack_slice!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      
+    end
+    
+  end
+end

data/lib/merb-photos/slicetasks.rb

@@ -0,0 +1,18 @@
+namespace :slices do
+  namespace :merb_photos do 
+    
+    # add your own merb-photos tasks here
+    
+    # implement this to test for structural/code dependencies
+    # like certain directories or availability of other files
+    desc "Test for any dependencies"
+    task :preflight do
+    end
+    
+    # implement this to perform any database related setup steps
+    desc "Migrate the database"
+    task :migrate do
+    end
+    
+  end
+end

data/lib/merb-photos/spectasks.rb

@@ -0,0 +1,65 @@
+namespace :slices do
+  namespace :merb_photos do
+      
+    desc "Run slice specs within the host application context"
+    task :spec => [ "spec:explain", "spec:default" ]
+    
+    namespace :spec do
+      
+      slice_root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
+      
+      task :explain do
+        puts "\nNote: By running MerbPhotos specs inside the application context any\n" +
+             "overrides could break existing specs. This isn't always a problem,\n" +
+             "especially in the case of views. Use these spec tasks to check how\n" +
+             "well your application conforms to the original slice implementation."
+      end
+      
+      Spec::Rake::SpecTask.new('default') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+
+      desc "Run all model specs, run a spec for a specific Model with MODEL=MyModel"
+      Spec::Rake::SpecTask.new('model') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['MODEL'])
+          t.spec_files = Dir["#{slice_root}/spec/models/**/#{ENV['MODEL']}_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/models/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all controller specs, run a spec for a specific Controller with CONTROLLER=MyController"
+      Spec::Rake::SpecTask.new('controller') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['CONTROLLER'])
+          t.spec_files = Dir["#{slice_root}/spec/controllers/**/#{ENV['CONTROLLER']}_spec.rb"].sort
+        else    
+          t.spec_files = Dir["#{slice_root}/spec/controllers/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all view specs, run specs for a specific controller (and view) with CONTROLLER=MyController (VIEW=MyView)"
+      Spec::Rake::SpecTask.new('view') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['CONTROLLER'] and ENV['VIEW'])
+          t.spec_files = Dir["#{slice_root}/spec/views/**/#{ENV['CONTROLLER']}/#{ENV['VIEW']}*_spec.rb"].sort
+        elsif(ENV['CONTROLLER'])
+          t.spec_files = Dir["#{slice_root}/spec/views/**/#{ENV['CONTROLLER']}/*_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/views/**/*_spec.rb"].sort
+        end
+      end
+
+      desc "Run all specs and output the result in html"
+      Spec::Rake::SpecTask.new('html') do |t|
+        t.spec_opts = ["--format", "html"]
+        t.libs = ['lib', 'server/lib' ]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+      
+    end
+    
+  end
+end

data/lib/merb-photos.rb

@@ -0,0 +1,80 @@
+if defined?(Merb::Plugins)
+
+  $:.unshift File.dirname(__FILE__)
+
+  load_dependency 'merb-ui'
+  Merb::Plugins.add_rakefiles "merb-photos/merbtasks", "merb-photos/slicetasks", "merb-photos/spectasks"
+
+  # Register the Slice for the current host application
+  Merb::Slices::register(__FILE__)
+  
+  # Slice configuration - set this in a before_app_loads callback.
+  # By default a Slice uses its own layout, so you can swicht to 
+  # the main application layout or no layout at all if needed.
+  # 
+  # Configuration options:
+  # :layout - the layout to use; defaults to :merb-photos
+  # :mirror - which path component types to use on copy operations; defaults to all
+  Merb::Slices::config[:merb_photos][:layout] ||= :application
+  
+  # All Slice code is expected to be namespaced inside a module
+  module MerbPhotos
+    
+    # Slice metadata
+    self.description = "Merb UI Photos"
+    self.version = "1.0"
+    self.author = "UI Poet"
+    
+    # Stub classes loaded hook - runs before LoadClasses BootLoader
+    # right after a slice's classes have been loaded internally.
+    def self.loaded
+    end
+    
+    # Initialization hook - runs before AfterAppLoads BootLoader
+    def self.init
+    end
+    
+    # Activation hook - runs after AfterAppLoads BootLoader
+    def self.activate
+    end
+    
+    # Deactivation hook - triggered by Merb::Slices.deactivate(MerbPhotos)
+    def self.deactivate
+    end
+    
+    # Setup routes inside the host application
+    #
+    # @param scope<Merb::Router::Behaviour>
+    #  Routes will be added within this scope (namespace). In fact, any 
+    #  router behaviour is a valid namespace, so you can attach
+    #  routes at any level of your router setup.
+    #
+    # @note prefix your named routes with :merb_photos_
+    #   to avoid potential conflicts with global named routes.
+    def self.setup_router(scope)
+      scope.to(:controller => 'photos') do |p|
+        p.match('/photo').to(:action => 'photo').name(:photo)
+        p.match('/photos').to(:action => 'index').name(:index)
+      end
+    end
+    
+  end
+  
+  # Setup the slice layout for MerbPhotos
+  #
+  # Use MerbPhotos.push_path and MerbPhotos.push_app_path
+  # to set paths to merb-photos-level and app-level paths. Example:
+  #
+  # MerbPhotos.push_path(:application, MerbPhotos.root)
+  # MerbPhotos.push_app_path(:application, Merb.root / 'slices' / 'merb-photos')
+  # ...
+  #
+  # Any component path that hasn't been set will default to MerbPhotos.root
+  #
+  # Or just call setup_default_structure! to setup a basic Merb MVC structure.
+  MerbPhotos.setup_default_structure!
+  
+  # Add dependencies for other MerbPhotos classes below. Example:
+  # dependency "merb-photos/other"
+  
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: merb-photos
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- uipoet
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-25 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: merb-ui
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: flickraw
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.5"
+    version: 
+description: Flickr photo gallery for Merb.
+email: dont.tase@me.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+files: 
+- LICENSE
+- README
+- Rakefile
+- lib/merb-photos
+- lib/merb-photos/merbtasks.rb
+- lib/merb-photos/slicetasks.rb
+- lib/merb-photos/spectasks.rb
+- lib/merb-photos.rb
+- app/controllers
+- app/controllers/application.rb
+- app/controllers/photos.rb
+- app/helpers
+- app/helpers/application_helper.rb
+- app/helpers/global_helpers.rb
+- app/views
+- app/views/photos
+- app/views/photos/index.html.erb
+- app/views/photos/photo.html.erb
+has_rdoc: true
+homepage: http://uipoet.com/
+post_install_message: 
+rdoc_options: []
+
+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: mui
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Flickr photo gallery for Merb.
+test_files: []
+