docs: def ip_address_wizard():
      """A wizard which attempts to determine the IP of a SpiNNaker system.
  
      Returns ``{"ip_address": "..."}`` via the :py:exc:`~rig.wizard.Success`
      exception.
      """
      option = yield MultipleChoice(
          "Would you like to auto-detect the SpiNNaker system's IP address?",
          ["Auto-detect",
           "Manually Enter IP address or hostname"],
          0)
      assert 0 <= option < 2
  
      if option == 0:
          yield Prompt(
              "Make sure the SpiNNaker system is switched on and is not booted.")
          yield Info("Discovering attached SpiNNaker systems...")
          ip_address = listen()
          if ip_address is None:
              raise Failure(
                  "Did not discover a locally connected SpiNNaker system.")
      elif option == 1:  # pragma: no branch
          ip_address = yield Text(
              "What is the IP address or hostname of the SpiNNaker system?")
          if ip_address == "":
              raise Failure("No IP address or hostname entered")
  
      raise Success({"ip_address": ip_address})