✅ Add only modified files to the staging area
Use case: You're using Git and your files are ready to commit. But when you run git commit
, your pre-commit
Git Hook runs a formatting tool that changes your files again. Now you have to run git add
again, but only for the changed files, since you don't want to add untracked files yet. That's boring, I know. Fortunately, now you can use restage
for that.
👉 restage
adds only modified files to the staging area.
Note: There are similar tools for JavaScript, such as lint-staged, that can be used for this purpose. restage
aims at projects that do not need to use JavaScript.
Requires only PHP 7.0+ and Git
composer require phputil/restage --dev
php vendor/bin/restage
You probably want to include the above command into your Git Hook (e.g. pre-commit
), to be executed after a command that formats your source code. For instance, php vendor/bin/php-cs-fixer && php vendor/bin/restage
.
--help This help.
--all, -a List untracked files and modified staged files.
--dry-run, -d Simulate the command without actually doing anything.
--modified, -m List modified staged files.
--verbose, -v Enable verbose mode.
👉 If you wanna run a linter/formatter in modified files, you can use --modified
to get them.
- Captain Hook can manage your Git Hooks.
- PHP-CS-Fixer can format your source code.
- PHP Code Sniffer is an alternative to PHP-CS-Fixer.