5 changed files with 151 additions and 119 deletions
-
2elisp/options.el
-
110modules/development.org
-
16modules/fonts.org
-
75modules/go.org
-
67modules/python.org
@ -0,0 +1,75 @@ |
|||
#+TITLE: Go |
|||
#+AUTHOR: Christopher James Hayward |
|||
#+EMAIL: chris@chrishayward.xyz |
|||
|
|||
#+PROPERTY: header-args:emacs-lisp :tangle go.el :comments org |
|||
#+PROPERTY: header-args:shell :tangle no |
|||
#+PROPERTY: header-args :results silent :eval no-export :comments org |
|||
|
|||
#+OPTIONS: num:nil toc:nil todo:nil tasks:nil tags:nil |
|||
#+OPTIONS: skip:nil author:nil email:nil creator:nil timestamp:nil |
|||
|
|||
Go is an open source programming language that makes it easy to build simple, reliable, and efficient software[fn:1] |
|||
|
|||
* Setup |
|||
|
|||
Install ~golang~[fn:1] on your system, and configure your environment prior to loading this module. |
|||
|
|||
#+begin_src shell |
|||
RUN apt install -y golang |
|||
#+end_src |
|||
|
|||
** Language server |
|||
|
|||
Get started by installing the ~gopls~[fn:2] language server. |
|||
|
|||
#+begin_src shell |
|||
GO111MODULE=on go get golang.org/x/tools/gopls@latest |
|||
#+end_src |
|||
|
|||
** Setup the environment |
|||
|
|||
Make some modifications to the environment. Set the =$GOPATH= variable prior to loading, allowing modification of the default value. Include the =bin= subdirectory of the =$GOPATH= in the =$PATH= variable, adding compiled golang applications to the system path. |
|||
|
|||
#+begin_src emacs-lisp |
|||
(setenv "GOPATH" (concat (getenv "HOME") "/.go/")) |
|||
(setenv "PATH" (concat (getenv "GOPATH") "bin:" (getenv "PATH"))) |
|||
#+end_src |
|||
|
|||
* Config |
|||
|
|||
Use the ~go-mode~[fn:3] package for integration with ~lsp-mode~, manually setting the path to ~gopls~[fn:2] before loading. |
|||
|
|||
#+begin_src emacs-lisp |
|||
(use-package go-mode |
|||
:hook (go-mode . lsp) |
|||
:custom (lsp-go-gopls-server-path "~/.go/bin/gopls")) |
|||
#+end_src |
|||
|
|||
** Before save hooks |
|||
|
|||
Apply some custom behaviour when saving ~golang~[fn:1] buffers. Format and organize the imports before saving. |
|||
|
|||
#+begin_src emacs-lisp |
|||
(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) |
|||
#+end_src |
|||
|
|||
** Babel structure templates |
|||
|
|||
Configure the ~babel~ engine to support ~golang~[fn:1] source blocks. |
|||
|
|||
#+begin_src emacs-lisp |
|||
(add-to-list 'org-structure-template-alist '("go" . "src go")) |
|||
#+end_src |
|||
|
|||
* Footnotes |
|||
|
|||
[fn:1] https://golang.org |
|||
|
|||
[fn:2] https://pkg.go.dev/golang.org/x/tools/gopls |
|||
|
|||
[fn:3] https://emacswiki.org/emacs/GoMode |
|||
@ -0,0 +1,67 @@ |
|||
#+TITLE: Python |
|||
#+AUTHOR: Christopher James Hayward |
|||
#+EMAIL: chris@chrishayward.xyz |
|||
|
|||
#+PROPERTY: header-args:emacs-lisp :tangle python.el :comments org |
|||
#+PROPERTY: header-args:shell :tangle no |
|||
#+PROPERTY: header-args :results silent :eval no-export :comments org |
|||
|
|||
#+OPTIONS: num:nil toc:nil todo:nil tasks:nil tags:nil |
|||
#+OPTIONS: skip:nil author:nil email:nil creator:nil timestamp:nil |
|||
|
|||
Python is an interpreted high-level general-purpose programming language[fn:1]. |
|||
|
|||
* Setup |
|||
|
|||
Ensure ~python3~[fn:1] is installed on the system, and the ~lsp~ and ~dap~ modules have been loaded before loading this module. |
|||
|
|||
#+begin_src shell |
|||
RUN apt install -y python3 python3-pip |
|||
#+end_src |
|||
|
|||
** Install the language server |
|||
|
|||
Install the ~pyls~[fn:2] language server. |
|||
|
|||
#+begin_src shell |
|||
RUN pip3 install --user "python-lsp-server[all]" |
|||
#+end_src |
|||
|
|||
* Config |
|||
|
|||
Add support for ~python3~[fn:1], including ~dap~ and ~lsp~ integration. The built-in Emacs mode ~python-mode~[fn:3] handles the rest of the integration. |
|||
|
|||
#+begin_src emacs-lisp |
|||
(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. |
|||
(org-babel-python-command "python3") ;; Same as above. |
|||
(dap-python-executable "python3") ;; Same as above. |
|||
(lsp-pyls-server-command "pylsp") |
|||
(dap-python-debugger 'debugpy)) |
|||
#+end_src |
|||
|
|||
** Code symbols |
|||
|
|||
Programming buffers can be made prettier with ~pretty-mode~[fn:4], this is complimentary to ~prettify-symbols-mode~[fn:5], a built-in package containing similar (but lacking) functionality. |
|||
|
|||
#+begin_src emacs-lisp |
|||
(use-package pretty-mode |
|||
:hook (python-mode . turn-on-pretty-mode)) |
|||
#+end_src |
|||
|
|||
* Footnotes |
|||
|
|||
[fn:1] https://python.org |
|||
|
|||
[fn:2] https://pypi.org/project/python-language-server/ |
|||
|
|||
[fn:3] https://emacswiki.org/emacs/PythonProgrammingInEmacs |
|||
|
|||
[fn:4] https://emacswiki.org/emacs/pretty-mode.el |
|||
|
|||
[fn:5] https://emacswiki.org/emacs/PrettySymbol |
|||
Write
Preview
Loading…
Cancel
Save
Reference in new issue