1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
***The art of simplicity is a puzzle of complexity.***
## Overview ##
[YAML](http://yaml.org) is a data serialization format designed for human readability and
interaction with scripting languages.
SnakeYAML Engine is a YAML 1.2 processor for the Java Virtual Machine version 8 and higher.
[Latest release](https://central.sonatype.dev/search?q=snakeyaml-engine)
## API
* The Engine will parse/emit basic Java structures (String, List<Integer>, Map<String, Boolean>).
JavaBeans or any other custom instances are explicitly out of scope.
* Since the custom instances are not supported, parsing any YAML document is safe - the YAML input
stream is not able to instruct the Engine to call arbitrary Java constructors (unless it is
explicitly enabled)
## SnakeYAML Engine features ##
* a **complete** [YAML 1.2 processor](https://yaml.org/spec/1.2.2/). In particular, SnakeYAML
can parse (almost) all examples from the specification.
* Integrated tests
from [YAML Test Suite - Comprehensive Test Suite for YAML](https://github.com/yaml/yaml-test-suite)
* Unicode support including UTF-8/UTF-16/UTF-32 input/output.
* Low-level API for serializing and deserializing native Java objects.
* All the [Schemas](https://yaml.org/spec/1.2.2/#chapter-10-recommended-schemas) are supported.
(A
good [introduction to schemas](http://blogs.perl.org/users/tinita/2018/01/introduction-to-yaml-schemas-and-tags.html))
* Relatively sensible error messages (can be switched off to improve performance).
* When you plan to feed the parser with untrusted data please study the settings which allow to restrict incoming data.
## Info ##
* [Changes](https://bitbucket.org/snakeyaml/snakeyaml-engine/wiki/Changes)
* [Documentation](https://bitbucket.org/snakeyaml/snakeyaml-engine/wiki/Documentation)
* [CVE and untrusted sources](https://bitbucket.org/snakeyaml/snakeyaml/wiki/CVE%20&%20NIST.md)
## Contribute ##
* GIT is used to dance with the [source code](https://bitbucket.org/snakeyaml/snakeyaml-engine/src).
* If you find a bug
please [file a bug report](https://bitbucket.org/snakeyaml/snakeyaml-engine/issues?status=new&status=open).
* You may discuss SnakeYAML Engine
at [the mailing list](http://groups.google.com/group/snakeyaml-core).
|
