created by wopark

장고 프로젝트 만들기

$ django-admin startproject config

• rename config -> Aconfig

• 안에있는 config폴더를 꺼낸 후 Aconfig를 삭제

• 이 때 settings.py에 있는 secret_key를 그냥 올리게 되면 깃에서 보안 경고 메일이 온다.

• 이를 처리하기 위한 방법

  • secrets.json 파일 생성

{
  "SECRET_KEY": "(1djli9wygoor+6^5g36bcn^ca+!+@8uc-=bw-3bk)z2pwrdq8"
}

• gitignore에 secrets.json 추가
• setting.py 아래와 같이 수정

import os, json
from django.core.exceptions import ImproperlyConfigured

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))


# Quick-start development settings - unsuitable for production
# See https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/

# SECURITY WARNING: keep the secret key used in production secret!
secret_file = os.path.join(BASE_DIR, "secrets.json")

with open(secret_file) as f:
    secrets = json.loads(f.read())

def get_secret(setting, secrets=secrets):
    try:
        return secrets(setting)
    execept KeyError:
        error_msg = "Set the {} environment variable".format(setting)
        raise ImproperlyConfigured(error_msg)

SECRET_KEY = get_secret("SECRET_KEY")

...

python manage.py runserver -> 서버 구동
python mamage.py createsuperuser -> 관리자 계정 만들기
python manage.py migrate -> 데이터베이스 업데이트

INSTALLED_APPS

• django와 함께 딸려오는 기본 앱들은 다음과 같다.
  • django.contrib.admin
    • django의 가장 강력한 부분 중 하나인 자동 관리 인터페이스이다.
    • 모델에서 메타데이터를 읽어 신뢰할 수 있는 사용자가 사이트의 콘텐츠를 관리할 수 있는 빠른 모델 중심 인터페이스를 제공한다.
    • (연결한 url/admin/)을 통해서 사용할 수 있다.
  • django.contrib.auth
    • 사용자 인증 시스템을 지원한다.
    • 사용자 계정, 그룹, 권한과 쿠키 기반의 사용자, 세션을 다룬다.
  • django.contrib.contenttypes
    • django 기반 프로젝트에 설치된 모든 모델을 추적할 수 있는 contenttypes 앱이 포함되어 있어 모델 작업을 위한 고급, 일반 인터페이스를 제공한다.
  • django.contrib.sessions
    • 세션 프레임워크를 사용하면 사이트 방문자별로 임의의 데이터를 저장하고 검색할 수 있다. 서버에 데이터를 저장하고 쿠키의 송수신을 추상화한다.
  • django.contrib.messages
    • 익명 및 인증된 사용자 모두에게 쿠키 및 세션 기반 메시징을 완벽하게 지원한다.
  • django.contrib.staticfiles
    • 정적파일을 관리하는 프레임워크

django-admin startapp 앱이름

• makemigrations

  • 생성 / 수정된 모델들의 변경사항을 migrations로 저장하고자 Django에게 알려준다.

• migrate

  • makemigrations 또는 기본적으로 생성된 migrations들을 실행시켜주고 자동으로 데이터베이스 스키마를 관리해준다.

• createsuperuser

  • 모든 권한을 가지는 superuser를 생성한다.

• django-admin startapp app 이름

  • conversations
  • lists
  • reservations
  • reviews
  • rooms
  • users
    • django에는 기본적으로 user가 존재하지만, 이 user는 데이터베이스에 접근 할 수 있는 user를 뜻한다. 하지만 우리가 필요한 user는 홈페이지를 사용할 고객이기 때문에 데이터베이스에 접근하지 못하는 새로운 users를 생성해서 사용한다.
    • app을 생성했을때 만들어지는 기본적인 파일 및 폴더들은 django에게 필요한 것이기 때문에 삭제하거나 이름을 바꾸어서는 안된다.

생성한 app안의 파일들

• __init__.py
• admin.py
  • app의 내용들을 admin 패널에 보여주기위한 파일
• veiw.py
  • 페이지에서 보여질 부분들을 작성하는 파일 -> html렌더
• urls.py
  • url들을 관리하는 파일
  • config/urls.py 에 모든 앱들의 url을 관리하지않고 각 앱에 있는 urls.py만들어서 연동시켜준다.
• apps.py
  • 앱의 구성을 관리하는 파일
• models.py
  • 앱의 모델을 관리하는 파일(데이터베이스) -> 앱의 데이터 변경
• tests.py

created by mki

#2.0 Creating a Django Project (05:46)

첫 번째 django 프로젝트 작성하기

이전에 아래의 명령으로 pipenv환경을 만든다면 Pipfile파일이 생성된다. 그 다음 README.md와 .gitignore을 만들자.

mkdir airbnb-clone
mv airbnb-clone
pipenv --python 3.7
pipenv install django==2.2.5

이제 실제로 django프로젝트를 시작해보자. 장고 튜토리얼에서는 아래와 프로젝트를 만들면 된다고 한다.

https://docs.djangoproject.com/ko/3.2/intro/tutorial01/

django-admin startproject mysite

그러나 위 명령어는 초심자를 위한 것이고, 규모를 확장하기에는 별로이다. 따라서 아래와 같이 시작하자.

django-admin startporject config

그 다음 아래 명령을 실행해 config폴더 안에 있는 config폴더와 manage.py를 밖으로 옮기자.

mv config Aconfig
mv Aconfig/config Aconfig/manage.py .
rm -rf Aconfig

번거로운 과정을 피하려면 아래와 같이 작성하자.

django-admin startproject config .

아래 책에서도 이러한 방법을 추천하고 있다.

https://www.amazon.com/Two-Scoops-Django-1-11-Practices-ebook/dp/B076D5FKFX

Interpreter 선택

VSC는 코드를 작성할 때 도움이 되는Extension들을 많이 제공하고 있다. Python역시 Microsoft에서 직접 제공을 하고 있다. 설치를 한 뒤에, VCS의 가장 아래 상태바를 보면, Python 2.7.10 64-bit로 선택되어 있다. 이것을 'airbnb-clone': pipenv가 적혀있는 python을 선택하면 에러메시지가 사라진다.

COMMAND+SHIFT+P를 사용하면 쉽게 변경이 가능하다.

키워드

• django-admin
• startproject

#2.1 Setting up VSCode and Python Like a PRO (10:08)

Linter

파이썬은 컴파일 언어가 아니고, 런타임 언어이다. 따러서 컴파일 언어처럼 에러를 사전에 잡아주지 않는다.

Linter는 여러분들이 쓴 코드를 보면서 에러가 생길 부분을 미리 감지하는 확장프로그램이다. 변수를 만들고 사용하지 않거나, 없는 변수를 사용하려면 안되는데, 이러한 부분을 코드를 실행하기 전에 미리 감지해서 알려준다.

https://ko.wikipedia.org/wiki/린트_(소프트웨어)

또한 Linter는 파이썬에서 널리 쓰이는 관습도 준수한다. 이러한 관습을 나열한 것을 PEP라고 부른다.

PEP

https://www.python.org/dev/peps/

이중에서 PEP8은 코드를 어떻게 작성해야 하는지 문서화한 것이다.

https://www.python.org/dev/peps/pep-0008/

이러한 관습을 신경쓰지 않도록 관리해 주는 프로그램을 Linter라고 한다. 코드를 작성할 때 문제가 있다면, 문제가 되는 부분을 알려준다. 정말 많은 Linter가 있는데, 가장 선호되는 Linter는 flake8이다. pylint라는 것도 있다.

flake8

https://pypi.org/project/flake8/

VSC팝업에서 어떤 linter를 선택할지 나오면 flake8을 선택하자.

그러면 .vscode폴더와 함께 그 안에 settings.json파일이 만들어진다.

# .vscode/setting.json

{
	"python.pythonPath": "~/.local/share/virtualenvs/mki-934kEbld/"
	"python.linting.flake8Enabled": true,
	"python.linting.pylintEnabled": false,
	"python.linting.enabled": true
}

위와 같이 만들어지지 않았다면, 새로 추가하자. 그 다음 flake8을 설치하라는 팝업이 뜬다. 설치를 진행하자.

#COMMAND + SHIFT + P
#Python: Select liner
pipenv install flake8 --dev

Pipfile을 보면 아래와 같이 적혀있는데, packages는 웹 애플리케이션이 동작할 때 필요한 패키지이고, dev-packages는 개발할 때 필요한 패키지이다.

# Pipfile

[source](/WONILLISM/Clone_airbnb/wiki/source)
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
django = "==2.2.5"
pillow = "*"
django-countries = "*"

[dev-packages]
flake8 = "*"
black = "*"

[requires]
python_version = "3.7"

[pipenv]
allow_prereleases = true

Code Formatting

http://c2.com/ppr/formatting.html

Formatter은 코드를 자동으로 포멧팅해주는 프로그램이다. Linter가 오류가 날 부분을 알려준다면, Formatter는 실제로 코드를 수정해준다.

black

black이란 formatter를 추천한다.

https://pypi.org/project/black/

https://www.daleseo.com/python-black/

설치하는 법은 팝업을 눌러도 되고, 아래와 같이 입력해도 된다.

pipenv install black --dev --pre

flake8 + black은 최고의 조합이다. 설치를 하면 VSC아래에 새로운 상태창이 생성되는데, 저장할 때마다 무언가 바뀌는 것이 보일 것이다. 만약 보이지 않으면 아래와 같이 실행하자.

• setting→"format on save"→check

만약 이러한 체크 박스가 없다면 setting.json을 수정해주어야 한다.

{
	"editor.formatOnSave": true,
}

Line 길이 제한 수정

파이썬은 라인의 길이가 79자를 넘어서면 안된다. E501에러가 발생하는데, 예전에는 모니터가 작아서 어쩔 수 없었지만, 지금은 모니터가 크다. 그래서 이런 제한이 없어도 된다. 그래서 아래와 같이 setting.json파일을 수정해주자.

{
	"python.linting.flake8Args": ["--max-line-length=88"]
}

setting.json

지금까지 작업한 setting.json을 한 눈에 보면 아래와 같다.

{
    "python.pythonPath": "~/.local/share/virtualenvs/mki-934kEbld/",
    "python.linting.flake8Enabled": true,
    "python.linting.pylintEnabled": false,
    "python.linting.enabled": true,
    "python.formatting.provider": "black",
    "python.linting.flake8Args": [
        "--max-line-length=88"
    ],
}

#2.2 Falling in love with Django part One (06:47)

프로젝트를 만든 뒤에 생성된 파일들을 살펴보자. 우선 manage.py가 있다.

manage.py

https://docs.djangoproject.com/ko/3.2/ref/django-admin/

https://devlog.jwgo.kr/2018/02/07/what-is-the-diff-btw-manage-django-admin/

config/init.py

init.py는 장고가 아니라 파이썬한테 필요한 것이다. 새로운 폴더를 만든 뒤,그 폴더의 파일들을 사용할 때에, 파이썬은 항상 init.py가 필요하다. 그래야 파이선 패키지로 인식해서 파일을 import할 수 있다.

https://wikidocs.net/1418

https://velog.io/@limes/Python-init.py-파일의-역할

config/setting.py

장고가 만들어 놓은 것.

INSTALLED_APPS

MIDDLEWARE

TEMPLATES

WSGI_APPLICATION

DATABASES

AUTO_PASSWORD_VALIDATORS

모든 것이 준비가 되어있다.

TIME_ZONE = "Asia/Seoul"

맨 위의 주석은 매우 중요하니 꼭 읽어라. 매우 도움이 되며, 링크도 매우 도움이 된다.

https://docs.djangoproject.com/ko/3.2/topics/settings/

config/urls.py

config/wsgi.py

Django Documentation

여러분의 새로운 베프

장고의 첫번째 좋은 점

Django에 필요한 모든 것이 여기에 있다.

세팅 파일을 보고 모르면 링크를 열어서 보자.

장고는 모든 것을 준비해 놓았고, 소스코드를 볼 수 있고, 코멘트도 친절하고 도큐먼트도 친절하다.

#2.3 Falling in love with Django part Two (09:39)

manage.py

Command키를 꾹 누르면 function정의 부분으로 간다.

intellisence

https://code.visualstudio.com/docs/editor/intellisense

python manage.py runserver

https://docs.djangoproject.com/ko/3.2/ref/django-admin/#django-admin-runserver

logger

파일을 저장하는 순간 즉시 다시 실행이 된다.

db.sqlite3 개발용 디비 자동으로 생성됨.

127.0.0.1:8000/admin

실행이 안된다.

ctrl + z

python manage.py migrate

https://docs.djangoproject.com/ko/3.2/ref/django-admin/#django-admin-migrate

python manage.py runserver

127.0.0.1:8000/admin

사용자가 없다.

python manage.py createsuperuser

다시 들어가서 사용자 mki 비밀번호입력

#2.4 Django Migrations (09:12)

python manage.py makemigrations

https://docs.djangoproject.com/ko/3.2/ref/django-admin/#makemigrations

python manage.py migrate

https://docs.djangoproject.com/ko/3.2/ref/django-admin/#django-admin-migrate

db.sqlite3삭제

unapplied migration 에러메시지

장고와 데이터베이스가 연동되어있지 않다.

SQLite3은 소규모 프로젝트에서 사용

PostgreSQL

우리의 옵션 2개.

SQL을 공부해서 사용하자.

데이터베이스에 무엇을 넣을지 정해주어야 한다.

장고에는 migration system이 있다.

무언가를 특정 장소에서 다른 곳으로 이동시키는 것은.

데이터베이스의 경우 하나의 상태에서 다른 상태로 옮기는 것.

데이터 유형이 변경될 때마다 migration이 필요하다.

python manage.py makemigrations

데이터베이스와 장고를 동기화...

python manage.py migrate

#2.5 Django Applications (09:09)

어디에 무엇을 넣을 것인가?

project는 어플리케이션의 모음.

어플은 function의 모음

room이란 공통. 생성 추가 삭제

review기능.

엄청 많은 기능들을 어느 폴더에 넣을까?

거대하고 어마무시한 폴더를 만들면 안된다.

Divide and conquer

계획을 하고 시작해야 한다.

작은 폴더들을 여러개 만들어서 config에 import할 것이다. 여러 매우 작은 어플리케이션들의 모음.

언제 어플리케이션을 만들고 안만들지 정해야 한다.

한 문장으로 표현할 수 있는 어플리케이션! and, or로 설명하면 안된다.

항상 작게 나누기!

#2.6 Creating the Apps! (06:16)

startapp

https://docs.djangoproject.com/ko/3.2/ref/django-admin/#startapp

airbnb-clone안, config폴더 밖에서 아래 명령을 실행하자.

django-admin startapp rooms

하나 더 해보자

django-admin startapp users
django-admin startapp reviews
django-admin startapp conversations
django-admin startapp lists
django-admin startapp reservations

application을 추가해야 관리자에서 볼 수 있다.

django user

#2.7 Explaining the Apps (07:38)

만든 application안에 있는 폴더와 파일들의 이름을 절대 변경해서는 안된다.

framework와 library의 차이점은, framework는 룰을 따라야 한다. react는 라이브러리! 이름들은 optional이 아니다!

장고는 urls.py를 지켜보고 있다.

framework룰을 따라야 한다!

migrations

init.py

admin.py

admin패널에 적용되는 것들

apps.py

configurations...?

models.py

data

database

tests.py

views.py

사용자들이 보는 것

html render, form upload

urls.py

application폴더 안에 urls를 새로 만들어서 url들을 분할정복하자!