twisted.python.urlpath.URLPath : API documentation

A representation of a URL.

Instance Variable	scheme	The scheme of the URL (e.g. 'http'). (type: `bytes`)
Instance Variable	netloc	The network location ("host"). (type: `bytes`)
Instance Variable	path	The path on the network location. (type: `bytes`)
Instance Variable	query	The query argument (the portion after ? in the URL). (type: `bytes`)
Instance Variable	fragment	The page fragment (the portion after # in the URL). (type: `bytes`)
Method	__init__	Undocumented
Method	pathList	Split this URL's path into its components.
Class Method	fromString	Make a `URLPath` from a `str` or `unicode`.
Class Method	fromBytes	Make a `URLPath` from a `bytes`.
Class Method	fromRequest	Make a `URLPath` from a `twisted.web.http.Request`.
Method	sibling	Get the sibling of the current `URLPath`. A sibling is a file which is in the same directory as the current file.
Method	child	Get the child of this `URLPath`.
Method	parent	Get the parent directory of this `URLPath`.
Method	here	Get the current directory of this `URLPath`.
Method	click	Return a path which is the URL where a browser would presumably take you if you clicked on a link with an HREF as given.
Method	__str__	The `str` of a `URLPath` is its URL text.
Method	__repr__	The `repr` of a `URLPath` is an eval-able expression which will construct a similar `URLPath`.
Method	_reconstitute	Reconstitute this `URLPath` from all its given attributes.
Class Method	_fromURL	Reconstruct all the public instance variables of this `URLPath` from its underlying `_URL`.
Method	_mod	Return a modified copy of `self` using `newURL`, keeping the query string if `keepQuery` is `True`.

scheme =

The scheme of the URL (e.g. 'http'). (type: bytes)

netloc =

The network location ("host"). (type: bytes)

path =

The path on the network location. (type: bytes)

query =

The query argument (the portion after ? in the URL). (type: bytes)

fragment =

The page fragment (the portion after # in the URL). (type: bytes)

def __init__(self, scheme='', netloc='localhost', path='', query='', fragment=''): (source)

Undocumented

def _reconstitute(self): (source)

Reconstitute this URLPath from all its given attributes.

@classmethod
def _fromURL(cls, urlInstance): (source)

Reconstruct all the public instance variables of this URLPath from its underlying _URL.

Parameters	urlInstance	the object to base this `URLPath` on. (type: `_URL`)
Returns	a new `URLPath`

def pathList(self, unquote=False, copy=True): (source)

Split this URL's path into its components.

Parameters	unquote	whether to remove %-encoding from the returned strings.
	copy	(ignored, do not use)
Returns	The components of `self.path` (type: `list` of `bytes`)

@classmethod
def fromString(klass, url): (source)

Make a URLPath from a str or unicode.

Parameters	url	A `str` representation of a URL. (type: `str` or `unicode`.)
Returns	a new `URLPath` derived from the given string. (type: `URLPath`)

@classmethod
def fromBytes(klass, url): (source)

Make a URLPath from a bytes.

Parameters	url	A `bytes` representation of a URL. (type: `bytes`)
Returns	a new `URLPath` derived from the given `bytes`. (type: `URLPath`)
Present Since	15.4

@classmethod
def fromRequest(klass, request): (source)

Make a URLPath from a twisted.web.http.Request.

Parameters	request	A `twisted.web.http.Request` to make the `URLPath` from.
Returns	a new `URLPath` derived from the given request. (type: `URLPath`)

def _mod(self, newURL, keepQuery): (source)

Return a modified copy of self using newURL, keeping the query string if keepQuery is True.

Parameters	newURL	a `URL` to derive a new `URLPath` from (type: `URL`)
	keepQuery	if `True`, preserve the query parameters from `self` on the new `URLPath`; if `False`, give the new `URLPath` no query parameters. (type: `bool`)
Returns	a new `URLPath`

def sibling(self, path, keepQuery=False): (source)

Get the sibling of the current URLPath. A sibling is a file which is in the same directory as the current file.

Parameters	path	The path of the sibling. (type: `bytes`)
	keepQuery	Whether to keep the query parameters on the returned `URLPath`.
Returns	a new `URLPath`

def child(self, path, keepQuery=False): (source)

Get the child of this URLPath.

Parameters	path	The path of the child. (type: `bytes`)
	keepQuery	Whether to keep the query parameters on the returned `URLPath`.
Returns	a new `URLPath`

def parent(self, keepQuery=False): (source)

Get the parent directory of this URLPath.

Parameters	keepQuery	Whether to keep the query parameters on the returned `URLPath`.
Returns	a new `URLPath`

def here(self, keepQuery=False): (source)

Get the current directory of this URLPath.

Parameters	keepQuery	Whether to keep the query parameters on the returned `URLPath`.
Returns	a new `URLPath`

def click(self, st): (source)

Return a path which is the URL where a browser would presumably take you if you clicked on a link with an HREF as given.

Parameters	st	A relative URL, to be interpreted relative to `self` as the base URL. (type: `bytes`)
Returns	a new `URLPath`

def __str__(self): (source)

The str of a URLPath is its URL text.

def __repr__(self): (source)

The repr of a URLPath is an eval-able expression which will construct a similar URLPath.

API Documentation for Twisted, generated by pydoctor at 2016-04-04 15:02:49.

twisted.python.urlpath.URLPath(object) class documentation

`twisted.python.urlpath.URLPath(object)` class documentation