gravaty 8.0.0

data/lib/gravaty/locales/ja.yml

@@ -0,0 +1,35 @@
+# gravaty
+# Copyright © 2013  新部裕
+# Copyright © 2014, 2015, 2016  新部裕, 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/>.
+
+ja:
+  error:
+    invalid: "無効なパラメータ %{value} です(RFC5322 もしくは以後の更新による)。"
+    nil: nil パラメータは許されません。
+    param: "パラメータ %{value} は無効です。"
+    type: "型 %{value} は既知の拡張ではありません。"
+    uri: "URI %{value} が無効です。"
+    value: "値 %{value} が範囲外です。"
+  warn:
+    deprecated: このメソッドはすでに廃止され、推奨されていません。
+  test:
+    test: 試験データ
+  gravatar:
+    errors:
+      -7: secure.gravatar.com を使用
+      -8: 内部エラー
+      -9: 認証エラー
+      -10: メソッド引数がありません
+      -11: メソッド引数が間違っています
+      -100: その他のエラー (テキスト参照)

data/lib/gravaty/parser.rb

@@ -0,0 +1,41 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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'
+
+module Gravaty
+
+  # This class is a simple utility that is used to parse and filter parameters for gravaty.
+  #
+  # Author:: {Marco Bresciani}[mailto:m.bresciani@email.it]
+  # Copyright:: Copyright © 2013, 2014, 2015, 2016  Marco Bresciani
+  # License:: GNU General Public License version 3
+  class Parser
+    attr_reader :parsers
+
+    def initialize(args = {})
+      @parsers = Hash.new
+      ALLOWED_PARAMS.each { |param| parsers[param] = args[param] } unless args.nil?
+    end
+
+    # Provides the duck type for a generic parsing object.
+    def parse(method = nil, value = nil)
+      a_parser = nil
+      a_parser = parsers[method.to_sym] unless method.nil? or parsers.nil?
+      a_parser.parse value unless a_parser.nil?
+    end
+  end
+end

data/lib/gravaty/parsers/avatar.rb

@@ -0,0 +1,33 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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 for avater or profile URI. The only needed parameter is a boolean, with +true+ for avatar.
+    #
+    # Author:: {Marco Bresciani}[mailto:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Avatar
+
+      # The parsable duck type interface to every parser usage.
+      def parse(value = true)
+        value ? 'avatar/' : ''
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/callback.rb

@@ -0,0 +1,34 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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 callback name. The only needed parameter is a valid callback +String+ name.
+    #
+    # Author:: {Marco Bresciani}[mailto:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  Marco Bresciani
+    # License:: GNU General Public License version 3
+    class Callback
+
+      # The parsable duck type interface to every parser usage.
+      def parse(value = nil)
+        return "callback=#{value}" unless value.nil? or value.empty?
+        ''
+      end
+    end
+  end
+end

data/lib/gravaty/parsers/default.rb

@@ -0,0 +1,79 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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?
+
+        an_uri = URI.extract(value.downcase, scheme)
+
+        return false if an_uri.nil?
+        return false if an_uri.empty?
+
+        begin
+          an_uri = URI::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,33 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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,38 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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,38 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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,38 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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,32 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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,38 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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