Git plugin for exporting the changed files between the current HEAD and an older commit as an archive.
It's useful for projects where you need to package updates to an existing codebase, but for some reason there is no CI/CD or GIT available on the destination server.
It's for those times when you still want to have a git-based workflow for development, and not have to hunt inside your project for files that need to be updated (mostly for legacy projects or clients with limited infrastructure - at least in my use case).
The plugin will find all files that have changes between your project's HEAD and an older commit and package them nicely inside an archive - except deleted files, you don't neet those anyway :)
You can then extract the archive on your destination server, inside the root folder of your project, and just overwrite the files contained in your archive.
Disclamer: I know, I know, this is bad practice, just upgrade your workflow, upgrade your infrastructure, upgrade your clients etc... But we all know sometimes you just gotta make do with what you have :)
NOTE: all archives created will have the current timestamp appended to the filename.
- Download or clone the current repository.
cd git-diff-archivemake install
NOTE: The plugin executable will be install in ~/bin, so it will only be available to the current user (for now).
cd /path/to/git-diff-archive(the one you downloaded earlier, or a fresh copy)make uninstall
Open a terminal and navigate to your git project's working directory, then use as you would any other git command:
git diff-archive [<options>] [<commit>]
| -d, --destination | Path to folder in which tp save the archive |
| -n, --name | Name of the exported archive (without extension) |
| -f, --format | Archive format (tar or zip - default: zip) |
| -s, --stamp | Append revision info to the archive's file name |
| -v, --version | Display current plugin version |
| -h, --help | Display information about usage in the terminal |
git diff-archive 702b3f - Will generate an archive with the changed files between HEAD and the commit with the short hash id of 702b3f
git diff-archive v1.0.0 - Will generate an archive with the changed files between HEAD and the commit tagged with v1.0.0
git diff-archive -h - Will display usage information
git diff-archive -v - Will display the current plugin version
git diff-archive --format tar - Will generate a .tar archive
git diff-archive -n my_archived_changes - Will generate an archive named my_archived_changes.zip
git diff-archive --stamp - Will add the short hashes of the 2 commits in use in the archive file name
git diff-archive -d /home/myuser/archives - This will create the archive file in the folder /home/myuser/archives
Please submit any issues, bugs and/or feature requests with as much information about it as possible.
This is something I built for personal use, but I will try to fix any bugs you find if time allows it.
Contributions are absolutely welcome. Ideally submit a pull request, with the following notes:
- Bug Fixes - submit a pull request against the
masterbranch. - Enhancements / New Features - submit a pull request against the
developbranch.