par2cmdline-turbo

1.4.0 verified Fri May 01 auth: no python

Python bindings for par2cmdline-turbo, a multithreaded PAR2 recovery tool. Version 1.4.0 supports creating, verifying, and repairing PAR2 parity files. Maintained by brenthuisman.

pip install par2cmdline-turbo

Common errors

error ModuleNotFoundError: No module named 'par2cmdline_turbo' ↓

cause You installed 'par2cmdline' instead of 'par2cmdline-turbo'.

fix

Run: pip install par2cmdline-turbo

error OSError: [Errno 2] No such file or directory: 'par2' ↓

cause The native par2cmdline-turbo binary is not installed or not in PATH.

fix

Ensure the binary is installed: 'sudo apt install par2cmdline-turbo' or 'brew install par2cmdline-turbo'.

error RuntimeError: create() missing required argument: 'redundancy' ↓

cause The 'redundancy' parameter is mandatory in create().

fix

Provide redundancy as a percentage (1-100) or integer number of blocks.

Warnings

deprecated The function 'turbo_par2.create_par2()' was renamed to 'turbo_par2.create()' in version 1.4.0. Old name still works but will be removed. ↓

fix Use 'turbo_par2.create()' instead.

gotcha The C++ backend par2cmdline-turbo must be installed separately on some systems (e.g., via apt or brew). The Python package only provides bindings. ↓

fix Install the native binary: 'sudo apt install par2cmdline-turbo' (Linux) or 'brew install par2cmdline-turbo' (macOS).

breaking In version 1.4.0, the function signature 'turbo_par2.repair()' changed: the 'output_dir' parameter is now required (was optional). ↓

fix Always pass 'output_dir' to 'repair()'.

Imports

turbo_par2
wrong
```
import par2cmdline
```
correct
```
from par2cmdline_turbo import turbo_par2
```
The correct package is 'par2cmdline-turbo', not 'par2cmdline'.

Quickstart

Create, verify, and repair PAR2 files using turbo_par2 functions.

from par2cmdline_turbo import turbo_par2

# Create PAR2 files
turbo_par2.create(
    data_files=['important.txt'],
    redundancy=5,
    output_par2_file='important.par2'
)

# Verify PAR2 files
turbo_par2.verify('important.par2')

# Repair files
turbo_par2.repair('important.par2', output_dir='./repaired')