https://github.com/inc44/thesync
Synchronize files between a source directory and a destination directory
https://github.com/inc44/thesync
automation cli command-line-tool conflict-resolution cross-platform data-backup data-integrity file-synchronization linux macos nodependence parallel-processing python windows
Last synced: 3 months ago
JSON representation
Synchronize files between a source directory and a destination directory
- Host: GitHub
- URL: https://github.com/inc44/thesync
- Owner: Inc44
- License: mit
- Created: 2024-02-07T21:26:43.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-02-07T22:36:46.000Z (over 1 year ago)
- Last Synced: 2025-01-22T11:17:19.833Z (5 months ago)
- Topics: automation, cli, command-line-tool, conflict-resolution, cross-platform, data-backup, data-integrity, file-synchronization, linux, macos, nodependence, parallel-processing, python, windows
- Language: Python
- Homepage:
- Size: 69.3 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
This Python script is designed to synchronize files between a source directory and a destination directory. It's implemented in a single file to simplify deployment and usage.
# Features
- **Decision Making**: Choose between automatic syncing or manual user decisions for file conflicts.
- **Date Modification Correction**: Options to fix date modifications on files either in the source or destination directory.
- **Verification**: Verify file integrity through size comparison and optional hash checks.
- **Concurrency**: Supports both serial and parallel processing to optimize performance.
- **Customizable Thread Count**: Allows specification of the number of threads for parallel processing.
# Installation
Download the Python script to your local machine and ensure Python is installed on your system to execute the script, as it's the only external dependency.
# Usage
## Parameters
- `source_directory`: Specifies the source directory from which to sync files.
- `destination_directory`: Specifies the target directory to which files will be synced.
- `--decision_maker (-dm)`: Sets the conflict resolution mode (`user` for manual resolution or `auto` for automatic), with `auto` being the default.
- `--date_modified_fix_source (-dmfs)`: Chooses the directory (`source_directory` or `destination_directory`) whose file modification dates are to be used for synchronization, with `destination_directory` as the default.
- `--date_modified_fix_enabled (-dmfe)`: Toggles the date modification fix feature on or off, with it being enabled by default.
- `--verify_steps (-vs)`: Sets the number of verification steps, with the default set to 0.
- `--verify_hash (-vh)`: Turns on hash verification for a more thorough integrity check, though it is off by default.
- `--parallel_processing_mode (-ppm)`: Enables or disables parallel processing, with it being disabled by default or if manual resolution mode is used.
- `--threads_count (-tc)`: Determines the number of threads to use for parallel processing, with 8 threads as the default.
## Commands
Execute the script from the command line, providing the required directories and any optional parameters:
```bash
python -O thesync.py [options]
```
# How It Works
## Sync Logic
## Sync Conflict Resolution
# License
MIT