Merge pull request #157 from filip26/feat/v011

v1.0.0

Author: filip26

README.md

@@ -1,15 +1,20 @@
 # Linked Data CLI
 
-A simple command-line utility designed to process JSON-LD, RDF, and CBOR-LD documents. Built with GraalVM, `ld-cli` delivers native executables for Ubuntu, macOS, and Windows - eliminating JVM dependencies and runtime overhead.
+A simple command-line utility designed to process JSON-LD, RDF, CBOR-LD, and multiformats documents. 
+    
+Supports batch workflows, canonicalization, serialization, encoding, decoding, and format conversion for linked data resources, binary identifiers, and content addressing formats in knowledge graphs, decentralized identifiers (DIDs), and semantic web applications.
 
-It's ideal for batch workflows, automated validation, canonicalization, and serialization of linked data resources in knowledge graphs, decentralized identifiers (DIDs), and semantic web applications.
+Built with GraalVM, `ld-cli` delivers native executables for Ubuntu, macOS, and Windows - eliminating JVM dependencies.
 
 ## 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)
+* [W3C CCG Multibase](https://github.com/w3c-ccg/multibase)
+* [Multicodec](https://github.com/multiformats/multicodec)
+* [Multihash](https://github.com/multiformats/multihash)
 
 ## Status
 
@@ -29,7 +34,7 @@ sudo snap install ld-cli
 
 ### 📁 Manual Download
 
-Download the latest release from the [GitHub Releases page](https://github.com/filip26/ld-cli/releases/).
+Download the latest release from the [GitHub Releases page](https://github.com/filip26/ld-cli/releases/). Click Assets to see the available downloads.
 
 After downloading, extract the archive and make the binary executable:
 
@@ -47,34 +52,40 @@ Usage: ld-cli [-hv] [COMMAND]
 Linked Data Command Line Processor
 
 Options:
-  -h, --help      display help message
-  -v, --version   display a version
+  -h, --help      Display help message.
+  -v, --version   Display version information.
 
 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)
+  expand      Expand a JSON-LD document.
+  compact     Compact a JSON-LD document using the provided context.
+  flatten     Flatten a JSON-LD document and optionally compact it using a
+                context.
+  frame       Frame a JSON-LD document using the provided frame.
+  fromrdf     Transform an N-Quads document into a JSON-LD document in expanded
+                form.
+  tordf       Transform a JSON-LD document into an RDF 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 using the RDFC-1.0 algorithm.
+  jcs         Canonize a JSON document using the JSON Canonicalization Scheme
+                (JCS).
+  multibase   Encode, decode, detect, or list multibase encodings.
+  multicodec  Add, remove, detect, or list multicodec headers.
 
 > ld-cli expand -h
-Usage: ld-cli expand [-op] [-b=<base>] [-c=<context>] [-i=<input>] [-m=1.0|1.1]
+Usage: ld-cli expand [-op] [--debug] [-b=<uri>] [-c=<uri>] [-i=<uri|file>]
+                     [-m=1.0|1.1]
 
-Expand JSON-LD document
+Expand a JSON-LD document.
 
 Options:
-  -b, --base=<base>         input document base IRI
-  -c, --context=<context>   context IRI
-  -i, --input=<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
+  -b, --base=<uri>         Base URI of the input document.
+  -c, --context=<uri>      Context URI.
+      --debug              Print detailed error information.
+  -i, --input=<uri|file>   Input document URI or file path.
+  -m, --mode=1.0|1.1       Processing mode.
+  -o, --ordered            Order certain algorithm steps lexicographically.
+  -p, --pretty             Pretty-print the output JSON.
 
 ```
 
@@ -97,7 +108,27 @@ 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'
+ld-cli decompress --pretty --dictionary ./utopia-barcodes-dictionary-example.json <<< 'd90664a60183198000198001198002189d82187618a418b8a3189c18a618ce18b218d01ae592208118baa2189c18a018a8447582002018be18aa18c0a5189c186c18d60418e018e618e258417ab7c2e56b49e2cce62184ce26818e15a8b173164401b5d3bb93ffd6d2b5eb8f6ac0971502ae3dd49d17ec66528164034c912685b8111bc04cdc9ec13dbadd91cc18e418ac'
+```
+
+### Multicodec
+```bash
+ld-cli multicodec --analyze --multibase <<< 'z6MkmM42vxfqZQsv4ehtTjFFxQ4sQKS2w6WR7emozFAn5cxu'
+```
+```bash
+Multibase:  name=base58btc, prefix=z, length=58 chars
+Multicodec: name=ed25519-pub, code=237, varint=[0xED,0x01], tag=Key, status=Draft
+Length:     32 bytes
+```
+
+### Multihash
+```bash
+ld-cli multicodec --analyze --multibase <<< 'MEiCcvAfD+ZFyWDajqipYHKICkZiqQgudmbwOEx2fPiy+Rw=='
+```
+```bash
+Multibase:  name=base64pad, prefix=M, length=64 chars
+Multihash:  name=sha2-256, code=18, varint=[0x12], tag=Multihash, status=Permanent
+Length:     32 bytes
 ```
 
 ## Contributing
@@ -108,7 +139,7 @@ All PR's welcome!
 
 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
+   - set ```GRAALVM_HOME``` env variable
 3. ```mvn clean package -Pnative```
 4. ```./target/ld-cli```
 
@@ -119,6 +150,8 @@ All PR's welcome!
 * [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)
+* [Copper Multibase](https://github.com/filip26/copper-multibase)
+* [Copper Multicodec](https://github.com/filip26/copper-multicodec)
 
 ## Sponsors
 

pom.xml

@@ -6,10 +6,17 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.apicatalog</groupId>
     <artifactId>ld-cli</artifactId>
-    <version>0.10.0</version>
+    <version>1.0.0</version>
     <packaging>jar</packaging>
 
     <name>A Command Line Processor for Linked Data Processing</name>
+    
+    <description>
+        Supports batch workflows, canonicalization, serialization, encoding,
+        decoding, and format conversion for linked data resources, binary
+        identifiers, and content addressing formats in knowledge graphs,
+        decentralized identifiers (DIDs), and semantic web applications.
+    </description>
 
     <url>https://github.com/filip26/ld-cli</url>
 
@@ -284,5 +291,4 @@
             </build>
         </profile>
     </profiles>
-
 </project>

snapcraft.yaml

@@ -1,25 +1,21 @@
 name: ld-cli
 title: Linked Data CLI
-version: 0.10.0
+version: 1.0.0
 license: Apache-2.0
-summary: Command-line tool for JSON-LD, RDF, RDFC, JCS, and CBOR-LD processing
+summary: Command-line tool for JSON-LD, RDF, RDFC, JCS, CBOR-LD, semantic processing
 description: |
-  Linked Data CLI (`ld-cli`) is a command-line tool for processing and transforming linked data formats,
-  including:
+  Linked Data CLI (`ld-cli`) is a command-line tool for processing and transforming linked data formats, including:
 
     • JSON-LD (JavaScript Object Notation for Linked Data)
     • RDF (Resource Description Framework)
     • RDFC (RDF Canonicalization)
     • JCS (JSON Canonicalization Scheme)
     • CBOR-LD (Concise Binary Object Representation for Linked Data)
-
-  Built with GraalVM, `ld-cli` provides native execution with zero JVM startup overhead.
-  It's ideal for batch workflows, automated validation, canonicalization, and serialization of
-  linked data resources in knowledge graphs, decentralized identifiers (DIDs), and semantic web applications.
-
-  This Snap includes a precompiled native executable built with GraalVM for optimal performance
-  on modern Ubuntu systems.
-
+    • multibase (Base-encoding format with self-describing prefixes)
+    • multicodec (Self-describing content type identifiers)
+    
+  Supports batch workflows, canonicalization, serialization, encoding, decoding, and format conversion for linked data resources, binary identifiers, and content addressing formats in knowledge graphs, decentralized identifiers (DIDs), and semantic web applications.
+    
 source-code: https://github.com/filip26/ld-cli
 issues: https://github.com/filip26/ld-cli/issues
 contact: filip26@gmail.com
@@ -30,7 +26,7 @@ grade: stable
 parts:
   graalvm:
     plugin: nil
-    source: https://download.oracle.com/graalvm/21/latest/graalvm-jdk-21_linux-x64_bin.tar.gz
+    source: https://download.oracle.com/graalvm/24/latest/graalvm-jdk-24_linux-x64_bin.tar.gz
     build-packages:
       - wget
       - tar 

src/main/java/com/apicatalog/cli/App.java

@@ -8,73 +8,65 @@
 import com.apicatalog.cli.command.FrameCmd;
 import com.apicatalog.cli.command.FromRdfCmd;
 import com.apicatalog.cli.command.JcsCmd;
+import com.apicatalog.cli.command.MultibaseCmd;
+import com.apicatalog.cli.command.MulticodecCmd;
 import com.apicatalog.cli.command.RdfCanonCmd;
 import com.apicatalog.cli.command.ToRdfCmd;
 import com.apicatalog.jsonld.http.media.MediaType;
 import com.apicatalog.jsonld.loader.HttpLoader;
 
 import picocli.CommandLine;
 import picocli.CommandLine.Command;
+import picocli.CommandLine.MissingParameterException;
 import picocli.CommandLine.Option;
 import picocli.CommandLine.ParseResult;
 
-@Command(
-    name = "ld-cli",
-    description = "Linked Data Command Line Processor",
-    subcommands = { 
-            ExpandCmd.class,
-            CompactCmd.class,
-            FlattenCmd.class,
-            FrameCmd.class,
-            FromRdfCmd.class,
-            ToRdfCmd.class,
-            CompressCmd.class,
-            DecompressCmd.class,
-            RdfCanonCmd.class,
-            JcsCmd.class,
-            },
-    mixinStandardHelpOptions = false,
-    descriptionHeading = "%n",
-    parameterListHeading = "%nParameters:%n",
-    optionListHeading = "%nOptions:%n",
-    commandListHeading = "%nCommands:%n",
-    version = {
-            "ld-cli            0.10.0  https://github.com/filip26/ld-cli",
-            "titanium-json-ld  1.6.0  https://github.com/filip26/titanium-json-ld",
-            "titanium-rdfc     2.0.0  https://github.com/filip26/titanium-rdf-canon",
-            "titanium-jcs      1.0.0  https://github.com/filip26/titanium-jcs",
-            "iridium-cbor-ld   0.3.0  https://github.com/filip26/iridium-cbor-ld",
-            }
-    )
+@Command(name = "ld-cli", description = "Linked Data Command Line Processor", subcommands = {
+        ExpandCmd.class,
+        CompactCmd.class,
+        FlattenCmd.class,
+        FrameCmd.class,
+        FromRdfCmd.class,
+        ToRdfCmd.class,
+        CompressCmd.class,
+        DecompressCmd.class,
+        RdfCanonCmd.class,
+        JcsCmd.class,
+        MultibaseCmd.class,
+        MulticodecCmd.class,
+}, mixinStandardHelpOptions = false, descriptionHeading = "%n", parameterListHeading = "%nParameters:%n", optionListHeading = "%nOptions:%n", commandListHeading = "%nCommands:%n", version = {
+        "ld-cli            0.11.0  https://github.com/filip26/ld-cli",
+        "titanium-json-ld  1.6.0   https://github.com/filip26/titanium-json-ld",
+        "titanium-rdfc     2.0.0   https://github.com/filip26/titanium-rdf-canon",
+        "titanium-jcs      1.0.0   https://github.com/filip26/titanium-jcs",
+        "iridium-cbor-ld   0.7.0   https://github.com/filip26/iridium-cbor-ld",
+        "copper-multibase  4.0.0   https://github.com/filip26/copper-multibase",
+        "copper-multicodec 2.1.0   https://github.com/filip26/copper-multicodec",
+})
 public final class App {
-    
-    @Option(names = { "-h", "--help" }, usageHelp = true, description = "display help message")
+
+    @Option(names = { "-h", "--help" }, usageHelp = true, description = "Display help message.")
     boolean help = false;
 
-    @Option(names = {"-v", "--version"}, versionHelp = true, description = "display a version")
-    boolean version;    
+    @Option(names = { "-v", "--version" }, versionHelp = true, description = "Display version information.")
+    boolean version;
 
     static {
         ((HttpLoader) HttpLoader.defaultInstance()).fallbackContentType(MediaType.JSON);
     }
-    
+
     public static void main(String[] args) {
 
         final CommandLine cli = new CommandLine(new App());
         cli.setCaseInsensitiveEnumValuesAllowed(true);
+        cli.setExecutionExceptionHandler(new ErrorHandler());
 
         try {
 
             final ParseResult result = cli.parseArgs(args);
 
             if (cli.isUsageHelpRequested()) {
-
-                if (result.subcommand() != null) {
-                    result.subcommand().commandSpec().commandLine().usage(cli.getOut());
-                    return;
-                }
-
-                cli.usage(cli.getOut());
+                usage(cli, result);
                 System.exit(cli.getCommandSpec().exitCodeOnUsageHelp());
                 return;
             }
@@ -86,10 +78,24 @@ public static void main(String[] args) {
             }
 
             System.exit(cli.execute(args));
+            return;
+
+        } catch (MissingParameterException e) {
+            cli.getErr().println(e.getMessage());
+            e.getCommandLine().getCommandSpec().commandLine().usage(cli.getOut());
 
         } catch (Exception ex) {
             cli.getErr().println(ex.getMessage());
-            System.exit(cli.getCommandSpec().exitCodeOnExecutionException());
         }
+
+        System.exit(cli.getCommandSpec().exitCodeOnExecutionException());
     }
+
+    static final void usage(final CommandLine cli, final ParseResult result) {
+        if (result.subcommand() != null) {
+            result.subcommand().commandSpec().commandLine().usage(cli.getOut());
+            return;
+        }
+        cli.usage(cli.getOut());
+    }    
 }

src/main/java/com/apicatalog/cli/ErrorHandler.java

@@ -0,0 +1,25 @@
+package com.apicatalog.cli;
+
+import com.apicatalog.cli.mixin.CommandOptions;
+
+import picocli.CommandLine;
+import picocli.CommandLine.IExecutionExceptionHandler;
+import picocli.CommandLine.ParseResult;
+
+public class ErrorHandler implements IExecutionExceptionHandler {
+    @Override
+    public int handleExecutionException(Exception ex,
+            CommandLine cmd,
+            ParseResult parseResult) {
+
+        cmd.getErr().println(ex.getMessage());
+
+        var options = ((CommandOptions) cmd.getMixins().get("options"));
+
+        if (options.debug) {
+            ex.printStackTrace(cmd.getErr());
+        }
+
+        return cmd.getCommandSpec().exitCodeOnExecutionException();
+    }
+}

src/main/java/com/apicatalog/cli/JsonCborDictionary.java

@@ -45,10 +45,15 @@ public static DocumentDictionary of(JsonObject json) {
             switch (item.getKey()) {
             case "code":
                 continue;
+
             case "context":
                 item.getValue().asJsonObject().entrySet()
                         .forEach(e -> builder.context(e.getKey(),
                                 ((JsonNumber) e.getValue()).intValue()));
+            case "uri":
+                item.getValue().asJsonObject().entrySet()
+                        .forEach(e -> builder.uri(e.getKey(),
+                                ((JsonNumber) e.getValue()).intValue()));
             default:
                 item.getValue().asJsonObject().entrySet()
                         .forEach(e -> builder.type(