https://github.com/engossoftware/kivi
KIVI | Key-value pair with key and value in separate lines
https://github.com/engossoftware/kivi
key kivi pair value
Last synced: about 2 months ago
JSON representation
KIVI | Key-value pair with key and value in separate lines
- Host: GitHub
- URL: https://github.com/engossoftware/kivi
- Owner: EngosSoftware
- License: apache-2.0
- Created: 2024-11-21T16:44:46.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-01-29T17:59:47.000Z (5 months ago)
- Last Synced: 2025-05-13T03:06:04.951Z (about 2 months ago)
- Topics: key, kivi, pair, value
- Language: Rust
- Homepage:
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# kivi
[![Crates.io][crates-badge]][crates-url]
![Code coverage][coverage-badge]
![build Linux][build-badge-linux]
![build Windows][build-badge-windows]
![build MacOs][build-badge-macos]
[![MIT licensed][mit-badge]][mit-license-url]
[![Apache 2.0 licensed][apache-badge]][apache-license-url]
[![Contributor Covenant][cc-badge]][cc-url]
[crates-badge]: https://img.shields.io/crates/v/kivi.svg
[crates-url]: https://crates.io/crates/kivi
[mit-badge]: https://img.shields.io/badge/License-MIT-blue.svg
[mit-url]: https://opensource.org/licenses/MIT
[mit-license-url]: https://github.com/EngosSoftware/kivi/blob/main/LICENSE-MIT
[apache-badge]: https://img.shields.io/badge/License-Apache%202.0-blue.svg
[apache-url]: https://www.apache.org/licenses/LICENSE-2.0
[apache-license-url]: https://github.com/EngosSoftware/kivi/blob/main/LICENSE
[apache-notice-url]: https://github.com/EngosSoftware/kivi/blob/main/NOTICE
[build-badge-linux]: https://github.com/EngosSoftware/kivi/actions/workflows/build-linux.yml/badge.svg
[build-badge-windows]: https://github.com/EngosSoftware/kivi/actions/workflows/build-windows.yml/badge.svg
[build-badge-macos]: https://github.com/EngosSoftware/kivi/actions/workflows/build-macos.yml/badge.svg
[coverage-badge]: https://img.shields.io/badge/Code%20coverage-100%25-green.svg
[cc-badge]: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg
[cc-url]: https://github.com/EngosSoftware/kivi/blob/main/CODE_OF_CONDUCT.md
[repository-url]: https://github.com/EngosSoftware/kivi
## Overview
KIVI format deserializer.
KIVI is a simple text format for storing keys with associated values on separate lines.
While it is not as widely known as formats like JSON or INI, it is straightforward
and particularly useful in specific contexts where keys or values consist
of multiple lines of text.
An example of a configuration file in KIVI format:
```text
host
127.0.0.1
port
54321
timeout
12ms
```
`host`, `port` and `timeout` are keys; `127.0.0.1`, `54321`, `12ms` are values.
It is quite similar to properties or INI file that store key-value pair in a single line.
In KIVI format, the key and/or value may span over multiple lines.
Multiple-line keys or values must be enclosed in quotation marks.
```text
host
127.0.0.1
port
54321
timeout
12ms
"General
description"
"This configuration file
should be placed in the same
directory where the servers
binary is placed"
```
## License
Licensed under either of
- [MIT license][mit-url] (see [LICENSE-MIT][mit-license-url]) or
- [Apache License, Version 2.0][apache-url] (see [LICENSE][apache-license-url] and [NOTICE][apache-notice-url])
at your option.
## Contribution
Any contributions to [**kivi**][repository-url] are greatly appreciated.
All contributions intentionally submitted for inclusion in the work by you,
shall be dual licensed as above, without any additional terms or conditions.