Wikipedia:Lua/Modul/URLutil/hsb

URLutil – Modul z funkcijemi za rjady znamješkow, kotrež so na internetowe adresy poćahnu (URL; IP-adresy – tež IPv4 a IPv6 – ale tež e-mejlka). Tež internacionalizěrowane adresy (IRI) su móžne.

Mamy za to zo je wužitk za Wikijowy projekt; tuž zmysłapołne adresy we wotewrjenym interneće. Sćěhowace specialne pady njejsu programowane, ale tež lědma relewantne:

• IPv4-adresa nic w normalnej notaciji (z dypkami rozdźělene, decimalne)
• URL z IPv6-Host (spinkowane; njekongruěruje derje z Wikijoweju syntaksu)
• Authority z username

Wšě funkcije maja eksaktnje jedyn njemjenowany parameter (zmysłapołnje so dyrbi daty). Tutón je tolerantny přećiwo prózdnym znamješkam před abo po wobsahu.

Hódnota wróćenja je prózdna rjad znamješkow („nic“), jeli hódnota parametra njedospołni wotčakowanja. Jeli rezultat je wobstejacy abo prašenske wuměnjenje je prawne, rezultuje minimalnje jedne znamjo. Rezultat njezapočina abo so kónči z prózdnym znamješkom.

getAuthority

Ekstrahuje z ressource URL zaměranje serwera (rezultat pisany w małkich pismikach)

• nic – jeli njedowoleny

getHost

Ekstrahuje z ressource-URL domainom abo IP-adresu (rezultat pisany w małkich pismikach)

• nic – jeli njedowoleny

getPort

Ekstraruje z ressource-URL informaciju wo portu (rezultat ličba)

• nic – jeli wobstejacy

getScheme

Ekstrahuje z ressource-URL šemu (rezultat pisany w małkich pismikach; inkluziwnje dwójnych nakósnych smužkow)

• // – relatiwny protokol
• https:// – protokol
• nic – jeli spočatk URL njedowoleny

getTLD

Ekstrahuje z ressource-URL Top-Level-Domain (rezultat z małkimi pismikami pisany)

• ničo – jeli njedowoleny

getTop2domain

Ekstrahuje z ressource-URL najbóle hornjej wobaj niwowaj domaina (rezultat z małkimi pismikami pisany)

• ničo – jeli njedowoleny

getTop3domain

• ničo – jeli njedowoleny

isAuthority

Wón je adresa serwera (tež IP) ressource, inkluziwnje porta?

• 1 – haj

isDomain

Wón je mjenowany domain, inkluziwnje subdomainow?

• 1 – haj

isDomainExample

• 1 – haj

isHost

Wón je adresa serwera bjez porta (tež IP)?

• 1 – haj

isIP

Wón je IP-adresa?

• 4 jeli IPv4 (w normalnej notaciji)
• 6 jeli IPv6
• nic – hewak

isIPlocal

isIPv4

Wón je IPv4-adresa w normalnej notaciji (z dypkami rozdźělena, decimalna)?

• 1 – haj

isIPv6

Wón je IPv6-adresa?

• 1 – haj

isMailAddress

Wón je adresa e-mejlki?

• 1 – haj

isMailLink

Wón je wotkaz na e-mejlku (mailto:)?

• 1 – haj

isProtocolDialog

Wón je URL / mjeno šemy, kotrež móže we Wikiju dialog započinać?

mailto, irc, ircs, ssh, telnet

• 1 – haj

isProtocolWiki

Wón je URL / mjeno šemy, z kotrymž so móže referencěrować we Wikiju na ressource?

Relatiwny protokol ale tež ftp ftps git http https mms nntp sftp svn worldwind

Njepřate su tu: gopher, wais ale tež mailto, irc, ircs, ssh, telnet.

• 1 – haj

isResourceURL

Wón je URL, při kotrejž powšitkownje so móže přistup měć k ressource? To rěka: relatiwny protokol, http, https, ftp a nimo toho płaćiwy hósćinarski kompjuter (jendźelsce Host). Druhe URL by k předstajenju na projektowych a funkcijskich stronach, ale nic w encyklopediskim terenje.

• 1 – haj

isSuspiciousURL

Wón je syntaktiski „podhladny“ URL, přećiwo kotrejž so by dyrbi warnować?

• 1 – haj

isUnescapedURL

Wón je URL, při kotrejž hišće Wikisyntaksa [ | ] so dyrbi wotpadnyć?

• 1 – haj

isWebURL

Wón je płaćiwa adresa za ressource (Protokol někajki)?

• 1 – haj

wikiEscapeURL

K wikisyntaksej zawěšće [ | ] escapować.

• Identisce z parametrom, jeli žadne problematiske znamješka wustupuja.
• Narunanje wot [ | ] přez k webserwerej wěste HTML-Entities, jeli wobstejace. Pipe je w syntaksy předłoha nic chroble móžne.

failsafe

Testowy bok ilustruje praktiske přikłady.

Wšě horjeka dokumentowane funkcije so tež móžeja zawjazować z require() do druhich modulow:

local lucky, URLutil = pcall( require, "Module:URLutil" )
if type( URLutil ) == "table" then
    URLutil = URLutil.URLutil()
else
    -- zmylkowu pad; URLutil wobsahuje powěsć zmylka
    return "<span class='error'>" .. URLutil .. "</span>"
end

Po tym su k dispoziciji:

• URLutil.getAuthority()
• URLutil.getHost()
• URLutil.getPort()
  numeriska hódnota, abo false
• URLutil.getScheme()
• URLutil.getTLD()
• URLutil.getTop2domain()
• URLutil.getTop3domain()
• URLutil.isAuthority()
• URLutil.isDomain()
• URLutil.isDomainExample()
• URLutil.isHost()
• URLutil.isIP()
  numeriski 4, 6, abo false
• URLutil.isIPlocal()
• URLutil.isIPv4()
• URLutil.isIPv6()
• URLutil.isMailAddress()
• URLutil.isMailLink()
• URLutil.isProtocolDialog
• URLutil.isProtocolWiki()
• URLutil.isResourceURL()
• URLutil.isSuspiciousURL()
• URLutil.isUnescapedURL()
• URLutil.isWebURL()
• URLutil.wikiEscapeURL()
• URLutil.failsafe()

W padźe wuspěcha URLutil.get*() wróći rjad znamješkow, URLutil.is*() hódnotu true (jeli nic hewak daty); při njewuspěchu kóždy raz false.

Powšykna biblioteka; njewobmjezowana.

Žadna.