Skip to main content

Union copier:copy files from one or more dirs to target and autorename files if same already presents

Project description

Union copier:

PyPI version

Default copy behavior offer to skip or replace files which names already existed in the target directory This script allowed to copy files from one or more directories at once to target directory with union mode; if a file with same name present in the destination directory, then the file will be renamed with a unique suffix


  • symlinks are ignored


python3 -m pip install --user ucopy


Definition: ucopy sourcepath destpath [-e allowed_extensions] or [-x excluded_extensions] [-v|--verbose]

Example 1: copy only png files, show progress log

ucopy /src/path/ /dest/path/ -e png --verbose

Example 2: copy files with extensions .png .jpg .txt

ucopy /src/path/ /dest/path/ -e .png,.jpg,.txt

Example 3: copy all files, but exclude ones with .zip and .gz extensions

ucopy /src/path/ /dest/path/ -x zip,tar.gz

Example 4: copy all files without restriction

ucopy /src/path/ /dest/path/ -e *

Example 5: copy from multiple source directories matched by glob pattern

ucopy /src/path/*/some/*/ /dest/path/

Note: You can specify file extensions with or without dots

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ucopy-1.0.1.tar.gz (3.7 kB view hashes)

Uploaded source

Built Distribution

ucopy-1.0.1-py3-none-any.whl (5.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page