pincer.utils.conversion

Complexity

Total Complexity

8

Size/Duplication

Total Lines	63
Duplicated Lines	0 %

Importance

Changes

0

2 Functions

Rating	Name	Duplication	Size	Complexity
A	construct_client_dict()	0	14	1
B	convert()	0	31	7

# Copyright Pincer 2021-Present

Missing module docstring

# Full MIT License can be found in `LICENSE` at the project root.

from __future__ import annotations

from inspect import getfullargspec
from typing import TYPE_CHECKING

from .types import T, MISSING

if TYPE_CHECKING:
    from ..client import Client

Cannot import 'client' due to syntax error 'invalid syntax (<unknown>, line 354)'

    from typing import Dict, Callable, Any, Optional


def construct_client_dict(client: Client, data: Dict[...]):
    # TODO: fix docs

TODO and FIXME comments should generally be avoided.

    """

    Parameters
    ----------
    client
    data

    Returns
    -------

    """
    return {**data, "_client": client, "_http": client.http}


def convert(
    value: Any,

Wrong hanging indentation before block (add 4 spaces).

    factory: Callable[[Any], T],

Wrong hanging indentation before block (add 4 spaces).

    check: Optional[T] = None,

Wrong hanging indentation before block (add 4 spaces).

    client: Optional[Client] = None,

Wrong hanging indentation before block (add 4 spaces).

) -> T:
    """
    Parameters
    ----------
    Value : Any
        The value that has to have its type converted.
    Factory : Callable[[Any], T]
        The conversion factory/object to use.
    Check : Optional[T]
        Skip conversion if ``value`` is already this type.
    Client : Optional[:class:`~pincer.client.Client`]
        Reference to :class:`~pincer.client.Client`
    """
    def handle_factory() -> T:
        if check is not None and isinstance(value, check):
            return value

        try:
            if client and "_client" in getfullargspec(factory).args:
                return factory(construct_client_dict(client, value))
        except TypeError:  # Building type/has no signature
            pass

        return factory(value)

    return MISSING if value is MISSING else handle_factory()