Skip to content

entrypoints

Processing of entry points for Metador plugins.

pkg_meta module-attribute 

pkg_meta = {}

Collected infos about packages that provide plugins (filled by get_group).

get_group 

get_group(group_name: str) -> Dict[str, Any]

Get a dict of all available entrypoints for a Metador plugin group.

Source code in src/metador_core/plugin/entrypoints.py 
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
def get_group(group_name: str) -> Dict[str, Any]:
    """Get a dict of all available entrypoints for a Metador plugin group."""
    ep_grp = to_ep_group_name(group_name)
    plugins: Dict[str, Any] = {}

    for ep in _eps.select(group=ep_grp):
        if ep.name in plugins:
            # TODO: will importlib_metadata even return colliding packages?
            # should be figured out (quite important to know)
            msg = f"{group_name}: a plugin named '{ep.name}' is already registered!"
            raise TypeError(msg)

        plugins[ep.name] = ep
        if ep.dist.name not in pkg_meta:
            pkg_meta[ep.dist.name] = PluginPkgMeta.for_package(ep.dist.name)

    return plugins

distmeta_for 

distmeta_for(dist: Distribution) -> DistMeta

Extract required metadata from importlib_metadata distribution object.

Source code in src/metador_core/plugin/entrypoints.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
def distmeta_for(dist: Distribution) -> DistMeta:
    """Extract required metadata from importlib_metadata distribution object."""
    ver = dist.version
    if not re.fullmatch("[0-9]+\\.[0-9]+\\.[0-9]+", ver):
        msg = f"Invalid version string of {dist.name}: {ver}"
        raise TypeError(msg)
    parsed_ver: SemVerTuple = tuple(map(int, ver.split(".")))  # type: ignore

    # parse entry point groups
    epgs = filter(
        is_metador_ep_group,
        dist.entry_points.groups,
    )
    eps = {
        from_ep_group_name(EPGroupName(epg)): list(
            map(lambda x: x.name, dist.entry_points.select(group=epg))
        )
        for epg in epgs
    }

    repo_url: Optional[str] = None
    try:
        urls = dist.metadata.get_all("Project-URL")
        url = next(filter(lambda u: u.startswith("Repository,"), urls or []))
        repo_url = url.split()[1]  # from "Repository, http://..."
    except StopIteration:
        pass
    return DistMeta(
        name=dist.name, version=parsed_ver, plugins=eps, repository_url=repo_url
    )