code: def upload_py_modules_if_needed(
      runtime_env: Dict[str, Any],
      scratch_dir: Optional[str] = os.getcwd(),
      logger: Optional[logging.Logger] = default_logger,
      upload_fn=None,
  ) -> Dict[str, Any]:
      """Uploads the entries in py_modules and replaces them with a list of URIs.
  
      For each entry that is already a URI, this is a no-op.
      """
      py_modules = runtime_env.get("py_modules")
      if py_modules is None:
          return runtime_env
  
      if not isinstance(py_modules, list):
          raise TypeError(
              "py_modules must be a List of local paths, imported modules, or "
              f"URIs, got {type(py_modules)}."
          )
  
      py_modules_uris = []
      for module in py_modules:
          if isinstance(module, str):
              # module_path is a local path or a URI.
              module_path = module
          elif isinstance(module, Path):
              module_path = str(module)
          elif isinstance(module, ModuleType):
              # NOTE(edoakes): Python allows some installed Python packages to
              # be split into multiple directories. We could probably handle
              # this, but it seems tricky & uncommon. If it's a problem for
              # users, we can add this support on demand.
              if len(module.__path__) > 1:
                  raise ValueError(
                      "py_modules only supports modules whose __path__ has length 1."
                  )
              [module_path] = module.__path__
          else:
              raise TypeError(
                  "py_modules must be a list of file paths, URIs, "
                  f"or imported modules, got {type(module)}."
              )
  
          if _check_is_uri(module_path):
              module_uri = module_path
          else:
              # module_path is a local path.
              if Path(module_path).is_dir():
                  excludes = runtime_env.get("excludes", None)
                  module_uri = get_uri_for_directory(
                      module_path, excludes=excludes
                  )
                  if upload_fn is None:
                      try:
                          upload_package_if_needed(
                              module_uri,
                              scratch_dir,
                              module_path,
                              excludes=excludes,
                              include_parent_dir=True,
                              logger=logger,
                          )
                      except Exception as e:
                          from ray.util.spark.utils import (
                              is_in_databricks_runtime,
                          )
  
                          if is_in_databricks_runtime():
                              raise RuntimeEnvSetupError(
                                  f"Failed to upload module {module_path} to the Ray "
                                  f"cluster, please ensure there are only files under "
                                  f"the module path, notebooks under the path are "
                                  f"not allowed, original exception: {e}"
                              ) from e
                          raise RuntimeEnvSetupError(
                              f"Failed to upload module {module_path} to the Ray "
                              f"cluster: {e}"
                          ) from e
                  else:
                      upload_fn(module_path, excludes=excludes)
              elif Path(module_path).suffix == ".whl":
                  module_uri = get_uri_for_package(Path(module_path))
                  if upload_fn is None:
                      if not package_exists(module_uri):
                          try:
                              upload_package_to_gcs(
                                  module_uri,
                                  Path(module_path).read_bytes(),
                              )
                          except Exception as e:
                              raise RuntimeEnvSetupError(
                                  f"Failed to upload {module_path} to the Ray "
                                  f"cluster: {e}"
                              ) from e
                  else:
                      upload_fn(
                          module_path, excludes=None, is_file=True
                      )
              else:
                  raise ValueError(
                      "py_modules entry must be a directory or a .whl file; "
                      f"got {module_path}"
                  )
  
          py_modules_uris.append(module_uri)
  
      # TODO(architkulkarni): Expose a single URI for py_modules.  This plugin
      # should internally handle the "sub-URIs", the individual modules.
  
      runtime_env["py_modules"] = py_modules_uris
      return runtime_env
  
file_path: ray/python/ray/_private/runtime_env/py_modules.py
imports: import logging
  import os
  from pathlib import Path
  from types import ModuleType
  from typing import Any, Dict, List, Optional
  from ray._private.runtime_env.context import RuntimeEnvContext
  from ray._private.runtime_env.packaging import Protocol, delete_package, download_and_unpack_package, get_local_dir_from_uri, get_uri_for_directory, get_uri_for_package, install_wheel_package, is_whl_uri, package_exists, parse_uri, upload_package_if_needed, upload_package_to_gcs
  from ray._private.runtime_env.plugin import RuntimeEnvPlugin
  from ray._private.runtime_env.working_dir import set_pythonpath_in_context
  from ray._private.utils import get_directory_size_bytes, try_to_create_directory
  from ray.exceptions import RuntimeEnvSetupError
label_desc: Use image node_id 2 for calling a global function with example usage: upload_py_modules_if_needed(runtime_env, scratch_dir, logger, upload_fn) and returns: runtime_env, runtime_env