📌 Pyenv + Django 개발 환경 구축 및 개념 정리

✅ pyenv & pyenv-virtualenv란?

• pyenv: 여러 파이썬 버전을 쉽게 설치하고 관리할 수 있는 도구
• pyenv-virtualenv: 프로젝트별 가상환경을 만들고 관리하는 pyenv 플러그인

즉, 프로젝트마다 다른 Python 버전과 라이브러리를 독립적으로 사용하고 싶은 사람들에게 필수 도구

---

✅ pyenv-virtualenv 장점

• 프로젝트 단위로 라이브러리/프레임워크 관리 가능
• venv와 달리 폴더 접근 시 자동으로 가상환경 활성화
• 폴더별 파이썬 버전 관리 기능
• .python-version 파일을 통해 해당 디렉토리만의 파이썬 환경 적용

---

🛠️ 설치 및 환경 설정

1. pyenv 설치

   brew install pyenv

2. pyenv-virtual 설치

   brew install pyenv-virtualenv

3. 셸 환경 설정 (bash or zsh)

   echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
   echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
   echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
   echo 'eval "$(pyenv init -)"' >> ~/.zshrc
   echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
   source ~/.zshrc

   Which $SHELL로 본인의 셸 확인 후, .bashrc or .zshrc 설정

4. pyenv 정상 설치 확인

   pyenv --version
   pyenv virtualenv --version

5. 설치 가능한 Python 버전 확인

   pyenv install --list

6. 원하는 파이썬 버전 설치

   pyenv install 3.10.12

7. 가상환경 생성 (닉네임 설정 가능)

   pyenv virtualenv 3.10.12 myenv310

8. 프로젝트 폴더에서 가상환경 적용

   cd myproject
   pyenv local myenv310 # .python-version 파일 생성됨

   해당 폴더에 진입하면 자동으로 가상환경이 활성화됩니다.

---

✅ 편리한 폴더 생성 팁

take myproject

take 명령어는 폴더 생성 + 바로 이동까지! (brew install coreutils로 설치 가능)

---

🐍 Python 패키지 설치 예시

pip install django
cd ..
pip install flask

각각의 폴더에 따라 독립적인 라이브러리 관리가 가능해집니다.

---

🧠 PyCharm 설정 (Django 프로젝트)

• Settings > Languages & Frameworks > Django
  • Enable Django Supprot ✅
  • Django project root: manage.py 위치
  • Settings.py / manage.py 경로 설정

---

📦 Django 프로젝트 생성

django-admin startproject config .

• django-admin은 Django 설치 시 함께 제공
• .점을 붙이면 현재 폴더에 생성됨

---

🚀 서버 실행

python manage.py runserver

manage.py는 Django에서 핵심 관리 도구입니다 (Java의 main()과 유사)

---

✅ Poetry 환경 구성 (패키지 관리 도구)

poetry init # pyproject.toml 생성

• pyproject.toml: 설치해야 할 패키지 목록
• poetry.lock: 실제 설치된 정확한 패키지 버전 기록

poetry add django
poetry install

프로젝트를 재현하고 싶을 땐, .toml과 .lock 파일만 복사하면 끝!

---

⚠️ Poetry에서 Python 버전 문제 발생 시

Current Python version (3.12.2) is not allowed by the project (>=3.13)

해결

poetry env use 3.13

---

📁 Django App 생성

python manage.py startapp myapp

생성되는 구조:

myapp/

생성되는 구조:

myapp/
 ├─ models.py        # DB 모델 정의
 ├─ views.py         # 클라이언트 요청 처리
 ├─ admin.py         # 관리자 페이지 설정
 ├─ apps.py          # 앱 설정
 ├─ tests.py         # 테스트 코드
 ├─ migrations/      # DB 변경 기록
 └─ __init__.py      # 패키지 인식용

---

📌 앱 등록

settings.py > INSTALLED_APPS에 추가해야 Django에서 인식함

---

🗃️ ORM 및 DB 마이그레이션

1. 모델 정의 후

   python manage.py makemigrations myapp
   python manage.py migrate

2. Superuser 생성

   python manage.py createsuperuser

3. SQLite DB 확인: db.sqlite3 -> DB Browser for SQLite로 확인 가능

---

🧪 ORM 쿼리 예시

# 포함된 단어 검색
Bookmark.objects.filter(name__icontains='네')
# 시작하는 단어 검색
Bookmark.objects.filter(name__startswith='다')
# 특정 리스트 안에 있는 값 검색
Bookmark.objects.filter(name__in=['구글','네이버'])
# 숫자 조건 검색
Bookmark.objects.filter(id__gte=2) # gte, gt, lte, lt

✅ 객체 추가

Bookmark.objects.create(name='야후', url='https://yahoo.com')

bookmark = Bookmark(name='야후2', url='https://yahoo.com')
bookmark.save()

✅ id 변경하여 새 객체로 저장

b = Bookmark.objects.first()
b.id = None
b.name = '네이버2'
b.save()

---

✅ Django 구조 정리: MVT 패턴

• Model: DB 설계, ORM 처리
• View: 로직/처리
• Template: 사용자에게 보여지는 HTML 화면

참고: Django는 MVC 프레임워크보다 먼저 나와서 이름만 다르고 구조는 거의 같음

---

💎 Django 장점

• 빠른 개발 속도 (관리자 페이지를 admin.site.register(Model) 한줄로 생성)
• 보안 강화 (ORM 사용으로 자동 방어)
• 코드 재사용성과 확장성
• 강력한 Admin 페이지
• 커뮤니티 및 패키지 풍부

⚠️ Django 단점

• 러닝커브 존재 (초반 진입장벽)
• Django스러운 개발 방식 요구
• 복잡한 설정과 구조 이해 필요

---

💬 마무리 Tip

• Flask/FastAPI는 가볍고 자유롭지만 Django는 처음부터 모든 게 갖춰진 풀스택 프레임워크입니다.
• 팀 프로젝트나 빠르게 관리 기능이 필요한 서비스에는 Django가 훨씬 효율적입니다.