Knowledge (XXG)

TOML

Source 📝

791: 157: 27: 627:
YAML is both universally used, and universally reviled. It has a lot of problems, but it also is so useful in solving specific tasks that it's hard to replace. Some new kids on the block (such as TOML) have successfully taken over a portion of its market share, but it remains in force in places where
527: 1030: 818: 184:. It is intended to be easy to read and write due to obvious semantics which aim to be "minimal", and it is designed to map unambiguously to a 1054: 472: 934: 589: 615: 1049: 886: 836: 707: 736: 365: 1009: 377: 222:
Its specification includes a list of supported data types: string, integer, float, boolean, datetime, array, and table.
811: 371: 185: 100: 517: 1059: 677: 394: 219:, but it includes a formal specification, whereas the INI file format suffers from many competing variants. 849: 804: 924: 351: 556: 864: 196:. TOML is used in a number of software projects and is implemented in many programming languages. 767: 874: 648: 548: 464: 416: 189: 181: 69: 34: 355: 993: 133: 844: 581: 359: 790: 156: 611: 968: 869: 494: 1043: 998: 988: 881: 827: 699: 983: 978: 941: 916: 756: 193: 177: 728: 1014: 347:
TOML is used in a variety of settings (some related to its creator), such as:
46: 216: 796: 854: 26: 1003: 961: 951: 946: 522: 669: 929: 891: 1019: 973: 956: 906: 859: 440: 406:
In TOML, the syntax determines the data types ("syntax typing").
800: 400:
TOML's hierarchies can be difficult to infer from syntax alone.
301:# Indentation (tabs and/or spaces) is allowed, but not required 901: 552: 439:, but this has never been officially registered with the 215:(for comments). TOML's syntax somewhat resembles that of 640: 915: 835: 784: 149: 144: 131: 123: 99: 81: 62: 45: 33: 389:TOML has been criticized on a number of points: 812: 729:"10. Project.toml and Manifest.toml · Pkg.jl" 403:Overcomplication: TOML has too many features. 8: 19: 435:There is a media type proposal for TOML as 819: 805: 797: 789: 155: 628:those alternatives show their weaknesses. 518:"Initial commit · toml-lang/toml@84db252" 277:# Line breaks are okay when inside arrays 1031:Comparison of data-serialization formats 456: 428: 641:"TOML: Tom's Obvious Minimal Language" 582:"The Manifest Format - The Cargo Book" 576: 574: 18: 680:from the original on 15 February 2017 559:from the original on January 29, 2024 551:; Gedam, Pradyun (January 11, 2021). 7: 417:Configuration file § Comparison 380:project setting and package manifest 204:TOML's syntax primarily consists of 516:Preston-Werner, Tom (2013-02-24). 14: 612:"My wish-list for the next YAML" 25: 739:from the original on 2023-07-08 710:from the original on 2024-06-11 651:from the original on 2022-08-08 618:from the original on 2024-03-09 592:from the original on 2019-08-26 530:from the original on 2024-06-15 475:from the original on 2017-10-18 166:Tom's Obvious, Minimal Language 1: 1055:Lightweight markup languages 700:"tomllib — Parse TOML files" 610:DeVault, Drew (2021-07-28). 397:and is syntactically noisy. 393:TOML is verbose; it is not 1076: 232:# This is a TOML document. 1028: 241:"ImpalaPay Co." 174:Tom's Own Markup Language 24: 16:Configuration file format 757:What is wrong with TOML? 229: 188:. Originally created by 47:Internet media type 768:An INI critique of TOML 471:. updated. 2024-06-07. 250:"192.168.1.1" 192:, its specification is 553:"TOML: English v1.0.0" 352:Static site generators 87:; 11 years ago 1050:Computer file formats 733:pkgdocs.julialang.org 110:; 3 years ago 85:23 February 2013 704:Python documentation 368:programming language 328:"10.0.0.2" 310:"10.0.0.1" 549:Preston-Werner, Tom 182:configuration files 21: 337:"eqdc10" 319:"eqdc10" 190:Tom Preston-Werner 70:Tom Preston-Werner 35:Filename extension 1037: 1036: 586:doc.rust-lang.org 497:. 12 January 2021 295:"omega" 289:"alpha" 163: 162: 63:Developed by 1067: 1060:Markup languages 994:Protocol Buffers 821: 814: 807: 798: 793: 788: 787: 785:Official website 770: 765: 759: 754: 748: 747: 745: 744: 725: 719: 718: 716: 715: 696: 690: 689: 687: 685: 670:"toml-lang/toml" 666: 660: 659: 657: 656: 637: 631: 630: 624: 623: 607: 601: 600: 598: 597: 578: 569: 568: 566: 564: 545: 539: 538: 536: 535: 513: 507: 506: 504: 502: 491: 485: 484: 482: 480: 461: 444: 438: 437:application/toml 433: 374:package manifest 338: 335: 332: 329: 326: 323: 320: 317: 314: 311: 308: 305: 302: 299: 296: 293: 290: 287: 284: 281: 278: 275: 272: 269: 266: 263: 260: 257: 254: 251: 248: 245: 242: 239: 236: 233: 214: 210: 207: 159: 154: 151: 137: 127:Data interchange 118: 116: 111: 95: 93: 88: 53: 52:application/toml 29: 22: 1075: 1074: 1070: 1069: 1068: 1066: 1065: 1064: 1040: 1039: 1038: 1033: 1024: 911: 831: 825: 783: 782: 779: 774: 773: 766: 762: 755: 751: 742: 740: 727: 726: 722: 713: 711: 698: 697: 693: 683: 681: 676:. 23 May 2022. 668: 667: 663: 654: 652: 639: 638: 634: 621: 619: 609: 608: 604: 595: 593: 580: 579: 572: 562: 560: 547: 546: 542: 533: 531: 515: 514: 510: 500: 498: 495:"Release 1.0.0" 493: 492: 488: 478: 476: 463: 462: 458: 453: 448: 447: 436: 434: 430: 425: 413: 387: 345: 340: 339: 336: 333: 330: 327: 324: 321: 318: 315: 312: 309: 306: 303: 300: 297: 294: 291: 288: 285: 282: 279: 276: 273: 270: 267: 264: 261: 258: 255: 252: 249: 246: 243: 240: 237: 234: 231: 228: 212: 209: 205: 202: 148: 132: 119: 115:12 January 2021 114: 112: 109: 108:12 January 2021 107: 91: 89: 86: 82:Initial release 77: 51: 41: 17: 12: 11: 5: 1073: 1071: 1063: 1062: 1057: 1052: 1042: 1041: 1035: 1034: 1029: 1026: 1025: 1023: 1022: 1017: 1012: 1007: 1001: 996: 991: 986: 981: 976: 971: 966: 965: 964: 954: 949: 944: 939: 938: 937: 927: 921: 919: 913: 912: 910: 909: 904: 899: 894: 889: 884: 879: 878: 877: 872: 867: 865:Web Encryption 857: 852: 847: 841: 839: 837:Human readable 833: 832: 826: 824: 823: 816: 809: 801: 795: 794: 778: 777:External links 775: 772: 771: 760: 749: 720: 691: 661: 632: 602: 570: 540: 508: 486: 455: 454: 452: 449: 446: 445: 427: 426: 424: 421: 420: 419: 412: 409: 408: 407: 404: 401: 398: 386: 383: 382: 381: 375: 369: 363: 344: 341: 259:connection_max 230: 227: 224: 201: 198: 161: 160: 146: 142: 141: 138: 129: 128: 125: 124:Type of format 121: 120: 105: 103: 101:Latest release 97: 96: 83: 79: 78: 76: 75: 72: 66: 64: 60: 59: 56:Not registered 49: 43: 42: 39: 37: 31: 30: 15: 13: 10: 9: 6: 4: 3: 2: 1072: 1061: 1058: 1056: 1053: 1051: 1048: 1047: 1045: 1032: 1027: 1021: 1018: 1016: 1013: 1011: 1008: 1005: 1002: 1000: 997: 995: 992: 990: 989:Property list 987: 985: 982: 980: 977: 975: 972: 970: 967: 963: 960: 959: 958: 955: 953: 950: 948: 945: 943: 940: 936: 933: 932: 931: 928: 926: 923: 922: 920: 918: 914: 908: 905: 903: 900: 898: 895: 893: 890: 888: 885: 883: 882:Property list 880: 876: 875:Web Signature 873: 871: 868: 866: 863: 862: 861: 858: 856: 853: 851: 848: 846: 843: 842: 840: 838: 834: 829: 828:Data exchange 822: 817: 815: 810: 808: 803: 802: 799: 792: 786: 781: 780: 776: 769: 764: 761: 758: 753: 750: 738: 734: 730: 724: 721: 709: 705: 701: 695: 692: 679: 675: 671: 665: 662: 650: 646: 642: 636: 633: 629: 617: 613: 606: 603: 591: 587: 583: 577: 575: 571: 558: 554: 550: 544: 541: 529: 525: 524: 519: 512: 509: 496: 490: 487: 474: 470: 466: 465:"Media Types" 460: 457: 450: 442: 432: 429: 422: 418: 415: 414: 410: 405: 402: 399: 396: 392: 391: 390: 384: 379: 376: 373: 370: 367: 364: 361: 357: 353: 350: 349: 348: 342: 225: 223: 220: 218: 199: 197: 195: 191: 187: 183: 179: 175: 172:, originally 171: 167: 158: 153: 147: 143: 139: 135: 130: 126: 122: 104: 102: 98: 84: 80: 73: 71: 68: 67: 65: 61: 57: 50: 48: 44: 38: 36: 32: 28: 23: 896: 763: 752: 741:. Retrieved 732: 723: 712:. Retrieved 703: 694: 682:. Retrieved 673: 664: 653:. Retrieved 644: 635: 626: 620:. Retrieved 605: 594:. Retrieved 585: 561:. Retrieved 543: 532:. Retrieved 521: 511: 499:. Retrieved 489: 477:. Retrieved 468: 459: 431: 388: 346: 221: 203: 173: 169: 165: 164: 55: 984:MessagePack 979:FlatBuffers 969:Cap'n Proto 684:16 December 563:January 27, 206:key = value 194:open source 178:file format 134:Open format 1044:Categories 743:2023-07-08 714:2023-07-08 655:2022-08-08 622:2021-07-28 596:2023-07-08 534:2024-06-15 501:17 January 451:References 217:.INI files 186:dictionary 92:2013-02-23 870:Web Token 385:Criticism 343:Use cases 74:Community 1015:uuencode 737:Archived 708:Archived 678:Archived 649:Archived 616:Archived 590:Archived 557:Archived 528:Archived 479:June 11, 473:Archived 469:iana.org 411:See also 855:EDIFACT 830:formats 645:toml.io 268:enabled 226:Example 208:pairs, 176:) is a 145:Website 113: ( 90: ( 1004:Cyphal 999:Thrift 962:UBJSON 952:Base64 947:Base32 917:Binary 674:GitHub 523:GitHub 366:Python 356:Jekyll 244:server 211:, and 200:Syntax 930:ASN.1 892:Rebol 423:Notes 378:Julia 354:like 280:hosts 253:ports 235:title 106:1.0.0 40:.toml 1020:yEnc 1006:DSDL 974:CBOR 957:BSON 942:Avro 907:YAML 897:TOML 860:JSON 845:Atom 686:2016 565:2024 503:2021 481:2024 441:IANA 372:Rust 360:Hugo 358:and 274:true 265:5000 180:for 170:TOML 150:toml 20:TOML 1010:XDR 935:SMI 925:AMF 902:XML 887:RDF 850:CSV 395:DRY 152:.io 140:Yes 1046:: 735:. 731:. 706:. 702:. 672:. 647:. 643:. 625:. 614:. 588:. 584:. 573:^ 555:. 526:. 520:. 467:. 331:dc 322:ip 313:dc 304:ip 820:e 813:t 806:v 746:. 717:. 688:. 658:. 599:. 567:. 537:. 505:. 483:. 443:. 362:. 334:= 325:= 316:= 307:= 298:] 292:, 286:[ 283:= 271:= 262:= 256:= 247:= 238:= 213:# 168:( 136:? 117:) 94:) 58:) 54:(

Index


Filename extension
Internet media type
Tom Preston-Werner
Latest release
Open format
toml.io
Edit this at Wikidata
file format
configuration files
dictionary
Tom Preston-Werner
open source
.INI files
Static site generators
Jekyll
Hugo
Python
Rust
Julia
DRY
Configuration file § Comparison
IANA
"Media Types"
Archived
"Release 1.0.0"
"Initial commit · toml-lang/toml@84db252"
GitHub
Archived
Preston-Werner, Tom

Text is available under the Creative Commons Attribution-ShareAlike License. Additional terms may apply.