Interactive Usage

This page will guide you to use Honeydew using an interactive python terminal.

Before proceeding further, please make sure to follow Setup and Installation steps.

After the installation succeeds, follow the script's instruction message to start a Python interpreter and import Honeydew.

Setup

The Honeydew library depends on some Fuchsia build artifacts that must be built for Honeydew to be successfully imported in Python. So before running conformance scripts or to use Honeydew in interactive python terminal, you need to run the below commands.

• Run appropriate fx set command along with --with-host //src/testing/end_to_end/honeydew param.
  • If test case requires SL4f transport then make sure to do the following:
    • Use a <PRODUCT> that supports SL4F (such as core)
    • Include --with //src/testing/sl4f --with //src/sys/bin/start_sl4f
    • Include --args=core_realm_shards+="[\"//src/testing/sl4f:sl4f_core_shard\"]"
      • Alternatively, run fx set without the --args option, and then run fx args, and add the line directly to the args.gn file in the editor that opens.
• Run fx build

~/fuchsia$ fx set core.x64 --with-host //src/testing/end_to_end/honeydew
~/fuchsia$ fx build

Creation

# Enable Info logging
>>> import logging
>>> logging.basicConfig(level=logging.INFO)

# Setup Honeydew to run using isolated FFX and collect the logs
# Call this first prior to calling any other Honeydew API
>>> import os
>>> FUCHSIA_ROOT = os.environ.get("FUCHSIA_DIR")
>>> FFX_BIN = f"{FUCHSIA_ROOT}/.jiri_root/bin/ffx"
>>> FFX_PLUGINS_PATH=f"{FUCHSIA_ROOT}/out/default/host-tools"
>>> from honeydew.transports import ffx
>>> ffx_config = ffx.FfxConfig()
>>> ffx_config.setup(binary_path=FFX_BIN, isolate_dir=None, logs_dir="/tmp/logs/honeydew/", logs_level="debug", enable_mdns=True, subtools_search_path=FFX_PLUGINS_PATH)

# Create Honeydew device object for a local device
>>> import honeydew
>>> emu = honeydew.create_device("fuchsia-emulator", transport=honeydew.typing.custom_types.TRANSPORT.SL4F, ffx_config=ffx_config.get_config())
# Note - Depending on whether you want to use SL4F or Fuchsia-Controller as a primary transport to perform the host-(fuchsia) target communications, set `transport` variable accordingly

# Create Honeydew device object for a remote/wfh device
>>> from honeydew.typing import custom_types
# Note - While using remote/wfh device, you need to pass `device_ip_port` argument.
# "[::1]:8022" is a fuchsia device whose SSH port is proxied via SSH from a local machine to a remote workstation.
>>> fd_remote = honeydew.create_device("fuchsia-d88c-796c-e57e", transport=honeydew.honeydew.typing.custom_types.TRANSPORT.SL4F, ffx_config=ffx_config.get_config(), device_ip_port=custom_types.IpPort.create_using_ip_and_port("[::1]:8022"))

# You can now start doing host-(fuchsia)target interactions using object returned by `honeydew.create_device()`
# To check all operations, affordances and transports supported, use `dir` command
>>> dir(emu)