From 3d3f83d244c674d4f6d187e2536b0fbbca261e75 Mon Sep 17 00:00:00 2001
From: Christopher James Hayward <chris@chrishayward.xyz>
Date: Wed, 13 Jan 2021 13:34:24 -0500
Subject: [PATCH] Add lsp / dap + python

---
 README.org | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 init.el    | 19 +++++++++++++++++
 2 files changed, 80 insertions(+)

diff --git a/README.org b/README.org
index 08528b2..311fb7d 100644
--- a/README.org
+++ b/README.org
@@ -383,3 +383,64 @@ https://github.com/integral-dw/org-superstar-mode
 #+end_src
 
 * Development
+:PROPERTIES:
+:header-args: :tangle init.el
+:END:
+
+An IDE like experience (or better) can be achieved in Emacs using two *Microsoft* open source initiatives.
++ https://microsoft.github.io/language-server-protocol/
++ https://microsoft.github.io/debug-adapter-protocol/
+
+https://emacs-lsp.github.io/lsp-mode/
++ Language servers for Emacs
+  
+#+begin_src emacs-lisp
+(use-package lsp-mode
+  :commands (lsp lsp-deferred)
+  :hook (lsp-mode . lsp-deferred))
+#+end_src
+
+https://emacs-lsp.github.io/lsp-ui/
++ UI improvements for =lsp-mode=
+
+#+begin_src emacs-lisp
+(use-package lsp-ui
+  :hook (lsp-mode . lsp-ui-mode))
+#+end_src
+
+https://emacs-lsp.github.io/dap-mode/
++ Debug adapters for Emacs
+
+#+begin_src emacs-lisp
+(use-package dap-mode)
+#+end_src
+
+** Python
+
+Full *IDE* experience for Python within Emacs.
++ Completion, jumps via =lsp-mode=
++ Debugging via =dap-mode=
+
+Install the =pyls= language server.
+
+#+begin_src shell :tangle no
+pip install --user "python-language-server[all]"
+#+end_src
+
+https://www.emacswiki.org/emacs/PythonProgrammingInEmacs
+
+#+begin_src emacs-lisp
+(use-package python-mode
+  :hook (python-mode . lsp-deferred)
+  :config (require 'dap-python)
+  :custom (python-shell-interpreter "python3") ;; Required if "python" is not python 3.
+          (dap-python-executable "python3")    ;; Same as above.
+          (dap-python-debugger 'debugpy))
+#+end_src
+
+Use the =pyvenv= package to use the =virtualenv= environment in Emacs. This allows =pyvenv-activate= to cause =lsp-mode= and =dap-mode= to be configured for the virtual environment.
+
+#+begin_src emacs-lisp
+(use-package pyvenv
+  :config (pyvenv-mode 1))
+#+end_src
diff --git a/init.el b/init.el
index 14c4a16..59469a6 100644
--- a/init.el
+++ b/init.el
@@ -157,3 +157,22 @@
 
 (use-package org-superstar
   :hook (org-mode . org-superstar-mode))
+
+(use-package lsp-mode
+  :commands (lsp lsp-deferred)
+  :hook (lsp-mode . lsp-deferred))
+
+(use-package lsp-ui
+  :hook (lsp-mode . lsp-ui-mode))
+
+(use-package dap-mode)
+
+(use-package python-mode
+  :hook (python-mode . lsp-deferred)
+  :config (require 'dap-python)
+  :custom (python-shell-interpreter "python3") ;; Required if "python" is not python 3.
+          (dap-python-executable "python3")    ;; Same as above.
+          (dap-python-debugger 'debugpy))
+
+(use-package pyvenv
+  :config (pyvenv-mode 1))