RubyGems - file_tree_visualizer - Versions diffs - 0.0.3 → 0.2.0 - Mend

file_tree_visualizer 0.0.3 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

checksums.yaml +4 -4
data/Gemfile +2 -0
data/README.md +111 -23
data/Rakefile +8 -0
data/file_tree_visualizer.gemspec +22 -20
data/lib/file_tree_visualizer/cli.rb +188 -34
data/lib/file_tree_visualizer/i18n.rb +205 -0
data/lib/file_tree_visualizer/report_builder.rb +50 -20
data/lib/file_tree_visualizer/scanner.rb +30 -4
data/lib/file_tree_visualizer/version.rb +1 -1
data/lib/file_tree_visualizer.rb +5 -4
metadata +23 -7

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9ec7a6ef5ea0597b5efc056da74912985e0ca2f9a784398c13aa83b5e95c5a6
-  data.tar.gz: f3a9a8ee8fb984e8b135fefbe9db34b9e8f5df19ccf787538a754b975b5c9022
+  metadata.gz: b43d301f84619b7a620a0cbcef1d135d4906073efaecf03b737b43572ebd6d89
+  data.tar.gz: 65de782e8d5094d981f0bedd23e6307d1b6cd4eedebd6b8bbb412a9b303e330e
 SHA512:
-  metadata.gz: f902440430610f789db16ab282b2890e3569fa354691ee74dd1587539ad299aa2b7db9c66890496fd46429e1369da7b5d84db95b6c1614977559ffbef3b99c68
-  data.tar.gz: 9571ce07d3162b7e5477ae40f1a844c61e2ac476780e1665300778e1d811500b1b288e064b376e86a2f2305e1fad3e54a3a2dbbd80c106459f8638d4d96b835c
+  metadata.gz: f6a58da21e94d26fd62fa5a05bc5d0946a16525c187f021e7184b010515051f346b2c8786067879c278c34ca3abfbe61dc416f1a2bd170201654c71d477bffd0
+  data.tar.gz: ba3cb73876856ee460c66f1b34a61f1965cb6deda2021f52dba5904a8500b995e8cd4c28fd91bb1f388462a88c2d62e381024e94d1430dfaf591555344c674a8

data/Gemfile CHANGED Viewed

@@ -3,3 +3,5 @@
 source "https://rubygems.org"
 gemspec
+gem "rake", "~> 13.0"
+gem "minitest", "~> 5.20"

data/README.md CHANGED Viewed

@@ -1,44 +1,132 @@
 # file_tree_visualizer
-Gema Ruby para escanear árboles de archivos desde terminal y generar un reporte HTML interactivo 100% offline con los elementos que más espacio ocupan.
+[![CI](https://github.com/JohnBidwellB/file-tree-visualizer/actions/workflows/release.yml/badge.svg)](https://github.com/JohnBidwellB/file-tree-visualizer/actions/workflows/release.yml)
+[![RubyGems](https://badge.fury.io/rb/file_tree_visualizer.svg)](https://rubygems.org/gems/file_tree_visualizer)
-## Qué hace
+Ruby gem to scan file trees from the terminal and generate a fully offline interactive HTML report with the items that consume the most disk space.
-- Recorre recursivamente una carpeta.
-- Calcula tamaño acumulado por directorio y tamaño por archivo.
-- Genera un reporte HTML con:
-  - Árbol de archivos expandible/colapsable.
-  - Filtros por texto y tamaño mínimo.
-  - Ranking de archivos más pesados.
-  - Sin dependencias externas (funciona sin internet).
+## What it does
-## Uso rápido (sin instalar la gema)
+- Recursively scans a directory.
+- Computes cumulative size per directory and size per file.
+- Generates an HTML report with:
+  - Expand/collapse file tree.
+  - Text and minimum-size filters.
+  - Ranking of the largest files.
+  - No external dependencies (works offline).
+## Quick usage (without installing the gem)
+```bash
+ruby bin/file-tree-visualizer /path/to/scan -o report.html
+```
+## Install from RubyGems
+Gem page: https://rubygems.org/gems/file_tree_visualizer
 ```bash
-ruby bin/file-tree-visualizer /ruta/a/escanear -o reporte.html
+gem install file_tree_visualizer
+file-tree-visualizer /path/to/scan -o report.html
 ```
-## Uso como gema
+Install a specific version:
+```bash
+gem install file_tree_visualizer -v 0.2.0
+```
+## Local development install
 ```bash
 bundle install
 gem build file_tree_visualizer.gemspec
-gem install ./file_tree_visualizer-0.0.3.gem
-file-tree-visualizer /ruta/a/escanear -o reporte.html
+gem install ./file_tree_visualizer-0.2.0.gem
+file-tree-visualizer /path/to/scan -o report.html
+```
+## Options
+```bash
+file-tree-visualizer [path] [options]
+If no `path` is provided, the current directory is scanned by default.
+During scanning, an interactive terminal shows a progress bar with processed files/directories vs discovered totals.
+    -o, --output FILE           Output HTML file (default: file-tree-report.html)
+    -t, --top N                 Number of largest files to keep in ranking (default: 200)
+        --follow-symlinks       Follow symbolic links
+        --no-progress           Disable progress bar
+        --exclude PATTERNS      Exclude patterns (comma-separated or repeated)
+        --summary               Print summary to terminal
+        --json FILE             Export full result as JSON
+        --csv FILE              Export top files as CSV
+        --lang LANG             Language for CLI and report (en|es)
+    -h, --help                  Show help
+Language resolution priority:
+- `--lang`
+- `LANG` environment variable (for example `es_CL.UTF-8`)
+- fallback to English (`en`)
 ```
-## Opciones
+## Common workflows
+Summary only (no HTML file generated unless `--output` is explicitly provided):
 ```bash
-file-tree-visualizer [ruta] [opciones]
+file-tree-visualizer --summary
+```
-Si no indicas `ruta`, se escanea el directorio actual por defecto.
+Summary + HTML report:
-Durante el escaneo, en terminal interactiva se muestra una barra de progreso con archivos y directorios procesados vs total detectado.
+```bash
+file-tree-visualizer . --summary --output report.html
+```
-    -o, --output FILE           Archivo HTML de salida (default: file-tree-report.html)
-    -t, --top N                 Cantidad de archivos pesados a guardar en ranking (default: 200)
-        --follow-symlinks       Sigue enlaces simbólicos
-        --no-progress           Desactiva la barra de progreso
-    -h, --help                  Muestra ayuda
+Exclude directories and files by pattern:
+```bash
+file-tree-visualizer . --exclude "node_modules,.git,*.log" --exclude "tmp/**"
+```
+Export JSON and CSV in one run:
+```bash
+file-tree-visualizer . --summary --json scan.json --csv top-files.csv
+```
+## Contributing
+1. Create a feature branch from `main`.
+2. Implement your change and run tests locally.
+3. Push your branch and open a Pull Request.
+4. Wait for CI to pass and at least one approval.
+```bash
+git checkout -b feat/short-description
+bundle exec rake test
+git push origin feat/short-description
+```
+Branch policy:
+- For collaborators, `main` is protected and requires PR + CI + approval.
+- Repository admins can bypass these rules when needed.
+## Automatic release to RubyGems
+- This repository publishes the gem automatically when pushing a tag with format `v*` (for example `v0.2.0`).
+- Before using it, configure the `RUBYGEMS_API_KEY` secret in GitHub Actions.
+- You can also trigger the workflow manually from GitHub Actions (`workflow_dispatch`).
+```bash
+git tag v0.2.0
+git push origin v0.2.0
+```
+Reusable release notes template:
+```bash
+gh release create v0.2.0 --title "v0.2.0" --notes-file .github/release-template.md
 ```

data/Rakefile CHANGED Viewed

@@ -1,3 +1,11 @@
 # frozen_string_literal: true
 require "bundler/gem_tasks"
+require "rake/testtask"
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+end
+task default: :test

data/file_tree_visualizer.gemspec CHANGED Viewed

@@ -1,33 +1,35 @@
 # frozen_string_literal: true
-require_relative "lib/file_tree_visualizer/version"
+require_relative 'lib/file_tree_visualizer/version'
 Gem::Specification.new do |spec|
-  spec.name = "file_tree_visualizer"
+  spec.name = 'file_tree_visualizer'
   spec.version = FileTreeVisualizer::VERSION
-  spec.authors = ["jbidwell1"]
-  spec.email = ["devnull@example.com"]
+  spec.authors = ['John Bidwell']
+  spec.email = ['johnbidwellb@gmail.com']
-  spec.summary = "CLI Ruby tool to analyze file sizes and generate an interactive HTML report."
-  spec.description = "Scans a directory recursively, computes file/directory sizes, and generates an HTML report rendered with React."
-  spec.homepage = "https://example.com/file_tree_visualizer"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.7"
+  spec.summary = 'CLI Ruby tool to analyze file sizes and generate an interactive HTML report.'
+  spec.description = 'Scans a directory recursively, computes file/directory sizes, and generates an HTML report rendered with React.'
+  spec.homepage = 'https://github.com/JohnBidwellB/file-tree-visualizer'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.7'
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata['source_code_uri'] = "#{spec.homepage}/tree/main"
+  spec.metadata['bug_tracker_uri'] = "#{spec.homepage}/issues"
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
   spec.files = Dir.chdir(__dir__) do
     Dir[
-      "README.md",
-      "Gemfile",
-      "Rakefile",
-      "bin/*",
-      "lib/**/*.rb",
-      "file_tree_visualizer.gemspec"
+      'README.md',
+      'Gemfile',
+      'Rakefile',
+      'bin/*',
+      'lib/**/*.rb',
+      'file_tree_visualizer.gemspec'
     ]
   end
-  spec.bindir = "bin"
-  spec.executables = ["file-tree-visualizer"]
-  spec.require_paths = ["lib"]
+  spec.bindir = 'bin'
+  spec.executables = ['file-tree-visualizer']
+  spec.require_paths = ['lib']
+  spec.add_dependency 'csv', '~> 3.3'
 end

data/lib/file_tree_visualizer/cli.rb CHANGED Viewed

@@ -1,42 +1,64 @@
 # frozen_string_literal: true
-require "optparse"
+require 'optparse'
+require 'csv'
+require 'json'
 module FileTreeVisualizer
   class CLI
-    DEFAULT_OUTPUT = "file-tree-report.html"
+    DEFAULT_OUTPUT = 'file-tree-report.html'
+    DEFAULT_LOCALE = 'en'
     def initialize(argv)
       @argv = argv
     end
     def run
-      options, parser = parse_options(@argv.dup)
+      options, parser, locale = parse_options(@argv.dup)
       if options[:help]
         puts parser
         return 0
       end
-      scanner = Scanner.new(top_limit: options[:top], follow_symlinks: options[:follow_symlinks])
-      progress = ProgressRenderer.new(enabled: options[:progress])
+      expanded_path = File.expand_path(options[:path])
+      unless File.directory?(expanded_path)
+        raise ArgumentError,
+              t(locale, 'cli.errors.invalid_directory', path: expanded_path)
+      end
+      scanner = Scanner.new(
+        top_limit: options[:top],
+        follow_symlinks: options[:follow_symlinks],
+        excludes: options[:exclude_patterns]
+      )
+      progress = ProgressRenderer.new(enabled: options[:progress], locale: locale)
       callback = options[:progress] ? progress.method(:render) : nil
-      result = scanner.scan(options[:path], progress: callback)
+      result = scanner.scan(expanded_path, progress: callback)
       progress.finish
-      report = ReportBuilder.new(result: result, source_path: options[:path]).build
-      output_path = File.expand_path(options[:output])
-      File.write(output_path, report)
-      puts "Reporte generado en: #{output_path}"
-      puts "Escaneado: #{result.stats[:directories]} directorios, #{result.stats[:files]} archivos, #{result.stats[:skipped]} omitidos."
-      puts "Tamaño total: #{format_bytes(result.stats[:bytes])}"
+      generated_at = Time.now.utc
+      output_path = maybe_write_report(options, expanded_path, result, locale, generated_at)
+      json_path = write_json_export(options[:json_output], expanded_path, result, locale, generated_at)
+      csv_path = write_csv_export(options[:csv_output], result)
+      print_summary(expanded_path, result, locale) if options[:summary]
+      puts t(locale, 'cli.messages.report_generated', path: output_path) if output_path
+      puts t(locale, 'cli.messages.json_generated', path: json_path) if json_path
+      puts t(locale, 'cli.messages.csv_generated', path: csv_path) if csv_path
+      unless options[:summary]
+        puts t(locale, 'cli.messages.scanned',
+               directories: result.stats[:directories],
+               files: result.stats[:files],
+               skipped: result.stats[:skipped])
+      end
+      puts t(locale, 'cli.messages.total_size', size: format_bytes(result.stats[:bytes])) unless options[:summary]
       0
     rescue OptionParser::ParseError, ArgumentError => e
+      locale = error_locale
       warn e.message
-      warn "Usa --help para ver las opciones disponibles."
+      warn t(locale, 'cli.errors.use_help')
       1
     rescue StandardError => e
-      warn "Error inesperado: #{e.message}"
+      locale = error_locale
+      warn t(locale, 'cli.errors.unexpected', message: e.message)
       1
     end
@@ -45,9 +67,10 @@ module FileTreeVisualizer
     class ProgressRenderer
       BAR_WIDTH = 28
-      def initialize(io: $stdout, enabled: true)
+      def initialize(io: $stdout, enabled: true, locale: DEFAULT_LOCALE)
         @io = io
         @enabled = enabled && io.tty?
+        @locale = locale
         @last_draw_at = nil
         @has_rendered = false
         @spinner_index = 0
@@ -82,7 +105,7 @@ module FileTreeVisualizer
       def render_counting(data)
         spinner = %w[| / - \\][@spinner_index % 4]
         @spinner_index += 1
-        @io.print(format("\rPreparando escaneo %<spinner>s Arch:%<files>d Dir:%<dirs>d",
+        @io.print(format("\r#{I18n.t(@locale, 'cli.progress.preparing')}",
                          spinner: spinner,
                          files: data.fetch(:discovered_files, 0),
                          dirs: data.fetch(:discovered_directories, 0)))
@@ -102,9 +125,9 @@ module FileTreeVisualizer
         empty = BAR_WIDTH - filled
         percent = progress_ratio * 100
-        @io.print(format("\rEscaneando [%<bar>s] %<percent>6.2f%% Arch:%<pf>d/%<tf>d Dir:%<pd>d/%<td>d",
-                         bar: ("#" * filled) + ("-" * empty),
-                         percent: percent,
+        @io.print(format("\r#{I18n.t(@locale, 'cli.progress.scanning')}",
+                         bar: ('#' * filled) + ('-' * empty),
+                         percent: format('%6.2f', percent),
                          pf: processed_files,
                          tf: total_files,
                          pd: processed_directories,
@@ -113,46 +136,110 @@ module FileTreeVisualizer
     end
     def parse_options(argv)
+      locale = I18n.resolve_locale(cli_value: extract_lang_argument(argv), env_lang: ENV['LANG'])
       options = {
         path: Dir.pwd,
         output: DEFAULT_OUTPUT,
         top: Scanner::DEFAULT_TOP_LIMIT,
         follow_symlinks: false,
         progress: true,
+        summary: false,
+        output_given: false,
+        json_output: nil,
+        csv_output: nil,
+        exclude_patterns: [],
+        lang: nil,
         help: false
       }
-      parser = OptionParser.new do |opts|
-        opts.banner = "Uso: file-tree-visualizer [ruta] [opciones]"
-        opts.separator ""
-        opts.separator "Opciones:"
+      parser = build_parser(locale, options)
+      remaining = parser.parse(argv)
+      if options[:lang] && !I18n.supported_locale?(options[:lang])
+        raise ArgumentError, t(locale,
+                               'cli.errors.invalid_lang',
+                               lang: options[:lang],
+                               supported: I18n::SUPPORTED_LOCALES.join(', '))
+      end
+      locale = I18n.resolve_locale(cli_value: options[:lang], env_lang: ENV['LANG'])
+      parser = build_parser(locale, options)
-        opts.on("-o", "--output FILE", "Archivo HTML de salida (default: #{DEFAULT_OUTPUT})") do |value|
+      options[:path] = File.expand_path(remaining.first || options[:path])
+      raise ArgumentError, t(locale, 'cli.errors.invalid_top') unless options[:top].positive?
+      [options, parser, locale]
+    end
+    def build_parser(locale, options)
+      OptionParser.new do |opts|
+        opts.banner = t(locale, 'cli.banner')
+        opts.separator ''
+        opts.separator t(locale, 'cli.options_header')
+        opts.on('-o', '--output FILE', t(locale, 'cli.output_option', default: DEFAULT_OUTPUT)) do |value|
           options[:output] = value
+          options[:output_given] = true
         end
-        opts.on("-t", "--top N", Integer, "Cantidad de archivos pesados en ranking (default: #{Scanner::DEFAULT_TOP_LIMIT})") do |value|
+        opts.on('-t', '--top N', Integer, t(locale, 'cli.top_option', default: Scanner::DEFAULT_TOP_LIMIT)) do |value|
           options[:top] = value
         end
-        opts.on("--follow-symlinks", "Sigue enlaces simbólicos durante el escaneo") do
+        opts.on('--follow-symlinks', t(locale, 'cli.follow_symlinks_option')) do
           options[:follow_symlinks] = true
         end
-        opts.on("--no-progress", "Desactiva la barra de progreso") do
+        opts.on('--no-progress', t(locale, 'cli.no_progress_option')) do
           options[:progress] = false
         end
-        opts.on("-h", "--help", "Muestra esta ayuda") do
+        opts.on('--exclude PATTERNS', t(locale, 'cli.exclude_option')) do |value|
+          options[:exclude_patterns].concat(split_patterns(value))
+        end
+        opts.on('--summary', t(locale, 'cli.summary_option')) do
+          options[:summary] = true
+        end
+        opts.on('--json FILE', t(locale, 'cli.json_option')) do |value|
+          options[:json_output] = value
+        end
+        opts.on('--csv FILE', t(locale, 'cli.csv_option')) do |value|
+          options[:csv_output] = value
+        end
+        opts.on('--lang LANG', t(locale, 'cli.lang_option')) do |value|
+          options[:lang] = value
+        end
+        opts.on('-h', '--help', t(locale, 'cli.help_option')) do
           options[:help] = true
         end
       end
+    end
+    def extract_lang_argument(argv)
+      argv.each_with_index do |arg, index|
+        return arg.split('=', 2).last if arg.start_with?('--lang=')
+        next unless arg == '--lang'
+        return argv[index + 1]
+      end
+      nil
+    end
-      remaining = parser.parse(argv)
-      options[:path] = File.expand_path(remaining.first || options[:path])
-      raise ArgumentError, "--top debe ser mayor que 0" unless options[:top].positive?
+    def split_patterns(value)
+      value.to_s.split(',').map(&:strip).reject(&:empty?)
+    end
-      [options, parser]
+    def t(locale, key, **vars)
+      I18n.t(locale, key, **vars)
+    end
+    def error_locale
+      I18n.resolve_locale(cli_value: extract_lang_argument(@argv), env_lang: ENV['LANG'])
     end
     def format_bytes(bytes)
@@ -170,5 +257,72 @@ module FileTreeVisualizer
       precision = value < 10 ? 2 : 1
       format("%.#{precision}f %s", value, units[unit_index])
     end
+    def maybe_write_report(options, source_path, result, locale, generated_at)
+      should_write = !options[:summary] || options[:output_given]
+      return nil unless should_write
+      report = ReportBuilder.new(
+        result: result,
+        source_path: source_path,
+        locale: locale,
+        generated_at: generated_at
+      ).build
+      output_path = File.expand_path(options[:output])
+      File.write(output_path, report)
+      output_path
+    end
+    def write_json_export(target_path, source_path, result, locale, generated_at)
+      return nil unless target_path
+      output_path = File.expand_path(target_path)
+      payload = {
+        source_path: source_path,
+        generated_at: generated_at.iso8601,
+        locale: locale,
+        version: FileTreeVisualizer::VERSION,
+        stats: result.stats,
+        root: result.root,
+        top_files: result.top_files
+      }
+      File.write(output_path, JSON.pretty_generate(payload))
+      output_path
+    end
+    def write_csv_export(target_path, result)
+      return nil unless target_path
+      output_path = File.expand_path(target_path)
+      CSV.open(output_path, 'w') do |csv|
+        csv << %w[rank path name size_bytes size_human]
+        result.top_files.each_with_index do |item, index|
+          csv << [index + 1, item[:path], item[:name], item[:size], format_bytes(item[:size])]
+        end
+      end
+      output_path
+    end
+    def print_summary(source_path, result, locale)
+      puts t(locale, 'cli.summary.heading')
+      puts t(locale, 'cli.summary.source', path: source_path)
+      puts t(locale, 'cli.summary.total_size', size: format_bytes(result.stats[:bytes]))
+      puts t(locale, 'cli.summary.files', count: result.stats[:files])
+      puts t(locale, 'cli.summary.directories', count: result.stats[:directories])
+      puts t(locale, 'cli.summary.skipped', count: result.stats[:skipped])
+      puts t(locale, 'cli.summary.top_files')
+      if result.top_files.empty?
+        puts "  #{t(locale, 'cli.summary.none')}"
+        return
+      end
+      result.top_files.each_with_index do |item, index|
+        puts format('  %<rank>d. %<size>s  %<path>s',
+                    rank: index + 1,
+                    size: format_bytes(item[:size]),
+                    path: item[:path])
+      end
+    end
   end
 end

data/lib/file_tree_visualizer/i18n.rb ADDED Viewed

@@ -0,0 +1,205 @@
+# frozen_string_literal: true
+module FileTreeVisualizer
+  module I18n
+    SUPPORTED_LOCALES = %w[en es].freeze
+    TRANSLATIONS = {
+      'en' => {
+        'cli' => {
+          'banner' => 'Usage: file-tree-visualizer [path] [options]',
+          'options_header' => 'Options:',
+          'output_option' => 'Output HTML file (default: %<default>s)',
+          'top_option' => 'Number of largest files in ranking (default: %<default>s)',
+          'follow_symlinks_option' => 'Follow symbolic links during scan',
+          'no_progress_option' => 'Disable progress bar',
+          'exclude_option' => 'Exclude patterns (comma-separated or repeated)',
+          'summary_option' => 'Print terminal summary',
+          'json_option' => 'Export scan result as JSON',
+          'csv_option' => 'Export top files as CSV',
+          'lang_option' => 'Language for CLI and report (en|es)',
+          'help_option' => 'Show this help',
+          'messages' => {
+            'report_generated' => 'Report generated at: %<path>s',
+            'json_generated' => 'JSON exported at: %<path>s',
+            'csv_generated' => 'CSV exported at: %<path>s',
+            'scanned' => 'Scanned: %<directories>s directories, %<files>s files, %<skipped>s skipped.',
+            'total_size' => 'Total size: %<size>s'
+          },
+          'errors' => {
+            'invalid_top' => '--top must be greater than 0',
+            'invalid_lang' => "Unsupported language '%<lang>s'. Supported values: %<supported>s",
+            'invalid_directory' => 'Path is not a directory: %<path>s',
+            'use_help' => 'Use --help to see available options.',
+            'unexpected' => 'Unexpected error: %<message>s'
+          },
+          'progress' => {
+            'preparing' => 'Preparing scan %<spinner>s Files:%<files>s Dirs:%<dirs>s',
+            'scanning' => 'Scanning [%<bar>s] %<percent>s%% Files:%<pf>s/%<tf>s Dirs:%<pd>s/%<td>s'
+          },
+          'summary' => {
+            'heading' => 'Summary',
+            'source' => 'Source: %<path>s',
+            'total_size' => 'Total size: %<size>s',
+            'files' => 'Files: %<count>s',
+            'directories' => 'Directories: %<count>s',
+            'skipped' => 'Skipped entries: %<count>s',
+            'top_files' => 'Top files:',
+            'none' => '(none)'
+          }
+        },
+        'report' => {
+          'page_title' => 'File Report',
+          'header_title' => 'Disk usage report',
+          'meta_source_prefix' => 'Source: ',
+          'meta_generated_prefix' => 'Generated: ',
+          'stats' => {
+            'total_size' => 'Total size',
+            'files' => 'Files',
+            'directories' => 'Directories',
+            'skipped' => 'Skipped entries'
+          },
+          'filters' => {
+            'search_label' => 'Search by name/path',
+            'search_placeholder' => 'eg: node_modules, .mp4, backup',
+            'min_size_label' => 'Minimum size (MB)',
+            'min_size_hint' => 'Filters tree nodes and ranking by minimum size.'
+          },
+          'panels' => {
+            'tree' => 'File tree',
+            'top_files' => 'Top largest files'
+          },
+          'table' => {
+            'index' => '#',
+            'size' => 'Size',
+            'path' => 'Path'
+          },
+          'empty' => {
+            'tree' => 'No results with current filters.',
+            'top_files' => 'No files to show with current filters.'
+          }
+        }
+      },
+      'es' => {
+        'cli' => {
+          'banner' => 'Uso: file-tree-visualizer [ruta] [opciones]',
+          'options_header' => 'Opciones:',
+          'output_option' => 'Archivo HTML de salida (default: %<default>s)',
+          'top_option' => 'Cantidad de archivos pesados en ranking (default: %<default>s)',
+          'follow_symlinks_option' => 'Sigue enlaces simbólicos durante el escaneo',
+          'no_progress_option' => 'Desactiva la barra de progreso',
+          'exclude_option' => 'Excluye patrones (separados por coma o repetidos)',
+          'summary_option' => 'Imprime resumen en terminal',
+          'json_option' => 'Exporta resultado del escaneo como JSON',
+          'csv_option' => 'Exporta top de archivos como CSV',
+          'lang_option' => 'Idioma para CLI y reporte (en|es)',
+          'help_option' => 'Muestra esta ayuda',
+          'messages' => {
+            'report_generated' => 'Reporte generado en: %<path>s',
+            'json_generated' => 'JSON exportado en: %<path>s',
+            'csv_generated' => 'CSV exportado en: %<path>s',
+            'scanned' => 'Escaneado: %<directories>s directorios, %<files>s archivos, %<skipped>s omitidos.',
+            'total_size' => 'Tamano total: %<size>s'
+          },
+          'errors' => {
+            'invalid_top' => '--top debe ser mayor que 0',
+            'invalid_lang' => "Idioma no soportado '%<lang>s'. Valores permitidos: %<supported>s",
+            'invalid_directory' => 'La ruta no es un directorio: %<path>s',
+            'use_help' => 'Usa --help para ver las opciones disponibles.',
+            'unexpected' => 'Error inesperado: %<message>s'
+          },
+          'progress' => {
+            'preparing' => 'Preparando escaneo %<spinner>s Arch:%<files>s Dir:%<dirs>s',
+            'scanning' => 'Escaneando [%<bar>s] %<percent>s%% Arch:%<pf>s/%<tf>s Dir:%<pd>s/%<td>s'
+          },
+          'summary' => {
+            'heading' => 'Resumen',
+            'source' => 'Origen: %<path>s',
+            'total_size' => 'Tamano total: %<size>s',
+            'files' => 'Archivos: %<count>s',
+            'directories' => 'Directorios: %<count>s',
+            'skipped' => 'Entradas omitidas: %<count>s',
+            'top_files' => 'Top archivos:',
+            'none' => '(ninguno)'
+          }
+        },
+        'report' => {
+          'page_title' => 'Reporte de archivos',
+          'header_title' => 'Reporte de espacio en disco',
+          'meta_source_prefix' => 'Origen: ',
+          'meta_generated_prefix' => 'Generado: ',
+          'stats' => {
+            'total_size' => 'Tamano total',
+            'files' => 'Archivos',
+            'directories' => 'Directorios',
+            'skipped' => 'Entradas omitidas'
+          },
+          'filters' => {
+            'search_label' => 'Buscar por nombre/ruta',
+            'search_placeholder' => 'ej: node_modules, .mp4, backup',
+            'min_size_label' => 'Tamano minimo (MB)',
+            'min_size_hint' => 'Filtra nodos y ranking por tamano minimo.'
+          },
+          'panels' => {
+            'tree' => 'Arbol de archivos',
+            'top_files' => 'Top archivos mas pesados'
+          },
+          'table' => {
+            'index' => '#',
+            'size' => 'Tamano',
+            'path' => 'Ruta'
+          },
+          'empty' => {
+            'tree' => 'Sin resultados con los filtros actuales.',
+            'top_files' => 'Sin archivos para mostrar con los filtros actuales.'
+          }
+        }
+      }
+    }.freeze
+    module_function
+    def supported_locale?(value)
+      SUPPORTED_LOCALES.include?(normalize_locale(value))
+    end
+    def resolve_locale(cli_value: nil, env_lang: nil)
+      normalize_locale(cli_value) || normalize_locale(env_lang) || 'en'
+    end
+    def normalize_locale(value)
+      return nil if value.nil?
+      normalized = value.to_s.strip.downcase
+      return nil if normalized.empty?
+      return 'es' if normalized.start_with?('es')
+      return 'en' if normalized.start_with?('en')
+      nil
+    end
+    def t(locale, key, **vars)
+      template = lookup(locale, key) || lookup('en', key)
+      return key unless template.is_a?(String)
+      return template if vars.empty?
+      template % vars.transform_keys(&:to_sym)
+    rescue KeyError
+      template
+    end
+    def lookup(locale, key)
+      current = TRANSLATIONS[locale]
+      return nil unless current
+      key.to_s.split('.').each do |part|
+        return nil unless current.is_a?(Hash)
+        current = current[part]
+      end
+      current
+    end
+  end
+end

data/lib/file_tree_visualizer/report_builder.rb CHANGED Viewed

@@ -1,25 +1,27 @@
 # frozen_string_literal: true
-require "json"
-require "time"
+require 'json'
+require 'time'
 module FileTreeVisualizer
   class ReportBuilder
-    def initialize(result:, source_path:, generated_at: Time.now.utc)
+    def initialize(result:, source_path:, generated_at: Time.now.utc, locale: 'en')
       @result = result
       @source_path = File.expand_path(source_path.to_s)
       @generated_at = generated_at
+      @locale = I18n.resolve_locale(cli_value: locale)
     end
     def build
-      payload_json = JSON.generate(payload).gsub("</", "<\\/")
+      payload_json = JSON.generate(payload).gsub('</', '<\\/')
+      translations_json = JSON.generate(translation_payload).gsub('</', '<\\/')
       <<~HTML
         <!doctype html>
-        <html lang="es">
+        <html lang="#{@locale}">
           <head>
             <meta charset="utf-8" />
             <meta name="viewport" content="width=device-width, initial-scale=1" />
-            <title>Reporte de archivos</title>
+            <title>#{t('report.page_title')}</title>
             <style>
               :root {
                 color-scheme: dark;
@@ -215,6 +217,7 @@ module FileTreeVisualizer
             <script>
               (function () {
                 const data = JSON.parse(document.getElementById("scan-data").textContent);
+                const i18n = #{translations_json};
                 const app = document.getElementById("app");
                 const state = {
@@ -256,31 +259,31 @@ module FileTreeVisualizer
                   '<div class="container">',
                   '  <header class="header">',
                   '    <div>',
-                  '      <h1>Reporte de espacio en disco</h1>',
+                  '      <h1>' + i18n.headerTitle + '</h1>',
                   '      <div class="meta" id="meta-source"></div>',
                   '      <div class="meta" id="meta-generated"></div>',
                   '    </div>',
                   '  </header>',
                   '  <section class="stats">',
-                  '    <div class="stat"><div class="stat-label">Tamaño total</div><div class="stat-value" id="stat-bytes"></div></div>',
-                  '    <div class="stat"><div class="stat-label">Archivos</div><div class="stat-value" id="stat-files"></div></div>',
-                  '    <div class="stat"><div class="stat-label">Directorios</div><div class="stat-value" id="stat-directories"></div></div>',
-                  '    <div class="stat"><div class="stat-label">Entradas omitidas</div><div class="stat-value" id="stat-skipped"></div></div>',
+                  '    <div class="stat"><div class="stat-label">' + i18n.statsTotalSize + '</div><div class="stat-value" id="stat-bytes"></div></div>',
+                  '    <div class="stat"><div class="stat-label">' + i18n.statsFiles + '</div><div class="stat-value" id="stat-files"></div></div>',
+                  '    <div class="stat"><div class="stat-label">' + i18n.statsDirectories + '</div><div class="stat-value" id="stat-directories"></div></div>',
+                  '    <div class="stat"><div class="stat-label">' + i18n.statsSkipped + '</div><div class="stat-value" id="stat-skipped"></div></div>',
                   '  </section>',
                   '  <section class="filters">',
-                  '    <label>Buscar por nombre/ruta<input id="query-input" type="text" placeholder="ej: node_modules, .mp4, backup" /></label>',
-                  '    <label>Tamaño mínimo (MB)<input id="min-size-input" type="number" min="0" value="0" /><span class="hint">Filtra nodos y ranking por tamaño mínimo.</span></label>',
+                  '    <label>' + i18n.searchLabel + '<input id="query-input" type="text" placeholder="' + i18n.searchPlaceholder + '" /></label>',
+                  '    <label>' + i18n.minSizeLabel + '<input id="min-size-input" type="number" min="0" value="0" /><span class="hint">' + i18n.minSizeHint + '</span></label>',
                   '  </section>',
                   '  <section class="layout">',
                   '    <article class="panel">',
-                  '      <h2>Árbol de archivos</h2>',
+                  '      <h2>' + i18n.treeTitle + '</h2>',
                   '      <div class="panel-body" id="tree-panel"></div>',
                   '    </article>',
                   '    <article class="panel">',
-                  '      <h2>Top archivos más pesados</h2>',
+                  '      <h2>' + i18n.topFilesTitle + '</h2>',
                   '      <div class="panel-body">',
                   '        <table>',
-                  '          <thead><tr><th>#</th><th>Tamaño</th><th>Ruta</th></tr></thead>',
+                  '          <thead><tr><th>' + i18n.tableIndex + '</th><th>' + i18n.tableSize + '</th><th>' + i18n.tablePath + '</th></tr></thead>',
                   '          <tbody id="top-files-body"></tbody>',
                   '        </table>',
                   '      </div>',
@@ -294,8 +297,8 @@ module FileTreeVisualizer
                 const treePanel = document.getElementById("tree-panel");
                 const topFilesBody = document.getElementById("top-files-body");
-                document.getElementById("meta-source").textContent = "Origen: " + data.source_path;
-                document.getElementById("meta-generated").textContent = "Generado: " + data.generated_at;
+                document.getElementById("meta-source").textContent = i18n.metaSourcePrefix + data.source_path;
+                document.getElementById("meta-generated").textContent = i18n.metaGeneratedPrefix + data.generated_at;
                 document.getElementById("stat-bytes").textContent = formatBytes(data.stats.bytes);
                 document.getElementById("stat-files").textContent = formatNumber(data.stats.files);
                 document.getElementById("stat-directories").textContent = formatNumber(data.stats.directories);
@@ -365,7 +368,7 @@ module FileTreeVisualizer
                   if (!nodeMatches(data.root, activeFilters.query, activeFilters.minBytes)) {
                     const empty = document.createElement("div");
                     empty.className = "empty-state";
-                    empty.textContent = "Sin resultados con los filtros actuales.";
+                    empty.textContent = i18n.emptyTree;
                     treePanel.appendChild(empty);
                     return;
                   }
@@ -384,7 +387,7 @@ module FileTreeVisualizer
                     const cell = document.createElement("td");
                     cell.colSpan = 3;
                     cell.className = "empty-state";
-                    cell.textContent = "Sin archivos para mostrar con los filtros actuales.";
+                    cell.textContent = i18n.emptyTopFiles;
                     emptyRow.appendChild(cell);
                     topFilesBody.appendChild(emptyRow);
                     return;
@@ -439,5 +442,32 @@ module FileTreeVisualizer
         top_files: @result.top_files
       }
     end
+    def translation_payload
+      {
+        headerTitle: t('report.header_title'),
+        metaSourcePrefix: t('report.meta_source_prefix'),
+        metaGeneratedPrefix: t('report.meta_generated_prefix'),
+        statsTotalSize: t('report.stats.total_size'),
+        statsFiles: t('report.stats.files'),
+        statsDirectories: t('report.stats.directories'),
+        statsSkipped: t('report.stats.skipped'),
+        searchLabel: t('report.filters.search_label'),
+        searchPlaceholder: t('report.filters.search_placeholder'),
+        minSizeLabel: t('report.filters.min_size_label'),
+        minSizeHint: t('report.filters.min_size_hint'),
+        treeTitle: t('report.panels.tree'),
+        topFilesTitle: t('report.panels.top_files'),
+        tableIndex: t('report.table.index'),
+        tableSize: t('report.table.size'),
+        tablePath: t('report.table.path'),
+        emptyTree: t('report.empty.tree'),
+        emptyTopFiles: t('report.empty.top_files')
+      }
+    end
+    def t(key)
+      I18n.t(@locale, key)
+    end
   end
 end

data/lib/file_tree_visualizer/scanner.rb CHANGED Viewed

@@ -5,16 +5,19 @@ module FileTreeVisualizer
     DEFAULT_TOP_LIMIT = 200
     Result = Struct.new(:root, :top_files, :stats, keyword_init: true)
-    def initialize(top_limit: DEFAULT_TOP_LIMIT, follow_symlinks: false)
+    def initialize(top_limit: DEFAULT_TOP_LIMIT, follow_symlinks: false, excludes: [])
       @top_limit = top_limit
       @follow_symlinks = follow_symlinks
+      @excludes = Array(excludes).map(&:to_s).reject(&:empty?)
       reset!
     end
     def scan(path, progress: nil)
       reset!
       expanded_path = File.expand_path(path.to_s)
-      raise ArgumentError, "La ruta no es un directorio: #{expanded_path}" unless File.directory?(expanded_path)
+      raise ArgumentError, "Path is not a directory: #{expanded_path}" unless File.directory?(expanded_path)
+      @root_path = expanded_path
       @progress_callback = progress
       notify_counting_progress(force: true)
@@ -57,6 +60,7 @@ module FileTreeVisualizer
       @processed_directories = 0
       @counted_files = 0
       @counted_directories = 0
+      @root_path = nil
     end
     def scan_directory(path)
@@ -66,7 +70,7 @@ module FileTreeVisualizer
       node = {
         name: directory_name,
         path: path,
-        type: "directory",
+        type: 'directory',
         size: 0,
         children: []
       }
@@ -78,6 +82,11 @@ module FileTreeVisualizer
       entries = Dir.children(path)
       entries.each do |entry_name|
         child_path = File.join(path, entry_name)
+        if excluded_path?(child_path)
+          @skipped_count += 1
+          next
+        end
         process_child_node(child_path, entry_name, node)
       rescue StandardError
         @skipped_count += 1
@@ -106,7 +115,7 @@ module FileTreeVisualizer
         file_node = {
           name: entry_name,
           path: child_path,
-          type: "file",
+          type: 'file',
           size: file_size
         }
         parent_node[:children] << file_node
@@ -142,6 +151,7 @@ module FileTreeVisualizer
       entries = Dir.children(path)
       entries.each do |entry_name|
         child_path = File.join(path, entry_name)
+        next if excluded_path?(child_path)
         begin
           if File.symlink?(child_path) && !@follow_symlinks
@@ -165,6 +175,22 @@ module FileTreeVisualizer
       totals
     end
+    def excluded_path?(path)
+      return false if @excludes.empty?
+      basename = File.basename(path)
+      relative = relative_path(path)
+      flags = File::FNM_PATHNAME | File::FNM_DOTMATCH | File::FNM_EXTGLOB
+      @excludes.any? do |pattern|
+        File.fnmatch?(pattern, basename, flags) || File.fnmatch?(pattern, relative, flags)
+      end
+    end
+    def relative_path(path)
+      path.delete_prefix("#{@root_path}/")
+    end
     def notify_progress
       return unless @progress_callback

data/lib/file_tree_visualizer/version.rb CHANGED Viewed

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 module FileTreeVisualizer
-  VERSION = "0.0.3"
+  VERSION = '0.2.0'
 end

data/lib/file_tree_visualizer.rb CHANGED Viewed

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
-require_relative "file_tree_visualizer/version"
-require_relative "file_tree_visualizer/scanner"
-require_relative "file_tree_visualizer/report_builder"
-require_relative "file_tree_visualizer/cli"
+require_relative 'file_tree_visualizer/version'
+require_relative 'file_tree_visualizer/i18n'
+require_relative 'file_tree_visualizer/scanner'
+require_relative 'file_tree_visualizer/report_builder'
+require_relative 'file_tree_visualizer/cli'
 module FileTreeVisualizer
 end

metadata CHANGED Viewed

@@ -1,19 +1,33 @@
 --- !ruby/object:Gem::Specification
 name: file_tree_visualizer
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.2.0
 platform: ruby
 authors:
-- jbidwell1
+- John Bidwell
 autorequire:
 bindir: bin
 cert_chain: []
 date: 2026-04-04 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
 description: Scans a directory recursively, computes file/directory sizes, and generates
   an HTML report rendered with React.
 email:
-- devnull@example.com
+- johnbidwellb@gmail.com
 executables:
 - file-tree-visualizer
 extensions: []
@@ -26,15 +40,17 @@ files:
 - file_tree_visualizer.gemspec
 - lib/file_tree_visualizer.rb
 - lib/file_tree_visualizer/cli.rb
+- lib/file_tree_visualizer/i18n.rb
 - lib/file_tree_visualizer/report_builder.rb
 - lib/file_tree_visualizer/scanner.rb
 - lib/file_tree_visualizer/version.rb
-homepage: https://example.com/file_tree_visualizer
+homepage: https://github.com/JohnBidwellB/file-tree-visualizer
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://example.com/file_tree_visualizer
-  source_code_uri: https://example.com/file_tree_visualizer
+  source_code_uri: https://github.com/JohnBidwellB/file-tree-visualizer/tree/main
+  bug_tracker_uri: https://github.com/JohnBidwellB/file-tree-visualizer/issues
+  changelog_uri: https://github.com/JohnBidwellB/file-tree-visualizer/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: