standardpaths 0.8.2
Getting standard system locations
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
Standard paths
D library for getting standard paths (e.g. Pictures, Music, Documents and also generic configuration and data paths). Inspired by QStandardPaths from Qt.
Platform support
Works on Freedesktop (GNU/Linux, FreeBSD, etc.), Windows and OS X.
Running examples
Print directories
Prints some standard paths to stdout.
dub examples/printdirs.d
On OSX it also can be built to use Cocoa instead of Carbon:
dub --single examples/printdirs.d --override-config=standardpaths/cocoa
Get path
Get path of given type, verify it exists or create if it does not.
dub examples/getpath.d --verify --create templates
Use Cocoa instead of Carbon on OSX:
dub --single examples/getpath.d --override-config=standardpaths/cocoa -- --create music
With subfolder:
dub examples/getpath.d --subfolder=MyLittleCompany/MyLittleApplication data
Use cases
Some code snippets showing how standardpaths library is supposed to be used.
Building file dialogs
Let's say you have some fancy FileDialog class and you want to provide shortcuts to standard user directories to improve experience. Your code may look like this:
import standardpaths;
import std.file;
import std.stdio;
void showFileDialog()
{
auto fileDialog = new FileDialog;
auto folderFlag = FolderFlag.verify;
string[] paths = [
homeDir(),
writablePath(StandardPath.desktop, folderFlag),
writablePath(StandardPath.downloads, folderFlag),
writablePath(StandardPath.documents, folderFlag),
writablePath(StandardPath.pictures, folderFlag),
writablePath(StandardPath.music, folderFlag),
writablePath(StandardPath.videos, folderFlag),
writablePath(StandardPath.templates, folderFlag),
writablePath(StandardPath.publicShare, folderFlag)
];
foreach(path; paths) {
if (path.length) {
string label = path.baseName();
fileDialog.addPath(label, path);
}
}
fileDialog.show();
}
Writing configuration files
Usually your application will have some configuration file (or files) to store user's preferences and settings. That's where you could use StandardPath.config path. While the library returns generic paths for configuration, data and cache, you want to have separate folders specially for your application, so you will not accidentally read or modify files used by other programs. Usually these paths are built by concatenating of generic path, organization name and application name.
//You may have these as constants somewhere in your code
enum organizationName = "MyLittleCompany";
enum applicationName = "MyLittleApplication";
import standardpaths;
import std.stdio;
import std.path;
void saveSettings(const Config config)
{
string configDir = writablePath(StandardPath.config, buildPath(organizationName, applicationName), FolderFlag.create);
if (!configDir.length) {
throw new Exception("Could not create config directory");
}
string configFile = buildPath(configDir, "config.conf");
auto f = File(configFile, "w");
// write settings
writeln("Settings saved!");
}
Reading configuration files
Since one can save settings it also should be able to read them. Before the first start application does not have any user-specific settings, though it may provide some global default settings upon installing. It's up to developer to decide how to read configs, e.g. whether to read the first found file only or to merge settings from all found config consequentially.
Config readSettings()
{
string[] configDirs = standardPaths(StandardPath.config, buildPath(organizationName, applicationName));
foreach(configDir; configDirs) {
string configFile = buildPath(configDir, "config.conf");
if (configFile.exists) {
auto f = File(configFile, "r");
Config config;
//read settings...
return config;//consider using of the first found file
}
}
}
Implementation details
Freedesktop
On freedesktop systems (GNU/Linux, FreeBSD, etc.) library follows XDG Base Directory Specification and also provides behavior similiar to xdg-user-dirs.
Windows
On Windows it utilizes SHGetKnownFolderPath or SHGetSpecialFolderPath as fallback.
Mac OS X
Depending on configuration the library uses FSFindFolder from Carbon framework or URLForDirectory from Cocoa. See here.
- 0.8.2 released 3 years ago
- FreeSlave/standardpaths
- BSL-1.0
- Copyright © 2015-2016, Roman Chistokhodov
- Authors:
- Dependencies:
- xdgpaths
- Versions:
-
0.8.2 2021-Jun-12 0.8.1 2018-May-05 0.8.0 2017-Oct-11 0.7.1 2016-Sep-26 0.7.0 2016-Jun-27 - Download Stats:
-
-
8 downloads today
-
55 downloads this week
-
246 downloads this month
-
20987 downloads total
-
- Score:
- 3.0
- Short URL:
- standardpaths.dub.pm