X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=lib%2FcreaDevManagerLib%2FmodelCDMPackage.h;h=05e24739014b69c8752d840ec9e57bb4a9b8b63d;hb=94511d0d24fe76a082b14afeab79bcaf0d1ecf13;hp=a644aae99b3c35ce788fadd1efbbe71a3035517c;hpb=62dfbfc86db5ed98a2272d0b6620af1711791c27;p=crea.git

diff --git a/lib/creaDevManagerLib/modelCDMPackage.h b/lib/creaDevManagerLib/modelCDMPackage.h
index a644aae..05e2473 100644
--- a/lib/creaDevManagerLib/modelCDMPackage.h
+++ b/lib/creaDevManagerLib/modelCDMPackage.h
@@ -37,46 +37,155 @@
 
 #include<iostream>
 #include<vector>
+#include<map>
 
-#include"modelCDMIProjectTreeNode.h"
-#include"modelCDMBlackBox.h"
+#include"modelCDMFolder.h"
+#include"modelCDMPackageSrc.h"
 
-class modelCDMPackage : public modelCDMIProjectTreeNode
+/**
+ * Class representing a package of a Crea project.
+ */
+class modelCDMPackage : public modelCDMFolder
 {
 public:
+  /**
+   * Default constructor.
+   */
   modelCDMPackage();
-  modelCDMPackage(const std::string& path, const int& level = 1);
+  /**
+   * Package node constructor.
+   * @param parent Parent node of the package folder node.
+   * @param path Full path to the package.
+   * @param name Name of the package folder.
+   * @param level Project hierarchy level of the package node.
+   */
+  modelCDMPackage(modelCDMIProjectTreeNode* parent, const std::string& path, const std::string& name, const int& level = 1);
+  /**
+   * Destructor.
+   */
   ~modelCDMPackage();
 
+  /**
+   * Retrieves the name of the package. the name of the package can be different from the package folder name.
+   * @return Package name.
+   */
   const std::string& GetNamePackage() const;
+  /**
+   * Retrieves the authors of the package.
+   * @return Package authors.
+   */
   const std::string& GetAuthors() const;
+  /**
+   * Retrieves the Author e-mails of the package.
+   * @return Author e-mails.
+   */
   const std::string& GetAuthorsEmail() const;
+  /**
+   * Retrieves the version of the package.
+   * @return Package version.
+   */
   const std::string& GetVersion() const;
+  /**
+   * Retrieves the description of the package.
+   * @return Package description
+   */
   const std::string& GetDescription() const;
+  /**
+   * Retrieves the src folder node of the package node.
+   * @return Reference to the package src file node.
+   */
+  modelCDMPackageSrc* GetSrc() const;
 
+  /**
+   * Sets the name of the package authors. This operation affects the project model as well as the system files.
+   * @param authors Name of the package authors.
+   * @param result Result message
+   * @return True if the operation was successful.
+   */
   bool SetAuthors(const std::string& authors, std::string*& result);
+  /**
+   * Sets the email of the package authors. This operation affects the project model as well as the system files.
+   * @param email
+   * @param result Result message
+   * @return True if the operation was successful.
+   */
   bool SetAuthorsEmail(const std::string& email, std::string*& result);
+  /**
+   * Sets the version of the package. This operation affects the project model as well as the system files.
+   * @param version
+   * @param result Result message
+   * @return True if the operation was successful.
+   */
   bool SetVersion(const std::string& version, std::string*& result);
+  /**
+   * Sets the description of the package. This operation affects the project model as well as the system files.
+   * @param description
+   * @param result Result message
+   * @return True if the operation was successful.
+   */
   bool SetDescription(const std::string& description, std::string*& result);
 
 
-  bool CreateBlackBox(
+  /**
+   * Creates a new black box and returns a reference to it if the creation is successful. This operation affects the project model as well as the system files.
+   * @param result Result message
+   * @param name New black box name.
+   * @param type Black box type.
+   * @param format Black box format.
+   * @param categories Categories associated to this black box.
+   * @param authors Black box authors' name.
+   * @param authorsEmail Black box authors' email.
+   * @param description Black box description.
+   * @return True if the operation was successful.
+   */
+  modelCDMBlackBox* CreateBlackBox(
+      std::string*& result,
       const std::string& name,
+      const std::string& type = "std",
+      const std::string& format = "C++",
+      const std::string& categories = "empty",
       const std::string& authors = "unknown",
       const std::string& authorsEmail = "",
-      const std::string& categories = "empty",
       const std::string& description = "no description"
   );
-  bool OpenCMakeListsFile(std::string*& result);
+  /**
+   * Refreshes the structure of the package folder node. This method updates the properties of the package as well as it refreshes its children.
+   * @param result Result message
+   * @return True if the operation was successful.
+   */
   virtual const bool Refresh(std::string*& result);
 
+  /**
+   * Checks the package structure with the CMakeLists file to look for project structure definition problems before compiling the project.
+   * @param properties Project properties.
+   */
+  void CheckStructure(std::map<std::string, bool>& properties);
+
 private:
+  /**
+   * Package name.
+   */
   std::string namePackage;
+  /**
+   * Package authors' name.
+   */
   std::string authors;
+  /**
+   * Package authors' e-mails.
+   */
   std::string authorsEmail;
+  /**
+   * Package version.
+   */
   std::string version;
+  /**
+   * Package description.
+   */
   std::string description;
-  std::vector<modelCDMBlackBox*> applications;
+  /**
+   * Reference to the package source folder.
+   */
+  modelCDMPackageSrc* src;
 
 };