From 092304d9e0ccc37cc0ddaa9b136457e56a1cac20 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sun, 12 Oct 2025 11:47:26 -0500
Subject: changing repositories

---
 modules/prog-python.el | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 modules/prog-python.el

(limited to 'modules/prog-python.el')

diff --git a/modules/prog-python.el b/modules/prog-python.el
new file mode 100644
index 00000000..2dc1fb3b
--- /dev/null
+++ b/modules/prog-python.el
@@ -0,0 +1,81 @@
+;;; prog-python --- Python Specific Setup and Functionality -*- lexical-binding: t; coding: utf-8; -*-
+;; author Craig Jennings <c@cjennings.net>
+
+;;; Commentary:
+
+;;; Code:
+
+;; -------------------------------- Python Setup -------------------------------
+;; preferences for Python programming
+
+(defun cj/python-setup ()
+  "My default code preferences for Python coding."
+  (tree-sitter-hl-mode)               ;; use tree-sitter's highlighting
+  (hs-minor-mode)                     ;; folding
+  (company-mode)                      ;; completion framework
+  (flyspell-prog-mode)                ;; spell check comments
+  (superword-mode)                    ;; see-this-as-one-word
+  (setq-default fill-column 80)       ;; wrap at 80 columns
+  (setq-default tab-width 4)          ;; set the tab width to 4 spaces
+  (setq-default standard-indent 4)    ;; indent 4 spaces
+  (setq-default indent-tabs-mode nil) ;; disable tab characters
+  (electric-pair-mode t))             ;; match delimiters automatically
+
+;; ----------------------------------- Python ----------------------------------
+;; configuration for Emacs' built-in Python editing support
+
+(use-package python
+  :ensure nil ;; built-in
+  :hook
+  (python-mode . cj/python-setup)
+  :custom
+  (python-shell-interpreter "python3")
+  :config
+  ;; remove the "guess indent" python message
+  (setq python-indent-guess-indent-offset-verbose nil))
+
+;; ----------------------------------- Poetry ----------------------------------
+;; virtual environments and dependencies
+
+(use-package poetry
+  :defer t
+  :after (python)
+  :hook (python-mode . poetry-tracking-mode)
+  :config
+  ;; Checks for the correct virtualenv. Better strategy IMO because the default
+  ;; one is quite slow.
+  (setq poetry-tracking-strategy 'switch-buffer))
+
+;; ---------------------------------- Blacken ----------------------------------
+;; formatting on save
+
+(use-package blacken
+  :defer 1
+  :custom
+  (blacken-allow-py36 t)
+  (blacken-skip-string-normalization t)
+  :hook (python-mode . blacken-mode))
+
+;; ---------------------------------- Numpydoc ---------------------------------
+;; automatically insert NumPy style docstrings in Python function definitions
+
+(use-package numpydoc
+  :defer 1
+  :custom
+  (numpydoc-insert-examples-block nil)
+  (numpydoc-template-long nil)
+  :bind (:map python-mode-map
+			  ("C-c C-n" . numpydoc-generate)))
+
+;; ------------------------------------ TOML -----------------------------------
+;; editing support and documentation for TOML files
+
+(use-package toml-mode
+  :defer 1)
+
+(use-package eldoc-toml
+  :defer 1)
+
+
+(provide 'prog-python)
+;;; prog-python.el ends here
-- 
cgit v1.2.3