mail_address 1.2.20 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11efdd5a61a85e9557f4d6b51371aac1aeb222d87e8439b08f65f22283909f23
-  data.tar.gz: 38c1f50d38c14b688b5839c6203dd2200dd20d4581ed77129bad1f7828c09ef5
+  metadata.gz: 6b0a0f8f9570bee5727e30b23812e5e453d134c7b0bd6600bea16d8a77e72d63
+  data.tar.gz: aedca5179b75e924bbc4257b51a62e9b0bb9bfaf5568a532006d1c0c327b3201
 SHA512:
-  metadata.gz: 45d4af2ecbca6933e76471dd07b2a91a5cb266ce7a9d22f386f0b8ffc0b0f3a5f13fffad028b771accc46a4e3afc052ce71440e2ee82c2205a10d6fda9e81b06
-  data.tar.gz: fc20c95ea8c293e0375280ce5ed63a857ced78d9b81d3ec991a3cca695bac65a4a31d568dced459ce183de4bc727ce2c6b06cf70ecd88fef66bddae844a78a84
+  metadata.gz: ce591ea386c87a8c7118f46db6ba4b503afe150f67ce8f9fd921f4c31470bba81fefba624d1ee377a6a2c46a5087df1ad9174c7abe79bf3702269809f2bbe4ae
+  data.tar.gz: e245562580351606d037c41a618629078ff4d89cd5f59deb3e7b10dd67907a7413d8186feb7cfe61beed77932f932cb726d1c630fc6e1fcdffbab7d2bffe30b7

data/.github/workflows/test.yml

@@ -0,0 +1,34 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version: ['2.7', '3.0', '3.1', '3.2', '3.3', '3.4']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake spec
+
+      - name: Upload coverage to Coveralls
+        if: matrix.ruby-version == '3.4'
+        uses: coverallsapp/github-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          file: coverage/lcov/mail_address.lcov

data/CLAUDE.md

@@ -0,0 +1,43 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+MailAddress は Perl の `Mail::Address` モジュールを Ruby に移植したメールアドレスパーサー gem。RFC非準拠のアドレス（docomo/au などの日本のキャリアメールで使われる `..` や末尾 `.`）もパース可能。ランタイム依存なし（Pure Ruby）。
+
+## Commands
+
+```bash
+# テスト実行（デフォルトの rake タスク）
+bundle exec rake spec
+
+# 特定ファイルのテスト
+bundle exec rspec spec/mail_address_spec.rb
+
+# 特定行のテスト
+bundle exec rspec spec/mail_address_spec.rb:10
+```
+
+リンターは未設定。
+
+## Architecture
+
+### コア構造
+
+- **`lib/mail_address.rb`** — エントリポイント。`MailAddress.parse`, `MailAddress.parse_first`, `MailAddress.parse_simple` を提供
+- **`lib/mail_address/address.rb`** — `MailAddress::Address` クラス。パース結果を保持（`phrase`, `address`, `original`）し、`name`, `host`, `user`, `format` メソッドを提供
+- **`lib/mail_address/mail_address.rb`** — メインのパースロジック。トークン化と複雑なアドレスフォーマットの処理
+- **`lib/mail_address/simple_parser.rb`** — Google Closure Library ベースのシンプルパーサー（スペース/カンマ区切りのアドレス向け）
+
+### パース戦略
+
+2つのパーサーを使い分ける:
+- **メインパーサー** (`parse`) — RFC準拠・非準拠の複雑なフォーマットを処理。括弧コメント、クォート、MIME エンコードなどに対応
+- **シンプルパーサー** (`parse_simple` / `g_parse`) — 空白・カンマ区切りの単純なリスト向け
+
+### コーディング規約
+
+- プライベートメソッドは `_` プレフィックス（例: `_tokenize`, `_complete`）
+- 定数は `UPPER_CASE`
+- テストは RSpec 3 の `expect` 構文を使用

data/README.md

@@ -1,20 +1,18 @@
-# MailAddress [![Build Status](https://travis-ci.org/kizashi1122/mail_address.svg)](https://travis-ci.org/kizashi1122/mail_address) [![Coverage Status](https://coveralls.io/repos/kizashi1122/mail_address/badge.png)](https://coveralls.io/r/kizashi1122/mail_address) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/kizashi1122/mail_address/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/kizashi1122/mail_address/?branch=master)
+# MailAddress [![Test](https://github.com/kizashi1122/mail_address/actions/workflows/test.yml/badge.svg)](https://github.com/kizashi1122/mail_address/actions/workflows/test.yml) [![Coverage Status](https://coveralls.io/repos/github/kizashi1122/mail_address/badge.svg?branch=master)](https://coveralls.io/github/kizashi1122/mail_address?branch=master)
 
-MailAddress is a port of Mail::Address from Perl.
-
-[mail](https://github.com/mikel/mail) is a great gem library. But some email addresses are unparsable with it. In perl, [Mail::Address](http://search.cpan.org/~markov/MailTools-2.14/lib/Mail/Address.pod) is a very common library to parse email addresses. Mail::Address conviniently can parse even non-RFC-compliant email addresses such as:
+MailAddress is a Ruby port of Perl's [Mail::Address](http://search.cpan.org/~markov/MailTools-2.14/lib/Mail/Address.pod), a widely used email address parser. While the [mail](https://github.com/mikel/mail) gem is excellent, it cannot parse certain email addresses. Mail::Address can conveniently parse even non-RFC-compliant email addresses such as:
 
 ```rb
 # mail gem cannot parse the following addresses
 Ello [Do Not Reply] <do-not-reply@ello.co> # [, ] are not permitted according to RFC5322
 大阪 太郎<osaka@example.com> # no whitespace just before `<`
 ```
-But Mail::Address(Perl) has some bad points (below). These are fixed in MailAddress.
+However, Mail::Address (Perl) has some limitations that MailAddress addresses:
 
-- if no ending parenthesis in name part, cannot parse correctly.
-- Modifications of name part are too much.
+- Fails to parse correctly when the name part has no closing parenthesis.
+- Over-modifies the name part.
 
-Many people copy and paste email addresses from Excel or the other spreadsheets. In this case, addresses are separated by whitespace(tab or space). To enable to parse this, also ported from a parser part of [Google Closure Library](https://github.com/google/closure-library/blob/master/closure/goog/format/emailaddress.js).
+Many people copy and paste email addresses from Excel or other spreadsheets, where addresses are separated by whitespace (tab or space). To handle this, MailAddress also includes a parser ported from the [Google Closure Library](https://github.com/google/closure-library/blob/master/closure/goog/format/emailaddress.js).
 
 ## Installation
 
@@ -34,8 +32,8 @@ Or install it yourself as:
 
 ## Usage
 
-It's almost the same as Mail::Address(Perl).
-But in this module, removed `comment` property from address class in version v1.0.0. Most people don't realize comment I think.
+The API is almost the same as Mail::Address (Perl).
+Note that the `comment` property was removed from the address class in v1.0.0, since most users are unlikely to need it.
 
 ```rb
 require 'mail_address'
@@ -60,10 +58,10 @@ p addrs[1].user       # "osaka"
 p addrs[1].original   # "大阪 太郎 <osaka@example.jp>"
 ```
 
-`address.name` and `address.phrase` are almost same.
+`address.name` and `address.phrase` are almost the same.
 `address.phrase` keeps outermost double quotes or parentheses.
 
-if you specify single email address, you can use `parse_first`.
+If you only need a single address, you can use `parse_first`.
 
 ```rb
 line = "John Doe <john@example.com>"
@@ -83,7 +81,7 @@ addrs = MailAddress.parse_simple(line)
 
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/mail_address/fork )
+1. Fork it ( https://github.com/kizashi1122/mail_address/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)

data/lib/mail_address/address.rb

@@ -27,7 +27,7 @@ module MailAddress
 
       email_address = enquote ? quoted_address : @address
 
-      if !@phrase.nil? && @phrase.length > 0
+      if !@phrase.nil? && !@phrase.empty?
         # if @phrase.match(/\A\(/) && @phrase.match(/\)\z/)
         #   addr.push(email_address) if !@address.nil? && @address.length > 0
         #   addr.push(@phrase)
@@ -35,11 +35,11 @@ module MailAddress
           addr.push(
             @phrase.match(/^(?:#{ATEXT})+$/) ? @phrase
             : @phrase.match(/(?<!\\)"/)      ? @phrase
-            : %Q("#{@phrase}")
+            : "\"#{@phrase}\""
             )
-          addr.push "<#{email_address}>" if !@address.nil? && @address.length > 0
+          addr.push "<#{email_address}>" if !@address.nil? && !@address.empty?
         # end
-      elsif !@address.nil? && @address.length > 0
+      elsif !@address.nil? && !@address.empty?
         addr.push(email_address)
       end
       addr.join(' ')
@@ -48,19 +48,19 @@ module MailAddress
     def name
       phrase = @phrase.dup
       name   = Address._extract_name(phrase)
-      name.length > 0 ? name : nil
+      !name.empty? ? name : nil
     end
 
     def host
-      addr = @address || '';
+      addr = @address || ''
       i = addr.rindex('@')
-      i.nil? ? nil : addr[i + 1 .. -1]
+      addr[(i + 1)..] if i
     end
 
     def user
-      addr = @address || '';
+      addr = @address || ''
       i = addr.rindex('@')
-      i.nil? ? addr : addr[0 ... i]
+      i ? addr[0...i] : addr
     end
 
     def quoted_address
@@ -78,18 +78,16 @@ module MailAddress
     # given a comment, attempt to extract a person's name
     def self._extract_name(name)
       # This function can be called as method as well
-      return '' if name.nil? || name == ''
+      return '' if name.nil? || name.empty?
 
       # Using encodings, too hard. See Mail::Message::Field::Full.
-      return '' if name.match(/\=\?.*?\?\=/)
+      return '' if name.match?(/\=\?.*?\?\=/)
 
       # trim whitespace
-      name.sub!(/^\s+/, '')
-      name.sub!(/\s+$/, '')
-      name.sub!(/\s+/, ' ')
+      name = name.strip.gsub(/\s+/, ' ')
 
       # Disregard numeric names (e.g. 123456.1234@compuserve.com)
-      return "" if name.match(/^[\d ]+$/)
+      return '' if name.match?(/^[\d ]+$/)
 
       name.sub!(/^\((.*)\)$/, '\1') # remove outermost parenthesis
       name.sub!(/^"(.*)"$/, '\1')   # remove outer quotation marks

data/lib/mail_address/mail_address.rb

@@ -10,24 +10,24 @@ module MailAddress
     line = lines.join('').strip
 
     # empty or <> or < or >
-    if line.empty? || line.match(/\A[<>;, \\]+\z/)
+    if line.empty? || line.match?(/\A[<>;, \\]+\z/)
       return [ MailAddress::Address.new(line, nil, line) ]
     end
 
     # undisclosed-recipient
-    if line.match(/undisclosed[ \-]recipients?: ?;?/i)
+    if line.match?(/undisclosed[ \-]recipients?: ?;?/i)
       return [ MailAddress::Address.new(line, nil, line) ]
     end
 
     phrase, address, objs = [], [], []
-    original = ''
+    original = ''.dup
     depth, idx, end_paren_idx = 0, 0, 0
 
     tokens = _tokenize lines
     len    = tokens.length
     _next  = _find_next idx, tokens, len
 
-    for idx in 0 ... len do
+    (0...len).each do |idx|
 
       token = tokens[idx]
       substr = token[0, 1]
@@ -55,7 +55,8 @@ module MailAddress
         if depth > 0
           # raise "Unmatched '<>' in line"
           o = MailAddress::Address.new(original, nil, original)
-          phrase.clear; address.clear
+          phrase.clear
+          address.clear
         else
           o = _complete(phrase, address, original)
         end
@@ -63,14 +64,14 @@ module MailAddress
         objs.push(o) if o
         depth = 0
         end_paren_idx = 0
-        original = ''
+        original = ''.dup
         _next = _find_next idx+1, tokens, len
       elsif (depth > 0)
         token.strip!
         address.push(token)
       elsif (_next == '<')
         phrase.push(token)
-      elsif ( token.match(/^[.\@:;]/) || address.empty? || address[-1].match(/^[.\@:;]/) )
+      elsif ( token.match?(/^[.\@:;]/) || address.empty? || address[-1].match?(/^[.\@:;]/) )
         token.strip!
         address.push(token)
       else
@@ -90,10 +91,9 @@ module MailAddress
     line.sub!(/\A\s+/, '')
     line.gsub!(/[\r\n]+/,' ')
 
-    while (line != '')
-      tmp = nil
+    until line.empty?
       if (
-          line.match(/"[^"]+"/) && line.sub!(/\A(\\?"(?:[^"\\]+|\\.)*")(\s*)/, '')  || # "..."
+          line.match?(/"[^"]+"/) && line.sub!(/\A(\\?"(?:[^"\\]+|\\.)*")(\s*)/, '')  || # "..."
           line.sub!(/\A([^\s()<>\@,;:\\".\[\]]+)(\s*)/, '') ||
           line.sub!(/\A([()<>\@,;:\\".\[\]])(\s*)/, '')
           )
@@ -127,7 +127,7 @@ module MailAddress
   end
 
   def self._complete (phrase, address, original)
-    phrase.length > 0 || address.length > 0 or return nil
+    return nil if phrase.empty? && address.empty?
 
     name = phrase.join('').strip
 
@@ -140,7 +140,8 @@ module MailAddress
     name = name.gsub(ESCAPED_BACKSLASHES_, '\\')
 
     new_address = MailAddress::Address.new(name, address.join(''), original)
-    phrase.clear; address.clear
+    phrase.clear
+    address.clear
     new_address
   end
 

data/lib/mail_address/simple_parser.rb

@@ -20,20 +20,20 @@ module MailAddress
 
   def self.parse_simple(str)
     result = []
-    email = token = ''
+    email = token = ''.dup
 
     # Remove non-UNIX-style newlines that would otherwise cause getToken_ to
     # choke. Remove multiple consecutive whitespace characters for the same
     # reason.
-    str = self.collapse_whitespace(str)
+    str = collapse_whitespace(str)
     i = 0
-    while (i < str.length)
+    while i < str.length
       token = get_token(str, i)
-      if self.is_address_separator(token) || (token == ' ' && self.is_valid(self.parse_internal(email)))
-        if !self.is_empty_or_whitespace(email)
-          result.push(self.parse_internal(email))
+      if is_address_separator(token) || (token == ' ' && is_valid(parse_internal(email)))
+        if !is_empty_or_whitespace(email)
+          result.push(parse_internal(email))
         end
-        email = ''
+        email = ''.dup
         i += 1
         next
       end
@@ -42,34 +42,34 @@ module MailAddress
     end
 
     # Add the final token.
-    if (!self.is_empty_or_whitespace(email))
-      result.push(self.parse_internal(email))
+    if !is_empty_or_whitespace(email)
+      result.push(parse_internal(email))
     end
-    return result
+    result
   end
 
   def self.parse_internal(addr)
-    name = ''
-    address = ''
+    name = ''.dup
+    address = ''.dup
     i = 0
-    while (i < addr.length)
+    while i < addr.length
       token = get_token(addr, i)
-      if (token[0] == '<' && token.index('>'))
+      if token[0] == '<' && token.index('>')
         end_i = token.index('>')
         address = token[1, end_i - 1]
-      elsif (address == '')
+      elsif address == ''
         name << token
       end
       i += token.length
     end
 
     # Check if it's a simple email address of the form "jlim@google.com".
-    if (address == '' && name.index('@'))
+    if address == '' && name.index('@')
       address = name
       name = ''
     end
 
-    name = self.collapse_whitespace(name)
+    name = collapse_whitespace(name)
     name = name[1 .. -2] if name.start_with?('\'') && name.end_with?('\'')
     name = name[1 .. -2] if name.start_with?('"') && name.end_with?('"')
 
@@ -89,7 +89,7 @@ module MailAddress
     p = OPENERS_.index(ch)
     return ch unless p
 
-    if (self.is_escaped_dbl_quote(str, pos))
+    if is_escaped_dbl_quote(str, pos)
       # If an opener is an escaped quote we do not treat it as a real opener
       # and keep accumulating the token.
       return ch
@@ -99,19 +99,18 @@ module MailAddress
 
     # If the closer is a quote we go forward skipping escaped quotes until we
     # hit the real closing one.
-    while (end_pos && end_pos >= 0 && self.is_escaped_dbl_quote(str, end_pos))
+    while end_pos && end_pos >= 0 && is_escaped_dbl_quote(str, end_pos)
       end_pos = str.index(closer_char, end_pos + 1)
     end
 
-    token = (end_pos && end_pos >= 0) ? str[pos .. end_pos] : ch
-    return token
+    (end_pos && end_pos >= 0) ? str[pos .. end_pos] : ch
   end
 
   def self.is_escaped_dbl_quote(str, pos)
     return false if str[pos] != '"'
     slash_count = 0
 
-    for idx in (pos - 1).downto(0)
+    (pos - 1).downto(0) do |idx|
       break unless str[idx] == '\\'
       slash_count += 1
     end
@@ -123,7 +122,7 @@ module MailAddress
   end
 
   def self.is_empty_or_whitespace(str)
-    /\A[\s\xc2\xa0]*\z/ =~ str
+    str.match?(/\A[\s\xc2\xa0]*\z/)
   end
 
   def self.is_address_separator(ch)

data/lib/mail_address/version.rb

@@ -1,3 +1,3 @@
 module MailAddress
-  VERSION = "1.2.20"
+  VERSION = "1.3.1"
 end

data/lib/mail_address.rb

@@ -4,5 +4,4 @@ module MailAddress
   require "mail_address/address"
   require "mail_address/mail_address"
   require "mail_address/simple_parser"
-  require "mail_address/version"
 end

data/mail_address.gemspec

@@ -1,5 +1,4 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'mail_address/version'
 
@@ -8,10 +7,11 @@ Gem::Specification.new do |spec|
   spec.version       = MailAddress::VERSION
   spec.authors       = ["Kizashi Nagata"]
   spec.email         = ["kizashi1122@gmail.com"]
-  spec.summary       = %q{Simple Mail Address Parser}
-  spec.description   = %q{A practical mail address parser implemented based on Perl Module Mail::Address.}
+  spec.summary       = "Simple Mail Address Parser"
+  spec.description   = "A practical mail address parser implemented based on Perl Module Mail::Address."
   spec.homepage      = "https://github.com/kizashi1122/mail_address"
   spec.license       = "MIT"
+  spec.required_ruby_version = '>= 2.7'
 
   spec.files         = `git ls-files -z`.split("\x0")
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
@@ -21,5 +21,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 2.1"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency 'rspec', '~> 3.1', '>= 3.1.0'
-  spec.add_development_dependency "coveralls"
+  spec.add_development_dependency "simplecov", "~> 0.22"
+  spec.add_development_dependency "simplecov-lcov", "~> 0.8"
 end

data/spec/spec_helper.rb

@@ -1,11 +1,14 @@
 require 'simplecov'
-require 'coveralls'
-Coveralls.wear!
 
-SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new([
-  SimpleCov::Formatter::HTMLFormatter,
-  Coveralls::SimpleCov::Formatter
-])
+if ENV['CI']
+  require 'simplecov-lcov'
+  SimpleCov::Formatter::LcovFormatter.config.report_with_single_file = true
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new([
+    SimpleCov::Formatter::HTMLFormatter,
+    SimpleCov::Formatter::LcovFormatter
+  ])
+end
+
 SimpleCov.start do
   add_filter '.bundle/'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mail_address
 version: !ruby/object:Gem::Version
-  version: 1.2.20
+  version: 1.3.1
 platform: ruby
 authors:
 - Kizashi Nagata
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-12 00:00:00.000000000 Z
+date: 2026-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -59,19 +59,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.1.0
 - !ruby/object:Gem::Dependency
-  name: coveralls
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.8'
 description: A practical mail address parser implemented based on Perl Module Mail::Address.
 email:
 - kizashi1122@gmail.com
@@ -80,9 +94,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".coveralls.yml"
+- ".github/workflows/test.yml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
+- CLAUDE.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -109,14 +124,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Simple Mail Address Parser

data/.travis.yml

@@ -1,3 +0,0 @@
-language: ruby
-rvm:
-- 2.0.0