markymark 0.1.0

data/lib/markymark/cli.rb

@@ -0,0 +1,497 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'net/http'
+require 'json'
+require 'socket'
+
+module Markymark
+  # Command-line interface handler
+  class CLI
+    DEFAULT_PORT = 4545
+
+    attr_reader :root_path, :port, :open_browser, :initial_file
+
+    def initialize(args)
+      @root_path = Dir.pwd
+      @port = DEFAULT_PORT
+      @open_browser = true
+      @initial_file = nil
+
+      parse_options(args)
+      validate!
+    end
+
+    def self.run(args)
+      cli = new(args)
+
+      # Check if pumadev mode is active
+      if PumadevManager.active?
+        puts "Pumadev mode is active"
+        # In pumadev mode - switch directory via pumadev manager
+        if PumadevManager.switch_directory(cli.root_path)
+          puts "Switched to #{cli.root_path}"
+          puts "Access markymark at: http://markymark.test"
+
+          # Open browser if requested
+          if cli.open_browser
+            require 'launchy'
+            url = if cli.initial_file
+              "http://markymark.test/?file=#{CGI.escape(cli.initial_file)}"
+            else
+              'http://markymark.test'
+            end
+            Launchy.open(url)
+          end
+        else
+          warn "Failed to switch directory in pumadev mode"
+          exit 1
+        end
+        return
+      end
+
+      # Check if a standalone server is already running
+      existing_server = cli.send(:detect_existing_server)
+
+      if existing_server
+        # Server exists - switch it to the new directory
+        cli.send(:handle_existing_server, existing_server)
+      else
+        # No server running - start a new one (check for port conflicts)
+        if cli.send(:port_available?, cli.port)
+          ServerSimple.launch(cli)
+        else
+          # Port is busy - prompt user
+          cli.send(:handle_port_conflict)
+        end
+      end
+    rescue => e
+      warn "Error: #{e.message}"
+      warn e.backtrace.join("\n")
+      exit 1
+    end
+
+    def self.stop_server
+      # Check if pumadev mode is active first
+      if PumadevManager.active?
+        PumadevManager.teardown
+        exit 0
+      end
+
+      # Check for standalone server
+      pid_file = File.expand_path('~/.markymark/server.pid')
+
+      unless File.exist?(pid_file)
+        puts "No markymark server is running"
+        exit 0
+      end
+
+      # Read PID file
+      content = File.read(pid_file)
+      port = content[/port=(\d+)/, 1]&.to_i
+      pid = content[/pid=(\d+)/, 1]&.to_i
+
+      unless pid
+        puts "Invalid PID file"
+        File.delete(pid_file)
+        exit 1
+      end
+
+      # Check if process is still running
+      begin
+        Process.kill(0, pid)
+      rescue Errno::ESRCH
+        puts "Server process not found (PID: #{pid})"
+        File.delete(pid_file)
+        exit 0
+      end
+
+      puts "Stopping markymark server (PID: #{pid}, port: #{port})..."
+
+      # Try graceful shutdown first (SIGTERM)
+      begin
+        Process.kill('TERM', pid)
+
+        # Wait up to 3 seconds for graceful shutdown
+        3.times do
+          sleep 1
+          begin
+            Process.kill(0, pid)
+          rescue Errno::ESRCH
+            # Process has exited
+            puts "Server stopped successfully"
+            File.delete(pid_file) if File.exist?(pid_file)
+            exit 0
+          end
+        end
+
+        # If still running, force kill
+        puts "Server didn't stop gracefully, forcing shutdown..."
+        Process.kill('KILL', pid)
+        sleep 1
+
+        puts "Server stopped (forced)"
+        File.delete(pid_file) if File.exist?(pid_file)
+      rescue Errno::ESRCH
+        puts "Server stopped successfully"
+        File.delete(pid_file) if File.exist?(pid_file)
+      rescue => e
+        warn "Error stopping server: #{e.message}"
+        exit 1
+      end
+    end
+
+    def self.show_status
+      puts "Markymark Status"
+      puts "=" * 40
+
+      # Check macOS app status
+      if RUBY_PLATFORM.include?('darwin')
+        app_status = AppInstaller.status
+        if app_status
+          puts ""
+          puts "macOS App:"
+          puts "  #{app_status[:message]}"
+        end
+      end
+
+      # Check pumadev
+      pumadev_status = PumadevManager.status
+      if pumadev_status
+        puts ""
+        puts "Server Mode: Pumadev"
+        puts "  #{pumadev_status[:message]}"
+        return
+      end
+
+      # Check standalone server
+      pid_file = File.expand_path('~/.markymark/server.pid')
+      unless File.exist?(pid_file)
+        puts ""
+        puts "Server: Not running"
+        return
+      end
+
+      content = File.read(pid_file)
+      port = content[/port=(\d+)/, 1]&.to_i
+      pid = content[/pid=(\d+)/, 1]&.to_i
+
+      # Check if process is still running
+      begin
+        Process.kill(0, pid)
+        puts ""
+        puts "Server Mode: Standalone"
+        puts "  Running (PID: #{pid}, port: #{port})"
+        puts "  Access at: http://localhost:#{port}"
+      rescue Errno::ESRCH
+        puts ""
+        puts "Server: Not running (stale PID file removed)"
+        File.delete(pid_file)
+      end
+    end
+
+    def self.show_pumadev_instructions
+      puts <<~INSTRUCTIONS
+        Pumadev Setup for markymark
+        ============================
+
+        Pumadev allows you to access markymark via a .test domain instead of remembering ports.
+
+        Quick Setup:
+          markymark --setup-pumadev [PATH]
+
+        Manual Setup Instructions:
+
+        1. Install pumadev (if not already installed):
+           gem install puma-dev
+
+        2. Set up pumadev:
+           sudo puma-dev -setup
+           puma-dev -install
+
+        3. Find your markymark gem installation:
+           gem which markymark
+
+        4. Create a symlink in ~/.puma-dev/:
+           cd ~/.puma-dev
+           ln -s /path/to/markymark/gem markymark
+
+        5. Access markymark at:
+           http://markymark.test
+
+        Notes for Ruby Version Manager Users:
+        - Install markymark in your global gemset of your default Ruby
+        - This ensures the command is available across all Ruby versions
+        - The symlink points to the gem location, which pumadev will use
+
+        Smart Directory Switching:
+        - The smart directory switching feature works with pumadev
+        - Run 'markymark [PATH]' from any directory to switch the server
+        - The directory setting persists across requests
+
+        For more information: https://github.com/puma/puma-dev
+      INSTRUCTIONS
+    end
+
+    private
+
+    def parse_options(args)
+      parser = OptionParser.new do |opts|
+        opts.banner = <<~BANNER
+          markymark - Browse markdown documentation with live reload
+
+          Usage: markymark [PATH] [OPTIONS]
+                 markymark init [-y]
+
+          Arguments:
+            PATH                     Directory or markdown file to browse (default: current directory)
+                                     If a file is specified, opens that directory with the file displayed
+
+          Commands:
+            init                     Interactive setup wizard (use -y to accept defaults)
+
+          Options:
+        BANNER
+
+        opts.on('-p', '--port PORT', Integer, "Port to run server on (default: #{DEFAULT_PORT})") do |p|
+          @port = p
+        end
+
+        opts.on('--no-browser', 'Do not auto-open browser on startup') do
+          @open_browser = false
+        end
+
+        opts.on('--stop', 'Stop the running markymark server') do
+          CLI.stop_server
+        end
+
+        opts.on('-h', '--help', 'Show this help message') do
+          puts opts
+          exit
+        end
+
+        opts.on('-v', '--version', 'Show version') do
+          puts "markymark #{Markymark::VERSION}"
+          exit
+        end
+
+        opts.on('--setup-pumadev [PATH]', 'Setup pumadev integration with optional path') do |path|
+          if PumadevManager.setup(path)
+            require 'launchy'
+            Launchy.open('http://markymark.test')
+          else
+            exit 1
+          end
+          exit 0
+        end
+
+        opts.on('--status', 'Show current server status') do
+          CLI.show_status
+          exit
+        end
+
+        opts.on('--pumadev-info', 'Show pumadev setup instructions') do
+          CLI.show_pumadev_instructions
+          exit
+        end
+
+        opts.on('--install-app', 'Install macOS app bundle to ~/Applications') do
+          if AppInstaller.install
+            exit 0
+          else
+            exit 1
+          end
+        end
+
+        opts.on('--uninstall-app', 'Remove macOS app bundle') do
+          if AppInstaller.uninstall
+            exit 0
+          else
+            exit 1
+          end
+        end
+
+        opts.on('--set-default', 'Set Markymark as default handler for .md files') do
+          if AppInstaller.set_default_handler
+            exit 0
+          else
+            exit 1
+          end
+        end
+      end
+
+      parser.parse!(args)
+
+      # Handle 'init' subcommand
+      if args.first == 'init'
+        args.shift
+        accept_defaults = args.include?('-y') || args.include?('--yes')
+        wizard = InitWizard.new(accept_defaults: accept_defaults)
+        wizard.run
+        exit 0
+      end
+
+      # First non-option argument is the path
+      @root_path = args.first if args.any?
+    end
+
+    def validate!
+      expanded_path = File.expand_path(@root_path)
+
+      unless File.exist?(expanded_path)
+        raise ArgumentError, "Path does not exist: #{@root_path}"
+      end
+
+      # If path is a file, extract directory and filename
+      if File.file?(expanded_path)
+        unless expanded_path =~ /\.(md|markdown)$/i
+          raise ArgumentError, "File must be a markdown file (.md or .markdown): #{@root_path}"
+        end
+        @initial_file = File.basename(expanded_path)
+        @root_path = File.realpath(File.dirname(expanded_path))
+      else
+        @root_path = File.realpath(expanded_path)
+      end
+
+      unless @port.between?(1, 65535)
+        raise ArgumentError, "Port must be between 1 and 65535"
+      end
+    end
+
+    # Detect if a markymark server is already running
+    def detect_existing_server
+      pid_file = File.expand_path('~/.markymark/server.pid')
+      return nil unless File.exist?(pid_file)
+
+      # Parse PID file
+      content = File.read(pid_file)
+      port = content[/port=(\d+)/, 1]&.to_i
+      pid = content[/pid=(\d+)/, 1]&.to_i
+
+      return nil unless port && pid
+
+      # Check if process is still running
+      begin
+        Process.kill(0, pid)
+      rescue Errno::ESRCH
+        # Process not found - clean up stale PID file
+        File.delete(pid_file)
+        return nil
+      end
+
+      # Verify it's actually a markymark server by checking /api/status
+      begin
+        uri = URI("http://localhost:#{port}/api/status")
+        response = Net::HTTP.get_response(uri)
+        if response.is_a?(Net::HTTPSuccess)
+          data = JSON.parse(response.body)
+          return { port: port, pid: pid } if data['app'] == 'markymark'
+        end
+      rescue => e
+        # Server not responding or not markymark - ignore
+      end
+
+      nil
+    end
+
+    # Handle existing server - switch directory and open browser
+    def handle_existing_server(server_info)
+      puts "Found existing markymark server on port #{server_info[:port]}"
+      puts "Switching to #{@root_path}..."
+
+      if switch_server_directory(server_info[:port], @root_path)
+        puts "Successfully switched to #{@root_path}"
+
+        # Open browser if requested
+        if @open_browser
+          base_url = "http://localhost:#{server_info[:port]}"
+          url = if @initial_file
+            "#{base_url}/?file=#{CGI.escape(@initial_file)}"
+          else
+            base_url
+          end
+          require 'launchy'
+          Launchy.open(url)
+        end
+      else
+        warn "Failed to switch directory. Starting new server instead..."
+        # Port might be available now if switch failed
+        if port_available?(@port)
+          ServerSimple.launch(self)
+        else
+          handle_port_conflict
+        end
+      end
+    end
+
+    # Handle port conflict with non-markymark app
+    def handle_port_conflict
+      puts "Port #{@port} is already in use by another application."
+      puts "What would you like to do?"
+      puts "  1) Start markymark on a different port"
+      puts "  2) Cancel"
+      print "Choice (1-2): "
+
+      choice = $stdin.gets&.strip
+
+      case choice
+      when "1"
+        new_port = find_available_port(@port + 1)
+        if new_port
+          puts "Starting markymark on port #{new_port}..."
+          @port = new_port
+          ServerSimple.launch(self)
+        else
+          warn "Could not find an available port"
+          exit 1
+        end
+      else
+        puts "Cancelled"
+        exit 0
+      end
+    end
+
+    # Switch directory on existing server
+    def switch_server_directory(port, new_path)
+      uri = URI("http://localhost:#{port}/change-dir")
+      request = Net::HTTP::Post.new(uri)
+      request.set_form_data('path' => new_path)
+      request['Accept'] = 'application/json'
+
+      begin
+        response = Net::HTTP.start(uri.hostname, uri.port, read_timeout: 5) do |http|
+          http.request(request)
+        end
+
+        # Server returns 303 redirect on successful directory change
+        if response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPRedirection)
+          return true
+        else
+          warn "Server returned error: #{response.code}"
+          return false
+        end
+      rescue => e
+        warn "Failed to communicate with server: #{e.message}"
+        return false
+      end
+    end
+
+    # Check if a port is available
+    def port_available?(port)
+      TCPServer.open('127.0.0.1', port) do |server|
+        server.close
+        true
+      end
+    rescue Errno::EADDRINUSE, Errno::EACCES
+      false
+    end
+
+    # Find next available port starting from given port
+    def find_available_port(start_port)
+      (start_port..65535).each do |port|
+        return port if port_available?(port)
+      end
+      nil
+    end
+  end
+end

data/lib/markymark/init_wizard.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+module Markymark
+  # Interactive setup wizard for Markymark
+  class InitWizard
+    def initialize(accept_defaults: false)
+      @accept_defaults = accept_defaults
+    end
+
+    def run
+      puts "Markymark Setup Wizard"
+      puts "=" * 40
+      puts ""
+
+      results = {
+        app_installed: false,
+        default_set: false,
+        server_mode: nil
+      }
+
+      # Step 1: Install macOS app (macOS only)
+      if macos?
+        results[:app_installed] = step_install_app
+
+        # Step 2: Set as default handler (only if app was installed)
+        if results[:app_installed]
+          results[:default_set] = step_set_default
+        end
+      else
+        puts "Skipping macOS app installation (not on macOS)"
+        puts ""
+      end
+
+      # Step 3: Server mode setup
+      results[:server_mode] = step_server_mode
+
+      # Summary
+      print_summary(results)
+
+      results
+    end
+
+    private
+
+    def macos?
+      RUBY_PLATFORM.include?('darwin')
+    end
+
+    def step_install_app
+      if AppInstaller.installed?
+        status = AppInstaller.status
+        if status[:valid]
+          puts "Markymark.app is already installed and valid."
+          return prompt_yes_no("Reinstall anyway?", default: false)
+        else
+          puts "Warning: #{status[:message]}"
+          reinstall = prompt_yes_no("Reinstall Markymark.app?", default: true)
+          if reinstall
+            return AppInstaller.install(force: true)
+          end
+          return false
+        end
+      end
+
+      install = prompt_yes_no("Install Markymark.app for macOS file handling?", default: true)
+      return false unless install
+
+      AppInstaller.install(force: true)
+    end
+
+    def step_set_default
+      set_default = prompt_yes_no("Set Markymark as default app for .md files?", default: true)
+      return false unless set_default
+
+      AppInstaller.set_default_handler
+    end
+
+    def step_server_mode
+      puts "Server mode setup:"
+      puts "  1) Standalone (port 4545) - run 'markymark' to start"
+      puts "  2) Pumadev (.test domain) - always available at markymark.test"
+      puts "  3) Skip - configure later"
+      puts ""
+
+      if @accept_defaults
+        puts "Using default: Skip (run 'markymark' or 'markymark --setup-pumadev' later)"
+        return :skip
+      end
+
+      print "Choice [1/2/3, default: 3]: "
+      choice = $stdin.gets&.strip
+
+      case choice
+      when '1'
+        puts ""
+        puts "Standalone mode selected."
+        puts "Run 'markymark' or 'markymark <directory>' to start the server."
+        :standalone
+      when '2'
+        puts ""
+        setup_pumadev
+      else
+        puts ""
+        puts "Skipped. Run 'markymark' or 'markymark --setup-pumadev' later."
+        :skip
+      end
+    end
+
+    def setup_pumadev
+      if PumadevManager.active?
+        puts "Pumadev is already configured for Markymark."
+        puts "Access at: http://markymark.test"
+        return :pumadev
+      end
+
+      puts "Setting up pumadev..."
+      if PumadevManager.setup
+        puts "Pumadev configured successfully!"
+        puts "Access at: http://markymark.test"
+        :pumadev
+      else
+        puts "Pumadev setup failed. You can try again with: markymark --setup-pumadev"
+        :skip
+      end
+    end
+
+    def prompt_yes_no(question, default: true)
+      if @accept_defaults
+        puts "#{question} [Y/n] #{default ? 'Y' : 'n'} (auto)"
+        return default
+      end
+
+      default_hint = default ? "[Y/n]" : "[y/N]"
+      print "#{question} #{default_hint} "
+      response = $stdin.gets&.strip&.downcase
+
+      return default if response.nil? || response.empty?
+
+      case response
+      when 'y', 'yes'
+        true
+      when 'n', 'no'
+        false
+      else
+        default
+      end
+    end
+
+    def print_summary(results)
+      puts ""
+      puts "=" * 40
+      puts "Setup Summary"
+      puts "=" * 40
+
+      if macos?
+        if results[:app_installed]
+          puts "  [x] Markymark.app installed to ~/Applications"
+        else
+          puts "  [ ] Markymark.app not installed"
+        end
+
+        if results[:default_set]
+          puts "  [x] Set as default handler for .md files"
+        else
+          puts "  [ ] Not set as default handler"
+        end
+      end
+
+      case results[:server_mode]
+      when :standalone
+        puts "  [x] Standalone mode (run 'markymark' to start)"
+      when :pumadev
+        puts "  [x] Pumadev mode (http://markymark.test)"
+      else
+        puts "  [ ] Server mode not configured"
+      end
+
+      puts ""
+      puts "You can always reconfigure with:"
+      puts "  markymark --install-app      # Install/reinstall macOS app"
+      puts "  markymark --set-default      # Set as default .md handler"
+      puts "  markymark --setup-pumadev    # Setup pumadev integration"
+      puts ""
+    end
+  end
+end