m1key_gallery_generator 0.3.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 49662e64799771b65adb4f6b2dc9eef86fdf0e8e21817e4c4435fe5b5b9b375e
+  data.tar.gz: 7a03a418ce8c31d997b1da617fc655a7f74cdb1ea82c71f2e4d436300c2472b5
+SHA512:
+  metadata.gz: 6c95eafb5cc4b78f2f5831ff417100cfd704a56f02f0055583a8f6742df14f79765a2f6fb80035aa776f53ce60edc0bf9bfef9ed4b7ba3017518d31f0ebdc007
+  data.tar.gz: b2224404d3ba85456f83f275727fac380d2175c0425d9b66f07d86184e8b8002a184a5b2ef44581f2c0391157df110e98515c7212fd0e498a2d40195c4200d03

data/.gitignore

@@ -0,0 +1,38 @@
+index.html
+uzbekistan*
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+.idea
+*.iml
+.rakeTasks
+vendor
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in m1key_gallery_generator.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Michal Huniewicz
+
+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,123 @@
+# M1keyGalleryGenerator
+
+This Ruby script generates www.m1key.me style gallery.
+
+A sample gallery is this: https://www.m1key.me/photography/mauritania_part_2/
+
+## Status
+
+This is work in progress, but has been used to generate real-life galleries.
+
+## Set up
+
+### Fedora 35+
+
+Install Ruby:
+
+> dnf install ruby
+
+Install Ruby Gem Bundler in Fedora 35 and higher:
+
+> gem install bundler
+
+> dnf install ruby-irb
+
+
+### Ubuntu
+
+Install Ruby using rbenv. Then:
+
+> rbenv install 3.4.7
+
+> rbenv global 3.4.7
+
+> gem install bundler
+
+### Windows
+
+Install Ruby. This has been most recently tested on Ruby 3.4.7.
+
+Install Gitbash.
+
+> gem install bundler
+
+### All
+
+Install dependencies:
+
+> ./bin/setup
+
+## Tests
+
+Run the script on some test data. This is required to run other tests.
+This assumes there is a valid gallery.yaml file present in the current folder,
+and the photos themselves in the format DSC_1234.jpg.
+*This is required to run tests.*
+
+> ruby -Ilib bin/console test/data
+
+Run other tests:
+
+> rake
+
+> rspec spec
+
+## Usage
+
+This assumes you are running Windows.
+
+Clone the project.
+
+Build the gem.
+
+> gem build m1key_gallery_generator.gemspec
+
+Install the gem.
+
+> gem install m1key_gallery_generator-0.3.2.gem
+
+In your gallery directory, have a file called generate.bat that looks like this:
+
+> ruby c:\Ruby34-x64\lib\ruby\gems\3.4.0\gems\m1key_gallery_generator-0.3.2\bin\console . wait_on_error
+
+## Development
+
+### Release
+
+To release a new version, update the version number in `version.rb`,
+commit your changes,
+and then run `bundle exec rake release` to create a git tag for the version,
+push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+### Gem
+
+To build gem:
+> gem build m1key_gallery_generator.gemspec
+
+To install gem:
+> gem install m1key_gallery_generator-0.3.2.gem
+
+To test gem:
+> irb
+
+> require 'm1key_gallery_generator'
+
+### Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'm1key_gallery_generator'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install m1key_gallery_generator
+
+## Gotchas
+
+Do not edit the templates in Atom due to its whitespace magic. I used vi instead.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+desc 'Run tests'
+task default: :test

data/bin/console

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+
+require 'm1key_gallery_generator'
+require 'erb'
+
+Encoding.default_external = Encoding::UTF_8
+
+include GalleryGenerator
+
+OUTPUT_FILE = 'index.html'
+DEFAULT_GALLERY_CONFIG_FILE = 'gallery.yaml'
+
+puts "M1key.me Gallery Generator #{M1keyGalleryGenerator::VERSION}"
+puts 'www.m1key.me'
+puts 'This generates a m1key.me style gallery HTML code.'
+puts
+
+working_directory = if ARGV.empty?
+  Dir.pwd.tap { |dir| puts "Working directory not specified. Using [#{dir}]." }
+else
+  ARGV[0].tap { |dir| puts "Using working directory [#{dir}]." }
+end
+
+puts
+
+begin
+  gallery_config = GalleryConfig.new(File.join(working_directory, DEFAULT_GALLERY_CONFIG_FILE))
+  viewable_photos = photos_config_into_viewable_photos(working_directory, gallery_config)
+
+  puts 'Creating viewable gallery...'
+
+  gallery = ViewableGallery.new(gallery_config.title, gallery_config.description, gallery_config.slug,
+    gallery_config.sources, gallery_config.upload_date, gallery_config.map_url, gallery_config.map_title,
+    gallery_config.year, viewable_photos, gallery_config.small_print).
+      update_using(
+      add_tabs_before_every_description_line(3),
+      add_links_to_descriptions,
+      for_each_photo(&add_links_to_descriptions),
+      for_each_photo(&remove_final_empty_line_from_description))
+
+  puts 'Preparing to write the output...'
+
+  output_file = File.join(working_directory, OUTPUT_FILE)
+  puts "Writing gallery file #{output_file}..."
+  template_file = File.read("#{File.dirname(File.expand_path(__FILE__))}/../lib/m1key_gallery_generator/template.erb")
+  erb = ERB.new(template_file, trim_mode: '-')
+  File.write(output_file, erb.result(gallery.get_binding))
+
+  puts "#{output_file} written."
+
+rescue StandardError => e
+  puts e
+  if ARGV.length > 1 && ARGV[1] == 'wait_on_error'
+    require 'io/console'
+    STDIN.getch
+  end
+end

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/m1key_gallery_generator/console_utils.rb

@@ -0,0 +1,6 @@
+module GalleryGenerator
+  def compact(multi_line_string)
+    multi_line_string.delete("\t\r\n").squeeze(' ')
+  end
+end
+

data/lib/m1key_gallery_generator/gallery_config.rb

@@ -0,0 +1,58 @@
+require 'date'
+require 'yaml'
+require_relative 'console_utils'
+
+module GalleryGenerator
+  class GalleryConfig
+
+    attr_reader :title, :map_url, :map_title, :slug, :upload_date, :description, :sources, :year, :photos, :small_print
+
+    def initialize(yaml_config_file_name)
+      puts "Attempting to parse #{yaml_config_file_name} to read gallery configuration..."
+      gallery_configuration = YAML.safe_load_file(yaml_config_file_name, permitted_classes: [Date, Symbol], permitted_symbols: [])
+      puts 'Parsed, seemingly.'
+      puts
+
+      @title = gallery_configuration['title']
+      puts "Gallery title is [#{@title}]."
+      @map_url = gallery_configuration['map']['url']
+      puts "Map url is [#{@map_url}]."
+      @map_title = gallery_configuration['map']['title']
+      puts "Map title is [#{@map_title}]."
+      @slug = gallery_configuration['slug']
+      puts "Gallery slug is [#{@slug}]."
+      @upload_date = gallery_configuration['upload_date']
+      puts "Gallery upload date is [#{@upload_date}]."
+      @description = gallery_configuration['description']
+      puts "Gallery description is [#{compact(@description)}]."
+      @small_print = gallery_configuration['small_print']
+      puts "Small print is [#{@small_print}]."
+
+      @sources = gallery_configuration['sources']
+
+      gallery_year_from_yaml =  gallery_configuration['year']
+      if gallery_year_from_yaml == 'current'
+        puts 'Using current year for gallery year...'
+        current_year = Date.today.strftime('%Y')
+        @year = Integer(current_year)
+      else
+        @year = Integer(gallery_year_from_yaml)
+        unless @year > 999 and @year < 10000
+          abort 'Gallery year should be exactly four digits long.'
+        end
+      end
+      puts "Gallery year is [#{year}]."
+      puts
+
+      @photos = gallery_configuration['photos']
+    end
+
+    def total_photos_number
+      @photos.size
+    end
+
+    def photo_id_digits
+      [2, total_photos_number.to_s.size].max
+    end
+  end
+end

data/lib/m1key_gallery_generator/gallery_mutators.rb

@@ -0,0 +1,34 @@
+require_relative 'string_utils'
+
+module GalleryGenerator
+  def add_tabs_before_every_description_line(how_many_tabs)
+    lambda do |mutable_viewable_content|
+      mutable_viewable_content.description = add_tabs_before_every_line(mutable_viewable_content.description, how_many_tabs)
+      mutable_viewable_content
+    end
+  end
+
+  def add_links_to_descriptions
+    lambda do |mutable_viewable_content|
+      mutable_viewable_content.description = add_links_to_sources(mutable_viewable_content.description)
+      mutable_viewable_content
+    end
+  end
+
+  def remove_final_empty_line_from_description
+    lambda do |mutable_viewable_content|
+      mutable_viewable_content.description = remove_final_empty_line(mutable_viewable_content.description)
+      mutable_viewable_content
+    end
+  end
+
+  def for_each_photo(&update_function)
+    lambda do |mutable_viewable_gallery|
+      mutable_viewable_gallery.photos.each do |mutable_viewable_photo|
+        update_function.call(mutable_viewable_photo)
+      end
+      mutable_viewable_gallery
+    end
+  end
+end
+

data/lib/m1key_gallery_generator/photos_utils.rb

@@ -0,0 +1,51 @@
+require 'exifr/jpeg'
+require 'fileutils'
+require_relative 'viewable_photo_metadata'
+
+module GalleryGenerator
+
+  def photos_config_into_viewable_photos(working_directory, gallery_config)
+    photos = []
+    current_photo_number = 0
+    total_photos_number = gallery_config.total_photos_number
+    photo_id_digits = gallery_config.photo_id_digits
+    puts "There are [#{total_photos_number}] photos total."
+    gallery_config.photos.each do |photo|
+      current_photo_number += 1
+      photo_id = to_photo_id(current_photo_number, photo_id_digits)
+      photo_title = photo['title']
+      photo_description = photo['description']
+      photo_file_name_contains = photo['fileNameContains']
+      photo_technical_info = photo['technicalInfo']
+      photo_metadata = get_metadata_for_image_with_file_name_containing(working_directory, photo_file_name_contains)
+
+      puts "Adding photo with ID [#{photo_id}], title [#{photo_title}], height [#{photo_metadata.height}], description [#{compact(photo['description'])}]..."
+      photos.push ViewablePhoto.new(photo_id, photo_title, photo_description, photo_metadata, photo_technical_info)
+
+      create_gallery_image(photo_metadata.original_file_name, gallery_config.slug, photo_id, working_directory)
+    end
+    photos
+  end
+
+  def to_photo_id(current_photo_number, photo_id_digits)
+    current_photo_number.to_s.rjust(photo_id_digits, '0')
+  end
+
+  def get_metadata_for_image_with_file_name_containing(working_directory, file_name_contains)
+    selected_file_name = Dir.entries(working_directory).find { |file_name| file_name.include?(file_name_contains.to_s) }
+
+    raise "ERROR  No matching photo found for #{file_name_contains}." unless selected_file_name
+
+    exif = EXIFR::JPEG.new(File.join(working_directory, selected_file_name))
+    photo_height = exif.height
+    photo_iso = exif.iso_speed_ratings
+    photo_focal_length = exif.focal_length.to_f.round.to_s
+    photo_f_number = exif.f_number.to_f
+    photo_exposure_time = exif.exposure_time.to_s
+    ViewablePhotoMetadata.new(selected_file_name, photo_height, photo_iso, photo_focal_length, photo_f_number, photo_exposure_time)
+  end
+
+  def create_gallery_image(original_file_name, gallery_slug, photo_id, working_directory)
+    FileUtils.cp(File.join(working_directory, original_file_name), File.join(working_directory, "#{gallery_slug}_#{photo_id}#{File.extname(original_file_name)}"))
+  end
+end

data/lib/m1key_gallery_generator/string_utils.rb

@@ -0,0 +1,19 @@
+module GalleryGenerator
+  def tabs(how_many_tabs)
+    "  " * how_many_tabs
+  end
+
+  def add_tabs_before_every_line(multi_line_string, how_many_tabs)
+    multi_line_string.each_line.map { |line| tabs(how_many_tabs) + line }.join
+  end
+
+  def remove_final_empty_line(multi_line_string)
+    lines = multi_line_string.lines
+    lines[-1] = lines[-1].sub(/[\r\n]$/, '') if lines.any?
+    lines.join
+  end
+
+  def add_links_to_sources(multi_line_string)
+    multi_line_string.gsub(/\[(\d+)\]/, '[<a href="#sources">\1</a>]')
+  end
+end

data/lib/m1key_gallery_generator/template.erb

@@ -0,0 +1,129 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width,initial-scale=1" />
+  <title><%= title %> &mdash; Photography and Art portfolio by Michal Huniewicz</title>
+  <meta name="description" content="<%= title %> &mdash; Photography and Art portfolio by Michal Huniewicz" />
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+  <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@800;900&display=swap" rel="stylesheet" />
+  <link href="https://fonts.googleapis.com/css2?family=Libre+Baskerville:wght@400;500;600;700&display=swap"
+    rel="stylesheet" />
+  <link rel="stylesheet" href="../../styles/base_responsive.css" />
+  <link rel="icon" href="../../images/icon.ico" />
+
+  <meta property="og:locale" content="en_US" />
+  <meta property="og:type" content="website" />
+  <meta property="og:title" content="<%= title %> by Michal Huniewicz" />
+  <meta property="og:description" content="<%= title %> &mdash; Photography and Art portfolio by Michal Huniewicz" />
+  <meta property="og:url" content="https://www.m1key.me/" />
+  <meta property="og:image" content="https://www.m1key.me/photography/<%= slug %>/<%= slug %>_01.jpg" />
+  <meta property="og:image:alt" content="<%= title %> by Michal Huniewicz" />
+
+  <meta name="twitter:card" content="summary_large_image" />
+  <meta name="twitter:title" content="<%= title %> by Michal Huniewicz" />
+  <meta name="twitter:description" content="<%= title %> &mdash; Photography and Art portfolio by Michal Huniewicz" />
+  <meta name="twitter:image" content="https://www.m1key.me/photography/<%= slug %>/<%= slug %>_01.jpg" />
+
+  <!-- Breadcrumb structured data for SEO -->
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "ImageGallery",
+    "name": "<%= title %> by Michal Huniewicz",
+    "url": "https://www.m1key.me/photography/<%= slug %>",
+    "author": {
+      "@type": "Person",
+      "name": "Michal Huniewicz"
+    },
+	"image": [
+	  {
+	    "@type": "ImageObject",
+	    "contentUrl" : "https://www.m1key.me/photography/<%= slug %>/<%= slug %>_01.jpg",
+	    "caption": "<%= title %>"
+	  }
+	],
+    "description": "<%= title %> &mdash; Photography and Art portfolio by Michal Huniewicz"
+  }
+  </script>
+</head>
+
+<body>
+
+  <main class="bigger-container">
+    <nav class="navigation" aria-label="Gallery navigation">
+      <ul>
+        <li><a href="../" class="nav-link">&lt; Back to Photography</a></li>
+        <li><a href="../../" class="nav-link">&lt;&lt; Back to M1key.me</a></li>
+      </ul>
+    </nav>
+
+    <header class="site-header">
+      <h1 class="page-title"><%= title %> by Michal Huniewicz</h1>
+    </header>
+
+    <section class="information" aria-labelledby="info-heading">
+      <h2 id="info-heading" class="visually-hidden">About this shoot</h2>
+<%= description -%>
+      
+      <p class="smallprint">
+        <span id="sources">Sources</span>:<% sources.each_with_index do |source, index| %>
+		    <a href="<%= source %>" class="nav-link">source <%= index + 1 %></a><% if (index + 1) < sources.size %>,<% else %>.<% end -%>
+		  <% end %>
+      </p>
+<% if small_print.to_s != '' %>
+      <p><%= small_print -%></p><% end %>
+      <p class="smallprint">Uploaded on: <%= upload_date %>.</p>
+    </section>
+
+    <figure class="map">
+      <a href="<%= map_url %>"
+        target="_blank" rel="noopener noreferrer">
+        <img src="<%= slug %>_map.png" alt="Map showing <%= map_title %> location (opens in OpenStreetMap)"
+          title="<%= map_title %>" width="320" height="240" />
+      </a>
+      <figcaption class="visually-hidden">Map showing <%= map_title %> location (opens in OpenStreetMap)</figcaption>
+    </figure>
+	<% photos.each do |photo| %>
+    <article class="photo" id="<%= photo.id %>">
+      <header>
+        <h2 class="title"><a href="#<%= photo.id %>" title="Link to this photo"><%= photo.title %></a></h2>
+      </header>
+      <figure class="image-container">
+        <img src="<%= slug %>_<%= photo.id %>.jpg" alt="<%= photo.title %>" loading="lazy" />
+        <figcaption>
+          <span class="description"><%= photo.description %></span>
+          <span class="technical">ISO <%= photo.metadata.iso %>, <%= photo.metadata.focal_length %>mm, f/<%= photo.metadata.f_number %>, <%= photo.metadata.exposure_time %>s.<% if photo.technical_info.to_s != '' %> <%= photo.technical_info %><% end %></span>
+        </figcaption>
+      </figure>
+    </article>
+	<% end %>
+    <nav class="navigation" aria-label="Gallery navigation bottom">
+      <ul>
+        <li><a href="../" class="nav-link">&lt; Back to Photography</a></li>
+        <li><a href="../../" class="nav-link">&lt;&lt; Back to M1key.me</a></li>
+      </ul>
+    </nav>
+
+  </main>
+
+  <footer class="site-footer">
+    <nav class="footer-nav" aria-label="Site navigation">
+      <ul>
+        <li><a href="https://www.m1key.me" class="nav-link">M1key.me</a></li>
+        <li><a href="https://www.m1key.me/photography/" class="nav-link">Photography</a></li>
+        <li><a href="https://www.m1key.me/about_me/" class="nav-link">About me</a></li>
+        <li><a href="https://www.flickr.com/photos/m1key-me/" rel="noopener noreferrer" class="nav-link">Flickr</a></li>
+      </ul>
+    </nav>
+
+    <div class="legal">
+      <p>&copy;2010&ndash;<%= year %> Michal Huniewicz &mdash; m1key.me</p>
+    </div>
+  </footer>
+
+</body>
+
+</html>

data/lib/m1key_gallery_generator/version.rb

@@ -0,0 +1,3 @@
+module M1keyGalleryGenerator
+  VERSION = '0.3.2'
+end

data/lib/m1key_gallery_generator/viewable_gallery.rb

@@ -0,0 +1,65 @@
+require_relative 'string_utils'
+
+module GalleryGenerator
+  class ViewableGallery
+    attr_reader :title, :description, :slug, :sources, :upload_date, :map_url, :map_title, :year, :photos, :small_print
+    def initialize(title, description, slug, sources, upload_date, map_url, map_title, year, viewable_photos, small_print)
+      @title = String.new(title)
+      @description = description
+      @slug = slug
+      @sources = sources
+      @upload_date = upload_date
+      @map_url = map_url
+      @map_title = map_title
+      @year = year
+      @photos = viewable_photos
+      @small_print = small_print
+    end
+
+    def get_binding
+      binding
+    end
+
+    def update_using(*update_functions)
+      updated_gallery = MutableViewableGallery.new(self)
+
+      update_functions.each do |update_function|
+        updated_gallery = update_function.call(updated_gallery)
+      end
+
+      ViewableGallery.new(updated_gallery.title, updated_gallery.description, updated_gallery.slug,
+          updated_gallery.sources, updated_gallery.upload_date, updated_gallery.map_url,
+          updated_gallery.map_title, updated_gallery.year, to_viewable_photos(updated_gallery.photos), updated_gallery.small_print)
+    end
+
+    def to_viewable_photos(mutable_viewable_photos)
+      mutable_viewable_photos.map do |mutable_viewable_photo|
+        ViewablePhoto.new(mutable_viewable_photo.id, mutable_viewable_photo.title, mutable_viewable_photo.description, mutable_viewable_photo.metadata, mutable_viewable_photo.technical_info)
+      end
+    end
+
+  end
+
+  class MutableViewableGallery
+    attr_accessor :title, :description, :slug, :sources, :upload_date, :map_url, :map_title, :year, :photos, :small_print
+    def initialize(viewable_gallery)
+      @title = viewable_gallery.title
+      @description = viewable_gallery.description
+      @slug = viewable_gallery.slug
+      @sources = viewable_gallery.sources
+      @upload_date = viewable_gallery.upload_date
+      @map_url = viewable_gallery.map_url
+      @map_title = viewable_gallery.map_title
+      @year = viewable_gallery.year
+      @photos = to_mutable_viewable_photos(viewable_gallery.photos)
+      @small_print = viewable_gallery.small_print
+    end
+
+    def to_mutable_viewable_photos(viewable_photos)
+      viewable_photos.map do |viewable_photo|
+        MutableViewablePhoto.new(viewable_photo)
+      end
+    end
+  end
+end
+

data/lib/m1key_gallery_generator/viewable_photo.rb

@@ -0,0 +1,24 @@
+module GalleryGenerator
+  class ViewablePhoto
+    attr_reader :id, :title, :description, :metadata, :technical_info
+    def initialize(id, title, description, metadata, technical_info)
+      @id = id
+      @title = title
+      @description = description
+      @metadata = metadata
+      @technical_info = technical_info
+    end
+  end
+
+  class MutableViewablePhoto
+    attr_accessor :id, :title, :description, :metadata, :technical_info
+    def initialize(viewable_photo)
+      @id = viewable_photo.id
+      @title = viewable_photo.title
+      @description = viewable_photo.description
+      @metadata = viewable_photo.metadata
+      @technical_info = viewable_photo.technical_info
+    end
+  end
+end
+

data/lib/m1key_gallery_generator/viewable_photo_metadata.rb

@@ -0,0 +1,14 @@
+module GalleryGenerator
+  class ViewablePhotoMetadata
+    attr_reader :original_file_name, :height, :iso, :focal_length, :f_number, :exposure_time
+    def initialize(original_file_name, height, iso, focal_length, f_number, exposure_time)
+      @original_file_name = original_file_name
+      @height = height
+      @iso = iso
+      @focal_length = focal_length
+      @f_number = f_number
+      @exposure_time = exposure_time
+    end
+  end
+end
+

data/lib/m1key_gallery_generator.rb

@@ -0,0 +1,6 @@
+require_relative 'm1key_gallery_generator/version'
+require_relative 'm1key_gallery_generator/viewable_gallery'
+require_relative 'm1key_gallery_generator/viewable_photo'
+require_relative 'm1key_gallery_generator/gallery_config'
+require_relative 'm1key_gallery_generator/photos_utils'
+require_relative 'm1key_gallery_generator/gallery_mutators'

data/m1key_gallery_generator.gemspec

@@ -0,0 +1,30 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'm1key_gallery_generator/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'm1key_gallery_generator'
+  spec.version       = M1keyGalleryGenerator::VERSION
+  spec.authors       = ['Mike Huniewicz']
+  spec.email         = ['REDACTED']
+  spec.required_ruby_version = '>= 3.0'
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  spec.summary       = 'm1key.me-style gallery generator.'
+  spec.description   = 'This gem allows you to generate a m1key.me-style gallery based on the JPG files in the working directory.'
+  spec.homepage      = 'https://github.com/m1key/m1key_gallery_generator'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'exifr', '~> 1.4', '>= 1.4.0'
+
+  spec.add_development_dependency 'bundler', '= 2.7.2'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'minitest', '~> 5.15'
+  spec.add_development_dependency 'rspec', '~> 3.13'
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: m1key_gallery_generator
+version: !ruby/object:Gem::Version
+  version: 0.3.2
+platform: ruby
+authors:
+- Mike Huniewicz
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: exifr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.15'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: This gem allows you to generate a m1key.me-style gallery based on the
+  JPG files in the working directory.
+email:
+- REDACTED
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/m1key_gallery_generator.rb
+- lib/m1key_gallery_generator/console_utils.rb
+- lib/m1key_gallery_generator/gallery_config.rb
+- lib/m1key_gallery_generator/gallery_mutators.rb
+- lib/m1key_gallery_generator/photos_utils.rb
+- lib/m1key_gallery_generator/string_utils.rb
+- lib/m1key_gallery_generator/template.erb
+- lib/m1key_gallery_generator/version.rb
+- lib/m1key_gallery_generator/viewable_gallery.rb
+- lib/m1key_gallery_generator/viewable_photo.rb
+- lib/m1key_gallery_generator/viewable_photo_metadata.rb
+- m1key_gallery_generator.gemspec
+homepage: https://github.com/m1key/m1key_gallery_generator
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: m1key.me-style gallery generator.
+test_files: []