Keyword-only requirements

Change Page and Shape methods to require keyword-only specifications as required `.insert_text()` and `.insert_textbox()`.

Author: JorjMcKie

docs/page.rst

@@ -728,9 +728,9 @@ In a nutshell, this is what you can do with PyMuPDF:
       pair: fill_opacity; insert_text
       pair: oc; insert_text
 
-   .. method:: insert_text(point, text, fontsize=11, fontname="helv", fontfile=None, idx=0, color=None, fill=None, render_mode=0, border_width=1, encoding=TEXT_ENCODING_LATIN, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, overlay=True, oc=0)
+   .. method:: insert_text(point, text, *, fontsize=11, fontname="helv", fontfile=None, idx=0, color=None, fill=None, render_mode=0, border_width=1, encoding=TEXT_ENCODING_LATIN, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, overlay=True, oc=0)
 
-      PDF only: Insert text starting at :data:`point_like` *point*. See :meth:`Shape.insert_text`.
+      PDF only: Insert text lines starting at :data:`point_like` ``point``. See :meth:`Shape.insert_text`.
 
       |history_begin|
 
@@ -756,7 +756,7 @@ In a nutshell, this is what you can do with PyMuPDF:
       pair: fill_opacity; insert_textbox
       pair: oc; insert_textbox
 
-   .. method:: insert_textbox(rect, buffer, fontsize=11, fontname="helv", fontfile=None, idx=0, color=None, fill=None, render_mode=0, border_width=1, encoding=TEXT_ENCODING_LATIN, expandtabs=8, align=TEXT_ALIGN_LEFT, charwidths=None, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, oc=0, overlay=True)
+   .. method:: insert_textbox(rect, buffer, *, fontsize=11, fontname="helv", fontfile=None, idx=0, color=None, fill=None, render_mode=0, border_width=1, encoding=TEXT_ENCODING_LATIN, expandtabs=8, align=TEXT_ALIGN_LEFT, charwidths=None, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, oc=0, overlay=True)
 
       PDF only: Insert text into the specified :data:`rect_like` *rect*. See :meth:`Shape.insert_textbox`.
 

docs/shape.rst

@@ -291,9 +291,9 @@ Several draw methods can be executed in a row and each one of them will contribu
       pair: fill_opacity; insert_text
       pair: oc; insert_text
 
-   .. method:: insert_text(point, text, fontsize=11, fontname="helv", fontfile=None, set_simple=False, encoding=TEXT_ENCODING_LATIN, color=None, lineheight=None, fill=None, render_mode=0, border_width=1, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, oc=0)
+   .. method:: insert_text(point, text, *, fontsize=11, fontname="helv", fontfile=None, set_simple=False, encoding=TEXT_ENCODING_LATIN, color=None, lineheight=None, fill=None, render_mode=0, border_width=1, rotate=0, morph=None, stroke_opacity=1, fill_opacity=1, oc=0)
 
-      Insert text lines start at *point*.
+      Insert text lines starting at ``point``.
 
       :arg point_like point: the bottom-left position of the first character of *text* in pixels. It is important to understand, how this works in conjunction with the *rotate* parameter. Please have a look at the following picture. The small red dots indicate the positions of *point* in each of the four possible cases.
 
@@ -331,7 +331,7 @@ Several draw methods can be executed in a row and each one of them will contribu
       pair: rotate; insert_textbox
       pair: oc; insert_textbox
 
-   .. method:: insert_textbox(rect, buffer, fontsize=11, fontname="helv", fontfile=None, set_simple=False, encoding=TEXT_ENCODING_LATIN, color=None, fill=None, render_mode=0, border_width=1, expandtabs=8, align=TEXT_ALIGN_LEFT, rotate=0, lineheight=None, morph=None, stroke_opacity=1, fill_opacity=1, oc=0)
+   .. method:: insert_textbox(rect, buffer, *, fontsize=11, fontname="helv", fontfile=None, set_simple=False, encoding=TEXT_ENCODING_LATIN, color=None, fill=None, render_mode=0, border_width=1, expandtabs=8, align=TEXT_ALIGN_LEFT, rotate=0, lineheight=None, morph=None, stroke_opacity=1, fill_opacity=1, oc=0)
 
       PDF only: Insert text into the specified rectangle. The text will be split into lines and words and then filled into the available space, starting from one of the four rectangle corners, which depends on `rotate`. Line feeds and multiple space will be respected.
 

src/utils.py

@@ -1919,6 +1919,7 @@ def insert_textbox(
     page: pymupdf.Page,
     rect: rect_like,
     buffer: typing.Union[str, list],
+    *,
     fontname: str = "helv",
     fontfile: OptStr = None,
     set_simple: int = 0,
@@ -1989,6 +1990,7 @@ def insert_text(
     page: pymupdf.Page,
     point: point_like,
     text: typing.Union[str, list],
+    *,
     fontsize: float = 11,
     lineheight: OptFloat = None,
     fontname: str = "helv",
@@ -3761,6 +3763,7 @@ def insert_text(
         self,
         point: point_like,
         buffer: typing.Union[str, list],
+        *,
         fontsize: float = 11,
         lineheight: OptFloat = None,
         fontname: str = "helv",
@@ -3947,6 +3950,7 @@ def insert_textbox(
         self,
         rect: rect_like,
         buffer: typing.Union[str, list],
+        *,
         fontname: OptStr = "helv",
         fontfile: OptStr = None,
         fontsize: float = 11,