問題タブ [pydoc]

私はLPTHからpythonを学んでいます。

read()学習ドリルの演習 15 では、pydoc を使用して何ができるかを知っているはずです。しかし、でそうしようとすると、python -m pydoc read()このようなエラーが発生します。

私は何が間違っていたのか理解できません。

私は: にも同じ方法を使用しましたraw_input,os,openが、どうやら私は何か間違ったことをしていread()ます。

pydoc の出力は、結果 (メソッドとその docstring) をアルファベット順に並べ替えます。これは良いことですが、私は新しいものの上にとどまりたいと思っています。モジュールに新しいメソッドを追加するときは、それを最初のメソッドとして追加するので、新しいメソッドを追加するたびに、それがファイルの最初のメソッドになります。

メソッドがファイルにあるのと同じ順序でpydoc出力を表示したい。

これは可能ですか？

例：

ここに私のモジュール pydoc_test.py があります:

「pydoc pydoc_test」の出力は次のとおりです。

pydoc は最初に「add_my_code」、次に「test_my_code」を表示しますが、ファイルと同じ順序が必要です。

Python はまだ非常に新しいので、これが明らかな場合はご容赦ください。ただし、argparse がスクリプトで pydoc を実行できないことがわかりました。

最後の行のコメントを外してpydoc scriptnameを実行すると、pydoc は書式設定された docstring を表示するだけでなく、何らかの方法でスクリプトを実行しようとしているように見えます ??

どこが間違っていますか？

pydoc.locateコードのブロックまたは基本的な対話型シェルから呼び出された場合、エラーは発生しません。locate存在しないモジュールが引数として指定された場合、pycharm 内から IPython コンソールを起動したときにのみエラーがスローされます。

Python コード:None出力として印刷

pycharm から IPython を実行する

ターミナルからの Python の実行

locateインポートエラーがあることを認識できるシステム変数としてpycharm IDEが設定するものはありますか?

誰かがこの動作をテストして説明できれば幸いです。

ありがとう！

I'm writing a storage automation module that provisions volumes. Instead of passing the half dozen or more arguments needed to actually create a volume on the storage controller, I created a parameter class using __slots__ that is passed into the create method like this:

上記の例は、1 つの小さな例外を除いてうまく機能します。パラメーター クラスの記述子に docstring を追加する方法は明らかではありません。メタクラスで可能であるように思われますが、メタクラスがインスタンス化されるときに記述子が定義されていません。

の副作用を使用することに同意しない人がいることを痛感して__slots__いますが、タイプミスをなくすのに役立つことは気に入っています。存在しないパラメータを設定してみると、ブーン、AttributeErrorと上がります。定型コードなしですべて。ボリュームの作成時に失敗させるのは間違いなくよりPythonicですが、その結果、スペルが間違っているパラメーターの代わりにデフォルトが使用されることになります。それは事実上、サイレントエラーになります。

パラメータ クラスの docstring を単純に拡張することは可能ですがpydoc、他のドキュメント作成スクリプトの結果は、クラスの大きな自由形式の docstringと各記述子の空の docstring になります。

確かに、によって作成された記述子のdocstringを定義する方法が必要__slots__です? おそらく、スロット以外に別の方法がありますか？可変namedtupleまたは類似？

Mac Osの公式サイトからpython 3をダウンロードしてインストールしました。セットアップでは、ドキュメントのチェックマークがありました。

このパッケージは、pydoc と IDLE に使用できる場所に python ドキュメントをインストールします。

しかし、私はそれを見つけることができません。 ドキュメントを開く方法、またはドキュメントはどこにありますか?