kettle-dev 1.2.4 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/CHANGELOG.md +232 -3
  4. data/CITATION.cff +6 -6
  5. data/CONTRIBUTING.md +64 -46
  6. data/FUNDING.md +1 -1
  7. data/LICENSE.md +12 -0
  8. data/README.md +448 -457
  9. data/certs/pboling.pem +27 -0
  10. data/exe/kettle-changelog +24 -13
  11. data/exe/kettle-check-eof +7 -0
  12. data/exe/kettle-check-eof.sh +118 -0
  13. data/exe/kettle-dev-setup +12 -63
  14. data/exe/kettle-gh-release +82 -0
  15. data/lib/kettle/dev/changelog_cli.rb +373 -62
  16. data/lib/kettle/dev/ci_monitor.rb +2 -2
  17. data/lib/kettle/dev/dvcs_cli.rb +1 -1
  18. data/lib/kettle/dev/gem_spec_reader.rb +100 -10
  19. data/lib/kettle/dev/git_adapter.rb +37 -1
  20. data/lib/kettle/dev/open_collective_config.rb +15 -3
  21. data/lib/kettle/dev/pre_release_cli.rb +4 -4
  22. data/lib/kettle/dev/rakelib/reek.rake +9 -6
  23. data/lib/kettle/dev/rakelib/spec_test.rake +25 -25
  24. data/lib/kettle/dev/rakelib/yard.rake +17 -17
  25. data/lib/kettle/dev/readme_backers.rb +4 -4
  26. data/lib/kettle/dev/release_cli.rb +27 -24
  27. data/lib/kettle/dev/tasks/ci_task.rb +4 -4
  28. data/lib/kettle/dev/version.rb +2 -87
  29. data/lib/kettle/dev.rb +31 -17
  30. data/sig/kettle/dev/source_merger.rbs +40 -56
  31. data/sig/kettle/dev/version.rbs +8 -0
  32. data.tar.gz.sig +0 -0
  33. metadata +63 -165
  34. metadata.gz.sig +0 -0
  35. data/.aiignore.example +0 -19
  36. data/.devcontainer/apt-install/devcontainer-feature.json +0 -9
  37. data/.devcontainer/apt-install/install.sh +0 -11
  38. data/.devcontainer/devcontainer.json +0 -28
  39. data/.env.local.example +0 -31
  40. data/.envrc +0 -47
  41. data/.envrc.example +0 -51
  42. data/.envrc.no-osc.example +0 -51
  43. data/.git-hooks/commit-msg +0 -54
  44. data/.git-hooks/commit-subjects-goalie.txt +0 -8
  45. data/.git-hooks/footer-template.erb.txt +0 -16
  46. data/.git-hooks/prepare-commit-msg +0 -8
  47. data/.github/.codecov.yml.example +0 -14
  48. data/.github/FUNDING.yml +0 -13
  49. data/.github/FUNDING.yml.no-osc.example +0 -13
  50. data/.github/dependabot.yml +0 -13
  51. data/.github/workflows/ancient.yml +0 -83
  52. data/.github/workflows/ancient.yml.example +0 -81
  53. data/.github/workflows/auto-assign.yml +0 -21
  54. data/.github/workflows/codeql-analysis.yml +0 -70
  55. data/.github/workflows/coverage.yml +0 -127
  56. data/.github/workflows/coverage.yml.example +0 -127
  57. data/.github/workflows/current.yml +0 -116
  58. data/.github/workflows/current.yml.example +0 -115
  59. data/.github/workflows/dep-heads.yml +0 -117
  60. data/.github/workflows/dependency-review.yml +0 -20
  61. data/.github/workflows/discord-notifier.yml.example +0 -39
  62. data/.github/workflows/heads.yml +0 -117
  63. data/.github/workflows/heads.yml.example +0 -116
  64. data/.github/workflows/jruby.yml +0 -82
  65. data/.github/workflows/jruby.yml.example +0 -72
  66. data/.github/workflows/legacy.yml +0 -76
  67. data/.github/workflows/license-eye.yml +0 -40
  68. data/.github/workflows/locked_deps.yml +0 -85
  69. data/.github/workflows/opencollective.yml +0 -40
  70. data/.github/workflows/style.yml +0 -67
  71. data/.github/workflows/supported.yml +0 -75
  72. data/.github/workflows/truffle.yml +0 -99
  73. data/.github/workflows/unlocked_deps.yml +0 -84
  74. data/.github/workflows/unsupported.yml +0 -76
  75. data/.gitignore +0 -50
  76. data/.gitlab-ci.yml.example +0 -134
  77. data/.idea/.gitignore +0 -45
  78. data/.junie/guidelines-rbs.md +0 -49
  79. data/.junie/guidelines.md +0 -141
  80. data/.junie/guidelines.md.example +0 -140
  81. data/.licenserc.yaml +0 -7
  82. data/.opencollective.yml +0 -3
  83. data/.opencollective.yml.example +0 -3
  84. data/.qlty/qlty.toml +0 -79
  85. data/.rspec +0 -9
  86. data/.rubocop.yml +0 -13
  87. data/.rubocop_rspec.yml +0 -33
  88. data/.simplecov +0 -16
  89. data/.simplecov.example +0 -11
  90. data/.tool-versions +0 -1
  91. data/.yardignore +0 -13
  92. data/.yardopts +0 -14
  93. data/Appraisal.root.gemfile +0 -10
  94. data/Appraisals +0 -151
  95. data/Appraisals.example +0 -102
  96. data/CHANGELOG.md.example +0 -47
  97. data/CONTRIBUTING.md.example +0 -227
  98. data/FUNDING.md.no-osc.example +0 -63
  99. data/Gemfile +0 -40
  100. data/Gemfile.example +0 -34
  101. data/LICENSE.txt +0 -21
  102. data/README.md.example +0 -570
  103. data/README.md.no-osc.example +0 -536
  104. data/REEK +0 -0
  105. data/Rakefile.example +0 -68
  106. data/bin/setup +0 -8
  107. data/gemfiles/modular/coverage.gemfile +0 -6
  108. data/gemfiles/modular/debug.gemfile +0 -13
  109. data/gemfiles/modular/documentation.gemfile +0 -14
  110. data/gemfiles/modular/erb/r2/v3.0.gemfile +0 -1
  111. data/gemfiles/modular/erb/r2.3/default.gemfile +0 -6
  112. data/gemfiles/modular/erb/r2.6/v2.2.gemfile +0 -3
  113. data/gemfiles/modular/erb/r3/v5.0.gemfile +0 -1
  114. data/gemfiles/modular/erb/r3.1/v4.0.gemfile +0 -2
  115. data/gemfiles/modular/erb/vHEAD.gemfile +0 -2
  116. data/gemfiles/modular/injected.gemfile +0 -60
  117. data/gemfiles/modular/mutex_m/r2/v0.3.gemfile +0 -2
  118. data/gemfiles/modular/mutex_m/r2.4/v0.1.gemfile +0 -3
  119. data/gemfiles/modular/mutex_m/r3/v0.3.gemfile +0 -2
  120. data/gemfiles/modular/mutex_m/vHEAD.gemfile +0 -2
  121. data/gemfiles/modular/optional.gemfile +0 -8
  122. data/gemfiles/modular/optional.gemfile.example +0 -5
  123. data/gemfiles/modular/runtime_heads.gemfile +0 -10
  124. data/gemfiles/modular/runtime_heads.gemfile.example +0 -8
  125. data/gemfiles/modular/stringio/r2/v3.0.gemfile +0 -5
  126. data/gemfiles/modular/stringio/r2.4/v0.0.2.gemfile +0 -4
  127. data/gemfiles/modular/stringio/r3/v3.0.gemfile +0 -5
  128. data/gemfiles/modular/stringio/vHEAD.gemfile +0 -2
  129. data/gemfiles/modular/style.gemfile +0 -25
  130. data/gemfiles/modular/style.gemfile.example +0 -25
  131. data/gemfiles/modular/templating.gemfile +0 -3
  132. data/gemfiles/modular/x_std_libs/r2/libs.gemfile +0 -3
  133. data/gemfiles/modular/x_std_libs/r2.3/libs.gemfile +0 -3
  134. data/gemfiles/modular/x_std_libs/r2.4/libs.gemfile +0 -3
  135. data/gemfiles/modular/x_std_libs/r2.6/libs.gemfile +0 -3
  136. data/gemfiles/modular/x_std_libs/r3/libs.gemfile +0 -3
  137. data/gemfiles/modular/x_std_libs/r3.1/libs.gemfile +0 -3
  138. data/gemfiles/modular/x_std_libs/vHEAD.gemfile +0 -3
  139. data/gemfiles/modular/x_std_libs.gemfile +0 -2
  140. data/kettle-dev.gemspec.example +0 -154
  141. data/lib/kettle/dev/modular_gemfiles.rb +0 -119
  142. data/lib/kettle/dev/prism_appraisals.rb +0 -351
  143. data/lib/kettle/dev/prism_gemfile.rb +0 -177
  144. data/lib/kettle/dev/prism_gemspec.rb +0 -284
  145. data/lib/kettle/dev/prism_utils.rb +0 -201
  146. data/lib/kettle/dev/rakelib/install.rake +0 -10
  147. data/lib/kettle/dev/rakelib/template.rake +0 -10
  148. data/lib/kettle/dev/setup_cli.rb +0 -403
  149. data/lib/kettle/dev/source_merger.rb +0 -655
  150. data/lib/kettle/dev/tasks/install_task.rb +0 -553
  151. data/lib/kettle/dev/tasks/template_task.rb +0 -975
  152. data/lib/kettle/dev/template_helpers.rb +0 -685
@@ -1,140 +0,0 @@
1
- Project: kettle-dev — Development Guidelines (for advanced contributors)
2
-
3
- This document captures project-specific knowledge to streamline setup, testing, and ongoing development.
4
-
5
- 1. Build and configuration
6
- - ENV is controlled by `direnv`.
7
- - Two files are loaded:
8
- - .envrc — environment variables for local development, committed to source control
9
- - .env.local — environment variables that are not committed to source control. These setting override .envrc.
10
- - Run `direnv allow` after making changes to .envrc or .env.local.
11
- - See .envrc for details.
12
- - See .env.local.example for an example of what to put in .env.local.
13
- - See CONTRIBUTING.md for details on how to set up your local environment.
14
- - Ruby and Bundler
15
- - Runtime supports Ruby >= {K_D_MIN_RUBY}
16
- - Development tooling targets Ruby >= {K_D_MIN_DEV_RUBY} (minimum supported by setup-ruby GHA).
17
- - Use a recent Ruby (>= 3.4 recommended) for fastest setup and to exercise modern coverage behavior.
18
- - Install dependencies via Bundler in project root:
19
- - bundle install
20
- - Rake tasks (preferred entry points)
21
- - The Rakefile wires common workflows. Useful targets:
22
- - rake spec — run RSpec suite (also aliased via rake test)
23
- - rake coverage — run specs with coverage locally and open a report (requires kettle-soup-cover)
24
- - rake rubocop_gradual:autocorrect — RuboCop-LTS Gradual, with autocorrect as default task
25
- - rake reek and rake reek:update — code smell checks and persisted snapshots in REEK
26
- - rake yard — generate YARD docs for lib and selected extra files
27
- - rake bundle:audit and rake bundle:audit:update — dependency vulnerability checks
28
- - rake build / rake release — gem build/release helper tasks (Bundler + stone_checksums)
29
- - The default rake target runs a curated set of tasks; this varies for CI vs local (see CI env var logic in Rakefile).
30
- - Always run the default rake task prior commits, and after making changes to lib/ code, or *.md files, to allow the linter to autocorrect, and to generate updated documentation.
31
- - Coverage orchestration
32
- - Coverage is controlled by kettle-soup-cover and .simplecov. Thresholds (line and branch) are enforced and can fail the process.
33
- - Thresholds are primarily controlled by environment variables (see .simplecov and comments therein) typically loaded via direnv (.envrc) and CI workflow (.github/workflows/coverage.yml). When running only a test subset, thresholds may fail; see Testing below.
34
- - Gem signing (for releases)
35
- - Signing is enabled unless SKIP_GEM_SIGNING is set. If enabled and certificates are present (certs/<USER>.pem), gem build will attempt to sign using ~/.ssh/gem-private_key.pem.
36
- - See CONTRIBUTING.md for releasing details; use SKIP_GEM_SIGNING when building in environments without the private key.
37
- - Important for local testing (to avoid hanging prompts): ALWAYS skip signing when building locally to test the packaging or install process. Without the private key password, the build will wait indefinitely at a signing prompt.
38
- - One-off commands (recommended):
39
- - SKIP_GEM_SIGNING=true gem build kettle-dev.gemspec
40
- - SKIP_GEM_SIGNING=true bundle exec rake build
41
- - SKIP_GEM_SIGNING=true bundle exec rake release # only to test workflow; do not actually push
42
- - direnv option (optional, not recommended globally): add `export SKIP_GEM_SIGNING=true` to your .env.local when you know you won’t be signing in this environment.
43
- - Remove or unset SKIP_GEM_SIGNING when performing a real, signed release in the environment that has the private key.
44
-
45
- 2. Testing
46
- - Framework and helpers
47
- - RSpec 3.13 with custom spec/spec_helper.rb configuration:
48
- - silent_stream: STDOUT is silenced by default for examples to keep logs clean.
49
- - To explicitly test console output, tag the example or group with :check_output.
50
- - DEBUG toggle: Set DEBUG=true to require 'debug' and avoid silencing output during your run.
51
- - Coverage: kettle-soup-cover integrates SimpleCov; .simplecov is invoked from spec_helper when enabled by Kettle::Soup::Cover::DO_COV, which is controlled by K_SOUP_COV_DO being set to true / false.
52
- - RSpec.describe usage:
53
- - Use `describe "#<method_name>"` to contain a block of specs that test instance method behavior.
54
- - Use `describe "::<method_name>"` to contain a block of specs that test class method behavior.
55
- - Do not use `describe ".<method_name>"` because the dot is ambiguous w.r.t instance vs. class methods.
56
- - When adding new code or modifying existing code always add tests to cover the updated behavior, including branches, and different types of expected and unexpected inputs.
57
- - Additional test utilities:
58
- - rspec-stubbed_env: Use stub_env to control ENV safely within examples.
59
- - timecop-rspec: Time manipulation is available, and is setup by kettle-test.
60
- - To freeze time use `freeze: Time.new(*args)` tag on an example or group
61
- - Running tests (verified)
62
- - Full suite (recommended to satisfy coverage thresholds):
63
- - bin/rspec
64
- - or: bundle exec rspec
65
- - or: bundle exec rake spec
66
- - Progress format (less verbose):
67
- - bundle exec rspec --format progress
68
- - Focused runs
69
- - You can run a single file or example, but note: coverage thresholds need to be disabled with K_SOUP_COV_MIN_HARD=false
70
- - Example: K_SOUP_COV_MIN_HARD=false bin/rspec spec/kettle-dev/class_spec.rb:42
71
- - Output visibility
72
- - To see STDOUT from the code under test, use the :check_output tag on the example or group.
73
- Example:
74
- RSpec.describe "with output", :check_output do
75
- it "has output" do
76
- output = capture(:stderr) {kernel.warn("This is a warning")}
77
- logs = [ "This is a warning\n" ]
78
- expect(output).to(include(*logs))
79
- end
80
- end
81
- - Alternatively, run with DEBUG=true to disable silencing for the entire run.
82
- - During a spec run, the presence of output about missing activation keys is often expected, since it is literally what this library is for. It only indicates a failure if the spec expected all activation keys to be present, and not all specs do.
83
- - Adding new tests (guidelines)
84
- - Organize specs by class/module. Do not create per-task umbrella spec files; add examples to the existing spec for the class/module under test, or create a new spec file for that class/module if one does not exist. Only create a standalone scenario spec when it intentionally spans multiple classes for an integration/benchmark scenario (e.g., bench_integration_spec), and name it accordingly.
85
- - Spec file names must map to a real class or module under lib/ (mirror the path). Do not introduce specs for non-existent classes or ad-hoc names (e.g., avoid template_helpers_replacements_spec.rb when testing Kettle::Dev::TemplateHelpers; add those examples to template_helpers_spec.rb).
86
- - REQUIRED: Provide unit tests for every class, module, constant, and public method. Place them in spec/ mirroring the path under lib/. When a file under lib/ is added or changed, ensure a corresponding spec file exists/updated for it.
87
- - Add tests for all public methods and add contexts for variations of their arguments, and arity.
88
- - This repository targets near-100% coverage of its public API; when you add new public methods, rake tasks to a rakelib, or config behavior, add or update specs accordingly.
89
- - Place new specs under spec/ mirroring lib/ structure where possible. Do not require "spec_helper" at the top of spec files, as it is automatically loaded by .rspec.
90
- - If your code relies on environment variables that drive activation (see "Activation env vars" below), prefer using rspec-stubbed_env:
91
- - it does not support stubbing with blocks, but it does automatically clean up after itself.
92
- - the below config is included in all spec scenarios by the kettle-test gem, so no need to do it again; it is here for reference:
93
- include_context 'with stubbed env'
94
- - in a before hook, or in an example:
95
- stub_env("FLOSS_FUNDING_MY_NS" => "Free-as-in-beer")
96
- # example code continues
97
- - If your spec needs to assert on console output, tag it with :check_output. By default, STDOUT is silenced.
98
- - Use Timecop for deterministic time-sensitive behavior as needed (require config/timecop is already done by spec_helper).
99
-
100
- - Types and documentation
101
- - REQUIRED: All public APIs must have RBS type signatures checked into sig/ under the corresponding path. When you add a new public method or change a signature, update the matching .rbs file.
102
- - REQUIRED: All public methods must include inline YARD docs with @param/@return (and @yield/@option where applicable). Generate docs with `bundle exec rake yard` to verify formatting.
103
-
104
- 3. Additional development information
105
- - Code style and static analysis
106
- - RuboCop-LTS (Gradual) is integrated. Use:
107
- - bundle exec rake rubocop_gradual:autocorrect
108
- - bundle exec rake rubocop_gradual:force_update # only run if there are still linting violations the default rake task, which includes autocorrect locally, or a standalone autocorrect task, has run, and failed, and the violations won't be fixed
109
- - Reek is configured to scan {lib,spec,tests}/**/*.rb. Use:
110
- - bundle exec rake reek
111
- - bundle exec rake reek:update # writes current output to REEK, fails on smells
112
- - Keep REEK file updated with intentional smells snapshot when appropriate (e.g., after refactors).
113
- - Locally, the default rake task includes reek:update.
114
- - Documentation
115
- - Generate YARD docs with: bundle exec rake yard. It includes lib/**/*.rb and extra docs like README.md, CHANGELOG.md, RUBOCOP.md, REEK, etc.
116
- - Appraisal and multi-gemfile testing
117
- - appraisal2 is present to manage multiple dependency sets; see Appraisals and gemfiles/modular/*.gemfile. If you need to verify against alternate dependency versions, use Appraisal to install and run rspec under those Gemfiles.
118
- - You can run a single github workflow by running `act -W /github/workflows/<workflow name>.yml`
119
- - CI/local differences and defaults
120
- - The Rakefile adjusts default tasks based on CI env var. Locally, rake default may include coverage, reek:update, yard, etc. On CI, it tends to just run spec.
121
-
122
- Quick start
123
- 1) bundle install
124
- 2) K_SOUP_COV_FORMATTERS="json" bin/rspec (generates a JSON coverage report with both line and branch data in coverage/. Use this single format.)
125
- 3) Static analysis: bundle exec rake rubocop_gradual:check && bundle exec rake reek
126
-
127
- Notes
128
- - ALWAYS Run bundle exec rake rubocop_gradual:autocorrect as the final step before completing a task, to lint and autocorrect any remaining issues. Then if there are new lint failures, attempt to correct them manually.
129
- - NEVER run vanilla rubocop, as it won't handle the linting config properly. Always run rubocop_gradual:autocorrect or rubocop_gradual.
130
- - Running only a subset of specs is supported but in order to bypass the hard failure due to coverage thresholds, you need to run with K_SOUP_COV_MIN_HARD=false.
131
- - When adding code that writes to STDOUT, remember most specs silence output unless tagged with :check_output or DEBUG=true.
132
- - Completion criteria after changes: Only consider your change “done” when the relevant examples pass, as verified by .rspec_status. Do not rely on STDOUT impressions; consult .rspec_status (and example IDs) to confirm green results for the affected files/examples. If you ran a subset, re-run the full suite before finalizing to restore coverage thresholds.
133
- - Coverage reports: NEVER review the HTML report. Use JSON (preferred), XML, LCOV, or RCOV. For this project, always run tests with K_SOUP_COV_FORMATTERS set to "json".
134
- - Do NOT modify .envrc in tasks; when running tests locally or in scripts, manually prefix each run, e.g.: K_SOUP_COV_FORMATTERS="json" bin/rspec
135
- - For all the kettle-soup-cover options, see .envrc and find the K_SOUP_COV_* env vars.
136
- - NEVER modify ENV variables in tests directly. Always use the stub_env macro from the rspec-stubbed_env gem (more details in the testing section above).
137
-
138
- Important documentation rules
139
- - Do NOT edit files under docs/ manually; they are generated by `bundle exec rake yard` as part of the default rake task.
140
- - Clarification: Executable scripts provided by this gem (exe/* and installed binstubs) work when the gem is installed as a system gem (gem install kettle-dev). However, the Rake tasks provided by this gem require kettle-dev to be declared as a development dependency in the host project's Gemfile and loaded in the project's Rakefile.
data/.licenserc.yaml DELETED
@@ -1,7 +0,0 @@
1
- header:
2
- license:
3
- spdx-id: MIT
4
-
5
- dependency:
6
- files:
7
- - Gemfile.lock
data/.opencollective.yml DELETED
@@ -1,3 +0,0 @@
1
- collective: "kettle-rb"
2
- readme-backers-commit-subject: "💸 Thanks 🙏 to our new backers 🎒 and subscribers 📜"
3
- readme-osc-tag: "OPENCOLLECTIVE"
@@ -1,3 +0,0 @@
1
- collective: "{OPENCOLLECTIVE|ORG_NAME}"
2
- readme-backers-commit-subject: "💸 Thanks 🙏 to our new backers 🎒 and subscribers 📜"
3
- readme-osc-tag: "OPENCOLLECTIVE"
data/.qlty/qlty.toml DELETED
@@ -1,79 +0,0 @@
1
- # For a guide to configuration, visit https://qlty.sh/d/config
2
- # Or for a full reference, visit https://qlty.sh/d/qlty-toml
3
- config_version = "0"
4
-
5
- exclude_patterns = [
6
- "*_min.*",
7
- "*-min.*",
8
- "*.min.*",
9
- "**/.yarn/**",
10
- "**/*.d.ts",
11
- "**/assets/**",
12
- "**/bin/**",
13
- "**/bower_components/**",
14
- "**/build/**",
15
- "**/cache/**",
16
- "**/config/**",
17
- "**/.devcontainer",
18
- "**/db/**",
19
- "**/deps/**",
20
- "**/dist/**",
21
- "**/doc/**",
22
- "**/docs/**",
23
- "**/extern/**",
24
- "**/external/**",
25
- "**/generated/**",
26
- "**/Godeps/**",
27
- "**/gradlew/**",
28
- "**/mvnw/**",
29
- "**/node_modules/**",
30
- "**/protos/**",
31
- "**/seed/**",
32
- "**/target/**",
33
- "**/templates/**",
34
- "**/testdata/**",
35
- "**/vendor/**",
36
- ".github/workflows/codeql-analysis.yml"
37
- ]
38
-
39
- test_patterns = [
40
- "**/test/**",
41
- "**/spec/**",
42
- "**/*.test.*",
43
- "**/*.spec.*",
44
- "**/*_test.*",
45
- "**/*_spec.*",
46
- "**/test_*.*",
47
- "**/spec_*.*",
48
- ]
49
-
50
- [smells]
51
- mode = "comment"
52
-
53
- [smells.boolean_logic]
54
- threshold = 4
55
- enabled = true
56
-
57
- [smells.file_complexity]
58
- threshold = 55
59
- enabled = false
60
-
61
- [smells.return_statements]
62
- threshold = 4
63
- enabled = true
64
-
65
- [smells.nested_control_flow]
66
- threshold = 4
67
- enabled = true
68
-
69
- [smells.function_parameters]
70
- threshold = 4
71
- enabled = true
72
-
73
- [smells.function_complexity]
74
- threshold = 5
75
- enabled = true
76
-
77
- [smells.duplication]
78
- enabled = true
79
- threshold = 20
data/.rspec DELETED
@@ -1,9 +0,0 @@
1
- --format progress
2
- --color
3
- --order random
4
- --require spec_helper
5
- --warnings
6
- --format html
7
- --out results/test_results.html
8
- --format RspecJunitFormatter
9
- --out results/test_results.xml
data/.rubocop.yml DELETED
@@ -1,13 +0,0 @@
1
- inherit_gem:
2
- rubocop-lts: config/rubygem_rspec.yml
3
-
4
- inherit_from:
5
- - .rubocop_rspec.yml
6
-
7
- plugins: rubocop-on-rbs
8
-
9
- RBS:
10
- Enabled: true
11
-
12
- Layout/IndentationConsistency:
13
- Exclude: ['*.md']
data/.rubocop_rspec.yml DELETED
@@ -1,33 +0,0 @@
1
- RSpec/MultipleExpectations:
2
- Enabled: false
3
-
4
- RSpec/NamedSubject:
5
- Enabled: false
6
-
7
- RSpec/ExampleLength:
8
- Enabled: false
9
-
10
- RSpec/VerifiedDoubles:
11
- Enabled: false
12
-
13
- RSpec/MessageSpies:
14
- Enabled: false
15
-
16
- RSpec/InstanceVariable:
17
- Enabled: false
18
-
19
- RSpec/NestedGroups:
20
- Enabled: false
21
-
22
- RSpec/ExpectInHook:
23
- Enabled: false
24
-
25
- RSpec/DescribeClass:
26
- Exclude:
27
- - 'spec/examples/*'
28
- - 'spec/integration/*'
29
- - 'spec/system/*'
30
- - 'spec/e2e/*'
31
-
32
- RSpec/MultipleMemoizedHelpers:
33
- Enabled: false
data/.simplecov DELETED
@@ -1,16 +0,0 @@
1
- require "kettle/soup/cover/config"
2
-
3
- # Minimum coverage thresholds are set by kettle-soup-cover.
4
- # It is controlled by ENV variables, which are set in .envrc and loaded via `direnv allow`
5
- # If the values for minimum coverage need to change, they should be changed both there,
6
- # and in 2 places in .github/workflows/coverage.yml.
7
- SimpleCov.start do
8
- track_files "lib/**/*.rb"
9
- track_files "lib/**/*.rake"
10
- track_files "exe/*.rb"
11
-
12
- # Version *is* tested (see spec/kettle/dev/version_spec.rb).
13
- # Due to early loading, the Version class can't be tracked by SimpleCov.
14
- # So we disable coverage here.
15
- add_filter "lib/kettle/dev/version.rb"
16
- end
data/.simplecov.example DELETED
@@ -1,11 +0,0 @@
1
- require "kettle/soup/cover/config"
2
-
3
- # Minimum coverage thresholds are set by kettle-soup-cover.
4
- # It is controlled by ENV variables, which are set in .envrc and loaded via `direnv allow`
5
- # If the values for minimum coverage need to change, they should be changed both there,
6
- # and in 2 places in .github/workflows/coverage.yml.
7
- SimpleCov.start do
8
- track_files "lib/**/*.rb"
9
- track_files "lib/**/*.rake"
10
- track_files "exe/*.rb"
11
- end
data/.tool-versions DELETED
@@ -1 +0,0 @@
1
- ruby 3.4.7
data/.yardignore DELETED
@@ -1,13 +0,0 @@
1
- # Ignore built gem artifacts and package dir
2
- bin/**/*
3
- certs/**/*
4
- checksums/**/*
5
- gemfiles/**/*
6
- pkg/**/*
7
- spec/**/*
8
- spec*/**/*
9
- test/**/*
10
- tmp/**/*
11
- *.gem
12
- # Also ignore yardoc cache
13
- .yardoc/
data/.yardopts DELETED
@@ -1,14 +0,0 @@
1
- --plugin fence
2
- -e yard/fence/hoist.rb
3
- --plugin yaml
4
- --plugin junk
5
- --plugin relative_markdown_links
6
- --readme tmp/yard-fence/README.md
7
- --charset utf-8
8
- --markup markdown
9
- --markup-provider kramdown
10
- --output docs
11
- 'lib/**/*.rb'
12
- -
13
- 'tmp/yard-fence/*.md'
14
- 'tmp/yard-fence/*.txt'
@@ -1,10 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- source "https://gem.coop"
4
-
5
- # Appraisal Root Gemfile is for running appraisal to generate the Appraisal Gemfiles
6
- # in gemfiles/*gemfile.
7
- # On CI, we use it for the Appraisal-based builds.
8
- # We do not load the standard Gemfile, as it is tailored for local development.
9
-
10
- gemspec
data/Appraisals DELETED
@@ -1,151 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # HOW TO UPDATE APPRAISALS (will run rubocop_gradual's autocorrect afterward):
4
- # bin/rake appraisals:update
5
-
6
- # Lock/Unlock Deps Pattern
7
- #
8
- # Two often conflicting goals resolved!
9
- #
10
- # - unlocked_deps.yml
11
- # - All runtime & dev dependencies, but does not have a `gemfiles/*.gemfile.lock` committed
12
- # - Uses an Appraisal2 "unlocked_deps" gemfile, and the current MRI Ruby release
13
- # - Know when new dependency releases will break local dev with unlocked dependencies
14
- # - Broken workflow indicates that new releases of dependencies may not work
15
- #
16
- # - locked_deps.yml
17
- # - All runtime & dev dependencies, and has a `Gemfile.lock` committed
18
- # - Uses the project's main Gemfile, and the current MRI Ruby release
19
- # - Matches what contributors and maintainers use locally for development
20
- # - Broken workflow indicates that a new contributor will have a bad time
21
- #
22
- appraise "unlocked_deps" do
23
- eval_gemfile "modular/coverage.gemfile"
24
- eval_gemfile "modular/documentation.gemfile"
25
- eval_gemfile "modular/optional.gemfile"
26
- eval_gemfile "modular/recording/r3/recording.gemfile"
27
- eval_gemfile "modular/style.gemfile"
28
- eval_gemfile "modular/x_std_libs.gemfile"
29
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
30
- # eval_gemfile "modular/injected.gemfile"
31
- end
32
-
33
- # Used for head (nightly) releases of ruby, truffleruby, and jruby.
34
- # Split into discrete appraisals if one of them needs a dependency locked discretely.
35
- appraise "head" do
36
- gem "benchmark", "~> 0.4", ">= 0.4.1"
37
- # Why is cgi gem here? See: https://github.com/vcr/vcr/issues/1057
38
- gem "cgi", ">= 0.5"
39
- eval_gemfile "modular/recording/r3/recording.gemfile"
40
- eval_gemfile "modular/x_std_libs.gemfile"
41
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
42
- # eval_gemfile "modular/injected.gemfile"
43
- end
44
-
45
- # Used for current releases of ruby, truffleruby, and jruby.
46
- # Split into discrete appraisals if one of them needs a dependency locked discretely.
47
- appraise "current" do
48
- eval_gemfile "modular/recording/r3/recording.gemfile"
49
- eval_gemfile "modular/x_std_libs.gemfile"
50
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
51
- # eval_gemfile "modular/injected.gemfile"
52
- end
53
-
54
- # Test current Rubies against head versions of runtime dependencies
55
- appraise "dep-heads" do
56
- eval_gemfile "modular/runtime_heads.gemfile"
57
- end
58
-
59
- appraise "ruby-2-3" do
60
- eval_gemfile "modular/recording/r2.3/recording.gemfile"
61
- eval_gemfile "modular/x_std_libs/r2.3/libs.gemfile"
62
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
63
- # eval_gemfile "modular/injected.gemfile"
64
- end
65
-
66
- appraise "ruby-2-4" do
67
- eval_gemfile "modular/recording/r2.4/recording.gemfile"
68
- eval_gemfile "modular/x_std_libs/r2.4/libs.gemfile"
69
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
70
- # eval_gemfile "modular/injected.gemfile"
71
- end
72
-
73
- appraise "ruby-2-5" do
74
- eval_gemfile "modular/recording/r2.5/recording.gemfile"
75
- eval_gemfile "modular/x_std_libs/r2.6/libs.gemfile"
76
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
77
- # eval_gemfile "modular/injected.gemfile"
78
- end
79
-
80
- appraise "ruby-2-6" do
81
- eval_gemfile "modular/recording/r2.5/recording.gemfile"
82
- eval_gemfile "modular/x_std_libs/r2.6/libs.gemfile"
83
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
84
- # eval_gemfile "modular/injected.gemfile"
85
- end
86
-
87
- appraise "ruby-2-7" do
88
- eval_gemfile "modular/recording/r2.5/recording.gemfile"
89
- eval_gemfile "modular/x_std_libs/r2/libs.gemfile"
90
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
91
- # eval_gemfile "modular/injected.gemfile"
92
- end
93
-
94
- appraise "ruby-3-0" do
95
- eval_gemfile "modular/recording/r3/recording.gemfile"
96
- eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
97
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
98
- # eval_gemfile "modular/injected.gemfile"
99
- end
100
-
101
- appraise "ruby-3-1" do
102
- # all versions of git gem are incompatible with truffleruby v23.0, syntactically.
103
- # So tests relying on the git gem are skipped, to avoid loading it.
104
- eval_gemfile "modular/recording/r3/recording.gemfile"
105
- eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
106
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
107
- # eval_gemfile "modular/injected.gemfile"
108
- end
109
-
110
- appraise "ruby-3-2" do
111
- # all versions of git gem are incompatible with truffleruby v23.1, syntactically.
112
- # So tests relying on the git gem are skipped, to avoid loading it.
113
- eval_gemfile "modular/recording/r3/recording.gemfile"
114
- eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
115
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
116
- # eval_gemfile "modular/injected.gemfile"
117
- end
118
-
119
- appraise "ruby-3-3" do
120
- eval_gemfile "modular/recording/r3/recording.gemfile"
121
- eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
122
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
123
- # eval_gemfile "modular/injected.gemfile"
124
- end
125
-
126
- # Only run security audit on the latest version of Ruby
127
- appraise "audit" do
128
- eval_gemfile "modular/x_std_libs.gemfile"
129
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
130
- # eval_gemfile "modular/injected.gemfile"
131
- end
132
-
133
- # Only run coverage on the latest version of Ruby
134
- appraise "coverage" do
135
- eval_gemfile "modular/coverage.gemfile"
136
- eval_gemfile "modular/optional.gemfile"
137
- eval_gemfile "modular/recording/r3/recording.gemfile"
138
- eval_gemfile "modular/x_std_libs.gemfile"
139
- # Normally style is included in coverage runs only, but we need it for the test suite to get full coverage
140
- eval_gemfile "modular/style.gemfile"
141
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
142
- # eval_gemfile "modular/injected.gemfile"
143
- end
144
-
145
- # Only run linter on the latest version of Ruby (but, in support of oldest supported Ruby version)
146
- appraise "style" do
147
- eval_gemfile "modular/style.gemfile"
148
- eval_gemfile "modular/x_std_libs.gemfile"
149
- # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
150
- # eval_gemfile "modular/injected.gemfile"
151
- end
data/Appraisals.example DELETED
@@ -1,102 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # HOW TO UPDATE APPRAISALS (will run rubocop_gradual's autocorrect afterward):
4
- # bin/rake appraisals:update
5
-
6
- # Lock/Unlock Deps Pattern
7
- #
8
- # Two often conflicting goals resolved!
9
- #
10
- # - unlocked_deps.yml
11
- # - All runtime & dev dependencies, but does not have a `gemfiles/*.gemfile.lock` committed
12
- # - Uses an Appraisal2 "unlocked_deps" gemfile, and the current MRI Ruby release
13
- # - Know when new dependency releases will break local dev with unlocked dependencies
14
- # - Broken workflow indicates that new releases of dependencies may not work
15
- #
16
- # - locked_deps.yml
17
- # - All runtime & dev dependencies, and has a `Gemfile.lock` committed
18
- # - Uses the project's main Gemfile, and the current MRI Ruby release
19
- # - Matches what contributors and maintainers use locally for development
20
- # - Broken workflow indicates that a new contributor will have a bad time
21
- #
22
- appraise "unlocked_deps" do
23
- eval_gemfile "modular/coverage.gemfile"
24
- eval_gemfile "modular/documentation.gemfile"
25
- eval_gemfile "modular/optional.gemfile"
26
- eval_gemfile "modular/style.gemfile"
27
- eval_gemfile "modular/x_std_libs.gemfile"
28
- end
29
-
30
- # Used for head (nightly) releases of ruby, truffleruby, and jruby.
31
- # Split into discrete appraisals if one of them needs a dependency locked discretely.
32
- appraise "head" do
33
- # Why is gem "cgi" here? See: https://github.com/vcr/vcr/issues/1057
34
- # gem "cgi", ">= 0.5"
35
- gem "benchmark", "~> 0.4", ">= 0.4.1"
36
- eval_gemfile "modular/x_std_libs.gemfile"
37
- end
38
-
39
- # Used for current releases of ruby, truffleruby, and jruby.
40
- # Split into discrete appraisals if one of them needs a dependency locked discretely.
41
- appraise "current" do
42
- eval_gemfile "modular/x_std_libs.gemfile"
43
- end
44
-
45
- # Test current Rubies against head versions of runtime dependencies
46
- appraise "dep-heads" do
47
- eval_gemfile "modular/runtime_heads.gemfile"
48
- end
49
-
50
- appraise "ruby-2-3" do
51
- eval_gemfile "modular/x_std_libs/r2.3/libs.gemfile"
52
- end
53
-
54
- appraise "ruby-2-4" do
55
- eval_gemfile "modular/x_std_libs/r2.4/libs.gemfile"
56
- end
57
-
58
- appraise "ruby-2-5" do
59
- eval_gemfile "modular/x_std_libs/r2.6/libs.gemfile"
60
- end
61
-
62
- appraise "ruby-2-6" do
63
- eval_gemfile "modular/x_std_libs/r2.6/libs.gemfile"
64
- end
65
-
66
- appraise "ruby-2-7" do
67
- eval_gemfile "modular/x_std_libs/r2/libs.gemfile"
68
- end
69
-
70
- appraise "ruby-3-0" do
71
- eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
72
- end
73
-
74
- appraise "ruby-3-1" do
75
- eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
76
- end
77
-
78
- appraise "ruby-3-2" do
79
- eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
80
- end
81
-
82
- appraise "ruby-3-3" do
83
- eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
84
- end
85
-
86
- # Only run security audit on the latest version of Ruby
87
- appraise "audit" do
88
- eval_gemfile "modular/x_std_libs.gemfile"
89
- end
90
-
91
- # Only run coverage on the latest version of Ruby
92
- appraise "coverage" do
93
- eval_gemfile "modular/coverage.gemfile"
94
- eval_gemfile "modular/optional.gemfile"
95
- eval_gemfile "modular/x_std_libs.gemfile"
96
- end
97
-
98
- # Only run linter on the latest version of Ruby (but, in support of oldest supported Ruby version)
99
- appraise "style" do
100
- eval_gemfile "modular/style.gemfile"
101
- eval_gemfile "modular/x_std_libs.gemfile"
102
- end