Module `fpdf.actions`

Expand source code Browse git

from abc import ABC
import warnings

from .syntax import PDFString, build_obj_dict, create_dictionary_string


class Action(ABC):
    def __init__(self, next_action=None):
        """
        Args:
            next (PDFObject | str): optional reference to another Action to trigger after this one
        """
        self.next = next_action

    def serialize(self, _security_handler=None, _obj_id=None):
        raise NotImplementedError

    def _serialize(self, key_values=None, _security_handler=None, _obj_id=None):
        if key_values is None:
            key_values = {}
        if self.next:
            key_values["Next"] = self.next
        obj_dict = build_obj_dict(key_values, _security_handler, _obj_id)
        return create_dictionary_string(obj_dict, field_join=" ")


class URIAction(Action):
    def __init__(self, uri, next_action=None):
        super().__init__(next)
        self.uri = uri

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/URI", "u_r_i": PDFString(self.uri, encrypt=True)},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )


class NamedAction(Action):
    def __init__(self, action_name, next_action=None):
        super().__init__(next)
        if action_name not in ("NextPage", "PrevPage", "FirstPage", "LastPage"):
            warnings.warn("Non-standard named action added")
        self.action_name = action_name

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/Named", "n": f"/{self.action_name}"},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )


class GoToAction(Action):
    "As of 2022, this does not seem honored by neither Adobe Acrobat nor Sumatra readers."

    def __init__(self, dest, next_action=None):
        super().__init__(next_action)
        self.dest = dest

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/GoTo", "d": self.dest},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )


class GoToRemoteAction(Action):
    def __init__(self, file, dest, next_action=None):
        super().__init__(next_action)
        self.file = file
        self.dest = dest

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/GoToR", "f": PDFString(self.file, encrypt=True), "d": self.dest},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )


class LaunchAction(Action):
    "As of 2022, this does not seem honored by neither Adobe Acrobat nor Sumatra readers."

    def __init__(self, file, next_action=None):
        super().__init__(next_action)
        self.file = file

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/Launch", "f": PDFString(self.file, encrypt=True)},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )


# Annotation & actions that we tested implementing,
# but that revealed not be worth the effort:
# * Popup annotation & Hide action: as of june 2021,
#   do not seem support neither by Adobe Acrobat nor by Sumatra.
#   Moreover, they both use to indirect reference annotations,
#   and hence implementing them would need some consequent refactoring,
#   as annotations are currently defined "inline", not as dedicated PDF objects.

Classes

class Action (next_action=None)

Helper class that provides a standard way to create an ABC using inheritance.

Args

next (PDFObject | str): optional reference to another Action to trigger after this one

Expand source code Browse git

class Action(ABC):
    def __init__(self, next_action=None):
        """
        Args:
            next (PDFObject | str): optional reference to another Action to trigger after this one
        """
        self.next = next_action

    def serialize(self, _security_handler=None, _obj_id=None):
        raise NotImplementedError

    def _serialize(self, key_values=None, _security_handler=None, _obj_id=None):
        if key_values is None:
            key_values = {}
        if self.next:
            key_values["Next"] = self.next
        obj_dict = build_obj_dict(key_values, _security_handler, _obj_id)
        return create_dictionary_string(obj_dict, field_join=" ")

Ancestors

abc.ABC

Methods

def serialize(self)

Expand source code Browse git

def serialize(self, _security_handler=None, _obj_id=None):
    raise NotImplementedError

class GoToAction (dest, next_action=None)

As of 2022, this does not seem honored by neither Adobe Acrobat nor Sumatra readers.

Args

next (PDFObject | str): optional reference to another Action to trigger after this one

Expand source code Browse git

class GoToAction(Action):
    "As of 2022, this does not seem honored by neither Adobe Acrobat nor Sumatra readers."

    def __init__(self, dest, next_action=None):
        super().__init__(next_action)
        self.dest = dest

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/GoTo", "d": self.dest},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )

Ancestors

Action
abc.ABC

Methods

def serialize(self)

Expand source code Browse git

def serialize(self, _security_handler=None, _obj_id=None):
    return super()._serialize(
        {"s": "/GoTo", "d": self.dest},
        _security_handler=_security_handler,
        _obj_id=_obj_id,
    )

class GoToRemoteAction (file, dest, next_action=None)

Helper class that provides a standard way to create an ABC using inheritance.

Args

next (PDFObject | str): optional reference to another Action to trigger after this one

Expand source code Browse git

class GoToRemoteAction(Action):
    def __init__(self, file, dest, next_action=None):
        super().__init__(next_action)
        self.file = file
        self.dest = dest

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/GoToR", "f": PDFString(self.file, encrypt=True), "d": self.dest},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )

Ancestors

Action
abc.ABC

Methods

def serialize(self)

Expand source code Browse git

def serialize(self, _security_handler=None, _obj_id=None):
    return super()._serialize(
        {"s": "/GoToR", "f": PDFString(self.file, encrypt=True), "d": self.dest},
        _security_handler=_security_handler,
        _obj_id=_obj_id,
    )

class LaunchAction (file, next_action=None)

As of 2022, this does not seem honored by neither Adobe Acrobat nor Sumatra readers.

Args

next (PDFObject | str): optional reference to another Action to trigger after this one

Expand source code Browse git

class LaunchAction(Action):
    "As of 2022, this does not seem honored by neither Adobe Acrobat nor Sumatra readers."

    def __init__(self, file, next_action=None):
        super().__init__(next_action)
        self.file = file

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/Launch", "f": PDFString(self.file, encrypt=True)},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )

Ancestors

Action
abc.ABC

Methods

def serialize(self)

Expand source code Browse git

def serialize(self, _security_handler=None, _obj_id=None):
    return super()._serialize(
        {"s": "/Launch", "f": PDFString(self.file, encrypt=True)},
        _security_handler=_security_handler,
        _obj_id=_obj_id,
    )

class NamedAction (action_name, next_action=None)

Helper class that provides a standard way to create an ABC using inheritance.

Args

next (PDFObject | str): optional reference to another Action to trigger after this one

Expand source code Browse git

class NamedAction(Action):
    def __init__(self, action_name, next_action=None):
        super().__init__(next)
        if action_name not in ("NextPage", "PrevPage", "FirstPage", "LastPage"):
            warnings.warn("Non-standard named action added")
        self.action_name = action_name

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/Named", "n": f"/{self.action_name}"},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )

Ancestors

Action
abc.ABC

Methods

def serialize(self)

Expand source code Browse git

def serialize(self, _security_handler=None, _obj_id=None):
    return super()._serialize(
        {"s": "/Named", "n": f"/{self.action_name}"},
        _security_handler=_security_handler,
        _obj_id=_obj_id,
    )

class URIAction (uri, next_action=None)

Helper class that provides a standard way to create an ABC using inheritance.

Args

next (PDFObject | str): optional reference to another Action to trigger after this one

Expand source code Browse git

class URIAction(Action):
    def __init__(self, uri, next_action=None):
        super().__init__(next)
        self.uri = uri

    def serialize(self, _security_handler=None, _obj_id=None):
        return super()._serialize(
            {"s": "/URI", "u_r_i": PDFString(self.uri, encrypt=True)},
            _security_handler=_security_handler,
            _obj_id=_obj_id,
        )

Ancestors

Action
abc.ABC

Methods

def serialize(self)

Expand source code Browse git

def serialize(self, _security_handler=None, _obj_id=None):
    return super()._serialize(
        {"s": "/URI", "u_r_i": PDFString(self.uri, encrypt=True)},
        _security_handler=_security_handler,
        _obj_id=_obj_id,
    )