Imports

De Stoq Wiki
Ir para: navegação, pesquisa

Normas para escrita de imports nos módulos Stoq

  • Estaremos sempre importando os simbolos (classes, funções, variáveis, etc.) a partir dos módulos ao invés do módulo inteiro.
  • Usar sempre o path completo nos imports visando evitar problemas de sibling imports.
  • Agrupar os imports nos seguintes blocos (sempre com uma linha entre cada bloco):
    • Standard Modules - módulos nativos do python, os, sys, datetime
    • Library Modules - módulos tais como gtk, kiwi, sqlobject, zope
    • Project Modules - módulos do stoq

Camadas kiwi, stoqlib, stoq

Para as versões futuras é meta do Stoq almejar uma separação rígida entre estas três camadas, todavia, estando o Kiwi2 com um número de features bastante reduzidas em relação ao montante de features do gtk e também o stoqlib ainda muito distante da complexidade do Kiwi2, é preferível importar sempre os módulos/pacotes diretamente de sua origem ao invés de uma biblioteca intermediária. Isto evitará esforços prematuros no sentido de separar as camadas, causando ônus desnecessário e de baixa prioridade.