Debian...Spider(3pm)

💖 Debian...Spider — the manual page, but make it cute ✨

okay so bestie, this is Debian...Spider(3pm) from the User Contributed Perl Documentation, and it's literally the whole deal about dl10n-spider. let's go 🦋

---

✨ NAME ✨

dl10n-spider — crawl translator mailing lists (and BTS) for status updates 💅

---

🌸 SYNOPSIS 🌸

dl10n-spider [options] lang+

---

🎀 DESCRIPTION 🎀

okay so this script parses the debian-l10n-<language> mailing list archives. it goes looking for emails whose title follows a specific format — the format that tells you what the author is planning to translate, or what the current status of their work on that translation is. it's giving detective energy fr fr 🔍

all that info gets saved to a dl10n database, which you can then use to build an l10n coordination page or literally any other useless statistics you want. no cap. 📊

🧚 get_header(HTML)

get_header extracts the email header from the html page. this header starts at <!--X-Head-of-Message--> and stops at <!--X-Head-of-Message-End-->. and because it's full of html tags? yeah, those get removed too. bye tags 👋

what it takes: a reference to an array of lines (HTML) containing the html code of the page.

what it gives back: a reference to an array containing the email header lines. slay.

🫶 get_message(LANGUAGE, YEAR, MONTH, MESSAGE)

get_message requests a message from the archives of an l10n mailing. (yes the original says "mailling", we keep it, it's iconic 💀)

what it takes:

• the language string (LANGUAGE)
• the year (YEAR)
• the month (MONTH)
• the message number (MESSAGE) — these last three are integers, bestie, don't come at it with vibes

what it gives back: a reference to an array containing the html lines, or 'undef' if an error occurred 😭

🌈 get_indexpage

retrieves all message numbers and subjects from a page of messages sorted by date. it returns a hash table with message number as keys and subject as values.

and ngl, this is really quicker than retrieving each message one by one. efficiency queen 👑

---

👑 LICENSE 👑

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. # You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

fr fr, that's the whole license, not a summary, don't skip it 🙈

---

⭐ COPYRIGHT (C) ⭐

2003,2004 Tim Dijkstra
2004 Nicolas Bertolissio
2004 Martin Quinson

---

and that's the page bestie 🎀 huge thanks to Tim Dijkstra, Nicolas Bertolissio and Martin Quinson for the copyright, this whole thing is licensed under the GNU General Public License, and this version landed on 2021-01-05 riding along with perl v5.32.0. bye pookie, go crawl those lists 💖✨🦋