view release on metacpan or  search on metacpan

t/config/30-alt_symbol_control.cfg  view on Meta::CPAN

# ==========================================================================
#
# Test Program         : t/30-alt_symbols_cfg.t
#
# This File            : t/config/30-alt_symbol_control.cfg
#
# Template Config File : t/config/10-simple.cfg
#
# ==========================================================================
# The test program genrerates thousands of test cases via this config file.
# And at this point it should be fairly rare to have to update it to
# support changes made to this config file.
# ==========================================================================
#
# This config file controls which config files are compared to a template to
# see if various combinations of "Read Options" will load and result in an
# equivalant config file.  This template has been 100% validated by another
# test case and so it provides a good basis for easy comparisons.
#
# It's an equivalant config file if once loaded the list of tags and their
# values remain the same.  If this is true, all the test cases will pass.  If
# it isn't true, one or more test cases will fail and I will know that either
# there is an issue with the config file or I've uncovered another bug in my
# module to fix.
#
# In any case, I will only release this module when all test cases pass.  Only
# during development when I add a new test config file should any test cases
# ever fail.
#
# ==========================================================================
#
# USAGE:  There is one section per config file.  (See POD for what a section is)
#         Each section defines what "Read Options" to use when loading that
#         config file into memory.
#
#         Each config file must use the ".cfg" extension to be analysed.
#         Otherwise that section will be ignored!
#
#         Spaces are allowed in the file name, but they must all reside in
#         the "t/config" directory.
#
# Special case option:
#         There are some special tags that ARE NOT a "Read Option".  These tags
#         all begin 'section_test_'.
#
#         When such tag(s) appear, it's an instruction to compare just that
#         one section of the config file to the template.  Everything else
#         outside that section is ignored.
#
#         So if you only have one section to compare, use "section_test_01".
#         If you have multiple sections to compare use "section_test_01",
#         "section_test_02", etc.
#
#         So say section_test_01 = "abc", then it looks up tag "abc" in the
#         referenced config file for the name of the section to use.  Done like
#         this since part of the tests were to use long messy section names
#         and this avoided tests failing due to typos.
#
#         Please note that sections of the same name are merged together and
#         I want to be able to validate that muliple sections map correctly.
#         
# ==========================================================================
#
# NOTE:   The template file does not use sections!  So when compared to a
#         config file with sections, it only compares the current section in
#         the target config file.  All other sections will be ignored.
#
#         If you don't use one of the special tags, it will only compare against
#         the default main section.
#
# ==========================================================================
#
# Please note that the test program does 3 tests per section:
#    1)   After the initial load ...
#    2)   After the 1st forced refresh ...
#    3)   After the 2nd forced refresh ...
#
# ==========================================================================
# Keep the sections in this config file sorted.  This is the order that
# the test program will process things.
# ==========================================================================


# Tells how many config files the test program is expecting to process.
number_test_files = 11


# ---------------------------------------------------------------------
# Test against itself ...

[ 10-simple.cfg ]
croak          = 2        # Call die if it doesn't parse correctly.

# ---------------------------------------------------------------------

[ 30-alt_symbols_01.cfg ]
assign         = ==
comment        = :
variable_left  = '$['     # $[..] for variable substitution
variable_right = ']'
quote_left     = '^'      # ^..^  for balanced quotes
quote_right    = '^'
croak          = 2        # Call die if it doesn't parse correctly.

# ---------------------------------------------------------------------

[ 30-alt_symbols_02.cfg ]
assign         = ==
comment        = =
variable_left  = '%'      # %..% for variable substitution
variable_right = '%'
quote_left     = '<'      # <..> for balanced quotes
quote_right    = '>'
croak          = 2

# ---------------------------------------------------------------------

[ 30-alt_symbols_03.cfg ]
assign         = :=
comment        = ?