org.eclipse.jgit/src/org/eclipse/jgit/lib/GpgConfig.java

/*
 * 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 <code>null</code>)
	 */
	public String getSigningKey() {
		return signingKey;
	}

	/**
	 * Retrieves the config value of commit.gpgSign.
	 *
	 * @return the value of commit.gpgSign (defaults to <code>false</code>)
	 */
	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;
	}
}