head_music 0.24.0 → 0.24.1

data/lib/head_music/locales/de.yml

@@ -0,0 +1,63 @@
+de:
+  rudiments:
+    clef: Notenschlüssel
+    consonance: Konsonanz
+  clefs:
+    alto_clef: Altschlüssel
+    baritone_c_clef: Baritonschlüssel
+    baritone_clef: Baritonschlüssel
+    baritone_f_clef: Baritonschlüssel
+    bass_clef: Bassschlüssel
+    c_clef: C-Schlüssel
+    choral_tenor_clef: oktavierten Violinschlüssel
+    contrabass_clef: contrabass clef
+    countertenor_clef: countertenor clef
+    double_treble_clef: double treble clef
+    drum_clef: Schlagzeugschlüssel
+    f_clef: F-Schlüssel
+    fifth_line_c_clef: fifth-line C-clef
+    fifth_line_f_clef: fifth-line F-clef
+    first_line_c_clef: Sopranschlüssel
+    first_line_g_clef: first-line G-clef
+    fourth_line_c_clef: fourth-line C-clef
+    fourth_line_f_clef: fourth-line F-clef
+    french_clef: French clef
+    french_violin_clef: French violin clef
+    g_clef: G-Schlüssel
+    indefinite_pitch_clef: indefinite pitch clef
+    mezzo_soprano_clef: Mezzosopranschlüssel
+    neutral_clef: Schlagzeugschlüssel
+    percussion_clef: Schlagzeugschlüssel
+    second_line_c_clef: second-line C-clef
+    second_line_g_clef: second-line G-clef
+    soprano_clef: Sopranschlüssel
+    sub_bass_clef: Subbassschlüssel
+    tenor_c_clef: Tenorschlüssel
+    tenor_clef: Tenorschlüssel
+    tenor_g_clef: tenor G-clef
+    third_line_c_clef: third-line C-clef
+    third_line_f_clef: third-line F-clef
+    treble_clef: Violinschlüssel
+    viola_clef: Bratschenschlüssel
+    violin_clef: Violinschlüssel
+  reference_pitches:
+    chamber_tone: Kammerton
+    choir_tone: Chorton
+  instruments:
+    accordian: Akkordeon
+    alto_flute: Altflöte
+    alto_voice: Alt
+    arpeggione: Arpeggione
+    bagpipe: Dudelsack
+    baritone_voice: Bariton
+    bass_voice: Bass
+    bass_clarinet: clarinette basse
+    fiddle: Geige
+    guitar: Gitarre
+    piano: Piano
+    viola: Bratsche
+    violin: Violine
+  instrument_voices:
+    alto: Alt
+    baritone: Bariton
+    bass: Bass

data/lib/head_music/locales/en.yml

@@ -0,0 +1,198 @@
+en:
+  rudiments:
+    chromatic_interval: chromatic interval
+    circle: circle
+    clef: clef
+    consonance: consonance
+    diatonic_interval: diatonic interval
+    grand_staff: grand staff
+    harmonic_interval: harmonic interval
+    instrument: instrument
+    interval_cycle: interval cycle
+    key_signature: key signature
+    letter_name: letter name
+    melodic_interval: melodic interval
+    meter: meter
+    motion: motion
+    musical_symbol: musical symbol
+    octave: octave
+    pitch: pitch
+    pitch_class: pitch class
+    pitch_class_set: pitch class set
+    pitch_set: pitch set
+    quality: quality
+    reference_pitch: reference pitch
+    rhythm: rhythm
+    rhythmic_unit: rhythmic unit
+    scale: scale
+    scale_degree: scale degree
+    scale_type: scale type
+    sign: sign
+    solmization: solmization
+    sonority: sonority
+    spelling: spelling
+    staff: staff
+    tuning: tuning
+  clefs:
+    alto_clef: alto clef
+    baritone_c_clef: baritone C-clef
+    baritone_clef: baritone clef
+    baritone_f_clef: baritone F-clef
+    bass_clef: bass clef
+    c_clef: C-clef
+    choral_tenor_clef: choral tenor clef
+    contrabass_clef: contrabass clef
+    countertenor_clef: countertenor clef
+    double_treble_clef: double treble clef
+    drum_clef: drum clef
+    f_clef: F-clef
+    fifth_line_c_clef: fifth-line C-clef
+    fifth_line_f_clef: fifth-line F-clef
+    first_line_c_clef: first-line C-clef
+    first_line_g_clef: first-line G-clef
+    fourth_line_c_clef: fourth-line C-clef
+    fourth_line_f_clef: fourth-line F-clef
+    french_clef: French clef
+    french_violin_clef: French violin clef
+    g_clef: G-clef
+    indefinite_pitch_clef: indefinite pitch clef
+    mezzo_soprano_clef: mezzo-soprano clef
+    neutral_clef: neutral clef
+    percussion_clef: percussion clef
+    second_line_c_clef: second-line C-clef
+    second_line_g_clef: second-line G-clef
+    soprano_clef: soprano clef
+    sub_bass_clef: sub-bass clef
+    tenor_c_clef: tenor C-clef
+    tenor_clef: tenor clef
+    tenor_g_clef: tenor G-clef
+    third_line_c_clef: third-line C-clef
+    third_line_f_clef: third-line F-clef
+    treble_clef: treble clef
+    viola_clef: viola clef
+    violin_clef: treble clef
+  reference_pitches:
+    a440: A440
+    baroque: Baroque pitch
+    berlin_philharmonic: Berlin Philharmonic
+    boston_symphony_orchestra: Boston Symphony Orchestra
+    chamber_tone: chamber tone
+    choir: choir tone
+    classical: classical pitch
+    concert: concert pitch
+    continental: continental pitch
+    french: French pitch
+    haydn: Haydn pitch
+    high: high pitch
+    international: international pitch
+    iso_16: ISO 16
+    low: low pitch
+    mozart: Mozart pitch
+    new_philharmonic: new philharmonic pitch
+    new_york_philharmonic: New York Philharmonic
+    old_philharmonic: old philharmonic pitch
+    philosophical: philosophical pitch
+    sauveur: Sauveur pitch
+    scheibler: Scheibler pitch
+    scientific: scientific pitch
+    stuttgart: Stuttgart pitch
+    sydney_symphony_orchestra: Sydney Symphony Orchestra
+    verdi: Verdi tuning
+  instruments:
+    accordian: accordian
+    alto_flute: alto flute
+    alto_voice: alto
+    arpeggione: arpeggione
+    bagpipe: bagpipe
+    baritone_voice: baritone
+    bass_clarinet: bass clarinet
+    bass_drum: bass drum
+    bass_guitar: bass guitar
+    bass_oboe: bass oboe
+    bass_trombone: bass trombone
+    bass_tuba: bass tuba
+    bass_voice: bass
+    bassoon: bassoon
+    castanets: castanets
+    chimes: chimes
+    clarinet: clarinet
+    clash_cymbals: clash cymbals
+    cornet: cornet
+    contrabassoon: contrabassoon
+    contra_bass_clarinet: contra bass clarinet
+    cor_anglais: cor anglais
+    cowbell: cowbell
+    cymbal: cymbal
+    crotales: crotales
+    double_bass: double bass
+    english_horn: English horn
+    euphonium: euphonium
+    flugel_horn: flugel horn
+    flute: flute
+    french_horn: French horn
+    glockenspiel: glockenspiel
+    guitar: guitar
+    harp: harp
+    harpsichord: harpsichord
+    mandolin: mandolin
+    maracas: maracas
+    marimba: marimba
+    metal_block: metal block
+    oboe: oboe
+    piano: piano
+    piccolo: piccolo
+    piccolo_trumpet: piccolo trumpet
+    side_drum: side drum
+    suspended_cymbal: suspended cymbal
+    synthesizer: synthesizer
+    tam_tam: tam-tam
+    tambourine: tambourine
+    temple_blocks: temple blocks
+    tenor_drum: tenor drum
+    tenor_trombone: tenor trombone
+    timpani: timpani
+    triangle: triangle
+    trumpet: trumpet
+    tuba: tuba
+    tubular_bells: tubular bells
+    vibraphone: vibraphone
+    viola: viola
+    violin: violin
+    violincello: cello
+    woodblock: woodblock
+    xylophone: xylophone
+  instrument_abbreviations:
+    accordian:
+    - acc
+    alto_flute:
+    - afl
+    alto_voice:
+    - alt
+    bagpipe:
+    - bag
+    baritone_voice:
+    - bar
+    bass_voice:
+    - bass
+    bass_clarinet:
+    - bcl
+  instrument_classifications:
+    aerophone: aerophone
+    bowed: bowed
+    brass: brass
+    double_reed: double-reed
+    keyboard: keyboard
+    percussion: percussion
+    single_reed: single-reed
+    string: string
+    wind: wind
+    woodwind: woodwind
+  instrument_voices:
+    piccolo: piccolo
+    soprano: soprano
+    alto: alto
+    tenor: tenor
+    baritone: baritone
+    bass: bass
+    contrabass: contrabass
+    octobass: octobass

data/lib/head_music/locales/en_GB.yml

@@ -0,0 +1,3 @@
+en_GB:
+  rudiments:
+    grand_staff: great staff

data/lib/head_music/locales/es.yml

@@ -0,0 +1,53 @@
+es:
+  rudiments:
+    clef: clave
+    consonance: consonancia
+  clefs:
+    alto_clef: clave contralto
+    baritone_c_clef: clave de barítono
+    baritone_clef: clave de barítono
+    baritone_f_clef: clave de fa en tercera
+    bass_clef: clave de bajo
+    c_clef: clave de do
+    choral_tenor_clef: choral tenor clef
+    contrabass_clef: clave de contrabajo
+    countertenor_clef: clave de contratenor
+    double_treble_clef: double clave de sol
+    drum_clef: clave para percusión
+    f_clef: clave de fa
+    fifth_line_c_clef: clave de do en quinta
+    fifth_line_f_clef: clave de fa en quinta
+    first_line_c_clef: clave de do en primera
+    first_line_g_clef: clave de sol en primera
+    fourth_line_c_clef: clave de do en cuarta
+    fourth_line_f_clef: clave de fa en cuarta
+    french_clef: clave de sol en primera
+    french_violin_clef: clave de sol en primera
+    g_clef: clave de sol
+    indefinite_pitch_clef: clave neutral
+    mezzo_soprano_clef: clave de mezzosoprano
+    neutral_clef: clave neutral
+    percussion_clef: clave para percusión
+    second_line_c_clef: clave de do en segunda
+    second_line_g_clef: clave de sol en segunda
+    soprano_clef: clave de soprano
+    sub_bass_clef: clave de fa en quinta
+    tenor_c_clef: clave de do en cuarta
+    tenor_clef: clave de tenor
+    tenor_g_clef: clave de sol en segunda
+    third_line_c_clef: clave de do en tercera
+    third_line_f_clef: clave de fa en tercera
+    treble_clef: clave de sol
+    viola_clef: clave de do
+    violin_clef: clave de sol
+  instruments:
+    accordian: acordeóon
+    alto_flute: flauta alto
+    alto_voice: contralto
+    bagpipe: gaita
+    baritone_voice: baritono
+    bass_voice: bajo
+    guitar: guitarra
+    piano: piano
+    viola: viola
+    violin: violín

data/lib/head_music/locales/fr.yml

@@ -0,0 +1,57 @@
+fr:
+  rudiments:
+    clef: clé
+  clefs:
+    alto_clef: clé alto
+    baritone_c_clef: clé de baryton
+    baritone_clef: clé de baryton
+    baritone_f_clef: clé de fa 3e
+    bass_clef: clé de basse
+    c_clef: clé d'ut
+    choral_tenor_clef: choral tenor clef
+    contrabass_clef: clé de contrebasse
+    countertenor_clef: clé de contre-ténor
+    double_treble_clef: double clé de sol
+    drum_clef: clé de tambour
+    f_clef: clé de fa
+    fifth_line_c_clef: clé d'ut 5e
+    fifth_line_f_clef: clé de fa 5e
+    first_line_c_clef: clé d'ut 1re
+    first_line_g_clef: clé de sol 1re
+    fourth_line_c_clef: clé d'ut 4e
+    fourth_line_f_clef: clé de fa 4e
+    french_clef: clé de sol 1re
+    french_violin_clef: clé de sol 1re
+    g_clef: clé de sol
+    indefinite_pitch_clef: clé à pas indéfini
+    mezzo_soprano_clef: clé de mezzo-soprano
+    neutral_clef: clé neutre
+    percussion_clef: clé de percussion
+    second_line_c_clef: clé d'ut 2e
+    second_line_g_clef: clé de sol 2e
+    soprano_clef: clé de soprano
+    sub_bass_clef: clé de fa 5e
+    tenor_c_clef: clé d'ut 4e
+    tenor_clef: clé de ténor
+    tenor_g_clef: clé de sol 2e
+    third_line_c_clef: clé d'ut 3e
+    third_line_f_clef: clé de fa 3e
+    treble_clef: clé de sol
+    viola_clef: clé d'ut
+    violin_clef: clé de sol
+  instruments:
+    accordian: accordéon
+    alto_flute: flûte alto
+    alto_voice: alto
+    bagpipe: cornemuse
+    baritone_voice: baryton
+    bass_clarinet: clarinette basse
+    bass_voice: basse
+    piano: piano
+    viola: alto
+    violin: violon
+  instrument_voices:
+    alto: alto
+    baritone: baryton
+    bass: basse
+    guitar: guitare

data/lib/head_music/locales/it.yml

@@ -0,0 +1,58 @@
+it:
+  rudiments:
+    clef: chiave
+    consonance: consonanza
+  clefs:
+    alto_clef: chiave di contralto
+    baritone_c_clef: chiave di baritono
+    baritone_clef: chiave di baritono
+    baritone_f_clef: chiave di baritono
+    bass_clef: chiave di basso
+    c_clef: chiave di do
+    choral_tenor_clef: chiave di sol in ottava
+    contrabass_clef: chiave di contrabbasso
+    countertenor_clef: chiave di controtenore
+    double_treble_clef: chiave di sol in ottava
+    drum_clef: chiave di percussione
+    f_clef: chiave di fa
+    fifth_line_c_clef: chiave di do sulla 5ª linea
+    fifth_line_f_clef: chiave di fa sulla 5ª linea
+    first_line_c_clef: chiave di do sulla 1ª linea
+    first_line_g_clef: chiave di sol sulla 1ª linea
+    fourth_line_c_clef: chiave di do sulla 4ª linea
+    fourth_line_f_clef: chiave di fa sulla 4ª linea
+    french_clef: chiave di violino francese
+    french_violin_clef: chiave di violino francese
+    g_clef: chiave di sol
+    indefinite_pitch_clef: chiave neutra
+    mezzo_soprano_clef: chiave di mezzosoprano
+    neutral_clef: chiave neutra
+    percussion_clef: chiave di percussione
+    second_line_c_clef: chiave di do sulla 2ª linea
+    second_line_g_clef: chiave di sol sulla 2ª linea
+    soprano_clef: chiave di soprano
+    sub_bass_clef: chiave di subbasso
+    tenor_c_clef: chiave di tenore
+    tenor_clef: chiave di tenore
+    tenor_g_clef: chiave di sol in ottava
+    third_line_c_clef: chiave di do sulla 3ª linea
+    third_line_f_clef: chiave di fa sulla 3ª linea
+    treble_clef: chiave di violino
+    viola_clef: chiave di viola
+    violin_clef: chiave di violino
+  instruments:
+    accordian: fisarmonica
+    alto_flute: flauto contralto
+    alto_voice: contralto
+    bagpipe: cornamusa
+    baritone_voice: baritono
+    bass_voice: basso
+    guitar: chitarra
+    piccolo: ottavino
+    piano: piano
+    viola: viola
+    violin: violino
+  instrument_voices:
+    alto: contralto
+    baritone: baritono
+    bass: basso

data/lib/head_music/named.rb

@@ -2,44 +2,111 @@
 
 # NameRudiment is a module to be included in classes whose instances may be identified by name.
 module HeadMusic::Named
-  attr_reader :name
   delegate :to_s, to: :name
 
-  def initialize(name)
-    @name = name.to_s
-  end
+  # Locale encapsulates a language and optional region or country.
+  class Locale
+    DEFAULT_CODE = :en_US
 
-  def hash_key
-    HeadMusic::Utilities::HashKey.for(name)
+    attr_reader :language, :region
+
+    def self.default_locale
+      get(DEFAULT_CODE)
+    end
+
+    def self.get(code)
+      @locales ||= {}
+      parts = code.to_s.split(/[_\-]/)
+      language = parts[0].downcase
+      region = parts[1]&.upcase
+      key = [language, region].compact.join('_').to_sym
+      @locales[key] ||= new(language: language, region: region)
+    end
+
+    def initialize(language:, region: nil)
+      @language = language
+      @region = region
+    end
+
+    def code
+      @code ||= [@language, @region].compact.join('_')
+    end
+
+    private_class_method :new
   end
 
-  def self.included(base)
-    base.extend(ClassMethods)
+  # A LocalizedName is the name of a rudiment in a locale.
+  class LocalizedName
+    attr_reader :locale, :name, :abbreviation
+
+    delegate :code, to: :locale, prefix: true
+    delegate :language, :region, to: :locale
+
+    def initialize(name:, locale_code: Locale::DEFAULT_CODE, abbreviation: nil)
+      @name = name
+      @locale = Locale.get(locale_code)
+      @abbreviation = abbreviation
+    end
   end
 
   # Adds .get_by_name to the including class.
   module ClassMethods
     def get_by_name(name)
       name = name.to_s
-      @instances_by_name ||= {}
+      @instances ||= {}
       key = HeadMusic::Utilities::HashKey.for(name)
-      @instances_by_name[key] ||= new(name)
+      @instances[key] ||= new(name)
     end
+  end
 
-    def aliases
-      {}
-    end
+  def self.included(base)
+    base.extend(ClassMethods)
   end
 
-  # An Alias encapsulates an alternative name for a rudiment.
-  class Alias
-    attr_reader :key, :name, :abbreviation, :locale
+  attr_reader :name_key, :alias_name_keys
 
-    def initialize(key:, name:, abbreviation: nil, locale: nil)
-      @key = key
-      @name = name
-      @abbreviation = abbreviation
-      @locale = locale
-    end
+  def name=(name)
+    ensure_localized_name(name: name)
+  end
+
+  def name(locale_code: Locale::DEFAULT_CODE)
+    localized_name(locale_code: locale_code)&.name
+  end
+
+  def localized_name(locale_code: Locale::DEFAULT_CODE)
+    locale = Locale.get(locale_code || Locale::DEFAULT_CODE)
+    localized_name_in_matching_locale(locale) ||
+      localized_name_in_locale_matching_language(locale) ||
+      localized_name_in_default_locale ||
+      localized_names.first
+  end
+
+  def ensure_localized_name(name:, locale_code: Locale::DEFAULT_CODE, abbreviation: nil)
+    @localized_names ||= []
+    @localized_names << LocalizedName.new(name: name, locale_code: locale_code, abbreviation: abbreviation)
+    @localized_names.uniq!
+  end
+
+  # Returns an array of LocalizedName instances that are synonymous with the name.
+  def localized_names
+    @localized_names ||= []
+  end
+
+  private
+
+  def localized_name_in_matching_locale(locale)
+    localized_names.detect { |candidate| candidate.locale_code == locale.code }
+  end
+
+  def localized_name_in_locale_matching_language(locale)
+    localized_names.detect { |candidate| candidate.language == locale.language }
+  end
+
+  def localized_name_in_default_locale
+    localized_names.detect { |name| name.locale_code == Locale::DEFAULT_CODE }
+  end
+
+  def hash_key
+    HeadMusic::Utilities::HashKey.for(name)
   end
 end