sqdash 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6331093df3973dab4ab641090a1065e284147718c0475f104f831553b6ce106
-  data.tar.gz: 974aada0730279565ca8c7f24d9bc79d644052c960af4fe98725d0b771e9f9a3
+  metadata.gz: dbf32880457e6d0e0ee135bdedcd9c4011bcf4a446c195eaa18a296e2afc20c6
+  data.tar.gz: e1dfaf39989e034e60c48932dc7a0599d0c3a1b42db79b7058e49b7325450f64
 SHA512:
-  metadata.gz: 85d9f93d466ef2731a851c34375a6675b9e94a965752614a730825593f2641168e3cf522b2ca82338b235a7346b9e5df88391866fef1598c5892e1eb67a553ce
-  data.tar.gz: bfe3cfe773ea0cca2aa708ffd87c216012d93985d91eaef90784be752e5d529b5d5a52f3ede55d4dc818a905da54e7b1c34acc138009b32db3ff1d631ae8d584
+  metadata.gz: bf714d16853aab1ccdf74e756dfdb0477b459903fa5c6f20d8984673946562cb693c3f51bde983882a8add79107d44ecdce7fb872e7f49a1c63c77b812d1048e
+  data.tar.gz: d06062de2d0d589685e015b8da084414460c38b9688069cf0b73ba2973704f6d33606cc3e1df7a609acea3ccd0fb8b5f9985a41e53d41055a16debf062838046

data/README.md

@@ -13,6 +13,7 @@ Solid Queue is the default Active Job backend in Rails 8, but it ships with no b
 - Retry or discard failed jobs with a single keypress
 - k9s-style `:` command bar with Tab autocomplete
 - `/` search with inline autocomplete hints
+- Job detail view with arguments, timestamps, and error backtraces
 
 ## Installation
 
@@ -42,6 +43,11 @@ gem install sqlite3  # SQLite
 
 ## Usage
 
+```bash
+sqdash --help       # Show usage and keybindings
+sqdash --version    # Show version
+```
+
 ```bash
 # PostgreSQL
 sqdash postgres://user:pass@localhost:5432/myapp_queue
@@ -67,6 +73,7 @@ Connection priority: **CLI argument** > **`DATABASE_URL` env var** > **built-in
 | Key | Action |
 |-----|--------|
 | `↑` `↓` | Navigate job list |
+| `Enter` | Open job detail view |
 | `/` | Filter jobs (fuzzy search across all columns) |
 | `:` | Command bar (sort, switch views) |
 | `Tab` | Autocomplete (in filter or command mode) |

data/lib/sqdash/cli.rb

@@ -7,6 +7,39 @@ module Sqdash
   class CLI
     DEFAULT_DB_URL = "postgres://sqd:sqd@localhost:5432/sqd_web_development_queue"
 
+    HELP_TEXT = <<~HELP
+      Usage: sqdash [database-url]
+
+      A terminal dashboard for Rails 8's Solid Queue.
+
+      Arguments:
+        database-url    Database connection URL (optional)
+                        Defaults to $DATABASE_URL or a local dev database
+
+      Options:
+        -h, --help      Show this help message
+        -v, --version   Show version
+
+      Keybindings:
+        ↑/↓             Navigate job list
+        Enter            View job details
+        /                Filter jobs (by class, queue, or ID)
+        :                Command mode (sort, view)
+        r                Retry failed job
+        d                Discard failed job
+        Space            Refresh data
+        q                Quit
+
+      Commands (in : mode):
+        sort created|id asc|desc    Sort jobs
+        view all|failed|completed|pending    Filter by status
+
+      Examples:
+        sqdash
+        sqdash postgres://user:pass@host:5432/myapp_production
+        DATABASE_URL=postgres://... sqdash
+    HELP
+
     COMMANDS = {
       "sort" => {
         "created" => ["asc", "desc"],
@@ -21,6 +54,14 @@ module Sqdash
     }.freeze
 
     def self.start
+      case ARGV[0]
+      when "-h", "--help"
+        puts HELP_TEXT
+        exit
+      when "-v", "--version"
+        puts "sqdash #{Sqdash::VERSION}"
+        exit
+      end
       new.run
     end
 
@@ -93,10 +134,14 @@ module Sqdash
 
     def terminal_height
       $stdout.winsize[0]
+    rescue
+      24
     end
 
     def terminal_width
       $stdout.winsize[1]
+    rescue
+      80
     end
 
     def visible_rows
@@ -251,8 +296,14 @@ module Sqdash
         end
       end
 
-      # Clear remaining rows
-      (rows - visible_jobs.length).times { puts "\e[K" }
+      # Empty state
+      if visible_jobs.empty?
+        puts "  \e[90mNo jobs found\e[0m\e[K"
+        (rows - 1).times { puts "\e[K" }
+      else
+        # Clear remaining rows
+        (rows - visible_jobs.length).times { puts "\e[K" }
+      end
 
       # Scrollbar hint
       puts "\e[90m#{"─" * w}\e[0m"
@@ -635,11 +686,15 @@ module Sqdash
       lines << ""
 
       lines << "\e[1mArguments:\e[0m"
-      begin
-        args = JSON.parse(job.arguments)
-        JSON.pretty_generate(args).each_line { |l| lines << "  #{l.chomp}" }
-      rescue JSON::ParserError
-        lines << "  #{job.arguments}"
+      if job.arguments.nil? || job.arguments.empty?
+        lines << "  —"
+      else
+        begin
+          args = JSON.parse(job.arguments)
+          JSON.pretty_generate(args).each_line { |l| lines << "  #{l.chomp}" }
+        rescue JSON::ParserError, TypeError
+          lines << "  #{job.arguments}"
+        end
       end
 
       if status == :failed && job.failed_execution

data/lib/sqdash/database.rb

@@ -15,8 +15,10 @@ module Sqdash
       require_adapter!(url)
       ActiveRecord::Base.establish_connection(url)
       ActiveRecord::Base.connection
-    rescue ActiveRecord::ConnectionNotEstablished => e
-      abort "\e[31mFailed to connect to database: #{e.message}\e[0m"
+    rescue => e
+      abort "\e[31mFailed to connect: #{e.message}\e[0m\n\n" \
+            "Usage: sqdash <database-url>\n" \
+            "Run sqdash --help for details."
     end
 
     def self.require_adapter!(url)

data/lib/sqdash/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sqdash
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqdash
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Nuha
@@ -52,7 +52,6 @@ licenses:
 metadata:
   homepage_uri: https://github.com/nuhasami/sqdash
   source_code_uri: https://github.com/nuhasami/sqdash
-  changelog_uri: https://github.com/nuhasami/sqdash/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: