^j dZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z mZddlmZddlmZmZmZddlmZmZmZmZmZmZdd lmZdd lmZdd l m!Z!m"Z"m#Z#m$Z$dd l%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+dd l,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:ejvdjyejzejvdZ>dZ?dZ@de@zZAde@zZBde@zZCdeCzZDeCdz ZEe$jeBeCz e$jeBeDz e$j~eBe?z e$jeBe@z e$jeBeAz e$jdiZFdZGdeGzZHdeGzZIdZJedeeKeZLdDdZMidgddgddgdddgddgd gdd!d"gd#dgd$dgd%d"gd&d"gd'gdd(gdd)gdd*dgd+dgd,gddggddd"gdgd-ZNed.d/0ZO ed1e30ZP Gd2d/e eePZQ dE dFd3ZRGd4d5ZSGd6d7eSZTGd8d9eSZUGd:d;eSZVGd<d=eSZWGd>d?ZXed@ZY dGdAZZeZeQjZ[eZeQjZ\eZeQjZ]eZeQjZ^eZeQjZ_eZeQjZ`eZeQjZaeZeQjZbeZeQjZceZeQjZddHdBZee>jdCeee)je)_geee)je)_hy)Ia build123d Common name: build_common.py by: Gumyr date: July 12th 2022 desc: This is a Python code defining a class hierarchy for building CAD models. The code defines an abstract base class Builder with three concrete subclasses BuildLine, BuildPart, and BuildSketch in separate modules. The Builder class has several methods for adding and retrieving geometric shapes such as vertices, edges, faces, and solids. It also has a method _add_to_pending for adding shapes to a pending list that will be integrated into the final model later. The class has a _get_context method for retrieving the current Builder instance and a validate_inputs method for validating input shapes. The code also defines a validate_inputs function that takes a Builder instance and validates the input shapes. license: Copyright 2022 Gumyr Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ) annotationsN)ABCabstractmethod)CallableIterable)product)cospisqrt)AnyGenericTypeTypeVarcastoverload)Standard_ConstructionError)Self)AlignModeSelectUnit)AxisLocationPlaneVector VectorLiketo_align_offset)CompoundCurveEdgeFaceJointPartShape ShapeListSketchSolidVertexWire new_edgestuplify build123dgMbP? igffffff9@ gXzY|@cJt|txrtd|DS)z$Identify points as tuples of numbersc3HK|]}t|ttfywN) isinstanceintfloat).0items O/opt/ringagent/.cad-venv/lib/python3.12/site-packages/build123d/build_common.py z_is_point..s *+/ 4#u&*s ")r3tupleall)objs r8 _is_pointr=s* c5 ! c*36*'Tct}|D]V}t|tttt fr#t |s|jt|F|j|X|S)zNConvert a sequence of object potentially containing iterables into a flat list) r%r3listr:filtersetr=extendflatten_sequenceappend)r< flat_listr7s r8rErEs_!* I# dT5&#6 7 $   -t4 5   T " # r>add) BuildPart BuildSketch BuildLine bounding_boxchamferdraftrIextrudefillet full_roundrJloftmake_brake_formed make_face make_hullmirroroffsetprojectproject_workplanerevolvescale)sectionsplitsweepthickenBBuilder)boundShapeTceZdZUdZej dZded<dZdZ e jd d'dZ e ed(dZej ed)d Ze d*d Ze d+d Zd,d Zd ZdZeddd-dZe d. d/dZdde jd d0dZej6fd1dZej6fd2dZej6fd3dZej6fd4dZej6fd5dZ ej6fd6dZ!ej6fd7dZ"ej6fd8dZ#ej6fd9dZ$ej6fd:dZ% d; draaBuilder Base class for the build123d Builders. Args: workplanes: sequence of Union[Face, Plane, Location]: set plane(s) to work on mode (Mode, optional): combination mode. Defaults to Mode.ADD. Attributes: mode (Mode): builder's combination mode workplanes (list[Plane]): active workplanes builder_parent (Builder): build to pass objects to on exit zBuilder._currentzcontextvars.ContextVar[Builder]_currentNonemodec||_tj|}|r|ntjg|_d|_tj}|J|jJ|jj|_ d|_ d|_ tgtgtgt gi|_d|_g|_d|_g|_yr2)rh WorkplaneList_convert_to_planesrXY workplanes _reset_tokinspect currentframef_back _python_frame parent_framebuilder_parentr(r r!r'lastsworkplanes_contextexit_workplanes obj_before to_combine)selfrhrmplanes current_frames r8__init__zBuilder.__init__s  11*=$*& =A,,. (((##///*1188 .2"Bb$E2F "&,.(,')r>ct)zObject to pass to parentNotImplementedErrorrzs r8_objz Builder._objs "!r>ctr2r)rzvalues r8rz Builder._objs "!r>cf|jr$|jjjSdS)z(Maximum size of object in all directions)rrLdiagonalrs r8 max_dimensionzBuilder.max_dimensions(59IItyy%%'00F3Fr>c|j tS|jgn |jg}t||jzd|jiS)z(Edges that changed during last operationcombined)rr%rxr*ry)rz before_lists r8r*zBuilder.new_edgessJ 99 ;  OO3b$//9J ;8NDIINNr>c&tj}tj}|r|r|j|j k(nd}|r||_nd|_|jj||_ tjdt|j|j|rdnd|jr't!|jj#|_|St!t&j(j#|_|S)zBUpon entering record the parent and a token to restore contextvarsFNz7Entering %s with mode=%s which is in %s scope as parentsame different)ra _get_contextrorprrrqrtrerCrnloggerinfotype__name__rhrmrj __enter__rvrrl)rzbuilder_contextr| same_scopes r8rzBuilder.__enter__s+2*>*>*@,,. =  ) )]-A-A A  "1D "&D --++D1 E J   II Fk   ??&3T__&E&O&O&QD # '4EHH&=&G&G&ID # r>cy)z!Any builder specific exit actionsNrs r8 _exit_extraszBuilder._exit_extras)sr>c|jj|j|j|j|j t jk7rtjdt|jj|jHtjds1tj |j"d|j$dd|jj'|j|j t(j+j,|_|j,r|j0j3dddtj5d t|jy) z6Upon exiting restore context and send object to parentNzTransferring object(s) to %sr-z is None - z didn't create anything) stacklevelrgz Exiting %s)reresetrnrrtrhrPRIVATErdebugrrrsysexc_infowarningswarn _obj_name_tag_add_to_contextrjrrmrwrv__exit__rrzexception_typeexception_value tracebacks r8rzBuilder.__exit__,s DOO,     *tyyDLL/H LL.T5H5H0I0R0R yy ): ~~&k$)) L$t*"5"56r>N) face_planectS)zTcT|jjd}|dnt|j}|rct |t t ttfr|jj}nt |tr|}nd}tjd||tt|S)z*Return the instance of the current builderNrfz%s context requested by %s)regetrrr3r#r&rr) __class__strrrrr`)clscallerlogresult context_name caller_names r8rzBuilder._get_contextKs!!$'!'vT&\5J5J &4"=>$..77 FC($ $ KK4lK PAvr>)faces_to_pendingcleanrhc V|j|_t||_|tj k7r)t |dkDrtttttfDcic]}|gc}}tttttfD]"}|Dcgc]}t||s|c}||<$td|jD}t ||k7rjtj dsSt#||jD chc] } | D]} |  c} } z } | dhk7rt%|j&d| |tD]@} ttttfD]%} || j)| j+| 'B|j&dk(rg}|tD]}|j-t.j0sd t/dd|j3 }|j9|}|j;t=dd|j?j@ f|j3j@dkDr|jC||jC| ||t<|tD](}|tj)|jE*|s(|tj)|tg|t<i}tFtttfD]5}|j t#nt#|jI|||<7||jJrltLjOd t ||jJ||}|tjPk(r|jjt ||jJdk(r||jJd}nO||jJjSjT||jJ}d }n|jjT||jJ}d }n|tjVk(r@|j tYd |jjZ||jJ}d }n|tj\k(rK|j tYd|jj_t||jJ}d }n:|tj`k(r'|jct||jJ}|jc|_n.t|tr|jc||_n||_|j!|r|jje|_tLjgdt ||jJ|tFtttfD]m}|j t#nt#|jI|}|jJ|k(rti||nti|||z |jj|<o|j|t|jtr+|jc|jjl|_n7|jct|jIjl|_|j&dk(rq|jn|ttpjsjtD]9}|tDcgc]}|jw|}}|jn|d|i;y|j&dk(r|jn|tyyyycc}wcc}wcc} } w#t4t$t6f$rt/d|j3 }YwxYwcc}w)aAdd objects to Builder instance Core method to interface with Builder instance. Input sequence of objects is parsed into lists of edges, faces, and solids. Edges and faces are added to pending lists. Solids are combined with current part. Each operation generates a list of vertices, edges, faces, and solids that have changed during this operation. These lists are only guaranteed to be valid up until the next operation as subsequent operations can eliminate these objects. Args: objects (Union[Edge, Wire, Face, Solid, Compound]): sequence of objects to add faces_to_pending (bool, optional): add faces to pending_faces. Default to True. clean (bool, optional): Remove extraneous internal structure. Defaults to True. mode (Mode, optional): combination mode. Defaults to Mode.ADD. Raises: ValueError: Invalid input ValueError: Nothing to intersect with ValueError: Nothing to intersect with rc32K|]}t|ywr2)len)r6ts r8r9z*Builder._add_to_context..s<SV>#34 5$e ##E$K0 d CdE2 R$(II$5353t||C?P;QC RT[[! Qdkk*+ $ 488#yy(uT[[12a7',T[['9!'dkk 2 6 6 8 = =uT[[?Q R%+0K#1499>>53E#F&+ T]]*yy(*+EFF,tyy}}eDKK.@AH"'KT^^+yy(*+FGG#yy228E$++#TL#T(D((,I5IJm+$$$eDk2,g%5  IM .T.!*:7QRX$)(BTBTBV$WEXZ$Us0" ] ]%#]%]*]0^&0/^#"^#cg}|tjk(rO|jgn|jj}|D]!}|j |j #na|tj k(r|jt}n:|tjk(r tdtdtjtt|S)a Return Vertices Return either all or the vertices created during the last operation. Args: select (Select, optional): Vertex selector. Defaults to Select.ALL. Returns: ShapeList[Vertex]: Vertices extracted Select.NEW only valid for edges%Invalid input, must be one of Select.)rALLrrrDverticesLASTrur(NEWr_member_names_r%rC)rzselect vertex_list obj_edgesobj_edges r8rzBuilder.verticess%' VZZ "ii/TYY__5FI% 8""8#4#4#67 8 v{{ "**V,K vzz !>? ?78M8M7NO [)**r>cj|j|}t|}|dk7rtd||dS)zReturn Vertex Return a vertex. Args: select (Select, optional): Vertex selector. Defaults to Select.ALL. Returns: Vertex: Vertex extracted r-z#Expected exactly one vertex, found r)rrr)rzr all_vertices vertex_counts r8vertexzBuilder.vertex4sA}}V, <( 1 B<.QR RAr>c|tjk(r;|j tn|jj }t|S|tj k(r|j t}t|S|tjk(r|j}t|Stdtj)zReturn Edges Return either all or the edges created during the last operation. Args: select (Select, optional): Edge selector. Defaults to Select.ALL. Returns: ShapeList[Edge]: Edges extracted r) rrrr%rrrur rr*rr)rzr edge_lists r8rz Builder.edgesEs VZZ '+yy'8 diioo>OI##v{{ " 4(I## vzz !I ##78M8M7NO r>cj|j|}t|}|dk7rtd||dS)zReturn Edge Return an edge. Args: select (Select, optional): Edge selector. Defaults to Select.ALL. Returns: Edge: Edge extracted r-z!Expected exactly one edge, found r)rrr)rzr all_edges edge_counts r8edgez Builder.edge\?JJv& ^ ?@ MN N|r>c|tjk(r;|j tn|jj }t|S|tj k(r1t j|jt}t|S|tjk(r tdtdtj)zReturn Wires Return either all or the wires created during the last operation. Args: select (Select, optional): Wire selector. Defaults to Select.ALL. Returns: ShapeList[Wire]: Wires extracted rr) rrrr%wiresrr)combinerur rrr)rzr wire_lists r8rz Builder.wiresms VZZ '+yy'8 diioo>OI##v{{ " TZZ%56I## vzz !>? ?78M8M7NO r>cj|j|}t|}|dk7rtd||dS)zReturn Wire Return a wire. Args: select (Select, optional): Wire selector. Defaults to Select.ALL. Returns: Wire: Wire extracted r-z!Expected exactly one wire, found r)rrr)rzr all_wires wire_counts r8wirez Builder.wirerr>ct|tjk(r;|j tn|jj }t|S|tj k(r|j t}t|S|tjk(r tdtdtj)zReturn Faces Return either all or the faces created during the last operation. Args: select (Select, optional): Face selector. Defaults to Select.ALL. Returns: ShapeList[Face]: Faces extracted rr) rrrr%facesrrur!rrr)rzr face_lists r8rz Builder.facess VZZ '+yy'8 diioo>OI##v{{ " 4(I## vzz !>? ?78M8M7NO r>cj|j|}t|}|dk7rtd||dS)zReturn Face Return a face. Args: select (Select, optional): Face selector. Defaults to Select.ALL. Returns: Face: Face extracted r-z!Expected exactly one face, found r)rrr)rzr all_faces face_counts r8facez Builder.facerr>ct|tjk(r;|j tn|jj }t|S|tj k(r|j t}t|S|tjk(r tdtdtj)aReturn Solids Return either all or the solids created during the last operation. Args: select (Select, optional): Solid selector. Defaults to Select.ALL. Returns: ShapeList[Solid]: Solids extracted rr) rrrr%solidsrrur'rrr)rzr solid_lists r8rzBuilder.solidss VZZ (, (9tyy?O?O?QJ$$v{{ "E*J$$ vzz !>? ?78M8M7NO r>cj|j|}t|}|dk7rtd||dS)zReturn Solid Return a solid. Args: select (Select, optional): Solid selector. Defaults to Select.ALL. Returns: Solid: Solid extracted r-z"Expected exactly one solid, found r)rrr)rzr all_solids solid_counts r8solidz Builder.solids@[[( *o ! A+OP P!}r>cz| |jn|}|j tS|tk(r|jj S|t k(r|jj S|tk(r|jjS|tk(r|jjStS)zExtract Shapes) rrr%r(rr rr!rr'r)rzobj_types r8rzBuilder._shapess #+"24;; 99 ;  v 99%%' ' t 99??$ $ t 99??$ $ u 99##% %{r>c |sg}nt|ts|g}t|tttt fru|j |jvr]t|jjd|jjd|jjd|jdt|tr8|jjt|vrtd|dt|d|D]d}t|tr|n|jj}|.t|tr?t|dt|jd |d y) z5Validate that objects/operations and parameters applyz doesn't have a z object or operation (z applies to )(z doesn't apply to Nrz, did you intend =?)r3rr#r&rr)r _applies_torrrroperations_apply_tor$r)rzvalidating_classrr< operations r8validate_inputszBuilder.validate_inputssx GGX.iG '$t)D E !1!=!==>>**++;#--6678$..778 EUEaEaDbbce  ' -''/BCS/TT$%%78KL\8]7^^_`  C.4!%//88  {U+" k!1$s)2D2D1EF114Q8 r>c`t|jjd|jd)z5Raise an error for invalid boolean combine operationszc is a builder of Shapes and can't be combined. The object being constructed is accessible via the 'z ' attribute.)rrrrrs r8_invalid_combinezBuilder._invalid_combine!s5~~&&'(| -  r>c"|jS)z Invalid addr'rz_others r8__add__zBuilder.__add__)$$&&r>c"|jS)z Invalid subr)r*s r8__sub__zBuilder.__sub__-r-r>c"|jS)z Invalid andr)r*s r8__and__zBuilder.__and__1r-r>c td|jjd|d|jjd|jd|d )z;The user is likely trying to reference the builder's object'z' has no attribute 'z'. Did you intend '..z'?)AttributeErrorrrr)rznames r8 __getattr__zBuilder.__getattr__5sX''((>:J!D6QS U  r>)rmFace | Plane | Locationrhr)returnz Shape | None)rr#r9rf)r9r5)r9ShapeList[Edge])r9r)rz Edge | Facerz Plane | None)NT)rzType[B]rz$Builder | Shape | Joint | str | Nonerboolr9zB | None)rz%Edge | Wire | Face | Solid | Compoundrr;rr;rhr)rrr9zShapeList[Vertex])rrr9r()rrr9r:)rrr9r )rrr9zShapeList[Wire])rrr9r))rrr9zShapeList[Face])rrr9r!)rrr9zShapeList[Solid])rrr9r'r2)rz;Type[Vertex] | Type[Edge] | Type[Face] | Type[Solid] | Noner9r%)rzShape | Iterable[Shape] | None)-r __module__ __qualname____doc__ contextvars ContextVarre__annotations__rrrrr}propertyrrsetterrr*rrrr classmethodrrrrrrrrrr rrrrrr%r'r,r/r1r7rr>r8raras: $1G 0F0F1H- DIXX*,***"" [[""GGOO#J074PT##8< 4  ."&XX v37v3v3 v3  v3t)/ +4'-jj"&,ZZ$.%+JJ"&,ZZ$.%+JJ"&,ZZ$.%+JJ"'-jj%.&,ZZ&QUM (KO')G'R ''' r>c.|y|j||y)zDA function to wrap the method when used outside of a Builder contextN)r%)contextr#rs r8r%r%=s  0':r>c|eZdZUdZej dZded<ed dZ d dZ dZ dZ d Z ed Zy ) LocationLista`Location Context A stateful context of active locations. At least one must be active at all time. Note that local locations are stored and global locations are returned as a property of the local locations and the currently active workplanes. Args: locations (list[Location]): list of locations to add to the context zContextList._currentz$contextvars.ContextVar[LocationList]rectj}|r |jntjg}|Dcgc]"}|j D]}|j |z$}}}|Scc}}w)z:Current local locations globalized with current workplanes)rjrrmrrllocal_locationslocation)rzrFrmrlocal_locationglobal_locationss r8 locationszLocationList.locationsYsx ,,.+2W'' $ "&"6"6  NN^ + +     s'A%c d|_||_yr2)rnrJ)rzrNs r8r}zLocationList.__init__es(r>c|jj||_tj dt |j t|j|j|S)3Upon entering create a token to restore contextvarsz%s is pushing %d points: %s) rerCrnrrrrrrJrs r8rzLocationList.__enter__isR--++D1 ) J   $$ %    r>c|jj|jtj dt |j t|jy)Upon exiting restore contextz%s is popping %d pointsN) rerrnrrrrrrJrs r8rzLocationList.__exit__us@ DOO, %tDz':':C@T@Tc,t|jSr2)iterrNrs r8__iter__zLocationList.__iter__|sDNN##r>c8|jjdS)z/Return the instance of the current LocationListNrerrs r8rzLocationList._get_context||%%r>N)r9list[Location])rNr[)rr<r=r>r?r@rerArBrNr}rrrVrDrrr>r8rHrHGsc 6L[5K5K6H2    )  $&&r>rHcheZdZdZdej ej ff dfd ZxZS) HexLocationsauLocation Context: Hex Array Creates a context of hexagon array of locations for Part or Sketch. When creating hex locations for an array of circles, set `radius` to the radius of the circle plus one half the spacing between the circles. Args: radius (float): distance from origin to vertices (major), or optionally from the origin to side (minor or apothem) with major_radius = False x_count (int): number of points ( > 0 ) y_count (int): number of points ( > 0 ) major_radius (bool): If True the radius is the major radius, else the radius is the minor radius (also known as inscribed radius). Defaults to False. align (Union[Align, tuple[Align, Align]], optional): align min, center, or max of object. Defaults to (Align.CENTER, Align.CENTER). Attributes: radius (float): distance from origin to vertices (major), or optionally from the origin to side (minor or apothem) with major_radius = False apothem (float): radius of the inscribed circle, also known as minor radius x_count (int): number of points ( > 0 ) y_count (int): number of points ( > 0 ) major_radius (bool): If True the radius is the major radius, else the radius is the minor radius (also known as inscribed radius). align (Union[Align, tuple[Align, Align]]): align min, center, or max of object. diagonal (float): major radius local_locations (list{Location}): locations relative to workplane Raises: ValueError: Spacing and count must be > 0 Fc |rd|z}|ttdz z}nd|ztdz }|}d|zdz }|tdzdz } |dks| dks |dks|dkr td||_||_||_||_||_||_ t|d|_ tt} td|dD]9} t|D])} | jt|| z| | z| dz z+;td|dD]6} t|D]&} | jt|| z| | z| z(8| j!t"j$| j!t"j&g} | ddj$| ddj$z | ddj&| ddj&z g}t| ddj$| ddj&}t)d ||}t| Dcgc]}|t|z|z c}} | Dcgc] }t+|}}t,j/||_t2|i|j0ycc}wcc}w) Nrrr-zSpacing and count must be > 0 rr)r r r rradiusapothemrx_county_count major_radiusr+alignr%rrangerFsort_byrXYrr Locations_move_to_existingrJsuperr})rzrdrfrgrhrirre x_spacing y_spacingpointsx_valy_val sorted_pointssize min_corner align_offsetpointrJrs r8r}zHexLocations.__init__s 6zHs26{*G6zDG+HGL1$ tAw&* >Y!^w{gk=> >      (UA& 6"$1gq) Ew  9u,i%.?)a-.OP   1gq) XEw X fY%6 E8II8UVW X X  /1GH  ! R " "]1%5a%8%:%: : ! R " "]1%5a%8%:%: : M!,Q/11=3CA3F3H3HI 'vtU; EK LEUV\* *Z 7 L  9??u8E???(::   --. M@s I7/I<) rdr5rfr4rgr4rhr;riAlign | tuple[Align, Align]rr<r=r>rCENTERr} __classcell__rs@r8r]r]s_!P#.3llELL-I B/B/B/ B/  B/ + B/B/r>r]cDeZdZdZ d dfd ZxZS)PolarLocationsaLocation Context: Polar Array Creates a context of polar array of locations for Part or Sketch Args: radius (float): array radius count (int): Number of points to push start_angle (float, optional): angle to first point from +ve X axis. Defaults to 0.0. angular_range (float, optional): magnitude of array from start angle. Defaults to 360.0. rotate (bool, optional): Align locations with arc tangents. Defaults to True. endpoint (bool, optional): If True, `start_angle` + `angular_range` is the last sample. Otherwise, it is not included. Defaults to False. Attributes: local_locations (list{Location}): locations relative to workplane Raises: ValueError: Count must be greater than or equal to 1 c |dkrtd||dk(rd}n||t|z z }g}t|D]`} |jt t |dj tj||| zzt ddd||| z|zzbtj||_ t |5|jy)Nr-(At least 1 elements required, requested rr)rr4rjrFrrrotaterrrnrorJrpr}) rzrdcount start_angle angular_rangerendpoint angle_steprJirs r8r}zPolarLocations.__init__s 19GwOP P A:J&%#h-*?@Ju A  " "61%,,TVV[:PQ>5QR1aOj1n{:;   )::   --.r>)rgv@TF) rdr5rr4rr5rr5rr;rr;)rr<r=r>r}r~rs@r8rrsZ0!$/// /  /  ///r>rc:eZdZdZ dfd ZeddZxZS)rnaALocation Context: Push Points Creates a context of locations for Part or Sketch Args: pts (Union[VectorLike, Vertex, Location, Face, Plane, Axis] or iterable of same): sequence of points to push Attributes: local_locations (list{Location}): locations relative to workplane c<g}t|D]Z}t|tr|j|&t|tr|jt|Qt|t r$|jtt |t|t r$|jtt |t|tr|jt|t|tr|j|jt|tr%|jtt|Ftdt|tj||_t |E|jy)NzLocations doesn't accept type )rEr3rrFrr(r:rrrKr!rrrnrorJrpr})rzptsrJrzrs r8r}zLocations.__init__3s3%s+ QE%*&&u-E6*&&x7E6*&&xu '>?E5)&&xu '>?E5)&&x7E4(&&u~~6E4(&&xe '=> #A$u+!OPP! Q$ )::   --.r>cg}tjGtjjD]$}|j|Dcgc]}||z c}&|S|}|Scc}w)a_move_to_existing Move as a group the local locations to any existing locations Note that existing polar locations may be rotated so this rotates the group not the individuals. Args: local_locations (list[Location]): location group to move to existing locations Returns: list[Location]: group of locations moved to existing locations as a group )rHrrJrD)rJlocation_group group_centerrs r8rozLocations._move_to_existingWsq  $ $ & 2 , 9 9 ; K K S %%&QA|a'7&QR S-N'Rs A" )rzuVectorLike | Vertex | Location | Face | Plane | Axis | Iterable[VectorLike | Vertex | Location | Face | Plane | Axis])rJr[r9r[)rr<r=r>r} staticmethodror~rs@r8rnrn%s- "/ M"/Hr>rncfeZdZdZej ej ff dfd ZxZS) GridLocationsaLocation Context: Rectangular Array Creates a context of rectangular array of locations for Part or Sketch Args: x_spacing (float): horizontal spacing y_spacing (float): vertical spacing x_count (int): number of horizontal points y_count (int): number of vertical points align (Union[Align, tuple[Align, Align]], optional): align min, center, or max of object. Defaults to (Align.CENTER, Align.CENTER). Attributes: x_spacing (float): horizontal spacing y_spacing (float): vertical spacing x_count (int): number of horizontal points y_count (int): number of vertical points align (Union[Align, tuple[Align, Align]]): align min, center, or max of object. local_locations (list{Location}): locations relative to workplane Raises: ValueError: Either x or y count must be greater than or equal to one. c L|dks|dkrtd|d|||_||_||_||_t |d|_||dz z||dz zg}t||_td||}||_ |j|jz|_ tt|t|D cgc]#\}} t|t||z| |zz%} }} tj!| |_g|_t& |Q|j"ycc} }w)Nr-rz, rrc)rrqrrrfrgr+rirrwrminmaxrrjrrnrorJr{rpr}) rzrqrrrfrgrirwryrjrJrs r8r}zGridLocations.__init__s; Q;'A+:7)2gYO #"  UA& Wq[)9! +DEDM &vtU; 88dii' gg?  1  M M      )::  $&  --.  s:(D ) rqr5rrr5rfr4rgr4rir{r|rs@r8rrmsUB/4llELL-I */*/*/ */  */ + */*/r>rceZdZUdZej dZded<ddZe ddZ dZ dZ d Z ed Zeedd Zeedd Zedd Zy)rjaWorkplane Context A stateful context of active workplanes. At least one must be active at all time. Args: workplanes (sequence of Union[Face, Plane, Location]): objects to become planes Attributes: workplanes (list[Plane]): list of workplanes zWorkplaneList._currentz%contextvars.ContextVar[WorkplaneList]recTd|_tj||_d|_yr2)rnrjrkrmlocations_context)rzrms r8r}zWorkplaneList.__init__s#':::F!%r>ct|}g}|D]k}t|tr|j|%t|tt fr|jt|Vt dt||S)zTranslate objects to planeszWorkplaneList does not accept )rEr3rrFrr!rr)objsr{r<s r8rkz WorkplaneList._convert_to_planessw & OC#u% c"C(D!12 eCj) #A$s)!MNN  O r>c6|jj||_tj dt |j t|j|jtttgj|_ |S)rQz%s is pushing %d workplanes: %s)rerCrnrrrrrrmrHrrrrrs r8rzWorkplaneList.__enter__sn--++D1 - J    OO  ".x/A.B!C!M!M!O r>c|jj|j|jj dddt j dt|jt|jy)rSNz%s is popping %d workplanes) rerrnrrrrrrrrmrs r8rzWorkplaneList.__exit__sV DOO, ''dD9 )4:+>+>DOO@T r>c,t|jSr2)rUrmrs r8rVzWorkplaneList.__iter__sDOO$$r>c8|jjdS)z.Return the instance of the current ContextListNrXrYs r8rzWorkplaneList._get_contextrZr>cyr2rrrss r8localizezWorkplaneList.localizes58r>cyr2rrs r8rzWorkplaneList.localizesc tj|Dcgc] }t|}}ng}tjjd}|Dcgc]E}t |t r(t t|jt|n t|G}}t|dk(r|j|dn|j|t|dk(r|dS|Scc}wcc}w)zLocalize a sequence of points to the active workplane (only used by BuildLine where there is only one active workplane) The return value is conditional: - 1 point -> Vector - >1 points -> list[Vector] rr-) rjrrrmr3r:rrrrFrD)rrsppoints_per_workplane workplanept localized_ptss r8rzWorkplaneList.localizes  % % ' /7=#>!F1I#> #>#% %224??BI!  ""e,!r?r@rerAr}rrkrrrVrDrrrrr>r8rjrjs 7Mk6L6L 7H3&     %&&88 ??$$r>rjT2cdtjtjfdfd }|S)ao Wraps a Builder method to automatically provide the Builder context. This function creates a wrapper around the provided Builder method (`func`) that automatically retrieves the current Builder context and passes it as the first argument to the method. This allows the method to be called without explicitly providing the Builder context. Args: func (Callable[[Builder, Select], T2]): The Builder method to be wrapped. - The method must take a `Builder` instance as its first argument and a `Select` instance as its second argument. Returns: Callable[T2]: A callable that takes only a `Select` argument and internally retrieves the Builder context to call the original method. Raises: RuntimeError: If no Builder context is available when the returned function is called. ctjj}|tjd||S)Nz,() requires a Builder context to be in scope)rarrr)rrFfuncs r8getterz.__gen_context_component_getter..getter=sI#*"6"6t}}"E ?==/!MN GV$$r>)rrr9r) functoolswrapsrr)rrs` r8__gen_context_component_getterr$s.2__T & %% Mr>cdfd }|S)Nct|trD tjjdj }tj ||z }||S#t$rYwxYw)Nr)r3r:rjrrmrrr5)rzvecr original_ops r8wrapperz(_vector_add_sub_wrapper..wrapper^si c5 ! &335@@CJJ#,,S1F:4%%"  sAA A+*A+)rzrrrr)rrs` r8_vector_add_sub_wrapperr]s & Nr>z-monkey-patching `Vector.add` and `Vector.sub`)r<r?r9zShapeList[Any]r2)rFzBuilder | NonerzIterable[Shape] | None)rzCallable[[Builder, Select], T2]r9zCallable[[Select], T2])rz&Callable[[Vector, VectorLike], Vector])ir> __future__rr?rrologgingrrabcrrcollections.abcrr itertoolsrmathr r r typingr r rrrr OCP.Standardrtyping_extensionsrbuild123d.build_enumsrrrrbuild123d.geometryrrrrrrbuild123d.topologyrrr r!r"r#r$r%r&r'r(r)r*r+ getLogger addHandler NullHandlerrMCMMCMMINFTTHOUUNITS_PER_METERGKGLBr=rAr?rEr"r`rcrar%rHr]rrnrrjrrrrrrrrrr rrrrrHsubrr>r8rs'R# #.>>3";;*+))*='*=*=*?@   ; '  "W2I BY"W Dy GGQVGGQVGGQVGGQVGGQVFFA  AX] Cd3i   4=8 k]   }   7 =/ [M+-- 7 78+  }!" 6#$} 6= )}+0 Cy!  '*@  c76?@  HRV; ;8N;;&;&|f/<f/R4/\4/nE EPF/LF/Rg$g$V T]$ )$$P *'*:*: ;&w}}5&w}}5&w}}5 ' 7 ' 7%gll3%gll3%gll3&w}}5  <= $VZZ 0 $VZZ 0 r>