Add fish shell compatible output

[chksome]

This adds a new argument -shell and the option to print fish shell compatible output. The default is still bash/zsh compatible output.

Documentation updated to match.

[mame]

Thanks. I think it is a good feature, but I am unsure if --shell fish is a good option. Do you know of any other examples?

I checked how ssh-agent does.

• ssh-agent -s outputs Bourne shell commands: SSH_AUTH_SOCK=/path/to/sock; export SSH_AUTH_SOCK;.
• ssh-agent -c outputs a C-shell command: setenv SSH_AUTH_SOCK /path/to/sock.
• If not specified, ssh-agent automatically checks if the environment variable SHELL ends with "csh".

And fish users seem to use eval (ssh-agent -c).

If we follow ssh-agent, it might be good to print setenv when --csh is given.

[mame]

Suggested change

	Bash or Zsh
	#### Bash or Zsh

[mame]

Suggested change

	Fish
	#### Fish

[mame]

Shouldn't it be $HOME/wsl2-ssh-agent --shell fish | source ?

[chksome]

Yup, good catch. Will fix.

[mame]

If there is no particular reason, please do not change these.

[chksome]

Whoops, yeah, I'll fix.
EDIT: So it seems Prettier is a fan of using - for unordered lists instead of *, hence how this change sneaked in on me. I'll change it back if you want, or keep it to be "more standards compliant". I don't really care either way, but if it stays this way you'll be good to go if you decide to start using it for formatting.

[mame]

I have reconsidered. I don't think it's a good idea to include the --csh option in modern times. If you show me that there are already major commands that implements --shell fish option, I'll be OK.

[Hill-98]

Maybe this is a good choice?

command -v export &>/dev/null && export A=1 || set A 1;:

Edit: I think we may need an option like -only-output-socket-path so that we can use export SSH_AUTH_SOCK="$(wsl2-ssh-agent -only-output-socket-path)" to be compatible with any Shell.

[chksome]

I have reconsidered. I don't think it's a good idea to include the --csh option in modern times. If you show me that there are already major commands that implements --shell fish option, I'll be OK.

I agree that a switch for each shell seems antiquated. I was going to do that first then changed to the current -shell argument so the argument list doesn't get really polluted. I'll be honest though, I don't know of any other application with a -shell argument. rbenv handles this with a shell name as an argument to init. Starship does the same thing. What's here now is in the same spirit, but of course with a different name. I'm open to changing it as I just kind of picked the second thing that came to mind.

[mame]

How about this.

• Add --format {auto,bash,zsh,csh,fish}
• Default is --format auto, which changes the output depending on the SHELL environment variable
  • If SHELL ends with fish, print set -x SSH_AUTH_SOCK /path/to/sock
  • if SHELL ends with csh, print setenv SSH_AUTH_SOCK /path/to/sock
  • Otherwise, print SSH_AUTH_SOCK=/path/to/sock; export SSH_AUTH_SOCK;

Just in case, I want to leave room for future extensions, such as --format bare-path to show just the path as @Hill-98 said, or --format custom:"export SSH_AUTH_SOCK=%s" to use a custom format.

@Hill-98 I like polyglot too, but I am afraid that ordinary users might be suspicious when they see the output.

[mame]

@chksome I have created another pull request #11 with you as Co-Author. If you agree with it, I will merge it.

[chksome]

Better solution in #11. Closing this one.