Document limitations
parent
4958a4c068
commit
2aea52d78f
19
README.md
19
README.md
|
@ -5,6 +5,25 @@
|
||||||
This library implements the [RFC7049: Concise Binary Object Representation (CBOR)][rfc]
|
This library implements the [RFC7049: Concise Binary Object Representation (CBOR)][rfc]
|
||||||
in Crystal.
|
in Crystal.
|
||||||
|
|
||||||
|
## Limitations
|
||||||
|
|
||||||
|
### Maximum Array/String array/Bytes array length
|
||||||
|
|
||||||
|
The spec allows for the maximum length of arrays, string arrays and bytes array
|
||||||
|
to be a `UInt64`.
|
||||||
|
|
||||||
|
While this library supports lengths expressed as a `UInt64`, it must not exceed
|
||||||
|
`Int32::MAX`.
|
||||||
|
|
||||||
|
### Diagnostic notation
|
||||||
|
|
||||||
|
While this library implements a diagnostic notation to be able to run against
|
||||||
|
the examples provided in the RFC, the diagnostic notation is not fully
|
||||||
|
spec-compliant:
|
||||||
|
|
||||||
|
- Indefinite length items are not marked with the starting underscore but
|
||||||
|
represented as their finite counterparts.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
1. Add the dependency to your `shard.yml`:
|
1. Add the dependency to your `shard.yml`:
|
||||||
|
|
Loading…
Reference in New Issue