\jXdZddlmZmZmZmZddlmZddlm Z m Z ddl m Z m Z mZmZdZdZGdd ZGd d ZGd d ZgdZy)z This submodule contains the :class:`Config` class for custom configuration of the SDK client. Note that the same class can also be imported from the ``ldclient.client`` submodule. )OptionalCallableListSet)InMemoryFeatureStore)logvalidate_application_info)BigSegmentStoreEventProcessor FeatureStoreUpdateProcessorz/sdk/latest-flagsz/flagsceZdZdZ ddeedededeedeeded efd Ze d eefd Z e d efd Z e d efdZ e d efdZ e d efdZe d efdZe d efdZy)BigSegmentsConfigaJConfiguration options related to Big Segments. Big Segments are a specific type of segments. For more information, read the LaunchDarkly documentation: https://docs.launchdarkly.com/home/users/big-segments If your application uses Big Segments, you will need to create a ``BigSegmentsConfig`` that at a minimum specifies what database integration to use, and then pass the ``BigSegmentsConfig`` object as the ``big_segments`` parameter when creating a :class:`Config`. This example shows Big Segments being configured to use Redis: :: from ldclient.config import Config, BigSegmentsConfig from ldclient.integrations import Redis store = Redis.new_big_segment_store(url='redis://localhost:6379') config = Config(big_segments=BigSegmentsConfig(store = store)) Nstorecontext_cache_sizecontext_cache_timeuser_cache_sizeuser_cache_timestatus_poll_interval stale_aftercZ||_||n||_||n||_||_||_y)a :param store: the implementation of :class:`ldclient.interfaces.BigSegmentStore` that will be used to query the Big Segments database :param context_cache_size: the maximum number of contexts whose Big Segment state will be cached by the SDK at any given time :param context_cache_time: the maximum length of time (in seconds) that the Big Segment state for a context will be cached by the SDK :param user_cache_size: deprecated alias for `context_cache_size` :param user_cache_time: deprecated alias for `context_cache_time` :param status_poll_interval: the interval (in seconds) at which the SDK will poll the Big Segment store to make sure it is available and to determine how long ago it was updated :param stale_after: the maximum length of time between updates of the Big Segments data before the data is considered out of date N)_BigSegmentsConfig__store&_BigSegmentsConfig__context_cache_size&_BigSegmentsConfig__context_cache_time(_BigSegmentsConfig__status_poll_interval_BigSegmentsConfig__stale_after)selfrrrrrrrs 9/root/env/lib/python3.12/site-packages/ldclient/config.py__init__zBigSegmentsConfig.__init__#s@, :I:Q$6Wf!:I:Q$6Wf!&:#( returnc|jSN)rrs rrzBigSegmentsConfig.store@s ||r c|jSr#)rr$s rrz$BigSegmentsConfig.context_cache_sizeD(((r c|jSr#)rr$s rrz$BigSegmentsConfig.context_cache_timeHr&r c|jS)z0Deprecated alias for :attr:`context_cache_size`.)rr$s rrz!BigSegmentsConfig.user_cache_sizeL&&&r c|jS)z0Deprecated alias for :attr:`context_cache_time`.)rr$s rrz!BigSegmentsConfig.user_cache_timeQr)r c|jSr#)rr$s rrz&BigSegmentsConfig.status_poll_intervalVs***r c|jSr#)rr$s rrzBigSegmentsConfig.stale_afterZ!!!r )NNNr/x)__name__ __module__ __qualname____doc__rr intfloatrpropertyrrrrrrrr rrrs4$59)-+,0426-.$'  1 %( &+ #+3-  #+5/  (-  $ :x0)C)))E))''''''+e++"U""r rc eZdZdZ ddededeedeedeedef d Ze d efd Z e d efd Z e d eefd Z e d eefdZ e d eefdZe d efdZy) HTTPConfigaUAdvanced HTTP configuration options for the SDK client. This class groups together HTTP/HTTPS-related configuration properties that rarely need to be changed. If you need to set these, construct an ``HTTPConfig`` instance and pass it as the ``http`` parameter when you construct the main :class:`Config` for the SDK client. Nconnect_timeout read_timeout http_proxyca_certs cert_filedisable_ssl_verificationcX||_||_||_||_||_||_y)a :param connect_timeout: The connect timeout for network connections in seconds. :param read_timeout: The read timeout for network connections in seconds. :param http_proxy: Use a proxy when connecting to LaunchDarkly. This is the full URI of the proxy; for example: http://my-proxy.com:1234. Note that unlike the standard ``http_proxy`` environment variable, this is used regardless of whether the target URI is HTTP or HTTPS (the actual LaunchDarkly service uses HTTPS, but a Relay Proxy instance could use HTTP). Setting this Config parameter will override any proxy specified by an environment variable, but only for LaunchDarkly SDK connections. :param ca_certs: If using a custom certificate authority, set this to the file path of the certificate bundle. :param cert_file: If using a custom client certificate, set this to the file path of the certificate. :param disable_ssl_verification: If true, completely disables SSL verification and certificate verification for secure requests. This is unsafe and should not be used in a production environment; instead, use a self-signed certificate and set ``ca_certs``. N)_HTTPConfig__connect_timeout_HTTPConfig__read_timeout_HTTPConfig__http_proxy_HTTPConfig__ca_certs_HTTPConfig__cert_file%_HTTPConfig__disable_ssl_verification)rr;r<r=r>r?r@s rrzHTTPConfig.__init__es3."1*&"$*B'r r!c|jSr#)rBr$s rr;zHTTPConfig.connect_timeout%%%r c|jSr#)rCr$s rr<zHTTPConfig.read_timeout"""r c|jSr#)rDr$s rr=zHTTPConfig.http_proxy   r c|jSr#)rEr$s rr>zHTTPConfig.ca_certs r c|jSr#)rFr$s rr?zHTTPConfig.cert_filesr c|jSr#)rGr$s rr@z#HTTPConfig.disable_ssl_verifications...r ) NNNF)r1r2r3r4r6rstrboolrr7r;r<r=r>r?r@r8r rr:r:^s)+%'+/)-*.05 C"'C$C&c]C$C= C %SM C ,0 C<&&&#e##!HSM!!(3- 8C=  /$//r r:c>deZdZdZdddddddid d d d d d d eed d d d d d d dd d ed d fdedededededede dede de e de e ede gefdede de e de dgefdeedeed e d!e d"ed#ed$e ed%e ed&e d'ed(e ed)e ed*ed+e ed,e e fZ"ed/e e dgeffd?Z#ed/e fd@Z$ed/e fdAZ%ed/efdBZ&ed/efdCZ'ed/e(efdDZ)ed/e(efdEZ*ed/e fdFZ+ed/e fdGZ,ed/efdHZ-ed/efdIZ.ed/efdJZ/ed/efdKZ0ed/e fdLZ1ed/efdMZ2ed/e efdNZ3ed/e efdOZ4ed/efdPZ5ed/efdQZ6ed/e fdRZ7dSZ8y )TConfigaAdvanced configuration options for the SDK client. To use these options, create an instance of ``Config`` and pass it to either :func:`ldclient.set_config()` if you are using the singleton client, or the :class:`ldclient.client.LDClient` constructor otherwise. zhttps://app.launchdarkly.comzhttps://events.launchdarkly.comi'r/zhttps://stream.launchdarkly.comTNFr.i,isdk_keybase_uri events_urievents_max_pendingflush_interval stream_uristreaminitial_reconnect_delaydefaults send_eventsupdate_processor_class poll_intervaluse_ldd feature_storeevent_processor_classprivate_attributesprivate_attribute_namesall_attributes_privateofflinecontext_keys_capacitycontext_keys_flush_intervaluser_keys_capacityuser_keys_flush_intervaldiagnostic_opt_outdiagnostic_recording_interval wrapper_namewrapper_versionhttp big_segments applicationc ||_|jd|_|jd|_|jd|_| |_||_||_t| d|_ | |_ |s tn||_ ||_ ||_||_||_| |_|durd} | dn| |_|xs||_||_||_||n||_||n||_||_t|d|_||_||_||_|s t;n||_t?|xsit@|_!y)a :param sdk_key: The SDK key for your LaunchDarkly account. This is always required. :param base_uri: The base URL for the LaunchDarkly server. Most users should use the default value. :param events_uri: The URL for the LaunchDarkly events server. Most users should use the default value. :param events_max_pending: The capacity of the events buffer. The client buffers up to this many events in memory before flushing. If the capacity is exceeded before the buffer is flushed, events will be discarded. :param flush_interval: The number of seconds in between flushes of the events buffer. Decreasing the flush interval means that the event buffer is less likely to reach capacity. :param stream_uri: The URL for the LaunchDarkly streaming events server. Most users should use the default value. :param stream: Whether or not the streaming API should be used to receive flag updates. By default, it is enabled. Streaming should only be disabled on the advice of LaunchDarkly support. :param initial_reconnect_delay: The initial reconnect delay (in seconds) for the streaming connection. The streaming service uses a backoff algorithm (with jitter) every time the connection needs to be reestablished. The delay for the first reconnection will start near this value, and then increase exponentially for any subsequent connection failures. :param send_events: Whether or not to send events back to LaunchDarkly. This differs from ``offline`` in that it affects only the sending of client-side events, not streaming or polling for events from the server. By default, events will be sent. :param offline: Whether the client should be initialized in offline mode. In offline mode, default values are returned for all flags and no remote network requests are made. By default, this is false. :param poll_interval: The number of seconds between polls for flag updates if streaming is off. :param use_ldd: Whether you are using the LaunchDarkly Relay Proxy in daemon mode. In this configuration, the client will not use a streaming connection to listen for updates, but instead will get feature state from a Redis instance. The ``stream`` and ``poll_interval`` options will be ignored if this option is set to true. By default, this is false. For more information, read the LaunchDarkly documentation: https://docs.launchdarkly.com/home/relay-proxy/using#using-daemon-mode :param array private_attributes: Marks a set of attributes private. Any users sent to LaunchDarkly with this configuration active will have these attributes removed. Each item can be either the name of an attribute ("email"), or a slash-delimited path ("/address/street") to mark a property within a JSON object value as private. :param array private_attribute_names: Deprecated alias for ``private_attributes`` ("names" is no longer strictly accurate because these could also be attribute reference paths). :param all_attributes_private: If true, all user attributes (other than the key) will be private, not just the attributes specified in ``private_attributes``. :param feature_store: A FeatureStore implementation :param context_keys_capacity: The number of context keys that the event processor can remember at any one time, so that duplicate context details will not be sent in analytics events. :param context_keys_flush_interval: The interval in seconds at which the event processor will reset its set of known context keys. :param user_keys_capacity: Deprecated alias for ``context_keys_capacity``. :param user_keys_flush_interval: Deprecated alias for ``context_keys_flush_interval``. :param feature_requester_class: A factory for a FeatureRequester implementation taking the sdk key and config :param event_processor_class: A factory for an EventProcessor implementation taking the config :param update_processor_class: A factory for an UpdateProcessor implementation taking the sdk key, config, and FeatureStore implementation :param diagnostic_opt_out: Unless this field is set to True, the client will send some diagnostics data to the LaunchDarkly servers in order to assist in the development of future SDK improvements. These diagnostics consist of an initial payload containing some details of SDK in use, the SDK's configuration, and the platform the SDK is being run on, as well as periodic information on irregular occurrences such as dropped events. :param diagnostic_recording_interval: The interval in seconds at which periodic diagnostic data is sent. The default is 900 seconds (every 15 minutes) and the minimum value is 60 seconds. :param wrapper_name: For use by wrapper libraries to set an identifying name for the wrapper being used. This will be sent in HTTP headers during requests to the LaunchDarkly servers to allow recording metrics on the usage of these wrapper libraries. :param wrapper_version: For use by wrapper libraries to report the version of the library in use. If ``wrapper_name`` is not set, this field will be ignored. Otherwise the version string will be included in the HTTP headers along with the ``wrapper_name`` during requests to the LaunchDarkly servers. :param http: Optional properties for customizing the client's HTTP/HTTPS behavior. See :class:`HTTPConfig`. :param application: Optional properties for setting application metadata. See :py:attr:`~application` /g>@TFN<)"_Config__sdk_keyrstrip_Config__base_uri_Config__events_uri_Config__stream_uri_Config__update_processor_class_Config__stream _Config__initial_reconnect_delaymax_Config__poll_interval_Config__use_lddr_Config__feature_store_Config__event_processor_class _Config__feature_requester_class_Config__events_max_pending_Config__flush_interval_Config__defaults_Config__send_events_Config__private_attributes_Config__all_attributes_private_Config__offline_Config__context_keys_capacity$_Config__context_keys_flush_interval_Config__diagnostic_opt_out&_Config__diagnostic_recording_interval_Config__wrapper_name_Config__wrapper_version _Config__httpr_Config__big_segmentsr r_Config__application) rrZr[r\r]r^r_r`rarbrcrdrerfrgfeature_requester_classrhrirjrkrlrmrnrorprqrrrsrtrurvrws rrzConfig.__init__sYJ!"//#.&--c2&--c2(>% )@&"=$7 =J35P]'<$)@&$6! ." d?K%0%8Tk$6$Q:Q!(>% @R@Z'<`r$LdLl-HsK*$6!/23PRT/U,*!0 9E/1<6{7Hb#Nr new_sdk_keyr!ctdid|d|jd|jd|jd|jd|j d|j d|jd |jd |jd |jd |jd |jd|jd|jd|jd|j d|j"d|j$d|j&d|j(d|j*d|j,d|j.d|j0d|j2d|j4S)zReturns a new ``Config`` instance that is the same as this one, except for having a different SDK key. :param new_sdk_key: the new SDK key rZr[r\r]r^r_r`rarbrcrdrerfrgrrhrirkrlrmrnrqrrrsrtrurvr8)rWr}r~rrrrrrrrrrrrrrrrrrrrrrrr)rrs rcopy_with_new_sdk_keyzConfig.copy_with_new_sdk_key&s 8k8#8!%!2!28*.)B)B8&*%:%: 8 "&!2!2 8 "]] 8/3.L.L8 $8#'"4"48.2-J-J8%)$8$88#nn8%)$8$88/3.L.L8-1,H,H8 *.)B)B!8".2-J-J#8$#nn%8&-1,H,H'8(372T2T)8**.)B)B+8,594X4X-8.$(#6#6/80'+&<&<182 ;;384$(#6#658 8r c@||jvr|S|j|Sr#)r)rkeydefaults r get_defaultzConfig.get_defaultHs!T__4wN$//#:NNr c|jSr#)r{r$s rrZzConfig.sdk_keyK ~~r c|jSr#)r}r$s rr[zConfig.base_uriOrOr c(|jtzSr#)r}GET_LATEST_FEATURES_PATHr$s rget_latest_flags_urizConfig.get_latest_flags_uriTs!999r c|jSr#r~r$s revents_base_urizConfig.events_base_uriYrMr c |jdzS)Nz/bulkrr$s rr\zConfig.events_uri^s  7**r c|jSr#)rr$s rstream_base_urizConfig.stream_base_uricrMr c(|jtzSr#)rSTREAM_FLAGS_PATHr$s rr_zConfig.stream_urihs  #444r c|jSr#)rr$s rrdzConfig.update_processor_classl,,,r c|jSr#)rr$s rr`z Config.streamps }}r c|jSr#)rr$s rrazConfig.initial_reconnect_delayt---r c|jSr#)rr$s rrezConfig.poll_intervalw###r c|jSr#)rr$s rrfzConfig.use_ldd{rr c|jSr#)rr$s rrgzConfig.feature_storerr c|jSr#)rr$s rrhzConfig.event_processor_class+++r c|jSr#)rr$s rrzConfig.feature_requester_classrr c|jSr#)rr$s rrczConfig.send_eventsr-r c|jSr#)rr$s rr]zConfig.events_max_pendingr&r c|jSr#)rr$s rr^zConfig.flush_intervals$$$r c,t|jSr#)listrr$s rrizConfig.private_attributessD--..r c|jSr#)rir$s rrjzConfig.private_attribute_namess&&&r c|jSr#)rr$s rrkzConfig.all_attributes_privaterr c|jSr#)rr$s rrlzConfig.offlinerr c|jSr#)rr$s rrmzConfig.context_keys_capacityrr c|jSr#)rr$s rrnz"Config.context_keys_flush_intervals111r c|jS)z2Deprecated name for :attr:`context_keys_capacity`.)rmr$s rrozConfig.user_keys_capacitys)))r c|jS)z8Deprecated name for :attr:`context_keys_flush_interval`.)rnr$s rrpzConfig.user_keys_flush_intervals///r c|jSr#)rr$s rrqzConfig.diagnostic_opt_outr&r c|jSr#)rr$s rrrz$Config.diagnostic_recording_intervals333r c|jSr#)rr$s rrszConfig.wrapper_namerKr c|jSr#)rr$s rrtzConfig.wrapper_versionrIr c|jSr#)rr$s rruz Config.https {{r c|jSr#)rr$s rrvzConfig.big_segmentsrKr c|jS)au An object that allows configuration of application metadata. Application metadata may be used in LaunchDarkly analytics or other product features, but does not affect feature flag evaluations. If you want to set non-default values for any of these fields, provide the appropriately configured dict to the {Config} object. )rr$s rrwzConfig.applications!!!r c|jdur |j|jdk(rtjdyy)NFzMissing or blank sdk_key.)rlrZrwarningr$s r _validatezConfig._validates5 <<5 T\\%9T\\R=O KK3 4>Pr )9r1r2r3r4setr:rTr5r6rUdictrrr r r rrrrrr7rZr[rrr\rr_rdr`rarerfrgrhrrcr]r^rrirjrkrlrmrnrorprqrrrsrtrurvrwrr8r rrWrWs >!B).'(!B"01 "-1lp&($7;)-MQ.1e365.3$,04759=A*/47-104",,;?-1?COCOCO!CO&) CO "' CO ! COCO+0CO CO'tnCO*2(C<;XZi;i2j)kCO!&COCO!) 6CO )1(^1K(L!CO"&)X#CO$+.c(%CO&*.'CO()CO*),+CO,/4-CO.&.c]/CO0,4E?1CO2&*3CO4145CO6 (}7CO8#+3-9CO:";CO< ((9:=CO>'tn?COJ888DO##::!!++!!55-3,:WYh:h1i(j--... $u$$$|$$,x(^9S0T'U,,..."T"")C))%%%/DI//'c''---,s,,2U22*C**0%00)D))4s44#hsm##&#&&j#/## "T " "5r rW)rWrr:N)r4typingrrrrldclient.feature_storerldclient.impl.utilrr ldclient.interfacesr r r r rrrr:rW__all__r8r rrsV 107=^^.K"K"Z;/;/zE5E5N 8r