Artifact 34fceeabd9353375575d39d7a32c8a468cee1611613fef94a89eeeef67729cfc:

Wiki page [config] by mario on 2018-07-03 20:49:59.
D 2018-07-03T20:49:59.570
L config
N text/x-markdown
P 57a4d9c434cbb12c654b1e6b736de2547d243374dcae2fe70094a19f97d9ba7a
U mario
W 3474
## # config:  {…}

The `config:` field is a list of entries describing feature- and
application-level settings.

    # config:
    #    { name: linky, type: bool, description: autolink urls }
    #    { name: xy.title, type: str, value: "blog title" }
    #    { name: perm, type: select, select: 3=USER|2=EX|1=SUP|0=KERN }

[PMD](wiki/Plugin+Meta+Data) is about uniform feature lookup. And
plugin handling goes hand in hand with configuration management.
However it requires a structured field to avoid bulky definitions, yet
support enough variation.

Usually `config:` contains multiple indented lines, each being a
<acronym title="JSON, but quotes optional">JSOL</acronym>-dictionary.

  *  The `name:` associates some variable/constant/expression to a setting.

  *  A few common `type:` names often cover 90% of configuration needs:

       * `bool`/`boolean` would render as checkbox often.

       * `str`/`string` for plain textual content.

       * `int`/`integer` verifies the value to be numeric.

       * `select`/`combo` defining a predefined list of defaults.

  * With `select: "aaa┃bbb┃ccc"` being the alternatives attribute for
    combobox options.

  * `description:` holds some elaboration on the key name.

  * And `value:` just sets a default.


## Storage and key name:

Notably this scheme just defines a list of available options. It does **not**
prescribe if they're stored in an `.ini`, `.json`, `xml` or code file, or a database
perhaps.  
Applications might utilize different stores even, and dispatch depending on
the `name:` syntax

  * For example `name: ALL_UPPERCASE` might become a code constant,
  * While `name: sectioned.feature.option` indicated an INI setting,
  * Or `name: "$cfg.plugins[after][]"` even a literal code target.

So names can be somewhat free-form. I'd avoid including the `$` sigil
however, or spaces obviously. Mostly-alphunumeric and dotted keys are
certainly most versatile.


## select: type

The syntax for `select:` is

 * preferrably `"alt|alt|alt"`
 * or with optional title `"1=title|2=alternative|3=…"`.
 * Though implementations may allow to use `,` comma and `|` dash.
 * Or `:` like `=` again.


## Other fields and types

Other per-config attributes migh encompass `category:` and `class:` for
decoration or grouping. Or `arg:` and `param:` for defining commandline args
rather than global application settings.

Other types migt be `text` (lengthy textarea-style strings), `color` (color
picker), `file` (filedialog), `table`/`csv`/`dict` for supporting more complex
setting lists.


## Regex tokenizer

You can get by with a somewhat simple regex extractor for this config
scheme. It's simply finding `{…}` pairs, then splitting key-value pairs,
and handling optional quoting.

  * Which allows syntax alternatives `[:=>]+` for key-value pairs.

  * Same as shortened/aliased type names add some user-friendliness.

Of course a stringent JSON-parser could be used. But that's obstructing
maintanability, and buys little performance-wise. (Plugin or option
management is rarely done during runtime; but confined to some admin
or installer UI.)


## Purpose

Once config options are easily parseable, it quickly pays off to implement
a centralized option/admin UI. And it sometimes can be combined with plugin
configuration itself. Which is why plugin meta data defines this simple
scheme.


Z 03d287afa7746272e553d6a3192d96d4