foobara-empty-ruby-project-generator 1.0.4 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69487bb9af39b07be4764e302f0a664e5d797fb12def733e9b6efffb7b16605e
-  data.tar.gz: 5c8f7cba5c5e3ce7e972077fa83b2ebb566d58a400dd76f32f168146b1e511fe
+  metadata.gz: 7e4a3e6022876d316da2d1151570016cefcc0a3e264fab8914f80c98a5884702
+  data.tar.gz: 2dcf65b9a6c3d55816a52c02258492544168f89debb55a1839ded3935460c976
 SHA512:
-  metadata.gz: 9e6012b705ec17908c11cbdcdb50e582d0c0b068c6300e0efc168be9d182a5d0f7eda9001b1903971d84da7983037578ca0329667b059fb98a7ffe63c137abda
-  data.tar.gz: 19d597e04921284dddc31fb0eaeb67f207352679b127f8aeaa5f14b98ddf8c84f381af17346f55e6b30a0d8157d0fac5316bd8086d31c0ceca38e2d837eac679
+  metadata.gz: '08542c35392d879154eb195d4ecf98a05d950d4a52857e3d05f4835a1c89454f798a038768cb34c0088b1e483ff939b161630610e6abbc8e01d1b1cc396daec7'
+  data.tar.gz: ddf08ce714ecd6f0c1b42f0674c1c8890930ad06a6801d5da9691e5a4d68506ba3335d80567ac314b2d409eded691681222d3816515fa6d1882919bcdf241150

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [1.1.0] - 2026-10-10
+
+- Add Foobara.start! to finish.rb.erb template
+- Eliminate an annoying deprecation warning
+- Use current Foobara version in generated gemspec
+- Set created GitHub repo's description to the --description value
+- Put the correct project name in README.md.erb output
+
+## [1.0.5] - 2026-09-15
+
+- Adds ./local_data to generated .gitignore
+- Fixes various deprecation warnings that pop up in newly generated projects
+- Defaults to branch coverage (should probably be optional!)
+- Make sure all deprecation warnings are shown by default in newly generated projects 
+
 ## [1.0.4] - 2025-08-24
 
 - Scrub cookies in vcr.rb instead of deleting them

data/README.md

@@ -1,49 +1,84 @@
 # Foobara::EmptyRubyProjectGenerator
 
-TODO: Delete this and the text below, and describe your gem
+Generates an empty Ruby project with RuboCop, RSpec, and GitHub Actions already wired up, so you can focus on writing your gem's code rather than setting up boilerplate code. 
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library
-into a gem. Put your Ruby code in the file `lib/foobara/empty_ruby_project_generator`. To experiment with that code,
-run `bin/console` for an interactive prompt.
+The generated project is ideally meant to be used with Foobara however, it can also be used for non-Foobara projects by deleting Foobara-specific parts after generation. 
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it
-to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with
-instructions to install your gem from git if you don't plan to release to RubyGems.org.
+The `foobara-empty-ruby-project-generator` is part of the `foob` family of code generators. Installing the `foob` gem will therefore automatically bring in this generator along with all other foobara generators eliminating the need to install the `foobara-empty-ruby-project-generator` gem separately. 
 
-Install the gem and add to the application's Gemfile by executing:
+Install the gem directly in the terminal:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+    `$ gem install foob`
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Or add it to your Gemfile:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+    `$ bundle add foob`
 
 ## Usage
 
-TODO: Write usage instructions here
+Run the generator to create a new project:
 
-## Development
+    `$ foob g ruby-project -n NAME [options]`
 
-```bash
-bundle config --global local.foobara /path/to/foobara
-bundle config set disable_local_branch_check true
-```
+The `-n` flag represents the name of the project to be generated and is required. It accepts either a plain project name or a name in the 
+`org/project` format:
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can
-also run `bin/console` for an interactive prompt that will allow you to experiment.
+- **Individual account:** `-n my-gem` — creates a project with a single 
+  module e.g. `MyGem`
+- **Organization:** `-n my-org/my-gem` — creates a project with a nested 
+  module e.g. `MyOrg::MyGem` and uses `my-org` as the GitHub organization
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the
-version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version,
-push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+For a full list of available options run:
+
+    `$ foob g ruby-project --help`
+
+or
+
+    `$ foob help ruby-project`
+
+**Commonly used options:**
+
+| Flag | Description |
+|------|-------------|
+| `-n, --name` | Project name or org/project (required) |
+| `-d, --description` | Project description. Defaults to `"No description. Add one."` |
+| `-a, --author-names` | Author name(s) |
+| `--author-emails` | Author email(s) |
+| `-l, --license` | One of: `MIT`, `Apache-2.0`, `MPL-2.0`, `Apache-2.0 OR MIT` |
+| `-u, --use-git` | Initialize a git repository |
+| `--push-to-github` | Create a private GitHub repo and push to it |
+| `-o, --output-directory` | Where to generate the project. Defaults to the project name |
+
+**Example:**
+
+    `$ foob g ruby-project -n my-org/my-gem -d "Does something useful" -l MIT --use-git`
+
+The above generator example when run will put the project in the `my-org/my-gem` folder. 
+
+Upon running the generator, all projects will have the following structure:
+
+- `lib/` - Contains all files that are loaded via `require` and based on the name you provided when generating the project, this folder will be structured as either `lib/my_org/my_gem.rb` for an organisation project name OR `lib/my_gem.rb` for a plain project name.
+
+- `src/` - Contains your ruby gem code. This is a Foobara-specific convention whereby instead of putting all your code in the `lib/` folder, the actual implementation code lives in `src/` folder while the `lib/` folder is reserved for code that can be required. 
+
+If you used the `foobara-empty-ruby-project-generator` gem to generate a non-Foobara Ruby project, you can delete the `src/` folder and place all your code in the `lib/` folder as well as delete any associated Foobara-specific parts. 
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub
-at https://github.com/[USERNAME]/foobara-empty_ruby_project_generator.
+Contributions in the form of PRs and issues are always welcome.
+
+To work on an existing issue or submit a PR:
+
+1. Fork the repo and clone it to your local machine
+2. Run `bundle install` to install dependencies
+3. Run `rake` to ensure that everything works as expected before making any changes. 
+4. Implement your changes and add tests where applicable
+5. Re-run `rake` to make sure that all tests and rubocop pass.
+6. Commit, push to GitHub and open a PR for review
 
 ## License
 
-This project is licensed under your choice of the Apache-2.0 license or the MIT license.
-See [LICENSE.txt](LICENSE.txt) for more info about licensing.
+This project is licensed under your choice of the Apache-2.0 license or 
+the MIT license. See [LICENSE.txt](LICENSE.txt) for more info.

data/src/generators/gemspec_generator.rb

@@ -12,6 +12,10 @@ module Foobara
           def target_path
             "#{kebab_case_full_project_name}.gemspec"
           end
+
+          def current_foobara_version
+            Gem.loaded_specs["foobara"].version
+          end
         end
       end
     end

data/src/generators/license_generator.rb

@@ -27,9 +27,9 @@ module Foobara
               when "MPL-2.0"
                 Mpl2LicenseGenerator
               else
-                # :nocov:
+                # simplecov:disable
                 raise "Unknown license string #{license_string}"
-                # :nocov:
+                # simplecov:enable
               end
             end.map do |klass|
               klass.new(relevant_manifest)
@@ -54,9 +54,9 @@ module Foobara
               "This project is dual licensed under your choice of the " \
               "#{licenses.first} license and the #{licenses.last} license."
             else
-              # :nocov:
+              # simplecov:disable
               raise "Not sure what to do with #{licenses.size} licenses"
-              # :nocov:
+              # simplecov:enable
             end
           end
         end

data/src/generators/project_generator.rb

@@ -24,9 +24,9 @@ module Foobara
                   Generators::VersionGenerator
                 ]
               else
-                # :nocov:
+                # simplecov:disable
                 raise "Not sure how build a generator for a #{manifest}"
-                # :nocov:
+                # simplecov:enable
               end
             end
           end

data/src/manifests/project_config.rb

@@ -38,8 +38,12 @@ module Foobara
         end
 
         def org_slash_project_kebab(organization_name = self.organization_name, project_name = self.project_name)
-          org_part = Util.kebab_case(organization_name)&.gsub("::", "-")
-          project_part = Util.kebab_case(project_name).gsub("::", "-")
+          org_part = if organization_name
+                       Util.kebab_case(organization_name)&.gsub("::", "-")
+                     end
+          project_part = if project_name
+                           Util.kebab_case(project_name).gsub("::", "-")
+                         end
 
           if org_part.nil? || org_part.empty?
             project_part
@@ -99,7 +103,7 @@ module Foobara
           # TODO: implement #[] or move it up to Model from Entity if it exists there.
           @author_names ||= read_attribute(:author_names) || begin
             # TODO: dump a git config file in CI so we don't have to skip this
-            # :nocov:
+            # simplecov:disable
             name = `git config --get user.name`
 
             if $CHILD_STATUS.exitstatus == 0
@@ -107,13 +111,13 @@ module Foobara
             else
               raise "Must set author_names because we can't get it from git for some reason"
             end
-            # :nocov:
+            # simplecov:enable
           end
         end
 
         def author_emails
           @author_emails ||= read_attribute(:author_emails) || begin
-            # :nocov:
+            # simplecov:disable
             email = `git config --get user.email`
 
             if $CHILD_STATUS.exitstatus == 0
@@ -121,7 +125,7 @@ module Foobara
             else
               raise "Must set author_emails because we can't get it from git for some reason"
             end
-            # :nocov:
+            # simplecov:enable
           end
         end
 

data/src/write_empty_ruby_project_to_disk.rb

@@ -1,5 +1,6 @@
 require "fileutils"
 require "extract_repo"
+require "shellwords"
 require_relative "generate_empty_ruby_project"
 
 module Foobara
@@ -115,9 +116,9 @@ module Foobara
               run_cmd_and_return_output(cmd)
             end
           else
-            # :nocov:
+            # simplecov:disable
             run_cmd_and_return_output(cmd)
-            # :nocov:
+            # simplecov:enable
           end
         end
 
@@ -131,14 +132,14 @@ module Foobara
               run_cmd_and_return_output(cmd)
             end
           else
-            # :nocov:
+            # simplecov:disable
             run_cmd_and_return_output(cmd)
-            # :nocov:
+            # simplecov:enable
           end
         rescue CouldNotExecuteError => e
-          # :nocov:
+          # simplecov:disable
           warn e.message
-          # :nocov:
+          # simplecov:enable
         end
 
         def make_bin_files_executable
@@ -148,9 +149,9 @@ module Foobara
               begin
                 run_cmd_and_return_output(cmd)
               rescue CouldNotExecuteError => e
-                # :nocov:
+                # simplecov:disable
                 warn e.message
-                # :nocov:
+                # simplecov:enable
               end
             end
           end
@@ -162,10 +163,10 @@ module Foobara
           cmd = "git init"
           run_cmd_and_return_output(cmd)
         rescue CouldNotExecuteError => e
-          # :nocov:
+          # simplecov:disable
           self.use_git_failed = true
           warn e.message
-          # :nocov:
+          # simplecov:enable
         end
 
         def git_add_all
@@ -174,10 +175,10 @@ module Foobara
           cmd = "git add ."
           run_cmd_and_return_output(cmd)
         rescue CouldNotExecuteError => e
-          # :nocov:
+          # simplecov:disable
           self.use_git_failed = true
           warn e.message
-          # :nocov:
+          # simplecov:enable
         end
 
         def git_commit
@@ -186,10 +187,10 @@ module Foobara
           cmd = "git commit -m 'Create ruby project files'"
           run_cmd_and_return_output(cmd)
         rescue CouldNotExecuteError => e
-          # :nocov:
+          # simplecov:disable
           self.use_git_failed = true
           warn e.message
-          # :nocov:
+          # simplecov:enable
         end
 
         def github_create_repo
@@ -197,7 +198,8 @@ module Foobara
 
           puts "pushing to github..."
 
-          cmd = "gh repo create --private #{project_config.org_slash_project_kebab}"
+          description = Shellwords.escape(project_config.description)
+          cmd = "gh repo create --private #{project_config.org_slash_project_kebab} --description #{description}"
           exit_status = run_cmd_and_write_output(cmd, raise_if_fails: false)
 
           unless exit_status&.success?
@@ -212,9 +214,9 @@ module Foobara
           exit_status = run_cmd_and_write_output(cmd, raise_if_fails: false)
 
           unless exit_status&.success?
-            # :nocov:
+            # simplecov:disable
             self.push_to_github_failed = true
-            # :nocov:
+            # simplecov:enable
           end
         end
 
@@ -225,9 +227,9 @@ module Foobara
           exit_status = run_cmd_and_write_output(cmd, raise_if_fails: false)
 
           unless exit_status&.success?
-            # :nocov:
+            # simplecov:disable
             self.use_git_failed = true
-            # :nocov:
+            # simplecov:enable
           end
         end
 

data/templates/.gitignore.erb

@@ -13,3 +13,5 @@
 /.idea/
 /.env.*.local
 /.env.local
+
+/local_data

data/templates/README.md.erb

@@ -3,7 +3,7 @@
 TODO: Delete this and the text below, and describe your gem
 
 Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library
-into a gem. Put your Ruby code in the file `lib/foobara/empty_ruby_project_generator`. To experiment with that code,
+into a gem. Put your Ruby code in the file `lib/<%= org_slash_project_underscore %>.rb`. To experiment with that code,
 run `bin/console` for an interactive prompt.
 
 

data/templates/boot/config.rb

@@ -1,9 +1,3 @@
-require "dotenv"
-
 require "foobara/load_dotenv"
 
-Dotenv.require_keys("FOOBARA_ENV")
-
-env = ENV.fetch("FOOBARA_ENV", nil)
-
-Foobara::LoadDotenv.run!(env:)
+Foobara::LoadDotenv.run!(env: ENV.fetch("FOOBARA_ENV"))

data/templates/boot/finish.rb.erb

@@ -9,16 +9,24 @@ last = %w[
 
 skip = ["start.rb", "finish.rb", *first, *last]
 
+# simplecov:disable
 first.each { |f| require_relative f if File.exist?("#{__dir__}/#{f}") }
+# simplecov:enable
 
 require "<%= project_lib_file_path %>"
 
 Dir.entries(__dir__).each do |boot_file|
   next unless boot_file.end_with?(".rb")
   next if skip.include?(boot_file)
+  # simplecov:disable
   next unless File.exist?("#{__dir__}/#{boot_file}")
+  # simplecov:enable
 
   require_relative boot_file
 end
 
+# simplecov:disable
 last.each { |f| require_relative f if File.exist?("#{__dir__}/#{f}") }
+# simplecov:enable
+
+Foobara.start!

data/templates/boot/start.rb

@@ -3,8 +3,18 @@ ENV["FOOBARA_ENV"] ||= "development"
 require "bundler/setup"
 
 if ["development", "test"].include?(ENV["FOOBARA_ENV"])
-  require "pry"
-  require "pry-byebug"
+  # simplecov:disable
+  if ENV["CI"] != "true"
+    if ENV["RUBY_DEBUG"] == "true"
+      require "debug"
+    elsif ENV["USE_PRY"] == "true"
+      require "pry"
+    elsif ENV["USE_PRY_BYEBUG"] == "true"
+      require "pry"
+      require "pry-byebug"
+    end
+  end
+  # simplecov:enable
 end
 
 require_relative "config"

data/templates/gemspec.gemspec.erb

@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
     "CHANGELOG.md"
   ]
 
-  spec.add_dependency "foobara", ">= 0.0.136", "< 2.0.0"
+  spec.add_dependency "foobara", ">= <%= current_foobara_version %>", "< 2.0.0"
 
   spec.require_paths = ["lib"]
   spec.metadata["rubygems_mfa_required"] = "true"

data/templates/spec/spec_helper.rb

@@ -6,6 +6,8 @@ require "pry"
 require "pry-byebug"
 require "rspec/its"
 
+Warning[:deprecated] = true
+
 require_relative "support/simplecov"
 require_relative "../boot/start"
 

data/templates/spec/support/simplecov.rb

@@ -1,9 +1,8 @@
 require "simplecov"
 
 SimpleCov.start do
-  add_filter "spec/support"
-  # enable_coverage :branch
-  minimum_coverage line: 100
-  # TODO: enable this? worth it to get to 100% branch coverage?
-  # minimum_coverage line: 100, branch: 100
+  skip "spec/support"
+
+  enable_coverage :branch
+  minimum_coverage line: 100, branch: 100
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foobara-empty-ruby-project-generator
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.0
 platform: ruby
 authors:
 - Miles Georgi
@@ -29,7 +29,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.7.3
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.0.0
@@ -39,7 +39,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.7.3
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.0.0
@@ -47,6 +47,9 @@ dependencies:
   name: foobara-files-generator
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.4
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.0.0
@@ -54,6 +57,9 @@ dependencies:
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.4
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.0.0
@@ -143,7 +149,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Generates empty ruby project boilerplate code from a template
 test_files: []