diff options
author | Ingo Klöcker <[email protected]> | 2023-12-21 08:38:52 +0000 |
---|---|---|
committer | Ingo Klöcker <[email protected]> | 2023-12-21 10:49:23 +0000 |
commit | a44d84772d6197dfb977b411f6eb7cb29b08471b (patch) | |
tree | d3b679026236ab83faabc36b94a466b6787f593d /lang/qt/src/signjob.h | |
parent | qt: Remove dead code (diff) | |
download | gpgme-a44d84772d6197dfb977b411f6eb7cb29b08471b.tar.gz gpgme-a44d84772d6197dfb977b411f6eb7cb29b08471b.zip |
qt: Support writing/reading signed/encrypted files directly to/from file
* lang/qt/src/Makefile.am: Add new files.
* lang/qt/src/job.cpp (EncryptJob, SignJob, SignEncryptJob): Move
definition of constructor and destructor and inclusion of the moc file
to the corresponding .cpp files.
* lang/qt/src/encryptjob.cpp (EncryptJob): Define constructor. Define
destructor as default. Include moc file.
* lang/qt/src/encryptjob.cpp, lang/qt/src/encryptjob.h (EncryptJob):
Add member functions setRecipients, recipients, setInputFile, inputFile,
setOutputFile, outputFile, setEncryptionFlags, encryptionFlags.
* lang/qt/src/encryptjob_p.h (EncryptJobPrivate): Add members
m_recipients, m_inputFilePath, m_outputFilePath, m_encryptionFlags.
* lang/qt/src/qgpgmeencryptjob.cpp (encrypt_to_filename): New.
(QGpgMEEncryptJobPrivate::startIt): Start the job with the values
from the member variables.
* lang/qt/src/qgpgmesignencryptjob.cpp (sign_encrypt_to_filename): New.
(QGpgMESignEncryptJobPrivate::startIt): Start the job with the values
from the member variables.
* lang/qt/src/qgpgmesignjob.cpp (class QGpgMESignJobPrivate): New.
(QGpgMESignJob::QGpgMESignJob): Instantiate private job class.
(sign_to_filename): New.
* lang/qt/src/signencryptjob.cpp (SignEncryptJob): Define constructor.
Define destructor as default. Include moc file.
* lang/qt/src/signencryptjob.cpp, lang/qt/src/signencryptjob.h
(SignEncryptJob): Add member functions setSigners, signers,
setRecipients, recipients, setInputFile, inputFile, setOutputFile,
outputFile, setEncryptionFlags, encryptionFlags.
* lang/qt/src/signencryptjob_p.h (SignEncryptJobPrivate): Add members
m_signers, m_recipients, m_inputFilePath, m_outputFilePath,
m_encryptionFlags.
* lang/qt/src/signjob.cpp: New.
* lang/qt/src/signjob.h (SignJob): Add member functions setSigners,
signers, setInputFile, inputFile, setOutputFile, outputFile,
setSigningFlags, signingFlags.
* lang/qt/src/signjob_p.h: New.
* lang/qt/tests/Makefile.am: Add new test programs.
* lang/qt/tests/run-encryptjob.cpp: New.
* lang/qt/tests/run-signjob.cpp: New.
--
This makes it possible to tell gpg to read the input and write the
output directly to a specified file bypassing GpgME's Data IO when
signing and/or encrypting a file.
GnuPG-bug-id: 6550
Diffstat (limited to 'lang/qt/src/signjob.h')
-rw-r--r-- | lang/qt/src/signjob.h | 50 |
1 files changed, 49 insertions, 1 deletions
diff --git a/lang/qt/src/signjob.h b/lang/qt/src/signjob.h index c05231cc..273277b5 100644 --- a/lang/qt/src/signjob.h +++ b/lang/qt/src/signjob.h @@ -70,6 +70,15 @@ namespace QGpgME will have scheduled it's own destruction with a call to QObject::deleteLater(). + Alternatively, the job can be started with startIt() after setting + an input file and an output file and, optionally, signers or flags. + If the job is started this way then the backend reads the input and + writes the output directly from/to the specified input file and output + file. In this case the signature value of the result signal will always + be empty. This direct IO mode is currently only supported for OpenPGP. + Note that startIt() does not schedule the job's destruction if starting + the job failed. + After result() is emitted, the SignJob will schedule it's own destruction by calling QObject::deleteLater(). */ @@ -79,7 +88,46 @@ class QGPGME_EXPORT SignJob : public Job protected: explicit SignJob(QObject *parent); public: - ~SignJob(); + ~SignJob() override; + + /** + * Sets the keys to use for signing. + * + * Used if the job is started with startIt(). + */ + void setSigners(const std::vector<GpgME::Key> &signers); + std::vector<GpgME::Key> signers() const; + + /** + * Sets the path of the file to sign. + * + * Used if the job is started with startIt(). + */ + void setInputFile(const QString &path); + QString inputFile() const; + + /** + * Sets the path of the file to write the signing result to. + * + * Used if the job is started with startIt(). + * + * \note If a file with this path exists, then the job will fail, i.e. you + * need to delete an existing file that shall be overwritten before you + * start the job. + */ + void setOutputFile(const QString &path); + QString outputFile() const; + + /** + * Sets the flags to use for signing. + * + * Defaults to \c SignFile. + * + * Used if the job is started with startIt(). The \c SignFile flag is + * always assumed set. + */ + void setSigningFlags(GpgME::SignatureMode flags); + GpgME::SignatureMode signingFlags() const; /** Starts the signing operation. \a signers is the list of keys to |