अजगर, मॉड्यूल, SWIG, विंडोज

यह लेख पायथन के लिए मॉड्यूल के निर्माण पर मेरे प्रयोगों का विवरण है। मुझे LibRaw पुस्तकालय के लिए एक उच्च-स्तरीय इंटरफ़ेस की आवश्यकता थी, विशेष रूप से विंडोज के तहत।

आखिरी बार जब मैंने 2004 में C ++ में पायथन के लिए एक मॉड्यूल लिखा था। स्टिलबोर्न के लिए मॉड्यूल (सौभाग्य से मेरे लिए नहीं) लाइब्रेरी (मैंने वेतन के लिए अपने कौशल को बेवकूफी से बेच दिया)। स्वाभाविक रूप से, कौशल तय नहीं हैं। मुझे याद है कि SWIG ने मेरे काम को बहुत आसान कर दिया, क्योंकि मुझे एक ऑब्जेक्ट इंटरफ़ेस की आवश्यकता थी, और "पेन" के साथ लिखने ने इसे तोड़ दिया। मेरी स्मृति पेशेवर है - अर्थात, चयनात्मक और संक्षिप्त, इसलिए मुझे पहले कूदना पड़ा।

यह लेख केवल विंडोज पर पायथन के लिए SWIG की स्थापना के बारे में है। SWIG का उपयोग करके C / C ++ में मॉड्यूल लिखना सब कुछ सेट करने की तुलना में बहुत आसान है (वैसे, मुझे यह धारणा है कि यह आधुनिक प्रोग्रामिंग का प्रतिमान है)।

सबसे पहले, मैं यैंडेक्स में चढ़ गया। एपिक फेल - सभी टिप्स और वर्कअराउंड तीन साल पुराने हैं। उनके बाद, मुझे स्रोत से अजगर के निर्माण के लिए बिल्कुल अनावश्यक कदम उठाना पड़ा। लेख में कोई अनावश्यक कदम नहीं हैं, हालांकि अजगर समस्याओं के बिना जा रहा है। लेकिन अगर आप इकट्ठा करते हैं, तो एक अच्छा टिप: फ़ाइल को "बॉक्सिंग" डिलीवरी से शामिल करें / pycohfig.h लें और चुपचाप इसे इकट्ठे संस्करण में डालें - यह काम में आएगा।

अच्छी खबर है। आप मॉड्यूल का निर्माण करने के लिए Microsoft Visual C ++ एक्सप्रेस संस्करण 2008 का उपयोग कर सकते हैं, क्योंकि पायथन 2.6+ उसके द्वारा बनाया गया है। इससे पहले, मुझे या तो स्रोत से अजगर को संकलित करना था, या वीसी ++ 7.0 खोदकर काई के साथ कवर करना था, और तब भी 6.0। इससे भी अच्छी खबर यह है कि मॉड्यूल को MinGW के साथ संकलित किया जा सकता है। वैसे? मैंने स्ट्राबेरी पर्ल में "मॉड्यूल शामिल" परीक्षण मॉड्यूल संकलित किया (यदि आप प्राचीन अजगर-मोती युद्ध को याद करते हैं तो काफी सनकी हैं)। सिर्फ इसलिए कि यह पाथ में पहला gcc है।

इसलिए, हमें SWIG से एक उदाहरण लेने और इसे एक मॉड्यूल में बदलने की आवश्यकता है। ऐसा करने के दो तरीके हैं।

लेकिन सबसे पहले, आपको विंडोज (swigwin-2.0.4) के तहत निर्मित SWIG को स्थापित करना होगा और इसे PATH में पंजीकृत करना होगा। उपयोग के मामले इसके साथ आते हैं।

विधि एक: विजुअल C ++

हमें पर्यावरण चर सेट करने की आवश्यकता होगी।

  PYTHON_INCLUDE = C: \ Python \ शामिल करें
 PYTHON_LIB = C: \ Python \ Libs \ python27.lib 

फिर आप चारों ओर बेवकूफ बना सकते हैं - तैयार उदाहरणों में से एक ले लो जिसके लिए एक समाधान (.sln) और एक परियोजना पहले ही बनाई गई है। और शांति से, इसके आधार पर, अपना मॉड्यूल बनाएं। उदाहरण के लिए, SWIG\Examples\python\class\exmple.sln । examples.i नाम दें mymodule.i , mymodule.cxx और mymodule_wrap.cxx , क्रमशः, mymodule.i , mymodule.cxx और mymodule_wrap.cxx नाम बदलें।

जैसा कि अनुभव अभी निर्धारित है, सब कुछ बहुत अच्छा काम करता है।

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

1. विंडोज DLL बनाने के लिए एक नया प्रोजेक्ट बनाएं
2. हम अपनी कक्षाओं / फ़ंक्शंस के लिए my_module.cxx (या .c) फ़ाइल बनाते हैं, इंटरफ़ेस के विवरण के लिए my_module.i । और हम ( my_module_wrap.cxx ) my_module_wrap.cxx पहली दो फाइलें, बेशक, मैं एक ही उदाहरण से काटता हूं, लेकिन आप उन्हें विकिपीडिया से ले सकते हैं , उदाहरण के लिए)
   
3. हम वातावरण में चुनें my_module.i , गुणों में ( कस्टम बिल्ड सेटअप ) सेट:
   - कमांड लाइन : swig.exe -c++ -python $(InputPath)
   - आउटपुट : $(InputName)_wrap.cxx
   (C प्रोजेक्ट्स के लिए, आपको पहले मामले में -c++ स्विच को निर्दिष्ट करने की आवश्यकता नहीं है। और दूसरे में .cxx एक्सटेंशन (.c मताधिकार)।
   परिणामस्वरूप, हम इंटरफ़ेस फ़ाइल my_module.i से my_module_wrap.c(xx) फ़ाइल my_module.i
   
4. आगे आपको अजगर हेडर का स्थान निर्धारित करने की आवश्यकता है। परियोजना गुणों में, कॉन्फ़िगरेशन गुण चुनें "/ C ++ और अतिरिक्त निर्देशिकाओं को $(PYTHON_INCLUDE) में सेट करें (क्या आपने उसे व्यर्थ में कुछ भी पूछा है?)
   
5. लिंकर के गुणों की योजना पर आगे (लिंकर):
   - इनपुट »सशर्त निर्भरियाँ : "$(PYTHON_LIB)"
   - सामान्य »आउटपुट फ़ाइल : $(ProjectDir)\_$(ProjectName).pyd
   पहले मामले में, उद्धरण चिह्न चोट नहीं करते हैं, और दूसरे में, अंडरस्कोर पर ध्यान दें। ऐसा क्यों है - मैं नीचे बताऊंगा
   
6. आप एक प्रोजेक्ट बना सकते हैं। रिलीज़ कॉन्फ़िगरेशन पर स्विच करना याद रखें। डीबग का उपयोग करने के लिए, आपको स्रोत से अजगर का निर्माण करना होगा, लेकिन क्या हमें इसकी आवश्यकता है?
   
7. लाभ
   

विधि दो: distutils

आनन्दित नहीं हो सकता, लेकिन पायथन 2.7 को पहले से ही डिस्टुटिल्स (पिछले संस्करणों में, 3 किलोग्राम shamanism की आवश्यकता थी) का उपयोग करके मॉड्यूल इकट्ठा करने के लिए कैद किया गया है। एक ही समय में, हम उपरोक्त दोनों (रात तक नहीं) एमवीसी 2008 और मुक्त मिंज डब्ल्यू का उपयोग कर सकते हैं।

रास्ते में हमें इंतजार करने वाली छोटी रेक के बारे में, मैंने अपना माथा सहलाया, अब मैं बताऊंगा।

फिर, हम SWIG से उदाहरण का उपयोग करते हुए अमानवीय प्रयोग करेंगे। तो, SWIG/examples/classes निर्देशिका में, setup.py बनाएँ

 # -*- coding: utf-8 -*- import distutils from distutils.core import setup, Extension setup(name = "Simple example from the SWIG website", version = "0.007", ext_modules = [Extension( "_example", #  :    ["example.i","example.cxx"], swig_opts=['-threads', '-c++'], #  :  swig  )] ); 

पहली रेक।

रेखांकित करते हैं। यदि आप इसे निर्दिष्ट नहीं करते हैं, तो हमें एक त्रुटि मिलती है LINK : error LNK2001: unresolved external symbol initexample ।

यह कहाँ से उगता है?

पायथन, जब मॉड्यूल "हाथ से" बनाता है, तो उम्मीद करता है कि संकलित मॉड्यूल (बाइनरी भाग) में init<_> साथ एक फ़ंक्शन होगा। यह इसलिए बनाया गया है ताकि C / C ++ में लिखा गया एक मॉड्यूल बाइनरी मॉड्यूल लोड करने पर इसका स्वाद ले सके (और अजगर को बताएं कि सब कुछ ठीक है)। व्रपर (SWIG) ईमानदारी से एक फ़ंक्शन बनाता है।

लेकिन SWIG हमारे मॉड्यूल के लिए दो (!) <_>.py बनाता है: <_>.py एक अजगर आवरण है जिसमें भविष्य के मॉड्यूल और _<_>.pyd कार्यों के लिए देशी कॉल _<_>.pyd (ध्यान दें अंडरस्कोर) एक बाइनरी लाइब्रेरी है। तथ्य यह है कि बाइनरी लाइब्रेरी को मूल एक (अंडरस्कोर "निहित") के समान import विवरण के साथ "अजगर में" लोड किया जा सकता है। तदनुसार, देशी रैपर और बाइनरी लाइब्रेरी के नाम अलग-अलग होने चाहिए। वे अलग - अलग हैं।

SWIG हमें उम्मीद है कि बाइनरी लाइब्रेरी को रेखांकित किया जाएगा, इसलिए, init_ <मॉड्यूल_name> नामक एक फ़ंक्शन बनाया, जिसके बारे में लिंकर को कुछ भी नहीं पता है। वह गलती है।

दूसरी रेक

यह समझने में स्रोत पर चढ़ने में मुझे कुछ समय लगा कि कमांड लाइन विकल्प को स्वाइग कमांड लाइन कॉल में कैसे पास किया जाए। डिफ़ॉल्ट रूप से, distutil हमें सी के साथ काम करने की उम्मीद करता है। इसलिए, -c++ पैरामीटर को निर्दिष्ट करना आवश्यक था ( -threads पैरामीटर "शो-ऑफ के लिए" जोड़ा -threads , लेकिन यह किसी के लिए उपयोगी नहीं हो सकता है)।

सभा

अब हम समझ गए हैं, मॉड्यूल बनाने के दो तरीके हैं:

MVC का उपयोग कर निर्माण करें:
python setup.py build

MinGW का उपयोग करके निर्माण करें:
python setup.py build -cmingw32

दोनों तरीकों का परीक्षण और काम किया जाता है। यह भी अजीब है।

किसी भी सलाह (जितना संभव हो उतना सरल) का स्वागत किया जाएगा। आलोचना, भी (लेकिन अधिमानतः इंगित करने के लिए कि यह कैसे करना है)। मुझे उम्मीद है कि मुझे पहली टिप्पणी के बाद जो हुआ उससे आधे से अधिक लेख को फिर से लिखना नहीं पड़ेगा। जिसके बाद मैंने पहले की तुलना में थोड़ी गहराई खोदी।