pike13-cli 0.1.4

data/lib/pike13/cli/formatter.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require "json"
+require "colorize"
+
+module Pike13
+  module CLI
+    # Handles output formatting for CLI commands
+    # Supports JSON, table, and CSV formats
+    class Formatter
+      # Output data in the specified format
+      # The SDK returns raw API responses (Hash or Array)
+      #
+      # @param data [Hash, Array] The data to format and output
+      # @param format [Symbol, String] Output format (:json, :table, or :csv)
+      # @param compact [Boolean] Whether to use compact JSON (no pretty printing)
+      # @param color [Boolean] Whether to use colored output
+      # @return [void]
+      def self.output(data, format: :json, compact: false, color: false)
+        case format.to_sym
+        when :json
+          puts compact ? JSON.generate(data) : JSON.pretty_generate(data)
+        when :table
+          output_table(data, color: color)
+        when :csv
+          output_csv(data)
+        else
+          puts JSON.pretty_generate(data)
+        end
+      end
+
+      def self.output_table(data, color: false)
+        return puts "No data" if data.nil? || (data.respond_to?(:empty?) && data.empty?)
+
+        # Extract array from wrapper if needed
+        items = extract_array_from_response(data)
+        return puts "No data" if items.empty?
+
+        # Get headers from first item
+        first = items.first
+        return puts "No data" if first.nil?
+
+        headers = first.is_a?(Hash) ? first.keys : ["value"]
+
+        # Calculate optimal column widths
+        col_widths = calculate_column_widths(headers, items)
+
+        # Print header
+        header_line = headers.map.with_index { |h, i| h.to_s.ljust(col_widths[i]) }.join(" | ")
+        puts color ? header_line.bold.cyan : header_line
+        puts "-" * header_line.length
+
+        # Print rows
+        items.each do |item|
+          if item.is_a?(Hash)
+            row = headers.map.with_index do |h, i|
+              truncate(item[h].to_s, col_widths[i]).ljust(col_widths[i])
+            end
+            puts row.join(" | ")
+          else
+            puts truncate(item.to_s, col_widths[0])
+          end
+        end
+      end
+
+      def self.output_csv(data)
+        return puts "" if data.nil? || (data.respond_to?(:empty?) && data.empty?)
+
+        # Extract array from wrapper if needed
+        items = extract_array_from_response(data)
+        return puts "" if items.empty?
+
+        first = items.first
+        return puts "" if first.nil? || !first.is_a?(Hash)
+
+        headers = first.keys
+
+        # Print CSV header
+        puts headers.join(",")
+
+        # Print CSV rows
+        items.each do |item|
+          puts headers.map { |h| csv_escape(item[h]) }.join(",")
+        end
+      end
+
+      def self.extract_array_from_response(data)
+        case data
+        when Array
+          data
+        when Hash
+          # Handle reporting API response (v3)
+          if data.dig("data", "attributes", "rows")
+            rows = data.dig("data", "attributes", "rows")
+            fields = data.dig("data", "attributes", "fields") || []
+            # Convert rows (arrays) to hashes using field names
+            return rows.map do |row|
+              fields.each_with_index.to_h { |field, i| [field["name"], row[i]] }
+            end
+          end
+
+          # Try to find an array value in the hash (common API response pattern)
+          # Look for keys like "locations", "people", "events", etc.
+          array_value = data.values.find { |v| v.is_a?(Array) }
+          array_value || [data]
+        else
+          [data]
+        end
+      end
+
+      def self.calculate_column_widths(headers, items, max_width: 50, min_width: 10)
+        # Calculate the width needed for each column
+        headers.map.with_index do |header, _i|
+          # Start with header width
+          max_len = header.to_s.length
+
+          # Check data widths (sample first 100 rows for performance)
+          items.first(100).each do |item|
+            next unless item.is_a?(Hash)
+
+            value_len = item[header].to_s.length
+            max_len = value_len if value_len > max_len
+          end
+
+          # Constrain to min/max
+          max_len.clamp(min_width, max_width)
+        end
+      end
+
+      def self.truncate(str, max_length)
+        str.length > max_length ? "#{str[0...(max_length - 3)]}..." : str
+      end
+
+      def self.csv_escape(value)
+        return "" if value.nil?
+
+        str = value.to_s
+        str.include?(",") || str.include?('"') || str.include?("\n") ? "\"#{str.gsub('"', '""')}\"" : str
+      end
+    end
+  end
+end

data/lib/pike13/cli/progress.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Pike13
+  module CLI
+    # Simple progress indicator for long-running operations
+    class Progress
+      SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"].freeze
+
+      def initialize(message = "Loading", enabled: true)
+        @message = message
+        @enabled = enabled && $stdout.tty?
+        @frame_index = 0
+        @thread = nil
+      end
+
+      # Start the spinner
+      def start
+        return unless @enabled
+
+        @thread = Thread.new do
+          loop do
+            print "\r#{SPINNER_FRAMES[@frame_index]} #{@message}..."
+            @frame_index = (@frame_index + 1) % SPINNER_FRAMES.length
+            sleep 0.1
+          end
+        end
+      end
+
+      # Stop the spinner and clear the line
+      def stop(final_message = nil)
+        return unless @enabled
+
+        @thread&.kill
+        print "\r#{' ' * (@message.length + 10)}\r" # Clear the line
+        puts final_message if final_message
+      end
+
+      # Run a block with progress indication
+      def self.run(message = "Loading", enabled: true)
+        progress = new(message, enabled: enabled)
+        progress.start
+
+        begin
+          result = yield
+          progress.stop
+          result
+        rescue StandardError => e
+          progress.stop
+          raise e
+        end
+      end
+
+      # Simple progress bar for known iterations
+      class Bar
+        def initialize(total, width: 40, enabled: true)
+          @total = total
+          @current = 0
+          @width = width
+          @enabled = enabled && $stdout.tty?
+        end
+
+        def increment(message = nil)
+          return unless @enabled
+
+          @current += 1
+          percentage = (@current.to_f / @total * 100).round
+          filled = (@current.to_f / @total * @width).round
+          bar = ("█" * filled) + ("░" * (@width - filled))
+
+          suffix = message ? " - #{message}" : ""
+          print "\r[#{bar}] #{percentage}%#{suffix}"
+          print "\n" if @current >= @total
+        end
+
+        def finish(message = "Complete")
+          return unless @enabled
+
+          @current = @total
+          bar = "█" * @width
+          print "\r[#{bar}] 100% - #{message}\n"
+        end
+      end
+    end
+  end
+end

data/lib/pike13/cli/thor_nested_subcommand.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Fix for Thor nested subcommand help display bug
+# Based on https://github.com/gangelo/thor_nested_subcommand
+module Pike13
+  module CLI
+    # This module fixes a bug in Thor that prohibits help for nested
+    # subcommands from displaying help properly. Nested subcommands fail
+    # to display their subcommand ancestor command name. This fixes that
+    # bug.
+    module ThorNestedSubcommand
+      class << self
+        def included(base)
+          base.extend ClassMethods
+        end
+      end
+
+      module ClassMethods
+        def base_usage
+          raise NotImplementedError, "#{name} must implement .base_usage method"
+        end
+
+        # Don't override desc - just fix the banner for proper display
+        # The banner override handles the display correctly
+
+        # Thor override
+        # rubocop:disable Lint/UnusedMethodArgument
+        # rubocop:disable Style/OptionalBooleanParameter
+        def banner(command, namespace = nil, subcommand = false)
+          "#{basename} #{base_usage} #{command.usage}"
+        end
+        # rubocop:enable Lint/UnusedMethodArgument
+        # rubocop:enable Style/OptionalBooleanParameter
+      end
+    end
+  end
+end

data/lib/pike13/cli/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Pike13
+  module CLI
+    VERSION = "0.1.4"
+  end
+end

data/lib/pike13/cli.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "pike13"
+require "thor"
+require "json"
+
+require_relative "cli/version"
+require_relative "cli/config"
+require_relative "cli/formatter"
+require_relative "cli/commands/desk"
+require_relative "cli/commands/front"
+require_relative "cli/commands/account"
+require_relative "cli/commands/report"
+
+module Pike13
+  module CLI
+    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)"
+
+      desc "desk SUBCOMMAND", "Desk namespace (staff interface)"
+      subcommand "desk", Commands::Desk
+
+      desc "front SUBCOMMAND", "Front namespace (client interface)"
+      subcommand "front", Commands::Front
+
+      desc "account SUBCOMMAND", "Account namespace"
+      subcommand "account", Commands::Account
+
+      desc "ac SUBCOMMAND", "Account namespace (shortcut)"
+      subcommand "ac", Commands::Account
+
+      desc "report SUBCOMMAND", "Reporting API"
+      subcommand "report", Commands::Report
+
+      desc "version", "Show version"
+      def version
+        require "colorize" if $stdout.tty?
+
+        puts "pike13-cli version #{Pike13::CLI::VERSION}".bold if $stdout.tty?
+        puts "pike13-cli version #{Pike13::CLI::VERSION}" unless $stdout.tty?
+        puts "pike13 gem version #{Pike13::VERSION}"
+        puts "Ruby version: #{RUBY_VERSION}"
+        puts ""
+        puts "Environment:"
+        puts "  PIKE13_ACCESS_TOKEN: #{ENV['PIKE13_ACCESS_TOKEN'] ? 'set' : 'not set'}"
+        puts "  PIKE13_BASE_URL: #{ENV['PIKE13_BASE_URL'] || 'not set'}"
+      end
+
+      def self.exit_on_failure?
+        true
+      end
+
+      # Hook to configure Pike13 before any command
+      def self.start(given_args = ARGV, config = {})
+        # 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") }
+        unless is_help_command || given_args.empty?
+          Config.configure_pike13!
+        end
+        super
+      rescue StandardError => e
+        puts "Error: #{e.message}"
+        exit 1
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: pike13-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- Pike13 CLI Contributors
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: pike13
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: table_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: A powerful CLI tool for interacting with Pike13's Core and Reporting
+  APIs
+email:
+- juanfhuttemann@gmail.com
+executables:
+- pike13
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE.txt
+- README.md
+- bin/pike13
+- completions/_pike13
+- completions/pike13.bash
+- lib/pike13/cli.rb
+- lib/pike13/cli/commands/account.rb
+- lib/pike13/cli/commands/account/business.rb
+- lib/pike13/cli/commands/account/confirmation.rb
+- lib/pike13/cli/commands/account/password.rb
+- lib/pike13/cli/commands/account/person.rb
+- lib/pike13/cli/commands/base.rb
+- lib/pike13/cli/commands/concerns/formattable_command.rb
+- lib/pike13/cli/commands/concerns/reporting_query.rb
+- lib/pike13/cli/commands/desk.rb
+- lib/pike13/cli/commands/desk/appointment.rb
+- lib/pike13/cli/commands/desk/booking.rb
+- lib/pike13/cli/commands/desk/business.rb
+- lib/pike13/cli/commands/desk/custom_field.rb
+- lib/pike13/cli/commands/desk/event.rb
+- lib/pike13/cli/commands/desk/event_occurrence.rb
+- lib/pike13/cli/commands/desk/event_occurrence_note.rb
+- lib/pike13/cli/commands/desk/event_occurrence_visit.rb
+- lib/pike13/cli/commands/desk/event_occurrence_waitlist_entry.rb
+- lib/pike13/cli/commands/desk/form_of_payment.rb
+- lib/pike13/cli/commands/desk/invoice.rb
+- lib/pike13/cli/commands/desk/location.rb
+- lib/pike13/cli/commands/desk/make_up.rb
+- lib/pike13/cli/commands/desk/note.rb
+- lib/pike13/cli/commands/desk/pack.rb
+- lib/pike13/cli/commands/desk/pack_product.rb
+- lib/pike13/cli/commands/desk/payment.rb
+- lib/pike13/cli/commands/desk/person.rb
+- lib/pike13/cli/commands/desk/person_plan.rb
+- lib/pike13/cli/commands/desk/person_visit.rb
+- lib/pike13/cli/commands/desk/person_waitlist_entry.rb
+- lib/pike13/cli/commands/desk/person_waiver.rb
+- lib/pike13/cli/commands/desk/plan.rb
+- lib/pike13/cli/commands/desk/plan_product.rb
+- lib/pike13/cli/commands/desk/punch.rb
+- lib/pike13/cli/commands/desk/refund.rb
+- lib/pike13/cli/commands/desk/revenue_category.rb
+- lib/pike13/cli/commands/desk/sales_tax.rb
+- lib/pike13/cli/commands/desk/service.rb
+- lib/pike13/cli/commands/desk/staff_member.rb
+- lib/pike13/cli/commands/desk/visit.rb
+- lib/pike13/cli/commands/desk/waitlist_entry.rb
+- lib/pike13/cli/commands/front.rb
+- lib/pike13/cli/commands/front/appointment.rb
+- lib/pike13/cli/commands/front/booking.rb
+- lib/pike13/cli/commands/front/branding.rb
+- lib/pike13/cli/commands/front/business.rb
+- lib/pike13/cli/commands/front/event.rb
+- lib/pike13/cli/commands/front/event_occurrence.rb
+- lib/pike13/cli/commands/front/event_occurrence_note.rb
+- lib/pike13/cli/commands/front/event_occurrence_waitlist_eligibility.rb
+- lib/pike13/cli/commands/front/form_of_payment.rb
+- lib/pike13/cli/commands/front/location.rb
+- lib/pike13/cli/commands/front/person.rb
+- lib/pike13/cli/commands/front/person_plan.rb
+- lib/pike13/cli/commands/front/person_visit.rb
+- lib/pike13/cli/commands/front/person_waitlist_entry.rb
+- lib/pike13/cli/commands/front/person_waiver.rb
+- lib/pike13/cli/commands/front/plan_product.rb
+- lib/pike13/cli/commands/front/plan_terms.rb
+- lib/pike13/cli/commands/front/service.rb
+- lib/pike13/cli/commands/report.rb
+- lib/pike13/cli/commands/report/clients.rb
+- lib/pike13/cli/commands/report/enrollments.rb
+- lib/pike13/cli/commands/report/event_occurrence_staff_members.rb
+- lib/pike13/cli/commands/report/event_occurrences.rb
+- lib/pike13/cli/commands/report/invoice_item_transactions.rb
+- lib/pike13/cli/commands/report/invoice_items.rb
+- lib/pike13/cli/commands/report/invoices.rb
+- lib/pike13/cli/commands/report/monthly_business_metrics.rb
+- lib/pike13/cli/commands/report/pays.rb
+- lib/pike13/cli/commands/report/person_plans.rb
+- lib/pike13/cli/commands/report/staff_members.rb
+- lib/pike13/cli/commands/report/transactions.rb
+- lib/pike13/cli/config.rb
+- lib/pike13/cli/formatter.rb
+- lib/pike13/cli/progress.rb
+- lib/pike13/cli/thor_nested_subcommand.rb
+- lib/pike13/cli/version.rb
+homepage: https://github.com/juanhuttemann/pike13-cli
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/juanhuttemann/pike13-cli
+  source_code_uri: https://github.com/juanhuttemann/pike13-cli
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Command-line interface for Pike13 API
+test_files: []