ellipsized 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6aecc397c82b24e3704bb3c017ff811e04034bc08b250b638226e797aa6e8921
-  data.tar.gz: 4800637798c1d81eb8fe49ee6b298654b3241e64ab4d75e22bd3af245a34abc9
+  metadata.gz: 1c05fb67e627a48333959a2e5939faf1ef73fec35c8bc3cb81f106452089797c
+  data.tar.gz: 4196eaefe1dbf1ba369d2c35248ae762653e842b8f371529241d9a730caa9773
 SHA512:
-  metadata.gz: 10e2415e492615df00a82d62b48b84f9fb2498c8961460228595113f558b0e5f5186d4d02a8a193d6a73120119516c5b215792b023560103b3fb3f64e61ed036
-  data.tar.gz: 65745ccea3fbbb71d6b40a0eb36c0a17b4cf0dca816e0756c77c611677d86bdf56d5e033ac7ccf634284153466d8b8503888c1908ea9b65fef7d12ae7a13fbc2
+  metadata.gz: 5b870d389d1f990a94af3a5f381c486eb144c7984704c97f75fd0ebd8fc66788583de8b58067e509ca9a3a4bc202d56b699125f336aaa04f5cb0254507536d9a
+  data.tar.gz: 39e19c22d146df6356ded9ebf56297fb9dadaf681eab7e4a15081c3ff04a1ab8d30a8035ca811a090e6c98faa9a129b72c2a8abb9f1058b4783e671033dc7b08

data/.rubocop.yml

@@ -18,4 +18,5 @@ Layout/EndOfLine:
   EnforcedStyle: lf
 Style/EvalWithLocation:
   Enabled: false
-require: []
+Metrics/AbcSize:
+  Max: 25

data/README.md

@@ -11,8 +11,8 @@
 [![Hits-of-Code](https://hitsofcode.com/github/yegor256/ellipsized)](https://hitsofcode.com/view/github/yegor256/ellipsized)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/ellipsized/blob/master/LICENSE.txt)
 
-It makes a string fit into required length, replacing
-part of it, in the middle, with ellipsis:
+It makes a string fit into a required length by replacing
+part of it in the middle with an ellipsis:
 
 ```ruby
 require 'ellipsized'
@@ -25,6 +25,18 @@ Prints:
 Hello, ...world!
 ```
 
+You can also specify what to fill the gap with:
+
+```ruby
+puts 'How are you doing?'.ellipsized(14, gap: '.. skip ..')
+```
+
+Prints:
+
+```text
+Ho.. skip ..g?
+```
+
 That's it.
 
 ## How to contribute
@@ -34,7 +46,7 @@ Read
 Make sure your build is green before you contribute
 your pull request. You will need to have
 [Ruby](https://www.ruby-lang.org/en/) 3.0+ and
-[Bundler](https://bundler.io/) installed. Then:
+[Bundler](https://bundler.io/) installed. Then run:
 
 ```bash
 bundle update

data/ellipsized.gemspec

@@ -9,15 +9,15 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=3.2'
   s.name = 'ellipsized'
-  s.version = '0.0.1'
+  s.version = '0.1.0'
   s.license = 'MIT'
-  s.summary = 'A simple Ruby gem that adds a .ellipsized() method to Array'
+  s.summary = 'A simple Ruby gem that adds a .ellipsized() method to String'
   s.description =
-    'It makes a string fit into required length, replacing ' \
-    'part of it, in the middle, with ellipsis.'
+    'It makes a string fit into a required length by replacing ' \
+    'part of it in the middle with an ellipsis.'
   s.authors = ['Yegor Bugayenko']
   s.email = 'yegor256@gmail.com'
-  s.homepage = 'http://github.com/yegor256/ellipsized'
+  s.homepage = 'https://github.com/yegor256/ellipsized'
   s.files = `git ls-files`.split($RS)
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
   s.rdoc_options = ['--charset=UTF-8']

data/lib/ellipsized.rb

@@ -3,20 +3,47 @@
 # SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
-# Replaces part of the text with ellipsis.
+# Replaces part of the text with a gap.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 class String
-  # @param [Integer] max The maximum length of the string, expected
-  # @return [String] The text with ellipsis inside (if necessary)
-  def ellipsized(max = 64)
+  # Truncates a string to specified maximum length, inserting a gap in the middle
+  # if necessary. The resulting string will never be longer than the specified
+  # maximum length. The original string is returned if it is already shorter than
+  # or equal to the maximum length.
+  #
+  # @param [Integer] max The maximum length of the resulting string
+  # @param [String] gap The string to use as gap (default: '...')
+  # @return [String] The truncated string with gap in the middle if necessary
+  #
+  # @example Basic usage with default parameters
+  #   "Hello, world!".ellipsized
+  #   # => "Hello, world!"
+  #
+  # @example Truncate a long string
+  #   "This is a very long string that needs to be truncated".ellipsized(20)
+  #   # => "This is...truncated"
+  #
+  # @example Custom gap
+  #   "Another very long string example".ellipsized(15, gap: "***")
+  #   # => "Anoth***example"
+  #
+  # @example Edge cases
+  #   "".ellipsized      # => ""
+  #   "Short".ellipsized # => "Short"
+  #   "xyz".ellipsized(0) # => ""
+  #   "xyz".ellipsized(2, gap: "...") # => "xy"
+  def ellipsized(max = 64, gap: '...')
     return '' if empty?
     return self if length <= max
+    return '' if max.zero?
+    return self[0..max - 1] if gap.length >= max
 
-    head = tail = (max - 3) / 2
-    head += 1 if head + tail + 3 < max
-    "#{self[0, head]}...#{self[length - tail..]}"
+    head = tail = (max - gap.length) / 2
+    head += 1 if head + tail + gap.length < max
+    head = max if head > max
+    "#{self[0, head]}#{gap}#{self[length - tail..]}"
   end
 end

data/test/test_ellipsized.rb

@@ -17,4 +17,23 @@ class TestEllipsized < Minitest::Test
     assert_equal('app...na', 'apple and banana'.ellipsized(8))
     assert_equal('пр...г!', 'привет, друг!'.ellipsized(7))
   end
+
+  def test_with_very_small_window
+    assert_equal('', 'The Godfather'.ellipsized(0))
+    assert_equal('T', 'The Godfather'.ellipsized(1))
+    assert_equal('Th', 'The Godfather'.ellipsized(2))
+    assert_equal('The', 'The Godfather'.ellipsized(3))
+    assert_equal('T...', 'The Godfather'.ellipsized(4))
+    assert_equal('T...r', 'The Godfather'.ellipsized(5))
+    assert_equal('Th...r', 'The Godfather'.ellipsized(6))
+    assert_equal('Th...er', 'The Godfather'.ellipsized(7))
+    assert_equal('The...er', 'The Godfather'.ellipsized(8))
+  end
+
+  def test_with_replacement
+    assert_equal(
+      'This .. skip ..indow',
+      'This story is very long to fit into a small window'.ellipsized(20, gap: '.. skip ..')
+    )
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ellipsized
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -9,8 +9,8 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: It makes a string fit into required length, replacing part of it, in
-  the middle, with ellipsis.
+description: It makes a string fit into a required length by replacing part of it
+  in the middle with an ellipsis.
 email: yegor256@gmail.com
 executables: []
 extensions: []
@@ -47,7 +47,7 @@ files:
 - renovate.json
 - test/test__helper.rb
 - test/test_ellipsized.rb
-homepage: http://github.com/yegor256/ellipsized
+homepage: https://github.com/yegor256/ellipsized
 licenses:
 - MIT
 metadata:
@@ -69,5 +69,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.7
 specification_version: 4
-summary: A simple Ruby gem that adds a .ellipsized() method to Array
+summary: A simple Ruby gem that adds a .ellipsized() method to String
 test_files: []