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.
params Any parameters included in the URI.
path The path component of the URI.
query Any query strings included in the URI.
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.

params

Any parameters included in the URI.

path

The path component of the URI.

query

Any query strings included in the URI.

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.