prremote 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5d636b2157c9ef1ede45b69b9df264da77cb142529f0c93d0857e23cb681bca
-  data.tar.gz: e2683165f9b9c91ab1c063295eb06fa3c04b062ab8fbe7f2b574b3dc1593dfe5
+  metadata.gz: b55c090d4bddcdac18b7a1166429af025eeecc0416e31dedf51f248b4d2cd975
+  data.tar.gz: c81096a50e22d31064a8f721daca2de89dcfc5ccbb6e6c9d2d3fb58973c85ac0
 SHA512:
-  metadata.gz: 57617c04aa3320602e05f2f3080c4abad1cbc2639ad3a2c1017f90747ff3c5653b588280984cc0a617e0560072059ae89bb2389a460e172cfe41bb926b5589ec
-  data.tar.gz: 16c446180dda99c3a61a80145281cad1732321aa94016e260c6e05fba30775f874cfad3b8e3ea945cb5cc3aff0079b6beb9751fa4c2d349213966fc6bdda2511
+  metadata.gz: 8d959c616f0205f2e63f9ba8eba7d96f66943822e1e59be4dc41cb58aed070fabe816ff1473a6cbee7057bdc19533274dbf8c0c2a5e04924d354bcaae54653db
+  data.tar.gz: 9a1fd33542e02a7a97f0e0a9d9626e3f688d80cf3027ff975de58e2159defc90fa3880a9611cb35b125359c7fc8d36ed3708e517673e16795ac3e8cb6a1d566a

data/README.md

@@ -163,8 +163,8 @@ Show the gem version, mrbc version, and the connected device's runtime version.
 
 ```bash
 prremote version
-# prremote: 0.1.5
-# runtime:  0.1.5 (/dev/tty.usbmodem101)
+# prremote: 0.1.7
+# runtime:  0.1.7 (/dev/tty.usbmodem101)
 # mrbc: mruby 4.0.0 (2026-04-20) (/opt/homebrew/bin/mrbc)
 ```
 
@@ -213,6 +213,40 @@ Scripts saved via `deploy` are stored in flash and run automatically on every bo
 
 ---
 
+## Development
+
+### Clone
+
+This repository uses Git submodules (mruby/c, picoruby, pico-sdk, etc.).
+Clone with:
+
+```bash
+git clone --recurse-submodules https://github.com/lumbermill/prremote.git
+```
+
+If you already cloned without `--recurse-submodules`:
+
+```bash
+git submodule update --init --recursive
+```
+
+### Build the runtime firmware
+
+Requires the ARM cross-compiler (`arm-none-eabi-gcc`) and CMake.
+
+```bash
+cd runtime/
+rake cache   # build UF2 for pico and picow → ~/.prremote/runtime/
+```
+
+### Run the tests
+
+```bash
+bundle exec rake test
+```
+
+---
+
 ## License
 
 [MIT License](LICENSE)

data/VERSION

@@ -1 +1 @@
-0.1.5
+0.1.7

data/lib/prremote/commands/deploy.rb

@@ -61,7 +61,7 @@ module Prremote
         buf = +''
         deadline = Time.now + 30
         loop do
-          chunk = normalize(serial.read(256) || '')
+          chunk = normalize(safe_read(serial, 256))
           buf << chunk unless chunk.empty?
 
           return if buf.include?("DEPLOYED\n")

data/lib/prremote/commands/run.rb

@@ -48,7 +48,7 @@ module Prremote
         post_running = wait_for_running(serial)
         stream_until_done(serial, post_running)
       rescue Interrupt
-        serial&.write("\x03")
+        serial&.write("\x03") rescue nil
         sleep 0.1
         raise
       ensure
@@ -59,7 +59,7 @@ module Prremote
         buf = +''
         deadline = Time.now + 10
         loop do
-          chunk = normalize(serial.read(256) || '')
+          chunk = normalize(safe_read(serial, 256))
           unless chunk.empty?
             debug "recv: #{chunk.inspect}"
             buf << chunk
@@ -79,7 +79,7 @@ module Prremote
       def stream_until_done(serial, initial = +'')
         buf = initial
         loop do
-          buf << normalize(serial.read(256) || '')
+          buf << normalize(safe_read(serial, 256))
 
           if (done_pos = buf.index("DONE\n"))
             $stdout.print buf[0, done_pos] unless done_pos.zero?
@@ -87,11 +87,11 @@ module Prremote
             return
           end
 
-          if buf.length > 512
-            safe = buf.length - 5
-            $stdout.print buf[0, safe]
+          # Flush on newline boundaries so each puts line appears immediately.
+          if (nl_pos = buf.rindex("\n"))
+            $stdout.print buf[0, nl_pos + 1]
             $stdout.flush
-            buf = buf[safe..]
+            buf = buf[(nl_pos + 1)..]
           end
 
           sleep 0.01

data/lib/prremote/commands/serial_helpers.rb

@@ -2,11 +2,20 @@ module Prremote
   module Commands
     module SerialHelpers
       def wait_for_ready(serial)
+        # On macOS, USB CDC TX buffers can be dropped when the host reopens the port,
+        # leaving the device stuck in getchar() without re-sending READY.
+        # Sending Ctrl+C forces the device to restart its READY loop.
+        sleep 0.1
+        serial.write("\x03") rescue nil
+
         buf = +''
         deadline = Time.now + 10
         loop do
-          buf << normalize(serial.read(256) || '')
-          return if buf.include?('READY ')
+          buf << normalize(safe_read(serial, 256))
+          if buf.include?('READY ')
+            warn_if_runtime_outdated(buf)
+            return
+          end
           raise 'Timeout waiting for device. Run `prremote reset` if a script is running.' if Time.now > deadline
 
           sleep 0.05
@@ -16,6 +25,29 @@ module Prremote
       def normalize(str)
         str.gsub("\r\n", "\n").gsub("\r", '')
       end
+
+      # Wraps serial.read so that a device disconnect (e.g. ENXIO on macOS when
+      # the Pico resets) surfaces as a human-readable error instead of a bare errno name.
+      def safe_read(serial, size)
+        serial.read(size) || ''
+      rescue RubySerial::Error => e
+        raise "Device disconnected (#{e.message}). Run `prremote reset` if the device is unresponsive."
+      end
+
+      private
+
+      def warn_if_runtime_outdated(buf)
+        m = buf.match(/READY prremote-runtime\/(\S+)/)
+        return unless m
+
+        runtime_ver = Gem::Version.new(m[1])
+        gem_ver     = Gem::Version.new(Prremote::VERSION)
+        return unless runtime_ver < gem_ver
+
+        warn "WARNING: runtime version #{m[1]} is older than prremote #{Prremote::VERSION}. Run `prremote install` to update."
+      rescue ArgumentError
+        # ignore unparseable version strings
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prremote
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - ITO Yosei