rpremote 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccf42c1aa0428ee4996626537122a820d94aac064a8bd40e15defb4b31c76901
-  data.tar.gz: f7d7ac9163993a8c8075861bb750ebda0ba9031f9c4393be77be93428eae5d2d
+  metadata.gz: 8dfb50a1e7d831a80c938b09c267d0ffa38bbcba43c9c0d870d2bfd594fe5502
+  data.tar.gz: af28f94924f0d121960a32f58dda68d3927d02b69d8d7cf13ce1680307ecf36f
 SHA512:
-  metadata.gz: 01e9ec8f0d4df3d3979903eea9c823bbd8224432c9b6ab246737f499ddb096e908fa2a613d92cddbffa7c53dd5163ceaf22e9c1e50c8f3d664ea5aeae3ae1ff3
-  data.tar.gz: ec02c4c3bb3b1bd28c51b56fb63895d48bac3afcc5c5211308be1f5112d161e175d5710aaa3ebdce24ff31104bc3569a2e49e5af7c3d712903b62444f7abdd12
+  metadata.gz: 0d9cbfdb48f779fdd0075e3712dac31a7ec815cc96b9779144b05a5970a24e8ee39ed7994eca120f55b248617173455ad951c8a431a0d3feb29a336b6be51875
+  data.tar.gz: e9a4d8a3aaf6de6a88adeac72ed27b880665a33621499c9ce062ea404bdd594361e08bc3a4d646dfbac48c50526046acdf24ef4d97895cff95d376a6fe62cf81

data/CHANGELOG.md

@@ -2,23 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
-## Unreleased
+## 0.2.0 - 2026-08-26
 
-## [0.1.0] - 2026-08-24
+- Make `run` and `exec` exit nonzero when compatible R2P2 firmware reports a Ruby exception, while preserving real-time program output.
+- Increase the default command timeout from 10 to 20 seconds.
+- Add a bilingual education example for practical PicoModem DFU application updates, startup confirmation, and A/B-slot rollback.
 
-- Add `setup`, `build`, and RP2350 BOOTSEL `flash` commands for custom
-  PicoRuby R2P2 firmware on Raspberry Pi Pico 2 and Pico 2 W.
-- Add target configuration for language, language version, board, cache,
-  firmware path, serial port, and timeouts, with command-line precedence.
-- Add `Mrbgems` and `Mrbgems.lock` support for reproducible public and local
-  mrbgems, including automatic regeneration of PicoRuby build output when a
-  custom mrbgem changes.
-- Add PicoModem DFU staging, status, compatible bytecode compilation, and
-  A/B-slot rollback support for Ruby and `.mrb` applications.
-- Add binary-safe file transfer and remote filesystem commands, plus `run`,
-  `exec`, `monitor`, `repl`, and reset with reconnect waiting.
+## 0.1.0 - 2026-08-24
+
+- Add `setup`, `build`, and RP2350 BOOTSEL `flash` commands for custom PicoRuby R2P2 firmware on Raspberry Pi Pico 2 and Pico 2 W.
+- Add target configuration for language, language version, board, cache, firmware path, serial port, and timeouts, with command-line precedence.
+- Add `Mrbgems` and `Mrbgems.lock` support for reproducible public and local mrbgems, including automatic regeneration of PicoRuby build output when a custom mrbgem changes.
+- Add PicoModem DFU staging, status, compatible bytecode compilation, and A/B-slot rollback support for Ruby and `.mrb` applications.
+- Add binary-safe file transfer and remote filesystem commands, plus `run`, `exec`, `monitor`, `repl`, and reset with reconnect waiting.
 - Add macOS R2P2 serial-port detection for Raspberry Pi Pico 2 and Pico 2 W.
-- Add bilingual repository, package, configuration, firmware, mrbgem, DFU,
-  and electronic-craft example documentation.
-- Add RBS signatures, automated tests, macOS CI, and release validation with
-  isolated gem installation and CLI smoke testing.
+- Add bilingual repository, package, configuration, firmware, mrbgem, DFU, and electronic-craft example documentation.
+- Add RBS signatures, automated tests, macOS CI, and release validation with isolated gem installation and CLI smoke testing.
+
+### Limitations
+
+- rpremote currently supports PicoRuby only.
+- Supported boards are Raspberry Pi Pico 2 and Pico 2 W; serial commands currently require macOS.
+- `rpremote run` and `exec` are temporary R2P2 executions, not persistent deployments. Use `build` and `flash` to replace firmware.
+- PicoModem DFU updates only the boot application. Changes to PicoRuby, R2P2, or embedded mrbgems require rebuilding and flashing a UF2.
+- DFU retains the complete application in RAM before writing flash. Verify available memory, bytecode compatibility, boot confirmation, and rollback on target hardware.

data/README.ja.md

@@ -1,12 +1,10 @@
-# rpremote
+# rpremote CLIリファレンス
 
 [English](README.md)
 
-Raspberry Pi Pico向けのカスタムPicoRuby R2P2ファームウェアを準備、ビルド、
-書き込み、操作するためのコマンドラインツールです。
+Raspberry Pi Pico向けのカスタムPicoRuby R2P2ファームウェアを準備、ビルド、書き込み、操作するためのコマンドラインツールです。
 
-公開mrbgemとローカルmrbgemを再現可能なファームウェアへ組み込み、生成したUF2の
-BOOTSEL書き込み、R2P2経由のバイナリ安全なファイル転送とRuby実行を行えます。
+公開mrbgemとローカルmrbgemを再現可能なファームウェアへ組み込み、生成したUF2のBOOTSEL書き込み、R2P2経由のバイナリ安全なファイル転送とRuby実行を行えます。
 
 ## 必要環境
 
@@ -32,9 +30,7 @@ rpremote flash --mount /Volumes/RP2350
 rpremote run main.rb
 ```
 
-既定では`firmware/picoruby-4.0.3/`にソースを準備し、
-`firmware/picoruby-4.0.3-pico2.uf2`を生成します。対象ボードを明示する必要がある
-場合は、`rpremote ports`でR2P2のCDC 0ポートを確認してください。
+既定では`firmware/picoruby-4.0.3/`にソースを準備し、`firmware/picoruby-4.0.3-pico2.uf2`を生成します。対象ボードを明示する必要がある場合は、`rpremote ports`でR2P2のCDC 0ポートを確認してください。
 
 ## mrbgemを追加する
 
@@ -42,7 +38,6 @@ rpremote run main.rb
 
 ```ruby
 vm :mrubyc
-
 gem github: "ksbmyk/picoruby-ws2812-plus", branch: "main"
 gem path: "../mrbgems/my-device"
 ```
@@ -55,21 +50,17 @@ rpremote mrbgems lock
 rpremote build
 ```
 
-`Mrbgems.lock`はGitHubのcommitとローカルgemの内容hashを固定します。`build`は
-既存lockを再利用し、`rpremote mrbgems update`だけが新しいcommitを解決します。
+`Mrbgems.lock`はGitHubのコミットとローカルgemの内容ハッシュを固定します。`build`は既存のlockを再利用し、`rpremote mrbgems update`だけが新しいコミットを解決します。
 
 ## 対象を選択する
 
 ```sh
 rpremote setup --language picoruby --language-version 3.4.2
 rpremote build --language picoruby --language-version 3.4.2 --board pico2
-rpremote flash --language picoruby --language-version 3.4.2 --board pico2 \
-  --mount /Volumes/RP2350
+rpremote flash --language picoruby --language-version 3.4.2 --board pico2 --mount /Volumes/RP2350
 ```
 
-コマンドラインオプションは`config/setting.json`より優先されます。現在実装されて
-いるのはPicoRubyです。将来のMicroPythonと追加Picoボード対応に備え、
-`language`と`board`はインターフェースに残しています。
+コマンドラインオプションは`config/setting.json`より優先されます。現在実装されているのはPicoRubyです。将来のMicroPythonと追加Picoボード対応に備え、`language`と`board`はインターフェースに残しています。
 
 ## コマンド
 
@@ -82,41 +73,60 @@ rpremote flash --language picoruby --language-version 3.4.2 --board pico2 \
 | `rpremote dfu compile FILE` | DFU用にPicoRuby版と一致する`.mrb`を生成します。 |
 | `rpremote dfu status` | DFUのアクティブおよび起動候補スロットを表示します。 |
 | `rpremote mrbgems …` | mrbgemを検査、表示、固定、更新します。 |
-| `rpremote flash` | 選択したUF2をBOOTSEL経由で書き込む。 |
+| `rpremote flash` | 選択したUF2をBOOTSEL経由で書き込みます。 |
+| `rpremote config show` | 設定ファイルとコマンドラインオプションを反映した実効設定を表示します。 |
 | `rpremote ports` | R2P2シリアルポートを表示します。 |
-| `rpremote run FILE` | Rubyファイルを転送して実行します。 |
-| `rpremote exec CODE` | 短いRubyコードを実行します。 |
-| `rpremote monitor` / `repl` | 対話型シリアルセッションを開く。 |
-| `rpremote reset` | R2P2を再起動して再接続まで待つ。 |
+| `rpremote run FILE` | Rubyファイルを転送して実行し、出力をリアルタイム表示します。Ruby例外時は非0で終了します。 |
+| `rpremote exec CODE` | 短いRubyコードを実行します。Ruby例外時は非0で終了します。 |
+| `rpremote monitor` / `repl` | 対話型シリアルセッションを開きます。 |
+| `rpremote reset` | R2P2を再起動して再接続まで待ちます。 |
 | `rpremote fs cp/cat/ls/rm/mkdir` | R2P2ファイルシステムを操作します。 |
 
-完全な構文は`rpremote --help`で確認できます。`monitor`と`repl`は`Ctrl-]`で
-終了します。
+コマンド一覧は`rpremote --help`で確認できます。コマンド固有の構文、既定値、影響は`rpremote <command> --help`で確認できます。
+
+```sh
+rpremote flash --help
+rpremote dfu app --help
+```
+
+`monitor`と`repl`は`Ctrl-]`で終了します。
+
+`run`と`exec`の例外終了コードには、Ruby例外ステータスに対応したR2P2ファームウェアが必要です。[GitHubリポジトリ](https://github.com/ogom/rpremote)のPicoRubyソースから`rpremote build`で生成したUF2が対応しています。
+
+## 操作モデル
+
+- `run`と`exec`はRubyコードを一時的に転送・実行して出力を表示し、一時リモートファイルを削除します。対応するR2P2ファームウェアがRuby例外を報告した場合は、非0で終了します。
+- `flash`はUF2をRP2350 BOOTSELボリュームへコピーし、永続的なR2P2ファームウェアを置き換えます。
+- `dfu app`はRubyソースまたは対応するバイトコードのアプリを非アクティブDFUスロットへ登録します。R2P2を再起動して試行し、正常に起動したアプリは`DFU.confirm`を呼び出します。
+- リモートパスには`:/REMOTE/PATH`を使います。`fs cp`はローカルパスとリモートパスの間で転送し、`fs rm`は指定したリモートパスを完全に削除します。
 
 ## ドキュメントとサンプル
 
-[GitHubリポジトリ](https://github.com/ogom/rpremote)に、英語・日本語のガイド、
-設定リファレンス、Mrbgems.lockの解説、カスタムファームウェア手順、電子工作
-サンプルがあります。
+[GitHubリポジトリ](https://github.com/ogom/rpremote)に、英語・日本語のガイド、設定リファレンス、Mrbgems.lockの解説、カスタムファームウェア手順、電子工作サンプルがあります。
 
 ## 関連プロジェクト
 
-- [mbremote](https://github.com/ogom/mbremote)は、BBC micro:bit向けの
-  MicroPython／PicoRubyプロジェクトをビルド、書き込み、操作する、同じコンセプトの
-  ツールです。
+- [mbremote](https://github.com/ogom/mbremote)は、BBC micro:bit向けのMicroPython／PicoRubyプロジェクトをビルド、書き込み、操作する、同じコンセプトのツールです。
 
 ## 開発
 
+依存gemを導入して、テスト、静的解析、RBSを検証します。
+
 ```sh
 bundle install
 bundle exec rake
 bundle exec rbs -I sig validate
 ```
 
-公開前は`bundle exec rake release:check`を実行し、
-[RELEASING.md](RELEASING.md)に従ってください。
+変更したローカル版を試すときは、次を実行します。ネットワークへ接続せずにgemをビルドし、現在のRuby環境へインストールします。
+
+```sh
+bundle exec rake install:local
+rpremote --version
+```
+
+リリースする版は`lib/rpremote/version.rb`と`CHANGELOG.md`を更新します。公開前は`bundle exec rake release:check`を実行し、[RELEASING.md](RELEASING.md)に従ってください。
 
 ## ライセンス
 
-[MIT](LICENSE)です。外部ソフトウェアについては
-[第三者ソフトウェアに関する通知](THIRD_PARTY_NOTICES.md)を参照してください。
+[MIT](LICENSE)です。外部ソフトウェアについては[第三者ソフトウェアに関する通知](THIRD_PARTY_NOTICES.md)を参照してください。

data/README.md

@@ -1,13 +1,10 @@
-# rpremote
+# rpremote CLI reference
 
 [日本語](README.ja.md)
 
-Command-line tools for preparing, building, flashing, and controlling custom
-PicoRuby R2P2 firmware on Raspberry Pi Pico boards.
+Command-line tools for preparing, building, flashing, and controlling custom PicoRuby R2P2 firmware on Raspberry Pi Pico boards.
 
-rpremote embeds public and local mrbgems in reproducible firmware, flashes the
-generated UF2 through BOOTSEL, and provides binary-safe file transfer and Ruby
-execution through R2P2.
+rpremote embeds public and local mrbgems in reproducible firmware, flashes the generated UF2 through BOOTSEL, and provides binary-safe file transfer and Ruby execution through R2P2.
 
 ## Requirements
 
@@ -33,9 +30,7 @@ rpremote flash --mount /Volumes/RP2350
 rpremote run main.rb
 ```
 
-The defaults prepare `firmware/picoruby-4.0.3/` and create
-`firmware/picoruby-4.0.3-pico2.uf2`. Use `rpremote ports` to locate the R2P2
-CDC 0 port when a board must be selected explicitly.
+The defaults prepare `firmware/picoruby-4.0.3/` and create `firmware/picoruby-4.0.3-pico2.uf2`. Use `rpremote ports` to locate the R2P2 CDC 0 port when a board must be selected explicitly.
 
 ## Add mrbgems
 
@@ -43,7 +38,6 @@ Create a project-level `Mrbgems` file. Local paths are relative to that file.
 
 ```ruby
 vm :mrubyc
-
 gem github: "ksbmyk/picoruby-ws2812-plus", branch: "main"
 gem path: "../mrbgems/my-device"
 ```
@@ -56,22 +50,17 @@ rpremote mrbgems lock
 rpremote build
 ```
 
-`Mrbgems.lock` pins GitHub commits and hashes local gem contents. Existing
-locks are reused by `build`; `rpremote mrbgems update` deliberately resolves
-new commits.
+`Mrbgems.lock` pins GitHub commits and hashes local gem contents. Existing locks are reused by `build`; `rpremote mrbgems update` deliberately resolves new commits.
 
 ## Select a target
 
 ```sh
 rpremote setup --language picoruby --language-version 3.4.2
 rpremote build --language picoruby --language-version 3.4.2 --board pico2
-rpremote flash --language picoruby --language-version 3.4.2 --board pico2 \
-  --mount /Volumes/RP2350
+rpremote flash --language picoruby --language-version 3.4.2 --board pico2 --mount /Volumes/RP2350
 ```
 
-Command-line options override `config/setting.json`. PicoRuby is implemented
-today; `language` and `board` are retained for planned MicroPython and
-additional Pico board support.
+Command-line options override `config/setting.json`. PicoRuby is implemented today; `language` and `board` are retained for planned MicroPython and additional Pico board support.
 
 ## Commands
 
@@ -85,40 +74,60 @@ additional Pico board support.
 | `rpremote dfu status` | Show the active and candidate DFU slots. |
 | `rpremote mrbgems …` | Check, list, lock, or update mrbgems. |
 | `rpremote flash` | Flash the selected UF2 through BOOTSEL. |
+| `rpremote config show` | Show the effective configuration after file and command-line options are resolved. |
 | `rpremote ports` | List detected R2P2 serial ports. |
-| `rpremote run FILE` | Upload and run a Ruby file. |
-| `rpremote exec CODE` | Run a short Ruby expression. |
+| `rpremote run FILE` | Upload and run a Ruby file with real-time output; exit nonzero on a Ruby exception. |
+| `rpremote exec CODE` | Run short Ruby code and exit nonzero on a Ruby exception. |
 | `rpremote monitor` / `repl` | Open an interactive serial session. |
 | `rpremote reset` | Reboot R2P2 and wait for reconnection. |
 | `rpremote fs cp/cat/ls/rm/mkdir` | Operate on the R2P2 filesystem. |
 
-Run `rpremote --help` for complete syntax. `monitor` and `repl` exit with
-`Ctrl-]`.
+Run `rpremote --help` for the complete command list. Run `rpremote <command> --help` for command-specific syntax, defaults, and effects.
+
+```sh
+rpremote flash --help
+rpremote dfu app --help
+```
+
+`monitor` and `repl` exit with `Ctrl-]`.
+
+Ruby-exception exit statuses for `run` and `exec` require R2P2 firmware with Ruby exception status support.
+UF2 files built with `rpremote build` from the [GitHub repository](https://github.com/ogom/rpremote) include that support.
+
+## Operation model
+
+- `run` and `exec` upload Ruby code temporarily, relay output, then remove the temporary remote file. A Ruby exception reported by compatible R2P2 firmware makes the command exit nonzero.
+- `flash` copies a UF2 to the RP2350 BOOTSEL volume and replaces persistent R2P2 firmware.
+- `dfu app` stages a Ruby source or matching bytecode app in the inactive DFU slot. Restart R2P2 to try it; a successful app must call `DFU.confirm`.
+- Remote paths use `:/REMOTE/PATH`. `fs cp` transfers between one local and one remote path, and `fs rm` permanently deletes the selected remote path.
 
 ## Documentation and examples
 
-The [GitHub repository](https://github.com/ogom/rpremote) contains the full
-English and Japanese guides, configuration reference, Mrbgems.lock reference,
-custom firmware guide, and electronic-craft examples.
+The [GitHub repository](https://github.com/ogom/rpremote) contains the full English and Japanese guides, configuration reference, Mrbgems.lock reference, custom firmware guide, and electronic-craft examples.
 
 ## Related projects
 
-- [mbremote](https://github.com/ogom/mbremote) is a tool with the same concept
-  for building, flashing, and controlling MicroPython and PicoRuby projects on
-  BBC micro:bit boards.
+- [mbremote](https://github.com/ogom/mbremote) is a tool with the same concept for building, flashing, and controlling MicroPython and PicoRuby projects on BBC micro:bit boards.
 
 ## Development
 
+Install dependencies, then run the test and static checks:
+
 ```sh
 bundle install
 bundle exec rake
 bundle exec rbs -I sig validate
 ```
 
-Before publishing, run `bundle exec rake release:check` and follow
-[RELEASING.md](RELEASING.md).
+To try the local gem without publishing it, install it into the current Ruby environment:
+
+```sh
+bundle exec rake install:local
+rpremote --version
+```
+
+Before publishing, run `bundle exec rake release:check` and follow [RELEASING.md](RELEASING.md).
 
 ## License
 
-[MIT](LICENSE). See [Third-Party Notices](THIRD_PARTY_NOTICES.md) for
-externally downloaded software.
+[MIT](LICENSE). See [Third-Party Notices](THIRD_PARTY_NOTICES.md) for externally downloaded software.

data/RELEASING.md

@@ -1,7 +1,6 @@
 # Releasing rpremote
 
-This checklist prepares and publishes one immutable gem version. Run every
-command from `packages/rpremote`.
+This checklist prepares and publishes one immutable gem version. Run every command from `packages/rpremote`.
 
 ## 1. Prepare the version
 
@@ -10,45 +9,46 @@ command from `packages/rpremote`.
 3. Commit all intended files and verify that `git status --short` is empty.
 4. Run the non-publishing release check:
 
-   ```sh
-   bundle exec rake release:check
-   ```
+```sh
+bundle exec rake release:check
+```
 
-The check runs the specs, RuboCop, and RBS validation; builds the gem; checks
-its metadata and packaged documentation; installs it into a temporary isolated
-gem directory; and executes the installed `rpremote --version` command.
+The check runs the specs, RuboCop, and RBS validation; builds the gem; checks its metadata and packaged documentation; installs it into a temporary isolated gem directory; and executes the installed `rpremote --version` command.
 
 ## 2. Prepare publishing services
 
-The repository must have an `origin` remote before releasing. Confirm it with:
+The repository must have an `origin` remote and GitHub CLI authentication before releasing. Confirm them with:
 
 ```sh
 git remote -v
+gh auth status
 ```
 
-For the first RubyGems.org release, confirm that the `rpremote` name is
-available and configure either RubyGems MFA for a manual push or a pending
-trusted publisher for GitHub Actions. Never commit an API key or
-`~/.gem/credentials`.
+Choose one publishing route before the first release:
+
+- For a manual release, sign in to RubyGems.org, confirm that the account owns `rpremote`, and enable MFA:
+
+  ```sh
+  gem signin
+  gem owner rpremote
+  ```
+
+- For a GitHub Actions trusted publisher, confirm the RubyGems.org trusted-publisher entry names this repository and workflow before starting the release.
+
+Never commit an API key or `~/.gem/credentials`.
 
 ## 3. Publish deliberately
 
-`bundle exec rake release` is a publishing command: it creates and pushes the
-version tag and pushes the built gem to RubyGems.org. Run it only after the
-release check passes and the working tree is clean:
+`bundle exec rake release` is a publishing command: it creates and pushes the version tag and pushes the built gem to RubyGems.org. It is not a dry run. Run it only after the release check passes and the working tree is clean:
 
 ```sh
 bundle exec rake release
 ```
 
-After the tag exists on GitHub, create a GitHub Release and attach the exact
-gem that passed validation. `--verify-tag` prevents GitHub CLI from silently
-creating a tag at another commit:
+After the tag exists on GitHub, create a GitHub Release and attach the exact gem that passed validation. `--verify-tag` prevents GitHub CLI from silently creating a tag at another commit:
 
 ```sh
-gh release create v0.1.0 rpremote-0.1.0.gem \
-  --verify-tag --generate-notes
+gh release create v0.1.0 rpremote-0.1.0.gem --verify-tag --generate-notes
 ```
 
-Replace `0.1.0` in both places for later versions. Finally, install from
-RubyGems.org in a fresh environment and run `rpremote --version`.
+Replace `0.1.0` in both places for later versions. Finally, install from RubyGems.org in a fresh environment and run `rpremote --version`.

data/THIRD_PARTY_NOTICES.md

@@ -1,8 +1,6 @@
 # Third-Party Notices
 
-`rpremote` does not bundle R2P2 firmware. The `setup` command downloads a
-selected PicoRuby/R2P2 4.0.3 or 3.4.2 release from the PicoRuby project and
-verifies its published SHA-256 digest.
+`rpremote` does not bundle R2P2 firmware. The `setup` command downloads a selected PicoRuby/R2P2 4.0.3 or 3.4.2 release from the PicoRuby project and verifies its published SHA-256 digest.
 
 ## PicoRuby and R2P2
 
@@ -10,20 +8,8 @@ Source: <https://github.com/picoruby/picoruby>
 
 Copyright © 2020 HASUMI Hitoshi
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/rpremote/builder.rb

@@ -4,15 +4,17 @@ require "rbconfig"
 require "fileutils"
 require "rubygems/version"
 require_relative "mrbgems"
+require_relative "picoruby_source_patch"
 
 module Rpremote
   class Builder
     class Error < Rpremote::Error; end
 
-    def initialize(root: Dir.pwd, runner: nil, mrbgems_class: Mrbgems)
+    def initialize(root: Dir.pwd, runner: nil, mrbgems_class: Mrbgems, source_patcher: nil)
       @root = File.expand_path(root)
       @runner = runner || method(:run_command)
       @mrbgems_class = mrbgems_class
+      @source_patcher = source_patcher || method(:patch_source)
     end
 
     def build(output: $stdout, error: $stderr, **options)
@@ -23,6 +25,7 @@ module Rpremote
       Language.validate!(target.language)
 
       source_dir = source_for(target)
+      source_patcher.call(source_dir, target.language_version)
       environment = {
         "RPREMOTE_LANGUAGE" => target.language,
         "RPREMOTE_LANGUAGE_VERSION" => target.language_version,
@@ -61,7 +64,11 @@ module Rpremote
 
     private
 
-    attr_reader :root, :runner, :mrbgems_class
+    attr_reader :root, :runner, :mrbgems_class, :source_patcher
+
+    def patch_source(source, version)
+      PicoRubySourcePatch.new(version: version).apply(source)
+    end
 
     def add_mrbgems_environment!(environment, options, source_dir, output)
       definition = mrbgems_definition(options[:mrbgems])

data/lib/rpremote/cli.rb

@@ -2,6 +2,7 @@
 
 require "optparse"
 require_relative "build_command"
+require_relative "config_show"
 require_relative "dfu_command"
 require_relative "flash_command"
 require_relative "help"
@@ -36,6 +37,8 @@ module Rpremote
       @config_class = config
       @config_filename, config_required = config.extract_option!(args)
       command = args.shift
+      return show_help(command, args) if Help.requested?(command, args)
+
       @config_options = config.load_command(command, filename: config_filename, required: config_required)
       dispatch(command, args)
       0
@@ -46,6 +49,11 @@ module Rpremote
     attr_reader :stdout, :stderr, :serial, :device, :flasher,
                 :config_class, :config_filename, :config_options
 
+    def show_help(command, args)
+      stdout.puts(Help.command_text(command, args))
+      0
+    end
+
     def dispatch(command, args)
       case command
       when nil, "help", "--help", "-h"
@@ -54,6 +62,8 @@ module Rpremote
         stdout.puts(Rpremote::VERSION)
       when "ports"
         ports(args)
+      when "config"
+        config_command(args)
       when "setup", "flash", "build", "dfu", "mrbgems"
         project_command(command, args)
       when "run", "monitor", "repl", "exec", "reset", "fs"
@@ -66,21 +76,13 @@ module Rpremote
     def project_command(command, args)
       case command
       when "setup"
-        SetupCommand.run(
-          args,
-          defaults: config_options,
-          config: config_class,
-          config_filename: config_filename,
-          output: stdout
-        )
+        SetupCommand.run(args, defaults: config_options, config: config_class, config_filename: config_filename, output: stdout)
       when "flash"
         FlashCommand.run(args, defaults: config_options, output: stdout, flasher: flasher)
       when "build"
         BuildCommand.run(args, defaults: config_options, output: stdout, error: stderr)
       when "dfu"
-        DfuCommand.run(
-          args, defaults: config_options, output: stdout, services: { serial: serial, device: device }
-        )
+        DfuCommand.run(args, defaults: config_options, output: stdout, services: { serial: serial, device: device })
       when "mrbgems"
         MrbgemsCommand.run(args, output: stdout)
       end
@@ -108,6 +110,13 @@ module Rpremote
       end
     end
 
+    def config_command(args)
+      subcommand = args.shift
+      raise ArgumentError, "unknown config command: #{subcommand || "(none)"}" unless subcommand == "show"
+
+      ConfigShow.run(args, defaults: config_options, output: stdout)
+    end
+
     def fs(args)
       subcommand = args.shift
       options = parse_connection_options(args)
@@ -129,7 +138,7 @@ module Rpremote
 
       source = args.first
       data = File.binread(source)
-      stdout.write(execute_temporary(data, options))
+      execute_temporary(data, options, output: stdout)
     rescue Errno::ENOENT => e
       raise ArgumentError, e.message
     end
@@ -138,14 +147,15 @@ module Rpremote
       options = parse_connection_options(args)
       raise ArgumentError, "usage: rpremote exec CODE [options]" unless args.length == 1
 
-      stdout.write(execute_temporary(args.first, options))
+      execute_temporary(args.first, options, output: stdout)
     end
 
-    def execute_temporary(data, options)
+    def execute_temporary(data, options, output: nil)
       Language.validate!(options[:language])
       port_path = device.main_port(options[:port])
       serial.open(port_path, baud: options[:baud]) do |port|
-        Runner.new(port, timeout: options[:timeout]).run(data)
+        runner = Runner.new(port, timeout: options[:timeout])
+        output ? runner.run(data, output: output) : runner.run(data)
       end
     end
 
@@ -201,9 +211,7 @@ module Rpremote
       source, destination = args
       source_remote = RemotePath.remote?(source)
       destination_remote = RemotePath.remote?(destination)
-      if source_remote == destination_remote
-        raise ArgumentError, "exactly one cp path must be remote (prefix remote paths with :)"
-      end
+      raise ArgumentError, "exactly one cp path must be remote (prefix remote paths with :)" if source_remote == destination_remote
 
       if source_remote
         data = with_modem(options) { |modem| modem.download(RemotePath.unwrap(source)) }
@@ -230,6 +238,7 @@ module Rpremote
       raise ArgumentError, usage unless args.length == 1
 
       path = RemotePath.validate(args.first)
+      stdout.puts("deleting remote path permanently: #{path}") if command == "rm"
       output = with_shell(options) do |shell|
         shell.execute("#{command} #{Shell.quote_argument(path)}")
       end

data/lib/rpremote/config.rb

@@ -29,6 +29,7 @@ module Rpremote
       "monitor" => %i[port baud timeout],
       "repl" => %i[port baud timeout],
       "fs" => %i[port baud timeout],
+      "config" => OPTION_TYPES.keys,
       "ports" => [],
       "mrbgems" => []
     }.freeze