X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fsupport%2Ffiletools.h;h=5177cdddee81ade1ced639a892c1225d36c5a6cb;hb=5608f6fdb67b86b4cf3d9215d24d7734239ad05a;hp=25c3a35e214d1fdc353c512b90cf32482bedb9c9;hpb=138b23fac84930cdbfada0067c61480989041113;p=lyx.git diff --git a/src/support/filetools.h b/src/support/filetools.h index 25c3a35e21..5177cdddee 100644 --- a/src/support/filetools.h +++ b/src/support/filetools.h @@ -4,7 +4,7 @@ * This file is part of LyX, the document processor. * Licence details can be found in the file COPYING. * - * \author Lars Gullik Bjønnes + * \author Lars Gullik Bjønnes * * Full author contact details are available in file CREDITS. */ @@ -13,23 +13,14 @@ #define LYX_FILETOOL_H #include "support/docstring.h" -#include "support/FileName.h" -#include #include #include namespace lyx { namespace support { -/// remove directory and all contents, returns true on success -bool destroyDir(FileName const & tmpdir); - -/// Creates the per buffer temporary directory -std::string const createBufferTmpDir(); - -/// Creates directory. Returns true on success -bool createDirectory(FileName const & name, int permissions); +class FileName; /** Creates the global LyX temp dir. \p deflt can be an existing directory name. In this case a new directory @@ -55,11 +46,16 @@ FileName const fileOpenSearch(std::string const & path, /// How to search files enum search_mode { - // The file must exist (return an empty file name otherwise) - standard_mode, + /// The file must exist (return an empty file name otherwise) + must_exist, /// Only do file name expansion, return the complete name even if /// the file does not exist - allow_unreadable + may_not_exist, + /// The (image) file may be present with hi-dpi resolution - + /// the lookup checks for a file named "image" + "@2x" + ".ext" first. + /// If found it will return e.g. "image@2x.png" instead of "image.png". + /// Otherwise it will work as must_exist. + check_hidpi }; /** Returns the real name of file name in directory path, with optional @@ -70,29 +66,25 @@ enum search_mode { FileName const fileSearch(std::string const & path, std::string const & name, std::string const & ext = std::string(), - search_mode mode = standard_mode); + search_mode mode = must_exist); -/// Returns a vector of all files in directory dir having extension ext. -std::vector const dirList(FileName const & dir, - std::string const & ext = std::string()); +/// +bool isLyXFileName(std::string const & filename); -/** Is directory read only? - returns - true: dir writeable - false: not writeable -*/ -bool isDirWriteable(FileName const & path); +/// +bool isSGMLFileName(std::string const & filename); -/** Is a file readable ? - Returns true if the file `path' is readable. - */ -bool isFileReadable(FileName const & path); +/// check for characters in filenames not allowed by LaTeX +bool isValidLaTeXFileName(std::string const & filename); -/// -bool isLyXFilename(std::string const & filename); +/** check for characters in filenames that might lead to + problems when manually compiling the LaTeX export of LyX + and opening the result with some older DVI-viewers +*/ +bool isValidDVIFileName(std::string const & filename); -/// -bool isSGMLFilename(std::string const & filename); +/// check whether the file has binary contents +bool isBinaryFile(FileName const & filename); /** Returns the path of a library data file. Search the file name.ext in the subdirectory dir of @@ -103,7 +95,8 @@ bool isSGMLFilename(std::string const & filename); */ FileName const libFileSearch(std::string const & dir, std::string const & name, - std::string const & ext = std::string()); + std::string const & ext = std::string(), + search_mode mode = must_exist); /** Same as libFileSearch(), but tries first to find an internationalized version of the file by prepending $LANG_ to the @@ -114,11 +107,22 @@ i18nLibFileSearch(std::string const & dir, std::string const & name, std::string const & ext = std::string()); +/** Same as libFileSearch(), but tries first to find a preferred + version of the file by appending the icon set name to the dir + */ +FileName const +imageLibFileSearch(std::string & dir, std::string const & name, + std::string const & ext = std::string(), + search_mode mode = must_exist); + /// How to quote a filename enum quote_style { /** Quote for the (OS dependant) shell. This is needed for command line arguments of subprocesses. */ quote_shell, + /** Quote a file name for the (OS dependant) shell. This is needed + for file names as command line arguments of subprocesses. */ + quote_shell_filename, /** Quote for python. Use this if you want to store a filename in a python script. Example: \code os << "infile = " << quoteName(filename) << '\\n'; @@ -134,8 +138,7 @@ enum quote_style { * command will still fail, but the error message will make some sort of * sense ;-) */ -std::string const libScriptSearch(std::string const & command, - quote_style style = quote_shell); +std::string const commandPrep(std::string const & command); enum latex_path_extension { PROTECT_EXTENSION, @@ -171,7 +174,7 @@ std::string const latex_path(std::string const & path, latex_path_dots dots = LEAVE_DOTS); /// Substitutes active latex characters with underscores in filename -std::string const makeLatexName(std::string const & file); +FileName const makeLatexName(FileName const & file); /** Put the name in quotes suitable for the current shell or python, depending on \p style. */ @@ -204,15 +207,6 @@ addExtension(std::string const & name, std::string const & extension); /// Return the extension of the file (not including the .) std::string const getExtension(std::string const & name); -/** Guess the file format name (as in Format::name()) from contents. - Normally you don't want to use this directly, but rather - Formats::getFormatFromFile(). - */ -std::string const getFormatFromContents(FileName const & name); - -/// check for zipped file -bool zippedFile(FileName const & name); - /** \return the name that LyX will give to the unzipped file \p zipped_file if the second argument of unzipFile() is empty. */ @@ -224,13 +218,7 @@ std::string const unzippedFileName(std::string const & zipped_file); Will overwrite an already existing unzipped file without warning. */ FileName const unzipFile(FileName const & zipped_file, - std::string const & unzipped_file = std::string()); - -/// Returns true is path is absolute -bool absolutePath(std::string const & path); - -/// Create absolute path. If impossible, don't do anything -std::string const expandPath(std::string const & path); + std::string const & unzipped_file = std::string()); /** Convert relative path into absolute path based on a basepath. If relpath is absolute, just use that. @@ -258,16 +246,8 @@ makeRelPath(docstring const & abspath, docstring const & basepath); /// Strip filename from path name std::string const onlyPath(std::string const & fname); -/** Normalize a path. Constracts path/../path - * Also converts paths like /foo//bar ==> /foo/bar - */ -std::string const normalizePath(std::string const & path); - /// Strips path from filename -std::string const onlyFilename(std::string const & fname); - -/// Get the contents of a file as a huge std::string -std::string const getFileContents(FileName const & fname); +std::string const onlyFileName(std::string const & fname); /** Check and Replace Environmentvariables ${NAME} in Path. Replaces all occurences of these, if they are found in the @@ -276,6 +256,18 @@ std::string const getFileContents(FileName const & fname); */ std::string const replaceEnvironmentPath(std::string const & path); +/** + Return a string to be used as a prefix to a command for setting the + environment of the TeX engine with respect to the paths \p path and \p lpath. + */ +std::string latexEnvCmdPrefix(std::string const &path, std::string const & lpath); + +/** Replace all references to a current directory (a lonely '.' or + the prefix "./") in \c pathlist with \c path. Also prefixes + all non-absolute paths with \c path. +*/ +std::string const replaceCurdirPath(std::string const & path, std::string const & pathlist); + /** Set \c link to the path \c file points to as a symbolic link. \return true if successful. */ @@ -292,12 +284,6 @@ bool readLink(FileName const & file, FileName & link); FileName const findtexfile(std::string const & fil, std::string const & format); -/// remove the autosave-file and give a Message if it can't be done -void removeAutosaveFile(std::string const & filename); - -/// read the BoundingBox entry from a ps/eps/pdf-file -std::string const readBB_from_PSFile(FileName const & file); - /** \param file1, file2 the two files to be compared. Must have absolute paths. * \returns 1 if \c file1 has a more recent timestamp than \c file2, * 0 if their timestamps are the same, @@ -307,11 +293,23 @@ std::string const readBB_from_PSFile(FileName const & file); */ int compare_timestamps(FileName const & file1, FileName const & file2); +/// \param lfuns: true if we're converting lfuns, false if prefs +bool prefs2prefs(FileName const & filename, FileName const & tempfile, + bool lfuns); + +/// Does file \p file need to be updated by configure.py? +bool configFileNeedsUpdate(std::string const & file); + typedef std::pair cmd_ret; cmd_ret const runCommand(std::string const & cmd); +int fileLock(const char * lock_file); +void fileUnlock(int fd, const char * lock_file); + } // namespace support } // namespace lyx + + #endif