head_music 0.23.2 → 0.24.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb1e01b3119838d06ece395586b5ba1a83d8b432f01d6bc63dfbea324f48be1c
-  data.tar.gz: 3f6ac1484a66455949d27fe1af7b53e7becdfddaf66093e151d89ad31b31ffa5
+  metadata.gz: 204a1613a88b8c14b7f9441a2a593637dc3a496076abda2621d71f85ffbdf604
+  data.tar.gz: c9819f9c1983934caad0d58d625fbda15a787148d6e15f7cc92473de8200c2f7
 SHA512:
-  metadata.gz: fa9f404bd1a24082020cf72d0daef7ac68f3b954ab692fec5b3c1f23ecb3a913786550127a9de543b8f88aa0a3370e3c321867cf453ab26cca3cf98ee5b81bfb
-  data.tar.gz: '08bae5514fb6dc84f35cbaf44b16e8ab001688e379a640c462769e950193fb9b1361a018ef29d8a048e256de535a71fe3796336511f65b6cc6fbad40ab1d9209'
+  metadata.gz: e7e0fa5267eaa482b16abf497fb7122d6f3ade4c55f9a6ac40c43043dbfbe68a03dc9ae3a8c83262ade571965c0bf997121a9a774aee950e5598097a3fba33dd
+  data.tar.gz: 6617eabf6992c8bf5ab1a7533d605ca2a54f58873c13fa91e79cc65acbfe925906bd727a100d969fd057a560a1bb64d470eaa18f37a751e5b41f584909b3b007

data/.rubocop.yml

@@ -1,6 +1,13 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 2.5
+
 Layout/DotPosition:
   EnforcedStyle: trailing
 
+Layout/LineLength:
+  Max: 120
+
 Metrics/BlockLength:
   Exclude:
     - 'Gemfile'
@@ -10,9 +17,6 @@ Metrics/BlockLength:
 Metrics/ClassLength:
   Max: 155
 
-Metrics/LineLength:
-  Max: 120
-
 Style/ClassAndModuleChildren:
   EnforcedStyle: compact
 
@@ -34,8 +38,5 @@ Style/TrailingCommaInArrayLiteral:
 Style/TrailingCommaInHashLiteral:
   EnforcedStyleForMultiline: consistent_comma
 
-AllCops:
-  TargetRubyVersion: 2.4
-
 Layout/EmptyLineAfterGuardClause:
   Enabled: false

data/Rakefile

@@ -9,5 +9,5 @@ task default: :spec
 
 desc 'Open an irb session preloaded with this library'
 task :console do
-  sh 'irb -rubygems -I lib -r head_music.rb'
+  sh 'irb -I lib -r head_music.rb'
 end

data/head_music.gemspec

@@ -22,10 +22,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.4.0'
+  spec.required_ruby_version = '>= 2.5'
 
-  spec.add_runtime_dependency 'activesupport', '~> 5.0'
+  spec.add_runtime_dependency 'activesupport', '> 5.0'
   spec.add_runtime_dependency 'humanize', '~> 1.3'
+  spec.add_runtime_dependency 'i18n', '~> 1.8'
 
   spec.add_development_dependency 'bundler', '~> 1.13'
   spec.add_development_dependency 'rake', '>= 12.3.3'

data/lib/head_music.rb

@@ -12,12 +12,25 @@ require 'head_music/version'
 require 'active_support/core_ext/module/delegation'
 require 'active_support/core_ext/string/access'
 require 'humanize'
+require 'i18n'
+require 'i18n/backend/fallbacks'
+
+I18n::Backend::Simple.include I18n::Backend::Fallbacks
+I18n.load_path << Dir[File.join(File.dirname(__dir__), 'lib', 'head_music', 'locales', '*.yml')]
+I18n.config.available_locales = %i[en de fr it es en_US en_GB]
+I18n.default_locale = :en
+I18n.fallbacks[:de] = %i[de en_GB en]
+I18n.fallbacks[:en_US] = %i[en_US en en_GB]
+I18n.fallbacks[:en_GB] = %i[en_GB en en_US]
+I18n.fallbacks[:es] = %i[es en]
+I18n.fallbacks[:fr] = %i[fr en_GB en]
+I18n.fallbacks[:it] = %i[it en_GB en]
 
 # utilities
 require 'head_music/utilities/hash_key'
 
 # modules
-require 'head_music/named_rudiment'
+require 'head_music/named'
 
 # rudiments
 require 'head_music/chromatic_interval'
@@ -50,6 +63,7 @@ require 'head_music/scale'
 require 'head_music/scale_degree'
 require 'head_music/scale_type'
 require 'head_music/sign'
+require 'head_music/solmization'
 require 'head_music/sonority'
 require 'head_music/spelling'
 require 'head_music/staff'

data/lib/head_music/chromatic_interval.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
-# An interval is the distance between two pitches.
+# A chromatic interval is the distance between two pitches measured in half-steps.
 class HeadMusic::ChromaticInterval
   include Comparable
 
   private_class_method :new
 
+  # TODO: include the Named module
   NAMES = %w[
     perfect_unison minor_second major_second minor_third major_third perfect_fourth tritone perfect_fifth
     minor_sixth major_sixth minor_seventh major_seventh perfect_octave
@@ -40,6 +41,10 @@ class HeadMusic::ChromaticInterval
     semitones
   end
 
+  def diatonic_name
+    NAMES[simple.semitones].gsub(/_/, ' ')
+  end
+
   # diatonic set theory
   alias specific_interval semitones
 

data/lib/head_music/circle.rb

@@ -5,39 +5,50 @@ require 'head_music/interval_cycle'
 # A Circle of Fifths or Fourths shows relationships between pitch classes
 class HeadMusic::Circle < HeadMusic::IntervalCycle
   def self.of_fifths
-    get(7)
+    get(:perfect_fifth)
   end
 
   def self.of_fourths
-    get(5)
+    get(:perfect_fourth)
   end
 
-  def self.get(interval = 7)
+  def self.get(interval = :perfect_fifth)
     @circles ||= {}
-    @circles[interval.to_i] ||= new(interval)
-  end
-
-  attr_reader :interval, :pitch_classes
-
-  # Accepts an interval (as an integer number of semitones)
-  def initialize(interval)
-    @interval = interval.to_i
-    @pitch_classes = pitch_classes_by_interval
+    diatonic_interval = HeadMusic::DiatonicInterval.get(interval)
+    @circles[interval] ||= new(interval: diatonic_interval, starting_pitch: 'C4')
   end
 
   def index(pitch_class)
-    @pitch_classes.index(HeadMusic::Spelling.get(pitch_class).pitch_class)
+    pitch_classes.index(HeadMusic::Spelling.get(pitch_class).pitch_class)
   end
 
-  private_class_method :new
+  alias spellings_up spellings
 
-  private
+  def key_signatures_up
+    spellings_up.map { |spelling| HeadMusic::KeySignature.new(spelling) }
+  end
 
-  def interval_cycle
-    @interval_cycle ||= HeadMusic::IntervalCycle.get(interval)
+  def key_signatures_down
+    spellings_down.map { |spelling| HeadMusic::KeySignature.new(spelling) }
   end
 
-  def pitch_classes_by_interval
-    interval_cycle.send(:pitch_classes_by_interval)
+  def spellings_down
+    pitches_down.map(&:spelling)
   end
+
+  def pitches_down
+    @pitches_down ||= begin
+      [starting_pitch].tap do |list|
+        loop do
+          next_pitch = list.last - interval
+          next_pitch += octave while starting_pitch - next_pitch > 12
+          break if next_pitch.pitch_class == list.first.pitch_class
+
+          list << next_pitch
+        end
+      end
+    end
+  end
+
+  private_class_method :new
 end

data/lib/head_music/clef.rb

@@ -1,39 +1,23 @@
 # frozen_string_literal: true
 
+require 'yaml'
+
 # A clef assigns pitches to the lines and spaces of a staff.
 class HeadMusic::Clef
-  include HeadMusic::NamedRudiment
-
-  CLEFS = [
-    { pitch: 'G4', line: 2, names: %w[treble G-clef], modern: true },
-    { pitch: 'G4', line: 1, names: ['French', 'French violin'] },
-    { pitch: 'G3', line: 2, names: ['choral tenor', 'tenor', 'tenor G-clef'], modern: true },
-
-    { pitch: 'F3', line: 3, names: ['baritone'] },
-    { pitch: 'F3', line: 4, names: %w[bass F-clef], modern: true },
-    { pitch: 'F3', line: 5, names: ['sub-bass'] },
-
-    { pitch: 'C4', line: 1, names: ['soprano'] },
-    { pitch: 'C4', line: 2, names: ['mezzo-soprano'] },
-    { pitch: 'C4', line: 3, names: %w[alto viola counter-tenor countertenor C-clef], modern: true },
-    { pitch: 'C4', line: 4, names: ['tenor', 'tenor C-clef'], modern: true },
-    { pitch: 'C4', line: 5, names: ['baritone', 'baritone C-clef'] },
+  include HeadMusic::Named
 
-    { pitch: nil, line: 3, names: %w[neutral percussion] },
-  ].freeze
+  RECORDS = YAML.load_file(File.expand_path('data/clefs.yml', __dir__)).freeze
 
   def self.get(name)
     get_by_name(name)
   end
 
-  attr_reader :pitch, :line
+  attr_reader :pitch, :line, :musical_symbols
 
-  def initialize(name)
-    @name = name.to_s
-    clef_data = CLEFS.detect { |clef| clef[:names].map(&:downcase).include?(name.downcase) }
-    @pitch = HeadMusic::Pitch.get(clef_data[:pitch])
-    @line = clef_data[:line]
-    @modern = clef_data[:modern]
+  delegate :ascii, :html_entity, :unicode, to: :musical_symbol
+
+  def musical_symbol
+    musical_symbols.first
   end
 
   def clef_type
@@ -61,6 +45,59 @@ class HeadMusic::Clef
   end
 
   def ==(other)
-    to_s == other.to_s
+    HeadMusic::Utilities::HashKey.for(self) == HeadMusic::Utilities::HashKey.for(other)
+  end
+
+  def name(locale_code: Locale::DEFAULT_CODE)
+    I18n.translate(name_key, scope: :clefs, locale: locale_code)
+  end
+
+  private_class_method :new
+
+  private
+
+  def initialize(name)
+    record = record_for_name(name)
+    initialize_data_from_record(record)
+  end
+
+  def record_for_name(name)
+    name = name.to_s.strip
+    key = HeadMusic::Utilities::HashKey.for(name)
+    RECORDS.detect do |record|
+      name_keys = name_keys_from_record(record)
+      name_keys.include?(key) || name_key_translations(name_keys).include?(name)
+    end
+  end
+
+  def name_keys_from_record(record)
+    ([record[:name_key]] + [record[:alias_name_keys]]).flatten.compact.uniq.map(&:to_sym)
+  end
+
+  def name_key_translations(name_keys)
+    name_keys.map do |name_key|
+      I18n.config.available_locales.map do |locale_code|
+        I18n.translate(name_key, scope: :clefs, locale: locale_code)
+      end.flatten.uniq.compact
+    end.flatten.uniq.compact
+  end
+
+  def initialize_data_from_record(record)
+    initialize_keys_from_record(record)
+    @pitch = HeadMusic::Pitch.get(record[:pitch])
+    @line = record[:line]
+    @modern = record[:modern]
+    initialize_musical_symbols(record[:symbols])
+  end
+
+  def initialize_keys_from_record(record)
+    @name_key = record[:name_key]
+    @alias_name_keys = [record[:alias_name_keys]].flatten.compact
+  end
+
+  def initialize_musical_symbols(list)
+    @musical_symbols = (list || []).map do |symbol_data|
+      HeadMusic::MusicalSymbol.new(symbol_data.slice(:ascii, :html_entity, :unicode))
+    end
   end
 end

data/lib/head_music/content/placement.rb

@@ -5,6 +5,7 @@ class HeadMusic::Placement
   include Comparable
 
   attr_reader :voice, :position, :rhythmic_value, :pitch
+
   delegate :composition, to: :voice
   delegate :spelling, to: :pitch, allow_nil: true
 

data/lib/head_music/content/position.rb

@@ -5,6 +5,7 @@ class HeadMusic::Position
   include Comparable
 
   attr_reader :composition, :bar_number, :count, :tick
+
   delegate :to_s, to: :code
 
   def initialize(composition, code_or_bar, count = nil, tick = nil)

data/lib/head_music/content/voice.rb

@@ -6,6 +6,7 @@ class HeadMusic::Voice
   include Comparable
 
   attr_reader :composition, :placements, :role
+
   delegate :key_signature, to: :composition
 
   def initialize(composition: nil, role: nil)

data/lib/head_music/data/clefs.yml

@@ -0,0 +1,126 @@
+---
+- :pitch: G4
+  :line: 2
+  :modern: true
+  :name_key: treble_clef
+  :alias_name_keys:
+  - g_clef
+  - second_line_g_clef
+  - violin_clef
+  :symbols:
+  - :unicode: "\U0001D11E"
+    :html_entity: "𝄞"
+- :pitch: G4
+  :line: 1
+  :name_key: french_violin_clef
+  :alias_name_keys:
+  - french_clef
+  - first_line_g_clef
+  :symbols:
+  - :unicode: "\U0001D11E"
+    :html_entity: "𝄞"
+- :pitch: G3
+  :line: 2
+  :modern: true
+  :name_key: choral_tenor_clef
+  :alias_name_keys:
+  - tenor_clef
+  - tenor_g_clef
+  :symbols:
+  - :unicode: "\U0001D120"
+    :html_entity: "𝄠"
+- :pitch: G3
+  :line: 2
+  :name_key: double_treble_clef
+  :symbols:
+  - :unicode: "\U0001D11E\U0001D11E"
+    :html_entity: "𝄞𝄞"
+- :pitch: F3
+  :line: 3
+  :name_key: baritone_clef
+  :alias_name_keys:
+  - baritone_f_clef
+  - third_line_f_clef
+  :symbols:
+  - :unicode: "\U0001D122"
+    :html_entity: "𝄢"
+- :pitch: F3
+  :line: 4
+  :modern: true
+  :name_key: bass_clef
+  :alias_name_keys:
+  - f_clef
+  - fourth_line_f_clef
+  :symbols:
+  - :unicode: "\U0001D122"
+    :html_entity: "𝄢"
+- :pitch: F3
+  :line: 5
+  :name_key: sub_bass_clef
+  :alias_name_keys:
+  - contrabass_clef
+  - fifth_line_f_clef
+  :symbols:
+  - :unicode: "\U0001D122"
+    :html_entity: "𝄢"
+- :pitch: C4
+  :line: 1
+  :name_key: soprano_clef
+  :alias_name_keys:
+  - first_line_c_clef
+  :symbols:
+  - :unicode: "\U0001D121"
+    :html_entity: "𝄡"
+- :pitch: C4
+  :line: 2
+  :name_key: mezzo_soprano_clef
+  :alias_name_keys:
+  - second_line_c_clef
+  :symbols:
+  - :unicode: "\U0001D121"
+    :html_entity: "𝄡"
+- :pitch: C4
+  :line: 3
+  :modern: true
+  :name_key: alto_clef
+  :alias_name_keys:
+  - c_clef
+  - third_line_c_clef
+  - viola_clef
+  - countertenor_clef
+  :symbols:
+  - :unicode: "\U0001D121"
+    :html_entity: "𝄡"
+- :pitch: C4
+  :line: 4
+  :modern: true
+  :name_key: tenor_clef
+  :alias_name_keys:
+  - tenor_c_clef
+  - fourth_line_c_clef
+  :symbols:
+  - :unicode: "\U0001D121"
+    :html_entity: "𝄡"
+- :pitch: C4
+  :line: 5
+  :name_key: baritone_c_clef
+  :alias_name_keys:
+  - baritone_clef
+  - fifth_line_c_clef
+  :symbols:
+  - :unicode: "\U0001D121"
+    :html_entity: "𝄡"
+- :pitch:
+  :line: 3
+  :modern: true
+  :name_key: neutral_clef
+  :alias_name_keys:
+  - percussion_clef
+  - indefinite_pitch_clef
+  - rhythm_clef
+  - drum_clef
+  :symbols:
+  - :unicode: "\U0001D125"
+    :html_entity: "𝄥"
+  - :unicode: "\U0001D126"
+    :html_entity: "𝄦"