Git Product home page Git Product logo

temple's Introduction

temple - Templated project management

Temple provides templated project creation and management.

The main functionality of temple includes:

  1. Creating new projects from cookiecutter templates.
  2. Listing all available templates under a github user / org along with all projects created from those templates.
  3. Keeping projects up to date with the template as it changes.

Documentation

View the temple docs here. A quick start and installation overview is provied below.

Installation

temple can be installed with:

pip3 install temple

Most temple functionality requires a GITHUB_API_TOKEN environment variable to be set. The Github API token is a personal token that you create by following the Github Access Token Instructions. This token only requires repo scope.

Note

Temple requires a Github API token for listing available templates, starting new projects, and updating a project with a template. However, project templates themselves might have other setup requirements. Consult the documentation of templates you want to use for your projects for information about other installation and setup required.

Quick Start

Projects are setup by temple with:

temple setup <[email protected]:user/cookiecutter-template.git>

Temple uses cookiecutter to gather user input and create the initial project scaffolding. cookiecutter hooks can be used to do additional project setup, such as publishing it to a remote Github repository or configuring continuous integration.

Once a project is set up and published to Github, temple-created projects can be listed with the temple ls command. temple ls <github_user_or_org> will list all available templates under a Github user or org. temple ls <github_user_or_org> <[email protected]:user/cookiecutter-template.git> will list all projects created using a particular template. Note that temple ls -l will print off descriptions of the returned repositories.

If a template is ever updated, changes can be pulled into a project with:

temple update

This will diff the changes in the new template and apply them to your repository. You will have to add and push these changes yourself. Note to lookout for "*.rej" files after updating. These are lines that could not automatically be applied to your repository, and you should look into them to see if they should be applied.

Note that temple update --check can be used to check if the project is up to date with the latest template.

Contributing Guide

For information on setting up temple for development and contributing changes, view CONTRIBUTING.rst.

Primary Authors

  • @wesleykendall (Wes Kendall)
  • @gwax (George Leslie-Waksman)

Other contributors can be found in the AUTHORS file

temple's People

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.