rufio 0.9.0

data/bin/rufio

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/rufio'
+
+# プラグインを読み込む
+Rufio::PluginManager.load_all
+
+# コマンドライン引数の処理
+if ARGV.include?('--check-health') || ARGV.include?('-c')
+  # ヘルスチェック実行
+  health_checker = Rufio::HealthChecker.new
+  success = health_checker.run_check
+  exit(success ? 0 : 1)
+elsif ARGV.include?('--help')
+  puts "rufio - Terminal-based file manager"
+  puts ""
+  puts "Usage:"
+  puts "  rufio [DIRECTORY]     Start rufio in specified directory"
+  puts "  rufio -c, --check-health  Check system dependencies"
+  puts "  rufio --help          Show this help message"
+  puts ""
+  puts "Examples:"
+  puts "  rufio                 # Start in current directory"
+  puts "  rufio /path/to/dir    # Start in specific directory"
+  puts "  rufio -c              # Check if all dependencies are available"
+  exit(0)
+else
+  start_directory = ARGV[0] || Dir.pwd
+
+  # アプリケーション開始
+  app = Rufio::Application.new(start_directory)
+  app.run
+end

data/config_example.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# rufio configuration example
+# Copy this file to ~/.config/rufio/config.rb to customize your settings
+
+# Cross-platform file opener method
+def get_system_open_command
+  case RbConfig::CONFIG['host_os']
+  when /mswin|mingw|cygwin/
+    'start'  # Windows
+  when /darwin/
+    'open'   # macOS
+  when /linux|bsd/
+    'xdg-open'  # Linux/BSD
+  else
+    'open'   # Fallback to open
+  end
+end
+
+# Get the appropriate open command for current platform
+SYSTEM_OPEN = get_system_open_command
+
+# Language setting
+# Available languages: 'en' (English), 'ja' (Japanese)
+# If not specified, language will be auto-detected from environment variables
+LANGUAGE = 'en'  # or 'ja'
+
+# Application associations
+# Define which applications to use for opening different file types
+APPLICATIONS = {
+  # Text files - open with 'code' (VS Code)
+  %w[txt md rb py js ts html css json xml yaml yml] => 'code',
+  
+  # Image files - open with default system app
+  %w[jpg jpeg png gif bmp svg webp] => SYSTEM_OPEN,
+  
+  # Video files - open with default system app
+  %w[mp4 avi mkv mov wmv] => SYSTEM_OPEN,
+  
+  # Documents - open with default system app
+  %w[pdf doc docx xls xlsx ppt pptx] => SYSTEM_OPEN,
+  
+  # Default application for unspecified file types
+  :default => SYSTEM_OPEN
+}
+
+# Color scheme
+# Define colors for different types of files and UI elements
+# You can use various color formats:
+#   - Symbols: :blue, :red, :green, :yellow, :cyan, :magenta, :white, :black
+#   - HSL: {hsl: [hue(0-360), saturation(0-100), lightness(0-100)]}
+#   - RGB: {rgb: [red(0-255), green(0-255), blue(0-255)]}
+#   - HEX: {hex: "#ff0000"}
+#   - ANSI codes: "34" or 34
+COLORS = {
+  # HSL color examples (Hue: 0-360, Saturation: 0-100%, Lightness: 0-100%)
+  directory: { hsl: [220, 80, 60] },    # Blue directory entries
+  file: { hsl: [0, 0, 90] },            # Light gray regular files
+  executable: { hsl: [120, 70, 50] },   # Green executable files
+  selected: { hsl: [50, 90, 70] },      # Yellow currently selected item
+  preview: { hsl: [180, 60, 65] },      # Cyan preview panel
+  
+  # You can also mix different formats:
+  # directory: :blue,                   # Traditional symbol
+  # file: {rgb: [200, 200, 200]},       # RGB format
+  # executable: {hex: "#00ff00"},       # HEX format
+  # selected: "93",                     # ANSI code (bright yellow)
+}
+
+# Key bindings
+# Customize keyboard shortcuts (not yet fully implemented)
+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]
+}
+
+# You can also set language via environment variable:
+# export BENIYA_LANG=ja    # Set to 'ja' for Japanese, 'en' for English
+# Note: Only BENIYA_LANG is used for language detection
+# System LANG variable is ignored to ensure English is the default

data/docs/PLUGIN_GUIDE.md

@@ -0,0 +1,431 @@
+# Rufio プラグインガイド
+
+Rufioのプラグインシステムを使って、機能を拡張する方法を説明します。
+
+## 目次
+
+1. [プラグインの基本](#プラグインの基本)
+2. [プラグインの作成](#プラグインの作成)
+3. [プラグインの設定](#プラグインの設定)
+4. [高度な機能](#高度な機能)
+5. [トラブルシューティング](#トラブルシューティング)
+
+## プラグインの基本
+
+### プラグインとは？
+
+プラグインは、Rufioに新しい機能を追加するためのRubyモジュールです。
+
+### プラグインの種類
+
+1. **組み込みプラグイン**: Rufio本体に含まれる
+   - 場所: `lib/rufio/plugins/`
+   - 例: `FileOperations`
+
+2. **ユーザープラグイン**: ユーザーが作成する
+   - 場所: `~/.rufio/plugins/`
+   - 自由にカスタマイズ可能
+
+## プラグインの作成
+
+### ステップ1: ディレクトリの準備
+
+```bash
+# プラグインディレクトリを作成
+mkdir -p ~/.rufio/plugins
+```
+
+### ステップ2: プラグインファイルの作成
+
+`~/.rufio/plugins/my_plugin.rb`を作成：
+
+```ruby
+# frozen_string_literal: true
+
+module Rufio
+  module Plugins
+    class MyPlugin < Plugin
+      # プラグイン名（必須）
+      def name
+        "MyPlugin"
+      end
+
+      # 説明（オプション）
+      def description
+        "私のカスタムプラグイン"
+      end
+
+      # バージョン（オプション）
+      def version
+        "1.0.0"
+      end
+
+      # コマンドの定義（オプション）
+      def commands
+        {
+          hello: method(:say_hello)
+        }
+      end
+
+      private
+
+      def say_hello
+        puts "Hello from MyPlugin!"
+      end
+    end
+  end
+end
+```
+
+### ステップ3: プラグインの読み込み
+
+Rufioを起動すると、自動的に`~/.rufio/plugins/`内のプラグインが読み込まれます。
+
+## プラグインの設定
+
+### 設定ファイルの作成
+
+`~/.rufio/config.yml`:
+
+```yaml
+plugins:
+  # プラグイン名を小文字で指定
+  myplugin:
+    enabled: true
+
+  # 無効化したいプラグイン
+  fileoperations:
+    enabled: false
+```
+
+### 設定のルール
+
+- **プラグイン名**: 大文字小文字を区別せず、小文字に統一されます
+  - `MyPlugin`, `myplugin`, `MYPLUGIN` → すべて `myplugin` として扱われます
+- **デフォルト**: 設定に記載のないプラグインは**有効**です
+- **enabled**: `true`で有効、`false`で無効
+
+## 高度な機能
+
+### 外部gemへの依存
+
+プラグインが外部gemに依存する場合、`requires`を使用：
+
+```ruby
+module Rufio
+  module Plugins
+    class AdvancedPlugin < Plugin
+      # 依存するgemを宣言
+      requires 'httparty', 'nokogiri'
+
+      def name
+        "AdvancedPlugin"
+      end
+
+      def description
+        "HTTPartyとNokogiriを使用"
+      end
+
+      private
+
+      def fetch_and_parse
+        require 'httparty'
+        require 'nokogiri'
+
+        response = HTTParty.get('https://example.com')
+        doc = Nokogiri::HTML(response.body)
+        # 処理...
+      end
+    end
+  end
+end
+```
+
+gemが不足している場合、以下のメッセージが表示されます：
+
+```
+⚠️  Plugin 'AdvancedPlugin' は以下のgemに依存していますが、インストールされていません:
+  - httparty
+  - nokogiri
+
+以下のコマンドでインストールしてください:
+  gem install httparty nokogiri
+```
+
+### コマンドの定義
+
+プラグインは複数のコマンドを提供できます：
+
+```ruby
+def commands
+  {
+    search: method(:search_files),
+    count: method(:count_files),
+    list: method(:list_files)
+  }
+end
+
+private
+
+def search_files
+  # 検索処理
+end
+
+def count_files
+  # カウント処理
+end
+
+def list_files
+  # 一覧表示
+end
+```
+
+## プラグインの例
+
+### 1. ファイル検索プラグイン
+
+```ruby
+module Rufio
+  module Plugins
+    class FileSearchPlugin < Plugin
+      def name
+        "FileSearch"
+      end
+
+      def description
+        "ファイル名で検索"
+      end
+
+      def commands
+        {
+          search: method(:search_files),
+          find_ext: method(:find_by_extension)
+        }
+      end
+
+      private
+
+      def search_files(query = "*")
+        Dir.glob("**/*#{query}*").each do |file|
+          puts file if File.file?(file)
+        end
+      end
+
+      def find_by_extension(ext)
+        Dir.glob("**/*.#{ext}").each do |file|
+          puts file
+        end
+      end
+    end
+  end
+end
+```
+
+### 2. Git統合プラグイン
+
+```ruby
+module Rufio
+  module Plugins
+    class GitPlugin < Plugin
+      def name
+        "Git"
+      end
+
+      def description
+        "Git操作の統合"
+      end
+
+      def commands
+        {
+          status: method(:git_status),
+          branch: method(:current_branch),
+          log: method(:git_log)
+        }
+      end
+
+      private
+
+      def git_status
+        system('git status') if git_available?
+      end
+
+      def current_branch
+        if git_available?
+          branch = `git branch --show-current`.strip
+          puts "ブランチ: #{branch}"
+        end
+      end
+
+      def git_log
+        system('git log --oneline -10') if git_available?
+      end
+
+      def git_available?
+        if system('which git > /dev/null 2>&1')
+          true
+        else
+          puts "⚠️  gitがインストールされていません"
+          false
+        end
+      end
+    end
+  end
+end
+```
+
+### 3. システム情報プラグイン
+
+```ruby
+module Rufio
+  module Plugins
+    class SystemInfoPlugin < Plugin
+      def name
+        "SystemInfo"
+      end
+
+      def description
+        "システム情報を表示"
+      end
+
+      def commands
+        {
+          info: method(:show_system_info),
+          disk: method(:show_disk_usage)
+        }
+      end
+
+      private
+
+      def show_system_info
+        puts "OS: #{RbConfig::CONFIG['host_os']}"
+        puts "Ruby: #{RUBY_VERSION}"
+        puts "ホームディレクトリ: #{ENV['HOME']}"
+      end
+
+      def show_disk_usage
+        puts "ディスク使用量:"
+        system('df -h .')
+      end
+    end
+  end
+end
+```
+
+## プラグインの仕組み
+
+### 自動登録
+
+プラグインは`Rufio::Plugin`を継承すると、自動的に`PluginManager`に登録されます：
+
+```ruby
+class MyPlugin < Plugin
+  # 継承した時点で自動登録される
+end
+```
+
+### 初期化時の依存チェック
+
+プラグインがインスタンス化されるとき、`requires`で宣言したgemがインストールされているかチェックされます：
+
+```ruby
+def initialize
+  check_dependencies!  # 自動的に呼ばれる
+end
+```
+
+## トラブルシューティング
+
+### プラグインが読み込まれない
+
+**症状**: プラグインを作成したのに動作しない
+
+**確認事項**:
+1. ファイルの場所: `~/.rufio/plugins/` に配置されているか
+2. ファイル名: `.rb`拡張子がついているか
+3. 構文エラー: Rubyの構文が正しいか
+4. 設定ファイル: `config.yml`で無効化されていないか
+
+### 依存gemが見つからない
+
+**症状**: プラグイン起動時にエラーが出る
+
+**解決方法**:
+```bash
+# エラーメッセージに表示されたgemをインストール
+gem install <gem名>
+```
+
+### プラグインが無効化されている
+
+**症状**: プラグインが読み込まれない（エラーなし）
+
+**確認**: `~/.rufio/config.yml`を確認
+
+```yaml
+plugins:
+  myplugin:
+    enabled: false  # ← これを true に変更
+```
+
+## ベストプラクティス
+
+### 1. わかりやすい名前をつける
+
+```ruby
+def name
+  "MyAwesomePlugin"  # 明確で分かりやすい名前
+end
+```
+
+### 2. 説明を書く
+
+```ruby
+def description
+  "このプラグインは〇〇の機能を提供します"
+end
+```
+
+### 3. エラーハンドリング
+
+```ruby
+def my_command
+  # エラーが起きる可能性のある処理
+  result = some_operation
+rescue StandardError => e
+  puts "⚠️  エラーが発生しました: #{e.message}"
+end
+```
+
+### 4. 外部コマンドの確認
+
+```ruby
+def command_available?(cmd)
+  system("which #{cmd} > /dev/null 2>&1")
+end
+
+def my_feature
+  unless command_available?('git')
+    puts "⚠️  gitがインストールされていません"
+    return
+  end
+
+  # 処理...
+end
+```
+
+## 参考
+
+- サンプルプラグイン: `docs/plugin_example.rb`
+- 組み込みプラグイン: `lib/rufio/plugins/file_operations.rb`
+- プラグイン基底クラス: `lib/rufio/plugin.rb`
+- プラグインマネージャー: `lib/rufio/plugin_manager.rb`
+
+## まとめ
+
+1. `~/.rufio/plugins/` にRubyファイルを作成
+2. `Rufio::Plugin`を継承したクラスを定義
+3. 必須メソッド`name`を実装
+4. オプションで`description`、`version`、`commands`を実装
+5. Rufio起動時に自動読み込み
+
+プラグインシステムを使って、Rufioを自分好みにカスタマイズしてください！

data/docs/plugin_example.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+# Rufio プラグイン実装例
+# このファイルを ~/.rufio/plugins/ にコピーして使用してください
+
+module Rufio
+  module Plugins
+    # ファイル検索プラグインの例
+    class FileSearchPlugin < Plugin
+      def name
+        "FileSearch"
+      end
+
+      def description
+        "ファイル名で検索する機能"
+      end
+
+      def version
+        "1.0.0"
+      end
+
+      def commands
+        {
+          search: method(:search_files),
+          find_by_ext: method(:find_by_extension)
+        }
+      end
+
+      private
+
+      # ファイル名で検索
+      def search_files(query)
+        Dir.glob("**/*#{query}*").each do |file|
+          puts file
+        end
+      end
+
+      # 拡張子でファイルを検索
+      def find_by_extension(ext)
+        Dir.glob("**/*.#{ext}").each do |file|
+          puts file
+        end
+      end
+    end
+
+    # Git統合プラグインの例（外部gem依存）
+    class GitIntegrationPlugin < Plugin
+      # gitコマンドが必要
+      # requires 'git' # gemが必要な場合
+
+      def name
+        "GitIntegration"
+      end
+
+      def description
+        "Git操作を統合"
+      end
+
+      def commands
+        {
+          git_status: method(:show_git_status),
+          git_branch: method(:show_current_branch)
+        }
+      end
+
+      private
+
+      def show_git_status
+        if system('which git > /dev/null 2>&1')
+          system('git status')
+        else
+          puts "⚠️  gitがインストールされていません"
+        end
+      end
+
+      def show_current_branch
+        if system('which git > /dev/null 2>&1')
+          branch = `git branch --show-current`.strip
+          puts "現在のブランチ: #{branch}"
+        else
+          puts "⚠️  gitがインストールされていません"
+        end
+      end
+    end
+
+    # シンプルなユーティリティプラグイン
+    class UtilityPlugin < Plugin
+      def name
+        "Utility"
+      end
+
+      def description
+        "便利なユーティリティ機能"
+      end
+
+      def commands
+        {
+          disk_usage: method(:show_disk_usage),
+          count_files: method(:count_files_in_directory)
+        }
+      end
+
+      private
+
+      def show_disk_usage
+        puts "ディスク使用量:"
+        system('df -h .')
+      end
+
+      def count_files_in_directory
+        files = Dir.glob('*').select { |f| File.file?(f) }
+        dirs = Dir.glob('*').select { |f| File.directory?(f) }
+
+        puts "ファイル数: #{files.count}"
+        puts "ディレクトリ数: #{dirs.count}"
+      end
+    end
+  end
+end

data/lib/rufio/application.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Rufio
+  class Application
+    # Error display constants
+    BACKTRACE_LINES = 5  # Number of backtrace lines to show
+
+    def initialize(start_directory = Dir.pwd)
+      @start_directory = File.expand_path(start_directory)
+      # Load configuration including language settings
+      ConfigLoader.load_config
+    end
+
+    def run
+      # 各コンポーネントを初期化
+      directory_listing = DirectoryListing.new(@start_directory)
+      keybind_handler = KeybindHandler.new
+      keybind_handler.set_base_directory(@start_directory)
+      file_preview = FilePreview.new
+      terminal_ui = TerminalUI.new
+
+      # アプリケーション開始
+      terminal_ui.start(directory_listing, keybind_handler, file_preview)
+    rescue Interrupt
+      puts "\n\n#{ConfigLoader.message('app.interrupted')}"
+    rescue StandardError => e
+      puts "\n#{ConfigLoader.message('app.error_occurred')}: #{e.message}"
+      puts e.backtrace.first(BACKTRACE_LINES).join("\n")
+    end
+  end
+end
+