# File dialogs for Windows
[![Coverage Status][coverage-badge]][coverage]
[![GitHub Workflow Status][status-badge]][status]
[![PyPI][pypi-badge]][pypi]
[![GitHub][licence-badge]][licence]
[![GitHub Last Commit][repo-badge]][repo]
[![GitHub Issues][issues-badge]][issues]
[![Downloads][downloads-badge]][pypi]
[![Python Version][version-badge]][pypi]
```shell
pip install windows-filedialogs
```
---
**Documentation**: [https://mrthearman.github.io/filedialogs/](https://mrthearman.github.io/filedialogs/)
**Source Code**: [https://github.com/MrThearMan/filedialogs/](https://github.com/MrThearMan/filedialogs/)
---
Implements easy Windows file dialog functions. Requires the [pywin32](https://pypi.org/project/pywin32/) module.
### Basic use:
```python
from filedialogs import save_file_dialog, open_file_dialog, open_folder_dialog
openpath = open_file_dialog()
if openpath:
with open(openpath, "r") as f:
...
savepath = save_file_dialog()
if savepath:
with open(savepath, "w") as f:
...
openfolder = open_folder_dialog()
if openfolder:
with open(os.path.join(openfolder, ...), "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]] - 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]] - 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.
---
[coverage-badge]: https://coveralls.io/repos/github/MrThearMan/filedialogs/badge.svg?branch=master
[status-badge]: https://img.shields.io/github/actions/workflow/status/MrThearMan/filedialogs/test.yml?branch=master
[pypi-badge]: https://img.shields.io/pypi/v/windows-filedialogs
[licence-badge]: https://img.shields.io/github/license/MrThearMan/filedialogs
[repo-badge]: https://img.shields.io/github/last-commit/MrThearMan/filedialogs
[issues-badge]: https://img.shields.io/github/issues-raw/MrThearMan/filedialogs
[version-badge]: https://img.shields.io/pypi/pyversions/windows-filedialogs
[downloads-badge]: https://img.shields.io/pypi/dm/windows-filedialogs
[coverage]: https://coveralls.io/github/MrThearMan/filedialogs?branch=master
[status]: https://github.com/MrThearMan/filedialogs/actions/workflows/test.yml
[pypi]: https://pypi.org/project/windows-filedialogs
[licence]: https://github.com/MrThearMan/filedialogs/blob/master/LICENSE
[repo]: https://github.com/MrThearMan/filedialogs/commits/master
[issues]: https://github.com/MrThearMan/filedialogs/issues
Raw data
{
"_id": null,
"home_page": "https://mrthearman.github.io/filedialogs",
"name": "windows-filedialogs",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4",
"maintainer_email": "",
"keywords": "file,dialogs,windows,open,save",
"author": "Matti Lamppu",
"author_email": "lamppu.matti.akseli@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3e/76/182222a692dc3eca2b73ba4ae8ea82e0a4cbddc649d0085d12244cb547da/windows_filedialogs-0.0.5.tar.gz",
"platform": null,
"description": "# File dialogs for Windows\n\n[![Coverage Status][coverage-badge]][coverage]\n[![GitHub Workflow Status][status-badge]][status]\n[![PyPI][pypi-badge]][pypi]\n[![GitHub][licence-badge]][licence]\n[![GitHub Last Commit][repo-badge]][repo]\n[![GitHub Issues][issues-badge]][issues]\n[![Downloads][downloads-badge]][pypi]\n[![Python Version][version-badge]][pypi]\n\n```shell\npip install windows-filedialogs\n```\n\n---\n\n**Documentation**: [https://mrthearman.github.io/filedialogs/](https://mrthearman.github.io/filedialogs/)\n\n**Source Code**: [https://github.com/MrThearMan/filedialogs/](https://github.com/MrThearMan/filedialogs/)\n\n---\n\nImplements easy Windows file dialog functions. Requires the [pywin32](https://pypi.org/project/pywin32/) module.\n\n### Basic use:\n\n```python\nfrom filedialogs import save_file_dialog, open_file_dialog, open_folder_dialog\n\nopenpath = open_file_dialog()\nif openpath:\n with open(openpath, \"r\") as f:\n ...\n\nsavepath = save_file_dialog()\nif savepath:\n with open(savepath, \"w\") as f:\n ...\n\nopenfolder = open_folder_dialog()\nif openfolder:\n with open(os.path.join(openfolder, ...), \"w\") as f:\n ...\n```\n\n## Documentation:\n\n#### *open_file_dialog*\n* title: str - Dialog title. Default is no title.\n* directory: str - Directory to open file dialog in. Default is the current working directory.\n* default_name: str - Default file name on dialog open. Default is empty.\n* default_ext: str - Default file extension on dialog open. Default is no extension.\n* ext: list[tuple[str, str]] - List of available extensions as (description, extension) tuples. Default is (\"All files\", \"*\").\n* multiselect: bool - Allow multiple files to be selected. Default is False.\n\nReturns: 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.\n\nRaises: IOError - File open dialog failed.\n\n---\n\n#### *save_file_dialog*\n* title: str - Dialog title. Default is no title.\n* directory: str - Directory to open file dialog in. Default is the current working directory.\n* default_name: str - Default file name on dialog open. Default is empty.\n* default_ext: str - Default file extension on dialog open. Default is no extension.\n* ext: list[tuple[str, str]] - List of available extensions as (description, extension) tuples. Default is (\"All files\", \"*\").\n\nReturns: Path file should be save to. None if file save dialog canceled.\n\nRaises: IOError - File save dialog failed.\n\n---\n\n#### *open_folder_dialog*\n* title: str - Dialog title. Default is no title.\n* encoding: str - Encoding for the folder. Default is Latin-1.\n\nReturns: Path to folder. None if no folder selected.\n\n---\n\n[coverage-badge]: https://coveralls.io/repos/github/MrThearMan/filedialogs/badge.svg?branch=master\n[status-badge]: https://img.shields.io/github/actions/workflow/status/MrThearMan/filedialogs/test.yml?branch=master\n[pypi-badge]: https://img.shields.io/pypi/v/windows-filedialogs\n[licence-badge]: https://img.shields.io/github/license/MrThearMan/filedialogs\n[repo-badge]: https://img.shields.io/github/last-commit/MrThearMan/filedialogs\n[issues-badge]: https://img.shields.io/github/issues-raw/MrThearMan/filedialogs\n[version-badge]: https://img.shields.io/pypi/pyversions/windows-filedialogs\n[downloads-badge]: https://img.shields.io/pypi/dm/windows-filedialogs\n\n[coverage]: https://coveralls.io/github/MrThearMan/filedialogs?branch=master\n[status]: https://github.com/MrThearMan/filedialogs/actions/workflows/test.yml\n[pypi]: https://pypi.org/project/windows-filedialogs\n[licence]: https://github.com/MrThearMan/filedialogs/blob/master/LICENSE\n[repo]: https://github.com/MrThearMan/filedialogs/commits/master\n[issues]: https://github.com/MrThearMan/filedialogs/issues\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Simple Windows file dialogs.",
"version": "0.0.5",
"split_keywords": [
"file",
"dialogs",
"windows",
"open",
"save"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "83a18e6287002d1c7a4e1d47dd14a878de44d448688f2010c13ce836d8dfb190",
"md5": "0d16a1850a9fb0978bba564c997a206a",
"sha256": "cda0b6e7ccc5867cfb18ddfea67e825a6c1a5fa576d3a59be27620e1b30a8c17"
},
"downloads": -1,
"filename": "windows_filedialogs-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0d16a1850a9fb0978bba564c997a206a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4",
"size": 6812,
"upload_time": "2023-03-30T19:37:45",
"upload_time_iso_8601": "2023-03-30T19:37:45.253130Z",
"url": "https://files.pythonhosted.org/packages/83/a1/8e6287002d1c7a4e1d47dd14a878de44d448688f2010c13ce836d8dfb190/windows_filedialogs-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3e76182222a692dc3eca2b73ba4ae8ea82e0a4cbddc649d0085d12244cb547da",
"md5": "532cf65ad7297c13c56890c5a87cccc7",
"sha256": "a9aa5739a0ab344c754720b43e0f3635a299dbac435be70d300b4d4da911e634"
},
"downloads": -1,
"filename": "windows_filedialogs-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "532cf65ad7297c13c56890c5a87cccc7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4",
"size": 4808,
"upload_time": "2023-03-30T19:37:46",
"upload_time_iso_8601": "2023-03-30T19:37:46.899670Z",
"url": "https://files.pythonhosted.org/packages/3e/76/182222a692dc3eca2b73ba4ae8ea82e0a4cbddc649d0085d12244cb547da/windows_filedialogs-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-30 19:37:46",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "windows-filedialogs"
}
JSON