task.hpp 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234
  1. #ifndef __TASK_HPP__
  2. #define __TASK_HPP__
  3. #include <QQueue>
  4. #include <QString>
  5. #include <QVector>
  6. #include <memory>
  7. #include <variant>
  8. #include <vector>
  9. namespace Scheduler {
  10. enum TaskType { INSTAGRAM = 1, OTHER = 2 };
  11. /**
  12. * Files
  13. */
  14. enum FileType { VIDEO = 1, IMAGE = 2 };
  15. /**
  16. * KFileData
  17. *
  18. * Structure for holding file bytes and metadata
  19. */
  20. struct KFileData {
  21. QString name;
  22. FileType type;
  23. QString path;
  24. QByteArray bytes;
  25. };
  26. /**
  27. * Type namespace
  28. *
  29. * Describes the types of task arguments available for use
  30. */
  31. namespace Type {
  32. static constexpr const char* TEXT = "Text";
  33. static constexpr const char* FILE = "File";
  34. static constexpr const char* STRINGVECTOR = "StringVector";
  35. static constexpr const char* FILEVECTOR = "FileVector";
  36. static constexpr const char* DATETIME = "DateTime";
  37. static constexpr const char* BOOLEAN = "Boolean";
  38. } // namespace Type
  39. namespace VariantIndex {
  40. static const uint8_t BOOLEAN = 0;
  41. static const uint8_t INTEGER = 1;
  42. static const uint8_t QSTRING = 2;
  43. static const uint8_t STRVEC = 3;
  44. static const uint8_t FILEVEC = 4;
  45. } // namespace VariantIndex
  46. inline bool isIndex(uint8_t v, uint8_t i) { return v == i; }
  47. /**
  48. * Forward Declarations
  49. */
  50. class TaskArgumentBase;
  51. class Task;
  52. /**
  53. * Aliases
  54. */
  55. using TaskQueue = QQueue<Task*>;
  56. using ArgumentType = const char*;
  57. using ArgumentValues = QVector<const QString>;
  58. using TypeVariant = std::variant<bool, int, QString, QVector<QString>, QVector<KFileData>>;
  59. using TaskIterator = std::vector<std::unique_ptr<TaskArgumentBase>>::iterator;
  60. using TaskArguments = std::vector<std::unique_ptr<TaskArgumentBase>>;
  61. /**
  62. * The interface expected on our Task Arguments
  63. */
  64. class TaskArgumentBase {
  65. public:
  66. virtual const QString text() = 0;
  67. virtual const QString getStringValue() = 0;
  68. virtual uint8_t getTypeIndex();
  69. virtual TypeVariant getValue() = 0;
  70. virtual void insert(QString value) = 0;
  71. virtual void insert(KFileData file) = 0;
  72. virtual void setValue(TypeVariant v) = 0;
  73. virtual bool isContainer() = 0;
  74. virtual void clear() = 0;
  75. };
  76. /**
  77. * TaskArgument
  78. *
  79. * A templated class providing a generic way for handling arguments whose types can be one from the set defined
  80. * by our TypeVariant alias
  81. */
  82. template <typename T = TypeVariant>
  83. class TaskArgument : TaskArgumentBase {
  84. public:
  85. TaskArgument(QString n, ArgumentType t, T _value) {
  86. name = n;
  87. type = t;
  88. value = _value;
  89. }
  90. /**
  91. * Move Constructor
  92. *
  93. * @constructor
  94. * @param [in] {TaskArgument&&} a The R-value reference to a TaskArgument
  95. */
  96. TaskArgument(TaskArgument&& a) :
  97. name(std::move(a.name)), type(std::move(a.type)), value(std::move(a.value)) {}
  98. /**
  99. * text
  100. * @returns {QString} The name of the argument
  101. */
  102. virtual const QString text() { return name; }
  103. /**
  104. * setValue
  105. * @param [in] {TypeVariant} new_value The new value for this argument
  106. */
  107. virtual void setValue(TypeVariant new_value) override { value = new_value; }
  108. /**
  109. * @brief getStringValue
  110. * @return [out] {QString}
  111. */
  112. virtual const QString getStringValue() override {
  113. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  114. return std::get<VariantIndex::QSTRING>(value);
  115. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  116. return QString::number(std::get<VariantIndex::BOOLEAN>(value));
  117. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  118. return QString::number(std::get<VariantIndex::INTEGER>(value));
  119. }
  120. }
  121. /**
  122. * @brief getValue
  123. * @return [out] {TypeVariant}
  124. */
  125. virtual TypeVariant getValue() override {
  126. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  127. return std::get<VariantIndex::QSTRING>(value);
  128. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  129. return std::get<VariantIndex::BOOLEAN>(value);
  130. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  131. return std::get<VariantIndex::INTEGER>(value);
  132. }
  133. }
  134. /**
  135. * @brief clear
  136. */
  137. virtual void clear() override {
  138. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  139. std::get<VariantIndex::STRVEC>(value).clear();
  140. } else if (isIndex(value.index(), VariantIndex::FILEVEC)) {
  141. std::get<VariantIndex::FILEVEC>(value).clear();
  142. } else if (isIndex(value.index(), VariantIndex::QSTRING)) {
  143. std::get<VariantIndex::QSTRING>(value).clear();
  144. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  145. std::get<VariantIndex::INTEGER>(value) = 0;
  146. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  147. std::get<VariantIndex::BOOLEAN>(value) = false;
  148. }
  149. }
  150. /**
  151. * @brief isContainer
  152. * @return [out] {bool}
  153. */
  154. virtual bool isContainer() override {
  155. return (isIndex(value.index(), VariantIndex::STRVEC) || isIndex(value.index(), VariantIndex::FILEVEC));
  156. }
  157. /**
  158. * @brief insert
  159. * @param value
  160. */
  161. virtual void insert(QString value) override {
  162. }
  163. /**
  164. * @brief insert
  165. * @param file
  166. */
  167. virtual void insert(KFileData file) override {
  168. if (value.index() == VariantIndex::FILEVEC) {
  169. std::get<VariantIndex::FILEVEC>(value).push_back(file);
  170. }
  171. }
  172. /**
  173. * @brief getTypeIndex
  174. * @return
  175. */
  176. virtual uint8_t getTypeIndex() override {
  177. return value.index();
  178. }
  179. private:
  180. QString name;
  181. ArgumentType type;
  182. TypeVariant value;
  183. };
  184. /**
  185. * The interface expected to be implemented in all Task types
  186. */
  187. class Task {
  188. public:
  189. Task(){};
  190. Task(KFileData);
  191. Task(QVector<KFileData>);
  192. virtual void setArgument(QString name, TypeVariant arg) = 0;
  193. virtual void setArgument(QString name, Scheduler::KFileData file) = 0;
  194. virtual const TaskArguments getTaskArguments() = 0;
  195. virtual TypeVariant getTaskArgument(QString name) = 0;
  196. virtual ArgumentValues getArgumentValues() = 0;
  197. virtual TaskType getType() = 0;
  198. virtual void defineTaskArguments() = 0;
  199. virtual void setDefaultValues() = 0;
  200. virtual const QVector<KFileData> getFiles() = 0;
  201. virtual void addFile(KFileData file) = 0;
  202. virtual bool hasFiles() = 0;
  203. virtual bool isReady() = 0;
  204. virtual void clear() = 0;
  205. virtual ~Task(){};
  206. };
  207. } // namespace Scheduler
  208. #endif // __TASK_HPP__