glaemscribe 1.0.19 → 1.1.0

data/lib/api/mode.rb

@@ -36,6 +36,8 @@ module Glaemscribe
       
       attr_accessor :supported_charsets
       attr_accessor :default_charset
+      
+      attr_reader   :latest_option_values
          
       def initialize(name)
         @name               = name
@@ -43,6 +45,7 @@ module Glaemscribe
         @warnings           = []
         @supported_charsets = {}
         @options            = {}
+        @last_raw_options   = nil
        
         @pre_processor    = TranscriptionPreProcessor.new(self)
         @processor        = TranscriptionProcessor.new(self)
@@ -59,6 +62,13 @@ module Glaemscribe
       
       def finalize(options={})
               
+        if options == @last_raw_options
+          # Small optimization : don't refinalize if options are the same as before
+          return
+        end      
+              
+        @last_raw_options = options      
+              
         # Hash: option_name => value_name
         trans_options = {}
         
@@ -95,10 +105,12 @@ module Glaemscribe
             }
           end
         }   
+        
+        @latest_option_values = trans_options_converted
            
-        @pre_processor.finalize(trans_options_converted)
-        @post_processor.finalize(trans_options_converted)
-        @processor.finalize(trans_options_converted)
+        @pre_processor.finalize(@latest_option_values)
+        @post_processor.finalize(@latest_option_values)
+        @processor.finalize(@latest_option_values)
         
         self
       end

data/lib/api/mode_parser.rb

@@ -214,11 +214,16 @@ module Glaemscribe
         @mode.version     = doc.root_node.gpath('version').first.args.first
                 
         doc.root_node.gpath("options.option").each{ |option_element|
-          values  = {}
+          values      = {}
+          visibility  = nil
+  
           option_element.gpath("value").each{ |value_element|
             value_name                = value_element.args.first
             values[value_name]        = value_element.args.last.to_i
           }
+          option_element.gpath("visible_when").each{ |visible_element|
+            visibility = visible_element.args.first
+          }
         
           option_name_at          = option_element.args[0]
           option_default_val_at   = option_element.args[1]
@@ -228,7 +233,7 @@ module Glaemscribe
             @mode.errors << Glaeml::Error.new(option_element.line, "Missing option default value.")
           end
             
-          option        = Option.new(option_name_at, option_default_val_at, values)
+          option        = Option.new(@mode, option_name_at, option_default_val_at, values, visibility)
           @mode.options[option.name] = option
         }
         

data/lib/api/option.rb

@@ -24,21 +24,25 @@ module Glaemscribe
   module API
     
     class Option
+      attr_reader   :mode
       attr_reader   :name
       attr_reader   :type
       attr_reader   :default_value_name      
       attr_reader   :values
+
     
       class Type
         ENUM = "ENUM"
         BOOL = "BOOL"
       end
          
-      def initialize(name, default_value_name, values)
+      def initialize(mode, name, default_value_name, values, visibility = nil)
+        @mode               = mode
         @name               = name
         @default_value_name = default_value_name
         @type               = (values.keys.count == 0)?(Type::BOOL):(Type::ENUM)
         @values             = values
+        @visibility         = visibility
       end
       
       def default_value
@@ -59,6 +63,16 @@ module Glaemscribe
         end
       end
       
+      def visible?
+        if_eval = Eval::Parser.new()
+        
+        begin
+          (if_eval.parse(@visibility || "true", @mode.latest_option_values || {}) == true)
+        rescue Eval::IfEvalError => e
+          nil
+        end       
+      end
+      
     end
   end
 end

data/lib/api/post_processor/resolve_virtuals.rb

@@ -37,35 +37,46 @@ module Glaemscribe
         }
       end
       
+      def apply_loop(charset, tokens, new_tokens, reversed, token, idx)
+        if token == '*SPACE'
+          reset_trigger_states(charset)
+          return
+        end
+        
+        # Check if token is a virtual char
+        c = charset[token]
+        return if c.nil? # May happen for empty tokens
+        if c.virtual? && (reversed == c.reversed)
+          # Try to replace
+          last_trigger = @last_triggers[c]
+          if last_trigger != nil
+            new_tokens[idx] = last_trigger.names.first # Take the first name of the non-virtual replacement.
+          end
+        else
+          # Update states of virtual classes
+          charset.virtual_chars.each{|vc|
+            rc                  = vc[token]
+            @last_triggers[vc]  = rc if rc != nil 
+          }
+        end        
+      end
+      
       def apply(tokens,charset)
         
-        reset_trigger_states(charset)
+        # Clone the tokens so that we can perform ligatures AND diacritics without interferences
+        new_tokens = tokens.clone
         
+        # Handle l to r virtuals (diacritics ?)
+        reset_trigger_states(charset)       
         tokens.each_with_index{ |token,idx|
-          
-          if token == '*SPACE'
-            reset_trigger_states(charset)
-            next
-          end
-          
-          # Check if token is a virtual char
-          c = charset[token]
-          next if c.nil? # May happen for empty tokens
-          if c.virtual?
-            # Try to replace
-            last_trigger = @last_triggers[c]
-            if last_trigger != nil
-              tokens[idx] = last_trigger.names.first # Take the first name of the non-virtual replacement.
-            end
-          else
-            # Update states of virtual classes
-            charset.virtual_chars.each{|vc|
-              rc                  = vc[token]
-              @last_triggers[vc]  = rc if rc != nil 
-            }
-          end
+          apply_loop(charset,tokens,new_tokens,false,token,idx)
+        }
+        # Handle r to l virtuals (ligatures ?)
+        reset_trigger_states(charset)       
+        tokens.reverse_each.with_index{ |token,idx|
+          apply_loop(charset,tokens,new_tokens,true,token,tokens.count - 1 - idx)
         }
-        tokens
+        new_tokens
       end
     end
 

data/lib/api/transcription_pre_post_processor.rb

@@ -142,7 +142,8 @@ module Glaemscribe
             when "*LF"
                ret += "\n"
             else
-               ret += out_charset[token].str
+              c = out_charset[token]       
+              ret += (c.nil?)?(UNKNOWN_CHAR_OUTPUT):c.str
           end        
         }
         ret

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glaemscribe
 version: !ruby/object:Gem::Version
-  version: 1.0.19
+  version: 1.1.0
 platform: ruby
 authors:
 - Benjamin 'Talagan' Babut
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-06 00:00:00.000000000 Z
+date: 2017-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: commander
@@ -38,26 +38,30 @@ files:
 - bin/glaemscribe
 - glaemresources/charsets/cirth_ds.cst
 - glaemresources/charsets/sarati_eldamar.cst
-- glaemresources/charsets/tengwar_ds.cst
+- glaemresources/charsets/tengwar_ds_annatar.cst
 - glaemresources/charsets/tengwar_ds_eldamar.cst
+- glaemresources/charsets/tengwar_ds_elfica.cst
+- glaemresources/charsets/tengwar_ds_parmaite.cst
+- glaemresources/charsets/tengwar_ds_sindarin.cst
+- glaemresources/charsets/tengwar_freemono.cst
 - glaemresources/charsets/unicode_gothic.cst
 - glaemresources/charsets/unicode_runes.cst
 - glaemresources/modes/adunaic.glaem
-- glaemresources/modes/blackspeech-annatar.glaem
 - glaemresources/modes/blackspeech.glaem
-- glaemresources/modes/futhark-long-branch.glaem.disabled
-- glaemresources/modes/futhark-short-twig.glaem.disabled
-- glaemresources/modes/futhorc.glaem.disabled
+- glaemresources/modes/english-ipa.glaem
+- glaemresources/modes/french-ipa.glaem
+- glaemresources/modes/futhark-runicus.glaem
+- glaemresources/modes/futhark-younger.glaem
+- glaemresources/modes/futhorc.glaem
 - glaemresources/modes/gothic.glaem
 - glaemresources/modes/khuzdul.glaem
 - glaemresources/modes/mercian.glaem
-- glaemresources/modes/oldnorse-medieval.glaem
 - glaemresources/modes/quenya-sarati.glaem
 - glaemresources/modes/quenya.glaem
 - glaemresources/modes/rlyehian.glaem
 - glaemresources/modes/sindarin-beleriand.glaem
-- glaemresources/modes/sindarin-classical.glaem
 - glaemresources/modes/sindarin-daeron.glaem
+- glaemresources/modes/sindarin.glaem
 - glaemresources/modes/telerin.glaem
 - glaemresources/modes/valarin-sarati.glaem
 - glaemresources/modes/westron.glaem
@@ -91,7 +95,7 @@ files:
 - lib/api/transcription_processor.rb
 - lib/api/transcription_tree_node.rb
 - lib/glaemscribe.rb
-homepage: http://jrrvf.com/~glaemscrafu/english/glaemscribe.html
+homepage: https://jrrvf.com/~glaemscrafu/english/glaemscribe.html
 licenses:
 - AGPL-3.0
 metadata: {}
@@ -111,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.11
 signing_key: 
 specification_version: 4
 summary: Glǽmscribe

data/glaemresources/modes/blackspeech-annatar.glaem

@@ -1,320 +0,0 @@
-\**
-
-Glǽmscribe (also written Glaemscribe) is a software dedicated to
-the transcription of texts between writing systems, and more 
-specifically dedicated to the transcription of J.R.R. Tolkien's 
-invented languages to some of his devised writing systems.
-
-Copyright (C) 2015 Benjamin Babut (Talagan).
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU Affero General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-any later version.
-
-This program 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 Affero General Public License for more details.
-
-You should have received a copy of the GNU Affero General Public License
-along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-**\
-
-\** BlackSpeech ring mode for glaemscribe (FAR FROM BEING COMPLETE!!!) **\
-
-\language "Black Speech"
-\writing  "Tengwar"
-\mode     "Ring Style / Cursive"
-\version  "0.0.1"
-\authors  "Talagan (Benjamin Babut)"
-
-\** TODO : NEEDS PORTING TO VIRTUAL CHARS, BUT NEEDS A NEW CHARSET FOR ANNATAR FOR THAT **\
-
-\charset  tengwar_ds         true
-
-\beg      options
-  \option reverse_numbers true
-  \beg option numbers_base BASE_12
-    \value    BASE_10 10
-    \value    BASE_12 12
-  \end
-\end
-
-\beg      preprocessor
-  \** Work exclusively downcase **\
-  \downcase
-  
-  \** Simplify trema vowels **\
-  \substitute ä a
-  \substitute ë e
-  \substitute ï i
-  \substitute ö o
-  \substitute ü u
-  \substitute ÿ y
-  
-  \** Dis-ambiguate long vowels **\
-  \rxsubstitute "(ā|â|aa)" "á"
-  \rxsubstitute "(ē|ê|ee)" "é"
-  \rxsubstitute "(ī|î|ii)" "í"
-  \rxsubstitute "(ō|ô|oo)" "ó"
-  \rxsubstitute "(ū|û|uu)" "ú"
-  
-  \** Preprocess numbers **\
-  \elvish_numbers "\\eval numbers_base" "\\eval reverse_numbers"
-\end
-  
-\beg processor
-
-  \beg rules litteral
-    {A}                 === a
-    {AA}                === á
-    {E}                 === e
-    {EE}                === é
-    {I}                 === i
-    {II}                === í
-    {O}                 === o
-    {OO}                === ó
-    {U}                 === u
-    {UU}                === ú
-    
-    {AI}                === {A}{I} \** attested **\
-    {AU}                === {A}{U} \** attested **\
-    {OI}                === {O}{I} \** Not quite sure (dushgoi) **\
-    
-    {K}                 === (c,k)
-    
-    \** VOWELS **\
-    {VOWELS}            === {A}               * {E}               * {I}        * {O}                * {U}
-    {LVOWELS}           === {AA}              * {EE}              * {II}       * {OO}               * {UU}  
-    \** Reverse o and u **\
-    {TEHTA_XS}          === A_TEHTA_XS        * E_TEHTA_XS        * I_TEHTA_XS *  U_TEHTA_XS        * O_TEHTA_XS      
-    {TEHTA__S}          === A_TEHTA_S         * E_TEHTA_S         * I_TEHTA_S  *  U_TEHTA_S         * O_TEHTA_S     
-    {TEHTA__L}          === A_TEHTA_L         * E_TEHTA_L         * I_TEHTA_L  *  U_TEHTA_L         * O_TEHTA_L     
-    {TEHTA_XL}          === A_TEHTA_XL        * E_TEHTA_XL        * I_TEHTA_XL *  U_TEHTA_XL        * O_TEHTA_XL          
-    \** Double tehtas **\ 
-    {DTEHTA_XS}         === A_TEHTA_DOUBLE_XS * E_TEHTA_DOUBLE_XS * Y_TEHTA_XS * U_TEHTA_DOUBLE_XS  * O_TEHTA_DOUBLE_XS 
-    {DTEHTA_S}          === A_TEHTA_DOUBLE_S  * E_TEHTA_DOUBLE_S  * Y_TEHTA_S  * U_TEHTA_DOUBLE_S   * O_TEHTA_DOUBLE_S  
-    {DTEHTA_L}          === A_TEHTA_DOUBLE_L  * E_TEHTA_DOUBLE_L  * Y_TEHTA_L  * U_TEHTA_DOUBLE_L   * O_TEHTA_DOUBLE_L   
-    {DTEHTA_XL}         === A_TEHTA_DOUBLE_XL * E_TEHTA_DOUBLE_XL * Y_TEHTA_XL * U_TEHTA_DOUBLE_XL  * O_TEHTA_DOUBLE_XL
-        
-    {DIPHTHONGS}         === {AI}              * {AU}              *  {OI}              
-    {DIPHTHENGS}         === YANTA A_TEHTA_L    * URE A_TEHTA_L     * YANTA U_TEHTA_L   
-     
-    {V_D_KER}           === [ {VOWELS}   * {LVOWELS}    * {DIPHTHONGS} ]
-    {V_D_IMG_XS}        === [ {TEHTA_XS} * {DTEHTA_XS}  * {DIPHTHENGS} ]
-    {V_D_IMG__S}        === [ {TEHTA__S} * {DTEHTA_L}   * {DIPHTHENGS} ]
-    {V_D_IMG__L}        === [ {TEHTA__L} * {DTEHTA_S}   * {DIPHTHENGS} ]
-    {V_D_IMG_XL}        === [ {TEHTA_XL} * {DTEHTA_XL}  * {DIPHTHENGS} ]
-    
-    [{VOWELS}]          -->   TELCO [{TEHTA_XS}]  \** Replace isolated short vowels **\
-    [{LVOWELS}]         -->   ARA   [{TEHTA_XS}]  \**  Replace long vowels **\
-    [{DIPHTHONGS}]       -->  [{DIPHTHENGS}]  \**  Replace diphthongs **\
-    
-    \** CONSONANT RULES (could be factorized with crossrules) **\
-    
-    \** ======================== **\
-         
-    l               --> LAMBE
-    \** If we look closely on the ring inscription, **\
-    \** we can see the offset for the tehta starting point **\
-    \** That's why we use the XL tehtas **\
-    {V_D_KER}  l    --> LAMBE {V_D_IMG_XL}       
-    \** when telco follows, ligature with telco **\
-    l {V_D_KER}  _  --> LAMBE_LIG TELCO {V_D_IMG_XS}
-    
-    \** ======================== **\
-    
-    b                           --> UMBAR
-    {V_D_KER}   b              --> UMBAR {V_D_IMG_XL}
-    \** Attached l to b **\
-    l {V_D_KER}  b             --> LAMBE_LIG UMBAR {V_D_IMG_XL}
-    {V_D_KER}  l {V_D_KER}  b --> LAMBE_LIG {V_D_IMG_XL} UMBAR {V_D_IMG_XL}
-                                                    
-    d                           --> ANDO
-    {V_D_KER}   d              --> ANDO {V_D_IMG_XL}
-    \** Attached l to d **\
-    l {V_D_KER}  d             --> LAMBE_LIG ANDO {V_D_IMG_XL}
-    {V_D_KER}  l {V_D_KER}  d --> LAMBE_LIG {V_D_IMG_XL} ANDO {V_D_IMG_XL}
-                                          
-    f                           --> FORMEN 
-    {V_D_KER}   f              --> FORMEN_EXT {V_D_IMG__S} \** Beware. **\ 
-    \** Attached l to f **\
-    l {V_D_KER}  f             --> LAMBE_LIG FORMEN_EXT {V_D_IMG__S}
-    {V_D_KER}  l {V_D_KER}  f --> LAMBE_LIG {V_D_IMG_XL} FORMEN_EXT {V_D_IMG__S}
-                                           
-    g                           --> UNGWE
-    {V_D_KER}   g              --> UNGWE {V_D_IMG_XL}
-    \** Attached l to g **\
-    l {V_D_KER}  g             --> LAMBE_LIG UNGWE {V_D_IMG_XL}
-    {V_D_KER}  l {V_D_KER}  g --> LAMBE_LIG {V_D_IMG_XL} UNGWE {V_D_IMG_XL}
-     
-    gh                           --> UNGWE_EXT
-    {V_D_KER}   gh              --> UNGWE_EXT {V_D_IMG_XL}
-    \** Attached l to g **\
-    l {V_D_KER}  gh             --> LAMBE_LIG UNGWE_EXT {V_D_IMG_XL}
-    {V_D_KER}  l {V_D_KER}  gh --> LAMBE_LIG {V_D_IMG_XL} UNGWE_EXT {V_D_IMG_XL}
-    
-    h                           --> HYARMEN
-    {V_D_KER}   h              --> HYARMEN {V_D_IMG_XS}
-    \** Attached l to g **\
-    l {V_D_KER}  h             --> LAMBE_LIG HYARMEN {V_D_IMG_XS}
-    {V_D_KER}  l {V_D_KER}  h --> LAMBE_LIG {V_D_IMG_XL} HYARMEN {V_D_IMG_XS}
-          
-    {K}                          --> QUESSE
-    {V_D_KER}   {K}              --> QUESSE {V_D_IMG__L}
-    \** Attached l to g **\
-    l {V_D_KER}  {K}             --> LAMBE_LIG QUESSE {V_D_IMG__L}
-    {V_D_KER}  l {V_D_KER}  {K}  --> LAMBE_LIG {V_D_IMG_XL} QUESSE {V_D_IMG__L}
-          
-    {K}h                           --> HWESTA
-    {V_D_KER}   {K}h              --> HWESTA_EXT {V_D_IMG__L}
-    \** Attached l to g **\
-    l {V_D_KER}  {K}h             --> LAMBE_LIG HWESTA_EXT {V_D_IMG__L}
-    {V_D_KER}  l {V_D_KER}  {K}h --> LAMBE_LIG {V_D_IMG_XL} HWESTA_EXT {V_D_IMG__L}
-          
-    
-    m                               --> MALTA
-    {V_D_KER}  m                   --> MALTA {V_D_IMG_XL}
-    
-    mb                              --> UMBAR TILD_SUP_L
-    {V_D_KER}  mb                  --> UMBAR TILD_SUP_L {V_D_IMG_XL}
-    
-    mp                             --> PARMA TILD_SUP_S
-    {V_D_KER}  mp                  --> PARMA TILD_SUP_S {V_D_IMG__L}
-    
-    n                              --> NUMEN
-    {V_D_KER} n                    --> NUMEN {V_D_IMG_XL} 
-    
-    n{K}                           --> QUESSE TILD_SUP_S
-    {V_D_KER} n{K}                 --> QUESSE TILD_SUP_S {V_D_IMG__S} 
-    
-    p                               --> PARMA
-    
-    r                               --> ROMEN
-    {V_D_KER}  r                   --> ORE {V_D_IMG__L}
-    \** Attached l to r **\        
-    l {V_D_KER}  r                 --> LAMBE_LIG ORE {V_D_IMG__L}
-    {V_D_KER}  l {V_D_KER}  r     --> LAMBE_LIG {V_D_IMG_XL} ORE {V_D_IMG__L}
-    
-    
-    r                               --> ROMEN
-    r_                              --> ORE
-    {V_D_KER} r                    --> ORE {V_D_IMG__S}                                      
-    {V_D_KER} rb                   --> ORE {V_D_IMG__L} UMBAR                                  
-    {V_D_KER} rz                   --> ORE {V_D_IMG__L} ESSE
-    
-    s                               --> SILME
-    
-    
-    \** Beware sh is not the same if not preceeded by vowel **\
-    sh                              --> AHA
-    {A}sh                           --> AHA_EXT A_TEHTA_L           
-    {E}sh                           --> AHA_EXT E_TEHTA_L
-    {I}sh                           --> AHA_EXT I_TEHTA_L
-    {O}sh                           --> AHA_EXT U_TEHTA_S 
-    {U}sh                           --> AHA_EXT O_TEHTA_XS \** The best one still not satisfying... **\
-    {AA}sh                          --> ESSE_NUQUERNA A_TEHTA_DOUBLE_L 
-    {EE}sh                          --> ESSE_NUQUERNA E_TEHTA_DOUBLE_L
-    {II}sh                          --> ESSE_NUQUERNA Y_TEHTA_L
-    {OO}sh                          --> ESSE_NUQUERNA U_TEHTA_DOUBLE_S 
-    {UU}sh                          --> ESSE_NUQUERNA O_TEHTA_DOUBLE_XS
-    
-    t                               --> TINCO
-    {V_D_KER} t                    --> TINCO {V_D_IMG__L}
-    
-    th                              --> SULE
-    y                               --> ANNA
-    
-    z                               --> ESSE
-    
-    \** Need to break thisone too **\
-    {A}z                            --> ESSE_NUQUERNA A_TEHTA_L 
-    {E}z                            --> ESSE_NUQUERNA E_TEHTA_L
-    {I}z                            --> ESSE_NUQUERNA I_TEHTA_L
-    {O}z                            --> ESSE_NUQUERNA U_TEHTA_S 
-    {U}z                            --> ESSE_NUQUERNA O_TEHTA_S
-    {AA}z                           --> ESSE_NUQUERNA A_TEHTA_DOUBLE_L 
-    {EE}z                           --> ESSE_NUQUERNA E_TEHTA_DOUBLE_L
-    {II}z                           --> ESSE_NUQUERNA Y_TEHTA_L
-    {OO}z                           --> ESSE_NUQUERNA U_TEHTA_DOUBLE_S 
-    {UU}z                           --> ESSE_NUQUERNA O_TEHTA_DOUBLE_S
-  \end
-    
-  \beg rules punctuation
-    . --> PUNCT_DDOT
-    .. --> PUNCT_DOT PUNCT_DDOT PUNCT_DOT
-    …  --> PUNCT_TILD
-    ... --> PUNCT_TILD
-    .... --> PUNCT_TILD
-    ..... --> PUNCT_TILD
-    ...... --> PUNCT_TILD
-    ....... --> PUNCT_TILD
-    
-    , --> PUNCT_DOT
-    : --> PUNCT_DOT
-    ; --> PUNCT_DOT
-    ! --> PUNCT_EXCLAM
-    ? --> PUNCT_INTERR
-    · --> PUNCT_DOT
-
-    \** Apostrophe **\
-
-    ' --> {NULL}
-    ’ --> {NULL}
-
-    \** Quotes **\
-
-    “ --> DQUOT_OPEN
-    ” --> DQUOT_CLOSE
-    « --> DQUOT_OPEN 
-    » --> DQUOT_CLOSE 
-
-    - --> {NULL}     
-    – --> PUNCT_TILD  
-    — --> PUNCT_TILD
-
-    [ --> PUNCT_PAREN_L
-    ] --> PUNCT_PAREN_R
-    ( --> PUNCT_PAREN_L
-    ) --> PUNCT_PAREN_R
-    { --> PUNCT_PAREN_L
-    } --> PUNCT_PAREN_R
-    < --> PUNCT_PAREN_L
-    > --> PUNCT_PAREN_R
-
-    \** Not universal between fonts ... **\
-    $ --> BOOKMARK_SIGN
-    ≤ --> RING_MARK_L \** Ring inscription left beautiful stuff **\
-    ≥ --> RING_MARK_R \** Ring inscription right beautiful stuff **\
-
-  \end
-
-  \beg rules numbers
-    0 --> NUM_0
-    1 --> NUM_1
-    2 --> NUM_2
-    3 --> NUM_3
-    4 --> NUM_4
-    5 --> NUM_5
-    6 --> NUM_6
-    7 --> NUM_7
-    8 --> NUM_8
-    9 --> NUM_9
-    A --> NUM_10
-    B --> NUM_11      
-  \end
-
-\end
-
-
-
-
-
-
-
-
-
- 
-