An autocompletion tool for Python that can be used for text editors.
#################################################################################### Jedi - an awesome autocompletion, static analysis and refactoring library for Python ####################################################################################
.. image:: http://isitmaintained.com/badge/open/davidhalter/jedi.svg :target: https://github.com/davidhalter/jedi/issues :alt: The percentage of open issues and pull requests
.. image:: http://isitmaintained.com/badge/resolution/davidhalter/jedi.svg :target: https://github.com/davidhalter/jedi/issues :alt: The resolution time is the median time an issue or pull request stays open.
.. image:: https://github.com/davidhalter/jedi/workflows/ci/badge.svg?branch=master :target: https://github.com/davidhalter/jedi/actions :alt: Tests
.. image:: https://pepy.tech/badge/jedi :target: https://pepy.tech/project/jedi :alt: PyPI Downloads
Jedi is a static analysis tool for Python that is typically used in IDEs/editors plugins. Jedi has a focus on autocompletion and goto functionality. Other features include refactoring, code search and finding references.
Jedi has a simple API to work with. There is a reference implementation as a
VIM-Plugin <https://github.com/davidhalter/jedi-vim>
_. Autocompletion in your
REPL is also possible, IPython uses it natively and for the CPython REPL you
can install it. Jedi is well tested and bugs should be rare.
Jedi can currently be used with the following editors/projects:
Visual Studio Code
_ (via Python Extension <https://marketplace.visualstudio.com/items?itemName=ms-python.python>
_)see <https://projects.kde.org/projects/kde/applications/kate/repository/show?rev=KDE%2F4.13>
_]GNOME Builder
_ (with support for GObject Introspection)Eric IDE
_IPython 6.0.0+ <https://ipython.readthedocs.io/en/stable/whatsnew/version6.html>
_xonsh shell <https://xon.sh/contents.html>
_ has jedi extension <https://xon.sh/xontribs.html#jedi>
_and many more!
There are a few language servers that use Jedi:
jedi-language-server <https://github.com/pappasam/jedi-language-server>
_python-language-server <https://github.com/palantir/python-language-server>
_ (currently unmaintained)python-lsp-server <https://github.com/python-lsp/python-lsp-server>
_ (fork from python-language-server)anakin-language-server <https://github.com/muffinmad/anakin-language-server>
_Here are some pictures taken from jedi-vim_:
.. image:: https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_complete.png
Completion for almost anything:
.. image:: https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_function.png
Documentation:
.. image:: https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_pydoc.png
Get the latest version from github <https://github.com/davidhalter/jedi>
_
(master branch should always be kind of stable/working).
Docs are available at https://jedi.readthedocs.org/en/latest/ <https://jedi.readthedocs.org/en/latest/>
. Pull requests with enhancements
and/or fixes are awesome and most welcome. Jedi uses semantic versioning <https://semver.org/>
.
If you want to stay up-to-date with releases, please subscribe to this
mailing list: https://groups.google.com/g/jedi-announce. To subscribe you can
simply send an empty email to jedi-announce+subscribe@googlegroups.com
.
You can file issues and questions in the issue tracker <https://github.com/davidhalter/jedi/>
. Alternatively you can also ask on
Stack Overflow <https://stackoverflow.com/questions/tagged/python-jedi>
_ with
the label python-jedi
.
Check out the docs <https://jedi.readthedocs.org/en/latest/docs/installation.html>
_.
Jedi's features are listed here:
Features <https://jedi.readthedocs.org/en/latest/docs/features.html>
_.
You can run Jedi on Python 3.6+ but it should also
understand code that is older than those versions. Additionally you should be
able to use Virtualenvs <https://jedi.readthedocs.org/en/latest/docs/api.html#environments>
_
very well.
Tips on how to use Jedi efficiently can be found here <https://jedi.readthedocs.org/en/latest/docs/features.html#recipes>
_.
You can find a comprehensive documentation for the
API here <https://jedi.readthedocs.org/en/latest/docs/api.html>
_.
There are the following commands:
jedi.Script.goto
jedi.Script.infer
jedi.Script.help
jedi.Script.complete
jedi.Script.get_references
jedi.Script.get_signatures
jedi.Script.get_context
The returned objects are very powerful and are really all you might need.
Jedi is a dependency of IPython. Autocompletion in IPython with Jedi is therefore possible without additional configuration.
Here is an example video <https://vimeo.com/122332037>
_ how REPL completion
can look like.
For the python
shell you can enable tab completion in a REPL <https://jedi.readthedocs.org/en/latest/docs/usage.html#tab-completion-in-the-python-shell>
_.
For a lot of forms of static analysis, you can try to use
jedi.Script(...).get_names
. It will return a list of names that you can
then filter and work with. There is also a way to list the syntax errors in a
file: jedi.Script.get_syntax_errors
.
Jedi supports the following refactorings:
jedi.Script.inline
jedi.Script.rename
jedi.Script.extract_function
jedi.Script.extract_variable
There is support for module search with jedi.Script.search
, and project
search for jedi.Project.search
. The way to search is either by providing a
name like foo
or by using dotted syntax like foo.bar
. Additionally you
can provide the API type like class foo.bar.Bar
. There are also the
functions jedi.Script.complete_search
and jedi.Project.complete_search
.
There's a pretty good and extensive development documentation <https://jedi.readthedocs.org/en/latest/docs/development.html>
_.
The test suite uses pytest
::
pip install pytest
If you want to test only a specific Python version (e.g. Python 3.8), it is as easy as::
python3.8 -m pytest
For more detailed information visit the testing documentation <https://jedi.readthedocs.org/en/latest/docs/testing.html>
_.
Thanks a lot to all the
contributors <https://jedi.readthedocs.org/en/latest/docs/acknowledgements.html>
_!
.. _jedi-vim: https://github.com/davidhalter/jedi-vim .. _youcompleteme: https://github.com/ycm-core/YouCompleteMe .. _deoplete-jedi: https://github.com/zchee/deoplete-jedi .. _completor.vim: https://github.com/maralla/completor.vim .. _Jedi.el: https://github.com/tkf/emacs-jedi .. _company-mode: https://github.com/syohex/emacs-company-jedi .. _elpy: https://github.com/jorgenschaefer/elpy .. _anaconda-mode: https://github.com/proofit404/anaconda-mode .. _ycmd: https://github.com/abingham/emacs-ycmd .. _sublimejedi: https://github.com/srusskih/SublimeJEDI .. _anaconda: https://github.com/DamnWidget/anaconda .. _wdb: https://github.com/Kozea/wdb .. _TextMate: https://github.com/lawrenceakka/python-jedi.tmbundle .. _Kate: https://kate-editor.org .. _Atom: https://atom.io/ .. _autocomplete-python-jedi: https://atom.io/packages/autocomplete-python-jedi .. _GNOME Builder: https://wiki.gnome.org/Apps/Builder .. _Visual Studio Code: https://code.visualstudio.com/ .. _gedi: https://github.com/isamert/gedi .. _Eric IDE: https://eric-ide.python-projects.org
.. :changelog:
Unreleased ++++++++++
0.19.1 (2023-10-02) +++++++++++++++++++
0.19.0 (2023-07-29) +++++++++++++++++++
Interpreter
(e.g. IPython) users.
This especially affects pandas
users with large datasets.jedi.settings.allow_unsafe_interpreter_executions
to make it easier
for IPython users to avoid unsafe executions.0.18.2 (2022-11-21) +++++++++++++++++++
:Pyimport django.db
did not work in some cases in jedi-vim.0.18.1 (2021-11-17) +++++++++++++++++++
Name().type
0.18.0 (2020-12-25) +++++++++++++++++++
pathlib.Path()
as an output instead of str
in most places:
Project.path
Script.path
Definition.module_path
Refactoring.get_renames
Refactoring.get_changed_files
@property
now return property
instead of function
in Name().type
This is likely going to be the last minor release before 1.0.
0.17.2 (2020-07-17) +++++++++++++++++++
Environment
Project(...).path
exists nowThis will be the last release that supports Python 2 and Python 3.5.
0.18.0
will be Python 3.6+.
0.17.1 (2020-06-20) +++++++++++++++++++
Model
meta class supportDjango Stubs <https://github.com/typeddjango/django-stubs>
_ projectSyntaxError.get_message
0.17.0 (2020-04-14) +++++++++++++++++++
Project
support. This allows a user to specify which folders Jedi
should work with.Script.rename
, Script.inline
,
Script.extract_variable
and Script.extract_function
.Script.get_syntax_errors
to display syntax errors in the current
script.Project.search
, Project.complete_search
,
Script.search
and Script.complete_search
.Script.help
to make it easier to display a help window to people.
Now returns pydoc information as well for Python keywords/operators. This
means that on the class keyword it will now return the docstring of Python's
builtin function help('class')
.This is likely going to be the last minor version that supports Python 2 and Python3.5. Bugfixes will be provided in 0.17.1+. The next minor/major version will probably be Jedi 1.0.0.
0.16.0 (2020-01-26) +++++++++++++++++++
Script.get_context
to get information where you currently are.d = {1000: 3}; d[10
will
expand to 1000
.__getattr__(self, name)
method that does a return getattr(x, name)
.
after loading them initially.jedi.Script
are now deprecatedcompletions
deprecated, use complete
insteadgoto_assignments
deprecated, use goto
insteadgoto_definitions
deprecated, use infer
insteadcall_signatures
deprecated, use get_signatures
insteadusages
deprecated, use get_references
insteadjedi.names
deprecated, use jedi.Script(...).get_names()
BaseName.goto_assignments
renamed to BaseName.goto
Name.goto
. Now its signature matches
Script.goto
.settings.no_completion_duplicates
. It wasn't tested and nobody
was probably using it anyway.settings.use_filesystem_cache
and
settings.additional_dynamic_modules
, they have no usage anymore. Pretty
much nobody was probably using them.0.15.2 (2019-12-20) +++++++++++++++++++
Script(...).completions(fuzzy=True)
0.15.1 (2019-08-13) +++++++++++++++++++
0.15.0 (2019-08-11) +++++++++++++++++++
Completion.type
now:
path
. Example: '/ho
-> '/home/
*args
/**kwargs
resolving. If possible Jedi replaces the parameters
with the actual alternatives.New APIs:
Name.get_signatures() -> List[Signature]
. Signatures are similar to
CallSignature
. Name.params
is therefore deprecated.Signature.to_string()
to format signatures.Signature.params -> List[ParamName]
, ParamName has the
following additional attributes infer_default()
, infer_annotation()
,
to_string()
, and kind
.Name.execute() -> List[Name]
, makes it possible to infer
return values of functions.0.14.1 (2019-07-13) +++++++++++++++++++
0.14.0 (2019-06-20) +++++++++++++++++++
goto_*(prefer_stubs=True)
as well as goto_*(prefer_stubs=True)
0.13.3 (2019-02-24) +++++++++++++++++++
0.13.2 (2018-12-15) +++++++++++++++++++
0.13.1 (2018-10-02) +++++++++++++++++++
0.13.0 (2018-10-02) +++++++++++++++++++
include_builtins
as a parameter to usages.goto_assignments
has a new follow_builtin_imports
parameter that
changes the previous behavior slightly.0.12.1 (2018-06-30) +++++++++++++++++++
0.12.0 (2018-04-15) +++++++++++++++++++
0.11.1 (2017-12-14) +++++++++++++++++++
0.11.0 (2017-09-20) +++++++++++++++++++
parso
.settings.*recursion*
away, they are no longer usable.0.10.2 (2017-04-05) +++++++++++++++++++
0.10.1 (2017-04-05) +++++++++++++++++++
0.10.0 (2017-02-03) +++++++++++++++++++
yield from
PEP 380.get_line_code
to Name
and Completion
objects.0.9.0 (2015-04-10) ++++++++++++++++++
InferState.modules
import cache, which resembles sys.modules
.jedi.names
, a command to do static analysis. Thanks to that
sourcegraph guys for sponsoring this!0.8.1 (2014-07-23) +++++++++++++++++++
0.8.0 (2014-05-05) +++++++++++++++++++
__getattr__
strings possible.0.7.0 (2013-08-09) ++++++++++++++++++
0.6.0 (2013-05-14) ++++++++++++++++++
0.5 versions (2012) +++++++++++++++++++