rubysmith 7.2.0 → 7.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9fdd8d0d5d95ffa934cc1530482d7be79e42d5ed191657a8bcd2d5a32156603
-  data.tar.gz: 91540e827a5d4a19ddee56f73070d6ab51a300109d3e293aabf7a01921bae108
+  metadata.gz: 1529b428758e620a07651f58648e9347d6285ae658c5ba7f4e60ec445958b279
+  data.tar.gz: 7efa1cd58738e11138bc31209ee0b6a2b0ab30a710f54016b8ad3c17b8f6a993
 SHA512:
-  metadata.gz: ce755310287dcb66dc60075580d96cd98f88a56c83f3f230bddda9ddd53be759871fd52c849ee4a4eea2cbdcc0ee628f827cd82fc82fb8d0abd907f1fee1d5af
-  data.tar.gz: 2e35bec0244e5d15ae4c50ec6a9504587855709e217011217731034c05f0c4a4a6da54a25c92ddfd8f0989588c41fd4cc111b75e94efb8579bc4c415bd9ee3b7
+  metadata.gz: bb59f4e7490b4e8298a9c14d31923f8e46d1f1ed28cc2ae0f6778d8269d4ee08eab8c304aef3c276439eb447ae5fb43d9b63cf6f9239d64a6e17bfaf70f81a7c
+  data.tar.gz: 51d8e56f5b799df3b03a9a20c8331004d5f44f0bbdf4371c8299f8a8f75a17719c74c11d2d9d4bc9159cd535f0c3bf26c86e6c1d93ece452a18d149490f490c6

data/README.adoc

@@ -2,8 +2,10 @@
 :toclevels: 5
 :figure-caption!:
 
-:gemsmith_link: link:https://alchemists.io/projects/gemsmith[Gemsmith]
 :bundler_inline_link: link:https://alchemists.io/articles/ruby_bundler_inline[Bundler Inline]
+:development_containers_link: link:https://containers.dev[Development Containers]
+:docker_link: link:https://www.docker.com[Docker]
+:gemsmith_link: link:https://alchemists.io/projects/gemsmith[Gemsmith]
 :string_formats_link: link:https://docs.ruby-lang.org/en/3.3/format_specifications_rdoc.html[String Formats]
 
 = Rubysmith
@@ -26,6 +28,8 @@ toc::[]
 * Supports link:https://orcid.org[Citations (ORCID)].
 * Supports console script for local development.
 * Supports link:https://github.com/ruby/debug[Debug].
+* Supports {development_containers_link}.
+* Supports {docker_link}.
 * Supports link:https://git-scm.com[Git].
 * Supports link:https://github.com[GitHub].
 * Supports link:https://alchemists.io/projects/git-lint[Git Lint].
@@ -46,6 +50,7 @@ toc::[]
 ** Security
 ** Code of Conduct
 ** Contributions
+** Developer Certificate of Origin
 ** Communities
 
 == Requirements
@@ -135,6 +140,11 @@ link:https://github.com/amazing-print/amazing_print[Amazing Print] gem for debug
 a handy debugging tool when inspecting your Ruby objects and printing details in a quick to read
 format.
 
+===== Bootsnap
+
+The `--bootsnap` option allows you to build your project with the
+link:https://github.com/Shopify/bootsnap[Bootsnap] gem for improved performance. This is best used for pure, non-gem, Ruby projects and/or web applications in general.
+
 ===== Caliber
 
 The `--caliber` option allows you to build your project with the
@@ -175,12 +185,26 @@ loaded.
 The `--contributions` option allows you to link to contributing documentation so people know to
 contribute back to your work.
 
+===== Developer Certificate of Origin
+
+The `--dcoo` option allows to you add link:https://developercertificate.org[Developer Certificate of Origin] documentation so all contributors are aware of how their contributions are applied in terms of ownership, copyright, and licensing.
+
+ℹ️ This is disabled by default but will be enabled by default in the next major version.
+
 ===== Debug
 
 The `--debug` option allows you add the link:https://github.com/ruby/debug[Debug] gem to your
 project for debugging your code by setting breakpoints, remotely connecting to running code, and
 much more.
 
+===== Docker
+
+The `--docker` option allows you add {docker_link} to your project so you can build and deploy to production.
+
+===== Development Containers
+
+The `--devcontainer` option allows you add {development_containers_link} support to your project so you can develop locally by running your project within a {docker_link} container.
+
 ===== Funding
 
 The `--funding` option allows you add a link:https://github.com[GitHub] funding configuration to
@@ -299,6 +323,7 @@ author:
   uri: "%<organization_uri>s/team/%<author_handle>s"
 build:
   amazing_print: true
+  bootsnap: false
   caliber: true
   circle_ci: false
   citation: true
@@ -307,7 +332,10 @@ build:
   conduct: true
   console: true
   contributions: true
+  dcoo: false
   debug: true
+  devcontainer: false
+  docker: false
   funding: false
   git: true
   git_hub: false
@@ -344,6 +372,7 @@ project:
     community: "%<organization_uri>s/community"
     conduct: "%<organization_uri>s/policies/code_of_conduct"
     contributions: "%<organization_uri>s/policies/contributions"
+    dcoo: "%<organization_uri>s/policies/developer_certificate_of_origin"
     download: "https://rubygems.org/gems/%<project_name>s"
     funding: "%<repository_uri>s/sponsors/%<repository_handle>s"
     home: "%<organization_uri>s/projects/%<project_name>s"
@@ -404,17 +433,68 @@ following options are available:
 
 ==== License
 
-Use this section to define the license you want to use for your project. The following are available:
+Use this section to define the license you want to use for your project. When picking a license, you can supply the appropriate `label` and `version` in addition to the `name`. The `name` is the only value you _can't_ customize. The following details all supported licenses.
+
+===== Apache
 
-* `apache`: Uses the link:https://www.apache.org/licenses/LICENSE-2.0[Apache] license.
-* `hippocratic`: Uses the link:https://firstdonoharm.dev[Hippocratic] license.
-* `mit`: Uses the link:https://mit-license.org[MIT] license.
+To use the link:https://www.apache.org/licenses/LICENSE-2.0[Apache] license, apply this configuration:
 
-When picking a license, you can also supply the appropriate label and version in addition to the name.
+[source,yaml]
+----
+license:
+  label: "Apache"
+  name: "apache"
+  version: "2.0"
+----
+
+===== Fair Source
+
+To use the link:https://fsl.software[Fair Source] license, apply this configuration:
+
+[source,yaml]
+----
+license:
+  label: "Fair Source"
+  name: "fair"
+  version: "FSL-1.1-Apache-2.0"
+----
+
+===== Hippocratic
+
+To use the link:https://firstdonoharm.dev[Hippocratic] license, apply this configuration:
+
+[source,yaml]
+----
+license:
+  label: "Hippocratic"
+  name: "hippocratic"
+  version: "2.1"
+----
+
+ℹ️ This is the default license unless you customize.
+
+===== MIT
+
+To use the  link:https://mit-license.org[MIT] license, apply this configuration:
+
+[source,yaml]
+----
+license:
+  label: "MIT"
+  name: "mit"
+  version: ""
+----
 
 ==== Organization
 
-Use this section to define URI information that points to your organization. This is useful for information that isn't project specific but related to all projects within your organization. You'll want to customize this URI especially for documentation purposes.
+Use this section to define organization specific information. This is useful for information that isn't project specific but related to all projects within your organization. You'll want -- highly recommended -- to supply configuration details. For example, here's what a fictional organization might look like:
+
+[source,yaml]
+----
+organization:
+  label: ACME
+  uri: https://acme.io
+----
 
 ==== Project
 
@@ -477,6 +557,8 @@ bin/rake
 
 == link:https://alchemists.io/policies/contributions[Contributions]
 
+== link:https://alchemists.io/policies/developer_certificate_of_origin[Developer Certificate of Origin]
+
 == link:https://alchemists.io/projects/rubysmith/versions[Versions]
 
 == link:https://alchemists.io/community[Community]

data/lib/rubysmith/builders/bundler.rb

@@ -13,7 +13,7 @@ module Rubysmith
                .render
                .replace(/\n\s+group/, "\n\ngroup")
                .replace(/\n\s+gem/, "\n  gem")
-               .replace(/  (?=.+(refinements|zeitwerk))/, "")
+               .replace(/  (?=.+(bootsnap|refinements|zeitwerk))/, "")
                .replace(/(\n+|\s+)end/, "\nend")
                .replace(/\n\ngroup :(quality|development|test|tools) do\nend/, "")
                .replace(/org"\n+/, "org\"\n\n")

data/lib/rubysmith/builders/dev_container/compose.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module DevContainer
+      # Builds Docker Compose configuration for container.
+      class Compose < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_devcontainer
+
+          path = "%project_name%/.devcontainer/compose.yaml.erb"
+          builder.call(settings.merge(template_path: path)).render
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/dev_container/configuration.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module DevContainer
+      # Builds container configuration.
+      class Configuration < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_devcontainer
+
+          path = "%project_name%/.devcontainer/devcontainer.json.erb"
+          builder.call(settings.merge(template_path: path)).render
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/dev_container/dockerfile.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module DevContainer
+      # Builds Dockerfile for container.
+      class Dockerfile < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_devcontainer
+
+          builder.call(settings.merge(template_path: "%project_name%/.devcontainer/Dockerfile.erb"))
+                 .render
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/docker/build.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module Docker
+      # Builds Docker build script.
+      class Build < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_docker
+
+          builder.call(settings.merge(template_path: "%project_name%/bin/docker/build.erb"))
+                 .render
+                 .permit 0o755
+
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/docker/console.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module Docker
+      # Builds Docker console script.
+      class Console < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_docker
+
+          builder.call(settings.merge(template_path: "%project_name%/bin/docker/console.erb"))
+                 .render
+                 .permit 0o755
+
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/docker/entrypoint.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module Docker
+      # Builds Docker entrypoint script.
+      class Entrypoint < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_docker
+
+          builder.call(settings.merge(template_path: "%project_name%/bin/docker/entrypoint.erb"))
+                 .render
+                 .permit 0o755
+
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/docker/file.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module Docker
+      # Builds Dockerfile configuration.
+      class File < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_docker
+
+          builder.call(settings.merge(template_path: "%project_name%/Dockerfile.erb")).render
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/builders/docker/ignore.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "refinements/struct"
+
+module Rubysmith
+  module Builders
+    module Docker
+      # Builds Docker ignore configuration.
+      class Ignore < Abstract
+        using Refinements::Struct
+
+        def call
+          return false unless settings.build_git
+
+          builder.call(settings.merge(template_path: "%project_name%/.dockerignore.erb")).render
+          true
+        end
+      end
+    end
+  end
+end

data/lib/rubysmith/cli/actions/bootsnap.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Rubysmith
+  module CLI
+    module Actions
+      # Stores Bootsnap flag.
+      class Bootsnap < Sod::Action
+        include Import[:settings]
+
+        description "Add Bootsnap gem."
+
+        on "--[no-]bootsnap"
+
+        default { Container[:settings].build_bootsnap }
+
+        def call(boolean) = settings.build_bootsnap = boolean
+      end
+    end
+  end
+end

data/lib/rubysmith/cli/actions/circle_ci.rb

@@ -9,7 +9,7 @@ module Rubysmith
       class CircleCI < Sod::Action
         include Import[:settings]
 
-        description "Add Circle CI settings."
+        description "Add Circle CI support."
 
         on "--[no-]circle_ci"
 

data/lib/rubysmith/cli/actions/dcoo.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Rubysmith
+  module CLI
+    module Actions
+      # Stores Developer Certificate of Origin flag.
+      class DCOO < Sod::Action
+        include Import[:settings]
+
+        description "Add Developer Certificate of Origin documentation."
+
+        on "--[no-]dcoo"
+
+        default { Container[:settings].build_dcoo }
+
+        def call(boolean) = settings.build_dcoo = boolean
+      end
+    end
+  end
+end

data/lib/rubysmith/cli/actions/dev_container.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Rubysmith
+  module CLI
+    module Actions
+      # Stores Development Container flag.
+      class DevContainer < Sod::Action
+        include Import[:settings]
+
+        description "Add Development Container support."
+
+        on "--[no-]devcontainer"
+
+        default { Container[:settings].build_devcontainer }
+
+        def call(boolean) = settings.build_devcontainer = boolean
+      end
+    end
+  end
+end

data/lib/rubysmith/cli/actions/docker.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Rubysmith
+  module CLI
+    module Actions
+      # Stores Docker flag.
+      class Docker < Sod::Action
+        include Import[:settings]
+
+        description "Add Docker support."
+
+        on "--[no-]docker"
+
+        default { Container[:settings].build_docker }
+
+        def call(boolean) = settings.build_docker = boolean
+      end
+    end
+  end
+end

data/lib/rubysmith/cli/actions/funding.rb

@@ -9,7 +9,7 @@ module Rubysmith
       class Funding < Sod::Action
         include Import[:settings]
 
-        description "Add GitHub funding settings."
+        description "Add GitHub funding."
 
         on "--[no-]funding"
 

data/lib/rubysmith/cli/actions/git_hub.rb

@@ -9,7 +9,7 @@ module Rubysmith
       class GitHub < Sod::Action
         include Import[:settings]
 
-        description "Add GitHub templates."
+        description "Add GitHub code review and issue templates."
 
         on "--[no-]git_hub"
 

data/lib/rubysmith/cli/actions/git_hub_ci.rb

@@ -9,7 +9,7 @@ module Rubysmith
       class GitHubCI < Sod::Action
         include Import[:settings]
 
-        description "Add GitHub continuous integration."
+        description "Add GitHub continuous integration support."
 
         on "--[no-]git_hub_ci"
 

data/lib/rubysmith/cli/actions/maximum.rb

@@ -12,7 +12,7 @@ module Rubysmith
 
         using ::Refinements::Struct
 
-        description "Use maximum options."
+        description "Use maximum configuration."
 
         on "--max"
 

data/lib/rubysmith/cli/actions/minimum.rb

@@ -12,7 +12,7 @@ module Rubysmith
 
         using ::Refinements::Struct
 
-        description "Use minimum options."
+        description "Use minimum configuration."
 
         on "--min"
 

data/lib/rubysmith/cli/commands/build.rb

@@ -37,6 +37,14 @@ module Rubysmith
           Builders::RSpec::Context.new,
           Builders::RSpec::Helper.new,
           Builders::Caliber.new,
+          Builders::DevContainer::Dockerfile.new,
+          Builders::DevContainer::Compose.new,
+          Builders::DevContainer::Configuration.new,
+          Builders::Docker::Build.new,
+          Builders::Docker::Console.new,
+          Builders::Docker::Entrypoint.new,
+          Builders::Docker::File.new,
+          Builders::Docker::Ignore.new,
           Extensions::Bundler.new,
           Extensions::Pragmater.new,
           Extensions::Tocer.new,
@@ -50,14 +58,18 @@ module Rubysmith
 
         on Actions::Name
         on Actions::AmazingPrint
+        on Actions::Bootsnap
         on Actions::Caliber
-        on Actions::Console
-        on Actions::Contributions
         on Actions::CircleCI
         on Actions::Citation
         on Actions::Community
         on Actions::Conduct
+        on Actions::Console
+        on Actions::Contributions
+        on Actions::DCOO
         on Actions::Debug
+        on Actions::DevContainer
+        on Actions::Docker
         on Actions::Funding
         on Actions::Git
         on Actions::GitHub

data/lib/rubysmith/configuration/contract.rb

@@ -14,6 +14,7 @@ module Rubysmith
       required(:author_handle).filled :string
       required(:author_uri).filled :string
       required(:build_amazing_print).filled :bool
+      required(:build_bootsnap).filled :bool
       required(:build_caliber).filled :bool
       required(:build_circle_ci).filled :bool
       required(:build_citation).filled :bool
@@ -22,7 +23,10 @@ module Rubysmith
       required(:build_conduct).filled :bool
       required(:build_console).filled :bool
       required(:build_contributions).filled :bool
+      required(:build_dcoo).filled :bool
       required(:build_debug).filled :bool
+      required(:build_devcontainer).filled :bool
+      required(:build_docker).filled :bool
       required(:build_funding).filled :bool
       required(:build_git).filled :bool
       required(:build_git_hub).filled :bool
@@ -52,11 +56,13 @@ module Rubysmith
       required(:license_label).filled :string
       required(:license_name).filled :string
       required(:license_version).filled :string
+      optional(:organization_label).filled :string
       required(:organization_uri).filled :string
       optional(:project_name).filled :string
       optional(:project_uri_community).filled :string
       optional(:project_uri_conduct).filled :string
       optional(:project_uri_contributions).filled :string
+      optional(:project_uri_dcoo).filled :string
       optional(:project_uri_download).filled :string
       optional(:project_uri_funding).filled :string
       optional(:project_uri_home).filled :string

data/lib/rubysmith/configuration/defaults.yml

@@ -3,6 +3,7 @@ author:
   uri: "%<organization_uri>s/team/%<author_handle>s"
 build:
   amazing_print: true
+  bootsnap: false
   caliber: true
   circle_ci: false
   citation: true
@@ -11,7 +12,10 @@ build:
   conduct: true
   console: true
   contributions: true
+  dcoo: false
   debug: true
+  devcontainer: false
+  docker: false
   funding: false
   git: true
   git_hub: false
@@ -48,6 +52,7 @@ project:
     community: "%<organization_uri>s/community"
     conduct: "%<organization_uri>s/policies/code_of_conduct"
     contributions: "%<organization_uri>s/policies/contributions"
+    dcoo: "%<organization_uri>s/policies/developer_certificate_of_origin"
     download: "https://rubygems.org/gems/%<project_name>s"
     funding: "%<repository_uri>s/sponsors/%<repository_handle>s"
     home: "%<organization_uri>s/projects/%<project_name>s"

data/lib/rubysmith/configuration/model.rb

@@ -15,6 +15,7 @@ module Rubysmith
       :author_handle,
       :author_uri,
       :build_amazing_print,
+      :build_bootsnap,
       :build_caliber,
       :build_circle_ci,
       :build_citation,
@@ -23,7 +24,10 @@ module Rubysmith
       :build_conduct,
       :build_console,
       :build_contributions,
+      :build_dcoo,
       :build_debug,
+      :build_devcontainer,
+      :build_docker,
       :build_funding,
       :build_git,
       :build_git_hub,
@@ -53,11 +57,13 @@ module Rubysmith
       :license_name,
       :license_version,
       :loaded_at,
+      :organization_label,
       :organization_uri,
       :project_name,
       :project_uri_community,
       :project_uri_conduct,
       :project_uri_contributions,
+      :project_uri_dcoo,
       :project_uri_download,
       :project_uri_funding,
       :project_uri_home,
@@ -103,6 +109,8 @@ module Rubysmith
 
       def computed_project_uri_contributions = format_uri(__method__)
 
+      def computed_project_uri_dcoo = format_uri(__method__)
+
       def computed_project_uri_download = format_uri(__method__)
 
       def computed_project_uri_funding = format_uri(__method__)

data/lib/rubysmith/container.rb

@@ -25,6 +25,7 @@ module Rubysmith
                       .add_transformer(:format, :project_uri_community)
                       .add_transformer(:format, :project_uri_conduct)
                       .add_transformer(:format, :project_uri_contributions)
+                      .add_transformer(:format, :project_uri_dcoo)
                       .add_transformer(:format, :project_uri_download, :project_name)
                       .add_transformer(:format, :project_uri_funding)
                       .add_transformer(:format, :project_uri_home, :project_name)

data/lib/rubysmith/extensions/pragmater.rb

@@ -14,7 +14,20 @@ module Rubysmith
       CLIENT = ::Pragmater::Inserter.new(
         settings: ::Pragmater::Configuration::Model[
           comments: ["# frozen_string_literal: true"],
-          patterns: %w[**/*.rake **/*.rb *.gemspec exe/* bin/* config.ru *file]
+          patterns: %w[
+            **/*.rake
+            **/*.rb
+            *.gemspec
+            exe/*
+            bin/console
+            bin/rake
+            bin/rspec
+            bin/rubocop
+            bin/setup
+            config.ru
+            Gemfile
+            Rakefile
+          ]
         ]
       ).freeze
 

data/lib/rubysmith/extensions/tocer.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "refinements/pathname"
+require "stringio"
 require "tocer"
 
 module Rubysmith
@@ -11,7 +12,7 @@ module Rubysmith
 
       using Refinements::Pathname
 
-      def initialize(client: ::Tocer::Runner.new, **)
+      def initialize(client: ::Tocer::Runner.new(io: StringIO.new), **)
         @client = client
         super(**)
       end

data/lib/rubysmith/templates/%project_name%/.devcontainer/Dockerfile.erb

@@ -0,0 +1 @@
+FROM bkuhlmann/alpine-ruby:latest

data/lib/rubysmith/templates/%project_name%/.devcontainer/compose.yaml.erb

@@ -0,0 +1,35 @@
+name: "<%= settings.project_name %>"
+
+services:
+  app:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    volumes:
+      - ../..:/workspaces:cached
+    environment:
+      DATABASE_URL: postgres://postgres:postgres@postgres:5432/postgres
+    command: sleep infinity
+    depends_on:
+      - postgres
+      - redis
+
+  postgres:
+    image: postgres:latest
+    restart: unless-stopped
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_DB: postgres
+      POSTGRES_PASSWORD: postgres
+
+  redis:
+    image: redis:latest
+    restart: unless-stopped
+    volumes:
+      - redis-data:/data
+
+volumes:
+  postgres-data:
+  redis-data:

data/lib/rubysmith/templates/%project_name%/.devcontainer/devcontainer.json.erb

@@ -0,0 +1,17 @@
+{
+  "name": "<%= settings.project_name %>",
+  "dockerComposeFile": "compose.yaml",
+  "service": "app",
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+  "features": {
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+  "containerEnv": {
+    "CAPYBARA_SERVER_PORT": "45678",
+    "REDIS_URL": "redis://redis:6379/1"
+  },
+  "forwardPorts": [2300, 3000, 5432, 6379],
+<% if settings.build_setup %>
+  "postCreateCommand": "bin/setup"
+<% end %>
+}

data/lib/rubysmith/templates/%project_name%/.dockerignore.erb

@@ -0,0 +1,36 @@
+# Assets
+/node_modules/
+
+# Bin
+/bin
+!/bin/console
+!/bin/docker/entrypoint
+
+# Bundler
+/.bundle
+
+# Development
+/.devcontainer
+
+# Docker
+/.dockerignore
+/Dockerfile*
+
+# Environment
+/.env*
+
+# Git
+/.git/
+/.gitignore
+
+# GitHub
+/.github
+
+# Log
+/log/
+
+# Temp
+/tmp/
+
+# XDG
+/.config

data/lib/rubysmith/templates/%project_name%/.github/workflows/ci.yml.erb

@@ -8,6 +8,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      - name: System Update
+        run: |
+          sudo apt-get update
+          sudo apt-get install --no-install-recommends -y curl libjemalloc2
+
       - name: Checkout
         uses: actions/checkout@v4
 

data/lib/rubysmith/templates/%project_name%/Dockerfile.erb

@@ -0,0 +1,60 @@
+# syntax = docker/dockerfile:1.4
+
+ARG RUBY_VERSION=<%= RUBY_VERSION %>
+
+FROM docker.io/library/ruby:$RUBY_VERSION-slim AS base
+
+LABEL description="<%= [settings.organization_label, "Application"].compact.join " " %>"
+LABEL maintainer="<%= settings.author_name %> <<%= settings.author_email %>>"
+
+WORKDIR /app
+
+RUN <<STEPS
+  apt-get update -qq \
+  && apt-get install --no-install-recommends -y curl libjemalloc2 \
+  && rm -rf /var/lib/apt/lists /var/cache/apt/archives
+STEPS
+
+ENV RACK_ENV=production
+ENV BUNDLE_DEPLOYMENT=1
+ENV BUNDLE_PATH=/usr/local/bundle
+ENV BUNDLE_WITHOUT="development:quality:test:tools"
+
+FROM base AS build
+
+RUN <<STEPS
+  apt-get update -qq \
+  && apt-get install --no-install-recommends -y build-essential git pkg-config \
+  && rm -rf /var/lib/apt/lists /var/cache/apt/archives
+STEPS
+
+COPY .ruby-version Gemfile Gemfile.lock ./
+
+RUN <<STEPS
+  bundle install
+  rm -rf "${BUNDLE_PATH}"/ruby/*/cache "${BUNDLE_PATH}"/ruby/*/bundler/gems/*/.git
+<% if settings.build_bootsnap %>
+  bundle exec bootsnap precompile --gemfile
+<% end %>
+STEPS
+
+COPY . .
+<% if settings.build_bootsnap %>
+RUN bundle exec bootsnap precompile app/ lib/ slices/
+<% end %>
+FROM base
+COPY --from=build "${BUNDLE_PATH}" "${BUNDLE_PATH}"
+COPY --from=build /app /app
+
+RUN <<STEPS
+  mkdir -p /app/log
+  mkdir -p /app/tmp
+STEPS
+
+RUN groupadd --system --gid 1000 app && \
+    useradd app --uid 1000 --gid 1000 --create-home --shell /bin/bash && \
+    chown -R app:app log tmp
+
+USER 1000:1000
+
+ENTRYPOINT ["/app/bin/docker/entrypoint"]

data/lib/rubysmith/templates/%project_name%/Gemfile.erb

@@ -2,6 +2,9 @@ ruby file: ".ruby-version"
 
 source "https://rubygems.org"
 
+<% if settings.build_bootsnap %>
+  gem "bootsnap", "~> 1.18"
+<% end %>
 <% if settings.build_refinements %>
   gem "refinements", "~> 12.7"
 <% end %>

data/lib/rubysmith/templates/%project_name%/LICENSE-fair.adoc.erb

@@ -0,0 +1,75 @@
+= Functional Source License, Version 1.1, Apache 2.0 Future License
+
+== Abbreviation
+
+FSL-1.1-Apache-2.0
+
+== Notice
+
+Copyright <%= settings.loaded_at.strftime "%Y" %> link:<%= settings.author_uri %>[<%= settings.author_name %>]
+
+== Terms and Conditions
+
+=== Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+=== The Software
+
+The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
+
+=== License Grant
+
+Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
+
+=== Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
+
+=== Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
+
+=== Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
+
+=== Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+=== Trademarks
+
+Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
+
+== Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under the Apache License, Version 2.0 that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the Apache License, Version 2.0, in which case the following will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

data/lib/rubysmith/templates/%project_name%/LICENSE-fair.md.erb

@@ -0,0 +1,75 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright <%= settings.loaded_at.strftime "%Y" %> [<%= settings.author_name %>](<%= settings.author_uri %>)
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under the Apache License, Version 2.0 that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the Apache License, Version 2.0, in which case the following will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

data/lib/rubysmith/templates/%project_name%/README.adoc.erb

@@ -75,6 +75,10 @@ bin/rake
 == link:<%= settings.computed_project_uri_contributions %>[Contributions]
 <% end %>
 
+<% if settings.build_dcoo %>
+== link:<%= settings.computed_project_uri_dcoo %>[Developer Certificate of Origin]
+<% end %>
+
 <% if settings.build_versions %>
 == link:<%= settings.computed_project_uri_versions %>[Versions]
 <% end %>

data/lib/rubysmith/templates/%project_name%/README.md.erb

@@ -60,6 +60,10 @@ To test, run:
 ## [Contributions](<%= settings.computed_project_uri_contributions %>)
 <% end %>
 
+<% if settings.build_dcoo %>
+## [Developer Certificate of Origin](<%= settings.computed_project_uri_dcoo %>)
+<% end %>
+
 <% if settings.build_versions %>
 ## [Versions](<%= settings.computed_project_uri_versions %>)
 <% end %>

data/lib/rubysmith/templates/%project_name%/bin/docker/build.erb

@@ -0,0 +1,15 @@
+#! /usr/bin/env ruby
+
+require "bundler/setup"
+Bundler.require :tools
+
+version = Bundler.root.join(".ruby-version").read.chop
+
+system <<~COMMAND
+  docker buildx \
+         build \
+         --load \
+         --build-arg RUBY_VERSION=#{version} \
+         --tag <%= settings.project_name %>:latest \
+         #{Bundler.root}
+COMMAND

data/lib/rubysmith/templates/%project_name%/bin/docker/console.erb

@@ -0,0 +1,14 @@
+#! /usr/bin/env ruby
+
+require "bundler/setup"
+Bundler.require :tools
+
+system <<~COMMAND
+  docker run \
+         --disable-content-trust \
+         --pull never \
+         --interactive \
+         --tty \
+         --rm <%= settings.project_name %>:latest \
+         bash
+COMMAND

data/lib/rubysmith/templates/%project_name%/bin/docker/entrypoint.erb

@@ -0,0 +1,8 @@
+#! /usr/bin/env ruby
+
+$VERBOSE = true
+
+path = Dir["/usr/lib/*/libjemalloc.so.2"]
+ENV["LD_PRELOAD"] = path.first unless ENV.key?("LD_PRELOAD") && path.empty?
+
+system ARGV.join(" ")

data/lib/rubysmith.rb

@@ -6,6 +6,7 @@ Zeitwerk::Loader.new.then do |loader|
   loader.inflector.inflect "cli" => "CLI",
                            "ci" => "CI",
                            "circle_ci" => "CircleCI",
+                           "dcoo" => "DCOO",
                            "erb" => "ERB",
                            "git_hub_ci" => "GitHubCI",
                            "irb_kit" => "IRBKit",

data/rubysmith.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "rubysmith"
-  spec.version = "7.2.0"
+  spec.version = "7.3.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/rubysmith"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubysmith
 version: !ruby/object:Gem::Version
-  version: 7.2.0
+  version: 7.3.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-08-11 00:00:00.000000000 Z
+date: 2024-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cogger
@@ -282,6 +282,14 @@ files:
 - lib/rubysmith/builders/circle_ci.rb
 - lib/rubysmith/builders/console.rb
 - lib/rubysmith/builders/core.rb
+- lib/rubysmith/builders/dev_container/compose.rb
+- lib/rubysmith/builders/dev_container/configuration.rb
+- lib/rubysmith/builders/dev_container/dockerfile.rb
+- lib/rubysmith/builders/docker/build.rb
+- lib/rubysmith/builders/docker/console.rb
+- lib/rubysmith/builders/docker/entrypoint.rb
+- lib/rubysmith/builders/docker/file.rb
+- lib/rubysmith/builders/docker/ignore.rb
 - lib/rubysmith/builders/documentation/citation.rb
 - lib/rubysmith/builders/documentation/license.rb
 - lib/rubysmith/builders/documentation/readme.rb
@@ -304,6 +312,7 @@ files:
 - lib/rubysmith/builders/setup.rb
 - lib/rubysmith/builders/version.rb
 - lib/rubysmith/cli/actions/amazing_print.rb
+- lib/rubysmith/cli/actions/bootsnap.rb
 - lib/rubysmith/cli/actions/caliber.rb
 - lib/rubysmith/cli/actions/circle_ci.rb
 - lib/rubysmith/cli/actions/citation.rb
@@ -311,7 +320,10 @@ files:
 - lib/rubysmith/cli/actions/conduct.rb
 - lib/rubysmith/cli/actions/console.rb
 - lib/rubysmith/cli/actions/contributions.rb
+- lib/rubysmith/cli/actions/dcoo.rb
 - lib/rubysmith/cli/actions/debug.rb
+- lib/rubysmith/cli/actions/dev_container.rb
+- lib/rubysmith/cli/actions/docker.rb
 - lib/rubysmith/cli/actions/funding.rb
 - lib/rubysmith/cli/actions/git.rb
 - lib/rubysmith/cli/actions/git_hub.rb
@@ -354,6 +366,10 @@ files:
 - lib/rubysmith/renderers/namespace.rb
 - lib/rubysmith/templates/%project_name%/.circleci/config.yml.erb
 - lib/rubysmith/templates/%project_name%/.config/rubocop/config.yml.erb
+- lib/rubysmith/templates/%project_name%/.devcontainer/Dockerfile.erb
+- lib/rubysmith/templates/%project_name%/.devcontainer/compose.yaml.erb
+- lib/rubysmith/templates/%project_name%/.devcontainer/devcontainer.json.erb
+- lib/rubysmith/templates/%project_name%/.dockerignore.erb
 - lib/rubysmith/templates/%project_name%/.github/FUNDING.yml.erb
 - lib/rubysmith/templates/%project_name%/.github/ISSUE_TEMPLATE.md.erb
 - lib/rubysmith/templates/%project_name%/.github/PULL_REQUEST_TEMPLATE.md.erb
@@ -362,10 +378,13 @@ files:
 - lib/rubysmith/templates/%project_name%/.reek.yml.erb
 - lib/rubysmith/templates/%project_name%/.ruby-version.erb
 - lib/rubysmith/templates/%project_name%/CITATION.cff.erb
+- lib/rubysmith/templates/%project_name%/Dockerfile.erb
 - lib/rubysmith/templates/%project_name%/Gemfile.erb
 - lib/rubysmith/templates/%project_name%/Guardfile.erb
 - lib/rubysmith/templates/%project_name%/LICENSE-apache.adoc.erb
 - lib/rubysmith/templates/%project_name%/LICENSE-apache.md.erb
+- lib/rubysmith/templates/%project_name%/LICENSE-fair.adoc.erb
+- lib/rubysmith/templates/%project_name%/LICENSE-fair.md.erb
 - lib/rubysmith/templates/%project_name%/LICENSE-hippocratic.adoc.erb
 - lib/rubysmith/templates/%project_name%/LICENSE-hippocratic.md.erb
 - lib/rubysmith/templates/%project_name%/LICENSE-mit.adoc.erb
@@ -376,6 +395,9 @@ files:
 - lib/rubysmith/templates/%project_name%/VERSIONS.adoc.erb
 - lib/rubysmith/templates/%project_name%/VERSIONS.md.erb
 - lib/rubysmith/templates/%project_name%/bin/console.erb
+- lib/rubysmith/templates/%project_name%/bin/docker/build.erb
+- lib/rubysmith/templates/%project_name%/bin/docker/console.erb
+- lib/rubysmith/templates/%project_name%/bin/docker/entrypoint.erb
 - lib/rubysmith/templates/%project_name%/bin/guard.erb
 - lib/rubysmith/templates/%project_name%/bin/rake.erb
 - lib/rubysmith/templates/%project_name%/bin/rspec.erb