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

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

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

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

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

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

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

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

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

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

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

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 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
}

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 परीक्षण फ़ाइल तक पहुंचने के लिए फ़ाइल को सार्वजनिक होना आवश्यक है। यह यह सुनिश्चित करके सिस्टम को सुरक्षित और निष्पादित दोनों बनाता है कि केवल आवश्यक घटक ही कोडबेस के अन्य भागों के संपर्क में आते हैं। अपने मॉड्यूल और परीक्षणों को प्रभावी ढंग से व्यवस्थित करके, आप यह सुनिश्चित कर सकते हैं कि आपका रस्ट एप्लिकेशन स्केलेबल और रखरखाव योग्य बना रहे। ⚙️