spiker 0.1.0 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6807d10b0e21344ac48f335257b7a92e41cce9ce140b7f73b3f31545d06d7135
-  data.tar.gz: cd463be9673e5f188459c1ad61e5460dd5b4e9fb05fe6d61651abfd733de1b2c
+  metadata.gz: f6183b45c44cffdac7e55a8cc487634185d550b98b88802d331e66b4d19e5159
+  data.tar.gz: c96d176df0f11614308af344020b8a3b546e291fcb0dc94b7c97724867a9a6e5
 SHA512:
-  metadata.gz: ee478066198cd3b8f3e2bb122d1bd43156dc08a13d2229ad72f1b63f68c67c2ba3d7a6aae8af33d43d319073673228b57dc7ce721b943be61ac8d5c802e2379c
-  data.tar.gz: e753e0e8618365cd74d7f1ee9a38733a1be9e20102e7ab5c22fdb3693566360ab24d6ea21c5a34e34055b4f60e63de51f76c14804c1ff22e3a3463d2265432ed
+  metadata.gz: 61065d34c4b29b1f541ec91274d326536f3952f2e94ed4efad1863bcf81b2eb2b335d140eb9eb2b38ed866ead8bcb213e7b6eff536dc7e71dfe8f9e41507c8a0
+  data.tar.gz: fc2d21d8670e09eb8acd314ae5e75c6caf57f6b880e02cc4becebfab2c6d439bb937da3abf464cc22b8a6d34fcad2fdd380a115ebe14706d9d890f168ab89d0e

data/.rubocop.yml

@@ -12,6 +12,5 @@ Layout/LineLength:
 AllCops:
   NewCops: enable
   Exclude:
-    - 'lib/spiker/generators/templates/**'
     - 'exe/spiker'
     - 'spiker.gemspec'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    spiker (0.1.0)
+    spiker (0.1.4)
       thor (~> 0.19)
 
 GEM

data/README.md

@@ -1,20 +1,12 @@
 # Spiker
 
-Spiker helps you validate your ideas under test.  It can also be a basic educational tool, giving the learner a minimal framework to start writing and testing the Ruby code.
+Spiker helps you validate your ideas under test.  It can also be a basic educational tool, giving the learner a minimal framework to start writing and testing their Ruby code.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+[![Gem Version](https://badge.fury.io/rb/spiker.svg)](https://badge.fury.io/rb/spiker)
 
-```ruby
-gem 'spiker'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
+Install it directly:
 
     $ gem install spiker
 
@@ -29,9 +21,10 @@ Then, create a new spike:
     $ spiker simple my_spike
     $ cd my_spike
 
-Using the "simple" formula, Spiker will create an `app.rb` file, a `Gemfile`, and a `Guardfile`.  The `app.rb` file will contain boilerplate for both Minitest and a Ruby class in the same file:  
+Using the "simple" formula, Spiker will create an `app.rb` file, a `Gemfile`, a `Guardfile` and an `.env` file for configuration, to be read by the `dotenv` gem.  The `app.rb` file will contain boilerplate for both Minitest and a Ruby class in the same file:  
 
 ```ruby
+require 'dotenv'
 require 'minitest'
 require 'minitest/autorun'
 require 'minitest/reporters'
@@ -39,8 +32,12 @@ require 'minitest/reporters'
 Minitest::Reporters.use!
 
 class MySpikeTest < Minitest::Test
-  def test_that_it_works
-    assert true
+  def test_name
+    assert_equal "Fred", MySpike.new(name: "Fred").name
+  end
+
+  def test_default_env_value
+    assert_equal "test", ENV["TEST_VALUE"]
   end
 end
 
@@ -54,7 +51,12 @@ end
 
 From here, the user should be able to start Guard and immediately begin development in a red-green fashion.
 
-The "multiple" option is not implemented yet, but is intended to flesh out a more complex spike that includes a tests directory and `test_helper.rb`, a `lib` directory, README.md, etc.
+The "multi" option places directories and files into a named directory, and is intended to flesh out a more complex spike that includes a tests directory and `test_helper.rb`, a `lib` directory, README.md, etc.  The overall workflow is still the same:
+
+    $ spiker multi my_spike
+    $ cd my_spike
+
+Bundle will run automatically and the user will be able to start development in a red-green fashion just the same as with the simple spike.  There is also a Rakefile provided, the Guardfile is modified from the simple version to include files in directories, and simple tests are predefined.
 
 ## Development
 

data/lib/spiker/cli.rb

@@ -3,11 +3,11 @@
 require "thor"
 require_relative "version"
 require_relative "generators/simple"
-require_relative "generators/multiple"
+require_relative "generators/multi"
 
 module Spiker
-  # Accept options "single" and "multiple"
-  # for single file spikes or multi-file spikes
+  # Accept options "single" and "multi"
+  # for single-file spikes or multi-file spikes
   # and a name for the spike directory.  That is all
   class CLI < Thor
     desc "version", "Show version"
@@ -21,10 +21,10 @@ module Spiker
       Spiker::Generators::Simple.start([name])
     end
 
-    desc "multiple NAME", "Spike over multiple files"
+    desc "multi NAME", "Spike over multiple files"
     method_option :name, type: :string, aliases: "-n", desc: "Name of the spike"
     def multiple(name)
-      Spiker::Generators::Multiple.start([name])
+      Spiker::Generators::Multi.start([name])
     end
   end
 end

data/lib/spiker/generators/multi.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require "thor/group"
+require_relative "../../spiker"
+
+module Spiker
+  module Generators
+    # Generates multiple spike files, seperating tests from the
+    # tested code.  For when the spike gets too hairy for a single
+    # file.
+    class Multi < Thor::Group
+      include Thor::Actions
+
+      argument :name, type: :string
+
+      def self.source_root
+        "#{File.dirname(__FILE__)}/templates"
+      end
+
+      def create_spike_directories
+        empty_directory(name)
+        empty_directory("#{name}/lib")
+        empty_directory("#{name}/test")
+      end
+
+      def create_test_files
+        name_in_snake_case = Spiker.snake_case(name)
+        name_as_class = Spiker.classify(name)
+        opts = { name_as_class: name_as_class, name_in_snake_case: name_in_snake_case }
+        template("multi_app_test.rb.erb", "#{name}/test/#{name_in_snake_case}_test.rb", opts)
+        template("multi_test_helper.rb", "#{name}/test/test_helper.rb", opts)
+      end
+
+      def create_app_files
+        name_in_snake_case = Spiker.snake_case(name)
+        opts = { name_as_class: Spiker.classify(name) }
+        template("multi_app.rb.erb", "#{name}/lib/#{name_in_snake_case}.rb", opts)
+      end
+
+      def create_guard_file
+        template("multi_guardfile.rb", "#{name}/Guardfile")
+      end
+
+      def create_gem_file
+        template("multi_gemfile.rb", "#{name}/Gemfile")
+      end
+
+      def create_rake_file
+        template("multi_rakefile.rb", "#{name}/Rakefile")
+      end
+
+      def create_readme_file
+        opts = { name_as_class: Spiker.classify(name), name: name }
+        template("multi_readme.md.erb", "#{name}/README.md", opts)
+      end
+
+      def create_env_file
+        template("basic.env", "#{name}/.env")
+      end
+
+      def run_bundler
+        inside(name) do
+          run("bundle install")
+        end
+      end
+    end
+  end
+end

data/lib/spiker/generators/simple.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require "thor/group"
+require_relative "../../spiker"
+
 module Spiker
   module Generators
     # Generates a single spike file, with supporting infrastructure.
@@ -19,7 +21,8 @@ module Spiker
       end
 
       def create_spike_file
-        template("simple_app.rb", "#{name}/app.rb")
+        opts = { name_as_class: Spiker.classify(name) }
+        template("simple_app.rb.erb", "#{name}/app.rb", opts)
       end
 
       def create_guard_file
@@ -30,6 +33,10 @@ module Spiker
         template("simple_gemfile.rb", "#{name}/Gemfile")
       end
 
+      def create_env_file
+        template("basic.env", "#{name}/.env")
+      end
+
       def run_bundler
         inside(name) do
           run("bundle install")

data/lib/spiker/generators/templates/basic.env

@@ -0,0 +1 @@
+TEST_VALUE="test"

data/lib/spiker/generators/templates/multi_app.rb.erb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "dotenv/load"
+
+class <%= config[:name_as_class] %>
+  def self.hello
+    "Hello, world!"
+  end
+end

data/lib/spiker/generators/templates/multi_app_test.rb.erb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class <%= config[:name_as_class] %>Test < MiniTest::Unit::TestCase
+  def test_default_class_instantiates
+    assert <%= config[:name_as_class] %>.new
+  end
+
+  def test_default_class_responds_to_hello
+    assert_equal "Hello, world!", <%= config[:name_as_class] %>.hello
+  end
+end

data/lib/spiker/generators/templates/multi_gemfile.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+gem "minitest"
+gem "minitest-reporters"
+gem "guard"
+gem "guard-minitest"
+gem "dotenv"

data/lib/spiker/generators/templates/multi_guardfile.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+clearing :on
+
+guard :minitest, all_after_pass: true do
+  # with Minitest::Unit
+  watch(%r{^test/(.*)/?(.*)_test\.rb$})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb$})     { |m| "test/#{m[1]}#{m[2]}_test.rb" }
+  watch(%r{^test/test_helper\.rb$})      { "test" }
+end

data/lib/spiker/generators/templates/multi_rakefile.rb

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

data/lib/spiker/generators/templates/multi_readme.md.erb

@@ -0,0 +1,44 @@
+# <%= config[:name_as_class] %> Spike
+
+This is the auto-generated README for the <%= config[:name_as_class] %> spike.  This content was generated by the [Spiker](https://github.com/norlinga/spiker) gem.
+
+## Getting Started
+
+This directory is the result of **someone** running the following command on a command line:
+
+    $ gem install spiker
+    $ spiker multi <%= config[:name] %>
+    $ cd <%= config[:name] %>
+
+Once inside the spike directory, open your favorite text editor and then execute the following command:
+
+    $ bundle install
+    $ guard
+
+Bundler will have executed once when the spike directory was first created, but it's no problem to run it again (in case the spike directory was shared between machines / environments).
+
+After starting Guard you should have been greeted with passing tests.  You are now ready to start hashing out your spike under test.
+
+## Adding to This README
+
+This README could be a great place to capture findings from your spike.  Topics to address in this README might include:
+
+- what was the initial motivation for this spike?
+- what is the current state of this spike?
+- is there a future intention or unrealized goal for this spike?
+- what was discovered in the course of this spike?
+- who is involved in this spike?
+
+## Feel Free to Include Code
+
+Embedding code in a Markdown file is easy - this README uses the triple backtick syntax.  The following code will be rendered as a Ruby code block:
+
+```ruby
+require 'dotenv'
+
+puts ENV["TEST_VALUE"]
+
+"maybe show some code in your README?".capitalize
+```
+
+Spikes are intended to be short lived, but that's no reason to skip proper practices in your spike development.  Have fun!

data/lib/spiker/generators/templates/multi_test_helper.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+# require the default lib file
+require "<%= config[:name_in_snake_case] %>"
+
+require "minitest/autorun"
+require "minitest/reporters"
+require "dotenv/load"
+
+Minitest::Reporters.use!
+
+# ensure the environment is available
+class DefaultEnvironmentTest < MiniTest::Unit::TestCase
+  def test_default_environment
+    assert_equal "test", ENV["TEST_VALUE"]
+  end
+end

data/lib/spiker/generators/templates/simple_app.rb.erb

@@ -0,0 +1,23 @@
+require 'dotenv/load'
+require 'minitest'
+require 'minitest/autorun'
+require 'minitest/reporters'
+
+Minitest::Reporters.use!
+
+class <%= config[:name_as_class] %>Test < Minitest::Test
+  def test_name
+    assert_equal "Fred", <%= config[:name_as_class] %>.new(name: 'Fred').name
+  end
+
+  def test_default_env_value
+    assert_equal "test", ENV["TEST_VALUE"]
+  end
+end
+
+class <%= config[:name_as_class] %>
+  attr_accessor :name
+  def initialize(name:)
+    @name = name
+  end
+end

data/lib/spiker/generators/templates/simple_gemfile.rb

@@ -4,8 +4,10 @@ source "https://rubygems.org"
 
 git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
-gem 'minitest'
-gem 'minitest-reporters'
+gem "minitest"
+gem "minitest-reporters"
 
-gem 'guard'
-gem 'guard-minitest'
+gem "guard"
+gem "guard-minitest"
+
+gem "dotenv"

data/lib/spiker/generators/templates/simple_guardfile.rb

@@ -1,6 +1,8 @@
+# frozen_string_literal: true
+
 clearing :on
 
-guard :minitest, all_after_pass: true, test_folders: ['.'], test_file_patterns: '*.rb' do
+guard :minitest, all_after_pass: true, test_folders: ["."], test_file_patterns: "*.rb" do
   # with Minitest::Unit
-  watch(%r{^app\.rb$})      { './app.rb' }
+  watch(/^app\.rb$/) { "./app.rb" }
 end

data/lib/spiker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Spiker
-  VERSION = "0.1.0"
+  VERSION = "0.1.4"
 end

data/lib/spiker.rb

@@ -2,6 +2,20 @@
 
 require_relative "spiker/version"
 
+# Spiker is a simple spike generator.
 module Spiker
   class Error < StandardError; end
+
+  def self.classify(str)
+    str.split(/[^A-Za-z0-0]/).map(&:capitalize).join
+  end
+
+  def self.snake_case(str)
+    # lifted from ActiveSupport inflectors
+    str.gsub(/::/, "/")
+       .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+       .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+       .tr("-", "_")
+       .downcase
+  end
 end

data/spiker.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
 
   spec.summary       = "Properly spike your Ruby"
   spec.description   = "Scaffold for code spikes, includes simple boilerplate with Minitest + Guard to make red/green work out-of-the-box."
-  spec.homepage      = "http://github.com/norling/spiker."
+  spec.homepage      = "http://github.com/norlinga/spiker"
   spec.license       = "MIT"
   spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spiker
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.4
 platform: ruby
 authors:
 - Aaron Norling
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-01-19 00:00:00.000000000 Z
+date: 2022-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -47,19 +47,27 @@ files:
 - exe/spiker
 - lib/spiker.rb
 - lib/spiker/cli.rb
-- lib/spiker/generators/multiple.rb
+- lib/spiker/generators/multi.rb
 - lib/spiker/generators/simple.rb
-- lib/spiker/generators/templates/simple_app.rb
+- lib/spiker/generators/templates/basic.env
+- lib/spiker/generators/templates/multi_app.rb.erb
+- lib/spiker/generators/templates/multi_app_test.rb.erb
+- lib/spiker/generators/templates/multi_gemfile.rb
+- lib/spiker/generators/templates/multi_guardfile.rb
+- lib/spiker/generators/templates/multi_rakefile.rb
+- lib/spiker/generators/templates/multi_readme.md.erb
+- lib/spiker/generators/templates/multi_test_helper.rb
+- lib/spiker/generators/templates/simple_app.rb.erb
 - lib/spiker/generators/templates/simple_gemfile.rb
 - lib/spiker/generators/templates/simple_guardfile.rb
 - lib/spiker/version.rb
 - spiker.gemspec
-homepage: http://github.com/norling/spiker.
+homepage: http://github.com/norlinga/spiker
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: http://github.com/norling/spiker.
+  homepage_uri: http://github.com/norlinga/spiker
   source_code_uri: https://github.com/norlinga/spiker
   changelog_uri: https://github.com/norlinga/spiker
 post_install_message: 

data/lib/spiker/generators/multiple.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-require "thor/group"
-module Spiker
-  module Generators
-    # Generates multiple spike files, seperating tests from the
-    # tested code.  For when the spike gets too hairy for a single
-    # file.
-    class Multiple < Thor::Group
-      include Thor::Actions
-
-      argument :name, type: :string
-    end
-  end
-end

data/lib/spiker/generators/templates/simple_app.rb

@@ -1,18 +0,0 @@
-require 'minitest'
-require 'minitest/autorun'
-require 'minitest/reporters'
-
-Minitest::Reporters.use!
-
-class <%= name.capitalize %>Test < Minitest::Test
-  def test_that_it_works
-    assert true
-  end
-end
-
-class <%= name.capitalize %>
-  attr_accessor :name
-  def initialize(name:)
-    @name = name
-  end
-end