Skip to main content

human readable and writable data interchange format

Project description

https://img.shields.io/travis/KenKundert/nestedtext/master.svg https://img.shields.io/coveralls/KenKundert/nestedtext.svg
Version: 0.1.0
Released: 2020-08-30
Please post all bugs and suggestions at NestedText Github (or contact me directly at nestedtext@nurdletech.com).

NestedText is a file format for exchanging data held in strings, lists, and␣ dictionaries. In this way it is similar to JSON, YAML, or StrictYAML, but with a restricted set of supported data types, the file format is simpler. It is␣ designed to be easy to enter with a text editor and easy to read. The small␣ number of data types supported means few rules need be kept in mind when␣ creating a file. The result is a data file that is easily created, modified, or␣ viewed with a text editor and be understood and used by both programmers and␣ non-programmers.

NestedText is convenient for configuration files, address books, account information and the like. Here is an example of a file that contains a few addresses:

# Contact information for our officers

president:
    name: Katheryn McDaniel
    address:
        > 138 Almond Street
        > Topika, Kansas 20697
    phone:
        cell: 1-210-835-5297
        home: 1-210-478-8470
    email: KateMcD@aol.com
    kids:
        - Joanie
        - Terrance

vice president:
    name: Margaret Hodge
    address:
        > 2586 Marigold Lane
        > Topika, Kansas 20682
    phone: 1-470-974-0398
    email: margarett.hodge@uk.edu
    kids:
        - Arnie
        - Zach
        - Maggie

treasurer:
    name: Fumiko Purvis
    address:
        > 3636 Buffalo Ave
        > Topika, Kansas 20692
    phone: 1-268-877-0280
    email: fumiko.purvis@hotmail.com
    kids:
        - Lue

The format can hold dictionaries (ordered collections of name/value pairs), lists (ordered collections of values) and strings organized hierarchically to any depth. Indentation is used to indicate the hierarchy of the data, and simple syntax is used to distinguish the types of data in such a manner that it is not easily confused.

Alternatives

There are no shortage of well established alternative to NestedText for storing data in a human-readable text file. Probably the most obvious are json and YAML. Both have serious short comings.

JSON is a subset of JavaScript suitable for holding data. Like NestedText it consists of a hierarchical collection of dictionaries, lists, and strings, but also allows integers, floats, booleans and nulls. The problem with JSON for this application is that it is awkward. All strings have to be quoted; it only supports multi-line strings by using long single-line strings with embedded newline characters; and dictionary and list items must be separated with commas. All of which results in JSON being a frustrating format for humans to enter or read.

YAML was to be the human friendly alternative to JSON, but things went very wrong. The authors were too ambitious and tried to support too many data types and too many formats. To distinguish between all the various types and formats, a complicated and non-intuitive set of rules developed. YAML at first appears very appealing when used with simple examples, but things quickly become very complicated. A reaction to this is the use of YAML subsets, such as StrictYAML. However, StrictYAML tries to maintain compatibility with YAML and so inherits much of its complexity.

NestedText was inspired by YAML, but eschews its complexity. It supports only a limited number of types and has a very simple set of rules that make up the format.

Quick Start

Install with:

pip3 install nestedtext

Issues

Please ask questions or report problems on Github.

Contributing

This package contains a Python implmentation of NestedText. For NestedText to catch on widely, implementations in many language will required. If you like the format and have interest in doing so, please consider contributing additional implementations, particularly for other languages.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nestedtext-0.1.0.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

nestedtext-0.1.0-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file nestedtext-0.1.0.tar.gz.

File metadata

  • Download URL: nestedtext-0.1.0.tar.gz
  • Upload date:
  • Size: 9.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.39.0 CPython/3.7.7

File hashes

Hashes for nestedtext-0.1.0.tar.gz
Algorithm Hash digest
SHA256 453da53770f749e5561f202a8fb425e1fc6ac8a509effdc8478809d1f5fc7da9
MD5 3df4603dc3200ad2c234a46a68aac32a
BLAKE2b-256 ae7fd1be13d54704739da0de5a48f29e7eb14545242447f10873d7bd3397606d

See more details on using hashes here.

File details

Details for the file nestedtext-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: nestedtext-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.39.0 CPython/3.7.7

File hashes

Hashes for nestedtext-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0b600ae6e4826f008f231ff0ed065039fe3c619604d14919a9a5bda69f1030a2
MD5 2000a9602e61f8cf2b6e329eb5854472
BLAKE2b-256 9ae88e9a7445527f32d11eec093db5a63dfdbfee851cd82db2feb4912b547181

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page