Nome do pacote e nome do módulo
-
Existem três módulos em um pacote, mod1.py, mod2.py, mod3.py, mas como garantir que apenas os mod1 e mod3 sejam importados ao importar módulos da importação de desmembramento *?
Adicione uma declaração em __init__ no descompacoteall=['mod1','mod3'] -
Atenção dos módulos no PEP8
- https://www.python.org/dev/peps/pep-0008/ - versão em inglês do PEP8
- https://cloud.tencent.com/developer/news/332042 --PEP8 versão chinesa
-
Importar
As importações geralmente estão em uma única linha, por exemplo:
Bom estilo:
Estilo ruim:
Isso também é possível:
A importação geralmente está na parte superior do arquivo, após o comentário do módulo e a documentação das cadeias, e antes das variáveis e constantes globais do módulo.
As importações devem ser agrupadas na seguinte ordem:
-
Importação de biblioteca padrão
-
Importações de terceiros relacionadas
-
Importação local específica de aplicativo / biblioteca
Coloque uma linha em branco entre cada grupo de importação.
Coloque quaisquer especificações __all__ relevantes após a importação.
As importações absolutas são recomendadas porque são mais fáceis de ler e, se o sistema de importação estiver configurado incorretamente (por exemplo, quando um diretório no pacote termina em sys.path), eles apresentam melhor desempenho (pelo menos, emitem melhores mensagens de erro):
import mypkg.sibling
from mypkg import sibling
from mypkg.sibling import example
As importações relativas explícitas podem ser usadas para aceitar importações absolutas alternativas, especialmente ao lidar com layouts de pacotes complexos, as importações absolutas são muito detalhadas.
from . import sibling
from .sibling import example
O código da biblioteca padrão deve evitar layouts complexos de pacotes e usar importações absolutas.
Importações relativas implícitas nunca devem ser usadas e foram removidas no Python 3.
Ao importar uma classe de um módulo que contém uma classe, geralmente é bom escrever da seguinte maneira:
from myclass import MyClass
from foo.bar.yourclass import YourClass
Se essa escrita levar a um conflito de nome local, basta escrever:
import myclass
import foo.bar.yourclass
Evite usar importações de caracteres curinga (da importação *), pois não fica claro quais nomes aparecem no espaço para nome, o que confunde o leitor e muitas ferramentas automatizadas. Existe um caso de uso razoável para importações de curingas, republicando uma interface interna como parte de uma API pública (por exemplo, reescrevendo uma interface implementada em Python puro, a interface define um módulo acelerador opcional e quais definições serão reescritas com antecedência Não sei).
Renomeados dessa maneira, as seguintes diretrizes sobre interfaces públicas e internas ainda se aplicam.
Propriedades internas no nível do módulo
Os atributos internos no nível do módulo (nomes com sublinhado duplo), como __all__, author , version , devem ser colocados após a documentação do módulo, antes de quaisquer instruções de importação, exceto das importações de __future__. O Python exige que as importações de __future__ devem preceder qualquer código e somente após as instruções no nível do módulo.
from __future__ import barry_as_FLUFL
__all__ = ['a', 'b', 'c']
__version__ = '0.1'
__author__ = 'Cardinal Biggles'
import os
import sys
```
模块名应该短，所有的字母小写。可以在模块名中使用下划线来提高可读性。Python包名也应该短，所有的字母小写，不鼓励使用下划线。
当一个C或C++书写的扩展模块，伴随Python模块来提供了一个更高层次（例如更面向对象）的接口时，C/C++模块名有一个前导下划线（如_socket）。
