My presentations, using Reveal.js (mostly in Portuguese).
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

550 lines
18 KiB

9 years ago
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Entendendo DJANGO</title>
<meta name="description" content="A framework for easily creating beautiful presentations using HTML">
<meta name="author" content="Hakim El Hattab">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, minimal-ui">
<link rel="stylesheet" href="reveal.js/css/reveal.css">
<link rel="stylesheet" href="reveal.js/css/theme/solarized.css" id="theme">
<!-- Code syntax highlighting -->
<link rel="stylesheet" href="reveal.js/lib/css/zenburn.css">
<!-- Printing and PDF exports -->
<script>
var link = document.createElement( 'link' );
link.rel = 'stylesheet';
link.type = 'text/css';
link.href = window.location.search.match( /print-pdf/gi ) ? 'css/print/pdf.css' : 'reveal.js/css/print/paper.css';
document.getElementsByTagName( 'head' )[0].appendChild( link );
</script>
<!--[if lt IE 9]>
<script src="lib/js/html5shiv.js"></script>
<![endif]-->
<!-- personal styles -->
<style>
.semi-opaque {
background-color: rgba(0, 0, 0, 0.7);
}
</style>
</head>
<body>
<div class="reveal">
<div class="slides">
<section data-background='_images/django-allauth.png'>
<h1 class='semi-opaque'>Entendendo Django</h1>
</section>
<section>
<h2>Agenda</h2>
<ul>
<li>Entendendo Projeto</li>
<li>Entendendo Apps</li>
<li>Adicionando Apps no Projeto</li>
</ul>
</section>
<section>
<section>
<h2>Projeto</h2>
<p>"Projeto" é como Django chama a base do sistema.</p>
<p>Criado com <code>django-admin startproject [PROJECT]</code>.</p>
</section>
<section>
<h2>Projeto: startproject</h2>
<pre><code class="hljs">
.
├── exemplo
   ├── __init__.py
   ├── settings.py
   ├── urls.py
   └── wsgi.py
└── manage.py
</code></pre>
<p>
<code>manage.py</code> vira o gerenciador do projeto.
</p>
</section>
<section>
<h2>
<small>Projeto &gt;</small>
App
</h2>
<p>
Dentro do projeto, para criar um app:
</p>
<p>
<code>python manage.py startapp [app]</code>
</p>
</section>
<section>
<h2>
<small>Projeto &gt;</small>
App
</h2>
<pre><code class="hljs">
.
├── 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
</code></pre>
</section>
9 years ago
</section>
<section>
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
models.py
</h2>
9 years ago
<p>Definição do banco de dados para o app.</p>
9 years ago
<pre><code class="hljs">
9 years ago
class Product(models.Model):
"""Product information"""
name = models.CharField(max_length=40)
</code></pre>
9 years ago
</section>
9 years ago
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
admin.py
</h2>
9 years ago
<p>Definição do admin (ou não) dos models.</p>
9 years ago
<pre><code class="hljs">
9 years ago
class ProductAdmin(admin.ModelAdmin):
pass
admin.site.register(Product, ProductAdmin)
</code></pre>
</section>
9 years ago
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
forms.py
</h2>
9 years ago
<p>Definição de formulários/formulários baseados em models.</p>
9 years ago
<pre><code class='hljs'>
9 years ago
class ProductForm(forms.Form):
name = forms.CharField(label='Your name', max_length=40)
</code></pre>
9 years ago
<pre><code class="hljs py">
9 years ago
class ProductForm(ModelForm):
class Meta:
model = Product
</code></pre>
</section>
9 years ago
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
views.py
</h2>
9 years ago
<p>Views do app.</p>
9 years ago
<pre><code class="hljs">
9 years ago
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'})
</code></pre>
</section>
9 years ago
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
templates/product_info.html
</h2>
9 years ago
<p>Na verdade, todos os templates <i>da app</i> ficam em
<code>templates</code>.</p>
9 years ago
<pre><code class="hljs">
9 years ago
{% extends 'base.html' %}
<ul>
<li>Product name: {{ product.name }}</li>
</ul>
</code></pre>
9 years ago
<p>O <code>base.html</code> pode estar no <code>templates</code>
do projeto.</p>
</section>
9 years ago
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
urls.py
</h2>
9 years ago
<p>URLs internas do app.</p>
9 years ago
<pre><code class="hljs">
9 years ago
from . import views
urlpatterns = [
url(r'^(?P&lt;product_id&gt;[0-9]+)/$', views.get_product, name='get'),
]
</code></pre>
</section>
9 years ago
<section>
<h2>App completa!</h2>
9 years ago
<p>... só que o Django ainda não sabe que ela existe.</p>
</section>
9 years ago
</section>
<section>
<section>
<h2>
<small>Projeto &gt;</small>
settings.py
</h2>
9 years ago
<pre><code class="hljs">
9 years ago
[...]
INSTALLED_APPS = (
[...]
'products',
[...]
)
</code></pre>
9 years ago
<p>Agora o Django sabe que a App existe!</p>
9 years ago
<p class="fragment">Só não sabe como chegar lá porque faltam as URLs.</p>
</section>
9 years ago
<section>
<h2>
<small>Projeto &gt;</small>
urls.py
</h2>
9 years ago
<pre><code class="hljs">
9 years ago
[...]
urlpatterns = [
[...]
url(r'/products', include('products')),
[...]
]
</code></pre>
</section>
<section>
<p>Agora funciona como esperado:</p>
<ul>
<li>Request de um browser chega no Django;</li>
<li>Consulta o urls.py base do projeto para encontrar o
que será executado;</li>
<li>Consulta o urls.py da app (no caso) para encontrar
a view que será executada;</li>
<li>Encontra a view dentro da app, que busca as informações no model;</li>
<li>Renderiza o template;</li>
<li>Retorna o template renderizado para o usuário.</li>
</ul>
</section>
9 years ago
</section>
<section>
<img src="_images/goodgood-but-we-must-go-deeper.jpg" alt="Go deeper"/>
</section>
<section>
<h2>Relationships</h2>
<p>Projeto &gt; App &gt; models.py</p>
<pre><code class="hljs">
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)
</code></pre>
</section>
<section>
<h2>Inserts</h2>
<pre><code class="hljs">
product = Product(name='fruit')
order = Order()
order.products.add(product)
product.save()
order.save()
</code></pre>
</section>
<section>
<section>
<h2>Queries</h2>
9 years ago
<pre><code class="hljs">
9 years ago
all_products = Product.objects.all()
</code></pre>
9 years ago
<pre><code class="hljs">
9 years ago
fruit = Product.objects.get(pk=1)
fruit = Product.objects.get(name='fruit')
</code></pre>
9 years ago
<pre><code class="hljs">
9 years ago
all_fruits = Order.objects.filter(products__name__like='fruit')
</code></pre>
</section>
<section>
<h2>Queries</h2>
<p><code>get</code> só pode retornar <strong>um</strong> elemento.</p>
<p><code>pk</code> é uma variável mágica que aponta
para o campo marcado como
<code>primary_key=True</code>; se não houver um
<code>primary_key</code>, o Django cria um
<code>IntegerField(auto_increment=True)</code>.</p>
</section>
<section>
<h2>Reverse Queries</h2>
<p>Quando é criada uma relação, o Django cria também uma
relação reversa entre os models.</p>
<pre><code class="hljs">
order = Order.objects.get(pk=1)
print order.products.all()
</code></pre>
<pre><code class="hljs">
print Products.order_set.all()
</code></pre>
<p>O nome da relacionamento reverso pode ser alterado com
<code>related_name</code>.</p>
</section>
</section>
<section>
<section>
<h2>Fixtures</h2>
<p>Fixtures são arquivos JSON que o Django consegue usar
para preencher o banco de dados.</p>
<pre><code class="hljs">
[
{
"pk": 1,
"model": "Products",
"fields": {
"name": "fruit"
}
}
]
</code></pre>
</section>
<section>
<h2>Fixtures em Testes</h2>
<p>Fixtures em testes se aplicam a suíte inteira.</p>
<p>Para definir que um teste usa fixtures, é usada a
variável <code>fixtures</code> da classe.</p>
<pre><code class="hljs">
class ProductTest(StaticLiveServerTestCase):
fixtures = ['products.json']
</code></pre>
</section>
<section>
<h2>Fixtures em Produção</h2>
<p>Para criação das tabelas de banco de dados, usa-se
<code>python manage.py syncdb</code>.</p>
<p>Se houverem fixtures a serem carregadas, essas serão
injetadas no banco de dados durante o
<code>syncdb</code>.</p>
</section>
9 years ago
</section>
<section>
<section>
<h2>Signals</h2>
<p>Signals (sinais) são eventos gerados dentro do Django
para chamar funções de usuário em algumas
condições (normalmente relacionadas com models).</p>
<pre><code class="hljs">
from django.db.models.signals import pre_save
from django.dispatch import receiver
from models import Product
@receiver(post_save, sender=Product)
def after_saving_product(sender, instance, created, raw, using, update_fields):
# ...
</code></pre>
</section>
<section>
<h2>Signals</h2>
<ul>
<li>sender = o model sendo afetado.</li>
<li>instance = registro sendo alterado.</li>
<li>created = se é um novo registro ou não.</li>
<li>raw = registro salvo exatamente como indicado (fixtures).</li>
<li>using = alías do database sendo usado.</li>
<li>update_fields = campos sendo salvos no
<code>save()</code> (None se forem todos).</li>
</ul>
</section>
</section>
9 years ago
<section>
<section>
<h2>Templatetags</h2>
<p>Funções especiais para templates para apresentação de valores.</p>
</section>
<section>
<h2>
<small>Projeto &gt; App &gt;</small>
templatetags/
</h2>
<p>Dentro do diretório <code>templatetags</code> do App
ficam os módulos com os tags.</p>
<p>(Lembrar de colocar o arquivo <code>__init__.py</code> para que
o Python detecte o diretório como um módulo).</p>
</section>
<section>
<h2>
<small>Projeto &gt; App &gt; templatetags/</small>
filters.py
</h2>
<pre><code class="hljs">
def free(value):
if value == 0:
return _('Free')
return value
</code></pre>
</section>
<section>
<h2>
<small>Projeto &gt; App &gt; templates/</small>
product_info.html
</h2>
<pre><code class="hljs">
{{ product.price|free }}
</code></pre>
</section>
9 years ago
</section>
</div>
</div>
<script src="reveal.js/lib/js/head.min.js"></script>
<script src="reveal.js/js/reveal.js"></script>
<script>
// Full list of configuration options available at:
// https://github.com/hakimel/reveal.js#configuration
Reveal.initialize({
controls: true,
progress: true,
history: true,
center: true,
transition: 'slide', // none/fade/slide/convex/concave/zoom
// Optional reveal.js plugins
dependencies: [
{ src: 'lib/js/classList.js', condition: function() { return !document.body.classList; } },
{ src: 'plugin/markdown/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } },
{ src: 'plugin/markdown/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } },
{ src: 'reveal.js/plugin/highlight/highlight.js', async: true, callback: function() { hljs.configure({languages: ['python']}); hljs.initHighlightingOnLoad(); } },
{ src: 'reveal.js/plugin/zoom-js/zoom.js', async: true },
{ src: 'reveal.js/plugin/notes/notes.js', async: true }
]
});
</script>
</body>
</html>