Add support for local files using file URIs

CHANGELOG.md

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+### Added
+
+- Added support for local asset paths using file URIs ([#254](https://github.com/stac-utils/stac-asset/pull/254))
+
 ## [0.4.7] - 2025-06-18
 
 ### Changed

src/stac_asset/filesystem_client.py

@@ -63,7 +63,8 @@ async def open_url(
 
     async def assert_href_exists(self, href: str) -> None:
         """Asserts that an href exists."""
-        if not os.path.exists(href):
+        url = URL(href)
+        if not os.path.exists(url.path):
             raise ValueError(f"href does not exist on the filesystem: {href}")
 
     async def __aenter__(self) -> FilesystemClient:

tests/test_filesystem_client.py

@@ -23,3 +23,8 @@ async def test_download(tmp_path: Path, asset_href: str) -> None:
 async def test_href_exists(asset_href: str) -> None:
     async with FilesystemClient() as client:
         assert await client.href_exists(asset_href)
+
+
+async def test_href_exists_file_uri(asset_href: str) -> None:
+    async with FilesystemClient() as client:
+        assert await client.href_exists(f"file://{asset_href}")