onlylogs 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e6b4ee2fde339a248ff9e15557c8bb8f0ea525b3807aa09b157e537057c0c7a
-  data.tar.gz: 208543eb460dc3f7c302fac4d4bd3277c710e402346f759c7e66c1b2dfc7049b
+  metadata.gz: 9303c9ba4c727343d48702332baef85d112068f0639a148ff42afc8693b1f7af
+  data.tar.gz: 82fe3f9d70cfc3b2d4a6f661a296974037aca9fd8bd8e97317476bb091d3c320
 SHA512:
-  metadata.gz: 4b47a580f758cacca9c34b1de0ebe445ff4db5df1e45f6e515cd80b1dd866d3dbbb39d7aea7862b94ee46e5d18cd39797fbadcb202e59745bcb94fb0a62da2b7
-  data.tar.gz: 8956f328a31a63cbf07a180a51ffa612c516f51ae37523bba49f6a41557a14ae35a83d91bc1bcc05b465bedd6cbc61cbffb8a402822a27b17d534668acd65211
+  metadata.gz: d7bf3497e6013d367776e50e716d113781cdde78b79d302b01a126778092aa36fb0f025c93162301b4f9444d9be83bd30ebd2b832d3e3e5da29d6ed721bd6138
+  data.tar.gz: 879705e6eb4dafe29e1bf1698495cfb0731ccefc13f3127547a45173e4fdc6beda4ea53c13b4406ae6c3d1ba10ffe36f3b2f21bf1a7e3ff17adf195b5161170f

data/README.md

@@ -235,7 +235,7 @@ end
 
 Onlylogs automatically detects file paths in log messages and converts them into clickable links that open in your preferred code editor.
 
-For a complete list of supported editors, see [lib/onlylogs/editor_detector.rb](lib/onlylogs/editor_detector.rb).
+For a complete list of supported editors, see [app/models/onlylogs/file_path_parser.rb](app/models/onlylogs/file_path_parser.rb).
 
 ```bash
 # env variables
@@ -272,6 +272,22 @@ Onlylogs.configure do |config|
 end
 ```
 
+#### Bounding How Long a Viewer Search Can Run
+
+Searches started from the log viewer stop after `search_timeout` seconds, keeping whatever they
+found and reporting that they did not reach the end of the file. The default is 120 seconds:
+
+```ruby
+# config/initializers/onlylogs.rb
+Onlylogs.configure do |config|
+  config.search_timeout = 300
+
+  # Or remove the ceiling entirely (a search then holds a CPU until it reaches
+  # the end of the file, however large it is)
+  config.search_timeout = nil
+end
+```
+
 ### Filtering Log Lines with a Denylist
 
 The `Onlylogs::Formatter` supports a denylist: an array of regular expressions that prevents matching lines from being logged. This is useful for filtering out noisy or irrelevant entries like health checks or asset requests.
@@ -324,6 +340,16 @@ bin/continuous_log_writer 10 3
 
 The script will write logs to `test/dummy/log/development.log`, which will appear in real-time in the onlylogs UI at `http://localhost:3000/onlylogs`. 
 
+The lines are generated by `Onlylogs::ContinuousLogWriter`, in the same format a Rails app logging through `Onlylogs::Logger` produces. The script is a thin wrapper, so applications embedding onlylogs can reuse the writer against any file of their own:
+
+```ruby
+require "onlylogs/continuous_log_writer"
+
+Onlylogs::ContinuousLogWriter.new(some_log_path, logs_per_batch: 3, interval: 1).call
+```
+
+It is plain Ruby (it does not need Rails to be booted) and is not loaded by `require "onlylogs"` — require it explicitly where you need it.
+
 **Example workflow:**
 
 ```bash

data/app/channels/onlylogs/logs_channel.rb

@@ -16,27 +16,8 @@ module Onlylogs
       @last_initialize_params = data.dup
       cleanup_existing_operations
 
-      # Decrypt and verify the file path
-      begin
-        encrypted_file_path = data["file_path"]
-        if encrypted_file_path.present?
-          file_path = Onlylogs::SecureFilePath.decrypt(encrypted_file_path)
-
-          # Verify the decrypted path is still allowed
-          unless Onlylogs.file_path_permitted?(file_path)
-            Rails.logger.error "Onlylogs: Attempted to access non-allowed file: #{file_path}"
-            transmit({action: "error", content: "Access denied"})
-            return
-          end
-        else
-          # Fallback to default if no encrypted path provided
-          file_path = Onlylogs.default_log_file_path
-        end
-      rescue Onlylogs::SecureFilePath::SecurityError => e
-        Rails.logger.error "Onlylogs: Security violation - #{e.message}"
-        transmit({action: "error", content: "Access denied"})
-        return
-      end
+      file_path = authorized_file_path(data["file_path"])
+      return unless file_path
 
       # Check if the file is a text file
       unless Onlylogs::File.text_file?(file_path)
@@ -72,6 +53,32 @@ module Onlylogs
 
     private
 
+    # Decrypts and authorises the requested file. Returns nil (after transmitting
+    # an error) when there is no token, when it cannot be decrypted, or when the
+    # decrypted path is not on the configured allow-list — the three ways a client
+    # can ask for something it is not entitled to stream.
+    def authorized_file_path(encrypted_file_path)
+      if encrypted_file_path.blank?
+        Rails.logger.error "Onlylogs: initialize_watcher without a file path token; refusing to stream"
+        transmit({action: "error", content: "Access denied"})
+        return nil
+      end
+
+      file_path = Onlylogs::SecureFilePath.decrypt(encrypted_file_path)
+
+      unless Onlylogs.file_path_permitted?(file_path)
+        Rails.logger.error "Onlylogs: Attempted to access non-allowed file: #{file_path}"
+        transmit({action: "error", content: "Access denied"})
+        return nil
+      end
+
+      file_path
+    rescue Onlylogs::SecureFilePath::SecurityError => e
+      Rails.logger.error "Onlylogs: Security violation - #{e.message}"
+      transmit({action: "error", content: "Access denied"})
+      nil
+    end
+
     def cleanup_existing_operations
       if @batch_sender
         @batch_sender.stop(send_remaining_lines: false)
@@ -168,55 +175,18 @@ module Onlylogs
         last_byte_offset = nil
         line_count = 0
 
-        Rails.logger.silence(Logger::ERROR) do
-          skip_first = start_position > 0
-
-          if filter.present?
-            # Use grep for filtered search
-            @log_file.grep(filter, regexp_mode: regexp_mode, start_position: start_position, end_position: end_position) do |result|
-              break if @batch_sender.nil? || @log_watcher_running == false
-
-              # Skip first line if start_position > 0 (line is cut off at byte boundary)
-              if skip_first
-                skip_first = false
-                next
-              end
-
-              # Result is a hash with {byte_offset, content}
-              byte_offset = result[:byte_offset]
-              log_line = result[:content]
+        show_expand_button = filter.present?
 
-              # Buffer previous line and skip it to avoid cut-off lines at boundaries
-              if last_line
-                @batch_sender.add_line(render_log_line(last_line, byte_offset: last_byte_offset, show_expand_button: true))
-                line_count += 1
-              end
-              last_line = log_line
-              last_byte_offset = byte_offset
-            end
-          else
-            # No filter - read all lines directly (skip grep)
-            # Still need byte_offset for highlighting when expanding around a line
-            current_byte_offset = start_position
-            read_byte_range(file_path, start_position, end_position) do |log_line|
-              break if @batch_sender.nil? || @log_watcher_running == false
-
-              # Skip first line if start_position > 0 (line is cut off at byte boundary)
-              if skip_first
-                skip_first = false
-                next
-              end
-
-              # Buffer previous line and skip it to avoid cut-off lines at boundaries
-              if last_line
-                @batch_sender.add_line(render_log_line(last_line, byte_offset: last_byte_offset))
-                line_count += 1
-              end
-              last_line = log_line
-              last_byte_offset = current_byte_offset
-              # Account for line content plus newline character (2 bytes for \r\n or 1 for \n)
-              current_byte_offset += log_line.bytesize + 1
+        Rails.logger.silence(Logger::ERROR) do
+          each_matching_line(file_path, filter, regexp_mode, start_position, end_position) do |log_line, byte_offset|
+            # Buffer previous line and skip it to avoid cut-off lines at boundaries
+            if last_line
+              @batch_sender.add_line(render_log_line(last_line, byte_offset: last_byte_offset,
+                show_expand_button: show_expand_button))
+              line_count += 1
             end
+            last_line = log_line
+            last_byte_offset = byte_offset
           end
         end
 
@@ -234,6 +204,11 @@ module Onlylogs
         else
           transmit({action: "finish", content: "Search finished."})
         end
+      rescue Onlylogs::Grep::TimeoutError
+        @batch_sender&.stop
+        transmit({action: "finish",
+                  content: "Search stopped after #{Onlylogs.search_timeout} seconds and did not reach " \
+                           "the end of the file. Narrow the range or the filter and search again."})
       ensure
         # Always cleanup even if interrupted or error occurs
         @batch_sender&.stop
@@ -243,6 +218,49 @@ module Onlylogs
       end
     end
 
+    # Yields [line, byte_offset] over the requested slice: through grep when there
+    # is a filter, straight off disk when there is not. Either way the offsets are
+    # the real ones, so "show around this line" can re-centre on them.
+    #
+    # A range that starts mid-line opens with a fragment of a line, which is
+    # dropped - but its bytes still count towards every offset after it.
+    def each_matching_line(file_path, filter, regexp_mode, start_position, end_position)
+      skip_first = start_position > 0
+
+      if filter.present?
+        @log_file.grep(filter, regexp_mode: regexp_mode, start_position: start_position,
+          end_position: end_position, timeout: Onlylogs.search_timeout) do |result|
+          break if reading_stopped?
+
+          if skip_first
+            skip_first = false
+            next
+          end
+
+          yield result[:content], result[:byte_offset]
+        end
+      else
+        offset = start_position
+
+        read_byte_range(file_path, start_position, end_position) do |log_line, raw_bytesize|
+          break if reading_stopped?
+
+          if skip_first
+            skip_first = false
+            offset += raw_bytesize
+            next
+          end
+
+          yield log_line, offset
+          offset += raw_bytesize
+        end
+      end
+    end
+
+    def reading_stopped?
+      @batch_sender.nil? || @log_watcher_running == false
+    end
+
     def read_byte_range(file_path, start_position, end_position)
       file_size = ::File.size(file_path)
       range_size = (end_position || file_size) - start_position
@@ -250,7 +268,7 @@ module Onlylogs
       return if start_position < 0 || range_size <= 0 || start_position >= file_size
 
       ::File.read(file_path, range_size, start_position).each_line do |line|
-        yield line.chomp
+        yield line.chomp, line.bytesize
       end
     rescue => e
       Rails.logger.error "Error reading byte range: #{e.message}"

data/app/javascript/onlylogs/controllers/keyboard_shortcuts_controller.js

@@ -1,7 +1,7 @@
 import { Controller } from "@hotwired/stimulus"
 
 export default class KeyboardShortcutsController extends Controller {
-  static targets = ["liveMode", "autoscroll"]
+  static targets = ["liveButton", "searchButton", "autoscroll"]
 
   connect() {
     this.boundHandleKeydown = this.handleKeydown.bind(this)
@@ -13,15 +13,25 @@ export default class KeyboardShortcutsController extends Controller {
   }
 
   handleKeydown(event) {
+    // These are bare single-key shortcuts. Any modifier means the keystroke belongs
+    // to the browser or the OS (cmd+L, cmd+A, cmd+S) and must pass straight through.
+    if (event.metaKey || event.ctrlKey || event.altKey) {
+      return
+    }
+
     // Only handle shortcuts when not typing in input fields
-    if (event.target.tagName === 'INPUT' || event.target.tagName === 'TEXTAREA') {
+    if (event.target.tagName === 'INPUT' || event.target.tagName === 'TEXTAREA' || event.target.isContentEditable) {
       return
     }
 
     switch (event.key.toLowerCase()) {
       case 'l':
         event.preventDefault()
-        this.toggleLiveMode()
+        if (this.hasLiveButtonTarget) this.liveButtonTarget.click()
+        break
+      case 's':
+        event.preventDefault()
+        if (this.hasSearchButtonTarget) this.searchButtonTarget.click()
         break
       case 'a':
         event.preventDefault()
@@ -30,15 +40,9 @@ export default class KeyboardShortcutsController extends Controller {
     }
   }
 
-  toggleLiveMode() {
-    if (this.hasLiveModeTarget) {
-      this.liveModeTarget.checked = !this.liveModeTarget.checked
-      this.liveModeTarget.dispatchEvent(new Event('change', { bubbles: true }))
-    }
-  }
-
   toggleAutoscroll() {
-    if (this.hasAutoscrollTarget) {
+    // Autoscroll only exists while live; ignore the shortcut when it is not on screen.
+    if (this.hasAutoscrollTarget && this.autoscrollTarget.offsetParent !== null) {
       this.autoscrollTarget.checked = !this.autoscrollTarget.checked
       this.autoscrollTarget.dispatchEvent(new Event('change', { bubbles: true }))
     }