geometamaker package

Submodules

• geometamaker.cli module
• geometamaker.config module
• geometamaker.geometamaker module
• geometamaker.models module
• geometamaker.utils module

Module contents

class geometamaker.Config(config_path=None)

Bases: object

Encapsulates user-settings such as a metadata Profile.

Load a Profile from a config file.

Use a default user profile if none given.

Parameters:

config_path (str) – path to a local yaml file

delete()

Delete the config file.

save(profile)

Save a Profile to a local config file.

Parameters:

profile (geometamaker.models.Profile)

pydantic model geometamaker.Profile

Bases: BaseMetadata

Class for a metadata profile.

A Profile can store metadata properties that are likely to apply to more than one resource, such as contact and license.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

classmethod load(filepath)

Load metadata document from a yaml file.

Parameters:

filepath (str) – path to yaml file

Returns:

instance of the class

write(target_path)

Write profile data to a yaml file.

Parameters:

target_path (str) – path to a yaml file to be written

geometamaker.describe(source_dataset_path, compute_stats=False)

Create a metadata resource instance with properties of the dataset.

Properties of the dataset are used to populate as many metadata properties as possible. Default/placeholder values are used for properties that require user input.

Parameters:

• source_dataset_path (string) – path or URL to dataset to which the metadata applies

• compute_stats (bool) – whether to compute statistics for each band in a raster.

Returns:

a metadata object

Return type:

geometamaker.models.Resource

Raises:

• ValueError if the file type or protocol of the dataset is not supported. –

• FileNotFoundError if the path does not exist. –

geometamaker.describe_collection(directory, depth=32767, exclude_regex=None, exclude_hidden=True, describe_files=False, backup=True, target_filename=None, **kwargs)

Create a single metadata document to describe a collection of files.

Describe all the files within a directory as members of a “collection”. The resulting metadata resource should include a list of all the files included in the collection along with a description and metadata filepath (or placeholder). Optionally create individual metadata files for each supported file in a directory.

Parameters:

• directory (str) – path to collection

• depth (int, optional) – maximum number of subdirectory levels to traverse when walking through directory to find files included in the collection. A value of 1 limits the walk to files in the top-level directory only. A value of 2 allows descending into immediate subdirectories, etc. All files in all subdirectories in the collection will be included by default.

• exclude_regex (str, optional) – a regular expression to pattern-match any files you do not want included in the output metadata yml.

• exclude_hidden (bool, default True) – whether to exclude hidden files (files that start with “.”).

• describe_files (bool, default False) – whether to describe all files, i.e., create individual metadata files for each supported resource in the collection.

• backup (bool) – whether to write a backup of a pre-existing metadata file before ovewriting it in cases where that file is not a valid geometamaker document.

• kwargs (dict) – optional keyward arguments accepted by describe.

Returns:

Collection metadata

geometamaker.validate(filepath)

Validate a YAML metadata document.

Validation includes type-checking of property values and checking for the presence of required properties.

Parameters:

directory (string) – path to a YAML file

Returns:

pydantic.ValidationError

Raises:

ValueError if the YAML document is not a geometamaker metadata doc. –

geometamaker.validate_dir(directory, depth=32767)

Validate all compatible yml documents in the directory.

Parameters:

• directory (string) – path to a directory

• depth (int) – maximum number of subdirectory levels to traverse when walking through directory.

Returns:

a list of the filepaths that were validated and

an equal-length list of the validation messages.

Return type:

tuple (list, list)