unicode-display_width 1.7.0 → 2.0.0.pre1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6717dfd17f33fb2c2baa553461b99081d0bb4c3db3213a63cb8a318e9b4982be
-  data.tar.gz: 2f844904759852d6e32a4fe89212c5f6e965a6482fdbdb182a8eeeedce917ad8
+  metadata.gz: 65e2ca3e7559abe233575caa4b9b94c09c3a9d011ece712c5a754b2b253871cb
+  data.tar.gz: 266717cf34ee4cd44ee69530dbd1a855d2243a642396d5ba588f4c5901adc337
 SHA512:
-  metadata.gz: d73355d6e5c63118502dc5129a84be7935320fc8ca3deb435ae2bf2e9b710ab08e21bde5470624d78c83928598429e97b95e71ea51e8d158ddd37b4236913fc1
-  data.tar.gz: 65c27dfb5b47af40e04665cfaefd152a8432aca44052fa3a92a1e141001bd542f578e5e53b323331f0432f4412491a45bebc9f5341347ba8a43d422be76f13f4
+  metadata.gz: 5d21dc665f1d47d634c82916ef1f507fd99813b51e1351927b303e4bc8e3d016da2a65cfd5d282ec281061f0b1e99899d12ff9a7b88105f44a6312497eb8c588
+  data.tar.gz: f67a9ea1e6fbd4383bf432d1563aafc078e15897d7b2e4136e8fcefe88ad40e512f0ebedfd75a3f41f255e15cfc9a3343c5707133a1fba75fe4cec746395c8f7

data/CHANGELOG.md

@@ -1,8 +1,20 @@
 # CHANGELOG
 
-## 1.7.0
+## 2.0.0.pre.1 (unreleased)
 
-- Unicode 13
+Will be published as non-pre version on rubygems.org when Ruby 3.0 is released (December 2020)
+
+- Introduce new class-based API, which remembers your string-width configuration. See README for details.
+- Remove auto-loading of string extension
+  - You can: `require "unicode/display_width/string_ext"` to continue to use the string extension
+  - The manual opt-out `require "unicode/display_width/no_string_ext"` is not needed anymore and will
+    issue a warning in the future
+- Remove (already deprecated) String#display_size and String#display_width aliases
+
+Refactorings / Internal Changes:
+
+- Freeze string literals
+- The Unicode::DisplayWidth now is class, instead of a module, this enables the new config-object API
 
 ## 1.6.1
 

data/README.md

@@ -1,12 +1,31 @@
 ## Unicode::DisplayWidth [![[version]](https://badge.fury.io/rb/unicode-display_width.svg)](https://badge.fury.io/rb/unicode-display_width) [<img src="https://travis-ci.org/janlelis/unicode-display_width.png" />](https://travis-ci.org/janlelis/unicode-display_width)
 
-Determines the monospace display width of a string in Ruby. Implementation based on [EastAsianWidth.txt](https://www.unicode.org/Public/UNIDATA/EastAsianWidth.txt) and other data, 100% in Ruby. Other than [wcwidth()](https://github.com/janlelis/wcswidth-ruby), which fulfills a similar purpose, it does not rely on the OS vendor to provide an up-to-date method for measuring string width.
+Determines the monospace display width of a string in Ruby. Implementation based on [EastAsianWidth.txt](https://www.unicode.org/Public/UNIDATA/EastAsianWidth.txt) and other data, 100% in Ruby. It does not rely on the OS vendor (like [wcwidth()](https://github.com/janlelis/wcswidth-ruby)) to provide an up-to-date method for measuring string width.
 
-Unicode version: **13.0.0** (March 2020)
+Unicode version: **12.1.0** (May 2019)
 
 Supported Rubies: **2.7**, **2.6**, **2.5**, **2.4**
 
-Old Rubies that might still work: **2.3**, **2.2**, **2.1**, **2.0**, **1.9**
+Old Rubies which might still work: **2.3**, **2.2**, **2.1**, **2.0**, **1.9**
+
+## Version 2.0.pre1 — Breaking Changes
+
+Some features of this library have been marked deprecated for a long time and will be removed with Version 2.0, which will be released December 2020:
+
+- Aliases of display_width (…\_size, …\_length) have been removed
+- Auto-loading of string core extension has been removed:
+
+If you are relying on the `String#display_width` string extension to be automatically loaded (old behavior), please load it explicitly now:
+
+```ruby
+require "unicode-display_width/string_ext"
+```
+
+You could also change your `Gemfile` line to achieve this:
+
+```ruby
+gem "unicode-display_width", require: "unicode/display_width/string_ext"
+```
 
 ## Introduction to Character Widths
 
@@ -44,6 +63,8 @@ Or add to your Gemfile:
 
 ## Usage
 
+### Classic API
+
 ```ruby
 require 'unicode/display_width'
 
@@ -51,7 +72,7 @@ Unicode::DisplayWidth.of("⚀") # => 1
 Unicode::DisplayWidth.of("一") # => 2
 ```
 
-### Ambiguous Characters
+#### Ambiguous Characters
 
 The second parameter defines the value returned by characters defined as ambiguous:
 
@@ -60,15 +81,15 @@ Unicode::DisplayWidth.of("·", 1) # => 1
 Unicode::DisplayWidth.of("·", 2) # => 2
 ```
 
-### Custom Overwrites
+#### Custom Overwrites
 
 You can overwrite how to handle specific code points by passing a hash (or even a proc) as third parameter:
 
 ```ruby
-Unicode::DisplayWidth.of("a\tb", 1, 0x09 => 10)) # => 12
+Unicode::DisplayWidth.of("a\tb", 1, "\t".ord => 10)) # => tab counted as 10, so result is 12
 ```
 
-### Emoji Support
+#### Emoji Support
 
 Experimental emoji support is included. It will adjust the string's size for modifier and zero-width joiner sequences. You will need to add the [unicode-emoji](https://github.com/janlelis/unicode-emoji) gem to your Gemfile:
 
@@ -84,18 +105,32 @@ Unicode::DisplayWidth.of "🤾🏽‍♀️" # => 5
 Unicode::DisplayWidth.of "🤾🏽‍♀️", 1, {}, emoji: true # => 2
 ```
 
-### Usage with String Extension
-
-Activated by default. Will be deactivated in version 2.0:
+#### Usage with String Extension
 
 ```ruby
 require 'unicode/display_width/string_ext'
 
-"⚀".display_width #=> 1
-'一'.display_width #=> 2
+"⚀".display_width # => 1
+'一'.display_width # => 2
 ```
 
-You can actively opt-out from the string extension with: `require 'unicode/display_width/no_string_ext'`
+### Modern API: Keyword-arguments Based Config Object
+
+Version 2.0 introduces a keyword-argument based API, which allows you to save your configuration for later-reuse. This requires an extra line of code, but has the advantage that you'll need to define your string-width options only once:
+
+```ruby
+require 'unicode/display_width'
+
+display_width = Unicode::DisplayWidth.new(
+  # ambiguous: 1,
+  overwrite: { "A".ord => 100 },
+  emoji: true
+)
+
+display_width.of "⚀" # => 1
+display_width.of "🤾🏽‍♀️" # => 2
+display_width.of "A" # => 100
+```
 
 ### Usage From the CLI
 

data/lib/unicode/display_width.rb

@@ -1,8 +1,10 @@
-require_relative 'display_width/constants'
-require_relative 'display_width/index'
+# frozen_string_literal: true
+
+require_relative "display_width/constants"
+require_relative "display_width/index"
 
 module Unicode
-  module DisplayWidth
+  class DisplayWidth
     DEPTHS = [0x10000, 0x1000, 0x100, 0x10].freeze
 
     def self.of(string, ambiguous = 1, overwrite = {}, options = {})
@@ -40,12 +42,24 @@ module Unicode
 
       extra_width
     end
-  end
-end
 
-# Allows you to opt-out of the default string extension. Will eventually be removed,
-# so you must opt-in for the core extension by requiring 'display_width/string_ext'
-unless defined?(Unicode::DisplayWidth::NO_STRING_EXT) && Unicode::DisplayWidth::NO_STRING_EXT
-  require_relative 'display_width/string_ext'
+    def initialize(ambiguous: 1, overwrite: {}, emoji: false)
+      @ambiguous = ambiguous
+      @overwrite = overwrite
+      @emoji     = emoji
+    end
+
+    def get_config(**kwargs)
+      [
+        kwargs[:ambiguous] || @ambiguous,
+        kwargs[:overwrite] || @overwrite,
+        { emoji: kwargs[:emoji] || @emoji },
+      ]
+    end
+
+    def of(string, **kwargs)
+      self.class.of(string, *get_config(**kwargs))
+    end
+  end
 end
 

data/lib/unicode/display_width/constants.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module Unicode
-  module DisplayWidth
-    VERSION = '1.7.0'
-    UNICODE_VERSION = "13.0.0".freeze
-    DATA_DIRECTORY = File.expand_path(File.dirname(__FILE__) + '/../../../data/').freeze
-    INDEX_FILENAME = (DATA_DIRECTORY + '/display_width.marshal.gz').freeze
+  class DisplayWidth
+    VERSION = "2.0.0.pre1"
+    UNICODE_VERSION = "12.1.0"
+    DATA_DIRECTORY = File.expand_path(File.dirname(__FILE__) + "/../../../data/")
+    INDEX_FILENAME = DATA_DIRECTORY + "/display_width.marshal.gz"
   end
 end

data/lib/unicode/display_width/index.rb

@@ -1,8 +1,10 @@
-require 'zlib'
-require_relative 'constants'
+# frozen_string_literal: true
+
+require "zlib"
+require_relative "constants"
 
 module Unicode
-  module DisplayWidth
+  class DisplayWidth
     File.open(INDEX_FILENAME, "rb") do |file|
       serialized_data = Zlib::GzipReader.new(file).read
       serialized_data.force_encoding Encoding::BINARY

data/lib/unicode/display_width/no_string_ext.rb

@@ -1,7 +1,8 @@
-module Unicode
-  module DisplayWidth
-    NO_STRING_EXT = true
-  end
-end
+# frozen_string_literal: true
 
-require_relative '../display_width'
+warn "You are loading 'unicode-display_width/no_string_ext'\n" \
+     "Beginning with version 2.0, this is not necessary anymore\n"\
+     "You can just require 'unicode-display_width' now and no\n"\
+     "string extension will be loaded"
+
+require_relative "../display_width"

data/lib/unicode/display_width/string_ext.rb

@@ -1,17 +1,9 @@
-require_relative '../display_width' unless defined? Unicode::DisplayWidth
+# frozen_string_literal: true
+
+require_relative "../display_width" unless defined? Unicode::DisplayWidth
 
 class String
   def display_width(ambiguous = 1, overwrite = {}, options = {})
     Unicode::DisplayWidth.of(self, ambiguous, overwrite, options)
   end
-
-  def display_size(*args)
-    warn "Deprecation warning: Please use `String#display_width` instead of `String#display_size`"
-    display_width(*args)
-  end
-
-  def display_length(*args)
-    warn "Deprecation warning: Please use `String#display_width` instead of `String#display_length`"
-    display_width(*args)
-  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unicode-display_width
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 2.0.0.pre1
 platform: ruby
 authors:
 - Jan Lelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-11 00:00:00.000000000 Z
+date: 2020-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -38,7 +38,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.4'
-description: "[Unicode 13.0.0] Determines the monospace display width of a string
+description: "[Unicode 12.1.0] Determines the monospace display width of a string
   using EastAsianWidth.txt, Unicode general category, and other data."
 email:
 - hi@ruby.consulting
@@ -76,11 +76,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Determines the monospace display width of a string in Ruby.