Metadata-Version: 2.1
Name: cookiecutter-project-upgrader
Version: 1.0.0
Summary: upgrade projects created from a Cookiecutter template
Home-page: https://github.com/thomasjahoda/cookiecutter_project_upgrader
Author: Thomas Jahoda
Author-email: thomasjahoda@users.noreply.github.com
License: MIT license
Keywords: cookiecutter_project_upgrader
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: cookiecutter
Requires-Dist: click (>=7.0)
Provides-Extra: dev
Requires-Dist: pytest-cookies (>=0.3.0) ; extra == 'dev'
Requires-Dist: pip (>=19.0.2) ; extra == 'dev'
Requires-Dist: bumpversion (>=0.5.3) ; extra == 'dev'
Requires-Dist: wheel (>=0.32.3) ; extra == 'dev'
Requires-Dist: watchdog (>=0.9.0) ; extra == 'dev'
Requires-Dist: flake8 (>=3.6.0) ; extra == 'dev'
Requires-Dist: tox (>=3.6.1) ; extra == 'dev'
Requires-Dist: coverage (>=4.5.2) ; extra == 'dev'
Requires-Dist: Sphinx (>=1.8.3) ; extra == 'dev'
Requires-Dist: twine (>=1.12.1) ; extra == 'dev'
Requires-Dist: pluggy (>=0.7.0) ; extra == 'dev'
Requires-Dist: mypy (>=0.650) ; extra == 'dev'
Requires-Dist: pytest (>=3.8.2) ; extra == 'dev'
Requires-Dist: pytest-runner (>=4.2) ; extra == 'dev'
Requires-Dist: pytest-mock (>=1.10.1) ; extra == 'dev'

=============================
Cookiecutter Project Upgrader
=============================


.. image:: https://img.shields.io/pypi/v/cookiecutter_project_upgrader.svg
        :target: https://pypi.python.org/pypi/cookiecutter_project_upgrader

.. image:: https://img.shields.io/travis/thomasjahoda/cookiecutter_project_upgrader.svg
        :target: https://travis-ci.org/thomasjahoda/cookiecutter_project_upgrader

.. image:: https://readthedocs.org/projects/cookiecutter-project-upgrader/badge/?version=latest
        :target: https://cookiecutter-project-upgrader.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status




upgrade projects created from a Cookiecutter template


* Free software: MIT license
* Documentation: https://cookiecutter-project-upgrader.readthedocs.io.

Features
--------

Cookiecutter Project Upgrader allows for the update of projects that are created using cookiecutter.
When run the first time on a project, it creates a new branch that contains the latest cookiecuttered code,
using a JSON file with context that matches the existing service.
This file can be created through cookiecutter with the following contents:

`{{ cookiecutter | jsonify }}`

The script uses the [Click](https://github.com/pallets/click) framework.

```
Usage: cookiecutter_project_upgrader [OPTIONS]

  Upgrade projects created from a Cookiecutter template

Options:
  -c, --context-file PATH  Default: docs/cookiecutter_input.json
  -b, --branch TEXT        Default: cookiecutter-template
  -m, --merge-now          Execute a git merge after a successful update
  --help                   Show this message and exit.
```

Note that you will need a recent version of git for this to work. (it needs --no-checkout on git worktree)


Auto-Completion
---------------
Because the script uses Click, you can enable completion for Zsh and Bash.

For Bash, add the following to your `.bashrc` or some other profile initialization file.
`eval "$(_COOKIECUTTER_PROJECT_UPGRADER_COMPLETE=source cookiecutter_project_upgrader)"`

For Zsh, please read [the Click documentation](https://click.palletsprojects.com/en/7.x/bashcomplete/#activation).

Credits
-------

The concept and some code is heavily based on https://github.com/senseyeio/cupper, with some changes
to use Click and some flags and default values to ease usage. Also cleanup has been done and automated tests have been added.

This package was created with Cookiecutter_ and the `thomasjahoda/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/thomasjahoda/cookiecutter
.. _`thomasjahoda/cookiecutter-pypackage`: https://github.com/thomasjahoda/cookiecutter-pypackage


=======
History
=======

1.0.0 (2019-03-22)
------------------

* First release on PyPI.


