forked from cookiecutter/cookiecutter-django
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Tim Santor
committed
Jan 9, 2024
1 parent
9c89eed
commit 774bdf1
Showing
9 changed files
with
91 additions
and
38 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,51 @@ | ||
This forked version of the cookiecutter-django repo keeps all the features of that repo, plus adds additional features to get started on more complex projects quickly. | ||
This forked version of the [cookiecutter-django](https://github.com/cookiecutter/cookiecutter-django) repo retains all the features of that repo and adds additional optional features to get started on more complex projects quickly. | ||
|
||
# Features | ||
- Optional Mosquitto integration | ||
- Optional Nginx integration for static file serving | ||
- Optional `robots` package | ||
## Features | ||
- Makefile with some helpful commands | ||
- Custom AdminSite class | ||
- Custom Storage classes | ||
- Prebuilt Celery Tasks | ||
- Custom JSONRenderer (consistent DRF response format) | ||
- Simple Model Mixins | ||
- Simple Admin Mixins | ||
- Bash Utility Scripts | ||
- Create User | ||
- Install Docker | ||
- Traefik | ||
- Dashboard enabled (traefik.domain.com/dashboard) | ||
- Access log enabled | ||
|
||
|
||
## Optional Integrations | ||
These features can be enabled during initial project setup. | ||
- Mosquitto service | ||
- Nginx integration for static file serving (via Traefix proxy) | ||
- `django-robots` package | ||
- `dj-rest-auth` package (see known issues below) | ||
- `djangorestframework-simplejwt` package | ||
- `django-oauth-toolkit` package | ||
- `django-auditlog` package | ||
- `django-celery-results` package | ||
- `django-perm-filter` package | ||
|
||
|
||
## Usage | ||
``` | ||
cookiecutter https://github.com/tsantor/cookiecutter-django | ||
``` | ||
You'll be prompted for some values. Provide them, then a Django project will be created for you. | ||
|
||
|
||
## Production Deployment via Docker | ||
|
||
- On local machine run, `push_production_env` | ||
- On production, run `make nginx_htaccess` - this | ||
- On production, run `make traefik_htaccess` | ||
- On production, run `make deploy_prod` | ||
|
||
|
||
## Known issues | ||
- Enabling rest-auth will thrown an error as it is not compatible with django-allauth > 0.54.0 | ||
|
||
## TODO | ||
- Need to make work with frontend pipelines other than Gulp |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
3 changes: 0 additions & 3 deletions
3
{{cookiecutter.project_slug}}/{{cookiecutter.project_slug}}/admin/admin.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters