# TOML Syntax

{% hint style="danger" %}

### THIS DOCUMENTATION IS NO LONGER USED

Go to <https://github.com/asacolips-projects/pbta/wiki/#getting-started> for the most current version of the documentation.
{% endhint %}

[TOML](https://github.com/toml-lang/toml) shares traits with other file formats used for application configuration and data serialization, such as YAML and JSON. TOML and JSON both are simple and use ubiquitous data types, making them easy to code for or parse with machines. TOML and YAML both emphasize human readability features, like comments that make it easier to understand the purpose of a given line. TOML differs in combining these, allowing comments (unlike JSON) but preserving simplicity (unlike YAML).

INI files are frequently compared to TOML for their similarities in syntax and use as configuration files. However, there is no standardized format for INI and they do not gracefully handle more than one or two levels of nesting.

## Example

```
# This is a comment in a TOML document.

# Properties are set with the key on the left and the value on the right.
title = "TOML Example"

# Groups should be wrapped in []
[owner]
  name = "Tom Preston-Werner"
  dob = 1979-05-27T07:32:00-08:00 # First class dates

# Value type examples:
[database]
  # String
  server = "192.168.1.1"
  # Array
  ports = [ 8001, 8001, 8002 ]
  # Number
  connection_max = 5000
  # Boolean
  enabled = true

# Groups can also have nested groups.
[servers]

  # Indentation (tabs and/or spaces) is recommended but not required
  [servers.alpha]
    ip = "10.0.0.1"
    dc = "eqdc10"

  # Nested groups must include the parent name as a prefix.
  [servers.beta]
    ip = "10.0.0.2"
    dc = "eqdc10"

[clients]
  data = [ ["gamma", "delta"], [1, 2] ]

# Line breaks are OK when inside arrays
hosts = [
  "alpha",
  "omega"
]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://asacolips.gitbook.io/pbta-system/configuration-reference-1/toml-syntax.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.