RubyGems - tinyzap - Versions diffs - 0.1.4 - Mend

tinyzap 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

checksums.yaml +7 -0
data/MIT-LICENSE +20 -0
data/README.md +98 -0
data/Rakefile +8 -0
data/app/assets/config/tinyzap_manifest.js +1 -0
data/app/assets/stylesheets/tinyzap/application.css +15 -0
data/app/controllers/concerns/tinyzap/open_graph.rb +43 -0
data/app/controllers/tinyzap/application_controller.rb +4 -0
data/app/helpers/tinyzap/application_helper.rb +4 -0
data/app/helpers/tinyzap/open_graph_tag_helper.rb +7 -0
data/app/jobs/tinyzap/application_job.rb +4 -0
data/app/mailers/tinyzap/application_mailer.rb +6 -0
data/app/models/tinyzap/application_record.rb +5 -0
data/app/models/tinyzap/open_graph/base.rb +51 -0
data/app/models/tinyzap/open_graph/image.rb +12 -0
data/app/models/tinyzap/open_graph/metatag.rb +11 -0
data/app/models/tinyzap/open_graph/metatag_mapper.rb +35 -0
data/app/models/tinyzap/open_graph/model.rb +35 -0
data/app/models/tinyzap/open_graph/twitter.rb +11 -0
data/app/views/layouts/tinyzap/application.html.erb +15 -0
data/config/initializers/inflections.rb +3 -0
data/config/initializers/mime_types.rb +3 -0
data/config/routes.rb +2 -0
data/exe/tinyzap +4 -0
data/lib/generators/tinyzap/install/USAGE +11 -0
data/lib/generators/tinyzap/install/install_generator.rb +19 -0
data/lib/generators/tinyzap/install/templates/application.opengraph.erb +15 -0
data/lib/generators/tinyzap/install/templates/tinyzap.rb.tt +14 -0
data/lib/tasks/tinyzap_tasks.rake +4 -0
data/lib/tinyzap/cli.rb +23 -0
data/lib/tinyzap/client.rb +13 -0
data/lib/tinyzap/configuration.rb +18 -0
data/lib/tinyzap/engine.rb +5 -0
data/lib/tinyzap/key_generator.rb +43 -0
data/lib/tinyzap/url_signature.rb +44 -0
data/lib/tinyzap/version.rb +3 -0
data/lib/tinyzap.rb +28 -0
metadata +126 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1accdcd2a97326d9828e08162431229177c9de87f73648bf39df58f36ccaf84e
+  data.tar.gz: 1872a8d9330c3a77eba6848ba181b48e6de9285241478b5ba16f5ad4f7eb20aa
+SHA512:
+  metadata.gz: ba985f66472361e4c5957d49537f83e4d31e92928888fd6b59b11d47b1d37c16fb93a2beb6f60b5ed028f676173af3bb8f633763d0a0d7b9041d145a4302f04b
+  data.tar.gz: e564ae50f51ef060029354f88760412c1777e06c993d1d03003230fcb08d7ab712f1aa92f570df494a6fbc1dcdfd9d829810c0f21a5e914b9892527dbcfde426

data/MIT-LICENSE ADDED Viewed

@@ -0,0 +1,20 @@
+Copyright 2022 Brad Gessler
+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 ADDED Viewed

@@ -0,0 +1,98 @@
+# TinyZap
+[![Ruby](https://github.com/tinyzap/ruby/actions/workflows/ruby.yml/badge.svg)](https://github.com/tinyzap/ruby/actions/workflows/ruby.yml)
+The easiest way to make Rails applications look great in Apple Messages, Facebook, LinkedIn, Twitter, and any other website that use Open Graph.
+## Installation
+From the root of your Rails application, run:
+```bash
+$ bundle add "tinyzap"
+```
+Then run:
+```bash
+$ rails generate tinyzap:install
+```
+This creates a `app/views/layout/application.opengraph.erb` file and adds `include TinyZap::OpenGraph` to `ApplicationController`.
+Add to your `app/views/layouts/application.html.erb` file:
+```
+<head>
+  <%= opengraph_meta_tags %>
+</head>
+```
+That's it for the bare minimum! A screenshot of the top part of the webpage will appear by default for all open graph images. Custom badges are where its at though, so read on my friend.
+## Setting OpenGraph data
+Open graph data can be set from the view or controller via the `opengraph` method.
+### Controller
+Here's a few ways to set opengraph data from a controller.
+```ruby
+class PostsController < ApplicationController
+  before_action: :assign_opengraph_data
+  def edit
+    # This overrides the title that's set from `assign_opengraph_data`
+    opengraph.title = "Editing #{@post.title}"
+  end
+  protected
+  def assign_opengraph_data
+    opengraph.title = @post.title
+    opengraph.description = @post.summary
+    # Displays the first image of a blog post, instead of a screenshot, for the opengraph image.
+    # Assumes the image was managed via ActiveStorage.
+    opengraph.image = url_for(@post.images.first)
+  end
+end
+```
+### View
+OpenGraph data may also be set from the view:
+```erb
+<%
+  opengraph.title = @post.title
+  opengraph.description = @post.summary
+%>
+<h1><%= @post.title %></h1>
+<article><%= @post.body %></article>
+```
+## Custom badges with Rails Views
+The real power in TinyZap Open Graph is creating custom badges via the `opengraph` format in your rails views. For the example below, we'll create an Open Graph badge for a blog post. Assuming a blog application has a `/posts/:id` with a view at `app/views/posts/show.html.erb`, we'd create a new view with the `opengraph` format:
+```bash
+$ touch ./app/views/posts/show.opengraph.erb
+```
+Open the file and add something like:
+```erb
+<h1><%= @post.title %></h1>
+<article><%= truncate @post.body, length: 100 %></article>
+<p>This article will take <%= time_to_read @post.body %> minutes to read</p>
+```
+The TinyZap screenshot service will take a screenshot of the content at this URL and use it for the Open Graph image.
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile ADDED Viewed

@@ -0,0 +1,8 @@
+require "bundler/setup"
+APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+load "rails/tasks/statistics.rake"
+require "bundler/gem_tasks"

data/app/assets/config/tinyzap_manifest.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ //= link_directory ../stylesheets/tinyzap .css

data/app/assets/stylesheets/tinyzap/application.css ADDED Viewed

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/concerns/tinyzap/open_graph.rb ADDED Viewed

@@ -0,0 +1,43 @@
+module TinyZap
+  module OpenGraph
+    extend ActiveSupport::Concern
+    DEFAULT_OPENGRAPH_TYPE = "website".freeze
+    DEFAULT_OPENGRAPH_FALLBACK_FORMATS = [ :opengraph, :html ]
+    included do
+      before_action :assign_opengraph_fallback_formats, if: :opengraph_request?
+      before_action :assign_opengraph_defaults
+      helper TinyZap::OpenGraphTagHelper
+      helper_method :opengraph
+    end
+    protected
+      def assign_opengraph_fallback_formats
+        request.formats = DEFAULT_OPENGRAPH_FALLBACK_FORMATS
+      end
+      def opengraph_request?
+        request.format.opengraph?
+      end
+      def url_for_opengraph_image
+        tinyzap_opengraph_url url: url_for(format: :opengraph)
+      end
+      def tinyzap_opengraph_url(*args, **kwargs)
+        TinyZap.client.url_signature.url_for "opengraph", *args, **kwargs
+      end
+      def opengraph
+        @opengraph ||= Model.new
+      end
+      def assign_opengraph_defaults
+        opengraph.image ||= url_for_opengraph_image
+        opengraph.type ||= DEFAULT_OPENGRAPH_TYPE
+      end
+  end
+end

data/app/controllers/tinyzap/application_controller.rb ADDED Viewed

@@ -0,0 +1,4 @@
+module TinyZap
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/tinyzap/application_helper.rb ADDED Viewed

@@ -0,0 +1,4 @@
+module TinyZap
+  module ApplicationHelper
+  end
+end

data/app/helpers/tinyzap/open_graph_tag_helper.rb ADDED Viewed

@@ -0,0 +1,7 @@
+module TinyZap
+  module OpenGraphTagHelper
+    def opengraph_meta_tags(model=opengraph)
+      model.to_html
+    end
+  end
+end

data/app/jobs/tinyzap/application_job.rb ADDED Viewed

@@ -0,0 +1,4 @@
+module TinyZap
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/tinyzap/application_mailer.rb ADDED Viewed

@@ -0,0 +1,6 @@
+module TinyZap
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/tinyzap/application_record.rb ADDED Viewed

@@ -0,0 +1,5 @@
+module TinyZap
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/tinyzap/open_graph/base.rb ADDED Viewed

@@ -0,0 +1,51 @@
+module TinyZap
+  module OpenGraph
+    # Provides a way to specify OpenGraph keys for an OpenGraphModel, which can later
+    # be iterated upon to generate OpenGraph meta tags.
+    class Base
+      # Encapsulates OpenGraph properties and provides helpers that are
+      # useful for documentation purposes or for reflecting on Ruby objects.
+      class Property
+        attr_accessor :key, :name, :description, :default
+        def initialize(key, description = nil, default: nil)
+          @key = key
+          @description = description
+          # If we get a string like `og:image:url`, this would give us `url`
+          *_, @name = key.rpartition(":")
+          @default = default
+        end
+      end
+      # Allows for the object to be initialized with args like `Image.new(url: "https://example.com/logo.png", alt: "Logo image")`.
+      def initialize(**kwargs)
+        kwargs.each do |kwarg, value|
+          self.send("#{kwarg}=", value)
+        rescue NoMethodError
+          raise NoMethodError, "#{kwarg.inspect} is not a property of #{self.inspect}"
+        end
+      end
+      # DSL for creating properties when defining a model.
+      def self.property(*args, **kwargs)
+        property = Property.new *args, **kwargs
+        attr_accessor property.name
+        self.properties.append property
+      end
+      # Array where properties are registered.
+      def self.properties
+        @properties ||= []
+      end
+      # Iterates through the properties and also gets their value.
+      def properties
+        Enumerator.new do |y|
+          self.class.properties.each do |property|
+            y << [ property, (self.send(property.name) || property.default) ]
+          end
+        end
+      end
+    end
+  end
+end

data/app/models/tinyzap/open_graph/image.rb ADDED Viewed

@@ -0,0 +1,12 @@
+module TinyZap
+  module OpenGraph
+    class Image < Base
+      property "og:image:url",        "Identical to og:image."
+      property "og:image:secure_url", "An alternate url to use if the webpage requires HTTPS."
+      property "og:image:type",       "A MIME type for this image."
+      property "og:image:width",      "The number of pixels wide."
+      property "og:image:height",     "The number of pixels high."
+      property "og:image:alt",        "A description of what is in the image (not a caption). If the page specifies an og:image it should specify og:image:alt."
+    end
+  end
+end

data/app/models/tinyzap/open_graph/metatag.rb ADDED Viewed

@@ -0,0 +1,11 @@
+module TinyZap
+  module OpenGraph
+    class Metatag < Struct.new(:property, :content)
+      include ActionView::Helpers::TagHelper
+      def to_html
+        tag :meta, property: property, content: content
+      end
+    end
+  end
+end

data/app/models/tinyzap/open_graph/metatag_mapper.rb ADDED Viewed

@@ -0,0 +1,35 @@
+module TinyZap
+  module OpenGraph
+    # Iterates recursively through an OpenGraph object and gets a bunch of
+    # metatags and keys.
+    class MetatagMapper
+      include ActionView::Helpers::OutputSafetyHelper
+      attr_reader :model
+      delegate :context,
+        to: :model
+      def initialize(model)
+        @model = model
+      end
+      def metatags
+        Enumerator.new do |y|
+          model.properties.each do |property, content|
+            if content.respond_to? :properties
+              MetatagMapper.new(content).metatags.each do |tag|
+                y << tag
+              end
+            else
+              y << Metatag.new(property.key, content) if content.present?
+            end
+          end
+        end
+      end
+      def to_html
+        safe_join metatags.map(&:to_html), "\n"
+      end
+    end
+  end
+end

data/app/models/tinyzap/open_graph/model.rb ADDED Viewed

@@ -0,0 +1,35 @@
+module TinyZap
+  module OpenGraph
+    class Model < Base
+      property "og:title",        %[The title of your object as it should appear within the graph, e.g., "The Rock".]
+      property "og:type",         %[The type of your object, e.g., "video.movie". Depending on the type you specify, other properties may also be required.]
+      property "og:image",        %[An image URL which should represent your object within the graph.]
+      property "og:url",          %[The canonical URL of your object that will be used as its permanent ID in the graph, e.g., "https://www.imdb.com/title/tt0117500/".]
+      property "og:description",  %[A one to two sentence description of your object.]
+      property "twitter",  %[A one to two sentence description of your object.]
+      delegate :to_html, to: :metatag_mapper
+      def image
+        @image ||= Image.new
+      end
+      def image=(url)
+        image.url = url
+      end
+      def twitter
+        @twitter ||= Twitter.new.tap do |twitter|
+          twitter.title = title
+          twitter.description = description
+          twitter.image = image.url
+        end
+      end
+      private
+        def metatag_mapper
+          MetatagMapper.new(self)
+        end
+    end
+  end
+end

data/app/models/tinyzap/open_graph/twitter.rb ADDED Viewed

@@ -0,0 +1,11 @@
+module TinyZap
+  module OpenGraph
+    class Twitter < Base
+      property "twitter:card",        "Type of card, which is 'summary_large_image'", default: "summary_large_image"
+      property "twitter:site",        "Twitter @handle of the account"
+      property "twitter:title",       "Title of the card, similar to og:title"
+      property "twitter:description", "Description of the card, similar to og:description"
+      property "twitter:image",       "Image URL of the card, similar to og:image"
+    end
+  end
+end

data/app/views/layouts/tinyzap/application.html.erb ADDED Viewed

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TinyZap</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+  <%= stylesheet_link_tag    "tinyzap/application", media: "all" %>
+</head>
+<body>
+<%= yield %>
+</body>
+</html>

data/config/initializers/inflections.rb ADDED Viewed

@@ -0,0 +1,3 @@
+ActiveSupport::Inflector.inflections(:en) do |inflect|
+  inflect.acronym "TinyZap"
+end

data/config/initializers/mime_types.rb ADDED Viewed

@@ -0,0 +1,3 @@
+# Used to represent the HTML pages that will be converted into an
+# image and served up for open graph image previews.
+Mime::Type.register_alias "text/html", :opengraph

data/config/routes.rb ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ TinyZap::Engine.routes.draw do
2	+ end

data/exe/tinyzap ADDED Viewed

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "tinyzap"
+TinyZap::CLI.start ARGV

data/lib/generators/tinyzap/install/USAGE ADDED Viewed

@@ -0,0 +1,11 @@
+Description:
+    Installs TinyZap in Rails
+Example:
+    bin/rails generate install:tinyzap
+    Creates the files:
+        app/views/layouts/application.opengraph.html
+    Patches ApplicationController by adding:
+        include TinyZap::OpenGraph

data/lib/generators/tinyzap/install/install_generator.rb ADDED Viewed

@@ -0,0 +1,19 @@
+class TinyZap::InstallGenerator < Rails::Generators::Base
+  source_root File.expand_path("templates", __dir__)
+  def include_controller_helper
+    inject_into_file 'app/controllers/application_controller.rb', after: "class ApplicationController < ActionController::Base\n" do <<-'RUBY'
+  include TinyZap::OpenGraph
+    RUBY
+    end
+  end
+  def copy_layout
+    copy_file "application.opengraph.erb", "app/views/layouts/application.opengraph.erb"
+  end
+  def copy_configuration_file
+    template "tinyzap.rb.tt", "config/initializers/tinyzap.rb"
+  end
+end

data/lib/generators/tinyzap/install/templates/application.opengraph.erb ADDED Viewed

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= opengraph.title %></title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <%= stylesheet_link_tag "application", "data-turbo-track": "reload" %>
+    <%= javascript_importmap_tags %>
+  </head>
+  <body>
+    <%= yield %>
+  </body>
+</html>

data/lib/generators/tinyzap/install/templates/tinyzap.rb.tt ADDED Viewed

@@ -0,0 +1,14 @@
+TinyZap.configure do |config|
+  if Rails.env.production?
+    # For production deployments, set the following environment keys:
+    #
+    # ```
+    # TINYZAP_SECRET_KEY=
+    # TINYZAP_PUBLIC_KEY=
+    # ```
+    config.load_env
+  else
+    config.secret_key = "<%= TinyZap.key_generator.secret_key %>"
+    config.public_key = "<%= TinyZap.key_generator.public_key %>"
+  end
+end

data/lib/tasks/tinyzap_tasks.rake ADDED Viewed

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :tinyzap do
+#   # Task goes here
+# end

data/lib/tinyzap/cli.rb ADDED Viewed

@@ -0,0 +1,23 @@
+require "thor"
+module TinyZap
+  class CLI < Thor
+    include Thor::Actions
+    desc "install", "Install TinyZap to the Rails application"
+    def install
+      run "./bin/bundle add tinyzap"
+      run "./bin/rails generate tinyzap:install"
+    end
+    desc "version", "Prints the version of tinyzap"
+    def version
+      puts TinyZap::VERSION
+    end
+    desc "environment [ENVIRONMENT]", "Generates environment variables for target enrivonment"
+    def environment(environment = TinyZap::KeyGenerator::ENVIRONMENT)
+      puts TinyZap.key_generator(environment: environment).env_vars
+    end
+  end
+end

data/lib/tinyzap/client.rb ADDED Viewed

@@ -0,0 +1,13 @@
+module TinyZap
+  class Client
+    delegate :secret_key, :public_key, to: :configuration
+    def url_signature
+      @url_signature ||= UrlSignature.new(secret_key: secret_key, public_key: public_key)
+    end
+    def configuration
+      @configuration ||= Configuration.new
+    end
+  end
+end

data/lib/tinyzap/configuration.rb ADDED Viewed

@@ -0,0 +1,18 @@
+module TinyZap
+  class Configuration
+    attr_accessor :secret_key, :public_key
+    def load_secret_key_env
+      self.secret_key = ENV["TINYZAP_SECRET_KEY"]
+    end
+    def load_public_key_env
+      self.public_key = ENV["TINYZAP_PUBLIC_KEY"]
+    end
+    def load_env
+      load_secret_key_env
+      load_public_key_env
+    end
+  end
+end

data/lib/tinyzap/engine.rb ADDED Viewed

@@ -0,0 +1,5 @@
+module TinyZap
+  class Engine < ::Rails::Engine
+    isolate_namespace TinyZap
+  end
+end

data/lib/tinyzap/key_generator.rb ADDED Viewed

@@ -0,0 +1,43 @@
+require "securerandom"
+module TinyZap
+  # Generates random keys for environments.
+  class KeyGenerator
+    LENGTH = 14
+    DELIMITER = "_".freeze
+    ENVIRONMENT = :development
+    attr_reader :environment
+    def initialize(environment: ENVIRONMENT)
+      @environment = environment
+    end
+    def public_key
+      generate :public
+    end
+    def secret_key
+      generate :secret
+    end
+    def env_vars
+      <<~ENVARS
+      TINYZAP_SECRET_KEY=#{secret_key}
+      TINYZAP_PUBLIC_KEY=#{public_key}
+      ENVARS
+    end
+    def generate(*scopes)
+      scopes
+        .prepend(environment)
+        .append(random)
+        .join(DELIMITER)
+    end
+    private
+      def random
+        SecureRandom.hex(LENGTH)
+      end
+  end
+end

data/lib/tinyzap/url_signature.rb ADDED Viewed

@@ -0,0 +1,44 @@
+require "openssl"
+require "uri"
+module TinyZap
+  class UrlSignature
+    # Use for `OpenSSL::HMAC`
+    DIGEST = "SHA256".freeze
+    attr_reader :secret_key, :public_key, :path_prefix
+    def initialize(secret_key:, public_key:)
+      @secret_key = secret_key
+      @public_key = public_key
+      @path_prefix = File.join("/", "v1", public_key)
+    end
+    def signed_url(path)
+      URI.join("https://tinyzap.com/", signed_path(path))
+    end
+    def valid?(url)
+      path = URI(url).request_uri
+      version, account_key, signature, path = Regexp.new("/(v1)/(.+?)/(.+?)(/.+)").match(path).captures
+      signature == sign(path)
+    end
+    def url_for(path, **query)
+      path = URI(path).tap do |url|
+        url.path = path
+        url.query = query.to_query
+      end
+      signed_url path
+    end
+    private
+      def signed_path(path)
+        File.join(path_prefix, sign(File.join("/", path.to_s)), path.to_s)
+      end
+      def sign(data)
+        OpenSSL::HMAC.hexdigest(DIGEST, secret_key, data)
+      end
+  end
+end

data/lib/tinyzap/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module TinyZap
+  VERSION = "0.1.4"
+end

data/lib/tinyzap.rb ADDED Viewed

@@ -0,0 +1,28 @@
+require "tinyzap/version"
+require "tinyzap/engine" if defined? Rails
+require "zeitwerk"
+module TinyZap
+  Loader = Zeitwerk::Loader.for_gem.tap do |loader|
+    loader.ignore "#{__dir__}/generators"
+    loader.inflector.inflect(
+      "tinyzap" => "TinyZap",
+      "cli" => "CLI"
+    )
+    loader.setup
+  end
+  class << self
+    def client
+      @client ||= Client.new
+    end
+    def key_generator(environment: Rails.env)
+      @key_generator ||= KeyGenerator.new(environment: environment)
+    end
+    def configure(&block)
+      block.call client.configuration
+    end
+  end
+end

metadata ADDED Viewed

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: tinyzap
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- Brad Gessler
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2023-11-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+description: Easiest way to generate fresh images for Rails applications.
+email:
+- brad@tinyzap.com
+executables:
+- tinyzap
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/config/tinyzap_manifest.js
+- app/assets/stylesheets/tinyzap/application.css
+- app/controllers/concerns/tinyzap/open_graph.rb
+- app/controllers/tinyzap/application_controller.rb
+- app/helpers/tinyzap/application_helper.rb
+- app/helpers/tinyzap/open_graph_tag_helper.rb
+- app/jobs/tinyzap/application_job.rb
+- app/mailers/tinyzap/application_mailer.rb
+- app/models/tinyzap/application_record.rb
+- app/models/tinyzap/open_graph/base.rb
+- app/models/tinyzap/open_graph/image.rb
+- app/models/tinyzap/open_graph/metatag.rb
+- app/models/tinyzap/open_graph/metatag_mapper.rb
+- app/models/tinyzap/open_graph/model.rb
+- app/models/tinyzap/open_graph/twitter.rb
+- app/views/layouts/tinyzap/application.html.erb
+- config/initializers/inflections.rb
+- config/initializers/mime_types.rb
+- config/routes.rb
+- exe/tinyzap
+- lib/generators/tinyzap/install/USAGE
+- lib/generators/tinyzap/install/install_generator.rb
+- lib/generators/tinyzap/install/templates/application.opengraph.erb
+- lib/generators/tinyzap/install/templates/tinyzap.rb.tt
+- lib/tasks/tinyzap_tasks.rake
+- lib/tinyzap.rb
+- lib/tinyzap/cli.rb
+- lib/tinyzap/client.rb
+- lib/tinyzap/configuration.rb
+- lib/tinyzap/engine.rb
+- lib/tinyzap/key_generator.rb
+- lib/tinyzap/url_signature.rb
+- lib/tinyzap/version.rb
+homepage: https://tinyzap.com/
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org/
+  homepage_uri: https://tinyzap.com/
+  source_code_uri: https://github.com/tinyzap/ruby
+  changelog_uri: https://github.com/tinyzap/ruby/releases
+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: []
+rubygems_version: 3.4.6
+signing_key:
+specification_version: 4
+summary: Easiest way to generate fresh images for Rails applications.
+test_files: []