stable-cli-rails 0.7.12 → 0.8.1

data/lib/stable/services/dependency_checker.rb

@@ -1,23 +1,33 @@
 # frozen_string_literal: true
 
+require_relative '../utils/package_manager'
+
 module Stable
   module Services
+    # Service for checking system dependencies and health
     class DependencyChecker
       def run
-        [
-          check('Homebrew', 'brew'),
+        platform = Stable::Utils::Platform.current
+        package_manager_name = Stable::Utils::PackageManager.name
+
+        checks = [
+          check(package_manager_name, package_manager_command(platform)),
           check('Caddy', 'caddy'),
           check('mkcert', 'mkcert'),
-          check('RVM', 'rvm'),
+          check_ruby_manager,
           check_caddy_running,
           check_certs_dir,
           check_apps_registry
         ]
+
+        checks.compact
       end
 
       private
 
       def check(name, command)
+        return nil if command.nil? # Skip checks that don't apply to this platform
+
         ok = system("which #{command} > /dev/null 2>&1")
         {
           name: name,
@@ -26,8 +36,47 @@ module Stable
         }
       end
 
+      def package_manager_command(platform)
+        case platform
+        when :macos
+          'brew'
+        when :linux
+          case Stable::Utils::Platform.package_manager
+          when :apt
+            'apt'
+          when :yum
+            'yum'
+          when :pacman
+            'pacman'
+          end
+        when :windows
+          nil # No package manager check for Windows
+        end
+      end
+
+      def check_ruby_manager
+        managers = [%w[rvm RVM], %w[rbenv rbenv], %w[chruby chruby]]
+
+        manager = managers.find do |cmd, _name|
+          system("which #{cmd} > /dev/null 2>&1")
+        end
+
+        if manager
+          { name: manager[1], ok: true, message: nil }
+        else
+          { name: 'Ruby version manager', ok: false, message: 'No Ruby version manager found (RVM, rbenv, or chruby)' }
+        end
+      end
+
       def check_caddy_running
-        ok = system('pgrep caddy > /dev/null 2>&1')
+        platform = Stable::Utils::Platform.current
+        cmd = if platform == :windows
+                'tasklist /FI "IMAGENAME eq caddy.exe" 2>NUL | find /I "caddy.exe" >NUL'
+              else
+                'pgrep caddy > /dev/null 2>&1'
+              end
+
+        ok = system(cmd)
         {
           name: 'Caddy running',
           ok: ok,
@@ -36,7 +85,7 @@ module Stable
       end
 
       def check_certs_dir
-        path = File.expand_path('~/StableCaddy/certs')
+        path = Stable::Paths.certs_dir
         ok = Dir.exist?(path)
         {
           name: 'Certificates directory',
@@ -46,12 +95,12 @@ module Stable
       end
 
       def check_apps_registry
-        path = File.expand_path('~/StableCaddy/apps.yml')
-        ok = File.exist?(path)
+        path = Stable::Paths.projects_dir
+        ok = Dir.exist?(path)
         {
-          name: 'Apps registry',
+          name: 'Projects directory',
           ok: ok,
-          message: ok ? nil : 'Missing apps registry. Run `stable setup`'
+          message: ok ? nil : 'Missing projects directory. Run `stable setup`'
         }
       end
     end

data/lib/stable/services/hosts_manager.rb

@@ -1,29 +1,40 @@
 # frozen_string_literal: true
 
+require_relative '../utils/platform'
+
 module Stable
   module Services
+    # Service for managing hosts file entries
     class HostsManager
-      HOSTS_FILE = '/etc/hosts'
+      def self.hosts_file
+        Stable::Utils::Platform.hosts_file
+      end
 
       def self.remove(domain)
-        lines = File.read(HOSTS_FILE).lines
+        hosts_file = hosts_file()
+        lines = File.read(hosts_file).lines
         filtered = lines.reject { |l| l.include?(domain) }
 
         return if lines == filtered
 
-        File.write('/tmp/hosts', filtered.join)
-        system("sudo mv /tmp/hosts #{HOSTS_FILE}")
+        if Process.uid.zero?
+          File.write(hosts_file, filtered.join)
+        else
+          File.write('/tmp/hosts', filtered.join)
+          system("sudo mv /tmp/hosts #{hosts_file}")
+        end
       end
 
       def self.add(domain)
+        hosts_file = hosts_file()
         entry = "127.0.0.1\t#{domain}\n"
-        hosts = File.read(HOSTS_FILE)
+        hosts = File.read(hosts_file)
         return if hosts.include?(domain)
 
         if Process.uid.zero?
-          File.open(HOSTS_FILE, 'a') { |f| f.puts entry }
+          File.open(hosts_file, 'a') { |f| f.puts entry }
         else
-          system(%(echo "#{entry}" | sudo tee -a #{HOSTS_FILE} > /dev/null))
+          system(%(echo "#{entry}" | sudo tee -a #{hosts_file} > /dev/null))
         end
       end
     end

data/lib/stable/services/process_manager.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Service for managing application processes
     class ProcessManager
       def self.start(target)
         app = target.is_a?(String) ? AppRegistry.fetch(target) : target
@@ -35,20 +36,23 @@ module Stable
 
         Process.detach(pid)
 
-        AppRegistry.update(app[:name], started_at: Time.now.to_i, pid: pid)
+        # Wait a moment for Rails to start, then find the actual Rails PID
+        sleep 2
+        rails_pid = find_rails_pid(app[:port])
 
-        pid
+        AppRegistry.update(app[:name], started_at: Time.now.to_i, pid: rails_pid || pid)
+
+        rails_pid || pid
       end
 
       def self.stop(app)
-        pid = app[:pid]
-        return unless pid
+        return unless app[:port]
 
-        output = `lsof -i tcp:#{app[:port]} -t`.strip
-        if output.empty?
+        pids = Stable::Utils::Platform.find_pids_by_port(app[:port])
+        if pids.empty?
           puts "No app running on port #{app[:port]}"
         else
-          output.split("\n").each { |pid| Process.kill('TERM', pid.to_i) }
+          pids.each { |pid| Process.kill('TERM', pid.to_i) rescue nil }
           puts "Stopped #{app[:name]} on port #{app[:port]}"
         end
 
@@ -56,6 +60,45 @@ module Stable
       rescue Errno::ESRCH
         AppRegistry.update(app[:name], started_at: nil, pid: nil)
       end
+
+      # Check if a process with the given PID is still running
+      def self.pid_alive?(pid)
+        return false unless pid
+
+        # Use a cross-platform method to check if PID exists
+        if RUBY_PLATFORM =~ /mingw|mswin|win32/
+          # Windows: use tasklist
+          system("tasklist /FI \"PID eq #{pid}\" 2>NUL | find /I \"#{pid}\" >NUL")
+        else
+          # Unix-like systems: check /proc or use ps
+          begin
+            Process.kill(0, pid)
+            true
+          rescue Errno::ESRCH
+            false
+          rescue Errno::EPERM
+            # Process exists but we don't have permission to signal it
+            true
+          end
+        end
+      end
+
+      # Validate and clean up stale app statuses
+      def self.validate_app_statuses
+        apps = AppRegistry.all
+        apps.each do |app|
+          next unless app[:started_at] && app[:pid]
+
+          unless pid_alive?(app[:pid])
+            AppRegistry.update(app[:name], started_at: nil, pid: nil)
+          end
+        end
+      end
+
+      def self.find_rails_pid(port)
+        pids = Stable::Utils::Platform.find_pids_by_port(port)
+        pids.first
+      end
     end
   end
 end

data/lib/stable/services/ruby.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Services
+    # Ruby version management utilities
     module Ruby
       def self.ensure_version(version)
         return if version.nil? || version.to_s.strip.empty?

data/lib/stable/services/setup_runner.rb

@@ -1,7 +1,10 @@
 # frozen_string_literal: true
 
+require_relative '../utils/package_manager'
+
 module Stable
   module Services
+    # Service for setting up the Stable environment and dependencies
     class SetupRunner
       def call
         ensure_directories
@@ -25,8 +28,8 @@ module Stable
       end
 
       def ensure_apps_registry
-        path = Stable::Paths.apps_file
-        File.write(path, {}.to_yaml) unless File.exist?(path)
+        path = Stable::Paths.projects_dir
+        FileUtils.mkdir_p(path)
       end
 
       def ensure_caddyfile
@@ -41,42 +44,133 @@ module Stable
       end
 
       def ensure_dependencies!
-        unless system('which brew > /dev/null')
-          puts 'Homebrew is required. Install it first: https://brew.sh'
+        platform = Stable::Utils::Platform.current
+
+        unless Stable::Utils::PackageManager.available?
+          puts "#{Stable::Utils::PackageManager.name} package manager is required."
+          show_platform_installation_instructions(platform)
           exit 1
         end
 
         # --- Install Caddy ---
-        unless system('which caddy > /dev/null')
+        unless system('which caddy > /dev/null 2>&1')
           puts 'Installing Caddy...'
-          system('brew install caddy')
+          install_package('caddy')
         end
 
         # --- Install mkcert ---
-        unless system('which mkcert > /dev/null')
+        unless system('which mkcert > /dev/null 2>&1')
           puts 'Installing mkcert...'
-          system('brew install mkcert nss')
+          install_mkcert(platform)
         end
 
-        # Always ensure mkcert CA is installed
-        system('mkcert -install')
+        # Always ensure mkcert CA is installed (skip on Windows for now)
+        unless platform == :windows
+          begin
+            system('mkcert -install')
+          rescue StandardError
+            nil
+          end
+        end
 
         # --- Install PostgreSQL ---
-        unless system('which psql > /dev/null')
+        unless system('which psql > /dev/null 2>&1')
           puts 'Installing PostgreSQL...'
-          system('brew install postgresql')
-          system('brew services start postgresql')
+          install_postgres(platform)
         end
 
         # --- Install MySQL ---
-        unless system('which mysql > /dev/null')
+        unless system('which mysql > /dev/null 2>&1')
           puts 'Installing MySQL...'
-          system('brew install mysql')
-          system('brew services start mysql')
+          install_mysql(platform)
         end
 
         puts '✅ All dependencies are installed and running.'
       end
+
+      def install_package(package)
+        cmd = Stable::Utils::PackageManager.install_command(package)
+        system(cmd) or abort("Failed to install #{package}")
+      end
+
+      def install_mkcert(platform)
+        case platform
+        when :macos
+          install_package('mkcert nss')
+        when :linux
+          case Stable::Utils::Platform.package_manager
+          when :apt
+            system('sudo apt update && sudo apt install -y wget')
+            system('wget -O mkcert https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-linux-amd64')
+            system('chmod +x mkcert && sudo mv mkcert /usr/local/bin/')
+          when :yum
+            system('wget -O mkcert https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-linux-amd64')
+            system('chmod +x mkcert && sudo mv mkcert /usr/local/bin/')
+          end
+        when :windows
+          puts 'Please install mkcert manually on Windows: https://github.com/FiloSottile/mkcert'
+        end
+      end
+
+      def install_postgres(platform)
+        case platform
+        when :macos
+          install_package('postgresql')
+          begin
+            system('brew services start postgresql')
+          rescue StandardError
+            nil
+          end
+        when :linux
+          install_package('postgresql postgresql-contrib')
+          start_service('postgresql')
+        when :windows
+          puts 'Please install PostgreSQL manually on Windows from: https://www.postgresql.org/download/windows/'
+        end
+      end
+
+      def install_mysql(platform)
+        case platform
+        when :macos
+          install_package('mysql')
+          begin
+            system('brew services start mysql')
+          rescue StandardError
+            nil
+          end
+        when :linux
+          install_package('mysql-server')
+          start_service('mysql')
+        when :windows
+          puts 'Please install MySQL manually on Windows from: https://dev.mysql.com/downloads/mysql/'
+        end
+      end
+
+      def start_service(service)
+        cmd = Stable::Utils::PackageManager.service_start_command(service)
+        begin
+          system(cmd)
+        rescue StandardError
+          nil
+        end
+      end
+
+      def show_platform_installation_instructions(platform)
+        case platform
+        when :macos
+          puts 'Homebrew is required. Install it first: https://brew.sh'
+        when :linux
+          puts 'Please install a package manager:'
+          puts '  Ubuntu/Debian: sudo apt update && sudo apt install -y build-essential'
+          puts '  CentOS/RHEL: sudo yum install -y gcc gcc-c++ make'
+          puts '  Arch: sudo pacman -S base-devel'
+        when :windows
+          puts 'Please install dependencies manually on Windows.'
+          puts 'Required: Caddy, mkcert, PostgreSQL, MySQL'
+        else
+          puts 'Unsupported platform detected.'
+        end
+      end
     end
   end
 end

data/lib/stable/system/shell.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module System
+    # Shell command execution utilities
     class Shell
       def self.run(cmd)
         puts "→ #{cmd}"

data/lib/stable/utils/package_manager.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require_relative 'platform'
+
+module Stable
+  module Utils
+    # Cross-platform package manager utilities
+    module PackageManager
+      class << self
+        def install_command(package)
+          case Platform.package_manager
+          when :brew
+            "brew install #{package}"
+          when :apt
+            "sudo apt update && sudo apt install -y #{package}"
+          when :yum
+            "sudo yum install -y #{package}"
+          when :pacman
+            "sudo pacman -S --noconfirm #{package}"
+          else
+            raise "Unsupported package manager on #{Platform.current} platform"
+          end
+        end
+
+        def service_start_command(service)
+          case Platform.current
+          when :macos
+            "brew services start #{service}"
+          when :linux
+            "sudo systemctl start #{service}" if systemctl_available?
+          else
+            raise "Service management not supported on #{Platform.current} platform"
+          end
+        end
+
+        def available?
+          pm = Platform.package_manager
+          if pm == :yum
+            system('which yum > /dev/null 2>&1') || system('which dnf > /dev/null 2>&1')
+          else
+            cmd = package_manager_commands.dig(pm, 0)
+            cmd ? system("#{cmd} > /dev/null 2>&1") : false
+          end
+        end
+
+        def name
+          pm = Platform.package_manager
+          package_manager_commands[pm]&.last || 'Unknown'
+        end
+
+        private
+
+        def package_manager_commands
+          {
+            brew: ['which brew', 'Homebrew'],
+            apt: ['which apt', 'APT'],
+            yum: ['which yum', 'YUM/DNF'],
+            pacman: ['which pacman', 'Pacman']
+          }
+        end
+
+        def systemctl_available?
+          system('which systemctl > /dev/null 2>&1')
+        end
+      end
+    end
+  end
+end

data/lib/stable/utils/platform.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Stable
+  module Utils
+    # Platform detection utilities for cross-platform compatibility
+    module Platform
+      class << self
+        def macos?
+          !!(RUBY_PLATFORM =~ /darwin/)
+        end
+
+        def linux?
+          !!(RUBY_PLATFORM =~ /linux/)
+        end
+
+        def windows?
+          !!(RUBY_PLATFORM =~ /mingw|mswin|win32/)
+        end
+
+        def unix?
+          !windows?
+        end
+
+        def current
+          return :macos if macos?
+          return :linux if linux?
+          return :windows if windows?
+
+          :unknown
+        end
+
+        def package_manager
+          return :brew if macos?
+          return detect_linux_package_manager if linux?
+
+          :unknown
+        end
+
+        def hosts_file
+          return '/etc/hosts' if unix?
+          return 'C:\Windows\System32\drivers\etc\hosts' if windows?
+
+          '/etc/hosts' # fallback
+        end
+
+        def home_directory
+          return ENV.fetch('USERPROFILE', nil) if windows?
+
+          Dir.home
+        end
+
+        def port_in_use?(port)
+          case current
+          when :macos, :linux
+            # Use lsof on Unix-like systems
+            system("lsof -i tcp:#{port} -sTCP:LISTEN > /dev/null 2>&1")
+          when :windows
+            # Use netstat on Windows
+            system("netstat -an | findstr :#{port} > nul 2>&1")
+          else
+            false
+          end
+        end
+
+        def find_pids_by_port(port)
+          case current
+          when :macos, :linux
+            # Use lsof to find PIDs listening on the port
+            output = `lsof -i tcp:#{port} -sTCP:LISTEN -t 2>/dev/null`.strip
+            return [] if output.empty?
+            output.split("\n").map(&:to_i)
+          when :windows
+            # On Windows, this is more complex. For now, return empty array
+            # Could potentially parse netstat output in the future
+            []
+          else
+            []
+          end
+        end
+
+        private
+
+        def detect_linux_package_manager
+          return :apt if apt_available?
+          return :yum if yum_available?
+          return :pacman if pacman_available?
+
+          :unknown
+        end
+
+        def apt_available?
+          system('which apt > /dev/null 2>&1')
+        end
+
+        def yum_available?
+          system('which yum > /dev/null 2>&1') || system('which dnf > /dev/null 2>&1')
+        end
+
+        def pacman_available?
+          system('which pacman > /dev/null 2>&1')
+        end
+      end
+    end
+  end
+end

data/lib/stable/utils/prompts.rb

@@ -4,6 +4,7 @@ require 'io/console'
 
 module Stable
   module Utils
+    # User interaction utilities for prompting input
     class Prompts
       def self.mysql_root_credentials
         print 'Enter MySQL root username (default: root): '

data/lib/stable/validators/app_name.rb

@@ -2,6 +2,7 @@
 
 module Stable
   module Validators
+    # Validates and normalizes Rails application names
     class AppName
       VALID_PATTERN = /\A[a-z0-9]+(-[a-z0-9]+)*\z/
       MAX_LENGTH = 63

data/lib/stable.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# Main Stable CLI module - provides cross-platform Rails application management
 module Stable
   def self.root
     Paths.root

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stable-cli-rails
 version: !ruby/object:Gem::Version
-  version: 0.7.12
+  version: 0.8.1
 platform: ruby
 authors:
 - Danny Simfukwe
@@ -23,36 +23,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.2.2
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-description: 'Stable CLI: manage local Rails apps with automatic Caddy, HTTPS, and
-  simple start/stop commands.'
+description: Stable is a cross-platform CLI tool to manage local Rails applications
+  with automatic Caddy setup, local trusted HTTPS certificates, and easy start/stop
+  functionality. Supports macOS, Linux, and Windows.
 email:
 - dannysimfukwe@gmail.com
 executables:
@@ -93,6 +66,8 @@ files:
 - lib/stable/services/ruby.rb
 - lib/stable/services/setup_runner.rb
 - lib/stable/system/shell.rb
+- lib/stable/utils/package_manager.rb
+- lib/stable/utils/platform.rb
 - lib/stable/utils/prompts.rb
 - lib/stable/validators/app_name.rb
 homepage: https://github.com/dannysimfukwe/stable-rails