gemsmith 18.0.1 → 18.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2eccd3e61093d233577ebd160926db18ee4f1091406bd606af59997b3d34873d
-  data.tar.gz: 23b36214567a303cd12d08d3b6cf9f34d7dcc99fcc6e0387f6e52d99f4af8427
+  metadata.gz: efa40f1261ef7850d3675a9a7ce4dc529a9440767c74ea7ac51737367feb176a
+  data.tar.gz: b7d00bdacacd6031710d3c60867db5a76c23af9043916baf5c97c8b86a455fb3
 SHA512:
-  metadata.gz: fd3fd459e7834d9ba463d3b547b0ce37fade1c5aead0981c4c161003eccdcbfa9da8e9a0bd69c7a996833920230411fb01995a5c6f35c0d623bcd72e37a16610
-  data.tar.gz: 63e1d3ce286241e9b63764d4efad434217437d6de2d88ea0daedc15ef2dfcf8bf1c04be084ab413dc8e4d3ac6ef439648091bdf269a2e8e8e84e247dbcb39cca
+  metadata.gz: 4a0bb9fb6b20c9314b513a6c63b0d7e0f508ad968df59e4e50c2b31f28e1de0b25ab0e277ddc2ec3f203247394b93f930cc4cd5f347a8cd2a407d220030395e4
+  data.tar.gz: 2bab2e73aaf57e439302744e2a0099130b4da472eba6908abf78bfbb3f0ca0df34d1cd6190e8ba7c300a0d580a5ffefde31782e137426c41ec033467a9f06e6f

checksums.yaml.gz.sig

@@ -1,3 +1,2 @@
-��{:��V,‹�c��kh.���ڗ��0Úʹ���E�\�:����7ⵙ��go����������A9J���\���gX�Z�1��/�0O�8�L`ɨJ*J��#��g��~i�\�ۑ��o[U���7���D]x���
-ϗCy3͕��l�}�A��Pb��
-�%A�,�i�jA���"<�H�%��
+�:��͏L���^ڦlFi�5Ca�k�P�AS�gΝU�ǎN3�S��qB/s�9���QR]?�$Ӻ��gq��D��ޅ��'�b)�d0^����A���; ��2�����/�����"� ���ͱ��P��ﵝ�O
���{h	�i���<_k��2Oc�t��UuL�Юfpg(M��7��
+5r��hG0��C�>U���j�f�̵���F�"�0�+ǖ�ؔɋ��ۧ���+���r

data/README.adoc

@@ -25,15 +25,6 @@ toc::[]
 . link:https://www.ruby-lang.org[Ruby].
 . link:https://rubygems.org[RubyGems].
 
-== Setup
-
-To install, run:
-
-[source,bash]
-----
-gem install gemsmith
-----
-
 == Upgrade
 
 If upgrading from 17.0.0 to 18.0.0, you'll want to be aware of the following changes:
@@ -43,6 +34,15 @@ If upgrading from 17.0.0 to 18.0.0, you'll want to be aware of the following cha
   ability to sign tags has been removed (this happens dynamically based on your Git configuration
   which gives you more flexibility).
 
+== Setup
+
+To install, run:
+
+[source,bash]
+----
+gem install gemsmith
+----
+
 == Usage
 
 === Command Line Interface (CLI)
@@ -71,6 +71,7 @@ BUILD OPTIONS:
       --[no-]console                       Add console script. Default: true.
       --[no-]contributions                 Add contributions documentation. Default: true.
       --[no-]debug                         Add Debug gem. Default: true.
+      --[no-]funding                       Add GitHub funding configuration. Default: false.
       --[no-]git                           Add Git. Default: true.
       --[no-]git_hub                       Add GitHub templates. Default: false.
       --[no-]git-lint                      Add Git Lint gem. Default: true.
@@ -221,6 +222,20 @@ the following:
 Feel free to take the combined Rubysmith + Gemsmith configuration, modify, and save as your own
 custom `configuration.yml`.
 
+It is recommended that you provide URLs for your project which would be all keys found in this
+section:
+
+[source,yaml]
+----
+:project:
+  :url:
+    # Add sub-key values here.
+----
+
+When these values exist, you'll benefit from having this information added to your generated
+`gemspec` and project documentation. Otherwise -- if these values are empty -- they are removed from
+new gem generation.
+
 === Workflows
 
 When building/testing your gem locally, a typical workflow is:
@@ -290,8 +305,8 @@ gem cert --build you@example.com
 chmod 600 gem-*.pem
 ----
 
-The resulting `*.pem` key files can be referenced via the `signing_key` and `cert_chain` of your
-`*.gemspec` which Gemsmith provides for you via the `--security` build option. Example:
+The resulting `.pem` key files can be referenced via the `signing_key` and `cert_chain` of your
+`.gemspec` which Gemsmith provides for you via the `--security` build option. Example:
 
 [source,ruby]
 ----
@@ -332,7 +347,7 @@ Gem::Specification.new do |spec|
 end
 ----
 
-💡 The gemspec metadata _must_ be strings per the
+💡 The gemspec metadata (i.e. keys and values) _must_ be strings per the
 link:https://guides.rubygems.org/specification-reference/#metadata[RubyGems Specification].
 
 Use of the `allowed_push_host` key provides two important capabilities:
@@ -360,8 +375,8 @@ https://private.example.com: Basic dXNlcjpwYXNzd29yZA==
 
 Notice how the first line contains credentials for the public RubyGems server while the second line
 is for our private example server. You'll also notice that the key is not a symbol but a URL string
-to our private server. This is important as this is how we link our gem specification metadata to
-our private credentials. To illustrate further, here are both files truncated and shown together:
+to our private server. This is important because this is how we link our gem specification metadata
+to our private credentials. To illustrate further, here are both files truncated and shown together:
 
 ....
 # Gem specification metadata which defines the private host to publish to.
@@ -371,8 +386,8 @@ spec.metadata = {"allowed_push_host" => "https://private.example.com"}
 https://private.example.com: Basic dXNlcjpwYXNzd29yZA==
 ....
 
-When the above are linked together like this, you enable Gemsmith to publish your gem using only the
-following command:
+When the above are linked together, you enable Gemsmith to publish your gem using only the following
+command:
 
 [source,bash]
 ----
@@ -380,8 +395,9 @@ gemsmith --publish
 ----
 
 This is especially powerful when publishing to
-link:https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry[GitHub's
-Packages registory] which would look like this when properly configured (truncated for brevity):
+link:https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-rubygems-registry[GitHub
+Packages] which would look like this when properly configured (truncated for brevity while using
+fake data):
 
 ....
 # Gem specification
@@ -395,6 +411,62 @@ Lastly, should you need to delete a credential (due to a bad login/password for
 open the `$HOME/.gem/credentials` in your default editor and remove the line(s) you don't need. Upon
 next publish of your gem, you'll be prompted for the missing credentials.
 
+=== GitHub Actions/Packages Automation
+
+Earlier, I hinted at using GitHub Packages but what if you could automate the entire publishing
+process? Well, good news, you can by using GitHub Actions to publish your packages. Here's the YAML
+necessary to accomplish this endeavor:
+
+``` yaml
+name: Gemsmith
+
+on:
+  push:
+    branches: main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    container:
+      image: ruby:latest
+    permissions:
+      contents: write
+      packages: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: '0'
+          ref: ${{github.head_ref}}
+      - name: Setup
+        run: |
+          git config user.email "engineering@example.com"
+          git config user.name "Gemsmith Publisher"
+          mkdir -p $HOME/.gem
+          printf "%s\n" "https://rubygems.pkg.github.com/example: Bearer ${{secrets.GITHUB_TOKEN}}" > $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+      - name: Install
+        run: gem install gemsmith
+      - name: Publish
+        run: |
+          if git describe --tags --abbrev=0 > /dev/null 2>&1; then
+            gemsmith --publish
+          else
+            printf "%s\n" "First gem version must be manually created. Skipping."
+          fi
+```
+
+The above will ensure the following:
+
+* Only the first version requires manual publishing (hence the check for existing Git tags).
+* Duplicate versions are always skipped.
+* Only when a new version is detected (by changing your gemspec version) and you are on the `main`
+  branch will a new version be automatically published.
+
+This entire workflow is explained in my
+link:https://www.alchemists.io/talks/ruby_git_hub_packages[talk] on this exact subject too.
+
 == Promotion
 
 Once your gem is released, let the world know about your accomplishment by posting an update to
@@ -402,7 +474,6 @@ these sites:
 
 * link:https://rubyflow.com[RubyFlow]
 * link:https://ruby.libhunt.com[Ruby Library Hunt]
-* link:https://rubydaily.org[RubyDaily]
 * link:https://awesome-ruby.com[Awesome Ruby]
 * link:https://www.ruby-toolbox.com[Ruby Toolbox]
 * link:https://www.ruby-lang.org/en/community[Ruby Community]

data/gemsmith.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "gemsmith"
-  spec.version = "18.0.1"
+  spec.version = "18.1.1"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://www.alchemists.io/projects/gemsmith"
@@ -13,6 +13,7 @@ Gem::Specification.new do |spec|
     "bug_tracker_uri" => "https://github.com/bkuhlmann/gemsmith/issues",
     "changelog_uri" => "https://www.alchemists.io/projects/gemsmith/versions",
     "documentation_uri" => "https://www.alchemists.io/projects/gemsmith",
+    "funding_uri" => "https://github.com/sponsors/bkuhlmann",
     "label" => "Gemsmith",
     "rubygems_mfa_required" => "true",
     "source_code_uri" => "https://github.com/bkuhlmann/gemsmith"
@@ -28,7 +29,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "dry-monads", "~> 1.4"
   spec.add_dependency "milestoner", "~> 14.0"
   spec.add_dependency "refinements", "~> 9.2"
-  spec.add_dependency "rubysmith", "~> 3.0"
+  spec.add_dependency "rubysmith", "~> 3.1"
   spec.add_dependency "runcom", "~> 8.2"
   spec.add_dependency "spek", "~> 0.2"
   spec.add_dependency "versionaire", "~> 10.0"

data/lib/gemsmith/builders/specification.rb

@@ -20,6 +20,8 @@ module Gemsmith
 
         builder.call(config)
                .render
+               .replace("    \n", "")
+               .replace("      ", "    ")
                .replace("  \n", "")
                .replace("    spec", "  spec")
                .replace(/\}\s+s/m, "}\n\n  s")

data/lib/gemsmith/templates/%project_name%/%project_name%.gemspec.erb

@@ -8,12 +8,25 @@ Gem::Specification.new do |spec|
   spec.license = "<%= configuration.license_label_version %>"
 
   spec.metadata = {
-    "bug_tracker_uri" => "<%= configuration.computed_project_url_issues %>",
-    "changelog_uri" => "<%= configuration.computed_project_url_versions %>",
-    "documentation_uri" => "<%= configuration.computed_project_url_home %>",
+    <% unless configuration.computed_project_url_issues.empty? %>
+      "bug_tracker_uri" => "<%= configuration.computed_project_url_issues %>",
+    <% end %>
+    <% unless configuration.computed_project_url_versions.empty? %>
+      "changelog_uri" => "<%= configuration.computed_project_url_versions %>",
+    <% end %>
+    <% unless configuration.computed_project_url_home.empty? %>
+      "documentation_uri" => "<%= configuration.computed_project_url_home %>",
+    <% end %>
+    <% unless configuration.computed_project_url_funding.empty? %>
+      "funding_uri" => "<%= configuration.computed_project_url_funding %>",
+    <% end %>
     "label" => "<%= configuration.project_label %>",
-    "rubygems_mfa_required" => "true",
-    "source_code_uri" => "<%= configuration.computed_project_url_source %>"
+    <% if configuration.computed_project_url_source.empty? %>
+      "rubygems_mfa_required" => "true"
+    <% else %>
+      "rubygems_mfa_required" => "true",
+      "source_code_uri" => "<%= configuration.computed_project_url_source %>"
+    <% end %>
   }
 
   <% if configuration.build_security %>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gemsmith
 version: !ruby/object:Gem::Version
-  version: 18.0.1
+  version: 18.1.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-04-15 00:00:00.000000000 Z
+date: 2022-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: auto_injector
@@ -120,14 +120,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: runcom
   requirement: !ruby/object:Gem::Requirement
@@ -261,6 +261,7 @@ metadata:
   bug_tracker_uri: https://github.com/bkuhlmann/gemsmith/issues
   changelog_uri: https://www.alchemists.io/projects/gemsmith/versions
   documentation_uri: https://www.alchemists.io/projects/gemsmith
+  funding_uri: https://github.com/sponsors/bkuhlmann
   label: Gemsmith
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/bkuhlmann/gemsmith
@@ -279,7 +280,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.11
+rubygems_version: 3.3.12
 signing_key:
 specification_version: 4
 summary: A command line interface for smithing Ruby gems.