pike13-cli 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fb670799c8613bf30e57bc2a27f67fa56688013c81040d2f99b0a831ec5b12e
-  data.tar.gz: 7723a7b7bc57df97147dc8ead89751d7913881e6a24282000df4ff69d56b1963
+  metadata.gz: 920c87ea78eca41c9a8ecf86d88543d261409eb8e9836b85a816007078c2eab7
+  data.tar.gz: 5de6a6180d416d4fc7811f0beea0612cbf9d542b286c1fb9d1c64c5d2ac4ae15
 SHA512:
-  metadata.gz: e02eefafc87f6fc027c13c162e5c8a76bf27a6688297ddaa5c70739174d9040535889aa2def7a65f6d860b2a5b09392640a4bb83896037c0505b217559c1c050
-  data.tar.gz: 15a52cd46b1aacd85c79bf925ce7f44e05c3a4e2b873ef8f9d970119fd3d4752b49bcb719d014cad83969c87d6c9b7ae99e0d3a77e35a3e48081db843b65a619
+  metadata.gz: 72f787c4b8d2c6881657dce67419b91a08b656c7f3582643cb38bbd2d3c1019f8e8a42cce08fd00401d15d44ed5dacedef2b0520722dc68ac841f0e849b5953d
+  data.tar.gz: 4a60dab31d632ae4365f96c34c60ed6401b8288a5719396d3500107298d86b87400bad80dab6e5c84185e42a449d71063a8b20be501169d9d8f54385024ac4d3

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.3] - 2025-11-22
+
+### Fixed
+- **Help Command Cleanup** - Removed redundant help command from command listings
+  - The `help` command no longer appears in command lists since `-h/--help` flags are already available
+  - Simplified command discovery by removing duplicate help options
+  - Improved command listing clarity across all namespaces
+
+## [0.2.2] - 2025-11-19
+
+### Fixed
+- **Help Command Documentation** - Improved help command clarity and consistency
+  - Updated README.md with better help command examples
+  - Enhanced help command display logic in CLI base commands
+  - Improved user experience for discovering available commands
+
 ## [0.2.1] - 2025-11-18
 
 ### Fixed

data/README.md

@@ -353,10 +353,10 @@ pike13 desk make_ups reasons
 pike13 desk make_ups generate 456 --make-up-reason-id 126989 --free-form-reason "Client was sick"
 
 # Waitlist
-pike13 desk waitlist list
-pike13 desk waitlist get 789
-pike13 desk waitlist create --person-id 123 --event-id 100
-pike13 desk waitlist delete 789
+pike13 desk waitlist_entry list
+pike13 desk waitlist_entry get 789
+pike13 desk waitlist_entry create --person-id 123 --event-id 100
+pike13 desk waitlist_entry delete 789
 
 # Person-related resources
 pike13 desk person_visits list 123
@@ -530,14 +530,33 @@ pike13 report clients query --progress --format table
 
 ```bash
 # Help for any command
-pike13 help
-pike13 desk help
-pike13 desk people help
-pike13 desk event_occurrences help
-pike13 desk event_occurrence_notes help
-pike13 desk custom_fields help
-pike13 desk forms_of_payment help
-pike13 report help
+pike13 --help
+pike13 -h
+
+pike13 desk --help
+pike13 desk -h
+
+pike13 desk people --help
+pike13 desk people -h
+
+pike13 desk event_occurrences --help
+pike13 desk event_occurrences -h
+
+pike13 desk event_occurrence_notes --help
+pike13 desk event_occurrence_notes -h
+
+pike13 desk custom_fields --help
+pike13 desk custom_fields -h
+
+pike13 desk forms_of_payment --help
+pike13 desk forms_of_payment -h
+
+pike13 report --help
+pike13 report -h
+
+# Help for specific commands
+pike13 desk people list --help
+pike13 report clients query --help
 
 # Verbose output (show HTTP requests and detailed debugging)
 pike13 desk people list --verbose
@@ -939,19 +958,30 @@ pike13 report clients query --format csv > clients.csv
 ### Getting Help
 
 ```bash
-# View help for any command
-pike13 help
-pike13 desk help
-pike13 desk people help
-pike13 desk event_occurrences help
-pike13 desk custom_fields help
-pike13 desk forms_of_payment help
+# View help for any command (use --help or -h flags)
+pike13 --help
+pike13 -h
+
+pike13 desk --help
+pike13 desk -h
+
+pike13 desk people --help
+pike13 desk people -h
+
+pike13 desk event_occurrences --help
+pike13 desk event_occurrences -h
+
+pike13 desk custom_fields --help
+pike13 desk custom_fields -h
+
+pike13 desk forms_of_payment --help
+pike13 desk forms_of_payment -h
 
 # Check your environment
 pike13 version
 
 # List all available commands
-pike13 help | grep -A 100 "Commands:"
+pike13 --help | grep -A 100 "Commands:"
 ```
 
 ## Development
@@ -969,7 +999,7 @@ gem build pike13-cli.gemspec
 gem install pike13-cli-0.1.0.beta.gem
 
 # Test the CLI
-pike13 help
+pike13 --help
 
 # Run tests
 bundle exec rspec

data/lib/pike13/cli/commands/account/person.rb

@@ -9,7 +9,7 @@ module Pike13
           def self.base_usage
             "account people"
           end
-          desc "list", "List all people across businesses"
+          desc "list", "List all people across your businesses"
           format_options
           def list
             handle_error do

data/lib/pike13/cli/commands/base.rb

@@ -12,6 +12,21 @@ module Pike13
         class_option :verbose, type: :boolean, aliases: "-v", desc: "Verbose output"
         class_option :quiet, type: :boolean, aliases: "-q", desc: "Quiet mode (errors only)"
 
+        # Override printable_commands to hide redundant help command from listings
+        def self.printable_commands(*args)
+          result = super
+          # Remove the help command from listings since it's redundant when using -h/--help
+          result.reject { |item| item.first.include?("help [COMMAND]") }
+        end
+
+        # Override help to show command-specific options
+        def self.handle_argument_error(task, error, _type)
+          puts "Error: #{error.message}"
+          puts
+          puts "Run '#{basename} #{base_usage} #{task.name} --help' for more information."
+          exit 1
+        end
+
         # Auto-generate base_usage from class name
         def self.base_usage
           # Convert class name like Pike13::CLI::Commands::Report::Clients

data/lib/pike13/cli/commands/desk/event.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Desk < Base
         class Event < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "desk events"
+          end
+
           desc "list", "List all events"
           map "ls" => :list
           format_options

data/lib/pike13/cli/commands/desk/invoice.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Desk < Base
         class Invoice < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "desk invoices"
+          end
+
           desc "list", "List all invoices"
           map "ls" => :list
           format_options

data/lib/pike13/cli/commands/desk/location.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Desk < Base
         class Location < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "desk locations"
+          end
+
           desc "list", "List all locations"
           map "ls" => :list
           format_options

data/lib/pike13/cli/commands/desk/service.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Desk < Base
         class Service < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "desk services"
+          end
+
           desc "list", "List all services"
           map "ls" => :list
           format_options

data/lib/pike13/cli/commands/desk/waitlist_entry.rb

@@ -5,6 +5,10 @@ module Pike13
     module Commands
       class Desk < Base
         class WaitlistEntry < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "desk waitlist_entry"
+          end
           desc "list", "List waitlist entries"
           map "ls" => :list
           format_options

data/lib/pike13/cli/commands/desk.rb

@@ -122,8 +122,11 @@ module Pike13
         desc "mu SUBCOMMAND", "Manage make-ups (shortcut)"
         subcommand "mu", Desk::MakeUp
 
-        desc "waitlist SUBCOMMAND", "Manage waitlist entries"
-        subcommand "waitlist", Desk::WaitlistEntry
+        desc "waitlist_entry SUBCOMMAND", "Manage waitlist entries"
+        subcommand "waitlist_entry", Desk::WaitlistEntry
+
+        desc "wl SUBCOMMAND", "Manage waitlist entries (shortcut)"
+        subcommand "wl", Desk::WaitlistEntry
 
         desc "person_visits SUBCOMMAND", "Manage person visits"
         subcommand "person_visits", Desk::PersonVisit

data/lib/pike13/cli/commands/front/event.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Front < Base
         class Event < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "front events"
+          end
+
           desc "list", "List events (client view)"
           format_options
           option :from, type: :string, desc: "Start date (YYYY-MM-DD or timestamp)"

data/lib/pike13/cli/commands/front/location.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Front < Base
         class Location < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "front locations"
+          end
+
           desc "list", "List locations (client view)"
           format_options
           def list

data/lib/pike13/cli/commands/front/service.rb

@@ -5,6 +5,11 @@ module Pike13
     module Commands
       class Front < Base
         class Service < Base
+          # Override base_usage to match the actual subcommand registration
+          def self.base_usage
+            "front services"
+          end
+
           desc "list", "List services (client view)"
           format_options
           def list

data/lib/pike13/cli/version.rb

@@ -2,6 +2,6 @@
 
 module Pike13
   module CLI
-    VERSION = "0.2.1"
+    VERSION = "0.2.3"
   end
 end

data/lib/pike13/cli.rb

@@ -17,6 +17,7 @@ module Pike13
     class Runner < Thor
       class_option :verbose, type: :boolean, aliases: "-v", desc: "Verbose output"
       class_option :quiet, type: :boolean, aliases: "-q", desc: "Quiet mode (errors only)"
+      class_option :help, type: :boolean, aliases: "-h", desc: "Show help information"
 
       desc "desk SUBCOMMAND", "Desk namespace (staff interface)"
       subcommand "desk", Commands::Desk
@@ -56,7 +57,8 @@ module Pike13
         # Skip config for help commands
         first_arg = given_args.first
         is_help_command = first_arg == "help" || first_arg == "version" ||
-                          given_args.any? { |arg| arg.include?("--help") }
+                          given_args.any? { |arg| arg.include?("--help") || arg.include?("-h") } ||
+                          given_args.include?("help") # Catch help subcommand at any level
         unless is_help_command || given_args.empty?
           Config.configure_pike13!
         end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: pike13-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
-- Pike13 CLI Contributors
+- Juan Huttemann
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z