tempest-rb 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 828dcb07d7565737bbe9b37ef7ca876fe6136dd7aaf308df43ec8c8fac9be825
-  data.tar.gz: 3a32fde6e7693ba99acea0482875cc9919e8e4969dd201404edeeb9e01d89193
+  metadata.gz: 2312e8eb343bf518ce61de53a97608a42ece28af9777501910d864e9e2f79f1f
+  data.tar.gz: 05063b25a45e82fbcb7051f93f6af1715e0c2e25f7cfeefdbf343b3d5f4877ed
 SHA512:
-  metadata.gz: 8eb5b81c5d05843c461fcf2352b8be5351e95dbb4eebd1359ba0c2ee2380400de36bd627fab9d96db685f44bb80cf39c3c914c1183ee895481f33d7d9b3a4b84
-  data.tar.gz: 1b16bd98ef48212760133e3b87bb877a9f3a7c0e1044a86f541219cf32871fad921d88074ac7ca52e1c42ed69b5f8d1fedbd5f7e762d4d3c21d22c45be88ad3c
+  metadata.gz: 8eb2f34c4c3e7dcb851976b4f7ad502edfb57784661dd06ed0792eaef9f1344ef65dee5a1b05f63c51859aa84d9412f23b5714cde1d65a08360dac549245e98f
+  data.tar.gz: 23d4f50ec5dab93b6d792009103f78a56df3fa7019bd1266866ff582a55db1e5831f72376ef2949c3bb4cf029a68c1faf1b3f68ea60cb4ea627507924ece146d

data/README.md

@@ -113,6 +113,7 @@ If you have been using a single-account installation of an earlier `tempest` rel
 |------------------|--------------------------------------------------|
 | `:timeline`      | Fetch and print the home timeline                |
 | `:stream on/off` | Toggle the Jetstream live feed                   |
+| `:compose`       | Open your editor to compose a multi-line post    |
 | `:open $LX`      | Open the URL with id `$LX` in the browser        |
 | `:help`          | Show in-app help                                 |
 | `:quit`          | Exit (`Ctrl-D` works too)                        |
@@ -120,6 +121,8 @@ If you have been using a single-account installation of an earlier `tempest` rel
 
 Anything else you type is sent as a new post.
 
+`:compose` hands the terminal over to your editor so you can write a longer post without fighting the single-line prompt. The editor is picked from `$VISUAL`, then `$EDITOR`, and falls back to `vi`. Lines that start with `#` are treated as comments and stripped; save with an empty body to cancel. Remember to `export` the variable in your shell rc (`export EDITOR=nvim`) — without `export`, the value is not inherited by child processes and the fallback to `vi` kicks in.
+
 Each post in the timeline is prefixed with a short `$XX` id, and URLs found inside posts get their own `$LX` ids. Use those ids with `$XX <text>` to reply or `:open $LX` to open a link. Like and repost events show the subject post's `$XX` id in trailing brackets (for example `liked @bob's post [$AA]`) whenever the original post is still in the session registry, so you can reply to it directly.
 
 ### CLI options

data/lib/tempest/commands/tui.rb

@@ -87,10 +87,12 @@ module Tempest
           cursor_store: cursor_store(env, did: target_did),
           filter: plan.filter,
           logger: debug_logger,
+          did: target_did,
         )
         watchdog = Tempest::Jetstream::Watchdog.new(
           stream_manager: stream_manager,
           logger: debug_logger,
+          did: target_did,
           **watchdog_options(env),
         )
 

data/lib/tempest/debug_log.rb

@@ -127,8 +127,9 @@ module Tempest
     class Channel
       attr_reader :loggers
 
-      def initialize(loggers:)
+      def initialize(loggers:, defaults: {})
         @loggers = Array(loggers)
+        @defaults = defaults.freeze
       end
 
       def info(mod, event:, **fields)
@@ -147,6 +148,15 @@ module Tempest
         emit(Logger::ERROR, mod, event, fields)
       end
 
+      # Returns a child channel that prepends `default_fields` to every
+      # subsequent log call. Used to attach per-session context such as `did=`
+      # to long-lived components (StreamManager, Watchdog) without sprinkling
+      # the field across every call site.
+      def with(**default_fields)
+        return self if default_fields.empty?
+        Channel.new(loggers: @loggers, defaults: @defaults.merge(default_fields))
+      end
+
       def close
         @loggers.each do |logger|
           begin
@@ -162,7 +172,8 @@ module Tempest
 
       def emit(level, mod, event, fields)
         return if @loggers.empty?
-        msg = format_body(event, fields)
+        merged = @defaults.merge(fields)
+        msg = format_body(event, merged)
         @loggers.each { |logger| logger.add(level, msg, mod) }
       end
 

data/lib/tempest/jetstream/stream_manager.rb

@@ -25,7 +25,7 @@ module Tempest
       def initialize(client:, backoff: DEFAULT_BACKOFF, sleeper: ->(s) { sleep(s) },
                      clock: -> { Time.now }, cursor_store: nil,
                      cursor_save_interval: DEFAULT_CURSOR_SAVE_INTERVAL,
-                     filter: nil, logger: nil)
+                     filter: nil, logger: nil, did: nil)
         @client = client
         @backoff = backoff
         @sleeper = sleeper
@@ -33,7 +33,8 @@ module Tempest
         @cursor_store = cursor_store
         @cursor_save_interval = cursor_save_interval
         @filter = filter
-        @logger = logger || Tempest::DebugLog.null_channel
+        base = logger || Tempest::DebugLog.null_channel
+        @logger = did ? base.with(did: did) : base
         @thread = nil
         @mutex = Mutex.new
         @stopping = false

data/lib/tempest/jetstream/watchdog.rb

@@ -25,13 +25,14 @@ module Tempest
                      interval_seconds: DEFAULT_INTERVAL_SECONDS,
                      clock: -> { Time.now },
                      sleeper: ->(s) { sleep(s) },
-                     logger: nil)
+                     logger: nil, did: nil)
         @stream_manager = stream_manager
         @threshold_seconds = threshold_seconds
         @interval_seconds = interval_seconds
         @clock = clock
         @sleeper = sleeper
-        @logger = logger || Tempest::DebugLog.null_channel
+        base = logger || Tempest::DebugLog.null_channel
+        @logger = did ? base.with(did: did) : base
         @thread = nil
         @mutex = Mutex.new
         @stopping = false

data/lib/tempest/repl/compose.rb

@@ -0,0 +1,77 @@
+require "tempfile"
+
+require_relative "../../tempest"
+
+module Tempest
+  module REPL
+    # Opens `$VISUAL` / `$EDITOR` on a scratch file so the user can compose a
+    # multi-line post in their normal editor, the same pattern `git commit`
+    # uses. Returns one of the status tuples below; the caller (typically
+    # `Runner#handle_compose`) maps each to a user-facing line and, when
+    # `:ok`, forwards the body to `Post.create`.
+    #
+    # Return values:
+    #   [:ok, body]            successful compose; body is non-empty
+    #   [:empty, nil]          user saved an empty body — treat as cancellation
+    #   [:editor_failed, nil]  the editor subprocess returned a non-zero status
+    #
+    # Lines beginning with `#` are stripped from the file before posting (so we
+    # can pre-populate the file with instructions a la `git commit`'s template).
+    module Compose
+      TEMPLATE = <<~EOT.freeze
+
+        # Compose your Bluesky post above this line.
+        # Lines starting with `#` and surrounding whitespace are stripped.
+        # Save with an empty body (or quit without changes) to cancel.
+      EOT
+
+      module_function
+
+      def run(env: ENV, runner: Kernel.method(:system),
+              tempfile_factory: ->(suffix) { Tempfile.new(["tempest-compose-", suffix]) })
+        editor = pick_editor(env)
+
+        file = tempfile_factory.call(".txt")
+        path = file.path
+        begin
+          file.write(TEMPLATE)
+          file.flush
+          file.close
+
+          ok = runner.call(editor, path)
+          return [:editor_failed, nil] unless ok
+
+          body = parse(File.read(path))
+          return [:empty, nil] if body.empty?
+          [:ok, body]
+        ensure
+          begin
+            file.unlink
+          rescue StandardError
+            # File may already be gone (e.g. editor moved it); best-effort.
+          end
+        end
+      end
+
+      # Editor resolution order, matching git's convention: $VISUAL, then
+      # $EDITOR, then "vi" as a POSIX-mandated last resort. The fallback means
+      # we never need to surface a "no editor" error to the user; if even vi
+      # cannot be exec'd, `Kernel.system` returns false and the call surfaces
+      # as :editor_failed.
+      def pick_editor(env)
+        candidate = env["VISUAL"]
+        candidate = env["EDITOR"] if candidate.nil? || candidate.strip.empty?
+        candidate = "vi" if candidate.nil? || candidate.strip.empty?
+        candidate
+      end
+
+      def parse(content)
+        content
+          .each_line
+          .reject { |line| line.start_with?("#") }
+          .join
+          .strip
+      end
+    end
+  end
+end

data/lib/tempest/repl/dispatcher.rb

@@ -5,7 +5,7 @@ module Tempest
     Command = Data.define(:name, :args)
 
     class Dispatcher
-      KNOWN_COMMANDS = %i[timeline quit help stream open relogin fav].freeze
+      KNOWN_COMMANDS = %i[timeline quit help stream open relogin fav compose].freeze
       DOLLAR_ID = /\A\$[A-Z]{2}\z/.freeze
 
       def dispatch(input)

data/lib/tempest/repl/runner.rb

@@ -4,6 +4,7 @@ require_relative "../../tempest"
 require_relative "../timeline"
 require_relative "../post"
 require_relative "../jetstream/stream_manager"
+require_relative "compose"
 require_relative "dispatcher"
 require_relative "formatter"
 require_relative "registry"
@@ -17,6 +18,7 @@ module Tempest
         Available commands:
           :timeline       Fetch and print the home timeline
           :stream on|off  Toggle the Jetstream live feed
+          :compose        Open $EDITOR to write a multi-line post
           :open $XX|$LX   Open the post or URL with the given id in the browser
           :fav $XX        Like the post with id $XX
           :relogin        Re-authenticate when the cached session is dead
@@ -35,7 +37,7 @@ module Tempest
       def initialize(session:, client:, input:, output:, dispatcher: Dispatcher.new,
                      stream_manager: nil, handle_resolver: nil, stream_output: nil,
                      timeline_store: nil, registry: Registry.new, opener: DEFAULT_OPENER,
-                     avatar_store: nil, reauth: nil)
+                     avatar_store: nil, reauth: nil, compose: Compose.method(:run))
         @session = session
         @client = client
         @input = input
@@ -49,6 +51,7 @@ module Tempest
         @opener = opener
         @avatar_store = avatar_store
         @reauth = reauth
+        @compose = compose
         # URIs already printed via bootstrap_timeline or backfill_timeline.
         # Jetstream's cursor-replay can re-emit those same posts on startup
         # (the persisted cursor is older than the getTimeline window), so the
@@ -105,6 +108,8 @@ module Tempest
             handle_stream(command.args.first)
           when :post
             handle_post(command.args.first)
+          when :compose
+            handle_compose
           when :reply
             handle_reply(command.args[0], command.args[1])
           when :open
@@ -148,6 +153,30 @@ module Tempest
         @output.puts "error: #{e.message}"
       end
 
+      def handle_compose
+        # Hand the terminal off to $EDITOR for the duration of the compose so
+        # the editor can take full control of the screen. We re-park the
+        # Screen on return regardless of success or exception.
+        suspend_screen do
+          status, body = @compose.call
+          case status
+          when :ok
+            handle_post(body)
+          when :empty
+            @output.puts "compose cancelled (empty body)"
+          when :editor_failed
+            @output.puts "editor exited with a non-zero status; post not sent"
+          end
+        end
+      end
+
+      def suspend_screen
+        @output.suspend if @output.respond_to?(:suspend)
+        yield
+      ensure
+        @output.resume if @output.respond_to?(:resume)
+      end
+
       def handle_relogin
         if @reauth.nil?
           @output.puts "relogin is not available in this session"

data/lib/tempest/repl/screen.rb

@@ -46,6 +46,26 @@ module Tempest
         @enabled = false
       end
 
+      # Transient teardown for handing the terminal off to a subprocess (e.g.
+      # $EDITOR via `:compose`). Unlike `disable`, this does NOT issue the
+      # Kitty graphics delete sequence — terminals that support the Kitty
+      # protocol keep image placements in the main screen buffer even while
+      # the editor draws on the alternate buffer, so suspending without
+      # deleting lets the avatars re-appear automatically when the editor
+      # exits. Pair with `resume` to re-establish the scrolling region.
+      def suspend
+        return unless @enabled
+        uninstall_resize_trap
+        @io.print "\e[r"
+        @io.flush if @io.respond_to?(:flush)
+        @enabled = false
+      end
+
+      def resume
+        return if @enabled
+        enable
+      end
+
       def enabled?
         @enabled
       end

data/lib/tempest/version.rb

@@ -1,3 +1,3 @@
 module Tempest
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tempest-rb
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Yuya Fujiwara
@@ -128,6 +128,7 @@ files:
 - lib/tempest/post.rb
 - lib/tempest/post_view.rb
 - lib/tempest/repl/async_output.rb
+- lib/tempest/repl/compose.rb
 - lib/tempest/repl/dispatcher.rb
 - lib/tempest/repl/formatter.rb
 - lib/tempest/repl/registry.rb