ButlerURI

class lsst.daf.butler.ButlerURI(uri, root=None, forceAbsolute=True)

Bases: object

Convenience wrapper around URI parsers.

Provides access to URI components and can convert file paths into absolute path URIs. Scheme-less URIs are treated as if they are local file system paths and are converted to absolute URIs.

Parameters:

uri : str or urllib.parse.ParseResult

URI in string form. Can be scheme-less if referring to a local filesystem path.

root : str, optional

When fixing up a relative path in a file scheme or if scheme-less, use this as the root. Must be absolute. If None the current working directory will be used.

forceAbsolute : bool, optional

If True, scheme-less relative URI will be converted to an absolute path using a file scheme. If False scheme-less URI will remain scheme-less and will not be updated to file or absolute path.

Attributes Summary

fragment	The fragment component of the URI.
netloc	The URI network location.
ospath	Path component of the URI localized to current OS.
params	Any parameters included in the URI.
path	The path component of the URI.
query	Any query strings included in the URI.
relativeToPathRoot	Returns path relative to network location.
scheme	The URI scheme (:// is not part of the scheme).

Methods Summary

geturl()	Return the URI in string form.
replace(**kwargs)	Replace components in a URI with new values and return a new instance.
updateFile(newfile)	Update in place the final component of the path with the supplied file name.

Attributes Documentation

fragment

The fragment component of the URI.

netloc

The URI network location.

ospath

Path component of the URI localized to current OS.

params

Any parameters included in the URI.

path

The path component of the URI.

query

Any query strings included in the URI.

relativeToPathRoot

Returns path relative to network location.

Effectively, this is the path property with posix separator stripped from the left hand side of the path.

scheme

The URI scheme (:// is not part of the scheme).

Methods Documentation

geturl()

Return the URI in string form.

Returns:

url : str

String form of URI.

replace(**kwargs)

Replace components in a URI with new values and return a new instance.

Returns:

new : ButlerURI

New ButlerURI object with updated values.

updateFile(newfile)

Update in place the final component of the path with the supplied file name.

Parameters:

newfile : str

File name with no path component.

Notes

Updates the URI in place.