hlUxSSKJr SSKJrJrJrJrJrJrJ r SSK r SSK r SSK J r SSKJr SSKJr SSKJrJr SSKJr "S S 5r"S S \ R5rSS jrSSjr"SS5rSr"SS5rSSjrSSjrSSjr SS Sjjr!SS!Sjjr"S"S#Sjjr#g)$) annotations)IterableIteratorCallableHashableSequenceUnionOptionalN)abc) DXFEntity)groupby)Vec3Vec2)EntityQueryParserc4\rSrSrSSjrS SjrSrSrSrg) _AttributeDescriptorcXlgNname)selfrs =/var/www/html/env/lib/python3.13/site-packages/ezdxf/query.py__init___AttributeDescriptor.__init__s Nc8URUR5$r) __getitem__r)robjobjtypes r__get___AttributeDescriptor.__get__styy))rc<URURU5 gr) __setitem__r)rrvalues r__set___AttributeDescriptor.__set__s  5)rc:URUR5 gr) __delitem__r)rrs r __delete___AttributeDescriptor.__delete__"s  "rr)rstrr) __name__ __module__ __qualname____firstlineno__rr!r&r*__static_attributes__rrrrs**#rrc\rSrSrSr\"S5r\"S5r\"S5r\"S5r \"S5r \"S5r \"S 5r \"S 5r S/S0S jjrS1S jrS2SjrSrSrSrS3SjrS4SjrSrSrSrSrSrSrSrSrSrSrSr Sr!S5S3S jjr"S6S!jr#S6S"jr$\%S#5r&\%S$5r'S7S8S%jjr(S7S9S&jjr)S7S9S'jjr*S:S;S(jjr+S EntityQuery&aC EntityQuery is a result container, which is filled with dxf entities matching the query string. It is possible to add entities to the container (extend), remove entities from the container and to filter the container. Query String ============ QueryString := EntityQuery ("[" AttribQuery "]")* The query string is the combination of two queries, first the required entity query and second the optional attribute query, enclosed in square brackets. Entity Query ------------ The entity query is a whitespace separated list of DXF entity names or the special name ``*``. Where ``*`` means all DXF entities, exclude some entity types by appending their names with a preceding ``!`` (e.g. all entities except LINE = ``* !LINE``). All DXF names have to be uppercase. Attribute Query --------------- The attribute query is used to select DXF entities by its DXF attributes. The attribute query is an addition to the entity query and matches only if the entity already match the entity query. The attribute query is a boolean expression, supported operators are: - not: !term is true, if term is false - and: term & term is true, if both terms are true - or: term | term is true, if one term is true - and arbitrary nested round brackets Attribute selection is a term: "name comparator value", where name is a DXF entity attribute in lowercase, value is a integer, float or double quoted string, valid comparators are: - "==" equal "value" - "!=" not equal "value" - "<" lower than "value" - "<=" lower or equal than "value" - ">" greater than "value" - ">=" greater or equal than "value" - "?" match regular expression "value" - "!?" does not match regular expression "value" Query Result ------------ The EntityQuery() class based on the abstract Sequence() class, contains all DXF entities of the source collection, which matches one name of the entity query AND the whole attribute query. If a DXF entity does not have or support a required attribute, the corresponding attribute search term is false. Examples: - 'LINE[text ? ".*"]' is always empty, because the LINE entity has no text attribute. - 'LINE CIRCLE[layer=="construction"]' => all LINE and CIRCLE entities on layer "construction" - '*[!(layer=="construction" & color<7)]' => all entities except those on layer == "construction" and color < 7 layercolorlinetype lineweightltscale invisible true_color transparencyNcSUlSUlU Uc/UlgUS:Xa[U5Ulg[ U5nUVs/sHoC"U5(dMUPM snUlgs snf)z Setup container with entities matching the initial query. Args: entities: sequence of wrapped DXF entities (at least GraphicEntity class) query: query string, see class documentation TN*)selected_dxf_attribute ignore_caseentitieslistentity_matcher)rrCquerymatchentitys rrEntityQuery.__init__ss_,.#  DM c\ NDM"5)E2:L(eFmV(LDMLs A%A%c,[UR5$)zReturns count of DXF entities.lenrCrs r__len__EntityQuery.__len__s4==!!rc,[UR5$)z&Returns iterable of DXFEntity objects.)iterrCrMs r__iter__EntityQuery.__iter__sDMM""rc[U[5(aURU5$URR U5$)zReturns DXFEntity at index `item`, supports negative indices and slicing. Returns all entities which support a specific DXF attribute, if `item` is a DXF attribute name as string. ) isinstancer,&_get_entities_with_supported_attributerCr)ritems rrEntityQuery.__getitem__s7 dC >>tD D}}((..rcf[U[5(d [S5eURX5 g)zOSet the DXF attribute `key` for all supported DXF entities to `value`. +key has to be a string (DXF attribute name)N)rUr, TypeError_set_dxf_attribute_for_all)rkeyr%s rr$EntityQuery.__setitem__s+#s##IJ J ''3rcf[U[5(d [S5eURU5 g)z@Discard the DXF attribute `key` from all supported DXF entities.rZN)rUr,r[_discard_dxf_attribute_for_all)rr]s rr)EntityQuery.__delitem__s)#s##IJ J ++C0rcxURVs/sHoR(dMUPM snUlU$s snf)zRemove destroyed entities.)rCis_alive)res rpurgeEntityQuery.purges+$(MM@MqZZM@  As77c`^URU4SjUR55nTUlU$)Nc3j># UH(oRRT5(dM$Uv M* g7fr)dxf is_supported).0rd attributes r EEntityQuery._get_entities_with_supported_attribute..s% $!(:(:9(EAA}s#3 3) __class__rCrA)rrlrFs ` rrV2EntityQuery._get_entities_with_supported_attributes3 }}  (1$ rcURHnURRX5 M! g![a M1f=fr)rCrisetAttributeError)rr]r%rds rr\&EntityQuery._set_dxf_attribute_for_alls9A  #%"  s 1 ??c`URHnURRU5 M gr)rCridiscard)rr]rds rr`*EntityQuery._discard_dxf_attribute_for_alls A EEMM# rczUR(d [S5eURU[R5$)zkEqual selector (self == other). Returns all entities where the selected DXF attribute is equal to `other`. no DXF attribute selected)rAr[_select_by_operatoroperatoreqrothers r__eq__EntityQuery.__eq__s0 **78 8''x{{;;rczUR(d [S5eURU[R5$)zsNot equal selector (self != other). Returns all entities where the selected DXF attribute is not equal to `other`. ry)rAr[rzr{ner}s r__ne__EntityQuery.__ne__s0**78 8''x{{;;rcxUR(d [S5eURU[RSS9$)zLess than selector (self < other). Returns all entities where the selected DXF attribute is less than `other`. Raises: TypeError: for vector based attributes like `center` or `insert` ryFvectors)rAr[rzr{ltr}s r__lt__EntityQuery.__lt__5**78 8''x{{E'JJrcxUR(d [S5eURU[RSS9$)zGreater than selector (self > other). Returns all entities where the selected DXF attribute is greater than `other`. Raises: TypeError: for vector based attributes like `center` or `insert` ryFr)rAr[rzr{gtr}s r__gt__EntityQuery.__gt__rrcxUR(d [S5eURU[RSS9$)zLess equal selector (self <= other). Returns all entities where the selected DXF attribute is less or equal `other`. Raises: TypeError: for vector based attributes like `center` or `insert` ryFr)rAr[rzr{ler}s r__le__EntityQuery.__le__rrcxUR(d [S5eURU[RSS9$)zGreater equal selector (self >= other). Returns all entities where the selected DXF attribute is greater or equal `other`. Raises: TypeError: for vector based attributes like `center` or `insert` ryFr)rAr[rzr{ger}s r__ge__EntityQuery.__ge__rrcZ[U[5(aURU5$[$)z"Union operator, see :meth:`union`.)rUr4unionNotImplementedr}s r__or__EntityQuery.__or__s$ e[ ) )::e$ $rcZ[U[5(aURU5$[$)z0Intersection operator, see :meth:`intersection`.)rUr4 intersectionrr}s r__and__EntityQuery.__and__s& e[ ) )$$U+ +rcZ[U[5(aURU5$[$)z,Difference operator, see :meth:`difference`.)rUr4 differencerr}s r__sub__EntityQuery.__sub__ s$ e[ ) )??5) )rcZ[U[5(aURU5$[$)z@Symmetric difference operator, see :meth:`symmetric_difference`.)rUr4symmetric_differencerr}s r__xor__EntityQuery.__xor__s& e[ ) ),,U3 3rcURnUR(a%[U[5(aUR 5nUR 5nXElUR nU(aUR HnURRU5nU(d?[U[[45(a$[S[UR5SU35eUR(a%[U[5(aUR 5nU"X5(dMURU5 M U$![a Mf=f)Nzunsupported operation 'z' for DXF attribute )rArBrUr,lowerrorCri get_defaultrsrrr[r-append) rr%oprrlrFrCrH entity_values rrzEntityQuery._select_by_operators //    5# 6 6KKME '0$>> --#)::#9#9)#DL:lT4L#I#I#1#bkk2B1CD%%.K1## <(E(E#/#5#5#7Ll**OOF+( &s<D99 EEc2^U4SjnTRX5$)zReturns all entities where the selected DXF attribute matches the regular expression `pattern`. Raises: TypeError: for non-string based attributes c>[U[5(aURU5SL$[STR35e)Nz2cannot apply regular expression to DXF attribute: )rUr,rGr[rA)r%regexrs rrG EntityQuery.match..match;sE%%%{{5)55D../1 r) _regex_match)rpatternrGs` rrGEntityQuery.match2s   00rcURnSUlU(a[ROSnURS5(dUS- nUR [R "XS9U5nX0lU$)NFr$flags)rBre IGNORECASEendswithrzcompile)rrfuncrBre_flagsresults rrEntityQuery._regex_matchEsi&&  $/2==Q$$ sNG)) JJw / ' rcV[UR5(aURS$g)zFirst entity or ``None``.rNrKrMs rfirstEntityQuery.firstSs% t}}  ==# #rcV[UR5(aURS$g)zLast entity or ``None``.NrKrMs rlastEntityQuery.last[s% t}}  ==$ $rcdURURX55RUlU$)zUExtent the :class:`EntityQuery` container by entities matching an additional query. )rrorC)rrCrFs rextendEntityQuery.extendcs( 4>>(#BCLL  rczURURURU55RUlU$)zYRemove all entities from :class:`EntityQuery` container matching this additional query. )rrorCrrFs rremoveEntityQuery.removeos5  NN4==% 0 (  rc:URURU5$)zReturns a new :class:`EntityQuery` container with all entities matching this additional query. Raises: pyparsing.ParseException: query string parsing error )rorCrs rrFEntityQuery.queryys~~dmmU33rc.[URX5$)aReturns a dict of entity lists, where entities are grouped by a DXF attribute or a key function. Args: dxfattrib: grouping DXF attribute as string like ``'layer'`` key: key function, which accepts a DXFEntity as argument, returns grouping key of this entity or ``None`` for ignore this object. Reason for ignoring: a queried DXF attribute is not supported by this entity )r rC)r dxfattribr]s rr EntityQuery.groupbys t}}i55rcJUR[XR55$)aHReturns a new :class:`EntityQuery` with all entities from this container for which the callable `func` returns ``True``. Build your own operator to filter by attributes which are not DXF attributes or to build complex queries:: result = msp.query().filter( lambda e: hasattr(e, "rgb") and e.rbg == (0, 0, 0) ) )rofilterrC)rrs rrEntityQuery.filters~~fT==9::rcvUR[UR5[UR5-5$)zsReturns a new :class:`EntityQuery` with entities from `self` and `other`. All entities are unique - no duplicates. rorrrCr}s rrEntityQuery.union*~~c$--03u~~3FFGGrcvUR[UR5[UR5-5$)zOReturns a new :class:`EntityQuery` with entities common to `self` and `other`. rr}s rrEntityQuery.intersectionrrcvUR[UR5[UR5- 5$)zZReturns a new :class:`EntityQuery` with all entities from `self` that are not in `other`. rr}s rrEntityQuery.differencerrcvUR[UR5[UR5- 5$)z[Returns a new :class:`EntityQuery` with entities in either `self` or `other` but not both. rr}s rr EntityQuery.symmetric_differencerr)rCrBrANr@)rCOptional[Iterable[DXFEntity]]rFr,)returnint)rIterator[DXFEntity])rr4)rlr,rr4)T)rr,rr4r@)rCIterable[DXFEntity]rFr,rr4)rFr,rr4)r?N)rr,r]z)Optional[Callable[[DXFEntity], Hashable]]rzdict[Hashable, list[DXFEntity]])rCallable[[DXFEntity], bool]rr4)r~r4rr4)2r-r.r/r0__doc__rr6r7r8r9r:r;r<r=rrNrRrr$r)rerVr\r`rrrrrrrrrrrzrGrpropertyrrrrrFr rrrrrr1r2rrr4r4&sAF ! )E  )E#J/H%l3J"9-G$[1I%l3J'7LLOM5MEHM2"#/41   << K K K K    21&  %    49=6676 ) 6$ ;H H H Hrr4c^^[R"USS9n[UR5m[ UR UR 5mSUU4SjjnU$)NT)parseAllc2>T"U5=(a T"U5$rr2)rHattrib_matcherentity_matcher_s rmatcherentity_matcher..matchersv&A>&+AArrHr rbool)r parseStringbuild_entity_name_matcherr4build_entity_attributes_matcher AttribQueryAttribQueryOptions)rF query_argsrrrs @@rrErEsS"..utDJ/ 0F0FGO4 = =NBB NrcH^SU4Sjjn[SRU5S9mU$)Nc0>T"UR55$r)dxftype)rd_matchs rrG(build_entity_name_matcher..matchsaiik""r )rF)rdr rr) name_matcherjoin)namesrGrs @rrrs!# 0F Lrc \rSrSr\R \R \R\R\R\RSSS.r \ "\ R55rS SjrS SjrSrg) Relationic(URU5SL$rrGrdrs rRelation.sekk!nD8rc(URU5SL$rrr s rr r su{{1~5r)z==z!=z>=?z!?cUup4nX0l[RUUlU(a[OSUlU(a[ ROSnSU;a[ R"US-US9Ul gUR U5Ul g)NcU$rr2xs rr #Relation.__init__..s1rrrrr) dxf_attribr CMP_OPERATORScompareto_lower convert_caserrrr%)rrelationrBrrr%rs rrRelation.__init__so"%--b1 (3H$/2==Q "9 8DJ**51DJrcURURRUR55nUR X R 5$![ a g[a gf=f)NF)rrirrrr%rs ValueError)rrHr%s revaluateRelation.evaluatesZ %%fjj&<&>rc`\rSrSr\R \R S.rSSjrSr S Sjr Sr g) BoolExpressioni)&|cXlgrtokens)rr+s rrBoolExpression.__init__s rc,[UR5$r)rQr+rMs rrRBoolExpression.__iter__sDKK  rcD[UR[5(aURRU5$/n/nURHGn[ US5(a"UR URU55 M6UR U5 MI UR 5 UHfnUS:XaUR5(+nO6[RU"UR5UR55nUR U5 Mh UR5$)Nr!) rUr+rrr$rreversepopr& OPERATORS)rrHvalues operatorstokenrr%s rrBoolExpression.evaluates  KK  ;;''/ / [[Euj)) ennV45  ' ! BSy"JJL(&004VZZ\6::<P MM%  zz|rr*N)r+rr) r-r.r/r0r{and_or_r3rrRrr1r2rrr&r&s& ]] \\I !rr&c SSjn[U[5(aU$[U5nU"U5(a [X5$[ UVs/sHn[ X15PM sn5$s snf)NcX[U5S:H=(a US[R;$)N)rLrr"r*s r is_relation$_compile_tokens..is_relation!s%6{aMF1I1M1M$MMr)r+rrr)rUr,tuplerr&_compile_tokens)r+rBr>r6s rrArAsbN&# 6]F6,,>D EfU_U 0f E  Es A%cp^[U5(dS$SU:Hn[[X55mSU4SjjnU$)Ncg)NTr2rs rr 1build_entity_attributes_matcher..4sric&>TRU5$r)r)rHexprs rmatch_bool_expr8build_entity_attributes_matcher..match_bool_expr8s}}V$$rr)rLr&rA)r+optionsrBrHrGs @rrr0s9 v;;.K /&> ?D% rc#j# [5nUHnX!;dM URU5 Uv M! g7f)zCYield all unique entities, order of all entities will be preserved.N)rradd)rCdonerHs runique_entitiesrN>s-5D   HHV Ls33c2^[U5mU4SjU5$)aFilters `names` by `query` string. The `query` string of entity names divided by spaces. The special name "*" matches any given name, a preceding "!" means exclude this name. Excluding names is only useful if the match any name is also given (e.g. "LINE !CIRCLE" is equal to just "LINE", where "* !CIRCLE" matches everything except CIRCLE"). Args: names: iterable of names to test query: query string of entity names separated by spaces Returns: yield matching names c3F># UHnT"U5(dMUv M g7frr2)rkrrGs rrmname_query..Vs 2UTeDkDDUs! !)r)rrFrGs @r name_queryrRGs  E 2U 22rc:^^^SUUU4Sjjn[UR5R55nSm[5m[5mUHJnUS:XaSmM URS5(aTR USS5 M9TR U5 ML U$)Nc&>T(aUT;$UT;$rr2)rdexcludeincludetake_alls rrGname_matcher..matchZs G# #< rFr@Tr0r=)rdr,rr)rruppersplit startswithrL)rFrG match_stringsrrUrVrWs @@@rrrYs   ++-.MHeGeG 3;H __S ! ! KKQR ! KK   Lrc[X5$)zStart a new query based on sequence `entities`. The `entities` argument has to be an iterable of :class:`~ezdxf.entities.DXFEntity` or inherited objects and returns an :class:`EntityQuery` object. )r4)rCrFs rnewr^os x ''r)rFr,rr)rz Sequence[str]rr)r+zUnion[str, Sequence]rBrrz$Union[str, Relation, BoolExpression])r+rrJr,rr)rCrrrr)rz Iterable[str]rFr,rz Iterator[str])rFr,rzCallable[[str], bool]r)rCrrFr,rr4)$ __future__rtypingrrrrrr r rr{ collectionsr ezdxf.entities.dxfentityr ezdxf.groupbyr ezdxf.mathrrezdxf.queryparserrrr4rErrrr&rArrNrRrr^r2rrrfs# .!!/ # #RH#,,RHj   ""J?  F  /3 ) $   "   3$.BE(+(;>((r