Python - Revision history

Elvince: /* Virtual environments */ add emacs-pet

2024-06-25T14:40:15Z

Virtual environments: add emacs-pet

Elvince: add Screencast session

2023-05-02T11:05:45Z

add Screencast session

Elvince: /* Documentation */ how to make M-q respect docstring Django style (long term issue for me!)

2021-09-07T16:39:18Z

Documentation: how to make M-q respect docstring Django style (long term issue for me!)

Salexan: /* MyPy checks */ The option "--fast-parser" does not exist anymore, see: https://github.com/python/mypy/commit/df4432f28dc4d4afb5453c66041e7c08ca8b84da

2021-08-29T12:12:37Z

MyPy checks: The option "--fast-parser" does not exist anymore, see: https://github.com/python/mypy/commit/df4432f28dc4d4afb5453c66041e7c08ca8b84da

Elvince: add dap-mode

2021-04-25T08:49:30Z

add dap-mode

Elvince: /* include import statements or remove unused */ with emacs-traad

2018-05-24T16:57:10Z

include import statements or remove unused: with emacs-traad

Elvince: add LSP modes

2018-05-11T14:14:10Z

add LSP modes

Holocronweaver: minor style improvement

2018-05-09T14:47:35Z

minor style improvement

Elvince: /* Code Checker */

2017-11-17T09:57:52Z

Code Checker

Elvince: /* Indexing sources: ctags, cscope, pycscope */ elpy and goto def

2017-09-18T17:04:21Z

Indexing sources: ctags, cscope, pycscope: elpy and goto def

← Older revision		Revision as of 14:40, 25 June 2024
Line 549:		Line 549:

	Some tools allow to apply the changes of virtual environment activation inside emacs. They make '''M-x compile''' aware of the environment, etc.		Some tools allow to apply the changes of virtual environment activation inside emacs. They make '''M-x compile''' aware of the environment, etc.
		+
		+	* [https://github.com/wyuenho/emacs-pet pet] should supersede the other solutions. I tracks down the correct Python tooling executables from your virtualenvs so you can glue the binaries to Emacs, without configuration.
		+	* «The first time you call one the few pet helper functions, it will use Projectile or project.el to detect the root of your project, search for the configuration files for the many supported Python virtualenv tools, and then lookup the location of the virtualenv based on the content of the configuration files. Once a virtualenv is found, all executables are found by looking into its bin directory.»

	* [https://github.com/porterjamesj/virtualenvwrapper.el virtualenvwrapper] emulates much of the functionnality of '''virtualenvwrapper''', integrates well with '''M-x shell''' or '''eshell''', is aware of hooks, has an automatic activation by project and integrates in the mode line.		* [https://github.com/porterjamesj/virtualenvwrapper.el virtualenvwrapper] emulates much of the functionnality of '''virtualenvwrapper''', integrates well with '''M-x shell''' or '''eshell''', is aware of hooks, has an automatic activation by project and integrates in the mode line.

← Older revision		Revision as of 11:05, 2 May 2023
Line 618:		Line 618:

	Let's put them on [[Python libraries]]. Hints to write Emacs packages for Python projects.		Let's put them on [[Python libraries]]. Hints to write Emacs packages for Python projects.
		+
		+	== Screencasts ==
		+
		+	These videos are of particular interest for Python development in Emacs:
		+
		+	* [https://www.youtube.com/watch?v=JmmTUIahB1U Emacs, Pyright and Eglot make for an excellent Python IDE]

	== See also ==		== See also ==

← Older revision		Revision as of 16:39, 7 September 2021
Line 418:		Line 418:

	== Documentation ==		== Documentation ==
		+
		+	=== Choose your docstring fill-paragraph style (M-q) ===
		+
		+	If you call '''M-q''' (fill-paragraph) inside a Python docstring, Python-mode will format it following PEP-257: the first sentence is on the same line with the opening quotes and a blank line is inserted before the closing quotes, like so:
		+
		+	<source>
		+	def foo():
		+	"""My docstring.
		+
		+	"""
		+	pass
		+	</source>
		+
		+	Perhaps you prefer the Django style:
		+
		+	<source>
		+	def foo():
		+	"""
		+	My docstring.
		+	"""
		+	pass
		+	</source>
		+
		+	To make '''M-q''' respect the Django style, use this setting:
		+
		+	(setq python-fill-docstring-style 'django)
		+

	=== Insert Sphinx docstrings ===		=== Insert Sphinx docstrings ===

@@ Line 245: / Line 245: @@
      python-mypy ""
      :command ("mypy"
-               "--ignore-missing-imports" "--fast-parser"
+               "--ignore-missing-imports"
                "--python-version" "3.6"
                source-original)

@@ Line 410: / Line 410: @@
 </source>
 Now just run '''M-x compile''' as usual.
 == Documentation ==

← Older revision		Revision as of 16:57, 24 May 2018
Line 546:		Line 546:

	Unfortunately Ropemacs can not do non-relative imports, it can only create imports of the "from X import Y" variety (if you type ''shutil.rmtree'' it doesn't write ''import shutil'').		Unfortunately Ropemacs can not do non-relative imports, it can only create imports of the "from X import Y" variety (if you type ''shutil.rmtree'' it doesn't write ''import shutil'').
		+
		+	'''emacs-traad''' (see above) has a function '''traad-auto-import'''.

	[https://github.com/Wilfred/pyimport pyimport] can add import statements or remove the unused ones (with pyflakes).		[https://github.com/Wilfred/pyimport pyimport] can add import statements or remove the unused ones (with pyflakes).

← Older revision		Revision as of 14:14, 11 May 2018
Line 50:		Line 50:

	[http://emacs-bootstrap.com/ Emacs-bootstrap] is a website where you can select a few programming languages, some options, and have it generate a full .emacs.d folder for you.		[http://emacs-bootstrap.com/ Emacs-bootstrap] is a website where you can select a few programming languages, some options, and have it generate a full .emacs.d folder for you.
		+
		+	== Language Server Protocol support ==
		+
		+	See [https://github.com/joaotavora/eglot eglot], a polyglot LSP mode for Emacs (by the author of Yasnippet,…),
		+
		+	and [https://github.com/palantir/python-language-server pyls] specifically for Python.

	== Refactoring ==		== Refactoring ==

← Older revision		Revision as of 14:47, 9 May 2018
Line 1:		Line 1:
−	How can we turn Emacs as full featured Python IDE ? How to use Emacs for data science ? Many packages are explained below. You don't have to install all of them one by one, see the all-in-one solutions, like Elpy, [http://wikemacs.org/wiki/Starter_Kits starter kits] and the [https://spacemacs.org/layers/+lang/python/README.html Spacemacs] layer.	+	How can we turn Emacs as full featured Python IDE? How to use Emacs for data science? Many packages are explained below. You don't have to install all of them one by one, see the all-in-one solutions, like Elpy, [http://wikemacs.org/wiki/Starter_Kits starter kits] and the [https://spacemacs.org/layers/+lang/python/README.html Spacemacs] layer.

	An important library you'll want to get familiar with is [https://jedi.readthedocs.io/en/latest/ Jedi], an autocompletion and analysis library for Python. It helps at autocompletion, finding definitions, showing documentation, etc. Elpy makes good use of it.		An important library you'll want to get familiar with is [https://jedi.readthedocs.io/en/latest/ Jedi], an autocompletion and analysis library for Python. It helps at autocompletion, finding definitions, showing documentation, etc. Elpy makes good use of it.

← Older revision		Revision as of 09:57, 17 November 2017
Line 228:		Line 228:

	[[File:flycheck-annotated.png]]		[[File:flycheck-annotated.png]]
		+
		+	=== MyPy checks ===
		+
		+	With [https://github.com/SerialDev/mypy-mode mypy-mode] we get a compilation-mode based support for python 3.6+ type hints checks.
		+
		+	As a side note, we can also get flycheck to work, at the same time as pylint, with:
		+
		+	<source lang="elisp">
		+	(flycheck-define-checker
		+	python-mypy ""
		+	:command ("mypy"
		+	"--ignore-missing-imports" "--fast-parser"
		+	"--python-version" "3.6"
		+	source-original)
		+	:error-patterns
		+	((error line-start (file-name) ":" line ": error:" (message) line-end))
		+	:modes python-mode)
		+
		+	(add-to-list 'flycheck-checkers 'python-mypy t)
		+	(flycheck-add-next-checker 'python-pylint 'python-mypy t)
		+	</source>

	== Indexing sources: ctags, cscope, pycscope ==		== Indexing sources: ctags, cscope, pycscope ==

← Older revision		Revision as of 17:04, 18 September 2017
Line 232:		Line 232:

	Indexing sources allows you to do neat things, like going to the definition of a function or finding which functions are calling another one.		Indexing sources allows you to do neat things, like going to the definition of a function or finding which functions are calling another one.
		+
		+	Note that Elpy does the "go to definition" feature (elpy-goto-definition), without the need of indexing sources.

	=== etags, ctags ===		=== etags, ctags ===