Skip to main content

Checkout repos to current cookiecutter config

Project description

License PyPI Build CodeQL pre-commit.ci status codecov.io readthedocs.org python3.8 Black isort docformatter pylint Security Status Known Vulnerabilities repocutter

Checkout repos to current cookiecutter config

Checkout one or more repos to current cookiecutter config

This will make changes to local repositories, hopefully preserving their history

Ideally only the working tree will change

Ignored files should be backed up

Use with caution

Usage

usage: repocutter [-h] [-v] [-a] [-c] [-b REV,NEW] [-i LIST] PATH [REPOS [REPOS ...]]

Checkout repos to current cookiecutter config

positional arguments:
  PATH                          path to cookiecutter template dir
  REPOS                         repos to run cookiecutter over

optional arguments:
  -h, --help                    show this help message and exit
  -v, --version                 show program's version number and exit
  -a, --accept-hooks            accept pre/post hooks
  -c, --gc                      clean up backups from previous runs
  -b REV,NEW, --branch REV,NEW  checkout new branch from existing revision
  -i LIST, --ignore LIST        comma separated list of paths to ignore, cookiecutter vars are allowed

Configuration

Currently only written for a configuration exactly like below

Technically a repo would not need to be a poetry project if the below section exists within its pyproject.toml file

This is the only use case at this time (If there are any other configurations you would like added please leave an issue)

Each repository’s pyproject.toml file will be parsed for data to recreate its working tree

A poetry section in the project’s pyproject.toml file that looks like the following…

[tool.poetry]
description = "Checkout repos to current cookiecutter config"
keywords = [
  "config",
  "cookiecutter",
  "jinja2",
  "repo",
  "template"
]
name = "repocutter"
version = "0.2.0"

…will temporarily write to the cookiecutter project’s cookiecutter.json file until the repo is created

{
  "project_name": "repocutter",
  "project_version": "0.2.0",
  "project_description": "Checkout repos to current cookiecutter config",
  "project_keywords": "config,cookiecutter,jinja2,repo,template",
}

The above configuration will reduce the diff, but it will still work if your config is not exactly the same

Why?

As time goes on, and you use cookiecutter for new projects, you will make more and more changes to your cookiecutter repo

You will find these new project layouts are preferable to your older, more outdated, projects

If you have a project layout configured with cookiecutter then it’s likely you will want this layout for all your projects

Configuring your existing projects manually is even more tedious than configuring a new project manually, especially if you have a lot of them

By checking out your projects to your configured cookiecutter layout, you can use whatever diff tool you use to rollback any undesired changes

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

repocutter-0.6.2.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

repocutter-0.6.2-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file repocutter-0.6.2.tar.gz.

File metadata

  • Download URL: repocutter-0.6.2.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.8.13 Darwin/22.6.0

File hashes

Hashes for repocutter-0.6.2.tar.gz
Algorithm Hash digest
SHA256 fe81ee780cfcdfb3d75277e077cd6f4798e3e47ba83786129b1982db73584339
MD5 ef1101a0017d187e7e3f4a50f3c8a385
BLAKE2b-256 728bb9e478b36704688b6612d28afb1e3f38c2515d30a001633e888f4740d333

See more details on using hashes here.

File details

Details for the file repocutter-0.6.2-py3-none-any.whl.

File metadata

  • Download URL: repocutter-0.6.2-py3-none-any.whl
  • Upload date:
  • Size: 8.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.8.13 Darwin/22.6.0

File hashes

Hashes for repocutter-0.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2845070a0298b614bd371197a341e6450f1cf29d98587740a6093d1099024340
MD5 8b649632847a183fcb7bdb2b234192b8
BLAKE2b-256 0f3752e319e54456eb6cf8ecd2ef45a64625f68fec10fc05e2d82e63221d678f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page