https://github.com/fasterxml/jackson-dataformats-text
Uber-project for (some) standard Jackson textual format backends: csv, properties, yaml (xml to be added in future)
https://github.com/fasterxml/jackson-dataformats-text
hacktoberfest jackson textual-formats
Last synced: 9 days ago
JSON representation
Uber-project for (some) standard Jackson textual format backends: csv, properties, yaml (xml to be added in future)
- Host: GitHub
- URL: https://github.com/fasterxml/jackson-dataformats-text
- Owner: FasterXML
- License: apache-2.0
- Created: 2017-03-19T19:57:44.000Z (about 8 years ago)
- Default Branch: 2.19
- Last Pushed: 2025-04-22T01:13:47.000Z (11 days ago)
- Last Synced: 2025-04-23T23:16:03.599Z (9 days ago)
- Topics: hacktoberfest, jackson, textual-formats
- Language: Java
- Homepage:
- Size: 6.65 MB
- Stars: 417
- Watchers: 12
- Forks: 152
- Open Issues: 95
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
## Overview
This is a multi-module umbrella project for [Jackson](../../../jackson)
standard text-format dataformat backends.
Dataformat backends are used to support format alternatives to JSON, using
general-purpose Jackson API. Formats included allow access using all 3
API styles (streaming, databinding, tree model).
For Jackson 2.x this is done by sub-classing Jackson core abstractions of:
* All backends sub-class `JsonFactory`, which is factory for:
* `JsonParser` for reading data (decoding data encoding in supported format)
* `JsonGenerator` for writing data (encoding data using supported format)
* Some backends sub-class `ObjectMapper` for additional support for databinding
there will be some changes (such as introduction of format-specific `ObjectMapper`
sub-classes) in Jackson 3.0.
## Branches
`master` branch is for developing the next major Jackson version -- 3.0 -- but there
are active maintenance branches in which much of development happens:
* `2.19` is for developing the next minor 2.x version
* `2.18`/`2.17` are for backported fixes for 2.18/2.17 patch versions (respectively)
Older branches are usually not changed but are available for historic reasons.
All released versions have matching git tags (`jackson-dataformats-text-2.9.4`).
Note that since individual format modules used to live in their own repositories,
older branches and tags do not exist in this repository.
## Textual formats included
Currently included backends are:
* [CSV](csv/)
* [Properties](properties/)
* [TOML](toml/) (since 2.13)
* [YAML](yaml/)
Standard supported formats that are not yet included here (but are likely added
in future) are:
* [XML](../../../jackson-dataformat-xml)
## License
All modules are licensed under [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.txt).
## Status
[](https://travis-ci.org/FasterXML/jackson-dataformats-text)
## Maven dependencies
To use these format backends Maven-based projects, use following dependency:
```xml
com.fasterxml.jackson.dataformat
jackson-dataformat-[FORMAT]
2.18.1
```
where `[FORMAT]` is one of supported modules (`csv`, `properties`, `toml`, `yaml`)
## More
See [Wiki](../../wiki) for more information (javadocs).