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:(
Text is available under the Creative Commons Attribution-ShareAlike License. Additional terms may apply.