Skip to main content

A small python program to export files changed between git commits or branches to a zip file retaining the directory structure.

Project description


Export all the changed files between two git commits or branches to a zip file including the directory structure.

gitzip usage

gitzip allows to copy all files that changed between two commits (or branches) into a zip file.

Expect a git repository being at commit 0c321f2. If two new files are created, e.g. and docs/screenshot.jpg, git status gives:

$ git status
On branch master

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        new:        docs/screenshot.jpg

After committing those changes, the command

python -m gitzip 0c321f2

will create a file. This file contains all files that changed between commit 0c321f2 and the current master branch. So in the given example, the zip file will have the following structure:

 ┣ 📂docs
 ┃ ┗ 📜screenshot.jpg
 ┗ 📜

The files will have the contents that are currently checked out in the repository.


Via pip

pip install gitzip

From source

To run this program from the code directly, python and poetry (pip install poetry) are required. Clone or download the repository.

To install all the dependencies, use your command line and navigate to the directory where this README file is located in. Then run

poetry install

For development

For development installation perform the From source installation.

For installing new packages, always run

poetry add <pip-package-name>

instead of pip install <pip-package-name>.

Launch the program either check out the Execution section or use the Run and Debug-side panel of VSCode.

If the interpreter of the virtual environment does not show up in VSCode, add it manually. The virtual environments are located in {cache-dir}/virtualenvs/<venv-name>/Scripts/python.exe where the {cache-dir} depends on the operating system (~/.cache/pypoetry, ~/Library/Caches/pypoetry or C.\Users\%USERNAME%\AppData\Local\pypoetry\Cache).


To execute the program use

poetry run python -m gitzip

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitzip-2.0.1.tar.gz (11.3 kB view hashes)

Uploaded Source

Built Distribution

gitzip-2.0.1-py3-none-any.whl (11.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page