55f0738f16
The latest XDG spec (0.8) defines XDG_STATE_HOME that does not exist in QStandardPaths::StandardLocation. Some Linux distributions clean XDG_CACHE_HOME on restart which makes XDG_STATE_HOME useful as a path for saving application state. This commit adds StateLocation and GenericStateLocation to serve as a StandardLocation for XDG_STATE_HOME for all platforms. This commit also updates docs and tests to fit the new changes. [ChangeLog][QStandardPaths] Added StateLocation & GenericStateLocation to StandardLocation Change-Id: I470602466c37f085062cc64d15ea243711728fa5 Reviewed-by: David Faure <david.faure@kdab.com> Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org> Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
111 lines
3.7 KiB
Plaintext
111 lines
3.7 KiB
Plaintext
// Copyright (C) 2019 The Qt Company Ltd.
|
|
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
|
|
|
|
//! [displayName]
|
|
|
|
Returns a localized display name for the given location \a type
|
|
or an empty QString if no relevant location can be found.
|
|
|
|
//! [displayName]
|
|
|
|
|
|
//! [findExecutable]
|
|
|
|
Finds the executable named \a executableName in the specified
|
|
\a paths, or the system paths if paths is empty.
|
|
|
|
On most operating systems the system path is determined by the
|
|
\c PATH environment variable. The directories where to search for
|
|
the executable can be set in the paths argument. To search in
|
|
both your own paths and the system paths, call findExecutable
|
|
twice, once with paths set and once with paths empty.
|
|
Symlinks are not resolved in order to preserve behavior for the
|
|
case of executables whose behavior depends on the name they are
|
|
invoked with
|
|
.
|
|
\note On Windows, the usual executable extensions (from the PATHEXT
|
|
environment variable) are automatically appended. For example, the
|
|
findExecutable("foo") call finds \c foo.exe or \c foo.bat if
|
|
present.
|
|
|
|
Returns the absolute file path to the executable, or an empty
|
|
string if not found.
|
|
|
|
If the given \n executableName is an absolute path pointing to
|
|
an executable its clean path is returned.
|
|
|
|
//! [findExecutable]
|
|
|
|
//! [locate]
|
|
|
|
Finds a file or directory called \a fileName in the standard
|
|
locations for \a type.
|
|
|
|
The \a options flag lets you specify whether to look for files
|
|
or directories. By default, this flag is set to \c LocateFile.
|
|
|
|
Returns the absolute path to the first file or directory found,
|
|
otherwise returns an empty string.
|
|
|
|
//! [locate]
|
|
|
|
//! [locateAll]
|
|
|
|
Finds all files or directories by the name, \a fileName, in the
|
|
standard locations for \a type.
|
|
|
|
The \a options flag lets you specify whether to look for files
|
|
or directories. By default, this flag is set to \c LocateFile.
|
|
|
|
Returns the list of all the files that were found.
|
|
|
|
//! [locateAll]
|
|
|
|
//! [setTestModeEnabled]
|
|
|
|
If \a testMode is \c true, this enables a special "test mode" in
|
|
QStandardPaths, which changes writable locations to point to
|
|
test directories. This prevents auto tests from reading
|
|
or writing to the current user's configuration.
|
|
|
|
It affects the locations into which test programs might write
|
|
files: \c GenericDataLocation, \c AppDataLocation, \c ConfigLocation,
|
|
\c GenericConfigLocation, \c AppConfigLocation,
|
|
\c StateLocation, \c GenericStateLocation,
|
|
\c GenericCacheLocation, and \c CacheLocation. Other locations
|
|
are not affected.
|
|
|
|
On Unix, \c XDG_DATA_HOME is set to \c{~/.qttest/share},
|
|
\c XDG_CONFIG_HOME is set to \c{~/.qttest/config},
|
|
\c XDG_STATE_HOME is set \c{~/.qttest/state} and
|
|
\c XDG_CACHE_HOME is set to \c{~/.qttest/cache}.
|
|
|
|
On macOS, data goes to \c{~/.qttest/Application Support},
|
|
cache goes to \c{~/.qttest/Cache}, and config goes to
|
|
\c{~/.qttest/Preferences}.
|
|
|
|
On Windows, everything goes to a "qttest" directory under
|
|
\c{%APPDATA%}.
|
|
|
|
//! [setTestModeEnabled]
|
|
|
|
//! [standardLocations]
|
|
|
|
Returns all the directories where files of \a type belong.
|
|
|
|
The list of directories is sorted from high to low priority,
|
|
starting with writableLocation() if it can be determined.
|
|
This list is empty if no locations for type are defined.
|
|
|
|
//! [standardLocations]
|
|
|
|
//! [writableLocation]
|
|
|
|
Returns the directory where files of \a type should be written to,
|
|
or an empty string if the location cannot be determined.
|
|
|
|
\note The storage location returned may not exist; that is,
|
|
it may need to be created by the system or the user.
|
|
|
|
//! [writableLocation]
|