task.hpp 8.9 KB

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