6.4 Separando Templates

Pretendemos que a view da página inicial e da lista sejam páginas bem distintas, portanto, merecem que sejam renderizadas por diferentes templates.

Na página principal, a intenção é que tenhamos uma página com um campo para a entrada de itens para uma nova lista. Já a página que exibe a lista deve apenas apresentar todos os itens disponíveis, já cadastrados.

Para iniciarmos essa separação dos templates, vamos, primeiro, criar um teste para guiar nossa implementação.

A nossa classe de teste ListViewTest ganhará o teste test_uses_list_template, conforme apresentado abaixo entre as linhas 36 a 38.

from django.urls import resolve
from django.test import TestCase
from lists.views import home_page
from lists.models import Item

class HomePageTest(TestCase):

	def test_root_url_resolves_to_home_page_view(self):
		found = resolve('/')
		self.assertEquals(found.func, home_page)

	def test_home_page_returns_correct_html(self):
		response = self.client.get('/')
		self.assertTemplateUsed(response, 'home.html')

	def test_only_saves_items_when_necessary(self):
		self.client.get('/')
		self.assertEquals(Item.objects.count(), 0)

	def test_can_save_a_POST_request(self):
		self.client.post('/', data={'item_text': 'A new list item'})

		self.assertEquals(Item.objects.count(), 1)
		new_item = Item.objects.first()
		self.assertEquals(new_item.text, 'A new list item')

	def test_redirects_after_POST(self):
		response = self.client.post('/', data={'item_text': 'A new list item'})

		self.assertEquals(response.status_code, 302)
		self.assertEquals(response['location'], '/lists/the-only-list-in-the-world/')


class ListViewTest(TestCase):

	def test_uses_list_template(self):
		response = self.client.get('/lists/the-only-list-in-the-world/')
		self.assertTemplateUsed(response, 'list.html')
		

	def test_displays_all_list_itens(self):
		Item.objects.create(text='itemey 1')
		Item.objects.create(text='itemey 2')

		response = self.client.get('/lists/the-only-list-in-the-world/')

		self.assertContains(response, 'itemey 1')
		self.assertContains(response, 'itemey 2')

class ItemModelTest(TestCase):

	def test_saving_and_retriving_items(self):
		first_item = Item()
		first_item.text = 'The first (ever) list item'
		first_item.save()

		second_item = Item()
		second_item.text = 'Item the second'
		second_item.save()

		saved_items = Item.objects.all()
		self.assertEquals(saved_items.count(),2)

		first_saved_item = saved_items[0]
		second_saved_item = saved_items[1]

		self.assertEquals(first_saved_item.text, 'The first (ever) list item')
		self.assertEquals(second_saved_item.text, 'Item the second')

Ao executar os testes, temos a mensagem de erro abaixo:

Assim sendo, vamos ditar nossa view para dar início a solução desse erro. Inicialmente vamos editar o arquivo lists/views.py para ficar conforme abaixo. Na linha 15, 'home.html' foi substituído por 'list.html'.

Após essa alteração, a execução dos testes apresenta a saída abaixo:

O próximo passo é criarmos o template list.html. Como sempre, faremos sempre pelo menor esforço. O comando abaixo cria um arquivo vazio.

Após a execução do comando acima, os testes passa a apresentar uma nova mensagem de erro:

Vamos então criar um template mais elaborado. Como muito do que precisamos está em home.html, vamos copiar o conteúdo de home.html para list.html e, em seguida, alterar o home.html para manter apenas o que é necessário.

O conteúdo de home.html após as alterações fica conforme abaixo:

Após as alterações, os testes passam e nos mostram que, após as alterações, não causamos efeitos colaterais no código.

Na nossa implementação, não há mais a necessidade de passar todos os itens para o template home.html e, desse modo, podemos simplificar a função da view para se adequar a isso. A nova função home_page - linhas 5 a 10 de lists/views.py - fica conforme abaixo:

Conforme observado abaixo, os testes unitários continuam passando.

E ao executar os testes funcionais observamos que os primeiros testes continuam passando e nosso novo teste avançou na sua execução.

Ótimo momento para colocarmos essas alterações sob controle de versão.

Last updated

Was this helpful?