रस्ट चाइल्ड मॉड्यूल

Mia Chevalier

शनिवार, 30 नवंबर 2024 को 8:11:52 am

जंग परियोजनाओं में मॉड्यूल पहुंच की खोज

रस्ट के साथ काम करते समय, स्वच्छ और मॉड्यूलर कोड बनाए रखने के लिए मॉड्यूल की संरचना और पहुंच को समझना आवश्यक है। यदि आप अभी रस्ट से शुरुआत कर रहे हैं या किसी मौजूदा प्रोजेक्ट पर काम कर रहे हैं, तो आपको अपने प्रोजेक्ट निर्देशिका के विभिन्न हिस्सों में स्थित मॉड्यूल तक पहुंचने की चुनौती का सामना करना पड़ सकता है। यह मुश्किल हो सकता है, खासकर जब मुख्य स्रोत कोड के बाहर एक परीक्षण फ़ाइल से चाइल्ड मॉड्यूल को संदर्भित करने का प्रयास किया जा रहा हो। 🔍

रस्ट प्रोजेक्ट के संदर्भ में, प्रोजेक्ट के विभिन्न हिस्सों से `mod.rs` फ़ाइल तक पहुंचने की क्षमता परीक्षण और मॉड्यूलरिटी के लिए महत्वपूर्ण है। `mod.rs` फ़ाइल एक मॉड्यूल के लिए प्रवेश बिंदु के रूप में कार्य करती है, और इसका उपयोग अक्सर सबफ़ोल्डर की सामग्री को व्यवस्थित करने के लिए किया जाता है। इस फ़ाइल को `tests/` फ़ोल्डर से एक्सेस करने का प्रयास करते समय एक सामान्य समस्या उत्पन्न होती है, जो मानक `src/` निर्देशिका के बाहर है। 🛠️

मान लीजिए कि आप एक प्रोजेक्ट के साथ काम कर रहे हैं जहां आपके पास `src/` निर्देशिका के अंदर एक `नियंत्रक/` फ़ोल्डर है, और आप इसकी कुछ कार्यक्षमता का परीक्षण करना चाहते हैं। `tests/test.rs` फ़ाइल से `mod.rs` फ़ाइल को ठीक से आयात और एक्सेस करने का तरीका जानने से आपकी परीक्षण प्रक्रिया आसान हो जाएगी। हालाँकि, रस्ट के मॉड्यूल सिस्टम को इसे निर्बाध रूप से प्राप्त करने के लिए सापेक्ष पथ और मॉड्यूल दृश्यता की अच्छी समझ की आवश्यकता होती है।

अगले भाग में, हम 'test.rs' फ़ाइल से 'नियंत्रक' फ़ोल्डर के अंदर 'mod.rs' को उचित रूप से संदर्भित करके इस समस्या को हल करने के चरणों पर चलेंगे। अंत तक, आप इस चुनौती को संभालने और अपनी रस्ट परियोजनाओं के लिए प्रभावी परीक्षण लागू करने के लिए सुसज्जित होंगे। आइए इस प्रक्रिया को स्पष्ट करने के लिए कुछ व्यावहारिक उदाहरण देखें!

आज्ञा	उपयोग का उदाहरण
mod	रस्ट प्रोजेक्ट के भीतर एक मॉड्यूल की घोषणा करता है। इसका उपयोग अन्य फ़ाइलों (उदाहरण के लिए, मॉड नियंत्रक;) या कोड के विशिष्ट भागों, जैसे सबमॉड्यूल को शामिल करने और संदर्भित करने के लिए किया जा सकता है।
#[cfg(test)]	विशेषताएँ जो निर्दिष्ट करती हैं कि कोड का कौन सा भाग केवल परीक्षण चलाते समय संकलित किया जाना चाहिए। यह परीक्षण-विशिष्ट तर्क को मुख्य कोडबेस से अलग करने में मदद करता है, यह सुनिश्चित करते हुए कि परीक्षण कोड उत्पादन कोड को प्रभावित नहीं करता है।
use	विशिष्ट मॉड्यूल, फ़ंक्शंस या प्रकारों को दायरे में लाने के लिए उपयोग किया जाता है। उदाहरण के लिए, कंट्रोलर::एसएमएस; का उपयोग करें। `नियंत्रक` निर्देशिका से `एसएमएस` मॉड्यूल को परीक्षण फ़ाइल में लाता है।
pub	यह कीवर्ड किसी मॉड्यूल, फ़ंक्शन या वेरिएबल को उसके वर्तमान दायरे के बाहर से पहुंच योग्य बनाता है। इसका उपयोग यह सुनिश्चित करने के लिए किया जाता है कि आपके कोड के हिस्से, जैसे `mod.rs` में फ़ंक्शन, परीक्षण सहित अन्य मॉड्यूल के लिए दृश्यमान हैं।
#[test]	किसी फ़ंक्शन को इकाई परीक्षण के रूप में चिह्नित करता है। रस्ट का अंतर्निहित परीक्षण ढांचा परीक्षण के रूप में चलाने के लिए कार्यों की पहचान करने के लिए इस एनोटेशन का उपयोग करता है, उदाहरण के लिए, #[परीक्षण] एफएन टेस्ट_एसएमएस()।
assert_eq!	यह जांचने के लिए उपयोग किया जाता है कि क्या दो अभिव्यक्तियाँ समान मान पर मूल्यांकन करती हैं। यदि मान समान नहीं हैं, तो परीक्षण विफल हो जाता है। उदाहरण के लिए,assert_eq!(परिणाम, ठीक है('संदेश सफलतापूर्वक भेजा गया!')); जाँचता है कि परिणाम अपेक्षित आउटपुट से मेल खाता है या नहीं।
Err	रस्ट में परिणाम प्रकार के एक प्रकार का प्रतिनिधित्व करता है, जो त्रुटि या विफलता का संकेत देता है। इसका उपयोग परीक्षण मामले में विफलता की स्थिति का अनुकरण करने के लिए किया जाता है, जैसा कि एर ("अमान्य इनपुट") में देखा गया है।
Ok	परिणाम प्रकार के सफलता संस्करण का प्रतिनिधित्व करता है। इसका उपयोग सफल परिणाम का अनुकरण करने के लिए परीक्षणों में किया जाता है, जैसे ओके ("संदेश सफलतापूर्वक भेजा गया!")।
mod.rs	वह फ़ाइल नाम जिसका उपयोग रस्ट किसी निर्देशिका के लिए मॉड्यूल घोषित करने के लिए करता है। यह एक ही फ़ोल्डर के भीतर सबमॉड्यूल को व्यवस्थित करने में मदद करता है, जब आप मूल फ़ोल्डर, जैसे, मॉड नियंत्रकों को संदर्भित करते हैं तो उन्हें पहुंच योग्य बनाता है; `नियंत्रक/mod.rs` तक पहुँचता है।

स्क्रिप्ट को समझना: जंग में बाल मॉड्यूल तक पहुँचना

पिछले उदाहरण में, हमने पता लगाया कि कैसे पहुंचें mod.rs के अंदर फ़ाइल करें नियंत्रकों में स्थित एक परीक्षण फ़ाइल से फ़ोल्डर परीक्षण निर्देशिका. आइए गहराई से जानें कि स्क्रिप्ट कैसे काम करती हैं और प्रत्येक भाग महत्वपूर्ण क्यों है। पहला कदम आपके रस्ट प्रोजेक्ट में मॉड्यूल घोषित करना है, विशेष रूप से इसका उपयोग करना आधुनिक संदर्भ के लिए कीवर्ड नियंत्रकों आपके मुख्य कोडबेस से मॉड्यूल। यह की सामग्री बनाता है नियंत्रकों फ़ोल्डर, जैसे sms.rs, परीक्षणों सहित आपके शेष कोड तक पहुंच योग्य। इस घोषणा के बिना, आपकी परीक्षण फ़ाइलें मॉड्यूल को ढूंढने या उसका उपयोग करने में सक्षम नहीं होंगी। यह किसी स्थान के लिए एक स्पष्ट पता प्रदान करने जैसा है - इसके बिना, सिस्टम यह नहीं जान सकता कि कहाँ जाना है। 🛠️

इन लिपियों का एक अन्य प्रमुख पहलू इसका उपयोग है #[सीएफजी(परीक्षण)] गुण। यह विशेषता रस्ट को केवल परीक्षण के दौरान कोड के विशिष्ट भागों को संकलित करने और शामिल करने के लिए कहती है। हमारे मामले में, इसका उपयोग परीक्षण कार्यों को अलग करने के लिए किया जाता है, ताकि वे एप्लिकेशन के मुख्य तर्क को प्रभावित न करें। यह दृष्टिकोण स्वच्छ कोड बनाए रखने और यह सुनिश्चित करने में मदद करता है कि परीक्षण तर्क उत्पादन कोड में हस्तक्षेप नहीं करता है। आप इसे एक परीक्षण वातावरण की तरह सोच सकते हैं जो केवल तभी सक्रिय होता है जब आप सिस्टम के प्रदर्शन या कार्यक्षमता की जांच करने के लिए तैयार होते हैं। यह सुनिश्चित करता है कि सिस्टम स्थिर रहे और परीक्षण कार्यों से अप्रभावित रहे।

उपयोग विशिष्ट मॉड्यूल या फ़ंक्शंस को दायरे में लाने में कीवर्ड महत्वपूर्ण भूमिका निभाता है। स्क्रिप्ट में, नियंत्रक::एसएमएस का उपयोग करें हमें एक्सेस करने की अनुमति देता है sms.rs मॉड्यूल के अंदर नियंत्रकों परीक्षण फ़ाइल से फ़ोल्डर. इससे सभी सार्वजनिक कार्य अंदर ही हो जाते हैं sms.rs सुलभ, जैसे एसएमएस भेजें फ़ंक्शन, जिसे हम यह सत्यापित करने के लिए परीक्षण करते हैं कि यह अपेक्षा के अनुरूप काम करता है या नहीं। यह दृष्टिकोण कोड पुन: प्रयोज्यता और मॉड्यूलरिटी के लिए रस्ट में एक सामान्य पैटर्न है। कल्पना कीजिए कि आप एक पुस्तकालय में हैं, और उपयोग यह आपके काम को पूरा करने के लिए शेल्फ से एक विशिष्ट पुस्तक प्राप्त करने जैसा है - यह आपके लिए कोड के केवल प्रासंगिक भागों को उपलब्ध कराकर समय और प्रयास बचाता है। 📚

अंततः #[परीक्षा] एनोटेशन और assert_eq! मैक्रो हमारे यूनिट परीक्षणों को चलाने और मान्य करने के लिए आवश्यक हैं। #[परीक्षा] किसी फ़ंक्शन को परीक्षण केस के रूप में चिह्नित करता है, जिसे रस्ट परीक्षण ढांचे द्वारा स्वचालित रूप से पहचाना जाता है। स्क्रिप्ट में, हमने उपयोग किया assert_eq! अपेक्षित परिणाम की वास्तविक परिणाम से तुलना करना एसएमएस भेजें समारोह। यदि मान मेल नहीं खाते हैं, तो परीक्षण विफल हो जाएगा, जिससे हमें हमारे कोड की कार्यक्षमता पर तत्काल प्रतिक्रिया मिलेगी। इससे हमें यह सुनिश्चित करने में मदद मिलती है कि हमारे मॉड्यूल उम्मीद के मुताबिक काम करते हैं और हमें समस्याओं को तुरंत पहचानने और ठीक करने की अनुमति मिलती है। यह विकास के दौरान एक सुरक्षा जाल की तरह है - अगर कुछ गलत होता है, तो परीक्षण इसे पकड़ लेगा और हमें बताएगा कि वास्तव में कहाँ देखना है।

रस्ट में एक परीक्षण से mod.rs फ़ाइल तक कैसे पहुँचें

जंग - बैकएंड विकास

mod controllers; // Declare the module from the controllers folder
use controllers::sms; // Use a specific module inside controllers
#[cfg(test)] // Mark the module for testing only
mod tests; // Declare the test module
#[cfg(test)] // Only compile the test code in test configuration
use crate::controllers::sms::send_sms; // Example of using the sms.rs file from controllers
#[test] // Declare a test function
fn test_sms_function() {
    assert_eq!(send_sms("12345", "Test message"), Ok("Message sent successfully!")); // Test the function
}

मॉड्यूल एक्सेस के लिए mod.rs का उपयोग करके सापेक्ष पथों के साथ समाधान

जंग - मॉड्यूल संगठन के साथ बैकएंड विकास

mod controllers { // Declare the controllers module
    pub mod sms; // Make the sms module accessible
    pub mod mod.rs; // Ensure mod.rs is public and accessible in tests
}
#[cfg(test)] // Only include this part in test builds
mod tests; // Test module declaration
use crate::controllers::sms::send_sms; // Access the sms function from controllers
#[test] // Mark this function as a test
fn test_sms() {
    let result = send_sms("12345", "Test message");
    assert_eq!(result, Ok("Message sent successfully!")); // Validate test results
}

test.rs से कंट्रोलर मॉड्यूल एक्सेस के लिए यूनिट टेस्ट

जंग - नियंत्रक मॉड्यूल का परीक्षण

mod controllers; // Declare the module path for controllers
use controllers::sms; // Use the sms module from controllers
#[cfg(test)] // This module is only included during testing
mod test; // Test module declaration
#[test] // The test annotation for unit tests
fn test_send_sms() {
    let result = sms::send_sms("12345", "Hello, World!");
    assert_eq!(result, Ok("Message sent successfully!")); // Check for expected result
}
#[test] // Another test for failure case
fn test_send_sms_failure() {
    let result = sms::send_sms("", "");
    assert_eq!(result, Err("Invalid input")); // Expect failure case
}

परीक्षण के लिए जंग में मॉड्यूल तक पहुंच और संरचना कैसे करें

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

तक पहुँचने के लिए mod.rs अपने परीक्षण कोड में फ़ाइल करें, आपको पहले यह सुनिश्चित करना होगा कि मॉड्यूल स्रोत कोड में सही ढंग से घोषित किया गया है। हमारे उदाहरण में, mod controllers मुख्य प्रोजेक्ट निर्देशिका में कथन हमें उस फ़ोल्डर को संदर्भित करने में मदद करता है जहां mod.rs फ़ाइल स्थित है. परीक्षण फ़ाइल के अंदर, आप फिर उपयोग कर सकते हैं use crate::controllers::sms जैसे विशिष्ट फ़ाइलों तक पहुँचने के लिए sms.rs और इसके कार्य. यह मॉड्यूलर संरचना बेहतर कोड संगठन और पुन: प्रयोज्य की अनुमति देती है, क्योंकि आपको केवल परीक्षण के लिए आवश्यक विशिष्ट कार्यों या प्रकारों को आयात करने की आवश्यकता होती है।

यह ध्यान रखना महत्वपूर्ण है कि रस्ट का मॉड्यूल सिस्टम दृश्यता के बारे में बहुत सख्त है। उदाहरण के लिए, कोई भी फ़ंक्शन या प्रकार जिसे आप उनके मूल मॉड्यूल के बाहर उपयोग करना चाहते हैं, उसे के साथ चिह्नित किया जाना चाहिए pub उन्हें सार्वजनिक करने के लिए कीवर्ड। इस मामले में, sms::send_sms के अंदर कार्य करता है sms.rs परीक्षण फ़ाइल तक पहुंचने के लिए फ़ाइल को सार्वजनिक होना आवश्यक है। यह यह सुनिश्चित करके सिस्टम को सुरक्षित और निष्पादित दोनों बनाता है कि केवल आवश्यक घटक ही कोडबेस के अन्य भागों के संपर्क में आते हैं। अपने मॉड्यूल और परीक्षणों को प्रभावी ढंग से व्यवस्थित करके, आप यह सुनिश्चित कर सकते हैं कि आपका रस्ट एप्लिकेशन स्केलेबल और रखरखाव योग्य बना रहे। ⚙️

रस्ट में चाइल्ड मॉड्यूल तक पहुँचने के बारे में अक्सर पूछे जाने वाले प्रश्न

मैं परीक्षण फ़ाइल से उपनिर्देशिका में स्थित मॉड्यूल तक कैसे पहुँच सकता हूँ?
आप इसका उपयोग कर सकते हैं mod मॉड्यूल घोषित करने के लिए कीवर्ड, उसके बाद use उस मॉड्यूल से विशिष्ट फ़ंक्शन या प्रकार लाने के लिए कीवर्ड। उदाहरण के लिए, use crate::controllers::sms इसे बनाएं sms.rs मॉड्यूल सुलभ.
क्या करता है #[cfg(test)] रस्ट में मतलब?
यह कोड को केवल परीक्षण के दौरान संकलित और चलाने के लिए चिह्नित करता है। इससे यह सुनिश्चित करने में मदद मिलती है कि परीक्षण-विशिष्ट तर्क आपके एप्लिकेशन के उत्पादन निर्माण को प्रभावित नहीं करता है।
मैं रस्ट में किसी अन्य मॉड्यूल में किसी फ़ंक्शन को कैसे पहुंच योग्य बना सकता हूं?
आपको फ़ंक्शन को इस रूप में घोषित करने की आवश्यकता है pub, जो इसे अपने मॉड्यूल के बाहर सार्वजनिक और सुलभ बनाता है। उदाहरण के लिए, pub fn send_sms() करने देगा एसएमएस भेजें परीक्षण फ़ाइलों में उपयोग किया जाना है।
क्यों mod.rs जंग में प्रयोग किया जाता है?
mod.rs मॉड्यूल फ़ोल्डर के लिए मुख्य प्रवेश बिंदु के रूप में कार्य करता है। यह रस्ट को फ़ाइलों को सबमॉड्यूल में व्यवस्थित करने की अनुमति देता है, जो बड़ी परियोजनाओं के लिए एक स्पष्ट संरचना प्रदान करता है।
मैं रस्ट में एक विशिष्ट परीक्षण फ़ंक्शन कैसे चलाऊं?
आप किसी फ़ंक्शन को इसके साथ चिह्नित कर सकते हैं #[test] यह इंगित करने के लिए कि यह एक परीक्षण फ़ंक्शन है। परीक्षण चलाने के लिए, बस निष्पादित करें cargo test आपके टर्मिनल में.
क्या करता है assert_eq! जंग परीक्षण में करते हैं?
assert_eq! एक परीक्षण में दो मानों की तुलना करता है। यदि मान समान नहीं हैं, तो परीक्षण विफल हो जाएगा। इस मैक्रो का उपयोग आमतौर पर यह जांचने के लिए किया जाता है कि वास्तविक आउटपुट यूनिट परीक्षणों में अपेक्षित आउटपुट से मेल खाता है या नहीं।
क्या मैं यहां से मॉड्यूल तक पहुंच सकता हूं? tests मुख्य स्रोत कोड में फ़ोल्डर?
नहीं, tests फ़ोल्डर डिफ़ॉल्ट रूप से मुख्य कोड से अलग होता है। आप इसका उपयोग करके अपने परीक्षणों में मुख्य मॉड्यूल तक पहुंच सकते हैं mod और use कीवर्ड, जैसा कि उदाहरण में दिखाया गया है।
मैं बड़ी रस्ट परियोजनाओं के लिए अपना कोड कैसे तैयार करूं?
बड़ी परियोजनाओं के लिए, अपने कोड को सबमॉड्यूल में व्यवस्थित करें mod.rs प्रत्येक फ़ोल्डर में फ़ाइलें. के साथ चिह्नित सार्वजनिक कार्यों का उपयोग करें pub क्रॉस-मॉड्यूल एक्सेस के लिए।
यदि मैं रस्ट में किसी फ़ंक्शन को सार्वजनिक करना भूल जाऊं तो क्या होगा?
यदि कोई फ़ंक्शन घोषित नहीं किया गया है pub, यह अपने मॉड्यूल के लिए निजी होगा। परीक्षण फ़ाइलों सहित अन्य मॉड्यूल, इसे तब तक एक्सेस नहीं कर पाएंगे जब तक कि इसे स्पष्ट रूप से सार्वजनिक न किया जाए।
मैं रस्ट में बाहरी निर्भरता वाले मॉड्यूल का परीक्षण कैसे कर सकता हूं?
बाहरी निर्भरता वाले मॉड्यूल का परीक्षण करने के लिए नकली लाइब्रेरी या निर्भरता इंजेक्शन का उपयोग करें। यह सुनिश्चित करता है कि आपके परीक्षण अलग-अलग हैं और बाहरी सिस्टम पर निर्भर नहीं हैं।

परीक्षणों से जंग मॉड्यूल तक पहुंच: एक पुनर्कथन

यह समझना कि कैसे पहुंचें mod.rs फ़ाइल के अंदर नियंत्रकों परीक्षण फ़ाइल से फ़ोल्डर आपके रस्ट प्रोजेक्ट को प्रभावी ढंग से संरचित करने के लिए महत्वपूर्ण है। उपयोग करके use और mod, आप विशिष्ट मॉड्यूल को दायरे में ला सकते हैं, जिससे कुशल और पृथक परीक्षण की अनुमति मिलती है। यह मॉड्यूलर दृष्टिकोण न केवल कोड पठनीयता को बढ़ाता है बल्कि आपके प्रोजेक्ट में पुन: प्रयोज्य में भी सुधार करता है। ⚙️

निष्कर्ष में, रस्ट मॉड्यूल का संगठन उपयोग कर रहा है mod.rs स्वच्छ कोड पृथक्करण और पहुंच में आसानी सुनिश्चित करता है। मॉड्यूल घोषणा और दृश्यता के लिए रस्ट के सम्मेलनों का पालन करके, डेवलपर्स एक स्केलेबल और परीक्षण योग्य कोडबेस बनाए रख सकते हैं। अच्छी तरह से संरचित परीक्षणों के साथ, आपका रस्ट प्रोजेक्ट लंबी अवधि में स्थिर और रखरखाव योग्य रहेगा। 📦

स्रोत और सन्दर्भ

रस्ट के मॉड्यूल सिस्टम को समझने के लिए, यह आलेख रस्ट में मॉड्यूल के साथ कैसे काम करें, इसकी विस्तृत व्याख्या प्रदान करता है। आप आधिकारिक पर रस्ट मॉड्यूल सिस्टम के बारे में अधिक पढ़ सकते हैं जंग दस्तावेज .
रस्ट में परीक्षण के बारे में और अपने परीक्षणों की संरचना कैसे करें, यह जानने के लिए एक और उपयोगी संसाधन आधिकारिक रस्ट बुक में उपलब्ध है। यहां और जानें: जंग परीक्षण .

रस्ट चाइल्ड मॉड्यूल में mod.rs तक पहुंचने के लिए टेस्ट फ़ाइल का उपयोग कैसे करें