utopia-gallery 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 69f0a0aec906b446239d6e3048f8eda7e3f65361
+  data.tar.gz: ae8c0c3da88f1aa55ef289665025d70b307f1221
+SHA512:
+  metadata.gz: c1402cbdf7fdce1316ef63cbce5cf2ac610260e8d32a2130dd029d6050593b5ab44301afd087f0b488ad4813bf206754a1e52d7323d9d97ce67416e288ed50fc
+  data.tar.gz: f081553113a7f74d1cffd008229c0d319712e2985f3d88c82521260019486c1e0a6d6eec59b7b5d638ce949653748c8a99520a71073a16104605bd2614a9beec

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.tags*
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+_cache
+_gallery

data/.rspec

@@ -0,0 +1,5 @@
+--color
+--format documentation
+--backtrace
+--warnings
+--require spec_helper

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in vips-thumbnail.gemspec
+gemspec
+
+group :development do
+end
+
+group :test do
+	gem 'rack-test'
+	
+	gem 'simplecov'
+	gem 'coveralls', require: false
+end

data/README.md

@@ -0,0 +1,95 @@
+# Utopia::Gallery
+
+This extension for [Utopia](https://github.com/ioquatix/utopia) provides tags for generating photo galleries. Works well in conjunction with [jQuery.LiteBox](https://github.com/ioquatix/jquery-litebox).
+
+## Installation
+
+Add this line to your website's Gemfile:
+
+	gem 'utopia-gallery'
+
+And then execute:
+
+	$ bundle
+
+## Usage
+
+Require the tag in your `config/environment.rb`:
+
+	require 'utopia/gallery'
+
+In your `config.ru` add the `gallery` namespace:
+
+use Utopia::Content,
+	namespaces: {
+		'gallery' => Utopia::Gallery::Tags.new
+	}
+
+In your `xnode`:
+
+```html
+<gallery:container path="_photos"/>
+```
+
+### Customizing Generated Markup
+
+The best way to customize the output is to specify a tag to use:
+
+```html
+<gallery:container path="_photos" tag="content:photo"/>
+```
+
+Add `_photo.xnode` such as:
+
+```html
+<figure class="photo">
+	<a href="#{attributes[:src].large}" title="#{attributes[:alt]}">
+		<img src="#{attributes[:src].small}" alt="#{attributes[:alt]}"/>
+	</a>
+	<figcaption>#{attributes[:alt]}</figcaption>
+</figure>
+```
+
+### Adding Captions
+
+You can add captions and other metadata by adding a `gallery.yaml` file:
+
+```yaml
+bear.jpg:
+  caption: "Brown bear is angry!"
+  order: 1
+```
+
+This file needs to be placed in the same directory as the images, and metadata can be accessed via the `alt` attribute, e.g. `attributes[:alt]['caption']`.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+Released under the MIT license.
+
+Copyright, 2012, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
+
+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/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/utopia/gallery.rb

@@ -0,0 +1,24 @@
+# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require_relative 'gallery/container'
+require_relative 'gallery/process'
+require_relative 'gallery/cache'
+require_relative 'gallery/tags'

data/lib/utopia/gallery/cache.rb

@@ -0,0 +1,77 @@
+# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+module Utopia
+	module Gallery
+		class Cache
+			# @param root [String] The root path for media files.
+			def initialize(media_root, cache_root, cache_path, media, processes)
+				# TODO: It's a lot of things to keep track of... perhaps a configuration class?
+				@media_root = media_root
+				@cache_root = cache_root
+				@cache_path = cache_path
+				@media = media
+				
+				@processes = processes
+			end
+			
+			attr :media_root
+			attr :cache_root
+			attr :processes
+			attr :media
+			
+			def to_s
+				@media.path
+			end
+			
+			def output_path_for(process)
+				File.join(@cache_root, process.relative_path(@media))
+			end
+			
+			def source_path_for(process)
+				File.join(@cache_path, process.relative_path(@media))
+			end
+			
+			# Process the media, update files in the cache.
+			def update
+				locals = {}
+				
+				@processes.values.each do |process|
+					process.call(self, locals)
+				end
+				
+				return self
+			end
+			
+			# This allows dynamic path lookup based on process name, e.g. `cache.small`.
+			def method_missing(name, *args)
+				if process = @processes[name]
+					return source_path_for(process)
+				else
+					super
+				end
+			end
+			
+			def respond_to?(name)
+				@processes.include?(name) || super
+			end
+		end
+	end
+end

data/lib/utopia/gallery/container.rb

@@ -0,0 +1,68 @@
+# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require_relative 'media'
+
+module Utopia
+	module Gallery
+		class Container
+			include Enumerable
+			
+			def initialize(root, path, filter: /(jpe?g|png)$/i)
+				@root = root
+				@path = path
+				@filter = filter
+			end
+			
+			def each
+				return to_enum unless block_given?
+				
+				gallery_metadata = load_metadata
+				
+				entries.each do |name|
+					path = File.join(@path, name)
+					media_metadata = gallery_metadata.delete(name)
+					
+					yield Media.new(path, media_metadata || {})
+				end
+			end
+			
+			private
+			
+			def full_path
+				File.join(@root, @path)
+			end
+			
+			def entries
+				Dir.entries(full_path).select{|name| name =~ @filter}
+			end
+			
+			def load_metadata
+				metadata_path = File.join(full_path, 'gallery.yaml')
+				
+				if File.exist? metadata_path
+					return YAML::load(File.read(metadata_path))
+				else
+					return {}
+				end
+			end
+		end
+	end
+end

data/lib/utopia/gallery/media.rb

@@ -0,0 +1,57 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+module Utopia
+	module Gallery
+		# Represents a single unit of media, e.g. a video or image.
+		class Media
+			# @param path [String] The full path to the media asset.
+			def initialize(path, metadata)
+				@path = path
+				@metadata = metadata
+			end
+			
+			attr :path
+			attr :metadata
+			
+			def [] key
+				@metadata[key.to_s]
+			end
+			
+			def caption
+				@metadata['caption']
+			end
+			
+			def to_s
+				caption || File.basename(@path, ".*")
+			end
+			
+			ORDER_KEY = 'order'.freeze
+			
+			def <=> other
+				if a = self[ORDER_KEY] and b = other[ORDER_KEY]
+					a <=> b
+				else
+					self.path.last <=> other.path.last
+				end
+			end
+		end
+	end
+end

data/lib/utopia/gallery/process.rb

@@ -0,0 +1,72 @@
+# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require 'vips/thumbnail'
+require 'fileutils'
+
+module Utopia
+	module Gallery
+		class Process
+			def initialize(name)
+				@name = name.to_sym
+			end
+			
+			attr :name
+			
+			def relative_path(media)
+				source_path = media.path
+				
+				File.join(File.dirname(source_path), @name.to_s, File.basename(source_path))
+			end
+			
+			def fresh?(input_path, output_path)
+				return File.exist?(output_path) && File.mtime(input_path) < File.mtime(output_path)
+			end
+		end
+		
+		class ResizeImage < Process
+			def initialize(name, size = [800, 800], method = :resize_to_fit, **options)
+				super(name)
+				
+				@size = size
+				@method = method
+				@options = options
+			end
+			
+			def call(cache, locals)
+				output_path = cache.output_path_for(self)
+				media = cache.media
+				media_path = File.join(cache.media_root, media.path)
+				
+				return if fresh?(media_path, output_path)
+				
+				resizer = locals[:resizer] ||= Vips::Thumbnail::Resizer.new(media_path)
+				
+				FileUtils.mkdir_p(File.dirname(output_path))
+				
+				if output_image = resizer.send(@method, @size)
+					output_image.write_to_file output_path, **@options
+				else
+					FileUtils.ln(media_path, output_path)
+				end
+			end
+		end
+	end
+end

data/lib/utopia/gallery/tags.rb

@@ -0,0 +1,84 @@
+# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require 'utopia/content/namespace'
+
+require_relative 'container'
+require_relative 'process'
+require_relative 'cache'
+
+module Utopia
+	module Gallery
+		class Tags
+			DEFAULT_PROCESSES = [
+				ResizeImage.new(:small, [400, 400], :resize_to_fill),
+				ResizeImage.new(:medium, [800, 800], :resize_to_fill),
+				ResizeImage.new(:large, [1600, 1600], :resize_to_fit),
+			]
+			
+			# @param media_root [String] Directory where media is stored.
+			# @param cache_root [String] Directory where media is cached.
+			# @param cache_root [String] The prefix path for the cached assets, served as static content.
+			def initialize(media_root: Utopia.default_root, cache_root: Utopia.default_root('public/_gallery'), cache_path: '/_gallery', processes: DEFAULT_PROCESSES)
+				@media_root = media_root
+				@cache_root = cache_root
+				@cache_path = cache_path
+				@processes = {}
+				
+				processes.each do |process|
+					name = process.name
+					
+					raise ArgumentError.new("Duplicate process #{name}") if @processes.include?(name)
+					
+					@processes[name] = process
+				end
+			end
+			
+			def container(document, state)
+				node = document.parent.node
+				path = node.uri_path.dirname + Utopia::Path[state[:path]]
+				
+				options = {}
+				if filetypes = state[:filetypes]
+					options[:filter] = Regexp.new("(#{filetypes})$", Regexp::IGNORECASE)
+				elsif filter = state[:filter]
+					options[:filter] = Regexp.new(filter, Regexp::IGNORECASE)
+				end
+				
+				# Where should we get this from?
+				container = Container.new(@media_root, path, **options)
+				
+				media_tag_name = state[:tag] || 'img'
+				
+				document.tag('div', class: 'gallery') do
+					container.each do |media|
+						cache = Cache.new(@media_root, @cache_root, @cache_path, media, @processes).update
+						document.tag(media_tag_name, src: cache, alt: media)
+					end
+				end
+			end
+			
+			def call(name, node)
+				# TODO: Validate security implications/leaky abstraction.
+				self.method(name)
+			end
+		end
+	end
+end

data/lib/utopia/gallery/version.rb

@@ -0,0 +1,5 @@
+module Utopia
+	module Gallery
+		VERSION = "2.0.0"
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+
+if ENV['COVERAGE']
+	begin
+		require 'simplecov'
+		
+		SimpleCov.start do
+			add_filter "/spec/"
+		end
+		
+		if ENV['TRAVIS']
+			require 'coveralls'
+			Coveralls.wear!
+		end
+	rescue LoadError
+		warn "Could not load simplecov: #{$!}"
+	end
+end
+
+require "bundler/setup"
+require "utopia/gallery"
+
+RSpec.configure do |config|
+	# Enable flags like --only-failures and --next-failure
+	config.example_status_persistence_file_path = ".rspec_status"
+
+	config.expect_with :rspec do |c|
+		c.syntax = :expect
+	end
+end

data/spec/utopia/gallery/cache_spec.rb

@@ -0,0 +1,25 @@
+
+RSpec.describe Utopia::Gallery::Cache do
+	let(:pages_root) {File.join(__dir__, 'site/pages')}
+	let(:cache_root) {File.join(__dir__, 'site/public/_gallery')}
+	
+	before(:each) do 
+		FileUtils.rm_rf cache_root
+	end
+	
+	# Cache wants processes as a hash by name.
+	let(:processes) do
+		{
+			small: Utopia::Gallery::ResizeImage.new(:small, [400, 400], :resize_to_fill),
+			large: Utopia::Gallery::ResizeImage.new(:large, [800, 800], :resize_to_fit),
+		}
+	end
+	
+	let(:container) {Utopia::Gallery::Container.new(pages_root, 'sample_images')}
+	
+	subject{container.collect{|media| described_class.new(pages_root, cache_root, '/_gallery', media, processes)}}
+	
+	it "should generate thumbnails" do
+		subject.each(&:update)
+	end
+end

data/spec/utopia/gallery/container_spec.rb

@@ -0,0 +1,9 @@
+
+RSpec.describe Utopia::Gallery::Container do
+	let(:pages_root) {File.join(__dir__, 'site/pages')}
+	subject{described_class.new(pages_root, 'sample_images')}
+	
+	it "should list media" do
+		expect(subject.count).to be == 4
+	end
+end

data/spec/utopia/gallery/site/pages/_photo.xnode

@@ -0,0 +1,6 @@
+<span class="photo">
+	<a rel="photos" class="thumbnail" href="#{attributes[:src].large}" title="#{attributes[:alt]}">
+		<img src="#{attributes[:src].small}" alt="#{attributes[:alt]}" />
+	</a>
+	<div class="caption">#{attributes[:alt]}</div>
+</span>

data/spec/utopia/gallery/site/pages/gallery.xnode

@@ -0,0 +1 @@
+<gallery:container tag="content:photo" path="sample_images" />

data/spec/utopia/gallery/site/pages/index.xnode

@@ -0,0 +1 @@
+<gallery:container path="sample_images"/>

data/spec/utopia/gallery/site_spec.rb

@@ -0,0 +1,70 @@
+# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.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.
+
+require 'rack/test'
+require 'utopia/content'
+
+describe Utopia::Gallery do
+	include Rack::Test::Methods
+	
+	let(:app) {Rack::Builder.parse_file(File.expand_path('site_spec.ru', __dir__)).first}
+	
+	let(:cache_root) {File.join(__dir__, 'site/public/_gallery')}
+	
+	before(:each) do 
+		FileUtils.rm_rf cache_root
+	end
+	
+	it "should generate gallery of sample images" do
+		get "/index"
+		
+		expect(last_response.body).to be == '<div class="gallery"><img src="/sample_images/IMG_3340.jpg" alt="IMG_3340"/><img src="/sample_images/IMG_3341.jpg" alt="IMG_3341"/><img src="/sample_images/IMG_3344.jpg" alt="IMG_3344"/><img src="/sample_images/IMG_3351.jpg" alt="IMG_3351"/></div>'
+	end
+	
+	it "should generate a gallery using the specified tag" do
+		get "/gallery"
+		
+		expect(last_response.body).to be == '<div class="gallery"><span class="photo">
+	<a rel="photos" class="thumbnail" href="/_gallery/sample_images/large/IMG_3340.jpg" title="IMG_3340">
+		<img src="/_gallery/sample_images/small/IMG_3340.jpg" alt="IMG_3340"/>
+	</a>
+	<div class="caption">IMG_3340</div>
+</span>
+<span class="photo">
+	<a rel="photos" class="thumbnail" href="/_gallery/sample_images/large/IMG_3341.jpg" title="IMG_3341">
+		<img src="/_gallery/sample_images/small/IMG_3341.jpg" alt="IMG_3341"/>
+	</a>
+	<div class="caption">IMG_3341</div>
+</span>
+<span class="photo">
+	<a rel="photos" class="thumbnail" href="/_gallery/sample_images/large/IMG_3344.jpg" title="IMG_3344">
+		<img src="/_gallery/sample_images/small/IMG_3344.jpg" alt="IMG_3344"/>
+	</a>
+	<div class="caption">IMG_3344</div>
+</span>
+<span class="photo">
+	<a rel="photos" class="thumbnail" href="/_gallery/sample_images/large/IMG_3351.jpg" title="IMG_3351">
+		<img src="/_gallery/sample_images/small/IMG_3351.jpg" alt="IMG_3351"/>
+	</a>
+	<div class="caption">IMG_3351</div>
+</span>
+</div>'
+	end
+end

data/spec/utopia/gallery/site_spec.ru

@@ -0,0 +1,13 @@
+
+require 'utopia/content'
+
+pages_root = File.expand_path('site/pages', __dir__)
+gallery_root = File.expand_path('site/public/_gallery', __dir__)
+
+use Utopia::Content,
+	root: pages_root,
+	namespaces: {
+		'gallery' => Utopia::Gallery::Tags.new(media_root: pages_root, cache_root: gallery_root, cache_path: '/_gallery')
+	}
+
+run lambda{|env| [200, {}, []]}

data/utopia-gallery.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+require_relative 'lib/utopia/gallery/version'
+
+Gem::Specification.new do |spec|
+	spec.name          = "utopia-gallery"
+	spec.version       = Utopia::Gallery::VERSION
+	spec.authors       = ["Samuel Williams"]
+	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
+
+	spec.summary       = %q{A gallery tag for use with the Utopia web framework.}
+	spec.homepage      = "https://github.com/ioquatix/utopia-gallery"
+	spec.license       = "MIT"
+
+	spec.files         = `git ls-files`.split($/)
+	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+	spec.require_paths = ["lib"]
+	
+	spec.add_dependency "utopia", "~> 2.0"
+	spec.add_dependency "vips-thumbnail"
+	
+	spec.add_development_dependency "bundler", "~> 1.14"
+	spec.add_development_dependency "rake", "~> 10.0"
+	spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,151 @@
+--- !ruby/object:Gem::Specification
+name: utopia-gallery
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-03-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: utopia
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: vips-thumbnail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- samuel.williams@oriontransfer.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- README.md
+- Rakefile
+- lib/utopia/gallery.rb
+- lib/utopia/gallery/cache.rb
+- lib/utopia/gallery/container.rb
+- lib/utopia/gallery/media.rb
+- lib/utopia/gallery/process.rb
+- lib/utopia/gallery/tags.rb
+- lib/utopia/gallery/version.rb
+- spec/spec_helper.rb
+- spec/utopia/gallery/cache_spec.rb
+- spec/utopia/gallery/container_spec.rb
+- spec/utopia/gallery/site/pages/_photo.xnode
+- spec/utopia/gallery/site/pages/gallery.xnode
+- spec/utopia/gallery/site/pages/index.xnode
+- spec/utopia/gallery/site/pages/sample_images/IMG_3340.jpg
+- spec/utopia/gallery/site/pages/sample_images/IMG_3341.jpg
+- spec/utopia/gallery/site/pages/sample_images/IMG_3344.jpg
+- spec/utopia/gallery/site/pages/sample_images/IMG_3351.jpg
+- spec/utopia/gallery/site_spec.rb
+- spec/utopia/gallery/site_spec.ru
+- utopia-gallery.gemspec
+homepage: https://github.com/ioquatix/utopia-gallery
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.10
+signing_key: 
+specification_version: 4
+summary: A gallery tag for use with the Utopia web framework.
+test_files:
+- spec/spec_helper.rb
+- spec/utopia/gallery/cache_spec.rb
+- spec/utopia/gallery/container_spec.rb
+- spec/utopia/gallery/site/pages/_photo.xnode
+- spec/utopia/gallery/site/pages/gallery.xnode
+- spec/utopia/gallery/site/pages/index.xnode
+- spec/utopia/gallery/site/pages/sample_images/IMG_3340.jpg
+- spec/utopia/gallery/site/pages/sample_images/IMG_3341.jpg
+- spec/utopia/gallery/site/pages/sample_images/IMG_3344.jpg
+- spec/utopia/gallery/site/pages/sample_images/IMG_3351.jpg
+- spec/utopia/gallery/site_spec.rb
+- spec/utopia/gallery/site_spec.ru