README
¶
Tast (go/tast)
Tast is an integration-testing system for Chrome OS. Its focus is on maintainability, speed, and ease of interpreting and reproducing test results. It supports building, deploying, and running tests. It doesn't implement other functionality like managing labs of devices used for testing, scheduling tests, or storing test results.
For more information, see the list of documentation.
Directory structure
This repository is organized in accordance with the Go in Chromium OS suggestions.
src/chromiumos/cmd/local_test_runner/-mainpackage for thelocal_test_runnerexecutable used to execute local test bundles on-device.cmd/remote_test_runner/-mainpackage for theremote_test_runnerexecutable used to execute remote test bundles on the host system.cmd/tast/-mainpackage for thetastexecutable used to build and run tests....- Packages used only by thetastexecutable.
tast/...- Common packages shared by multiple executables.
Tests are located in the tast-tests repository.
Notes about the logo
The Go gopher concept and design was originally created by Renee French and is covered by the Creative Commons Attribution 3.0 license. The Tast logo above is also covered by the Creative Commons Attribution 3.0 license.
Directories
¶
| Path | Synopsis |
|---|---|
|
src
|
|
|
chromiumos/tast/autocaps
Package autocaps determines the DUT's capabilities by parsing autotest-capability YAML files.
|
Package autocaps determines the DUT's capabilities by parsing autotest-capability YAML files. |
|
chromiumos/tast/bundle
Package bundle contains functionality shared by test bundles.
|
Package bundle contains functionality shared by test bundles. |
|
chromiumos/tast/caller
Package caller provides utilities to inspect the caller of a function.
|
Package caller provides utilities to inspect the caller of a function. |
|
chromiumos/tast/cmd/local_test_runner
Package main implements the local_test_runner executable.
|
Package main implements the local_test_runner executable. |
|
chromiumos/tast/cmd/remote_test_runner
Package main implements the remote_test_runner executable.
|
Package main implements the remote_test_runner executable. |
|
chromiumos/tast/cmd/tast
Package main implements the tast executable, used to build and run tests.
|
Package main implements the tast executable, used to build and run tests. |
|
chromiumos/tast/cmd/tast-lint/internal/diff
Package diff computes differences between strings.
|
Package diff computes differences between strings. |
|
chromiumos/tast/cmd/tast/internal/build
Package build provides support for compiling tests and related executables.
|
Package build provides support for compiling tests and related executables. |
|
chromiumos/tast/cmd/tast/internal/display
Package display provides advanced methods of logging to a terminal.
|
Package display provides advanced methods of logging to a terminal. |
|
chromiumos/tast/cmd/tast/internal/logging
Package logging is used by the tast executable to write informational output.
|
Package logging is used by the tast executable to write informational output. |
|
chromiumos/tast/cmd/tast/internal/run
Package run starts test runners and interprets their output.
|
Package run starts test runners and interprets their output. |
|
chromiumos/tast/cmd/tast/internal/symbolize
Package symbolize provides support for symbolizing crashes.
|
Package symbolize provides support for symbolizing crashes. |
|
chromiumos/tast/cmd/tast/internal/symbolize/breakpad
Package breakpad processes minidump crash reports created by Breakpad.
|
Package breakpad processes minidump crash reports created by Breakpad. |
|
chromiumos/tast/cmd/tast_rtd
Package main implements the tast_rtd executable, used to invoke tast in RTD.
|
Package main implements the tast_rtd executable, used to invoke tast in RTD. |
|
chromiumos/tast/ctxutil
Package ctxutil provides convenience functions for working with context.Context objects.
|
Package ctxutil provides convenience functions for working with context.Context objects. |
|
chromiumos/tast/dut
Package dut provides a connection to a DUT ("Device Under Test") for use by remote tests.
|
Package dut provides a connection to a DUT ("Device Under Test") for use by remote tests. |
|
chromiumos/tast/errors
Package errors provides basic utilities to construct errors.
|
Package errors provides basic utilities to construct errors. |
|
chromiumos/tast/errors/stack
Package stack provides a utility to capture and format a stack trace.
|
Package stack provides a utility to capture and format a stack trace. |
|
chromiumos/tast/fsutil
Package fsutil implements common file operations.
|
Package fsutil implements common file operations. |
|
chromiumos/tast/genutil
Package genutil provides utilities to help "go generate" implementation.
|
Package genutil provides utilities to help "go generate" implementation. |
|
chromiumos/tast/internal/bundle
Package bundle contains internal code that corresponds to the public bundle package.
|
Package bundle contains internal code that corresponds to the public bundle package. |
|
chromiumos/tast/internal/command
Package command contains code shared by executables (e.g.
|
Package command contains code shared by executables (e.g. |
|
chromiumos/tast/internal/control
Package control writes and reads control messages describing the state of a test run.
|
Package control writes and reads control messages describing the state of a test run. |
|
chromiumos/tast/internal/crash
Package crash can be used by local tests to interact with on-device crash reports.
|
Package crash can be used by local tests to interact with on-device crash reports. |
|
chromiumos/tast/internal/dep
Package dep deals with dependencies of tests.
|
Package dep deals with dependencies of tests. |
|
chromiumos/tast/internal/devserver
Package devserver provides a client for devservers.
|
Package devserver provides a client for devservers. |
|
chromiumos/tast/internal/devserver/devservertest
Package devservertest provides a fake implementation of devservers.
|
Package devservertest provides a fake implementation of devservers. |
|
chromiumos/tast/internal/expr
Package expr provides support for evaluating boolean expressions.
|
Package expr provides support for evaluating boolean expressions. |
|
chromiumos/tast/internal/extdata
Package extdata implements the external data file mechanism.
|
Package extdata implements the external data file mechanism. |
|
chromiumos/tast/internal/faketlw
Package faketlw provides a fake implementation of the TLW service.
|
Package faketlw provides a fake implementation of the TLW service. |
|
chromiumos/tast/internal/linuxssh
Package linuxssh provides Linux specific operations conducted via SSH
|
Package linuxssh provides Linux specific operations conducted via SSH |
|
chromiumos/tast/internal/logs
Package logs is used on-device to collect updates to system logs.
|
Package logs is used on-device to collect updates to system logs. |
|
chromiumos/tast/internal/planner
Package planner contains logic to build and execute a test plan.
|
Package planner contains logic to build and execute a test plan. |
|
chromiumos/tast/internal/protocol
Package protocol contains gRPC services and protocol buffer messages used in the core framework.
|
Package protocol contains gRPC services and protocol buffer messages used in the core framework. |
|
chromiumos/tast/internal/rpc
Package rpc provides internal gRPC utilities.
|
Package rpc provides internal gRPC utilities. |
|
chromiumos/tast/internal/runner
Package runner provides functionality shared by test runners.
|
Package runner provides functionality shared by test runners. |
|
chromiumos/tast/internal/runner/gen
Package main implements a script for writing a Go source file containing intel family constants.
|
Package main implements a script for writing a Go source file containing intel family constants. |
|
chromiumos/tast/internal/sshconfig
Package sshconfig provides functionality to parse SSH configuration and return real host information to users.
|
Package sshconfig provides functionality to parse SSH configuration and return real host information to users. |
|
chromiumos/tast/internal/sshtest
Package sshtest provides support code for testing the host package.
|
Package sshtest provides support code for testing the host package. |
|
chromiumos/tast/internal/testcontext
Package testcontext provides logic to extract information from context.
|
Package testcontext provides logic to extract information from context. |
|
chromiumos/tast/internal/testing
Package testing implements public framework APIs, as well as framework-internal facility to run an entity.
|
Package testing implements public framework APIs, as well as framework-internal facility to run an entity. |
|
chromiumos/tast/internal/testingutil
Package testingutil is a kitchen sink of utilities shared by Tast tests and Tast framework.
|
Package testingutil is a kitchen sink of utilities shared by Tast tests and Tast framework. |
|
chromiumos/tast/lsbrelease
Package lsbrelease provides a parser of /etc/lsb-release.
|
Package lsbrelease provides a parser of /etc/lsb-release. |
|
chromiumos/tast/rpc
Package rpc provides gRPC utilities for Tast tests.
|
Package rpc provides gRPC utilities for Tast tests. |
|
chromiumos/tast/shutil
Package shutil provides shell-related utility functions.
|
Package shutil provides shell-related utility functions. |
|
chromiumos/tast/ssh
Package ssh provides means to communicate with remote host through SSH.
|
Package ssh provides means to communicate with remote host through SSH. |
|
chromiumos/tast/ssh/linuxssh
Package linuxssh provides Linux specific operations conducted via SSH TODO(oka): now that this file is not used from framework, simplify the code.
|
Package linuxssh provides Linux specific operations conducted via SSH TODO(oka): now that this file is not used from framework, simplify the code. |
|
chromiumos/tast/testing
Package testing provides public API for tests.
|
Package testing provides public API for tests. |
|
chromiumos/tast/testing/hwdep
Package hwdep provides the hardware dependency mechanism to select tests to run on a DUT based on its hardware features and setup.
|
Package hwdep provides the hardware dependency mechanism to select tests to run on a DUT based on its hardware features and setup. |
|
chromiumos/tast/testing/testcheck
Package testcheck provides common functions to check test definitions.
|
Package testcheck provides common functions to check test definitions. |
|
chromiumos/tast/testutil
Package testutil provides support code for unit tests.
|
Package testutil provides support code for unit tests. |
|
chromiumos/tast/timing
Package timing is used to collect and write timing information about a process.
|
Package timing is used to collect and write timing information about a process. |
Click to show internal directories.
Click to hide internal directories.