cookiecutter django下載 - cookiecutter django原始碼下載

cookiecutter django

Python

2024.12.08

下載

薑戈

Cookiecutter Django 由 Cookiecutter 提供支持，是一個用於快速啟動生產就緒 Django 專案的框架。

文件：https://cookiecutter-django.readthedocs.io/en/latest/
請參閱常見錯誤和障礙的故障排除
如果您對 Cookiecutter Django 有問題，請開啟問題，不要向維護人員發送電子郵件。

特徵

對於 Django 5.0
適用於 Python 3.12
以 100% 的起始測試覆蓋率渲染 Django 項目
Twitter Bootstrap v5
透過 django-environ 基於 12 因素的設置
預設情況下安全。我們相信 SSL。
優化的開發和生產設置
透過 django-allauth 註冊
附帶隨時可用的自訂使用者模型
Websocket 的可選基本 ASGI 設定
使用 Gulp 或 Webpack 的可選自訂靜態構建
透過 Anymail 發送電子郵件（預設使用 Mailgun，如果選擇了 AWS 雲端供應商，請使用 Amazon SES，但可切換）
使用 Amazon S3、Google Cloud Storage、Azure Storage 或 nginx 的媒體存儲
Docker 支援使用 docker-compose 進行開發和生產（使用 Traefik 和 LetsEncrypt 支援）
用於部署到 Heroku 的 Procfile
部署到 PythonAnywhere 的說明
使用unittest或pytest運行測試
可自訂的 PostgreSQL 版本
與預提交的預設集成，用於在提交程式碼審查之前識別簡單問題

可選集成

這些功能可以在初始項目設定期間啟用。

從 Amazon S3、Google Cloud Storage、Azure Storage 或 Whitenoise 提供靜態文件
Celery 和 Flower 的配置（後者僅在 Docker 設定中）
與 Mailpit 整合以進行本地電子郵件測試
與 Sentry 整合以記錄錯誤

約束條件

僅使用維護的第三方函式庫。
到處使用 PostgreSQL：12 - 16（MySQL 分支也可使用）。
用於配置的環境變數（這不適用於 Apache/mod_wsgi）。

支持這個項目！

該專案是一個由志願者運行的開源專案。您可以透過 OpenCollective 贊助我們，也可以透過 GitHub 贊助商單獨贊助我們：

Daniel Roy Greenfeld，專案負責人（GitHub、Patreon）：Django 和 AWS ELB 的專業知識。
Fabio C. Barrionuevo，核心開發人員 (GitHub)：Python/Django 的專業知識、DevOps 實務與前端經驗。
Bruno Alla，核心開發人員 (GitHub)：Python/Django 和 DevOps 的專業知識。
Nikita Shupeyko，核心開發人員 (GitHub)：Python/Django 的專業知識、DevOps 實務與前端經驗。

為維護者提供財政支援的項目：

兩匙姜戈

兩球 Django 3.x 是宇宙中最好的冰淇淋主題 Django 參考！

pyup

PyUp 為您提供 Google 和其他組織使用的自動安全性和相依性更新。免費用於開源專案！

用法

假設您想要建立一個名為「redditclone」的 Django 專案。與其使用startproject然後編輯結果以包括您的姓名、電子郵件和各種配置問題（這些問題總是在最糟糕的時刻之前被遺忘），不如讓 cookiecutter 完成所有工作。

首先，取得 Cookiecutter。相信我，這太棒了：

 $ pip install "cookiecutter>=1.7.0"

現在針對此存儲庫運行它：

 $ cookiecutter https://github.com/cookiecutter/cookiecutter-django

系統會提示您輸入一些值。提供它們，然後將為您建立 Django 專案。

警告：此後，將“Daniel Greenfeld”、“pydanny”等更改為您自己的資訊。

使用您自己想要的選項回答提示。例如：

 Cloning into 'cookiecutter-django'...
remote: Counting objects: 550, done.
remote: Compressing objects: 100% (310/310), done.
remote: Total 550 (delta 283), reused 479 (delta 222)
Receiving objects: 100% (550/550), 127.66 KiB | 58 KiB/s, done.
Resolving deltas: 100% (283/283), done.
project_name [My Awesome Project]: Reddit Clone
project_slug [reddit_clone]: reddit
description [Behold My Awesome Project!]: A reddit clone.
author_name [Daniel Roy Greenfeld]: Daniel Greenfeld
domain_name [example.com]: myreddit.com
email [[email protected]]: [email protected]
version [0.1.0]: 0.0.1
Select open_source_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]: 1
Select username_type:
1 - username
2 - email
Choose from 1, 2 [1]: 1
timezone [UTC]: America/Los_Angeles
windows [n]: n
Select an editor to use. The choices are:
1 - None
2 - PyCharm
3 - VS Code
Choose from 1, 2, 3 [1]: 1
use_docker [n]: n
Select postgresql_version:
1 - 16
2 - 15
3 - 14
4 - 13
5 - 12
Choose from 1, 2, 3, 4, 5 [1]: 1
Select cloud_provider:
1 - AWS
2 - GCP
3 - None
Choose from 1, 2, 3 [1]: 1
Select mail_service:
1 - Mailgun
2 - Amazon SES
3 - Mailjet
4 - Mandrill
5 - Postmark
6 - Sendgrid
7 - Brevo (formerly SendinBlue)
8 - SparkPost
9 - Other SMTP
Choose from 1, 2, 3, 4, 5, 6, 7, 8, 9 [1]: 1
use_async [n]: n
use_drf [n]: y
Select frontend_pipeline:
1 - None
2 - Django Compressor
3 - Gulp
4 - Webpack
Choose from 1, 2, 3, 4 [1]: 1
use_celery [n]: y
use_mailpit [n]: n
use_sentry [n]: y
use_whitenoise [n]: n
use_heroku [n]: y
Select ci_tool:
1 - None
2 - Travis
3 - Gitlab
4 - Github
Choose from 1, 2, 3, 4 [1]: 4
keep_local_envs_in_vcs [y]: y
debug [n]: n

進入專案看看：

 $ cd reddit/
$ ls

建立一個 git 儲存庫並將其推送到那裡：

 $ git init
$ git add .
$ git commit -m "first awesome commit"
$ git remote add origin [email protected]:pydanny/redditclone.git
$ git push -u origin master

現在看看您的儲存庫。不要忘記仔細查看產生的自述文件。太棒了，對吧？

對於本地開發，請參閱以下內容：