LocationFactory

class lsst.daf.butler.LocationFactory(datastoreRoot: Union[lsst.resources._resourcePath.ResourcePath, str])

Bases: object

Factory for Location instances.

The factory is constructed from the root location of the datastore. This location can be a path on the file system (absolute or relative) or as a URI.

Parameters:
datastoreRoot : str

Root location of the Datastore either as a path in the local filesystem or as a URI. File scheme URIs can be used. If a local filesystem path is used without URI scheme, it will be converted to an absolute path and any home directory indicators expanded. If a file scheme is used with a relative path, the path will be treated as a posixpath but then converted to an absolute path.

Attributes Summary

netloc Return the network location of root location of the Datastore.

Methods Summary

fromPath(path, …) Create a Location from a POSIX path.

Attributes Documentation

netloc

Return the network location of root location of the Datastore.

Methods Documentation

fromPath(path: Union[str, lsst.resources._resourcePath.ResourcePath]) → lsst.daf.butler.core.location.Location

Create a Location from a POSIX path.

Parameters:
path : str or ButlerURI

A standard POSIX path, relative to the Datastore root. If it is a ButlerURI it must not be absolute.
Returns:
location : Location

The equivalent Location.