PHP 8.2.30
Preview: _entry_points.py Size: 2.41 KB
//opt/cloudlinux/venv/lib/python3.11/site-packages/setuptools/_entry_points.py

import functools
import itertools
import operator

from jaraco.functools import pass_none
from jaraco.text import yield_lines
from more_itertools import consume

from ._importlib import metadata
from ._itertools import ensure_unique
from .errors import OptionError


def ensure_valid(ep):
    """
    Exercise one of the dynamic properties to trigger
    the pattern match.

    This function is deprecated in favor of importlib_metadata 8.7 and
    Python 3.14 importlib.metadata, which validates entry points on
    construction.
    """
    try:
        ep.extras
    except (AttributeError, AssertionError) as ex:
        # Why both? See https://github.com/python/importlib_metadata/issues/488
        msg = (
            f"Problems to parse {ep}.\nPlease ensure entry-point follows the spec: "
            "https://packaging.python.org/en/latest/specifications/entry-points/"
        )
        raise OptionError(msg) from ex


def load_group(value, group):
    """
    Given a value of an entry point or series of entry points,
    return each as an EntryPoint.
    """
    # normalize to a single sequence of lines
    lines = yield_lines(value)
    text = f'[{group}]\n' + '\n'.join(lines)
    return metadata.EntryPoints._from_text(text)


def by_group_and_name(ep):
    return ep.group, ep.name


def validate(eps: metadata.EntryPoints):
    """
    Ensure entry points are unique by group and name and validate each.
    """
    consume(map(ensure_valid, ensure_unique(eps, key=by_group_and_name)))
    return eps


@functools.singledispatch
def load(eps):
    """
    Given a Distribution.entry_points, produce EntryPoints.
    """
    groups = itertools.chain.from_iterable(
        load_group(value, group) for group, value in eps.items()
    )
    return validate(metadata.EntryPoints(groups))


@load.register(str)
def _(eps):
    r"""
    >>> ep, = load('[console_scripts]\nfoo=bar')
    >>> ep.group
    'console_scripts'
    >>> ep.name
    'foo'
    >>> ep.value
    'bar'
    """
    return validate(metadata.EntryPoints(metadata.EntryPoints._from_text(eps)))


load.register(type(None), lambda x: x)


@pass_none
def render(eps: metadata.EntryPoints):
    by_group = operator.attrgetter('group')
    groups = itertools.groupby(sorted(eps, key=by_group), by_group)

    return '\n'.join(f'[{group}]\n{render_items(items)}\n' for group, items in groups)


def render_items(eps):
    return '\n'.join(f'{ep.name} = {ep.value}' for ep in sorted(eps))

Directory Contents

Dirs: 7 × Files: 43

Name Size Perms Modified Actions
command DIR
- drwxr-xr-x 2026-02-06 08:01:08
Edit Download
compat DIR
- drwxr-xr-x 2026-02-06 08:01:08
Edit Download
config DIR
- drwxr-xr-x 2026-02-06 08:01:08
Edit Download
tests DIR
- drwxr-xr-x 2026-02-06 08:01:49
Edit Download
- drwxr-xr-x 2026-02-06 08:01:08
Edit Download
_vendor DIR
- drwxr-xr-x 2026-02-06 08:01:08
Edit Download
- drwxr-xr-x 2026-02-06 08:05:34
Edit Download
7.18 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
19.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
11.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
14.00 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
13.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
11.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
5.83 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
20.76 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
43.83 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
2.95 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
6.53 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
5.92 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
11.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
14.00 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
13.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
11.50 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
4.97 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
820 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
1.23 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
568 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
3.63 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
40.66 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
3.10 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
218 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
138 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
3.11 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
161 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
3.71 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
9.25 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
726 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
11.70 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
836 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
2.41 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
2.38 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
223 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
657 B lrw-r--r-- 2026-01-20 13:01:47
Edit Download
5.61 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
2.91 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
1.35 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
10.98 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
1.54 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
4.74 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download
8.79 KB lrw-r--r-- 2026-01-20 13:01:47
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).