cbor4ii

KO | EN

gitlite — search

#python #typescript #go #machine-learning #linux #docker #nodejs #java #cli #security #ios #mcp #openai #open-source

(★ 89)

CBOR: Concise Binary Object Representation

File Explorer

Download Latest Version (.zip)

- - ci.yml
  - release.yml
- bench_de.rs
- bench_ser.rs
- - de.rs
  - decode.rs
- .gitignore
- Cargo.toml
- - dec.rs
  - enc.rs
  - error.rs
  - raw_value.rs
  - types.rs
  - utils.rs
- - de.rs
  - error.rs
  - ser.rs
- core.rs
- lib.rs
- serde.rs
- util.rs
- decode.rs
- serde.rs
- serde_cbor.rs
.gitignore
Cargo.toml
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CBOR 0x(4+4)9 0x49
[![github actions](https://github.com/quininer/cbor4ii/workflows/CI/badge.svg)](https://github.com/quininer/cbor4ii/actions)
[![crates](https://img.shields.io/crates/v/cbor4ii.svg)](https://crates.io/crates/cbor4ii)
[![license](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/quininer/cbor4ii/blob/master/LICENSE)
[![docs.rs](https://docs.rs/cbor4ii/badge.svg)](https://docs.rs/cbor4ii/)

“The Concise Binary Object Representation (CBOR)
is a data format whose design goals include the possibility of extremely small code size,
fairly small message size, and extensibility without the need for version negotiation.”

see [rfc8949](https://www.rfc-editor.org/rfc/rfc8949.html)

## Compatibility

The `core` mod should be fully compatible with rfc8949,
but some extensions will not be implemented in this crate,
such as `datetime`, `bignum`, `bigfloat`.

The `serde` mod defines how Rust types should be expressed in CBOR,
which is not any standard,
so different crate may have inconsistent behavior.

This library is intended to be compatible with `serde_cbor`,
but will not follow some unreasonable designs of `serde_cbor`.

* `cbor4ii` will express the unit type as an empty array instead of null.
  This avoids the problem that `serde_cbor` cannot distinguish between `None` and `Some(())`.
  see <https://github.com/pyfisch/cbor/issues/185>
* `cbor4ii` does not support packed mode, and it may be implemented in future,
  but it may not be compatible with `serde_cbor`.
  If you want packed mode, you should look at `bincode`.

## Performance

It is not specifically optimized for performance in implementation,
but benchmarks shows that its performance is slightly better than `serde_cbor`.

And it supports zero-copy deserialization and `deserialize_ignored_any` of serde,
so in some scenarios it may perform better than crate that do not support such feature.

## Robustness

The decode part has been fuzz tested,
and it should not crash or panic during the decoding process.

The decode of serde module has a depth limit
to prevent stack overflow or OOM caused by specially constructed input.
If you want to turn off deep inspection or adjust parameters,
you can implement the `dec::Read` trait yourself.

# License

This project is licensed under [the MIT license](LICENSE).

cbor4ii

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

cbor4ii

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README