2 # ---------------------------------------------------------------------
4 # Copyright (c) CREATIS (Centre de Recherche en Acquisition et Traitement de l'Image
6 # Authors : Eduardo Davila, Frederic Cervenansky, Claire Mouton
7 # Previous Authors : Laurent Guigues, Jean-Pierre Roux
8 # CreaTools website : www.creatis.insa-lyon.fr/site/fr/creatools_accueil
10 # This software is governed by the CeCILL-B license under French law and
11 # abiding by the rules of distribution of free software. You can use,
12 # modify and/ or redistribute the software under the terms of the CeCILL-B
13 # license as circulated by CEA, CNRS and INRIA at the following URL
14 # http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
15 # or in the file LICENSE.txt.
17 # As a counterpart to the access to the source code and rights to copy,
18 # modify and redistribute granted by the license, users are provided only
19 # with a limited warranty and the software's author, the holder of the
20 # economic rights, and the successive licensors have only limited
23 # The fact that you are presently reading this means that you have had
24 # knowledge of the CeCILL-B license and that you accept its terms.
25 # ------------------------------------------------------------------------
31 * Created on: Nov 23, 2012
32 * Author: Daniel Felipe Gonzalez Obando
35 #ifndef CDMUTILITIES_H_
36 #define CDMUTILITIES_H_
42 namespace CDMUtilities
49 static std::string SLASH = "\\";
52 static std::string SLASH = "/";
54 static std::string SLASH = "/";
62 static std::string TEXT_EDITOR = "notepad";
65 //TODO: implementation for apple
67 static std::string TEXT_EDITOR = "gedit";
71 * File explorer program
75 static std::string FILE_EXPLORER = "explorer";
78 //TODO: implementation for apple
80 static std::string FILE_EXPLORER = "nautilus";
88 static std::string TERMINAL = "start cmd.exe";
91 //TODO: implementation for apple
93 static std::string TERMINAL = "gnome-terminal";
102 static std::string BUILD_COMMAND = "make";
106 * Structure that handles the split method for c++
107 * It calls the split method to split a string given certain delimiters.
112 * Enum to allow or not empty resulting strings after performing splits.
114 enum empties_t { empties_ok, no_empties };
116 * Method to split a string given a set of delimiter characters.
117 * @param result Resulting container.
118 * @param s String to be splitted.
119 * @param delimiters Delimiter characters to split the string.
120 * @param empties Either allow or not empty resulting strings after performing split.
121 * @return Resulting container.
123 template <typename Container>
124 static Container& split
127 const typename Container::value_type& s,
128 const typename Container::value_type& delimiters,
129 empties_t empties = empties_ok
137 if (empties == no_empties)
139 next = s.find_first_not_of(delimiters, next + 1);
140 if (next == Container::value_type::npos)
147 next = s.find_first_of(delimiters, current);
148 result.push_back(s.substr(current, next - current));
150 while (next != Container::value_type::npos);
156 * Fixes a given path to avoid double slash directories
157 * @param path Unfixed path.
158 * @return Fixed path.
160 const std::string fixPath(const std::string& path);
163 * Opens the default text editor. If a file is given, then it tries to open the given file.
164 * @param file Full path to the file.
165 * @return True if there was an error on the execution of the operation.
167 int openTextEditor(const std::string& file = "");
169 * Opens the system file explorer on the given file path
170 * @param file Path of the desired folder to open.
171 * @return True if there was an error on the execution of the operation.
173 int openFileExplorer(const std::string& file = "");
175 * Opens a file with a given command.
176 * @param file Full path of the file to open.
177 * @param command Command to execute the file with.
178 * @param parameters Parameters to open file.
179 * @return True if there was an error on the execution of the operation.
181 int openFileWithCommand(const std::string& file, const std::string& command, const std::string& parameters = "");
183 * Opens the BBTK Graphical Editor
184 * @return True if there was an error on the execution of the operation.
188 * Opens the minitools or the creaTools
189 * @return True if there was an error on the execution of the operation.
191 int openCreaToolsTools();
193 * Open a command line interpreter and executes the given command if any.
194 * @param command Command to execute.
195 * @return True if there was an error on the execution of the operation.
197 int openTerminal(const std::string& command = "");
199 * Creates a blank class(.h and .cpp files).
200 * @param name Name of the new class.
201 * @param path Path where the class is to be created.
202 * @return True if the class was successfully created.
204 bool createEmptyClass(const std::string& name, const std::string& path);
206 * Creates a string replacing each \ by double \ .
207 * @param line String to stringify.
208 * @return line stringified.
210 std::string stringify(const std::string& line);
212 //CMakeLists file handling
214 * Type definition for the value of a syntax element for CMakeLists files
216 typedef std::vector<std::string> cmdValue;
219 * Type definition for the type of a syntax element for CMakeLists files
221 typedef std::string cmdType;
224 * Type definition for syntax elements of a CMakeLists file
226 typedef std::pair<cmdType,cmdValue> syntaxElement;
229 * Type definition for describing a CMakeLists file content
231 typedef std::vector<syntaxElement> CMLFile;
234 * Reads a file as string and returns the read data.
235 * @param file_path Full path of the CMakeLists file.
236 * @return A string with the contents of the given file.
238 std::string readFile(const std::string& file_path);
240 * Writes the given string into a file and returns whether the operation is successful.
241 * @param file_path Full path of the CMakeLists file.
242 * @param st string to write.
243 * @return True if the operation was successful.
245 bool writeFile(const std::string& file_path, const std::string& st);
248 * Reads a CMakeLists file and returns the read data.
249 * @param file_path Full path of the CMakeLists file.
250 * @return A CMLFile with the contents of the given file.
252 CMLFile readCMLFile(const std::string& file_path);
255 * Writes the given data into specified CMakeLists file.
256 * @param file_path Full path of the CMakeLists file.
257 * @param data CMakeLists data.
258 * @return True if the operation was successful.
260 bool writeCMLFile(const std::string& file_path, const CMLFile& data);
263 * @param st Strips all space character at the beginning and at the end of the string.
265 void normalizeStr(std::string& st);
269 #endif /* CDMUTILITIES_H_ */