t / t0303-credential-external.shon commit conditional markdown preprocessing (c8b1cd9)
   1#!/bin/sh
   2
   3test_description='external credential helper tests
   4
   5This is a tool for authors of external helper tools to sanity-check
   6their helpers. If you have written the "git-credential-foo" helper,
   7you check it with:
   8
   9  make GIT_TEST_CREDENTIAL_HELPER=foo t0303-credential-external.sh
  10
  11This assumes that your helper is capable of both storing and
  12retrieving credentials (some helpers may be read-only, and they will
  13fail these tests).
  14
  15Please note that the individual tests do not verify all of the
  16preconditions themselves, but rather build on each other. A failing
  17test means that tests later in the sequence can return false "OK"
  18results.
  19
  20If your helper supports time-based expiration with a configurable
  21timeout, you can test that feature with:
  22
  23  make GIT_TEST_CREDENTIAL_HELPER=foo \
  24       GIT_TEST_CREDENTIAL_HELPER_TIMEOUT="foo --timeout=1" \
  25       t0303-credential-external.sh
  26
  27If your helper requires additional setup before the tests are started,
  28you can set GIT_TEST_CREDENTIAL_HELPER_SETUP to a sequence of shell
  29commands.
  30'
  31
  32. ./test-lib.sh
  33. "$TEST_DIRECTORY"/lib-credential.sh
  34
  35if test -z "$GIT_TEST_CREDENTIAL_HELPER"; then
  36        skip_all="used to test external credential helpers"
  37        test_done
  38fi
  39
  40test -z "$GIT_TEST_CREDENTIAL_HELPER_SETUP" ||
  41        eval "$GIT_TEST_CREDENTIAL_HELPER_SETUP"
  42
  43# clean before the test in case there is cruft left
  44# over from a previous run that would impact results
  45helper_test_clean "$GIT_TEST_CREDENTIAL_HELPER"
  46
  47helper_test "$GIT_TEST_CREDENTIAL_HELPER"
  48
  49if test -z "$GIT_TEST_CREDENTIAL_HELPER_TIMEOUT"; then
  50        say "# skipping timeout tests (GIT_TEST_CREDENTIAL_HELPER_TIMEOUT not set)"
  51else
  52        helper_test_timeout "$GIT_TEST_CREDENTIAL_HELPER_TIMEOUT"
  53fi
  54
  55# clean afterwards so that we are good citizens
  56# and don't leave cruft in the helper's storage, which
  57# might be long-term system storage
  58helper_test_clean "$GIT_TEST_CREDENTIAL_HELPER"
  59
  60test_done