जाहिर है, यह इस तथ्य से शुरू होता है कि हम सीपीथॉन दुभाषिया संस्करण 2.7.x के बारे में बात करेंगे (उदाहरण 2.7.3 संस्करण पर परीक्षण किए गए थे)।

आधिकारिक वेबसाइट में पायथन में आयात विवरण और मॉड्यूल के विवरण शामिल हैं:

• docs.python.org/2/reference/simple_stmts.html#import
• docs.python.org/2/tutorial/modules.html

यह उनके अनुसार है कि पायथन में पैकेज, मॉड्यूल और मॉड्यूल में परिभाषित नाम हैं। यह भी ध्यान दिया जाना चाहिए कि प्रलेखन के कुछ हिस्सों में, मॉड्यूल को सबमोड्यूल्स कहा जाता है यदि उन्हें पैकेज के अंदर रखा जाता है।

पायथन में, आयात विवरण आपको उन पैकेजों, मॉड्यूलों और नामों को आयात करने की अनुमति देता है, जिसमें नाम आयात में निष्पादित होता है। इसके साथ, दो दिलचस्प विशेषताएं हैं:

1. आयात विवरण का वाक्य-विन्यास हमेशा स्पष्ट रूप से नहीं समझा जाता है कि क्या आयात किया जाना चाहिए: पैकेज, मॉड्यूल या नाम
2. आयात विवरण का वाक्य-विन्यास स्पष्ट रूप से यह संकेत नहीं दे सकता है कि मॉड्यूल का पथ एक पूर्ण पथ है (हालाँकि आप स्पष्ट रूप से संकेत कर सकते हैं कि पथ सापेक्ष है, डिफ़ॉल्ट निरपेक्ष पथ का उपयोग करने के संदर्भ में, निर्देश के शब्दार्थ को बदलना भी संभव है। देखें www.python.org/dev/ पेप्स / पेप -0328 )

आयात abcd रिकॉर्ड के लिए निम्नलिखित अस्पष्टताएँ इन दो विशेषताओं का अनुसरण करती हैं:

1. आयात पैकेज abcd, या मॉड्यूल abcd आयात करें
2. CURRENT पैकेज से पैकेज / मॉड्यूल abcd आयात करें (जिस मॉड्यूल में abcd आयात किया गया है, उस मॉड्यूल के पैकेज से), या sys.path में निर्दिष्ट निर्देशिकाओं की सूची के अनुसार पैकेज से।

अस्पष्टताओं के और उदाहरण:

• abcd import defg से: (abg package से defg मॉड्यूल आयात करें, या abcd पैकेज से defg पैकेज आयात करें, या abcd पैकेज से defg नाम आयात करें, या abcd मॉड्यूल से defg नाम आयात करें) X (उसी पैकेज से, या पैकेज के अनुसार पैकेज से आयात करें) sys.path)
• आयात abcd.defg: (एबसीडी पैकेज से डीईएफ पैकेज आयात करें, एबीडी पैकेज से डीएफजी मॉड्यूल आयात करें) एक्स (उसी पैकेज से, या sys.path के अनुसार पैकेज से)

इन घोषणात्मक अस्पष्टताओं को हल करने के लिए, एक आवश्यक एल्गोरिथ्म मौजूद होना चाहिए। इस तरह के एक एल्गोरिथ्म को आधिकारिक पायथन प्रलेखन में किसी न किसी रूप में वर्णित किया गया है।

आयात abcd के लिए नाम खोज एल्गोरिथ्म

आयात के लिए abcd नाम निम्नलिखित एल्गोरिथम द्वारा खोजा गया है:

संख्या	हम क्या देख रहे हैं	हम कहाँ देख रहे हैं *	टिप्पणी
1	abcd पैकेज	वर्तमान मॉड्यूल के पैकेज में (मॉड्यूल जिसमें आयात abcd निष्पादित है)	केवल अगर वर्तमान मॉड्यूल ही पैकेज में निहित है **
2	abcd मॉड्यूल	वर्तमान मॉड्यूल के पैकेज में (मॉड्यूल जिसमें आयात abcd निष्पादित है)	केवल अगर वर्तमान मॉड्यूल ही पैकेज में निहित है **
3	abcd मॉड्यूल	अंतर्निहित मॉड्यूल में	प्रलेखन के लिए लिंक में संकेत दिया गया है ***
4	abcd पैकेज	निर्देशिका में sys.path में निर्दिष्ट	प्रलेखन का संदर्भ **** में दर्शाया गया है
5	abcd मॉड्यूल	निर्देशिका में sys.path में निर्दिष्ट	प्रलेखन का संदर्भ **** में दर्शाया गया है

उपरोक्त चरणों में से किसी एक पर पैकेज के लिए सफल खोज के मामले में आगे की खोज को समाप्त कर दिया गया है।

* प्रयोगात्मक रूप से स्थापित मॉड्यूल पर एक पैकेज की खोज की प्राथमिकता पर जानकारी, यह स्पष्ट रूप से प्रलेखन में संकेत नहीं दिया गया है।

** इस मामले में, इस मॉड्यूल का __package__ चर पैकेज के नाम के बराबर है, अन्यथा यह कोई भी नहीं है।
दस्तावेज़ लिंक:
docs.python.org/2/tutorial/modules.html#intra-package-references
"वास्तव में, इस तरह के संदर्भ इतने सामान्य हैं कि आयात विवरण पहले मानक मॉड्यूल खोज पथ में देखने से पहले युक्त पैकेज में दिखता है।"

(!!!) यहां यह ध्यान देने योग्य है कि इस तथ्य का उसी दस्तावेज़ (http://docs.python.org/2/tutorial/modules.html#the-module-search-path) में अन्यत्र उल्लेख नहीं है, जो गलत है (देखें Bugs.python.org/issue16891 )।

(!!!) ध्यान देने वाली दूसरी बात यह है कि यह खोज चरण तभी मौजूद होता है जब मॉड्यूल जिसमें आयात एबीसी को निष्पादित किया जाता है, पैकेज से ही आयात किया जाता है (यानी आयात <पैकेज नाम> <मॉड्यूल नाम का उपयोग करके। >)। पैकेज निर्दिष्ट किए बिना, या मॉड्यूल को स्क्रिप्ट के रूप में निष्पादित करने के मामले में इस मॉड्यूल को आयात करने के मामलों में, यह कदम छोड़ दिया जाएगा। यह दस्तावेज़ में दिखाई देता है www.python.org/dev/peps/pep-0302/#id23 :
“इंपोर्टेड.c में अंतर्निहित __import__ फंक्शन (PyImport_ImportModuleEx () के रूप में जाना जाता है) फिर यह देखने के लिए जांच करेगा कि इंपोर्ट करने वाला मॉड्यूल पैकेज है या पैकेज का सबमॉड्यूल। यदि यह वास्तव में (a) पैकेज का सबमॉड्यूल है, तो यह पहले पैकेज (सबमॉडल के लिए मूल पैकेज) के सापेक्ष आयात करने की कोशिश करता है। उदाहरण के लिए यदि "स्पैम" नामक एक पैकेज "आयात अंडे" करता है, तो यह पहली बार "स्पैम.गॉग्स" नामक एक मॉड्यूल की तलाश करेगा। यदि वह विफल रहता है, तो आयात एक पूर्ण आयात के रूप में जारी रहता है: यह "अंडे" नामक एक मॉड्यूल की तलाश करेगा।

*** docs.python.org/2/tutorial/modules.html#the-module-search-path
"जब स्पैम नामक मॉड्यूल आयात किया जाता है, तो दुभाषिया पहले उस नाम के साथ एक अंतर्निहित मॉड्यूल की खोज करता है।"

**** docs.python.org/2/tutorial/modules.html#the-module-search-path
"यदि नहीं मिला है, तो यह चर sys.path द्वारा दी गई निर्देशिकाओं की सूची में स्पैमहोम नामक एक फ़ाइल की खोज करता है।"

आयात abcd.defg के लिए नाम लुकअप एल्गोरिथ्म

सबसे पहले, एक पैकेज या मॉड्यूल abcd आयात abcd के लिए वर्णित एल्गोरिथ्म के अनुसार खोजा जाता है।

यदि खोज सफल होती है, तो पैकेज या डिफ मॉड्यूल को निम्न एल्गोरिथम के अनुसार खोजा जाता है:

संख्या	हम क्या देख रहे हैं	हम कहाँ देख रहे हैं *	टिप्पणी
1	डीफ़ग पैकेज	abcd पैकेज में	प्रलेखन का लिंक ** में इंगित किया गया है
2	डीएफजी मॉड्यूल	abcd पैकेज में	प्रलेखन का लिंक ** में इंगित किया गया है

* अगर, abcd खोज के परिणामस्वरूप, बाद वाला एक मॉड्यूल बन गया, तो आयात एक आयात के साथ समाप्त हो जाएगा: कोई भी मॉड्यूल जिसे डीएफजी त्रुटि का नाम नहीं दिया गया है, क्योंकि एक मॉड्यूल में अन्य मॉड्यूल या पैकेज नहीं हो सकते हैं:
docs.python.org/2/reference/simple_stmts.html#import : "एक पैकेज में अन्य पैकेज और मॉड्यूल शामिल हो सकते हैं जबकि मॉड्यूल में अन्य मॉड्यूल या पैकेज नहीं हो सकते हैं।"
** www.python.org/dev/peps/pep-0302/#id23
“तंत्र में गिरावट, एक बिंदीदार नाम आयात इसके घटकों द्वारा विभाजित किया गया है। "इम्पोर्ट स्पैम.हैम" के लिए, पहले "इम्पोर्ट स्पैम" किया जाता है, और केवल जब वह सफल होता है तो "हैम" को "स्पैम" के सबमॉड्यूल के रूप में आयात किया जाता है। "

Abcd.defg आयात ghi से नाम लुकअप एल्गोरिथ्म

सबसे पहले, एक पैकेज या मॉड्यूल abcd.defg आयात abcd.defg के लिए वर्णित एल्गोरिथ्म के अनुसार खोजा जाता है:

संख्या	हम क्या देख रहे हैं	हम कहां देख रहे हैं
1	घी नाम	एक पैकेज या डिफेग मॉड्यूल में
2	ghi पैकेज	डींग पैकेज में
3	घी मॉड्यूल	डींग पैकेज में

नाम ओवरलैप

मैं एक दिलचस्प विशेषता को नोट करना चाहता हूं जो उपरोक्त एल्गोरिदम के सुसंगत अनुप्रयोग से आता है। निम्न स्थिति की कल्पना करें: एबसीडी नाम का एक मॉड्यूल है और एबसीडी नाम का एक पैकेज है, जो बदले में डीफ़ग मॉड्यूल को शामिल करता है, एबीडीके मॉड्यूल और एबीडीके पैकेज अलग-अलग निर्देशिकाओं में स्थित होते हैं, जबकि एबसीडी मॉड्यूल उसी पैकेज में स्थित होता है जिसमें मॉड्यूल होता है आयात abcd.defg स्टेटमेंट निष्पादित किया जाता है। इस स्थिति में, आयात विफल हो जाएगा। ऐसा इसलिए है क्योंकि पायथन दुभाषिया पहले abcd मॉड्यूल का पता लगाता है, फिर इसमें डीफ़ग मॉड्यूल देखने की कोशिश करता है, जो असंभव है।

आयात कथन के वाक्य-विन्यास से यह निर्धारित करना अधिक उचित होगा कि abcd केवल एक पैकेज हो सकती है (क्योंकि एक बिंदु के सभी तत्व केवल संकुल हो सकते हैं) और abcd को केवल संकुल के रूप में देख सकते हैं। इस स्थिति में, एब्सकॉर्ड पैकेज को किसी अन्य निर्देशिका से आयात किया जाएगा, इसमें डीएफजी मॉड्यूल का पता लगाया जाएगा, और कार्यक्रम बिना त्रुटियों के जारी रहेगा।

दुर्भाग्य से, पायथन के इस व्यवहार को लागू नहीं किया गया है। Bugs.python.org/issue16891#msg179353 देखें।

लेख के लेखक को इस समस्या का सामना करना पड़ा, लेकिन आधिकारिक पायथन प्रलेखन में विवरण की असंगति के कारण, इस दुभाषिया व्यवहार के कारणों का पता लगाने में कुछ समय लगा। परिणामस्वरूप, निम्नलिखित चर्चाएं खड़ी हो गई हैं : overoverflow.com/questions/14183541/why-python-finds-module-instead-of-package-if-they-have-the-same-name और bugs.python.org/issue16891 , साथ ही साथ लिखित। यह लेख।

ऐसे नाम टकराव की स्थिति में, निम्नलिखित समाधान संभव हैं:

1. मॉड्यूल या पैकेज का नाम बदलें ताकि पैकेज का नाम मॉड्यूल के नाम से मेल न खाए, अर्थात मिलान नामों को बाहर करें
2. कभी-कभी यह आयात करने के लिए डिफ़ॉल्ट पूर्ण पथों को शामिल करने में मदद कर सकता है __future__ आयात निरपेक्ष_ आयात कथन (वास्तव में, इस मामले में, यह केवल sys.path को बदलकर संकुल और मॉड्यूल की खोज के अनुक्रम पर नियंत्रण बढ़ाता है)

परिशिष्ट: स्रोत कोड

इस भंडार में स्रोत कोड है जो ऊपर वर्णित एल्गोरिदम को प्रदर्शित करता है: bitbucket.org/dmugtasimov/python_import ।