Development

Support for individual programming languages, has a hard dependency on the Projects module for integration with LSP¹ / DAP²

Go

First class language support for Golang³.

Full support of LSP¹
Full support of DAP¹

Installing requirements

Get started by installing the gopls⁴ language server.

GO111MODULE=on go get golang.org/x/tools/gopls@latest

Setup the environment

Make some modifications to the environment.

Overriding the $GOPATH

Set the $GOPATH environment variable prior to loading the module, allowing modification of the default value.

(setenv "GOPATH" (concat (getenv "HOME") "/.go/"))

Adding $GOBIN to the $PATH

Include the bin subdirectory of the $GOPATH in the $PATH variable, adding compiled Golang applications to the system path.

(setenv "PATH" (concat (getenv "GOPATH") "bin:" (getenv "PATH")))

Configuration

Include the go-mode⁵ package for integration with lsp-mode from the Projects module.

Manually set the gopls application path

(use-package go-mode
  :hook (go-mode . lsp)
  :custom (lsp-go-gopls-server-path "~/.go/bin/gopls"))

Before save hooks

Apply some custom behaviour prior to saving buffers.

Format buffers
Organize imports

(defun dotfiles/go-hook ()
  (add-hook 'before-save-hook #'lsp-format-buffer t t)
  (add-hook 'before-save-hook #'lsp-organize-imports t t))

(add-hook 'go-mode-hook #'dotfiles/go-hook)

Babel structure templates

Add a structure template for Golang³ source blocks.

(add-to-list 'org-structure-template-alist '("go" . "src go"))

HTTP

Interactive with HTTP endpoints using the ob-http⁶ package. You can see how it works in my post Kanye as a Service. Essentialy it adds interactive HTTP blocks that can output their results in place.

(use-package ob-http
  :after org
  :config (org-babel-do-load-languages
            'org-babel-load-languages '((http . t))))

YAML

Support for YAML files.

(use-package yaml-mode)

C/C++

Add support for the C/C++ family of languages via the CCLS⁷ language server.

Install requirements
Integrate with LSP²
Integrate with DAP¹
Load babel language modules
Create new structure templates
- <cc for C
- <cpp for C++

(use-package ccls
  :init (dotfiles/install "ccls")
  :hook ((c-mode c++-mode objc-mode cuda-mode) .
         (lambda ()
           (require 'ccls)
           (lsp-deferred)))
  :config (add-to-list 'org-structure-template-alist '("cc" . "src C"))
          (add-to-list 'org-structure-template-alist '("cpp" . "src C++"))
          (org-babel-do-load-languages 'org-babel-load-languages '((C . t))))

Python

Adds support for Python and Python 3⁸ with DAP¹ and LSP² integration. The built in Emacs mode python-mode⁹ implements the behaviour.

Load the babel language modules for Python
Add a structure template with <py

(use-package python-mode
  :hook (python-mode . lsp-deferred)
  :config (require 'dap-python)
          (add-to-list 'org-src-lang-modes '("python" . python))
          (add-to-list 'org-structure-template-alist '("py" . "src python"))
          (org-babel-do-load-languages 'org-babel-load-languages '((python . t)))
  :custom (python-shell-interpreter "python3") ;; Required if "python" is not python 3.
          (dap-python-executable "python3")    ;; Same as above.
          (dap-python-debugger 'debugpy))

Installing the language server

Install the pyls¹⁰ language server.

pip3 install --user "python-language-server[all]"

PlantUML

Download and install PlantUML¹¹, a text-based markup language for creating UML diagrams. You can read my notes about the tool PlantUML here. Support added through the plantuml-mode¹² package.

Install requirements
Load the babel module for PlantUML¹¹
Create a structure template with <pl
Toggle inline imagines with SPC t i

(use-package plantuml-mode
  :after org
  :init (dotfiles/install "default-jre")
  :custom (plantuml-default-exec-mode 'jar)
          (plantuml-jar-path "~/.local/bin/plantuml.jar")
          (org-plantuml-jar-path (expand-file-name "~/.local/bin/plantuml.jar"))
          (org-startup-with-inline-images t)
  :config (add-to-list 'org-src-lang-modes '("plantuml" . plantuml))
          (add-to-list 'org-structure-template-alist '("pl" . "src plantuml"))
          (org-babel-do-load-languages 'org-babel-load-languages '((plantuml . t)))
          (dotfiles/leader "ti" '(org-toggle-inline-images :which-key "Images")))