Location

class lsst.daf.butler.Location(datastoreRootUri, path)

Bases: object

Identifies a location within the Datastore.

Parameters:
datastoreRootUri : ButlerURI or str

Base URI for this datastore, must include an absolute path.

path : str

Relative path within datastore. Assumed to be using the local path separator if a file scheme is being used for the URI, else a POSIX separator.

Attributes Summary

path Path corresponding to location.
pathInStore Path corresponding to location relative to Datastore root.
uri URI string corresponding to fully-specified location in datastore.

Methods Summary

updateExtension(ext) Update the file extension associated with this Location.

Attributes Documentation

path

Path corresponding to location.

This path includes the root of the Datastore, but does not include non-path components of the root URI. If a file URI scheme is being used the path will be returned with the local OS path separator.

pathInStore

Path corresponding to location relative to Datastore root.

Uses the same path separator as supplied to the object constructor.

uri

URI string corresponding to fully-specified location in datastore.

Methods Documentation

updateExtension(ext)

Update the file extension associated with this Location.

Parameters:
ext : str

New extension. If an empty string is given any extension will be removed. If None is given there will be no change.