semvec/pypi-packages huggingface dataset:
jaraco.vcs 2.4.1
Facilities for working with VCS repositories
Requires Python: >=3.9

.. image:: https://img.shields.io/pypi/v/jaraco.vcs.svg
   :target: https://pypi.org/project/jaraco.vcs

.. image:: https://img.shields.io/pypi/pyversions/jaraco.vcs.svg

.. image:: https://github.com/jaraco/jaraco.vcs/actions/workflows/main.yml/badge.svg
   :target: https://github.com/jaraco/jaraco.vcs/actions?query=workflow%3A%22tests%22
   :alt: tests

.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json
    :target: https://github.com/astral-sh/ruff
    :alt: Ruff

.. .. image:: https://readthedocs.org/projects/PROJECT_RTD/badge/?version=latest
..    :target: https://PROJECT_RTD.readthedocs.io/en/latest/?badge=latest

.. image:: https://img.shields.io/badge/skeleton-2025-informational
   :target: https://blog.jaraco.com/skeleton

Usage
=====

jaraco.vcs
provides classes for inspecting and working with repositories in the
Mercurial and Git version control systems (VCS).

The classes provided are designed to use subprocess invocation to
leverage the command-line interfaces of the VCS tools ``hg`` and ``git``. An
in-process Repo for Mercurial exists but has been disabled due to
issues that arise when run in certain environments (namely setuptools
sandboxing).

Auto Version Numbering
----------------------

This project adds support for automatically generating
project version numbers from a source code repository under
development.

To use this feature, the project must follow the following assumptions:

- Repo tags are used to indicate released versions.
- Tag names are specified as the version only (i.e. 0.1 or v0.1 and
  not release-0.1)
- Released versions currently must conform to the Version in
  `packaging <https://pypi.org/project/packaging>`_. Any tags
  that don't match this scheme will be ignored.

Thereafter, use the Repo.get_current_version to
determine the version of the local code. If the current revision is tagged
with a valid version, that version will be used. Otherwise, the tags in
the repo will be searched, the latest release will be found, and the
function will infer the upcoming release version.

For example, if the repo contains the tags 0.1, 0.2, and 0.3 and the
repo is not on any of those tags, get_current_version will return
'0.3.1dev' and get_current_version(increment='0.1') will return
'0.4dev'.

Example::

    >>> import jaraco.vcs
    >>> jaraco.vcs.repo().get_current_version()
    '9.0.1.dev0'
carecopy 1.0
carecopy: A simple file copy and comparison tool that allows to copy files and directories, compare files and directories, and estimate the time it will take to copy files.

# CareCopy: a desktop application for safely copying files and directories with verification capabilities.

version: 1.0

## Features

- **File and Directory Operations**
  - Copy files or entire directory structures
  - Compare files and directories to identify differences
  - Estimate copy time and size before operation

- **Advanced Options**
  - Verify file integrity after copying (using MD5 hash comparison)
  - Continue copying even when errors occur with specific files
  - Real-time progress tracking

- **User-Friendly Interface**
  - Simple and intuitive GUI built with PySide6
  - Detailed logging of operations
  - Cancel operations in progress

## Screenshots

*[Add screenshots here]*

## Requirements

- Python 3.12+
- PySide6

## Installation

### Clone the Repository

```bash
git clone https://github.com/EasyCam/CareCopy.git
cd CareCopy
python -m pip install -r requirements.txt
python -m carecopy
```

### Pip Installation

```bash
# Install dependencies
pip install PySide6
pip install carecopy

# Run the application
python -m carecopy
```

## Usage

1. **Select Source**: Choose a file or directory to copy
2. **Select Destination**: Choose where to copy the file(s)
3. **Configure Options**:
   - Continue on error: Continue copying if individual files fail
   - Verify copied files: Ensure file integrity after copy
4. **Execute Operation**:
   - Copy: Start copying files
   - Compare: Compare source and destination
   - Estimate: Calculate size and estimated time
   - Cancel: Stop current operation

## How It Works

CareCopy uses multithreaded operations to ensure the UI stays responsive during file operations. The application includes:

- `CopyWorker`: Handles file copying with optional verification
- `CompareWorker`: Performs detailed comparison between files/directories
- `EstimateWorker`: Calculates file sizes and estimated copy times

## License

This project is licensed under the GNU General Public License v3.0 (GPLv3).

- You are free to use, modify, and distribute this software.
- If you modify the software, you must distribute your contributions under the same license.
- You must disclose your source code when distributing the software.
- The software comes with no warranty.

For more details, see [the full GPLv3 license](https://www.gnu.org/licenses/gpl-3.0.en.html).