rbwatch 1.0.0

data/lib/rbwatch/theme.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+require "colorize"
+require "pastel"
+require "tty-prompt"
+require "tty-screen"
+
+module RBWatch
+  class Theme
+    Definition = Struct.new(
+      :banner_border,
+      :status_border,
+      :restart_border,
+      :border_color,
+      :accent_color,
+      :info_color,
+      :success_color,
+      :warning_color,
+      :error_color,
+      :restart_color,
+      :muted_color,
+      keyword_init: true
+    )
+
+    DEFINITIONS = {
+      ruby: Definition.new(
+        banner_border: :thick,
+        status_border: :light,
+        restart_border: :thick,
+        border_color: :red,
+        accent_color: :red,
+        info_color: :cyan,
+        success_color: :green,
+        warning_color: :yellow,
+        error_color: :red,
+        restart_color: :magenta,
+        muted_color: :bright_black
+      ),
+      neon: Definition.new(
+        banner_border: :thick,
+        status_border: :light,
+        restart_border: :thick,
+        border_color: :cyan,
+        accent_color: :magenta,
+        info_color: :cyan,
+        success_color: :green,
+        warning_color: :yellow,
+        error_color: :red,
+        restart_color: :magenta,
+        muted_color: :bright_black
+      ),
+      minimal: Definition.new(
+        banner_border: :ascii,
+        status_border: :ascii,
+        restart_border: :ascii,
+        border_color: :bright_black,
+        accent_color: :white,
+        info_color: :white,
+        success_color: :white,
+        warning_color: :white,
+        error_color: :white,
+        restart_color: :white,
+        muted_color: :bright_black
+      ),
+      matrix: Definition.new(
+        banner_border: :light,
+        status_border: :light,
+        restart_border: :thick,
+        border_color: :green,
+        accent_color: :green,
+        info_color: :green,
+        success_color: :green,
+        warning_color: :yellow,
+        error_color: :red,
+        restart_color: :green,
+        muted_color: :bright_black
+      )
+    }.freeze
+
+    class UnknownThemeError < ArgumentError; end
+
+    class << self
+      def available
+        DEFINITIONS.keys
+      end
+
+      def default(color: true)
+        new(:ruby, color: color)
+      end
+
+      def normalize_name(name)
+        return nil if name.nil?
+
+        value = name.to_s.strip.downcase
+        return nil if value.empty?
+
+        value.to_sym
+      end
+
+      def resolve(name, color: true, interactive: false, input: $stdin, output: $stderr)
+        key = normalize_name(name)
+        return default(color: color) if key.nil?
+        return new(key, color: color) if DEFINITIONS.key?(key)
+
+        if interactive && input.tty? && output.tty?
+          choice = TTY::Prompt.new.select("Choose a theme", available.map(&:to_s), default: "ruby")
+          return new(choice.to_sym, color: color)
+        end
+
+        raise UnknownThemeError, "Unknown theme `#{name}`. Available themes: #{available.map(&:to_s).join(', ')}"
+      end
+    end
+
+    attr_reader :name, :definition
+
+    def initialize(name = :ruby, color: true)
+      @name = self.class.normalize_name(name) || :ruby
+      @definition = self.class::DEFINITIONS.fetch(@name, self.class::DEFINITIONS.fetch(:ruby))
+      @color = color
+      @pastel = Pastel.new(enabled: color)
+    end
+
+    def color?
+      @color
+    end
+
+    def border(kind)
+      case kind
+      when :banner then definition.banner_border
+      when :restart then definition.restart_border
+      else definition.status_border
+      end
+    end
+
+    def box_options(kind = :status)
+      {
+        border: border(kind),
+        enable_color: color?,
+        style: { border: { fg: definition.border_color } }
+      }
+    end
+
+    def accent(text)
+      paint(text, definition.accent_color)
+    end
+
+    def info(text)
+      paint(text, definition.info_color)
+    end
+
+    def success(text)
+      paint(text, definition.success_color)
+    end
+
+    def warning(text)
+      paint(text, definition.warning_color)
+    end
+
+    def error(text)
+      paint(text, definition.error_color)
+    end
+
+    def restart(text)
+      paint(text, definition.restart_color)
+    end
+
+    def muted(text)
+      paint(text, definition.muted_color)
+    end
+
+    def label(text)
+      muted(text)
+    end
+
+    def prefix(level = :info)
+      text = "[RBWatch]"
+      return text unless color?
+
+      color = case level
+              when :success then :green
+              when :warning then :yellow
+              when :error then :red
+              when :restart then :magenta
+              else :cyan
+              end
+      text.colorize(color)
+    end
+
+    def timestamp(time = Time.now)
+      muted("[#{time.strftime('%H:%M:%S')}]")
+    end
+
+    def status(text)
+      success(text)
+    end
+
+    def command(text)
+      info(text)
+    end
+
+    def files(text)
+      accent(text)
+    end
+
+    def delay(text)
+      accent(text)
+    end
+
+    def pid(text)
+      accent(text)
+    end
+
+    def paint(text, color)
+      return text.to_s unless color?
+
+      pastel.public_send(color, text.to_s)
+    rescue NoMethodError
+      text.to_s
+    end
+
+    private
+
+    attr_reader :pastel
+  end
+end
+

data/lib/rbwatch/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RBWatch
+  VERSION = "1.0.0"
+end

data/lib/rbwatch/watcher.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module RBWatch
+  class Watcher
+    Event = Struct.new(:change_set, :snapshot, :first_seen_at, :delivered_at, keyword_init: true)
+
+    attr_reader :baseline_snapshot, :delay, :poll_interval
+
+    def initialize(scanner:, delay:, poll_interval: 0.1, clock: -> { Process.clock_gettime(Process::CLOCK_MONOTONIC) })
+      @scanner = scanner
+      @delay = delay.to_f
+      @poll_interval = poll_interval.to_f
+      @clock = clock
+      @baseline_snapshot = {}
+      @last_observed_snapshot = {}
+      @pending_change = nil
+      @stopped = false
+    end
+
+    def reset(snapshot = @scanner.scan)
+      @baseline_snapshot = snapshot.dup
+      @last_observed_snapshot = snapshot.dup
+      @pending_change = nil
+      self
+    end
+
+    def stop
+      @stopped = true
+    end
+
+    def stopped?
+      @stopped
+    end
+
+    def step
+      current_snapshot = @scanner.scan
+      now = @clock.call
+      poll_diff = @scanner.diff(@last_observed_snapshot, current_snapshot)
+
+      if poll_diff.changed?
+        if current_snapshot == @baseline_snapshot
+          @pending_change = nil
+        else
+          @pending_change ||= { first_seen_at: now }
+          @pending_change[:change_set] = @scanner.diff(@baseline_snapshot, current_snapshot)
+          @pending_change[:snapshot] = current_snapshot
+          @pending_change[:last_change_at] = now
+        end
+      elsif @pending_change && now - @pending_change[:last_change_at] >= delay_seconds
+        event = Event.new(
+          change_set: @pending_change[:change_set],
+          snapshot: @pending_change[:snapshot],
+          first_seen_at: @pending_change[:first_seen_at],
+          delivered_at: now
+        )
+
+        @baseline_snapshot = @pending_change[:snapshot].dup
+        @last_observed_snapshot = current_snapshot.dup
+        @pending_change = nil
+        return event
+      end
+
+      @last_observed_snapshot = current_snapshot.dup
+
+      if @pending_change && now - @pending_change[:last_change_at] >= delay_seconds
+        event = Event.new(
+          change_set: @pending_change[:change_set],
+          snapshot: @pending_change[:snapshot],
+          first_seen_at: @pending_change[:first_seen_at],
+          delivered_at: now
+        )
+
+        @baseline_snapshot = @pending_change[:snapshot].dup
+        @pending_change = nil
+        event
+      else
+        nil
+      end
+    end
+
+    def run
+      return enum_for(:run) unless block_given?
+
+      until stopped?
+        if (event = step)
+          yield event
+        end
+        sleep poll_interval
+      end
+    end
+
+    private
+
+    def delay_seconds
+      @delay / 1000.0
+    end
+  end
+end

data/lib/rbwatch.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module RBWatch
+end
+
+require_relative "rbwatch/version"
+require_relative "rbwatch/theme"
+require_relative "rbwatch/configuration"
+require_relative "rbwatch/file_scanner"
+require_relative "rbwatch/process_manager"
+require_relative "rbwatch/watcher"
+require_relative "rbwatch/dashboard"
+require_relative "rbwatch/runner"
+require_relative "rbwatch/cli"
+

metadata

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification
+name: rbwatch
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- RBWatch 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.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: tty-box
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+- !ruby/object:Gem::Dependency
+  name: tty-screen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.3
+- !ruby/object:Gem::Dependency
+  name: tty-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: RBWatch watches Ruby project files, restarts processes on changes, and
+  presents a polished terminal UI.
+email:
+- opensource@example.com
+executables:
+- rbw
+- rbwatch
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/rbw
+- bin/rbwatch
+- exe/rbw
+- exe/rbwatch
+- lib/rbwatch.rb
+- lib/rbwatch/cli.rb
+- lib/rbwatch/configuration.rb
+- lib/rbwatch/dashboard.rb
+- lib/rbwatch/file_scanner.rb
+- lib/rbwatch/process_manager.rb
+- lib/rbwatch/runner.rb
+- lib/rbwatch/theme.rb
+- lib/rbwatch/version.rb
+- lib/rbwatch/watcher.rb
+homepage: https://github.com/cavalheri/rbwatch
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.11
+specification_version: 4
+summary: A delightful Ruby file watcher and process reloader
+test_files: []