mirror of
https://codeberg.org/PGPainless/sop-java.git
synced 2024-06-17 09:04:56 +02:00
47 lines
1.4 KiB
Kotlin
47 lines
1.4 KiB
Kotlin
// SPDX-FileCopyrightText: 2023 Paul Schaub <vanitasvitae@fsfe.org>
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
package sop.operation
|
|
|
|
import java.io.IOException
|
|
import java.io.InputStream
|
|
import sop.Ready
|
|
import sop.enums.ArmorLabel
|
|
import sop.exception.SOPGPException.BadData
|
|
import sop.exception.SOPGPException.UnsupportedOption
|
|
|
|
interface Armor {
|
|
|
|
/**
|
|
* Overrides automatic detection of label.
|
|
*
|
|
* @param label armor label
|
|
* @return builder instance
|
|
*/
|
|
@Deprecated("Use of armor labels is deprecated and will be removed in a future release.")
|
|
@Throws(UnsupportedOption::class)
|
|
fun label(label: ArmorLabel): Armor
|
|
|
|
/**
|
|
* Armor the provided data.
|
|
*
|
|
* @param data input stream of unarmored OpenPGP data
|
|
* @return armored data
|
|
* @throws BadData if the data appears to be OpenPGP packets, but those are broken
|
|
* @throws IOException in case of an IO error
|
|
*/
|
|
@Throws(BadData::class, IOException::class) fun data(data: InputStream): Ready
|
|
|
|
/**
|
|
* Armor the provided data.
|
|
*
|
|
* @param data unarmored OpenPGP data
|
|
* @return armored data
|
|
* @throws BadData if the data appears to be OpenPGP packets, but those are broken
|
|
* @throws IOException in case of an IO error
|
|
*/
|
|
@Throws(BadData::class, IOException::class)
|
|
fun data(data: ByteArray): Ready = data(data.inputStream())
|
|
}
|