Retrocookie updates Cookiecutter templates with changes from their instances.
When developing Cookiecutter templates, you often need to work in a generated project rather than the template itself. Reasons for this include the following:
- You need to run the Continuous Integration suite for the generated project
- Your development tools choke when running on the templated project
Any changes you make in the generated project
need to be backported into the template,
carefully replacing expanded variables from cookiecutter.json
by templating tags,
and escaping any use of {{
and }}
or other tokens with special meaning in Jinja.
Retrocookie helps you in this situation.
It is designed to fetch commits from the repository of a generated project, and import them into your Cookiecutter repository, rewriting them on the fly to insert templating tags, escape Jinja-special constructs, and place files in the template directory.
Under the hood, Retrocookie rewrites the selected commits using git-filter-repo, saving them to a temporary repository. It then fetches and cherry-picks the rewritten commits from the temporary repository into the Cookiecutter template, using pygit2.
Maybe you're thinking, how can this possibly work? One cannot reconstruct a Jinja template from its rendered output. However, simple replacements of template variables work well in practice when you're only importing a handful of commits at a time.
- Python 3.7+
- git >= 2.22.0
You can install Retrocookie via pip from PyPI:
$ pip install retrocookie
The basic form:
$ retrocookie <repository> [<commits>...] $ retrocookie <repository> -b <branch> [--create]
The <repository>
is a filesystem path to the source repository.
For <commits>
, see gitrevisions(7).
Import HEAD
from <repository>
:
$ retrocookie <repository>
Import the last two commits:
$ retrocookie <repository> HEAD~2..
Import by commit hash:
$ retrocookie <repository> 53268f7 6a3368a c0b4c6c
Import commits from branch topic
:
$ retrocookie <repository> --branch=topic
Equivalently:
$ retrocookie <repository> master..topic
Import commits from topic
into a branch with the same name:
$ retrocookie <repository> --branch=topic --create
Equivalently, using short options:
$ retrocookie <repository> -cb topic
Import commits from branch topic
, which was branched off 1.0
:
$ retrocookie <repository> --branch=topic --upstream=1.0
Equivalently:
$ retrocookie <repository> 1.0..topic
Import HEAD
into a new branch topic
:
$ retrocookie <repository> --create-branch=topic
Contributions are very welcome. To learn more, see the Contributor Guide.
Distributed under the terms of the MIT license, Retrocookie is free and open source software.
If you encounter any problems, please file an issue along with a detailed description.
This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.