Be able to `deploy` a git history of a given file

[paulRbr]

Context

Imagine you want to import the history of changes of a given API definition file to Bump.

The current “solution” is to use a manual script to deploy each revision one by one. Very rough-and-not-working oneliner bash script: git log --pretty=format:%H my/definition/openapi.yml | xargs -I % git show '%:my/definition/openapi.yml.

Solution

We should allow the bump deploy command to deploy a git history of a given file. This would simplify our users' initial import work.

e.g. Deploy the my/definition/openapi.yml file to the my-doc documentation would be as simple as:

bump deploy --git-history --doc my doc my/definition/openapi.yml

We could also allow --from / --to options such as:

bump deploy --git-history --from c900e6 --to main --doc my doc my/definition/openapi.yml