Python modülünün mutlak ve açık göreli içe aktarımı

Bir Python uygulamasında paketleri içe aktarmanın tercih edilen yolunu merak ediyorum. Bunun gibi bir paket yapım var:

project.app1.models
project.app1.views
project.app2.models

project.app1.viewsithalat project.app1.modelsve project.app2.models. Bunu yapmanın akla gelen iki yolu var.

Mutlak ithalatla:

import A.A
import A.B.B

veya PEP 328 ile Python 2.5'te tanıtıldığı gibi açık göreli içe aktarımlarla :

# explicit relative
from .. import A
from . import B

Bunu yapmanın en pitonik yolu nedir?

Mutlak ithalatlar. PEP 8'den:

Paket içi ithalatlar için göreli ithalatlar kesinlikle tavsiye edilmiyor. Tüm içe aktarmalar için her zaman mutlak paket yolunu kullanın. PEP 328 [7] Python 2.5'te tamamen uygulandığı şu anda bile, açıkça göreli içe aktarma tarzı etkin bir şekilde önerilmez; mutlak içe aktarmalar daha taşınabilir ve genellikle daha okunabilirdir.

Açık göreli içe aktarmalar güzel bir dil özelliğidir (sanırım), ancak mutlak içe aktarmalar kadar açık değildir. Daha okunaklı form:

import A.A
import A.B.B

özellikle birkaç farklı ad alanını içe aktarırsanız. Paketlerin içinden ithalatı içeren bazı iyi yazılmış projelere / öğreticilere bakarsanız, genellikle bu tarzı izlerler.

Daha açık hale getirmek için aldığınız birkaç ekstra tuş vuruşu, başkalarına (ve belki de size) gelecekte ad alanınızı anlamaya çalışırken (özellikle paketin bir kısmının bulunduğu 3.x'e geçiş yaparsanız) bolca zaman kazandıracaktır. isimler değişti).

Python göreli içe aktarmalar artık kesinlikle tavsiye edilmemektedir, ancak bu durumda mutlak_import'un kullanılması şiddetle önerilir.

Lütfen Guido'nun kendisinden alıntı yapan bu tartışmaya bakın :

"Bu çoğunlukla tarihsel değil mi? Yeni göreli ithalat sözdizimi uygulanana kadar göreli ithalata ilişkin çeşitli sorunlar vardı. Kısa vadeli çözüm, bunları kullanmamayı önermekti. Uzun vadeli çözüm, kesin bir sözdizimi uygulamaktı. Şimdi anti-tavsiyeyi geri çekmenin zamanı geldi. Tabii ki, denize düşmeden - hala onlara kazanılmış bir zevk buluyorum; ama onların yeri var. "

OP , şunu söyleyen PEP 328'i doğru şekilde bağlar :

En önemlisi, alt paketleri düzenlemek zorunda kalmadan büyük paketlerin yapısını yeniden düzenleyebilmek olan birkaç kullanım durumu sunuldu. Ek olarak, bir paketin içindeki bir modül, göreli içe aktarmalar olmadan kendisini kolayca içe aktaramaz.

Ayrıca neredeyse yinelenen soruya bakın neden Python göreli ithalat kullanmak veya

Elbette hala bir zevk meselesi olarak duruyor. Göreceli içe aktarmalarla kodu taşımak daha kolay olsa da, bu beklenmedik bir şekilde işleri bozabilir; ve ithalatı yeniden adlandırmak o kadar da zor değil.

PEP 328'den yeni davranışı zorlamak için şunu kullanın:

from __future__ import absolute_import

Bu durumda, örtük göreceli içe aktarma artık mümkün import localfileolmayacaktır (örn. Artık çalışmayacaktır, yalnızca from . import localfile). Temiz ve ileride kanıtlanmış davranış için, absolute_import kullanılması tavsiye edilir.

Önemli bir uyarı, PEP 338 ve PEP 366 nedeniyle , göreceli içe aktarımların python dosyasının bir modül olarak içe aktarılmasını gerektirmesidir - göreceli içe aktarımı olan bir file.py'yi yürütemezsiniz veya bir ValueError: Attempted relative import in non-package.

En iyi yaklaşım değerlendirilirken bu sınırlama dikkate alınmalıdır. Guido, her durumda bir modülden komut dosyası çalıştırmaya karşıdır:

Bu konuda ve __main__ makinenin diğer önerilen oynamalarında -1'im. Tek kullanım durumu, her zaman bir anti-model olarak gördüğüm bir modülün dizininde yaşayan betikleri çalıştırmak gibi görünüyor. Fikrimi değiştirmemi sağlamak için, beni öyle olmadığına ikna etmelisin.

Konuyla ilgili kapsamlı tartışmalar SO'da bulunabilir; yeniden. Python 3 bu oldukça kapsamlıdır:

• Python 3'te göreli içe aktarmalar

Göreli içe aktarmalar, daha sonra düzinelerce dahili içe aktarmayı değiştirmeden paketinizi yeniden adlandırmanız için sizi özgür bırakmaz, aynı zamanda onlarla döngüsel içe aktarma veya ad alanı paketleri gibi şeyleri içeren belirli sorunları çözmede başarılı oldum, çünkü bunlar Python'u " üst düzey ad alanından sonraki modülü aramaya baştan başlamak için top ".