Rename add_trace to add_line_trace for consistency

docs/80_code_generation/10_gerber.md

@@ -64,7 +64,7 @@ For full reference of shapes available in `PadCreator` check out
 
 [`GerberX3Builder`](../reference/pygerber/builder/gerber.md#pygerber.builder.gerber.GerberX3Builder)
 class also provides means to add traces to the Gerber image. You can use
-[`new_trace()`](../reference/pygerber/builder/gerber.md#pygerber.builder.gerber.GerberX3Builder.add_trace)
+[`new_trace()`](../reference/pygerber/builder/gerber.md#pygerber.builder.gerber.GerberX3Builder.add_line_trace)
 and
 [`add_clockwise_arc_trace()`](../reference/pygerber/builder/gerber.md#pygerber.builder.gerber.GerberX3Builder.add_clockwise_arc_trace)
 methods to do that. Fist one creates a straight lines, second one creates arcs. You
@@ -95,10 +95,10 @@ with PyGerber:
 
 ## Using objects as locations
 
-Commands creating graphical elements, like `add_pad()` or `add_trace()` return special
-`Draw` objects (`PadDraw` or `TraceDraw` respectively) which can be used as locations
-for `new_pad()` or `new_trace()` method calls. This way you don not have to retype
-coordinates for draws which are connected to previous objects.
+Commands creating graphical elements, like `add_pad()` or `add_line_trace()` return
+special `Draw` objects (`PadDraw` or `TraceDraw` respectively) which can be used as
+locations for `new_pad()` or `new_trace()` method calls. This way you don not have to
+retype coordinates for draws which are connected to previous objects.
 
 !!! warning
 

src/pygerber/builder/gerber.py

@@ -163,8 +163,8 @@ def add_pad(
             Previously defined pad object to be used for drawing.
         at : Loc2D | TraceDraw
             Location to flash at. Can be a 2-tuple of floats or TraceDraw object
-            returned from `add_trace()` or `add_clockwise_arc_trace()`, then the end
-            location of that trace will be used.
+            returned from `add_line_trace()` or `add_clockwise_arc_trace()`, then the
+            end location of that trace will be used.
         rotation : float, optional
             Pad rotation (rotation around pad origin), by default 0.0
         mirror_x : bool, optional
@@ -288,8 +288,8 @@ def add_cutout_pad(
             Previously defined pad object to be used for drawing.
         at : Loc2D | TraceDraw
             Location to flash at. Can be a 2-tuple of floats or TraceDraw object
-            returned from `add_trace()` or `add_clockwise_arc_trace()`, then the end
-            location of that trace will be used.
+            returned from `add_line_trace()` or `add_clockwise_arc_trace()`, then the
+            end location of that trace will be used.
         rotation : float, optional
             Pad rotation (rotation around pad origin), by default 0.0
         mirror_x : bool, optional
@@ -335,7 +335,7 @@ def add_cutout_pad(
         self._add_draw(draw)
         return draw
 
-    def add_trace(
+    def add_line_trace(
         self,
         width: float,
         begin: Loc2D | PadDraw | TraceDraw,

src/pygerber/gerber/pygments.py

@@ -98,7 +98,7 @@ class PyGerberDocsLexer(PythonLexer):
                 "new_pad": Name.Function,
                 "add_pad": Name.Function,
                 "add_cutout_pad": Name.Function,
-                "add_trace": Name.Function,
+                "add_line_trace": Name.Function,
                 "add_clockwise_arc_trace": Name.Function,
                 "add_counter_clockwise_arc_trace": Name.Function,
                 "get_code": Name.Function,

test/examples/builder/gerber/_10_circle_pad_and_trace.ex.py

@@ -5,8 +5,8 @@
 
 d10 = builder.new_pad().circle(diameter=0.5)
 builder.add_pad(d10, (2, 1))
-builder.add_trace(0.1, (0, 0), (0, 1))
-builder.add_trace(0.1, (0, 1), (2, 1))
+builder.add_line_trace(0.1, (0, 0), (0, 1))
+builder.add_line_trace(0.1, (0, 1), (2, 1))
 
 code = builder.get_code()
 print(code.dumps())

test/examples/builder/gerber/_11_circle_pad_and_trace_with_reuse.ex.py

@@ -8,8 +8,8 @@
 pad_0 = builder.add_pad(d10, (0, 0))
 pad_1 = builder.add_pad(d10, (2, 1))
 
-trace_0 = builder.add_trace(0.1, pad_0, (0, 1))
-builder.add_trace(0.1, trace_0, pad_1)
+trace_0 = builder.add_line_trace(0.1, pad_0, (0, 1))
+builder.add_line_trace(0.1, trace_0, pad_1)
 
 
 code = builder.get_code()

test/test_builder/test_gerber.py

@@ -615,7 +615,7 @@ def test_two_complicated(
 
 class TestTraces:
     def test_one_trace(self, builder: GerberX3Builder, default_header: str) -> None:
-        builder.add_trace(0.1, (0, 0), (1, 1))
+        builder.add_line_trace(0.1, (0, 0), (1, 1))
         assert (
             builder.get_code().dumps()
             == f"""{default_header}
@@ -632,8 +632,8 @@ def test_one_trace(self, builder: GerberX3Builder, default_header: str) -> None:
     def test_two_traces_same_width(
         self, builder: GerberX3Builder, default_header: str
     ) -> None:
-        builder.add_trace(0.1, (0, 0), (1, 1))
-        builder.add_trace(0.1, (1, 1), (1, 2))
+        builder.add_line_trace(0.1, (0, 0), (1, 1))
+        builder.add_line_trace(0.1, (1, 1), (1, 2))
         assert (
             builder.get_code().dumps()
             == f"""{default_header}
@@ -651,8 +651,8 @@ def test_two_traces_same_width(
     def test_two_traces_different_width(
         self, builder: GerberX3Builder, default_header: str
     ) -> None:
-        builder.add_trace(0.1, (0, 0), (1, 1))
-        builder.add_trace(0.2, (1, 1), (1, 2))
+        builder.add_line_trace(0.1, (0, 0), (1, 1))
+        builder.add_line_trace(0.2, (1, 1), (1, 2))
         assert (
             builder.get_code().dumps()
             == f"""{default_header}
@@ -670,9 +670,9 @@ def test_two_traces_different_width(
         )
 
     def test_three_traces(self, builder: GerberX3Builder, default_header: str) -> None:
-        builder.add_trace(0.1, (0, 0), (1, 1))
-        builder.add_trace(0.2, (1, 1), (1, 2))
-        builder.add_trace(0.1, (1, 2), (2, 1))
+        builder.add_line_trace(0.1, (0, 0), (1, 1))
+        builder.add_line_trace(0.2, (1, 1), (1, 2))
+        builder.add_line_trace(0.1, (1, 2), (2, 1))
         assert (
             builder.get_code().dumps()
             == f"""{default_header}
@@ -694,8 +694,8 @@ def test_three_traces(self, builder: GerberX3Builder, default_header: str) -> No
     def test_two_traces_discontinued(
         self, builder: GerberX3Builder, default_header: str
     ) -> None:
-        builder.add_trace(0.1, (0, 0), (1, 1))
-        builder.add_trace(0.1, (2, 2), (3, 3))
+        builder.add_line_trace(0.1, (0, 0), (1, 1))
+        builder.add_line_trace(0.1, (2, 2), (3, 3))
         assert (
             builder.get_code().dumps()
             == f"""{default_header}
@@ -719,7 +719,7 @@ def test_trace_connect_two_pads(
         pad0 = builder.add_pad(pad, (0, 0))
         pad1 = builder.add_pad(pad, (2, 2))
 
-        builder.add_trace(0.1, pad0, pad1)
+        builder.add_line_trace(0.1, pad0, pad1)
 
         assert (
             builder.get_code().dumps()
@@ -746,8 +746,8 @@ def test_two_trace_connect_two_pads(
         pad0 = builder.add_pad(pad, (0, 0))
         pad1 = builder.add_pad(pad, (2, 2))
 
-        trace0 = builder.add_trace(0.1, pad0, (1, 1))
-        builder.add_trace(0.1, trace0, pad1)
+        trace0 = builder.add_line_trace(0.1, pad0, (1, 1))
+        builder.add_line_trace(0.1, trace0, pad1)
 
         assert (
             builder.get_code().dumps()