;iuSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r SSK J r SSKJr SSKJrJr SSK Jr SSKrSSKrSSKJr SS KJrJrJrJrJrJrJrJ r J!r!J"r"J#r#J$r$J%r%J&r&J'r'J(r(J)r)J*r*J+r+J,r,J-r-J.r.J/r/J0r0J1r1J2r2J3r3J4r4J5r5J6r6J7r7J8r8J9r9J:r:J;r;Jr>J?r?J@r@JArAJBrBJCrC S rD\D"5urErFrGS \H4S jrI\I"\FS S9rJSdSjrK\K"SSS9rLSrMSrNSrOSrPSrQSrRSrSSrTSrUSrVSrWSrXSrYS rZS!r[S"r\S#r]S$r^S%r_S&r`S'raS(rbS)rcS*rdS+reS,rfS-rgS.rhS/riS0rjS1rkS2rlS3rmS4rnS5roS6rpSeS7jrqS8rrS9rsS:rtS;ruS<rvS=rwS>rxS?ryS@rzSAr{SBr|SCr}SDr~SErSFrSGr\"\A"5\5"5\<"5\4"5/5=(a \"5(+rSHrSIrSJr"SKSL\ GR5r"SMSN\ GR5r"SOSP\ GR5rSQr"SRSS5rSTrSfS \4SUjjrSgSV\HS \4SWjjrSXrSYr"SZS[\5rShS\\H\4S]jjrS^\S \4S_jr\ SiS`\Sa\\S \4Sbjj5rScrg)jN)contextmanager)partial)Path)OptionalUnion)mock)AcceleratorState)+check_cuda_fp8_capabilitycompare_versionsgatheris_aim_availableis_bnb_availableis_clearml_availableis_comet_ml_availableis_cuda_availableis_datasets_availableis_deepspeed_availableis_dvclive_availableis_fp8_availableis_fp16_availableis_habana_gaudi1is_hpu_availableis_import_timer_availableis_matplotlib_availableis_mlflow_availableis_mlu_availableis_mps_availableis_musa_availableis_npu_availableis_pandas_availableis_pippy_availableis_pytest_availableis_schedulefree_availableis_sdaa_availableis_swanlab_availableis_tensorboard_availableis_timm_availableis_torch_versionis_torch_xla_availableis_torchao_available*is_torchdata_stateful_dataloader_availableis_torchvision_availableis_trackio_availableis_transformer_engine_available%is_transformer_engine_mxfp8_availableis_transformers_availableis_triton_availableis_wandb_availableis_xpu_available str_to_boolc[5(a9S[RR5[RR4$[ 5(a9S[RR5[RR4$[ SS9(aSS[RR4$[ 5(aSSS4$[5(a9S[RR5[RR4$[5(a9S [RR5[RR4$[5(a9S [RR5[RR4$[5(a9S [R R5[R R4$[#5(a9S [R$R5[R$R4$['5(a9S [R(R5[R(R4$SSS4$)Nxlacudaz2.0) min_versionmpscgNrr>m/home/dmtnaga/Documents/work/airagagent/rag_env/lib/python3.13/site-packages/accelerate/test_utils/testing.pyget_backend..[r?mlusdaamusanpuxpuhpucpucgr=r>r>r?r@rArBirCr?)r*torchr8 device_countmemory_allocatedrrr:current_allocated_memoryrrDr%rErrFr rGr4rHrrIr>r?r@ get_backendrPSsejj--/1L1LLL   uzz..0%**2M2MMM e ,a;;;;   a""   eii,,. 0J0JJJ   uzz..0%**2M2MMM   uzz..0%**2M2MMM   eii,,. 0J0JJJ   eii,,. 0J0JJJ   eii,,. 0J0JJJa""r?returnc SS/nUR5HSup#[U[5(aU(aURSU35 M7UcM<URSUSU35 MU U$)z Wraps around `kwargs` to help simplify launching from `subprocess`. Example: ```python # returns ['accelerate', 'launch', '--num_processes=2', '--device_count=2'] get_launch_command(num_processes=2, device_count=2) ``` acceleratelaunchz--=)items isinstanceboolappend)kwargscommandkvs r@get_launch_commandr^oseX&G  a  1 NNRs8 $ ] NNRs!A3< (  Nr?g?) num_processesmonitor_intervalFc[RUn[U5nU$![a [SUS35ef=f![a UnU$f=f)NzIf set, z must be yes or no.)osenvironr5 ValueErrorKeyError)keydefaultvalue_values r@parse_flag_from_envrjsp B 3  B 'F M Bxu,?@A A B  MsA #= AARUN_SLOW)rgc:[R"S5"U5$)z+Decorator that skips a test unconditionallyzTest was skipped)unittestskip test_cases r@rnrns ==+ ,Y 77r?cD[R"[S5"U5$)z Decorator marking a test as slow. Slow tests are skipped by default. Set the RUN_SLOW environment variable to a truthy value to run them. z test is slow)rm skipUnless_run_slow_testsros r@slowrts    ? JJr?cJ[R"[S:HS5"U5$)zm Decorator marking a test that must be only ran on the CPU. These tests are skipped when a GPU is available. rJztest requires only a CPUrmrr torch_deviceros r@ require_cpurxs#   |u46P QR[ \\r?cJ[R"[S:gS5"U5$)z Decorator marking a test that requires a hardware accelerator backend. These tests are skipped when there are no hardware accelerator available. rJtest requires a GPUrvros r@require_non_cpur{s"   |u46K LY WWr?cx[R"[5=(a [5(+S5"U5$)z Decorator marking a test that requires CUDA. These tests are skipped when there are no GPU available or when TorchXLA is available. rz)rmrrrr*ros r@ require_cudar}s.   02S;Q;S7SUj klu vvr?c[R"[5=(a [5(+=(d [ 5S5"U5$)z Decorator marking a test that requires CUDA or HPU. These tests are skipped when there are no GPU available or when TorchXLA is available. ztest requires a GPU or HPU)rmrrrr*rros r@require_cuda_or_hpurs=      =%;%=!=TBRBTVr  r?cL[R"[5S5"U5$)zf Decorator marking a test that requires XPU. These tests are skipped when there are no XPU available. test requires a XPU)rmrrr4ros r@ require_xpurs!   /13H I) TTr?c[5=(a [5(+n[5n[R"U=(d US5"U5$)z Decorator marking a test that requires CUDA or XPU. These tests are skipped when there are no GPU available or when TorchXLA is available. ztest requires a CUDA GPU or XPU)rr*r4rmrr)rpcuda_condition xpu_conditions r@require_cuda_or_xpurs? '(I1G1I-IN$&M   ~>@a bcl mmr?cJ[R"[S:gS5"U5$)z: Decorator marking a test that should be skipped for XPU. rHztest requires a non-XPUrvros r@require_non_xpur#   |u46O PQZ [[r?cJ[R"[S:gS5"U5$)z: Decorator marking a test that should be skipped for HPU. rIztest requires a non-HPUrvros r@require_non_hpurrr?cL[R"[5S5"U5$)zb Decorator marking a test that requires FP16. These tests are skipped when FP16 is not supported. ztest requires FP16 support)rmrrrros r@ require_fp16rs"   024P QR[ \\r?c[5n[RR5(a[ 5(dSn[ 5(a[ 5(aSn[R"US5"U5$)z` Decorator marking a test that requires FP8. These tests are skipped when FP8 is not supported. Fztest requires FP8 support) rrLr8 is_availabler rrrmrr)rpfp8_is_availables r@ require_fp8rsa() zz  )B)D)D .00    /1L Mi XXr?cP[R"[SS5S5"U5$)N>=z2.5.0z$test requires FSDP2 (torch >= 2.5.0))rmrrr)ros r@ require_fsdp2rs$   /g>@f ghq rrr?cL[R"[5S5"U5$)zf Decorator marking a test that requires MLU. These tests are skipped when there are no MLU available. ztest require a MLU)rmrrrros r@ require_mlur!   /13G H SSr?cL[R"[5S5"U5$)zh Decorator marking a test that requires SDAA. These tests are skipped when there are no SDAA available. ztest require a SDAA)rmrrr%ros r@ require_sdaar !   024I J9 UUr?cL[R"[5S5"U5$)zh Decorator marking a test that requires MUSA. These tests are skipped when there are no MUSA available. ztest require a MUSA)rmrrrros r@ require_musarrr?cL[R"[5S5"U5$)zf Decorator marking a test that requires NPU. These tests are skipped when there are no NPU available. ztest require a NPU)rmrrr ros r@ require_npurrr?cL[R"[5S5"U5$)zw Decorator marking a test that requires MPS backend. These tests are skipped when torch doesn't support `mps` backend. z0test requires a `mps` backend support in `torch`)rmrrrros r@ require_mpsrs"   /13e fgp qqr?cn[R"[5=(a [5S5"U5$)zn Decorator marking a test that requires transformers and datasets. These tests are skipped when they are not. z$test requires the Hugging Face suite)rmrrr1rros r@require_huggingface_suiter's3   !#?(=(?.  r?cL[R"[5S5"U5$)za Decorator marking a test that requires transformers. These tests are skipped when they are not. z&test requires the transformers library)rmrrr1ros r@require_transformersr1"   8:S TU^ __r?cJ[R"[S:S5"U5$)z} Decorator marking a test that requires a multi-device setup. These tests are skipped on a machine without multiple devices. r;z,test requires multiple hardware accelerators)rmrrrMros r@require_multi_devicers#   |a/1_ `aj kkr?cz[R"[RR 5S:S5"U5$)zw Decorator marking a test that requires a multi-GPU setup. These tests are skipped on a machine without multiple GPUs. r;ztest requires multiple GPUsrros r@require_multi_gpurs0   uzz6681<>[ \]f ggr?cz[R"[RR 5S:S5"U5$)zw Decorator marking a test that requires a multi-XPU setup. These tests are skipped on a machine without multiple XPUs. r;ztest requires multiple XPUsrros r@require_multi_xpurs0   uyy557!;=Z [\e ffr?c[R"[5=(d [5=(a [S:S5"U5$)z Decorator marking a test that requires a multi-GPU setup. These tests are skipped on a machine without multiple GPUs or XPUs. r;z#test requires multiple GPUs or XPUs)rmrrrr4rMros r@require_multi_gpu_or_xpurs;      2 0 2H q8HJo  r?cL[R"[5S5"U5$)zt Decorator marking a test that requires DeepSpeed installed. These tests are skipped when DeepSpeed isn't installed ztest requires DeepSpeed)rmrrrros r@require_deepspeedrs"   579R ST] ^^r?cx[R"[SS5=(a [SSS5S5"U5$)zf Decorator marking a test that requires TP installed. These tests are skipped when TP isn't installed rz2.3.0 transformersz4.52.0zGtest requires torch version >= 2.3.0 and transformers version >= 4.52.0)rmrrr)r ros r@ require_tprs>   w'\,<^TS[,\Q  r?cxUc[[US9$[R"[ SU5SU35"U5$)z Decorator marking that a test requires a particular torch version to be tested. These tests are skipped when an installed torch version is less than the required one. )versionrztest requires torch version >= )rrequire_torch_min_versionrmrrr))rprs r@rrsC 0'BB   /g>Babiaj@k lmv wwr?cL[R"[5S5"U5$)zx Decorator marking a test that requires tensorboard installed. These tests are skipped when tensorboard isn't installed ztest requires Tensorboard)rmrrr'ros r@require_tensorboardrs"   79;V WXa bbr?cL[R"[5S5"U5$)zl Decorator marking a test that requires wandb installed. These tests are skipped when wandb isn't installed ztest requires wandb)rmrrr3ros r@ require_wandbrs!   135J KI VVr?cL[R"[5S5"U5$)zp Decorator marking a test that requires trackio installed. These tests are skipped when trackio isn't installed ztest requires trackio)rmrrr.ros r@require_trackior"   357N OPY ZZr?cL[R"[5S5"U5$)zr Decorator marking a test that requires comet_ml installed. These tests are skipped when comet_ml isn't installed ztest requires comet_ml)rmrrrros r@require_comet_mlrs"   468P QR[ \\r?cL[R"[5S5"U5$)zh Decorator marking a test that requires aim installed. These tests are skipped when aim isn't installed ztest requires aim)rmrrrros r@ require_aimrs!   /13F G RRr?cL[R"[5S5"U5$)zp Decorator marking a test that requires clearml installed. These tests are skipped when clearml isn't installed ztest requires clearml)rmrrrros r@require_clearmlrrr?cL[R"[5S5"U5$)zp Decorator marking a test that requires dvclive installed. These tests are skipped when dvclive isn't installed ztest requires dvclive)rmrrrros r@require_dvcliverrr?cL[R"[5S5"U5$)zp Decorator marking a test that requires swanlab installed. These tests are skipped when swanlab isn't installed ztest requires swanlab)rmrrr&ros r@require_swanlabrrr?cL[R"[5S5"U5$)zn Decorator marking a test that requires pandas installed. These tests are skipped when pandas isn't installed ztest requires pandas)rmrrr!ros r@require_pandasr!   246L Mi XXr?cL[R"[5S5"U5$)zn Decorator marking a test that requires mlflow installed. These tests are skipped when mlflow isn't installed ztest requires mlflow)rmrrrros r@require_mlflowrrr?cx[R"[5=(a [5(+S5"U5$)z Decorator marking a test that requires pippy installed. These tests are skipped when pippy isn't installed It is also checked if the test is running on a Gaudi1 device which doesn't support pippy. ztest requires pippy)rmrrr"rros r@ require_pippyrs.   13N@Be fgp qqr?cL[R"[5S5"U5$)z Decorator marking a test that requires transformers engine MXFP8 block scaling available. These tests are skipped when transformers engine MXFP8 block scaling isn't available z5test requires transformers engine MXFP8 block scaling)rmrrr0ros r@ require_transformer_engine_mxfp8r s(   -/1h  r?cL[R"[5S5"U5$)zp Decorator marking a test that requires torchao installed. These tests are skipped when torchao isn't installed ztest requires torchao)rmrrr+ros r@require_torchaor*rr?cL[R"[5S5"U5$)zv Decorator marking a test that requires matplotlib installed. These tests are skipped when matplotlib isn't installed ztest requires matplotlib)rmrrrros r@require_matplotlibr1s"   68:T UV_ ``r?cD[R"[S5"U5$)z Decorator marking that a test requires at least one tracking library installed. These tests are skipped when none are installed zYtest requires at least one tracker to be available and for `comet_ml` to not be installed)rmrr_atleast_one_tracker_availableros r@require_trackersr?s'   &c  r?cL[R"[5S5"U5$)z Decorator marking a test that requires torchdata.stateful_dataloader. These tests are skipped when torchdata with stateful_dataloader module isn't installed. z+test requires torchdata.stateful_dataloader)rmrrr,ros r@%require_torchdata_stateful_dataloaderrJs(   246c  r?cn[5(a%SSKnURRS5"U5$U$)a Decorator marking a test with order(1). When pytest-order plugin is installed, tests marked with this decorator are guaranteed to run first. This is especially useful in some test settings like on a Gaudi instance where a Gaudi device can only be used by a single process at a time. So we make sure all tests that run in a subprocess are launched first, to avoid device allocation conflicts. If pytest is not installed, test will be returned as is. rNr;)r#pytestmarkorder)rprs r@ run_firstrVs0{{  #I.. r?cB\rSrSrSrSr\S5r\S5rSr Sr g) TempDirTestCaseiiat A TestCase class that keeps a single `tempfile.TemporaryDirectory` open for the duration of the class, wipes its data at the start of a test, and then destroys it at the end of the TestCase. Useful for when a class or API requires a single constant folder throughout it's use, such as Weights and Biases The temporary directory location will be stored in `self.tmpdir` TcJ[[R"55Ulg)zECreates a `tempfile.TemporaryDirectory` and stores it in `cls.tmpdir`N)rtempfilemkdtemptmpdirclss r@ setUpClassTempDirTestCase.setUpClassus(**,- r?c[RRUR5(a![R "UR5 gg)z1Remove `cls.tmpdir` after test suite has finishedN)rbpathexistsrshutilrmtreers r@ tearDownClassTempDirTestCase.tearDownClasszs0 77>>#** % % MM#** % &r?cUR(awURRS5HWnUR5(aUR 5 M*UR 5(dMA[ R"U5 MY gg)z>KKM[[]]MM$' 1 r?r>N) __name__ __module__ __qualname____firstlineno____doc__r  classmethodrr r__static_attributes__r>r?r@rris9N..&& (r?rc,^\rSrSrSrU4SjrSrU=r$)AccelerateTestCaseiz A TestCase class that will reset the accelerator state at the end of every test. Every test that checks or utilizes the `AcceleratorState` class should inherit from this to avoid silent failures due to state being shared between tests. cN>[TU]5 [R"S5 g)NT)supertearDownr _reset_state)r __class__s r@rAccelerateTestCase.tearDowns %%d+r?r>)rrrrrrr __classcell__)r!s@r@rrs ,,r?rc^\rSrSrSrS\\R\\R44Sjr Sr g)MockingTestCaseiau A TestCase class designed to dynamically add various mockers that should be used in every test, mimicking the behavior of a class-wide mock when defining one normally will not do. Useful when a mock requires specific information available only initialized after `TestCase.setUpClass`, such as setting an environment variable with that information. The `add_mocks` function should be ran at the end of a `TestCase`'s `setUp` function, after a call to `super().setUp()` such as: ```python def setUp(self): super().setUp() mocks = mock.patch.dict(os.environ, {"SOME_ENV_VAR", "SOME_VALUE"}) self.add_mocks(mocks) ``` mocksc[U[[45(aUOU/UlURH.nUR 5 UR UR 5 M0 g)a! Add custom mocks for tests that should be repeated on each test. Should be called during `MockingTestCase.setUp`, after `super().setUp()`. Args: mocks (`mock.Mock` or list of `mock.Mock`): Mocks that should be added to the `TestCase` after `TestCase.setUpClass` has been run N)rWtuplelistr&start addCleanupstop)rr&ms r@ add_mocksMockingTestCase.add_mockssF) >>UUG A GGI OOAFF #r?)r&N) rrrrrrrMockr)r.rr>r?r@r%r%s)" $uTYYTYY%?@ $r?r%cF[5nUSR5RUR5n[ U5R 5nUSR 5n[ URS5H#n[R"X#U5(aM# g g)NrFT) r clonetodevicer rJrangeshaperLequal)tensorstatetensorsis r@are_the_same_tensorsr<s  E D\   ! $ $U\\ 2FVn  "G AY]]_F 7==# ${{7:v..% r?c\rSrSrSrSrg) _RunOutputic(XlX lX0lgN) returncodestdoutstderr)rrArBrCs r@__init___RunOutput.__init__s$  r?)rArCrBN)rrrrrDrr>r?r@r>r>sr?r>cf# UR5IShvN nU(a U"U5 OgM+N7fr@)readline)streamcallbacklines r@ _read_streamrKs, __&&  TN  &s 1/1c h^^^^ # U(a[SSRU55 [R"US/USSQ7U[RR [RR US.6IShvN n/m/mS U4Sjjm [R "[R"[URUU 4Sj55[R"[URUU 4Sj55/US 9IShvN [UR 5IShvN TT5$NN)N7f) Nz Running:  rr;)stdinrBrCenvc>URS5R5nURU5 T(d [X0US9 gg)Nutf-8)file)decoderstriprYprint)rJsinkpipelabelquiets r@tee_stream_subprocess..tees8{{7#**, D %D )r?c2>T"UT[RSS9$)Nzstdout:rX)sysrB)loutrZs r@rA$_stream_subprocess..QSZZ_hAir?c2>T"UT[RSS9$)Nzstderr:r])r^rC)r_errrZs r@rArarbr?)timeout)) rUjoinasynciocreate_subprocess_exec subprocessPIPEwait create_taskrKrBrCr>) cmdrOrNrerYechoprdr`rZs ` @@@r@_stream_subprocessrqs  mSXXc]+,, A QR!!&&!!&&   A" C C* ,,    QXX7i j k    QXX7i j k    AFFHnc3 //E 6%s7A9D2?D,BD2D.D2!D0" D2.D20D2rnc [U5H)upg[U[5(dM[U5X'M+ [R "5nUR [XX#XES95n SRU5n U RS:a9SRU R5n [SU SU RSU 35eU $)N)rOrNrerYrorMr 'z' failed with returncode z, The combined stderr from workers follows: ) enumeraterWrstrrhget_event_looprun_until_completerqrgrArC RuntimeError) rnrOrNrerYror;cloopresultcmd_strrCs r@execute_subprocess_asyncr~s# a  VCF  ! ! #D  $ $3uU^FhhsmG 16==)y1&2C2C1DE::@ C  Mr?c[RRSS5n[R"SSUS[R 5n[ U5$)z Returns an int value of worker's numerical id under `pytest-xdist`'s concurrent workers `pytest -n N` regime, or 0 if `-n 1` or `pytest-xdist` isn't being used. PYTEST_XDIST_WORKERgw0z^gwrfr)rbrcgetresubMint)workers r@pytest_xdist_worker_idrs= ZZ^^15 9F VVFB244 0F v;r?c"Sn[5nX-$)z Returns a port number that can be fed to `torch.distributed.launch`'s `--master_port` argument. Under `pytest-xdist` it adds a delta number based on a worker id so that concurrent tests don't try to use the same port at once. iN)rrrrrr>r?r@rr'sr?rr[c[U5H)up4[U[5(dM[U5X'M+ Uc[R R 5n[R"U[RUS9nU(a$[US5(aURS5nU$g![Ra>n[SSRU5SURR535UeSnAff=f)z Runs `command` with `subprocess.check_output` and will potentially return the `stdout`. Will also properly capture if an error occurred while running `command` N)rCrOrSrQz Command `rMz$` failed with the following error: )rurWrrvrbrccopyrj check_outputSTDOUThasattrrSCalledProcessErrorrrgoutput)r[ return_stdoutrOr;rzres r@ run_commandr+s '" a  QGJ# {jjoo ((9J9JPST vx((w/M   ( (%)**PQRQYQYQ`Q`QbPc d  sAB++C=?9C88C= componentscz[[R"[55RnUR "U6$)z Get a path within the `accelerate` package's directory. Args: *components: Components of the path to join after the package directory. Returns: `Path`: The path to the requested file or directory. )rinspectgetfilerSparentjoinpath)raccelerate_package_dirs r@path_in_accelerate_packagerBs/"'//*"=>EE ! * *J 77r?exception_classmsgc## SnSv SnU(a[ SUS 35eg![aYn[X05(dSUS[U535eUb&U[U5;dSUS[U5S35eSnANuSnAff=f7f) z Context manager to assert that the right `Exception` class was raised. If `msg` is provided, will check that the message is contained in the raised exception. FNTzExpected exception of type z but got zExpected message 'z' to be in exception but got 'rtz but ran without issue.) ExceptionrWtypervAssertionError)rrwas_ranrs r@assert_exceptionrQsGd  :?:KKbcdd d!--p1L_L]]fgklmgnfo/pp- ?#a&= c$6se;YZ]^_Z`Yaab"c c=ds+B #B  BAB<B BB c[R"5n[RnU[lU"U0UD6 U[lUR 5$![anUeSnAff=f!U[lf=f)zX Takes in a `func` with `args` and `kwargs` and returns the captured stdout as a string N)ioStringIOr^rBrgetvalue)funcargsrZcaptured_outputoriginal_stdoutrs r@capture_call_outputrdsjkkmOjjO%$  df%  # # %% % s#A A' A""A''A** A7)F)NN)NNNFF)NNFT)FNr@)rhrrrbrrrjr^rrm contextlibr functoolsrpathlibrtypingrrrrLrSr9r utilsr r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5rPrwrMmemory_allocated_funcr)r^DEFAULT_LAUNCH_COMMANDrjrsrnrtrxr{r}rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrranyrrrrTestCaserrr%r<r>rKrqr~rrrrrvrrrXrrr>r?r@rs  %" $,,,,,,,,,,,,^#25@M1 l1D&,,Y\]  &j%@8 K]XwUn\\]Y$sTVVTrqaoeqhjqa`lhg_xcW[]S[[[YYrir[a  79;O;QSgSijk$ ! ##  &(h''(B ,** ,$h''$B&0bl&0R$fp*  i c. 8C 8D 8eiehsmetee$ &r?