Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Unclutter your .profile
Go Shell HTML Makefile

Merge pull request #163 from p0deje/fix-vim-unlet

Empty variable as unloading in Vim
latest commit d2efb29692
@zimbatm authored
Failed to load latest commit information.
docs Preliminary support for vim
man Merge pull request #146 from bbense/tcsh-support
script Use Travis to push release builds to github
test shell_fish: use single quotes to simplify escaping logic
.gitignore Use Travis to push release builds to github
.nojekyll New site: put the doc inside the project so it stays in sync
.travis.yml Use Travis to push release builds to github
CHANGELOG.md Release v2.6.0
CNAME New site: put the doc inside the project so it stays in sync
LICENSE.md LICENSE update
Makefile Use Travis to push release builds to github
README.md README tweaks
cmd_allow.go Display command arguments in the help
cmd_apply_dump.go Only backup the diff of environments. Fixes #82
cmd_deny.go Corrected spelling mistake in deny command
cmd_dotenv.go Fix dotenv with explicit .env
cmd_dotenv_test.go Support more of the dotenv syntax format
cmd_dump.go Refactored the whole export and diff mechanism. Fixes #92 regression.
cmd_edit.go Try to detect an editor in the PATH if EDITOR is not set.
cmd_exec.go Adapt `direnv exec` to also work on non-env folders.
cmd_expand_path.go Display command arguments in the help
cmd_export.go Allow to disable logging by setting an empty DIRENV_LOG_FORMAT
cmd_help.go Add command aliases. `direnv --help` is an alias to `direnv help`
cmd_hook.go Display command arguments in the help
cmd_reload.go Adds a new `direnv reload` command for convenience
cmd_status.go Adds selected bash executable in `direnv status`
cmd_stdlib.go Move the stdlib into a .sh file to benefit from syntax coloring
cmd_version.go Move the version information into the direnv executable.
commands.go Allow to disable logging by setting an empty DIRENV_LOG_FORMAT
config.go Support for Cygwin
const.go Refactored the whole export and diff mechanism. Fixes #92 regression.
env.go Refactored the whole export and diff mechanism. Fixes #92 regression.
env_diff.go ignore BASH_FUNC_* variables
env_diff_test.go Add TestEnvDiffEmptyValue
env_test.go Refactored the whole export and diff mechanism. Fixes #92 regression.
index.html New site: put the doc inside the project so it stays in sync
log.go Allow to disable logging by setting an empty DIRENV_LOG_FORMAT
look_path.go Try to detect an editor in the PATH if EDITOR is not set.
main.go Use terminal colours for direnv output
marshal.go Only backup the diff of environments. Fixes #82
rc.go Forward Stdin to allow user input
rc_test.go If two paths don't have a common ancestors, don't make them relative.
shell.go Having test script mostly working stuck on special vars
shell_bash.go Fixes parse error on the bash hook when evaluated on a single line.
shell_fish.go shell_fish: use single quotes to simplify escaping logic
shell_tcsh.go Having test script mostly working stuck on special vars
shell_test.go Fixes shell detection in case $0 doesn't contain a path
shell_vim.go Empty variable as unloading in Vim
shell_zsh.go Add -g option.
stdlib.go Unset PYTHONHOME as part of the python layout
stdlib.sh Unset PYTHONHOME as part of the python layout
version.go Release v2.6.0
xdg.go Still WIP but approaching a workable state

README.md

direnv -- Unclutter your .profile

direnv is an environment switcher for the shell. It knows how to hook into bash, zsh, tcsh and fish shell to load or unload environment variables depending on the current directory. This allows to have project-specific environment variables and not clutter the "~/.profile" file.

Before each prompt it checks for the existence of an ".envrc" file in the current and parent directories. If the file exists (and authorized), it is loaded into a bash sub-shell and all exported variables are then captured by direnv and then made available the current shell.

Because direnv is compiled into a single static executable it is fast enough to be unnoticeable on each prompt. It is also language agnostic and can be used to build solutions similar to rbenv, pyenv, phpenv, ...

Example

$ cd ~/my_project
$ echo ${FOO-nope}
nope
$ echo export FOO=foo > .envrc
.envrc is not allowed
$ direnv allow .
direnv: reloading
direnv: loading .envrc
direnv export: +FOO
$ echo ${FOO-nope}
foo
$ cd ..
direnv: unloading
direnv export: ~PATH
$ echo ${FOO-nope}
nope

Install

From source

Dependencies: make, golang

git clone https://github.com/zimbatm/direnv
cd direnv
make install
# or symlink ./direnv into the $PATH

Packaged

There's package definitions on Homebrew, Arch's AUR and NixOS's nixpkgs.

Links to binary builds are also available on each release.

Setup

For direnv to work properly it needs to be hooked into the shell. Each shell has it's own extension mechanism:

BASH

Add the following line at the end of the "~/.bashrc" file:

eval "$(direnv hook bash)"

Make sure it appears even after rvm, git-prompt and other shell extensions that manipulate the prompt.

ZSH

Add the following line at the end of the "~/.zshrc" file:

eval "$(direnv hook zsh)"

FISH

Add the following line at the end of the "~/.config/fish/config.fish" file:

eval (direnv hook fish)

TCSH

Add the following line at the end of the "~/.cshrc" file:

eval `direnv hook tcsh`

Usage

In some target folder, create an ".envrc" file and add some export(1) directives in it.

On the next prompt you will notice that direnv complains about the ".envrc" being blocked. This is the security mechanism to avoid loading new files automatically. Otherwise any git repo that you pull, or tar archive that you unpack, would be able to wipe your hard drive once you cd into it.

So here we are pretty sure that it won't do anything bad. Type direnv allow . and watch direnv loading your new environment. Note that direnv edit . is a handy shortcut that opens the file in your $EDITOR and automatically allows it if the file's modification time has changed.

Now that the environment is loaded you can notice that once you cd out of the directory it automatically gets unloaded. If you cd back into it it's loaded again. That's the base of the mechanism that allows you to build cool things.

The stdlib

Exporting variables by hand is a bit repetitive so direnv provides a set of utility functions that are made available in the context of the ".envrc" file.

As an example, the PATH_add function is used to expand and prepend a path to the $PATH environment variable. Instead of export $PATH=$PWD/bin:$PATH you can write PATH_add bin. It's shorter and avoid a common mistake where $PATH=bin.

To find the documentation for all available functions check the direnv-stdlib(1) man page.

It's also possible to create your own extensions by creating a bash file at "~/.config/direnv/direnvrc" or "~/.direnvrc". This file is loaded before your ".envrc" and thus allows you to make your own extensions to direnv.

Loading layered .envrc

Lets say you have the following structure:

  • "/a/.envrc"
  • "/a/b/.envrc"

If you add the following line in "/a/b/.envrc", you can load both of the ".envrc" when you are in /a/b:

source_env ..

Similar projects

  • autoenv - lightweight, doesn't support unloads

Contribute

Bug reports, contributions and forks are welcome.

All bugs or other forms of discussion happen on http://github.com/zimbatm/direnv/issues

There is also a wiki available where you can share your usage patterns or other tips and tricks https://github.com/zimbatm/direnv/wiki

Or drop by on the #direnv channel on FreeNode to have a chat.

Build Status

COPYRIGHT

Copyright (C) 2014 shared by all contributors under the MIT licence.

Something went wrong with that request. Please try again.