Added support for passing values read from a file using --file

[tehsis]

Description

This PR adds supports for --file <path> modifier in esc env set.
This modifier will read the file in and, if it's a valid string content, will use that to set the value of the specified key.

Usage

$ esc env set --file /path/to/file.txt myorg/myproj/myenv "mykey"

the --file flag also supports passing "-" to read from stdin so its consistent with the behavior of --file flag in esc env edit

$ cat /path/to/file.txt | esc env set --file - myorg/myproj/myenv

The flag can be combined with other flags. For example to store a file as a rawstring content and secret:

$ esc env set --secret --string --file /path/to/file.pem myorg/myproj/myenv "mykey"

To simplify reading file content, we fixed a bug where a new line is always being added at the end of the value when using --value string in esc env open and esc env get.

Users will be able to get the file content from esc.

eg.

$ esc env set --secret --string --file /path/to/file.pem myorg/myproj/myenv "mypemfile"
$ esc env get --show-secrets --value string myorg/myproj/myenv "mypemfile" >> /path/to/file_1.pem
$ diff /path/to/file_1.pem /path/to/file.pem
$

Known Issues

--file does not currently supports binary files (or any other file that does not contain valid utf-8 characters). These files require special treatment and might be included in another change (see #483)

[Copilot]

Pull Request Overview

This PR adds support for a --file flag to the esc env set command, allowing users to read values from files or stdin instead of providing them as command-line arguments. Additionally, it fixes a bug where an unnecessary newline was being appended to string values in esc env open and esc env get commands.

• Adds --file parameter to esc env set command with support for reading from files or stdin (using "-")
• Modifies argument validation to allow fewer arguments when --file flag is used
• Fixes newline handling in string output format for env open and env get commands

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
cmd/esc/cli/env_set.go	Implements --file flag functionality with UTF-8 validation and argument handling changes
cmd/esc/cli/env_open.go	Fixes string output format to avoid duplicate newlines and updates help text
cmd/esc/cli/env_get.go	Updates help text to include 'string' format option
CHANGELOG_PENDING.md	Documents the new --file parameter feature

[pgavlin]

These changes need tests. We have a pretty robust test harness for the CLI's code--you can use the tests for env set and the tests for env edit -f for reference. I'd recommend adding tests in a new testdata file (e.g. env-set-file.yaml).

[pgavlin]

Could use one more test, but LGTM otherwise

[rgharris]

LGTM other than there may still be a leading newline issue.

[tehsis]

I was able to reproduce the multiline issue that Robert mentioned. Will take a look into that

[pulumi-bot]

This PR has been shipped in release v0.15.0.