tag	934db5a4919de87bd92e87f030876a335a2cb0d7
tagger	Sam Balana <sbalana@google.com>	Mon Nov 28 15:54:46 2022 -0800
object	6699665bb8250b8cf550cb6d2055063e4527a7ff

commit	6699665bb8250b8cf550cb6d2055063e4527a7ff	[log] [tgz]
author	CQ Bot <fuchsia-internal-scoped@luci-project-accounts.iam.gserviceaccount.com>	Mon Nov 28 23:29:18 2022 +0000
committer	Gerrit Code Review <noreply-gerritcodereview@google.com>	Mon Nov 28 23:29:18 2022 +0000
tree	c5d47880df5d6abb6baa1354edc19a0cdd003190
parent	7b3743352e1c4e65ea5e426b0f80abc9202b7ed2 [diff]
parent	c1360c7e8d27fe3cb5038edc232799d5878ea450 [diff]

tree: c5d47880df5d6abb6baa1354edc19a0cdd003190

README.md

antlion

Collection of host-driven, hardware-agnostic Fuchsia connectivity tests. Mainly targeting WLAN and Netstack testing.

Getting Started

Requires Python 3.8+

Clone the repo

git clone https://fuchsia.googlesource.com/antlion

Install dependencies

cd antlion
python3 -m venv .venv
source .venv/bin/activate
pip install --editable .[dev] # development mode

Write the sample config and update the Fuchsia controller to match your development environment

cat <<EOF > config.json
{
   "testbed": [{
      "name": "simple_testbed",
      "FuchsiaDevice": [{
         "ip": "fuchsia-00e0-4c01-04df",
         "ssh_config": "/home/fuchsia/out/default/ssh-keys/ssh_config",
         "ffx_binary_path": "/home/fuchsia/out/default/host_x64/ffx"
      }]
   }],
   "logpath": "logs",
   "testpaths": [ "tests" ]
}
EOF

Run the sanity test

antlion -c config.json -tc Sl4fSanityTest

See antlion -h for more full usage.

Contributing

Contributions are what make open source 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 pull request.

Create a feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add some amazing feature')
Upload CL (git push origin HEAD:refs/for/main)

A public bug tracker is not (yet) available.

Recommended git aliases

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 comments
git 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

License

Distributed under the Apache 2.0 License. See LICENSE for more information.

Acknowledgments

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.

Migrating CLs from ACTS

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