Django

Przegląd

Django to wysokopoziomowy framework webowy w Pythonie, który zachęca do szybkiego rozwoju i przejrzystego, pragmatycznego projektowania. Zawiera ORM, panel administracyjny, system uwierzytelniania i silnik szablonów.

Pierwsze kroki

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>

pip install -r requirements.txt

python manage.py migrate
python manage.py runserver

git add .
git commit -m "Initial setup"
git push origin main

Lokalny rozwój z Dockerem

Jeśli nie masz lokalnie zainstalowanego Pythona, możesz użyć Dockera, aby uruchomić aplikację Django.

Uruchamianie komend z Dockerem

# Zainstaluj zależności
docker run --rm -v $(pwd):/app -w /app python:3.12 pip install -r requirements.txt

# Uruchom serwer deweloperski
docker run --rm -v $(pwd):/app -w /app -p 8000:8000 python:3.12 sh -c "pip install -r requirements.txt && python manage.py runserver 0.0.0.0:8000"

Konfiguracja bazy danych

Platforma NStrim udostępnia bazę danych MySQL/MariaDB. Zaktualizuj ustawienie DATABASES w pliku settings.py.

Aktualizacja settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': '<username>',
        'USER': '<username>',
        'PASSWORD': '<password>',
        'HOST': 'db.<session-domain>',
        'PORT': '3306',
    }
}

Struktura projektu

├── project/
│   ├── settings.py            # Konfiguracja projektu
│   ├── urls.py                # Główna konfiguracja URL
│   └── wsgi.py                # Punkt wejścia WSGI
├── app/
│   ├── models.py              # Modele bazy danych
│   ├── views.py               # Funkcje / klasy widoków
│   ├── urls.py                # Wzorce URL aplikacji
│   ├── serializers.py         # Serializery DRF
│   ├── admin.py               # Konfiguracja panelu admina
│   └── templates/             # Szablony HTML
├── static/                    # CSS, JS, obrazy
├── manage.py                  # CLI Django
├── requirements.txt           # Zależności Python
└── Dockerfile                 # Konfiguracja Docker
        

Typowe zadania

Tworzenie modelu

from django.db import models

class User(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField(unique=True)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name

Tworzenie widoku

from django.http import JsonResponse
from .models import User

def user_list(request):
    users = list(User.objects.values('id', 'name', 'email'))
    return JsonResponse(users, safe=False)

Konfiguracja URL

from django.urls import path
from . import views

urlpatterns = [
    path('users/', views.user_list, name='user-list'),
]

Przydatne komendy

Rozwiązywanie problemów

Proces wdrażania