Metadata-Version: 2.1
Name: carboncopy
Version: 0.0.1
Summary: A small CLI utility to keep your repositories up-to-date with their templates
Home-page: https://pypi.org/project/carboncopy/
Author: Marc Cataford
Author-email: c.marcandre@gmail.com
License: MIT
Project-URL: Source, https://github.com/mcataford/carboncopy
Project-URL: Bug Reports, https://github.com/mcataford/carboncopy/issues
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.22.0)
Requires-Dist: inquirer (==2.6.3)

# carboncopy

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

## ❓ Why `carboncopy`?

[Github Template Repositories](https://github.blog/2019-06-06-generate-new-repositories-with-repository-templates/) 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.


