This repository has been archived on 2024-07-19. You can view files and clone it, but cannot push or open issues or pull requests.
carboncopy/README.md
Marc Cataford 276b9e339c
Setting up CI (#3)
* infra: boilerplate CI

* ci: workflow name

* chore: typo

* docs: badges

* docs: status badge
2020-01-05 16:39:37 -05:00

1.9 KiB

carboncopy

Keep your repositories up-to-date with their templates in a few keystrokes.

CarbonCopy CICD PyPi version Wheel License Status

Why carboncopy?

Github Template Repositories made it really easy to skip project boilerplate setup steps and to produce "new project kits" that ensure that all your (or your organization's) new projects have all the must-haves. Problem is, templates aren't set in stone and it's likely that templates get updated after some projects have been spawned from it.

Because template repositories are different than forks, you can't simply rebase your project to gulp in the latest templated goodies -- leaving you with the gnarly task of manually moving files over. No more.

With carboncopy, you are one command away from pulling in the latest changes from your template repositories as if it were a regular base branch. You can configure it via its RC file to ignore certain files from the template, and more!

📦 Installation

As it is not yet published on PyPi, you can simply clone this repository and use pip install <path> to install it in your local environment.

🔨 Usage

From your repository, simply type carboncopy in your terminal to bring up a prompt asking you what to pull from your template repository. Any change made is left as an unstaged change so you can commit and merge it however you want.

⚙ Configuration

You can configure the way carboncopy handles your template's contents by creating a .carboncopyrc file at the root of your repository. Documentation TBD. See src/carboncopy/config_defaults.py for general layout.