「PythonのHELP」の版間の差分
(→pydoc.py を使う方法) |
|||
4行: | 4行: | ||
pythonには ヘルプを見るためのいくつかの方法が提供されています。 | pythonには ヘルプを見るためのいくつかの方法が提供されています。 | ||
− | ここでは help関数を使う方法と、pydoc | + | ここでは help関数を使う方法と、pydoc.py というちょっとおの白いツールの使い方を紹介します。 |
==help関数を使う方法== | ==help関数を使う方法== | ||
14行: | 14行: | ||
>>> help(<<キーワード>>) | >>> help(<<キーワード>>) | ||
− | + | とすればキーワードに関するヘルプを見ることができます。但し、見たいキーワードを | |
− | + | 含んでいるモジュールを import で読み込んでいないとヘルプを見ることができません。 | |
例えば tkinter のヘルプを表示するには | 例えば tkinter のヘルプを表示するには | ||
38行: | 38行: | ||
ここにはいろいろ面白い python のプログラムが入っています。 | ここにはいろいろ面白い python のプログラムが入っています。 | ||
− | pydoc.py | + | pydoc.py もその一つで、最も簡単な使い方は help関数と同じです。コマンドプロンプトで |
pydoc.py <<キーワード>> | pydoc.py <<キーワード>> | ||
− | + | とすれば、具体的には | |
pydoc.py tkinter | pydoc.py tkinter | ||
と打てば、tkinterモジュールのヘルプが表示されます。 | と打てば、tkinterモジュールのヘルプが表示されます。 | ||
+ | |||
+ | ここまでは平凡ですが、面白いのはここからです。 | ||
+ | |||
pydoc.py -w tkinter | pydoc.py -w tkinter | ||
と打てば、カレントディレクトリの tkinter モジュールの HTML で書かれたヘルプ tkinter.html が作られます。 | と打てば、カレントディレクトリの tkinter モジュールの HTML で書かれたヘルプ tkinter.html が作られます。 | ||
+ | ただのテキストファイルよりだいぶ読みやすいです。 | ||
さらにもっと面白いのは | さらにもっと面白いのは |
2018年8月14日 (火) 02:23時点における版
メインページ>コンピュータの部屋#Python>Python Tips
pythonには ヘルプを見るためのいくつかの方法が提供されています。
ここでは help関数を使う方法と、pydoc.py というちょっとおの白いツールの使い方を紹介します。
help関数を使う方法
help関数は、通常 python の インタープリターの中で ヘルプ を見るのに使います。
インタープリターのプロンプト >>> で
>>> help(<<キーワード>>)
とすればキーワードに関するヘルプを見ることができます。但し、見たいキーワードを 含んでいるモジュールを import で読み込んでいないとヘルプを見ることができません。
例えば tkinter のヘルプを表示するには
>>> import tkinter
として
>>> help(tkinter)
や
>>> help(tkinter.Wm)
などと表示します。
help関数は モジュールのソースの docstring を表示するようです。tkinter のようにライブラリリファレンスにまともに情報が載っていないモジュールでは貴重な情報源と言えます。
pydoc.py を使う方法
もし今あなたが コマンドプロンプトやシェルのパスに <<pythonをインストールしたフォルダ/Lib>> を含めていないなら是非含めておきましょう。 ここにはいろいろ面白い python のプログラムが入っています。
pydoc.py もその一つで、最も簡単な使い方は help関数と同じです。コマンドプロンプトで
pydoc.py <<キーワード>>
とすれば、具体的には
pydoc.py tkinter
と打てば、tkinterモジュールのヘルプが表示されます。
ここまでは平凡ですが、面白いのはここからです。
pydoc.py -w tkinter
と打てば、カレントディレクトリの tkinter モジュールの HTML で書かれたヘルプ tkinter.html が作られます。 ただのテキストファイルよりだいぶ読みやすいです。
さらにもっと面白いのは
pydoc.py -b
です。コンソールには
Server ready at http://localhost:59321/ Server commands: [b]rowser, [q]uit server>
と表示されて httpサーバーが起動し、自動的にブラウザが起動して、全モジュールのヘルプが表示されます。
英語に問題がない方であれば、これで pythonのモジュールをブラウザしてみるのも面白いでしょう。