rufio 0.61.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_manager.rb

@@ -15,12 +15,12 @@ module Rufio
     private
 
     def create_default_bookmark
-      # 必要に応じてJSONからYAMLに移行
+      # 必要に応じて古いconfig.ymlからマイグレーション
       ConfigLoader.migrate_bookmarks_if_needed
 
-      # YAMLストレージを使用
+      # 新形式のYAMLストレージを使用（bookmarks.yml）
       storage = ConfigLoader.bookmark_storage
-      Bookmark.new(ConfigLoader::YAML_CONFIG_PATH, storage: storage)
+      Bookmark.new(ConfigLoader::BOOKMARKS_YML, storage: storage)
     end
 
     public

data/lib/rufio/bookmark_storage.rb

@@ -3,6 +3,7 @@
 require 'json'
 require 'yaml'
 require 'fileutils'
+require_relative 'config'
 
 module Rufio
   # ブックマークストレージの基底クラス
@@ -28,16 +29,21 @@ module Rufio
 
     def valid_bookmark?(bookmark)
       bookmark.is_a?(Hash) &&
-        bookmark.key?(:path) &&
-        bookmark.key?(:name) &&
-        bookmark[:path].is_a?(String) &&
-        bookmark[:name].is_a?(String)
+        (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) }
+      bookmarks.select { |b| valid_bookmark?(b) }.map { |b| normalize_bookmark(b) }
     end
   end
 
@@ -63,15 +69,24 @@ module Rufio
     end
   end
 
-  # YAML形式のブックマークストレージ（config.ymlに統合）
+  # YAML形式のブックマークストレージ（新旧形式対応）
+  # 新形式: bookmarks.yml（配列形式）
+  # 旧形式: config.yml（bookmarksセクション）
   class YamlBookmarkStorage < BookmarkStorage
     def load
       return [] unless File.exist?(@file_path)
 
-      content = YAML.safe_load(File.read(@file_path), symbolize_names: true)
-      return [] unless content.is_a?(Hash) && content[:bookmarks]
+      # 新形式: bookmarks.yml（配列形式）
+      if @file_path.end_with?('bookmarks.yml')
+        return Config.load_bookmarks_from_yml(@file_path)
+      end
 
-      filter_valid_bookmarks(content[:bookmarks])
+      # 旧形式: 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
@@ -79,70 +94,56 @@ module Rufio
     def save(bookmarks)
       ensure_directory
 
-      # 既存の設定を読み込み
-      existing_config = if File.exist?(@file_path)
-                          YAML.safe_load(File.read(@file_path), symbolize_names: true) || {}
-                        else
-                          {}
-                        end
+      # 新形式: 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
 
-      # ブックマークを文字列キーのハッシュに変換（YAMLの可読性のため）
-      bookmarks_for_yaml = bookmarks.map do |b|
+      existing['bookmarks'] = bookmarks.map do |b|
         { 'path' => b[:path], 'name' => b[:name] }
       end
 
-      # ブックマークセクションを更新
-      existing_config_string_keys = deep_stringify_keys(existing_config)
-      existing_config_string_keys['bookmarks'] = bookmarks_for_yaml
-
-      File.write(@file_path, YAML.dump(existing_config_string_keys))
+      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)
 
-    private
+      # JSONからブックマークを読み込む
+      json_storage = JsonBookmarkStorage.new(json_path)
+      bookmarks = json_storage.load
 
-    def deep_stringify_keys(hash)
-      return hash unless hash.is_a?(Hash)
+      return false if bookmarks.empty?
 
-      hash.transform_keys(&:to_s).transform_values do |v|
-        case v
-        when Hash
-          deep_stringify_keys(v)
-        when Array
-          v.map { |item| item.is_a?(Hash) ? deep_stringify_keys(item) : item }
-        else
-          v
-        end
-      end
-    end
-  end
+      # YAMLに保存
+      yaml_storage = YamlBookmarkStorage.new(yaml_path)
+      yaml_storage.save(bookmarks)
 
-  # ブックマークのJSON→YAMLマイグレーター
-  class BookmarkMigrator
-    class << self
-      def migrate(json_path, yaml_path)
-        return false unless File.exist?(json_path)
-
-        # JSONからブックマークを読み込み
-        json_storage = JsonBookmarkStorage.new(json_path)
-        bookmarks = json_storage.load
-
-        # YAMLに保存
-        yaml_storage = YamlBookmarkStorage.new(yaml_path)
-        yaml_storage.save(bookmarks)
-
-        # JSONファイルをバックアップして削除
-        backup_path = "#{json_path}.bak"
-        FileUtils.mv(json_path, backup_path)
-
-        true
-      rescue StandardError => e
-        warn "Failed to migrate bookmarks: #{e.message}"
-        false
-      end
+      # JSONファイルをバックアップ
+      FileUtils.mv(json_path, "#{json_path}.bak")
+
+      true
+    rescue StandardError => e
+      warn "Migration failed: #{e.message}"
+      false
     end
   end
 end