Add support for logs directory (#55)

Author: Ratakor

README.md

@@ -25,6 +25,7 @@ pub const KnownFolder = enum {
     local_configuration,
     global_configuration,
     data,
+    logs,
     runtime,
     executable_dir,
 };

RESOURCES.md

@@ -35,4 +35,5 @@
 | Roaming Configuration | %APPDATA%                | XDG_CONFIG_HOME            | HOME/Library/Preferences |
 | Local Configuration   | %LOCALAPPDATA%           | XDG_CONFIG_HOME            | HOME/Library/Application Support |
 | Data                  | %APPDATA%                | XDG_DATA_HOME              | HOME/Library/Application Support |
+| Logs                  | %LOCALAPPDATA%/Temp      | XDG_STATE_HOME             | HOME/Library/Logs |
 | Runtime               | %LOCALAPPDATA%/Temp      | XDG_RUNTIME_DIR            | HOME/Library/Application Support |

known-folders.zig

@@ -89,6 +89,13 @@ pub const KnownFolder = enum {
     ///
     /// XDG's definition of `XDG_DATA_HOME`: There is a set of preference ordered base directories
     data,
+    /// The base directory relative to which user-specific log files should be written.
+    ///
+    /// Windows:       `%LOCALAPPDATA%\Temp`
+    /// MacOS default: `$HOME/Library/Logs`
+    ///  *nix default: `$HOME/.local/state`
+    /// XDG directory: `XDG_STATE_HOME`
+    logs,
     /// The base directory relative to which user-specific runtime files and other file objects should be placed.
     ///
     /// Windows:       `%LOCALAPPDATA%\Temp`
@@ -658,6 +665,7 @@ fn getWindowsFolderSpec(folder: KnownFolder) WindowsFolderSpec {
         .local_configuration => .{ .by_guid = comptime std.os.windows.GUID.parse("{F1B32785-6FBA-4FCF-9D55-7B8E7F157091}") }, // FOLDERID_LocalAppData
         .global_configuration => .{ .by_guid = comptime std.os.windows.GUID.parse("{62AB5D82-FDC1-4DC3-A9DD-070D1D495D97}") }, // FOLDERID_ProgramData
         .data => .{ .by_env = .{ .env_var = "APPDATA", .subdir = null } }, // %LOCALAPPDATA%\Temp
+        .logs => .{ .by_env = .{ .env_var = "LOCALAPPDATA", .subdir = "Temp" } }, // %LOCALAPPDATA%\Temp
         .runtime => .{ .by_env = .{ .env_var = "LOCALAPPDATA", .subdir = "Temp" } },
     };
 }
@@ -681,6 +689,7 @@ fn getMacFolderSpec(folder: KnownFolder) []const u8 {
         .local_configuration => "Library/Application Support",
         .global_configuration => "/Library/Preferences", // absolute path
         .data => "Library/Application Support",
+        .logs => "Library/Logs",
         .runtime => "Library/Application Support",
     };
 }
@@ -717,6 +726,7 @@ fn getXdgFolderSpec(folder: KnownFolder) XdgFolderSpec {
         .local_configuration => .{ .env = .{ .name = "XDG_CONFIG_HOME", .user_dir = false, .suffix = null }, .default = "~/.config" },
         .global_configuration => .{ .env = .{ .name = "XDG_CONFIG_DIRS", .user_dir = false, .suffix = null }, .default = "/etc" }, // absolute path
         .data => .{ .env = .{ .name = "XDG_DATA_HOME", .user_dir = false, .suffix = null }, .default = "~/.local/share" },
+        .logs => .{ .env = .{ .name = "XDG_STATE_HOME", .user_dir = false, .suffix = null }, .default = "~/.local/state" },
         .runtime => .{ .env = .{ .name = "XDG_RUNTIME_DIR", .user_dir = false, .suffix = null }, .default = null },
     };
 }