Cross-platform utilities for file system paths. More...

#include <platform_paths.h>

Static Public Member Functions
static std::filesystem::path	GetHomeDirectory ()
	Get the user's home directory in a cross-platform way.

static absl::StatusOr< std::filesystem::path >	GetAppDataDirectory ()
	Get the user-specific application data directory for YAZE.

static absl::StatusOr< std::filesystem::path >	GetConfigDirectory ()
	Get the user-specific configuration directory for YAZE.

static absl::StatusOr< std::filesystem::path >	GetImGuiIniPath ()
	Get the ImGui ini path for YAZE.

static absl::StatusOr< std::filesystem::path >	GetUserDocumentsDirectory ()
	Get the user's Documents directory.

static absl::StatusOr< std::filesystem::path >	GetUserDocumentsSubdirectory (const std::string &subdir)
	Get a subdirectory within the user documents folder.

static absl::StatusOr< std::filesystem::path >	GetAppDataSubdirectory (const std::string &subdir)
	Get a subdirectory within the app data folder.

static absl::Status	EnsureDirectoryExists (const std::filesystem::path &path)
	Ensure a directory exists, creating it if necessary.

static bool	Exists (const std::filesystem::path &path)
	Check if a file or directory exists.

static absl::StatusOr< std::filesystem::path >	GetTempDirectory ()
	Get a temporary directory for the application.

static std::string	NormalizePathForDisplay (const std::filesystem::path &path)
	Normalize path separators for display.

static std::string	ToNativePath (const std::filesystem::path &path)
	Convert path to native format.

static absl::StatusOr< std::filesystem::path >	FindAsset (const std::string &relative_path)
	Find an asset file in multiple standard locations.

Detailed Description

Cross-platform utilities for file system paths.

Provides consistent, platform-independent file and directory operations that work correctly on Windows (MSVC), macOS, and Linux.

Definition at line 18 of file platform_paths.h.

Member Function Documentation

◆ GetHomeDirectory()

std::filesystem::path yaze::util::PlatformPaths::GetHomeDirectory ( )

static

Get the user's home directory in a cross-platform way.

Windows: Uses USERPROFILE environment variable
Unix/macOS: Uses HOME environment variable
Fallback: Returns current directory

Returns: Path to user's home directory, or "." if not available

Definition at line 31 of file platform_paths.cc.

Referenced by yaze::editor::SettingsPanel::DrawAIAgentSettings(), yaze::editor::anonymous_namespace{agent_editor.cc}::ExpandUserPath(), FindAsset(), GetAppDataDirectory(), and GetUserDocumentsDirectory().

◆ GetAppDataDirectory()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetAppDataDirectory ( )

static

Get the user-specific application data directory for YAZE.

This is the standard location for storing user-specific data, settings, and cache files. The directory is created if it doesn't exist.

Windows/macOS/Linux: ~/.yaze (user home, cross-platform consistency)
Legacy locations (AppData/Library/XDG) are migrated or reused if present.

Returns: StatusOr with path to the application data directory.

Definition at line 85 of file platform_paths.cc.

References EnsureDirectoryExists(), Exists(), and GetHomeDirectory().

Referenced by yaze::editor::ProjectManagementPanel::DrawStorageLocations(), GetAppDataSubdirectory(), and GetConfigDirectory().

Here is the call graph for this function:

◆ GetConfigDirectory()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetConfigDirectory ( )

static

Get the user-specific configuration directory for YAZE.

This is the standard location for storing user configuration files. The directory is created if it doesn't exist.

Windows/macOS/Linux: ~/.yaze (user home, cross-platform consistency)
Legacy locations (AppData/Library/XDG) are migrated or reused if present.

Returns: StatusOr with path to the configuration directory.

Definition at line 234 of file platform_paths.cc.

References GetAppDataDirectory().

Referenced by yaze::editor::UICoordinator::DrawCommandPalette(), yaze::project::RecentFilesManager::GetFilePath(), GetImGuiIniPath(), yaze::gui::ThemeManager::GetThemeSearchPaths(), yaze::gui::ThemeManager::GetUserThemesDirectory(), yaze::editor::UICoordinator::InitializeCommandPalette(), yaze::util::LoadFileFromConfigDir(), yaze::editor::PanelManager::LoadPresetsFromFile(), yaze::project::RecentFilesManager::Save(), yaze::util::SaveFile(), yaze::editor::PanelManager::SavePresetsToFile(), and yaze::editor::UserSettings::UserSettings().

Here is the call graph for this function:

◆ GetImGuiIniPath()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetImGuiIniPath ( )

static

Get the ImGui ini path for YAZE.

This ensures imgui.ini lives in the app config directory rather than the current working directory.

Returns: StatusOr with path to imgui.ini

Definition at line 240 of file platform_paths.cc.

References GetConfigDirectory().

Referenced by yaze::core::CreateWindow(), yaze::platform::IOSWindowBackend::InitializeImGui(), yaze::platform::SDL2WindowBackend::InitializeImGui(), yaze::editor::WindowDelegate::ResetLayout(), yaze::editor::LayoutCoordinator::ResetWorkspaceLayout(), and yaze::editor::WorkspaceManager::ResetWorkspaceLayout().

Here is the call graph for this function:

◆ GetUserDocumentsDirectory()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetUserDocumentsDirectory ( )

static

Get the user's Documents directory.

This is a visible, user-facing directory for storing projects, logs, and resources the user might want to access or share.

Windows: My Documents\Yaze
macOS/Linux: ~/Documents/Yaze

Returns: StatusOr with path to the Yaze documents directory.

Definition at line 249 of file platform_paths.cc.

References EnsureDirectoryExists(), and GetHomeDirectory().

Referenced by yaze::editor::SettingsPanel::DrawFilesystemSettings(), GetUserDocumentsSubdirectory(), and yaze::editor::UserSettings::UserSettings().

Here is the call graph for this function:

◆ GetUserDocumentsSubdirectory()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetUserDocumentsSubdirectory ( const std::string & subdir )

static

Get a subdirectory within the user documents folder.

Creates the directory if it doesn't exist.

Parameters

subdir Subdirectory name (e.g., "logs", "agent")

Returns: StatusOr with path to subdirectory

Definition at line 302 of file platform_paths.cc.

References EnsureDirectoryExists(), and GetUserDocumentsDirectory().

Referenced by yaze::editor::SettingsPanel::DrawFilesystemSettings().

Here is the call graph for this function:

◆ GetAppDataSubdirectory()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetAppDataSubdirectory ( const std::string & subdir )

static

Get a subdirectory within the app data folder.

Creates the directory if it doesn't exist.

Parameters

subdir Subdirectory name (e.g., "agent", "cache", "logs")

Returns: StatusOr with path to subdirectory

Definition at line 316 of file platform_paths.cc.

References EnsureDirectoryExists(), and GetAppDataDirectory().

Referenced by yaze::cli::anonymous_namespace{proposal_registry.cc}::DetermineDefaultRoot(), yaze::cli::anonymous_namespace{rom_sandbox_manager.cc}::DetermineDefaultRoot(), yaze::editor::WindowDelegate::GetAvailableLayouts(), yaze::util::CrashHandler::GetCrashLogDirectory(), yaze::editor::WindowDelegate::GetLayoutFilePath(), yaze::editor::anonymous_namespace{layout_manager.cc}::GetLayoutsFilePath(), yaze::editor::AgentEditor::GetProfilesDirectory(), yaze::emu::render::SaveStateManager::Initialize(), yaze::cli::agent::LearnedKnowledgeService::LearnedKnowledgeService(), yaze::cli::PolicyEvaluator::LoadPolicies(), yaze::editor::WindowDelegate::LoadWorkspaceLayout(), yaze::editor::WorkspaceManager::LoadWorkspacePreset(), main(), yaze::editor::WorkspaceManager::RefreshPresets(), yaze::editor::anonymous_namespace{agent_chat.cc}::ResolveAgentChatHistoryPath(), yaze::editor::anonymous_namespace{right_panel_manager.cc}::ResolveAgentChatHistoryPath(), yaze::gui::anonymous_namespace{agent_chat_widget.cc}::ResolveAgentChatHistoryPath(), yaze::editor::anonymous_namespace{agent_chat.cc}::ResolveAgentSessionsDir(), ResolveLogConfig(), yaze::editor::WindowDelegate::SaveWorkspaceLayout(), yaze::editor::WorkspaceManager::SaveWorkspacePreset(), yaze::editor::AgentCollaborationCoordinator::SessionsDirectory(), and yaze::cli::agent::TodoManager::TodoManager().

Here is the call graph for this function:

◆ EnsureDirectoryExists()

absl::Status yaze::util::PlatformPaths::EnsureDirectoryExists ( const std::filesystem::path & path )

static

Ensure a directory exists, creating it if necessary.

Uses std::filesystem::create_directories which works cross-platform.

Parameters

path	Directory path to create

Returns: OK if directory exists or was created successfully

Definition at line 333 of file platform_paths.cc.

References Exists().

Referenced by yaze::editor::anonymous_namespace{user_settings.cc}::EnsureParentDirectory(), GetAppDataDirectory(), GetAppDataSubdirectory(), yaze::editor::anonymous_namespace{layout_manager.cc}::GetLayoutsFilePath(), GetTempDirectory(), yaze::gui::ThemeManager::GetThemeSearchPaths(), GetUserDocumentsDirectory(), GetUserDocumentsSubdirectory(), yaze::gui::ThemeManager::GetUserThemesDirectory(), yaze::cli::agent::LearnedKnowledgeService::Initialize(), yaze::cli::agent::TodoManager::Initialize(), and yaze::editor::LayoutManager::SaveLayoutsToDisk().

Here is the call graph for this function:

◆ Exists()

bool yaze::util::PlatformPaths::Exists ( const std::filesystem::path & path )

static

Check if a file or directory exists.

Parameters

path	Path to check

Returns: true if exists, false otherwise

Definition at line 351 of file platform_paths.cc.

Referenced by EnsureDirectoryExists(), yaze::cli::agent::anonymous_namespace{learned_knowledge_service.cc}::FileExists(), GetAppDataDirectory(), yaze::cli::agent::TodoManager::Initialize(), yaze::editor::UserSettings::Load(), and yaze::editor::PanelManager::LoadPresetsFromFile().

◆ GetTempDirectory()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::GetTempDirectory ( )

static

Get a temporary directory for the application.

Windows: TEMP%\yaze
Unix: /tmp/yaze or $TMPDIR/yaze

Returns: StatusOr with path to temp directory

Definition at line 357 of file platform_paths.cc.

References EnsureDirectoryExists().

Referenced by yaze::editor::ProjectManagementPanel::DrawStorageLocations(), yaze::util::CrashHandler::GetCrashLogDirectory(), yaze::editor::AgentEditor::GetProfilesDirectory(), yaze::cli::agent::LearnedKnowledgeService::LearnedKnowledgeService(), yaze::editor::anonymous_namespace{agent_chat.cc}::ResolveAgentChatHistoryPath(), yaze::editor::anonymous_namespace{right_panel_manager.cc}::ResolveAgentChatHistoryPath(), yaze::gui::anonymous_namespace{agent_chat_widget.cc}::ResolveAgentChatHistoryPath(), and yaze::editor::AgentCollaborationCoordinator::SessionsDirectory().

Here is the call graph for this function:

◆ NormalizePathForDisplay()

std::string yaze::util::PlatformPaths::NormalizePathForDisplay ( const std::filesystem::path & path )

static

Normalize path separators for display.

Converts all path separators to forward slashes for consistent output in logs and UI (forward slashes work on all platforms).

Parameters

path	Path to normalize

Returns: Normalized path string

Definition at line 381 of file platform_paths.cc.

Referenced by yaze::editor::SettingsPanel::DrawAIAgentSettings(), yaze::editor::SettingsPanel::DrawFilesystemSettings(), and yaze::editor::ProjectManagementPanel::DrawStorageLocations().

◆ ToNativePath()

std::string yaze::util::PlatformPaths::ToNativePath ( const std::filesystem::path & path )

static

Convert path to native format.

Ensures path uses the correct separator for the current platform.

Parameters

path	Path to convert

Returns: Native path string

Definition at line 389 of file platform_paths.cc.

◆ FindAsset()

absl::StatusOr< std::filesystem::path > yaze::util::PlatformPaths::FindAsset ( const std::string & relative_path )

static

Find an asset file in multiple standard locations.

Searches for an asset file in the following order:

YAZE_ASSETS_PATH (if defined at compile time) + relative_path
Current working directory + assets/ + relative_path
Executable directory + assets/ + relative_path
Parent directory + assets/ + relative_path
~/.yaze/assets/ + relative_path (user-installed assets)
/usr/local/share/yaze/assets/ + relative_path (system-wide on Unix)

Parameters

relative_path Path relative to assets directory (e.g., "agent/prompt_catalogue.yaml")

Returns: StatusOr with absolute path to found asset file

Definition at line 394 of file platform_paths.cc.

References GetHomeDirectory().

Referenced by yaze::cli::PromptBuilder::BuildConstraintsSection(), yaze::editor::SettingsPanel::DrawPatchSettings(), and yaze::cli::PromptBuilder::ResolveCataloguePath().

Here is the call graph for this function:

The documentation for this class was generated from the following files:

src/util/platform_paths.h
src/util/platform_paths.cc

	yaze 0.3.2 Link to the Past ROM Editor

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ GetHomeDirectory()

◆ GetAppDataDirectory()

◆ GetConfigDirectory()

◆ GetImGuiIniPath()

◆ GetUserDocumentsDirectory()

◆ GetUserDocumentsSubdirectory()

◆ GetAppDataSubdirectory()

◆ EnsureDirectoryExists()

◆ Exists()

◆ GetTempDirectory()

◆ NormalizePathForDisplay()

◆ ToNativePath()

◆ FindAsset()