dspex

# Generated by SnakeBridge v0.12.0 - DO NOT EDIT MANUALLY
# Regenerate with: mix compile
# Library: dspy 3.1.2
# Python module: dspy.teleprompt.simba_utils

defmodule Dspy.Teleprompt.SimbaUtils do
  @moduledoc """
  Submodule bindings for `dspy.teleprompt.simba_utils`.
  """

  def __snakebridge_python_name__, do: "dspy.teleprompt.simba_utils"
  def __snakebridge_library__, do: "dspy"

  @doc """

  """
  @spec append_a_demo(term(), keyword()) :: {:ok, term()} | {:error, Snakepit.Error.t()}
  def append_a_demo(demo_input_field_maxlen, opts \\ []) do
    SnakeBridge.Runtime.call(__MODULE__, :append_a_demo, [demo_input_field_maxlen], opts)
  end

  @doc """

  """
  @spec append_a_rule(term(), term(), keyword()) :: {:ok, term()} | {:error, Snakepit.Error.t()}
  def append_a_rule(bucket, system, opts \\ []) do
    SnakeBridge.Runtime.call(__MODULE__, :append_a_rule, [bucket, system], opts)
  end

  @doc """

  """
  @spec inspect_modules(term(), keyword()) :: {:ok, term()} | {:error, Snakepit.Error.t()}
  def inspect_modules(program, opts \\ []) do
    SnakeBridge.Runtime.call(__MODULE__, :inspect_modules, [program], opts)
  end

  @doc """

  """
  @spec prepare_models_for_resampling(Dspy.Primitives.Module.Module.t(), integer()) ::
          {:ok, term()} | {:error, Snakepit.Error.t()}
  @spec prepare_models_for_resampling(Dspy.Primitives.Module.Module.t(), integer(), keyword()) ::
          {:ok, term()} | {:error, Snakepit.Error.t()}
  @spec prepare_models_for_resampling(Dspy.Primitives.Module.Module.t(), integer(), term()) ::
          {:ok, term()} | {:error, Snakepit.Error.t()}
  @spec prepare_models_for_resampling(
          Dspy.Primitives.Module.Module.t(),
          integer(),
          term(),
          keyword()
        ) :: {:ok, term()} | {:error, Snakepit.Error.t()}
  def prepare_models_for_resampling(program, n) do
    SnakeBridge.Runtime.call(__MODULE__, :prepare_models_for_resampling, [program, n], [])
  end

  def prepare_models_for_resampling(program, n, opts)
      when is_list(opts) and
             (opts == [] or
                (is_tuple(hd(opts)) and tuple_size(hd(opts)) == 2 and is_atom(elem(hd(opts), 0)))) do
    SnakeBridge.Runtime.call(__MODULE__, :prepare_models_for_resampling, [program, n], opts)
  end

  def prepare_models_for_resampling(program, n, teacher_settings) do
    SnakeBridge.Runtime.call(
      __MODULE__,
      :prepare_models_for_resampling,
      [program, n, teacher_settings],
      []
    )
  end

  def prepare_models_for_resampling(program, n, teacher_settings, opts)
      when is_list(opts) and
             (opts == [] or
                (is_tuple(hd(opts)) and tuple_size(hd(opts)) == 2 and is_atom(elem(hd(opts), 0)))) do
    SnakeBridge.Runtime.call(
      __MODULE__,
      :prepare_models_for_resampling,
      [program, n, teacher_settings],
      opts
    )
  end

  @doc """

  """
  @spec recursive_mask(term(), keyword()) :: {:ok, term()} | {:error, Snakepit.Error.t()}
  def recursive_mask(o, opts \\ []) do
    SnakeBridge.Runtime.call(__MODULE__, :recursive_mask, [o], opts)
  end

  @doc """

  """
  @spec wrap_program(Dspy.Primitives.Module.Module.t(), term(), keyword()) ::
          {:ok, term()} | {:error, Snakepit.Error.t()}
  def wrap_program(program, metric, opts \\ []) do
    SnakeBridge.Runtime.call(__MODULE__, :wrap_program, [program, metric], opts)
  end
end