Debian Codegraph @

scripts/generate_manifest.py

raw
1 """
2 Script that creates initial transform manifests from the version_map
3 files in the asdf-standard repo. This file can be removed once
4 the format of the manifest files has been finalized.
5 """
6 import argparse
7
8 import asdf
9 import yaml
10
11
12 def parse_args():
13 parser = argparse.ArgumentParser()
14 parser.add_argument("version_map_path")
15 parser.add_argument("output_path")
16 return parser.parse_args()
17
18
19 class MultilineString(str):
20 pass
21
22
23 def represent_multiline_string(dumper, data):
24 return dumper.represent_scalar("tag:yaml.org,2002:str", data, style="|")
25
26
27 yaml.add_representer(MultilineString, represent_multiline_string)
28
29 args = parse_args()
30
31 asdf_standard_version = args.version_map_path.split("/")[-1].rsplit(".", 1)[0].split("-")[-1]
32
33 with open(args.version_map_path) as f:
34 version_map = yaml.safe_load(f.read())
35
36 manifest = {}
37
38 manifest["id"] = f"http://stsci.edu/asdf/extensions/transform/manifests/transform-{asdf_standard_version}"
39 manifest["extension_uri"] = f"http://stsci.edu/asdf/extensions/transform-{asdf_standard_version}"
40 manifest["title"] = f"Transform extension {asdf_standard_version}"
41 manifest["description"] = MultilineString("A set of tags for serializing data transforms.")
42 manifest["tags"] = []
43
44 for tag_base, tag_version in version_map["tags"].items():
45 if tag_base.startswith("tag:stsci.edu:asdf/transform/"):
46 tag_uri = f"{tag_base}-{tag_version}"
47 schema_uri = tag_uri.replace("tag:stsci.edu:asdf/transform/", "http://stsci.edu/schemas/asdf/transform/")
48 schema = asdf.schema.load_schema(schema_uri)
49 manifest["tags"].append(
50 {
51 "tag_uri": tag_uri,
52 "schema_uri": schema_uri,
53 "title": schema["title"].strip(),
54 "description": MultilineString(schema["description"].strip()),
55 }
56 )
57
58 with open(args.output_path, "w") as f:
59 yaml.dump(manifest, f, sort_keys=False)