gravaty 8.0.0

data/lib/gravaty/utils/downloader.rb

@@ -0,0 +1,150 @@
+#--
+# 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 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/https' if RUBY_VERSION < '1.9'
+      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 for the original URL, 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,50 @@
+#--
+# 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 '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:m.bresciani@email.it]
+  # Copyright:: Copyright © 2013, 2014, 2015, 2016  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:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  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,102 @@
+#--
+# 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 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

data/lib/gravaty/utils/rpc_connector.rb

@@ -0,0 +1,71 @@
+#--
+# 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 'i18n'
+
+require_relative 'raisers'
+
+module Gravaty
+  module Utils
+
+    # This module contains the XML-RPC connector class.
+    #
+    # Author:: {Marco Bresciani}[mailto:m.bresciani@email.it]
+    # Copyright:: Copyright © 2013, 2014, 2015, 2016  Marco Bresciani
+    # License:: GNU General Public License version 3
+    module RpcConnector
+
+      # Creates a +RpcConnector+ described by the user's email +digest+ and a +password+. Throws a +ArgumentError+ if the supplied +digest+ or the +password+ are not valid.
+      #
+      # Usage::
+      #   - <tt>rpc_connector = RpcConnector.new digest, passowrd</tt>
+      # Params::
+      #   - +digest+, the user's email address MD5 digest.
+      #   - +password+, the user's Gravatar account password.
+      # Returns:: a +RcpConnector+ object for the specified email +digest+.
+      # Raises:: +ArgumentError+, if any of the supplied parameters are not valid.
+      class RpcConnector
+        include Gravaty::Utils::Raisers
+
+        def initialize(digest, password = nil)
+          I18n.load_path = Dir[File.join(File.dirname(__FILE__), '/../locales/', '*.yml')]
+
+          raise ArgumentError, I18n.t('error.nil') if digest.nil? or digest.empty?
+          raise ArgumentError, I18n.t('error.nil') if password.nil? or password.empty?
+
+          @digest = digest
+          @connector = XMLRPC::Client.new(RPC_URI, build_rpc_path, 443, nil, nil, nil, nil, true)
+
+          @params = Hash.new
+          @params[:password] = password
+        end
+
+        def call(a_method = RPC_TEST_METHOD, params = {})
+          raiser_downcase 'error.value', a_method, RPC_METHODS
+
+          @connector.call a_method, @params.merge(params)
+        end
+
+# ------------------------------------------------------------------------------ here starts the list of private methods
+        private
+
+        def build_rpc_path
+          "/xmlrpc?user=#{@digest}"
+        end
+      end
+    end
+  end
+end

data/lib/gravaty/version.rb

@@ -0,0 +1,20 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018  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
+  # Current version number for Gravaty gem.
+  VERSION = '8.0.0'
+end

data/test/gravaty/locales/test_locales.rb

@@ -0,0 +1,61 @@
+#--
+# 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 '../../test_helper'
+
+describe Gravaty::Gravaty do
+  describe 'when using I18N' do
+
+    RELATIVE_PATH = '/../../../lib/gravaty/locales/'
+
+    before do
+      I18n.load_path = Dir[File.join(File.dirname(__FILE__), RELATIVE_PATH, '*.yml')]
+    end
+
+    subject { I18n.available_locales }
+
+    it 'shall return at least one available locale' do
+      subject.wont_be_nil
+      subject.wont_be_empty
+    end
+
+    it 'shall contain at least English and Italiano' do
+      subject.must_include :en
+      subject.must_include :it
+    end
+
+    it 'shall contain a test.test signpost for each available locale' do
+      def load_yaml_file(locale)
+        filename = File::join(File::dirname(__FILE__), RELATIVE_PATH, "#{locale}" + '.yml')
+        filename = File::expand_path filename
+        YAML::load(File::open "#{filename}")
+      end
+
+      subject.each do |locale|
+        I18n.locale = locale
+
+        translation = load_yaml_file(locale)
+        translation["#{locale}"]['test']['test'].wont_be_nil
+
+        a_string = I18n.t('test.test')
+        a_string.wont_be_nil
+        a_string.wont_be_empty
+        a_string.wont_include 'translation missing'
+        a_string.must_equal translation["#{locale}"]['test']['test']
+      end
+    end
+  end
+end