Skip to main content

Simple Windows file dialogs.

Project description

File dialogs for Windows

Coverage Status GitHub Workflow Status PyPI GitHub GitHub Last Commit GitHub Issues Downloads Python Version

pip install windows-filedialogs

Documentation: https://mrthearman.github.io/filedialogs/

Source Code: https://github.com/MrThearMan/filedialogs/

Contributing: https://github.com/MrThearMan/filedialogs/blob/main/CONTRIBUTING.md


Implements easy Windows file dialog functions. Requires the pywin32 module.

Basic use:

from filedialogs import save_file_dialog, open_file_dialog, open_folder_dialog

open_path = open_file_dialog()
if open_path:
    with open(open_path, "r") as f:
        ...

save_path = save_file_dialog()
if save_path:
    with open(save_path, "w") as f:
        ...

open_folder = open_folder_dialog()
if open_folder:
    with open(os.path.join(open_folder, ...), "w") as f:
        ...

Documentation:

open_file_dialog

  • title: str - Dialog title. Default is no title.
  • directory: str - Directory to open file dialog in. Default is the current working directory.
  • default_name: str - Default file name on dialog open. Default is empty.
  • default_ext: str - Default file extension on dialog open. Default is no extension.
  • ext: list[tuple[str, str | tuple[str, ...]]] - List of available extensions as (description, extension) tuples. Default is ("All files", "*").
  • multiselect: bool - Allow multiple files to be selected. Default is False.

Returns: Path to a file to open if multiselect=False. List of the paths to files which should be opened if multiselect=True. None if file open dialog canceled.

Raises: IOError - File open dialog failed.


save_file_dialog

  • title: str - Dialog title. Default is no title.
  • directory: str - Directory to open file dialog in. Default is the current working directory.
  • default_name: str - Default file name on dialog open. Default is empty.
  • default_ext: str - Default file extension on dialog open. Default is no extension.
  • ext: list[tuple[str, str | tuple[str, ...]]] - List of available extensions as (description, extension) tuples. Default is ("All files", "*").

Returns: Path file should be save to. None if file save dialog canceled.

Raises: IOError - File save dialog failed.


open_folder_dialog

  • title: str - Dialog title. Default is no title.
  • encoding: str - Encoding for the folder. Default is Latin-1.

Returns: Path to folder. None if no folder selected.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

windows_filedialogs-0.0.7.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

windows_filedialogs-0.0.7-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file windows_filedialogs-0.0.7.tar.gz.

File metadata

  • Download URL: windows_filedialogs-0.0.7.tar.gz
  • Upload date:
  • Size: 6.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.12.0 Windows/11

File hashes

Hashes for windows_filedialogs-0.0.7.tar.gz
Algorithm Hash digest
SHA256 af4ebb131ac28f4dbee4d9424d31e3225ebff255d05e7a74e0f3996e5458b0c4
MD5 00c7b26fb731bf6af9bf6ee45e922d4d
BLAKE2b-256 23d699a755fe46cbdbcb00026e6c06140929c844e93b807298d8d076d72747eb

See more details on using hashes here.

File details

Details for the file windows_filedialogs-0.0.7-py3-none-any.whl.

File metadata

File hashes

Hashes for windows_filedialogs-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 ae90391c0158aa8c2ea408c1c3eeb25706e3f9f914a3af3613e8093d545e0e0d
MD5 bb8e595f37c1b3fecf0796449cff3296
BLAKE2b-256 d7ad04de02c34b8c225ace2c8d549eac24b0554713f6abe8286dba00811709fe

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page