pyzrunの組み込みオブジェクトや組み込みクラスについてのエラー

Question

前提・実現したいこと

プログラミング初心者です
pygame zeroを利用して簡単なゲームを作りたいと思っています。

pygame zeroがインストールでき、早速簡単なコードを書こうと思っていたのですが、下記のような警告メッセージが出ました。実行自体は問題なくできているのですが、できれば消したいと思っています。

発生している問題・エラーメッセージ

"Actor" is not defined
"screen" is not defined

該当のソースコード

import pgzrun

WIDTH = 200
HEIGHT = 200
card = Actor('card', center=(100,100))

def draw():
    screen.clear()
    card.draw()

def update():
    card.x += 1

pgzrun.go()

試したこと

特になし
動くことには動いているので、何をすればいいのか分からないです。　

補足情報（FW/ツールのバージョンなど）

環境
macOS Big Sur ver11.4
python 3.9.0でVScodeを使用しています。pygame zeroのバージョンは1.2.1です。

Answer 1

"Actor", "screen" は、pgzrun の組み込みクラス・オブジェクトで、
エディタの静的コードチェックが警告を出してるのだと思います。

組み込みのクラス・関数については、pgzero.builtins から import する事ができます。

from pgzero.builtins import Actor

---

screen は特殊なケースで、
pgzrun.go() 実行後に生成される為、事前に import する事はできません。

場所は、pgzero.screen 内のグローバル変数 screen として定義されてますが、
ファイルの先頭を実行してる時点では import しても None になります。

回避策としては、組み込み変数の警告をオフにする方法
特定の変数のみ警告を除外するように設定できます。

pgzero flake8 and other linters complain about custom pgzero built-ins #61

コメントにpyflakes での設定例が載ってます。

• 具体的な方法、VScode での設定方法は別途調べて下さい。
• ソースコードの静的検査は複数あるので、ツール毎に設定方法は異なります。

以下の名前を警告を出さないように設定します。
Actor,Rect,ZRect,animate,clock,exit,images,keyboard,keymods,keys,mouse,music,screen,sounds,storage,tone

デメリットとしては、多分(未検証です）、
これらのオブジェクトではメソッドの補完等のサポートが効かなくなります。
（組込オブジェクトは、実行時に追加される為、実行前のソース解析では把握できない）

明示的に import する方法が推奨ですが、screen の扱いのみが課題。
上記リンク 開発サイトで報告されてますが、現時点では Open なので未解決の問題です。

Comments

[nite]

回答ありがとうございます。
Actorクラスに関しては教えていただいたコードを入力することで解消できました。
screenは少し特殊なんですね、とても勉強になりました。
とりあえず現時点では必要になったクラスなどをbulidinからimportして作業を進めていきたいと思います。