tidy-file-organizer 1.0.0

data/lib/tidy_file_organizer/file_helper.rb

@@ -0,0 +1,57 @@
+module TidyFileOrganizer
+  module FileHelper
+    BYTE_UNITS = %w[B KB MB GB TB].freeze
+    BYTES_PER_UNIT = 1024.0
+
+    # Collect files
+    def collect_files(target_dir, recursive: false, exclude_dirs: [])
+      if recursive
+        collect_files_recursively(target_dir, exclude_dirs)
+      else
+        collect_files_in_directory(target_dir)
+      end
+    end
+
+    # Get relative path
+    def relative_path(file_path, base_dir)
+      file_path.sub("#{base_dir}/", '')
+    end
+
+    # Convert file size to human-readable format
+    def human_readable_size(size)
+      unit_index = 0
+      size_float = size.to_f
+
+      while size_float >= BYTES_PER_UNIT && unit_index < BYTE_UNITS.size - 1
+        size_float /= BYTES_PER_UNIT
+        unit_index += 1
+      end
+
+      format('%.2f %s', size_float, BYTE_UNITS[unit_index])
+    end
+
+    private
+
+    def collect_files_in_directory(target_dir)
+      Dir.children(target_dir)
+        .map { |entry| File.join(target_dir, entry) }
+        .select { |path| File.file?(path) }
+    end
+
+    def collect_files_recursively(target_dir, exclude_dirs)
+      pattern = File.join(target_dir, '**', '*')
+      Dir.glob(pattern).select do |path|
+        File.file?(path) && !excluded_path?(path, target_dir, exclude_dirs)
+      end
+    end
+
+    def excluded_path?(path, target_dir, exclude_dirs)
+      return false if exclude_dirs.empty?
+
+      relative = path.sub("#{target_dir}/", '')
+      path_parts = relative.split('/')
+
+      exclude_dirs.any? { |dir| path_parts.include?(dir) }
+    end
+  end
+end

data/lib/tidy_file_organizer/file_mover.rb

@@ -0,0 +1,57 @@
+require 'fileutils'
+
+module TidyFileOrganizer
+  class FileMover
+    attr_reader :target_dir
+
+    def initialize(target_dir)
+      @target_dir = File.expand_path(target_dir)
+    end
+
+    # Move file to specified directory
+    def move_file(file_path, dest_dir_name, dry_run: false)
+      filename = File.basename(file_path)
+      relative = relative_path(file_path)
+      dest_dir = File.join(@target_dir, dest_dir_name)
+      dest_path = File.join(dest_dir, filename)
+
+      return handle_conflict(relative, dest_dir_name, dry_run) if conflicting?(file_path, dest_path)
+      return handle_skip(relative, dry_run) if already_in_place?(file_path, dest_path)
+
+      perform_move(file_path, dest_dir, dest_path, relative, dest_dir_name, dry_run)
+    end
+
+    private
+
+    def relative_path(file_path)
+      file_path.sub("#{@target_dir}/", '')
+    end
+
+    def conflicting?(file_path, dest_path)
+      File.exist?(dest_path) && file_path != dest_path
+    end
+
+    def already_in_place?(file_path, dest_path)
+      file_path == dest_path
+    end
+
+    def handle_conflict(relative, dest_dir_name, dry_run)
+      message = "⚠️  Conflict: #{relative} -> #{dest_dir_name}/ (filename conflict)"
+      puts dry_run ? "[Dry-run] #{message}" : message
+    end
+
+    def handle_skip(relative, dry_run)
+      puts I18n.t('organizer.skip', file: relative) if dry_run
+    end
+
+    def perform_move(file_path, dest_dir, dest_path, relative, dest_dir_name, dry_run)
+      if dry_run
+        puts "[Dry-run] #{relative} -> #{dest_dir_name}/"
+      else
+        FileUtils.mkdir_p(dest_dir)
+        FileUtils.mv(file_path, dest_path)
+        puts "Moved: #{relative} -> #{dest_dir_name}/"
+      end
+    end
+  end
+end

data/lib/tidy_file_organizer/i18n.rb

@@ -0,0 +1,43 @@
+require 'yaml'
+
+module TidyFileOrganizer
+  module I18n
+    class << self
+      def locale
+        @locale ||= detect_locale
+      end
+
+      def locale=(value)
+        @locale = value
+      end
+
+      def t(key, **options)
+        translations = load_translations(locale)
+        text = translations.dig(*key.to_s.split('.')) || key.to_s
+
+        # Variable substitution
+        options.each do |k, v|
+          text = text.gsub("%{#{k}}", v.to_s)
+        end
+
+        text
+      end
+
+      private
+
+      def detect_locale
+        lang = ENV['LANG'].to_s
+        lang.start_with?('ja') ? :ja : :en
+      end
+
+      def load_translations(locale)
+        @translations ||= {}
+        @translations[locale] ||= begin
+          locale_file = File.expand_path("locale/#{locale}.yml", __dir__)
+          yaml_data = YAML.load_file(locale_file)
+          yaml_data[locale.to_s]
+        end
+      end
+    end
+  end
+end

data/lib/tidy_file_organizer/locale/en.yml

@@ -0,0 +1,110 @@
+en:
+  setup:
+    title: tidy-file-organizer Setup
+    separator: "============================================================"
+    section_separator: "------------------------------------------------------------"
+    target_directory: "Target directory: %{dir}"
+    language_setting: "[0] Folder Name Language Setting"
+    language_description: Choose the language for organized folder names
+    language_option_1: "  1: English (e.g., Images, Documents, Screenshots)"
+    language_option_2: "  2: Japanese (e.g., 画像, 書類, スクリーンショット)"
+    current_setting: "Current setting: %{setting}"
+    language_prompt: "Choose (1=English, 2=Japanese, Enter=keep current): "
+    invalid_input: Invalid input. Using default (English).
+    extensions_title: "[1] File Extension Rules"
+    extensions_description: Specify destination folders based on file extensions
+    keywords_title: "[2] Keyword Rules"
+    keywords_description: Specify destination folders based on keywords in filenames
+    keywords_note: "※Keywords have priority over extensions"
+    input_format: "Input format: extension_list:folder_name extension_list:folder_name ..."
+    default_values: "Default values:"
+    current_config: "Current config: %{config}"
+    new_config_prompt: "Enter new config (Enter to use defaults): "
+    config_saved: "✓ Configuration saved"
+    save_location: "  Location: %{path}"
+    next_steps: "Next steps:"
+    step_dry_run: "  1. Dry-run: tidyify run %{dir} --dry-run"
+    step_execute: "  2. Execute: tidyify run %{dir}"
+    none: none
+    english: English
+    japanese: Japanese
+
+  organizer:
+    no_config: Configuration not found. Please run 'setup' command first.
+    starting: "--- Starting organization (%{dir}) %{mode}  ---"
+    dry_run_mode: "[Dry-run mode]"
+    recursive_mode: "[Recursive mode]"
+    moved: "Moved: %{file} -> %{dest}"
+    dry_run_moved: "[Dry-run] %{file} -> %{dest}"
+    cleaned_up: "Cleaned up: %{dir} (removed empty directory)"
+    no_files: No files to organize.
+    completed: Organization completed.
+    skip: "[Skip] %{file} (already in correct location)"
+
+  date_organizer:
+    starting: "--- Starting date-based organization (%{dir}) %{mode}  ---"
+    pattern: "Pattern: %{pattern}"
+    invalid_pattern: "Invalid pattern: %{pattern}. Use year, year-month, or year-month-day."
+
+  duplicate_detector:
+    starting: "--- Starting duplicate detection (%{dir}) ---"
+    file_count: "File count: %{count}"
+    calculating: Calculating hashes...
+    progress: "Progress: %{current}/%{total}"
+    result_title: "=== Duplicate Detection Results ==="
+    duplicate_groups: "Duplicate groups: %{count}"
+    duplicate_files: "Duplicate files: %{count}"
+    no_duplicates: No duplicates found.
+    group_title: "--- Group %{num} (%{count} files, hash: %{hash}...) ---"
+    file_size: "File size: %{size}"
+    wasted_space: "Wasted space: %{size}"
+    total_wasted: "Total wasted space: %{size}"
+    deletion_starting: "--- Starting duplicate deletion %{mode} ---"
+    deletion_plan: "--- Deletion Plan ---"
+    will_keep: "Keep: %{file}"
+    will_delete: "Delete: %{file} (%{size})"
+    kept: "Keep: %{file}"
+    deleted: "Delete: %{file} (%{size})"
+    confirm_deletion: "Delete these files? [yes/no]: "
+    deletion_cancelled: Deletion cancelled.
+    invalid_response: Invalid response. Please enter yes or no.
+    summary: "--- Summary ---"
+    deleted_count: "Deleted files: %{count}"
+    saved_space: "Saved disk space: %{size}"
+    confirm_header: Duplicate File Deletion Confirmation
+    confirm_separator: "============================================================"
+    files_to_delete: "Files to delete: %{count}"
+    space_to_save: "Disk space to save: %{size}"
+    files_list_title: "Files to delete:"
+    kept_file: "   Kept file: %{file}"
+    executing_deletion: Executing deletion...
+
+  cli:
+    error_directory_required: "Error: Please specify target directory"
+    usage: "Usage: tidyify [command] [target_directory] [options]"
+    commands: "Commands:"
+    cmd_setup: "  setup              Set up organization rules interactively (defaults to current dir)"
+    cmd_run: "  run                Organize files based on configuration (defaults to current dir)"
+    cmd_organize_date: "  organize-by-date   Organize files by modification date"
+    cmd_find_dup: "  find-duplicates    Find duplicate files"
+    cmd_remove_dup: "  remove-duplicates  Remove duplicate files (keep first one)"
+    options: "Options:"
+    opt_dry_run: "  --dry-run             Simulate without actual execution"
+    opt_recursive: "  --recursive, -r       Process files in subdirectories recursively"
+    opt_pattern: "  --pattern=<pattern>   Date pattern (year, year-month, year-month-day)"
+    opt_no_confirm: "  --no-confirm          Skip confirmation before deletion (remove-duplicates only)"
+    examples: "Examples:"
+    ex_setup: |2
+        tidyify setup                                   # Set up current directory
+        tidyify setup ~/Downloads                           # Set up specific directory
+    ex_run_current: "  tidyify run                                     # Organize current directory"
+    ex_run_dry: "  tidyify run ~/Downloads --dry-run               # Dry-run"
+    ex_run_exec: "  tidyify run ~/Downloads --recursive             # Execute"
+    ex_organize_date: "  tidyify organize-by-date ~/Downloads --pattern=year-month"
+    ex_find_dup: "  tidyify find-duplicates ~/Downloads --recursive"
+    ex_remove_dup: "  tidyify remove-duplicates ~/Downloads --recursive"
+    ex_remove_no_confirm: "  tidyify remove-duplicates ~/Downloads --no-confirm"
+
+  post_install:
+    created_default_en: "✓ Created default config file (English): %{path}"
+    created_default_ja: "✓ Created default config file (Japanese): %{path}"

data/lib/tidy_file_organizer/locale/ja.yml

@@ -0,0 +1,110 @@
+ja:
+  setup:
+    title: tidy-file-organizer セットアップ
+    separator: "============================================================"
+    section_separator: "------------------------------------------------------------"
+    target_directory: "対象ディレクトリ: %{dir}"
+    language_setting: "[0] フォルダ名の言語設定"
+    language_description: 整理先フォルダ名を日本語にするか英語にするか選択します
+    language_option_1: "  1: English (例: Images, Documents, Screenshots)"
+    language_option_2: "  2: 日本語 (例: 画像, 書類, スクリーンショット)"
+    current_setting: "現在の設定: %{setting}"
+    language_prompt: "選択 (1=English, 2=日本語, Enter=現在の設定のまま): "
+    invalid_input: 無効な入力です。デフォルト（English）を使用します。
+    extensions_title: "[1] 拡張子による整理ルール"
+    extensions_description: ファイルの拡張子に基づいて整理先フォルダを指定します
+    keywords_title: "[2] キーワードによる整理ルール"
+    keywords_description: ファイル名に含まれるキーワードで整理先フォルダを指定します
+    keywords_note: "※キーワードは拡張子より優先されます"
+    input_format: "入力形式: 拡張子リスト:フォルダ名 拡張子リスト:フォルダ名 ..."
+    default_values: "デフォルト値:"
+    current_config: "現在の設定: %{config}"
+    new_config_prompt: "新しい設定を入力 (デフォルト値を使う場合はEnter): "
+    config_saved: "✓ 設定を保存しました"
+    save_location: "  保存先: %{path}"
+    next_steps: "次のステップ:"
+    step_dry_run: "  1. シミュレーション: tidyify run %{dir} --dry-run"
+    step_execute: "  2. 実際に整理を実行: tidyify run %{dir}"
+    none: なし
+    english: English
+    japanese: 日本語
+
+  organizer:
+    no_config: 設定が見つかりません。先に 'setup' コマンドを実行してください。
+    starting: "--- 整理を開始します (%{dir}) %{mode}  ---"
+    dry_run_mode: "[Dry-run モード]"
+    recursive_mode: "[再帰モード]"
+    moved: "Moved: %{file} -> %{dest}"
+    dry_run_moved: "[Dry-run] %{file} -> %{dest}"
+    cleaned_up: "Cleaned up: %{dir} (空ディレクトリを削除)"
+    no_files: 整理対象のファイルが見つかりませんでした。
+    completed: 整理が完了しました。
+    skip: "[Skip] %{file} (既に正しい場所にあります)"
+
+  date_organizer:
+    starting: "--- 日付ベースの整理を開始します (%{dir}) %{mode}  ---"
+    pattern: "整理パターン: %{pattern}"
+    invalid_pattern: "無効なパターン: %{pattern}。year, year-month, year-month-day のいずれかを使用してください。"
+
+  duplicate_detector:
+    starting: "--- 重複ファイルの検出を開始します (%{dir}) ---"
+    file_count: "ファイル数: %{count}"
+    calculating: ハッシュ値を計算中...
+    progress: "進捗: %{current}/%{total}"
+    result_title: "=== 重複ファイルの検出結果 ==="
+    duplicate_groups: "重複グループ数: %{count}"
+    duplicate_files: "重複ファイル数: %{count}"
+    no_duplicates: 重複ファイルは見つかりませんでした。
+    group_title: "--- グループ %{num} (%{count} 件, ハッシュ: %{hash}...) ---"
+    file_size: "ファイルサイズ: %{size}"
+    wasted_space: "無駄な容量: %{size}"
+    total_wasted: "合計無駄容量: %{size}"
+    deletion_starting: "--- 重複ファイルの削除を開始します %{mode} ---"
+    deletion_plan: "--- 削除計画 ---"
+    will_keep: "保持: %{file}"
+    will_delete: "削除: %{file} (%{size})"
+    kept: "保持: %{file}"
+    deleted: "削除: %{file} (%{size})"
+    confirm_deletion: "これらのファイルを削除しますか？ [yes/no]: "
+    deletion_cancelled: 削除をキャンセルしました。
+    invalid_response: 無効な応答です。yes か no を入力してください。
+    summary: "--- サマリー ---"
+    deleted_count: "削除されたファイル数: %{count}"
+    saved_space: "節約されたディスク容量: %{size}"
+    confirm_header: 重複ファイル削除の確認
+    confirm_separator: "============================================================"
+    files_to_delete: "削除対象のファイル数: %{count}"
+    space_to_save: "節約されるディスク容量: %{size}"
+    files_list_title: "削除対象のファイル:"
+    kept_file: "   保持されるファイル: %{file}"
+    executing_deletion: 削除を実行します...
+
+  cli:
+    error_directory_required: "エラー: 対象ディレクトリを指定してください"
+    usage: "Usage: tidyify [command] [target_directory] [options]"
+    commands: "Commands:"
+    cmd_setup: "  setup              整理ルールをインタラクティブに設定します（ディレクトリ省略時はカレントディレクトリ）"
+    cmd_run: "  run                設定に基づいてファイルを整理します（ディレクトリ省略時はカレントディレクトリ）"
+    cmd_organize_date: "  organize-by-date   ファイルを更新日時ベースで整理します"
+    cmd_find_dup: "  find-duplicates    重複ファイルを検出します"
+    cmd_remove_dup: "  remove-duplicates  重複ファイルを削除します（最初のファイルを保持）"
+    options: "Options:"
+    opt_dry_run: "  --dry-run             実際には実行せず、シミュレーションのみ行います"
+    opt_recursive: "  --recursive, -r       サブディレクトリ内のファイルも再帰的に処理します"
+    opt_pattern: "  --pattern=<pattern>   日付整理のパターン (year, year-month, year-month-day)"
+    opt_no_confirm: "  --no-confirm          削除前の確認をスキップします（remove-duplicatesのみ）"
+    examples: "Examples:"
+    ex_setup: |2
+        tidyify setup                                   # Setup current directory
+        tidyify setup ~/Downloads                           # Setup specific directory
+    ex_run_current: "  tidyify run                                     # Organize current directory"
+    ex_run_dry: "  tidyify run ~/Downloads --dry-run               # Dry-run simulation"
+    ex_run_exec: "  tidyify run ~/Downloads --recursive             # Execute with recursive"
+    ex_organize_date: "  tidyify organize-by-date ~/Downloads --pattern=year-month"
+    ex_find_dup: "  tidyify find-duplicates ~/Downloads --recursive"
+    ex_remove_dup: "  tidyify remove-duplicates ~/Downloads --recursive"
+    ex_remove_no_confirm: "  tidyify remove-duplicates ~/Downloads --no-confirm"
+
+  post_install:
+    created_default_en: "✓ デフォルト設定ファイル（英語）を作成しました: %{path}"
+    created_default_ja: "✓ デフォルト設定ファイル（日本語）を作成しました: %{path}"

data/lib/tidy_file_organizer/organizer.rb

@@ -0,0 +1,117 @@
+require 'fileutils'
+
+module TidyFileOrganizer
+  class Organizer
+    include FileHelper
+
+    attr_reader :target_dir
+
+    def initialize(target_dir)
+      @target_dir = File.expand_path(target_dir)
+      @config_manager = Config.new(@target_dir)
+      @file_mover = FileMover.new(@target_dir)
+      @organized_dirs = []
+    end
+
+    def setup
+      SetupPrompt.new(@config_manager).run(@target_dir)
+    end
+
+    def run(dry_run: false, recursive: false)
+      config = @config_manager.load
+      return handle_missing_config unless config
+
+      print_header(dry_run, recursive)
+
+      @organized_dirs = extract_organized_dirs(config)
+
+      files = collect_files(@target_dir, recursive: recursive, exclude_dirs: @organized_dirs)
+      return handle_empty_files if files.empty?
+
+      organize_files(files, config, dry_run)
+      cleanup_empty_directories if recursive && !dry_run
+
+      print_completion_message
+    end
+
+    private
+
+    def handle_missing_config
+      puts I18n.t('organizer.no_config')
+    end
+
+    def print_header(dry_run, recursive)
+      mode_label = dry_run ? I18n.t('organizer.dry_run_mode') : ''
+      recursive_label = recursive ? I18n.t('organizer.recursive_mode') : ''
+      puts I18n.t('organizer.starting', dir: @target_dir, mode: "#{mode_label} #{recursive_label}")
+    end
+
+    def extract_organized_dirs(config)
+      (config[:extensions].keys + config[:keywords].keys).uniq
+    end
+
+    def handle_empty_files
+      puts I18n.t('organizer.no_files')
+    end
+
+    def print_completion_message
+      puts "\n#{I18n.t('organizer.completed')}"
+    end
+
+    def organize_files(files, config, dry_run)
+      files.each do |file_path|
+        destination_dir = determine_destination(file_path, config)
+        next unless destination_dir
+
+        @file_mover.move_file(file_path, destination_dir, dry_run: dry_run)
+      end
+    end
+
+    def determine_destination(file_path, config)
+      filename = File.basename(file_path)
+      extension = extract_extension(file_path)
+
+      find_by_keyword(filename, config[:keywords]) ||
+        find_by_extension(extension, config[:extensions])
+    end
+
+    def extract_extension(file_path)
+      File.extname(file_path).delete('.').downcase
+    end
+
+    def find_by_keyword(filename, keywords_config)
+      keywords_config.each do |dir, keywords|
+        return dir if keywords.any? { |kw| filename.include?(kw) }
+      end
+      nil
+    end
+
+    def find_by_extension(extension, extensions_config)
+      extensions_config.each do |dir, extensions|
+        return dir if extensions.include?(extension)
+      end
+      nil
+    end
+
+    def cleanup_empty_directories
+      Dir.glob(File.join(@target_dir, '**/*')).reverse_each do |path|
+        next unless should_cleanup?(path)
+
+        remove_empty_directory(path)
+      end
+    end
+
+    def should_cleanup?(path)
+      File.directory?(path) &&
+        path != @target_dir &&
+        !@organized_dirs.include?(File.basename(path)) &&
+        Dir.empty?(path)
+    end
+
+    def remove_empty_directory(path)
+      Dir.rmdir(path)
+      relative = relative_path(path, @target_dir)
+      puts I18n.t('organizer.cleaned_up', dir: relative)
+    end
+  end
+end

data/lib/tidy_file_organizer/post_install.rb

@@ -0,0 +1,31 @@
+require 'fileutils'
+require_relative 'i18n'
+
+module TidyFileOrganizer
+  class PostInstall
+    CONFIG_DIR = File.expand_path('~/.config/tidy-file-organizer').freeze
+    DEFAULT_CONFIG_PATH = File.join(CONFIG_DIR, 'default.yml').freeze
+    DEFAULT_CONFIG_JA_PATH = File.join(CONFIG_DIR, 'default.ja.yml').freeze
+
+    def self.run
+      FileUtils.mkdir_p(CONFIG_DIR)
+
+      # 英語版（デフォルト）
+      source = File.expand_path('../../config/default.yml', __dir__)
+      unless File.exist?(DEFAULT_CONFIG_PATH)
+        FileUtils.cp(source, DEFAULT_CONFIG_PATH)
+        puts I18n.t('post_install.created_default_en', path: DEFAULT_CONFIG_PATH)
+      end
+
+      # 日本語版
+      source_ja = File.expand_path('../../config/default.ja.yml', __dir__)
+      unless File.exist?(DEFAULT_CONFIG_JA_PATH)
+        FileUtils.cp(source_ja, DEFAULT_CONFIG_JA_PATH)
+        puts I18n.t('post_install.created_default_ja', path: DEFAULT_CONFIG_JA_PATH)
+      end
+    end
+  end
+end
+
+# Auto-execute on gem install
+TidyFileOrganizer::PostInstall.run if __FILE__ == $PROGRAM_NAME