10. Exercício Prático: Versão 2

Esta nova versão introduz o seguinte ficheiro [config.py]:

def configure():
    import os

    #  absolute path of this script's folder
    script_dir = os.path.dirname(os.path.abspath(__file__))

    #  root from which certain relative paths are measured
    root_dir = "C:/Data/st-2020/dev/python/cours-2020/python3-flask-2020/impots"

    #  application dependencies
    absolute_dependencies = [
        f"{root_dir}/v01/shared",
    ]

    #  application configuration
    config = {
        #  absolute path of the taxpayer file
        "taxpayersFilename": f"{script_dir}/../data/taxpayersdata.txt",
        #  absolute path of the results file
        "resultsFilename": f"{script_dir}/../data/résultats.txt"
    }

    #  update syspath
    from myutils import set_syspath
    set_syspath(absolute_dependencies)

    #  return the config
    return config

Comentários

• linha 5: Recuperamos o caminho absoluto da pasta que contém o script que está a ser executado, neste caso o script [config.py]. Isto dá-nos o caminho absoluto da pasta [main]. Esta é também a pasta que contém o script principal [main.py];
• linha 8: quando um ficheiro referenciado não pertence à pasta da aplicação, não usaremos [script_dir] para o localizar, mas sim [root_dir]. Esta linha deve ser alterada assim que a aplicação for movida para uma localização diferente no sistema de ficheiros;
• linhas 11–13: listamos os caminhos absolutos de todas as pastas que devem estar no Python Path para que a aplicação funcione. Na linha 12, referenciamos a pasta [shared] da versão 1 do exercício da aplicação;
• linhas 16–21: definimos a configuração da aplicação num dicionário [config]. Aqui, especificamos os caminhos absolutos dos ficheiros de texto tratados pela aplicação. Para tal, utilizamos [script_dir], que, como lembrete, se refere à pasta [main] neste caso;
• Linhas 24–25: definimos o caminho Python exigido pela aplicação;

O script principal [main.py] é o seguinte:

#  configure the application
import config

config = config.configure()

#  syspath is configured - imports can be made
from impôts_module_01 import calcul_impôt, record_results, get_taxpayers_data

#  taxpayer file
taxpayers_filename = config['taxpayersFilename']
#  results file
results_filename = config['resultsFilename']

#  code
try:

    #  reading taxpayer data
    taxpayers = get_taxpayers_data(taxpayers_filename)
    #  results list
    results = []
    #  taxpayers' taxes are calculated
    for taxpayer in taxpayers:
        #  tax calculation returns a dictionary of keys
        #  ['married', 'children', 'salary', 'tax', 'surcôte', 'décôte', 'réduction', 'taux']
        result = calcul_impôt(taxpayer['marié'], taxpayer['enfants'], taxpayer['salaire'])
        #  the dictionary is added to the list of results
        results.append(result)
    #  we record the results
    record_results(results_filename, results)
except BaseException as erreur:
    #  there may be various errors: no file, incorrect file content
    #  display the error and exit the application
    print(f"L'erreur suivante s'est produite : {erreur}]\n")
finally:
    print("Travail terminé...")

Comentários

• linhas 1–4: a aplicação está configurada;
• linha 7: sabemos que, após a configuração, o Python Path está correto e inclui a pasta [shared], que contém o script [impôts_module_01]. A partir deste script, importamos as funções de que precisamos;
• linhas 9-12: os nomes dos ficheiros utilizados encontram-se na configuração. Trata-se de caminhos absolutos;
• linhas 14–35: este é o código da versão 1;

A versão 1 não funcionou numa consola Python. Na mesma consola, a versão 2 produz os seguintes resultados:

(venv) C:\Data\st-2020\dev\python\cours-2020\python3-flask-2020\impots\v02>python main/main.py
Travail terminé...

Não foram encontrados erros.