hiq 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: feffecaed3b4b0269c1959d10fd992c44f9f8b14bc2cdfad0fa07a674a501d86
-  data.tar.gz: c3f59d4b20a0cec63a28a78ff4b388cccd8ad7ba3d9a1d27e45563674064b67f
+  metadata.gz: f0b32efd71e97bff2d927e2011ba99ba7953473f48e4c1006009109526589777
+  data.tar.gz: bc77a0486a393cbe5dfbce67cd7fbed4b34c7ae74e55a48a370d38fff54ef330
 SHA512:
-  metadata.gz: 9e50c6cbcbfd02943102b71cfd7a5cbc31e4cd6f9670c99cfdecf9f4c53dcdcbb21267019d0bd9f584401ee7fa040ca12f1b165d5bae90dbc52d32e17c33f583
-  data.tar.gz: 8f7a7f1d867ad5b5492244ff2f3b9ac398f0ad0b9480827e1a14ca7479d7f0d8aba772a3649c8b2e6df82360bf60190fb5cd455eb8931a74b49ad534e4be689e
+  metadata.gz: e52601838f38c0880481672f69884b46a1be9b55779ee86de15fc277cfea20e1e104ca6985c316488c2b3a8a2d3edcb73cf7abc91a25f65c941703e9eae2774b
+  data.tar.gz: ee1910c58e9c0458d281dcf476bcf90b3a74b0cf7797a94e1b2437f5f4fc35aace762db310dd78448167930867cbba411f00134dead04706eb500d49e4342ad0

data/lib/hiq/domain/line_composer.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Hiq
+  # service responsible for composing a single line of Haiku
+  class LineComposer
+    include Syllabizable
+
+    attr_reader :line, :target_syllable_length
+
+    def self.call(line, target_syllable_length:)
+      new(line, target_syllable_length: target_syllable_length).call
+    end
+
+    def initialize(line, target_syllable_length:)
+      @line = line
+      @target_syllable_length = target_syllable_length
+    end
+
+    def call
+      return line if syllable_gap_size.zero?
+
+      filled_line
+    end
+
+    private
+
+    def syllable_gap_size
+      target_syllable_length - line.map { |word| syllables(word) }.sum
+    end
+
+    def filled_line
+      return [fillers[target_syllable_length].sample] if line.empty?
+
+      [interpolated_fillers[target_syllable_length][syllable_gap_size].gsub('X', line.first)]
+    end
+
+    def interpolated_fillers
+      {
+        5 => {
+          1 => 'the X',
+          2 => 'ghastly X',
+          3 => 'shadow of X',
+          4 => 'X of my joy fade'
+        },
+        7 => {
+          1 => 'a X',
+          2 => 'the pale X',
+          3 => 'X in silence',
+          4 => 'X ends the autumn',
+          5 => 'A spark of X above',
+          6 => 'the sad facade of X torn'
+        }
+      }
+    end
+
+    def fillers
+      {
+        5 => ['empty riverside', 'tears flow in the rain', 'cheerful summer\'s charm'],
+        7 => ['the vain wind of summer blows', 'gentle breeze upon a mountain', 'a frog jumps into a well']
+      }
+    end
+  end
+end

data/lib/hiq/domain/word_checker.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Hiq
+  # service for checking whether haiku can be constructed out of those words
+  class WordChecker
+    include Syllabizable
+
+    attr_reader :words
+
+    def self.validate!(words)
+      new(words).validate!
+    end
+
+    def initialize(words)
+      @words = words
+    end
+
+    def validate!
+      ensure_word_length
+      ensure_word_composition
+    end
+
+    private
+
+    def ensure_word_composition
+      raise WordsCompositionError if syllable_count.select { |count| count > 5 }.size > 1
+      raise WordsCompositionError if syllable_count.select { |count| count == 5 }.size > 3
+    end
+
+    def ensure_word_length
+      raise TooManyWordsError if words.size > 3
+      raise WordTooLongError if syllable_count.any? { |count| count > 7 }
+      raise WordsTooLongError if syllable_count.sum > 22
+    end
+
+    def syllable_count
+      @syllable_count ||= words.map { |word| syllables(word) }
+    end
+  end
+end

data/lib/hiq/exceptions.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Hiq
+  # Basic haiku error
+  class WordLengthError < StandardError
+  end
+
+  # limiting number of words to 3
+  class TooManyWordsError < StandardError
+    def failure_message
+      'The API is currently limited to 3 words'
+    end
+  end
+
+  # Exception for when one of the words is too long to fit into haiku
+  class WordTooLongError < WordLengthError
+    def failure_message
+      'At least one of the words provided exceeds 7 syllables - haiku with such word is impossible'
+    end
+  end
+
+  # Exception for when word composition is unattainable
+  class WordsCompositionError < WordLengthError
+    def failure_message
+      'The words provided cannot meet the haiku composition requirement due to their length'
+    end
+  end
+
+  # Exception for when too many syllables are provided by the user
+  class WordsTooLongError < WordLengthError
+    def failure_message
+      'Words provided exceed 22 syllables - haiku needs to be 22 syllables long'
+    end
+  end
+end

data/lib/hiq/haiku.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Hiq
+  # Haiku generating object
+  class Haiku
+    include Syllabizable
+
+    attr_reader :words
+
+    def initialize(words)
+      @words = words.sort_by(&:size)
+    end
+
+    def to_s
+      haiku_lines.map { |l| l.join(' ') }.join("\n")
+    end
+
+    private
+
+    def haiku_lines
+      WordChecker.validate!(words)
+
+      [5, 7, 5].zip(line_templates).map do |syllabes, line|
+        LineComposer.call(line, target_syllable_length: syllabes)
+      end
+    end
+
+    def line_templates
+      lines = [[], [], []]
+      words.each do |word|
+        lines.detect { |l| l.size == lines.map(&:size).min } << word
+      end
+      lines
+    end
+  end
+end

data/lib/hiq/syllabizable.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Hiq
+  # syllabization functionality
+  module Syllabizable
+    def syllables(word)
+      word.downcase.scan(/[aeiouy]/).size - diphtongs(word) - triphtongs(word) - silent_e_count(word)
+    end
+
+    def diphtongs(word)
+      word.downcase.scan(/(?:[^aeiouy]|^)([aeiouy][aeiouy])(?:[^aeiouy]|$)/).size
+    end
+
+    def triphtongs(word)
+      word.downcase.scan(/(?:[^aeiouy]|^)([aeiouy][aeiouy][aeiouy])([^aeiouy]|$)/).size
+    end
+
+    def silent_e_count(word)
+      return 0 if word == 'the'
+
+      word.downcase[-1] == 'e' ? 1 : 0
+    end
+  end
+end

data/lib/hiq/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Hiq
+  VERSION = '0.2.1'
+end

data/lib/hiq.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require 'version'
-require 'syllabizable'
-require 'exceptions'
-require 'domain/word_checker'
-require 'domain/line_composer'
-require 'haiku'
+require 'hiq/version'
+require 'hiq/syllabizable'
+require 'hiq/exceptions'
+require 'hiq/domain/word_checker'
+require 'hiq/domain/line_composer'
+require 'hiq/haiku'
 
 # haiku main module
 module Hiq

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: hiq
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Jan Taras
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2022-03-20 00:00:00.000000000 Z
@@ -87,11 +87,17 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/hiq.rb
+- lib/hiq/domain/line_composer.rb
+- lib/hiq/domain/word_checker.rb
+- lib/hiq/exceptions.rb
+- lib/hiq/haiku.rb
+- lib/hiq/syllabizable.rb
+- lib/hiq/version.rb
 homepage: https://github.com/TarasJan/hiq
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -107,7 +113,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.3.1
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Hiq - a Haiku generator
 test_files: []