rufio 0.60.0 → 0.62.0

data/README_ja.md

@@ -0,0 +1,331 @@
+# rufio
+
+**Runtime Unified Flow I/O Operator**
+
+ファイルを起点に、ツールとスクリプトを実行・連携させるTUIファイルマネージャー。
+Ruby/Python/PowerShellに対応し、開発ワークフローを一箇所に統合します。
+
+A TUI file manager as a unified runtime environment for tools and scripts.
+
+**日本語** | [English](./README.md)
+
+## コンセプト
+
+rufioは単なるファイルマネージャーではありません。**ツールランタイム実行環境**です。
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                        rufio                            │
+│         Runtime Unified Flow I/O Operator               │
+├─────────────────────────────────────────────────────────┤
+│  Files ──→ Scripts ──→ Tools ──→ Output                 │
+│    ↑                                   │                │
+│    └───────────── Feedback ────────────┘                │
+└─────────────────────────────────────────────────────────┘
+```
+
+- **ファイル操作**: 従来のファイルマネージャー機能
+- **スクリプト実行**: Ruby/Python/PowerShellスクリプトをファイルコンテキストで実行
+- **ツール連携**: 外部ツール（git, fzf, rga等）とのシームレスな統合
+- **統一I/O**: すべての入出力を単一のフローで管理
+
+## 特徴
+
+### ツールランタイムとして
+
+- **マルチ言語スクリプト対応**: Ruby, Python, PowerShell
+- **スクリプトパス管理**: 複数のスクリプトディレクトリを登録・管理
+- **コマンド補完**: `@`プレフィックスでスクリプトをTab補完
+- **ジョブ管理**: バックグラウンドでスクリプト/コマンドを実行
+- **実行ログ**: すべての実行結果を自動記録
+
+### ファイルマネージャーとして
+
+- **Vimライクなキーバインド**: 直感的なナビゲーション
+- **リアルタイムプレビュー**: ファイル内容を即座に表示
+- **高速検索**: fzf/rgaとの連携
+- **ブックマーク**: よく使うディレクトリに素早くアクセス
+- **zoxide連携**: スマートなディレクトリ履歴
+
+### クロスプラットフォーム
+
+- **macOS**: ネイティブサポート
+- **Linux**: ネイティブサポート
+- **Windows**: PowerShellスクリプト対応
+
+## インストール
+
+```bash
+gem install rufio
+```
+
+または、Gemfileに追加:
+
+```ruby
+gem 'rufio'
+```
+
+## クイックスタート
+
+### 1. 起動
+
+```bash
+rufio           # カレントディレクトリで起動
+rufio /path/to  # 指定したディレクトリで起動
+```
+
+### 2. スクリプトパスを登録
+
+1. スクリプトを配置したいディレクトリに移動
+2. `B` → `2` でスクリプトパスに追加
+
+### 3. スクリプトを実行
+
+1. `:` でコマンドモードを起動
+2. `@` + スクリプト名の一部を入力
+3. `Tab` で補完
+4. `Enter` で実行
+
+## キーバインド
+
+### 基本操作
+
+| キー | 機能 |
+|------|------|
+| `j/k` | 上下移動 |
+| `h/l` | 親/子ディレクトリ |
+| `g/G` | 先頭/末尾 |
+| `Enter` | ディレクトリに入る/ファイルを開く |
+| `q` | 終了 |
+
+### ファイル操作
+
+| キー | 機能 |
+|------|------|
+| `Space` | 選択/選択解除 |
+| `o` | 外部エディタで開く |
+| `a/A` | ファイル/ディレクトリ作成 |
+| `r` | リネーム |
+| `d` | 削除 |
+| `m/c/x` | 移動/コピー/削除（選択済み） |
+
+### 検索・フィルター
+
+| キー | 機能 |
+|------|------|
+| `f` | フィルターモード |
+| `s` | fzfでファイル検索 |
+| `F` | rgaでファイル内容検索 |
+
+### ナビゲーション
+
+| キー | 機能 |
+|------|------|
+| `b` | ブックマーク追加 |
+| `B` | ブックマークメニュー |
+| `0` | 起動ディレクトリに戻る |
+| `1-9` | ブックマークにジャンプ |
+| `z` | zoxide履歴 |
+
+### ツールランタイム
+
+| キー | 機能 |
+|------|------|
+| `:` | コマンドモード |
+| `J` | ジョブモード |
+| `L` | 実行ログ表示 |
+| `?` | ヘルプ |
+
+## コマンドモード
+
+`:` でコマンドモードを起動し、様々なコマンドを実行できます。
+
+### スクリプト実行
+
+```
+:@build           # @で始まるとスクリプト補完
+:@deploy.rb       # 登録済みスクリプトを実行
+```
+
+### シェルコマンド
+
+```
+:!git status      # !で始まるとシェルコマンド
+:!ls -la          # バックグラウンドで実行
+```
+
+### 組み込みコマンド
+
+```
+:hello            # 挨拶メッセージ
+:stop             # rufioを終了
+```
+
+## スクリプトパス
+
+### スクリプトパスとは
+
+スクリプトファイルを配置するディレクトリを登録する機能です。登録したディレクトリ内のスクリプトは、コマンドモードで `@` プレフィックスを使って実行できます。
+
+### 管理方法
+
+`B` → `3` でスクリプトパス管理メニューを開きます：
+
+- 登録済みパスの一覧表示
+- `d`: パスを削除
+- `Enter`: ディレクトリにジャンプ
+- `ESC`: メニューを閉じる
+
+### 対応スクリプト
+
+| 拡張子 | 言語 |
+|--------|------|
+| `.rb` | Ruby |
+| `.py` | Python |
+| `.ps1` | PowerShell |
+| `.sh` | Shell (bash/zsh) |
+
+## DSLコマンド
+
+`~/.config/rufio/commands.rb` でカスタムコマンドを定義できます：
+
+```ruby
+command "hello" do
+  ruby { "Hello from rufio!" }
+  description "挨拶コマンド"
+end
+
+command "status" do
+  shell "git status"
+  description "Gitステータス"
+end
+
+command "build" do
+  script "~/.config/rufio/scripts/build.rb"
+  description "ビルド実行"
+end
+```
+
+## 設定
+
+### 設定ファイル構成
+
+```
+~/.config/rufio/
+├── config.rb         # メイン設定（スクリプトパス、カラー等）
+├── commands.rb       # DSLコマンド定義
+├── bookmarks.json    # ブックマーク
+├── scripts/          # スクリプトファイル
+└── logs/             # 実行ログ
+```
+
+### 設定例
+
+```ruby
+# ~/.config/rufio/config.rb
+
+# スクリプトパス - スクリプトを配置するディレクトリ
+SCRIPT_PATHS = [
+  '~/.config/rufio/scripts',
+  '~/my-scripts',
+  './scripts'
+].freeze
+
+# カラー設定（HSL形式推奨）
+COLORS = {
+  directory: { hsl: [220, 80, 60] },
+  file: { hsl: [0, 0, 90] },
+  executable: { hsl: [120, 70, 50] },
+  selected: { hsl: [50, 90, 70] },
+  preview: { hsl: [180, 60, 65] }
+}.freeze
+```
+
+### ローカル設定
+
+プロジェクトルートに `rufio.rb` を配置すると、そのプロジェクト専用のスクリプトパスを設定できます：
+
+```ruby
+# ./rufio.rb（プロジェクトルート）
+SCRIPT_PATHS = [
+  './scripts',
+  './bin'
+].freeze
+```
+
+## 外部ツール連携
+
+rufioは以下の外部ツールと連携して機能を拡張します：
+
+| ツール | 用途 | キー |
+|--------|------|------|
+| fzf | ファイル名検索 | `s` |
+| rga | ファイル内容検索 | `F` |
+| zoxide | ディレクトリ履歴 | `z` |
+
+### インストール
+
+```bash
+# macOS
+brew install fzf rga zoxide
+
+# Ubuntu/Debian
+apt install fzf zoxide
+# rgaは別途インストール: https://github.com/phiresky/ripgrep-all
+```
+
+## 高度な機能
+
+### ネイティブスキャナー（実験的）
+
+高速なディレクトリスキャンのためのネイティブ実装をサポート：
+
+```bash
+rufio --native        # 自動検出
+rufio --native=zig    # Zig実装
+```
+
+### JITコンパイラ
+
+```bash
+rufio --yjit   # Ruby 3.1+ YJIT
+rufio --zjit   # Ruby 3.4+ ZJIT
+```
+
+### ヘルスチェック
+
+```bash
+rufio -c              # システム依存関係をチェック
+rufio --check-health  # 同上
+```
+
+## 開発
+
+### 必要な環境
+
+- Ruby 2.7.0以上
+- io-console, pastel, tty-cursor, tty-screen gems
+
+### 開発版の実行
+
+```bash
+git clone https://github.com/masisz/rufio
+cd rufio
+bundle install
+./bin/rufio
+```
+
+### テスト
+
+```bash
+bundle exec rake test
+```
+
+## ライセンス
+
+MIT License
+
+## 貢献
+
+バグ報告や機能リクエストは [GitHub Issues](https://github.com/masisz/rufio/issues) でお願いします。
+プルリクエストも歓迎です！

data/examples/bookmarks.yml

@@ -0,0 +1,14 @@
+# ~/.config/rufio/bookmarks.yml
+# List of bookmarks
+#
+# Press 1-9 keys to jump directly to bookmarks.
+# Press B key to open bookmark menu for add/remove operations.
+
+- path: ~/Documents
+  name: Documents
+- path: ~/Downloads
+  name: Downloads
+- path: ~/projects
+  name: Projects
+- path: ~/.config
+  name: Config

data/examples/config.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# ~/.config/rufio/config.rb
+# rufio DSL Configuration File
+#
+# This file defines the configuration for rufio.
+# Script paths and bookmarks are managed in separate YAML files.
+
+# ========================================
+# Language Setting
+# ========================================
+# 'en' (English) or 'ja' (Japanese)
+LANGUAGE = 'ja'
+
+# ========================================
+# Color Settings
+# ========================================
+# HSL format: [hue(0-360), saturation(0-100), lightness(0-100)]
+COLORS = {
+  directory: { hsl: [220, 80, 60] },    # Blue
+  file: { hsl: [0, 0, 90] },            # White
+  executable: { hsl: [120, 70, 50] },   # Green
+  selected: { hsl: [50, 90, 70] },      # Yellow
+  preview: { hsl: [180, 60, 65] }       # Cyan
+}.freeze
+
+# ========================================
+# Keybind Settings
+# ========================================
+KEYBINDS = {
+  quit: %w[q ESC],
+  up: %w[k UP],
+  down: %w[j DOWN],
+  left: %w[h LEFT],
+  right: %w[l RIGHT ENTER],
+  top: %w[g],
+  bottom: %w[G],
+  refresh: %w[r],
+  search: %w[/],
+  open_file: %w[o SPACE]
+}.freeze
+
+# ========================================
+# Application Associations
+# ========================================
+# Specify which application to open for each file extension
+APPLICATIONS = {
+  %w[txt md rb py js html css json xml yaml yml] => 'code',
+  %w[jpg jpeg png gif bmp svg webp] => 'open',
+  %w[mp4 avi mkv mov wmv] => 'open',
+  %w[pdf] => 'open',
+  %w[doc docx xls xlsx ppt pptx] => 'open',
+  :default => 'open'
+}.freeze
+
+# ========================================
+# Command History Size
+# ========================================
+COMMAND_HISTORY_SIZE = 1000
+
+# ========================================
+# Script Paths and Bookmarks
+# ========================================
+# script_paths.yml - List of script directories
+# bookmarks.yml    - List of bookmarks
+#
+# These files are automatically loaded by rufio.
+# You can edit them manually or manage via rufio's UI.

data/examples/script_paths.yml

@@ -0,0 +1,11 @@
+# ~/.config/rufio/script_paths.yml
+# List of script directories
+#
+# Scripts in registered directories can be executed
+# from rufio's command mode (:).
+#
+# Example: :build -> executes build.sh or build.rb in script_paths
+
+- ~/.config/rufio/scripts
+- ~/bin
+- ~/scripts

data/lib/rufio/application.rb

@@ -21,7 +21,7 @@ module Rufio
       terminal_ui = TerminalUI.new(test_mode: test_mode)
 
       # バックグラウンドコマンド実行用の設定
-      log_dir = File.join(Dir.home, '.config', 'rufio', 'log')
+      log_dir = File.join(Dir.home, '.config', 'rufio', 'logs')
       FileUtils.mkdir_p(log_dir) unless Dir.exist?(log_dir)
       command_logger = CommandLogger.new(log_dir)
       background_executor = BackgroundCommandExecutor.new(command_logger)

data/lib/rufio/bookmark.rb

@@ -2,13 +2,15 @@
 
 require 'json'
 require 'fileutils'
+require_relative 'bookmark_storage'
 
 module Rufio
   class Bookmark
     MAX_BOOKMARKS = 9
 
-    def initialize(config_file = nil)
+    def initialize(config_file = nil, storage: nil)
       @config_file = config_file || default_config_file
+      @storage = storage || JsonBookmarkStorage.new(@config_file)
       @bookmarks = []
       ensure_config_directory
       load
@@ -70,38 +72,12 @@ module Rufio
     end
 
     def save
-      begin
-        File.write(@config_file, JSON.pretty_generate(@bookmarks))
-        true
-      rescue StandardError => e
-        warn "Failed to save bookmarks: #{e.message}"
-        false
-      end
+      @storage.save(@bookmarks)
     end
 
     def load
-      return true unless File.exist?(@config_file)
-
-      begin
-        content = File.read(@config_file)
-        @bookmarks = JSON.parse(content, symbolize_names: true)
-        @bookmarks = [] unless @bookmarks.is_a?(Array)
-        
-        # 無効なブックマークを除去
-        @bookmarks = @bookmarks.select do |bookmark|
-          bookmark.is_a?(Hash) &&
-            bookmark.key?(:path) &&
-            bookmark.key?(:name) &&
-            bookmark[:path].is_a?(String) &&
-            bookmark[:name].is_a?(String)
-        end
-        
-        true
-      rescue JSON::ParserError, StandardError => e
-        warn "Failed to load bookmarks: #{e.message}"
-        @bookmarks = []
-        true
-      end
+      @bookmarks = @storage.load
+      true
     end
 
     private

data/lib/rufio/bookmark_manager.rb

@@ -1,16 +1,30 @@
 # frozen_string_literal: true
 
 require_relative 'bookmark'
+require_relative 'bookmark_storage'
 require_relative 'config_loader'
 
 module Rufio
   # Manages bookmark operations with interactive UI
   class BookmarkManager
     def initialize(bookmark = nil, dialog_renderer = nil)
-      @bookmark = bookmark || Bookmark.new
+      @bookmark = bookmark || create_default_bookmark
       @dialog_renderer = dialog_renderer
     end
 
+    private
+
+    def create_default_bookmark
+      # 必要に応じて古いconfig.ymlからマイグレーション
+      ConfigLoader.migrate_bookmarks_if_needed
+
+      # 新形式のYAMLストレージを使用（bookmarks.yml）
+      storage = ConfigLoader.bookmark_storage
+      Bookmark.new(ConfigLoader::BOOKMARKS_YML, storage: storage)
+    end
+
+    public
+
     # Show bookmark menu and handle user selection
     # @param current_path [String] Current directory path
     # @return [Symbol, nil] Action to perform (:navigate, :add, :list, :remove, :cancel)

data/lib/rufio/bookmark_storage.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'yaml'
+require 'fileutils'
+require_relative 'config'
+
+module Rufio
+  # ブックマークストレージの基底クラス
+  class BookmarkStorage
+    def initialize(file_path)
+      @file_path = file_path
+    end
+
+    def load
+      raise NotImplementedError, 'Subclasses must implement #load'
+    end
+
+    def save(_bookmarks)
+      raise NotImplementedError, 'Subclasses must implement #save'
+    end
+
+    protected
+
+    def ensure_directory
+      dir = File.dirname(@file_path)
+      FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
+    end
+
+    def valid_bookmark?(bookmark)
+      bookmark.is_a?(Hash) &&
+        (bookmark.key?(:path) || bookmark.key?('path')) &&
+        (bookmark.key?(:name) || bookmark.key?('name'))
+    end
+
+    def normalize_bookmark(bookmark)
+      {
+        path: bookmark[:path] || bookmark['path'],
+        name: bookmark[:name] || bookmark['name']
+      }
+    end
+
+    def filter_valid_bookmarks(bookmarks)
+      return [] unless bookmarks.is_a?(Array)
+
+      bookmarks.select { |b| valid_bookmark?(b) }.map { |b| normalize_bookmark(b) }
+    end
+  end
+
+  # JSON形式のブックマークストレージ
+  class JsonBookmarkStorage < BookmarkStorage
+    def load
+      return [] unless File.exist?(@file_path)
+
+      content = File.read(@file_path)
+      bookmarks = JSON.parse(content, symbolize_names: true)
+      filter_valid_bookmarks(bookmarks)
+    rescue JSON::ParserError, StandardError
+      []
+    end
+
+    def save(bookmarks)
+      ensure_directory
+      File.write(@file_path, JSON.pretty_generate(bookmarks))
+      true
+    rescue StandardError => e
+      warn "Failed to save bookmarks to JSON: #{e.message}"
+      false
+    end
+  end
+
+  # YAML形式のブックマークストレージ（新旧形式対応）
+  # 新形式: bookmarks.yml（配列形式）
+  # 旧形式: config.yml（bookmarksセクション）
+  class YamlBookmarkStorage < BookmarkStorage
+    def load
+      return [] unless File.exist?(@file_path)
+
+      # 新形式: bookmarks.yml（配列形式）
+      if @file_path.end_with?('bookmarks.yml')
+        return Config.load_bookmarks_from_yml(@file_path)
+      end
+
+      # 旧形式: config.yml（bookmarksセクション）
+      yaml = YAML.safe_load(File.read(@file_path), symbolize_names: true)
+      return [] unless yaml.is_a?(Hash)
+
+      bookmarks = yaml[:bookmarks] || []
+      filter_valid_bookmarks(bookmarks)
+    rescue StandardError
+      []
+    end
+
+    def save(bookmarks)
+      ensure_directory
+
+      # 新形式: bookmarks.yml（配列形式）
+      if @file_path.end_with?('bookmarks.yml')
+        Config.save_bookmarks_to_yml(@file_path, bookmarks)
+        return true
+      end
+
+      # 旧形式: config.yml（bookmarksセクション - 既存の設定を保持）
+      existing = if File.exist?(@file_path)
+                   YAML.safe_load(File.read(@file_path), symbolize_names: false) || {}
+                 else
+                   {}
+                 end
+
+      existing['bookmarks'] = bookmarks.map do |b|
+        { 'path' => b[:path], 'name' => b[:name] }
+      end
+
+      File.write(@file_path, YAML.dump(existing))
+      true
+    rescue StandardError => e
+      warn "Failed to save bookmarks to YAML: #{e.message}"
+      false
+    end
+  end
+
+  # JSONからYAMLへのマイグレーター
+  class BookmarkMigrator
+    # @param json_path [String] JSONファイルのパス
+    # @param yaml_path [String] YAMLファイルのパス
+    # @return [Boolean] マイグレーションが実行されたかどうか
+    def self.migrate(json_path, yaml_path)
+      return false unless File.exist?(json_path)
+
+      # JSONからブックマークを読み込む
+      json_storage = JsonBookmarkStorage.new(json_path)
+      bookmarks = json_storage.load
+
+      return false if bookmarks.empty?
+
+      # YAMLに保存
+      yaml_storage = YamlBookmarkStorage.new(yaml_path)
+      yaml_storage.save(bookmarks)
+
+      # JSONファイルをバックアップ
+      FileUtils.mv(json_path, "#{json_path}.bak")
+
+      true
+    rescue StandardError => e
+      warn "Migration failed: #{e.message}"
+      false
+    end
+  end
+end

data/lib/rufio/command_mode.rb

@@ -62,9 +62,9 @@ module Rufio
         # バックグラウンドエグゼキュータが利用可能な場合は非同期実行
         if @background_executor
           if @background_executor.execute_async(shell_command)
-            return "🔄 バックグラウンドで実行中: #{shell_command.split.first}"
+            return "🔄 Running in background: #{shell_command.split.first}"
           else
-            return "⚠️  既にコマンドが実行中です"
+            return "⚠️  Command already running"
           end
         else
           # バックグラウンドエグゼキュータがない場合は同期実行
@@ -165,9 +165,9 @@ module Rufio
         if @background_executor.execute_ruby_async(command_display_name) do
              ScriptExecutor.execute_command(dsl_cmd)
            end
-          return "🔄 バックグラウンドで実行中: #{command_display_name}"
+          return "🔄 Running in background: #{command_display_name}"
         else
-          return "⚠️  既にコマンドが実行中です"
+          return "⚠️  Command already running"
         end
       end