Merge pull request #1097 from jdegenstein/deprecate_arcs

Deprecate some Arcs (e.g. ArcArcTangentArc)

.readthedocs.yaml

@@ -10,6 +10,10 @@ build:
     python: "3.10"
   apt_packages:
     - graphviz
+  jobs:
+    post_checkout:
+      # necessary to ensure that the development builds get a correct version tag
+      - git fetch --unshallow || true
 
 # Build from the docs/ directory with Sphinx
 sphinx:
@@ -21,8 +25,3 @@ python:
       path: .
       extra_requirements:
         - docs
-
-# Explicitly set the version of Python and its requirements
-# python:
-#   install:
-#     - requirements: docs/requirements.txt

src/build123d/objects_curve.py

@@ -29,6 +29,7 @@ license:
 from __future__ import annotations
 
 import copy as copy_module
+import warnings
 import numpy as np
 import sympy  # type: ignore
 from collections.abc import Iterable
@@ -1362,6 +1363,12 @@ class PointArcTangentLine(BaseEdgeObject):
         mode (Mode, optional): combination mode. Defaults to Mode.ADD
     """
 
+    warnings.warn(
+        "The 'PointArcTangentLine' object is deprecated and will be removed in a future version.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
     _applies_to = [BuildLine._tag]
 
     def __init__(
@@ -1441,6 +1448,12 @@ class PointArcTangentArc(BaseEdgeObject):
         RuntimeError: No tangent arc found
     """
 
+    warnings.warn(
+        "The 'PointArcTangentArc' object is deprecated and will be removed in a future version.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
     _applies_to = [BuildLine._tag]
 
     def __init__(
@@ -1584,6 +1597,11 @@ class ArcArcTangentLine(BaseEdgeObject):
             Defaults to Keep.INSIDE
         mode (Mode, optional): combination mode. Defaults to Mode.ADD
     """
+    warnings.warn(
+        "The 'ArcArcTangentLine' object is deprecated and will be removed in a future version.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
 
     _applies_to = [BuildLine._tag]
 
@@ -1685,6 +1703,12 @@ class ArcArcTangentArc(BaseEdgeObject):
         mode (Mode, optional): combination mode. Defaults to Mode.ADD
     """
 
+    warnings.warn(
+        "The 'ArcArcTangentArc' object is deprecated and will be removed in a future version.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
     _applies_to = [BuildLine._tag]
 
     def __init__(