SOML – A Config Format for Humans
Source Entity
Hacker News
SOML (Sindre's Objectively Marvelous Language) is a new configuration format designed to prioritize human readability and developer ergonomics. It eliminates common syntax friction found in JSON by removing unnecessary braces, quotes, and commas.
The Emergence of SOML: Rethinking Configuration
In the modern software development landscape, configuration formats serve as the backbone of application infrastructure. While formats like JSON have long been the industry standard for data interchange, they are often criticized for their rigid syntax, which requires excessive boilerplate such as quotes, commas, and curly braces. The introduction of SOML, or "Sindre's Objectively Marvelous Language," represents a deliberate pivot toward developer ergonomics, aiming to provide a configuration experience that is as pleasant to write as it is easy to read.
Syntactic Innovations
SOML distinguishes itself by simplifying the fundamental structure of configuration files. By removing the requirement for top-level braces and eliminating the need for quotes around keys, the language reduces visual noise significantly. The use of line breaks instead of commas creates a cleaner, more readable hierarchy that mirrors human-readable documents. Furthermore, the format allows comments to be placed almost anywhere, a feature notably absent in standard JSON, which often forces developers to rely on pre-processors or lose context in their configuration files.
Type Safety and Native Data Handling
One of the most significant technical hurdles in traditional formats is the ambiguity of data types. SOML solves this by deriving a value's type strictly from its syntax rather than its content. This "what you see is what you get" approach ensures that '123' is treated as a string, while 123 is treated as an integer, eliminating common bugs associated with silent type coercion. By treating dates, instants, and durations as first-class, native values, SOML removes the guesswork from time-based configurations, such as defining 30s as a duration rather than a unitless integer.
Managing Complex Data Types
Beyond basic scalar values, SOML addresses the notorious difficulty of handling paths, regular expressions, and prose. By allowing these elements to exist without the need for manual escaping, the format drastically reduces the likelihood of syntax errors that frequently plague developers working with complex strings. The inclusion of block strings for prose ensures that documentation or long-form text within configuration files remains legible and well-structured, further bridging the gap between machine-readable files and human-readable documentation.
Standardization and Future Trends
Crucial to the longevity of any configuration language is its implementation consistency. SOML addresses this by establishing one canonical form and a shared conformance suite. This ensures that every implementation, regardless of the programming language or environment, reads a configuration file in an identical manner. As the software industry continues to move toward more complex microservices and infrastructure-as-code paradigms, the demand for human-centric configuration tools like SOML is likely to grow, potentially challenging the dominance of legacy formats that prioritize machine parsing over developer comfort.