/archive-cp

Non-destructive copy for archival purposes.

Primary LanguagePythonMIT LicenseMIT

Archive Cp

PyPI Status Python Version License

The Ethical Source Principles Contributor Covenant Read the documentation at https://archive-cp.readthedocs.io/ Tests Codecov

pre-commit Black

archive-cp is a small utility intended to be used to copy files with the goal of not losing data, for archival purposes. If files would be the same name in the target directory, and they aren't duplicates, all of them are kept. Duplicates are identified, the oldest of each group of duplicates sharing a name and destdir is selected, of the remaining items, the newest gets the original filename, the others are timestamped to give them unique names.

The fclones tool is required for duplicate file detection.

As the author, my original use of this project was to combine multiple mirrors of old ftp sites without losing old versions of old tools, since it's not always easy to identify which mirror is the most recent, which are complete or incomplete, and even if they're all complete, files got replaced or removed over time, so there's value in being able to merge them.

Features

  • TODO

Requirements

  • TODO

Installation

You can install Archive Cp via pip from PyPI:

$ pip install archive-cp

Usage

Please see the Command-line Reference for details.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, Archive Cp is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.