YAML implementation for Nim https://nimyaml.org
Go to file
Vindaar fb13dc1627 further `isNil` checks in `tserialization` fixed 2018-10-12 16:00:39 +02:00
bench Fixed a GC problem; improved bench & tojson 2016-09-30 19:35:43 +02:00
doc Testing Ground uses HTTPS now 2016-11-30 20:31:36 +01:00
server Added YamlParser.display() 2017-02-14 19:40:40 +01:00
test further `isNil` checks in `tserialization` fixed 2018-10-12 16:00:39 +02:00
tools Added testSuiteEvents tool 2017-01-09 19:09:07 +01:00
yaml [soft] take out yTagNimNilString/Seq and related (?) nil tests 2018-10-12 16:00:39 +02:00
.gitignore make tests green again; final fix for 0.17.0 2017-07-10 20:31:40 +02:00
.gitmodules make tests green again; final fix for 0.17.0 2017-07-10 20:31:40 +02:00
.travis.yml Fix Travis build for Nim devel. 2017-10-09 10:43:11 +02:00
CHANGELOG.md Version 0.10.3 2017-09-20 19:04:57 +02:00
README.md README update 2018-08-30 09:49:02 +02:00
config.nims Made token output conform to yaml test suite 2017-02-14 19:06:41 +01:00
copying.txt Added copyright 2015-12-28 22:22:51 +01:00
nimdoc.cfg Documentation update 2016-11-01 12:40:53 +01:00
yaml.nim doc link fixes 2016-10-01 15:19:42 +02:00
yaml.nimble Version 0.10.3 2017-09-20 19:04:57 +02:00

README.md

NimYAML - YAML implementation for Nim

Build Status

NimYAML is a pure Nim YAML implementation without any dependencies other than Nim's standard library. It enables you to serialize Nim objects to a YAML stream and back. It also provides a low-level event-based API, and a document object model which you do not want to use because serializing to native types is much more awesome.

Documentation, examples and an online demo are available here. Releases are available as tags in this repository and can be fetched via nimble:

nimble install yaml

Status

The library is fairly stable, I only maintain it and will not add any features due to lack of time and interest. There are few issues with YAML corner cases in the lexer which you are unlikely to encounter unless you're going for them. Fixing them would mean a larger refactor of the lexer which I am not willing to do.

PRs for bugs are welcome. If you want to add a feature, you are free to; but be aware that I will not maintain it and am unlikely to review it in depth, so if I accept it, you will be co-maintainer.

Features that have been planned, but will not be implemented by myself

  • Serialization:
    • Support for more standard library types
    • Support for polymorphism
    • Support for generic objects

Developers

nim tests # runs all tests
nim lexerTests # run lexer tests
nim parserTests # run parser tests (git-clones yaml-dev-kit)
nim serializationTests # runs serialization tests
nim quickstartTests # run tests for quickstart snippets from documentation
nim documentation # builds documentation to folder docout
nim server # builds the REST server used for the testing ground
nim bench # runs benchmarks, requires libyaml
nim clean # guess
nim build # build a library

NimYAML needs at least Nim 0.17.0 in order to compile. Version 0.9.1 is the last release to support 0.15.x and 0.16.0.

License

MIT