adsfolio.gui.osint

Operating-system integration for opening and revealing library files.

adsfolio.gui.osint.open_path(path, application=None)[source]

Open path with the operating system’s default application.

Parameters:

  • path (Path) – File to open.

  • application (str | None)

Returns:

False when the file does not exist or Qt cannot open it.

Return type:

bool

adsfolio.gui.osint.open_url(url, application=None)[source]

Open an external URL with a configured or system-default browser.

Parameters:

  • url (str)

  • application (str | None)

Return type:

bool

adsfolio.gui.osint.reveal_command(path, platform)[source]

Build the argv that reveals path in a platform file manager.

Parameters:

  • path (Path) – File to select in the file manager.

  • platform (str) – A sys.platform value. This argument is explicit so the pure builder can be tested on any host operating system.

Returns:

Platform-specific argv, or None when no strategy is known.

Return type:

list[str] or None

adsfolio.gui.osint.reveal_in_file_manager(path)[source]

Reveal path in the platform file manager.

Missing files are represented by revealing their existing parent directory. Linux uses the freedesktop D-Bus method first, then falls back to opening the parent directory when the utility is unavailable or fails.

Parameters:

path (pathlib.Path)

Return type:

bool