Neste post (o último da série) veremos o teste do plugin que criamos para o QGIS.
1. MOCKING
Para testar um plugin do QGIS você precisa simular o ambiente que ele deve rodar. E esse ambiente é obviamente o próprio QGIS, mas não é possível iniciar o QGIS toda vez que você executa um teste. Felizmente, há o QGIS Mocking para lhe auxiliar.
2. VOCÊ PRECISA DE DADOS
Cada teste é executado repetidas vezes, o que significa que ele precisa redefinir os dados que estão sendo usados para seu estado padrão. Isso pode ser um “PIDA” se o teste alterar os dados de maneira imprevisível.
Usando as camadas do QGIS, você pode preparar novos dados para cada um dos seus testes, colocando de forma eficaz todo o processo de manipulação de dados.
3. ESCREVENDO TESTES
Cada um dos testes do plugin AttributeTransfer herda da classe unittest.TestCase, que vem com vários métodos que você pode estar familiarizado com outros idiomas: setUp() é executado antes para cada método de teste, enquanto tearDown() é executado após cada um deles. Os testes são definidos como métodos cujos nomes começam com a palavra test.
Cada teste deve chamar algum método assertWhatever que verifica se o teste foi aprovado ou não. Aqui está um exemplo de tal teste cobrindo camadas não pontuais.
#!/usr/bin/env python
# -*- coding: utf-8 -*-
# @Date : 2017-11-18 18:40:50
# @Author : Michal Zimmermann <zimmicz@gmail.com>
import os
import sip
import sys
import unittest
from qgis.core import QgsMapLayerRegistry, QgsVectorLayer, QgsFeature, QgsGeometry, QgsPoint
from utilities import get_qgis_app
sys.path.append(os.path.dirname(os.path.abspath(__file__)) + "/..")
from attribute_transfer import AttributeTransfer
from create_dummy_data import create_dummy_data_polygon_or_line
sip.setapi('QtCore', 2)
sip.setapi('QString', 2)
sip.setapi('QDate', 2)
sip.setapi('QDateTime', 2)
sip.setapi('QTextStream', 2)
sip.setapi('QTime', 2)
sip.setapi('QUrl', 2)
sip.setapi('QVariant', 2)
QGIS_APP = get_qgis_app()
IFACE = QGIS_APP[2]
class AttributeTransferTestPolygonOrLine(unittest.TestCase):
def setUp(self):
self.source_layer = QgsVectorLayer(
"Polygon?crs=epsg:4326&field=id:integer&field=textAttr:string&field=intAttr:integer&field=decAttr:double&field=dateAttr:date&index=yes", "source layer", "memory")
self.target_layer = QgsVectorLayer(
"Linestring?crs=epsg:4326&field=id:integer&index=yes", "target layer", "memory")
self.widget = AttributeTransfer(IFACE)
registry = QgsMapLayerRegistry.instance()
registry.removeAllMapLayers()
registry.addMapLayers([self.source_layer, self.target_layer])
create_dummy_data_polygon_or_line(self.source_layer, self.target_layer)
self.widget.initGui()
self.widget.vectors = [self.source_layer, self.target_layer]
self.widget.editable_vectors = [self.source_layer, self.target_layer]
self.widget.dlg.sourceLayer.addItems(["source layer", "target layer"])
def test_text_attr(self):
ATTRIBUTE_NAME = "textAttr"
ATTRIBUTE_INDEX = 1
self._test_attr(ATTRIBUTE_NAME, ATTRIBUTE_INDEX)
def test_int_attr(self):
ATTRIBUTE_NAME = "intAttr"
ATTRIBUTE_INDEX = 2
self._test_attr(ATTRIBUTE_NAME, ATTRIBUTE_INDEX)
def test_dec_attr(self):
ATTRIBUTE_NAME = "decAttr"
ATTRIBUTE_INDEX = 3
self._test_attr(ATTRIBUTE_NAME, ATTRIBUTE_INDEX)
def test_date_attr(self):
ATTRIBUTE_NAME = "dateAttr"
ATTRIBUTE_INDEX = 4
self._test_attr(ATTRIBUTE_NAME, ATTRIBUTE_INDEX)
def test_existing_attr(self):
ATTRIBUTE_NAME = "id"
ATTRIBUTE_INDEX = 0
self.widget.dlg.sourceAttribute.setCurrentIndex(ATTRIBUTE_INDEX)
self.widget.dlg.targetAttribute.setText(ATTRIBUTE_NAME)
self.assertEqual(
self.widget.dlg.sourceAttribute.currentText(), ATTRIBUTE_NAME)
self.assertFalse(self.widget.transfer())
def _test_attr(self, attr_name, attr_index):
self.widget.dlg.sourceAttribute.setCurrentIndex(attr_index)
self.widget.dlg.targetAttribute.setText(attr_name)
self.assertEqual(
self.widget.dlg.sourceAttribute.currentText(), attr_name)
self.widget.transfer()
target_fields = [f.name()
for f in self.target_layer.dataProvider().fields()]
self.assertIn(attr_name, target_fields)
source_features = [f for f in self.source_layer.getFeatures()]
target_features = [f for f in self.target_layer.getFeatures()]
for idx, f in enumerate(source_features):
self.assertEqual(f.attribute(attr_name), target_features[
idx].attribute(attr_name))
if __name__ == "__main__":
unittest.main()
Com esse teste encerro a série de posts sobre como desenvolver um plugin para o QGIS. Espero que tenha ajudado a você que está querendo criar ou está criando o seu plugin para o QGIS.
Esta série de posts é tradução e uma adaptação livre do post escrito originalmente por Michal Zimmermann do blog “Pieces of knowledge from the world of GIS“.
