CookieCutter安装与使用
简洁:cookiecutter是Python一款快速搭建项目的命令行工具。
安装:pip install cookiecutter
使用:
创建Django项目示例:cookiecutter https://github.com/pydanny/cookiecutter-django.git
环境配置:
project_name [My Awesome Project]: myproject # 项目名称 project_slug [myproject]: app01 # slug description [Behold My Awesome Project!]: This is the first application! # 项目描述 author_name [Daniel Roy Greenfeld]: yourname # 作者 domain_name [example.com]: example.com # 部署的域名 email [__jack__@example.com]: imooc@imooc.com # 邮箱 version [0.1.0]: # 版本号,默认为0.1.0 Select open_source_license: # 选择项目License 1 - MIT 2 - BSD 3 - GPLv3 4 - Apache Software License 2.0 5 - Not open source Choose from 1, 2, 3, 4, 5 (1, 2, 3, 4, 5) [1]: 5 timezone [UTC]: Asia/Shanghai # Django settings中的TIME_ZONE windows [n]: n # 是否是Windows环境 use_pycharm [n]: y # 是否使用Pycharm开发 use_docker [n]: y # 是否使用Docker容器 Select postgresql_version: # 选择Postgres数据库版本,cookiecutter-django默认只支持Postgres 1 - 10.5 2 - 10.4 3 - 10.3 4 - 10.2 5 - 10.1 6 - 9.6 7 - 9.5 8 - 9.4 9 - 9.3 Choose from 1, 2, 3, 4, 5, 6, 7, 8, 9 (1, 2, 3, 4, 5, 6, 7, 8, 9) [1]: 1 Select js_task_runner: # js运行方式 1 - None 2 - Gulp Choose from 1, 2 (1, 2) [1]: 1 custom_bootstrap_compilation [n]: n # 是否自定义bootstrap压缩 use_compressor [n]: n # 是否使用压缩 use_celery [n]: n # 是否使用celery,一个异步任务队列 use_mailhog [n]: n # 是否使用mailhog,Django项目中发送邮件的,也可以使用Mailgun代替 use_sentry [n]: n # 是否使用错误日志日志监控,sentry也是不错的开源python项目 use_whitenoise [n]: y # 是否使用whitenoise use_heroku [n]: n # 是否使用heroku,heroku是国外著名的云服务厂商之一,提供PaaS use_travisci [n]: n # 是否使用travisci,类似于jekins,用于DevOps中的持续集成与发布 keep_local_envs_in_vcs [y]: y # 对于本地环境变量使用版本控制 debug [n]: y # 是否开启debug模式,settings中配置 [SUCCESS]: Project initialized, keep up the good work! [root@shiyanlou ~]# 完成后进入项目目录,初始化git仓库在开发环境中进入config文件夹,修改base.py,在项目根目录下创建.env文件按照下面的代码修改原来的代码 READ_DOT_ENV_FILE = env.bool("DJANGO_READ_DOT_ENV_FILE", default=True) CELERY_ACCEPT_CONTENT = ["json",'msgpack'] CELERY_TASK_SERIALIZER = "msgpack" EMAIL_BACKEND = env( "DJANGO_EMAIL_BACKEND", default="django.core.mail.backends.smtp.EmailBackend" ) EMAIL_HOST = env('DJANGO_EMAIL_HOST') EMAIL_USE_SSL = env('DJANGO_EMAIL_USE_SSL',default = True) EMAIL_PORT = env('DJANGO_EMAIL_PORT',default = 465) EMAIL_HOST_USER = env('DJANGO_EMAIL_HOST_USER') EMAIL_HOST_PASSWORD = env('DJANGO_EMAIL_HOST_PASSWORD') DEFAULT_FROM_EMAIL = env('DJANGO_DEFAULT_FROM_EMAIL') CELERY_RESULT_BACKEND = env('CELERY_RESULT_BACKEND') .env 文件配置 #MySQL DATABASE_URL=mysql://zanhu:123456@127.0.0.1/zanhu #REDIS REDIS_URL=redis://127.0.0.1:6379 DJANGO_DEBUG=True DJANGO_SECRET_KEY=fp2#2%p3z-(g+f--k&0gutlah85vd6wp^y6lc3wfdrkr*l3n_v #Email DJANGO_EMAIL_USE_SSL=True DJANGO_EMAIL_HOST='smtp.qq.com' DJANGO_EMAIL_PORT=25 DJANGO_EMAIL_HOST_USER='597445210@qq.com' DJANGO_EMAIL_HOST_PASSWORD='xxaejnxormsabcce' DJANGO_DEFAULT_FROM_EMAIL=EMAIL_HOST_USER #Celery CELERY_BROKER_URL=redis://127.0.0.1:6379/1 CELERY_RESULT_BACKEND=redis://127.0.0.1:6379/2
可用的Cookiecutter模板
现在在已经有很多开源的Cookiecutter 项目模板可供选择。
特定的Cookiecutter模板
这些模板由cookiecutter官方团队进行维护:
- cookiecutter-pypackage:@audreyr终极Python包项目模板。
- cookiecutter-django: 一个具有Bootstrap 4、可定制用户应用程序、启动器模板、用户注册、celery设置等功能的Django项目模板。
- cookiecutter-pytest-plugin: 编写pytest插件的最小Cookiecutter模板,帮助你编写更好的程序。
Cookiecutter模板分类
社区驱动的各类Cookiecutter模板(非Cookiecutter官方维护)
Python
- cookiecutter-pypackage: @audreyr的终极Python包项目模板。
- cookiecutter-pipproject: pip可安装项目的最小软件包
- cookiecutter-pypackage-minimal: 一个最小的Python包模板。
- cookiecutter-lux-python: 一个Python样板项目,旨在利用方便的Makefile工具和额外的辅助工具创建Python包。
- cookiecutter-flask :带有 Bootstrap 3、启动器模板和工作用户注册的Flask模板。
- cookiecutter-flask-2: 一个更重的cookiecutter-flask,有更多的样板,包括忘记密码和Heroku集成功能
- cookiecutter-flask-foundation : 带有缓存、表单、sqlalchemy和单元测试的Flask模板。
- cookiecutter-flask-minimal : 最小但production就绪的Flask项目模板,除了Flask本身之外,没有其他依赖。
- cookiecutter-flask-skeleton : Flask启动项目。
- cookiecutter-bottle : 用于快速创建可重复使用的Bottle项目的cookiecutter模板。
- cookiecutter-openstack: OpenStack项目的模板。
- cookiecutter-docopt: Python命令行脚本的模板,使用docopt进行参数解析。
- cookiecutter-quokka-module: 用于创建Quokka Flask CMS蓝图模块的模板。
- cookiecutter-kivy:基于kivy python-framework构建的NUI应用程序模板。
- cookiedozer: Python Kivy应用程序的模板,已准备好使用Buildozer部署到Android设备。
- cookiecutter-pylibrary: 一个旨在快速开始进行良好的测试和打包的复杂模板,(Tox,Pytest,Travis-CI,Coveralls,AppVeyor,Sphinx docs,isort,转换,打包、检查等工作配置)。
- cookiecutter-pyvanguard: 用于尖端Python开发的模板。[invoke](http://docs.pyinvoke.org/en/latest /)、pytest、bumpversion和Python 2/3兼容性。
- Python-iOS-template: 用于创建在iOS设备上运行的Python项目模板。
- Python-Android-template: 用于创建在Android设备上运行的Python项目模板。
- cookiecutter-tryton用于创建基本和外部Tryton模块的模板。
- cookiecutter-tryton-fulfilio: 用于创建tryton模块的模板。
- cookiecutter-pytest-plugin: 用于创作pytest插件的最小Cookiecutter模板,可帮助您编写更好的程序。
- cookiecutter-tox-plugin: 编写tox 插件的最小Cookiecutter模板,用于更改或扩展测试自动化的行为。
- cookiecutter-tapioca: 用于构建基于Web API包装器(客户端)的[tapioca-wrapper](https://github.com/vintasoftware/tapioca-wrapper)的模板。
- cookiecutter-muffin: 带有Bootstrap 3,启动器模板和工作用户注册的Muffin模板。
- cookiecutter-octoprint-plugin: 用于构建OctoPrint.插件的模板
- cookiecutter-funkload-friendly: funkload-friendly 项目的Cookiecutter模板。
- cookiecutter-python-app: 用于创建具有子命令、日志记录、YAML配置、pytest测试和Virtualenv部署的Python CLI应用程序的模板。
- morepath-cookiecutter:超强web微框架Morepath的Cookiecutter模板,。
- Springerle/hovercraft-slides: 新Hovercraft! 展现项目模板(reStructuredText中嵌入
impress.js
幻灯片) - cookiecutter-snakemake-analysis-pipeline: 一种轻松设置Snakemake分析管道的方法。
- cookiecutter-py3tkinter: Python 3 Tkinter应用程序gui的模板。
- cookiecutter-pyqt5: 预构建的PyQt4 GUI模板,具有日志记录支持、用于测试和分离ui和工作组件的结构。
- cookiecutter-pyqt4: A prebuilt PyQt4 GUI template with a logging support, structure for tests and separation of ui and worker components.
- cookiecutter-xontrib: 用于构建xontribs的模板,a.k.a xonsh贡献
- cookiecutter-conda-python: 用于构建Conda Python包的模板
- cookiecutter-pypackage-rust-cross-platform-publish: 包含Rust二进制模块的Python wheel 模板,支持在Windows,OSX和Linux上发布。
- cookiecutter-telegram-bot: 一个带有基于CherryPy webhook的Telegram机器人模板项目。
- python-project-template: 一个用于Python项目的模板,具有复杂的发布自动化功能。
- cookiecutter-anyblok-project: 基于Anyblok的项目模板。
- cookiecutter-python-cli:用于使用“click”创建Python CLI应用程序的cookiecutter模板
Python-Django
- cookiecutter-django: 带有Bootstrap 4的前沿Django项目模板,可自定义的用户应用程序,入门模板,用户注册,celery设置等等。
- cookiecutter-django-rest: 用于为移动和Web应用程序创建REST api。
- cookiecutter-simple-django: 快速创建可重用Django项目的cookiecutter 模板
- django-docker-bootstrap: Djangodocker开发/生产环境,并集成了 Postgres, NodeJS(React), Nginx, uWSGI.
- cookiecutter-djangopackage:用于创建可重用的第三方PyPI友好Django应用程序的cookicutter模板。 用教程格式编写文档
- cookiecutter-django-cms: Django CMS的模板,带有简单的Bootstrap 3模板。 它具有快速启动和部署文档。
- cookiecutter-django-crud: 用于围绕工厂模式和测试的模型创建带有CRUD样板的Django应用程序。
- cookiecutter-django-lborgav:Django项目的另一个cookiecutter模板,带有Bootstrap 3和FontAwesome 4
- cookiecutter-django-paas: 准备在像Heroku,OpenShift等PAAS平台中使用的Django模板
- cookiecutter-django-rest-framework: 用于创建可重用Django REST框架包的模板。
- cookiecutter-django-aws-eb: 在AWS Elastic Beanstalk上启动并运行Django。
- cookiecutter-wagtail : 基于Wagtail CMS的网站模板
- wagtail-cookiecutter-foundation: Wagtail CMS项目的完整模板,带有 Zurb Foundation 6,ansible资源调配和部署,使用bower进行前端相关性管理,模块化的应用程序,使您的网站启动和运行照片画廊,RSS流等。
- django-starter: 包含vagrant和provisioning脚本的Django模板- 灵感来自12factor应用程序和cookiecutter-django。
- cookiecutter-django-gulp: 在Django项目中集成前端开发工具的Cookiecutter模板
- wagtail-starter-kit: 配有wagtail,django布局,vagrant,配置脚本,前端构建系统等等的cookiecutter模板。
- cookiecutter-django-herokuapp: 一个为Heroku python3优化的Django 1.7+模板。
- cookiecutter-simple-django-cn:一个简单的Django中文模板。
- cc_django_ember_app: 用于使用Django和EmberJS创建应用程序
- cc_project_app_drf: 用于基于“project app”项目体系结构创建REST api
- cc_project_app_full_with_hooks: 用于基于“project app”项目体系结构创建Django项目
- cc-automated-drf-template: 模板+脚本,根据模型文件作为输入自动创建包含序列化程序,视图,URL和管理文件的Django REST项目。
- cookiecutter-django-foundation: cookiecutter-django分支, 基于 Zurb Foundation 6前端框架。
- cookiecutter-django-ansible: 用于快速启动ansible项目,以便为您的* cookiecutter-django *应用程序提供服务器的框架
- wemake-django-template: 前沿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项目模板的元模板。
- cookiecutter-template: 用于创建一个Cookiecutter模板
Ansible
- cookiecutter-molecule: 按照最佳实践创建Create Molecule角色, 利用Test-kitchen,Docker和InSpec实现已经实施的测试基础架构。Molecule, Docker and Testinfra.
- cookiecutter-ansible-role: 用于创建ansible角色的模板。 忘记文件创建,专注于操作。
- cookiecutter-ansible-role-ci: 按照最佳实践创建Ansible角色,利用Test-kitchen,Docker和InSpec实现已经实施的测试基础架构。
Git
- cookiecutter-git: Git repo项目模板
C
- bootstrap.c: 用C语言编写的带有autotools的简单项目模板。
- cookiecutter-avr: avr开发的模板。
C++
- BoilerplatePP: 一个简单的cmake模板,对用C ++编写的项目进行单元测试。
- cookiecutter-dpf-effect: DISTRHO插件框架(DPF)的音频插件项目模板
- cookiecutter-dpf-audiotk: 一个音频插件项目模板,用于发行版插件框架(DPF)和音频工具包(ATK) DSP库
- cookiecutter-kata-gtest: 使用Google Test框架的C ++测试驱动开发katas模板。
- cookiecutter-kata-cpputest: 使用CppUTest框架的C ++测试驱动开发katas的模板。
C#
- cookiecutter-csharp-objc-binding: 生成用于绑定Objective-C静态库的C#绑定项目的cookircutter模板。
Common Lisp
- cookiecutter-cl-project: 带有bootstrap脚本和Slime集成的Common Lisp项目cookiecutter模板,
Elm
- cookiecutter-elm: 基于Elm带有html样例的cookiecutter模板。
Golang
- cookiecutter-golang: 根据最佳实践创建基golang新项目的模板
Java
- cookiecutter-java: 使用gradle的基本java应用程序设置的cookiecutter模板。
- cookiecutter-spring-boot: 标准java spring boot gradle应用程序的Cookiecutter模板。
- cookiecutter-android:基于Gradle的Android项目Cookiecutter模板。
JS
- cookiecutter-es6-boilerplate:S6中的前端项目cookiecutter模板
- cookiecutter-webpack: Webpack 2项目的模板,包括热重新加载,babel es6模块和反应。
- cookiecutter-jquery:一个基于jQuery Boilerplate的jQuery插件项目模板。
- cookiecutter-jswidget: 为多个JS打包系统创建一个通用的前端非jQuery JS小部件的项目模板。
- cookiecutter-component: Component JS 包模板
- cookiecutter-tampermonkey: TamperMonkey浏览器脚本的模板。
- cookiecutter-es6-package: 使用ES6通过babel编写nodejs包的模板。
- cookiecutter-angular2: 带有typescript应用程序的模块化angular2模板。
- CICADA: 自动为AngularJS前端创建列表/细节控制器和片段,以连接到DRF后端的模板和脚本。 与cc-automated-drf-template配合的很好。
Kotlin
- cookiecutter-kotlin-gradle: 基于Gradle的Kotlin项目简单模板。
LaTeX/XeTeX
- pandoc-talk:用于与pandoc和XeTeX进行对接的cookiecutter模板。
- cookiecutter-latex-article: 针对学术界使用的LaTeX模板
- cookiecutter-beamer: LaTeX Beamer展示模板
PHP
- cookiecutter-mediawiki-extension: MediaWiki扩展的模板。
Sublime Text
- cookiecutter-sublime-text-3-plugin: Sublime Text 3 插件模板, 包括自定义设置、命令、键绑定和主菜单
- sublime-snippet-package-template: 包含片段型Sublime Text包的模板。
Berkshelf-Vagrant
- slim-berkshelf-vagrant: 与 vagrant/berkshelf cookbooks保持一致的cookbook简单模板
HTML
-
cookiecutter-complexity:一个使用Bootstrap 3的复杂静态站点cookiecutter模板。
-
cookiecutter-reveal.js: reveal.js演示文稿的cookiecutter模板。
-
cookiecutter-tumblr-theme: 使用GruntJS作为连接工具的Tumblr主题项目的cookiecutter模板。
Scala -
cookiecutter-scala:带有几个库的简单scala hello world应用程序cookiecutter模板
-
cookiecutter-scala-spark: 用Scala编写的Apache Spark应用程序的cookiecutter模板。
6502 Assembly -
cookiecutter-atari2600: Atari2600项目的cookiecutter模板。
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)
持续交付
- painless-continuous-delivery: 用于包含持续交付的软件开发设置cookiecutter模板。支持Python (Django, Flask), 实验性支持 PHP 。
- cookiecutter-devenv: 用于将开发和ci环境添加到现有项目的模板。
云工具
- cookiecutter-tf-module: 用于构建一致Terraform模块的Cookiecutter模板。
Tornado
- cookiecutter-tornado: 创建Tornado项目的Cookiecutter模板
其他
- cookiecutter-awesome: 创建[awesome](https://github.com/sindresorhus/awesome)列表的Cookiecutter模板。
- cookiecutter_dotfile: 由stow管理的dotfiles文件夹的模板。
- cookiecutter-raml: RAML v1.0 API文档的模板。
与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生成器,带有一些附加组件和集成