EnglishFrenchSpanish

OnWorks favicon

direnv - Online in the Cloud

Run direnv in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command direnv that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

NAME


direnv - unclutter your .profile

SYNOPSIS


direnv command ...

DESCRIPTION


direnv is an environment variable manager for your shell. It knows how to hook into bash,
zsh and fish shell to load or unload environment variables depending on your current
directory. This allows you 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, it is loaded into a bash sub-shell and all
exported variables are then captured by direnv and then made available to your 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

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 your "~/.bashrc" file:

eval "$(direnv hook bash)"

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

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

eval "$(direnv hook zsh)"

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

eval (direnv hook fish)

TCSH
Add the following line at the end of your "~/.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 open
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.

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. Check the direnv-
stdlib(1) man page for more details. You can also define your own extensions inside a
"~/.direnvrc" file.

Hopefully this is enough to get you started.

CONTRIBUTE


Bug reports, contributions and forks are welcome.

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

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

Or drop by on the #direnv channel on FreeNode ⟨irc://#direnv@FreeNode⟩ to have a chat.

COPYRIGHT


Copyright (C) 2014 zimbatm and contributors under the MIT licence.

Use direnv online using onworks.net services


Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Boost C++ Libraries
    Boost C++ Libraries
    Boost provides free portable
    peer-reviewed C++ libraries. The
    emphasis is on portable libraries which
    work well with the C++ Standard Library.
    See http://www.bo...
    Download Boost C++ Libraries
  • 2
    VirtualGL
    VirtualGL
    VirtualGL redirects 3D commands from a
    Unix/Linux OpenGL application onto a
    server-side GPU and converts the
    rendered 3D images into a video stream
    with which ...
    Download VirtualGL
  • 3
    libusb
    libusb
    Library to enable user space
    application programs to communicate with
    USB devices. Audience: Developers, End
    Users/Desktop. Programming Language: C.
    Categories...
    Download libusb
  • 4
    SWIG
    SWIG
    SWIG is a software development tool
    that connects programs written in C and
    C++ with a variety of high-level
    programming languages. SWIG is used with
    different...
    Download SWIG
  • 5
    WooCommerce Nextjs React Theme
    WooCommerce Nextjs React Theme
    React WooCommerce theme, built with
    Next JS, Webpack, Babel, Node, and
    Express, using GraphQL and Apollo
    Client. WooCommerce Store in React(
    contains: Products...
    Download WooCommerce Nextjs React Theme
  • 6
    archlabs_repo
    archlabs_repo
    Package repo for ArchLabs This is an
    application that can also be fetched
    from
    https://sourceforge.net/projects/archlabs-repo/.
    It has been hosted in OnWorks in...
    Download archlabs_repo
  • More »

Linux commands

Ad