2011-11-16 3 views
1

Pythonの公式ドキュメントよりも優れたリファレンスマニュアルがありますか?私は経験豊富なプログラマー(PHP、C#、javascript、そして最近のC)ですが、PHPマニュアルとMSDNを比較するとPythonのマニュアルがかなり不足しています。特に、公式の文書は、私が何か無効なものを渡すとどのようなエラーが発生する可能性があり、モジュール内をナビゲートする方法はないようです。Pythonのリファレンスマニュアル?

は、例えばthe os moduleしてください。私はそのページで呼び出すことができる定数やメソッドのリストがないので、私はそれを見つけるまでCtrl + fを "stat("にしなければなりません。それで見つけたら、存在しないディレクトリをstatと呼ぶと何を期待するのかわからないので、ターミナルで試してみるだけで何が起こるのか見てみる必要があります。

これは乱暴に非効率です...どのようにPythonプログラマは、これに対処するのですか?実際に

+1

:かなりPHPに比べて欠けO!それはあなたが確かにフィードをスプーンしませんが欠けているとは思わないでしょう。あなたが持っているstat問題については、エラーハンドラを作成します。 –

+0

すべての言語の疣贅について、PHPマニュアルはかなり素晴らしいです。人々がPHPについて嫌うもののリストでさえ、マニュアルは通常賞賛されます。エラーハンドラとは何ですか? – notJim

+0

エラーハンドラ:http://docs.python.org/tutorial/errors.html(ドキュメントにあなたを連れて来るのではなく、基本的な考え方を伝えるのは嫌です)。 –

答えて

3

、あなたは簡単なテストプログラムが動作を確認するために作る、あるいはソースコードを読むのいずれか。 Pythonの標準ライブラリのコードの多くは、はっきりと書かれていて、実際には文書化されているわけではありません。そのため、何かがうまくいくかどうかを知る必要があるときに参照するのが標準的な方法です。

例外:1つの例外:osモジュールの多くの低レベルシステム関数では、関数は基盤となるプラットフォームのCの名前に直接マッピングされます。したがって、Pythonのstatの動作について知る必要がある場合は、ご使​​用のプラットフォームのネイティブC statコールの参照ドキュメントを参照してください。これらのケースでは、Pythonライブラリのドキュメントは、関数の基本的な目的と、それがC言語の同等物とどう違うかについてのみ説明しています。

+0

うわー、面白いです。あなたが依存している慣習はありますか?たとえば、PHPでは、通常、関数は(関数の型に応じて)falseまたはnullを返します。したがって、これらの2つをチェックするのはかなり安全です。それはPythonがより例外的だと思われる? – notJim

+0

関数が失敗したかどうかを判断するための規則はありますか?うん、Python関数は、何かがうまくいかないときに例外を発生させます。例えば、 'os'ドキュメントページの始めに' OSError'に関する注意を書いてください。おそらく、そのガイドラインには例外がありますが(意図されていない)、ドキュメントに記述されています。 –

+0

ああ、私はそのメモを逃しました、それは実際には私が探していたものより多かれ少なかれです。 – notJim

1

私はあなたがそうであるように私が今までのpythonのドキュメントへの同じ感覚を持っていたとは思わないが、私はいくつかの回は、より良いPythonの作品のどの部分を理解するために私の方法のうちのいくつかの時間を移動する必要がありました。それがほとんどの言語がどのようにしているのかです。 Pythonは、ドキュメントの時間を短縮し、プログラミング時間を短縮するためのすばやく簡単な言語です。また、PythonのユーザーベースはPHPほど大きくはありません。 PHPには、毎日特定の関数に関する例と詳細が常に提供されています。

Pythonのもう一つの素晴らしい点は、物をテストするための対話的なシェルです。あなたがプログラミングをするという私の考えは、それを見てもっと学びます。ですから、コンパイルをドラッグする必要がないものをテストすることに関心があるなら、インタプリタに簡単なスクリプトを書くだけです。通訳者にも参考ツールがあります。例モジュールの場合はdir(<identifier>)help(<identifier>)、clasaまたは関数が必要です。私の好きな言語、pyDocを守る

十分な任意の方法は、あなたがあなたのpythonから必要なものを得るのを助けるために少し便利なツールです。

pydocは、 を表示してPythonのドキュメントを生成するために使用できるPythonに付属するツールです。

関連する問題