Warp Rust: पूरी गाइड, उदाहरण और सेटअप ट्यूटोरियल

Warp क्या है और इसकी ज़रूरत क्यों है?

Warp, Rust भाषा के लिए एक आधुनिक, एसिंक्रोनस और कम्पोज़ेबल (composable) वेब फ्रेमवर्क है। यह hyper लाइब्रेरी और एसिंक्रोनस रनटाइम tokio पर आधारित है। इसकी मुख्य फिलॉसफी फिल्टर (filters) का उपयोग है, जो जटिल रूट और रिक्वेस्ट हैंडलर बनाने के लिए बिल्डिंग ब्लॉक्स की तरह जोड़े जाते हैं।

Warp हाई-परफॉर्मेंस वेब सर्वर, REST API, माइक्रोसर्विसेज और सरल वेब एप्लिकेशन बनाने के लिए एकदम सही है। Rust की सख्त टाइपिंग और फिल्टर की शक्तिशाली प्रणाली के कारण, Warp कंपाइल टाइम पर ही कई गलतियों को पकड़ लेता है, जिससे कोड सुरक्षित और अनुमानित रहता है।

Warp का उपयोग क्यों करें?

• परफॉर्मेंस: Rust + async/await C/C++ जैसी स्पीड देते हैं।
• सुरक्षा: Rust कंपाइलर टाइप और मेमोरी चेक करता है, Warp रूट्स की सही जांच करता है।
• कम्पोज़ेबिलिटी: फिल्टर को जोड़ा, दोबारा इस्तेमाल और अलग-अलग टेस्ट किया जा सकता है।
• मिनिमलिज़्म: कोई मैक्रो या जादू नहीं - सब कुछ फंक्शन और क्लोज़र पर आधारित है।
• बिल्ट-इन एसिंक्रोनस: WebSocket, डेटा स्ट्रीमिंग और लंबे कनेक्शन के लिए सपोर्ट।

Warp इंस्टॉल कैसे करें

Warp Rust की एक लाइब्रेरी है, इसलिए इसे cargo पैकेज मैनेजर के ज़रिए इंस्टॉल किया जाता है। सुनिश्चित करें कि आपके पास Rust (कम से कम वर्शन 1.70) इंस्टॉल है।

नया प्रोजेक्ट बनाएं:

cargo new my_warp_app
cd my_warp_app

Cargo.toml फ़ाइल में डिपेंडेंसी जोड़ें:

[dependencies]
warp = "0.3"
tokio = { version = "1", features = ["full"] }

फिर बिल्ड करें:

cargo build

अगर आप Windows का उपयोग कर रहे हैं, तो कंपाइलेशन के लिए Build Tools for Visual Studio इंस्टॉल करना पड़ सकता है।

त्वरित शुरुआत: Warp पर पहला सर्वर

एक बेसिक HTTP सर्वर बनाएं जो किसी भी GET रिक्वेस्ट पर "Hello, World!" रिस्पॉन्स दे।

use warp::Filter;

#[tokio::main]
async fn main() {
    // रूट डिफाइन करें: GET / -> "Hello, World!"
    let hello = warp::path::end()
        .map(|| "Hello, World!");

    // सर्वर को पोर्ट 3030 पर चलाएं
    warp::serve(hello)
        .run(([127, 0, 0, 1], 3030))
        .await;
}

सर्वर को cargo run कमांड से चलाएं और ब्राउज़र में http://127.0.0.1:3030 खोलें। आपको "Hello, World!" मैसेज दिखेगा।

Warp के मुख्य मेथड और फंक्शन

नीचे Warp के प्रमुख फंक्शन और मेथड्स को विस्तार से समझाया गया है।

1. warp::any()

क्या करता है: एक ऐसा फिल्टर बनाता है जो किसी भी रिक्वेस्ट (मेथड, पथ, हेडर - सब कुछ) से मैच करता है। इसे कम्बाइन करने के लिए बेस के रूप में उपयोग किया जाता है।

पैरामीटर: कोई नहीं।

उदाहरण:

use warp::Filter;

let any_route = warp::any()
    .map(|| "यह किसी भी रिक्वेस्ट से मैच करेगा");

2. warp::path(String)

क्या करता है: एक विशिष्ट पथ सेगमेंट से मैच करने वाला फिल्टर बनाता है। जैसे, warp::path("api") /api से मैच करेगा।

पैरामीटर: path: impl Into<String> — पथ की स्ट्रिंग।

उदाहरण:

use warp::Filter;

let api_route = warp::path("api")
    .map(|| "API एंडपॉइंट");

3. warp::path::param()

क्या करता है: पथ से डायनामिक पैरामीटर (जैसे यूज़र ID) निकालता है। यह String टाइप का मान लौटाता है (या कोई अन्य टाइप जो FromStr को इम्प्लीमेंट करता है)।

पैरामीटर: कोई नहीं (टाइप कॉन्टेक्स्ट से तय होता है)।

उदाहरण:

use warp::