Module fpdf.deprecation

Utilities to manage deprecation errors & warnings.

The contents of this module are internal to fpdf2, and not part of the public API. They may change at any time without prior warning or any deprecation period, in non-backward-compatible ways.

Functions

def deprecated_parameter(parameters)

Expand source code Browse git

def deprecated_parameter(parameters):
    """Decorator removing deprecated keyword arguments from a function call.

    Args:
        parameters (Iterable[tuple[str, str]]): sequence of `(parameter, version)` pairs.
    """

    deprecated_info = tuple(parameters)
    _sentinel = object()

    def decorator(fn):
        @wraps(fn)
        def wrapper(*args, **kwargs):
            for name, version in deprecated_info:
                if kwargs.pop(name, _sentinel) is not _sentinel:
                    warnings.warn(
                        f'"{name}" parameter is deprecated since v{version} and will be removed in a future release',
                        DeprecationWarning,
                        stacklevel=get_stack_level(),
                    )
            return fn(*args, **kwargs)

        return wrapper

    return decorator

Decorator removing deprecated keyword arguments from a function call.

Args

parameters : Iterable[tuple[str, str]]

sequence of (parameter, version) pairs.

def get_stack_level() ‑> int

Expand source code Browse git

def get_stack_level() -> int:
    """Get the first place in the call stack that is not inside fpdf2"""

    # pylint: disable=import-outside-toplevel
    import fpdf  # pylint: disable=cyclic-import

    pkg_dir = os.path.dirname(fpdf.__file__)
    contextlib_dir = os.path.dirname(contextlib.__file__)

    frame = inspect.currentframe()
    n = 0
    while frame is not None:
        fname = inspect.getfile(frame)
        if fname.startswith(pkg_dir) or fname.startswith(contextlib_dir):
            frame = frame.f_back
            n += 1
        else:
            break
    return n

Get the first place in the call stack that is not inside fpdf2

def support_deprecated_txt_arg(fn)

Expand source code Browse git

def support_deprecated_txt_arg(fn):
    """Decorator converting `txt=` arguments into `text=` arguments"""

    @wraps(fn)
    def wrapper(self, *args, **kwargs):
        txt_value = kwargs.pop("txt", None)
        if txt_value is not None:
            if "text" in kwargs:
                raise ValueError("Both txt= & text= arguments cannot be provided")
            kwargs["text"] = txt_value
            warnings.warn(
                'The parameter "txt" has been renamed to "text" in 2.7.6',
                DeprecationWarning,
                stacklevel=get_stack_level(),
            )
        return fn(self, *args, **kwargs)

    return wrapper

Decorator converting txt= arguments into text= arguments

Classes

class WarnOnDeprecatedModuleAttributes (*args, **kwargs)

Expand source code Browse git

class WarnOnDeprecatedModuleAttributes(ModuleType):
    def __call__(self):
        raise TypeError(
            "You tried to instantied the fpdf module."
            " You probably want to import the FPDF class instead:"
            " from fpdf import FPDF"
        )

    def __getattr__(self, name):
        if name in ("FPDF_CACHE_DIR", "FPDF_CACHE_MODE"):
            warnings.warn(
                (
                    "fpdf.FPDF_CACHE_DIR & fpdf.FPDF_CACHE_MODE"
                    " have been deprecated in favour of"
                    " FPDF(font_cache_dir=...)"
                ),
                DeprecationWarning,
                stacklevel=get_stack_level(),
            )
            return None
        return super().__getattribute__(name)

    def __setattr__(self, name, value):
        if name in ("FPDF_CACHE_DIR", "FPDF_CACHE_MODE"):
            warnings.warn(
                (
                    "fpdf.FPDF_CACHE_DIR & fpdf.FPDF_CACHE_MODE"
                    " have been deprecated in favour of"
                    " FPDF(font_cache_dir=...)"
                ),
                DeprecationWarning,
                stacklevel=get_stack_level(),
            )
            return
        super().__setattr__(name, value)

Create a module object.

The name must be a string; the optional doc argument can have any type.

Ancestors

• builtins.module