SOURCE CODE: Uize.Parse.Po.NameValue (view docs)

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Parse.Po.NameValue Class
|   /    / /    |
|  /    / /  /| |    ONLINE : http://www.uize.com
| /____/ /__/_| | COPYRIGHT : (c)2014-2016 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://www.uize.com/license.html
*/

/* Module Meta Data
  type: Class
  importance: 1
  codeCompleteness: 100
  docCompleteness: 2
*/

/*?
  Introduction
    The =Uize.Parse.Po.NameValue= module provides methods for parsing and serializing name-value pairs in GNU gettext [[https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html][PO files]].

    *DEVELOPERS:* `Chris van Rensburg`
*/

Uize.module ({
  name:'Uize.Parse.Po.NameValue',
  superclass:'Uize.Parse.Base',
  required:[
    'Uize.Str.Whitespace',
    'Uize.Str.CharClass',
    'Uize.Parse.Po.Name',
    'Uize.Parse.Po.Value'
  ],
  builder:function (_superclass) {
    'use strict';

    var
      /*** Variables for Performance Optimization ***/
        _Uize_Parse_Po_Name = Uize.Parse.Po.Name,
        _Uize_Parse_Po_Value = Uize.Parse.Po.Value,

      /*** General Variables ***/
        _inlineWhitespaceCharClass = Uize.Str.CharClass (Uize.Str.Whitespace.inlineWhitespaceCharCodes)
    ;

    return _superclass.subclass ({
      constructor:function () {
        var m = this;
        m.name = new _Uize_Parse_Po_Name;
        m.value = new _Uize_Parse_Po_Value;
        _superclass.apply (m,arguments);
      },

      instanceMethods:{
        parse:function (_source,_index) {
          function _eatInlineWhitespace () {
            _index =
              (_inlineWhitespaceCharClass.indexOfNonClassChar (_source,_index) + 1 || _sourceLength + 1) - 1
            ;
          }
          var
            m = this,
            _sourceLength = (m.source = _source).length
          ;
          m.index = _index || (_index = 0);
          m.name.parse (_source,_index);
          if (m.name.isValid) {
            _index += m.name.length;
            _eatInlineWhitespace ();
            m.value.parse (_source,_index);
            _index = m.value.isValid ? _index + m.value.length : m.index;
          }
          m.isValid = !!(m.length = _index - m.index);
        },

        serialize:function () {
          return this.isValid ? this.name.serialize () + ' ' + this.value.serialize () : '';
        }
      }
    });
  }
});