keyfunc/internal/cli/age_test.go

package cli_test

import (
	"io"
	"os"
	"os/exec"
	"path/filepath"
	"strings"
	"syscall"
	"testing"
	"time"

	"github.com/stretchr/testify/require"
	"sneak.berlin/go/keyfunc/internal/agekey"
	"sneak.berlin/go/keyfunc/internal/mnemonic"
)

func TestTheAgeCommandsPrintTheKey(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	recipient := strings.TrimSpace(run(t, "age", "pub"))
	require.True(t, strings.HasPrefix(recipient, "age1"))

	identity := strings.TrimSpace(run(t, "age", "priv"))
	require.True(t, strings.HasPrefix(identity, "AGE-SECRET-KEY-1"))
}

func TestAFileEncryptedByTheToolIsReadBackByIt(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	plain := written(t, "notes.txt", "the secret\n")
	sealed := filepath.Join(t.TempDir(), "notes.age")

	run(t, "age", "encrypt", "-o", sealed, plain)
	require.Equal(t, "the secret\n", run(t, "age", "decrypt", sealed))
}

func TestTheArmoredFormIsTextThatDecrypts(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	plain := written(t, "notes.txt", "the secret\n")

	armored := run(t, "age", "encrypt", "--armor", plain)
	require.True(t, strings.HasPrefix(
		armored, "-----BEGIN AGE ENCRYPTED FILE-----",
	))

	sealed := written(t, "notes.age", armored)
	require.Equal(t, "the secret\n", run(t, "age", "decrypt", sealed))
}

func TestAnotherRecipientIsAddedAndTheDerivedOneStays(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	theirs := strings.TrimSpace(run(t, "age", "pub", "-n", "7"))
	plain := written(t, "notes.txt", "the secret\n")
	sealed := filepath.Join(t.TempDir(), "notes.age")

	run(t, "age", "encrypt", "--to", theirs, "-o", sealed, plain)

	require.Equal(t, "the secret\n", run(t, "age", "decrypt", sealed))
	require.Equal(t,
		"the secret\n", run(t, "age", "decrypt", "-n", "7", sealed),
	)
}

func TestAFileForAnotherKeyIsRefused(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	plain := written(t, "notes.txt", "the secret\n")
	sealed := filepath.Join(t.TempDir(), "notes.age")

	run(t, "age", "encrypt", "-n", "7", "-o", sealed, plain)

	_, err := execute(t, "age", "decrypt", sealed)
	require.ErrorIs(t, err, agekey.ErrNotRecipient)
}

func TestARefusedDecryptionLeavesTheOutputFileAlone(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	plain := written(t, "notes.txt", "the secret\n")
	sealed := filepath.Join(t.TempDir(), "notes.age")
	existing := written(t, "notes.out", "what was already there\n")

	run(t, "age", "encrypt", "-n", "7", "-o", sealed, plain)

	_, err := execute(t, "age", "decrypt", "-o", existing, sealed)
	require.ErrorIs(t, err, agekey.ErrNotRecipient)

	//nolint:gosec // the test made this path itself
	kept, err := os.ReadFile(existing)
	require.NoError(t, err)
	require.Equal(t, "what was already there\n", string(kept))
}

func TestASignalStopsAnEncryptionAndPutsNoFileInPlace(t *testing.T) {
	t.Setenv(mnemonic.Variable, example())

	for _, ending := range []os.Signal{
		syscall.SIGTERM, syscall.SIGINT, syscall.SIGHUP,
	} {
		encryptionInterrupted(t, ending.String(), ending)
	}
}

// encryptionInterrupted runs "age encrypt -o" as a subprocess reading
// from a pipe that stays open, waits until the tool has begun writing
// the file beside the one it was named, and sends it the signal. The
// tool has to end on the signal alone, with a failure, and leave
// nothing at the name it was given. A tool that went on reading would
// not end until the input did, and would then put the encryption of the
// cut-off input in place.
func encryptionInterrupted(t *testing.T, name string, signal os.Signal) {
	t.Helper()

	directory := t.TempDir()
	sealed := filepath.Join(directory, "notes.age")

	//nolint:gosec // the binary is this test's own, re-run as the tool
	command := exec.CommandContext(
		t.Context(), os.Args[0], "age", "encrypt", "-o", sealed,
	)

	command.Env = append(os.Environ(), runAsTool+"=1")

	producer, err := command.StdinPipe()
	require.NoError(t, err)
	require.NoError(t, command.Start())

	_, err = io.WriteString(producer, "the start of the secret\n")
	require.NoError(t, err)

	// The file beside the named one is made once the mnemonic has been
	// read, just before the encryption starts.
	require.Eventually(t, func() bool {
		entries, err := os.ReadDir(directory)

		return err == nil && len(entries) > 0
	}, 5*time.Second, 5*time.Millisecond)

	require.NoError(t, command.Process.Signal(signal))
	waitForTool(t, name, command)

	require.False(t, command.ProcessState.Success(), name)
	require.NoFileExists(t, sealed, name)
}

// written puts the contents in a file of that name in a directory of
// this test's own and returns the path to it.
func written(t *testing.T, name, contents string) string {
	t.Helper()

	path := filepath.Join(t.TempDir(), name)
	require.NoError(t, os.WriteFile(path, []byte(contents), 0o600))

	return path
}