task.hpp 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294
  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. static constexpr const char* INTEGER = "Integer";
  39. } // namespace Type
  40. namespace VariantIndex {
  41. static const uint8_t BOOLEAN = 0;
  42. static const uint8_t INTEGER = 1;
  43. static const uint8_t STRVEC = 2;
  44. static const uint8_t QSTRING = 3;
  45. static const uint8_t FILEVEC = 4;
  46. } // namespace VariantIndex
  47. inline bool isIndex(uint8_t v, uint8_t i) { return v == i; }
  48. /**
  49. * Forward Declarations
  50. */
  51. class TaskArgumentBase;
  52. class Task;
  53. /**
  54. * Aliases
  55. */
  56. using TaskQueue = QQueue<Task*>;
  57. using ArgumentType = const char*;
  58. using ArgumentValues = QVector<QString>;
  59. using TypeVariant = std::variant<bool, int, QVector<QString>, QString, QVector<KFileData>>;
  60. using TaskIterator = std::vector<TaskArgumentBase*>::iterator;
  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() = 0;
  69. virtual TypeVariant getValue() = 0;
  70. virtual void insert(QString value) = 0;
  71. virtual void insert(KFileData file) = 0;
  72. virtual void remove(TypeVariant value) = 0;
  73. virtual void setValue(TypeVariant v) = 0;
  74. virtual bool isContainer() = 0;
  75. virtual void clear() = 0;
  76. };
  77. /**
  78. * TaskArgument
  79. *
  80. * A templated class providing a generic way for handling arguments whose types can be one from the set defined
  81. * by our TypeVariant alias
  82. */
  83. class TaskArgument : TaskArgumentBase {
  84. public:
  85. TaskArgument(QString n, ArgumentType t, TypeVariant _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. * Copy Constructor
  100. *
  101. * @constructor
  102. * @param [in] {TaskArgument&&} a The const reference to a TaskArgument
  103. */
  104. TaskArgument(const TaskArgument& a) :
  105. name(std::move(a.name)), type(std::move(a.type)), value(std::move(a.value)) {}
  106. /**
  107. * text
  108. * @returns {QString} The name of the argument
  109. */
  110. virtual const QString text() override { return name; }
  111. /**
  112. * setValue
  113. * @param [in] {TypeVariant} new_value The new value for this argument
  114. */
  115. virtual void setValue(TypeVariant new_value) override {
  116. value = new_value;
  117. }
  118. /**
  119. * @brief getStringValue
  120. * @return [out] {QString}
  121. */
  122. virtual const QString getStringValue() override {
  123. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  124. return std::get<VariantIndex::QSTRING>(value);
  125. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  126. return QString::number(std::get<VariantIndex::BOOLEAN>(value));
  127. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  128. return QString::number(std::get<VariantIndex::INTEGER>(value));
  129. }
  130. return ""; // Throw?
  131. }
  132. /**
  133. * @brief getValue
  134. * @return [out] {TypeVariant}
  135. */
  136. virtual TypeVariant getValue() override {
  137. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  138. return std::get<VariantIndex::QSTRING>(value);
  139. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  140. return std::get<VariantIndex::BOOLEAN>(value);
  141. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  142. return std::get<VariantIndex::INTEGER>(value);
  143. } else if (isIndex(value.index(), VariantIndex::STRVEC)) {
  144. return std::get<VariantIndex::STRVEC>(value);
  145. } else if (isIndex(value.index(), VariantIndex::FILEVEC)) {
  146. return std::get<VariantIndex::FILEVEC>(value);
  147. }
  148. return ""; // Throw?
  149. }
  150. /**
  151. * @brief clear
  152. */
  153. virtual void clear() override {
  154. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  155. std::get<VariantIndex::STRVEC>(value).clear();
  156. } else if (isIndex(value.index(), VariantIndex::FILEVEC)) {
  157. std::get<VariantIndex::FILEVEC>(value).clear();
  158. } else if (isIndex(value.index(), VariantIndex::QSTRING)) {
  159. std::get<VariantIndex::QSTRING>(value).clear();
  160. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  161. std::get<VariantIndex::INTEGER>(value) = 0;
  162. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  163. std::get<VariantIndex::BOOLEAN>(value) = false;
  164. }
  165. }
  166. /**
  167. * @brief isContainer
  168. * @return [out] {bool}
  169. */
  170. virtual bool isContainer() override {
  171. return (isIndex(value.index(), VariantIndex::STRVEC) || isIndex(value.index(), VariantIndex::FILEVEC));
  172. }
  173. /**
  174. * @brief insert
  175. * @param value
  176. */
  177. virtual void insert(QString string) override {
  178. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  179. std::get<VariantIndex::STRVEC>(value).push_back(string);
  180. } else {
  181. // Unable to push. Throw?
  182. }
  183. }
  184. /**
  185. * @brief insert
  186. * @param file
  187. */
  188. virtual void insert(KFileData file) override {
  189. if (value.index() == VariantIndex::FILEVEC) {
  190. std::get<VariantIndex::FILEVEC>(value).push_back(file);
  191. } else {
  192. // Unable to push. Throw?
  193. }
  194. }
  195. /**
  196. * @brief remove
  197. * @param value
  198. */
  199. virtual void remove(TypeVariant unwanted_value) override {
  200. if (value.index() == VariantIndex::STRVEC && unwanted_value.index() == VariantIndex::QSTRING) {
  201. auto&& container = std::get<VariantIndex::STRVEC>(value);
  202. auto value_to_remove = std::get<VariantIndex::QSTRING>(unwanted_value);
  203. auto it = std::find_if(container.begin(), container.end(), [&value_to_remove](QString s) {
  204. return (s == value_to_remove);
  205. });
  206. if (it != container.end()) {
  207. container.erase(it);
  208. return;
  209. } else {
  210. throw std::out_of_range("Could not find value requested for removal");
  211. }
  212. } else if (value.index() == VariantIndex::STRVEC && unwanted_value.index() == VariantIndex::FILEVEC) {
  213. auto&& container = std::get<VariantIndex::STRVEC>(value);
  214. auto value_to_remove = std::get<VariantIndex::QSTRING>(unwanted_value);
  215. auto it = std::find_if(container.begin(), container.end(), [&value_to_remove](QString s) {
  216. return (s == value_to_remove);
  217. });
  218. if (it != container.end()) {
  219. container.erase(it);
  220. return;
  221. } else {
  222. throw std::out_of_range("Could not find value requested for removal");
  223. }
  224. }
  225. throw std::invalid_argument("The value provided does not match any existing container");
  226. }
  227. /**
  228. * @brief getTypeIndex
  229. * @return
  230. */
  231. virtual uint8_t getTypeIndex() override {
  232. return value.index();
  233. }
  234. private:
  235. QString name;
  236. ArgumentType type;
  237. TypeVariant value;
  238. };
  239. using TaskArguments = std::vector<TaskArgument*>;
  240. /**
  241. * The interface expected to be implemented in all Task types
  242. */
  243. class Task {
  244. public:
  245. Task(){};
  246. Task(KFileData);
  247. Task(QVector<KFileData>);
  248. virtual void setArgument(QString name, TypeVariant arg) = 0;
  249. virtual void addArgument(QString name, Scheduler::KFileData file) = 0;
  250. virtual void addArgument(QString name, QString string) = 0;
  251. virtual void removeArgument(QString name, TypeVariant arg) = 0;
  252. virtual const TaskArguments&& getTaskArguments() = 0;
  253. virtual TaskArgument&& getTaskArgument(QString name) = 0;
  254. virtual const TypeVariant getTaskArgumentValue(QString name) = 0;
  255. virtual ArgumentValues getArgumentValues() = 0;
  256. virtual QVector<QString> getArgumentNames() = 0;
  257. virtual TaskType getType() = 0;
  258. virtual void defineTaskArguments() = 0;
  259. virtual void setDefaultValues() = 0;
  260. virtual const QVector<KFileData> getFiles() = 0;
  261. virtual bool hasFiles() = 0;
  262. virtual bool isReady() = 0;
  263. virtual void clear() = 0;
  264. virtual ~Task(){};
  265. };
  266. } // namespace Scheduler
  267. #endif // __TASK_HPP__