pyfilechoose 0.1.0__tar.gz

pyfilechoose-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jonathan Katende Pinto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyfilechoose-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: pyfilechoose
+Version: 0.1.0
+Summary: A simple replication of R's file.choose() for Python.
+Author-email: Jonathan Katende Pinto <katendepinto@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Pinto-Katende-Jonathan/pyfilechoose
+Project-URL: Repository, https://github.com/Pinto-Katende-Jonathan/pyfilechoose
+Project-URL: Issues, https://github.com/Pinto-Katende-Jonathan/pyfilechoose/issues
+Project-URL: Changelog, https://github.com/Pinto-Katende-Jonathan/pyfilechoose/blob/main/CHANGELOG.md
+Keywords: file,dialog,tkinter,file.choose,R,filedialog
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# pyfilechoose
+
+R's `file.choose()`, reimplemented for Python.
+
+[![PyPI version](https://img.shields.io/pypi/v/pyfilechoose.svg)](https://pypi.org/project/pyfilechoose/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pyfilechoose.svg)](https://pypi.org/project/pyfilechoose/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+In R, `file.choose()` opens a file picker and returns the path you select.
+`pyfilechoose` gives you the same one-liner in Python, with no GUI boilerplate
+and no leftover Tk windows.
+
+It uses `tkinter` from the standard library, so it has no third-party
+dependencies.
+
+## Installation
+
+With pip:
+
+```bash
+pip install pyfilechoose
+```
+
+With [uv](https://docs.astral.sh/uv/):
+
+```bash
+# Add it to your project
+uv add pyfilechoose
+
+# ...or install it into the current environment
+uv pip install pyfilechoose
+
+# ...or run a one-off script that uses it, no install needed
+uv run --with pyfilechoose your_script.py
+```
+
+On Linux, `tkinter` ships with most Python builds but may need to be installed
+separately, e.g. `sudo apt install python3-tk`.
+
+## Usage
+
+### Pick a single file
+
+```python
+from pyfilechoose import file_choose
+
+path = file_choose()
+print(path)  # absolute path of the file you selected
+```
+
+### With pandas (the classic R workflow)
+
+`file_choose()` returns a path string, so it works with any function that takes
+a file path, including `pd.read_csv`:
+
+```python
+import pandas as pd
+from pyfilechoose import file_choose
+
+# Just like df <- read.csv(file.choose()) in R
+df = pd.read_csv(file_choose())
+```
+
+You can still pass the usual pandas options, and filter the picker to CSVs:
+
+```python
+df = pd.read_csv(file_choose(filetypes=[("CSV files", "*.csv")]), sep=";")
+```
+
+### Filter file types and set a starting directory
+
+```python
+path = file_choose(
+    title="Pick your dataset",
+    filetypes=[("CSV files", "*.csv"), ("All files", "*.*")],
+    initialdir="~/Documents",
+)
+```
+
+### Pick several files at once
+
+```python
+from pyfilechoose import files_choose
+
+paths = files_choose(filetypes=[("Images", "*.png *.jpg")])
+for p in paths:
+    print(p)
+```
+
+## API
+
+### `file_choose(*, title="Select a file", filetypes=None, initialdir=None) -> str`
+
+Opens a dialog and returns the absolute path of the chosen file.
+Raises `FileNotFoundError` if the user cancels.
+
+### `files_choose(*, title="Select one or more files", filetypes=None, initialdir=None) -> list[str]`
+
+Same as above but allows multiple selections; returns a list of absolute paths.
+Raises `FileNotFoundError` if nothing is selected.
+
+| Argument     | Type                          | Description                                               |
+| ------------ | ----------------------------- | --------------------------------------------------------- |
+| `title`      | `str`                         | Title of the dialog window.                               |
+| `filetypes`  | `list[tuple[str, str]]` \| `None` | `(label, pattern)` pairs, e.g. `[("CSV", "*.csv")]`.  |
+| `initialdir` | `str` \| `None`               | Directory the dialog opens in.                            |
+
+## Development
+
+```bash
+git clone https://github.com/Pinto-Katende-Jonathan/pyfilechoose.git
+cd pyfilechoose
+```
+
+With uv, which creates and manages the virtualenv for you:
+
+```bash
+uv sync --extra dev   # set up the environment with dev dependencies
+uv run pytest         # run the test suite
+```
+
+With pip:
+
+```bash
+python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © Jonathan Katende Pinto

pyfilechoose-0.1.0/README.md

@@ -0,0 +1,132 @@
+# pyfilechoose
+
+R's `file.choose()`, reimplemented for Python.
+
+[![PyPI version](https://img.shields.io/pypi/v/pyfilechoose.svg)](https://pypi.org/project/pyfilechoose/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pyfilechoose.svg)](https://pypi.org/project/pyfilechoose/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+In R, `file.choose()` opens a file picker and returns the path you select.
+`pyfilechoose` gives you the same one-liner in Python, with no GUI boilerplate
+and no leftover Tk windows.
+
+It uses `tkinter` from the standard library, so it has no third-party
+dependencies.
+
+## Installation
+
+With pip:
+
+```bash
+pip install pyfilechoose
+```
+
+With [uv](https://docs.astral.sh/uv/):
+
+```bash
+# Add it to your project
+uv add pyfilechoose
+
+# ...or install it into the current environment
+uv pip install pyfilechoose
+
+# ...or run a one-off script that uses it, no install needed
+uv run --with pyfilechoose your_script.py
+```
+
+On Linux, `tkinter` ships with most Python builds but may need to be installed
+separately, e.g. `sudo apt install python3-tk`.
+
+## Usage
+
+### Pick a single file
+
+```python
+from pyfilechoose import file_choose
+
+path = file_choose()
+print(path)  # absolute path of the file you selected
+```
+
+### With pandas (the classic R workflow)
+
+`file_choose()` returns a path string, so it works with any function that takes
+a file path, including `pd.read_csv`:
+
+```python
+import pandas as pd
+from pyfilechoose import file_choose
+
+# Just like df <- read.csv(file.choose()) in R
+df = pd.read_csv(file_choose())
+```
+
+You can still pass the usual pandas options, and filter the picker to CSVs:
+
+```python
+df = pd.read_csv(file_choose(filetypes=[("CSV files", "*.csv")]), sep=";")
+```
+
+### Filter file types and set a starting directory
+
+```python
+path = file_choose(
+    title="Pick your dataset",
+    filetypes=[("CSV files", "*.csv"), ("All files", "*.*")],
+    initialdir="~/Documents",
+)
+```
+
+### Pick several files at once
+
+```python
+from pyfilechoose import files_choose
+
+paths = files_choose(filetypes=[("Images", "*.png *.jpg")])
+for p in paths:
+    print(p)
+```
+
+## API
+
+### `file_choose(*, title="Select a file", filetypes=None, initialdir=None) -> str`
+
+Opens a dialog and returns the absolute path of the chosen file.
+Raises `FileNotFoundError` if the user cancels.
+
+### `files_choose(*, title="Select one or more files", filetypes=None, initialdir=None) -> list[str]`
+
+Same as above but allows multiple selections; returns a list of absolute paths.
+Raises `FileNotFoundError` if nothing is selected.
+
+| Argument     | Type                          | Description                                               |
+| ------------ | ----------------------------- | --------------------------------------------------------- |
+| `title`      | `str`                         | Title of the dialog window.                               |
+| `filetypes`  | `list[tuple[str, str]]` \| `None` | `(label, pattern)` pairs, e.g. `[("CSV", "*.csv")]`.  |
+| `initialdir` | `str` \| `None`               | Directory the dialog opens in.                            |
+
+## Development
+
+```bash
+git clone https://github.com/Pinto-Katende-Jonathan/pyfilechoose.git
+cd pyfilechoose
+```
+
+With uv, which creates and manages the virtualenv for you:
+
+```bash
+uv sync --extra dev   # set up the environment with dev dependencies
+uv run pytest         # run the test suite
+```
+
+With pip:
+
+```bash
+python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © Jonathan Katende Pinto

pyfilechoose-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyfilechoose"
+version = "0.1.0"
+description = "A simple replication of R's file.choose() for Python."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name = "Jonathan Katende Pinto", email = "katendepinto@gmail.com" },
+]
+keywords = ["file", "dialog", "tkinter", "file.choose", "R", "filedialog"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: User Interfaces",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0"]
+
+[project.urls]
+Homepage = "https://github.com/Pinto-Katende-Jonathan/pyfilechoose"
+Repository = "https://github.com/Pinto-Katende-Jonathan/pyfilechoose"
+Issues = "https://github.com/Pinto-Katende-Jonathan/pyfilechoose/issues"
+Changelog = "https://github.com/Pinto-Katende-Jonathan/pyfilechoose/blob/main/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pyfilechoose = ["py.typed"]

pyfilechoose-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyfilechoose-0.1.0/src/pyfilechoose/__init__.py

@@ -0,0 +1,12 @@
+"""pyfilechoose - R's ``file.choose()``, reimplemented for Python.
+
+Open a native file-selection dialog and get back an absolute path:
+
+    >>> from pyfilechoose import file_choose
+    >>> path = file_choose()
+"""
+
+from .core import file_choose, files_choose
+
+__all__ = ["file_choose", "files_choose"]
+__version__ = "0.1.0"

pyfilechoose-0.1.0/src/pyfilechoose/core.py

@@ -0,0 +1,149 @@
+"""Core implementation of :func:`file_choose` and :func:`files_choose`.
+
+These functions open a native "Open file" dialog using :mod:`tkinter`
+(part of the Python standard library) and return the selected path(s).
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Iterable, Optional, Sequence, Tuple
+
+__all__ = ["file_choose", "files_choose"]
+
+# Type alias for the ``filetypes`` argument, e.g. ``[("CSV files", "*.csv")]``.
+FileTypes = Sequence[Tuple[str, str]]
+
+
+def _open_dialog(
+    *,
+    multiple: bool,
+    title: str,
+    filetypes: Optional[FileTypes],
+    initialdir: Optional[str],
+):
+    """Open a Tkinter file dialog and return the raw selection.
+
+    A hidden root window is created, forced to the foreground, used for a
+    single dialog, then destroyed so no resources leak.
+    """
+    # Imported lazily so that merely importing the package does not require
+    # a working Tk installation (e.g. on a headless server).
+    try:
+        import tkinter as tk
+        from tkinter import filedialog
+    except ImportError as exc:  # pragma: no cover - platform dependent
+        raise RuntimeError(
+            "tkinter is not available in this Python installation. "
+            "On Linux install it with your package manager, e.g. "
+            "'sudo apt install python3-tk'."
+        ) from exc
+
+    root = tk.Tk()
+    root.withdraw()
+    # Force the dialog to appear on top of other windows.
+    root.wm_attributes("-topmost", 1)
+
+    options = {"title": title}
+    if filetypes is not None:
+        options["filetypes"] = list(filetypes)
+    if initialdir is not None:
+        options["initialdir"] = initialdir
+
+    try:
+        if multiple:
+            selection = filedialog.askopenfilenames(**options)
+        else:
+            selection = filedialog.askopenfilename(**options)
+    finally:
+        # Always release the Tk resources, even if the dialog raises.
+        root.destroy()
+
+    return selection
+
+
+def file_choose(
+    *,
+    title: str = "Select a file",
+    filetypes: Optional[FileTypes] = None,
+    initialdir: Optional[str] = None,
+) -> str:
+    """Open a dialog and return the absolute path of the chosen file.
+
+    A small replication of R's ``file.choose()`` for Python.
+
+    Parameters
+    ----------
+    title:
+        Title shown in the dialog window.
+    filetypes:
+        Optional sequence of ``(label, pattern)`` pairs used to filter the
+        files shown, e.g. ``[("CSV files", "*.csv"), ("All files", "*.*")]``.
+    initialdir:
+        Directory the dialog should open in. Defaults to the platform's
+        last-used directory.
+
+    Returns
+    -------
+    str
+        The absolute path of the selected file.
+
+    Raises
+    ------
+    FileNotFoundError
+        If the user cancels the dialog without selecting a file.
+
+    Examples
+    --------
+    >>> import pandas as pd
+    >>> df = pd.read_csv(file_choose(filetypes=[("CSV files", "*.csv")]))
+    """
+    file_path = _open_dialog(
+        multiple=False,
+        title=title,
+        filetypes=filetypes,
+        initialdir=initialdir,
+    )
+
+    # askopenfilename returns an empty string when the user cancels.
+    if not file_path:
+        raise FileNotFoundError("No file was selected.")
+
+    return os.path.abspath(file_path)
+
+
+def files_choose(
+    *,
+    title: str = "Select one or more files",
+    filetypes: Optional[FileTypes] = None,
+    initialdir: Optional[str] = None,
+) -> list[str]:
+    """Open a dialog allowing multiple selections and return absolute paths.
+
+    Parameters
+    ----------
+    title, filetypes, initialdir:
+        See :func:`file_choose`.
+
+    Returns
+    -------
+    list of str
+        Absolute paths of every selected file, in selection order.
+
+    Raises
+    ------
+    FileNotFoundError
+        If the user cancels the dialog without selecting any file.
+    """
+    selection: Iterable[str] = _open_dialog(
+        multiple=True,
+        title=title,
+        filetypes=filetypes,
+        initialdir=initialdir,
+    )
+
+    paths = [os.path.abspath(p) for p in selection]
+    if not paths:
+        raise FileNotFoundError("No file was selected.")
+
+    return paths

pyfilechoose-0.1.0/src/pyfilechoose.egg-info/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: pyfilechoose
+Version: 0.1.0
+Summary: A simple replication of R's file.choose() for Python.
+Author-email: Jonathan Katende Pinto <katendepinto@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Pinto-Katende-Jonathan/pyfilechoose
+Project-URL: Repository, https://github.com/Pinto-Katende-Jonathan/pyfilechoose
+Project-URL: Issues, https://github.com/Pinto-Katende-Jonathan/pyfilechoose/issues
+Project-URL: Changelog, https://github.com/Pinto-Katende-Jonathan/pyfilechoose/blob/main/CHANGELOG.md
+Keywords: file,dialog,tkinter,file.choose,R,filedialog
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# pyfilechoose
+
+R's `file.choose()`, reimplemented for Python.
+
+[![PyPI version](https://img.shields.io/pypi/v/pyfilechoose.svg)](https://pypi.org/project/pyfilechoose/)
+[![Python versions](https://img.shields.io/pypi/pyversions/pyfilechoose.svg)](https://pypi.org/project/pyfilechoose/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+In R, `file.choose()` opens a file picker and returns the path you select.
+`pyfilechoose` gives you the same one-liner in Python, with no GUI boilerplate
+and no leftover Tk windows.
+
+It uses `tkinter` from the standard library, so it has no third-party
+dependencies.
+
+## Installation
+
+With pip:
+
+```bash
+pip install pyfilechoose
+```
+
+With [uv](https://docs.astral.sh/uv/):
+
+```bash
+# Add it to your project
+uv add pyfilechoose
+
+# ...or install it into the current environment
+uv pip install pyfilechoose
+
+# ...or run a one-off script that uses it, no install needed
+uv run --with pyfilechoose your_script.py
+```
+
+On Linux, `tkinter` ships with most Python builds but may need to be installed
+separately, e.g. `sudo apt install python3-tk`.
+
+## Usage
+
+### Pick a single file
+
+```python
+from pyfilechoose import file_choose
+
+path = file_choose()
+print(path)  # absolute path of the file you selected
+```
+
+### With pandas (the classic R workflow)
+
+`file_choose()` returns a path string, so it works with any function that takes
+a file path, including `pd.read_csv`:
+
+```python
+import pandas as pd
+from pyfilechoose import file_choose
+
+# Just like df <- read.csv(file.choose()) in R
+df = pd.read_csv(file_choose())
+```
+
+You can still pass the usual pandas options, and filter the picker to CSVs:
+
+```python
+df = pd.read_csv(file_choose(filetypes=[("CSV files", "*.csv")]), sep=";")
+```
+
+### Filter file types and set a starting directory
+
+```python
+path = file_choose(
+    title="Pick your dataset",
+    filetypes=[("CSV files", "*.csv"), ("All files", "*.*")],
+    initialdir="~/Documents",
+)
+```
+
+### Pick several files at once
+
+```python
+from pyfilechoose import files_choose
+
+paths = files_choose(filetypes=[("Images", "*.png *.jpg")])
+for p in paths:
+    print(p)
+```
+
+## API
+
+### `file_choose(*, title="Select a file", filetypes=None, initialdir=None) -> str`
+
+Opens a dialog and returns the absolute path of the chosen file.
+Raises `FileNotFoundError` if the user cancels.
+
+### `files_choose(*, title="Select one or more files", filetypes=None, initialdir=None) -> list[str]`
+
+Same as above but allows multiple selections; returns a list of absolute paths.
+Raises `FileNotFoundError` if nothing is selected.
+
+| Argument     | Type                          | Description                                               |
+| ------------ | ----------------------------- | --------------------------------------------------------- |
+| `title`      | `str`                         | Title of the dialog window.                               |
+| `filetypes`  | `list[tuple[str, str]]` \| `None` | `(label, pattern)` pairs, e.g. `[("CSV", "*.csv")]`.  |
+| `initialdir` | `str` \| `None`               | Directory the dialog opens in.                            |
+
+## Development
+
+```bash
+git clone https://github.com/Pinto-Katende-Jonathan/pyfilechoose.git
+cd pyfilechoose
+```
+
+With uv, which creates and manages the virtualenv for you:
+
+```bash
+uv sync --extra dev   # set up the environment with dev dependencies
+uv run pytest         # run the test suite
+```
+
+With pip:
+
+```bash
+python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE) © Jonathan Katende Pinto

pyfilechoose-0.1.0/src/pyfilechoose.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/pyfilechoose/__init__.py
+src/pyfilechoose/core.py
+src/pyfilechoose/py.typed
+src/pyfilechoose.egg-info/PKG-INFO
+src/pyfilechoose.egg-info/SOURCES.txt
+src/pyfilechoose.egg-info/dependency_links.txt
+src/pyfilechoose.egg-info/requires.txt
+src/pyfilechoose.egg-info/top_level.txt
+tests/test_core.py

pyfilechoose-0.1.0/src/pyfilechoose.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyfilechoose-0.1.0/src/pyfilechoose.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[dev]
+pytest>=7.0

pyfilechoose-0.1.0/src/pyfilechoose.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyfilechoose

pyfilechoose-0.1.0/tests/test_core.py

@@ -0,0 +1,68 @@
+"""Tests for pyfilechoose.
+
+The Tk dialog itself is replaced with a fake so the suite can run headless
+(in CI, without a display). We only verify the logic around the dialog:
+absolute-path conversion, cancellation handling, and argument forwarding.
+"""
+
+import os
+
+import pytest
+
+from pyfilechoose import core, file_choose, files_choose
+
+
+def test_file_choose_returns_absolute_path(tmp_path, monkeypatch):
+    target = tmp_path / "data.csv"
+    target.write_text("a,b\n1,2\n")
+
+    monkeypatch.setattr(core, "_open_dialog", lambda **kwargs: str(target))
+
+    result = file_choose()
+    assert result == os.path.abspath(str(target))
+    assert os.path.isabs(result)
+
+
+def test_file_choose_raises_on_cancel(monkeypatch):
+    # An empty string is what Tk returns when the user cancels.
+    monkeypatch.setattr(core, "_open_dialog", lambda **kwargs: "")
+
+    with pytest.raises(FileNotFoundError):
+        file_choose()
+
+
+def test_file_choose_forwards_arguments(monkeypatch):
+    captured = {}
+
+    def fake(**kwargs):
+        captured.update(kwargs)
+        return "/some/file.csv"
+
+    monkeypatch.setattr(core, "_open_dialog", fake)
+
+    file_choose(
+        title="Pick one",
+        filetypes=[("CSV", "*.csv")],
+        initialdir="/tmp",
+    )
+
+    assert captured["multiple"] is False
+    assert captured["title"] == "Pick one"
+    assert captured["filetypes"] == [("CSV", "*.csv")]
+    assert captured["initialdir"] == "/tmp"
+
+
+def test_files_choose_returns_list(monkeypatch):
+    monkeypatch.setattr(
+        core, "_open_dialog", lambda **kwargs: ("/a/one.txt", "/b/two.txt")
+    )
+
+    result = files_choose()
+    assert result == [os.path.abspath("/a/one.txt"), os.path.abspath("/b/two.txt")]
+
+
+def test_files_choose_raises_on_empty(monkeypatch):
+    monkeypatch.setattr(core, "_open_dialog", lambda **kwargs: ())
+
+    with pytest.raises(FileNotFoundError):
+        files_choose()