gdZddlmZddlmZmZddlmZddlm Z m Z ddl m Z ddl mZmZeeZGdd eZd gZy ) z! OpenTelemetry Base Instrumentor ) annotations)ABCabstractmethod) getLogger)Any Collection))_OpenTelemetrySemanticConventionStability)DependencyConflictget_dependency_conflictscreZdZdZdZdZdZedZe d dZ d dZ e d dZ dd Z d d Zd d Zy)BaseInstrumentoraAn ABC for instrumentors. Child classes of this ABC should instrument specific third party libraries or frameworks either by using the ``opentelemetry-instrument`` command or by calling their methods directly. Since every third party library or framework is different and has different instrumentation needs, more methods can be added to the child classes as needed to provide practical instrumentation to the end user. NFcf|jtj||_|jSN) _instanceobject__new__)clsargskwargss _/var/www/openai/venv/lib/python3.12/site-packages/opentelemetry/instrumentation/instrumentor.pyrzBaseInstrumentor.__new__5s& == "NN3/CM}}c|jSr)!_is_instrumented_by_opentelemetryselfs r is_instrumented_by_opentelemetryz1BaseInstrumentor.is_instrumented_by_opentelemetry;s555rcy)aReturn a list of python packages with versions that the will be instrumented. The format should be the same as used in requirements.txt or pyproject.toml. For example, if an instrumentation instruments requests 1.x, this method should look like: def instrumentation_dependencies(self) -> Collection[str]: return ['requests ~= 1.0'] This will ensure that the instrumentation will only be used when the specified library is present in the environment. Nrs rinstrumentation_dependenciesz-BaseInstrumentor.instrumentation_dependencies?rc y)zInstrument the libraryNrrrs r _instrumentzBaseInstrumentor._instrumentOr rc y)zUninstrument the libraryNrr"s r _uninstrumentzBaseInstrumentor._uninstrumentRr rc8|j}t|Sr)rr )r dependenciess r_check_dependency_conflictsz,BaseInstrumentor._check_dependency_conflictsVs88: ' 55rc |jrtjdy|jdd}|s(|j }|rtj |yt j|jdi|}d|_|S)aSInstrument the library This method will be called without any optional arguments by the ``opentelemetry-instrument`` command. This means that calling this method directly without passing any optional values should do the very same thing that the ``opentelemetry-instrument`` command does. z3Attempting to instrument while already instrumentedNskip_dep_checkFTr) r_LOGwarningpopr(errorr _initializer#)rrr*conflictresults r instrumentzBaseInstrumentor.instrumentZs  1 1 LLN O $4e<779H 8$ 2==?!!!  26. rc ||jr|jdi|}d|_|Stjdy)zUninstrument the library See ``BaseInstrumentor.instrument`` for more information regarding the usage of ``kwargs``. Fz7Attempting to uninstrument while already uninstrumentedNr)rr%r+r,)rrr1s r uninstrumentzBaseInstrumentor.uninstrumentzs?  1 1'T''1&1F5:D 2M NOr)returnzCollection[str])rr)r5zDependencyConflict | None)__name__ __module__ __qualname____doc__rrrpropertyrrrr#r%r(r2r4rrrr r %sj I(-% 66    %''6@rr N)r9 __future__rabcrrloggingrtypingrr&opentelemetry.instrumentation._semconvr *opentelemetry.instrumentation.dependenciesr r r6r+r __all__rrrrBsG ##" cscL  r