gotsha 0.2.8 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c141f44322e5b490f725002cfeb08b78c6fdac86bd596311fdb9a80a553d2119
-  data.tar.gz: 8061d31df2234c3911c827bdf5592e9d25281187d36605ec5ab8a64c98a5a7f1
+  metadata.gz: 6d2eaa7864b9db6785117da9995761e2f6012ebc0c17d6ea6bd509c36791237e
+  data.tar.gz: d9c634e46197de4fd2c9515bf87ea7fee9f63cceb563dde98068a821e5bab175
 SHA512:
-  metadata.gz: 6b52ac1560058e39dbe268e04fac7f0f9cf7b031c11fe448da1fc825d7a6b3b10611d7cacbdddad2d768848998a23c8467a3eef51662d51d05d4b919710b2e70
-  data.tar.gz: 2d574789ad564b58d86fa3de9dd647e449a5c8925cf715531b31cc22c20f64491f051f51b0e34c687b6ed4a4e5443f73cbc5f85d65db0dc1bfb788265c0f4398
+  metadata.gz: e97d568ebcd2f288b16841a7a673ad64fe38fcbb6a63ab46acc82ff6601da22891218b9173a325a3ed00cbfe0c27db9247f7ab4590dd1cac7c6b056eabc8857a
+  data.tar.gz: 45bb9f592dc803fbe9d2ce9c4b8e70671d27f92daaeee1c6251b3c83f60f0ce6458b22b2f5bc457c6939504588cfd009b3cb24598a6acc4c0cfca08b57665e79

data/.gotsha/hooks/pre-push

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-grep -qE 'pre_push_tests\s*=\s*true' .gotsha/config.toml && (gotsha status || gotsha test)
-gotsha push
+grep -qE 'pre_push_tests\s*=\s*true' .gotsha/config.toml && (exe/gotsha status || exe/gotsha test)
+exe/gotsha push

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.3] - 2025-10-18
+
+- Add guide for case when `gotsha config` fails due to missing `ENV['EDITOR']`
+- Enhance help command (hide some internal commands to not confuse users, add `-h` alias for `help`, add the ability to call `gotsha help <command>` AND `gotsha <command> -h`)
+- Change wording and examples in the config file template, to make it less confising for new users
+
+## [0.2.9] - 2025-10-15
+
+- Add some commented out GT Action code to quickly show how to disable for PR drafts
+
 ## [0.2.8] - 2025-10-15
 
 - Fix pre-push hook (push every time, even when disabled)

data/exe/gotsha

@@ -3,10 +3,8 @@
 
 require_relative "../lib/gotsha"
 
-action = ARGV.first
-
 begin
-  message = Gotsha::ActionDispatcher.call(action)
+  message = Gotsha::ActionDispatcher.call(*ARGV)
   puts("\n✓ Gotsha: #{message}\n\n")
   exit 0
 rescue Gotsha::Errors::SoftFail => e

data/lib/gotsha/action_dispatcher.rb

@@ -2,23 +2,26 @@
 
 module Gotsha
   class ActionDispatcher
-    INIT_SETUP_ACTION = "init"
+    SKIP_CONFIG_VERIFICATION_FOR = %w[init configure uninstall].freeze
     DEFAULT_ACTION = "help"
-    OPEN_CONFIG_ACTION = "configure"
-    UNINSTALL_ACTION = "uninstall"
+    HELP_ACTION_SHORTCUT = "-h"
 
-    def self.call(action_name = DEFAULT_ACTION)
+    def self.call(action_name = DEFAULT_ACTION, *args)
       action_name ||= DEFAULT_ACTION
 
-      new.call(action_name)
+      new.call(action_name, *args)
     end
 
-    def call(action_name)
+    def call(action_name, *args)
       @action_name = action_name
 
       verify_configuration!
 
-      action_class.new.call
+      action_class.new.call(*args)
+    rescue ArgumentError
+      return Actions::Help.new.call(action_name) if args == [HELP_ACTION_SHORTCUT]
+
+      raise Errors::HardFail, "too many arguments"
     end
 
     private
@@ -26,9 +29,7 @@ module Gotsha
     attr_reader :action_name
 
     def verify_configuration!
-      return if UserConfig.get(:ci)
-
-      return if [INIT_SETUP_ACTION, UNINSTALL_ACTION].include?(action_name.to_s)
+      return if SKIP_CONFIG_VERIFICATION_FOR.include?(action_name.to_s) || UserConfig.get(:ci)
 
       raise(Errors::HardFail, "config files not found, please run `gotsha init` first") if UserConfig.blank?
 
@@ -39,7 +40,6 @@ module Gotsha
       end
 
       return unless UserConfig.get(:autogenerated)
-      return if action_name.to_s == OPEN_CONFIG_ACTION
 
       raise Errors::HardFail,
             "autogenerated config detected! Please, remove `autogenerated = true` from `#{Config::CONFIG_FILE}` " \
@@ -47,8 +47,10 @@ module Gotsha
     end
 
     def action_class
-      Kernel.const_get("Gotsha::Actions::#{action_name.capitalize}")
+      Kernel.const_get("Gotsha::Actions::#{action_name.to_s.capitalize}")
     rescue NameError
+      return Gotsha::Actions::Help if action_name.to_s == HELP_ACTION_SHORTCUT
+
       raise Errors::HardFail, "unknown command `#{action_name}`. See available commands via `gotsha help`."
     end
   end

data/lib/gotsha/actions/commit.rb

@@ -3,7 +3,7 @@
 module Gotsha
   module Actions
     class Commit
-      DESCRIPTION = "creates a dummy commit and runs tests on it"
+      DESCRIPTION = "creates a dummy commit and runs tests on it (use for manual sign-off, if you disable hooks)"
 
       def call
         BashCommand.silent_run!('git -c core.hooksPath=/dev/null commit --allow-empty -m "Run Gotsha"')

data/lib/gotsha/actions/configure.rb

@@ -8,7 +8,12 @@ module Gotsha
       def call
         editor = ENV["EDITOR"]
 
-        raise(Errors::HardFail, "please, set ENV variable `EDITOR` first") unless editor
+        if editor.to_s.empty?
+          raise(Errors::HardFail,
+                "could not open config file automatically, ENV " \
+                "variable `EDITOR` not set.\n\nPlease, open file" \
+                "`#{Config::CONFIG_FILE}` manually.")
+        end
 
         if Kernel.system("#{editor} #{Config::CONFIG_FILE}")
           "done"

data/lib/gotsha/actions/help.rb

@@ -3,31 +3,52 @@
 module Gotsha
   module Actions
     class Help
-      DESCRIPTION = "shows available commands and some tips"
+      DESCRIPTION = "shows available commands and some tips (has optional <COMMAND> argument)"
+      INTERNAL_ACTIONS = %i[fetch push test].freeze
+
+      def call(action_name = nil)
+        @action_name = action_name
 
-      def call
         [
           "help",
           commands,
+          action_description,
           config_file,
           contact
-        ].join("\n\n")
+        ].compact.join("\n\n")
       end
 
       private
 
       def commands
+        return if @action_name
+
         commands = Gotsha::Actions.constants.map do |command|
           name = command.downcase
+
+          next if INTERNAL_ACTIONS.include?(name)
+
           description = Kernel.const_get("Gotsha::Actions::#{command}::DESCRIPTION")
 
           "gotsha #{name}   # #{description}"
-        end.sort.join("\n")
+        end.compact.sort.join("\n")
 
         "Available commands: \n\n#{commands}\n"
       end
 
+      def action_description
+        return unless @action_name
+
+        description = Kernel.const_get("Gotsha::Actions::#{@action_name.capitalize}::DESCRIPTION")
+
+        "`gotsha #{@action_name}` #{description}"
+      rescue NameError
+        raise Errors::HardFail, "unknown command `#{@action_name}`"
+      end
+
       def config_file
+        return if @action_name
+
         [
           "Config file:",
           "How and when Gotsha runs tests is configured in `#{Config::CONFIG_FILE}` file, " \
@@ -39,6 +60,8 @@ module Gotsha
       end
 
       def contact
+        return if @action_name
+
         [
           "Contact:",
           "Is something not clear? Did you find a bug? Would you use new feature? Let's talk! \n" \

data/lib/gotsha/actions/init.rb

@@ -3,7 +3,7 @@
 module Gotsha
   module Actions
     class Init
-      DESCRIPTION = "first setup"
+      DESCRIPTION = "performs the Gotsha setup (creates few files and changes Git Hooks path)"
 
       def call
         puts "Creating files..."

data/lib/gotsha/actions/test.rb

@@ -26,8 +26,7 @@ module Gotsha
         return if commands.any?
 
         raise(Errors::HardFail,
-              "please, define some test commands in `#{Config::CONFIG_FILE}` " \
-              "(you can run `gotsha configure` to open it)")
+              "no test commands configured, please run `gotsha configure`")
       end
 
       def run_commands!
@@ -70,7 +69,7 @@ module Gotsha
       end
 
       def commands
-        @commands ||= UserConfig.get(:commands) || []
+        @commands ||= (UserConfig.get(:commands) || []).reject(&:empty?)
       end
     end
   end

data/lib/gotsha/templates/config.toml

@@ -9,15 +9,18 @@ autogenerated = true # Remove this line to start using Gotsha
 #
 # Test commands
 # 
-# This is where you define what tests to run and how.
-# Multiple (comma-separated) commands supported, see the
-# commented examples:
+# This is where you define your test commands.
+# A "test command" is any bash command.
+# Multiple (comma-separated) commands supported
 #
 commands = [
-#  "bundle exec rspec --order rand",
-#  "bin/rails t",
-#  "rubocop",
-#  "docker exec -it great-app rspec"
+  # Your first test command goes into the parentheses!
+  "",
+  # See some examples:
+  #  "bundle exec rspec --order rand",
+  #  "bin/rails t",
+  #  "rubocop",
+  #  "docker exec -it great-app rspec"
 ]
 
 # Git hooks config
@@ -34,7 +37,7 @@ commands = [
 #
 # ```
 #
-post_commit_tests = false # run tests for every commit
+post_commit_tests = true # run tests for every commit
 pre_push_tests = true # run tests on every push
 interrupt_push_on_tests_failure = false # prohibit pushing when tests fail
 

data/lib/gotsha/templates/github_action_example.yml

@@ -2,6 +2,8 @@ name: Gotsha
 
 on:
   pull_request:
+    # Uncomment line below to run Gotsha only when asking for review (ie. do not run when PR is draft)
+    # types: [ready_for_review]
 
 jobs:
   verify:

data/lib/gotsha/user_config.rb

@@ -18,7 +18,7 @@ module Gotsha
     rescue Errno::ENOENT
       {}
     rescue TomlRB::ParseError => e
-      raise Errors::HardFail, "Syntax error in config file\n\n#{e.message}"
+      raise Errors::HardFail, "Syntax error in config file. Open it by running `gotsha configure`\n\n#{e.message}"
     end
   end
 end

data/lib/gotsha/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gotsha
-  VERSION = "0.2.8"
+  VERSION = "0.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gotsha
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: '0.3'
 platform: ruby
 authors:
 - Vitek Meloun