219 lines
6.9 KiB
Python
219 lines
6.9 KiB
Python
|
|
"""
|
|
The MIT License (MIT)
|
|
Copyright © 2019 Jean-Christophe Bos & HC² (www.hc2.fr)
|
|
"""
|
|
|
|
class UrlUtils :
|
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
@staticmethod
|
|
def Quote(s, safe='/') :
|
|
r = ''
|
|
for c in str(s) :
|
|
if (c >= 'a' and c <= 'z') or \
|
|
(c >= '0' and c <= '9') or \
|
|
(c >= 'A' and c <= 'Z') or \
|
|
(c in '.-_') or (c in safe) :
|
|
r += c
|
|
else :
|
|
for b in c.encode('UTF-8') :
|
|
r += '%%%02X' % b
|
|
return r
|
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
@staticmethod
|
|
def UrlEncode(s) :
|
|
return UrlUtils.Quote(s, ';/?:@&=+$,')
|
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
@staticmethod
|
|
def Unquote(s) :
|
|
r = str(s).split('%')
|
|
try :
|
|
b = r[0].encode()
|
|
for i in range(1, len(r)) :
|
|
try :
|
|
b += bytes([int(r[i][:2], 16)]) + r[i][2:].encode()
|
|
except :
|
|
b += b'%' + r[i].encode()
|
|
return b.decode('UTF-8')
|
|
except :
|
|
return str(s)
|
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
@staticmethod
|
|
def UnquotePlus(s) :
|
|
return UrlUtils.Unquote(str(s).replace('+', ' '))
|
|
|
|
# ============================================================================
|
|
# ===( Class Url )============================================================
|
|
# ============================================================================
|
|
|
|
class Url :
|
|
|
|
def __init__(self, url='') :
|
|
self.URL = url
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
def __repr__(self) :
|
|
return self.URL if self.URL is not None else ''
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
def IsHttps(self) :
|
|
return (self._proto == 'https')
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def URL(self) :
|
|
host = self.Host
|
|
if host != '' :
|
|
proto = self.Proto
|
|
port = self.Port
|
|
if ( proto == 'http' and port == 80 ) or \
|
|
( proto == 'https' and port == 443 ) :
|
|
port = ''
|
|
else :
|
|
port = ':' + str(port)
|
|
url = proto + '://' + host + port + self.Path
|
|
url = UrlUtils.UrlEncode(url)
|
|
qs = self.QueryString
|
|
if qs != '' :
|
|
return url + '?' + qs
|
|
return url
|
|
return None
|
|
|
|
@URL.setter
|
|
def URL(self, value) :
|
|
try :
|
|
s = str(value)
|
|
if '://' in s :
|
|
proto, s = s.split('://', 1)
|
|
else :
|
|
proto = 'http'
|
|
except :
|
|
raise ValueError('URL error (%s)' % value)
|
|
self.Proto = proto
|
|
if '/' in s :
|
|
host, path = s.split('/', 1)
|
|
elif '?' in s :
|
|
host, path = s.split('?', 1)
|
|
path = '?' + path
|
|
else :
|
|
host = s
|
|
path = ''
|
|
if ':' in host :
|
|
try :
|
|
host, port = host.split(':')
|
|
self.Port = port
|
|
except :
|
|
raise ValueError('URL host:port error (%s)' % host)
|
|
self.Host = host
|
|
self._queryParams = { }
|
|
self.Path = path
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def Proto(self) :
|
|
return self._proto
|
|
|
|
@Proto.setter
|
|
def Proto(self, value) :
|
|
value = str(value).lower()
|
|
if value == 'http' :
|
|
self._port = 80
|
|
elif value == 'https' :
|
|
self._port = 443
|
|
else :
|
|
raise ValueError('Unsupported URL protocol (%s)' % value)
|
|
self._proto = value
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def Host(self) :
|
|
return self._host
|
|
|
|
@Host.setter
|
|
def Host(self, value) :
|
|
self._host = UrlUtils.UnquotePlus(value)
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def Port(self) :
|
|
return self._port
|
|
|
|
@Port.setter
|
|
def Port(self, value) :
|
|
try :
|
|
p = int(value)
|
|
except :
|
|
raise ValueError('Port must be an integer value')
|
|
if p <= 0 or p >= 65536 :
|
|
raise ValueError('Port must be greater than 0 and less than 65536')
|
|
self._port = p
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def Path(self) :
|
|
return self._path
|
|
|
|
@Path.setter
|
|
def Path(self, value) :
|
|
x = value.split('?', 1)
|
|
if len(x[0]) > 0 :
|
|
if x[0][0] != '/' :
|
|
x[0] = '/' + x[0]
|
|
self._path = UrlUtils.UnquotePlus(x[0])
|
|
else :
|
|
self._path = '/'
|
|
if len(x) == 2 :
|
|
self.QueryString = x[1]
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def QueryString(self) :
|
|
r = ''
|
|
for param in self._queryParams :
|
|
if param != '' :
|
|
if r != '' :
|
|
r += '&'
|
|
r += UrlUtils.Quote(param) + '=' + UrlUtils.Quote(self._queryParams[param])
|
|
return r
|
|
|
|
@QueryString.setter
|
|
def QueryString(self, value) :
|
|
self._queryParams = { }
|
|
for x in value.split('&') :
|
|
param = x.split('=', 1)
|
|
if param[0] != '' :
|
|
value = UrlUtils.Unquote(param[1]) if len(param) > 1 else ''
|
|
self._queryParams[UrlUtils.Unquote(param[0])] = value
|
|
|
|
# ------------------------------------------------------------------------
|
|
|
|
@property
|
|
def QueryParams(self) :
|
|
return self._queryParams
|
|
|
|
@QueryParams.setter
|
|
def QueryParams(self, value) :
|
|
if not isinstance(value, dict) :
|
|
raise ValueError('QueryParams must be a dict')
|
|
self._queryParams = value
|
|
|
|
# ============================================================================
|
|
# ============================================================================
|
|
# ============================================================================
|