/git-attic

git subcommand to manage retired references

Primary LanguagePythonApache License 2.0Apache-2.0

GitHub Workflow Status

git subcommand to manage retired references

Manage an archive of git references such as retired branches. The package provides the git attic subcommand that may be used to move branches to the archive, to restore them, and to push and fetch the archive to and from remote repositories.

The mechanism is to store references using a dedicated prefix that is ignored by other git commands. As a result, the references in the archive are retained in the repository, but do not interfere with daily git workflows. The idea has been borrowed from a reply on Stack Overflow.

System requirements

Python:

  • Python 3.5 or newer

External Programs:

Required library packages:

Optional library packages:

  • setuptools_scm

    The version number is managed using this package. All source distributions add a static text file with the version number and fall back using that if setuptools_scm is not available. So this package is only needed to build out of the plain development source tree as cloned from GitHub.

  • pytest >= 3.9

    Only needed to run the test suite.

  • distutils-pytest

    Only needed to run the test suite.

Copyright and License

Copyright 2021–2022 Rolf Krahl

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.