Entendendo Django
+Agenda
+ +-
+
- Entendendo Projeto +
- Entendendo Apps +
- Adicionando Apps no Projeto +
Projeto
+ +"Projeto" é como Django chama a base do sistema.
+ +Criado com django-admin startproject [PROJECT].
Projeto: startproject
+ +
+.
+├── exemplo
+│ ├── __init__.py
+│ ├── settings.py
+│ ├── urls.py
+│ └── wsgi.py
+└── manage.py
+
+ manage.py vira o gerenciador do projeto.
+
+ Projeto > + App +
+ ++ Dentro do projeto, para criar um app: +
+ +
+ python manage.py startapp [app]
+
+ Projeto > + App +
+ +
+.
+├── exemplo
+│ ├── __init__.py
+│ ├── __init__.pyc
+│ ├── settings.py
+│ ├── settings.pyc
+│ ├── urls.py
+│ └── wsgi.py
+├── manage.py
+└── products
+ ├── admin.py
+ ├── __init__.py
+ ├── migrations
+ │ └── __init__.py
+ ├── models.py
+ ├── tests.py
+ └── views.py
+ + Projeto > App > + models.py +
+ +Definição do banco de dados para o app.
+ +
+class Product(models.Model):
+
+ """Product information"""
+
+ name = models.CharField(max_length=40)
+ + Projeto > App > + admin.py +
+ +Definição do admin (ou não) dos models.
+ +
+class ProductAdmin(admin.ModelAdmin):
+ pass
+
+admin.site.register(Product, ProductAdmin)
+ + Projeto > App > + forms.py +
+ +Definição de formulários/formulários baseados em models.
+ +
+class ProductForm(forms.Form):
+ name = forms.CharField(label='Your name', max_length=40)
+
+class ProductForm(ModelForm):
+ class Meta:
+ model = Product
+ + Projeto > App > + views.py +
+ +Views do app.
+ +
+def get_product(request, product_id):
+ if request.method == 'GET':
+ product = get_object_or_404(Product, pk=product_id)
+ return render(request,
+ 'product_info.html',
+ {'product': product})
+ else:
+ return render(request,
+ 'invalid.html',
+ {'reason': 'Can\'t create products yet'})
+ + Projeto > App > + templates/product_info.html +
+ +Na verdade, todos os templates da app ficam em
+ templates.
+{% extends 'base.html' %}
+
+ - Product name: {{ product.name }}
+
+ O base.html pode estar no templates
+ do projeto.
+ Projeto > App > + urls.py +
+ +URLs internas do app.
+ +
+from . import views
+
+urlpatterns = [
+ url(r'^(?P<product_id>[0-9]+)/$', views.get_product, name='get'),
+
+]
+ App completa!
+ +... só que o Django ainda não sabe que ela existe.
++ Projeto > + settings.py +
+ +
+[...]
+INSTALLED_APPS = (
+ [...]
+ 'products',
+ [...]
+)
+ Agora o Django sabe que a App existe!
+ +Só não sabe como chegar lá porque faltam as URLs.
++ Projeto > + urls.py +
+ +
+[...]
+urlpatterns = [
+ [...]
+ url(r'/products', include('products')),
+ [...]
+]
+ Agora funciona como esperado:
+ +-
+
- Request de um browser chega no Django; +
- Consulta o urls.py base do projeto para encontrar o + que será executado; +
- Consulta o urls.py da app (no caso) para encontrar + a view que será executada; +
- Encontra a view dentro da app, que busca as informações no model; +
- Renderiza o template; +
- Retorna o template renderizado para o usuário. +
+ Relationships
+ +Projeto > App > models.py
+ +
+class Product(models.Model):
+
+ """Product information"""
+
+ name = models.CharField(max_length=40)
+ price = models.DecimalField(max_digits=6, decimal_places=2)
+
+
+class Order(models.Model):
+
+ """An order."""
+
+ products = models.ManyToManyField(Product)
+ Inserts
+ +
+product = Product(name='fruit')
+order = Order()
+order.products.add(product)
+product.save()
+order.save()
+ Queries
+ +
+all_products = Product.objects.all()
+
+fruit = Product.objects.get(pk=1)
+fruit = Product.objects.get(name='fruit')
+
+all_fruits = Order.objects.filter(products__name__like='fruit')
+ Queries
+get só pode retornar um elemento.
pk é uma variável mágica que aponta para o campo marcado
+ como primary_key=True; se não houver um primary_key,
+ o Django cria um IntegerField(auto_increment=True).