Emacs untuk Python dan Puisi Menggunakan `basedpyright-langserver`

Saya amat berpuas hati dengan persediaan emacs semasa saya untuk Python, tetapi saya mendapati persediaan agak rumit. Saya akan mendokumenkan persediaan saya di sini untuk diri saya pada masa hadapan dan untuk mana-mana Pythonista lain yang mencari konfigurasi emac yang kukuh.

Mengapa basedpyright?

Sehingga ke tahap ini, saya telah menggunakan mypy --strict pada baris arahan untuk semua keperluan semakan taip saya, tetapi mypy agak perlahan walaupun untuk pangkalan kod yang sangat kecil, malah dalam mod --strict ia bukan seperti tegas mungkin. Ia juga bukan pelayan bahasa, yang saya mahukan untuk persediaan emacs saya.

basedpyright ialah garpu pyright dengan beberapa peningkatan yang sangat baik dalam kedua-dua semakan dan dalam kebolehpercayaan. Ia adalah penyemak taip yang pantas dan sangat ketat dengan beberapa keupayaan linting yang baik sebagai tambahan.

Satu-satunya kelemahan yang saya alami ialah ia tidak bermain dengan baik seperti mypy dengan pelanggan boto3-stubs untuk AWS dan ia menggunakan # pyright: abaikan komen dan bukannya standard # type: abaikan komen, tetapi Saya boleh menghadapi isu tersebut demi pengalaman semakan jenis yang ketat.

Mengkonfigurasi projek Puisi anda untuk berfungsi dengan basedpyright atau pyright

Jika anda mempunyai projek sedia ada yang menggunakan Puisi, anda pasti mahu bermain-main sedikit dengan persekitaran maya anda.

Pergi ke akar setiap projek anda dan jalankan arahan berikut:

poetry config --local virtualenvs.in-project true

Ini akan mencipta fail poetry.toml jika fail itu belum wujud dan menambah tetapan yang sepadan.

Ini, walau bagaimanapun, akan tidak sebenarnya menggerakkan persekitaran maya anda yang sedia ada. Untuk membolehkan perubahan ini berkuat kuasa, anda perlu mengalih keluar persekitaran maya sedia ada anda, yang boleh anda temui dengan menjalankan

poetry env info --path

Jangan lupa tambahkan laluan .venv ke .gitignore anda dan konfigurasi untuk sebarang alatan lain yang mungkin anda gunakan, seperti pycodestyle, atau anda akan mendapat agak huru-hara.

Seterusnya, anda harus menambah bahagian konfigurasi pada pyproject.toml anda untuk memberitahu basedpyright tempat mencari persekitaran maya anda.

[tool.pyright]
venv=".venv"
venvPath="."

Anda juga boleh melakukan ini dalam fail pyrightconfig.json jika, tidak seperti saya, anda masih belum berasa terlalu sibuk dengan fail konfigurasi untuk alatan pembangunan Python yang berbeza.

Memasang basedpyright sebagai pelayan bahasa

Satu perkara yang sangat menarik tentang basedpyright berbanding pyright ialah ia membina kebergantungan nodejs sebagai roda, jadi anda boleh yakin bahawa basedpyright harus berfungsi pada mesin anda tidak kira sama ada anda telah memasang nodejs.

Untuk pengasingan, biasanya idea yang baik untuk memasang pakej Python boleh laku menggunakan pipx dan bukannya pip. Mari teruskan dan lakukan itu .

pipx install basedpyright

Untuk pemeriksaan kewarasan, pertimbangkan untuk berlari

basedpyright --version

Memasang basedpyright juga memberi anda akses kepada arahan basedpyright-langserver, tetapi itu tidak benar-benar ditulis untuk pengguna berinteraksi, jadi jika anda menjalankanbasedpyright-langserver ataubasedpyright-langserver --version atau sesuatu, anda akan mendapat surih tindanan nodejs.

Mengkonfigurasi emac untuk menggunakan basedpyright-langserver

Saya akan menganggap anda sebagai pembaca tahu cara memasang pakej daripada MELPA dan mempunyai cara pilihan untuk melakukannya. Berikut adalah semua pakej yang anda perlukan:

• syarikat
• mod-lsp
• lsp-pyright
• lsp-ui
• mod-python

Dapatkan yang dipasang dan kemudian buka ~/.emacs anda atau ~/.emacs.d/init.el anda dan tambahkan yang berikut:

;; lsp global settings
(add-hook 'after-init-hook 'global-company-mode)
(setq lsp-auto-guess-root t)

;; python
(require 'lsp-mode)
(setq lsp-pyright-langserver-command "basedpyright")
(add-hook 'python-mode-hook (lambda () (require 'lsp-pyright) (lsp)))

Sepatutnya itu sahaja yang anda perlukan.

Petua umum untuk menyahpepijat mod lsp

Jika anda rasa anda telah menyediakan semuanya dengan betul dan anda masih menghadapi masalah mendapatkan mod lsp untuk mencari pakej yang sepatutnya tersedia dalam Puisi, satu perkara yang anda mungkin cuba ialah masuk dan memadam anda ~/.emacs.d/.lsp-session-v1. Ini akan mempunyai kesan menyebabkan mod lsp melupakan akar projek dan memaksanya mencarinya semula.

Selamat mengekod!

Saya harap ini telah memberi anda permulaan yang baik pada persekitaran pembangunan Python anda. Jika anda mempunyai sebarang soalan, saya seorang pemula dengan semua ini, dan saya mungkin tidak dapat membantu anda, tetapi saya akan mempertimbangkan permintaan gabungan jika anda mempunyai sebarang petua atau helah tambahan untuk menggunakan basedpyright dengan emacs.

Atas ialah kandungan terperinci Emacs untuk Python dan Puisi Menggunakan `basedpyright-langserver`. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!