csvops 0.8.0.alpha → 0.9.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c09a1df68b5bbb8885b254bd7ea1260617495fc042cae43ef7251d9eb66836e
-  data.tar.gz: a5fbf5098df8007e844c83134a5474f92eafe4866b4d9910519d9a1517675af9
+  metadata.gz: 940c2492f5bea33d56ad0a47ebf6933cb2e43817530aa04d4e02950affe9d493
+  data.tar.gz: 9c32a162b4393f25e99b55e908df2b9dcb55099ce0d820aa3255c310fc09d983
 SHA512:
-  metadata.gz: 3695b9d49a638138d03d69122267a2889ecb6bd33605e9a256a20480ccab869c858f8f08996a213a885c2fb9a08e740712bb1dcc38fef6734d10129b20b3d611
-  data.tar.gz: df4cf19d31ac3c317ae69552cd3181c48984295268880810adf0d7b46bb606a2fa92646c35c4b1cd3343c04c5d08c734efb6b53b08f44fb3259b3dc3cbaf4509
+  metadata.gz: 3babceb657e3e3c366c19daa305fcffe18fca1e145dafa8d8f66f022531e17fc21f0788da7b27a0d76e17e07c88fa098105d20116353cced5e4b207870a0f88e
+  data.tar.gz: a8efe4b0a86dd3e303ca8946a0b25b3dbcffb1bbeb76823910d43ab8ff1ba4fc7670f1a2c16e135941caf74a3a216f988010bd0178b892a60eb9bd82963c4596

data/README.md

@@ -57,7 +57,10 @@ Typical prompt pattern:
 - choose action-specific options
 - choose output destination (console or file)
 
-For architecture and internal design details, see [`docs/architecture.md`](docs/architecture.md).
+For architecture and internal design details, see:
+
+- [`docs/architecture.md`](docs/architecture.md)
+- [`docs/cli-output-conventions.md`](docs/cli-output-conventions.md)
 
 ### 4. Example interaction (console output)
 
@@ -118,6 +121,22 @@ With Bundler:
 bundle exec csvtool column /path/to/file.csv column_name
 ```
 
+Get CSV stats directly (default text output):
+
+```bash
+csvtool stats /path/to/file.csv
+```
+
+Optional output format and color mode:
+
+```bash
+csvtool stats /path/to/file.csv --format json
+csvtool stats /path/to/file.csv --format csv
+csvtool stats /path/to/file.csv --color auto
+csvtool stats /path/to/file.csv --color always
+csvtool stats /path/to/file.csv --color never
+```
+
 ### 7. Dedupe interaction example
 
 Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
@@ -303,7 +322,7 @@ bundle exec rake test
 
 ## Alpha release
 
-Current prerelease version: `0.8.0.alpha`
+Current prerelease version: `0.9.0.alpha`
 
 Install prerelease from RubyGems:
 
@@ -313,7 +332,7 @@ gem install csvops --pre
 
 Release runbook:
 
-- `docs/release-v0.8.0-alpha.md`
+- `docs/release-v0.9.0-alpha.md`
 
 
 ## Architecture
@@ -321,3 +340,4 @@ Release runbook:
 Full architecture and domain documentation lives in:
 
 - [`docs/architecture.md`](docs/architecture.md)
+- [`docs/cli-output-conventions.md`](docs/cli-output-conventions.md)

data/docs/architecture.md

@@ -21,6 +21,9 @@ For all interactive domains (`Column Extraction`, `Row Extraction`, `Row Randomi
 - `domain/*`: invariants and domain policies.
 - `infrastructure/*`: CSV mechanics and output adapters.
 
+Output UI rules:
+- See [`docs/cli-output-conventions.md`](cli-output-conventions.md) for stream, format, color, and table rendering contracts used across workflows.
+
 Write-boundary rule:
 - Use cases coordinate write paths but do not perform direct file writes.
 - Direct write APIs (`CSV.open`, writable `File.open`, `File.write`, `IO.write`) are infrastructure-only.

data/docs/cli-output-conventions.md

@@ -0,0 +1,49 @@
+# CLI Output Conventions
+
+This document defines the output contract for all CLI workflows.
+
+## 1. Stream contract
+
+- `stdout` is for data output only.
+- `stderr` is for prompts, menu UI, status, and errors.
+- Commands should be pipe-safe: redirecting `stdout` must not capture prompts/errors.
+
+## 2. Format contract
+
+- Supported formats: `text`, `json`, `csv`.
+- `text` is human-readable and may include tables/colors.
+- `json` and `csv` are machine-readable and should remain stable over time.
+- Structured formats must avoid decorative output.
+
+## 3. Color policy
+
+- Supported modes: `auto`, `always`, `never`.
+- `auto` colors only when output target is a TTY.
+- `NO_COLOR` disables color in `auto` mode.
+- `always` overrides `NO_COLOR`.
+- Structured formats (`json`, `csv`) are not colorized.
+
+## 4. Table rendering rules
+
+- Use shared table renderer for summary-style text output.
+- Render within terminal width constraints.
+- Truncate long cells with ellipsis when necessary.
+- Avoid broken/overlapping columns in narrow terminals.
+
+## 5. Shared services usage
+
+All workflows should use shared output services under:
+
+- `lib/csvtool/interface/cli/output/streams.rb`
+- `lib/csvtool/interface/cli/output/formatters/*`
+- `lib/csvtool/interface/cli/output/color_policy.rb`
+- `lib/csvtool/interface/cli/output/colorizer.rb`
+- `lib/csvtool/interface/cli/output/table_renderer.rb`
+
+Prefer these services over ad-hoc formatting in presenters/workflows.
+
+## 6. Testing expectations
+
+- Add focused unit tests for each output service.
+- Add workflow/CLI tests for stream separation and representative formatting behavior.
+- Keep acceptance assertions centered on contract semantics rather than fragile spacing where possible.

data/docs/release-v0.9.0-alpha.md

@@ -0,0 +1,80 @@
+# Release Checklist: v0.9.0-alpha
+
+## 1. Verify environment
+
+```bash
+ruby -v
+bundle -v
+```
+
+Expected:
+- Ruby `3.3.x`
+
+## 2. Install dependencies
+
+```bash
+bundle install
+```
+
+## 3. Run quality checks
+
+```bash
+bundle exec rake test
+```
+
+## 4. Smoke test CLI commands
+
+```bash
+bundle exec csvtool menu
+bundle exec csvtool stats test/fixtures/sample_people.csv --format text
+bundle exec csvtool stats test/fixtures/sample_people.csv --format json
+bundle exec csvtool stats test/fixtures/sample_people.csv --format csv
+```
+
+## 5. Smoke test output conventions across workflows
+
+Verify in menu-driven workflows:
+- prompts/menu/errors are on `stderr`
+- data output is on `stdout`
+
+Verify shared output behavior:
+- formatter consistency (`text|json|csv`)
+- color policy (`auto|always|never`, `NO_COLOR`)
+- width-aware summary tables in stats/parity/split/dedupe
+
+## 6. Build and validate gem package
+
+```bash
+gem build csvops.gemspec
+gem install ./csvops-0.9.0.alpha.gem
+csvtool menu
+```
+
+## 7. Commit release prep
+
+```bash
+git add -A
+git commit -m "chore(release): prepare v0.9.0-alpha"
+```
+
+## 8. Tag release
+
+```bash
+git tag -a v0.9.0-alpha -m "v0.9.0-alpha"
+git push origin main --tags
+```
+
+## 9. Publish gem
+
+```bash
+gem push csvops-0.9.0.alpha.gem
+```
+
+## 10. Create GitHub release
+
+Create release `v0.9.0-alpha` with:
+- Shared output stream services across workflows (`stdout` data, `stderr` UI/errors)
+- Shared formatter services and migrated presenters
+- Shared color policy + colorizer across workflows
+- Shared width-aware table rendering across summary presenters
+- New output conventions documentation (`docs/cli-output-conventions.md`)

data/lib/csvtool/cli.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "csv"
+require "json"
 require "csvtool/interface/cli/menu_loop"
 require "csvtool/interface/cli/workflows/run_extraction_workflow"
 require "csvtool/interface/cli/workflows/run_row_extraction_workflow"
@@ -10,9 +11,19 @@ require "csvtool/interface/cli/workflows/run_csv_parity_workflow"
 require "csvtool/interface/cli/workflows/run_csv_split_workflow"
 require "csvtool/interface/cli/workflows/run_csv_stats_workflow"
 require "csvtool/interface/cli/errors/presenter"
+require "csvtool/interface/cli/output/table_renderer"
+require "csvtool/interface/cli/output/streams"
+require "csvtool/interface/cli/output/color_policy"
+require "csvtool/interface/cli/output/colorizer"
+require "csvtool/interface/cli/output/formatters/stats_formatter"
 require "csvtool/infrastructure/csv/header_reader"
 require "csvtool/infrastructure/csv/value_streamer"
 require "csvtool/infrastructure/output/console_writer"
+require "csvtool/application/use_cases/run_csv_stats"
+require "csvtool/domain/csv_stats_session/stats_source"
+require "csvtool/domain/csv_stats_session/stats_options"
+require "csvtool/domain/csv_stats_session/stats_session"
+require "csvtool/domain/shared/output_destination"
 
 module Csvtool
   class CLI
@@ -27,15 +38,16 @@ module Csvtool
       "Exit"
     ].freeze
 
-    def self.start(argv, stdin:, stdout:, stderr:)
-      new(argv, stdin: stdin, stdout: stdout, stderr: stderr).run
+    def self.start(argv, stdin:, stdout:, stderr:, env: ENV)
+      new(argv, stdin: stdin, stdout: stdout, stderr: stderr, env: env).run
     end
 
-    def initialize(argv, stdin:, stdout:, stderr:)
+    def initialize(argv, stdin:, stdout:, stderr:, env: ENV)
       @argv = argv
       @stdin = stdin
       @stdout = stdout
       @stderr = stderr
+      @env = env
     end
 
     def run
@@ -44,6 +56,8 @@ module Csvtool
         run_menu_loop
       when "column"
         run_column_command
+      when "stats"
+        run_stats_command
       else
         print_usage
         1
@@ -53,16 +67,18 @@ module Csvtool
     private
 
     def run_menu_loop
-      extract_column_action = -> { Interface::CLI::Workflows::RunExtractionWorkflow.new(stdin: @stdin, stdout: @stdout).call }
-      extract_rows_action = -> { Interface::CLI::Workflows::RunRowExtractionWorkflow.new(stdin: @stdin, stdout: @stdout).call }
-      randomize_rows_action = -> { Interface::CLI::Workflows::RunRowRandomizationWorkflow.new(stdin: @stdin, stdout: @stdout).call }
-      dedupe_action = -> { Interface::CLI::Workflows::RunCrossCsvDedupeWorkflow.new(stdin: @stdin, stdout: @stdout).call }
-      parity_action = -> { Interface::CLI::Workflows::RunCsvParityWorkflow.new(stdin: @stdin, stdout: @stdout).call }
-      split_action = -> { Interface::CLI::Workflows::RunCsvSplitWorkflow.new(stdin: @stdin, stdout: @stdout).call }
-      stats_action = -> { Interface::CLI::Workflows::RunCsvStatsWorkflow.new(stdin: @stdin, stdout: @stdout).call }
+      streams = Interface::CLI::Output::Streams.build(data: @stdout, ui: @stderr)
+      extract_column_action = -> { Interface::CLI::Workflows::RunExtractionWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
+      extract_rows_action = -> { Interface::CLI::Workflows::RunRowExtractionWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
+      randomize_rows_action = -> { Interface::CLI::Workflows::RunRowRandomizationWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
+      dedupe_action = -> { Interface::CLI::Workflows::RunCrossCsvDedupeWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
+      parity_action = -> { Interface::CLI::Workflows::RunCsvParityWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
+      split_action = -> { Interface::CLI::Workflows::RunCsvSplitWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
+      stats_action = -> { Interface::CLI::Workflows::RunCsvStatsWorkflow.new(stdin: @stdin, stdout: streams.data, stderr: streams.ui).call }
       Interface::CLI::MenuLoop.new(
         stdin: @stdin,
-        stdout: @stdout,
+        stdout: streams.data,
+        stderr: streams.ui,
         menu_options: MENU_OPTIONS,
         extract_column_action: extract_column_action,
         extract_rows_action: extract_rows_action,
@@ -78,6 +94,7 @@ module Csvtool
       @stderr.puts "Usage:"
       @stderr.puts "  csvtool menu"
       @stderr.puts "  csvtool column <file> <column>"
+      @stderr.puts "  csvtool stats <file> [--format text|json|csv] [--color auto|always|never]"
     end
 
     def run_column_command
@@ -88,7 +105,7 @@ module Csvtool
         return 1
       end
 
-      errors = Interface::CLI::Errors::Presenter.new(stdout: @stdout)
+      errors = Interface::CLI::Errors::Presenter.new(stdout: @stderr)
       return errors.file_not_found(file_path) || 1 unless File.file?(file_path)
 
       header_reader = Infrastructure::CSV::HeaderReader.new
@@ -107,5 +124,108 @@ module Csvtool
       errors.cannot_read_file(file_path)
       1
     end
+
+    def run_stats_command
+      file_path, format, color_mode = parse_stats_args(@argv[1..])
+      unless file_path
+        print_usage
+        return 1
+      end
+
+      errors = Interface::CLI::Errors::Presenter.new(stdout: @stderr)
+      unless %w[text json csv].include?(format)
+        @stderr.puts "Invalid format: #{format}"
+        return 1
+      end
+      unless %w[auto always never].include?(color_mode)
+        @stderr.puts "Invalid color mode: #{color_mode}"
+        return 1
+      end
+      source = Domain::CsvStatsSession::StatsSource.new(path: file_path, separator: ",", headers_present: true)
+      options = Domain::CsvStatsSession::StatsOptions.new
+      destination = Domain::Shared::OutputDestination.console
+      session = Domain::CsvStatsSession::StatsSession.start(source: source, options: options).with_output_destination(destination)
+      result = Application::UseCases::RunCsvStats.new.call(session: session)
+
+      unless result.ok?
+        case result.error
+        when :file_not_found
+          errors.file_not_found(result.data[:path])
+        when :could_not_parse_csv
+          errors.could_not_parse_csv
+        when :cannot_read_file
+          errors.cannot_read_file(result.data[:path])
+        else
+          @stderr.puts "Unknown error."
+        end
+        return 1
+      end
+
+      formatter = Interface::CLI::Output::Formatters::StatsFormatter.new(
+        table_renderer: Interface::CLI::Output::TableRenderer.new
+      )
+      output = formatter.call(data: result.data, format: format, max_width: terminal_width)
+      print_stats_output(output, format: format, color_mode: color_mode)
+
+      0
+    end
+
+    def parse_stats_args(args)
+      file_path = args[0]
+      format = "text"
+      color_mode = "auto"
+      index = 1
+      while index < args.length
+        arg = args[index]
+        if arg.start_with?("--format=")
+          format = arg.split("=", 2)[1]
+        elsif arg == "--format"
+          format = args[index + 1].to_s
+          index += 1
+        elsif arg.start_with?("--color=")
+          color_mode = arg.split("=", 2)[1]
+        elsif arg == "--color"
+          color_mode = args[index + 1].to_s
+          index += 1
+        end
+        index += 1
+      end
+      [file_path, format, color_mode]
+    end
+
+    def print_stats_output(output, format:, color_mode:)
+      if format == "text"
+        policy = Interface::CLI::Output::ColorPolicy.new(mode: color_mode, io: @stdout, env: @env)
+        colorizer = Interface::CLI::Output::Colorizer.new(policy: policy)
+        text = apply_text_color(output, colorizer: colorizer)
+        @stdout.puts text
+      else
+        @stdout.puts output
+      end
+    end
+
+    def apply_text_color(text, colorizer:)
+      text.lines.map do |line|
+        line = line.chomp
+        case line
+        when "CSV Stats Summary"
+          colorizer.call(line, code: "1;36")
+        when "Column completeness:"
+          colorizer.call(line, code: "1")
+        when /\A(Metric|Value|Column|Non-blank|Blank)(\s+\|.*)?\z/
+          colorizer.call(line, code: "1")
+        else
+          line
+        end
+      end.join("\n")
+    end
+
+    def terminal_width
+      columns = @env["COLUMNS"].to_i
+      return columns if columns.positive?
+      return @stdout.winsize[1] if @stdout.respond_to?(:winsize)
+
+      80
+    end
   end
 end

data/lib/csvtool/interface/cli/menu_loop.rb

@@ -4,9 +4,10 @@ module Csvtool
   module Interface
     module CLI
       class MenuLoop
-        def initialize(stdin:, stdout:, menu_options:, extract_column_action:, extract_rows_action:, randomize_rows_action:, dedupe_action:, parity_action:, split_action:, stats_action:)
+        def initialize(stdin:, stdout:, stderr: stdout, menu_options:, extract_column_action:, extract_rows_action:, randomize_rows_action:, dedupe_action:, parity_action:, split_action:, stats_action:)
           @stdin = stdin
           @stdout = stdout
+          @stderr = stderr
           @menu_options = menu_options
           @extract_column_action = extract_column_action
           @extract_rows_action = extract_rows_action
@@ -20,7 +21,7 @@ module Csvtool
         def run
           loop do
             print_menu
-            @stdout.print "> "
+            @stderr.print "> "
             choice = @stdin.gets
             return 0 if choice.nil?
 
@@ -42,7 +43,7 @@ module Csvtool
             when "8"
               return 0
             else
-              @stdout.puts "Please choose 1, 2, 3, 4, 5, 6, 7, or 8."
+              @stderr.puts "Please choose 1, 2, 3, 4, 5, 6, 7, or 8."
             end
           end
         end
@@ -50,9 +51,9 @@ module Csvtool
         private
 
         def print_menu
-          @stdout.puts "CSV Tool Menu"
+          @stderr.puts "CSV Tool Menu"
           @menu_options.each_with_index do |option, index|
-            @stdout.puts "#{index + 1}. #{option}"
+            @stderr.puts "#{index + 1}. #{option}"
           end
         end
       end

data/lib/csvtool/interface/cli/output/color_policy.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Interface
+    module CLI
+      module Output
+        class ColorPolicy
+          def initialize(mode:, io:, env: ENV)
+            @mode = mode
+            @io = io
+            @env = env
+          end
+
+          def enabled?
+            return true if @mode == "always"
+            return false if @mode == "never"
+            return false if @env["NO_COLOR"]
+
+            @io.respond_to?(:tty?) && @io.tty?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/interface/cli/output/colorizer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "csvtool/interface/cli/output/color_policy"
+
+module Csvtool
+  module Interface
+    module CLI
+      module Output
+        class Colorizer
+          def initialize(policy:)
+            @policy = policy
+          end
+
+          def call(text, code:)
+            return text unless @policy.enabled?
+
+            "\e[#{code}m#{text}\e[0m"
+          end
+
+          def self.auto(io:, env: ENV)
+            new(policy: ColorPolicy.new(mode: "auto", io: io, env: env))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/interface/cli/output/formatters/csv_row_formatter.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "csv"
+
+module Csvtool
+  module Interface
+    module CLI
+      module Output
+        module Formatters
+          class CsvRowFormatter
+            def call(fields:, col_sep:)
+              ::CSV.generate_line(fields, row_sep: "", col_sep: col_sep).chomp
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/interface/cli/output/formatters/stats_formatter.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Csvtool
+  module Interface
+    module CLI
+      module Output
+        module Formatters
+          class StatsFormatter
+            def initialize(table_renderer:)
+              @table_renderer = table_renderer
+            end
+
+            def call(data:, format:, max_width: 80)
+              case format
+              when "json"
+                JSON.generate(data)
+              when "csv"
+                csv_lines(data).join("\n")
+              else
+                text_lines(data, max_width: max_width).join("\n")
+              end
+            end
+
+            private
+
+            def csv_lines(data)
+              lines = ["metric,value", "row_count,#{data[:row_count]}", "column_count,#{data[:column_count]}"]
+              lines << "headers,#{data[:headers].join('|')}" unless data[:headers].nil? || data[:headers].empty?
+              data.fetch(:column_stats, []).each do |stats|
+                lines << "column.#{stats[:name]}.non_blank,#{stats[:non_blank_count]}"
+                lines << "column.#{stats[:name]}.blank,#{stats[:blank_count]}"
+              end
+              lines
+            end
+
+            def text_lines(data, max_width:)
+              lines = ["CSV Stats Summary"]
+              summary_rows = [["Rows", data[:row_count].to_s], ["Columns", data[:column_count].to_s]]
+              summary_rows << ["Headers", data[:headers].join(", ")] unless data[:headers].nil? || data[:headers].empty?
+              lines << @table_renderer.render(headers: ["Metric", "Value"], rows: summary_rows, max_width: max_width)
+
+              return lines if data[:column_stats].nil? || data[:column_stats].empty?
+
+              lines << ""
+              lines << "Column completeness:"
+              rows = data[:column_stats].map { |stats| [stats[:name], stats[:non_blank_count].to_s, stats[:blank_count].to_s] }
+              lines << @table_renderer.render(headers: ["Column", "Non-blank", "Blank"], rows: rows, max_width: max_width)
+              lines
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/interface/cli/output/streams.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Interface
+    module CLI
+      module Output
+        class Streams
+          attr_reader :data, :ui
+
+          def self.build(data:, ui: data)
+            new(data: data, ui: ui)
+          end
+
+          def initialize(data:, ui:)
+            @data = data
+            @ui = ui
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/interface/cli/output/table_renderer.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Interface
+    module CLI
+      module Output
+        class TableRenderer
+          MIN_COLUMN_WIDTH = 4
+
+          def render(headers:, rows:, max_width: 80)
+            widths = compute_widths(headers, rows)
+            widths = fit_widths(widths, max_width)
+
+            lines = []
+            lines << format_row(headers, widths)
+            lines << separator(widths)
+            rows.each { |row| lines << format_row(row, widths) }
+            lines.join("\n")
+          end
+
+          private
+
+          def compute_widths(headers, rows)
+            widths = headers.map { |header| header.to_s.length }
+            rows.each do |row|
+              row.each_with_index do |cell, index|
+                widths[index] = [widths[index], cell.to_s.length].max
+              end
+            end
+            widths
+          end
+
+          def fit_widths(widths, max_width)
+            return widths if total_width(widths) <= max_width
+
+            adjusted = widths.dup
+            while total_width(adjusted) > max_width
+              index = adjusted.each_with_index.max_by { |width, _i| width }[1]
+              break if adjusted[index] <= MIN_COLUMN_WIDTH
+
+              adjusted[index] -= 1
+            end
+            adjusted
+          end
+
+          def total_width(widths)
+            widths.sum + (3 * (widths.length - 1))
+          end
+
+          def separator(widths)
+            widths.map { |width| "-" * width }.join("-+-")
+          end
+
+          def format_row(row, widths)
+            row.each_with_index.map do |cell, index|
+              truncate(cell.to_s, widths[index]).ljust(widths[index])
+            end.join(" | ")
+          end
+
+          def truncate(text, width)
+            return text if text.length <= width
+            return text[0, width] if width < MIN_COLUMN_WIDTH
+
+            "#{text[0, width - 3]}..."
+          end
+        end
+      end
+    end
+  end
+end