gravaty 9.0.0

data/lib/gravaty/parsers/default.rb

@@ -0,0 +1,92 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require 'cgi'
+
+require_relative '../constants'
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # checks the default option. The only needed parameter is a valid
+    # default option.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Default
+
+      # The parsable duck type interface to every parser usage.
+      def parse(value = nil)
+        unless value.nil? or value.empty?
+          unless DEFAULT_OPTIONS.include? value
+            valid = %w(http https).index {|scheme| valid?(value, scheme)}
+
+            raise ArgumentError, I18n.t('error.uri', value: value) if valid.nil?
+          end
+
+          return 'd=' + CGI::escape(value).to_s
+        end
+        ''
+      end
+
+      # ------------------------ here starts the list of private methods
+
+      private
+
+      def valid?(value, scheme)
+        return false if value.nil?
+        return false if value.empty?
+
+        parser = URI::Parser.new
+        an_uri = parser.extract(value.downcase, scheme)
+
+        return false if an_uri.nil?
+        return false if an_uri.empty?
+
+        begin
+          an_uri = parser.parse an_uri[0]
+
+          #See URI validation rules at
+          # http://en.gravatar.com/site/implement/images/#default-image
+
+          #rule 2
+          return false if (an_uri.scheme == 'http') and
+              (an_uri.port != Net::HTTP.http_default_port)
+          return false if (an_uri.scheme == 'https') and
+              (an_uri.port != Net::HTTP.https_default_port)
+
+          #rule 3
+          allowed = IMAGES_FORMATS
+                        .index {|format| an_uri.path.end_with? format}
+          return false if allowed.nil?
+
+          #rule 4
+          return false unless an_uri.query.nil?
+        rescue
+          return false
+        end
+        true
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/force.rb

@@ -0,0 +1,40 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # checks forces the default value. The only needed parameter is a
+    # boolean, with +true+ for forced.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Force
+      # The parsable duck type interface to every parser usage.
+      def parse(value = false)
+        return 'f=y' if value
+        ''
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/format.rb

@@ -0,0 +1,45 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require_relative '../constants'
+require_relative '../utils/raisers'
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # checks the profile type. The only needed parameter is a valid
+    # profile format.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Format
+      include Utils::Raisers
+
+      # The parsable duck type interface to every parser usage.
+      def parse(value = nil)
+        raiser_downcase('error.type', value, PROFILE_FORMATS)
+        value.nil? ? '' : ".#{value.downcase}"
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/pixelsize.rb

@@ -0,0 +1,45 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require_relative '../constants'
+require_relative '../utils/raisers'
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # checks the image size. The only needed parameter is a valid image
+    # size.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Pixelsize
+      include Utils::Raisers
+
+      # The parsable duck type interface to every parser usage.
+      def parse(value = nil)
+        raiser_to_i('error.value', value, ALLOWED_SIZES)
+        value.nil? ? '' : "s=#{value.to_s}"
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/rating.rb

@@ -0,0 +1,45 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require_relative '../constants'
+require_relative '../utils/raisers'
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # checks the rating type. The only needed parameter is a valid
+    # rating type.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Rating
+      include Utils::Raisers
+
+      # the parsable duck type interface to every parser usage.
+      def parse(value = nil)
+        raiser_downcase('error.value', value, RATING_OPTIONS)
+        value.nil? ? '' : "rating=#{value.downcase.to_s}"
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/secure.rb

@@ -0,0 +1,39 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # provides the secure or unsecure URI. The only needed parameter is
+    # a boolean, with +true+ for secure.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Secure
+      # The parsable duck type interface to every parser usage.
+      def parse(value = false)
+        value ? 'https://secure' : 'http://www'
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/type.rb

@@ -0,0 +1,45 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require_relative '../constants'
+require_relative '../utils/raisers'
+
+module Gravaty
+  module Parsers
+
+    # This class is an implementation of the Parsable duck type that
+    # checks the avatar type. The only needed parameter is a valid
+    # avatar format.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Type
+      include Utils::Raisers
+
+      # The parsable duck type interface to every parser usage.
+      def parse(value = nil)
+        raiser_downcase('error.type', value, AVATAR_FORMATS)
+        value.nil? ? '' : ".#{value.downcase}"
+      end
+    end
+  end
+end

data/lib/gravaty/utils/downloader.rb

@@ -0,0 +1,156 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+module Gravaty
+  module Utils
+
+    # This module is a simple wrapper container for Peter R. Marreck's
+    # gist.
+    #
+    # Author:: {Jon Maken}[mailto:jon.forums@gmail.com]
+    # License:: 3-clause BSD
+    # Revision:: 2012-03-25 23:01:19 -0600
+    module Downloader
+
+      require 'net/http'
+      require 'net/ftp'
+      require 'openssl'
+      require 'fileutils'
+      require 'tempfile'
+
+      #!/usr/bin/env ruby
+      #
+      # An HTTP/HTTPS/FTP file downloader library/CLI based upon
+      # MiniPortile's HTTP implementation.
+      #
+      # Author:: Jon Maken
+      # License:: 3-clause BSD
+      # Revision:: 2012-03-25 23:01:19 -0600
+      class Downloader
+
+        VERSION = '0.1.0'
+
+        class << self
+          attr_accessor :logger, :max_ca_verify_depth, :ftp_data_chunk_size
+        end
+
+        @logger = STDOUT.binmode
+        @max_ca_verify_depth = 5
+        @ftp_data_chunk_size = 8192
+
+
+        def self.download_file(url, full_path, count = 3)
+          raise RuntimeError, I18n.t('error.nil') if url.nil?
+          return if File.exist?(full_path)
+
+          http_download(url, full_path, count)
+        end
+
+        private
+
+        def self.message(text)
+          @logger.print text
+          @logger.flush
+        end
+
+        def self.output(text = '')
+          @logger.puts text
+          @logger.flush
+        end
+
+        def self.http_download(url, full_path, count)
+          uri = URI.parse(url)
+
+          begin
+            filename = File.basename(uri.path)
+
+            if ENV['HTTP_PROXY']
+              #protocol,
+              userinfo, proxy_host, proxy_port = URI::split(ENV['HTTP_PROXY'])
+              proxy_user, proxy_pass = userinfo.split(/:/) if userinfo
+              http = Net::HTTP.new(uri.host, uri.port, proxy_host, proxy_port, proxy_user, proxy_pass)
+            else
+              http = Net::HTTP.new(uri.host, uri.port)
+            end
+
+            if uri.scheme.downcase == 'https'
+              http.use_ssl = true
+              if ENV['SSL_CERT_FILE']
+                cert_file = ENV['SSL_CERT_FILE'].dup
+                cert_file.gsub!(File::ALT_SEPARATOR, File::SEPARATOR) if File::ALT_SEPARATOR
+              end
+              if cert_file && File.exists?(cert_file)
+                http.ca_file = cert_file
+                http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+                http.verify_depth = @max_ca_verify_depth
+              else
+                raise <<-EOT
+To download using HTTPS you must first set the SSL_CERT_FILE
+environment variable to the path of a valid CA certificate file.
+A file of bundled public CA certs may be downloaded from:
+
+   http://curl.haxx.se/ca/cacert.pem
+
+                EOT
+              end
+            end
+
+            http.request_get(uri) do |response|
+              case response
+              when Net::HTTPNotFound
+                output '404 - Not Found'
+                return false
+
+              when Net::HTTPClientError
+                output "Error: Client Error: #{response.inspect}"
+                return false
+
+              when Net::HTTPRedirection
+                raise 'Too many redirections, halting.' if count <= 0
+                url = response['location']
+                return http_download(url, full_path, count - 1)
+
+              when Net::HTTPOK
+                temp_file = Tempfile
+                                .new("download-#{filename}")
+                temp_file.binmode
+                temp_file << response.body
+
+                output
+
+                temp_file.close
+                File.unlink full_path if File.exists?(full_path)
+                FileUtils.mkdir_p File.dirname(full_path)
+                FileUtils.mv temp_file.path, full_path, force: true
+              else
+                puts response
+              end
+            end
+
+          rescue Exception => e
+            File.unlink full_path if File.exists?(full_path)
+            output "ERROR: #{e.message}"
+            raise 'Failed to download file'
+          end
+        end
+      end # Downloader
+    end
+  end
+end

data/lib/gravaty/utils/raisers.rb

@@ -0,0 +1,63 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require 'i18n'
+
+module Gravaty
+
+  # This module is a simple collection of useful things and methods that
+  # I prefer to keep as DRYer as possible. Just include it and use the
+  # methods...
+  #
+  # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+  # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+  # 2019  Marco Bresciani
+  # License:: GNU General Public License version 3
+  module Utils
+
+    # This module contains some utility method to raise errors according
+    # to (possibly) common conditions.
+    #
+    # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016, 2017, 2018,
+    # 2019  Marco Bresciani
+    # License:: GNU General Public License version 3
+    module Raisers
+
+      # Raises an +ArgumentError+ according to parameters, unless the
+      # +array+ contains a downcased +value+.
+      def raiser_downcase(name = 'error.value', value = nil, array = nil)
+        unless value.nil?
+          raise ArgumentError,
+                I18n.t(name, value: value) unless array.include? value.downcase
+        end
+      end
+
+      # Raises an +ArgumentError+ according to parameters, unless the
+      # +array+ contains the number of the +value+.
+      def raiser_to_i(name = 'error.value', value = nil, array = nil)
+        unless value.nil?
+          raise ArgumentError,
+                I18n.t(name, value: value) unless array.include? value.to_i
+        end
+      end
+    end
+  end
+end

data/lib/gravaty/utils/rfc5322.rb

@@ -0,0 +1,110 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of gravaty.
+#
+# gravaty is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# gravaty is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gravaty. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+module Gravaty
+  module Utils
+    # This module is a simple wrapper container for Peter R. Marreck's gist.
+    #
+    # Author:: {Peter R. Marreck}[mailto:lumbergh@gmail.com]
+    # Copyright:: Copyleft (©) 2013, Peter R. Marreck
+    # License:: This work is released under the BSD 3-Clause License
+    # http://choosealicense.com/licenses/bsd-3-clause/
+    module Rfc5322
+
+# Author:: {Peter R. Marreck}[mailto:lumbergh@gmail.com]
+# Copyright:: Copyleft (©) 2013, Peter R. Marreck
+# License:: This work is released under the BSD 3-Clause License
+# http://choosealicense.com/licenses/bsd-3-clause/
+
+# RFC 5322 Email Validation Regex in Ruby
+
+# This work is released under the BSD 3-Clause License
+# http://choosealicense.com/licenses/bsd-3-clause/
+# Copyleft (©) 2013, Peter R. Marreck
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#   Redistributions of source code must retain the above copyright
+#   notice, this list of conditions and the following disclaimer.
+#
+#   Redistributions in binary form must reproduce the above copyright
+#   notice, this list of conditions and the following disclaimer in the
+#   documentation and/or other materials provided with the distribution.
+#
+#   Neither the name of the {organization} nor the names of its
+#   contributors may be used to endorse or promote products derived from
+#   this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+      EMAIL = /
+    (?<addr_spec> (?> \g<local_part> @ \g<domain> ) ){0}
+    (?<local_part> (?> \g<dot_atom> | \g<quoted_string> | \g<obs_local_part> ) ){0}
+    (?<domain> (?> \g<dot_atom> | \g<domain_literal> | \g<obs_domain> ) ){0}
+    (?<domain_literal> (?> \g<CFWS>? \[ (?: \g<FWS>? \g<dtext> )* \g<FWS>? \] \g<CFWS>? ) ){0}
+    (?<dtext> (?> [\x21-\x5a] | [\x5e-\x7e] | \g<obs_dtext> ) ){0}
+    (?<quoted_pair> (?> \\ (?: \g<VCHAR> | \g<WSP> ) | \g<obs_qp> ) ){0}
+    (?<dot_atom> (?> \g<CFWS>? \g<dot_atom_text> \g<CFWS>? ) ){0}
+    (?<dot_atom_text> (?> \g<atext> (?: \. \g<atext> )* ) ){0}
+    (?<atext> (?> [a-zA-Z0-9!\#\$%&'*\+\/\=\?\^_`{\|}~\-]+ ) ){0}
+    (?<atom> (?> \g<CFWS>? \g<atext> \g<CFWS>? ) ){0}
+    (?<word> (?> \g<atom> | \g<quoted_string> ) ){0}
+    (?<quoted_string> (?> \g<CFWS>? " (?: \g<FWS>? \g<qcontent> )* \g<FWS>? " \g<CFWS>? ) ){0}
+    (?<qcontent> (?> \g<qtext> | \g<quoted_pair> ) ){0}
+    (?<qtext> (?> \x21 | [\x23-\x5b] | [\x5d-\x7e] | \g<obs_qtext> ) ){0}
+
+    # comments and whitespace
+    (?<FWS> (?> (?: \g<WSP>* \r\n )? \g<WSP>+ | \g<obs_FWS> ) ){0}
+    (?<CFWS> (?> (?: \g<FWS>? \g<comment> )+ \g<FWS>? | \g<FWS> ) ){0}
+    (?<comment> (?> \( (?: \g<FWS>? \g<ccontent> )* \g<FWS>? \) ) ){0}
+    (?<ccontent> (?>\g<ctext> | \g<quoted_pair> | \g<comment> ) ){0}
+    (?<ctext> (?> [\x21-\x27] | [\x2a-\x5b] | [\x5d-\x7e] | \g<obs_ctext> ) ){0}
+
+    # obsolete tokens
+    (?<obs_domain> (?> \g<atom> (?: \. \g<atom> )* ) ){0}
+    (?<obs_local_part> (?> \g<word> (?: \. \g<word> )* ) ){0}
+    (?<obs_dtext> (?> \g<obs_NO_WS_CTL> | \g<quoted_pair> ) ){0}
+    (?<obs_qp> (?> \\ (?: \x00 | \g<obs_NO_WS_CTL> | \n | \r ) ) ){0}
+    (?<obs_FWS> (?> \g<WSP>+ (?: \r\n \g<WSP>+ )* ) ){0}
+    (?<obs_ctext> (?> \g<obs_NO_WS_CTL> ) ){0}
+    (?<obs_qtext> (?> \g<obs_NO_WS_CTL> ) ){0}
+    (?<obs_NO_WS_CTL> (?> [\x01-\x08] | \x0b | \x0c | [\x0e-\x1f] | \x7f ) ){0}
+
+    # character class definitions
+    (?<VCHAR> (?> [\x21-\x7E] ) ){0}
+    (?<WSP> [ \t] ){0}
+  \g<addr_spec>
+/uix
+    end
+  end
+end