
'''simple docstring'''





import os

from packaging import version

from .. import __version__
from .accelerate_utils import apply_forward_hook
from .constants import (
    CONFIG_NAME,
    DEPRECATED_REVISION_ARGS,
    DIFFUSERS_CACHE,
    DIFFUSERS_DYNAMIC_MODULE_NAME,
    FLAX_WEIGHTS_NAME,
    HF_MODULES_CACHE,
    HUGGINGFACE_CO_RESOLVE_ENDPOINT,
    ONNX_EXTERNAL_WEIGHTS_NAME,
    ONNX_WEIGHTS_NAME,
    SAFETENSORS_WEIGHTS_NAME,
    TEXT_ENCODER_ATTN_MODULE,
    WEIGHTS_NAME,
)
from .deprecation_utils import deprecate
from .doc_utils import replace_example_docstring
from .dynamic_modules_utils import get_class_from_dynamic_module
from .hub_utils import (
    HF_HUB_OFFLINE,
    _add_variant,
    _get_model_file,
    extract_commit_hash,
    http_user_agent,
)
from .import_utils import (
    BACKENDS_MAPPING,
    ENV_VARS_TRUE_AND_AUTO_VALUES,
    ENV_VARS_TRUE_VALUES,
    USE_JAX,
    USE_TF,
    USE_TORCH,
    DummyObject,
    OptionalDependencyNotAvailable,
    is_accelerate_available,
    is_accelerate_version,
    is_bsa_available,
    is_flax_available,
    is_ftfy_available,
    is_inflect_available,
    is_invisible_watermark_available,
    is_k_diffusion_available,
    is_k_diffusion_version,
    is_librosa_available,
    is_note_seq_available,
    is_omegaconf_available,
    is_onnx_available,
    is_safetensors_available,
    is_scipy_available,
    is_tensorboard_available,
    is_tf_available,
    is_torch_available,
    is_torch_version,
    is_torchsde_available,
    is_transformers_available,
    is_transformers_version,
    is_unidecode_available,
    is_wandb_available,
    is_xformers_available,
    requires_backends,
)
from .logging import get_logger
from .outputs import BaseOutput
from .pil_utils import PIL_INTERPOLATION, numpy_to_pil, pt_to_pil
from .torch_utils import is_compiled_module, randn_tensor


if is_torch_available():
     from .testing_utils import (
         floats_tensor,
         load_hf_numpy,
         load_image,
         load_numpy,
         load_pt,
         nightly,
         parse_flag_from_env,
         print_tensor_test,
         require_torch_a,
         require_torch_gpu,
         skip_mps,
         slow,
         torch_all_close,
         torch_device,
     )
     from .torch_utils import maybe_allow_in_graph

from .testing_utils import export_to_gif, export_to_video


A							     = get_logger(__name__)
def 	snake_case_							(				_a  :				Dict      ):
      if version.parse(_a      ) < version.parse(_a      ):
            if "dev" in min_version:
                  snake_case_    							=				(
                      "This example requires a source install from HuggingFace diffusers (see "
                      "`https://huggingface.co/docs/diffusers/installation#install-from-source`),"
                  )
            else:
                  snake_case_    							=				F'''This example requires a minimum version of {min_version},'''
            error_message += F''' but the version found is {__version__}.\n'''
            raise ImportError(_a      )



'''simple docstring'''





import os
import sys
from pathlib import Path

import pytest

from datasets import Dataset, IterableDataset
from datasets.distributed import split_dataset_by_node

from .utils import execute_subprocess_async, get_torch_dist_unique_port, require_torch
def 	snake_case_							(				):
      snake_case_    							=				Dataset.from_dict({"i": range(17      )}      )
      snake_case_    							=				len(_a      )
      snake_case_    							=				3
      snake_case_    							=				[
          split_dataset_by_node(_a			,       rank=_a			,       world_size=_a      ) for rank in range(_a      )
      ]
      assert sum(len(_a      ) for ds in datasets_per_rank      ) == full_size
      assert len({tuple(x.values()      ) for ds in datasets_per_rank for x in ds}      ) == full_size
def 	snake_case_							(				):
      def gen():
            return ({"i": i} for i in range(17      ))

      snake_case_    							=				3
      snake_case_    							=				IterableDataset.from_generator(_a      )
      snake_case_    							=				len(list(_a      )      )
      snake_case_    							=				[
          split_dataset_by_node(_a			,       rank=_a			,       world_size=_a      ) for rank in range(_a      )
      ]
      assert sum(len(list(_a      )      ) for ds in datasets_per_rank      ) == full_size
      assert len({tuple(x.values()      ) for ds in datasets_per_rank for x in ds}      ) == full_size
@pytest.mark.parametrize("shards_per_node"			,       [1, 2, 3]      )
def 	snake_case_							(				_a  :				List[Any]      ):
      def gen(_a  :				Dict      ):
            for shard in shards:
                  yield from ({"i": i, "shard": shard} for i in range(17      ))

      snake_case_    							=				3
      snake_case_    							=				shards_per_node * world_size
      snake_case_    							=				{"shards": [F'''shard_{shard_idx}.txt''' for shard_idx in range(_a      )]}
      snake_case_    							=				IterableDataset.from_generator(_a			,       gen_kwargs=_a      )
      snake_case_    							=				len(list(_a      )      )
      assert full_ds.n_shards == world_size * shards_per_node
      snake_case_    							=				[
          split_dataset_by_node(_a			,       rank=_a			,       world_size=_a      ) for rank in range(_a      )
      ]
      assert [ds.n_shards for ds in datasets_per_rank] == [shards_per_node] * world_size
      assert sum(len(list(_a      )      ) for ds in datasets_per_rank      ) == full_size
      assert len({tuple(x.values()      ) for ds in datasets_per_rank for x in ds}      ) == full_size
def 	snake_case_							(				):
      def gen():
            return ({"i": i} for i in range(17      ))

      snake_case_    							=				2
      snake_case_    							=				IterableDataset.from_generator(_a      )
      snake_case_    							=				len(list(_a      )      )

      snake_case_    							=				split_dataset_by_node(_a			,       rank=0			,       world_size=_a      ).shuffle(seed=42      )
      assert len(list(_a      )      ) == 1 + full_size // world_size
      with pytest.raises(_a      ):
            split_dataset_by_node(_a			,       rank=0			,       world_size=_a      ).shuffle()

      snake_case_    							=				split_dataset_by_node(full_ds.shuffle(seed=42      )			,       rank=0			,       world_size=_a      )
      assert len(list(_a      )      ) == 1 + full_size // world_size
      with pytest.raises(_a      ):
            split_dataset_by_node(full_ds.shuffle()			,       rank=0			,       world_size=_a      )
@pytest.mark.parametrize("streaming"			,       [False, True]      )
@require_torch
@pytest.mark.skipif(os.name == "nt"			,       reason="execute_subprocess_async doesn't support windows"      )
@pytest.mark.integration
def 	snake_case_							(				_a  :				Any      ):
      snake_case_    							=				2
      snake_case_    							=				get_torch_dist_unique_port()
      snake_case_    							=				Path(_a      ).resolve().parent / "distributed_scripts" / "launch_torch_distributed.py"
      snake_case_    							=				F'''
        -m torch.distributed.launch
        --nproc_per_node={nproc_per_node}
        --master_port={master_port}
        {test_script}
    '''.split()
      snake_case_    							=				F'''
        --streaming={streaming}
    '''.split()
      snake_case_    							=				[sys.executable] + distributed_args + args
      execute_subprocess_async(_a			,       env=os.environ.copy()      )




@pytest.mark.parametrize(
    "nproc_per_node, num_workers"			,       [
        (2, 2),  # each node has 2 shards and each worker has 1 shards
        (3, 2),  # each node uses all the shards but skips examples, and each worker has 2 shards
    ]			,       )
@require_torch
@pytest.mark.skipif(os.name == "nt"			,       reason="execute_subprocess_async doesn't support windows"      )
@pytest.mark.integration
def 	snake_case_							(				_a  :				int			,       _a  :				List[Any]      ):
      snake_case_    							=				True
      snake_case_    							=				get_torch_dist_unique_port()
      snake_case_    							=				Path(_a      ).resolve().parent / "distributed_scripts" / "launch_torch_distributed.py"
      snake_case_    							=				F'''
        -m torch.distributed.launch
        --nproc_per_node={nproc_per_node}
        --master_port={master_port}
        {test_script}
    '''.split()
      snake_case_    							=				F'''
        --streaming={streaming}
        --num_workers={num_workers}
    '''.split()
      snake_case_    							=				[sys.executable] + distributed_args + args
      execute_subprocess_async(_a			,       env=os.environ.copy()      )

