wwwjdic 13.0.0

data/lib/wwwjdic/utils/raisers.rb

@@ -0,0 +1,67 @@
+#--
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require 'i18n'
+
+module WWWJDic
+
+  # 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 © 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 © 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 the exact +value+.
+      def raiser_array(name = 'error.value', value = nil, array = nil)
+        unless value.nil?
+          raise ArgumentError, I18n.t(name, value: value) unless array.include? value
+        end
+      end
+
+      # 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/wwwjdic/utils/splitter.rb

@@ -0,0 +1,84 @@
+#--
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require 'i18n'
+require 'json'
+
+require_relative '../constants'
+
+module WWWJDic
+  # This class is a simple API to interact with WWWJDic Backboor
+  # Entry/API.
+  # Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+  # Copyright:: Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+  # License:: GNU General Public License version 3
+  class Splitter
+    # Creates a +Splitter+ object.
+    #
+    # Usage:: <tt>new_splitter = Splitter.new translation_content</tt>
+    # Returns:: a +Splitter+ object.
+    def initialize(translation)
+      @translation = translation.force_encoding('UTF-8')
+    end
+
+    def title
+      $1 if /<TITLE>(.*)<\/TITLE>/.match @translation
+    end
+
+    def translation
+      $1.strip if /<pre>(.*)<\/pre>/m.match @translation
+    end
+
+    def message
+      return $1.strip if /<p>(.*)<p>/m.match @translation unless @translation.nil?
+      $1 if /<p>(.*)<pre>/m.match @translation if @translation.nil?
+    end
+
+    def lines
+      result = Array.new
+      translation.each_line do |a_line|
+        stripped_line = a_line.strip
+        result.push stripped_line unless stripped_line.empty?
+      end
+      result unless result.empty?
+    end
+
+    def content
+      result = Array.new
+      lines.each do |a_line|
+        inner = Hash.new
+        if /(.*)\[/m.match a_line
+          inner[:word] = $1.strip
+          inner[:kana] = $1.strip if /\[(.*)\]/m.match a_line
+          inner[:text] = $1.strip if /\] \/(.*)\//m.match a_line
+        else
+          inner[:kana] = $1.strip if /^(.*)(\s)\//m.match a_line
+          inner[:word] = inner[:kana]
+          inner[:text] = $1.strip if /\/(.*)\//m.match a_line
+        end
+        inner[:meanings] = inner[:text].split('/') if inner[:text].include? '/'
+        result.push inner unless inner.empty?
+      end
+
+      result unless result.empty?
+    end
+
+  end
+end

data/lib/wwwjdic/version.rb

@@ -0,0 +1,20 @@
+#--
+# wwwjdic
+# Copyright © 2014, 2015, 2016  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see
+# <http://www.gnu.org/licenses/>.
+#++
+
+module WWWJDic
+  # Current version number for WWWJDic gem.
+  VERSION = '13.0.0'
+end

data/lib/wwwjdic.rb

@@ -0,0 +1,57 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+require 'digest/md5'
+require 'i18n'
+require 'uri'
+
+require_relative 'wwwjdic/application'
+require_relative 'wwwjdic/parser'
+require_relative 'wwwjdic/parsers/dict'
+require_relative 'wwwjdic/parsers/display'
+require_relative 'wwwjdic/parsers/key'
+require_relative 'wwwjdic/parsers/search'
+require_relative 'wwwjdic/parsers/server'
+
+# Author:: {Marco Bresciani}[mailto:marcobresciani_1974@libero.it]
+# Copyright:: Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+# License:: GNU General Public License version 3
+module WWWJDic
+
+  # Creates a new WWWJDic object (from the verb 'to Breen'... :) ).
+  #
+  # Usage::
+  #   - <tt>new_wwwjdic = WWWJDic::breener</tt>
+  # Returns:: a +WWWJDic+ object.
+  def self.breener
+    WWWJDic.new(parser)
+  end
+
+# ------------------------------ here starts the list of private methods
+
+  private
+
+# Provides the parameters' parsers object.
+  def self.parser
+    parsers = {dict: Parsers::Dict.new, display: Parsers::Display.new,
+               key: Parsers::Key.new, search: Parsers::Search.new,
+               server: Parsers::Server.new}
+
+    Parser.new parsers
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,40 @@
+#--
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require 'i18n'
+require 'json'
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'set'
+
+require_relative '../lib/wwwjdic'
+require_relative '../lib/wwwjdic/constants'
+require_relative '../lib/wwwjdic/parsers/dict'
+require_relative '../lib/wwwjdic/parsers/display'
+require_relative '../lib/wwwjdic/parsers/key'
+require_relative '../lib/wwwjdic/parsers/server'
+require_relative '../lib/wwwjdic/utils/downloader'
+
+require_relative 'wwwjdic/test_parsable_duck_type'
+
+module WWWJDic
+  # Example basic URI (profile part) for testing purposes.
+  TEST_REFERENCE_URI = URI_DEFAULT + DICTIONARY_CODES[0] + DISPLAY[:regular]
+end

data/test/test_wwwjdic.rb

@@ -0,0 +1,32 @@
+#--
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require_relative 'test_helper'
+
+describe WWWJDic::WWWJDic do
+  describe 'when created' do
+    subject {WWWJDic::breener}
+
+    it 'must create a wwwjdic object' do
+      subject.wont_be_nil
+      subject.must_be_instance_of WWWJDic::WWWJDic
+    end
+  end
+end

data/test/wwwjdic/locales/de.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+de:
+  test:
+    kotoba: Sprache
+    test: test data

data/test/wwwjdic/locales/en.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+en:
+  test:
+    kotoba: word
+    test: test data

data/test/wwwjdic/locales/es.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+es:
+  test:
+    kotoba: palabra
+    test: test data

data/test/wwwjdic/locales/fr.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+fr:
+  test:
+    kotoba: mot
+    test: test data

data/test/wwwjdic/locales/hu.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+hu:
+  test:
+    kotoba:  hír
+    test: test data

data/test/wwwjdic/locales/it.yml

@@ -0,0 +1,21 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+it:
+    kotoba: parola
+    test: dato di prova

data/test/wwwjdic/locales/ja.yml

@@ -0,0 +1,23 @@
+# wwwjdic
+# Copyright © 2013  新部裕
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  新部裕, Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+ja:
+  test:
+    kotoba: 言葉
+    test: 試験データ

data/test/wwwjdic/locales/nl.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+nl:
+  test:
+    kotoba: taal
+    test: test data

data/test/wwwjdic/locales/ru.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+ru:
+  test:
+    kotoba: слово
+    test: test data

data/test/wwwjdic/locales/sl.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+sl:
+  test:
+    kotoba: beseda
+    test: test data

data/test/wwwjdic/locales/sv.yml

@@ -0,0 +1,22 @@
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+
+sv:
+  test:
+    kotoba: ord
+    test: test data

data/test/wwwjdic/locales/test_locales.rb

@@ -0,0 +1,65 @@
+#--
+# wwwjdic
+# Copyright © 2014, 2015, 2016, 2017, 2018, 2019  Marco Bresciani
+#
+# This file is part of wwwjdic.
+#
+# wwwjdic 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.
+#
+# wwwjdic 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 wwwjdic. If not, see <http://www.gnu.org/licenses/>.
+#++
+
+require_relative '../../test_helper'
+
+describe WWWJDic::WWWJDic do
+  describe 'when using I18N' do
+
+    RELATIVE_PATH = '/../../../lib/wwwjdic/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