mirror of
https://codeberg.org/PGPainless/sop-java.git
synced 2024-12-23 05:17:58 +01:00
37 lines
No EOL
1.6 KiB
Markdown
37 lines
No EOL
1.6 KiB
Markdown
<!--
|
|
SPDX-FileCopyrightText: 2021 Paul Schaub <vanitasvitae@fsfe.org>
|
|
|
|
SPDX-License-Identifier: Apache-2.0
|
|
-->
|
|
# SOP-Java-Picocli
|
|
|
|
[![javadoc](https://javadoc.io/badge2/org.pgpainless/sop-java-picocli/javadoc.svg)](https://javadoc.io/doc/org.pgpainless/sop-java-picocli)
|
|
[![Maven Central](https://badgen.net/maven/v/maven-central/org.pgpainless/sop-java-picocli)](https://search.maven.org/artifact/org.pgpainless/sop-java-picocli)
|
|
|
|
Implementation of the [Stateless OpenPGP Command Line Interface](https://tools.ietf.org/html/draft-dkg-openpgp-stateless-cli-01) specification.
|
|
This terminal application allows generation of OpenPGP keys, extraction of public key certificates,
|
|
armoring and de-armoring of data, as well as - of course - encryption/decryption of messages and creation/verification of signatures.
|
|
|
|
## Install a SOP backend
|
|
|
|
This module comes without a SOP backend, so in order to function you need to extend it with an implementation of the interfaces defined in `sop-java`.
|
|
An implementation using PGPainless can be found in the module `pgpainless-sop`, but it is of course possible to provide your
|
|
own implementation.
|
|
|
|
Just install your SOP backend by calling
|
|
```java
|
|
// static method call prior to execution of the main method
|
|
SopCLI.setSopInstance(yourSopImpl);
|
|
```
|
|
|
|
## Usage
|
|
|
|
To get an overview of available commands of the application, execute
|
|
```shell
|
|
java -jar sop-java-picocli-XXX.jar help
|
|
```
|
|
|
|
If you just want to get started encrypting messages, see the module `pgpainless-cli` which initializes
|
|
`sop-java-picocli` with `pgpainless-sop`, so you can get started right away without the need to manually wire stuff up.
|
|
|
|
Enjoy! |