Deal with .rej
files with reasonable pain
The application is designed to work with .rej files generated during patch application failures or from updating git templates using tools s.a. cookiecutter
or cruft
It provides functionality to either fix these files individually or in bulk, view differences, list them, and clean them up.
The rich library is used for better console output formatting, providing a more user-friendly and visually appealing interface.
It's important to use the commands cautiously, especially fix_all and clean, as they perform bulk operations.
This documentation provides a clear guide on how to interact with the rejx Typer application, making it easier for users to understand and utilize its functionalities.
# Pip
pip install rejx
# Poetry
poetry add rejx
Your Python Typer application, rejx, provides a command line interface (CLI) for managing .rej files, which are typically generated when patches fail to apply cleanly. Below, I'll detail each command, its purpose, and how to use it, including optional arguments.
Purpose: Applies the changes from a specified .rej file to its corresponding original file. Usage:
rejx fix path/to/file.rej
Purpose: Searches for all .rej files in the current directory and subdirectories, then applies their changes to the corresponding original files. Usage:
rejx fix_all
Purpose: Displays the differences between the current files and the changes proposed in the .rej files. Usage:
rejx diff
Note: This command uses a pager for output. Use arrow keys or Vim bindings to navigate, and q to quit.
Purpose: Lists all .rej files in the current directory and subdirectories. By default, it lists files, but can also display them in a tree structure. Usage: For listing files:
rejx ls
For tree view:
rejx ls --view tree
For list view (default):
rejx ls --view list
Purpose: Deletes all .rej files in the current directory and subdirectories. It has an optional preview feature. Usage:
rejx clean
With preview:
rejx clean --preview