.. image:: https://img.shields.io/pypi/v/git-archive-all.svg
    :target: https://pypi.python.org/pypi/git-archive-all
    :alt: PyPI
.. image:: https://img.shields.io/homebrew/v/git-archive-all.svg
    :target: https://formulae.brew.sh/formula/git-archive-all
    :alt: Homebrew
.. image:: https://travis-ci.org/Kentzo/git-archive-all.svg?branch=master
    :target: https://travis-ci.org/Kentzo/git-archive-all
    :alt: Travis
.. image:: https://codecov.io/gh/Kentzo/git-archive-all/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/Kentzo/git-archive-all/branch/master
    :alt: Coverage
.. image:: https://img.shields.io/pypi/pyversions/git-archive-all.svg
    :target: https://pypi.python.org/pypi/git-archive-all
    :alt: Supported Python versions
.. image:: https://img.shields.io/pypi/implementation/git-archive-all.svg
    :target: https://pypi.python.org/pypi/git-archive-all
    :alt: Supported Python implementations

Archive repository with all its submodules.

::

    git-archive-all [-v] [--prefix PREFIX] [--no-exclude] [--force-submodules] [--extra EXTRA1 ...] [--dry-run] [-0 | ... | -9] OUTPUT_FILE

    Options:

      --version             Show program's version number and exit.

      -h, --help            Show this help message and exit.

      -v, --verbose         Enable verbose mode.

      --prefix=PREFIX       Prepend PREFIX to each filename in the archive. OUTPUT_FILE name is used by default to avoid tarbomb. You can set it to '' in order to explicitly request tarbomb.

      --no-exclude          Don't read .gitattributes files for patterns containing export-ignore attributes.

      --force-submodules    Force a `git submodule init && git submodule update` at each level before iterating submodules

      --extra               Include extra files to the resulting archive.

      --dry-run             Don't actually archive anything, just show what would be done.

Questions & Answers
-------------------

| Q: How to exclude files?
| A: Mark paths you want to exclude in the .gitattributes file with the export-ignore attribute. Read more on `git-scm.com <https://git-scm.com/docs/gitattributes#_code_export_ignore_code>`_.

Support
-------
If functional you need is missing but you're ready to pay for it, feel free to `contact me <mailto:kulakov.ilya@gmail.com?subject=git-archive-all>`_. If not, create an issue anyway, I'll take a look as soon as I can.
