NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
Packagist
Packagist, #686 most downloaded on Packagist
πΈ Nette NEON: a human-friendly data format, simpler than YAML and with entities for objects. Comes with a fast encoder and decoder.
Latest stable
v4.0.1
Last release 16 days ago
06 Nov 2026
Release timing varies
gaps range from 2 weeks to 13 months
Nearly every release is documented
notes for 42 of 42 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
42 releases Β· first in 2014
Drag across the ruler to compare, or tap a release to open it.
Inline arrays over several lines read as in JSON β following the NEON specification 1.1 , a value on the line after its key belongs to that key, so {a
{a: + new line + b} is {a: b}; the same holds in entity arguments, and a new line may also stand between a key and its colon{a: + new line + b} as {a: null, 0: b}. As a transitional aid, parsing a value on the line after its key triggers E_USER_NOTICE naming the line and the key; to keep a key without a value, write null or a comma after itNeon::BLOCK and Neon::CHAIN are deprecated, use blockMode: true and Neon::Chain
NEON 4 parses a file into a lossless syntax tree in which every comment and every space has its place, so you can edit a configuration and the diff shows only your change. Decoding and encoding stay as they were: Neon::decode() gives the same values as 3.4.
Neon::parse($text)->print() === $text holds for any input NEON acceptssetValue(), addItem() and removeItem() change only the tokens they edit: 0x0CEA stays hexadecimal, yes becomes no, a new key is indented like its siblings, and a removed item takes its comment along. A refused edit changes nothing at all, so installers, admin panels and AI agents can rewrite config.neon safelyfind(), findAncestor(), siblings, and a public Traverser that can replace and remove nodes on the walk$blockMode to decide per array whether it is written as a block, e.g. fn($v, $path) => !$path for the first level only, and writes floats in the shortest form that reads back exactlygetDescription()--json for tools and --check to verify that a file prints back byte for byte; an AI agent can run it after saving a .neon filembstring extensionNodes\DocumentNode, and the classes Decoder, Node\* and the old Traverser are gone. Code that walked the old nodes moves to the new tree, see examples/treeNette\Neon\Exception for a string that is not valid UTF-8 instead of replacing it with U+FFFD; its errors now name the path to the value--debug is gone, and a failure of the tool itself exits with 2Neon::BLOCK and Neon::CHAIN are deprecated, use blockMode: true and Neon::ChainYour coding agent can read these notes before it upgrades. Set up the MCP server β
Neon::encode() now quotes strings like -.5 and +.5 , so they decode back as strings, not floats
-.5 and +.5, so they decode back as strings, not floats''', now survive an encode and decode round trip unchanged--debug for the path to checkToo deep nesting instead of overflowing the stack, and deeply nested dash lists no longer take exponential time to parseA literal shaped like a date that is not a valid one, such as 2024-02-30 or 2024-13-01 , now decodes as a plain string
2024-02-30 or 2024-13-01, now decodes as a plain string!!chain is reserved for chained entities and can no longer be written in the inputMore precise phpDoc types across the codebase β better autocompletion and stricter static analysis
Encoder: invalid UTF-8 sequences are replaced with U+FFFD #76
fixed mixed indents in block strings
optimized global function calls
Encoder: fixed encoding of control characters #72
Decoder: fixed JSON parsing with \n before comma
syntax: allowed tab as separator for dashed-blocks
removed deprecated syntax on/off & \x (BC break)
on/off & \x** (BC break)on/off & \x** (BC break)Encoder: fixed encoding of control characters #72
Neon::decodeFile() is atomicEncoder: uses more readable single quote strings
Node::getSubNodes() changed to IteratorAggregate generator,Node::getSubNodes() changed to IteratorAggregate generator,ArrayNode::$indentation usage fixed #63
Neon::decode() no longer removes BOM (BC break)
Neon::decodeFile()Neon::decode() no longer removes BOM (BC break)Neon::encode() $flags replaced with parameters* completely rewritten parser * generates AST * added Traverser * encoder uses AST
uses mb_string when iconv is not available
Decoder: fixed \s in unicode, replaced with \n\t\_
For the details you can have a look at the diff.
syntax \xAA is deprecated in favor of \uAAAA (BC break)
Encoder: correctly encodes numeric strings
For the details you can have a look at the diff.
Encoder: json_encode() error is escalated to exception
json_encode() error is escalated to exceptionFor the details you can have a look at the diff.
Neon syntax: deprecated keywords on/off
: when it follows after '" to improve JSON compatibility (syntax BC break)- or : followed by =[{( (syntax BC break)on/off (#41)! (#42)Encoder: correctly encodes numeric strings
json_encode() error is escalated to exceptionFor the details you can have a look at the diff.
uses PHP 7.0 scalar and return type hints
For the details you can have a look at the diff.
For the details you can have a look at the diff.
coding style: fixes, lowercase true/false/null
For the details you can have a look at the diff.
Decoder: every regexp are possessive #36
__set_state() support #35For the details you can have a look at the diff.
added support for multilines strings nette/nette#1375
For the details you can have a look at the diff.
Decoder: fixed datetime regexp #29
For the details you can have a look at the diff.
Decoder: fixed entity value conversion in the entity chain
For the details you can have a look at the diff.
Encoder: added support for entity chaining #21
For the details you can have a look at the diff.
travis: migrating to container-based infrastructure
For the details you can have a look at the diff.
Encoder: removed trailing spaces #20
For the details you can have a look at the diff.
chained syntax first(a, b)second(1, 2)
first(a, b)second(1, 2)Encoder: removed trailing spaces #20
For the details you can have a look at the diff.
travis: migrating to container-based infrastructure
For the details you can have a look at the diff.
Encoder: encodes strings with JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES
For the details you can have a look at the diff.
For the details you can have a look at the diff.
For the details you can have a look at the diff.
For the details you can have a look at the diff.
allows combinations of tabs and spaces
- key: val
key2: val2
For the details you can have a look at the diff.
The first standalone release. For more information see readme.md and sandbox.
The first standalone release. For more information see readme.md and sandbox.
One column per quarter.