|
;;; .dir-locals.el
|
|
;;
|
|
;; Per-Directory Local Variables:
|
|
;; https://www.gnu.org/software/emacs/manual/html_node/emacs/Directory-Variables.html
|
|
;;
|
|
;; For full fledge developer tools install emacs packages:
|
|
;;
|
|
;; M-x package-install ...
|
|
;;
|
|
;; magit gitconfig
|
|
;; nvm lsp-mode lsp-pyright lsp-eslint
|
|
;; pyvenv pylint pip-requirements
|
|
;; jinja2-mode
|
|
;; json-mode
|
|
;; company company-jedi company-quickhelp company-shell
|
|
;; realgud
|
|
;; sphinx-doc markdown-mode graphviz-dot-mode
|
|
;; apache-mode nginx-mode
|
|
;;
|
|
;; To setup a developer environment, build target::
|
|
;;
|
|
;; $ make node.env.dev pyenv.install
|
|
;;
|
|
;; Some buffer locals are referencing the project environment:
|
|
;;
|
|
;; - prj-root --> <repo>/
|
|
;; - nvm-dir --> <repo>/.nvm
|
|
;; - python-environment-directory --> <repo>/local
|
|
;; - python-environment-default-root-name --> py3
|
|
;; - python-shell-virtualenv-root --> <repo>/local/py3
|
|
;; When this variable is set with the path of the virtualenv to use,
|
|
;; `process-environment' and `exec-path' get proper values in order to run
|
|
;; shells inside the specified virtualenv, example::
|
|
;; (setq python-shell-virtualenv-root "/path/to/env/")
|
|
;; - python-shell-interpreter --> <repo>/local/py3/bin/python
|
|
;;
|
|
;; Python development:
|
|
;;
|
|
;; Jedi, flycheck & other python stuff should use the 'python-shell-interpreter'
|
|
;; from the local py3 environment.
|
|
;;
|
|
|
|
((nil
|
|
. ((fill-column . 80)
|
|
(indent-tabs-mode . nil)
|
|
(eval . (progn
|
|
|
|
(add-to-list 'auto-mode-alist '("\\.html\\'" . jinja2-mode))
|
|
|
|
;; project root folder is where the `.dir-locals.el' is located
|
|
(setq-local prj-root
|
|
(locate-dominating-file default-directory ".dir-locals.el"))
|
|
|
|
(setq-local python-environment-directory
|
|
(expand-file-name "./local" prj-root))
|
|
|
|
;; to get in use of NVM environment, install https://github.com/rejeep/nvm.el
|
|
(setq-local nvm-dir (expand-file-name "./.nvm" prj-root))
|
|
|
|
;; use nodejs from the (local) NVM environment (see nvm-dir)
|
|
(nvm-use-for-buffer)
|
|
(ignore-errors (require 'lsp))
|
|
(setq-local lsp-server-install-dir (car (cdr nvm-current-version)))
|
|
(setq-local lsp-enable-file-watchers nil)
|
|
|
|
;; use 'py3' environment as default
|
|
(setq-local python-environment-default-root-name
|
|
"py3")
|
|
|
|
(setq-local python-shell-virtualenv-root
|
|
(expand-file-name
|
|
python-environment-default-root-name python-environment-directory))
|
|
|
|
(setq-local python-shell-interpreter
|
|
(expand-file-name
|
|
"bin/python" python-shell-virtualenv-root))))))
|
|
(makefile-gmake-mode
|
|
. ((indent-tabs-mode . t)))
|
|
|
|
(yaml-mode
|
|
. ((eval . (progn
|
|
|
|
;; flycheck should use the local py3 environment
|
|
(setq-local flycheck-yaml-yamllint-executable
|
|
(expand-file-name "bin/yamllint" python-shell-virtualenv-root))
|
|
|
|
(setq-local flycheck-yamllintrc
|
|
(expand-file-name ".yamllint.yml" prj-root))
|
|
|
|
(flycheck-checker . yaml-yamllint)))))
|
|
|
|
(json-mode
|
|
. ((eval . (progn
|
|
(setq-local js-indent-level 4)
|
|
(flycheck-checker . json-python-json)))))
|
|
|
|
(js-mode
|
|
. ((eval . (progn
|
|
(ignore-errors (require 'lsp-eslint))
|
|
(setq-local js-indent-level 2)
|
|
;; flycheck should use the eslint checker from developer tools
|
|
(setq-local flycheck-javascript-eslint-executable
|
|
(expand-file-name "node_modules/.bin/eslint" prj-root))
|
|
;; (flycheck-mode)
|
|
|
|
(if (featurep 'lsp-eslint)
|
|
(lsp))
|
|
))))
|
|
|
|
(python-mode
|
|
. ((eval . (progn
|
|
(ignore-errors (require 'jedi-core))
|
|
(ignore-errors (require 'lsp-pyright))
|
|
(ignore-errors (sphinx-doc-mode))
|
|
(setq-local python-environment-virtualenv
|
|
(list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
|
|
;;"--system-site-packages"
|
|
"--quiet"))
|
|
|
|
(setq-local pylint-command
|
|
(expand-file-name "bin/pylint" python-shell-virtualenv-root))
|
|
|
|
(if (featurep 'lsp-pyright)
|
|
(lsp))
|
|
|
|
;; pylint will find the '.pylintrc' file next to the CWD
|
|
;; https://pylint.readthedocs.io/en/latest/user_guide/run.html#command-line-options
|
|
(setq-local flycheck-pylintrc
|
|
".pylintrc")
|
|
|
|
;; flycheck & other python stuff should use the local py3 environment
|
|
(setq-local flycheck-python-pylint-executable
|
|
python-shell-interpreter)
|
|
|
|
;; use 'M-x jedi:show-setup-info' and 'M-x epc:controller' to inspect jedi server
|
|
;; https://tkf.github.io/emacs-jedi/latest/#jedi:environment-root -- You
|
|
;; can specify a full path instead of a name (relative path). In that case,
|
|
;; python-environment-directory is ignored and Python virtual environment
|
|
;; is created at the specified path.
|
|
(setq-local jedi:environment-root
|
|
python-shell-virtualenv-root)
|
|
|
|
;; https://tkf.github.io/emacs-jedi/latest/#jedi:server-command
|
|
(setq-local jedi:server-command
|
|
(list python-shell-interpreter
|
|
jedi:server-script))
|
|
|
|
;; jedi:environment-virtualenv --> see above 'python-environment-virtualenv'
|
|
;; is set buffer local! No need to setup jedi:environment-virtualenv:
|
|
;;
|
|
;; Virtualenv command to use. A list of string. If it is nil,
|
|
;; python-environment-virtualenv is used instead. You must set non-nil
|
|
;; value to jedi:environment-root in order to make this setting work.
|
|
;;
|
|
;; https://tkf.github.io/emacs-jedi/latest/#jedi:environment-virtualenv
|
|
;;
|
|
;; (setq-local jedi:environment-virtualenv
|
|
;; (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
|
|
;; "--python"
|
|
;; "/usr/bin/python3.4"
|
|
;; ))
|
|
))))
|
|
)
|