asdf-format__asdf-1853

{
  "status": "ok",
  "stdout": "asdf/_core/_converters/reference.py:22:    def select_tag(self, obj, tags, ctx):\nasdf/extension/_converter.py:7:import warnings\nasdf/extension/_converter.py:20:    The ``select_tag`` method is optional.\nasdf/extension/_converter.py:22:    If implemented, ``select_tag`` should accept 3 parameters\nasdf/extension/_converter.py:108:            select_tag method.\nasdf/extension/_converter.py:171:        # and a warning will be emitted, but it won't crash the program.\nasdf/extension/_converter.py:181:        if len(relevant_tags) > 1 and not hasattr(delegate, \"select_tag\"):\nasdf/extension/_converter.py:185:                # prior to asdf 3.0 Converter provided a default select_tag\nasdf/extension/_converter.py:187:                # to be registered with >1 tag but produce a warning\nasdf/extension/_converter.py:190:                    \"but does not implement a select_tag method. \"\nasdf/extension/_converter.py:192:                    \"the now removed select_tag. This will be an error in a future \"\nasdf/extension/_converter.py:195:                warnings.warn(msg, AsdfWarning)\nasdf/extension/_converter.py:197:                msg = \"Converter handles multiple tags for this extension, but does not implement a select_tag method.\"\nasdf/extension/_converter.py:204:        if not len(self._tags) and not hasattr(delegate, \"select_tag\"):\nasdf/extension/_converter.py:250:    def select_tag(self, obj, ctx):\nasdf/extension/_converter.py:266:        method = getattr(self._delegate, \"select_tag\", None)\nasdf/yamlutil.py:248:        tag = converter.select_tag(obj, _serialization_context)\nasdf/yamlutil.py:249:        # if select_tag returns None, converter.to_yaml_tree should return a new\nasdf/yamlutil.py:264:            tag = converter.select_tag(obj, _serialization_context)\n",
  "stderr": "",
  "exit_code": 0
}

{
  "status": "ok",
  "filepath": "asdf/extension/_converter.py",
  "content": "        # and not in the middle of the user's session.  The extension will fail to load\n        # and a warning will be emitted, but it won't crash the program.\n\n        relevant_tags = set()\n        for tag in delegate.tags:\n            if isinstance(tag, str):\n                relevant_tags.update(t.tag_uri for t in extension.tags if uri_match(tag, t.tag_uri))\n            else:\n                msg = \"Converter property 'tags' must contain str values\"\n                raise TypeError(msg)\n\n        if len(relevant_tags) > 1 and not hasattr(delegate, \"select_tag\"):\n            # we cannot use isinstance here because Converter supports\n            # virtual subclasses\n            if Converter in delegate.__class__.__mro__:\n                # prior to asdf 3.0 Converter provided a default select_tag\n                # to provide backwards compatibility allow Converter subclasses\n                # to be registered with >1 tag but produce a warning\n                msg = (\n                    \"Converter handles multiple tags for this extension, \"\n                    \"but does not implement a select_tag method. \"\n                    \"This previously worked because Converter subclasses inherited \"\n                    \"the now removed select_tag. This will be an error in a future \"\n                    \"version of asdf\"\n                )\n                warnings.warn(msg, AsdfWarning)\n            else:\n                msg = \"Converter handles multiple tags for this extension, but does not implement a select_tag method.\"\n                raise RuntimeError(msg)\n\n        self._tags = sorted(relevant_tags)\n\n        self._types = []\n\n        if not len(self._tags) and not hasattr(delegate, \"select_tag\"):\n            # this converter supports no tags so don't inspect the types\n            return\n\n        for typ in delegate.types:\n            if isinstance(typ, (str, type)):\n                self._types.append(typ)",
  "start_line": 170,
  "end_line": 210,
  "total_lines": 385,
  "is_truncated": false
}

{
  "status": "ok",
  "filepath": "asdf/exceptions.py",
  "content": "from yaml.representer import RepresenterError\n\nfrom asdf._jsonschema import ValidationError\n\n__all__ = [\n    \"AsdfConversionWarning\",\n    \"AsdfDeprecationWarning\",\n    \"AsdfLazyReferenceError\",\n    \"AsdfManifestURIMismatchWarning\",\n    \"AsdfPackageVersionWarning\",\n    \"AsdfProvisionalAPIWarning\",\n    \"AsdfSerializationError\",\n    \"AsdfWarning\",\n    \"DelimiterNotFoundError\",\n    \"ValidationError\",\n]\n\n\nclass AsdfWarning(Warning):\n    \"\"\"\n    The base warning class from which all ASDF warnings should inherit.\n    \"\"\"\n\n\nclass AsdfDeprecationWarning(AsdfWarning, DeprecationWarning):\n    \"\"\"\n    A warning class to indicate a deprecated feature.\n    \"\"\"\n\n\nclass AsdfConversionWarning(AsdfWarning):\n    \"\"\"\n    Warning class used for failures to convert data into custom types.\n    \"\"\"\n\n\nclass AsdfBlockIndexWarning(AsdfWarning):\n    \"\"\"\n    Warning class to indicate that a file was read with an invalid block index\n    \"\"\"\n\n\nclass DelimiterNotFoundError(ValueError):\n    \"\"\"\n    Indicates that a delimiter was not found when reading or\n    seeking through a file.\n    \"\"\"\n\n\nclass AsdfProvisionalAPIWarning(AsdfWarning, FutureWarning):\n    \"\"\"\n    Used for provisional features where breaking API changes might be\n    introduced at any point (including minor releases). These features\n    are likely to be added in a future ASDF version. However, Use of\n    provisional features is highly discouraged for production code.\n    \"\"\"\n\n\nclass AsdfPackageVersionWarning(AsdfWarning):\n    \"\"\"\n    A warning indicating a package version mismatch\n    \"\"\"\n\n\nclass AsdfManifestURIMismatchWarning(AsdfWarning):\n    \"\"\"\n    A warning indicaing that an extension registered with a manifest\n    contains a id that does not match the uri of the manifest.\n    \"\"\"\n\n\nclass AsdfLazyReferenceError(ReferenceError):\n    \"\"\"\n    Indicates that the lazy tree node failed to resolve a reference\n    to an AsdfFile instance. This likely means the AsdfFile was garbage\n    collected and you may need to update your code to keep the AsdfFile\n    in memory (by keeping a reference).\n    \"\"\"\n\n\nclass AsdfSerializationError(RepresenterError):\n    \"\"\"\n    An object failed serialization by asdf and by yaml. This likely indicates\n    that the object does not have a supporting asdf Converter and needs to\n    be manually converted to a supported type.\n    \"\"\"",
  "start_line": 1,
  "end_line": 86,
  "total_lines": 86,
  "is_truncated": false
}

{
  "status": "ok",
  "filepath": "asdf/extension/_converter.py",
  "content": "\"\"\"\nSupport for Converter, the new API for serializing custom\ntypes.  Will eventually replace the `asdf.types` module.\n\"\"\"\n\nimport abc\nimport warnings\n\nfrom asdf.exceptions import AsdfWarning\nfrom asdf.util import get_class_name, uri_match\n\n\nclass Converter(abc.ABC):\n    \"\"\"\n    Abstract base class for plugins that convert nodes from the\n    parsed YAML tree into custom objects, and vice versa.\n\n    Implementing classes must provide the `tags` and `types`\n    properties and `to_yaml_tree` and `from_yaml_tree` methods.\n    The ``select_tag`` method is optional.\n\n    If implemented, ``select_tag`` should accept 3 parameters\n\n        obj : object\n            Instance of the custom type being converted.  Guaranteed\n            to be an instance of one of the types listed in the\n            `types` property.\n        tags : list of str\n            List of active tags to choose from.  Guaranteed to match\n            one of the tag patterns listed in the 'tags' property.\n        ctx : asdf.asdf.SerializationContext\n            Context of the current serialization request.\n\n    and return a str, the selected tag (should be one of tags) or\n    `None` which will trigger the result of ``to_yaml_tree`` to be\n    used to look up the next converter for this object.\n\n    The ``lazy`` attribute is optional. If ``True`` asdf will\n    pass \"lazy\" objects to the converter. If ``False`` (or not\n    defined) asdf will convert all child objects before calling\n    `from_yaml_tree`.\n    \"\"\"\n\n    @classmethod\n    def __subclasshook__(cls, class_):\n        if cls is Converter:\n            return (\n                hasattr(class_, \"tags\")\n                and hasattr(class_, \"types\")\n                and hasattr(class_, \"to_yaml_tree\")\n                and hasattr(class_, \"from_yaml_tree\")\n            )\n        return NotImplemented  # pragma: no cover\n\n    @property\n    @abc.abstractmethod\n    def tags(self):\n        \"\"\"\n        Get the YAML tags that this converter is capable of\n        handling.  URI patterns are permitted, see\n        `asdf.util.uri_match` for details.\n\n        Returns\n        -------\n        iterable of str\n            Tag URIs or URI patterns.\n        \"\"\"\n\n    @property\n    @abc.abstractmethod",
  "start_line": 1,
  "end_line": 70,
  "total_lines": 385,
  "is_truncated": false
}

{
  "status": "ok",
  "filepath": "asdf/extension/_converter.py",
  "content": "            or a generator that yields such an instance.\n        \"\"\"\n\n\nclass ConverterProxy(Converter):\n    \"\"\"\n    Proxy that wraps a `Converter` and provides default\n    implementations of optional methods.\n    \"\"\"\n\n    def __init__(self, delegate, extension):\n        if not isinstance(delegate, Converter):\n            msg = \"Converter must implement the asdf.extension.Converter interface\"\n            raise TypeError(msg)\n\n        self._delegate = delegate\n        self._extension = extension\n        self._class_name = get_class_name(delegate)\n\n        # Sort these out up-front so that errors are raised when the extension is loaded\n        # and not in the middle of the user's session.  The extension will fail to load\n        # and a warning will be emitted, but it won't crash the program.\n\n        relevant_tags = set()\n        for tag in delegate.tags:\n            if isinstance(tag, str):\n                relevant_tags.update(t.tag_uri for t in extension.tags if uri_match(tag, t.tag_uri))\n            else:\n                msg = \"Converter property 'tags' must contain str values\"\n                raise TypeError(msg)\n",
  "start_line": 150,
  "end_line": 180,
  "total_lines": 385,
  "is_truncated": false
}

{
  "status": "error",
  "error_type": "CommandError",
  "error_message": "Traceback (most recent call last):\n  File \"<stdin>\", line 1, in <module>\n  File \"/workspace/asdf/__init__.py\", line 20, in <module>\n    from ._asdf import AsdfFile\n  File \"/workspace/asdf/_asdf.py\", line 12, in <module>\n    from . import _compression as mcompression\n  File \"/workspace/asdf/_compression.py\", line 8, in <module>\n    from .config import get_config\n  File \"/workspace/asdf/config.py\", line 11, in <module>\n    from . import _entry_points, util, versioning\n  File \"/workspace/asdf/_entry_points.py\", line 5, in <module>\n    from .extension import ExtensionProxy\n  File \"/workspace/asdf/extension/__init__.py\", line 11, in <module>\n    from ._serialization_context import SerializationContext\n  File \"/workspace/asdf/extension/_serialization_context.py\", line 4, in <module>\n    from asdf._helpers import validate_version\n  File \"/workspace/asdf/_helpers.py\", line 2, in <module>\n    from ._version import version as asdf_package_version\nModuleNotFoundError: No module named 'asdf._version'\n",
  "details": {
    "stdout": "",
    "stderr": "Traceback (most recent call last):\n  File \"<stdin>\", line 1, in <module>\n  File \"/workspace/asdf/__init__.py\", line 20, in <module>\n    from ._asdf import AsdfFile\n  File \"/workspace/asdf/_asdf.py\", line 12, in <module>\n    from . import _compression as mcompression\n  File \"/workspace/asdf/_compression.py\", line 8, in <module>\n    from .config import get_config\n  File \"/workspace/asdf/config.py\", line 11, in <module>\n    from . import _entry_points, util, versioning\n  File \"/workspace/asdf/_entry_points.py\", line 5, in <module>\n    from .extension import ExtensionProxy\n  File \"/workspace/asdf/extension/__init__.py\", line 11, in <module>\n    from ._serialization_context import SerializationContext\n  File \"/workspace/asdf/extension/_serialization_context.py\", line 4, in <module>\n    from asdf._helpers import validate_version\n  File \"/workspace/asdf/_helpers.py\", line 2, in <module>\n    from ._version import version as asdf_package_version\nModuleNotFoundError: No module named 'asdf._version'\n",
    "exit_code": 1
  }
}

{
  "status": "ok",
  "filepath": "asdf/util.py",
  "content": "import enum\nimport importlib.util\nimport inspect\nimport math\nimport re\nimport struct\nimport sys\nimport types\nimport warnings\nfrom functools import lru_cache\nfrom importlib import metadata\nfrom urllib.request import pathname2url\n\nimport numpy as np\nimport yaml\nfrom packaging.version import Version\n\nfrom . import constants, exceptions\n\n# The standard library importlib.metadata returns duplicate entrypoints\n# for all python versions up to and including 3.11\n# https://github.com/python/importlib_metadata/issues/410#issuecomment-1304258228\n# see PR https://github.com/asdf-format/asdf/pull/1260\n# see issue https://github.com/asdf-format/asdf/issues/1254\nif sys.version_info >= (3, 12):\n    from importlib.metadata import packages_distributions\nelse:\n    from importlib_metadata import packages_distributions\n\n\n# We're importing our own copy of urllib.parse because\n# we need to patch it to support asdf:// URIs, but it'd\n# be irresponsible to do this for all users of a\n# standard library.\nurllib_parse_spec = importlib.util.find_spec(\"urllib.parse\")\n_patched_urllib_parse = importlib.util.module_from_spec(urllib_parse_spec)\nurllib_parse_spec.loader.exec_module(_patched_urllib_parse)\ndel urllib_parse_spec\n\n# urllib.parse needs to know that it should treat asdf://\n# URIs like http:// URIs for the purposes of joining\n# a relative path to a base URI.\n_patched_urllib_parse.uses_relative.append(\"asdf\")\n_patched_urllib_parse.uses_netloc.append(\"asdf\")\n\n\n__all__ = [\n    \"load_yaml\",\n    \"human_list\",\n    \"get_array_base\",\n    \"get_base_uri\",\n    \"filepath_to_url\",\n    \"iter_subclasses\",\n    \"calculate_padding\",\n    \"resolve_name\",\n    \"NotSet\",\n    \"is_primitive\",\n    \"uri_match\",\n    \"get_class_name\",\n    \"get_file_type\",\n    \"FileType\",\n]\n\n\ndef load_yaml(init, tagged=False):\n    \"\"\"\n    Load just the yaml portion of an ASDF file\n\n    Parameters\n    ----------\n\n    init : filename or file-like\n        If file-like this must be opened in binary mode.\n\n    tagged: bool, optional\n        Return tree with instances of `asdf.tagged.Tagged` this\n        can be helpful if the yaml tags are of interest.\n        If False, the tree will only contain basic python types\n        (see the pyyaml ``BaseLoader`` documentation).\n\n    Returns\n    -------\n\n    tree : dict\n        Dictionary representing the ASDF tree\n    \"\"\"\n\n    from .generic_io import get_file\n    from .yamlutil import AsdfLoader, _IgnoreCustomTagsLoader\n\n    if tagged:\n        loader = AsdfLoader\n    else:\n        loader = _IgnoreCustomTagsLoader\n\n    with get_file(init, \"r\") as gf:\n        reader = gf.reader_until(\n            constants.YAML_END_MARKER_REGEX,\n            7,\n            \"End of YAML marker\",\n            include=True,\n        )\n        # The following call to yaml.load is safe because we're\n        # using only loaders that don't create custom python objects\n        content = yaml.load(reader, Loader=loader)  # noqa: S506\n    return content\n\n\ndef human_list(line, separator=\"and\"):\n    \"\"\"\n    Formats a list for human readability.\n\n    Parameters\n    ----------\n    l : sequence\n        A sequence of strings\n\n    separator : string, optional\n        The word to use between the last two entries.  Default:\n        ``\"and\"``.\n\n    Returns\n    -------\n    formatted_list : string\n\n    Examples\n    --------\n    >>> human_list([\"vanilla\", \"strawberry\", \"chocolate\"], \"or\")  # doctest: +SKIP\n    'vanilla, strawberry or chocolate'\n    \"\"\"\n    warnings.warn(\"asdf.util.human_list is deprecated\", exceptions.AsdfDeprecationWarning)\n    if len(line) == 1:\n        return line[0]\n\n    return \", \".join(line[:-1]) + \" \" + separator + \" \" + line[-1]\n\n\ndef get_array_base(arr):\n    \"\"\"\n    For a given Numpy array, finds the base array that \"owns\" the\n    actual data.\n    \"\"\"\n    from .tags.core import ndarray\n\n    base = arr\n    while isinstance(base.base, (np.ndarray, ndarray.NDArrayType)):\n        base = base.base\n    return base\n\n",
  "start_line": 1,
  "end_line": 150,
  "total_lines": 600,
  "is_truncated": true
}

{
  "status": "ok",
  "stdout": "",
  "stderr": "",
  "exit_code": 0
}

{
  "status": "error",
  "error_type": "CommandError",
  "error_message": "Traceback (most recent call last):\n  File \"<stdin>\", line 6, in <module>\nImportError: cannot import name 'Tag' from 'asdf.extension._tag' (/workspace/asdf/extension/_tag.py)\n",
  "details": {
    "stdout": "",
    "stderr": "Traceback (most recent call last):\n  File \"<stdin>\", line 6, in <module>\nImportError: cannot import name 'Tag' from 'asdf.extension._tag' (/workspace/asdf/extension/_tag.py)\n",
    "exit_code": 1
  }
}

{
  "status": "ok",
  "filepath": "asdf/extension/_tag.py",
  "content": "class TagDefinition:\n    \"\"\"\n    Container for properties of a custom YAML tag.\n\n    Parameters\n    ----------\n    tag_uri : str\n        Tag URI.\n    schema_uris : str, optional\n        URI of the schema that should be used to validate objects\n        with this tag.\n    title : str, optional\n        Short description of the tag.\n    description : str, optional\n        Long description of the tag.\n    \"\"\"\n\n    def __init__(self, tag_uri, *, schema_uris=None, title=None, description=None):\n        if \"*\" in tag_uri:\n            msg = \"URI patterns are not permitted in TagDefinition\"\n            raise ValueError(msg)\n\n        self._tag_uri = tag_uri\n\n        if schema_uris is None:\n            self._schema_uris = []\n\n        elif isinstance(schema_uris, list):\n            self._schema_uris = schema_uris\n\n        else:\n            self._schema_uris = [schema_uris]\n\n        self._title = title\n        self._description = description\n\n    @property\n    def tag_uri(self):\n        \"\"\"\n        Get the tag URI.\n\n        Returns\n        -------\n        str\n        \"\"\"\n        return self._tag_uri\n\n    @property\n    def schema_uris(self):\n        \"\"\"\n        Get the URIs of the schemas that should be used to validate\n        objects with this tag.\n\n        Returns\n        -------\n        list\n        \"\"\"\n        return self._schema_uris\n\n    @property\n    def title(self):\n        \"\"\"\n        Get the short description of the tag.\n\n        Returns\n        -------\n        str or None\n        \"\"\"\n        return self._title\n\n    @property\n    def description(self):\n        \"\"\"\n        Get the long description of the tag.\n\n        Returns\n        -------\n        str or None\n        \"\"\"\n        return self._description\n\n    def __repr__(self):\n        return f\"<TagDefinition URI: {self.tag_uri}>\"",
  "start_line": 1,
  "end_line": 83,
  "total_lines": 83,
  "is_truncated": false
}

{
  "status": "error",
  "error_type": "CommandError",
  "error_message": "Traceback (most recent call last):\n  File \"<stdin>\", line 15, in <module>\nTypeError: Extension() takes no arguments\n",
  "details": {
    "stdout": "",
    "stderr": "Traceback (most recent call last):\n  File \"<stdin>\", line 15, in <module>\nTypeError: Extension() takes no arguments\n",
    "exit_code": 1
  }
}

{
  "status": "ok",
  "filepath": "asdf/extension/_extension.py",
  "content": "import abc\n\nfrom packaging.specifiers import SpecifierSet\n\nfrom asdf.util import get_class_name\n\nfrom ._compressor import Compressor\nfrom ._converter import ConverterProxy\nfrom ._tag import TagDefinition\nfrom ._validator import Validator\n\n\nclass Extension(abc.ABC):\n    \"\"\"\n    Abstract base class defining an extension to ASDF.\n\n    Implementing classes must provide the `extension_uri`.\n    Other properties are optional.\n    \"\"\"\n\n    @classmethod\n    def __subclasshook__(cls, class_):\n        if cls is Extension:\n            return hasattr(class_, \"extension_uri\")\n        return NotImplemented  # pragma: no cover\n\n    @property\n    @abc.abstractmethod\n    def extension_uri(self):\n        \"\"\"\n        Get the URI of the extension to the ASDF Standard implemented\n        by this class.  Note that this may not uniquely identify the\n        class itself.\n\n        Returns\n        -------\n        str\n        \"\"\"\n\n    @property\n    def legacy_class_names(self):\n        \"\"\"\n        Get the set of fully-qualified class names used by older\n        versions of this extension.  This allows a new-style\n        implementation of an extension to prevent warnings when a\n        legacy extension is missing.\n\n        Returns\n        -------\n        iterable of str\n        \"\"\"\n        return set()\n\n    @property\n    def asdf_standard_requirement(self):\n        \"\"\"\n        Get the ASDF Standard version requirement for this extension.\n\n        Returns\n        -------\n        str or None\n            If str, PEP 440 version specifier.\n            If None, support all versions.\n        \"\"\"\n        return\n\n    @property\n    def converters(self):\n        \"\"\"\n        Get the `asdf.extension.Converter` instances for tags\n        and Python types supported by this extension.\n\n        Returns\n        -------\n        iterable of asdf.extension.Converter\n        \"\"\"\n        return []\n\n    @property\n    def tags(self):\n        \"\"\"\n        Get the YAML tags supported by this extension.\n\n        Returns\n        -------\n        iterable of str or asdf.extension.TagDefinition\n        \"\"\"\n        return []\n\n    @property\n    def compressors(self):\n        \"\"\"\n        Get the `asdf.extension.Compressor` instances for\n        compression schemes supported by this extension.\n\n        Returns\n        -------\n        iterable of asdf.extension.Compressor\n        \"\"\"\n        return []\n\n    @property\n    def yaml_tag_handles(self):\n        \"\"\"\n        Get a dictionary of custom yaml TAG handles defined by the extension.\n\n        The dictionary key indicates the TAG handles to be placed in the YAML header,\n        the value defines the string for tag replacement.\n        See https://yaml.org/spec/1.1/#tag%20shorthand/\n\n        Example: ``{\"!foo!\": \"tag:nowhere.org:custom/\"}``\n\n        Returns\n        -------\n        dict\n\n        \"\"\"\n        return {}\n\n    @property\n    def validators(self):\n        \"\"\"\n        Get the `asdf.extension.Validator` instances for additional\n        schema properties supported by this extension.\n\n        Returns\n        -------\n        iterable of asdf.extension.Validator\n        \"\"\"\n        return []\n\n\nclass ExtensionProxy(Extension):\n    \"\"\"\n    Proxy that wraps an extension, provides default implementations\n    of optional methods, and carries additional information on the\n    package that provided the extension.\n    \"\"\"\n\n    @classmethod\n    def maybe_wrap(cls, delegate):\n        if isinstance(delegate, ExtensionProxy):\n            return delegate\n\n        return ExtensionProxy(delegate)\n\n    def __init__(self, delegate, package_name=None, package_version=None):\n        if not isinstance(delegate, Extension):\n            msg = \"Extension must implement the Extension interface\"\n            raise TypeError(msg)",
  "start_line": 1,
  "end_line": 150,
  "total_lines": 420,
  "is_truncated": true
}

{
  "status": "ok",
  "stdout": "Caught exception: AttributeError: 'list' object has no attribute 'warnings'\n",
  "stderr": "",
  "exit_code": 0
}

{
  "status": "ok",
  "stdout": "Finished without exception. Warnings: 1\nWarning: Converter handles multiple tags for this extension, but does not implement a select_tag method. This previously worked because Converter subclasses inherited the now removed select_tag. This will be an error in a future version of asdf\n",
  "stderr": "",
  "exit_code": 0
}

{
  "status": "ok",
  "stdout": "9:from asdf.exceptions import AsdfWarning\n195:                warnings.warn(msg, AsdfWarning)\n",
  "stderr": "",
  "exit_code": 0
}

{
  "status": "ok",
  "filepath": "asdf/extension/_converter.py",
  "content": "\n        if len(relevant_tags) > 1 and not hasattr(delegate, \"select_tag\"):\n            # we cannot use isinstance here because Converter supports\n            # virtual subclasses\n            if Converter in delegate.__class__.__mro__:\n                # prior to asdf 3.0 Converter provided a default select_tag\n                # to provide backwards compatibility allow Converter subclasses\n                # to be registered with >1 tag but produce a warning\n                msg = (\n                    \"Converter handles multiple tags for this extension, \"\n                    \"but does not implement a select_tag method. \"\n                    \"This previously worked because Converter subclasses inherited \"\n                    \"the now removed select_tag. This will be an error in a future \"\n                    \"version of asdf\"\n                )\n                warnings.warn(msg, AsdfWarning)\n            else:\n                msg = \"Converter handles multiple tags for this extension, but does not implement a select_tag method.\"\n                raise RuntimeError(msg)\n\n        self._tags = sorted(relevant_tags)\n\n        self._types = []\n\n        if not len(self._tags) and not hasattr(delegate, \"select_tag\"):\n            # this converter supports no tags so don't inspect the types\n            return\n\n        for typ in delegate.types:\n            if isinstance(typ, (str, type)):\n                self._types.append(typ)",
  "start_line": 180,
  "end_line": 210,
  "total_lines": 385,
  "is_truncated": false
}

{
  "status": "ok",
  "filepath": "asdf/extension/_converter.py",
  "content": "            or a generator that yields such an instance.\n        \"\"\"\n\n\nclass ConverterProxy(Converter):\n    \"\"\"\n    Proxy that wraps a `Converter` and provides default\n    implementations of optional methods.\n    \"\"\"\n\n    def __init__(self, delegate, extension):\n        if not isinstance(delegate, Converter):\n            msg = \"Converter must implement the asdf.extension.Converter interface\"\n            raise TypeError(msg)\n\n        self._delegate = delegate\n        self._extension = extension\n        self._class_name = get_class_name(delegate)\n\n        # Sort these out up-front so that errors are raised when the extension is loaded\n        # and not in the middle of the user's session.  The extension will fail to load\n        # and a warning will be emitted, but it won't crash the program.\n\n        relevant_tags = set()\n        for tag in delegate.tags:\n            if isinstance(tag, str):\n                relevant_tags.update(t.tag_uri for t in extension.tags if uri_match(tag, t.tag_uri))\n            else:\n                msg = \"Converter property 'tags' must contain str values\"\n                raise TypeError(msg)\n",
  "start_line": 150,
  "end_line": 180,
  "total_lines": 385,
  "is_truncated": false
}

{
  "status": "ok",
  "filepath": "asdf/extension/_converter.py",
  "content": "\"\"\"\nSupport for Converter, the new API for serializing custom\ntypes.  Will eventually replace the `asdf.types` module.\n\"\"\"\n\nimport abc\nimport warnings\n\nfrom asdf.exceptions import AsdfWarning\nfrom asdf.util import get_class_name, uri_match\n\n\nclass Converter(abc.ABC):\n    \"\"\"\n    Abstract base class for plugins that convert nodes from the\n    parsed YAML tree into custom objects, and vice versa.\n\n    Implementing classes must provide the `tags` and `types`\n    properties and `to_yaml_tree` and `from_yaml_tree` methods.\n    The ``select_tag`` method is optional.\n\n    If implemented, ``select_tag`` should accept 3 parameters\n\n        obj : object\n            Instance of the custom type being converted.  Guaranteed\n            to be an instance of one of the types listed in the\n            `types` property.\n        tags : list of str\n            List of active tags to choose from.  Guaranteed to match\n            one of the tag patterns listed in the 'tags' property.\n        ctx : asdf.asdf.SerializationContext\n            Context of the current serialization request.\n\n    and return a str, the selected tag (should be one of tags) or\n    `None` which will trigger the result of ``to_yaml_tree`` to be\n    used to look up the next converter for this object.\n\n    The ``lazy`` attribute is optional. If ``True`` asdf will\n    pass \"lazy\" objects to the converter. If ``False`` (or not\n    defined) asdf will convert all child objects before calling\n    `from_yaml_tree`.\n    \"\"\"\n\n    @classmethod\n    def __subclasshook__(cls, class_):\n        if cls is Converter:\n            return (\n                hasattr(class_, \"tags\")\n                and hasattr(class_, \"types\")\n                and hasattr(class_, \"to_yaml_tree\")\n                and hasattr(class_, \"from_yaml_tree\")\n            )\n        return NotImplemented  # pragma: no cover\n\n    @property\n    @abc.abstractmethod\n    def tags(self):\n        \"\"\"\n        Get the YAML tags that this converter is capable of\n        handling.  URI patterns are permitted, see\n        `asdf.util.uri_match` for details.\n\n        Returns\n        -------\n        iterable of str\n            Tag URIs or URI patterns.\n        \"\"\"\n\n    @property\n    @abc.abstractmethod\n    def types(self):\n        \"\"\"\n        Get the Python types that this converter is capable of\n        handling.\n\n        Returns\n        -------\n        iterable of str or type\n            If str, the fully qualified class name of the type.\n        \"\"\"\n\n    @abc.abstractmethod\n    def to_yaml_tree(self, obj, tag, ctx):\n        \"\"\"\n        Convert an object into a node suitable for YAML serialization.\n        This method is not responsible for writing actual YAML; rather, it\n        converts an instance of a custom type to a built-in Python object type\n        (such as dict, list, str, or number), which can then be automatically\n        serialized to YAML as needed.\n\n        For container types returned by this method (dict or list),\n        the children of the container need not themselves be converted.\n        Any list elements or dict values will be converted by subsequent\n        calls to to_yaml_tree implementations.\n\n        The returned node must be an instance of `dict`, `list`, or `str`.\n        Children may be any type supported by an available Converter.\n\n        Parameters\n        ----------",
  "start_line": 1,
  "end_line": 100,
  "total_lines": 385,
  "is_truncated": false
}