discourse-systray 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 342570ecbf8771500b6be8dd6deba05ceb429b4465746c3fa2fc822dedbff311
+  data.tar.gz: c6a5dbc3ab88a256c2d9f5a9bda9def61ce26ec46a32280e4a81c144335f1017
+SHA512:
+  metadata.gz: 183b3a72d39b1f6525d7a2ce533829349709192f8da6ede5d53ae231441a3064e37e04eaa94050ed3e63327784184c9b004049521c7a79fc6f2db688618aec96
+  data.tar.gz: 5c803012c9fdcaeea04465e8803e66f3531cec3c3487616256e24ede3b28d4e2a0e3a3e59c583fdb9a1a1618d411de98297b43b77ed7abd2c664e2a4a2e648de

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,56 @@
+# Discourse Systray
+
+A system tray application for managing local Discourse development instances.
+
+## Installation
+
+```bash
+gem install discourse-systray
+```
+
+## Usage
+
+Simply run:
+
+```bash
+discourse-systray
+```
+
+Optional flags:
+- `--debug`: Enable debug mode
+- `--path PATH`: Set Discourse path
+
+### Features
+
+- Start/Stop Discourse development environment from system tray
+- Monitor Ember CLI and Unicorn server status
+- View real-time logs with ANSI color support
+- Status indicators for running services
+- Clean process management and graceful shutdown
+
+### System Tray Menu
+
+- **Start Discourse**: Launches both Ember CLI and Unicorn server
+- **Stop Discourse**: Gracefully stops all running processes
+- **Show Status**: Opens log viewer window
+- **Quit**: Exits application and cleans up processes
+
+### Requirements
+
+- Ruby >= 2.6.0
+- GTK3
+- Discourse development environment
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies.
+
+To install this gem onto your local machine, run:
+```bash
+gem build discourse-systray.gemspec
+gem install ./discourse-systray-0.1.0.gem
+```
+
+## License
+
+The gem is available as open source under the terms of the MIT License.

data/bin/discourse-systray

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "discourse_systray/systray"
+
+DiscourseSystemTray.new.run

data/lib/discourse_systray/systray.rb

@@ -0,0 +1,507 @@
+require "gtk3"
+require "open3"
+require "optparse"
+require "timeout"
+require "fileutils"
+require "json"
+
+# Parse command line options
+OPTIONS = { debug: false, path: nil }
+
+OptionParser
+  .new do |opts|
+    opts.banner = "Usage: systray.rb [options]"
+    opts.on("--debug", "Enable debug mode") { OPTIONS[:debug] = true }
+    opts.on("--path PATH", "Set Discourse path") { |p| OPTIONS[:path] = p }
+  end
+  .parse!
+
+class DiscourseSystemTray
+  CONFIG_DIR = File.expand_path("~/.config/discourse-systray")
+  CONFIG_FILE = File.join(CONFIG_DIR, "config.json")
+
+  def self.load_or_prompt_config
+    FileUtils.mkdir_p(CONFIG_DIR) unless Dir.exist?(CONFIG_DIR)
+
+    if OPTIONS[:path]
+      save_config(path: OPTIONS[:path])
+      return OPTIONS[:path]
+    end
+
+    if File.exist?(CONFIG_FILE)
+      config = JSON.parse(File.read(CONFIG_FILE))
+      return config["path"] if config["path"] && Dir.exist?(config["path"])
+    end
+
+    # Show dialog to get path
+    dialog =
+      Gtk::FileChooserDialog.new(
+        title: "Select Discourse Directory",
+        parent: nil,
+        action: :select_folder,
+        buttons: [["Cancel", :cancel], ["Select", :accept]]
+      )
+
+    path = nil
+    if dialog.run == :accept
+      path = dialog.filename
+      save_config(path: path)
+    else
+      puts "No Discourse path specified. Exiting."
+      exit 1
+    end
+
+    dialog.destroy
+    path
+  end
+
+  def self.save_config(path:, window_geometry: nil)
+    config = { path: path }
+    config[:window_geometry] = window_geometry if window_geometry
+    File.write(CONFIG_FILE, JSON.generate(config))
+    nil # Prevent return value from being printed
+  end
+
+  def self.load_config
+    return {} unless File.exist?(CONFIG_FILE)
+    JSON.parse(File.read(CONFIG_FILE))
+  rescue JSON::ParserError
+    {}
+  end
+  BUFFER_SIZE = 2000
+
+  def initialize
+    @discourse_path = self.class.load_or_prompt_config
+    @indicator = Gtk::StatusIcon.new
+    @indicator.pixbuf = GdkPixbuf::Pixbuf.new(file: File.join(File.dirname(__FILE__), "../../assets/discourse.png"))
+    @indicator.tooltip_text = "Discourse Manager"
+    @running = false
+    @ember_output = []
+    @unicorn_output = []
+    @processes = {}
+    @ember_running = false
+    @unicorn_running = false
+    @status_window = nil
+
+    # Create right-click menu
+    @indicator.signal_connect("popup-menu") do |tray, button, time|
+      menu = Gtk::Menu.new
+
+      # Create menu items with icons
+      start_item = Gtk::ImageMenuItem.new(label: "Start Discourse")
+      start_item.image =
+        Gtk::Image.new(icon_name: "media-playback-start", size: :menu)
+
+      stop_item = Gtk::ImageMenuItem.new(label: "Stop Discourse")
+      stop_item.image =
+        Gtk::Image.new(icon_name: "media-playback-stop", size: :menu)
+
+      status_item = Gtk::ImageMenuItem.new(label: "Show Status")
+      status_item.image =
+        Gtk::Image.new(icon_name: "utilities-system-monitor", size: :menu)
+
+      quit_item = Gtk::ImageMenuItem.new(label: "Quit")
+      quit_item.image =
+        Gtk::Image.new(icon_name: "application-exit", size: :menu)
+
+      # Add items in new order
+      menu.append(start_item)
+      menu.append(stop_item)
+      menu.append(Gtk::SeparatorMenuItem.new)
+      menu.append(status_item)
+      menu.append(Gtk::SeparatorMenuItem.new)
+      menu.append(quit_item)
+
+      start_item.signal_connect("activate") do
+        set_icon(:running)
+        start_discourse
+        @running = true
+      end
+
+      stop_item.signal_connect("activate") do
+        set_icon(:stopped)
+        stop_discourse
+        @running = false
+      end
+
+      quit_item.signal_connect("activate") do
+        cleanup
+        Gtk.main_quit
+      end
+
+      status_item.signal_connect("activate") { show_status_window }
+
+      menu.show_all
+
+      # Show/hide items based on running state - AFTER show_all
+      start_item.visible = !@running
+      stop_item.visible = @running
+      menu.popup(nil, nil, button, time)
+    end
+  end
+
+  def start_discourse
+    @ember_output.clear
+    @unicorn_output.clear
+
+    Dir.chdir(@discourse_path) do
+      @processes[:ember] = start_process("bin/ember-cli")
+      @ember_running = true
+      @processes[:unicorn] = start_process("bin/unicorn")
+      @unicorn_running = true
+      update_tab_labels if @notebook
+    end
+  end
+
+  def stop_discourse
+    cleanup
+  end
+
+  def cleanup
+    return if @processes.empty?
+
+    @processes.each do |name, process|
+      begin
+        Process.kill("TERM", process[:pid])
+        # Wait for process to finish with timeout
+        Timeout.timeout(10) { process[:thread].join }
+      rescue StandardError => e
+        puts "Error stopping #{name}: #{e}" if OPTIONS[:debug]
+      end
+    end
+    @processes.clear
+    @ember_running = false
+    @unicorn_running = false
+    update_tab_labels if @notebook
+
+    # Clean up window and timeouts on exit
+    if @status_window
+      # Clean up any existing timeouts
+      if @view_timeouts
+        @view_timeouts.values.each do |id|
+          begin
+            GLib::Source.remove(id)
+          rescue StandardError
+            nil
+          end
+        end
+        @view_timeouts.clear
+      end
+      @status_window.destroy
+      @status_window = nil
+    end
+  end
+
+  def start_process(command)
+    stdin, stdout, stderr, wait_thr = Open3.popen3(command)
+
+    # Create a monitor thread that will detect if process dies
+    monitor_thread =
+      Thread.new do
+        wait_thr.value # Wait for process to finish
+        is_ember = command.include?("ember-cli")
+        @ember_running = false if is_ember
+        @unicorn_running = false unless is_ember
+        GLib::Idle.add do
+          update_tab_labels if @notebook
+          false
+        end
+      end
+
+    # Monitor stdout
+    Thread.new do
+      while line = stdout.gets
+        buffer = command.include?("ember-cli") ? @ember_output : @unicorn_output
+        puts "[OUT] #{line}" if OPTIONS[:debug]
+        buffer << line
+        buffer.shift if buffer.size > BUFFER_SIZE
+        # Force GUI update
+        GLib::Idle.add do
+          update_all_views
+          false
+        end
+      end
+    end
+
+    # Monitor stderr
+    Thread.new do
+      while line = stderr.gets
+        buffer = command.include?("ember-cli") ? @ember_output : @unicorn_output
+        puts "[ERR] #{line}" if OPTIONS[:debug]
+        buffer << line
+        buffer.shift if buffer.size > BUFFER_SIZE
+        # Force GUI update
+        GLib::Idle.add do
+          update_all_views
+          false
+        end
+      end
+    end
+
+    {
+      pid: wait_thr.pid,
+      stdin: stdin,
+      stdout: stdout,
+      stderr: stderr,
+      thread: wait_thr,
+      monitor: monitor_thread
+    }
+  end
+
+  def show_status_window
+    if @status_window&.visible?
+      @status_window.present
+      # Force window to current workspace in i3
+      if @status_window.window
+        @status_window.window.raise
+        if system("which i3-msg >/dev/null 2>&1")
+          # First move to current workspace, then focus
+          system(
+            "i3-msg '[id=#{@status_window.window.xid}] move workspace current'"
+          )
+          system("i3-msg '[id=#{@status_window.window.xid}] focus'")
+        end
+      end
+      return
+    end
+
+    # Clean up any existing window
+    if @status_window
+      @status_window.destroy
+      @status_window = nil
+    end
+
+    @status_window = Gtk::Window.new("Discourse Status")
+    @status_window.set_wmclass("discourse-status", "Discourse Status")
+
+    # Load saved geometry or use defaults
+    config = self.class.load_config
+    if config["window_geometry"]
+      geo = config["window_geometry"]
+      @status_window.move(geo["x"], geo["y"])
+      @status_window.resize(geo["width"], geo["height"])
+    else
+      @status_window.set_default_size(800, 600)
+      @status_window.window_position = :center
+    end
+    @status_window.type_hint = :dialog
+    @status_window.set_role("discourse-status-dialog")
+
+    # Handle window destruction and hide
+    @status_window.signal_connect("delete-event") do
+      save_window_geometry
+      @status_window.hide
+      true # Prevent destruction
+    end
+
+    # Save position and size when window is moved or resized
+    @status_window.signal_connect("configure-event") do
+      save_window_geometry
+      false
+    end
+
+    @notebook = Gtk::Notebook.new
+
+    @ember_view = create_log_view(@ember_output)
+    @ember_label = create_status_label("Ember CLI", @ember_running)
+    @notebook.append_page(@ember_view, @ember_label)
+
+    @unicorn_view = create_log_view(@unicorn_output)
+    @unicorn_label = create_status_label("Unicorn", @unicorn_running)
+    @notebook.append_page(@unicorn_view, @unicorn_label)
+
+    @status_window.add(@notebook)
+    @status_window.show_all
+  end
+
+  def update_all_views
+    return unless @ember_view && @unicorn_view
+
+    update_log_view(@ember_view.child, @ember_output)
+    update_log_view(@unicorn_view.child, @unicorn_output)
+  end
+
+  def create_log_view(buffer)
+    scroll = Gtk::ScrolledWindow.new
+    text_view = Gtk::TextView.new
+    text_view.editable = false
+    text_view.wrap_mode = :word
+
+    # Set white text on black background
+    text_view.override_background_color(:normal, Gdk::RGBA.new(0, 0, 0, 1))
+    text_view.override_color(:normal, Gdk::RGBA.new(1, 1, 1, 1))
+
+    # Create text tags for colors
+    _tag_table = text_view.buffer.tag_table
+    create_ansi_tags(text_view.buffer)
+
+    # Initial text
+    update_log_view(text_view, buffer)
+
+    # Store timeouts in instance variable for proper cleanup
+    @view_timeouts ||= {}
+
+    # Set up periodic refresh with validity check
+    timeout_id =
+      GLib::Timeout.add(1000) do
+        if text_view&.parent.nil? || !text_view&.parent&.visible?
+          @view_timeouts.delete(text_view.object_id)
+          false # Stop the timeout if view is destroyed
+        else
+          begin
+            update_log_view(text_view, buffer)
+          rescue StandardError
+            nil
+          end
+          true # Keep the timeout active
+        end
+      end
+
+    @view_timeouts[text_view.object_id] = timeout_id
+
+    # Clean up timeout when view is destroyed
+    text_view.signal_connect("destroy") do
+      if timeout_id = @view_timeouts.delete(text_view.object_id)
+        begin
+          GLib::Source.remove(timeout_id)
+        rescue StandardError
+          nil
+        end
+      end
+    end
+
+    scroll.add(text_view)
+    scroll
+  end
+
+  def create_ansi_tags(buffer)
+    # Basic ANSI colors
+    {
+      "31" => "#ff6b6b", # Brighter red
+      "32" => "#87ff87", # Brighter green
+      "33" => "#ffff87", # Brighter yellow
+      "34" => "#87d7ff", # Brighter blue
+      "35" => "#ff87ff", # Brighter magenta
+      "36" => "#87ffff", # Brighter cyan
+      "37" => "#ffffff" # White
+    }.each do |code, color|
+      buffer.create_tag("ansi_#{code}", foreground: color)
+    end
+
+    # Add more tags for bold, etc
+    buffer.create_tag("bold", weight: :bold)
+  end
+
+  def update_log_view(text_view, buffer)
+    return if buffer.empty? || text_view.nil? || !text_view.visible?
+    return unless text_view.parent&.visible?
+
+    text_view.buffer.text = ""
+    iter = text_view.buffer.get_iter_at(offset: 0)
+
+    buffer.each do |line|
+      # Parse ANSI sequences
+      segments = line.scan(/\e\[([0-9;]*)m([^\e]*)|\e\[K([^\e]*)|([^\e]+)/)
+
+      segments.each do |codes, text, clear_line, plain|
+        if codes
+          codes
+            .split(";")
+            .each do |code|
+              case code
+              when "1"
+                text_view.buffer.apply_tag("bold", iter, iter)
+              when "31".."37"
+                text_view.buffer.apply_tag("ansi_#{code}", iter, iter)
+              end
+            end
+          text_view.buffer.insert(iter, text)
+        elsif clear_line
+          text_view.buffer.insert(iter, clear_line)
+        else
+          text_view.buffer.insert(iter, plain || "")
+        end
+      end
+    end
+
+    # Scroll to bottom if near bottom
+    if text_view&.parent&.vadjustment
+      adj = text_view.parent.vadjustment
+      if adj.value >= adj.upper - adj.page_size - 50
+        adj.value = adj.upper - adj.page_size
+      end
+    end
+  end
+
+  def create_status_label(text, running)
+    box = Gtk::Box.new(:horizontal, 5)
+    label = Gtk::Label.new(text)
+    status = Gtk::Label.new
+    color =
+      (
+        if running
+          Gdk::RGBA.new(0.2, 0.8, 0.2, 1)
+        else
+          Gdk::RGBA.new(0.8, 0.2, 0.2, 1)
+        end
+      )
+    status.override_color(:normal, color)
+    status.text = running ? "●" : "○"
+    box.pack_start(label, expand: false, fill: false, padding: 0)
+    box.pack_start(status, expand: false, fill: false, padding: 0)
+    box.show_all
+    box
+  end
+
+  def update_tab_labels
+    return unless @notebook
+    @ember_label.children[1].text = @ember_running ? "●" : "○"
+    @ember_label.children[1].override_color(
+      :normal,
+      Gdk::RGBA.new(
+        @ember_running ? 0.2 : 0.8,
+        @ember_running ? 0.8 : 0.2,
+        0.2,
+        1
+      )
+    )
+
+    @unicorn_label.children[1].text = @unicorn_running ? "●" : "○"
+    @unicorn_label.children[1].override_color(
+      :normal,
+      Gdk::RGBA.new(
+        @unicorn_running ? 0.2 : 0.8,
+        @unicorn_running ? 0.8 : 0.2,
+        0.2,
+        1
+      )
+    )
+  end
+
+  def save_window_geometry
+    return unless @status_window&.visible? && @status_window.window
+
+    x, y = @status_window.position
+    width, height = @status_window.size
+
+    self.class.save_config(
+      path: @discourse_path,
+      window_geometry: {
+        "x" => x,
+        "y" => y,
+        "width" => width,
+        "height" => height
+      }
+    )
+  end
+
+  def set_icon(status)
+    icon_file = status == :running ? "discourse_running.png" : "discourse.png"
+    icon_path = File.join(File.dirname(__FILE__), "../../assets", icon_file)
+    @indicator.pixbuf = GdkPixbuf::Pixbuf.new(file: icon_path)
+  end
+
+  def run
+    Gtk.main
+  end
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: discourse-systray
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sam Saffron
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-01-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gtk3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !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: A GTK3 system tray application that helps manage local Discourse development
+  instances
+email:
+- sam.saffron@gmail.com
+executables:
+- discourse-systray
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- assets/circle.png
+- assets/discourse.png
+- assets/discourse_running.png
+- assets/play.png
+- bin/discourse-systray
+- lib/discourse_systray/systray.rb
+homepage: https://github.com/SamSaffron/discourse-systray
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/SamSaffron/discourse-systray
+  source_code_uri: https://github.com/SamSaffron/discourse-systray
+post_install_message:
+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.5.22
+signing_key:
+specification_version: 4
+summary: System tray application for managing Discourse development
+test_files: []