task.hpp 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241
  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<QString>;
  58. using TypeVariant = std::variant<bool, int, QString, QVector<QString>, QVector<KFileData>>;
  59. using TaskIterator = std::vector<std::unique_ptr<TaskArgumentBase>>::iterator;
  60. /**
  61. * The interface expected on our Task Arguments
  62. */
  63. class TaskArgumentBase {
  64. public:
  65. virtual const QString text() = 0;
  66. virtual const QString getStringValue() = 0;
  67. virtual uint8_t getTypeIndex();
  68. virtual TypeVariant getValue() = 0;
  69. virtual void insert(QString value) = 0;
  70. virtual void insert(KFileData file) = 0;
  71. virtual void setValue(TypeVariant v) = 0;
  72. virtual bool isContainer() = 0;
  73. virtual void clear() = 0;
  74. };
  75. /**
  76. * TaskArgument
  77. *
  78. * A templated class providing a generic way for handling arguments whose types can be one from the set defined
  79. * by our TypeVariant alias
  80. */
  81. class TaskArgument : TaskArgumentBase {
  82. public:
  83. TaskArgument(QString n, ArgumentType t, TypeVariant _value) {
  84. name = n;
  85. type = t;
  86. value = _value;
  87. }
  88. /**
  89. * Move Constructor
  90. *
  91. * @constructor
  92. * @param [in] {TaskArgument&&} a The R-value reference to a TaskArgument
  93. */
  94. TaskArgument(TaskArgument&& a) :
  95. name(std::move(a.name)), type(std::move(a.type)), value(std::move(a.value)) {}
  96. /**
  97. * text
  98. * @returns {QString} The name of the argument
  99. */
  100. virtual const QString text() override { return name; }
  101. /**
  102. * setValue
  103. * @param [in] {TypeVariant} new_value The new value for this argument
  104. */
  105. virtual void setValue(TypeVariant new_value) override { value = new_value; }
  106. /**
  107. * @brief getStringValue
  108. * @return [out] {QString}
  109. */
  110. virtual const QString getStringValue() override {
  111. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  112. return std::get<VariantIndex::QSTRING>(value);
  113. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  114. return QString::number(std::get<VariantIndex::BOOLEAN>(value));
  115. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  116. return QString::number(std::get<VariantIndex::INTEGER>(value));
  117. }
  118. return "";
  119. }
  120. /**
  121. * @brief getValue
  122. * @return [out] {TypeVariant}
  123. */
  124. virtual TypeVariant getValue() override {
  125. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  126. return std::get<VariantIndex::QSTRING>(value);
  127. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  128. return std::get<VariantIndex::BOOLEAN>(value);
  129. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  130. return std::get<VariantIndex::INTEGER>(value);
  131. }
  132. }
  133. /**
  134. * @brief clear
  135. */
  136. virtual void clear() override {
  137. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  138. std::get<VariantIndex::STRVEC>(value).clear();
  139. } else if (isIndex(value.index(), VariantIndex::FILEVEC)) {
  140. std::get<VariantIndex::FILEVEC>(value).clear();
  141. } else if (isIndex(value.index(), VariantIndex::QSTRING)) {
  142. std::get<VariantIndex::QSTRING>(value).clear();
  143. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  144. std::get<VariantIndex::INTEGER>(value) = 0;
  145. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  146. std::get<VariantIndex::BOOLEAN>(value) = false;
  147. }
  148. }
  149. /**
  150. * @brief isContainer
  151. * @return [out] {bool}
  152. */
  153. virtual bool isContainer() override {
  154. return (isIndex(value.index(), VariantIndex::STRVEC) || isIndex(value.index(), VariantIndex::FILEVEC));
  155. }
  156. /**
  157. * @brief insert
  158. * @param value
  159. */
  160. virtual void insert(QString string) override {
  161. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  162. std::get<VariantIndex::STRVEC>(value).push_back(string);
  163. } else {
  164. // Unable to push. Throw?
  165. }
  166. }
  167. /**
  168. * @brief insert
  169. * @param file
  170. */
  171. virtual void insert(KFileData file) override {
  172. if (value.index() == VariantIndex::FILEVEC) {
  173. std::get<VariantIndex::FILEVEC>(value).push_back(file);
  174. } else {
  175. // Unable to push. Throw?
  176. }
  177. }
  178. /**
  179. * @brief getTypeIndex
  180. * @return
  181. */
  182. virtual uint8_t getTypeIndex() override {
  183. return value.index();
  184. }
  185. private:
  186. QString name;
  187. ArgumentType type;
  188. TypeVariant value;
  189. };
  190. using TaskArguments = std::vector<std::unique_ptr<TaskArgument>>;
  191. /**
  192. * The interface expected to be implemented in all Task types
  193. */
  194. class Task {
  195. public:
  196. Task(){};
  197. Task(KFileData);
  198. Task(QVector<KFileData>);
  199. virtual void setArgument(QString name, TypeVariant arg) = 0;
  200. virtual void addArgument(QString name, Scheduler::KFileData file) = 0;
  201. virtual void addArgument(QString name, QString string) = 0;
  202. virtual const TaskArguments getTaskArguments() = 0;
  203. virtual const TypeVariant getTaskArgument(QString name) = 0;
  204. virtual ArgumentValues getArgumentValues() = 0;
  205. virtual TaskType getType() = 0;
  206. virtual void defineTaskArguments() = 0;
  207. virtual void setDefaultValues() = 0;
  208. virtual const QVector<KFileData> getFiles() = 0;
  209. virtual void addFile(KFileData file) = 0;
  210. virtual bool hasFiles() = 0;
  211. virtual bool isReady() = 0;
  212. virtual void clear() = 0;
  213. virtual ~Task(){};
  214. };
  215. } // namespace Scheduler
  216. #endif // __TASK_HPP__