.. default-domain:: bash

==========================
J.U.S.T. Archive Functions
==========================

.. file:: just_archive.bsh

git archive plugin for just

.. envvar:: JUST_ARCHIVE_FILE

Default archive file.

.. seealso::

  :func:`git-archive-recursive`

.. envvar:: JUST_ARCHIVE_DIR

Default archive directory containing git repo.

.. seealso::

  :func:`git-archive-recursive`

.. function:: git-archive-recursive

Recursive ``git archive`` on current repo including submodules, saving result to a tarball. The archive will be created from the current repo (i.e., ``HEAD``) & current submodules (i.e., ``HEAD`` of each submodule)

:Arguments: * [``-o|--output {file}``] - Output archive file
            * [``--overwrite``] - Overwrite existing archive file
            * [``-C {path}``] - Run as if git was started in ``<path>`` instead of the current working directory.

:Output: * archive_extra_args - number of arguments consumed


.. function:: archive_defaultify

Archive plugin for just