mirror of
https://github.com/microsoft/pyright.git
synced 2024-09-11 07:55:56 +03:00
Moved installation instructions and FAQ to their own docs pages, further simplifying the main README.
This commit is contained in:
parent
b61f121efe
commit
6cb2f4a058
59
README.md
59
README.md
@ -2,55 +2,12 @@
|
|||||||
|
|
||||||
# Static type checker for Python
|
# Static type checker for Python
|
||||||
|
|
||||||
Pyright is a full-featured, standards-based static type checker for Python. It is designed for high performance and can be used with large Python source bases.
|
Pyright is a full-featured, standards-based static type checker for Python. It is designed for high performance and can be used with large Python source bases. Pyright includes both a [command-line tool](/docs/command-line.md) and an [extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-pyright.pyright).
|
||||||
|
|
||||||
### Command-line Tool or Visual Studio Code Extension
|
|
||||||
Pyright includes both a [command-line tool](/docs/command-line.md) and an [extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-pyright.pyright).
|
|
||||||
|
|
||||||
|
|
||||||
## Installation
|
## Documentation & Questions
|
||||||
### VS Code Extension
|
|
||||||
For most VS Code users, we recommend using the Pylance extension rather than Pyright. Pylance incorporates the Pyright type checker but features additional capabilities such as semantic token highlighting and symbol indexing. You can install the latest-published version of the Pylance VS Code extension directly from VS Code. Simply open the extensions panel and search for “Pylance”.
|
|
||||||
|
|
||||||
### Vim
|
Refer to [the documentation](https://microsoft.github.io/pyright) for installation, configuration, and usage details.
|
||||||
Vim/neovim users can install [coc-pyright](https://github.com/fannheyward/coc-pyright), the Pyright extension for coc.nvim.
|
|
||||||
|
|
||||||
Alternatively, [ALE](https://github.com/dense-analysis/ale) will automatically check your code with Pyright if added to the linters list.
|
|
||||||
|
|
||||||
### Sublime Text
|
|
||||||
Sublime text users can install the [LSP-pyright](https://github.com/sublimelsp/LSP-pyright) plugin from [package control](https://packagecontrol.io/packages/LSP-pyright).
|
|
||||||
|
|
||||||
### Emacs
|
|
||||||
Emacs users can install [eglot](https://github.com/joaotavora/eglot) or [lsp-mode](https://github.com/emacs-lsp/lsp-mode) with [lsp-pyright](https://github.com/emacs-lsp/lsp-pyright).
|
|
||||||
|
|
||||||
### Command-line
|
|
||||||
A [community-maintained](https://github.com/RobertCraigie/pyright-python) Python package by the name of “pyright” is available on pypi and conda-forge. This package will automatically install node (which Pyright requires) and keep Pyright up to date.
|
|
||||||
|
|
||||||
`pip install pyright`
|
|
||||||
|
|
||||||
or
|
|
||||||
|
|
||||||
`conda install pyright`
|
|
||||||
|
|
||||||
Once installed, you can run the tool from the command line as follows:
|
|
||||||
`pyright <options>`
|
|
||||||
|
|
||||||
|
|
||||||
Alternatively, you can install the command-line version of Pyright directly from npm, which is part of node. If you don't have a recent version of node on your system, install that first from [nodejs.org](https://nodejs.org).
|
|
||||||
|
|
||||||
To install pyright globally:
|
|
||||||
`npm install -g pyright`
|
|
||||||
|
|
||||||
On MacOS or Linux, sudo may be required to install globally:
|
|
||||||
`sudo npm install -g pyright`
|
|
||||||
|
|
||||||
To update to the latest version:
|
|
||||||
`sudo npm update -g pyright`
|
|
||||||
|
|
||||||
|
|
||||||
## Documentation
|
|
||||||
|
|
||||||
Full documentation can be found [here](https://microsoft.github.io/pyright)
|
|
||||||
|
|
||||||
|
|
||||||
## Community
|
## Community
|
||||||
@ -59,16 +16,6 @@ Do you have questions about Pyright or Python type annotations in general? Post
|
|||||||
If you would like to report a bug or request an enhancement, file a new issue in either the [pyright](https://github.com/microsoft/pyright/issues) or [pylance-release](https://github.com/microsoft/pylance-release/issues) issue tracker. In general, core type checking functionality is associated with Pyright while language service functionality is associated with Pylance, but the same contributors monitor both repos. For best results, provide the information requested in the issue template.
|
If you would like to report a bug or request an enhancement, file a new issue in either the [pyright](https://github.com/microsoft/pyright/issues) or [pylance-release](https://github.com/microsoft/pylance-release/issues) issue tracker. In general, core type checking functionality is associated with Pyright while language service functionality is associated with Pylance, but the same contributors monitor both repos. For best results, provide the information requested in the issue template.
|
||||||
|
|
||||||
|
|
||||||
## FAQ
|
|
||||||
**Q:** What is the difference between Pyright and [Pylance](https://github.com/microsoft/pylance-release)?
|
|
||||||
|
|
||||||
**A:** Pyright is an open-source Python type checker and language server. Pylance leverages Pyright’s functionality with additional features, some of which are not open-sourced.
|
|
||||||
|
|
||||||
**Q:** What is the long-term plan for Pyright?
|
|
||||||
|
|
||||||
**A:** Pyright is an officially-supported Microsoft type checker for Python. It will continue to be developed and maintained as an open-source project under its original MIT license terms.
|
|
||||||
|
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
This project welcomes contributions and suggestions. For feature and complex bug fix contributions, it is recommended that you first discuss the proposed change with Pyright’s maintainers before submitting the pull request. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
|
This project welcomes contributions and suggestions. For feature and complex bug fix contributions, it is recommended that you first discuss the proposed change with Pyright’s maintainers before submitting the pull request. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
- [Type Concepts](type-concepts.md)
|
- [Type Concepts](type-concepts.md)
|
||||||
- [Getting Started with Type Checking](getting-started.md)
|
- [Getting Started with Type Checking](getting-started.md)
|
||||||
- [Pyright Features](features.md)
|
- [Pyright Features](features.md)
|
||||||
|
- [FAQ](faq.md)
|
||||||
|
|
||||||
- Customization
|
- Customization
|
||||||
|
|
||||||
|
9
docs/faq.md
Normal file
9
docs/faq.md
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
# Frequently Asked Questions
|
||||||
|
|
||||||
|
**Q:** What is the difference between Pyright and [Pylance](https://github.com/microsoft/pylance-release)?
|
||||||
|
|
||||||
|
**A:** Pyright is an open-source Python type checker and language server. Pylance leverages Pyright’s functionality with additional features, some of which are not open-sourced.
|
||||||
|
|
||||||
|
**Q:** What is the long-term plan for Pyright?
|
||||||
|
|
||||||
|
**A:** Pyright is an officially-supported Microsoft type checker for Python. It will continue to be developed and maintained as an open-source project under its original MIT license terms.
|
Loading…
Reference in New Issue
Block a user