CSTNet

Caret-Separated Text (or CST) is a key-value pair format represented by digits or words as keys and the value as text enclosed between carets. (e.g. <key> ^<text>^) Any text which is not enclosed with carets is considered a comment and ignored. Neither strings nor comments may use the caret character. CST.NET is a library for parsing the CST format.

Architecture

CST.NET uses .NET's built-in indexing extension function to accomplish locating of each respective key. As a consequence, it does not matter what you use for keys. I added an additional normalization to the pipeline that converts the document's line endings to the system's, in order to prevent crashes.

Usage

See usage.md.

To-do

• Support for arguments (e.g. %1)

Known issues

• Skipping comments is a little unpredictable.

Requirements

• .NET 6 or later.
• IDEs or Editors
  • Visual Studio Code
  • Visual Studio 2022
• .NET Interactive for notebooks (optional).
  • VSCode Extension or nteract.

License

I license this project under the BSD-3-Clause license - see LICENSE for details.