Newer
Older
tconfpy / WHATSNEW.txt
@tundra tundra on 19 Jan 2005 3 KB Formatting cleanup.
BUG FIXES

- There was a problem properly identifying templates if they were
  named using fully qualified names that included one or more
  namespaces. Fixed.

CHANGES


- More and better validation is done of parameters passed to
  the parsing API:

    In addition to the initial symbol table, the passed template table
    is also checked.

    The initial value for each passed symbol is checked for valid type
    in both the symbol table and the template table passed to the API.

    Template names are checked to make sure they do not contain
    namespace separators.  Templates must be named canonically.  This
    was always a requirement, but it was never checked or documented.

- The program changes described below have made the 'ParseConfig'
  API incompatible with previous versions of 'tconfpy'.  The version
  number has been branched to 2.x to reflect this fact.  Existing
  programs that use 'tconfpy' will have to be modified to use
  this new release.  

- Symbol Tables and Templates are now first-class objects in their own
  right (classes 'SymbolTable' and 'Template' respectively).  This
  means API will not be compatible with programs built using previous
  versions of 'tconfpy'.  You must now pass/receive objects of the
  appropriate type rather than just dictionaries as was previously the
  case.

- The 'RetObj' object has been removed.  Objects of type 'SymbolTable'
  are now returned.

- There is significant internal code restructuring to encasulate
  parse-related data structures into the 'SymbolTable' object.  This
  eliminated most of the global variables.


NEW FEATURES

- Added the 'CallingProgram' API keyword parameter.  This allows the
  calling program to change the program name embedded in every message
  produced during the parse.

- It is now possible to parse a configuration that is stored in-memory
  as a list of text lines.  The 'ParseConfig' API "autodetects" whether
  it is parsing a file or an in-memory list by  examining the type of
  the first (mandatory) parameter passed to it.  If it is a string,
  the program assumes it to be a file name.  If it is a list, the
  program assumes the list contains configuration statements.  If it
  is of any other type, the program declares an error.

- Added the ability to test the *state* of boolean variables in the
  existential conditionials (.ifall/any/none).  Previous versions of
  'tconfpy' could only do this with an explict test like:

   .if BooleanVar == True

  It is now additionally possible to do logical testing like this:

   .ifall [BooleanVar1] [BooleanVar2] ...

  Previously, this would have amounted to '.ifall True False ...'
  which likely would fail since the variables 'True' and 'False'
  would not be defined.

  As of this release, the semantics in the specific instance of
  boolean dereferences during (any of) the existential conditional
  tests have changed.  In this case the logical *state* of the
  variables being tested is returned.  This is believed to be clearer
  than doing explicit equality tests on booleans (though that ability
  is still supported).

  Note that the following construct continues to work as before:

    .ifall BooleanVar1 BooleanVar2 ...

  This tests to see if the variables actually *exist*.


WHATSNEW For 'tconfpy' 1.185    (Sun May  2 03:07:05 CDT 2004)
----------------------------------------------------------------------

BUG FIXES

- The content of literal blocks found within False conditional
  blocks was being reported as a syntax error.  This was 
  benign, but annoying.  Now all text within literal blocks is
  not syntax checked, whether or not the enclosing block is True.


WHATSNEW For 'tconfpy' 1.184    (Tue Apr 27 18:54:11 CDT 2004)
----------------------------------------------------------------------

Added support for Variable Templates.
Added the 'ReturnPredefs' API option.


WHATSNEW For 'tconfpy' 1.181    (Sat Apr 24 15:49:13 CDT 2004)
----------------------------------------------------------------------

First public release of the program.