awesome-emacs/doomemacs
1
0
Fork 0
mirror of https://github.com/doomemacs/doomemacs synced 2025-08-05 12:37:33 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
f18603e66a1160927044d13a46f15bbddfd72d39
doomemacs/modules/tools/direnv
History
Henrik Lissner 747a57fe54 bump: :tools 
andras-simonyi/citeproc-el@c61c98b9d2 -> andras-simonyi/citeproc-el@44f90cb296
editorconfig/editorconfig-emacs@c3666c093f -> editorconfig/editorconfig-emacs@d73b6392de
emacs-citar/citar-org-roam@7d67dccf80 -> emacs-citar/citar-org-roam@82d47b5df1
emacs-tree-sitter/tree-sitter-langs@c56cb51104 -> emacs-tree-sitter/tree-sitter-langs@b7895ca759
emacsorphanage/quickrun@248149b026 -> emacsorphanage/quickrun@373634cf51
hcl-emacs/terraform-mode@e8b57df8c2 -> hcl-emacs/terraform-mode@a645c32a8f
k1LoW/emacs-ansible@d89ac0ee57 -> k1LoW/emacs-ansible@1d7de8d3dd
krzysztof-magosa/company-ansible@79dd421b16 -> krzysztof-magosa/company-ansible@338922601c
nicolaisingh/saveplace-pdf-view@abfb5e1f46 -> nicolaisingh/saveplace-pdf-view@ee95460cd9
purcell/envrc@1385e72a73 -> purcell/envrc@8eb7401700
spotify/dockerfile-mode@52c6c00da1 -> spotify/dockerfile-mode@39a012a27f
tmalsburg/helm-bibtex@bf184cc311 -> tmalsburg/helm-bibtex@8b71b4f5ce
vedang/pdf-tools@c69e7656a4 -> vedang/pdf-tools@93e7492451
xuchunyang/osx-dictionary.el@1f5a74f3e5 -> xuchunyang/osx-dictionary.el@6abfd6908b
yoshiki/yaml-mode@5b58248ab2 -> yoshiki/yaml-mode@7b5ce294fb
2024-04-03 17:24:17 -04:00
..
config.el
fix(direnv): envrc triggering in its own internal buffers
2023-03-11 19:50:28 -05:00
doctor.el
Add tools/direnv module
2019-04-05 03:16:37 -04:00
packages.el
bump: :tools
2024-04-03 17:24:17 -04:00
README.org
docs(*): replace all-the-icons with nerd-icons
2023-09-16 20:19:11 +02:00

README.org

:tools direnv

Description   unfold

This module integrates direnv into Emacs.

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

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

Maintainers

Become a maintainer?

Module flags

This module has no flags.

Packages

Hacks

  • envrc-mode has been modified to fail gracefully if direnv isn't available.
  • envrc-global-mode has been modified to activate envrc-mode sooner in the major mode activation process, so that any env state performed in mode hooks aren't overwritten by direnv.
  • Added direnv support for Org src blocks.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module requires direnv.

MacOS 

brew install direnv

Arch Linux

direnv is available on the AUR:

yay -S direnv

NixOS 

environment.systemPackages = [ pkgs.direnv ];

Or $ nix-env -i direnv

TODO Usage

󱌣 This module's usage documentation is incomplete. Complete it?

To make use of direnv you need a .envrc file in a directory. Any time you open a file or buffer in said directory, the doom-package:envrc Emacs package will kick in, activate the local env, and inject it into Emacs for the current buffer.

TODO Configuration

󱌣 This module has no configuration documentation yet. Write some?

Troubleshooting

Report an issue?

direnv + nix is slow

Consider augmenting direnv with lorri, which will cache nix builds and speed up direnv tremendously:

services.lorri.enable = true;

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

󱌣 This module has no appendix yet. Write one?