Skip to content
Awesome autocompletion and static analysis library for python.
Python Other
  1. Python 99.9%
  2. Other 0.1%
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Fix some array tests Aug 17, 2019
jedi Fix inference from type comment for function parameter with dot Nov 8, 2019
scripts Add a script for profiling pytest Jun 19, 2019
test Fix inference from type comment for function parameter with dot Nov 8, 2019
.coveragerc Move the evaluate package to inference Aug 14, 2019
.gitignore Add pytest cache to gitignore Mar 4, 2018
.gitmodules Cloning typeshed should be possible without git write access Dec 16, 2018
.travis.yml 3.8-dev should not be allowed to fail Aug 2, 2019
AUTHORS.txt Fix for failing assertion on native modules Issue #1354 (#1370) Jul 23, 2019
CHANGELOG.rst
CONTRIBUTING.md Mention that it's ok to have a line length of 100 characters in our f… Jul 12, 2018
LICENSE.txt Remove the license parts that are not needed anymore, because they ar… Jun 1, 2017
MANIFEST.in Another try with MANIFEST.in May 19, 2019
README.rst Update link to YouCompleteMe Jul 3, 2019
appveyor.yml Clone appveyor submodules recursively Dec 16, 2018
conftest.py Move the evaluate package to inference Aug 14, 2019
deploy-master.sh Make sure that the deployment process checks out git submodules (e.g.… May 17, 2019
pytest.ini Merge branch 'master' into pytest May 19, 2019
requirements.txt Update parso requirement Jun 21, 2019
setup.cfg Better flake8 configuration Jul 23, 2018
setup.py Cannot use pytest 5 yet Jul 2, 2019
sith.py Fix sith.py line number generation May 31, 2019
tox.ini For now use parso master for tox testing May 21, 2019

README.rst

Jedi - an awesome autocompletion/static analysis library for Python

PyPI version Supported Python versions Linux Tests Windows Tests Coverage status

If you have specific questions, please add an issue or ask on Stack Overflow with the label python-jedi.

Jedi is a static analysis tool for Python that can be used in IDEs/editors. Jedi has a focus on autocompletion and goto functionality. Jedi is fast and is very well tested. It understands Python and stubs on a deep level.

Jedi has support for different goto functions. It's possible to search for usages and list names in a Python file to get information about them.

Jedi uses a very simple API to connect with IDE's. There's a reference implementation as a VIM-Plugin, which uses Jedi's autocompletion. We encourage you to use Jedi in your IDEs. Autocompletion in your REPL is also possible, IPython uses it natively and for the CPython REPL you have to install it.

Jedi can currently be used with the following editors/projects:

and many more!

Here are some pictures taken from jedi-vim:

https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_complete.png

Completion for almost anything (Ctrl+Space).

https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_function.png

Display of function/class bodies, docstrings.

https://github.com/davidhalter/jedi/raw/master/docs/_screenshots/screenshot_pydoc.png

Pydoc support (Shift+k).

There is also support for goto and renaming.

Get the latest version from github (master branch should always be kind of stable/working).

Docs are available at https://jedi.readthedocs.org/en/latest/. Pull requests with documentation enhancements and/or fixes are awesome and most welcome. Jedi uses semantic versioning.

If you want to stay up-to-date (News / RFCs), please subscribe to this github thread.:

Installation

pip install jedi

Note: This just installs the Jedi library, not the editor plugins. For information about how to make it work with your editor, refer to the corresponding documentation.

You don't want to use pip? Please refer to the manual.

Feature Support and Caveats

Jedi really understands your Python code. For a comprehensive list what Jedi understands, see: Features. A list of caveats can be found on the same page.

You can run Jedi on CPython 2.7 or 3.4+ but it should also understand/parse code older than those versions. Additionally you should be able to use Virtualenvs very well.

Tips on how to use Jedi efficiently can be found here.

API

You can find the documentation for the API here.

Autocompletion / Goto / Pydoc

Please check the API for a good explanation. There are the following commands:

  • jedi.Script.goto_assignments
  • jedi.Script.completions
  • jedi.Script.usages

The returned objects are very powerful and really all you might need.

Autocompletion in your REPL (IPython, etc.)

Starting with IPython 6.0.0 Jedi is a dependency of IPython. Autocompletion in IPython is therefore possible without additional configuration.

It's possible to have Jedi autocompletion in REPL modes - example video. This means that in Python you can enable tab completion in a REPL.

Static Analysis

To do all forms of static analysis, please try to use jedi.names. It will return a list of names that you can use to infer types and so on.

Refactoring

Jedi's parser would support refactoring, but there's no API to use it right now. If you're interested in helping out here, let me know. With the latest parser changes, it should be very easy to actually make it work.

Development

There's a pretty good and extensive development documentation.

Testing

The test suite depends on tox and pytest:

pip install tox pytest

To run the tests for all supported Python versions:

tox

If you want to test only a specific Python version (e.g. Python 2.7), it's as easy as

tox -e py27

Tests are also run automatically on Travis CI.

For more detailed information visit the testing documentation.

Acknowledgements

  • Takafumi Arakaki (@tkf) for creating a solid test environment and a lot of other things.
  • Danilo Bargen (@dbrgn) for general housekeeping and being a good friend :).
  • Guido van Rossum (@gvanrossum) for creating the parser generator pgen2 (originally used in lib2to3).
You can’t perform that action at this time.