dopstick 0.0.1

data/Rakefile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rubocop/rake_task"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/bin/console

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "dopstick"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+begin
+  require "pry"
+  Pry.start
+rescue LoadError
+  require "irb"
+  IRB.start(__FILE__)
+end

data/bin/setup

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

data/dopstick.gemspec

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "./lib/dopstick/version"
+
+Gem::Specification.new do |spec|
+  spec.name    = "dopstick"
+  spec.version = Dopstick::VERSION
+  spec.authors = ["Nando Vieira"]
+  spec.email   = ["me@fnando.com"]
+
+  spec.summary     = "Generate a project skeleton for creating a rubygem"
+  spec.description = spec.summary
+  spec.license     = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+
+  github_url = "https://github.com/fnando/dopstick"
+  github_tree_url = "#{github_url}/blob/v#{spec.version}"
+
+  spec.homepage = github_url
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["bug_tracker_uri"] = "#{github_url}/issues"
+  spec.metadata["source_code_uri"] = github_tree_url
+  spec.metadata["changelog_uri"] = "#{github_tree_url}/CHANGELOG.md"
+  spec.metadata["documentation_uri"] = "#{github_tree_url}/README.md"
+  spec.metadata["license_uri"] = "#{github_tree_url}/LICENSE.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`
+      .split("\x0")
+      .reject {|f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) {|f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "thor"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "minitest-utils"
+  spec.add_development_dependency "pry-meta"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rubocop-fnando"
+  spec.add_development_dependency "simplecov"
+end

data/exe/dopstick

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/dopstick"
+Dopstick::CLI.start

data/lib/dopstick.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "date"
+require "pathname"
+require "thor"
+
+module Dopstick
+  require_relative "dopstick/refinements"
+  require_relative "dopstick/version"
+  require_relative "dopstick/generator"
+  require_relative "dopstick/cli"
+end

data/lib/dopstick/cli.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Dopstick
+  class CLI < Thor
+    using Dopstick::Refinements
+    check_unknown_options!
+
+    def self.exit_on_failure?
+      true
+    end
+
+    desc "new PATH", "Create a new gem"
+    option :name,
+           default: "",
+           desc: "Set the gem name. Defaults to path's basename."
+    option :active_record,
+           default: false,
+           type: :boolean,
+           desc: "Set up ActiveRecord for testing."
+    option :author_name,
+           default: "",
+           desc: "Set author name. Defaults to `git config user.name`."
+    option :author_email,
+           default: "",
+           desc: "Set author email. Defaults to `git config user.email`."
+    option :author_github,
+           default: "",
+           desc: "Set Github username. Defaults to `git config user.github`."
+    option :author_paypal,
+           default: "",
+           desc: "Set Paypal account for donations. Defaults to " \
+                 "`git config user.paypal`."
+    option :repository,
+           default: "",
+           desc: "Set Github repository name. Defaults to gem name."
+    option :description,
+           default: "",
+           desc: "Set gem description."
+    option :version,
+           default: "0.0.0",
+           desc: "Set package initial version."
+    option :bin,
+           default: "",
+           desc: "Set binary name. Also sets up Thor CLI and generator."
+    option :namespace,
+           default: "",
+           desc: "Set the codebase namespace. By default, it's inferred from " \
+                 "the gem name."
+    option :ruby_versions,
+           default: %w[2.6 2.7],
+           type: :array,
+           desc: "Set Ruby versions that are officially supported. Multiple " \
+                 "versions must separated by space."
+    def new(path)
+      options = dup_options
+      gem_name, namespace = expand_gem_name_and_namespace(path)
+
+      generator = Generator.new
+      generator.destination_root = File.expand_path(path)
+      generator.options = options.merge(
+        gem_name: gem_name,
+        namespace: namespace,
+        entry_path: namespace.underscore("/")
+      )
+
+      generator.invoke_all
+    end
+
+    no_commands do
+      private def dup_options
+        options.each_with_object({}) do |(key, value), buffer|
+          buffer[key.to_sym] = value
+        end
+      end
+
+      private def expand_gem_name_and_namespace(path) # rubocop:disable Metrics/AbcSize
+        if options[:name].presence && options[:namespace].presence
+          [options[:name], options[:namespace]]
+        elsif options[:name].presence
+          [options[:name], options[:name].camelize]
+        elsif options[:namespace].presence
+          [options[:namespace].underscore("-"), options[:namespace]]
+        else
+          [File.basename(path), File.basename(path).camelize]
+        end
+      end
+    end
+  end
+end

data/lib/dopstick/generator.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+module Dopstick
+  class Generator < Thor::Group # rubocop:disable Metrics/ClassLength
+    using Dopstick::Refinements
+
+    include Thor::Actions
+
+    def self.exit_on_failure?
+      true
+    end
+
+    attr_accessor :options
+
+    desc "Generate a new gem folder structure"
+
+    def self.source_root
+      File.join(__dir__, "templates")
+    end
+
+    def copy_gemspec
+      template "gemspec.erb", "#{gem_name}.gemspec"
+    end
+
+    def copy_license
+      template "license.erb", "LICENSE.md"
+    end
+
+    def copy_coc
+      template "coc.erb", "CODE_OF_CONDUCT.md"
+    end
+
+    def copy_readme
+      template "readme.erb", "README.md"
+    end
+
+    def copy_changelog
+      copy_file "CHANGELOG.md"
+    end
+
+    def copy_contributing
+      template "contributing.erb", "CONTRIBUTING.md"
+    end
+
+    def copy_github_templates
+      template "funding.erb", ".github/FUNDING.yml"
+      template "tests_workflow.erb", ".github/workflows/tests.yml"
+      template "bug_report.erb", ".github/ISSUE_TEMPLATE/bug_report.md"
+      template "feature_request.erb",
+               ".github/ISSUE_TEMPLATE/feature_request.md"
+      template "pull_request.erb", ".github/PULL_REQUEST_TEMPLATE.md"
+    end
+
+    def copy_rakefile
+      template "rakefile.erb", "Rakefile"
+    end
+
+    def copy_rubocop
+      template "rubocop.erb", ".rubocop.yml"
+    end
+
+    def copy_gitignore
+      template "gitignore.erb", ".gitignore"
+    end
+
+    def copy_gemfile
+      template "gemfile.erb", "Gemfile"
+    end
+
+    def copy_bins
+      template "console.erb", "bin/console"
+      template "setup.erb", "bin/setup"
+      in_root { run "chmod +x bin/*" }
+    end
+
+    def create_entry_file
+      if entry_path.include?("/")
+        template "gem_entry_file.erb", "lib/#{gem_name}.rb"
+      end
+
+      template "entry_file.erb", "lib/#{entry_path}.rb"
+    end
+
+    def create_version_file
+      template "version.erb", "lib/#{entry_path}/version.rb"
+    end
+
+    def copy_test_files
+      template "test_helper.erb", "test/test_helper.rb"
+      template "test_file.erb", "test/#{entry_path}_test.rb"
+    end
+
+    def copy_binary_files
+      return unless options[:bin].presence
+
+      template "cli.erb", "lib/#{entry_path}/cli.rb"
+      template "generator.erb", "lib/#{entry_path}/generator.rb"
+      template "bin.erb", "exe/#{options[:bin]}"
+      create_file "lib/#{entry_path}/templates/.keep"
+      in_root { run "chmod +x exe/*" }
+    end
+
+    def copy_active_record_files
+      return unless options[:active_record]
+
+      template "active_record.erb", "test/support/active_record.rb"
+    end
+
+    def initialize_repo
+      in_root do
+        run "git init --initial-branch=main", capture: true
+        run "git add .", capture: true
+        run "git add bin --force", capture: true
+      end
+    end
+
+    no_commands do # rubocop:disable Metrics/BlockLength
+      def gem_name
+        options[:gem_name]
+      end
+
+      def entry_path
+        options[:entry_path]
+      end
+
+      def user_name
+        @user_name ||= options[:author_name].presence ||
+                       `git config --global user.name`.chomp
+      end
+
+      def user_email
+        @user_email ||= options[:author_email].presence ||
+                        `git config --global user.email`.chomp
+      end
+
+      def github_user
+        @github_user ||= options[:author_github].presence || begin
+          user = `git config --global user.github`.chomp
+          user.empty? ? "[USER]" : user
+        end
+      end
+
+      def paypal_user
+        @paypal_user ||= options[:author_paypal].presence || begin
+          user = `git config --global user.paypal`.chomp
+          user.empty? ? "[USER]" : user
+        end
+      end
+
+      def github_url
+        "https://github.com/#{github_user}/#{gem_name}"
+      end
+
+      def ruby_versions
+        options[:ruby_versions]
+      end
+
+      def const_names
+        @const_names ||= options[:namespace].split("::")
+      end
+
+      def const_names_size
+        @const_names_size ||= const_names.size
+      end
+
+      def render_tree(skip_content_spaces = false, &block) # rubocop:disable Style/OptionalBooleanParameter
+        content = []
+
+        const_names.each_with_index do |name, count|
+          content << ("  " * count) + "module #{name}"
+        end
+
+        spacer = skip_content_spaces ? "" : "  "
+
+        content << (spacer * const_names_size) + block.call
+
+        (const_names_size - 1).downto(0) do |count|
+          content << "#{'  ' * count}end"
+        end
+
+        content.join("\n")
+      end
+
+      def erb(file)
+        ERB.new(File.read("#{__dir__}/templates/#{file}")).result binding
+      end
+
+      def render_cli
+        cli_class = erb("cli_class.erb")
+                    .chomp
+                    .gsub(/^(.)/m, "#{'  ' * const_names_size}\\1")
+
+        render_tree(true) { cli_class }
+      end
+
+      def render_generator
+        generator_class = erb("generator_class.erb")
+                          .chomp
+                          .gsub(/^(.)/m, "#{'  ' * const_names_size}\\1")
+
+        render_tree(true) { generator_class }
+      end
+
+      def oldest_ruby_version
+        version = options[:ruby_versions]
+                  .map {|v| Gem::Version.new(v) }
+                  .min
+                  .canonical_segments
+
+        [*version, 0].take(3).join(".")
+      end
+    end
+  end
+end

data/lib/dopstick/refinements.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Dopstick
+  module Refinements
+    refine String do
+      def presence
+        empty? ? nil : self
+      end
+
+      def camelize
+        split("-")
+          .map {|word| word.split("_").map(&:capitalize).join }
+          .join("::")
+      end
+
+      def underscore(separator = "/")
+        split("::")
+          .map {|word| word.gsub(/([A-Z]+)/m, "_\\1")[1..-1] }
+          .join(separator)
+          .downcase
+      end
+    end
+  end
+end

data/lib/dopstick/templates/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+<!--
+Prefix your message with one of the following:
+
+- [Added] for new features.
+- [Changed] for changes in existing functionality.
+- [Deprecated] for soon-to-be removed features.
+- [Removed] for now removed features.
+- [Fixed] for any bug fixes.
+- [Security] in case of vulnerabilities.
+-->
+
+## Unreleased
+
+- Initial release.