mirror of
https://github.com/Tarrasch/zsh-autoenv.git
synced 2024-11-04 17:01:00 +02:00
147 lines
4.2 KiB
Markdown
147 lines
4.2 KiB
Markdown
[](https://bitdeli.com/free "Bitdeli Badge")
|
|
|
|
[](https://travis-ci.org/Tarrasch/zsh-autoenv)
|
|
|
|
# Autoenv for Zsh
|
|
|
|
zsh-autoenv automatically sources (known/whitelisted) `.autoenv.zsh` files,
|
|
typically used in project root directories.
|
|
|
|
It handles "enter" and leave" events, nesting, and stashing of
|
|
variables (overwriting and restoring).
|
|
|
|
## Features
|
|
|
|
- Support for enter and leave events, which can use the same file.
|
|
By default `.autoenv.zsh` is used for entering, and `.autoenv_leave.zsh`
|
|
for leaving.
|
|
- Interactively asks for confirmation / authentication before sourcing an
|
|
unknown `.autoenv.zsh` file, and remembers whitelisted files by their
|
|
hashed content.
|
|
- Test suite.
|
|
- Written in Zsh.
|
|
|
|
### Variable stashing
|
|
|
|
You can use `autostash` in your `.autoenv.zsh` files to overwrite some
|
|
variable, e.g. `$PATH`. When leaving the directory, it will be automatically
|
|
restored.
|
|
|
|
% echo 'echo ENTERED; autostash FOO=changed' > project/.autoenv.zsh
|
|
% FOO=orig
|
|
% cd project
|
|
Attempting to load unauthorized env file!
|
|
-rw-rw-r-- 1 user user 36 Mai 6 20:38 /tmp/project/.autoenv.zsh
|
|
|
|
**********************************************
|
|
|
|
echo ENTERED; autostash FOO=changed
|
|
|
|
**********************************************
|
|
|
|
Would you like to authorize it? (type 'yes') yes
|
|
ENTERED
|
|
project % echo $FOO
|
|
changed
|
|
% cd ..
|
|
% echo $FOO
|
|
orig
|
|
|
|
There is also `stash`, `unstash` and `autounstash`, in case you want to
|
|
have more control.
|
|
|
|
The varstash library has been taken from smartcd, and was optimized for Zsh.
|
|
|
|
|
|
## Writing your .autoenv.zsh file
|
|
|
|
### `autoenv_source_parent()`
|
|
|
|
zsh-autoenv will stop looking for `.autoenv.zsh` files upwards after the first
|
|
one has been found, but you can use the function `autoenv_source_parent` to
|
|
source the next `.autoenv.zsh` file upwards the directory tree from there.
|
|
|
|
The function accepts an optional argument, which allows to stop looking before
|
|
the file system root is reached:
|
|
|
|
```zsh
|
|
autoenv_source_parent ../..
|
|
```
|
|
|
|
## Installation
|
|
|
|
Clone the repository and source it from your `~/.zshrc` file:
|
|
|
|
% git clone https://github.com/Tarrasch/zsh-autoenv ~/.dotfiles/lib/zsh-autoenv
|
|
% echo 'source ~/.dotfiles/lib/zsh-autoenv/autoenv.zsh' >> ~/.zshrc
|
|
|
|
### Using [antigen](https://github.com/zsh-users/antigen)
|
|
|
|
antigen-bundle Tarrasch/zsh-autoenv
|
|
|
|
### Using [zgen](https://github.com/tarjoilija/zgen)
|
|
|
|
Add the following to your `.zshrc` where you are loading your plugins:
|
|
|
|
zgen load Tarrasch/zsh-autoenv
|
|
|
|
|
|
## Configuration
|
|
|
|
You can use the following variables to control zsh-autoenv's behavior.
|
|
Add them to your `~/.zshrc` file, before sourcing/loading zsh-autoenv.
|
|
|
|
### AUTOENV\_FILE\_ENTER
|
|
Name of the file to look for when entering directories.
|
|
|
|
Default: `.autoenv.zsh`
|
|
|
|
### AUTOENV\_FILE\_LEAVE
|
|
Name of the file to look for when leaving directories.
|
|
Requires `AUTOENV_HANDLE_LEAVE=1`.
|
|
|
|
Default: `.autoenv_leave.zsh`
|
|
|
|
### AUTOENV\_LOOK\_UPWARDS
|
|
Look for zsh-autoenv "enter" files in parent dirs?
|
|
|
|
Default: `1`
|
|
|
|
### AUTOENV\_HANDLE\_LEAVE
|
|
Handle leave events when changing away from a subtree, where an "enter"
|
|
event was handled?
|
|
|
|
Default: `1`
|
|
|
|
### AUTOENV\_DISABLED
|
|
(Temporarily) disable zsh-autoenv. This gets looked at in the chpwd handler.
|
|
|
|
Default: 0
|
|
|
|
### AUTOENV\_DEBUG
|
|
Enable debugging. Multiple levels are supported (max 2).
|
|
|
|
Default: `0`
|
|
|
|
|
|
## Related projects
|
|
- https://github.com/cxreg/smartcd
|
|
- https://github.com/kennethreitz/autoenv
|
|
|
|
|
|
## History
|
|
|
|
This started as an optimized version of the bash plugin
|
|
[autoenv](https://github.com/kennethreitz/autoenv) but for Zsh, and grew a lot
|
|
of functionality on top of it (inspired by [smartcd]).
|
|
|
|
The code was initially based on
|
|
[@joshuaclayton](https://github.com/joshuaclayton)'s dotfiles.
|
|
In September 2013 [@Tarrasch](https://github.com/Tarrasch) packaged it into a
|
|
nice [antigen]-compatible unit with integration tests. Since November 2014,
|
|
[@blueyed](https://github.com/blueyed) took over and added many many nice
|
|
features, mainly inspired by [smartcd].
|
|
|
|
[antigen]: https://github.com/Tarrasch/antigen-hs
|
|
[smartcd]: https://github.com/cxreg/smartcd
|