https://github.com/filip26/ld-cli
A command-line utility for processing JSON-LD, RDF, RDFC, JCS, and CBOR-LD, with native executables for Ubuntu, macOS, and Windows.
https://github.com/filip26/ld-cli
cbor cbor-ld cli command-line jcs json json-ld linked-data rdf rdf-canonicalization rdfc
Last synced: 18 days ago
JSON representation
A command-line utility for processing JSON-LD, RDF, RDFC, JCS, and CBOR-LD, with native executables for Ubuntu, macOS, and Windows.
- Host: GitHub
- URL: https://github.com/filip26/ld-cli
- Owner: filip26
- License: apache-2.0
- Created: 2022-04-01T12:56:26.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-21T09:52:28.000Z (21 days ago)
- Last Synced: 2025-04-23T22:51:38.478Z (18 days ago)
- Topics: cbor, cbor-ld, cli, command-line, jcs, json, json-ld, linked-data, rdf, rdf-canonicalization, rdfc
- Language: Java
- Homepage:
- Size: 345 KB
- Stars: 19
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-java-rdf - `ld-cli`
- awesome-java-rdf - `ld-cli`
README
> [!IMPORTANT]
> Your feedback is essential to the improvement of this library. Please share any concerns, primary use cases, areas for enhancement, or challenges you have encountered. Your insights help refine and optimize the library to better meet user needs. Thank you for your time and contributions.
# Linked Data CLI
A simple command-line utility designed to process JSON-LD, RDF, and CBOR-LD documents. The goal is to provide native executables compiled for Ubuntu, macOS, and Windows.
## Features
* [W3C JSON-LD 1.1](https://www.w3.org/TR/json-ld/)
* [W3C CBOR-LD 1.0](https://json-ld.github.io/cbor-ld-spec/)
* [W3C Standard RDF Dataset Canonicalization Algorithm](https://www.w3.org/TR/rdf-canon/)
* [RFC 8785 JSON Canonicalization Scheme (JCS)](https://www.rfc-editor.org/rfc/rfc8785)
## Status
[](https://github.com/filip26/ld-cli/releases)
[](https://github.com/filip26/ld-cli/releases)
## Installation
[Downloads](https://github.com/filip26/ld-cli/releases/)
```bash
> unzip ld-cli-....zip
> chmod +x ld-cli
```
## Usage
```bash
> ld-cli -h
Usage: ld-cli [-hv] [COMMAND]
Linked Data Command Line Processor
Options:
-h, --help display help message
-v, --version display a version
Commands:
expand Expand JSON-LD document
compact Compact JSON-LD document using the context
flatten Flatten JSON-LD document and optionally compact using a context
frame Frame JSON-LD document using the frame
fromrdf Transform N-Quads document into a JSON-LD document in an expanded form
tordf Transform JSON-LD document into N-Quads document
compress Compress JSON-LD document into CBOR-LD
decompress Decompress CBOR-LD document into JSON-LD
rdfc Canonize an RDF N-Quads document with RDFC-1.0
jcs Canonize a JSON document using the JSON Canonicalization Scheme (JCS)
> ld-cli expand -h
Usage: ld-cli expand [-op] [-b=] [-c=] [-i=] [-m=1.0|1.1]
Expand JSON-LD document
Options:
-b, --base= input document base IRI
-c, --context= context IRI
-i, --input= input document IRI
-m, --mode=1.0|1.1 processing mode
-o, --ordered certain algorithm processing steps are ordered
lexicographically
-p, --pretty pretty print output JSON
```
### Pipeline
```bash
> cat document.json | ld-cli expand --ordered --pretty > expanded.jsonld
```
### `https://` scheme support
```bash
> ld-cli rdfc -i https://raw.githubusercontent.com/filip26/titanium-rdf-canon/refs/heads/main/src/test/resources/com/apicatalog/rdf/canon/rdfc10/test022-in.nq
```
### `file:/` scheme support
```bash
> ld-cli compress -i file:/home/filip/example.jsonld
```
### Custom CBOR-LD dictionaries
```bash
> ld-cli decompress --pretty --dictionary=./utopia-barcodes-dictionary-example.json <<< 'd90664a60183198000198001198002189d82187618a418b8a3189c18a618ce18b218d01ae592208118baa2189c18a018a8447582002018be18aa18c0a5189c186c18d60418e018e618e258417ab7c2e56b49e2cce62184ce26818e15a8b173164401b5d3bb93ffd6d2b5eb8f6ac0971502ae3dd49d17ec66528164034c912685b8111bc04cdc9ec13dbadd91cc18e418ac'
```
## Contributing
All PR's welcome!
### Building
1. [Install GraalVM and Native Image](https://www.graalvm.org/latest/docs/)
- download and unpack ```graalvm-jdk-....tar.gz```
- set ```JAVA_HOME``` and ```PATH``` env variables
3. ```mvn clean package -Pnative```
4. ```./target/ld-cli```
## Resources
* [Titanium JSON-LD](https://github.com/filip26/titanium-json-ld)
* [Titanium RDFC](https://github.com/filip26/titanium-rfc-canon)
* [Titanium JCS](https://github.com/filip26/titanium-jcs)
* [Iridium CBOR-LD](https://github.com/filip26/iridium-cbor-ld)
## Sponsors
## Commercial Support
Commercial support is available at [email protected]