task.hpp 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298
  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, GENERIC = 2, OTHER = 3 };
  11. static constexpr const char* INSTAGRAM_NAME = "Instagram";
  12. /**
  13. * Files
  14. */
  15. enum FileType { VIDEO = 1, IMAGE = 2 };
  16. /**
  17. * KFileData
  18. *
  19. * Structure for holding file bytes and metadata
  20. */
  21. struct KFileData {
  22. QString name;
  23. FileType type;
  24. QString path;
  25. QByteArray bytes;
  26. };
  27. /**
  28. * Type namespace
  29. *
  30. * Describes the types of task arguments available for use
  31. */
  32. namespace Type {
  33. static constexpr const char* TEXT = "Text";
  34. static constexpr const char* FILE = "File";
  35. static constexpr const char* STRINGVECTOR = "StringVector";
  36. static constexpr const char* FILEVECTOR = "FileVector";
  37. static constexpr const char* DATETIME = "DateTime";
  38. static constexpr const char* BOOLEAN = "Boolean";
  39. static constexpr const char* INTEGER = "Integer";
  40. } // namespace Type
  41. namespace VariantIndex {
  42. static const uint8_t BOOLEAN = 0;
  43. static const uint8_t INTEGER = 1;
  44. static const uint8_t STRVEC = 2;
  45. static const uint8_t QSTRING = 3;
  46. static const uint8_t FILEVEC = 4;
  47. } // namespace VariantIndex
  48. inline bool isIndex(uint8_t v, uint8_t i) { return v == i; }
  49. /**
  50. * Forward Declarations
  51. */
  52. class TaskArgumentBase;
  53. class Task;
  54. /**
  55. * Aliases
  56. */
  57. using TaskQueue = QQueue<Task*>;
  58. using ArgumentType = const char*;
  59. using ArgumentValues = QVector<QString>;
  60. using TypeVariant = std::variant<bool, int, QVector<QString>, QString, QVector<KFileData>>;
  61. using TaskIterator = std::vector<TaskArgumentBase*>::iterator;
  62. /**
  63. * The interface expected on our Task Arguments
  64. */
  65. class TaskArgumentBase {
  66. public:
  67. virtual const QString text() = 0;
  68. virtual const QString getStringValue() = 0;
  69. virtual uint8_t getTypeIndex() = 0;
  70. virtual TypeVariant getValue() = 0;
  71. virtual void insert(QString value) = 0;
  72. virtual void insert(KFileData file) = 0;
  73. virtual void remove(TypeVariant value) = 0;
  74. virtual void setValue(TypeVariant v) = 0;
  75. virtual bool isContainer() = 0;
  76. virtual void clear() = 0;
  77. };
  78. /**
  79. * TaskArgument
  80. *
  81. * A templated class providing a generic way for handling arguments whose types can be one from the set defined
  82. * by our TypeVariant alias
  83. */
  84. class TaskArgument : TaskArgumentBase {
  85. public:
  86. TaskArgument(QString n, ArgumentType t, TypeVariant _value) {
  87. auto index = _value.index();
  88. name = n;
  89. type = t;
  90. value = _value;
  91. }
  92. /**
  93. * Move Constructor
  94. *
  95. * @constructor
  96. * @param [in] {TaskArgument&&} a The R-value reference to a TaskArgument
  97. */
  98. TaskArgument(TaskArgument&& a) :
  99. name(std::move(a.name)), type(std::move(a.type)), value(std::move(a.value)) {}
  100. /**
  101. * Copy Constructor
  102. *
  103. * @constructor
  104. * @param [in] {TaskArgument&&} a The const reference to a TaskArgument
  105. */
  106. TaskArgument(const TaskArgument& a) :
  107. name(std::move(a.name)), type(std::move(a.type)), value(std::move(a.value)) {}
  108. /**
  109. * text
  110. * @returns {QString} The name of the argument
  111. */
  112. virtual const QString text() override { return name; }
  113. /**
  114. * setValue
  115. * @param [in] {TypeVariant} new_value The new value for this argument
  116. */
  117. virtual void setValue(TypeVariant new_value) override {
  118. value = new_value;
  119. }
  120. /**
  121. * @brief getStringValue
  122. * @return [out] {QString}
  123. */
  124. virtual const QString getStringValue() 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 QString::number(std::get<VariantIndex::BOOLEAN>(value));
  129. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  130. return QString::number(std::get<VariantIndex::INTEGER>(value));
  131. }
  132. return ""; // Throw?
  133. }
  134. /**
  135. * @brief getValue
  136. * @return [out] {TypeVariant}
  137. */
  138. virtual TypeVariant getValue() override {
  139. if (isIndex(value.index(), VariantIndex::QSTRING)) {
  140. return std::get<VariantIndex::QSTRING>(value);
  141. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  142. return std::get<VariantIndex::BOOLEAN>(value);
  143. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  144. return std::get<VariantIndex::INTEGER>(value);
  145. } else if (isIndex(value.index(), VariantIndex::STRVEC)) {
  146. return std::get<VariantIndex::STRVEC>(value);
  147. } else if (isIndex(value.index(), VariantIndex::FILEVEC)) {
  148. return std::get<VariantIndex::FILEVEC>(value);
  149. }
  150. return ""; // Throw?
  151. }
  152. /**
  153. * @brief clear
  154. */
  155. virtual void clear() override {
  156. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  157. std::get<VariantIndex::STRVEC>(value).clear();
  158. } else if (isIndex(value.index(), VariantIndex::FILEVEC)) {
  159. std::get<VariantIndex::FILEVEC>(value).clear();
  160. } else if (isIndex(value.index(), VariantIndex::QSTRING)) {
  161. std::get<VariantIndex::QSTRING>(value).clear();
  162. } else if (isIndex(value.index(), VariantIndex::INTEGER)) {
  163. std::get<VariantIndex::INTEGER>(value) = 0;
  164. } else if (isIndex(value.index(), VariantIndex::BOOLEAN)) {
  165. std::get<VariantIndex::BOOLEAN>(value) = false;
  166. }
  167. }
  168. /**
  169. * @brief isContainer
  170. * @return [out] {bool}
  171. */
  172. virtual bool isContainer() override {
  173. return (isIndex(value.index(), VariantIndex::STRVEC) || isIndex(value.index(), VariantIndex::FILEVEC));
  174. }
  175. /**
  176. * @brief insert
  177. * @param value
  178. */
  179. virtual void insert(QString string) override {
  180. if (isIndex(value.index(), VariantIndex::STRVEC)) {
  181. std::get<VariantIndex::STRVEC>(value).push_back(string);
  182. } else {
  183. // Unable to push. Throw?
  184. }
  185. }
  186. /**
  187. * @brief insert
  188. * @param file
  189. */
  190. virtual void insert(KFileData file) override {
  191. if (value.index() == VariantIndex::FILEVEC) {
  192. std::get<VariantIndex::FILEVEC>(value).push_back(file);
  193. } else {
  194. // Unable to push. Throw?
  195. }
  196. }
  197. /**
  198. * @brief remove
  199. * @param value
  200. */
  201. virtual void remove(TypeVariant unwanted_value) override {
  202. if (value.index() == VariantIndex::STRVEC && unwanted_value.index() == VariantIndex::QSTRING) {
  203. auto&& container = std::get<VariantIndex::STRVEC>(value);
  204. auto value_to_remove = std::get<VariantIndex::QSTRING>(unwanted_value);
  205. auto it = std::find_if(container.begin(), container.end(), [&value_to_remove](QString s) {
  206. return (s == value_to_remove);
  207. });
  208. if (it != container.end()) {
  209. container.erase(it);
  210. return;
  211. } else {
  212. throw std::out_of_range("Could not find value requested for removal");
  213. }
  214. } else if (value.index() == VariantIndex::FILEVEC && unwanted_value.index() == VariantIndex::QSTRING) {
  215. auto&& container = std::get<VariantIndex::FILEVEC>(value);
  216. auto file_to_remove = std::get<VariantIndex::QSTRING>(unwanted_value);
  217. auto it = std::find_if(container.begin(), container.end(), [&file_to_remove](Scheduler::KFileData f) {
  218. return (f.name == file_to_remove);
  219. });
  220. if (it != container.end()) {
  221. container.erase(it);
  222. return;
  223. } else {
  224. throw std::out_of_range("Could not find value requested for removal");
  225. }
  226. }
  227. throw std::invalid_argument("The value provided does not match any existing container");
  228. }
  229. /**
  230. * @brief getTypeIndex
  231. * @return
  232. */
  233. virtual uint8_t getTypeIndex() override {
  234. return value.index();
  235. }
  236. private:
  237. QString name;
  238. ArgumentType type;
  239. TypeVariant value;
  240. };
  241. using TaskArguments = std::vector<TaskArgument*>;
  242. /**
  243. * The interface expected to be implemented in all Task types
  244. */
  245. class Task {
  246. public:
  247. Task(){};
  248. Task(KFileData);
  249. Task(QVector<KFileData>);
  250. virtual void setArgument(QString name, TypeVariant arg) = 0;
  251. virtual void addArgument(QString name, Scheduler::KFileData file) = 0;
  252. virtual void addArgument(QString name, QString string) = 0;
  253. virtual void removeArgument(QString name, TypeVariant arg) = 0;
  254. virtual const TaskArguments&& getTaskArguments() = 0;
  255. virtual TaskArgument&& getTaskArgument(QString name) = 0;
  256. virtual const TypeVariant getTaskArgumentValue(QString name) = 0;
  257. virtual ArgumentValues getArgumentValues() = 0;
  258. virtual QVector<QString> getArgumentNames() = 0;
  259. virtual TaskType getType() = 0;
  260. virtual int getTaskCode() = 0;
  261. virtual void defineTaskArguments() = 0;
  262. virtual void setDefaultValues() = 0;
  263. virtual const QVector<KFileData> getFiles() = 0;
  264. virtual bool hasFiles() = 0;
  265. virtual bool isReady() = 0;
  266. virtual void clear() = 0;
  267. virtual ~Task(){};
  268. };
  269. } // namespace Scheduler
  270. #endif // __TASK_HPP__