ܖi}ddlmZmZddlmZddlmZddlmZddlm Z m Z m Z ddl m Z mZddlmZddlZdd lmZd d lmZd d lmZd d lmZmZd dlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&d dl'm(Z(ddl)m*Z*m+Z+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3ddl4m5Z5ddl6m7Z7m8Z8ddl9m:Z:m;Z;mm?Z?m@Z@mAZAddlBmCZCddlDmEZEmFZFmGZGddlHmIZIe rddlJmKZKejGddeMeZNejd Gd!d"ZPejd Gd#d$ZQejhd%d&Gd'd(ZRy))) GeneratorIterable)datetime)Enum)chain) TYPE_CHECKINGOptionalUnion)UUIDuuid4)warnN) SortedSet)ComparableTuple) get_now_utc))LicenseExpressionAlongWithOthersException#UnknownComponentDependencyException)SchemaVersion1Dot0SchemaVersion1Dot1SchemaVersion1Dot2SchemaVersion1Dot3SchemaVersion1Dot4SchemaVersion1Dot5SchemaVersion1Dot6SchemaVersion1Dot7) UrnUuidHelper)_BOM_LINK_PREFIXExternalReferenceProperty)BomRef) Component)OrganizationalContactOrganizationalEntity) Definitions) Dependable Dependency)LicenseLicenseExpressionLicenseRepository%_LicenseRepositorySerializationHelper) LifecycleLifecycleRepository_LifecycleRepositoryHelper)Service)ToolToolRepository_ToolRepositoryHelper) Vulnerability) PackageURLc$eZdZdZdZdZdZdZdZy)TlpClassificationaT Enum object that defines the Traffic Light Protocol (TLP) classification that controls the sharing and distribution of the data that the BOM describes. .. note:: Introduced in CycloneDX v1.7 .. note:: See the CycloneDX Schema definition: https://cyclonedx.org/docs/1.7/xml/#type_tlpClassificationType CLEARGREENAMBERAMBER_AND_STRICTREDN) __name__ __module__ __qualname____doc__r7r8r9r:r;W/var/www/html/content-pipeline/venv/lib/python3.12/site-packages/cyclonedx/model/bom.pyr6r6<s#  E E E) CrAr6T)%ignore_unknown_during_deserializationceZdZdZdddeeddfdZeejddefdZ e jdeddfd Z de fd Z d edefd Zd edefd ZdefdZdefdZy)DistributionConstraintsam Our internal representation of the `distributionConstraints` complex type. Conditions and constraints governing the sharing and distribution of the data or components described by this BOM. .. note:: Introduced in CycloneDX v1.7 .. note:: See the CycloneDX Schema definition: https://cyclonedx.org/docs/1.7/xml/#type_metadata NtlprGreturnc6|xstj|_yN)r6r7rGselfrGs rB__init__z DistributionConstraints.__init__]s1+11rArc|jS)z The Traffic Light Protocol (TLP) classification that controls the sharing and distribution of the data that the BOM describes. Returns: `TlpClassification` enum value _tlprLs rBrGzDistributionConstraints.tlpcsyyrAc||_yrJrOrKs rBrGzDistributionConstraints.tlpos  rAc,t|jSrJ)_ComparableTuplerGrQs rB__comparable_tuplez*DistributionConstraints.__comparable_tupless))rAothercft|tr!|j|jk(SyNF) isinstancerE*_DistributionConstraints__comparable_tuplerLrVs rB__eq__zDistributionConstraints.__eq__vs- e4 5**,0H0H0JJ JrAcpt|tr!|j|jkStSrJ)rYrErZNotImplementedr[s rB__lt__zDistributionConstraints.__lt__{s0 e4 5**,u/G/G/II IrAc4t|jSrJ)hashrZrQs rB__hash__z DistributionConstraints.__hash__D++-..rAc"d|jdS)NzrFrQs rB__repr__z DistributionConstraints.__repr__s.txxj::rA)r<r=r>r?r r6rMproperty serializable xml_sequencerGsetterrTrZobjectboolr\r_intrbstrrfr@rArBrErEPs ,02 ' (2 2 \q!&" ZZ(T*$4*Ft Ft /#/;#;rArEc: eZdZdZdddddddddddd deeeeefdeee dee dee deee d eee d eed ee d eeed eedee ddfdZeej(ej*j,ej.ddefdZej2d eddfdZeej4eej4eej4eej(eej.ddefdZ e j2d eeddfdZ eej(e!ej.ddefdZ"e"j2deeeefddfdZ"eejFejHjJdej.dd:dZ&e&j2dee ddfdZ&eej.ddee fdZ'e'j2dee ddfd Z'eej4e(ej4e)ej4e*ej4eej4eej4eej.d!dee fd"Z+e+j2dee ddfd#Z+eej4eej4eej.d$dee fd%Z,e,j2d ee ddfd&Z,eej.d'dee fd(Z-e-j2dee ddfd)Z-eej4e)ej4e*ej4eej4eej4eej(e.ej.d*de/fd+Z0e0j2dee ddfd,Z0eej4e)ej4e*ej4eej4eej4eejFejHjJd-ej.d.d;d/Z1e1j2d ee ddfd0Z1eej4eej.d1deefd2Z2e2j2d eeddfd3Z2de3fd4Z4d5e5de6fd6Z7d5e5de6fd7Z8de9fd8Z:de;fd9Zr?r r rr0r1r#r"r$r(r rr,rErMrgrh type_mappinghelpers XsdDateTimerirwrjviewrrrr.r-ryr2rq xml_arrayXmlArraySerializationTypeNESTEDrrrsrrrr{rxrtr+r*rurvrzrTrrkrlr\r_rmrbrnrfr@rArBrprpsBF=A)-370437(,7;48FJ6:'htnn<=>'(#89:'I& ' /0 ' 8G,- 'Xh/0'H%'34'Xi01'#++B"C'23' '8\|33??@\q!8"A$8$$$\)*\)*\)*\9:\q! / ";+++  ;Xi%8;T;;\45\q!~"6 \\-5$!?@-T-- \LBBII8T\q! "U  ^^+x(=>+4++\q!8I." $8I#6 $4 $ $\)*\)*\)*\)*\)*\)*\q!!X&:;!"++++++! (x0D'E ($ ( (\)*\)*\q! "h';< ""++ "*2F)G*D**\q! (#78 " __"*>!?"D""\)*\)*\)*\)*\)*\DE\q!+"F+++++__5'!25t55\)*\)*\)*\)*\)*\LBBII:V\r"  #W+++++  1Xh%71D11\)*\r".(3J*K.#+.$$BJaAbBgkB%B $4 Ft Ft /#/W#WrArp>$schema bom_format spec_version)ignore_during_deserializationrCceZdZdZddddddddddd deeedeeedeeedee d e d ee d eee d eee d eeedeeddfdZeej&eej*eej*eej*eej*eej*eej*eej*eej:de fdZej>de ddfdZeej:de fdZ e j>d e ddfdZ eej*eej*eej*eej*eej*eej*eejBdde fdZ"e"j>d e ddfdZ"eejFe$ejFeejJejLjNdejBddGdZ(e(j>deeddfdZ(eej*eej*eej*eej*eej*eej*eejJejLjNdejBddHdZ)e)j>deeddfdZ)eej*eej*eej*eej*eej*eej*eej*eejJejLjNd ejBd!dId"Z*e*j>deeddfd#Z*eej*eej*eej*eej*eej*eej*eejJejLjNd$ejBd%dJd&Z+e+j>d ee ddfd'Z+eej*eej*eej*eejJejLjNd(ejBd)dKd*Z,e,j>d eeddfd+Z,eej*eej*eej*eej*eejJejLjNd,ejBd-dLd/Z-e-j>d ee ddfd0Z-eej*eej*eejBd1deefd2Z.e.j>deddfd3Z.d4ed5deefd6Z/de0fd7Z1dede2fd8Z3de4eddffd9Z5d:e6dd.fd;Z7de2fd<Z8dMd=e9d>eee9ddfd?Z:de0fd@Z;de2fdAZdCe?de2fdDZ@de fdEZAde0fdFZBy)NBoma! This is our internal representation of a bill-of-materials (BOM). Once you have an instance of `cyclonedx.model.bom.Bom`, you can pass this to an instance of `cyclonedx.output.BaseOutput` to produce a CycloneDX document according to a specific schema version and format. Nr) componentsservicesexternal_references serial_numberversionmetadata dependenciesvulnerabilitiesrv definitionsrrrrrrrrrvrrHc |xs t|_||_|xs t|_|xsg|_|xsg|_|xsg|_|xsg|_|xsg|_ | xsg|_ | xs t|_ y)z Create a new Bom that you can manually/programmatically add data to later. Returns: New, empty `cyclonedx.model.bom.Bom` instance. N) r rrrprrrrrrrvr%r) rLrrrrrrrrrvrs rBrMz Bom.__init__s&+5eg  1KM $* B #6#<" .4"(.B$*&7+-rAc|jS)zt Unique UUID for this BOM Returns: `UUID` instance `UUID` instance _serial_numberrQs rBrzBom.serial_numbers$"""rAc||_yrJr)rLrs rBrzBom.serial_numbers +rAc|jSrJ_versionrQs rBrz Bom.versions}}rAc||_yrJr)rLrs rBrz Bom.versions  rArc|jS)a Get our internal metadata object for this Bom. Returns: Metadata object instance for this Bom. .. note:: See the CycloneDX Schema for Bom metadata: https://cyclonedx.org/docs/1.7/xml/#type_metadata  _metadatarQs rBrz Bom.metadatas$~~rAc||_yrJr)rLrs rBrz Bom.metadatarrArsc|jS)z} Get all the Components currently in this Bom. Returns: Set of `Component` in this Bom ) _componentsrQs rBrzBom.components srAc$t||_yrJ)rr)rLrs rBrzBom.componentsrrAservicec|jS)zy Get all the Services currently in this Bom. Returns: Set of `Service` in this BOM ) _servicesrQs rBrz Bom.servicess ~~rAc$t||_yrJ)rr)rLrs rBrz Bom.services0s"8,rA reference(c|jS)z Provides the ability to document external references related to the BOM or to the project the BOM describes. Returns: Set of `ExternalReference` )_external_referencesrQs rBrzBom.external_references4s"(((rAc$t||_yrJ)rr)rLrs rBrzBom.external_referencesGs$-.A$B!rA dependency2c|jSrJ) _dependenciesrQs rBrzBom.dependenciesKs!!!rAc$t||_yrJ)rr)rLrs rBrzBom.dependenciesWs&|4rArgFc|jS)a Provides the ability to document properties in a name/value store. This provides flexibility to include data not officially supported in the standard without having to use additional namespaces or create extensions. Property names of interest to the general public are encouraged to be registered in the CycloneDX Property Taxonomy - https://github.com/CycloneDX/cyclonedx-property-taxonomy. Formal registration is OPTIONAL. Return: Set of `Property` rrQs rBrvzBom.propertieshs$rAc$t||_yrJrrs rBrvzBom.properties|rrA vulnerabilityPSortedSet[Vulnerability]c|jS)zp Get all the Vulnerabilities in this BOM. Returns: Set of `Vulnerability` )_vulnerabilitiesrQs rBrzBom.vulnerabilitiess$$$rAc$t||_yrJ)rr)rLrs rBrzBom.vulnerabilitiess )/ :rAncbt|jjdkDr |jSdS)z\ The repository for definitions Returns: `Definitions` rN)len _definitions standardsrQs rBrzBom.definitionss-%((9(9(C(C$Dq$Ht  RdRrAc||_yrJ)r)rLrs rBrzBom.definitionss 'rApurlr4c|r<|jDcgc]}|j|k(s|}}t|dk(r|dSycc}w)a  Get a Component already in the Bom by its PURL Args: purl: An instance of `packageurl.PackageURL` to look and find `Component`. Returns: `Component` or `None` .. deprecated:: next rrN)rrr)rLrxfounds rBget_component_by_purlzBom.get_component_by_purlsE  $B1166T>QBEB5zQQx Cs AAc.|jjS)z Get the unique reference for this Bom. Returns: URN formatted UUID that uniquely identified this Bom instance. .. deprecated:: next )rurnrQs rB get_urn_uuidzBom.get_urn_uuids!!%%%rAc||jvS)ab Check whether this Bom contains the provided Component. Args: component: The instance of `cyclonedx.model.component.Component` to check if this Bom contains. Returns: `bool` - `True` if the supplied Component is part of this Bom, `False` otherwise. .. deprecated:: next )rrs rB has_componentzBom.has_componentsDOO++rAc#K|jjr.|jjjdEd{|jD]}|jdEd{y707 w)NT include_self)rrsget_all_nested_componentsr)rLcs rB_get_all_componentszBom._get_all_componentssk == " "}}..HHVZH[ [ [ FA222E E E F \ Es$AA7A3(A7+A5,A75A7bom_refct}|jD]>}|jD]-}|j|jk(s|j |/@|S)a  Get all known Vulnerabilities that affect the supplied bom_ref. Args: bom_ref: `BomRef` Returns: `SortedSet` of `Vulnerability` .. deprecated:: next Deprecated without any replacement. )rraffectsrefvalueadd)rLrrvtargets rBget_vulnerabilities_for_bom_refz#Bom.get_vulnerabilities_for_bom_refsY5>K%% +A)) +::.#''* + +rAc,t|jS)a Check whether this Bom has any declared vulnerabilities. Returns: `bool` - `True` if this Bom has at least one Vulnerability, `False` otherwise. .. deprecated:: next Deprecated without any replacement. )rlrrQs rBhas_vulnerabilitieszBom.has_vulnerabilitiessD(())rAr depends_onc Zttfd|jd}|r)|rf|jjt d|n?|j j tj|r t d|ng|r|D]}|j|dyy)Nc6|jjk(SrJ)rr)_drs rBz)Bom.register_dependency..sBFFfnn$<rAc.t|jSNrr'r)rs rBr z)Bom.register_dependency..sjRZZ6PrAc.t|jSr"r$)_deps rBr z)Bom.register_dependency..sjT\\.JrA)rr)rr) nextfilterrupdatemaprrr'rregister_dependency)rLrrr_d2s ` rBr+zBom.register_dependencys &O>OPRV W &&s+PR\']^    " ":NN[eS!JJWkm$  ! F(((E F rAcDt|jd|jS)zV .. deprecated:: next Deprecated without any replacement. /)rrrrQs rBrzBom.urn!s% ##D$6$6#7qGGrAc jjr&jjjjD]}j|jD]}j|t t djt t djz}t tdjDtjdjD}||z }t|dkDrtd|jjrntjdkDrVtt fdjs4td jjjd t d tjgjjr&jjj#d ngtjdjDjD]E}t|j$d kDstd|j$Ds9t'd|y )a  Perform data-model level validations to make sure we have some known data integrity prior to attempting output of this `Bom` Returns: `bool` .. deprecated:: next Deprecated without any replacement. )rc|jSrJr)rs rBr zBom.validate..>s qyyrAc|jSrJr1)ss rBr zBom.validate..?s !))rAc34K|]}|jywrJr#.0ds rB zBom.validate..As .qQUU .sc3<K|]}|jywrJ)dependencies_as_bom_refsr5s rBr8zBom.validate..BsX : : <XrzsOne or more Components have Dependency references to Components/Services that are not known in this BOM. They are: c|jjjjk(xrt |j dkDS)Nr)rrrsrrr)r7rLs rBr zBom.validate..Ms4aeet}}66>>>Z3q~~CVYZCZrAz%The Component this BOM is describing z has no defined dependencies which means the Dependency Graph is incomplete - you should add direct dependencies to this "root" Component to complete the Dependency Graph data.r)category stacklevelTr c3@K|]}|jdyw)Tr N)r)r6rs rBr8zBom.validate..]shST ; ; ; Nhsc3<K|]}t|tywrJ)rYr))r6lis rBr8zBom.validate..`s-hTVj=N.O-hr;z7Found LicenseExpression along with others licenses in: )rrsr+rrsetr*rrr from_iterablerranyr r UserWarningrrur)rL_c_scomponent_bom_refsdependency_bom_refsdependency_diffelems` rBvalidatez Bom.validate)sF == " "  $ $DMM,C,C $ D// 0B  $ $B $ / 0-- 0B  $ $B $ / 0!%8$:R:R:T!UVY\ #T]] 3Z55!% .D-- .   XdFWFWX X#  .0BB  ! #5""1!245 5 == " "s4??';a'?C Z   M I  7 8O8O8T8T7UVJJ%   ]]OTXTaTaTkTkDMM # # = =4 = Pqs   hX\XgXgh h MM   XD 4==!A%#-hZ^ZgZg-h*h?MdXVXX XrAc Jt|j|j|jt|jt|j t|j t|jt|jt|jf SrJ) rTrrrrrrrrvrrQs rBrUzBom.__comparable_tuplefs}    dmm=M>!"24=="A T55 68H!!9#$4T__$E T11 2 !   rArVcft|tr!|j|jk(SyrX)rYr_Bom__comparable_tupler[s rBr\z Bom.__eq__os, eS !**,0H0H0JJ JrAc4t|jSrJ)rarOrQs rBrbz Bom.__hash__trcrAc:d|jdt|dS)Nz r?r rr"r/rr rmrpr'r3r r%rMrgrhrrrrrrrrrr xml_attributerrjrrir include_nonerrrrrrrrrvrrrrnrrlr rrr!rrr&r+rrLrTrOrkr\rbrfr@rArBrrs 5904EI(,*.7;=A37-18Xi0188G,-8&h/@&AB 8  ~ 8  8;'8x 348"(="9:8Xh/08k*8 8<\}-\)*\)*\)*\)*\)*\)*\)*\!#t#"+++++++.#,4,D,,\!" ^^ s t  \)*\)*\)*\)*\)*\)*\r" + #++++++ __""""\12\12\LBBII;W\r" #X33  1Xi%81T11\)*\)*\)*\)*\)*\)*\LBBII9U\r"#V++++++__-'!2-t--\)*\)*\)*\)*\)*\)*\)*\LBBII;W\r")#X+++++++)Cx@Q7RCW[C C\)*\)*\)*\)*\)*\)*\LBBII<X\r""#Y++++++"5*)=5$55 \)*\)*\)*\LBBII:V\r"  #W+++  1Xh%71D11\)*\)*\)*\)*\LBBII?[\r"%#\++++%;x /F;4;;2\)*\)*\s#SXk2S$++S({(t(((<*@XiEX( &c & ,y ,T ,FYy$/D%EF vB\( *T *F*F(8T^K_B`FlpF$HSH;$;z $4 Ft /#/E#ErAr)Scollections.abcrrrenumr itertoolsrtypingrr r uuidr r warningsr py_serializablerhsortedcontainersr_internal.comparerrT_internal.timerr}exception.modelrr schema.schemarrrrrrrr serializationrrrr rr!rsr"contactr#r$ definitionr%rr&r'licenser(r)r*r+ lifecycler,r-r.rr/toolr0r1r2rr3 packageurlr4serializable_enumrnr6serializable_classrErprr@rArBrjs$&011&&C8l   *;; @#.iiQQ==(%T &!  tL3;3;M3;l!  tL\W\WM\W~!  #+/  KEKE  KErA