Pylance使用時、構文チェックでエラーとなる原因について

Question

Pylance使用時、構文チェックでエラーとなる原因について

環境

• 開発環境：VScode
• 開発サーバ：Raspbian GNU/Linux 10 (buster)
• 開発言語：Python 3.7.9

希望回答事項

• 構文エラーの原因と回避方法
• 関数アノテーションを作成する際の型調査方法

質問事項

PythonからPostgreSQLへ接続するプログラムを勉強中となります。
VSCodeを使用して実装しており、Pylanceという拡張機能を使用したところ
DB接続関数のアノテーションを記載したところで構文エラーが出力されてしまいました。
※psycopg2.extensions.connectionの「extensions」にてエラーが出力されます。

なぜ構文エラーが出力されてしまうのか、その原因と回避策についてご教示いただけないでしょうか。
また、アノテーション記述する際、呼び出し元にて「type()」を使用して型名を調べてから記載するようにしているのですが
他に良い方法がございましたら、合わせてご教示いただけると幸いです。

該当コード

import psycopg2

class Pgdb:
    __URL = ('host=***.***.***.*** port=5432 dbname=postgres user=admin password=************')

    def connect(self) -> psycopg2.extensions.connection:
        conn = psycopg2.connect(Pgdb.__URL)
        return conn

main.py

def main():
    db = postgresql.Pgdb()
    with db.connect() as conn:
        print('main.py')

エラー内容

extensions: Unknown
"extensions" is not a known member of module Pylance(reportGeneralTypeIssues)

Comments

[meg_]

> Pylanceという拡張機能を使用したところ
拡張機能なしであれば正常に動作するのでしょうか？

[EOS]

はい。拡張機能を有効にしても無効にしても動作します。
※Pylanceは構文チェックにのみ使用しています。
アノテーションの書き方が間違っているのではないかと思い、正しい書き方をご教示いただけたらと考えております。

[退会済みユーザー]

回避策ですが、エラーが出てる行の末尾に「# type: ignore」を加えてみてはどうでしょうか。

Answer 1

Pylance 拡張機能を使用せずに動作し type() 確認したクラスを記載しているのであれば Pylance の不具合でしょうね。
ドキュメントにも存在しています。
https://www.psycopg.org/docs/extensions.html

Pylance を使うのをやめた方が良いと思います。
どうしても使いたいのであれば、回避策として文字列アノテーションを使うぐらいでしょう。

    def connect(self) -> 'psycopg2.extensions.connection':
        conn = psycopg2.connect(Pgdb.__URL)
        return conn

Comments

[EOS]

回答ありがとうございます。
教えていただいた文字列アノテーションも試してみたのですが、解消しませんでした。
構文エラーは気になるところですが、動作に支障がないことからしばらく使用を続けてみたいと思います。