PyPDFForm 1.4.27__py3-none-any.whl → 1.4.29__py3-none-any.whl

PyPDFForm/__init__.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """Contains any object users might need."""
 
-__version__ = "1.4.27"
+__version__ = "1.4.29"
 
-from .wrapper import FormWrapper, PdfWrapper, PyPDFForm
+from .wrapper import FormWrapper, PdfWrapper

PyPDFForm/filler.py

@@ -177,7 +177,6 @@ def simple_fill(
 ) -> bytes:
     """Fills a PDF form in place."""
 
-    # pylint: disable=too-many-branches
     pdf = PdfReader(stream_to_io(template))
     enable_adobe_mode(pdf, adobe_mode)
     out = PdfWriter()

PyPDFForm/wrapper.py

@@ -5,11 +5,10 @@ from __future__ import annotations
 
 from functools import cached_property
 from typing import BinaryIO, Dict, List, Tuple, Union
-from warnings import warn
 
 from .adapter import fp_or_f_obj_or_stream_to_stream
 from .constants import (DEFAULT_FONT, DEFAULT_FONT_COLOR, DEFAULT_FONT_SIZE,
-                        DEPRECATION_NOTICE, VERSION_IDENTIFIER_PREFIX,
+                        NEW_LINE_SYMBOL, VERSION_IDENTIFIER_PREFIX,
                         VERSION_IDENTIFIERS)
 from .coordinate import generate_coordinate_grid
 from .filler import fill, simple_fill
@@ -90,21 +89,6 @@ class PdfWrapper(FormWrapper):
                 each.font_size = self.global_font_size
                 each.font_color = self.global_font_color
 
-    @property
-    def elements(self) -> dict:
-        """ToDo: deprecate this."""
-
-        warn(
-            DEPRECATION_NOTICE.format(
-                f"{self.__class__.__name__}.elements",
-                f"{self.__class__.__name__}.widgets",
-            ),
-            DeprecationWarning,
-            stacklevel=2,
-        )
-
-        return self.widgets
-
     @property
     def sample_data(self) -> dict:
         """Returns a valid sample data that can be filled into the PDF form."""
@@ -261,6 +245,9 @@ class PdfWrapper(FormWrapper):
         new_widget.font_size = kwargs.get("font_size", DEFAULT_FONT_SIZE)
         new_widget.font_color = kwargs.get("font_color", DEFAULT_FONT_COLOR)
 
+        if NEW_LINE_SYMBOL in text:
+            new_widget.text_lines = text.split(NEW_LINE_SYMBOL)
+
         watermarks = create_watermarks_and_draw(
             self.stream,
             page_number,
@@ -314,20 +301,6 @@ class PdfWrapper(FormWrapper):
 
         return result
 
-    def generate_schema(self) -> dict:
-        """ToDo: deprecate this."""
-
-        warn(
-            DEPRECATION_NOTICE.format(
-                f"{self.__class__.__name__}.generate_schema()",
-                f"{self.__class__.__name__}.schema",
-            ),
-            DeprecationWarning,
-            stacklevel=2,
-        )
-
-        return self.schema
-
     @classmethod
     def register_font(
         cls, font_name: str, ttf_file: Union[bytes, str, BinaryIO]
@@ -337,22 +310,3 @@ class PdfWrapper(FormWrapper):
         ttf_file = fp_or_f_obj_or_stream_to_stream(ttf_file)
 
         return register_font(font_name, ttf_file) if ttf_file is not None else False
-
-
-class PyPDFForm(PdfWrapper):
-    """ToDo: deprecate this."""
-
-    def __init__(
-        self,
-        template: Union[bytes, str, BinaryIO] = b"",
-        **kwargs,
-    ):
-        """Only extra thing is the deprecation notice."""
-
-        warn(
-            DEPRECATION_NOTICE.format("PyPDFForm.PyPDFForm", "PyPDFForm.PdfWrapper"),
-            DeprecationWarning,
-            stacklevel=2,
-        )
-
-        super().__init__(template, **kwargs)

{PyPDFForm-1.4.27.dist-info → PyPDFForm-1.4.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyPDFForm
-Version: 1.4.27
+Version: 1.4.29
 Summary: The Python library for PDF forms.
 Home-page: https://github.com/chinapandaman/PyPDFForm
 Author: Jinge Li
@@ -34,22 +34,6 @@ Requires-Dist: reportlab
     <a href="https://pypistats.org/packages/pypdfform"><img src="https://img.shields.io/pypi/dm/pypdfform?logo=pypi&logoColor=white&label=downloads&labelColor=black&color=blue&style=for-the-badge"></a>
 </p>
 
-## Important API Changes
-
-Happy new year fellow developers! We start the year 2024 with a new release of v1.4.0 and 
-there are some important changes I'm making to the APIs of the library.
-
-* The PDF object that gets instantiated is now `PyPDFForm.PdfWrapper`, changed from `PyPDFForm.PyPDFForm`.
-* Form widgets are now accessed via the `PdfWrapper.widgets` attribute, changed from `PdfWrapper.elements`.
-* The JSON schema of the form data is now accessed via a new attribute called `PdfWrapper.schema`, 
-changed from the old method of `PdfWrapper.generate_schema()`.
-
-All the old APIs will be persisted for half a year and then fully deprecated. Each of them 
-will emit a `DeprecationWarning` when invoked, so it is advised that you make the switch before they are 
-removed and start breaking your code.
-
-Happy hacking!
-
 ## Introduction
 
 PyPDFForm is a free and open source pure-Python 3 library for PDF form processing. It contains the essential 
@@ -99,12 +83,6 @@ and it should look like [this](https://github.com/chinapandaman/PyPDFForm/raw/ma
 
 The official documentation can be found on [the GitHub page](https://chinapandaman.github.io/PyPDFForm/) of this repository.
 
-## Public Speak
+## Other Resources
 
 [Chicago Python User Group - Dec 14, 2023](https://youtu.be/8t1RdAKwr9w?si=TLgumBNXv9H8szSn)
-
-## How to Contribute
-
-It is difficult to make sure that the library supports all the PDF form creating tools out 
-there. So if you run into a case where the library does not work for certain PDF forms created by certain tools, feel free to open an issue with the problematic PDF form attached. I will seek 
-to make the library support the attached PDF form as well as the tool used to create it.

{PyPDFForm-1.4.27.dist-info → PyPDFForm-1.4.29.dist-info}/RECORD

@@ -1,15 +1,15 @@
-PyPDFForm/__init__.py,sha256=grkJLpy2Zjzo37fkYqaZIE7_w_Gsdbat72pwcl_KRko,149
+PyPDFForm/__init__.py,sha256=7PqqRfPhC05fsbxMhlPBXIs5vnUxIuZeSrivp55uw94,138
 PyPDFForm/adapter.py,sha256=OgAIwcmukpBqHFBLymd3I7wA7wIdipRqgURZA2Y0Hgo,885
 PyPDFForm/constants.py,sha256=Y-WINNe5GoOPfBFQroWuzzLELhAl-Fj_d7_3b1QodW0,1767
 PyPDFForm/coordinate.py,sha256=V_ZZQ1pXtVPAyfMJCX7fKoEimK7XwX6bU3VQ0nKOhQA,7314
-PyPDFForm/filler.py,sha256=ph2FvhfJsWGmv_NFWBq2UHJGcW1Dg-ITj7QlvB4lTP8,7526
+PyPDFForm/filler.py,sha256=pgMA7EC8axKUganmbk7X1uDdsb4OQQFoiI85td3pOO4,7486
 PyPDFForm/font.py,sha256=DCaKN6WIfNeMpP6ud17q1FOVRQXqrdevLycIQ9kItXQ,5711
 PyPDFForm/image.py,sha256=0GV8PFgY5oLJFHmhPD1fG-_5SBEO7jVLLtxCc_Uodfo,1143
 PyPDFForm/patterns.py,sha256=Ylfe6s9UV2X7cRAFQjaGoEa4nVSpEn-MLrH7IROp_aY,4332
 PyPDFForm/template.py,sha256=u3QxYdsT8HhoUBlhmChYaTJeFWI-SSrhICtUYsTTrow,13141
 PyPDFForm/utils.py,sha256=gDeRDszZ5Q59RjZjJYnikS2pQ_hc78osQH2Oy1TuLsY,4269
 PyPDFForm/watermark.py,sha256=clYdRqCuWEE25IL-BUHnSo4HgLkHPSOl7FUJLhbAfGg,4755
-PyPDFForm/wrapper.py,sha256=Q4TKCmXLmO_oP3k2UQPFYhDCmDkGocBq7cVXFBVoloA,10587
+PyPDFForm/wrapper.py,sha256=nwmaBkcnd0wt53s9SHHWFCvSJX4J2f7MU3ktt3105WU,9496
 PyPDFForm/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 PyPDFForm/middleware/base.py,sha256=TmoO8XpjFa5NerAumrAGm_kUt2eFP3DyyF-Vx0uXloM,724
 PyPDFForm/middleware/checkbox.py,sha256=Z92awlKjceMd_ryb9Fhrtyd4fLkU84Ii6fSum60rHcA,1305
@@ -23,8 +23,8 @@ PyPDFForm/widgets/base.py,sha256=Stq-oQt-cfwQ6nilQ4NqpO5udFSKDNb1mAwryrWggZA,207
 PyPDFForm/widgets/checkbox.py,sha256=MGB6NGI-XMBz4j2erykgYOCd1pswvthuQ6UFowQOd4o,503
 PyPDFForm/widgets/dropdown.py,sha256=2_R5xcLUWAL0G4raVgWWtE7TJdiWJITay-Gtl8YI2QI,705
 PyPDFForm/widgets/text.py,sha256=x8EglZLYoI9osN9wORLRYoR7lebrpj-wx38QiRH7H1A,629
-PyPDFForm-1.4.27.dist-info/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
-PyPDFForm-1.4.27.dist-info/METADATA,sha256=hcvKA9BAmZIFlVvNjFwis5Zkjqf8tl8-xV0rf6SyCVQ,5367
-PyPDFForm-1.4.27.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-PyPDFForm-1.4.27.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
-PyPDFForm-1.4.27.dist-info/RECORD,,
+PyPDFForm-1.4.29.dist-info/LICENSE,sha256=43awmYkI6opyTpg19me731iO1WfXZwViqb67oWtCsFY,1065
+PyPDFForm-1.4.29.dist-info/METADATA,sha256=XpWnZIbenPQtjTIZKAovCTQP7HX0vobgn70b5kc_Tms,4151
+PyPDFForm-1.4.29.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
+PyPDFForm-1.4.29.dist-info/top_level.txt,sha256=GQQKuWqPUjT9YZqwK95NlAQzxjwoQrsxQ8ureM8lWOY,10
+PyPDFForm-1.4.29.dist-info/RECORD,,

{PyPDFForm-1.4.27.dist-info → PyPDFForm-1.4.29.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (70.1.1)
 Root-Is-Purelib: true
 Tag: py3-none-any