Add roaming and savedGames as StandardPath enum constants

examples/getpath/source/app.d

@@ -44,6 +44,12 @@ bool stringToType(string typeStr, out StandardPath type)
         case "startup" :
             type = StandardPath.startup;
             return true;
+        case "roaming":
+            type = StandardPath.roaming;
+            return true;
+        case "savedGames":
+            type = StandardPath.savedGames;
+            return true;
         default:
             break;
     }

examples/printdirs/dub.selections.json

@@ -4,4 +4,4 @@
 		"isfreedesktop": "0.1.0",
 		"xdgpaths": "0.2.2"
 	}
-}
+}

examples/printdirs/source/app.d

@@ -26,8 +26,8 @@ int main()
 
     version(Windows) {
         writeln("\nSpecific functions for Windows:");
-        writeln("Roaming data: ", roamingPath());
-        writeln("Saved games: ", savedGames());
+        writeln("Roaming data: ", writablePath(StandardPath.roaming));
+        writeln("Saved games: ", writablePath(StandardPath.savedGames));
     } else version(linux) {
         writeln("\nSpecific functions for Linux:");
         writeln("Runtime: ", xdgRuntimeDir());

source/standardpaths.d

@@ -162,7 +162,15 @@ enum StandardPath {
      * On OSX it's not available.
      * On Freedesktop it's directory where autostarted .desktop files are stored.
      */
-    startup
+    startup,
+    /**
+     * Roaming directory that stores a user data which should be shared between user profiles on different machines. Windows-only.
+     */
+    roaming,
+    /**
+     * Common directory for game save files. Windows-only.
+     */
+    savedGames
 }
 
 /**
@@ -320,15 +328,15 @@ version(D_Ddoc)
      * Returns: User's Roaming directory. On fail returns an empty string.
      * See_Also: $(D writablePath), $(D FolderFlag)
      */
-    string roamingPath(FolderFlag params = FolderFlag.none) nothrow @safe;
+    deprecated string roamingPath(FolderFlag params = FolderFlag.none) nothrow @safe;
 
     /**
      * Location where games may store their saves. Windows only.
      * Note: This is common path for games. One should use subfolder for their game saves.
      * Returns: User's Saved Games directory. On fail returns an empty string.
      * See_Also: $(D writablePath), $(D FolderFlag)
      */
-    string savedGames(FolderFlag params = FolderFlag.none) nothrow @safe;
+    deprecated string savedGames(FolderFlag params = FolderFlag.none) nothrow @safe;
 }
 
 version(Windows) {
@@ -525,24 +533,14 @@ version(Windows) {
         return null;
     }
 
-    string roamingPath(FolderFlag params = FolderFlag.none) nothrow @safe
+    deprecated("use writablePath(StandardPath.roaming)") string roamingPath(FolderFlag params = FolderFlag.none) nothrow @safe
     {
-        if (hasSHGetKnownFolderPath()) {
-            return getKnownFolder(FOLDERID_RoamingAppData, params);
-        } else if (hasSHGetSpecialFolderPath()) {
-            return getCSIDLFolder(CSIDL_APPDATA, params);
-        } else {
-            return null;
-        }
+        return writablePath(StandardPath.roaming, params);
     }
 
-    string savedGames(FolderFlag params = FolderFlag.none) nothrow @safe
+    deprecated("use writablePath(StandardPath.savedGames)") string savedGames(FolderFlag params = FolderFlag.none) nothrow @safe
     {
-        if (hasSHGetKnownFolderPath()) {
-            return getKnownFolder(FOLDERID_SavedGames, params);
-        } else {
-            return null;
-        }
+        return writablePath(StandardPath.savedGames, params);
     }
 
     string writablePath(StandardPath type, FolderFlag params = FolderFlag.none) nothrow @safe
@@ -576,6 +574,10 @@ version(Windows) {
                     return getKnownFolder(FOLDERID_Programs, params);
                 case StandardPath.startup:
                     return getKnownFolder(FOLDERID_Startup, params);
+                case StandardPath.roaming:
+                    return getKnownFolder(FOLDERID_RoamingAppData, params);
+                case StandardPath.savedGames:
+                    return getKnownFolder(FOLDERID_SavedGames, params);
             }
         } else if (hasSHGetSpecialFolderPath()) {
             final switch(type) {
@@ -606,6 +608,10 @@ version(Windows) {
                     return getCSIDLFolder(CSIDL_PROGRAMS, params);
                 case StandardPath.startup:
                     return getCSIDLFolder(CSIDL_STARTUP, params);
+                case StandardPath.roaming:
+                    return getCSIDLFolder(CSIDL_APPDATA, params);
+                case StandardPath.savedGames:
+                    return null;
             }
         } else {
             return null;
@@ -993,6 +999,10 @@ version(Windows) {
                     return domainDir(NSApplicationDirectory, NSUserDomainMask, shouldCreate);
                 case StandardPath.startup:
                     return null;
+                case StandardPath.roaming:
+                    return null;
+                case StandardPath.savedGames:
+                    return null;
             }
         } else {
             final switch(type) {
@@ -1024,6 +1034,10 @@ version(Windows) {
                     return fsPath(kUserDomain, kApplicationsFolderType, shouldCreate);
                 case StandardPath.startup:
                     return null;
+                case StandardPath.roaming:
+                    return null;
+                case StandardPath.savedGames:
+                    return null;
             }
         }
     }
@@ -1253,6 +1267,10 @@ PICTURES=Images
                     return xdgDataHome("applications", shouldCreate);
                 case StandardPath.startup:
                     return xdgConfigHome("autostart", shouldCreate);
+                case StandardPath.roaming:
+                    return null;
+                case StandardPath.savedGames:
+                    return null;
             }
         }