Skip to content
Carlos Grande edited this page Nov 2, 2022 · 11 revisions

Table of Contents

  1. Description
  2. Installation
  3. Usage
  4. Troubleshooting
  5. Disclaimer
  6. Help wanted
  7. Other links

1. What is PyTemplate

A Python archetype to help me and others begin developing a coding project. The archetype follows a customizable project structure using cookiecutter as a template generator.

1.1 What is cookiecutter

A command-line utility that creates projects from cookiecutters (project templates), e.g. creating a Python package project from a Python package project template.

Visit these links to learn more about cookiecutter. Documentation: https://cookiecutter.readthedocs.io/ GitHub: https://github.com/cookiecutter/cookiecutter

2. Installation

2.1 Cookiecutter installation

Installing cookiecutter package on Ubuntu is very easy, visit the link to the cookiecutter documentation to learn how to install it. Install cookiecutter

2.2 PyTemplate installation

To generate a custom project from the template, follow these steps:

    1. Navigate to the path where you desire to generate the project folder.
    1. Run the cookiecutter command followed by the repository URL.
    cookiecutter https://github.com/charlstown/py-template.git
    
    1. Fill out the form in the console and the project will be generated at the end.

3. Usage

Explain all the steps to execute your app. Remember if it's for Linux/mac or windows or both, and help yourself with coding snippets to explain the commands.

# Example of a code snippet
python code/myapp.py -MyFlags

4. Troubleshooting

Errors, future updates, or beta configurations. Explain why and how it could break.

5. Disclaimer

Explain the dos and don'ts of your app, what you take responsibility for, and where is the limit of its purpose.

6. Help Wanted

Some extra help or clarification about the whole process. What you don't provide.

7. Other links

References, contact, or related repositories go here.

Clone this wiki locally