पाठ्यक्रम 156 में से पाठ 46 · एक blocker बनाएँ
एक blocker बनाएँ

Blocklists कैसे काम करती हैं

यह क्यों मायने रखता है आज दुनिया में ज़्यादातर tracker blocking, extensions में और ब्राउज़रों में, नियमों की एक सादी टेक्स्ट फ़ाइल से शुरू होती है। एक बार आप वह फ़ाइल पढ़ सकें, तो आप ठीक देख सकते हैं कि एक blocker क्या रोकेगा और क्या नहीं, और एक साइट कभी-कभी क्यों टूटती है।

एक सूची वाला bouncer

एक club के दरवाज़े पर एक छपी सूची लिए एक bouncer की तस्वीर बनाएँ: "इन लोगों को अंदर न आने दें", साथ में एक छोटा नोट: "इन नियमित लोगों को छोड़कर"। bouncer किसी को परखता नहीं; वे बस नामों को सूची से जाँचते हैं।

एक blocker भी ऐसे ही काम करता है। हर बार जब एक पन्ना कुछ माँगता है (एक script, एक तस्वीर, एक pixel), blocker पते को अपनी सूची से जाँचता है और कहता है allow या block।

Filter list: नियमों की एक टेक्स्ट फ़ाइल, हर पंक्ति पर एक, जो एक blocker को बताती है कि कौन-सी requests रोकनी हैं। सबसे जाना-माना परिवार EasyList है, Adblock Plus syntax में लिखा जो ज़्यादातर blockers समझते हैं।

Request: आपके ब्राउज़र से एक server को एक माँग, जैसे "मुझे https://adco.example/tag.js भेजो"। एक पन्ना आमतौर पर कई requests करता है।

Syntax, एक छोटा अभ्यास हिस्सा

असली सूचियों में दसियों हज़ार पंक्तियाँ और कई अतिरिक्त features होते हैं। हम उसी मूल syntax वाली एक छोटी, बनावटी अभ्यास सूची इस्तेमाल करते हैं। यह रही (यह watched.leg2b_blocker.PRACTICE_LIST में रहती है):

[Adblock Plus 2.0]
! Title: Watched Practice List (made up for the course)

||adco.example^
||metrics.example^$third-party
||trackmore.example^
/p.gif?
*/collect?*cid=
/beacon/*/hit$third-party

! Exceptions: things that look like trackers but are needed
@@||cdn.example^
@@/assets/p.gif?

! Cosmetic rules (hide page parts). A network blocker ignores these.
##.ad-banner
shopc.example##.sponsored
पंक्ति ऐसी दिखती हैमतलब
! ... या [...]एक टिप्पणी या एक header। इसे छोड़ें।
||adco.example^एक domain नियम: adco.example और हर subdomain, जैसे img.adco.example, रोकें। ^ host नाम का अंत चिह्नित करता है।
/p.gif?एक pattern नियम: कोई भी पता रोकें जिसमें यह टेक्स्ट हो। अंदर एक * का मतलब "यहाँ कोई भी अक्षर"।
@@...एक अपवाद: इसकी अनुमति दें, भले ही एक रोकने वाला नियम भी मेल खाए।
...$third-partyएक option: यह नियम सिर्फ़ तब लागू करें जब request उस पन्ने से अलग साइट को जाए जिस पर आप हैं।
##.ad-bannerएक cosmetic नियम: पन्ने का हिस्सा छिपाएँ। यह कभी एक request नहीं रोकता, इसलिए एक network blocker इसे छोड़ता है।

Third party: आपके address bar वाली से अलग साइट को एक request। shopa.example पर adco.example को एक request third party है; shopa.example को ही एक first party है।

एक पंक्ति को डेटा में बदलना

प्रोग्राम हर request के लिए टेक्स्ट फिर से पढ़ना नहीं चाहते। इसलिए पहला काम parsing है: हर पंक्ति को एक बार, start-up पर, एक छोटे dict में बदलना।

Parsing: टेक्स्ट पढ़कर उसे संरचित डेटा में बदलना जिसे एक प्रोग्राम सीधे इस्तेमाल कर सके, जैसे एक लिखी ख़रीदारी सूची को एक form पर tick किए boxes में बदलना।

हमारे नियम dict में चार keys हैं:

parse_rule("||metrics.example^$third-party")
# {'exception': False, 'kind': 'domain',
#  'value': 'metrics.example', 'third_party': True}

parse_rule("@@/assets/p.gif?")
# {'exception': True, 'kind': 'pattern',
#  'value': '/assets/p.gif?', 'third_party': False}

parse_rule("! just a comment")
# None

Python के दो string औज़ार ज़्यादातर काम करते हैं। line.startswith("@@") जाँचता है कि एक पंक्ति कैसे शुरू होती है। line.rsplit("$", 1) आख़िरी $ पर एक बार बाँटता है, नियम का टेक्स्ट और options देते हुए, इसलिए "a$b".rsplit("$", 1) है ["a", "b"]।

एक आम ग़लतफ़हमी

"Blocklists विज्ञापन रोकती हैं।" कई रोकती हैं, पर निजता के लिए मायने रखने वाली सूचियाँ (जैसे EasyPrivacy) trackers को निशाना बनाती हैं: pixels, beacons और analytics scripts, जो आप screen पर कभी नहीं देखते। एक पन्ना बिल्कुल कोई विज्ञापन न दिखाए और फिर भी आपकी visit पाँच कंपनियों को भेजे।

आज़माएँ एक blocker extension install वाले एक desktop ब्राउज़र में extension की settings खोलें और उसकी filter lists ढूँढें। ज़्यादातर आपको एक सूची सादे टेक्स्ट के रूप में देखने देते हैं। || और @@ से शुरू होने वाली पंक्तियाँ खोजें: वे ठीक वे नियम हैं जो आप parse करने वाले हैं।

दूसरी भाषाओं में

JavaScript:

function parseRule(line) {
  line = line.trim();
  if (!line || line.startsWith("!") || line.startsWith("[")) return null;
  if (line.includes("##") || line.includes("#@#")) return null;
  const exception = line.startsWith("@@");
  if (exception) line = line.slice(2);
  let thirdParty = false;
  const at = line.lastIndexOf("$");
  if (at >= 0) {
    thirdParty = line.slice(at + 1).split(",").includes("third-party");
    line = line.slice(0, at);
  }
  const isDomain = line.startsWith("||");
  const value = isDomain ? line.slice(2).replace(/\^$/, "") : line;
  return { exception, kind: isDomain ? "domain" : "pattern",
           value: value.toLowerCase(), thirdParty };
}

Rust:

struct Rule { exception: bool, domain: bool, value: String, third_party: bool }

fn parse_rule(line: &str) -> Option<Rule> {
    let mut l = line.trim();
    if l.is_empty() || l.starts_with('!') || l.starts_with('[') || l.contains("##") {
        return None;
    }
    let exception = l.starts_with("@@");
    if exception { l = &l[2..]; }
    let mut third_party = false;
    if let Some((rule, opts)) = l.rsplit_once('$') {
        third_party = opts.split(',').any(|o| o == "third-party");
        l = rule;
    }
    let domain = l.starts_with("||");
    let v = if domain { l[2..].trim_end_matches('^') } else { l };
    Some(Rule { exception, domain, value: v.to_lowercase(), third_party })
}

सार

  • एक filter list सादा टेक्स्ट है: domain नियम (||host^), pattern नियम, अपवाद (@@) और options ($third-party)।
  • Cosmetic नियम (##) पन्ने के हिस्से छिपाते हैं और कभी एक request नहीं रोकते।
  • एक बार सरल dicts में parse करें ताकि बाद में मिलान तेज़ और साफ़ हो।
आपकी बारी

parse_rule(line) लिखें जो ख़ाली, टिप्पणी (!), header ([) और cosmetic (## या #@#) पंक्तियों के लिए None लौटाए, और नहीं तो keys exception, kind ("domain" या "pattern"), value (छोटे अक्षरों में, ||, आख़िरी ^, @@ या $options के बिना) और third_party वाला एक dict। फिर parse_list(text) लिखें जो हर पंक्ति के नियमों की सूची लौटाए, क्रम में, None नतीजे छोड़कर। कोर्स का अपना parser import न करें।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।