Komut Dosyası ve Modül Karşılaştırması
İşte bir açıklama. Kısa sürüm, doğrudan bir Python dosyasını çalıştırmak ve bu dosyayı başka bir yerden içe aktarmak arasında büyük bir fark olmasıdır. Bir dosyanın hangi dizinde olduğunu bilmek, Python'un hangi paket içinde olduğunu düşündüğünü belirlemez. Bu, dosyayı Python'a nasıl yüklediğinize (çalıştırarak veya içe aktararak) bağlıdır.
Python dosyasını yüklemenin iki yolu vardır: en üst düzey komut dosyası olarak veya bir modül olarak. Bir dosyayı doğrudan yürütürseniz üst düzey komut dosyası olarak, örneğin python myfile.pykomut satırına yazarak yüklenir . Bunu yaparsanız python -m myfileveya importbaşka bir dosyanın içinde bir deyimle karşılaşıldığında yüklenirse modül olarak yüklenir . Bir kerede yalnızca bir üst düzey komut dosyası olabilir; üst düzey komut dosyası, işleri başlatmak için çalıştırdığınız Python dosyasıdır.
Adlandırma
Bir dosya yüklendiğinde, dosyaya bir ad verilir (bu dosya __name__özniteliğinde saklanır ). En üst düzey komut dosyası olarak yüklendiyse adı __main__. Bir modül olarak yüklendiyse, adı, önce parçası olan herhangi bir paket / alt paketin adlarıyla, noktalarla ayrılmış dosya adıdır.
Örneğin, örneğin:
package/
__init__.py
subpackage1/
__init__.py
moduleX.py
moduleA.py
içe aktardıysanız moduleX(not: içe aktarıldı , doğrudan yürütülmedi), adı olur package.subpackage1.moduleX. İçe aktardıysanız moduleA, adı olur package.moduleA. Ancak, doğrudan moduleX komut satırından çalıştırırsanız , adı bunun yerine olur __main__ve doğrudan moduleAkomut satırından çalıştırırsanız , adı olur __main__. Bir modül en üst düzey komut dosyası olarak çalıştırıldığında, normal adını kaybeder ve bunun yerine adı olur __main__.
Bir modüle içerdiği paket üzerinden erişme
Ek bir kırışıklık var: modülün adı, içinde bulunduğu dizinden "doğrudan" alınıp alınmadığına veya bir paket aracılığıyla alınıp alınmadığına bağlıdır. Bu yalnızca Python'u bir dizinde çalıştırırsanız ve aynı dizinde (veya alt dizininde) bir dosyayı içe aktarmaya çalışırsanız fark yaratır. Örneğin, dizinde Python yorumlayıcısını başlatır package/subpackage1ve sonra başlatırsanız import moduleXadı moduleXsadece olur moduleX, olmaz package.subpackage1.moduleX. Bunun nedeni, Python'un geçerli dizini başlangıçta arama yoluna eklemesidir; geçerli dizinde içe aktarılacak modülü bulursa, bu dizinin bir paketin parçası olduğunu bilmez ve paket bilgileri modül adının bir parçası olmaz.
Özel bir durum, yorumlayıcıyı etkileşimli olarak çalıştırmanızdır (örn., pythonPython kodunu anında yazın ve girmeye başlayın). Bu durumda, bu etkileşimli oturumun adıdır __main__.
Şimdi hata mesajınız için çok önemli olan şey: eğer bir modülün adında nokta yoksa bir paketin parçası sayılmaz . Dosyanın gerçekte diskte nerede olduğu önemli değil. Önemli olan tek şey adının ne olduğu ve adı nasıl yüklediğinize bağlı.
Şimdi sorunuza dahil ettiğiniz alıntıya bakın:
Göreli içe aktarmalar, modülün paket hiyerarşisindeki konumunu belirlemek için bir modülün name özniteliğini kullanır. Modülün adı herhangi bir paket bilgisi içermiyorsa (örn. 'Ana' olarak ayarlanmışsa), göreli içe aktarmalar, modülün dosya sisteminde nerede bulunduğuna bakılmaksızın modülün en üst düzey bir modülmiş gibi çözümlenir.
Göreli ithalat ...
Göreli içe aktarmalar , bir pakette nerede olduğunu belirlemek için modülün adını kullanır. Gibi göreli bir içe aktarma kullandığınızda from .. import foo, noktalar, paket hiyerarşisinde bazı düzeylerde yükseltmeyi belirtir. Mevcut modülün adıdır Örneğin, eğer package.subpackage1.moduleX, o zaman ..moduleAanlamına gelecektir package.moduleA. A'nın from .. importçalışması için modül adının importifadede yer alan en az sayıda noktaya sahip olması gerekir .
... sadece bir pakette göreceli
Ancak, modülünüzün adı __main__bir pakette olduğu kabul edilmez. Adında nokta yoktur ve bu nedenle from .. importiçinde ifadeler kullanamazsınız . Bunu yapmaya çalışırsanız, "paket dışı göreli alma" hatası alırsınız.
Komut dosyaları göreli olarak içe aktarılamaz
Muhtemelen moduleX, komut satırından çalıştırmayı denediğiniz veya benzer bir şeydir. Bunu yaptığınızda, adı olarak ayarlandı; bu __main__, içindeki göreli içe aktarma işleminin başarısız olacağı anlamına gelir, çünkü adı bir pakette olduğunu göstermez. Bunun, Python'u bir modülün bulunduğu dizinden çalıştırırsanız ve daha sonra bu modülü içe aktarmaya çalışırsanız da gerçekleşeceğini unutmayın, çünkü yukarıda açıklandığı gibi Python, geçerli dizinde modülü "çok erken" olduğunu fark etmeden bulacaktır. paketin bir parçası.
Ayrıca, etkileşimli yorumlayıcıyı çalıştırdığınızda, söz konusu etkileşimli oturumun "adı" nın her zaman olduğunu unutmayın __main__. Böylece , doğrudan etkileşimli bir oturumdan göreli içe aktarma yapamazsınız . Göreli ithalat sadece modül dosyalarında kullanım içindir.
İki çözüm:
Gerçekten moduleXdoğrudan çalıştırmak istiyorsanız , ancak yine de bir paketin parçası olarak kabul edilmesini istiyorsanız, bunu yapabilirsiniz python -m package.subpackage1.moduleX. -mDeğil üst düzey komut dosyası gibi bir modül olarak yüklemek için Python söyler.
Ya da belki de aslında istemiyorum çalıştırmak moduleX sadece diğer bazı komut dosyasını çalıştırmak söylemek istiyorum, myfile.pybu kullanımlar içinde işlevlerini moduleX. Bu durumda, dizinin içine değil - myfile.py başka bir yere koyun ve çalıştırın. Eğer içinizde gibi şeyler yaparsanız , iyi çalışır.packagemyfile.pyfrom package.moduleA import spam
notlar
Bu çözümlerden herhangi biri için paket dizinine ( packageörneğin) Python modülü arama yolundan ( sys.path) erişilebilir olmalıdır . Değilse, paketteki hiçbir şeyi güvenilir bir şekilde kullanamazsınız.
Python 2.6'dan bu yana, paket çözümleme amaçlı modülün "adı" yalnızca __name__niteliklerine göre değil , özelliğine göre de belirlenir __package__. Bu yüzden __name__modülün "adına" atıfta bulunmak için açık sembolü kullanmaktan kaçınıyorum . Python 2.6 Bir modülün "ad" etkili bir şekilde olduğu için __package__ + '.' + __name__, ya da sadece __name__eğer __package__olduğunu None.)