Improve type hints on public interface

drawBot/context/baseContext.py

@@ -264,13 +264,13 @@ def _curveToOne(self, pt1, pt2, pt3):
         """
         self._path.curveToPoint_controlPoint1_controlPoint2_(pt3, pt1, pt2)
 
-    def closePath(self):
+    def closePath(self) -> None:
         """
         Close the path.
         """
         self._path.closePath()
 
-    def beginPath(self, identifier=None):
+    def beginPath(self, identifier: str | None = None) -> None:
         """
         Begin using the path as a so called point pen and start a new subpath.
         """
@@ -285,9 +285,9 @@ def addPoint(
         segmentType: str | None = None,
         smooth: bool = False,
         name: str | None = None,
-        identifier=None,
-        **kwargs,
-    ):
+        identifier: str | None = None,
+        **kwargs: Any,
+    ) -> None:
         """
         Use the path as a point pen and add a point to the current subpath. `beginPath` must
         have been called prior to adding points with `addPoint` calls.
@@ -303,7 +303,7 @@ def addPoint(
             **kwargs,
         )
 
-    def endPath(self):
+    def endPath(self) -> None:
         """
         End the current subpath. Calling this method has two distinct meanings depending
         on the context:
@@ -603,7 +603,7 @@ def controlPointBounds(self) -> BoundingBox | None:
         (x, y), (w, h) = self._path.controlPointBounds()
         return x, y, x + w, y + h
 
-    def optimizePath(self):
+    def optimizePath(self) -> None:
         count = self._path.elementCount()
         if not count or self._path.elementAtIndex_(count - 1) != AppKit.NSMoveToBezierPathElement:
             return
@@ -630,13 +630,13 @@ def copy(self) -> Self:
         new.copyContextProperties(self)
         return new
 
-    def reverse(self):
+    def reverse(self) -> None:
         """
         Reverse the path direction
         """
         self._path = self._path.bezierPathByReversingPath()
 
-    def appendPath(self, otherPath: Self):
+    def appendPath(self, otherPath: Self) -> None:
         """
         Append a path.
         """
@@ -653,13 +653,13 @@ def __iadd__(self, other: Self) -> Self:
 
     # transformations
 
-    def translate(self, x: float = 0, y: float = 0):
+    def translate(self, x: float = 0, y: float = 0) -> None:
         """
         Translate the path with a given offset.
         """
         self.transform((1, 0, 0, 1, x, y))
 
-    def rotate(self, angle: float, center: Point = (0, 0)):
+    def rotate(self, angle: float, center: Point = (0, 0)) -> None:
         """
         Rotate the path around the `center` point (which is the origin by default) with a given angle in degrees.
         """
@@ -668,7 +668,7 @@ def rotate(self, angle: float, center: Point = (0, 0)):
         s = math.sin(angle)
         self.transform((c, s, -s, c, 0, 0), center)
 
-    def scale(self, x: float = 1, y: float | None = None, center: Point = (0, 0)):
+    def scale(self, x: float = 1, y: float | None = None, center: Point = (0, 0)) -> None:
         """
         Scale the path with a given `x` (horizontal scale) and `y` (vertical scale).
 
@@ -680,7 +680,7 @@ def scale(self, x: float = 1, y: float | None = None, center: Point = (0, 0)):
             y = x
         self.transform((x, 0, 0, y, 0, 0), center)
 
-    def skew(self, angle1: float, angle2: float = 0, center: Point = (0, 0)):
+    def skew(self, angle1: float, angle2: float = 0, center: Point = (0, 0)) -> None:
         """
         Skew the path with given `angle1` and `angle2`.
 
@@ -692,7 +692,7 @@ def skew(self, angle1: float, angle2: float = 0, center: Point = (0, 0)):
         angle2 = math.radians(angle2)
         self.transform((1, math.tan(angle2), math.tan(angle1), 1, 0, 0), center)
 
-    def transform(self, transformMatrix: TransformTuple, center: Point = (0, 0)):
+    def transform(self, transformMatrix: TransformTuple, center: Point = (0, 0)) -> None:
         """
         Transform a path with a transform matrix (xy, xx, yy, yx, x, y).
         """
@@ -1638,7 +1638,7 @@ def font(
         font = getNSFontFromNameOrPath(fontNameOrPath, fontSize or 10, fontNumber)
         return getFontName(font)
 
-    def fontNumber(self, fontNumber: int):
+    def fontNumber(self, fontNumber: int) -> None:
         self._fontNumber = fontNumber
 
     def fallbackFont(self, fontNameOrPath: SomePath, fontNumber: int = 0) -> str | None:
@@ -1656,17 +1656,17 @@ def fallbackFont(self, fontNameOrPath: SomePath, fontNumber: int = 0) -> str | N
         self._fallbackFontNumber = fontNumber
         return fontName
 
-    def fallbackFontNumber(self, fontNumber: int):
+    def fallbackFontNumber(self, fontNumber: int) -> None:
         self._fallbackFontNumber = fontNumber
 
-    def fontSize(self, fontSize: float):
+    def fontSize(self, fontSize: float) -> None:
         """
         Set the font size in points.
         The default `fontSize` is 10pt.
         """
         self._fontSize = fontSize
 
-    def fill(self, r: float | None = None, g: float | None = None, b: float | None = None, alpha: float = 1):
+    def fill(self, r: float | None = None, g: float | None = None, b: float | None = None, alpha: float = 1) -> None:
         """
         Sets the fill color with a `red`, `green`, `blue` and `alpha` value.
         Each argument must a value float between 0 and 1.
@@ -1678,7 +1678,7 @@ def fill(self, r: float | None = None, g: float | None = None, b: float | None =
         self._fill = fill
         self._cmykFill = None
 
-    def stroke(self, r: float | None = None, g: float | None = None, b: float | None = None, alpha: float = 1):
+    def stroke(self, r: float | None = None, g: float | None = None, b: float | None = None, alpha: float = 1) -> None:
         """
         Sets the stroke color with a `red`, `green`, `blue` and `alpha` value.
         Each argument must a value float between 0 and 1.
@@ -1697,7 +1697,7 @@ def cmykFill(
         y: float | None = None,
         k: float | None = None,
         alpha: float = 1,
-    ):
+    ) -> None:
         """
         Set a fill using a CMYK color before drawing a shape. This is handy if the file is intended for print.
 
@@ -1730,39 +1730,39 @@ def cmykStroke(
         self._cmykStroke = cmykStroke
         self._stroke = None
 
-    def strokeWidth(self, strokeWidth: float):
+    def strokeWidth(self, strokeWidth: float) -> None:
         """
         Sets stroke width.
         """
         self._strokeWidth = strokeWidth
 
-    def align(self, align: str):
+    def align(self, align: str) -> None:
         """
         Sets the text alignment.
         Possible `align` values are: `left`, `center` and `right`.
         """
         self._align = align
 
-    def lineHeight(self, lineHeight: float):
+    def lineHeight(self, lineHeight: float) -> None:
         """
         Set the line height.
         """
         self._lineHeight = lineHeight
 
-    def tracking(self, tracking: float):
+    def tracking(self, tracking: float) -> None:
         """
         Set the tracking between characters. It adds an absolute number of
         points between the characters.
         """
         self._tracking = tracking
 
-    def baselineShift(self, baselineShift: float):
+    def baselineShift(self, baselineShift: float) -> None:
         """
         Set the shift of the baseline.
         """
         self._baselineShift = baselineShift
 
-    def underline(self, underline: str | None):
+    def underline(self, underline: str | None) -> None:
         """
         Set the underline value.
         Underline must be `single`, `thick`, `double` or `None`.
@@ -1771,7 +1771,7 @@ def underline(self, underline: str | None):
             raise DrawBotError("underline must be %s" % (", ".join(sorted(self._textUnderlineMap.keys()))))
         self._underline = underline
 
-    def strikethrough(self, strikethrough: str | None):
+    def strikethrough(self, strikethrough: str | None) -> None:
         """
         Set the strikethrough value.
         Strikethrough must be `single`, `thick`, `double` or `None`.
@@ -1780,7 +1780,7 @@ def strikethrough(self, strikethrough: str | None):
             raise DrawBotError("strikethrough must be %s" % (", ".join(sorted(self._textstrikethroughMap.keys()))))
         self._strikethrough = strikethrough
 
-    def url(self, url: str | None):
+    def url(self, url: str | None) -> None:
         """
         set the url value.
         url must be a string or `None`
@@ -1908,7 +1908,7 @@ def listNamedInstances(self, fontNameOrPath: SomePath | None = None, fontNumber:
         font = getNSFontFromNameOrPath(fontNameOrPath, 10, fontNumber)
         return variation.getNamedInstancesForFont(font)
 
-    def tabs(self, tab: tuple[float, str] | None, *tabs: tuple[float, str]):
+    def tabs(self, tab: tuple[float, str] | None, *tabs: tuple[float, str]) -> None:
         """
         Set tabs,tuples of (`float`, `alignment`)
         Aligment can be `"left"`, `"center"`, `"right"` or any other character.
@@ -1932,7 +1932,7 @@ def tabs(self, tab: tuple[float, str] | None, *tabs: tuple[float, str]):
             combinedTabs.extend(tabs)
             self._tabs = combinedTabs
 
-    def indent(self, indent: float):
+    def indent(self, indent: float) -> None:
         """
         Set indent of text left of the paragraph.
 
@@ -2005,7 +2005,7 @@ def indent(self, indent: float):
         """
         self._indent = indent
 
-    def tailIndent(self, indent: float):
+    def tailIndent(self, indent: float) -> None:
         """
         Set indent of text right of the paragraph.
 
@@ -2014,19 +2014,19 @@ def tailIndent(self, indent: float):
         """
         self._tailIndent = indent
 
-    def firstLineIndent(self, indent: float):
+    def firstLineIndent(self, indent: float) -> None:
         """
         Set indent of the text only for the first line.
         """
         self._firstLineIndent = indent
 
-    def paragraphTopSpacing(self, value: float):
+    def paragraphTopSpacing(self, value: float) -> None:
         """
         set paragraph spacing at the top.
         """
         self._paragraphTopSpacing = value
 
-    def paragraphBottomSpacing(self, value: float):
+    def paragraphBottomSpacing(self, value: float) -> None:
         """
         set paragraph spacing at the bottom.
         """

drawBot/context/tools/imageObject.py

@@ -1,15 +1,11 @@
-import AppKit  # type: ignore
-import Quartz  # type: ignore
-from math import radians
 import os
 from math import radians
-from typing import Any
-
-import AppKit
 from typing import Self
 
+import AppKit  # type: ignore
+import Quartz  # type: ignore
+
 from drawBot.aliases import BoundingBox, Point, RGBAColorTuple, Size, SomePath, TransformTuple
-from drawBot.context.baseContext import FormattedString
 from drawBot.context.imageContext import _makeBitmapImageRep
 from drawBot.misc import DrawBotError, optimizePath