IiASSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SSKJr SSKJr SSKJrJrJr \R,"\5r"SS \5rS S jrg) )absolute_importN)six)errors)get_ip_port_afi)Future)BrokerMetadataPartitionMetadataTopicPartitionc\rSrSrSrSS/S.rSrSrSrS r S r S r S r S r SrSrSrSrSrSr\S5rSSjrSrSrSrSrSrSrSrSrg) ClusterMetadataa A class to manage kafka cluster metadata. This class does not perform any IO. It simply updates internal state given API responses (MetadataResponse, FindCoordinatorResponse). Keyword Arguments: retry_backoff_ms (int): Milliseconds to backoff when retrying on errors. Default: 100. metadata_max_age_ms (int): The period of time in milliseconds after which we force a refresh of metadata even if we haven't seen any partition leadership changes to proactively discover any new brokers or partitions. Default: 300000 bootstrap_servers: 'host[:port]' string (or list of 'host[:port]' strings) that the client should contact to bootstrap initial cluster metadata. This does not have to be the full node list. It just needs to have at least one broker that will respond to a Metadata API Request. Default port is 9092. If no servers are specified, will default to localhost:9092. di)retry_backoff_msmetadata_max_age_msbootstrap_serversc 40Ul0Ul[R"[5Ul0UlSUlSUlSUl SUl [ 5Ul [R"5UlSUl[ 5Ul[ 5UlSUlSUl[(R("UR*5UlUR,HnX!;dM XUR,U'M UR/5Ul0Ulg)NrTF)_brokers _partitions collections defaultdictset_broker_partitions _coordinators_last_refresh_ms_last_successful_refresh_ms _need_update_future _listeners threadingLock_lockneed_all_topic_metadataunauthorized_topicsinternal_topics controller cluster_idcopyDEFAULT_CONFIGconfig_generate_bootstrap_brokers_bootstrap_brokers_coordinator_brokers)selfconfigskeys 3/venv/lib/python3.13/site-packages/kafka/cluster.py__init__ClusterMetadata.__init__0s "-"9"9#"> !+,(  %^^% ',$#&5 "uii 3 34 ;;C~#*< C #'"B"B"D$&!c[URS5n0n[U5HunupEnSU-n[XtUS5X''M U$)Nrz bootstrap-%s) collect_hostsr) enumerater)r-bootstrap_hostsbrokersihostport_node_ids r0r*+ClusterMetadata._generate_bootstrap_brokersIsU' 4G(HI"+O"< AA$q(G-gT4HG #=r3cXR;$N)r+)r-r=s r0 is_bootstrapClusterMetadata.is_bootstrapSs1111r3c[URR55=(d# [URR55$)z@Get all BrokerMetadata Returns: set: {BrokerMetadata, ...} )rrvaluesr+r-s r0r8ClusterMetadata.brokersVs5 4=='')*Sc$2I2I2P2P2R.SSr3cURRU5=(d= URRU5=(d URRU5$)zGet BrokerMetadata Arguments: broker_id (int or str): node_id for a broker to check Returns: BrokerMetadata or None if not found )rgetr+r,r- broker_ids r0broker_metadataClusterMetadata.broker_metadata^sM MM  i ( 5  # # ' ' 2 5  % % ) )) 4 r3cnXR;ag[URUR55$)zReturn set of all partitions for topic (whether available or not) Arguments: topic (str): topic to check for partitions Returns: set: {partition (int), ...} None if topic not found. N)rrkeys)r-topics r0partitions_for_topic$ClusterMetadata.partitions_for_topicms2 (( (4##E*//122r3cXR;ag[[R"URU5VVs/sHup#URS:wdMUPM snn5$s snnf)zReturn set of partitions with known leaders Arguments: topic (str): topic to check for partitions Returns: set: {partition (int), ...} None if topic not found. N)rrr iteritemsleader)r-rO partitionmetadatas r0available_partitions_for_topic.ClusterMetadata.available_partitions_for_topic{se (( (!$t/?/?/F!G8!G#6)!)B!6!G89 98s A$ A$ cURUR;agURURUR;agURURURR$)z:Return node_id of leader, -1 unavailable, None if unknown.N)rOrrVrUr-rVs r0leader_for_partition$ClusterMetadata.leader_for_partitions] ??$"2"2 2  (8(8(I I 01D1DELLLr3cbURURURR$r@)rrOrV leader_epochr[s r0leader_epoch_for_partition*ClusterMetadata.leader_epoch_for_partitions( 01D1DERRRr3c8URRU5$)zReturn TopicPartitions for which the broker is a leader. Arguments: broker_id (int or str): node id for a broker Returns: set: {TopicPartition, ...} None if the broker either has no partitions or does not exist. )rrHrIs r0partitions_for_broker%ClusterMetadata.partitions_for_brokers&&**955r3c<URRSU45$)zReturn node_id of group coordinator. Arguments: group (str): name of consumer group Returns: node_id (int or str) for group coordinator, -1 if coordinator unknown None if the group does not exist. group)rrH)r-rfs r0coordinator_for_group%ClusterMetadata.coordinator_for_groups !!%%w&677r3c[R"5S-nUR(aSnO XR- nURSU- nXR- nURSU- n[ X%S5$)z/Milliseconds until metadata should be refreshedrrr)timerrr)rmax)r-nowttl metadata_age retry_age next_retrys r0rnClusterMetadata.ttlsqiikD    C!A!AAL++34|CC/// [[!34y@ 3A&&r3c URS$)zDReturn milliseconds to wait before attempting to retry after failurer)r)rEs r0refresh_backoffClusterMetadata.refresh_backoffs{{-..r3cUR SUlUR(aURR(a[ 5UlURsSSS5 $!,(df  g=f)zFlags metadata for update, return Future() Actual update must be handled separately. This method will only change the reported ttl() Returns: kafka.future.Future (value will be the cluster object after update) TN)r!rris_donerrEs r0request_updateClusterMetadata.request_updates@ZZ $D <<4<<#7#7%x << ZZs AA%% A3cUR$r@)rrEs r0 need_updateClusterMetadata.need_updates   r3cv[URR55nU(aX R- $U$)aJGet set of known topics. Arguments: exclude_internal_topics (bool): Whether records from internal topics (such as offsets) should be exposed to the consumer. If set to True the only way to receive records from an internal topic is subscribing to it. Default True Returns: set: {topic (str), ...} )rrrNr$)r-exclude_internal_topicstopicss r0rClusterMetadata.topicss4T%%**,- "000 0Mr3cSnUR UR(aURnSUlSSS5 U(aURU5 [R"5S-Ulg!,(df  ND=f)z4Update cluster state given a failed MetadataRequest.Nrj)r!rfailurerkr)r- exceptionfs r0 failed_updateClusterMetadata.failed_updatesV  ZZ||LL#  IIi $ d 2 Zs %A22 Bc 0 UR(d:[RS5 UR[R "U55$0nURH=nUR S:XaUupEnSnOUupEpgURU[XEXg505 M? UR S:XaSnOURUR5nUR S:aSn O URn 0n [R"[5n [5n [5n URGHnUR S:Xa UunnnSnOUunnnnU(aU R!U5 [R""U5nU[R$La0U U'UHnSn/nUR S:a UunnnnnnnO"UR S:a UunnnnnnOUunnnnn['UUUUUUUUS 9U UU'US:wdMbU UR![)UU55 M MUR*(aGMU[R,La[RS U5 GM2U[R.La[R1S U5 GM^U[R2La*[R1S U5 U R!U5 GMU[R4La[R1S U5 GM[R1SUU5 GM UR6 X lXlXl XlXlXl Xl!SnURD(a URDnSUl"SUl#SSS5 [HRH"5S-nUUl%UUl&W(a[OUR5S:XaqURSS[R$RP:waCURSSSunn[R""U5"U5nURSU5 OURUU5 [RWSU5 URXH nU"U5 M UR*(aSUl#gg!,(df  GN"=f)zUpdate cluster state given a MetadataResponse. Arguments: metadata (MetadataResponse): broker response to a metadata request Returns: None z9No broker metadata found in MetadataResponse -- ignoring.rNFrS)rOrVrUr_replicasisroffline_replicaserrorz;Topic %s is not available during auto-create initializationz&Topic %s not found in cluster metadataz*Topic %s is not authorized for this clientz'%s' is not a valid topic namez(Error fetching metadata for topic %s: %srjzUpdated cluster metadata to %s)-r8logwarningrErrorsMetadataEmptyBrokerList API_VERSIONupdaterrH controller_idr&rrrraddfor_codeNoErrorr r r"LeaderNotAvailableErrorUnknownTopicOrPartitionErrorrTopicAuthorizationFailedErrorInvalidTopicErrorr!rr%rrr#r$rrrkrrlenerrnorsuccessdebugr) r-rW _new_brokersbrokerr=r:r;rack_new_controller_new_cluster_id_new_partitions_new_broker_partitions_new_unauthorized_topics_new_internal_topics topic_data error_coderO partitions is_internal error_typepartition_datar_rp_errorrVrUrrrrmrlisteners r0update_metadataClusterMetadata.update_metadatas KKS T%%f&D&DX&NO O &&F##q(&,#t,2)t   tB!  '   1 $"O*..x/E/EFO   ! #"O&11O!,!8!8!=#&5 "u"//J##q(0:- E:# =G: E; $((/4JV^^+)+&&0N#%L')$++q0draFL(CQa!--2VdSFHcCSDRAFHc8I#y%L!)sEU% 9'OE*95 |.v6::*5)<>!'1(--v=== ./46vBBB BEJvCCC FN(,,U3v777 :EB D-[*`ZZ(M-O-O. &< #'? $#7 A||LLDL %D iikD  #+.( 8??#q(X__Q-?-BfnnFZFZ-Z$,OOA$6r$:! E 3E: %  $ 2D9H TN(  ' ' !&D  (CZs AR Rc:URRU5 g)z U(a[R"U5 U$)za Collects a comma-separated set of hosts (host:port) and optionally randomize the returned list. ,z^.*://) isinstancer string_typesstripsplitresubrappendrandomshuffle)hosts randomizeresult host_portr:r;afis r0r5r5s %))** ##C( F FF8R3 ))4C t3'(  v Mr3r) __future__rrr'loggingrrrrk kafka.vendorrkafkarr kafka.connr kafka.futurer kafka.structsrr r getLoggerrrobjectr r5rr3r0rsU&   "&KK !VTfVTr r3