snakeyaml - GitLite

KO | EN

gitlite — search

#python #ai #llm #golang #go #machine-learning #rust #linux #nodejs #windows #awesome #cli #pytorch #ios

snakeyaml

(★ 155)

Mirror of https://codeberg.org/snakeyaml/snakeyaml

File Explorer

Download Latest Version (.zip)

- - devcontainer.json
- Devcontainer.md
- Dockerfile
- - CI.yml
- - maven-wrapper.properties
- - changes.xml
- - announcement.msg
  - eclipse-java-google-style.xml
  - header.txt
.gitignore
bitbucket-pipelines.yml
docker-run-jdk11.sh
docker-run-jdk17.sh
docker-run-jdk21.sh
docker-run-jdk25.sh
LICENSE.txt
mvnw
mvnw.cmd
pom.xml
README.md
run-in-docker.sh

# Installation Guide

1. Get the code

git clone https://github.com/snakeyaml/snakeyaml

Downloads the entire project code from GitHub to your computer.

cd snakeyaml

Moves into the project folder you just downloaded.

2. Maven (Java)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java projects.
Maven The build tool used for the mvn command.

mvn clean install

Installs dependencies and builds the project using Maven.

✅ A BUILD SUCCESS message means it worked. The output is created under target/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

***The art of simplicity is a puzzle of complexity.***

## CVE ##

When you are here because of some vulnerability report please be 
aware that it is most probably a **false positive**.

When you use SnakeYAML 
[to configure your application](https://codeberg.org/snakeyaml/snakeyaml/wiki/CVE-2022-1471) 
you are totally safe.

### When a low quality tooling is complaining ###

1. Go to the issue tracker of your low quality tooling and file a bug report about a false positive. You will be impressed with the amount of bugs already created and ignored (this makes the tool low quality - the bugs are created but ignored). The big amount of already reported issues should not stop you - they must be aware of the stream of false positives they produce.
2. Go to your manager or security specialist and present this information. If you pay for the low quality tooling they cannot leave it unattended.
3. Develop further and be happy !

## Overview ##
[YAML](http://yaml.org) is a data serialization format designed for human readability and interaction with scripting languages.

SnakeYAML is a YAML 1.1 processor for the Java Virtual Machine version 8+.
For YAML 1.2 (which is a superset of JSON) you may have a look at [SnakeYAML Engine](https://codeberg.org/snakeyaml/snakeyaml-engine)

## SnakeYAML features ##

* a **complete** [YAML 1.1 processor](http://yaml.org/spec/1.1/current.html). (If you need YAML **1.2** support have a look [here](https://codeberg.org/snakeyaml/snakeyaml-engine)). In particular, SnakeYAML can parse all examples from the specification.
* Unicode support including UTF-8/UTF-16 input/output.
* high-level API for serializing and deserializing native Java objects.
* support for all types from the [YAML types repository](http://yaml.org/type/index.html).
* relatively sensible error messages.
* when you plan to feed the parser with untrusted data please study the settings which allow to restrict incoming data.

## Info ##
 * [Changes](https://codeberg.org/snakeyaml/snakeyaml/wiki/Changes)
 * [Documentation](https://codeberg.org/snakeyaml/snakeyaml/wiki)
 * [CVE and untrusted data](https://codeberg.org/snakeyaml/snakeyaml/wiki/CVE_N_NIST)

## Contribute ##
* GIT [is now used](https://codeberg.org/snakeyaml/snakeyaml/wiki/Migration%20to%20Git) to dance with the [source code](https://codeberg.org/snakeyaml/snakeyaml/src).
* If you find a bug in SnakeYAML, please [file a bug report](https://codeberg.org/snakeyaml/snakeyaml/issues?status=new&status=open&is_spam=!spam).
* You may discuss SnakeYAML at
[the mailing list](http://groups.google.com/group/snakeyaml-core).
* [Slack workspace](https://app.slack.com/client/T26CKL7FU/D02URJSL2KS)
* Telegram group is removed because of the spam
* [YAML community](https://matrix.to/#/%23chat:yaml.io)

## JMH microbenchmarks ##

To execute the [JMH](https://github.com/openjdk/jmh) microbenchmarks locally via Maven:

```shell
./mvnw jmh:benchmark
```
This will produce console results such as the following, as well as a `./jmh-result.json` that can be
visualized via https://jmh.morethan.io/ .

```text
Benchmark                    (entries)  Mode  Cnt    Score     Error  Units
EmitterBenchmark.emitScalar        N/A  avgt    3    0.299 ±   0.047  us/op
ParseBenchmark.load               1000  avgt    3    1.388 ±   0.103  ms/op
ParseBenchmark.load             100000  avgt    3  258.281 ± 367.009  ms/op
ParseBenchmark.parse              1000  avgt    3    0.886 ±   0.163  ms/op
ParseBenchmark.parse            100000  avgt    3   94.930 ±   3.995  ms/op
```