Installation

• Interpreter
  

  Tangled to the Homebrew bundle Brewfile:

  brew "python@3.12"
  

  N.B. We install version 3.12 to make TensorFlow work.

• Virtual environment
  

  python3.12 -m venv ~/.venv/
  

  N.B. We use version 3.12 to make TensorFlow work.

  N.B. Avoid the proprietary Anaconda distribution.

  • python-interpreter is for non-interactive use, and
  • python-shell-interpreter is for interactive use.

  (with-eval-after-load 'python
    (let ((interpreter "~/.venv/bin/ipython"))
      (setq python-interpreter interpreter
            python-shell-interpreter interpreter)))
  

• Package management
  

  source ~/.venv/bin/activate
  pip install --upgrade pip
  

• Language server
  

  source ~/.venv/bin/activate
  pip install "python-lsp-server[all]"
  

  N.B. [all] installs support for all 3rd-party tooling.

  (with-eval-after-load 'eglot
    (add-to-list 'eglot-server-programs
                 '((python-mode python-ts-mode) .
                   ("~/.venv/bin/pylsp"))))
  

  (with-eval-after-load 'python
    (add-hook 'python-mode-hook #'eglot-ensure)
    (add-hook 'python-mode-hook #'outline-minor-mode))
  

• Type hints
  

  source ~/.venv/bin/activate
  pip install pyright pylsp-mypy
  

  Ignore with:

  • # pyright: ignore
  • # mypy: ignore
• Refactoring
  

  source ~/.venv/bin/activate
  pip install pylsp-rope
  

• Linting
  

  source ~/.venv/bin/activate
  pip install python-lsp-ruff
  

• Formatting
  

  https://pypi.org/project/black/

  source ~/.venv/bin/activate
  pip install python-lsp-black # black
  

  (with-eval-after-load 'package
    (add-to-list 'package-selected-packages 'blacken))
  

  (with-eval-after-load 'blacken
    (setq blacken-executable "~/.venv/bin/black"
          blacken-line-length 'fill))
  

  ;; (add-hook 'python-mode-hook #'blacken-mode)
  

• Notebooks
  

  source ~/.venv/bin/activate
  pip install jupyter
  

  N.B. To run Jupyter, execute

  source ~/.venv/bin/activate && jupyter notebook
  

  in a shell or in the Compilation mode.

  • Experimental
    

    source ~/.venv/bin/activate
    pip install jupytext
    

    (with-eval-after-load 'package
      (add-to-list 'package-selected-packages 'code-cells)
      (add-to-list 'package-selected-packages 'drepl))
    

    Make code-cells use our Python environment.

    (with-eval-after-load 'code-cells
      (dolist (index (list 0 1))
        (setf (nth 0 (nth index code-cells-convert-ipynb-style))
              "~/.venv/bin/jupytext")))