README.md 2,1 КБ
Newer Older
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
1
2
3
4
# Шаблон для fastapi проекта

## Использование
1) Установите cookiecutter 
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
5
6
7
```console
foo@bar:~$ pip install cookiecutter
```
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
8
9

2) Перейдите в ту директорию, где у вас будет хранится код для проекта
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
10
Это делается комадами:
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
11
12
13
14
15
16
17
```console
foo@bar:~$ cd
foo@bar:~$ pwd
foo@bar:~$ ls
```
Это _не_ последовательность команд, а _список_ нужных

Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
18
19
20
Гуглите их, если у вас будет что-то не получаться

3) Выполните раскатку шаблона в текущую директорию командой
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
21
22
23
```console
foo@bar:~$ cookiecutter https://github.com/profcomff/fastapi-template.git
```
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
24
25
26
27

После команды вас спросят, хотите ли вы загрузить шаблон, согласитесь.

Вам зададут несколько вопросов:
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
28

Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
29
3.1) repo_name - имя будущего репозитория
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
30

Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
31
3.2) module_name - имя модуля, который будет запускаться командой: python3 -m module_name. На одном уровне с ним будут лежать Dockerfile, .gitignore, .env, Makefile, docker-compose, pyproject.toml, flake8.conf, README.md, requirements.txt, alembic.ini, gunicorn.conf, миграции. А внутри будет лежать исполняемый код.
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
32

Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
33
34
35
3.3) description - Краткое описание проекта для README.md

4) У вас создастся структура проекта, корнем которой будет папка repo_name. Вы должны создать новый пустой репозиторий на GitHub и импортировать туда все из этой папки.
Grigoriev Semyon's avatar
Grigoriev Semyon включено в состав коммита
36
37
38
39
40
41
42
43
44
45
46
47
48

## Стек технологий в шаблоне

1) fastapi
2) sqlalchemy
3) pydantic
4) alembic

Вы можете добавлять новые технологии в файле requirements.txt.

## Предложения по шаблону

Писать мне @Alevardo (tg) или в нашем чатике