| 
									
										
											  
											
												Allow brew shellenv to accept a shell name param
Resolves #15358
With this change, `brew shellenv` will accept a shell name parameter to
override its default output (based on `/bin/ps`) for advanced use cases
such as with dotfile templating and caching with
[twpayne/chezmoi](https://github.com/twpayne/chezmoi/discussions/2971).
When running under `fish`, this is the output:
```console
$ brew shellenv pwsh
[System.Environment]::SetEnvironmentVariable('HOMEBREW_PREFIX','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_CELLAR','/opt/homebrew/Cellar',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_REPOSITORY','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('PATH',$('/opt/homebrew/bin:/opt/homebrew/sbin:'+$ENV:PATH),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('MANPATH',$('/opt/homebrew/share/man'+$(if(${ENV:MANPATH}){':'+${ENV:MANPATH}})+':'),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('INFOPATH',$('/opt/homebrew/share/info'+$(if(${ENV:INFOPATH}){':'+${ENV:INFOPATH}})),[System.EnvironmentVariableTarget]::Process)
$ brew shellenv
set -gx HOMEBREW_PREFIX "/opt/homebrew";
set -gx HOMEBREW_CELLAR "/opt/homebrew/Cellar";
set -gx HOMEBREW_REPOSITORY "/opt/homebrew";
set -q PATH; or set PATH ''; set -gx PATH "/opt/homebrew/bin" "/opt/homebrew/sbin" $PATH;
set -q MANPATH; or set MANPATH ''; set -gx MANPATH "/opt/homebrew/share/man" $MANPATH;
set -q INFOPATH; or set INFOPATH ''; set -gx INFOPATH "/opt/homebrew/share/info" $INFOPATH;
```
The specific case presented in the mentioned discussion could be
mitigated by an additional level of indirection (`{{ output "fish" "-c"
"'brew shellenv'" | trim }}`), that requires that the running system
have the target shells installed, when they are not strictly necessary
with `brew shellenv`.
											
										 
											2023-05-04 10:28:11 -04:00
										 |  |  | #:  * `shellenv [bash|csh|fish|pwsh|sh|tcsh|zsh]` | 
					
						
							| 
									
										
										
										
											2018-09-13 09:27:43 +01:00
										 |  |  | #: | 
					
						
							| 
									
										
										
										
											2019-08-20 00:04:14 -04:00
										 |  |  | #:  Print export statements. When run in a shell, this installation of Homebrew will be added to your `PATH`, `MANPATH`, and `INFOPATH`. | 
					
						
							| 
									
										
										
										
											2018-09-13 09:27:43 +01:00
										 |  |  | #: | 
					
						
							| 
									
										
										
										
											2019-08-20 00:04:14 -04:00
										 |  |  | #:  The variables `HOMEBREW_PREFIX`, `HOMEBREW_CELLAR` and `HOMEBREW_REPOSITORY` are also exported to avoid querying them multiple times. | 
					
						
							| 
									
										
										
										
											2022-01-15 17:27:39 -05:00
										 |  |  | #:  To help guarantee idempotence, this command produces no output when Homebrew's `bin` and `sbin` directories are first and second | 
					
						
							| 
									
										
										
										
											2023-09-27 16:35:03 +08:00
										 |  |  | #:  respectively in your `PATH`. Consider adding evaluation of this command's output to your dotfiles (e.g. `~/.bash_profile` or | 
					
						
							|  |  |  | #:  `~/.zprofile` on macOS and `~/.bashrc` or `~/.zshrc` on Linux) with: `eval "$(brew shellenv)"` | 
					
						
							| 
									
										
											  
											
												Allow brew shellenv to accept a shell name param
Resolves #15358
With this change, `brew shellenv` will accept a shell name parameter to
override its default output (based on `/bin/ps`) for advanced use cases
such as with dotfile templating and caching with
[twpayne/chezmoi](https://github.com/twpayne/chezmoi/discussions/2971).
When running under `fish`, this is the output:
```console
$ brew shellenv pwsh
[System.Environment]::SetEnvironmentVariable('HOMEBREW_PREFIX','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_CELLAR','/opt/homebrew/Cellar',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_REPOSITORY','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('PATH',$('/opt/homebrew/bin:/opt/homebrew/sbin:'+$ENV:PATH),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('MANPATH',$('/opt/homebrew/share/man'+$(if(${ENV:MANPATH}){':'+${ENV:MANPATH}})+':'),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('INFOPATH',$('/opt/homebrew/share/info'+$(if(${ENV:INFOPATH}){':'+${ENV:INFOPATH}})),[System.EnvironmentVariableTarget]::Process)
$ brew shellenv
set -gx HOMEBREW_PREFIX "/opt/homebrew";
set -gx HOMEBREW_CELLAR "/opt/homebrew/Cellar";
set -gx HOMEBREW_REPOSITORY "/opt/homebrew";
set -q PATH; or set PATH ''; set -gx PATH "/opt/homebrew/bin" "/opt/homebrew/sbin" $PATH;
set -q MANPATH; or set MANPATH ''; set -gx MANPATH "/opt/homebrew/share/man" $MANPATH;
set -q INFOPATH; or set INFOPATH ''; set -gx INFOPATH "/opt/homebrew/share/info" $INFOPATH;
```
The specific case presented in the mentioned discussion could be
mitigated by an additional level of indirection (`{{ output "fish" "-c"
"'brew shellenv'" | trim }}`), that requires that the running system
have the target shells installed, when they are not strictly necessary
with `brew shellenv`.
											
										 
											2023-05-04 10:28:11 -04:00
										 |  |  | #: | 
					
						
							|  |  |  | #:  The shell can be specified explicitly with a supported shell name parameter. Unknown shells will output POSIX exports. | 
					
						
							| 
									
										
										
										
											2018-09-13 09:27:43 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-04-28 20:47:39 +09:00
										 |  |  | # HOMEBREW_CELLAR and HOMEBREW_PREFIX are set by extend/ENV/super.rb | 
					
						
							|  |  |  | # HOMEBREW_REPOSITORY is set by bin/brew | 
					
						
							| 
									
										
										
										
											2022-09-15 21:51:27 +08:00
										 |  |  | # Trailing colon in MANPATH adds default man dirs to search path in Linux, does no harm in macOS. | 
					
						
							|  |  |  | # Please do not submit PRs to remove it! | 
					
						
							| 
									
										
										
										
											2021-04-28 20:47:39 +09:00
										 |  |  | # shellcheck disable=SC2154 | 
					
						
							| 
									
										
										
										
											2018-09-13 09:27:43 +01:00
										 |  |  | homebrew-shellenv() { | 
					
						
							| 
									
										
										
										
											2021-12-09 18:55:33 +08:00
										 |  |  |   if [[ "${HOMEBREW_PATH%%:"${HOMEBREW_PREFIX}"/sbin*}" == "${HOMEBREW_PREFIX}/bin" ]] | 
					
						
							| 
									
										
										
										
											2021-09-16 01:04:06 +08:00
										 |  |  |   then | 
					
						
							|  |  |  |     return | 
					
						
							|  |  |  |   fi | 
					
						
							| 
									
										
										
										
											2021-08-03 16:17:24 +08:00
										 |  |  | 
 | 
					
						
							| 
									
										
											  
											
												Allow brew shellenv to accept a shell name param
Resolves #15358
With this change, `brew shellenv` will accept a shell name parameter to
override its default output (based on `/bin/ps`) for advanced use cases
such as with dotfile templating and caching with
[twpayne/chezmoi](https://github.com/twpayne/chezmoi/discussions/2971).
When running under `fish`, this is the output:
```console
$ brew shellenv pwsh
[System.Environment]::SetEnvironmentVariable('HOMEBREW_PREFIX','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_CELLAR','/opt/homebrew/Cellar',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_REPOSITORY','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('PATH',$('/opt/homebrew/bin:/opt/homebrew/sbin:'+$ENV:PATH),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('MANPATH',$('/opt/homebrew/share/man'+$(if(${ENV:MANPATH}){':'+${ENV:MANPATH}})+':'),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('INFOPATH',$('/opt/homebrew/share/info'+$(if(${ENV:INFOPATH}){':'+${ENV:INFOPATH}})),[System.EnvironmentVariableTarget]::Process)
$ brew shellenv
set -gx HOMEBREW_PREFIX "/opt/homebrew";
set -gx HOMEBREW_CELLAR "/opt/homebrew/Cellar";
set -gx HOMEBREW_REPOSITORY "/opt/homebrew";
set -q PATH; or set PATH ''; set -gx PATH "/opt/homebrew/bin" "/opt/homebrew/sbin" $PATH;
set -q MANPATH; or set MANPATH ''; set -gx MANPATH "/opt/homebrew/share/man" $MANPATH;
set -q INFOPATH; or set INFOPATH ''; set -gx INFOPATH "/opt/homebrew/share/info" $INFOPATH;
```
The specific case presented in the mentioned discussion could be
mitigated by an additional level of indirection (`{{ output "fish" "-c"
"'brew shellenv'" | trim }}`), that requires that the running system
have the target shells installed, when they are not strictly necessary
with `brew shellenv`.
											
										 
											2023-05-04 10:28:11 -04:00
										 |  |  |   if [[ -n "$1" ]] | 
					
						
							|  |  |  |   then | 
					
						
							|  |  |  |     HOMEBREW_SHELL_NAME="$1" | 
					
						
							|  |  |  |   else | 
					
						
							| 
									
										
										
										
											2023-05-08 11:06:30 -04:00
										 |  |  |     HOMEBREW_SHELL_NAME="$(/bin/ps -p "${PPID}" -c -o comm=)" | 
					
						
							| 
									
										
											  
											
												Allow brew shellenv to accept a shell name param
Resolves #15358
With this change, `brew shellenv` will accept a shell name parameter to
override its default output (based on `/bin/ps`) for advanced use cases
such as with dotfile templating and caching with
[twpayne/chezmoi](https://github.com/twpayne/chezmoi/discussions/2971).
When running under `fish`, this is the output:
```console
$ brew shellenv pwsh
[System.Environment]::SetEnvironmentVariable('HOMEBREW_PREFIX','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_CELLAR','/opt/homebrew/Cellar',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('HOMEBREW_REPOSITORY','/opt/homebrew',[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('PATH',$('/opt/homebrew/bin:/opt/homebrew/sbin:'+$ENV:PATH),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('MANPATH',$('/opt/homebrew/share/man'+$(if(${ENV:MANPATH}){':'+${ENV:MANPATH}})+':'),[System.EnvironmentVariableTarget]::Process)
[System.Environment]::SetEnvironmentVariable('INFOPATH',$('/opt/homebrew/share/info'+$(if(${ENV:INFOPATH}){':'+${ENV:INFOPATH}})),[System.EnvironmentVariableTarget]::Process)
$ brew shellenv
set -gx HOMEBREW_PREFIX "/opt/homebrew";
set -gx HOMEBREW_CELLAR "/opt/homebrew/Cellar";
set -gx HOMEBREW_REPOSITORY "/opt/homebrew";
set -q PATH; or set PATH ''; set -gx PATH "/opt/homebrew/bin" "/opt/homebrew/sbin" $PATH;
set -q MANPATH; or set MANPATH ''; set -gx MANPATH "/opt/homebrew/share/man" $MANPATH;
set -q INFOPATH; or set INFOPATH ''; set -gx INFOPATH "/opt/homebrew/share/info" $INFOPATH;
```
The specific case presented in the mentioned discussion could be
mitigated by an additional level of indirection (`{{ output "fish" "-c"
"'brew shellenv'" | trim }}`), that requires that the running system
have the target shells installed, when they are not strictly necessary
with `brew shellenv`.
											
										 
											2023-05-04 10:28:11 -04:00
										 |  |  |   fi | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   case "${HOMEBREW_SHELL_NAME}" in | 
					
						
							| 
									
										
										
										
											2021-07-29 22:39:26 +08:00
										 |  |  |     fish | -fish) | 
					
						
							| 
									
										
										
										
											2021-04-28 20:47:39 +09:00
										 |  |  |       echo "set -gx HOMEBREW_PREFIX \"${HOMEBREW_PREFIX}\";" | 
					
						
							|  |  |  |       echo "set -gx HOMEBREW_CELLAR \"${HOMEBREW_CELLAR}\";" | 
					
						
							|  |  |  |       echo "set -gx HOMEBREW_REPOSITORY \"${HOMEBREW_REPOSITORY}\";" | 
					
						
							| 
									
										
										
										
											2024-02-04 14:23:36 +02:00
										 |  |  |       echo "fish_add_path -gP \"${HOMEBREW_PREFIX}/bin\" \"${HOMEBREW_PREFIX}/sbin\";" | 
					
						
							| 
									
										
										
										
											2023-09-30 17:39:39 -04:00
										 |  |  |       echo "! set -q MANPATH; and set MANPATH ''; set -gx MANPATH \"${HOMEBREW_PREFIX}/share/man\" \$MANPATH;" | 
					
						
							|  |  |  |       echo "! set -q INFOPATH; and set INFOPATH ''; set -gx INFOPATH \"${HOMEBREW_PREFIX}/share/info\" \$INFOPATH;" | 
					
						
							| 
									
										
										
										
											2019-02-20 10:10:31 +00:00
										 |  |  |       ;; | 
					
						
							| 
									
										
										
										
											2021-07-29 22:39:26 +08:00
										 |  |  |     csh | -csh | tcsh | -tcsh) | 
					
						
							| 
									
										
										
										
											2021-04-28 20:47:39 +09:00
										 |  |  |       echo "setenv HOMEBREW_PREFIX ${HOMEBREW_PREFIX};" | 
					
						
							|  |  |  |       echo "setenv HOMEBREW_CELLAR ${HOMEBREW_CELLAR};" | 
					
						
							|  |  |  |       echo "setenv HOMEBREW_REPOSITORY ${HOMEBREW_REPOSITORY};" | 
					
						
							|  |  |  |       echo "setenv PATH ${HOMEBREW_PREFIX}/bin:${HOMEBREW_PREFIX}/sbin:\$PATH;" | 
					
						
							|  |  |  |       echo "setenv MANPATH ${HOMEBREW_PREFIX}/share/man\`[ \${?MANPATH} == 1 ] && echo \":\${MANPATH}\"\`:;" | 
					
						
							|  |  |  |       echo "setenv INFOPATH ${HOMEBREW_PREFIX}/share/info\`[ \${?INFOPATH} == 1 ] && echo \":\${INFOPATH}\"\`;" | 
					
						
							| 
									
										
										
										
											2019-02-20 10:10:31 +00:00
										 |  |  |       ;; | 
					
						
							| 
									
										
										
										
											2021-12-01 09:55:33 +01:00
										 |  |  |     pwsh | -pwsh | pwsh-preview | -pwsh-preview) | 
					
						
							| 
									
										
										
										
											2021-11-30 10:47:56 +01:00
										 |  |  |       echo "[System.Environment]::SetEnvironmentVariable('HOMEBREW_PREFIX','${HOMEBREW_PREFIX}',[System.EnvironmentVariableTarget]::Process)" | 
					
						
							|  |  |  |       echo "[System.Environment]::SetEnvironmentVariable('HOMEBREW_CELLAR','${HOMEBREW_CELLAR}',[System.EnvironmentVariableTarget]::Process)" | 
					
						
							|  |  |  |       echo "[System.Environment]::SetEnvironmentVariable('HOMEBREW_REPOSITORY','${HOMEBREW_REPOSITORY}',[System.EnvironmentVariableTarget]::Process)" | 
					
						
							|  |  |  |       echo "[System.Environment]::SetEnvironmentVariable('PATH',\$('${HOMEBREW_PREFIX}/bin:${HOMEBREW_PREFIX}/sbin:'+\$ENV:PATH),[System.EnvironmentVariableTarget]::Process)" | 
					
						
							|  |  |  |       echo "[System.Environment]::SetEnvironmentVariable('MANPATH',\$('${HOMEBREW_PREFIX}/share/man'+\$(if(\${ENV:MANPATH}){':'+\${ENV:MANPATH}})+':'),[System.EnvironmentVariableTarget]::Process)" | 
					
						
							|  |  |  |       echo "[System.Environment]::SetEnvironmentVariable('INFOPATH',\$('${HOMEBREW_PREFIX}/share/info'+\$(if(\${ENV:INFOPATH}){':'+\${ENV:INFOPATH}})),[System.EnvironmentVariableTarget]::Process)" | 
					
						
							|  |  |  |       ;; | 
					
						
							| 
									
										
										
										
											2019-02-20 10:10:31 +00:00
										 |  |  |     *) | 
					
						
							| 
									
										
										
										
											2021-04-28 20:47:39 +09:00
										 |  |  |       echo "export HOMEBREW_PREFIX=\"${HOMEBREW_PREFIX}\";" | 
					
						
							|  |  |  |       echo "export HOMEBREW_CELLAR=\"${HOMEBREW_CELLAR}\";" | 
					
						
							|  |  |  |       echo "export HOMEBREW_REPOSITORY=\"${HOMEBREW_REPOSITORY}\";" | 
					
						
							|  |  |  |       echo "export PATH=\"${HOMEBREW_PREFIX}/bin:${HOMEBREW_PREFIX}/sbin\${PATH+:\$PATH}\";" | 
					
						
							|  |  |  |       echo "export MANPATH=\"${HOMEBREW_PREFIX}/share/man\${MANPATH+:\$MANPATH}:\";" | 
					
						
							|  |  |  |       echo "export INFOPATH=\"${HOMEBREW_PREFIX}/share/info:\${INFOPATH:-}\";" | 
					
						
							| 
									
										
										
										
											2019-02-20 10:10:31 +00:00
										 |  |  |       ;; | 
					
						
							|  |  |  |   esac | 
					
						
							| 
									
										
										
										
											2018-09-13 09:27:43 +01:00
										 |  |  | } |