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";
97 * Structure that handles the split method for c++
98 * It calls the split method to split a string given certain delimiters.
103 * Enum to allow or not empty resulting strings after performing splits.
105 enum empties_t { empties_ok, no_empties };
107 * Method to split a string given a set of delimiter characters.
108 * @param result Resulting container.
109 * @param s String to be splitted.
110 * @param delimiters Delimiter characters to split the string.
111 * @param empties Either allow or not empty resulting strings after performing split.
112 * @return Resulting container.
114 template <typename Container>
115 static Container& split
118 const typename Container::value_type& s,
119 const typename Container::value_type& delimiters,
120 empties_t empties = empties_ok
128 if (empties == no_empties)
130 next = s.find_first_not_of(delimiters, next + 1);
131 if (next == Container::value_type::npos)
138 next = s.find_first_of(delimiters, current);
139 result.push_back(s.substr(current, next - current));
141 while (next != Container::value_type::npos);
147 * Fixes a given path to avoid double slash directories
148 * @param path Unfixed path.
149 * @return Fixed path.
151 const std::string fixPath(const std::string& path);
154 * Opens the default text editor. If a file is given, then it tries to open the given file.
155 * @param file Full path to the file.
156 * @return True if there was an error on the execution of the operation.
158 int openTextEditor(const std::string& file = "");
160 * Opens the system file explorer on the given file path
161 * @param file Path of the desired folder to open.
162 * @return True if there was an error on the execution of the operation.
164 int openFileExplorer(const std::string& file = "");
166 * Opens a file with a given command.
167 * @param file Full path of the file to open.
168 * @param command Command to execute the file with.
169 * @return True if there was an error on the execution of the operation.
171 int openFileWithCommand(const std::string& file, const std::string& command);
173 * Opens the BBTK Graphical Editor
174 * @return True if there was an error on the execution of the operation.
178 * Opens the minitools or the creaTools
179 * @return True if there was an error on the execution of the operation.
181 int openCreaToolsTools();
183 * Open a command line interpreter and executes the given command if any.
184 * @param command Command to execute.
185 * @return True if there was an error on the execution of the operation.
187 int openTerminal(const std::string& command = "");
189 * Creates a blank class(.h and .cpp files).
190 * @param name Name of the new class.
191 * @param path Path where the class is to be created.
192 * @return True if the class was successfully created.
194 bool createEmptyClass(const std::string& name, const std::string& path);
196 * Creates a string replacing each \ by double \ .
197 * @param line String to stringify.
198 * @return line stringified.
200 std::string stringify(const std::string& line);
202 //CMakeLists file handling
204 * Type definition for the value of a syntax element for CMakeLists files
206 typedef std::vector<std::string> cmdValue;
209 * Type definition for the type of a syntax element for CMakeLists files
211 typedef std::string cmdType;
214 * Type definition for syntax elements of a CMakeLists file
216 typedef std::pair<cmdType,cmdValue> syntaxElement;
219 * Type definition for describing a CMakeLists file content
221 typedef std::vector<syntaxElement> CMLFile;
224 * Reads a file as string and returns the read data.
225 * @param file_path Full path of the CMakeLists file.
226 * @return A string with the contents of the given file.
228 std::string readFile(const std::string& file_path);
230 * Writes the given string into a file and returns whether the operation is successful.
231 * @param file_path Full path of the CMakeLists file.
232 * @param st string to write.
233 * @return True if the operation was successful.
235 bool writeFile(const std::string& file_path, const std::string& st);
238 * Reads a CMakeLists file and returns the read data.
239 * @param file_path Full path of the CMakeLists file.
240 * @return A CMLFile with the contents of the given file.
242 CMLFile readCMLFile(const std::string& file_path);
245 * Writes the given data into specified CMakeLists file.
246 * @param file_path Full path of the CMakeLists file.
247 * @param data CMakeLists data.
248 * @return True if the operation was successful.
250 bool writeCMLFile(const std::string& file_path, const CMLFile& data);
253 * @param st Strips all space character at the beginning and at the end of the string.
255 void normalizeStr(std::string& st);
259 #endif /* CDMUTILITIES_H_ */