forked from reingart/pyfpdf
/
__init__.py
86 lines (74 loc) · 2.23 KB
/
__init__.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
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
85
86
"""
Root module.
Gives direct access to some classes defined in submodules:
* `fpdf.fpdf.FPDF`
* `fpdf.enums.Align`
* `fpdf.enums.TextMode`
* `fpdf.enums.XPos`
* `fpdf.enums.YPos`
* `fpdf.errors.FPDFException`
* `fpdf.fonts.FontFace`
* `fpdf.fpdf.TitleStyle`
* `fpdf.prefs.ViewerPreferences`
* `fpdf.template.Template`
* `fpdf.template.FlexTemplate`
"""
import warnings, sys
from .enums import Align, TextMode, XPos, YPos
from .errors import FPDFException
from .fpdf import (
FPDF,
TitleStyle,
FPDF_FONT_DIR as _FPDF_FONT_DIR,
FPDF_VERSION as _FPDF_VERSION,
)
from .fonts import FontFace
from .html import HTMLMixin, HTML2FPDF
from .prefs import ViewerPreferences
from .template import Template, FlexTemplate
from .deprecation import WarnOnDeprecatedModuleAttributes
try:
# This module only exists in PyFPDF, it has been removed in fpdf2 since v2.5.7:
# pylint: disable=import-self
from . import ttfonts
warnings.warn(
"You have both PyFPDF & fpdf2 installed. "
"Both packages cannot be installed at the same time as they share the same module namespace. "
"To only keep fpdf2, run: pip uninstall --yes pypdf && pip install --upgrade fpdf2"
)
except ImportError:
pass # no PyFPDF installation detected
FPDF_VERSION = _FPDF_VERSION
"Current fpdf2 version, also available as `__version__`"
FPDF_FONT_DIR = _FPDF_FONT_DIR
"Extra filesystem folder where fpdf2 looks for fonts files, after the current directory"
# Pattern from sir Guido Von Rossum: https://stackoverflow.com/a/72911884/636849
# > a module can define a class with the desired functionality, and then at
# > the end, replace itself in sys.modules with an instance of that class
sys.modules[__name__].__class__ = WarnOnDeprecatedModuleAttributes
__license__ = "LGPL 3.0"
__version__ = FPDF_VERSION
__all__ = [
# Metadata:
"__version__",
"__license__",
# Classes:
"FPDF",
"FPDFException",
"FontFace",
"Align",
"TextMode",
"XPos",
"YPos",
"Template",
"FlexTemplate",
"TitleStyle",
"ViewerPreferences",
# Deprecated classes:
"HTMLMixin",
"HTML2FPDF",
# FPDF constants:
"FPDF_VERSION",
"FPDF_FONT_DIR",
]
__pdoc__ = {name: name.startswith("FPDF_") for name in __all__}