Skip to content

31. Clientes web para os serviços jSON e XML da versão 12

Vamos escrever três aplicativos de console clientes para os serviços jSON e XML do servidor web que acabamos de criar. Retomamos a arquitetura cliente/servidor da versão 11:

Image

Vamos criar três scripts de console:

  • os scripts [main] e [main3] utilizarão a camada [métier] do servidor;
  • o script [main2] utilizará a camada [métier] do cliente;

31.1. A estrutura de diretórios dos scripts dos clientes

A pasta [http-clients/07] é obtida inicialmente por meio da cópia da pasta [http-clients/06]. Em seguida, ela é modificada.

Image

  • em [1]: os dados utilizados ou criados pelo cliente;
  • em [2], a configuração e os scripts de console do cliente;
  • em [3], a camada [dao] do cliente;
  • em [4], a pasta de testes da camada [dao] do cliente;

31.2. A camada [dao] dos clientes

Image

Image

31.2.1. Interface

A camada [dao] implementará a seguinte interface [InterfaceImpôtsDaoWithHttpSession]:


from abc import abstractmethod

from AbstractImpôtsDao import AbstractImpôtsDao
from AdminData import AdminData
from TaxPayer import TaxPayer

class InterfaceImpôtsDaoWithHttpSession(AbstractImpôtsDao):

    # cálculo do imposto por unidade
    @abstractmethod
    def calculate_tax(self, taxpayer: TaxPayer):
        pass

    # cálculo do imposto por lotes
    @abstractmethod
    def calculate_tax_in_bulk_mode(self, taxpayers: list):
        pass

    # inicialização de uma sessão
    @abstractmethod
    def init_session(self, type_session: str):
        pass

    # fim da sessão
    @abstractmethod
    def end_session(self):
        pass

    # autenticação
    @abstractmethod
    def authenticate_user(self, user: str, password: str):
        pass

    # lista de simulações
    @abstractmethod
    def get_simulations(self) -> list:
        pass

    # excluir uma simulação
    @abstractmethod
    def delete_simulation(self, id: int) -> list:
        pass

    # obter os dados necessários para o cálculo do imposto
    @abstractmethod
    def get_admindata(self) -> AdminData:
        pass

Cada método da interface corresponde a um serviço URL do servidor de cálculo de impostos.

  • linha 7: a interface estende a classe [AbstractDao], que gerencia os acessos ao sistema de arquivos;

A correspondência entre os métodos e os URL de serviço é definida no arquivo de configuração [config]:


        # o servidor de cálculo do imposto
        "server": {
            "urlServer""http://127.0.0.1:5000",
            "user": {
                "login""admin",
                "password""admin"
            },
            "url_services": {
                "calculate-tax""/calculer-impot",
                "get-admindata""/get-admindata",
                "calculate-tax-in-bulk-mode""/calculer-impots",
                "init-session""/init-session",
                "end-session""/fin-session",
                "authenticate-user""/authentifier-utilisateur",
                "get-simulations""/lister-simulations",
                "delete-simulation""/supprimer-simulation"
            }

31.2.2. Implementação

A interface [InterfaceImpôtsDaoWithHttpSession] é implementada pela seguinte classe [ImpôtsDaoWithHttpSession]:


# importações
import json

import requests
import xmltodict
from flask_api import status

from AbstractImpôtsDao import AbstractImpôtsDao
from AdminData import AdminData
from ImpôtsError import ImpôtsError
from InterfaceImpôtsDaoWithHttpSession import InterfaceImpôtsDaoWithHttpSession
from TaxPayer import TaxPayer

class ImpôtsDaoWithHttpSession(InterfaceImpôtsDaoWithHttpSession):

    # construtor
    def __init__(self, config: dict):
        # inicialização do pai
        AbstractImpôtsDao.__init__(self, config)
        # armazenamento dos elementos de configuração
        # configuração geral
        self.__config = config
        # servidor
        self.__config_server = config["server"]
        # serviços
        self.__config_services = config["server"]['url_services']
        # modo de depuração
        self.__debug = config["debug"]
        # registrador
        self.__logger = None
        # cookies
        self.__cookies = None
        # tipo de sessão (json, xml)
        self.__session_type = None

        # etapa de solicitação/resposta
     def get_response(self, method: str, url_service: str, data_value: dict = None, json_value=None):
        # [method]: método HTTP, GET ou POST
        # [url_service]: URL de serviço
        # [data]: parâmetros do POST no formato x-www-form-urlencoded
        # [json]: parâmetros do POST em JSON
        # [cookies]: cookies a serem incluídos na solicitação

        # é necessário ter uma sessão XML ou JSON; caso contrário, não será possível processar a resposta
        if self.__session_type not in ['json''xml']:
            raise ImpôtsError(73"il n'y a pas de session valide en cours")

        # conexão
        if method == "GET":
            # GET
            response = requests.get(url_service, cookies=self.__cookies)
        else:
            # POST
            response = requests.post(url_service, data=data_value, json=json_value, cookies=self.__cookies)

        # modo de depuração?
        if self.__debug:
            # registrador
            if not self.__logger:
                self.__logger = self.__config['logger']
            # estamos registrando
            self.__logger.write(f"{response.text}\n")

        # resultado
        if self.__session_type == "json":
            résultat = json.loads(response.text)
        else:  # xml
            résultat = xmltodict.parse(response.text[39:])['root']

        # recuperam-se os cookies da resposta, se houver
        if response.cookies:
            self.__cookies = response.cookies

        # código de status
        status_code = response.status_code

        # se o código de status for diferente de 200 OK
        if status_code != status.HTTP_200_OK:
            raise ImpôtsError(35, résultat['réponse'])

        # retorna-se o resultado
        return résultat['réponse']

    def init_session(self, session_type: str):
        # registra-se o tipo da sessão
        self.__session_type = session_type

        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['init-session']}/{session_type}"

        # execução da consulta
        self.get_response("GET", url_service)

  • linhas 16-34: o construtor da classe;
  • linha 19: a classe pai é inicializada;
  • linhas 21-28: alguns dados da configuração são armazenados;
  • linhas 29-34: criam-se três propriedades utilizadas nos métodos da classe;
  • linhas 36-82: o método [get_response] abstrai o que é comum a todos os métodos da camada [dao]: o envio de uma solicitação HTTP e a recuperação da resposta HTTP do servidor;
  • linhas 38-42: definição dos 5 parâmetros do método [get_response];
  • linha 42: observe que, como o servidor mantém uma sessão, o cliente precisa ler e reenviar cookies;
  • linhas 44-46: verifica-se se há de fato uma sessão válida em andamento;
  • linha 51: caso do GET. Os cookies recebidos são reenviados;
  • linha 54: caso do POST. Este pode ter dois tipos de parâmetros:
    • o tipo [x-www-form-urlencoded]. É o caso dos URL, [/calculer-impot] e [/authentifier-utilisateur]. Nesse caso, utiliza-se o parâmetro [data_value] recebido pelo método;
    • o tipo [json]. É o caso dos URL e [/calculer-impots]. Nesse caso, utiliza-se o parâmetro [json_value] recebido pelo método;

Nesse caso também, o cookie de sessão é devolvido.

  • linhas 56-62: se estivermos no modo [debug], a resposta do servidor é registrada no log. Esse registro é importante, pois permite saber exatamente o que o servidor retornou;
  • linhas 64-68: dependendo se estamos no modo JSON ou XML, a resposta em texto do servidor é transformada em um dicionário. Tomemos o exemplo do URL [/init-session]:

A resposta jSON é a seguinte:


2020-08-03 11:45:21.218116, MainThread : {"action": "init-session", "état": 700, "réponse": ["session démarrée avec le type de réponse json"]}

A resposta XML é a seguinte:


2020-08-03 11:45:54.671871, MainThread : <?xml version="1.0" encoding="utf-8"?>
<root><action>init-session</action><état>700</état><réponse>session démarrée avec le type de réponse xml</réponse></root>

O código das linhas 64-68 garante que, nos dois casos, obtenha-se em [résultat] um dicionário com as chaves [action, état, réponse];

  • linhas 70 a 72: se a resposta contiver cookies, eles são recuperados. Será necessário reenviá-los na próxima solicitação;
  • linhas 74-79: se o status HTTP da resposta for diferente de 200, lança-se uma exceção com a mensagem de erro contida em resultado[’réponse’]. Pode ser um erro ou uma lista de erros;
  • linhas 81-82: retorna-se a resposta do servidor ao código chamador;

[init_session]

  • linha 84: o método [init_session] serve para definir o tipo de sessão (json ou xml) que o cliente deseja iniciar com o servidor;
  • linha 86: registra-se o tipo de sessão desejado na classe. De fato, todos os métodos precisam dessa informação para decodificar corretamente a resposta do servidor;
  • linhas 88-90: com base na configuração do aplicativo, determina-se o método de serviço URL a ser chamado;
  • linha 93: o serviço URL é consultado. O resultado do método [get_response] não é recuperado:
    • se ela lançar uma exceção, a operação falhou. A exceção não é tratada aqui e será repassada diretamente ao código chamador, que então encerrará o cliente com uma mensagem de erro;
    • se não lançar uma exceção, significa que a inicialização da sessão foi bem-sucedida;

[authenticate_user]


    def authenticate_user(self, user: str, password: str):
        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['authenticate-user']}"
        post_params = {
            "user": user,
            "password": password
        }

        # execução da solicitação
        self.get_response("POST", url_service, post_params)
  • o método [authenticate_user] serve para autenticar-se no servidor. Para isso, ele recebe as credenciais de conexão [user, password] na linha 1;
  • linhas 2-4: determina-se o serviço URL a ser consultado;
  • linhas 5 a 8: os parâmetros do POST, uma vez que o URL e o [/authentifier-utilisateur] aguardam um POST com parâmetros [user, password];
  • linha 11: a consulta é executada. Mais uma vez, não se obtém a resposta do servidor. É a exceção lançada pelo [get_response] que indica se a operação foi bem-sucedida ou não;

[calculate_tax]


    def calculate_tax(self, taxpayer: TaxPayer):
        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['calculate-tax']}"
        # parâmetros do POST
        post_params = {
            "marié": taxpayer.marié,
            "enfants": taxpayer.enfants,
            "salaire": taxpayer.salaire
        }

        # execução da solicitação
        response = self.get_response("POST", url_service, post_params)
        # atualização do TaxPayer com a resposta
        taxpayer.fromdict(response)
  • o método [calculate_tax] permite calcular o imposto de um contribuinte [taxpayer] passado como parâmetro. Esse parâmetro é modificado pelo método (linha 15) e, portanto, constitui o resultado do método;
  • linhas 2-4: define-se o serviço URL a ser consultado;
  • linhas 6-10: os parâmetros do POST a serem enviados. De fato, o serviço URL do serviço [/calculer-impot] aguarda um POST com os parâmetros [marié, enfants, salaire];
  • linhas 12-13: a consulta é executada e a resposta do servidor é recuperada. O URL do serviço [/calculer-impot] retorna um dicionário com as chaves [impôt, décôte, surcôte, réduction, taux] do imposto;
  • linha 15: o dicionário [response] obtido é utilizado para atualizar o contribuinte [taxpayer];

[calculate_tax_in_bulk_mode]


    # cálculo do imposto em modo em lote
    def calculate_tax_in_bulk_mode(self, taxpayers: list):
        # permite que as exceções sejam reportadas

        # converte os contribuintes em uma lista de dicionários
        # mantém-se apenas as propriedades [marié, enfants, salaire]
        list_dict_taxpayers = list(
            map(lambda taxpayer:
                taxpayer.asdict(included_keys=[
                    '_TaxPayer__marié',
                    '_TaxPayer__enfants',
                    '_TaxPayer__salaire']),
                taxpayers))

        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['calculate-tax-in-bulk-mode']}"

        # execução da consulta
        list_dict_taxpayers2 = self.get_response("POST", url_service, data_value=None, json_value=list_dict_taxpayers)
        # quando há apenas um contribuinte e estamos em uma sessão XML, [list_dict_taxpayers2] não é uma lista
        # nesse caso, transforma-se em uma lista
        if not isinstance(list_dict_taxpayers2, list):
            list_dict_taxpayers2 = [list_dict_taxpayers2]
        # atualizamos a lista inicial de contribuintes com os resultados recebidos
        for i in range(len(taxpayers)):
            # atualização dos contribuintes [i]
            taxpayers[i].fromdict(list_dict_taxpayers2[i])
        # aqui, o parâmetro [taxpayers] foi atualizado com os resultados do servidor
  • linha 2: o método recebe uma lista de contribuintes do tipo TaxPayer;
  • linhas 7-13: essa lista de elementos do tipo [TaxPayer] é transformada em uma lista de dicionários [marié, enfants, salaire];
  • linhas 15-17: define-se o URL de serviço;
  • linhas 19-20: executa-se uma consulta POST cujo corpo jSON é formado pela lista de dicionários criada na linha 7. Recupera-se a resposta do servidor;
  • linhas 23-24: os testes revelaram um problema quando a sessão é do tipo XML:
    • se a lista inicial de contribuintes tiver N elementos (N>1), obtém-se como resultado uma lista de N dicionários do tipo [OrderedDict];
    • se a lista inicial tiver apenas um elemento, obtém-se não uma lista, mas um elemento do tipo [OrderedDict];
  • linhas 23-24: se estivermos nesse último caso (1 elemento), transformamos o resultado em uma lista de 1 elemento;
  • linhas 25-28: essa lista de dicionários recebidos contém o imposto de cada contribuinte da lista inicial. Atualiza-se, então, cada um deles com os resultados recebidos;

[get_simulations]


    def get_simulations(self) -> list:
        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['get-simulations']}"

        # execução da consulta
        return self.get_response("GET", url_service)
  • linha 1: o método solicita a lista das simulações realizadas na sessão atual;
  • linha 2: o método retorna a resposta do servidor;

[delete_simulation]


    def delete_simulation(self, id: int) -> list:
        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['delete-simulation']}/{id}"

        # execução da solicitação
        return self.get_response("GET", url_service)
  • linha 1: o método exclui a simulação cujo identificador é passado;
  • linha 7: retorna a resposta do servidor, a lista das simulações restantes após a exclusão solicitada;

[get-admindata]


    def get_admindata(self) -> AdminData:
        # permitimos que as exceções sejam propagadas

        # URL do serviço
        config_server = self.__config_server
        url_service = f"{config_server['urlServer']}{self.__config_services['get-admindata']}"

        # execução da consulta
        résultat = self.get_response("GET", url_service)

        # o resultado é um dicionário de valores do tipo str se for uma sessão XML
        if self.__session_type == 'xml':
            # novo dicionário
            résultat2 = {}
            # converte tudo para formato numérico
            for key, value in résultat.items():
                # alguns elementos do dicionário são listas
                if isinstance(value, list):
                    values = []
                    for value2 in value:
                        values.append(float(value2))
                    résultat2[key] = values
                else:
                    # outros são elementos simples
                    résultat2[key] = float(value)
        else:
            résultat2 = résultat
        # resultado do tipo AdminData
        return AdminData().fromdict(résultat2)
  • linha 1: o método solicita ao servidor as constantes fiscais necessárias para o cálculo do imposto;
  • linha 29: retorna um tipo [AdminData];
  • linha 9: a resposta do servidor é recuperada na forma de um dicionário. Os testes mostram que há um problema quando a sessão é do tipo XML: em vez de serem valores numéricos, os valores do dicionário são cadeias de caracteres. Já havíamos relatado esse problema durante a análise do módulo [xmltodict] e constatado que se tratava de um comportamento normal. O [xmltodict] não possui informações de tipos no fluxo XML que lhe é fornecido. Dito isso, neste caso específico, é necessário converter em valores numéricos todos os valores do dicionário recebido. Este contém três listas [limites, coeffr, coeffn] e uma sequência de propriedades numéricas;
  • linhas 13-25: criação de um dicionário [résultat2] com valores numéricos a partir do dicionário [résultat] com valores do tipo cadeia de caracteres;
  • linha 29: o dicionário [resultat2] é utilizado para inicializar um tipo [AdminData];

31.2.3. A fábrica da camada [dao]

Nossos clientes serão multithread. Como a camada [dao] é implementada por uma classe com estado de leitura/gravação (= propriedades de leitura/gravação), cada thread deve ter sua própria camada [dao] ou, caso contrário, será necessário sincronizar o acesso aos dados compartilhados entre os threads. Aqui, optamos pela primeira solução. Utilizamos uma classe [ImpôtsDaoWithHttpSessionFactory] capaz de criar instâncias da camada [dao]:


from ImpôtsDaoWithHttpSession import ImpôtsDaoWithHttpSession

class ImpôtsDaoWithHttpSessionFactory:

    def __init__(self, config: dict):
        # o parâmetro é armazenado
        self.__config = config

    def new_instance(self):
        # retorna-se uma instância da camada [dao]
        return ImpôtsDaoWithHttpSession(self.__config)

31.3. Configuração dos clientes

Image

Os clientes são configurados pelos arquivos [config] e [config_layers]. O arquivo [config] é o seguinte:


def configure(config: dict) -> dict:
    import os

    # etapa 1 ------

    # pasta deste arquivo
    script_dir = os.path.dirname(os.path.abspath(__file__))

    # caminho raiz
    root_dir = "C:/Data/st-2020/dev/python/cours-2020/python3-flask-2020"

    # dependências absolutas
    absolute_dependencies = [
        # pastas do projeto
        # BaseEntity, MyException
        f"{root_dir}/classes/02/entities",
        # InterfaceImpôtsDao, InterfaceImpôtsMétier, InterfaceImpôtsUi
        f"{root_dir}/impots/v04/interfaces",
        # AbstractImpôtsdao, ImpôtsConsole, ImpôtsMétier
        f"{root_dir}/impots/v04/services",
        # ImpotsDaoWithAdminDataInDatabase
        f"{root_dir}/impots/v05/services",
        # AdminData, ImpôtsError, TaxPayer
        f"{root_dir}/impots/v04/entities",
        # Constantes, faixas
        f"{root_dir}/impots/v05/entities",
        # ImpôtsDaoWithHttpSession, ImpôtsDaoWithHttpSessionFactory, InterfaceImpôtsDaoWithHttpSession
        f"{script_dir}/../services",
        # scripts de configuração
        script_dir,
        # Logger
        f"{root_dir}/impots/http-servers/02/utilities",
    ]

    # definimos o syspath
    from myutils import set_syspath
    set_syspath(absolute_dependencies)

    # etapa 2 ------
    # configuração do aplicativo com constantes
    config.update({
        # arquivo de contribuintes
        "taxpayersFilename"f"{script_dir}/../data/input/taxpayersdata.txt",
        # arquivo de resultados
        "resultsFilename"f"{script_dir}/../data/output/résultats.json",
        # arquivo de erros
        "errorsFilename"f"{script_dir}/../data/output/errors.txt",
        # arquivo de logs
        "logsFilename"f"{script_dir}/../data/logs/logs.txt",
        # servidor de cálculo de impostos
        "server": {
            "urlServer""http://127.0.0.1:5000",
            "user": {
                "login""admin",
                "password""admin"
            },
            "url_services": {
                "calculate-tax""/calculer-impot",
                "get-admindata""/get-admindata",
                "calculate-tax-in-bulk-mode""/calculer-impots",
                "init-session""/init-session",
                "end-session""/fin-session",
                "authenticate-user""/authentifier-utilisateur",
                "get-simulations""/lister-simulations",
                "delete-simulation""/supprimer-simulation"
            }
        },
        # modo de depuração
        "debug"True
    }
    )

    # etapa 3 ------
    # instanciação das camadas
    import config_layers
    config['layers'] = config_layers.configure(config)

    # fazemos a configuração
    return config

O arquivo [config_layers] é o seguinte:


def configure(config: dict) -> dict:
    # instanciação das camadas do aplicativo

    # camada [métier]
    from ImpôtsMétier import ImpôtsMétier
    métier = ImpôtsMétier()

    # fábrica da camada DAO
    from ImpôtsDaoWithHttpSessionFactory import ImpôtsDaoWithHttpSessionFactory
    dao_factory = ImpôtsDaoWithHttpSessionFactory(config)

    # fazemos a configuração das camadas
    return {
        "dao_factory": dao_factory,
        "métier": métier
    }
  • os clientes não terão acesso direto à camada [dao]. Para obtê-lo, eles deverão passar pela fábrica da camada [dao];

31.4. O cliente [main]

Image

O cliente [main] permite testar os URL e [/init-session, /authentifier-utilisateur, /calculer-impots, /fin-session]:


# espera-se um parâmetro JSON ou XML
import sys

syntaxe = f"{sys.argv[0]} json / xml"
erreur = len(sys.argv) != 2
if not erreur:
    session_type = sys.argv[1].lower()
    erreur = session_type != "json" and session_type != "xml"
if erreur:
    print(f"syntaxe : {syntaxe}")
    sys.exit()

# configurando o aplicativo
import config
config = config.configure({"session_type": session_type})

# dependências
from ImpôtsError import ImpôtsError
import random
import sys
import threading
from Logger import Logger

# execução da camada [dao] em um thread
# taxpayers é uma lista de contribuintes
def thread_function(config: dict, taxpayers: list):
    # recupera-se a fábrica da camada [dao]
    dao_factory = config['layers']['dao_factory']
    # cria-se uma instância da camada [dao]
    dao = dao_factory.new_instance()
    # tipo da sessão
    session_type = config['session_type']
    # número de contribuintes
    nb_taxpayers = len(taxpayers)
    # log
    logger.write(f"début du calcul de l'impôt des {nb_taxpayers} contribuables\n")
    # inicializa-se a sessão
    dao.init_session(session_type)
    # autenticação
    dao.authenticate_user(config['server']['user']['login'], config['server']['user']['password'])
    # cálculo do imposto dos contribuintes
    dao.calculate_tax_in_bulk_mode(taxpayers)
    # fim da sessão
    dao.end_session()
    # registro
    logger.write(f"fin du calcul de l'impôt des {nb_taxpayers} contribuables\n")

# lista de threads do cliente
threads = []
logger = None
# código
try:
    # registrador
    logger = Logger(config["logsFilename"])
    # armazenado na configuração
    config["logger"] = logger
    # registro de início
    logger.write("début du calcul de l'impôt des contribuables\n")
    # recuperamos a fábrica da camada [dao]
    dao_factory = config["layers"]["dao_factory"]
    # cria-se uma instância da camada [dao]
    dao = dao_factory.new_instance()
    # leitura dos dados dos contribuintes
    taxpayers = dao.get_taxpayers_data()["taxpayers"]
    # dos contribuintes?
    if not taxpayers:
        raise ImpôtsError(36f"Pas de contribuables valides dans le fichier {config['taxpayersFilename']}")
    # cálculo do imposto dos contribuintes com várias threads
    i = 0
    l_taxpayers = len(taxpayers)
    while i < len(taxpayers):
        # cada thread processará de 1 a 4 contribuintes
        nb_taxpayers = min(l_taxpayers - i, random.randint(14))
        # a lista de contribuintes processados pela thread
        thread_taxpayers = taxpayers[slice(i, i + nb_taxpayers)]
        # incrementa-se i para a próxima thread
        i += nb_taxpayers
        # cria-se o thread
        thread = threading.Thread(target=thread_function, args=(config, thread_taxpayers))
        # ele é adicionado à lista de threads do script principal
        threads.append(thread)
        # inicia-se a thread — essa operação é assíncrona — não se aguarda o resultado da thread
        thread.start()
    # o thread principal aguarda a conclusão de todos os threads que iniciou
    for thread in threads:
        thread.join()
    # aqui, todas as threads concluíram seu trabalho — cada uma modificou um ou mais objetos [taxpayer]
    # os resultados são gravados no arquivo jSON
    dao.write_taxpayers_results(taxpayers)
    # fim
except BaseException as erreur:
    # exibição do erro
    print(f"L'erreur suivante s'est produite : {erreur}")
finally:
    # fecha-se o registrador
    if logger:
        # registro de encerramento
        logger.write("fin du calcul de l'impôt des contribuables\n")
        # fechamento do registrador
        logger.close()
    # concluído
    print("Travail terminé...")
    # encerramento dos threads que ainda possam existir caso a execução tenha sido interrompida devido a um erro
    sys.exit()
  • linhas 4-11: o cliente aguarda um parâmetro que indique o tipo de sessão, json ou xml, a ser usado com o servidor;
  • linhas 13-15: o cliente está configurado;
  • linhas 48-104: esse código é conhecido. Já foi utilizado inúmeras vezes. Ele distribui os contribuintes para os quais se deseja calcular o imposto por várias threads;
  • linha 26: o método [thread_function] é o método executado por cada thread para calcular o imposto dos contribuintes que lhe foram atribuídos;
  • linhas 27-30: cada thread possui sua própria camada [dao];
  • o cálculo do imposto é feito em quatro etapas:
    • linhas 37-38: inicialização de uma sessão, em JSON ou XML, com o servidor;
    • linhas 39-40: autenticação junto ao servidor;
    • linhas 41-42: cálculo do imposto;
    • linhas 43-44: encerramento da sessão com o servidor;

Ao executar esse código no modo [json], obtêm-se os seguintes logs:


2020-08-03 14:28:34.320751, MainThread : début du calcul de l'impôt des contribuables
2020-08-03 14:28:34.328749, Thread-1 : début du calcul de l'impôt des 4 contribuables
2020-08-03 14:28:34.328749, Thread-2 : début du calcul de l'impôt des 4 contribuables
2020-08-03 14:28:34.333592, Thread-3 : début du calcul de l'impôt des 3 contribuables
2020-08-03 14:28:34.368651, Thread-2 : {"action": "init-session", "état": 700, "réponse": ["session démarrée avec le type de réponse json"]}
2020-08-03 14:28:34.375699, Thread-1 : {"action": "init-session", "état": 700, "réponse": ["session démarrée avec le type de réponse json"]}
2020-08-03 14:28:34.377432, Thread-3 : {"action": "init-session", "état": 700, "réponse": ["session démarrée avec le type de réponse json"]}
2020-08-03 14:28:34.385653, Thread-2 : {"action": "authentifier-utilisateur", "état": 200, "réponse": "Authentification réussie"}
2020-08-03 14:28:34.392656, Thread-1 : {"action": "authentifier-utilisateur", "état": 200, "réponse": "Authentification réussie"}
2020-08-03 14:28:34.396377, Thread-3 : {"action": "authentifier-utilisateur", "état": 200, "réponse": "Authentification réussie"}
2020-08-03 14:28:34.406528, Thread-2 : {"action": "calculer-impots", "état": 1500, "réponse": [{"marié": "non", "enfants": 3, "salaire": 100000, "impôt": 16782, "surcôte": 7176, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 1}, {"marié": "oui", "enfants": 3, "salaire": 100000, "impôt": 9200, "surcôte": 2180, "taux": 0.3, "décôte": 0, "réduction": 0, "id": 2}, {"marié": "oui", "enfants": 5, "salaire": 100000, "impôt": 4230, "surcôte": 0, "taux": 0.14, "décôte": 0, "réduction": 0, "id": 3}, {"marié": "non", "enfants": 0, "salaire": 100000, "impôt": 22986, "surcôte": 0, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 4}]}
2020-08-03 14:28:34.413837, Thread-1 : {"action": "calculer-impots", "état": 1500, "réponse": [{"marié": "oui", "enfants": 2, "salaire": 55555, "impôt": 2814, "surcôte": 0, "taux": 0.14, "décôte": 0, "réduction": 0, "id": 1}, {"marié": "oui", "enfants": 2, "salaire": 50000, "impôt": 1384, "surcôte": 0, "taux": 0.14, "décôte": 384, "réduction": 347, "id": 2}, {"marié": "oui", "enfants": 3, "salaire": 50000, "impôt": 0, "surcôte": 0, "taux": 0.14, "décôte": 720, "réduction": 0, "id": 3}, {"marié": "non", "enfants": 2, "salaire": 100000, "impôt": 19884, "surcôte": 4480, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 4}]}
2020-08-03 14:28:34.416695, Thread-3 : {"action": "calculer-impots", "état": 1500, "réponse": [{"marié": "oui", "enfants": 2, "salaire": 30000, "impôt": 0, "surcôte": 0, "taux": 0.0, "décôte": 0, "réduction": 0, "id": 1}, {"marié": "non", "enfants": 0, "salaire": 200000, "impôt": 64210, "surcôte": 7498, "taux": 0.45, "décôte": 0, "réduction": 0, "id": 2}, {"marié": "oui", "enfants": 3, "salaire": 200000, "impôt": 42842, "surcôte": 17283, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 3}]}
2020-08-03 14:28:34.425747, Thread-2 : {"action": "fin-session", "état": 400, "réponse": "session réinitialisée"}
2020-08-03 14:28:34.425747, Thread-2 : fin du calcul de l'impôt des 4 contribuables
2020-08-03 14:28:34.428956, Thread-1 : {"action": "fin-session", "état": 400, "réponse": "session réinitialisée"}
2020-08-03 14:28:34.428956, Thread-1 : fin du calcul de l'impôt des 4 contribuables
2020-08-03 14:28:34.428956, Thread-3 : {"action": "fin-session", "état": 400, "réponse": "session réinitialisée"}
2020-08-03 14:28:34.428956, Thread-3 : fin du calcul de l'impôt des 3 contribuables
2020-08-03 14:28:34.428956, MainThread : fin du calcul de l'impôt des contribuables

Acima, vemos o percurso da thread [Thread-2].

Se executarmos [main] no modo XML, os logs serão os seguintes:


2020-08-03 14:32:48.495316, MainThread : début du calcul de l'impôt des contribuables
2020-08-03 14:32:48.496452, Thread-1 : début du calcul de l'impôt des 2 contribuables
2020-08-03 14:32:48.498992, Thread-2 : début du calcul de l'impôt des 2 contribuables
2020-08-03 14:32:48.498992, Thread-3 : début du calcul de l'impôt des 4 contribuables
2020-08-03 14:32:48.498992, Thread-4 : début du calcul de l'impôt des 3 contribuables
2020-08-03 14:32:48.538637, Thread-1 : <?xml version="1.0" encoding="utf-8"?>
<root><action>init-session</action><état>700</état><réponse>session démarrée avec le type de réponse xml</réponse></root>
2020-08-03 14:32:48.540783, Thread-4 : <?xml version="1.0" encoding="utf-8"?>
<root><action>init-session</action><état>700</état><réponse>session démarrée avec le type de réponse xml</réponse></root>
2020-08-03 14:32:48.547811, Thread-3 : <?xml version="1.0" encoding="utf-8"?>
<root><action>init-session</action><état>700</état><réponse>session démarrée avec le type de réponse xml</réponse></root>
2020-08-03 14:32:48.547811, Thread-2 : <?xml version="1.0" encoding="utf-8"?>
<root><action>init-session</action><état>700</état><réponse>session démarrée avec le type de réponse xml</réponse></root>
2020-08-03 14:32:48.555184, Thread-1 : <?xml version="1.0" encoding="utf-8"?>
<root><action>authentifier-utilisateur</action><état>200</état><réponse>Authentification réussie</réponse></root>
2020-08-03 14:32:48.564793, Thread-2 : <?xml version="1.0" encoding="utf-8"?>
<root><action>authentifier-utilisateur</action><état>200</état><réponse>Authentification réussie</réponse></root>
2020-08-03 14:32:48.564793, Thread-3 : <?xml version="1.0" encoding="utf-8"?>
<root><action>authentifier-utilisateur</action><état>200</état><réponse>Authentification réussie</réponse></root>
2020-08-03 14:32:48.568333, Thread-4 : <?xml version="1.0" encoding="utf-8"?>
<root><action>authentifier-utilisateur</action><état>200</état><réponse>Authentification réussie</réponse></root>
2020-08-03 14:32:48.568333, Thread-1 : <?xml version="1.0" encoding="utf-8"?>
<root><action>calculer-impots</action><état>1500</état><réponse><marié>oui</marié><enfants>2</enfants><salaire>55555</salaire><impôt>2814</impôt><surcôte>0</surcôte><taux>0.14</taux><décôte>0</décôte><réduction>0</réduction><id>1</id></réponse><réponse><marié>oui</marié><enfants>2</enfants><salaire>50000</salaire><impôt>1384</impôt><surcôte>0</surcôte><taux>0.14</taux><décôte>384</décôte><réduction>347</réduction><id>2</id></réponse></root>
2020-08-03 14:32:48.579205, Thread-2 : <?xml version="1.0" encoding="utf-8"?>
<root><action>calculer-impots</action><état>1500</état><réponse><marié>oui</marié><enfants>3</enfants><salaire>50000</salaire><impôt>0</impôt><surcôte>0</surcôte><taux>0.14</taux><décôte>720</décôte><réduction>0</réduction><id>1</id></réponse><réponse><marié>non</marié><enfants>2</enfants><salaire>100000</salaire><impôt>19884</impôt><surcôte>4480</surcôte><taux>0.41</taux><décôte>0</décôte><réduction>0</réduction><id>2</id></réponse></root>
2020-08-03 14:32:48.579205, Thread-3 : <?xml version="1.0" encoding="utf-8"?>
<root><action>calculer-impots</action><état>1500</état><réponse><marié>non</marié><enfants>3</enfants><salaire>100000</salaire><impôt>16782</impôt><surcôte>7176</surcôte><taux>0.41</taux><décôte>0</décôte><réduction>0</réduction><id>1</id></réponse><réponse><marié>oui</marié><enfants>3</enfants><salaire>100000</salaire><impôt>9200</impôt><surcôte>2180</surcôte><taux>0.3</taux><décôte>0</décôte><réduction>0</réduction><id>2</id></réponse><réponse><marié>oui</marié><enfants>5</enfants><salaire>100000</salaire><impôt>4230</impôt><surcôte>0</surcôte><taux>0.14</taux><décôte>0</décôte><réduction>0</réduction><id>3</id></réponse><réponse><marié>non</marié><enfants>0</enfants><salaire>100000</salaire><impôt>22986</impôt><surcôte>0</surcôte><taux>0.41</taux><décôte>0</décôte><réduction>0</réduction><id>4</id></réponse></root>
2020-08-03 14:32:48.588051, Thread-4 : <?xml version="1.0" encoding="utf-8"?>
<root><action>calculer-impots</action><état>1500</état><réponse><marié>oui</marié><enfants>2</enfants><salaire>30000</salaire><impôt>0</impôt><surcôte>0</surcôte><taux>0.0</taux><décôte>0</décôte><réduction>0</réduction><id>1</id></réponse><réponse><marié>non</marié><enfants>0</enfants><salaire>200000</salaire><impôt>64210</impôt><surcôte>7498</surcôte><taux>0.45</taux><décôte>0</décôte><réduction>0</réduction><id>2</id></réponse><réponse><marié>oui</marié><enfants>3</enfants><salaire>200000</salaire><impôt>42842</impôt><surcôte>17283</surcôte><taux>0.41</taux><décôte>0</décôte><réduction>0</réduction><id>3</id></réponse></root>
2020-08-03 14:32:48.594058, Thread-1 : <?xml version="1.0" encoding="utf-8"?>
<root><action>fin-session</action><état>400</état><réponse>session réinitialisée</réponse></root>
2020-08-03 14:32:48.595198, Thread-1 : fin du calcul de l'impôt des 2 contribuables
2020-08-03 14:32:48.595198, Thread-2 : <?xml version="1.0" encoding="utf-8"?>
<root><action>fin-session</action><état>400</état><réponse>session réinitialisée</réponse></root>
2020-08-03 14:32:48.595198, Thread-2 : fin du calcul de l'impôt des 2 contribuables
2020-08-03 14:32:48.595198, Thread-3 : <?xml version="1.0" encoding="utf-8"?>
<root><action>fin-session</action><état>400</état><réponse>session réinitialisée</réponse></root>
2020-08-03 14:32:48.595198, Thread-3 : fin du calcul de l'impôt des 4 contribuables
2020-08-03 14:32:48.603351, Thread-4 : <?xml version="1.0" encoding="utf-8"?>
<root><action>fin-session</action><état>400</état><réponse>session réinitialisée</réponse></root>
2020-08-03 14:32:48.603351, Thread-4 : fin du calcul de l'impôt des 3 contribuables
2020-08-03 14:32:48.603351, MainThread : fin du calcul de l'impôt des contribuables

Acima, o percurso do thread [Thread-2].

31.5. O cliente [main2]

Image

O cliente [main2] permite testar os URL e [/init-session, /authentifier-utilisateur, /get-admindata, /fin-session]:


# aguardando um parâmetro JSON ou XML
import sys

syntaxe = f"{sys.argv[0]} json / xml"
erreur = len(sys.argv) != 2
if not erreur:
    session_type = sys.argv[1].lower()
    erreur = session_type != "json" and session_type != "xml"
if erreur:
    print(f"syntaxe : {syntaxe}")
    sys.exit()

# configurando o aplicativo
import config
config = config.configure({"session_type": session_type})

# dependências
from ImpôtsError import ImpôtsError
from Logger import Logger

logger = None
# código
try:
    # registrador
    logger = Logger(config["logsFilename"])
    # armazenando na configuração
    config["logger"] = logger
    # log de início
    logger.write("début du calcul de l'impôt des contribuables\n")
    # recuperamos a fábrica da camada [dao]
    dao_factory = config['layers']['dao_factory']
    # cria-se uma instância da camada [dao]
    dao = dao_factory.new_instance()
    # recupera-se os contribuintes
    taxpayers = dao.get_taxpayers_data()["taxpayers"]
    # dos contribuintes?
    if not taxpayers:
        raise ImpôtsError(36f"Pas de contribuables valides dans le fichier {config['taxpayersFilename']}")
    # tipo da sessão
    session_type = config['session_type']
    # inicializa-se a sessão
    dao.init_session(session_type)
    # autenticação
    dao.authenticate_user(config['server']['user']['login'], config['server']['user']['password'])
    # recuperando os dados da administração fiscal
    admindata = dao.get_admindata()
    # fim da sessão
    dao.end_session()
    # cálculo do imposto dos contribuintes pela camada [métier]
    métier = config['layers']['métier']
    for taxpayer in taxpayers:
        métier.calculate_tax(taxpayer, admindata)
    # os resultados são gravados no arquivo jSON
    dao.write_taxpayers_results(taxpayers)
 except BaseException as erreur:
     # exibição do erro
     print(f"L'erreur suivante s'est produite : {erreur}")
finally:
    # fecha-se o registrador
    if logger:
        # registro de encerramento
        logger.write("fin du calcul de l'impôt des contribuables\n")
        # encerramento do registrador
        logger.close()
    # concluído
    print("Travail terminé...")
  • linhas 1-11: recupera-se o parâmetro [json, xml], que define o tipo de sessão a ser estabelecida com o servidor;
  • linhas 13-15: configura-se o cliente;
  • linhas 30-33: cria-se uma camada [dao];
  • linhas 34-35: com ela, recupera-se a lista de contribuintes para os quais é necessário calcular o imposto;
  • em seguida, ocorrem as quatro etapas do diálogo com o servidor;
    • linhas 41-42: inicia-se uma sessão com o servidor;
    • linhas 43-44: realiza-se a autenticação junto ao servidor;
    • linhas 45-46: solicitam-se ao servidor as constantes fiscais necessárias para o cálculo do imposto;
    • linhas 47-48: encerra-se a sessão com o servidor;
  • linhas 49-52: com essas constantes, é possível calcular o imposto dos contribuintes por meio da camada [métier] local no cliente;
  • linhas 53-54: registram-se os resultados obtidos;

Para uma sessão XML, os resultados são os seguintes:


2020-08-03 14:44:43.194294, MainThread : début du calcul de l'impôt des contribuables
2020-08-03 14:44:43.231633, MainThread : <?xml version="1.0" encoding="utf-8"?>
<root><action>init-session</action><état>700</état><réponse>session démarrée avec le type de réponse xml</réponse></root>
2020-08-03 14:44:43.240872, MainThread : <?xml version="1.0" encoding="utf-8"?>
<root><action>authentifier-utilisateur</action><état>200</état><réponse>Authentification réussie</réponse></root>
2020-08-03 14:44:43.250061, MainThread : <?xml version="1.0" encoding="utf-8"?>
<root><action>get-admindata</action><état>1000</état><réponse><limites>9964.0</limites><limites>27519.0</limites><limites>73779.0</limites><limites>156244.0</limites><limites>93749.0</limites><coeffr>0.0</coeffr><coeffr>0.14</coeffr><coeffr>0.3</coeffr><coeffr>0.41</coeffr><coeffr>0.45</coeffr><coeffn>0.0</coeffn><coeffn>1394.96</coeffn><coeffn>5798.0</coeffn><coeffn>13913.7</coeffn><coeffn>20163.4</coeffn><abattement_dixpourcent_min>437.0</abattement_dixpourcent_min><plafond_impot_couple_pour_decote>2627.0</plafond_impot_couple_pour_decote><plafond_decote_couple>1970.0</plafond_decote_couple><valeur_reduc_demi_part>3797.0</valeur_reduc_demi_part><plafond_revenus_celibataire_pour_reduction>21037.0</plafond_revenus_celibataire_pour_reduction><id>1</id><abattement_dixpourcent_max>12502.0</abattement_dixpourcent_max><plafond_impot_celibataire_pour_decote>1595.0</plafond_impot_celibataire_pour_decote><plafond_decote_celibataire>1196.0</plafond_decote_celibataire><plafond_revenus_couple_pour_reduction>42074.0</plafond_revenus_couple_pour_reduction><plafond_qf_demi_part>1551.0</plafond_qf_demi_part></réponse></root>
2020-08-03 14:44:43.269850, MainThread : <?xml version="1.0" encoding="utf-8"?>
<root><action>fin-session</action><état>400</état><réponse>session réinitialisée</réponse></root>
2020-08-03 14:44:43.269850, MainThread : fin du calcul de l'impôt des contribuables

31.6. O cliente [main3]

O cliente [main3] permite testar os URL e [/init-session, /calculer-impots, /get-simulations, /delete-simulation, /fin-session]:

Image


# aguardando um parâmetro JSON ou XML
import sys

syntaxe = f"{sys.argv[0]} json / xml"
erreur = len(sys.argv) != 2
if not erreur:
    session_type = sys.argv[1].lower()
    erreur = session_type != "json" and session_type != "xml"
if erreur:
    print(f"syntaxe : {syntaxe}")
    sys.exit()

# configurando o aplicativo
import config
config = config.configure({"session_type": session_type})

# dependências
from ImpôtsError import ImpôtsError
import sys
from Logger import Logger

logger = None
# código
try:
    # registrador
    logger = Logger(config["logsFilename"])
    # armazenando na configuração
    config["logger"] = logger
    # log de início
    logger.write("début du calcul de l'impôt des contribuables\n")
    # recuperamos a fábrica da camada [dao]
    dao_factory = config["layers"]["dao_factory"]
    # cria-se uma instância da camada [dao]
    dao = dao_factory.new_instance()
    # leitura dos dados dos contribuintes
    taxpayers = dao.get_taxpayers_data()["taxpayers"]
    # dos contribuintes?
    if not taxpayers:
        raise ImpôtsError(36f"Pas de contribuables valides dans le fichier {config['taxpayersFilename']}")
    # cálculo do imposto dos contribuintes
    # número de contribuintes
    nb_taxpayers = len(taxpayers)
    # registro
    logger.write(f"début du calcul de l'impôt des {nb_taxpayers} contribuables\n")
    # inicializa-se a sessão
    dao.init_session(session_type)
    # autenticação
    dao.authenticate_user(config['server']['user']['login'], config['server']['user']['password'])
    # cálculo do imposto dos contribuintes
    dao.calculate_tax_in_bulk_mode(taxpayers)
    # solicita-se a lista de simulações
    simulations = dao.get_simulations()
    # elimina-se uma em cada duas
    for i in range(len(simulations)):
        if i % 2 == 0:
            # elimina-se a simulação
            dao.delete_simulation(simulations[i]['id'])
    # fim da sessão
    dao.end_session()
    # consulte os logs para ver os diferentes resultados (modo debug=True)
except BaseException as erreur:
    # exibição do erro
    print(f"L'erreur suivante s'est produite : {erreur}")
finally:
    # encerrando o registrador de logs
    if logger:
        # log de encerramento
        logger.write("fin du calcul de l'impôt des contribuables\n")
        # encerramento do registrador
        logger.close()
    # concluído
    print("Travail terminé...")
  • linhas 1-11: obtém-se o tipo da sessão nos parâmetros do script;
  • linhas 13-15: configura-se o aplicativo;
  • linhas 25-50: encontramos código já explicado em algum momento;
  • linhas 51-52: solicita-se a lista das simulações realizadas na sessão atual;
  • linhas 53-57: exclui-se uma em cada duas simulações;
  • linhas 58-59: encerra-se a sessão;

Durante uma sessão jSON, os logs são os seguintes:


2020-08-03 15:01:52.702297, MainThread : début du calcul de l'impôt des contribuables
2020-08-03 15:01:52.702297, MainThread : début du calcul de l'impôt des 11 contribuables
2020-08-03 15:01:52.734806, MainThread : {"action": "init-session", "état": 700, "réponse": ["session démarrée avec le type de réponse json"]}
2020-08-03 15:01:52.747961, MainThread : {"action": "authentifier-utilisateur", "état": 200, "réponse": "Authentification réussie"}
2020-08-03 15:01:52.765721, MainThread : {"action": "calculer-impots", "état": 1500, "réponse": [{"marié": "oui", "enfants": 2, "salaire": 55555, "impôt": 2814, "surcôte": 0, "taux": 0.14, "décôte": 0, "réduction": 0, "id": 1}, {"marié": "oui", "enfants": 2, "salaire": 50000, "impôt": 1384, "surcôte": 0, "taux": 0.14, "décôte": 384, "réduction": 347, "id": 2}, {"marié": "oui", "enfants": 3, "salaire": 50000, "impôt": 0, "surcôte": 0, "taux": 0.14, "décôte": 720, "réduction": 0, "id": 3}, {"marié": "non", "enfants": 2, "salaire": 100000, "impôt": 19884, "surcôte": 4480, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 4}, {"marié": "non", "enfants": 3, "salaire": 100000, "impôt": 16782, "surcôte": 7176, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 5}, {"marié": "oui", "enfants": 3, "salaire": 100000, "impôt": 9200, "surcôte": 2180, "taux": 0.3, "décôte": 0, "réduction": 0, "id": 6}, {"marié": "oui", "enfants": 5, "salaire": 100000, "impôt": 4230, "surcôte": 0, "taux": 0.14, "décôte": 0, "réduction": 0, "id": 7}, {"marié": "non", "enfants": 0, "salaire": 100000, "impôt": 22986, "surcôte": 0, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 8}, {"marié": "oui", "enfants": 2, "salaire": 30000, "impôt": 0, "surcôte": 0, "taux": 0.0, "décôte": 0, "réduction": 0, "id": 9}, {"marié": "non", "enfants": 0, "salaire": 200000, "impôt": 64210, "surcôte": 7498, "taux": 0.45, "décôte": 0, "réduction": 0, "id": 10}, {"marié": "oui", "enfants": 3, "salaire": 200000, "impôt": 42842, "surcôte": 17283, "taux": 0.41, "décôte": 0, "réduction": 0, "id": 11}]}
2020-08-03 15:01:52.785505, MainThread : {"action": "lister-simulations", "état": 500, "réponse": [{"décôte": 0, "enfants": 2, "id": 1, "impôt": 2814, "marié": "oui", "réduction": 0, "salaire": 55555, "surcôte": 0, "taux": 0.14}, {"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 720, "enfants": 3, "id": 3, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 5, "impôt": 16782, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 7176, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 5, "id": 7, "impôt": 4230, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 2, "id": 9, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 30000, "surcôte": 0, "taux": 0.0}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}, {"décôte": 0, "enfants": 3, "id": 11, "impôt": 42842, "marié": "oui", "réduction": 0, "salaire": 200000, "surcôte": 17283, "taux": 0.41}]}
2020-08-03 15:01:52.801475, MainThread : {"action": "supprimer-simulation", "état": 600, "réponse": [{"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 720, "enfants": 3, "id": 3, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 5, "impôt": 16782, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 7176, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 5, "id": 7, "impôt": 4230, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 2, "id": 9, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 30000, "surcôte": 0, "taux": 0.0}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}, {"décôte": 0, "enfants": 3, "id": 11, "impôt": 42842, "marié": "oui", "réduction": 0, "salaire": 200000, "surcôte": 17283, "taux": 0.41}]}
2020-08-03 15:01:52.810129, MainThread : {"action": "supprimer-simulation", "état": 600, "réponse": [{"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 5, "impôt": 16782, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 7176, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 5, "id": 7, "impôt": 4230, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 2, "id": 9, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 30000, "surcôte": 0, "taux": 0.0}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}, {"décôte": 0, "enfants": 3, "id": 11, "impôt": 42842, "marié": "oui", "réduction": 0, "salaire": 200000, "surcôte": 17283, "taux": 0.41}]}
2020-08-03 15:01:52.818803, MainThread : {"action": "supprimer-simulation", "état": 600, "réponse": [{"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 5, "id": 7, "impôt": 4230, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 2, "id": 9, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 30000, "surcôte": 0, "taux": 0.0}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}, {"décôte": 0, "enfants": 3, "id": 11, "impôt": 42842, "marié": "oui", "réduction": 0, "salaire": 200000, "surcôte": 17283, "taux": 0.41}]}
2020-08-03 15:01:52.834604, MainThread : {"action": "supprimer-simulation", "état": 600, "réponse": [{"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 2, "id": 9, "impôt": 0, "marié": "oui", "réduction": 0, "salaire": 30000, "surcôte": 0, "taux": 0.0}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}, {"décôte": 0, "enfants": 3, "id": 11, "impôt": 42842, "marié": "oui", "réduction": 0, "salaire": 200000, "surcôte": 17283, "taux": 0.41}]}
2020-08-03 15:01:52.843803, MainThread : {"action": "supprimer-simulation", "état": 600, "réponse": [{"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}, {"décôte": 0, "enfants": 3, "id": 11, "impôt": 42842, "marié": "oui", "réduction": 0, "salaire": 200000, "surcôte": 17283, "taux": 0.41}]}
2020-08-03 15:01:52.851855, MainThread : {"action": "supprimer-simulation", "état": 600, "réponse": [{"décôte": 384, "enfants": 2, "id": 2, "impôt": 1384, "marié": "oui", "réduction": 347, "salaire": 50000, "surcôte": 0, "taux": 0.14}, {"décôte": 0, "enfants": 2, "id": 4, "impôt": 19884, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 4480, "taux": 0.41}, {"décôte": 0, "enfants": 3, "id": 6, "impôt": 9200, "marié": "oui", "réduction": 0, "salaire": 100000, "surcôte": 2180, "taux": 0.3}, {"décôte": 0, "enfants": 0, "id": 8, "impôt": 22986, "marié": "non", "réduction": 0, "salaire": 100000, "surcôte": 0, "taux": 0.41}, {"décôte": 0, "enfants": 0, "id": 10, "impôt": 64210, "marié": "non", "réduction": 0, "salaire": 200000, "surcôte": 7498, "taux": 0.45}]}
2020-08-03 15:01:52.863165, MainThread : {"action": "fin-session", "état": 400, "réponse": "session réinitialisée"}
2020-08-03 15:01:52.863165, MainThread : fin du calcul de l'impôt des contribuables
  • linha 6: temos 11 simulações;
  • linha 12: após as diversas exclusões, restam apenas 5;

31.7. A classe de teste [Test2HttpClientDaoWithSession]

Image

A classe [Test2HttpClientDaoWithSession] testa a camada [dao] dos clientes da seguinte maneira:


import unittest

from ImpôtsError import ImpôtsError
from Logger import Logger
from TaxPayer import TaxPayer

class Test2HttpClientDaoWithSession(unittest.TestCase):

    def test_init_session_json(self) -> None:
        print('test_init_session_json')
        erreur = False
        try:
            dao.init_session('json')
        except ImpôtsError as ex:
            print(ex)
            erreur = True
        # não deve haver erros
        self.assertFalse(erreur)

    def test_init_session_xml(self) -> None:
        print('test_init_session_xml')
        erreur = False
        try:
            dao.init_session('xml')
        except ImpôtsError as ex:
            print(ex)
            erreur = True
        # não deve haver erros
        self.assertFalse(erreur)

    def test_init_session_xxx(self) -> None:
        print('test_init_session_xxx')
        erreur = False
        try:
            dao.init_session('xxx')
        except ImpôtsError as ex:
            print(ex)
            erreur = True
        # deve haver um erro
        self.assertTrue(erreur)

    def test_authenticate_user_success(self) -> None:
        print('test_authenticate_user_success')
        # inicializar sessão
        dao.init_session('json')
        # teste
        erreur = False
        try:
            dao.authenticate_user(config['server']['user']['login'], config['server']['user']['password'])
        except ImpôtsError as ex:
            print(ex)
            erreur = True
        # não deve haver erro
        self.assertFalse(erreur)

    def test_authenticate_user_failed(self) -> None:
        print('test_authenticate_user_failed')
        # inicialização da sessão
        dao.init_session('json')
        # teste
        erreur = False
        try:
            dao.authenticate_user('x''y')
        except ImpôtsError as ex:
            print(ex)
            erreur = True
        # deve haver um erro
        self.assertTrue(erreur)

    def test_get_simulations(self) -> None:
        print('test_get_simulations')
        # inicialização da sessão
        dao.init_session('json')
        # autenticação
        dao.authenticate_user('admin''admin')
        # cálculo de imposto
        # {'casado': 'sim', 'filhos': 2, 'salário': 55555,
        # 'imposto': 2814, 'sobretaxa': 0, 'abatimento': 0, 'redução': 0, 'alíquota': 0,14}
        taxpayer = TaxPayer().fromdict({"marié""oui""enfants"2"salaire"55555})
        dao.calculate_tax(taxpayer)
        # get_simulations
        simulations = dao.get_simulations()
        # verificações
        # deve haver 1 simulação
        self.assertEqual(1, len(simulations))
        simulation = simulations[0]
        # verificação do imposto calculado
        self.assertAlmostEqual(simulation['impôt']2815, delta=1)
        self.assertEqual(simulation['décôte']0)
        self.assertEqual(simulation['réduction']0)
        self.assertAlmostEqual(simulation['taux']0.14, delta=0.01)
        self.assertEqual(simulation['surcôte']0)

    def test_delete_simulation(self) -> None:
        print('test_delete_simulation')
        # inicialização da sessão
        dao.init_session('json')
        # autenticação
        dao.authenticate_user('admin''admin')
        # cálculo do imposto
        taxpayer = TaxPayer().fromdict({"marié""oui""enfants"2"salaire"55555})
        dao.calculate_tax(taxpayer)
        # get_simulations
        simulations = dao.get_simulations()
        # delete_simulation
        dao.delete_simulation(simulations[0]['id'])
        # get_simulations
        simulations = dao.get_simulations()
        # verificação — não deve haver mais simulações
        self.assertEqual(0, len(simulations))
        # estamos excluindo uma simulação que não existe
        erreur = False
        try:
            dao.delete_simulation(100)
        except ImpôtsError as ex:
            print(ex)
            erreur = True
        # deve haver um erro
        self.assertTrue(erreur)

if __name__ == '__main__':
    # configurando o aplicativo
    import config
    config = config.configure({})

    # registrar
    logger = Logger(config["logsFilename"])
    # armazenando na configuração
    config["logger"] = logger

    # camada [dao]
    dao_factory = config['layers']['dao_factory']
    dao = dao_factory.new_instance()

    # executa-se os métodos de teste
    print("tests en cours...")
    unittest.main()
  • a camada [dao] envia uma solicitação ao servidor, recebe sua resposta e a formata para devolvê-la ao código chamador. Quando o servidor envia uma resposta com um código de status diferente de 200, a camada [dao] lança uma exceção. Além disso, uma série de testes visa verificar se houve ou não uma exceção;
  • linhas 9-18: inicializa-se uma sessão jSON. Não deve ocorrer nenhum erro;
  • linhas 20-29: inicializa-se uma sessão XML. Não deve ocorrer nenhum erro;
  • linhas 31-40: inicializa-se uma sessão com um tipo incorreto. Deve ocorrer um erro;
  • linhas 42-54: realiza-se a autenticação com as credenciais corretas. Não deve ocorrer nenhum erro;
  • linhas 56-68: autentica-se com credenciais incorretas. Deve ocorrer um erro;
  • linhas 70-92: faz-se um cálculo de imposto e, em seguida, solicita-se a lista de simulações. Deve haver uma. Além disso, verifica-se se essa simulação contém de fato o imposto solicitado;
  • linhas 94-119: faz-se uma simulação que é excluída em seguida. Depois, tenta-se excluir uma simulação quando já não há nenhuma. Deve ocorrer um erro;
  • linhas 121-137: o teste é executado como um script de console clássico;
  • linhas 122-124: configuramos o aplicativo;
  • linhas 126-129: configuramos o logger. Isso nos permitirá acompanhar os logs;
  • linhas 131-133: instanciamos a camada [dao] que será testada;
  • linhas 135-137: executamos os testes;

Os resultados na console são os seguintes:


C:\Data\st-2020\dev\python\cours-2020\python3-flask-2020\venv\Scripts\python.exe C:/Data/st-2020/dev/python/cours-2020/python3-flask-2020/impots/http-clients/07/tests/Test2HttpClientDaoWithSession.py
tests en cours...
test_authenticate_user_failed
..MyException[35, ["Echec de l'authentification"]]
test_authenticate_user_success
test_delete_simulation
MyException[35, ["la simulation n° [100] n'existe pas"]]
test_get_simulations
test_init_session_json
test_init_session_xml
test_init_session_xxx
MyException[73, il n'y a pas de session valide en cours]
----------------------------------------------------------------------
Ran 7 tests in 0.171s

OK

Process finished with exit code 0