cpz

A small, fast, and modern utility command line tool for 'cp/mv' alternative or replacement that written in Go. It's also allows you to filter files based on filenames, extensions, or regular expressions during the copy or move process.

Features

• Copy or move files or directories while showing a progress bar.
• Exclude files based on their names, extensions, or regular expressions.
• Supports concurrency for faster copying or moving.
• Verify files to guarantee that source and destination file are same after copying or moving.

Installation

To install cpz, clone the repository and run the following commands:

git clone https://github.com/Kei-K23/go-cpz.git
cd go-cpz
go build -o cpz

Usage

Copy

cpz cp [source] [destination] [flags]

Arguments

• source: The path of the file or directory to copy.
• destination: The path where the file or directory will be copied.

Flags

• -p, --progress: Show a progress indicator during the copy operation.
• -f, --filter: Exclude files by name. Provide multiple values as a comma-separated list.
• -e, --extensions: Exclude files by extension. Provide multiple extensions as a comma-separated list (e.g., .log, .tmp).
• -r, --regex: Exclude files by regular expression patterns.

Examples

Basic File Copy

cpz cp /path/to/source/file.txt /path/to/destination/file.txt

Directory Copy with Progress Bar

cpz cp /path/to/source/directory /path/to/destination/directory -p

Exclude Files by Name

cpz cp /path/to/source /path/to/destination -f "README.md,.env"

This will exclude files named README.md and .env from being copied.

Exclude Files by Extension

cpz cp /path/to/source /path/to/destination -e ".log,.tmp"

This will exclude files with the .log and .tmp extensions from being copied.

Exclude Files by Regular Expression

cpz cp /path/to/source /path/to/destination -r "^._*backup\.zip$,^old*._"

This will exclude files ending with backup.zip and files starting with old.

Move

cpz mv [source] [destination] [flags]

Arguments

• source: The path of the file or directory to move.
• destination: The path where the file or directory will be moved.

Flags

• -p, --progress: Show a progress indicator during the move operation.
• -f, --filter: Exclude files by name. Provide multiple values as a comma-separated list.
• -e, --extensions: Exclude files by extension. Provide multiple extensions as a comma-separated list (e.g., .log, .tmp).
• -r, --regex: Exclude files by regular expression patterns.

Examples

Basic File Move

cpz mv /path/to/source/file.txt /path/to/destination/file.txt

Directory Move with Progress Bar

cpz mv /path/to/source/directory /path/to/destination/directory -p

Exclude Files by Name

cpz mv /path/to/source /path/to/destination -f "README.md,.env"

This will exclude files named README.md and .env from being moved.

Exclude Files by Extension

cpz mv /path/to/source /path/to/destination -e ".log,.tmp"

This will exclude files with the .log and .tmp extensions from being moved.

Exclude Files by Regular Expression

cpz mv /path/to/source /path/to/destination -r "^._*backup\.zip$,^old*._"

This will exclude files ending with backup.zip and files starting with old.

Verify

cpz verify [source] [destination]

Arguments

• source: The path of the file or directory to verify.
• destination: The path of the file or directory to verify.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributions

Contributions, issues, and feature requests are welcome. Feel free to check the issues page for more information.