Collection of host-driven, hardware-agnostic Fuchsia connectivity tests. Mainly targeting WLAN and Netstack testing.
Docs | Report Bug | Request Feature
Requires Python 3.8+
Clone the repo
git clone https://fuchsia.googlesource.com/antlion
Install dependencies using venv
cd antlion python3 -m venv .venv # Create a virtual environment in the `.venv` directory source .venv/bin/activate # Activate the virtual environment pip install --editable . # Run `deactivate` later to exit the virtual environment
Write the sample config and update the Fuchsia controller to match your development environment
mkdir -p config cat <<EOF > config/simple.json { "testbed": [{ "name": "simple_testbed", "FuchsiaDevice": [{ "ip": "fuchsia-00e0-4c01-04df" }] }], "logpath": "logs" } EOF
Run the sanity test
antlion -c config/simple.json -tc Sl4fSanityTest
See antlion -h
for more full usage.
Contributions are what make open source projects a great place to learn, inspire, and create. Any contributions you make are greatly appreciated. If you have a suggestion that would make this better, please create a CL.
Before contributing, a few more tools are necessary:
pip install --editable ".[dev]"
To create a CL:
git checkout -b feature/amazing-feature
)CHANGELOG.md
Black
formattergit add . && git commit -m 'Add some amazing feature'
)git push origin HEAD:refs/for/main
)A public bug tracker is not (yet) available.
There are a handful of git commands that will be commonly used throughout the process of contributing. Here are a few aliases to add to your git config (~/.gitconfig
) for a smoother workflow:
git amend
to modify your CL in response to code review commentsgit uc
to upload your CL, run pre-submit tests, enable auto-submit, and add a reviewer[alias] amend = commit --amend --no-edit uc = push origin HEAD:refs/for/main%l=Commit-Queue+1,l=Fuchsia-Auto-Submit+1,publish-comments,r=sbalana
You may also want to add a section to ignore the project's large formatting changes:
[blame] ignoreRevsFile = .git-blame-ignore-revs
Distributed under the Apache 2.0 License. See LICENSE
for more information.
This is a fork of ACTS, the connectivity testing framework used by Android. The folks over there did a great job at cultivating amazing tools, much of which are being used or have been extended with additional features.
antlion
and ACTS share the same git history, so migrating existing changes is straightforward:
Checkout to latest main
git checkout main git pull --rebase origin main
Cherry-pick the ACTS change
git fetch acts refs/changes/16/12345/6 && git checkout -b change-12345 FETCH_HEAD git fetch https://android.googlesource.com/platform/tools/test/connectivity refs/changes/30/2320530/1 && git cherry-pick FETCH_HEAD
Resolve any merge conflicts, if any
git add [...] git rebase --continue
Upload CL
git push origin HEAD:refs/for/main # or "git uc" if using the alias