From 8c439874245ff3cd6625c86dabef2307617936c8 Mon Sep 17 00:00:00 2001 From: Shunsuke Shibayama Date: Sat, 5 Oct 2024 16:49:30 +0900 Subject: [PATCH] Deployed fddc571 with MkDocs version: 1.6.0 --- index.html | 5 ++++- search/search_index.json | 2 +- sitemap.xml | 12 ++++++------ sitemap.xml.gz | Bin 256 -> 257 bytes 4 files changed, 11 insertions(+), 8 deletions(-) diff --git a/index.html b/index.html index 7c96fe3..629132d 100644 --- a/index.html +++ b/index.html @@ -755,8 +755,10 @@

TODOs#
  • Optional
  • Literal
  • Callable
    • -
  • TypedDict
    • +
  • Any
  • TypeVar
    • +
  • TypedDict
    • +
  • ClassVar
  • Generic
  • Protocol
  • Final
    • @@ -780,6 +782,7 @@

    TODOs#
  • type narrowing (is, isinstance)
  • pyi (stub) files support
  • glob pattern file check
    • +
  • type comment (# type: ...)

    • Join us!#

    We are looking for contributors to help us improve pylyzer. If you are interested in contributing and have any questions, please feel free to contact us.

    diff --git a/search/search_index.json b/search/search_index.json index ccff4df..480613b 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"pylyzer \u26a1","text":"

    pylyzer is a static code analyzer / language server for Python, written in Rust.

    "},{"location":"#installation","title":"Installation","text":""},{"location":"#pip","title":"pip","text":"
    pip install pylyzer\n
    "},{"location":"#cargo-rust-package-manager","title":"cargo (Rust package manager)","text":"
    cargo install pylyzer --locked\n
    "},{"location":"#build-from-source","title":"build from source","text":"
    git clone https://github.com/mtshiba/pylyzer.git\ncargo install --path . --locked\n

    Make sure that cargo/rustc is up-to-date, as pylyzer may be written with the latest (stable) language features.

    "},{"location":"#github-releases","title":"GitHub Releases","text":""},{"location":"#what-is-the-advantage-over-pylint-pyright-pytype-etc","title":"What is the advantage over pylint, pyright, pytype, etc.?","text":"
    • Performance \ud83c\udf1f

    On average, pylyzer can inspect Python scripts more than 100 times faster than pytype and pyright 1. This is largely due to the fact that pylyzer is implemented in Rust.

    • Reports readability \ud83d\udcd6

    While pytype/pyright's error reports are illegible, pylyzer shows where the error occurred and provides clear error messages.

    "},{"location":"#pyright","title":"pyright","text":""},{"location":"#pylyzer_1","title":"pylyzer \ud83d\ude03","text":"
    • Rich LSP support \ud83d\udcdd

    pylyzer as a language server supports various features, such as completion and renaming (The language server is an adaptation of the Erg Language Server (ELS). For more information on the implemented features, please see here).

    "},{"location":"#vscode-extension","title":"VSCode extension","text":"

    You can install the VSCode extension from the Marketplace or from the command line:

    code --install-extension pylyzer.pylyzer\n
    "},{"location":"#what-is-the-difference-from-ruff","title":"What is the difference from Ruff?","text":"

    Ruff, like pylyzer, is a static code analysis tool for Python written in Rust, but Ruff is a linter and pylyzer is a type checker & language server. pylyzer does not perform linting & formatting, and Ruff does not perform type checking.

    "},{"location":"#how-it-works","title":"How it works","text":"

    pylyzer uses the type checker of the Erg programming language internally. This language is a transpiled language that targets Python, and has a static type system.

    pylyzer converts Python ASTs to Erg ASTs and passes them to Erg's type checker. It then displays the results with appropriate modifications.

    "},{"location":"#limitations","title":"Limitations","text":"

    • pylyzer's type inspector only assumes (potentially) statically typed code, so you cannot check any code uses reflections, such as exec, setattr, etc.

    • pylyzer (= Erg's type system) has its own type declarations for the Python standard APIs. Typing of all APIs is not complete and may result in an error that such an API does not exist.

    • Since pylyzer's type checking is conservative, you may encounter many (possibly false positive) errors. We are working on fixing this, but if you are concerned about editor errors, please turn off the diagnostics feature.

    "},{"location":"#todos","title":"TODOs","text":"
    • type checking
      • variable
      • operator
      • function/method
      • class
    • type inference
      • variable
      • operator
      • function/method
      • class
    • builtin modules analysis
    • local scripts analysis
    • local packages analysis
    • LSP features
      • diagnostics
      • completion
      • rename
      • hover
      • goto definition
      • signature help
      • find references
      • document symbol
      • call hierarchy
    • collection types
      • list
      • dict
      • tuple
      • set
    • typing
      • Union
      • Optional
      • Literal
      • Callable
      • TypedDict
      • TypeVar
      • Generic
      • Protocol
      • Final
      • Annotated
      • TypeAlias
      • TypeGuard
      • type parameter syntax
      • type narrowing
      • others
    • collections.abc
      • Iterable
      • Iterator
      • Mapping
      • Sequence
      • others
    • type assertion (typing.cast)
    • type narrowing (is, isinstance)
    • pyi (stub) files support
    • glob pattern file check
    "},{"location":"#join-us","title":"Join us!","text":"

    We are looking for contributors to help us improve pylyzer. If you are interested in contributing and have any questions, please feel free to contact us.

    • Discord (Erg language)
      • #pylyzer
    • GitHub discussions

    1 The performance test was conducted on MacBook (Early 2016) with 1.1 GHz Intel Core m3 processor and 8 GB 1867 MHz LPDDR3 memory.\u21a9

    "},{"location":"editor/","title":"Editor integrations","text":""},{"location":"editor/#vscode","title":"VSCode","text":"
    • Install the extension.
    "},{"location":"editor/#neovim","title":"Neovim","text":"
    • Setup mason.
    • Type :MasonInstall pylyzer in Neovim.

    If you use LunarVim, no setup is required. Just install pylyzer and you are good to go.

    "},{"location":"errors/errors/","title":"Pylyzer-specific errors","text":""},{"location":"errors/errors/#e0001-reassignment-of-a-function-referenced-by-other-functions","title":"E0001: Reassignment of a function referenced by other functions","text":"
    def g(): return f()\n\ndef f(): return 1\ndef f(): return \"a\" # E0001: Reassignment of a function referenced by other functions\n\nprint(g())\n
    "},{"location":"errors/errors/#e0002-__init__-doesnt-have-a-first-parameter-named-self","title":"E0002: __init__ doesn't have a first parameter named self","text":"
    class C:\n    def __init__(a): pass # E0002\n
    "},{"location":"errors/errors/#e0003-__init__-as-a-member-variable","title":"E0003: __init__ as a member variable","text":"
    class C:\n    __init__ = 1 # E0003\n
    "},{"location":"errors/warns/","title":"Pylyzer-specific warnings","text":""},{"location":"errors/warns/#w0188-used-value","title":"W0188: Used value","text":"
    def f(x): return x\n\nf(1) # W0188: UnusedWarning: the evaluation result of the expression (: {1, }) is not used\n
    "},{"location":"options/options/","title":"command line options","text":""},{"location":"options/options/#-server","title":"--server","text":"

    Launch as a language server.

    "},{"location":"options/options/#-dump-decl","title":"--dump-decl","text":"

    Dump a type declarations file (d.er) after type checking.

    $ pylyzer --dump-decl test.py\nStart checking: test.py\nAll checks OK: test.py\n\n$ ls\ntest.py  test.d.er\n
    "},{"location":"options/options/#-c-code","title":"-c/--code","text":"

    Check code from the command line.

    $ pylyzer -c \"print('hello world')\"\nStart checking: string\nAll checks OK: string\n
    "},{"location":"options/options/#-disable","title":"--disable","text":"

    Disable a default LSP feature. Default (disableable) features are:

    • codeAction
    • codeLens
    • completion
    • diagnostics
    • findReferences
    • gotoDefinition
    • hover
    • inlayHint
    • rename
    • semanticTokens
    • signatureHelp
    "},{"location":"options/pyproject/","title":"pyproject.toml options","text":""},{"location":"options/pyproject/#toolpylyzerpythonpath","title":"tool.pylyzer.python.path","text":"

    Path to the Python interpreter to use. If not set, the default Python interpreter will be used.

    [tool.pylyzer.python]\npath = \"path/to/python\"\n
    "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"pylyzer \u26a1","text":"

    pylyzer is a static code analyzer / language server for Python, written in Rust.

    "},{"location":"#installation","title":"Installation","text":""},{"location":"#pip","title":"pip","text":"
    pip install pylyzer\n
    "},{"location":"#cargo-rust-package-manager","title":"cargo (Rust package manager)","text":"
    cargo install pylyzer --locked\n
    "},{"location":"#build-from-source","title":"build from source","text":"
    git clone https://github.com/mtshiba/pylyzer.git\ncargo install --path . --locked\n

    Make sure that cargo/rustc is up-to-date, as pylyzer may be written with the latest (stable) language features.

    "},{"location":"#github-releases","title":"GitHub Releases","text":""},{"location":"#what-is-the-advantage-over-pylint-pyright-pytype-etc","title":"What is the advantage over pylint, pyright, pytype, etc.?","text":"
    • Performance \ud83c\udf1f

    On average, pylyzer can inspect Python scripts more than 100 times faster than pytype and pyright 1. This is largely due to the fact that pylyzer is implemented in Rust.

    • Reports readability \ud83d\udcd6

    While pytype/pyright's error reports are illegible, pylyzer shows where the error occurred and provides clear error messages.

    "},{"location":"#pyright","title":"pyright","text":""},{"location":"#pylyzer_1","title":"pylyzer \ud83d\ude03","text":"
    • Rich LSP support \ud83d\udcdd

    pylyzer as a language server supports various features, such as completion and renaming (The language server is an adaptation of the Erg Language Server (ELS). For more information on the implemented features, please see here).

    "},{"location":"#vscode-extension","title":"VSCode extension","text":"

    You can install the VSCode extension from the Marketplace or from the command line:

    code --install-extension pylyzer.pylyzer\n
    "},{"location":"#what-is-the-difference-from-ruff","title":"What is the difference from Ruff?","text":"

    Ruff, like pylyzer, is a static code analysis tool for Python written in Rust, but Ruff is a linter and pylyzer is a type checker & language server. pylyzer does not perform linting & formatting, and Ruff does not perform type checking.

    "},{"location":"#how-it-works","title":"How it works","text":"

    pylyzer uses the type checker of the Erg programming language internally. This language is a transpiled language that targets Python, and has a static type system.

    pylyzer converts Python ASTs to Erg ASTs and passes them to Erg's type checker. It then displays the results with appropriate modifications.

    "},{"location":"#limitations","title":"Limitations","text":"

    • pylyzer's type inspector only assumes (potentially) statically typed code, so you cannot check any code uses reflections, such as exec, setattr, etc.

    • pylyzer (= Erg's type system) has its own type declarations for the Python standard APIs. Typing of all APIs is not complete and may result in an error that such an API does not exist.

    • Since pylyzer's type checking is conservative, you may encounter many (possibly false positive) errors. We are working on fixing this, but if you are concerned about editor errors, please turn off the diagnostics feature.

    "},{"location":"#todos","title":"TODOs","text":"
    • type checking
      • variable
      • operator
      • function/method
      • class
    • type inference
      • variable
      • operator
      • function/method
      • class
    • builtin modules analysis
    • local scripts analysis
    • local packages analysis
    • LSP features
      • diagnostics
      • completion
      • rename
      • hover
      • goto definition
      • signature help
      • find references
      • document symbol
      • call hierarchy
    • collection types
      • list
      • dict
      • tuple
      • set
    • typing
      • Union
      • Optional
      • Literal
      • Callable
      • Any
      • TypeVar
      • TypedDict
      • ClassVar
      • Generic
      • Protocol
      • Final
      • Annotated
      • TypeAlias
      • TypeGuard
      • type parameter syntax
      • type narrowing
      • others
    • collections.abc
      • Iterable
      • Iterator
      • Mapping
      • Sequence
      • others
    • type assertion (typing.cast)
    • type narrowing (is, isinstance)
    • pyi (stub) files support
    • glob pattern file check
    • type comment (# type: ...)
    "},{"location":"#join-us","title":"Join us!","text":"

    We are looking for contributors to help us improve pylyzer. If you are interested in contributing and have any questions, please feel free to contact us.

    • Discord (Erg language)
      • #pylyzer
    • GitHub discussions

    1 The performance test was conducted on MacBook (Early 2016) with 1.1 GHz Intel Core m3 processor and 8 GB 1867 MHz LPDDR3 memory.\u21a9

    "},{"location":"editor/","title":"Editor integrations","text":""},{"location":"editor/#vscode","title":"VSCode","text":"
    • Install the extension.
    "},{"location":"editor/#neovim","title":"Neovim","text":"
    • Setup mason.
    • Type :MasonInstall pylyzer in Neovim.

    If you use LunarVim, no setup is required. Just install pylyzer and you are good to go.

    "},{"location":"errors/errors/","title":"Pylyzer-specific errors","text":""},{"location":"errors/errors/#e0001-reassignment-of-a-function-referenced-by-other-functions","title":"E0001: Reassignment of a function referenced by other functions","text":"
    def g(): return f()\n\ndef f(): return 1\ndef f(): return \"a\" # E0001: Reassignment of a function referenced by other functions\n\nprint(g())\n
    "},{"location":"errors/errors/#e0002-__init__-doesnt-have-a-first-parameter-named-self","title":"E0002: __init__ doesn't have a first parameter named self","text":"
    class C:\n    def __init__(a): pass # E0002\n
    "},{"location":"errors/errors/#e0003-__init__-as-a-member-variable","title":"E0003: __init__ as a member variable","text":"
    class C:\n    __init__ = 1 # E0003\n
    "},{"location":"errors/warns/","title":"Pylyzer-specific warnings","text":""},{"location":"errors/warns/#w0188-used-value","title":"W0188: Used value","text":"
    def f(x): return x\n\nf(1) # W0188: UnusedWarning: the evaluation result of the expression (: {1, }) is not used\n
    "},{"location":"options/options/","title":"command line options","text":""},{"location":"options/options/#-server","title":"--server","text":"

    Launch as a language server.

    "},{"location":"options/options/#-dump-decl","title":"--dump-decl","text":"

    Dump a type declarations file (d.er) after type checking.

    $ pylyzer --dump-decl test.py\nStart checking: test.py\nAll checks OK: test.py\n\n$ ls\ntest.py  test.d.er\n
    "},{"location":"options/options/#-c-code","title":"-c/--code","text":"

    Check code from the command line.

    $ pylyzer -c \"print('hello world')\"\nStart checking: string\nAll checks OK: string\n
    "},{"location":"options/options/#-disable","title":"--disable","text":"

    Disable a default LSP feature. Default (disableable) features are:

    • codeAction
    • codeLens
    • completion
    • diagnostics
    • findReferences
    • gotoDefinition
    • hover
    • inlayHint
    • rename
    • semanticTokens
    • signatureHelp
    "},{"location":"options/pyproject/","title":"pyproject.toml options","text":""},{"location":"options/pyproject/#toolpylyzerpythonpath","title":"tool.pylyzer.python.path","text":"

    Path to the Python interpreter to use. If not set, the default Python interpreter will be used.

    [tool.pylyzer.python]\npath = \"path/to/python\"\n
    "}]} \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index 88f1e59..4a1d990 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,32 +2,32 @@ https://mtshiba.github.io/pylyzer/ - 2024-09-02 + 2024-10-05 daily https://mtshiba.github.io/pylyzer/editor/ - 2024-09-02 + 2024-10-05 daily https://mtshiba.github.io/pylyzer/errors/errors/ - 2024-09-02 + 2024-10-05 daily https://mtshiba.github.io/pylyzer/errors/warns/ - 2024-09-02 + 2024-10-05 daily https://mtshiba.github.io/pylyzer/options/options/ - 2024-09-02 + 2024-10-05 daily https://mtshiba.github.io/pylyzer/options/pyproject/ - 2024-09-02 + 2024-10-05 daily \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index d3f301fbfb571bf4d4e89849577ca6fc27c7b7fd..ada685926721c5e60f42702be4452fffb77ae1ba 100644 GIT binary patch literal 257 zcmV+c0sj6UiwFqt0svbj>dPSVKhN|oH%eCF%(^)?{)pF^lVY(@{UWn12`%0>g7kA2HtU!Lm+ zwpSZ@$^k7^B^+J{Ms zg>&H%H=y64+0GNJn=og{_#^8F9d(YY=7dD$k>E}L0cx63hIeb|?_tkU{s{FAMIu}f HQv?72mZ*F4 literal 256 zcmV+b0ssCViwFpCfz)OK|8r?{Wo=<_E_iKh0M(R1Zo?oDMfW*{#oi3Hx@am)c0ECR z0D`HZvVk&_y6)+VlQiy`kF=>W2YL?+}C1Xi>5@b-YRCC4!wQN_FZ+_53_`o zbK!v-(C^S}=P7QRFz1-@N45_-=^QrA855O9f;asKsA*0)zF9+m4||sKN2qV9