G General

[.Shuggles.] Config Handler FULL PERM Version 0.61

[.Shuggles.] Config Handler FULL PERM
Details
Features
Contents
Reviews

The purpose of the Config Handler script is to read configuration notecards, one line at
a time or the complete notecard at once using the new synced notecard reading which is
much faster. It provides a link message and listen interface to get and set configuration
options in different sections which is described in detail in the included documentation.
When using the link message interface, all scripts need to be in the same prim or object;
when using the listen interface, they can be in different ones and you need to configure
the channel in the scripts - messages will also be limited to 1024 bytes then (1024 ASCII
characters, UTF-8 characters can use more bytes). You can also have several options on
one line (separated by "|") to increase reading speed:

----------------------------------------------------------------
# Example
General option 1=Value
General option 2=Another value
[Section 1]
Option 1=Value 1
Option 2=Value 2
Option 3=Value 3|Option 4=Value 4|Option 5=Value 5
[Section 2]
List item 1
List item 2
List item 3|List item 4|List item 5
----------------------------------------------------------------

Interface:

- read (from notecard) and write (to local chat) config
- optionally append to existing config or explicitly clear it
- get sections and number of sections
- get and set values by name or index
- add values at the end of a section
- delete values by name, index or value
- remove whole sections
- get names and values in a section as well as their number
- error codes and human-readable error messages

PLEASE NOTE: This version is incompatible with releases before v0.58 because it uses "|"
as separator in messages now instead of ":" and section names are case-insensitive now.
That means that all scripts using the Config Handler need to be adjusted. It also affects
the Slideshow and Tip Jar scripts which were updated in Slideshow v0.58 and Tip Jar v0.63.

The Config Handler script is full perm, so it can be adapted to your needs and
requirements. It's licensed under the BSD license with the addition that it must not be
resold or otherwise given away standalone in parts or as whole. It can be used in your
creations as long as these license conditions are met.
Please use the original scripts, keeping script name and creator intact, and remember to
change script permissions to copy or transfer only before you put your products on sale.

The Config Handler package contains a full perm test script to test some typical usecases
and special cases as well as a simpler example script. Both can be taken as reference on
how to operate the actual Config Handler script. Just rez a prim, drop the Config Handler
and Config Test scripts as well as the Example Config in and touch it. Check the output
manually and verify your usecases as well. If you want to use the listen interface, both
scripts can be in different prims and you need to configure the channel in the scripts.

To update or redeliver a product, wear the included Updater and follow the instructions.
Store policies and info about custom scripting at my MP store and the inworld terminals.

See item in Second Life
  • Easily read config notecards
  • Link message interface
  • Get, set and add config options
  • Get options by name or index
  • Write current config to local chat