mirror of
https://bitbucket.org/smil3y/kde-extraapps.git
synced 2025-02-24 02:42:52 +00:00
129 lines
3.9 KiB
C++
129 lines
3.9 KiB
C++
/*
|
|
* Copyright (C) 2008,2009,2010 Rolf Eike Beer <kde@opensource.sf-tec.de>
|
|
*/
|
|
|
|
/***************************************************************************
|
|
* *
|
|
* This program 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 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
***************************************************************************/
|
|
|
|
#ifndef KGPGIMPORT_H
|
|
#define KGPGIMPORT_H
|
|
|
|
#include <QObject>
|
|
#include <QList>
|
|
#include <QString>
|
|
#include <QStringList>
|
|
|
|
#include <KUrl>
|
|
|
|
#include "kgpgtextorfiletransaction.h"
|
|
|
|
class KGpgItemModel;
|
|
|
|
/**
|
|
* @brief import one or more keys into the keyring
|
|
*/
|
|
class KGpgImport: public KGpgTextOrFileTransaction {
|
|
Q_OBJECT
|
|
|
|
Q_DISABLE_COPY(KGpgImport)
|
|
public:
|
|
/**
|
|
* @brief import given text
|
|
* @param parent parent object
|
|
* @param text key text to import
|
|
*/
|
|
explicit KGpgImport(QObject *parent, const QString &text = QString());
|
|
|
|
/**
|
|
* @brief import key(s) from file(s)
|
|
* @param parent parent object
|
|
* @param files list of file locations to import from
|
|
*/
|
|
KGpgImport(QObject *parent, const KUrl::List &files);
|
|
|
|
/**
|
|
* @brief destructor
|
|
*/
|
|
virtual ~KGpgImport();
|
|
|
|
/**
|
|
* @brief get the names and short fingerprints of the imported keys
|
|
* @return list of keys that were imported
|
|
*/
|
|
QStringList getImportedKeys() const;
|
|
|
|
/**
|
|
* @brief get the full fingerprints of the imported keys
|
|
* @param log transaction log to scan
|
|
* @param reason key import reason
|
|
* @return list of ids that were imported
|
|
*
|
|
* You can filter the list of keys returned by the status of that key
|
|
* as reported by GnuPG. See doc/DETAILS of GnuPG for the meaning of
|
|
* the different flags.
|
|
*
|
|
* If reason is -1 (the default) all processed key ids are returned.
|
|
* If reason is 0 only keys of status 0 (unchanged) are returned. For
|
|
* any other value a key is returned if one of his status bits matched
|
|
* one of the bits in reason (i.e. (reason & status) != 0).
|
|
*/
|
|
static QStringList getImportedIds(const QStringList &log, const int reason = -1);
|
|
/**
|
|
* @brief get the full fingerprints of the imported keys
|
|
*
|
|
* This is an overloaded member. It calls the static function with the
|
|
* result log from this transaction object.
|
|
*/
|
|
QStringList getImportedIds(const int reason = -1) const;
|
|
|
|
/**
|
|
* @brief get textual summary of the import events
|
|
* @return messages describing what was imported
|
|
*
|
|
* This is an overloaded member. It calls the static function with the
|
|
* result log from this transaction object.
|
|
*/
|
|
QString getImportMessage() const;
|
|
|
|
/**
|
|
* @brief get textual summary of the import events
|
|
* @param log import log
|
|
* @return messages describing what was imported
|
|
*
|
|
* The log must contain a "IMPORT_RES" line. If this is not present
|
|
* the result string will contain an error message.
|
|
*/
|
|
static QString getImportMessage(const QStringList &log);
|
|
|
|
/**
|
|
* @brief get detailed summary of import
|
|
* @param log import log
|
|
* @return message describing which keys changed and how
|
|
*
|
|
* The log must contain a "IMPORT_RES" line. If this is not present
|
|
* the result string will contain an error message.
|
|
*/
|
|
static QString getDetailedImportMessage(const QStringList &log, const KGpgItemModel *model = NULL);
|
|
|
|
/**
|
|
* @brief check if the given text contains a private or public key
|
|
* @param text text to check
|
|
* @param incomplete assume text is only the beginning of the data
|
|
* @return if text contains a key or not
|
|
* @retval 0 no key found
|
|
* @retval 1 public key found
|
|
* @retval 2 private key found
|
|
*/
|
|
static int isKey(const QString &text, const bool incomplete = false);
|
|
|
|
protected:
|
|
virtual QStringList command() const;
|
|
};
|
|
|
|
#endif // KGPGIMPORT_H
|