asdf/test/help_command.bats

#!/usr/bin/env bats

load test_helpers

setup() {
  setup_asdf_dir
  install_dummy_plugin
  install_dummy_legacy_plugin
  run asdf install dummy 1.0
  run asdf install dummy 1.1

  PROJECT_DIR="$HOME/project"
  mkdir -p "$PROJECT_DIR"
}

teardown() {
  clean_asdf_dir
}

@test "help should show dummy plugin help" {
  cd "$PROJECT_DIR"

  run asdf help "dummy"

  expected_output="$(
    cat <<EOF
Dummy plugin documentation

Dummy plugin is a plugin only used for unit tests
EOF
  )"
  [ "$status" -eq 0 ]
  [ "$output" = "$expected_output" ]
}

@test "help should show dummy plugin help specific to version when version is present" {
  cd "$PROJECT_DIR"

  run asdf help "dummy" "1.2.3"

  expected_output="$(
    cat <<EOF
Dummy plugin documentation

Dummy plugin is a plugin only used for unit tests

Details specific for version 1.2.3
EOF
  )"
  [ "$status" -eq 0 ]
  [ "$output" = "$expected_output" ]
}

@test "help should fail for unknown plugins" {
  cd "$PROJECT_DIR"

  run asdf help "sunny"
  [ "$status" -eq 1 ]
  [ "$output" = "No plugin named sunny" ]
}

@test "help should fail when plugin doesn't have documentation callback" {
  cd "$PROJECT_DIR"

  run asdf help "legacy-dummy"
  [ "$status" -eq 1 ]
  [ "$output" = "No documentation for plugin legacy-dummy" ]
}

@test "help should show asdf help when no plugin name is provided" {
  cd "$PROJECT_DIR"

  run asdf help

  [ "$status" -eq 0 ]
  [[ $output == 'version: v'* ]]
  [[ $output == *$'MANAGE PLUGINS\n'* ]]
  [[ $output == *$'MANAGE TOOLS\n'* ]]
  [[ $output == *$'UTILS\n'* ]]
  [[ $output == *$'"Late but latest"\n-- Rajinikanth' ]]
}