prremote 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46762e433d6de80bfe8f614bbdd3ee25fdbf976a235d69b3aecfe2039bd180f8
-  data.tar.gz: bcff6b310ed0056d0298a6511cdefe9ffb77aadbcbf0522a379b62d6e3fcc872
+  metadata.gz: 45e633df22e18c19d4c78f58c93580d3f8bfee065806067415004220b50957d2
+  data.tar.gz: 291cfe851b01f38dad3d6bb10a827713d247b5ff0b8942043cbb2d2a57f40038
 SHA512:
-  metadata.gz: 9ad10419ea1caafefbdbbeaf803dc80d2a39caf148d0ad545f069661acd46010ba45eecba4c1325235b06d0e43d8cc695bc042e03906d48a820fd6c14b658f53
-  data.tar.gz: 40ba90421406056fdde9b2849b46a849bd6d642c00784c14f03b62ce12e09724d343b61d89eb97d6d9a035350f1dbd445b253cefe602a5faacc56698df36ff4c
+  metadata.gz: 1f1af87f2ae1c9b72ad86dbf14d7a8cc05a94078c9913cafa294bea45c71844baf3bfad804cbb3a9c5cc3bf726866695b8d4685eb658906e35ebaba9181e46e0
+  data.tar.gz: 4cf41d9ea379ba497d70c648100c907c7a51cdd452034a7fead5ba0a2d3021e60d5817f9fcaaa84b7254cd49cf7b4634a030af56f9228a9312b54c9284f33822

data/README.md

@@ -69,27 +69,34 @@ Put the device into BOOTSEL mode (hold BOOTSEL, connect USB, release) when promp
 
 ---
 
-### `run FILE`
+### `run FILE [FILE ...]`
 
-Compile a local `.rb` file to mruby bytecode and run it on the device immediately (one-shot).
+Compile one or more local `.rb` files to mruby bytecode and run them on the device immediately (one-shot).
 
 ```bash
 prremote run app.rb
 prremote run blink.rb --port /dev/tty.usbmodem101
 ```
 
+Multiple files are compiled in order into a single `.mrb`. Classes and methods defined in earlier files are available to later ones — this is the recommended alternative to `require`, which is not available in mruby/c.
+
+```bash
+prremote run lib.rb main.rb
+```
+
 The device responds with `RUNNING`, streams any output, then `DONE`.
 
 You can find some examples in [test/samples](test/samples/).
 
 ---
 
-### `deploy FILE`
+### `deploy FILE [FILE ...]`
 
-Compile a local `.rb` file and save it to the device's flash. The script runs automatically on every boot.
+Compile one or more local `.rb` files and save them to the device's flash. The script runs automatically on every boot.
 
 ```bash
 prremote deploy app.rb
+prremote deploy lib.rb main.rb
 ```
 
 The device responds with `DEPLOYED` when the write is complete.
@@ -127,15 +134,16 @@ prremote reset
 
 ---
 
-### `watch FILE`
+### `watch FILE [FILE ...]`
 
-Watch a local file for changes and automatically re-run it on the device on every save.
+Watch one or more local files for changes and automatically re-run them on the device on every save.
 
 ```bash
 prremote watch app.rb
+prremote watch lib.rb main.rb
 ```
 
-Useful during development — save your file and the device immediately runs the updated code.
+Useful during development — save any watched file and the device immediately runs the updated code.
 
 ---
 
@@ -155,9 +163,9 @@ Show the gem version, mrbc version, and the connected device's runtime version.
 
 ```bash
 prremote version
-# prremote: 0.1.1
-# mrbc:     3.3.0 (/usr/local/bin/mrbc)
-# runtime:  0.1.3
+# prremote: 0.1.6
+# runtime:  0.1.6 (/dev/tty.usbmodem101)
+# mrbc: mruby 4.0.0 (2026-04-20) (/opt/homebrew/bin/mrbc)
 ```
 
 ---

data/VERSION

@@ -1 +1 @@
-0.1.4
+0.1.6

data/lib/prremote/cli.rb

@@ -7,6 +7,7 @@ require_relative 'runtime_manager'
 require_relative 'commands/install'
 require_relative 'commands/deploy'
 require_relative 'commands/undeploy'
+require_relative 'commands/ls'
 require_relative 'commands/run'
 require_relative 'commands/eval_cmd'
 require_relative 'commands/watch'
@@ -37,19 +38,31 @@ module Prremote
       raise Thor::Error, e.message
     end
 
-    desc 'run FILE', 'Compile and run a Ruby script on the device (one-shot)'
-    def run_script(file)
+    desc 'run FILE [FILE ...]', 'Compile and run Ruby scripts on the device (one-shot)'
+    def run_script(*files)
+      raise Thor::Error, 'At least one file is required.' if files.empty?
+
       port = resolve_port
-      Commands::Run.new(port: port, baud: options[:baud]).call(file)
+      Commands::Run.new(port: port, baud: options[:baud]).call(*files)
     rescue StandardError => e
       raise Thor::Error, e.message
     end
     map 'run' => :run_script
 
-    desc 'deploy FILE', 'Compile and save a Ruby script to flash (auto-runs on boot)'
-    def deploy(file)
+    desc 'deploy FILE [FILE ...]', 'Compile and save Ruby scripts to flash (auto-runs on boot)'
+    def deploy(*files)
+      raise Thor::Error, 'At least one file is required.' if files.empty?
+
       port = resolve_port
-      Commands::Deploy.new(port: port, baud: options[:baud]).call(file)
+      Commands::Deploy.new(port: port, baud: options[:baud]).call(*files)
+    rescue StandardError => e
+      raise Thor::Error, e.message
+    end
+
+    desc 'ls', 'Show the script deployed to flash (use `reset` first if a script is running)'
+    def ls
+      port = resolve_port
+      Commands::Ls.new(port: port, baud: options[:baud]).call
     rescue StandardError => e
       raise Thor::Error, e.message
     end
@@ -70,10 +83,12 @@ module Prremote
       raise Thor::Error, e.message
     end
 
-    desc 'watch FILE', 'Watch a Ruby file for changes and re-run on the device automatically'
-    def watch(file)
+    desc 'watch FILE [FILE ...]', 'Watch Ruby files for changes and re-run on the device automatically'
+    def watch(*files)
+      raise Thor::Error, 'At least one file is required.' if files.empty?
+
       port = resolve_port
-      Commands::Watch.new(port: port, baud: options[:baud]).call(file)
+      Commands::Watch.new(port: port, baud: options[:baud]).call(*files)
     rescue StandardError => e
       raise Thor::Error, e.message
     end
@@ -116,7 +131,6 @@ module Prremote
       rescue StandardError => e
         puts "mrbc:     (#{e.message})"
       end
-
     end
 
     private

data/lib/prremote/commands/deploy.rb

@@ -1,34 +1,38 @@
 require 'open3'
 require 'tempfile'
 require_relative '../mrbc'
+require_relative 'serial_helpers'
 
 module Prremote
   module Commands
     class Deploy
+      include SerialHelpers
+
       DEPLOY_MAGIC = 'DPLY'.freeze
+      META_MAGIC   = 'META'.freeze
 
       def initialize(port:, baud:)
         @port = port
         @baud = baud
       end
 
-      def call(rb_path)
-        raise "File not found: #{rb_path}" unless File.exist?(rb_path)
+      def call(*rb_paths)
+        rb_paths.each { |f| raise "File not found: #{f}" unless File.exist?(f) }
 
-        warn "Compiling #{rb_path}..."
-        mrb_data = compile(rb_path)
+        warn "Compiling #{rb_paths.map { |f| File.basename(f) }.join(', ')}..."
+        mrb_data = compile(*rb_paths)
 
         warn 'Deploying to flash...'
-        deploy_to_device(mrb_data)
+        deploy_to_device(mrb_data, rb_paths)
         warn 'Deployed. Script will run automatically on next boot.'
       end
 
       private
 
-      def compile(rb_path)
+      def compile(*rb_paths)
         Mrbc.check_version!
         tmp = Tempfile.new(['prremote', '.mrb'])
-        out, status = Open3.capture2e(Mrbc.bin, '-o', tmp.path, rb_path)
+        out, status = Open3.capture2e(Mrbc.bin, '-o', tmp.path, *rb_paths)
         raise "mrbc failed:\n#{out.chomp}" unless status.success?
 
         File.binread(tmp.path)
@@ -36,19 +40,23 @@ module Prremote
         tmp&.close!
       end
 
-      def deploy_to_device(mrb_data)
+      def deploy_to_device(mrb_data, rb_paths)
         serial = Serial.new(@port, @baud)
-        sleep 0.5
-        serial.read(4096)
-
-        serial.write(DEPLOY_MAGIC + mrb_data)
-        debug "sent DPLY + #{mrb_data.bytesize} bytes"
-
+        wait_for_ready(serial)
+        serial.write(DEPLOY_MAGIC + build_meta_packet(rb_paths) + mrb_data)
         wait_for_deployed(serial)
       ensure
         serial&.close
       end
 
+      def build_meta_packet(rb_paths)
+        names_bytes = rb_paths.map { |f| File.basename(f) }.join(' ').encode('UTF-8').b
+        name_len    = [names_bytes.bytesize, 240].min
+        ts          = Time.now.to_i
+        debug "meta: #{name_len} bytes, ts=#{ts}"
+        META_MAGIC + [name_len].pack('C') + names_bytes[0, name_len] + [ts].pack('N')
+      end
+
       def wait_for_deployed(serial)
         buf = +''
         deadline = Time.now + 30
@@ -64,10 +72,6 @@ module Prremote
         end
       end
 
-      def normalize(str)
-        str.gsub("\r\n", "\n").gsub("\r", '')
-      end
-
       def debug(msg)
         warn "[debug] #{msg}" if ENV['PRREMOTE_DEBUG']
       end

data/lib/prremote/commands/ls.rb

@@ -0,0 +1,61 @@
+require_relative 'serial_helpers'
+
+module Prremote
+  module Commands
+    class Ls
+      include SerialHelpers
+
+      QUERY_MAGIC = 'QURY'.freeze
+
+      def initialize(port:, baud:)
+        @port = port
+        @baud = baud
+      end
+
+      def call
+        result = query_device
+        if result
+          ts_str = if result[:timestamp].positive?
+                     Time.at(result[:timestamp]).strftime('%Y-%m-%d %H:%M:%S')
+                   else
+                     '(unknown)'
+                   end
+          puts 'Deployed script:'
+          puts "  Files:    #{result[:names]}"
+          puts "  Deployed: #{ts_str}"
+        else
+          puts 'No script deployed.'
+        end
+      end
+
+      private
+
+      def query_device
+        serial = Serial.new(@port, @baud)
+        wait_for_ready(serial)
+        serial.write(QUERY_MAGIC)
+
+        buf = +''
+        deadline = Time.now + 5
+        loop do
+          chunk = normalize(serial.read(256) || '')
+          buf << chunk
+
+          if (m = buf.match(/^DEPLOYED (\d+) (.+)\n/))
+            return { timestamp: m[1].to_i, names: m[2].strip }
+          end
+          return nil if buf.include?("NONE\n")
+
+          if Time.now > deadline
+            raise 'Timeout waiting for device response. ' \
+                  'If a script is running, use `prremote reset` first.'
+          end
+
+          sleep 0.05
+        end
+      ensure
+        serial&.close
+      end
+    end
+  end
+end

data/lib/prremote/commands/run.rb

@@ -1,31 +1,36 @@
 require 'open3'
 require 'tempfile'
 require_relative '../mrbc'
+require_relative 'serial_helpers'
 
 module Prremote
   module Commands
     class Run
+      include SerialHelpers
+
       def initialize(port:, baud:)
         @port = port
         @baud = baud
       end
 
-      def call(rb_path)
-        raise "File not found: #{rb_path}" unless File.exist?(rb_path)
+      def call(*rb_paths)
+        rb_paths.each { |f| raise "File not found: #{f}" unless File.exist?(f) }
 
-        warn "Compiling #{rb_path}..."
-        mrb_data = compile(rb_path)
+        warn "Compiling #{rb_paths.map { |f| File.basename(f) }.join(', ')}..."
+        mrb_data = compile(*rb_paths)
 
         warn 'Running...'
         run_on_device(mrb_data)
+      rescue Interrupt
+        warn ''
       end
 
       private
 
-      def compile(rb_path)
+      def compile(*rb_paths)
         Mrbc.check_version!
         tmp = Tempfile.new(['prremote', '.mrb'])
-        out, status = Open3.capture2e(Mrbc.bin, '-o', tmp.path, rb_path)
+        out, status = Open3.capture2e(Mrbc.bin, '-o', tmp.path, *rb_paths)
         raise "mrbc failed:\n#{out.chomp}" unless status.success?
 
         File.binread(tmp.path)
@@ -35,15 +40,17 @@ module Prremote
 
       def run_on_device(mrb_data)
         serial = Serial.new(@port, @baud)
-        sleep 0.5
-        drained = serial.read(4096) || ''
-        debug "drained #{drained.bytesize} bytes: #{drained.inspect}"
+        wait_for_ready(serial)
 
         serial.write(mrb_data)
         debug "sent #{mrb_data.bytesize} bytes (first 4: #{mrb_data[0, 4].inspect})"
 
         post_running = wait_for_running(serial)
         stream_until_done(serial, post_running)
+      rescue Interrupt
+        serial&.write("\x03")
+        sleep 0.1
+        raise
       ensure
         serial&.close
       end
@@ -91,10 +98,6 @@ module Prremote
         end
       end
 
-      def normalize(str)
-        str.gsub("\r\n", "\n").gsub("\r", '')
-      end
-
       def debug(msg)
         warn "[debug] #{msg}" if ENV['PRREMOTE_DEBUG']
       end

data/lib/prremote/commands/serial_helpers.rb

@@ -0,0 +1,27 @@
+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 ')
+          raise 'Timeout waiting for device. Run `prremote reset` if a script is running.' if Time.now > deadline
+
+          sleep 0.05
+        end
+      end
+
+      def normalize(str)
+        str.gsub("\r\n", "\n").gsub("\r", '')
+      end
+    end
+  end
+end

data/lib/prremote/commands/watch.rb

@@ -10,21 +10,22 @@ module Prremote
         @baud = baud
       end
 
-      def call(rb_path)
-        raise "File not found: #{rb_path}" unless File.exist?(rb_path)
+      def call(*rb_paths)
+        rb_paths.each { |f| raise "File not found: #{f}" unless File.exist?(f) }
 
-        warn "Watching #{rb_path} (Ctrl+C to stop)..."
-        last_mtime = File.mtime(rb_path)
-        run(rb_path)
+        label = rb_paths.map { |f| File.basename(f) }.join(', ')
+        warn "Watching #{label} (Ctrl+C to stop)..."
+        mtimes = rb_paths.map { |f| File.mtime(f) }
+        run(*rb_paths)
 
         loop do
           sleep POLL_INTERVAL
-          mtime = File.mtime(rb_path)
-          next if mtime == last_mtime
+          new_mtimes = rb_paths.map { |f| File.mtime(f) }
+          next if new_mtimes == mtimes
 
-          last_mtime = mtime
-          warn "\n--- #{rb_path} changed, re-running ---"
-          run(rb_path)
+          mtimes = new_mtimes
+          warn "\n--- #{label} changed, re-running ---"
+          run(*rb_paths)
         end
       rescue Interrupt
         warn "\nStopped watching."
@@ -32,8 +33,8 @@ module Prremote
 
       private
 
-      def run(rb_path)
-        Run.new(port: @port, baud: @baud).call(rb_path)
+      def run(*rb_paths)
+        Run.new(port: @port, baud: @baud).call(*rb_paths)
       rescue StandardError => e
         warn "Error: #{e.message}"
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prremote
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - ITO Yosei
@@ -110,7 +110,9 @@ files:
 - lib/prremote/commands/deploy.rb
 - lib/prremote/commands/eval_cmd.rb
 - lib/prremote/commands/install.rb
+- lib/prremote/commands/ls.rb
 - lib/prremote/commands/run.rb
+- lib/prremote/commands/serial_helpers.rb
 - lib/prremote/commands/undeploy.rb
 - lib/prremote/commands/watch.rb
 - lib/prremote/detector.rb