Skip to content

Document moves into existing directories - #578

Open
Himanshuagrawal4 wants to merge 1 commit into
fsspec:mainfrom
Himanshuagrawal4:PRO/upath-directory-moves-20261119
Open

Himanshuagrawal4 wants to merge 1 commit into
fsspec:mainfrom
Himanshuagrawal4:PRO/upath-directory-moves-20261119

Conversation

@Himanshuagrawal4

Copy link
Copy Markdown

Description

Explain which operation to use when the destination is already a directory. On file:// and memory:// paths, renaming a file into an existing directory can return the directory rather than the moved file. The guide recommends move_into() for that operation and move() when the target is the new filename. This does not change rename behavior or the planned compatibility work.

Type of Change

  • Documentation update

Testing

  • Exercised rename, move, and move_into against plain Windows paths, file://, and memory:// using temporary files. Checked whether the source stayed put, where it ended up, and which path the method returned.
  • Strict MkDocs build passed. Cloud backends were not tested.

Checklist

  • Documentation updated
  • Full test suite verified

Refs #569.

AI assistance: OpenAI Codex helped prepare the documentation and run the local checks.

@Himanshuagrawal4
Himanshuagrawal4 marked this pull request as ready for review November 18, 2026 19:22

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant