picturama 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+.rvmrc
+config/config.yml

data/Gemfile

@@ -0,0 +1,7 @@
+source :rubygems
+
+gem "mini_magick", "~> 3.6.0"
+
+group :test, :development do
+  gem 'rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,22 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.2.4)
+    mini_magick (3.6.0)
+      subexec (~> 0.2.1)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.1)
+    subexec (0.2.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  mini_magick (~> 3.6.0)
+  rspec

data/LICENCE

@@ -0,0 +1,50 @@
+Copyright (c) 2012 David Silveira
+
+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.
+
+----------------------------------------------------------
+
+TRADUCCIÓN NO OFICIAL NI AUTORIZADA PARA SU USO COMO LICENCIA LEGAL
+Copyright (c) 2012 David Silveira
+
+Se autoriza por la presente, de forma gratuita, a cualquier
+persona que haya obtenido una copia de este software y 
+archivos asociados de documentación (el "Software"), para tratar en el
+Software sin restricción, incluyendo sin ninguna limitación en lo que concierne
+los derechos para usar, copiar, modificar, fusionar, publicar,
+distribuir, sublicenciar, y / o vender copias de este
+Software, y para permitir a las personas a las que se les proporcione el Software para 
+hacer lo mismo, sujeto a las siguientes condiciones:
+
+El aviso de copyright anterior y este aviso de permiso
+tendrá que ser incluido en todas las copias o partes sustanciales de
+este Software.
+
+EL SOFTWARE SE ENTREGA "TAL CUAL", SIN GARANTÍA DE NINGÚN
+TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO SIN LIMITARSE A GARANTÍAS DE
+MERCANTIBILIDAD, CAPACIDAD DE HACER Y DE NO INFRACCIÓN DE COPYRIGHT. EN NINGÚN 
+CASO LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN RESPONSABLES DE 
+NINGUNA RECLAMACIÓN, DAÑOS U OTRAS RESPONSABILIDADES, 
+YA SEA EN UN LITIGIO, AGRAVIO O DE OTRO MODO, 
+DERIVADAS DE, OCASIONADAS POR CULPA DE O EN CONEXION CON EL
+SOFTWARE O SU USO U OTRO TIPO DE ACCIONES EN EL SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# Pictorama
+
+Welcome to *Pictorama*. An easy picture gallery based on directory and files
+
+### How to install
+
+Just clone the github repo..
+
+```ruby
+git clone git@github.com:aboyon/pictorama.git
+```
+### Configure your settings...
+
+Copy the config.sample.yml to config.yml (into the config/ file)
+
+```ruby
+cd config/
+cp config.sample.yml config.yml
+```
+and then proceed to adjust the settings
+
+```yaml
+picturama:
+  album_source: '/home/user/Pictures/some_folder/'
+  allowed_formats: ['jpg','png','jpeg']
+  thumbnail_prefix: thumb_
+  thumnail_default_size: "200x200"
+```
+
+generate your thumbnails quickly, by using the rake task created for that
+```
+rake thumbnail:generate["/some/folder"] #you can specify a different folder...
+```
+and then you'll get an answer like this:
+```
+Generating 30 thumbnails for folder /some/folder/ ...
+Size: 200x200
+Thumbnail generated for source 1.JPG. Target destination thumb_1.JPG
+Thumbnail generated for source 2.JPG. Target destination thumb_2.JPG
+```
+# License
+
+Please [see licence file](https://github.com/aboyon/pictorama/blob/master/LICENCE) for further reading.

data/config/config.sample.yml

@@ -0,0 +1,5 @@
+picturama:
+  album_source: '[your_path_here]'
+  allowed_formats: ['jpg','png','jpeg','JPG']
+  thumbnail_prefix: thumb_
+  thumnail_default_size: "200x200"

data/i18n/en.yml

@@ -0,0 +1,11 @@
+picturama:
+  title: David Silveira pictures
+  album:
+    view: View album
+    pictures: Pictures here
+    size: album size
+  picture:
+    name: Picture name
+    comments: Comments
+    size: Size
+    Taken: "Taken on #{date}"

data/i18n/es.yml

@@ -0,0 +1,11 @@
+picturama:
+  title: Fotos de David Silveira
+  album:
+    view: Ver album
+    pictures: Imagenes aca
+    size: "Tamaño del album"
+  picture:
+    name: Nombre
+    comments: Comentarios
+    size: "Tamaño"
+    Taken: "Imagen tomada el #{date}"

data/lib/ext/string.rb

@@ -0,0 +1,15 @@
+class String
+
+  def humanize(options)
+    
+    if include?("-")
+      split("-").join(" ").downcase
+    end
+
+    if (options == :all_caps)
+      capitalize!
+    end
+
+  end
+
+end

data/lib/picturama.rb

@@ -0,0 +1,27 @@
+require 'fileutils'
+require 'picturama/album'
+require 'picturama/picture'
+require 'picturama/version'
+
+module Picturama
+
+  Dir["lib/picturama/*.rb"].each { |file| 
+    require "#{Dir.pwd}/#{file}"
+  }
+
+  def self.config
+    YAML.load_file('config/config.yml')['picturama']
+  end
+
+  def self.albums(album_source)
+    albums = []
+    Dir["#{album_source}/*"].each { |album|
+      if File.directory?(album)
+        potential_album = Picturama::Album.new(:folder => album)
+        albums.push(album)
+      end
+    }
+    albums
+  end
+
+end

data/lib/picturama/album.rb

@@ -0,0 +1,72 @@
+require 'picturama'
+
+module Picturama
+  class Album
+    
+    def initialize(args)
+      @folder = args[:folder]
+      @thumbnails = "#{args[:folder]}/thumbnails"
+      @resized = "#{args[:folder]}/resized"
+    end
+
+    def pictures(order = true)
+      if File.directory?(@folder)
+        list = []
+        filter = "#{@folder}/*.{#{Picturama::config['allowed_formats'].join(',')}}"
+        dir_list = generate_sorting(filter)
+        dir_list.each do |picture|
+          list.push(Picturama::Picture.new(picture))
+        end
+        unless order
+          list.reverse!
+        end
+        list
+      end
+    end
+
+    def name
+      File.basename(@folder).humanize
+    end
+
+    def count_pictures
+      pictures.size
+    end
+
+    def has_thumbnails?
+      File.directory?(@thumbnails)
+    end
+
+    def has_resized?
+      File.directory?(@resized)
+    end
+
+    def has_broken_thumbnails?
+      thumbnails_found = Dir["#{@thumbnails}/*.{#{Picturama::config['allowed_formats'].join(',')}}"].size
+      !has_thumbnails? || thumbnails_found < count_pictures
+    end
+
+    def init_thumbnails
+      unless has_thumbnails?
+        FileUtils.mkdir_p "#{@thumbnails}"
+      end
+    end
+
+    def init_resized
+      unless has_resized?
+        FileUtils.mkdir_p "#{@resized}"
+      end
+    end
+
+    protected
+
+    def generate_sorting(filter)
+      if (filter == :size)
+        dir_list = Dir[filter].sort_by{ |filename| File.size("#{filename}") }
+      else
+        dir_list = Dir[filter].sort_by{ |filename| File.ctime("#{filename}") }
+      end
+      dir_list
+    end
+
+  end
+end

data/lib/picturama/picture.rb

@@ -0,0 +1,33 @@
+require 'picturama'
+
+module Picturama
+  class Picture < File
+    
+    attr_accessor :thumbnail
+
+    def initialize(args)
+      super
+      @thumbnail = "#{File.dirname(path)}/thumbnails/#{Picturama::config['thumbnail_prefix']}#{File.basename(path)}"
+      @resized = "#{File.dirname(path)}/resized/resized_#{File.basename(path)}"
+      @metainfo = "#{File.dirname(path)}/resized/resized_#{File.basename(path)}.info"
+    end
+
+    def info
+      File.read(@metainfo) if File.exists?(@metainfo)
+    end
+
+    def has_resized?
+      File.exists?(@resized)
+    end
+
+    def has_thumbnail?
+      File.exists?(@thumbnail) && File.size(@thumbnail) < size
+    end
+
+    def remove_assoc
+      File.delete(@thumbnail) if has_thumbnail?
+      File.delete(@resized) if has_resized?
+    end
+
+  end
+end

data/lib/picturama/version.rb

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

data/picturama.gemspec

@@ -0,0 +1,20 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "picturama/version"
+
+Gem::Specification.new do |s|
+  s.name        = 'picturama'
+  s.version     = Picturama::VERSION
+  s.summary     = "An easy picture gallery based on directory and files"
+  s.description = "An easy picture gallery based on directory and files"
+  s.authors     = ["David Silveira"]
+  s.email       = 'jdsilveira@gmail.com'
+  s.files       = `git ls-files`.split("\n")
+  s.homepage    = 'http://davidsilveira.me/picturama'
+
+  s.add_dependency('mini_magick', '~> 3.6.0')
+
+  s.add_development_dependency 'rspec'
+
+  s.require_paths = ["lib"]
+
+end

data/rakefile

@@ -0,0 +1,35 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+require 'rubygems'
+require 'fileutils'
+require 'picturama'
+require 'mini_magick'
+
+namespace :thumbnail do
+
+  desc "Generate thumbnail for a given folder or just a single file"
+  task :generate, :source do |t, args|
+    if File.directory?(args[:source]) || File.exists?(args[:source])
+      size = Picturama::config['thumnail_default_size']
+      album = Picturama::Album.new(:folder => args[:source])
+      puts "Generating #{album.count_pictures} thumbnails for folder #{args[:source]}..."
+      puts "Size: #{size}"
+      unless album.has_broken_thumbnails?
+        puts "WARNING: Seems that this album has all his thumbnails properly generated. There are no broken thumbs."
+      end
+      album.init_thumbnails
+      album.pictures.each do |picture|
+        unless picture.has_thumbnail?
+          thumb = MiniMagick::Image.open(picture.path)
+          thumb.resize "#{size}"
+          thumb.format "jpg"
+          thumb.write picture.thumbnail
+          puts "Thumbnail generated for source #{File.basename(picture.path)}. Target destination #{File.basename(picture.thumbnail)}"
+        end
+      end
+    else
+      puts "Error => target destination #{args[:source]} does not exist"
+    end
+  end
+
+end

data/spec/album_spec.rb

@@ -0,0 +1,34 @@
+require_relative '../lib/picturama'
+
+describe "For a given folder" do 
+  
+  before :each do
+    @target_exists_folder = "#{Dir.pwd}/spec/pictures"
+    @album = Picturama::Album.new(:folder => @target_exists_folder)
+  end
+
+  it "check that Folder module return the list properly" do
+    expected_file = "#{@target_exists_folder}/king.jpg"
+    @album.pictures.first.class.should == Picturama::Picture.new('.').class
+    @album.pictures.first.path.should == expected_file
+  end
+
+  it "check thumnails for images" do
+    @album.pictures.first.has_thumbnail?.should be_false
+    @album.pictures.first.has_resized?.should be_false
+  end
+
+  it "check info for files" do
+    @album.pictures.first.info.nil?.should be_true
+  end
+
+  it "verify how many files are in album" do
+    @album.count_pictures.should > 0
+  end
+
+  it "gets all the albums in a given folder" do
+    Picturama::albums(File.dirname(@target_exists_folder)).size.should > 0
+  end
+
+
+end

data/spec/picture_spec.rb

@@ -0,0 +1,26 @@
+require 'mini_magick'
+require_relative '../lib/picturama'
+
+describe "For a given picture in a given album" do 
+  
+  before :each do
+    @target_exists_folder = "#{Dir.pwd}/spec/pictures"
+    album = Picturama::Album.new(:folder => @target_exists_folder)
+    album.init_thumbnails
+    @picture = album.pictures.first
+    @thumb_w = 100
+  end
+
+  it "generate thumbnail" do
+    @picture.has_thumbnail?.should be_false
+    thumb = MiniMagick::Image.open(@picture.path)
+    thumb.resize "100x100"
+    thumb.format "jpg"
+    thumb.write @picture.thumbnail
+    @picture.has_thumbnail?.should be_true
+    @picture.remove_assoc
+    @picture.has_thumbnail?.should be_false
+  end
+
+
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: picturama
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- David Silveira
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: An easy picture gallery based on directory and files
+email: jdsilveira@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENCE
+- README.md
+- config/config.sample.yml
+- i18n/en.yml
+- i18n/es.yml
+- lib/ext/string.rb
+- lib/picturama.rb
+- lib/picturama/album.rb
+- lib/picturama/picture.rb
+- lib/picturama/version.rb
+- picturama.gemspec
+- rakefile
+- spec/album_spec.rb
+- spec/picture_spec.rb
+- spec/pictures/king.jpg
+- spec/pictures/quimby.gif
+- spec/pictures/vote-quimby.jpg
+- spec/pictures/vote_quimby.jpg
+homepage: http://davidsilveira.me/picturama
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: An easy picture gallery based on directory and files
+test_files: []