# `a` tool

`a` is a command-line tool that can run Android workflows and productivity tools.
For more information, see the design doc at go/a-tool-design-doc.

Contributions welcome!

## Setup: Aliases and Autocomplete

### Bash
Add the following to your  `~/.bashrc` to enable the `a` command and its autocompletion.
```
# Alias for local workflow "a update" tool
a() {
    python3 "$ANDROID_BUILD_TOP/tools/asuite/experiments/a/a.py" "$@"
}
_a_completion() {
  local cur prev opts
  COMPREPLY=()
  cur="${COMP_WORDS[COMP_CWORD]}"
  prev="${COMP_WORDS[COMP_CWORD-1]}"

  if [[ ${prev} == "a" ]] ; then
    COMPREPLY=( $(compgen -W "update" -- ${cur}) )
    return 0
  fi

  if [[ ${prev} == "update" ]] ; then
    COMPREPLY=( $(compgen -W "$(a update --list-aliases)" -- ${cur}) )
    return 0
  fi
}
complete -F _a_completion a
```

### Zsh
Add the following to your `~/.zshrc` to enable the `a` command and its autocompletion.
```
# Turn on auto completion
autoload -U compinit
compinit

# Alias for local workflow "a update" tool
a() {
    python3 "$ANDROID_BUILD_TOP/tools/asuite/experiments/a/a.py" "$@"
}
_a_completion() {
    local state

    _arguments \
        '1: :->command' \
        '*:: :->args'

    case $state in
        command)
            _values 'command' 'update'
            ;;
        args)
            case ${words[1]} in
                update)
                    _arguments '*:alias:_values "alias" $(a update --list-aliases)'
                    ;;
            esac
            ;;
    esac
}
compdef _a_completion a
```

## Running and Developing
You can run the tool using either the `a` alias (if configured) or by directly invoking the script:
```a {config_name}```
or
```python3 a.py {config_name}```

## Testing
Run the tests using any of the following commands:
```python3 -m unittest **/*_test.py```
or
```python3 tests.py``
or
```atest .```