rubysmith 0.16.1 → 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (76) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/LICENSE.adoc +207 -155
  4. data/README.adoc +340 -94
  5. data/lib/rubysmith/builder.rb +1 -2
  6. data/lib/rubysmith/builders/bundler.rb +7 -11
  7. data/lib/rubysmith/builders/circle_ci.rb +8 -2
  8. data/lib/rubysmith/builders/console.rb +8 -2
  9. data/lib/rubysmith/builders/core.rb +7 -3
  10. data/lib/rubysmith/builders/documentation/{change.rb → citation.rb} +8 -8
  11. data/lib/rubysmith/builders/documentation/license.rb +9 -4
  12. data/lib/rubysmith/builders/documentation/readme.rb +12 -18
  13. data/lib/rubysmith/builders/documentation/{contribution.rb → version.rb} +10 -5
  14. data/lib/rubysmith/builders/git/commit.rb +3 -1
  15. data/lib/rubysmith/builders/git/setup.rb +2 -1
  16. data/lib/rubysmith/builders/git_hub.rb +8 -3
  17. data/lib/rubysmith/builders/guard.rb +9 -3
  18. data/lib/rubysmith/builders/rake.rb +8 -3
  19. data/lib/rubysmith/builders/reek.rb +7 -2
  20. data/lib/rubysmith/builders/rspec/context.rb +8 -2
  21. data/lib/rubysmith/builders/rspec/helper.rb +8 -2
  22. data/lib/rubysmith/builders/rubocop.rb +34 -0
  23. data/lib/rubysmith/builders/setup.rb +8 -2
  24. data/lib/rubysmith/cli/actions/build.rb +10 -12
  25. data/lib/rubysmith/cli/actions/config.rb +4 -2
  26. data/lib/rubysmith/cli/actions/publish.rb +21 -0
  27. data/lib/rubysmith/cli/parser.rb +31 -0
  28. data/lib/rubysmith/cli/parsers/build.rb +80 -45
  29. data/lib/rubysmith/cli/parsers/core.rb +14 -10
  30. data/lib/rubysmith/cli/shell.rb +22 -15
  31. data/lib/rubysmith/configuration/content.rb +170 -0
  32. data/lib/rubysmith/configuration/defaults.yml +88 -0
  33. data/lib/rubysmith/configuration/enhancers/current_time.rb +24 -0
  34. data/lib/rubysmith/configuration/enhancers/git_email.rb +31 -0
  35. data/lib/rubysmith/configuration/enhancers/git_hub_user.rb +31 -0
  36. data/lib/rubysmith/configuration/enhancers/git_user.rb +33 -0
  37. data/lib/rubysmith/configuration/loader.rb +48 -0
  38. data/lib/rubysmith/container.rb +1 -1
  39. data/lib/rubysmith/extensions/bundler.rb +30 -0
  40. data/lib/rubysmith/extensions/milestoner.rb +35 -0
  41. data/lib/rubysmith/extensions/pragmater.rb +35 -0
  42. data/lib/rubysmith/extensions/rubocop.rb +29 -0
  43. data/lib/rubysmith/extensions/tocer.rb +37 -0
  44. data/lib/rubysmith/identity.rb +1 -1
  45. data/lib/rubysmith/templates/%project_name%/.github/ISSUE_TEMPLATE.md.erb +1 -4
  46. data/lib/rubysmith/templates/%project_name%/.rubocop.yml.erb +2 -0
  47. data/lib/rubysmith/templates/%project_name%/CITATION.cff.erb +16 -0
  48. data/lib/rubysmith/templates/%project_name%/Gemfile.erb +12 -9
  49. data/lib/rubysmith/templates/%project_name%/LICENSE-hippocratic.adoc.erb +214 -0
  50. data/lib/rubysmith/templates/%project_name%/LICENSE-hippocratic.md.erb +214 -0
  51. data/lib/rubysmith/templates/%project_name%/README.adoc.erb +20 -21
  52. data/lib/rubysmith/templates/%project_name%/README.md.erb +20 -21
  53. data/lib/rubysmith/templates/%project_name%/VERSIONS.adoc.erb +5 -0
  54. data/lib/rubysmith/templates/%project_name%/VERSIONS.md.erb +5 -0
  55. data/lib/rubysmith/templates/%project_name%/bin/rubocop.erb +0 -1
  56. data.tar.gz.sig +0 -0
  57. metadata +54 -38
  58. metadata.gz.sig +3 -2
  59. data/lib/rubysmith/builders/documentation/conduct.rb +0 -32
  60. data/lib/rubysmith/builders/pragma.rb +0 -32
  61. data/lib/rubysmith/builders/rubocop/formatter.rb +0 -31
  62. data/lib/rubysmith/builders/rubocop/setup.rb +0 -31
  63. data/lib/rubysmith/cli/configuration/content.rb +0 -97
  64. data/lib/rubysmith/cli/configuration/defaults.yml +0 -46
  65. data/lib/rubysmith/cli/configuration/enhancers/current_time.rb +0 -26
  66. data/lib/rubysmith/cli/configuration/enhancers/git_hub_user.rb +0 -33
  67. data/lib/rubysmith/cli/configuration/enhancers/version.rb +0 -26
  68. data/lib/rubysmith/cli/configuration/loader.rb +0 -46
  69. data/lib/rubysmith/cli/parsers/assembler.rb +0 -32
  70. data/lib/rubysmith/cli/parsers.rb +0 -11
  71. data/lib/rubysmith/templates/%project_name%/CHANGES.adoc.erb +0 -5
  72. data/lib/rubysmith/templates/%project_name%/CHANGES.md.erb +0 -5
  73. data/lib/rubysmith/templates/%project_name%/CODE_OF_CONDUCT.adoc.erb +0 -114
  74. data/lib/rubysmith/templates/%project_name%/CODE_OF_CONDUCT.md.erb +0 -115
  75. data/lib/rubysmith/templates/%project_name%/CONTRIBUTING.adoc.erb +0 -22
  76. data/lib/rubysmith/templates/%project_name%/CONTRIBUTING.md.erb +0 -22
@@ -0,0 +1,24 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "refinements/structs"
4
+
5
+ module Rubysmith
6
+ module Configuration
7
+ module Enhancers
8
+ # Adds current time to content.
9
+ class CurrentTime
10
+ using Refinements::Structs
11
+
12
+ def initialize now = Time.now
13
+ @now = now
14
+ end
15
+
16
+ def call(content) = content.merge(now:)
17
+
18
+ private
19
+
20
+ attr_reader :now
21
+ end
22
+ end
23
+ end
24
+ end
@@ -0,0 +1,31 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "git_plus"
4
+ require "refinements/strings"
5
+ require "refinements/structs"
6
+
7
+ module Rubysmith
8
+ module Configuration
9
+ module Enhancers
10
+ # Dynamically adds Git email if defined.
11
+ class GitEmail
12
+ using Refinements::Strings
13
+ using Refinements::Structs
14
+
15
+ def initialize repository: GitPlus::Repository.new
16
+ @repository = repository
17
+ end
18
+
19
+ def call content
20
+ String(content.author_email).blank? ? content.merge(author_email: email) : content
21
+ end
22
+
23
+ private
24
+
25
+ attr_reader :repository
26
+
27
+ def email = repository.config_get("user.email")
28
+ end
29
+ end
30
+ end
31
+ end
@@ -0,0 +1,31 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "git_plus"
4
+ require "refinements/strings"
5
+ require "refinements/structs"
6
+
7
+ module Rubysmith
8
+ module Configuration
9
+ module Enhancers
10
+ # Dynamically adds GitHub user if user is defined.
11
+ class GitHubUser
12
+ using Refinements::Strings
13
+ using Refinements::Structs
14
+
15
+ def initialize repository: GitPlus::Repository.new
16
+ @repository = repository
17
+ end
18
+
19
+ def call content
20
+ String(content.git_hub_user).blank? ? content.merge(git_hub_user: user) : content
21
+ end
22
+
23
+ private
24
+
25
+ attr_reader :repository
26
+
27
+ def user = repository.config_get("github.user")
28
+ end
29
+ end
30
+ end
31
+ end
@@ -0,0 +1,33 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "git_plus"
4
+ require "refinements/strings"
5
+ require "refinements/structs"
6
+
7
+ module Rubysmith
8
+ module Configuration
9
+ module Enhancers
10
+ # Dynamically adds Git user if defined.
11
+ class GitUser
12
+ using Refinements::Strings
13
+ using Refinements::Structs
14
+
15
+ def initialize repository: GitPlus::Repository.new
16
+ @repository = repository
17
+ end
18
+
19
+ def call(content) = String(content.author_name).blank? ? content.merge(**user) : content
20
+
21
+ private
22
+
23
+ attr_reader :repository
24
+
25
+ def user
26
+ repository.config_get("user.name")
27
+ .then { |name| String(name).split }
28
+ .then { |first, last| {author_given_name: first, author_family_name: last} }
29
+ end
30
+ end
31
+ end
32
+ end
33
+ end
@@ -0,0 +1,48 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "pathname"
4
+ require "refinements/hashes"
5
+ require "refinements/structs"
6
+ require "runcom"
7
+ require "yaml"
8
+
9
+ module Rubysmith
10
+ module Configuration
11
+ # Represents the fully assembled Command Line Interface (CLI) configuration.
12
+ class Loader
13
+ using Refinements::Hashes
14
+ using Refinements::Structs
15
+
16
+ DEFAULTS = YAML.load_file(Pathname(__dir__).join("defaults.yml")).freeze
17
+ CLIENT = Runcom::Config.new "#{Identity::NAME}/configuration.yml", defaults: DEFAULTS
18
+
19
+ ENHANCERS = [
20
+ Enhancers::CurrentTime.new,
21
+ Enhancers::GitEmail.new,
22
+ Enhancers::GitHubUser.new,
23
+ Enhancers::GitUser.new
24
+ ].freeze
25
+
26
+ def self.call(...) = new(...).call
27
+
28
+ def self.with_defaults = new(client: DEFAULTS, enhancers: [])
29
+
30
+ def initialize content: Content.new, client: CLIENT, enhancers: ENHANCERS
31
+ @content = content
32
+ @client = client
33
+ @enhancers = enhancers
34
+ end
35
+
36
+ def call
37
+ enhancers.reduce(preload_content) { |preload, enhancer| enhancer.call preload }
38
+ .freeze
39
+ end
40
+
41
+ private
42
+
43
+ attr_reader :content, :client, :enhancers
44
+
45
+ def preload_content = content.merge(**client.to_h.flatten_keys)
46
+ end
47
+ end
48
+ end
@@ -9,7 +9,7 @@ module Rubysmith
9
9
  module Container
10
10
  extend Dry::Container::Mixin
11
11
 
12
- register(:configuration, memoize: true) { CLI::Configuration::Loader.call }
12
+ register(:configuration) { Configuration::Loader.call }
13
13
  register(:colorizer) { Pastel.new enabled: $stdout.tty? }
14
14
  register(:kernel) { Kernel }
15
15
 
@@ -0,0 +1,30 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "bundler"
4
+ require "bundler/cli"
5
+ require "refinements/pathnames"
6
+
7
+ module Rubysmith
8
+ module Extensions
9
+ # Ensures gem dependencies are installed.
10
+ class Bundler
11
+ using Refinements::Pathnames
12
+
13
+ def self.call(...) = new(...).call
14
+
15
+ def initialize configuration, client: ::Bundler::CLI
16
+ @configuration = configuration
17
+ @client = client
18
+ end
19
+
20
+ def call
21
+ configuration.project_root.change_dir { client.start %w[install --quiet] }
22
+ configuration
23
+ end
24
+
25
+ private
26
+
27
+ attr_reader :configuration, :client
28
+ end
29
+ end
30
+ end
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "milestoner"
4
+
5
+ module Rubysmith
6
+ module Extensions
7
+ # Ensures project can be published (tagged) in a reliable and consistent fashion.
8
+ class Milestoner
9
+ def self.call(...) = new(...).call
10
+
11
+ def initialize configuration,
12
+ client: ::Milestoner::Tags::Publisher.new,
13
+ content: ::Milestoner::Configuration::Content
14
+ @configuration = configuration
15
+ @client = client
16
+ @content = content
17
+ end
18
+
19
+ def call = client.call(settings) && configuration
20
+
21
+ private
22
+
23
+ attr_reader :configuration, :client, :content
24
+
25
+ def settings
26
+ content[
27
+ documentation_format: configuration.extensions_milestoner_documentation_format,
28
+ prefixes: configuration.extensions_milestoner_prefixes,
29
+ sign: configuration.extensions_milestoner_sign,
30
+ version: configuration.project_version
31
+ ]
32
+ end
33
+ end
34
+ end
35
+ end
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "pragmater"
4
+
5
+ module Rubysmith
6
+ module Extensions
7
+ # Ensures project skeleton has pragmas.
8
+ class Pragmater
9
+ def self.call(...) = new(...).call
10
+
11
+ def initialize configuration,
12
+ client: ::Pragmater::Runner.new,
13
+ content: ::Pragmater::Configuration::Content
14
+ @configuration = configuration
15
+ @client = client
16
+ @content = content
17
+ end
18
+
19
+ def call = client.call(settings) && configuration
20
+
21
+ private
22
+
23
+ attr_reader :configuration, :client, :content
24
+
25
+ def settings
26
+ content[
27
+ action_insert: true,
28
+ comments: configuration.extensions_pragmater_comments,
29
+ includes: configuration.extensions_pragmater_includes,
30
+ root_dir: configuration.project_root
31
+ ]
32
+ end
33
+ end
34
+ end
35
+ end
@@ -0,0 +1,29 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "rubocop"
4
+ require "refinements/ios"
5
+
6
+ module Rubysmith
7
+ module Extensions
8
+ # Ensures project skeleton adheres to style guide.
9
+ class Rubocop
10
+ using Refinements::IOs
11
+
12
+ def self.call(...) = new(...).call
13
+
14
+ def initialize configuration, client: ::RuboCop::CLI.new
15
+ @configuration = configuration
16
+ @client = client
17
+ end
18
+
19
+ def call
20
+ STDOUT.squelch { client.run ["--auto-correct", configuration.project_root.to_s] }
21
+ configuration
22
+ end
23
+
24
+ private
25
+
26
+ attr_reader :configuration, :client
27
+ end
28
+ end
29
+ end
@@ -0,0 +1,37 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "tocer"
4
+
5
+ module Rubysmith
6
+ module Extensions
7
+ # Ensures project skeleton documentation has table of contents.
8
+ class Tocer
9
+ def self.call(...) = new(...).call
10
+
11
+ def initialize configuration,
12
+ client: ::Tocer::Runner.new,
13
+ content: ::Tocer::Configuration::Content
14
+ @configuration = configuration
15
+ @client = client
16
+ @content = content
17
+ end
18
+
19
+ def call
20
+ client.call(settings) if configuration.build_readme
21
+ configuration
22
+ end
23
+
24
+ private
25
+
26
+ attr_reader :configuration, :client, :content
27
+
28
+ def settings
29
+ content[
30
+ includes: configuration.extensions_tocer_includes,
31
+ label: configuration.extensions_tocer_label,
32
+ root_dir: configuration.project_root
33
+ ]
34
+ end
35
+ end
36
+ end
37
+ end
@@ -4,7 +4,7 @@ module Rubysmith
4
4
  module Identity
5
5
  NAME = "rubysmith"
6
6
  LABEL = "Rubysmith"
7
- VERSION = "0.16.1"
7
+ VERSION = "1.0.0"
8
8
  VERSION_LABEL = "#{LABEL} #{VERSION}".freeze
9
9
  SUMMARY = "A command line interface for smithing Ruby projects."
10
10
  end
@@ -1,5 +1,5 @@
1
1
  ## Overview
2
- <!-- Required. Describe, briefly, the behavior experienced. -->
2
+ <!-- Required. Describe, briefly, the behavior experienced and desired. -->
3
3
 
4
4
  ## Screenshots/Screencasts
5
5
  <!-- Optional. Attach screenshot(s) and/or screencast(s) that demo the behavior. -->
@@ -7,8 +7,5 @@
7
7
  ## Steps to Recreate
8
8
  <!-- Required. List exact steps (numbered list) to reproduce errant behavior. -->
9
9
 
10
- ## Desired Behavior
11
- <!-- Required. Describe the behavior you'd like to see or your idea of a proposed solution. -->
12
-
13
10
  ## Environment
14
11
  <!-- Required. What is your operating system, software version(s), etc. -->
@@ -1,6 +1,8 @@
1
1
  inherit_from:
2
2
  - https://raw.githubusercontent.com/bkuhlmann/code_quality/main/configurations/rubocop/ruby.yml
3
+ <% if configuration.build_rake %>
3
4
  - https://raw.githubusercontent.com/bkuhlmann/code_quality/main/configurations/rubocop/rake.yml
5
+ <% end %>
4
6
  - https://raw.githubusercontent.com/bkuhlmann/code_quality/main/configurations/rubocop/performance.yml
5
7
  <% if configuration.build_rspec %>
6
8
  - https://raw.githubusercontent.com/bkuhlmann/code_quality/main/configurations/rubocop/rspec.yml
@@ -0,0 +1,16 @@
1
+ cff-version: 1.2.0
2
+ message: <%= configuration.citation_message %>
3
+ title: <%= configuration.project_label %>
4
+ abstract:
5
+ version: <%= configuration.project_version %>
6
+ license: <%= configuration.license_label_version %>
7
+ date-released: <%= configuration.now.strftime "%Y-%m-%d" %>
8
+ authors:
9
+ - family-names: <%= configuration.author_family_name %>
10
+ given-names: <%= configuration.author_given_name %>
11
+ affiliation: <%= configuration.citation_affiliation %>
12
+ orcid: https://orcid.org/<%= configuration.citation_orcid %>
13
+ keywords:
14
+ - ruby
15
+ repository-code: <%= configuration.computed_project_url_source %>
16
+ repository-artifact: <%= configuration.computed_project_url_download %>
@@ -3,7 +3,7 @@ ruby File.read(".ruby-version").strip
3
3
  source "https://rubygems.org"
4
4
 
5
5
  <% if configuration.build_refinements %>
6
- gem "refinements", "~> 8.5"
6
+ gem "refinements", "~> 9.0"
7
7
  <% end %>
8
8
  <% if configuration.build_zeitwerk %>
9
9
  gem "zeitwerk", "~> 2.5"
@@ -13,22 +13,25 @@ group :code_quality do
13
13
  <% if configuration.build_bundler_leak %>
14
14
  gem "bundler-leak", "~> 0.2"
15
15
  <% end %>
16
+ <% if configuration.build_dead_end %>
17
+ gem "dead_end", "~> 3.0"
18
+ <% end %>
16
19
  <% if configuration.build_git && configuration.build_git_lint %>
17
- gem "git-lint", "~> 2.0"
20
+ gem "git-lint", "~> 3.0"
18
21
  <% end %>
19
22
  <% if configuration.build_reek %>
20
23
  gem "reek", "~> 6.0"
21
24
  <% end %>
22
25
  <% if configuration.build_rubocop %>
23
- gem "rubocop", "~> 1.20"
24
- gem "rubocop-performance", "~> 1.11"
26
+ gem "rubocop", "~> 1.24"
27
+ gem "rubocop-performance", "~> 1.12"
25
28
  gem "rubocop-rake", "~> 0.6"
26
29
  <% end %>
27
30
  <% if configuration.build_rspec && configuration.build_rubocop %>
28
- gem "rubocop-rspec", "~> 2.4"
31
+ gem "rubocop-rspec", "~> 2.6"
29
32
  <% end %>
30
33
  <% if configuration.build_simple_cov %>
31
- gem "simplecov", "~> 0.20"
34
+ gem "simplecov", "~> 0.21"
32
35
  <% end %>
33
36
  end
34
37
 
@@ -37,7 +40,7 @@ group :development do
37
40
  gem "rake", "~> 13.0"
38
41
  <% end %>
39
42
  <% if configuration.markdown? %>
40
- gem "tocer", "~> 12.1"
43
+ gem "tocer", "~> 13.0"
41
44
  <% end %>
42
45
  end
43
46
 
@@ -52,9 +55,9 @@ end
52
55
 
53
56
  group :tools do
54
57
  <% if configuration.build_amazing_print %>
55
- gem "amazing_print", "~> 1.3"
58
+ gem "amazing_print", "~> 1.4"
56
59
  <% end %>
57
60
  <% if configuration.build_debug %>
58
- gem "debug", "~> 1.1"
61
+ gem "debug", "~> 1.4"
59
62
  <% end %>
60
63
  end