LocationFactory

class lsst.daf.butler.LocationFactory(datastoreRoot: Union[str, urllib.parse.ParseResult, ResourcePath, pathlib.Path])

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, urllib.parse.ParseResult, …)

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, urllib.parse.ParseResult, ResourcePath, pathlib.Path]) → lsst.daf.butler.core.location.Location

Create a Location from a POSIX path.

Parameters:

path : str or lsst.resources.ResourcePath

A standard POSIX path, relative to the Datastore root. If it is a lsst.resources.ResourcePath it must not be absolute.

Returns:

location : Location

The equivalent Location.