原文档地址：https://cookiecutter.readthedocs.io/en/latest/

本系列只介绍cookiecutter的基础使用，而且会删除与功能使用无关的部分。深度使用及了解更多详情请请参考原文档。

关于Cookiecutter的中文译名，我不知道别人怎么翻译的，我将其翻译为饼干制造机。本系列中将不对其作翻译，直接使用英文原名。

Cookiecutter简介

Cookiecutter 是一个通过项目模板创建项目的命令行工具。比如，通过Python Package模板来创建Python package项目。（通过Python代码调用Cookiecutter的API可以扩展为自动化创建服务和带有Web UI的服务程序）

功能特点

  • 跨平台：官方支持Windows、Mac和Linux
  • 可以在Python 2.7, 3.4, 3.5, 3.6, and PyPy.环境中正常使用（此处指的是Cookiecutter的运行环境，而不是你项目的运行环境。使用Cookiecutter不需要你懂得编写Python代码）
  • 项目模板可以是任何编程语言或标记格式：Python, JavaScript, Ruby, CoffeeScript, RST, Markdown, CSS, HTML等任何你能叫出名字的。你也可以在同一个项目模板中使用多种语言。
  • 命令行的简单使用：
# 从cookiecutter-pypackage.git模板创建项目

# 你将会被提示输入相应的值。

# 然后Cookiecutter将基于你的输入在当前工作目录中创建Python包

$ cookiecutter https://github.com/audreyr/cookiecutter-pypackage

# 为了简洁起见，repos在GitHub上可以只使用“gh”前缀

$ cookiecutter gh:audreyr/cookiecutter-pypackage
  • 在命令行中使用本地模板：
# 从本地在当前目录创建项目

# cookiecutter-pypackage/ template

$ cookiecutter cookiecutter-pypackage/
  • 目录名和文件名可以模板化。例如：{{cookiecutter.repo_name}}/{{cookiecutter.repo_name}}/{{cookiecutter.repo_name}}.py
  • 支持无限层级的目录嵌套。
  • 文件和目录名称100%使用Jinja2完成模板化。
  • 只需在·cookiecutter.json·文件中定义模板变量即可。 例如：
{

    "full_name": "Tacey Wong",

    "email": "xinyong.wang@qq.com",

    "project_name": "Complexity",

    "repo_name": "complexity",

    "project_short_description": "令人耳目一新的简单的静态网站生成器.",

    "release_date": "2019-03-10",

    "year": "2019",

    "version": "0.0.1"

}
  • 没有你用·--no-input·来禁止，系统会提示你输入：

    • cookiecutter.json中键/key对应的值/value。
    • cookiecutter.json中的缺省值
    • 提示符按顺序显示
  • 跨平台支持~/.cookiecutterrc文件：
default_context:

    full_name: "Tacey Wong"

    email: "xinyong.wang@qq.com"

    github_username: "taceywong"

cookiecutters_dir: "~/.cookiecutters/"
  • 克隆的Cookiecutter项目模板会缺省放置在~/.cookiecutters/目录下，如果特殊指定，会放置在cookiecutters_dir对应的目录下：
# 克隆cookiecutter-pypackage

$ cookiecutter gh:audreyr/cookiecutter-pypackage

# 现在你可以根据名字使用对应的模板

$ cookiecutter cookiecutter-pypackage
  • 您可以使用你本地模板、远程Git repos
  • 默认上下文:指定在生成项目时要用作默认值的键/值对
  • 用命令行参数注入额外的上下文：
$ cookiecutter --no-input gh:msabramo/cookiecutter-supervisor program_name=foobar startsecs=10
  • 直接访问Cookiecutter API允许注入额外的上下文。
  • 预生成和后生成挂钩/hook:在生成项目之前或之后运行的Python或shell脚本。
  • 本地项目的路径可以指定为绝对路径或相对路径。
  • 项目始终生成到当前目录。

可用的Cookiecutter模板

现在在已经有很多开源的Cookiecutter 项目模板可供选择。

特定的Cookiecutter模板

这些模板由cookiecutter官方团队进行维护：

Cookiecutter模板分类

社区驱动的各类Cookiecutter模板（非Cookiecutter官方维护）

Python

Python-Django

Python-Pyramid

  • pyramid-cookiecutter-alchemy:Cookiecutter (项目模板)，使用SQLite创建Pyramid项目，SQLAlchemy用于ORM，URL调度用于路由，Jinja2用于模板。
  • pyramid-cookiecutter-starter: 使用URL调度进行路由分配，使用Jinjab 2、Chameleon或Mako模板创建Pyramid入门项目的Cookiecutter (项目模板)。
  • pyramid-cookiecutter-zodb:Cookiecutter（项目模板），用于创建Pyramid项目，使用ZODB进行持久存储，遍历路由，使用Chameleon进行模板化。
  • substanced-cookiecutter: 用于创建Substance D初始项目的cookiecutter（项目模板）。 Substance D是基于Pyramid实现的。
  • cookiecutter-pyramid-talk-python-starter: 一个自以为是的Cookiecutter模板，用于创建PyramidWeb应用程序，从开发链的下游开始。这个cookiecutter模板将创建一个新的Pyramid Web应用程序，其中包含电子邮件，sqlalchemy，rollbar以及更多的集成。

**Cookiecutter (meta) **

用于生成Cookiecutter项目模板的元模板。

Ansible

Git

C

C++

C#

Common Lisp

Elm

Golang

Java

JS

Kotlin

LaTeX/XeTeX

PHP

Sublime Text

Berkshelf-Vagrant

HTML

Data Science

  • widget-cookiecutter: 用于创建自定义Jupyter小部件项目的cookiecutter模板。
  • cookiecutter-data-science:为在Python中进行和共享数据科学工作的逻辑的、合理标准化的、灵活的项目结构。此处提供了的完整文档 。
  • cookiecutter-r-data-analysis: 组织基于R的工作流->doc(通过pandoc)->pdf报告(通过latex)的模板
  • cookiecutter-docker-science: Cookiecutter template for data scientists working in Docker containers.为使用Docker容器工作的数据科学家准备的Cookiecutter模板。

Reproducible Science

  • cookiecutter-reproducible-science: 用于开始一个可重复和透明的科学项目，包括数据，模型，分析和报告的cookiecutter模板 (比如你的科学论文)。与上面数据科学Cookiecutter模板的哲学非常一致

数据驱动的Journalism

  • cookiecutter-data-driven-journalism: 通过持续组织数据日志项目和一些预先填充的文件来促进数据日志的透明度的Cookiecutter模板(包括 .gitignore, README, AUTHORS)

持续交付

云工具

Tornado

其他

与Cookiecutter类似的项目

  • Paste 具有创建骨架项目的创建选项。
  • Diecutter: 一个提供模板和变量的配置文件的API服务。
  • Django的tartproject和startapp命令可以使用-template选项。
  • python-packager:使用自己的模板创建Python包，并提供可配置的选项。
  • Yeoman 有一个受Rails启发的生成器系统，为应用程序提供脚手架。
  • Pyramid的pcreate命令，用于从脚手架模板创建Pyramid 项目。
  • mr.bob 是一个文件系统模板渲染器，用于弃用paster和templer等工具
  • grunt-init 曾经被内置到Grunt中，现在是一个独立的脚手架工具，可以自动创建项目。
  • scaffolt 使用Handlebars 的JSON生成器。
  • init-skeleton 克隆或复制存储库，执行npm安装和bower安装，并删除.git目录。
  • Cog 由Ned Batchelder开发的基于python的代码生成工具包
  • Skaffold 基于python和json配置的django / MVC生成器，带有一些附加组件和集成。

Cookiecutter: 更好的项目模板工具：（1）简介及可用资源汇总的更多相关文章

  1. Cookiecutter: 更好的项目模板工具：（2）安装及基础使用

    安装 通过python包管理工具 命令行输入 $pip install cookiecutter 或者 # mac os经常会禁止用户全局安装python包 $pip install --user c ...

  2. Cookiecutter: 更好的项目模板工具：（3）高级用法

    本文中的Hook就是钩子,钩子就是Hook 使用生成前/生成后钩子脚本 你可以在项目生成之前和/或之后运行Python或Shell脚本. 像这样把它们放进Hook里: cookiecutter-som ...

  3. 【MVC】ASP.NET MVC 4项目模板的结构简介

    引言     在VS2012新建一个窗体验证的MVC 4项目后,可以看到微软已经帮我们做了很多了,项目里面该有的都有了,完全可以看成一个简单网站.作为开发,能理解里面文件结构和作用,也算是半只脚踏进M ...

  4. Vue.js——60分钟webpack项目模板快速入门

    概述 browserify是一个 CommonJS风格的模块管理和打包工具,上一篇我们简单地介绍了Vue.js官方基于browserify构筑的一套开发模板.webpack提供了和browserify ...

  5. Vue.js——60分钟browserify项目模板快速入门

    概述 在之前的一系列vue.js文章,我们都是用传统模式引用vue.js以及其他的js文件的,这在开发时会产生一些问题. 首先,这限定了我们的开发模式是基于页面的,而不是基于组件的,组件的所有代码都直 ...

  6. Gulp.js - 简单、直观的自动化项目构建工具

    Gulp.js 是一个简单.直观的构建系统.崇尚代码优于配置,使复杂的任务更好管理.通过结合 NodeJS 的数据流的能力,你能够快速构建.通过简单的 API 接口,只需几步就能搭建起自己的自动化项目 ...

  7. 20Spring_JdbcTemplatem模板工具类

    JdbcTemplate 是Spring提供简化Jdbc开发模板工具类.为了更好的了解整个JdbcTemplate配置数据库连接池的过程,这篇文章不采用配置文件的方式,而是采用最基本的代码 的方式来写 ...

  8. cocos2d-x创建新项目模板

    1.起因 长期使用项目中自带的HelloWorldScene来创建模板工程,不知大家有木有感到厌烦? 我是个懒人,所以就弄了个新的模板工程.这样最起码可以不用每次都把HelloWorldScene删掉 ...

  9. Vue.jsbrowserify项目模板

    Vue.js——60分钟browserify项目模板快速入门   概述 在之前的一系列vue.js文章,我们都是用传统模式引用vue.js以及其他的js文件的,这在开发时会产生一些问题. 首先,这限定 ...

随机推荐

  1. Chrome_调试CSS

    1.我们都知道chrome浏览器打开开发者工具的Sources 栏可以查看css文件,并且可以实时修改样式,查看效果,但是这里修改的内容并不会保存到源文件中. 2.  以下方法可以使在chrome浏览 ...

  2. H5C301

    标题H5C301 1.html5 h5最新版本.所有主流浏览器都支持h5.但仅ie9及以上支持h5 改变了用户与文档的交互方式:多媒体 新增了其他的特性:语义,本地存储,网页多媒体 抛弃了不合理的标签 ...

  3. Hibernate(9)_双向n对n

    1.概述 ①双向 n-n 关联需要两端都使用集合属性 ②双向n-n关联必须使用连接表 ③集合属性应增加 key 子元素用以映射外键列, 集合元素里还应增加many-to-many子元素关联实体类 ④在 ...

  4. Python中syncio和aiohttp

    CPython 解释器本身就不是线程安全的,因此有全局解释器锁(GIL),一次只允许使用一个线程执行 Python 字节码.因此,一个 Python 进程通常不能同时使用多个 CPU 核心.然而,标准 ...

  5. MySQL关于根据日期查询数据的sql语句

    查询在某段日期之间的数据: select * from 数据表  where 时间字段名 BETWEEN '2016-02-01' AND '2016-02-05' 查询往前3个月的数据: selec ...

  6. [Python设计模式] 第16章 上班，干活，下班，加班——状态模式

    github地址:https://github.com/cheesezh/python_design_patterns 题目 用代码模拟一天的工作状态,上午状态好,中午想睡觉,下午渐恢复,加班苦煎熬. ...

  7. 在Ubuntu18.04下配置hadoop集群

    服务器准备 启动hadoop最小集群的典型配置是3台服务器, 一台作为Master, NameNode, 两台作为Slave, DataNode. 操作系统使用的Ubuntu18.04 Server, ...

  8. iOS Xcode 10: Multiple commands produce

    Xcode自动升级到10.0 1.编译的时候报错:Multiple commands produce 解决办法:File -> Workspace Setting -> build sys ...

  9. Kettle实现数据抽取、转换、装入和加载数据-数据转移ETL工具

    原文地址:http://www.xue51.com/soft/5341.html Kettle是来自国外的一款开源的ETL工具,纯java编写,可以在Window.Linux.Unix上运行,绿色无需 ...

  10. ASP.NET CORE 中用单元测试测试控制器

    之前用ASP.NET CORE做的项目 加了一个新功能,数据库加了个字段balabala.... 更新到服务器上,新功能测试正常,然后就没管了..... 今天客户说网站有BUG,某个页面打开后出错了, ...