Skip to content

Commit 2fe7cc3

Browse files
committed
Reword something
1 parent 882d6b4 commit 2fe7cc3

2 files changed

Lines changed: 6 additions & 27 deletions

File tree

docs/commands/cp.md

Lines changed: 5 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,10 @@ Copy storage files and directories between cloud and local storage.
55
## Synopsis
66

77
```usage
8-
usage: datachain cp [-h] [-v] [-q] [-r] [--team TEAM] [--local] [--anon] [--update] [--no-glob] [--force] source_path destination_path
8+
usage: datachain cp [-h] [-v] [-q] [-r] [--team TEAM]
9+
[--local] [--anon] [--update]
10+
[--no-glob] [--force]
11+
source_path destination_path
912
```
1013

1114
## Description
@@ -143,33 +146,9 @@ datachain cp --local --force s3://my-bucket/data /path/to/local/
143146
datachain cp --local --update --no-glob s3://my-bucket/data/*.txt /path/to/local/
144147
```
145148

146-
## Limitations and Edge Cases
147-
148-
### Bucket Restrictions
149+
## Limitations
149150
- **Cannot copy between different buckets**: Remote-to-remote copies must be within the same bucket
150-
- **Cross-bucket operations**: Use local as intermediate step for cross-bucket copies
151-
152-
### Directory Operations
153-
- **Recursive flag required**: Copying directories requires the `--recursive` flag
154-
- **Directory structure preservation**: Directory structure is preserved during copy operations
155-
- **Empty directories**: Empty directories may not be copied in some scenarios
156-
157-
158-
### Error Handling
159-
- **File not found**: Missing source files result in operation failure
160-
- **Permission errors**: Insufficient permissions cause operation failure
161-
- **Network issues**: Network problems are reported with appropriate error messages
162-
163-
### Team Configuration
164-
- **Default team**: If no team is specified, uses the team from your configuration
165-
- **Team-specific storage**: Each team has its own storage namespace
166151

167152
## Notes
168-
169-
* Use the `--verbose` flag to get detailed information about the copy operation
170-
* The `--quiet` flag suppresses output except for errors
171153
* When using Studio mode, you must be authenticated with `datachain auth login` before using it
172154
* The `--local` mode bypasses Studio and operates directly with storage providers
173-
* Use `--recursive` flag when copying directories
174-
* The `--force` flag is only available in local mode and will overwrite existing files
175-
* For cross-bucket copies, consider using local storage as an intermediate step

src/datachain/cli/parser/studio.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,7 @@ def add_storage_parser(subparsers, parent_parser) -> None:
156156
"destination_path",
157157
action="store",
158158
help="Path to the destination file or directory to copy",
159-
)
159+
).complete = shtab.DIR # type: ignore[attr-defined]
160160

161161
storage_cp_parser.add_argument(
162162
"-r",

0 commit comments

Comments
 (0)