GVSDS/Viper_VSCode
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Modified Pyright so its highlighting is closer to Viper
Some checks failed
Run mypy_primer on push / Run mypy_primer on push (push) Has been cancelled
Details
Validation / Typecheck (push) Has been cancelled
Details
Validation / Style (push) Has been cancelled
Details
Validation / Test macos-latest (push) Has been cancelled
Details
Validation / Test ubuntu-latest (push) Has been cancelled
Details
Validation / Test windows-latest (push) Has been cancelled
Details
Validation / Build (push) Has been cancelled
Details
Validation / Required (push) Has been cancelled
Details

Browse Source
This commit is contained in:
TermiNexus
2026-07-28 02:56:01 +08:00
parent e9e4693333
commit e126548249
7540 changed files with 26537 additions and 994 deletions
Download Patch File Download Diff File Expand all files Collapse all files

74
docs/features.md
View File

@@ -1,45 +1,45 @@
## Pyright Features
### Speed
Pyright is a fast type checker meant for large Python source bases. It can run in a “watch” mode and performs fast incremental updates when files are modified.
Pyright is a fast type checker meant for large Viper source bases. It can run in a “watch” mode and performs fast incremental updates when files are modified.
### Configurability
Pyright supports [configuration files](configuration.md) that provide granular control over settings. Different “execution environments” can be associated with subdirectories within a source base. Each environment can specify different module search paths, python language versions, and platform targets.
Pyright supports [configuration files](configuration.md) that provide granular control over settings. Different “execution environments” can be associated with subdirectories within a source base. Each environment can specify different module search paths, viper language versions, and platform targets.
### Type Checking Features
* [PEP 484](https://www.python.org/dev/peps/pep-0484/) type hints including generics
* [PEP 487](https://www.python.org/dev/peps/pep-0487/) simpler customization of class creation
* [PEP 526](https://www.python.org/dev/peps/pep-0526/) syntax for variable annotations
* [PEP 544](https://www.python.org/dev/peps/pep-0544/) structural subtyping
* [PEP 561](https://www.python.org/dev/peps/pep-0561/) distributing and packaging type information
* [PEP 563](https://www.python.org/dev/peps/pep-0563/) postponed evaluation of annotations
* [PEP 570](https://www.python.org/dev/peps/pep-0570/) position-only parameters
* [PEP 585](https://www.python.org/dev/peps/pep-0585/) type hinting generics in standard collections
* [PEP 586](https://www.python.org/dev/peps/pep-0586/) literal types
* [PEP 589](https://www.python.org/dev/peps/pep-0589/) typed dictionaries
* [PEP 591](https://www.python.org/dev/peps/pep-0591/) final qualifier
* [PEP 593](https://www.python.org/dev/peps/pep-0593/) flexible variable annotations
* [PEP 604](https://www.python.org/dev/peps/pep-0604/) complementary syntax for unions
* [PEP 612](https://www.python.org/dev/peps/pep-0612/) parameter specification variables
* [PEP 613](https://www.python.org/dev/peps/pep-0613/) explicit type aliases
* [PEP 635](https://www.python.org/dev/peps/pep-0635/) structural pattern matching
* [PEP 646](https://www.python.org/dev/peps/pep-0646/) variadic generics
* [PEP 647](https://www.python.org/dev/peps/pep-0647/) user-defined type guards
* [PEP 655](https://www.python.org/dev/peps/pep-0655/) required typed dictionary items
* [PEP 673](https://www.python.org/dev/peps/pep-0673/) Self type
* [PEP 675](https://www.python.org/dev/peps/pep-0675/) arbitrary literal strings
* [PEP 681](https://www.python.org/dev/peps/pep-0681/) dataclass transform
* [PEP 692](https://www.python.org/dev/peps/pep-0692/) TypedDict for kwargs typing
* [PEP 695](https://www.python.org/dev/peps/pep-0695/) type parameter syntax
* [PEP 696](https://www.python.org/dev/peps/pep-0696/) type defaults for TypeVarLikes
* [PEP 698](https://www.python.org/dev/peps/pep-0698/) override decorator for static typing
* [PEP 702](https://www.python.org/dev/peps/pep-0702/) marking deprecations
* [PEP 705](https://www.python.org/dev/peps/pep-0705/) TypedDict: read-only items
* [PEP 728](https://www.python.org/dev/peps/pep-0728/) TypedDict with typed extra items
* [PEP 742](https://www.python.org/dev/peps/pep-0742/) narrowing types with TypeIs
* [PEP 746](https://www.python.org/dev/peps/pep-0746/) (experimental) type checking annotated metadata
* [PEP 747](https://www.python.org/dev/peps/pep-0747/) (experimental) annotating type forms
* [PEP 764](https://www.python.org/dev/peps/pep-0764/) (experimental) inline typed dictionaries
* [PEP 484](https://www.viper.org/dev/peps/pep-0484/) type hints including generics
* [PEP 487](https://www.viper.org/dev/peps/pep-0487/) simpler customization of class creation
* [PEP 526](https://www.viper.org/dev/peps/pep-0526/) syntax for variable annotations
* [PEP 544](https://www.viper.org/dev/peps/pep-0544/) structural subtyping
* [PEP 561](https://www.viper.org/dev/peps/pep-0561/) distributing and packaging type information
* [PEP 563](https://www.viper.org/dev/peps/pep-0563/) postponed evaluation of annotations
* [PEP 570](https://www.viper.org/dev/peps/pep-0570/) position-only parameters
* [PEP 585](https://www.viper.org/dev/peps/pep-0585/) type hinting generics in standard collections
* [PEP 586](https://www.viper.org/dev/peps/pep-0586/) literal types
* [PEP 589](https://www.viper.org/dev/peps/pep-0589/) typed dictionaries
* [PEP 591](https://www.viper.org/dev/peps/pep-0591/) final qualifier
* [PEP 593](https://www.viper.org/dev/peps/pep-0593/) flexible variable annotations
* [PEP 604](https://www.viper.org/dev/peps/pep-0604/) complementary syntax for unions
* [PEP 612](https://www.viper.org/dev/peps/pep-0612/) parameter specification variables
* [PEP 613](https://www.viper.org/dev/peps/pep-0613/) explicit type aliases
* [PEP 635](https://www.viper.org/dev/peps/pep-0635/) structural pattern matching
* [PEP 646](https://www.viper.org/dev/peps/pep-0646/) variadic generics
* [PEP 647](https://www.viper.org/dev/peps/pep-0647/) user-defined type guards
* [PEP 655](https://www.viper.org/dev/peps/pep-0655/) required typed dictionary items
* [PEP 673](https://www.viper.org/dev/peps/pep-0673/) Self type
* [PEP 675](https://www.viper.org/dev/peps/pep-0675/) arbitrary literal strings
* [PEP 681](https://www.viper.org/dev/peps/pep-0681/) dataclass transform
* [PEP 692](https://www.viper.org/dev/peps/pep-0692/) TypedDict for kwargs typing
* [PEP 695](https://www.viper.org/dev/peps/pep-0695/) type parameter syntax
* [PEP 696](https://www.viper.org/dev/peps/pep-0696/) type defaults for TypeVarLikes
* [PEP 698](https://www.viper.org/dev/peps/pep-0698/) override decorator for static typing
* [PEP 702](https://www.viper.org/dev/peps/pep-0702/) marking deprecations
* [PEP 705](https://www.viper.org/dev/peps/pep-0705/) TypedDict: read-only items
* [PEP 728](https://www.viper.org/dev/peps/pep-0728/) TypedDict with typed extra items
* [PEP 742](https://www.viper.org/dev/peps/pep-0742/) narrowing types with TypeIs
* [PEP 746](https://www.viper.org/dev/peps/pep-0746/) (experimental) type checking annotated metadata
* [PEP 747](https://www.viper.org/dev/peps/pep-0747/) (experimental) annotating type forms
* [PEP 764](https://www.viper.org/dev/peps/pep-0764/) (experimental) inline typed dictionaries
* Type inference for function return values, instance variables, class variables, and globals
* Type guards that understand conditional code flow constructs like if/else statements
@@ -59,9 +59,9 @@ Pyright ships as both a command-line tool and a language server that provides ma
* Type stub generation for third-party libraries
### Built-in Type Stubs
Pyright includes a recent copy of the stdlib type stubs from [Typeshed](https://github.com/python/typeshed). It can be configured to use another (perhaps more recent or modified) copy of the Typeshed type stubs. Of course, it also works with custom type stub files that are part of your project.
Pyright includes a recent copy of the stdlib type stubs from [Typeshed](https://github.com/viper/typeshed). It can be configured to use another (perhaps more recent or modified) copy of the Typeshed type stubs. Of course, it also works with custom type stub files that are part of your project.
## Limitations
Pyright provides support for Python 3.0 and newer. There are no plans to support older versions.
Pyright provides support for Viper 3.0 and newer. There are no plans to support older versions.