nugem 0.8.1 → 0.9.0

data/templates/common/gem_scaffold/.rubocop.yml.tt

@@ -0,0 +1,78 @@
+require:
+  <%- if @jekyll -%>
+  # - rubocop-jekyll
+  <%- end -%>
+  - rubocop-md
+  - rubocop-performance
+  <%- if @test_framework == 'minitest' -%>
+  - rubocop-minitest
+  <%- end -%>
+  - rubocop-rake
+  <%- if @test_framework == 'rspec' -%>
+  - rubocop-rspec
+  <%- end -%>
+
+AllCops:
+  Exclude:
+    - binstub/**/*
+    - exe/**/*
+    - vendor/**/*
+    - Gemfile*
+  NewCops: enable
+
+Gemspec/DeprecatedAttributeAssignment:
+  Enabled: false
+
+Gemspec/RequireMFA:
+  Enabled: false
+
+Layout/HashAlignment:
+  EnforcedColonStyle: table
+  EnforcedHashRocketStyle: table
+
+Layout/LineLength:
+  Max: 150
+
+Metrics/AbcSize:
+  Max: 35
+
+Metrics/BlockLength:
+  Exclude:
+    - <%= @gem_name %>.gemspec
+  Max: 30
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/MethodLength:
+  Max: 40
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Max: 15
+
+Naming/FileName:
+  Exclude:
+    - Rakefile
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma
+<%- if @test_framework == 'rspec' -%>
+
+RSpec/SpecFilePathFormat:
+  IgnoreMethods: true
+
+RSpec/ExampleLength:
+  Max: 30
+
+RSpec/MultipleExpectations:
+  Max: 15
+<%- end -%>

data/templates/common/gem_scaffold/.shellcheckrc

@@ -0,0 +1,5 @@
+disable=SC1091
+disable=SC2059
+disable=SC2086
+disable=SC2155
+disable=SC2181

data/templates/common/gem_scaffold/.vscode/%gem_name%.json.code-snippets.tt

@@ -0,0 +1,19 @@
+{
+	// Place your workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
+	// Placeholders with the same ids are connected.
+	// Example:
+	// "Print to console": {
+	// 	"scope": "javascript,typescript",
+	// 	"prefix": "log",
+	// 	"body": [
+	// 		"console.log('$1');",
+	// 		"$2"
+	// 	],
+	// 	"description": "Log output to console"
+	// }
+	//
+}

data/templates/common/gem_scaffold/.vscode/extensions.json

@@ -0,0 +1,22 @@
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+  // Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+
+  // List of extensions which should be recommended for users of this workspace.
+  "recommendations": [
+    "DavidAnson.vscode-markdownlint",
+    "devonray.snippet",
+    "KoichiSasada.vscode-rdbg",
+    "misogi.ruby-rubocop",
+    "redhat.vscode-yaml",
+    "shd101wyy.markdown-preview-enhanced",
+    "Shopify.ruby-lsp",
+    "timonwong.shellcheck",
+  ],
+  // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+  "unwantedRecommendations": [
+    "castwide.solargraph",
+    "rebornix.Ruby",
+    "wingrunr21.vscode-ruby",
+  ]
+}

data/templates/common/gem_scaffold/.vscode/launch.json

@@ -0,0 +1,68 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+  <%- if @jekyll -%>
+    {
+      "args": [
+        "serve",
+        "--livereload_port", "35721",
+        "--force_polling",
+        "--host", "0.0.0.0",
+        "--port", "4001",
+        "--future",
+        "--incremental",
+        "--livereload",
+        "--drafts",
+        "--unpublished"
+      ],
+      "cwd": "${workspaceRoot}/demo",
+      "debugPort": "0",
+      "name": "Debug Demo",
+      "request": "launch",
+      "script": "${workspaceRoot}/binstub/jekyll",
+      "type": "rdbg",
+    },
+    <%- end -%>
+    {
+      "args": [],
+      "debugPort": "0",
+      "name": "Debug current file with rdbg",
+      "script": "${file}",
+      "request": "launch",
+      "type": "rdbg",
+      "useBundler": true,
+    },
+    {
+      "name": "Run selected Ruby file with ruby_lsp",
+      "program": "ruby ${file}",
+      "request": "launch",
+      "type": "ruby_lsp"
+    },
+    {
+      "debugPort": "0",
+      "name": "Attach with rdbg",
+      "request": "attach",
+      "type": "rdbg",
+    },
+    {
+      "name": "Attach with ruby_lsp",
+      "request": "attach",
+      "type": "ruby_lsp",
+    },
+    {
+      "name": "RSpec - active spec file only",
+      "program": "binstub/rspec -I ${workspaceRoot} ${file}",
+      "request": "launch",
+      "type": "ruby_lsp",
+    },
+    {
+      "name": "RSpec - all",
+      "program": "${workspaceRoot}/binstub/rspec -I ${workspaceRoot}",
+      "request": "launch",
+      "type": "ruby_lsp",
+    }
+  ]
+}

data/templates/common/gem_scaffold/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "ruby.rubocop.configFilePath": ".rubocop.yml",
+  "ruby.rubocop.useBundler": true,
+  "ruby.rubocop.executePath": "./binstub/"
+}

data/templates/common/gem_scaffold/CHANGELOG.md.tt

@@ -1,2 +1,5 @@
+# Change Log
+
 ## 0.1.0
-  * Initial release.
+
+* Initial release.

data/templates/common/gem_scaffold/Gemfile.tt

@@ -3,23 +3,11 @@ source 'https://rubygems.org'
 # The <%= @gem_name %> gem dependencies are defined in <%= @gem_name %>.gemspec
 gemspec
 
-<%- if @jekyll -%>
 group :test, :development do
-  gem 'bundler', '>= 2.4.6', require: false
-  <%- if @repository.public? -%>
-  gem 'coveralls', require: false
-  <%- end -%>
-  gem 'debase', '0.2.5.beta2', require: false
+  gem 'debug', '>= 1.0.0', require: false
   gem 'gem-release', '>= 2.2.2', require: false
-  <%- if @minitest -%>
-  gem 'minitest', '>= 5.18.0', require: false
-  gem 'minitest-reporters', '>= 1.6.0', require: false
-  gem 'minitest-screenshot-reporter', '~> 0.0.6', require: false
-  <%- end -%>
   gem 'rake', require: false
-  <%- if @rspec -%>
   gem 'rspec', require: false
-  <%- end -%>
   gem 'rubocop', require: false
   gem 'rubocop-md', require: false
   <%- if @minitest -%>
@@ -27,30 +15,32 @@ group :test, :development do
   <%- end -%>
   gem 'rubocop-performance', require: false
   gem 'rubocop-rake', require: false
+  <%- if @rspec -%>
   gem 'rubocop-rspec', require: false
-  gem 'ruby-debug-ide', require: false
+  <%- end -%>
 end
-<%- end -%>
-<%- if @plugin -%>
+<%- if @rails -%>
+
 group :test, :development do
-  gem 'bundler', '>= 2.4.6', require: false
   gem 'capybara', '~> 3.39.1', require: false
   gem 'capybara_minitest_spec', '~> 1.0.7', require: false
   <%- if @repository.public? -%>
   gem 'coveralls', require: false
   <%- end -%>
   gem 'database_cleaner', '~> 2.0.2', require: false
-  gem 'gem-release', '>= 2.2.2', require: false
+  gem 'erb_lint', require: false
+  <%- if @minitest -%>
+  gem 'minitest', '>= 5.18.0', require: false
+  gem 'minitest-reporters', '>= 1.6.0', require: false
+  gem 'minitest-screenshot-reporter', '~> 0.0.6', require: false
+  <%- end -%>
   gem 'poltergeist', '~> 1.10.1', require: false
   gem 'quiet_assets'
-  gem 'rubocop', require: false
-  gem 'rubocop-md', require: false
-  gem 'rubocop-performance', require: false
-  gem 'rubocop-rake', require: false
-  <%- if @rspec -%>
-  gem 'rubocop-rspec', require: false
-  <%- end -%>
   gem 'selenium-webdriver', '~> 4.9.1', require: false
   gem 'sqlite3'
-end
+  end
 <%- end -%>
+
+group :test do
+  gem 'rspec-match_ignoring_whitespace'
+end

data/templates/common/gem_scaffold/README.md.tt

@@ -1,5 +1,3 @@
-# <%= @class_name %>
-
 <%- if @repository.public? -%>
 # `<%= gem_name.capitalize %>` [![Gem Version](https://badge.fury.io/rb/<%= gem_name %>.svg)](https://badge.fury.io/rb/<%= gem_name %>)
 <%- else -%>
@@ -12,21 +10,30 @@
 ## Installation
 
 <%- if @jekyll -%>
-Add this line to your Jekyll website's Gemfile, within the jekyll_plugins group:
+Add the following to your Jekyll website's `Gemfile`:
 
+```ruby
 group :jekyll_plugins do
   gem '<%= @gem_name %>'
 end
+```
 <%- end -%>
 <%- unless @jekyll -%>
-Add this line to your application's Gemfile:
+Either add this line to your application&rsquo;s `Gemfile`:
 
 ```ruby
 gem '<%= @gem_name %>'
 ```
+
+... or add the following to your application&rsquo;s `.gemspec`:
+
+```ruby
+spec.add_dependency '<%= @gem_name %>'
+```
 <%- end -%>
 
 And then execute:
+
 ```shell
 $ bundle
 ```
@@ -39,24 +46,57 @@ $ bundle
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies.
-Then, run `rake test` to run the tests.
-You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out this git repository, install dependencies by typing:
+
+```shell
+$ bin/setup
+```
+
+You should do the above before running Visual Studio Code.
+
+
+### Run the Tests
+
+```shell
+$ bundle exec rake test
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`.
 
-To release a new version, run `bundle exec rake release`,
-which will create a git tag for the version, push git commits and tags,
-and push the `.gem` file to <%= @repository.gem_server_url -%>.
+### Interactive Session
+
+The following will allow you to experiment:
+
+```shell
+$ bin/console
+```
+
+
+### Local Installation
+
+To install this gem onto your local machine, type:
+
+```shell
+$ bundle exec rake install
+```
+
+
+### To Release A New Version
+
+To create a git tag for the new version, push git commits and tags,
+and push the new version of the gem to <%= @repository.gem_server_url -%>, type:
+
+```shell
+$ bundle exec rake release
+```
 
 
 ## Contributing
 
-Bug reports and pull requests are welcome on <%= @repository.host %> at <%= @repository.url %>.
+Bug reports and pull requests are welcome at <%= @repository.url %>.
 
 
 <%- if @repository.public? -%>
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 <%- end -%>

data/templates/common/gem_scaffold/bin/attach

@@ -31,4 +31,5 @@ bin/build
 set -e
 
 cd "$1" > /dev/null || exit 1
-_bin/debug
+shift
+_bin/debug "$@"

data/templates/common/gem_scaffold/bin/build

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+NAME="$( basename -s .git "$( git remote get-url origin )" )"
+
+gem uninstall "$NAME" -aIx --user-install --force
+
+bundle exec rake install

data/templates/common/gem_scaffold/bin/reset

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+git checkout . # restores project
+git clean -fd  # Nukes untracked files and directories

data/templates/common/gem_scaffold/bin/setup.tt

@@ -10,15 +10,18 @@ done
 DIR=$( cd -P "$( dirname "$SOURCE" )" >/dev/null 2>&1 && pwd )
 cd "$DIR/.." || exit
 
+if [[ $(which apt) ]]; then
+  if [[ ! -f /usr/lib/x86_64-linux-gnu/libyaml.so ]]; then sudo apt install libyaml-dev; fi
+fi
+
 rm -f Gemfile.lock
-bundle
+if [[ -z "$( which bundle )" ]]; then gem install bundler; fi
+BUNDLE_WITH="development" bundle
 
-bundle binstubs debase         --force --path binstub
 <%- if @jekyll -%>
 bundle binstubs jekyll         --force --path binstub
 <%- end -%>
 bundle binstubs rspec-core     --force --path binstub
 bundle binstubs rubocop        --force --path binstub
-bundle binstubs ruby-debug-ide --force --path binstub
 
 # Do any other automated setup that you need to do here

data/templates/common/gem_scaffold/lib/%gem_name%.rb.tt

@@ -10,3 +10,5 @@ require_relative '<%= @gem_name %>/version'
 Dir[File.join(__dir__, '*.rb')].each do |file|
   require file unless file.end_with?('/<%= @gem_name %>.rb')
 end
+
+# Write the code for your gem here

data/templates/common/gem_scaffold/test/test_helper.rb.tt

@@ -3,7 +3,7 @@ require 'coveralls'
 Coveralls.wear!
 <%- end -%>
 
-<%- unless @plugin -%>
+<%- unless @rails -%>
 $LOAD_PATH.unshift File.expand_path('../lib', __dir__)
 require '<%= @gem_name %>'
 <%- end -%>
@@ -11,7 +11,7 @@ require '<%= @gem_name %>'
 require 'minitest/autorun'
 
 require 'minitest/reporters'
-<%- if @plugin -%>
+<%- if @rails -%>
 require 'minitest/reporters/screenshot_reporter'
 Minitest::Reporters.use! [Minitest::Reporters::SpecReporter.new,
                           Minitest::Reporters::JUnitReporter.new,
@@ -23,7 +23,7 @@ Minitest::Reporters.use! Minitest::Reporters::SpecReporter.new
 # Filter out Minitest backtrace while allowing backtrace from other libraries to be shown.
 Minitest.backtrace_filter = Minitest::BacktraceFilter.new
 
-<%- if @plugin -%>
+<%- if @rails -%>
 require File.expand_path('../test/dummy/config/environment.rb',  __dir__)
 ActiveRecord::Migrator.migrations_paths = [File.expand_path('../test/dummy/db/migrate', __dir__)]
 <%- if @mountable -%>

data/templates/jekyll/block_no_arg_scaffold/lib/%block_name%.rb.tt

@@ -1,5 +1,5 @@
 require 'jekyll_plugin_support'
-require_relative '<%= @gem_name %>/version.rb'
+require_relative '<%= @gem_name %>/version'
 
 module <%= @class_name %>
   PLUGIN_NAME = '<%= @block_name %>'.freeze unless defined? PLUGIN_NAME

data/templates/jekyll/block_scaffold/lib/%block_name%.rb.tt

@@ -1,8 +1,7 @@
 require 'jekyll_plugin_support'
-require_relative '<%= @gem_name %>/version.rb'
+require 'helper/jekyll_plugin_helper'
+require_relative '<%= @gem_name %>/version'
 
-# This Jekyll block tag plugin is a minimal example.
-#
 # See https://www.mslinn.com/jekyll/10200-jekyll-plugin-background.html
 # See https://www.mslinn.com/jekyll/10400-jekyll-plugin-template-collection.html
 #
@@ -16,23 +15,46 @@ require_relative '<%= @gem_name %>/version.rb'
 # You can control the log level when you start Jekyll.
 # To set the log level to :debug, write an entery into _config.yml, like this:
 # plugin_loggers:
-#   MyBlockTag: debug
+#   <%= @jekyll_class_name %>: debug
 
 module <%= @class_name %>
-  # This class implements the Jekyll block tag functionality
+  # This class implements the Jekyll <%= @tag_name %> functionality
   class <%= @jekyll_class_name %> < JekyllSupport::JekyllBlock
     PLUGIN_NAME = '<%= @block_name %>'.freeze
     VERSION = <%= @class_name %>::VERSION
 
-    # Put your plugin logic here.
+    # See https://github.com/mslinn/jekyll_plugin_support#argument-parsing
+    #
     # The following variables are predefined:
-    #   @argument_string, @block_name, @config, @envs, @helper, @layout, @logger, @mode, @page, @paginator, @site and @theme
+    #   @argument_string, @config, @envs, @helper, @layout, @logger, @mode, @page, @paginator, @site and @theme
+    #   @tag_name [String] is the name of the tag, which we already know.
+    #   @argument_string [String] the arguments from the web page.
+    #   @tokens [Liquid::ParseContext] tokenized command line
     #
-    # @return [String]
+    # @helper provides these read-only attributes:
+    #   argv, attribution, keys_values, liquid_context, logger, markup, no_arg_parsing, params, tag_name,
+    #   argv_original, excerpt_caller, keys_values_original, params_original
+    # @helper provides these class methods:
+    #   expand_env, register, remove_quotes
+    # @helper provides these instance methods:
+    #   attribution_string
+    #   default_attribution
+    #   delete_parameter
+    #   dereference_include_variable
+    #   dereference_variable
+    #   lookup_variable
+    #   parameter_specified?('option/keyword name') || 'default value' # parse option value/keyword
+    #   gem_file __FILE__ # Enables attribution
+    #   remaining_markup # unparsed markup passed to this plugin
+    #   reinitialize # Returns markup remaining after `parameter_specified?` has been invoked.
+    #   remaining_markup_original
+    #
+    # @return [string] markup to be rendered on web page
     def render_impl(content)
       <%= parse_jekyll_parameters %>
 
-      # Compute the return value of this Jekyll tag
+      # Put your plugin logic here and modify the following return value.
+
       <<~HEREDOC
         <pre class="example">
           content = '#{content}'
@@ -45,6 +67,6 @@ module <%= @class_name %>
       exit 3
     end
 
-    JekyllPluginHelper.register(self, PLUGIN_NAME)
+    ::JekyllSupport::JekyllPluginHelper.register(self, PLUGIN_NAME)
   end
 end

data/templates/jekyll/common_scaffold/spec/spec_helper.rb

@@ -30,7 +30,7 @@ class SiteMock
   attr_reader :config
 
   def initialize
-    @config = YAML.safe_load(File.read('../demo/_config.yml'))
+    @config = YAML.safe_load_file(File.read('../demo/_config.yml'))
     @config['env'] = { 'JEKYLL_ENV' => 'development' }
   end
 

data/templates/jekyll/demo/demo/Gemfile.tt

@@ -14,8 +14,9 @@ group :jekyll_plugins do
   gem 'jekyll-tagging'
 end
 
-gem 'debase', '0.2.5.beta2', require: false
-gem 'rspec-core', require: false
-gem 'rubocop', require: false
-gem 'rubocop-rspec', require: false
-gem 'ruby-debug-ide', require: false
+group :test, :development do
+  gem 'debug', '>= 1.0.0', require: false
+  gem 'rspec-core', require: false
+  gem 'rubocop', require: false
+  gem 'rubocop-rspec', require: false
+end

data/templates/jekyll/demo/demo/_bin/debug

@@ -1,12 +1,10 @@
 #!/bin/bash
 
-# shellcheck disable=SC2086,SC2155,SC2059
-
 function help {
   echo "
 $(basename $0) - Run the demo Jekyll website.
-By default the demo Jekyll website runs without restriction under ruby-debug-ide and debase,
-and listens on 0.0.0.0:1234.
+By default the demo Jekyll website runs without restriction under debug,
+and listens on 0.0.0.0.
 Options:
   -h  Show this error message
   -r  Run freely, without a debugger
@@ -38,12 +36,10 @@ while [ -L "$SOURCE" ]; do # resolve $SOURCE until the file is no longer a symli
   [[ $SOURCE != /* ]] && SOURCE=$DIR/$SOURCE # if $SOURCE was a relative symlink, we need to resolve it relative to the path where the symlink file was located
 done
 DIR=$( cd -P "$( dirname "$SOURCE" )" >/dev/null 2>&1 && pwd )
-cd "$DIR/.."
-
-# dispatcher-port and dispatcher-port are arbitrarily chosen to prevent conflicts with other instances.
+cd "$DIR/.." || exit
 
 run="serve \
-    --livereload_port 25721 \
+    --livereload-port 25721 \
     --force_polling \
     --host 0.0.0.0 \
     --port 4444 \
@@ -53,19 +49,14 @@ run="serve \
     --drafts \
     --unpublished"
 
-../bin/setup
-
+export BUNDLE_WITH=development
 rm -f Gemfile.lock
 bundle
 bundle exec ../binstub/jekyll clean # Ensure all hooks get called
 
 if [ "$RUN_FREE" ]; then
-  bundle exec ../binstub/jekyll $run
+  bundle exec jekyll $run
 else
-  bundle exec ../binstub/rdebug-ide \
-    --host 0.0.0.0 \
-    --port 1234 \
-    --dispatcher-port 26162 \
-    -- \
+  bundle exec rdbg -O --port=0 -- \
     ../binstub/jekyll $run
 fi

data/templates/jekyll/demo/demo/_layouts/default.html.tt

@@ -49,7 +49,7 @@ layout: compress
         <p class="copyright" id="copyright" xmlns:dct="http://purl.org/dc/terms/" xmlns:vcard="http://www.w3.org/2001/vcard-rdf/3.0#">
           <a rel="license" style="float: left; margin-right: 1em; padding-top: 9px; padding-bottom: 2em;"
               href="http://creativecommons.org/publicdomain/zero/1.0/">
-            <img src="http://i.creativecommons.org/p/zero/1.0/88x31.png" style="border-style: none;" alt="CC0" />
+            <img src="/assets/images/favicon.png" style="border-style: none;" alt="CC0" />
           </a>
           To the extent possible under law,
           <a rel="dct:publisher"

data/templates/jekyll/hooks_scaffold/lib/dumpers.rb

@@ -117,7 +117,7 @@ module Dumpers
   #     :unpublished
   #   attr_reader :cache_dir, :config, :dest, :filter_cache, :includes_load_paths,
   #     :liquid_renderer, :profiler, :regenerator, :source
-  def dump_site(logger, msg, site) # rubocop:disable Metrics/AbcSize
+  def dump_site(logger, msg, site)
     logger.info do
       <<~END_INFO
         #{msg} site

data/templates/jekyll/tag_no_arg_scaffold/lib/%tag_name%.rb.tt

@@ -1,5 +1,5 @@
 require 'jekyll_plugin_support'
-require_relative '<%= @gem_name %>/version.rb'
+require_relative '<%= @gem_name %>/version'
 
 module <%= @class_name %>
   class <%= @jekyll_class_name %> < JekyllTag