/*
* Copyright (C) 2018, 2021 Salesforce and others
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0 which is available at
* https://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
package org.eclipse.jgit.lib;
/**
* Typed access to GPG related configuration options.
*
* @since 5.2
*/
public class GpgConfig {
/**
* Config values for gpg.format.
*/
public enum GpgFormat implements Config.ConfigEnum {
/** Value for openpgp */
OPENPGP("openpgp"), //$NON-NLS-1$
/** Value for x509 */
X509("x509"), //$NON-NLS-1$
/**
* Value for ssh.
*
* @since 7.0
*/
SSH("ssh"); //$NON-NLS-1$
private final String configValue;
private GpgFormat(String configValue) {
this.configValue = configValue;
}
@Override
public boolean matchConfigValue(String s) {
return configValue.equals(s);
}
@Override
public String toConfigValue() {
return configValue;
}
}
private final GpgFormat keyFormat;
private final String signingKey;
private final String program;
private final boolean signCommits;
private final boolean signAllTags;
private final boolean forceAnnotated;
private final String sshDefaultKeyCommand;
private final String sshAllowedSignersFile;
private final String sshRevocationFile;
/**
* Create a new GPG config that reads the configuration from config.
*
* @param config
* the config to read from
*/
public GpgConfig(Config config) {
keyFormat = config.getEnum(ConfigConstants.CONFIG_GPG_SECTION, null,
ConfigConstants.CONFIG_KEY_FORMAT, GpgFormat.OPENPGP);
signingKey = config.getString(ConfigConstants.CONFIG_USER_SECTION, null,
ConfigConstants.CONFIG_KEY_SIGNINGKEY);
String exe = config.getString(ConfigConstants.CONFIG_GPG_SECTION,
keyFormat.toConfigValue(), ConfigConstants.CONFIG_KEY_PROGRAM);
if (exe == null && GpgFormat.OPENPGP.equals(keyFormat)) {
exe = config.getString(ConfigConstants.CONFIG_GPG_SECTION, null,
ConfigConstants.CONFIG_KEY_PROGRAM);
}
program = exe;
signCommits = config.getBoolean(ConfigConstants.CONFIG_COMMIT_SECTION,
ConfigConstants.CONFIG_KEY_GPGSIGN, false);
signAllTags = config.getBoolean(ConfigConstants.CONFIG_TAG_SECTION,
ConfigConstants.CONFIG_KEY_GPGSIGN, false);
forceAnnotated = config.getBoolean(ConfigConstants.CONFIG_TAG_SECTION,
ConfigConstants.CONFIG_KEY_FORCE_SIGN_ANNOTATED, false);
sshDefaultKeyCommand = config.getString(
ConfigConstants.CONFIG_GPG_SECTION,
ConfigConstants.CONFIG_SSH_SUBSECTION,
ConfigConstants.CONFIG_KEY_SSH_DEFAULT_KEY_COMMAND);
sshAllowedSignersFile = config.getString(
ConfigConstants.CONFIG_GPG_SECTION,
ConfigConstants.CONFIG_SSH_SUBSECTION,
ConfigConstants.CONFIG_KEY_SSH_ALLOWED_SIGNERS_FILE);
sshRevocationFile = config.getString(ConfigConstants.CONFIG_GPG_SECTION,
ConfigConstants.CONFIG_SSH_SUBSECTION,
ConfigConstants.CONFIG_KEY_SSH_REVOCATION_FILE);
}
/**
* Retrieves the config value of gpg.format.
*
* @return the {@link org.eclipse.jgit.lib.GpgConfig.GpgFormat}
*/
public GpgFormat getKeyFormat() {
return keyFormat;
}
/**
* Retrieves the value of the configured GPG program to use, as defined by
* gpg.openpgp.program, gpg.x509.program (depending on the defined
* {@link #getKeyFormat() format}), or gpg.program.
*
* @return the program string configured, or {@code null} if none
* @since 5.11
*/
public String getProgram() {
return program;
}
/**
* Retrieves the config value of user.signingKey.
*
* @return the value of user.signingKey (may be null
)
*/
public String getSigningKey() {
return signingKey;
}
/**
* Retrieves the config value of commit.gpgSign.
*
* @return the value of commit.gpgSign (defaults to false
)
*/
public boolean isSignCommits() {
return signCommits;
}
/**
* Retrieves the value of git config {@code tag.gpgSign}.
*
* @return the value of {@code tag.gpgSign}; by default {@code false}
*
* @since 5.11
*/
public boolean isSignAllTags() {
return signAllTags;
}
/**
* Retrieves the value of git config {@code tag.forceSignAnnotated}.
*
* @return the value of {@code tag.forceSignAnnotated}; by default
* {@code false}
*
* @since 5.11
*/
public boolean isSignAnnotated() {
return forceAnnotated;
}
/**
* Retrieves the value of git config {@code gpg.ssh.defaultKeyCommand}.
*
* @return the value of {@code gpg.ssh.defaultKeyCommand}
*
* @since 7.1
*/
public String getSshDefaultKeyCommand() {
return sshDefaultKeyCommand;
}
/**
* Retrieves the value of git config {@code gpg.ssh.allowedSignersFile}.
*
* @return the value of {@code gpg.ssh.allowedSignersFile}
*
* @since 7.1
*/
public String getSshAllowedSignersFile() {
return sshAllowedSignersFile;
}
/**
* Retrieves the value of git config {@code gpg.ssh.revocationFile}.
*
* @return the value of {@code gpg.ssh.revocationFile}
*
* @since 7.1
*/
public String getSshRevocationFile() {
return sshRevocationFile;
}
}