rangu 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a9c2af7fa78a5071c99ea0e30ad4f903a2c963912aa0f7f0d2c3a5564e64c60
-  data.tar.gz: 453dba103348dfd8aabb4be616cebebed250d81e9db7955ba49cf40d7d96c76c
+  metadata.gz: '09dd594057ccb584243d53f15ad5506e4dcb0ca155423f97c5e1b08f56981596'
+  data.tar.gz: e1591c9cb6a351994aa7eea1f3c22b06e7325871081eaaecd21c001ebe8eefa3
 SHA512:
-  metadata.gz: df2235642f28da6a01314c65438e34e25deb2659386819ace855ac4e97f3150df0328f4fbed06bb1b18035e3036c9888b23f1af99cdb50664b1a5c8c82eda0b7
-  data.tar.gz: d32dc0e5d8885b189201083fb479e2a7aa6b7cafcd60eff540c104051137336dc16cdf2bd2306e5ec1b8ff53e69caa06ddbea18645a7a28284ee10edc67fc6dc
+  metadata.gz: a9052b246105a9455ddb18ecd6a376667e3bbd5897ffade8ca37ffa72b13826c7b5e4df9e010502cab98d051daa05e144e84862907544ca847fef31ad89f34d7
+  data.tar.gz: 8b1400f450b06cfe71b5118b07de1b78f19051acc193c77b6a23aa785adebfdc2bee900e2de96634e90ba4846cf533f013d34b23745a1e02701ea70e08318fc6

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to Rangu are documented in this file.
+
+## 1.0.0 - 2026-07-19
+
+### Added
+
+- Added the `rangu` command-line interface with text, file, and standard-input modes.
+- Added GitHub Actions coverage for Ruby 3.3, 3.4, and 4.0.
+- Added grouped monthly Dependabot updates for Bundler and GitHub Actions.
+
+### Changed
+
+- Updated Rangu's spacing rules to match pangu.py 4.0.6.1 and added corresponding Minitest coverage.
+- Made `Rangu.spacing` and `Rangu.spacing_text` immutable text-only APIs.
+- Made `Rangu.spacing_file` the only file-reading API and preserved file contents.
+- Replaced the RSpec suite with Minitest 6 and modernized the development toolchain to Bundler 4, Rake 13, and
+  RuboCop 1.88.
+- Raised the minimum supported Ruby version to 3.3.
+- Enabled MFA-required RubyGems releases and restricted the gem push host to RubyGems.org.
+
+### Breaking changes from 0.3.0
+
+- CJK-adjacent ASCII punctuation is now normalized to full-width punctuation, and middle-dot variants are normalized
+  to `・`.
+- `Rangu.spacing(existing_path)` no longer reads the file at that path; call `Rangu.spacing_file(path)` instead.
+- Input strings are no longer modified in place.
+- Ruby versions older than 3.3 are no longer supported.

data/README.md

@@ -1,47 +1,107 @@
 # Rangu
 
-[![Build Status](https://travis-ci.org/bugtender/rangu.svg?branch=master)](https://travis-ci.org/bugtender/rangu)
+[![CI](https://github.com/bugtender/rangu/actions/workflows/ci.yml/badge.svg)](https://github.com/bugtender/rangu/actions/workflows/ci.yml)
+[![Gem Version](https://img.shields.io/gem/v/rangu.svg)](https://rubygems.org/gems/rangu)
 
-Paranoid text spacing for good readability, to automatically insert whitespace between CJK (Chinese, Japanese, Korean) and half-width characters (alphabetical letters, numerical digits and symbols).
+Rangu inserts readable spacing between CJK characters and half-width letters, numbers, and symbols. It provides an
+immutable Ruby API and a command-line interface.
 
 This is the Ruby copy version from [Vinta](https://github.com/vinta)'s [pangu.py](https://github.com/vinta/pangu.py).
 
+Rangu requires Ruby 3.3 or newer and has no runtime dependencies.
+
 ## Installation
 
-Add this line to your application's Gemfile:
+Add Rangu to your bundle:
 
-```ruby
-gem 'rangu'
+```shell
+bundle add rangu
 ```
 
-And then execute:
-
-    $ bundle
+Or install the gem directly:
 
-Or install it yourself as:
-
-    $ gem install rangu
+```shell
+gem install rangu
+```
 
-## Usage
+## Ruby API
 
 ```ruby
 require "rangu"
 
 Rangu.spacing("當你凝視著bug，bug也凝視著你")
-=> "當你凝視著 bug，bug 也凝視著你"
+# => "當你凝視著 bug，bug 也凝視著你"
+
+Rangu.spacing_text("Ruby中文")
+# => "Ruby 中文"
 
-Rangu.spacing("path/to/file.txt")
-=> "與 PM 戰鬥的人，應當小心自己不要成為 PM"
+Rangu.spacing_file("notes.txt")
+# => the spaced UTF-8 contents of notes.txt
 ```
 
-## Contributing
+`Rangu.spacing` is the primary text API, and `Rangu.spacing_text` is an alias. Both always treat their argument as
+text, leave the original string unchanged, accept frozen strings, and return a distinct string. `Rangu.spacing_file`
+is the only file-reading API; it reads UTF-8 and never writes the file. File and encoding errors are passed through to
+the caller.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/bugtender/rangu. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+When CJK text is present, Rangu also normalizes adjacent ASCII punctuation such as `~!;:,.?` to full-width forms and
+normalizes `·`, `•`, and `‧` to `・`. Leading and trailing whitespace is removed from CJK results.
 
-## License
+## Command-line interface
+
+```shell
+rangu "當你凝視著bug，bug也凝視著你"
+rangu --text "Ruby中文"
+rangu --file notes.txt
+printf "中文Ruby" | rangu
+rangu --version
+rangu --help
+```
+
+Text, file, and positional modes are mutually exclusive. Explicit input takes priority over standard input, and stdin
+is read only when no explicit input is provided. Results go to stdout; usage, option, and file errors go to stderr with
+a non-zero exit status. The CLI never edits a file in place.
+
+## Upgrading from 0.3.0
+
+Rangu 1.0.0 has four intentional breaking changes:
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+- ASCII punctuation adjacent to CJK text is now normalized to full-width punctuation, including middle-dot conversion.
+- `Rangu.spacing(existing_path)` no longer detects or reads files. Use `Rangu.spacing_file(path)` explicitly.
+- Spacing APIs no longer modify the input string and always return a separate string.
+- The minimum supported Ruby version is now 3.3.
 
-## Code of Conduct
+## Development
+
+Install Ruby 3.3 or newer and Bundler 4, then run:
+
+```shell
+bin/setup
+bundle exec rake
+```
+
+The default Rake task runs the Minitest suite and RuboCop. Individual checks and the package build are also available:
+
+```shell
+bundle exec rake test
+bundle exec rubocop
+bundle exec rake build
+```
+
+Bug reports and pull requests are welcome in the [issue tracker](https://github.com/bugtender/rangu/issues). By
+participating, you agree to follow the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+## Manual release
+
+1. Update `Rangu::VERSION` and `CHANGELOG.md` in a release commit.
+2. Run `bundle exec rake` and `bundle exec rake build`.
+3. Inspect `pkg/rangu-VERSION.gem`, then install it into a temporary `GEM_HOME` for a smoke test.
+4. Create and push an annotated `vVERSION` tag.
+5. Publish with `gem push --host https://rubygems.org --otp OTP pkg/rangu-VERSION.gem`.
+
+RubyGems publishing is restricted to `https://rubygems.org`, and all owners must have multi-factor authentication
+enabled. Releases are manual; CI does not publish gems.
+
+## License
 
-Everyone interacting in the Rangu project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/bugtender/rangu/blob/master/CODE_OF_CONDUCT.md).
+Rangu is available under the [MIT License](LICENSE).

data/exe/rangu

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "rangu/cli"
+
+exit Rangu::CLI.run(ARGV)

data/lib/rangu/cli.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require "optparse"
+require "rangu"
+
+module Rangu
+  class CLI
+    SUCCESS = 0
+    ERROR = 1
+    USAGE_ERROR = 2
+
+    def self.run(arguments, stdin: $stdin, stdout: $stdout, stderr: $stderr)
+      new(stdin:, stdout:, stderr:).run(arguments)
+    end
+
+    def initialize(stdin:, stdout:, stderr:)
+      @stdin = stdin
+      @stdout = stdout
+      @stderr = stderr
+    end
+
+    def run(arguments)
+      options = {}
+      parser = option_parser(options)
+      positional = parser.parse(arguments.dup)
+      return print_help(parser) if options[:help]
+      return print_version if options[:version]
+
+      source = resolve_source(options, positional, parser)
+      source ? execute(source) : USAGE_ERROR
+    rescue OptionParser::ParseError => e
+      report_usage(e.message, parser)
+      USAGE_ERROR
+    end
+
+    private
+
+    def option_parser(options)
+      OptionParser.new do |parser|
+        parser.banner = "Usage: rangu [TEXT] | --text TEXT | --file PATH"
+        parser.summary_width = 24
+
+        parser.on("-t", "--text TEXT", "space the provided text") { |text| options[:text] = text }
+        parser.on("-f", "--file PATH", "read and space a UTF-8 file") { |path| options[:file] = path }
+        parser.on("-v", "--version", "print the version") { options[:version] = true }
+        parser.on("-h", "--help", "show this help") { options[:help] = true }
+
+        parser.separator("")
+        parser.separator("With no explicit input, rangu reads standard input. Files are never modified.")
+      end
+    end
+
+    def resolve_source(options, positional, parser)
+      return report_usage("expected at most one TEXT argument", parser) if positional.length > 1
+
+      sources = explicit_sources(options, positional)
+      return report_usage("text and file inputs are mutually exclusive", parser) if sources.length > 1
+      return sources.first unless sources.empty?
+
+      standard_input_source(parser)
+    end
+
+    def explicit_sources(options, positional)
+      sources = []
+      sources << [:text, options[:text]] if options.key?(:text)
+      sources << [:file, options[:file]] if options.key?(:file)
+      sources << [:text, positional.first] unless positional.empty?
+      sources
+    end
+
+    def standard_input_source(parser)
+      input = @stdin.read
+      return report_usage("no input provided", parser) if input.empty?
+
+      [:text, input]
+    end
+
+    def execute(source)
+      mode, value = source
+      result = mode == :file ? Rangu.spacing_file(value) : Rangu.spacing(value)
+      @stdout.puts(result)
+      SUCCESS
+    rescue SystemCallError, IOError, EncodingError, ArgumentError => e
+      @stderr.puts("rangu: #{e.message}")
+      ERROR
+    end
+
+    def print_help(parser)
+      @stdout.puts(parser)
+      SUCCESS
+    end
+
+    def print_version
+      @stdout.puts(VERSION)
+      SUCCESS
+    end
+
+    def report_usage(message, parser)
+      @stderr.puts("rangu: #{message}")
+      @stderr.puts(parser.banner)
+      nil
+    end
+  end
+end

data/lib/rangu/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Rangu
-  VERSION = "0.3.0"
+  VERSION = "1.0.0"
 end

data/lib/rangu.rb

@@ -1,68 +1,138 @@
+# frozen_string_literal: true
+
 require "rangu/version"
 
 module Rangu
-  CJK_QUOTE         = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])(["\'])/i
-  QUOTE_CJK         = /(["\'])([\u3040-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])/i
+  # Spacing rules adapted from pangu.py 4.0.6.1.
+  CJK = "\\u2e80-\\u2eff\\u2f00-\\u2fdf\\u3040-\\u309f\\u30a0-\\u30fa\\u30fc-\\u30ff" \
+        "\\u3100-\\u312f\\u3200-\\u32ff\\u3400-\\u4dbf\\u4e00-\\u9fff\\uf900-\\ufaff"
 
-  FIX_QUOTE         = /(["\'\(\[\{<\u201c]+)(\s*)(.+?)(\s*)(["\'\)\]\}>\u201d]+)/i
-  FIX_SINGLE_QUOTE  = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])( )(\')([A-Za-zΑ-Ωα-ω])/i
+  ANY_CJK = /[#{CJK}]/
 
-  CJK_HASH          = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])(#(\S+))/i
-  HASH_CJK          = /((\S+)#)([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])/i
+  CONVERT_TO_FULLWIDTH_CJK_SYMBOLS_CJK = /([#{CJK}])( *(?::+|\.) *)([#{CJK}])/
+  CONVERT_TO_FULLWIDTH_CJK_SYMBOLS = /([#{CJK}]) *([~!;,?]+) */
+  DOTS_CJK = /(\.{2,}|…)([#{CJK}])/
+  FIX_CJK_COLON_ANS = /([#{CJK}]):([A-Z0-9()])/
 
-  CJK_OPERATOR_ANS  = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])([\+\-\*\/=&\\|<>])([A-Za-zΑ-Ωα-ω0-9])/i
-  ANS_OPERATOR_CJK  = /([A-Za-zΑ-Ωα-ω0-9])([\+\-\*\/=&\\|<>])([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])/i
+  CJK_QUOTE = /([#{CJK}])([`"״])/
+  QUOTE_CJK = /([`"״])([#{CJK}])/
+  FIX_QUOTE_ANY_QUOTE = /([`"״]+)(\s*)(.+?)(\s*)([`"״]+)/
 
-  CJK_BRACKET_CJK   = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])([\(\[\{<\u201c]+(.*?)[\)\]\}>\u201d]+)([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])/i
-  CJK_BRACKET       = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])([\(\[\{<\u201c>])/i
-  BRACKET_CJK       = /([\)\]\}>\u201d<])([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])/i
-  FIX_BRACKET       = /([\(\[\{<\u201c]+)(\s*)(.+?)(\s*)([\)\]\}>\u201d]+)/i
+  CJK_SINGLE_QUOTE_BUT_POSSESSIVE = /([#{CJK}])('[^s])/
+  SINGLE_QUOTE_CJK = /(')([#{CJK}])/
+  FIX_POSSESSIVE_SINGLE_QUOTE = /([#{CJK}A-Za-z0-9])( )('s)/
 
-  FIX_SYMBOL        = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])([~!;:,\.\?\u2026])([A-Za-zΑ-Ωα-ω0-9])/i
+  HASH_ANS_CJK_HASH = /([#{CJK}])(#)([#{CJK}]+)(#)([#{CJK}])/
+  CJK_HASH = /([#{CJK}])(#([^ ]))/
+  HASH_CJK = /(([^ ])#)([#{CJK}])/
 
-  CJK_ANS           = /([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])([A-Za-zΑ-Ωα-ω0-9`\$%\^&\*\-=\+\\\|\/@\u00a1-\u00ff\u2022\u2027\u2150-\u218f])/i
-  ANS_CJK           = /([A-Za-zΑ-Ωα-ω0-9`~\$%\^&\*\-=\+\\\|\/!;:,\.\?\u00a1-\u00ff\u2022\u2026\u2027\u2150-\u218f])([\u2e80-\u2eff\u2f00-\u2fdf\u3040-\u309f\u30a0-\u30ff\u3100-\u312f\u3200-\u32ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff])/i
+  CJK_OPERATOR_ANS = %r{([#{CJK}])([+\-*/=&|<>])([A-Za-z0-9])}
+  ANS_OPERATOR_CJK = %r{([A-Za-z0-9])([+\-*/=&|<>])([#{CJK}])}
 
-  def self.spacing_text(text)
-    text.gsub!(CJK_QUOTE, "\\1 \\2")
-    text.gsub!(QUOTE_CJK, "\\1 \\2")
+  FIX_SLASH_AS = %r{(/) ([a-z\-_./]+)}
+  FIX_SLASH_AS_SLASH = %r{([/.])([A-Za-z\-_./]+) (/)}
 
-    text.gsub!(FIX_QUOTE, "\\1\\3\\5")
-    text.gsub!(FIX_SINGLE_QUOTE, "\\1\\3\\4")
+  CJK_LEFT_BRACKET = /([#{CJK}])([\(\[\{<>“])/
+  RIGHT_BRACKET_CJK = /([)\]}<>”])([#{CJK}])/
+  FIX_LEFT_BRACKET_ANY_RIGHT_BRACKET = /([\(\[\{<“]+)(\s*)(.+?)(\s*)([)\]}>”]+)/
+  ANS_CJK_LEFT_BRACKET_ANY_RIGHT_BRACKET = /([A-Za-z0-9#{CJK}]) *(“)([A-Za-z0-9#{CJK}\-_ ]+)(”)/
+  LEFT_BRACKET_ANY_RIGHT_BRACKET_ANS_CJK = /(“)([A-Za-z0-9#{CJK}\-_ ]+)(”) *([A-Za-z0-9#{CJK}])/
 
-    text.gsub!(CJK_HASH, "\\1 \\2")
-    text.gsub!(HASH_CJK, "\\1 \\3")
+  AN_LEFT_BRACKET = /([A-Za-z0-9])([\(\[\{])/
+  RIGHT_BRACKET_AN = /([)\]}])([A-Za-z0-9])/
 
-    text.gsub!(CJK_OPERATOR_ANS, "\\1 \\2 \\3")
-    text.gsub!(ANS_OPERATOR_CJK, "\\1 \\2 \\3")
+  CJK_ANS = %r{([#{CJK}])([A-Za-z\u0370-\u03ff0-9@$%\^&*\-+\\=|/\u00a1-\u00ff\u2150-\u218f\u2700—\u27bf])}
+  ANS_CJK = %r{([A-Za-z\u0370-\u03ff0-9~!$%\^&*\-+\\=|;:,./?\u00a1-\u00ff\u2150-\u218f\u2700—\u27bf])([#{CJK}])}
 
-    old_text = text
-    text.gsub!(CJK_BRACKET_CJK, "\\1 \\2 \\4")
-    if old_text == text
-      text.gsub!(CJK_BRACKET, "\\1 \\2")
-      text.gsub!(BRACKET_CJK, "\\1 \\2")
-    end
-    text.gsub!(FIX_BRACKET, "\\1\\3\\5")
+  S_A = /(%)([A-Za-z])/
+  MIDDLE_DOT = /( *)([·•‧])( *)/
 
-    text.gsub!(FIX_SYMBOL, "\\1\\2 \\3")
+  TILDES = /~+/
+  EXCLAMATION_MARKS = /!+/
+  SEMICOLONS = /;+/
+  COLONS = /:+/
+  COMMAS = /,+/
+  PERIODS = /\.+/
+  QUESTION_MARKS = /\?+/
 
-    text.gsub!(CJK_ANS, "\\1 \\2")
-    text.gsub!(ANS_CJK, "\\1 \\2")
-    text
+  def self.spacing(text)
+    return text.dup if text.length <= 1 || !ANY_CJK.match?(text)
+
+    new_text = normalize_fullwidth_symbols_between_cjk(text.dup)
+    new_text = normalize_fullwidth_symbols_after_cjk(new_text)
+
+    new_text = new_text.gsub(DOTS_CJK, "\\1 \\2")
+    new_text = new_text.gsub(FIX_CJK_COLON_ANS, "\\1：\\2")
+
+    new_text = new_text.gsub(CJK_QUOTE, "\\1 \\2")
+    new_text = new_text.gsub(QUOTE_CJK, "\\1 \\2")
+    new_text = new_text.gsub(FIX_QUOTE_ANY_QUOTE, "\\1\\3\\5")
+
+    new_text = new_text.gsub(CJK_SINGLE_QUOTE_BUT_POSSESSIVE, "\\1 \\2")
+    new_text = new_text.gsub(SINGLE_QUOTE_CJK, "\\1 \\2")
+    new_text = new_text.gsub(FIX_POSSESSIVE_SINGLE_QUOTE, "\\1's")
+
+    new_text = new_text.gsub(HASH_ANS_CJK_HASH, "\\1 \\2\\3\\4 \\5")
+    new_text = new_text.gsub(CJK_HASH, "\\1 \\2")
+    new_text = new_text.gsub(HASH_CJK, "\\1 \\3")
+
+    new_text = new_text.gsub(CJK_OPERATOR_ANS, "\\1 \\2 \\3")
+    new_text = new_text.gsub(ANS_OPERATOR_CJK, "\\1 \\2 \\3")
+
+    new_text = new_text.gsub(FIX_SLASH_AS, "\\1\\2")
+    new_text = new_text.gsub(FIX_SLASH_AS_SLASH, "\\1\\2\\3")
+
+    new_text = new_text.gsub(CJK_LEFT_BRACKET, "\\1 \\2")
+    new_text = new_text.gsub(RIGHT_BRACKET_CJK, "\\1 \\2")
+    new_text = new_text.gsub(FIX_LEFT_BRACKET_ANY_RIGHT_BRACKET, "\\1\\3\\5")
+    new_text = new_text.gsub(ANS_CJK_LEFT_BRACKET_ANY_RIGHT_BRACKET, "\\1 \\2\\3\\4")
+    new_text = new_text.gsub(LEFT_BRACKET_ANY_RIGHT_BRACKET_ANS_CJK, "\\1\\2\\3 \\4")
+
+    new_text = new_text.gsub(AN_LEFT_BRACKET, "\\1 \\2")
+    new_text = new_text.gsub(RIGHT_BRACKET_AN, "\\1 \\2")
+
+    new_text = new_text.gsub(CJK_ANS, "\\1 \\2")
+    new_text = new_text.gsub(ANS_CJK, "\\1 \\2")
+    new_text = new_text.gsub(S_A, "\\1 \\2")
+    new_text.gsub(MIDDLE_DOT, "・").strip
+  end
+
+  class << self
+    alias spacing_text spacing
   end
 
   def self.spacing_file(path)
-    file = File.open(path, "r")
-    data = file.read
-    file.close
-    spacing_text(data)
+    spacing(File.read(path, encoding: Encoding::UTF_8))
   end
 
-  def self.spacing(text_or_path)
-    if File.file?(File.absolute_path(text_or_path))
-      spacing_file(text_or_path)
-    else
-      spacing_text(text_or_path)
+  def self.normalize_fullwidth_symbols_between_cjk(text)
+    while (matched = CONVERT_TO_FULLWIDTH_CJK_SYMBOLS_CJK.match(text))
+      text[matched.begin(0)...matched.end(0)] = "#{matched[1]}#{convert_to_fullwidth(matched[2])}#{matched[3]}"
     end
+
+    text
+  end
+  private_class_method :normalize_fullwidth_symbols_between_cjk
+
+  def self.normalize_fullwidth_symbols_after_cjk(text)
+    while (matched = CONVERT_TO_FULLWIDTH_CJK_SYMBOLS.match(text))
+      prefix = text[0, matched.begin(0) + 1].strip
+      suffix = text[matched.end(0)..].strip
+      text = "#{prefix}#{convert_to_fullwidth(matched[2])}#{suffix}"
+    end
+
+    text
+  end
+  private_class_method :normalize_fullwidth_symbols_after_cjk
+
+  def self.convert_to_fullwidth(symbols)
+    symbols = symbols.gsub(TILDES, "～")
+    symbols = symbols.gsub(EXCLAMATION_MARKS, "！")
+    symbols = symbols.gsub(SEMICOLONS, "；")
+    symbols = symbols.gsub(COLONS, "：")
+    symbols = symbols.gsub(COMMAS, "，")
+    symbols = symbols.gsub(PERIODS, "。")
+    symbols.gsub(QUESTION_MARKS, "？").strip
   end
+  private_class_method :convert_to_fullwidth
 end

metadata

@@ -1,84 +1,39 @@
 --- !ruby/object:Gem::Specification
 name: rangu
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Vincent Lin
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-01-21 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
 description: Insert a white space between FullWidth and HalfWidth characters.
 email:
 - bugtender@gmail.com
-executables: []
+executables:
+- rangu
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".rubocop.yml"
-- ".travis.yml"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
-- Gemfile
-- Gemfile.lock
 - LICENSE
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
+- exe/rangu
 - lib/rangu.rb
+- lib/rangu/cli.rb
 - lib/rangu/version.rb
-- rangu.gemspec
 homepage: https://github.com/bugtender/rangu
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  allowed_push_host: https://rubygems.org
+  bug_tracker_uri: https://github.com/bugtender/rangu/issues
+  changelog_uri: https://github.com/bugtender/rangu/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/bugtender/rangu
 rdoc_options: []
 require_paths:
 - lib
@@ -86,16 +41,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.3
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Paranoid text spacing in Ruby
 test_files: []

data/.gitignore

@@ -1,12 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status
-.vscode/

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper