/**
* Copyright (C) 2021 Saturneric
*
* This file is part of GpgFrontend.
*
* GpgFrontend is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* GpgFrontend is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with GpgFrontend. If not, see .
*
* The initial version of the source code is inherited from
* the gpg4usb project, which is under GPL-3.0-or-later.
*
* All the source code of GpgFrontend was modified and released by
* Saturneric starting on May 12, 2021.
*
* SPDX-License-Identifier: GPL-3.0-or-later
*
*/
#ifndef GPGFRONTEND_GPGKEY_H
#define GPGFRONTEND_GPGKEY_H
#include "GpgSubKey.h"
#include "GpgUID.h"
namespace GpgFrontend {
/**
* @brief
*
*/
class GPGFRONTEND_CORE_EXPORT GpgKey {
public:
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsGood() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetId() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetName() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetEmail() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetComment() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetFingerprint() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetProtocol() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetOwnerTrust() const;
/**
* @brief
*
* @return std::string
*/
[[nodiscard]] std::string GetPublicKeyAlgo() const;
/**
* @brief
*
* @return boost::posix_time::ptime
*/
[[nodiscard]] boost::posix_time::ptime GetLastUpdateTime() const;
/**
* @brief
*
* @return boost::posix_time::ptime
*/
[[nodiscard]] boost::posix_time::ptime GetExpireTime() const;
/**
* @brief Create a time object
*
* @return boost::posix_time::ptime
*/
[[nodiscard]] boost::posix_time::ptime GetCreateTime() const;
/**
* @brief s
*
* @return unsigned int
*/
[[nodiscard]] unsigned int GetPrimaryKeyLength() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasEncryptionCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasActualEncryptionCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasSigningCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasActualSigningCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasCertificationCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasActualCertificationCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasAuthenticationCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasActualAuthenticationCapability() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasCardKey() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsPrivateKey() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsExpired() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsRevoked() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsDisabled() const;
/**
* @brief
*
* @return true
* @return false
*/
[[nodiscard]] bool IsHasMasterKey() const;
/**
* @brief
*
* @return std::unique_ptr>
*/
[[nodiscard]] std::unique_ptr> GetSubKeys() const;
/**
* @brief
*
* @return std::unique_ptr>
*/
[[nodiscard]] std::unique_ptr> GetUIDs() const;
/**
* @brief Construct a new Gpg Key object
*
*/
GpgKey() = default;
/**
* @brief Construct a new Gpg Key object
*
* @param key
*/
explicit GpgKey(gpgme_key_t&& key);
/**
* @brief Destroy the Gpg Key objects
*
*/
~GpgKey() = default;
/**
* @brief Construct a new Gpg Key object
*
* @param key
*/
GpgKey(const gpgme_key_t& key) = delete;
/**
* @brief Construct a new Gpg Key object
*
* @param k
*/
GpgKey(GpgKey&& k) noexcept;
/**
* @brief
*
* @param k
* @return GpgKey&
*/
GpgKey& operator=(GpgKey&& k) noexcept;
/**
* @brief
*
* @param key
* @return GpgKey&
*/
GpgKey& operator=(const gpgme_key_t& key) = delete;
/**
* @brief
*
* @param o
* @return true
* @return false
*/
bool operator==(const GpgKey& o) const;
/**
* @brief
*
* @param o
* @return true
* @return false
*/
bool operator<=(const GpgKey& o) const;
/**
* @brief
*
* @return gpgme_key_t
*/
explicit operator gpgme_key_t() const;
/**
* @brief
*
* @return GpgKey
*/
[[nodiscard]] GpgKey Copy() const;
private:
/**
* @brief
*
*/
struct GPGFRONTEND_CORE_EXPORT _key_ref_deleter {
void operator()(gpgme_key_t _key);
};
using KeyRefHandler =
std::unique_ptr; ///<
KeyRefHandler key_ref_ = nullptr; ///<
};
} // namespace GpgFrontend
#endif // GPGFRONTEND_GPGKEY_H