dandi.misctypes

Added in version 0.36.0.

Miscellaneous public classes

class dandi.misctypes.BasePath(parts: tuple[str, ...])[source]

An abstract base class for path-like objects that can be traversed with the / operator à la pathlib.Path (though, unlike pathlib.Path instances, “dividing” by another non-string path is not allowed). All paths are treated as forward-slash-separated relative paths under an empty-name “root” path.

abstract exists() bool[source]

True iff the resource at the given path exists

abstract is_dir() bool[source]

True if the resource at the given path exists and is a directory

abstract is_file() bool[source]

True if the resource at the given path exists and is a file

is_root() bool[source]

Returns true if this path object represents the root of its hierarchy

abstract iterdir() Iterator[P][source]

Returns a generator of the paths under the instance, which must be a directory

joinpath(*paths: str) P[source]

Combine the path with each name or relative path in paths using the / operator

match(pattern: str) bool[source]

Tests whether the path matches the given glob pattern

property name: str

The basename of the path object. When the object represents the root of a path hierarchy, this is the empty string.

abstract property parent: P

The parent path of the object. The parent of the root of a path hierarchy is itself.

property parents: tuple[P, ...]

A tuple of the path’s ancestors, starting at the parent and going up to (and including) the root of the hierarchy

parts: tuple[str, ...]

The path components of the object

property root_path: P

The root of the path object’s hierarchy

abstract property size: int

The size of the resource at the path

property stem: str

The basename without its final file extension, if any

property suffix: str

The final file extension of the basename, if any

property suffixes: list[str]

A list of the basename’s file extensions

with_name(name: str) P[source]

Equivalent to p.parent / name

with_stem(stem: str) P[source]

Returns a new path with the stem changed

with_suffix(suffix: str) P[source]

Returns a new path with the final file extension changed

dandi.misctypes.DUMMY_DANDI_ETAG = Digest(algorithm=<DigestType.dandi_etag: 'dandi:dandi-etag'>, value='dddddddddddddddddddddddddddddddd-1')

Placeholder digest used in some situations where a digest is required but not actually relevant and would be too expensive to calculate

class dandi.misctypes.Digest(algorithm: DigestType, value: str)[source]

A computed digest for a file or directory

algorithm: DigestType

The digest algorithm used

asdict() dict[DigestType, str][source]

Convert the instance to a single-item dict mapping the digest algorithm to the digest value

classmethod dandi_etag(value: str) Digest[source]

Construct a Digest with the given value and a algorithm of DigestType.dandi_etag

classmethod dandi_zarr(value: str) Digest[source]

Construct a Digest with the given value and a algorithm of DigestType.dandi_zarr_checksum

value: str

The digest itself

class dandi.misctypes.LocalReadableFile(filepath: str | Path)[source]

A concrete implementation of Readable for local files.

Instances of this class are obtained by calling LocalFileAsset.as_readable() or DandisetMetadataFile.as_readable().

filepath

The path to a local file to read

get_filename() str[source]

Returns the base name of the resource, suitable for use as a file name

get_mtime() datetime[source]

Returns the time at which the resource’s contents were last modified, if it can be determined

get_size() int[source]

Returns the size in bytes of the resource

open() IO[bytes][source]

Returns a readable binary filehandle for accessing the resource’s bytes

class dandi.misctypes.Readable[source]

Added in version 0.50.0.

An abstract base class representing a local or remote resource that can be opened & read like a file

abstract get_filename() str[source]

Returns the base name of the resource, suitable for use as a file name

abstract get_mtime() datetime | None[source]

Returns the time at which the resource’s contents were last modified, if it can be determined

abstract get_size() int[source]

Returns the size in bytes of the resource

abstract open() IO[bytes][source]

Returns a readable binary filehandle for accessing the resource’s bytes

class dandi.misctypes.RemoteReadableAsset(url: str, size: int, mtime: datetime | None, name: str)[source]

A concrete implementation of Readable for DANDI blob assets on a remote server. The fsspec library must be installed with the http extra (e.g., pip install "fsspec[http]") in order for open() to be usable.

Instances of this class are obtained by calling BaseRemoteBlobAsset.as_readable().

get_filename() str[source]

Returns the base name of the resource, suitable for use as a file name

get_mtime() datetime | None[source]

Returns the time at which the resource’s contents were last modified, if it can be determined

get_size() int[source]

Returns the size in bytes of the resource

open() IO[bytes][source]

Returns a readable binary filehandle for accessing the resource’s bytes

url: str

The URL that data is read from