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 and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page