This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release.

# 28.15. `user` --- ユーザー設定のフック

バージョン 2.6 で非推奨: `user` モジュールは Python 3 で削除されました。

ポリシーとして、Python は起動時にユーザー毎の設定を行うコードを実行することはしません (ただし対話型セッションで環境変数 `PYTHONSTARTUP` が設定されていた場合にはそのスクリプトを実行します)。

しかしながら、プログラムやサイトによっては、プログラムが要求した時にユーザーごとの標準設定ファイルを実行できると便利なこともあります。このモジュールはそのような機構を実装しています。この機構を利用したいプログラムでは、以下の文を実行してください:

    import user

`user` モジュールはユーザーのホームディレクトリの `.pythonrc.py` ファイルを探し、オープンできるなら (`user` モジュールの) グローバル名前空間で実行します(`execfile()` を利用します)。この段階で発生したエラーは catch されません。 `user` モジュールを import したプログラムに伝播します。ホームディレクトリは環境変数 `HOME` が仮定されていますが、もし設定されていなければカレントディレクトリが使われます。

ユーザーの `.pythonrc.py` では Python のバージョンに従って異なる動作を行うために `sys.version` のテストを行うことが考えられます。

ユーザーへの警告: `.pythonrc.py` ファイルに書く内容には慎重になってください。どのプログラムが利用しているかわからない状況で、標準のモジュールや関数の振る舞いを変えることはおすすめできません。

この機構を使おうとするプログラマへの提案: あなたのパッケージ向けのオプションをユーザーが設定できるようにするシンプルな方法は、 `.pythonrc.py` ファイルで変数を定義して、あなたのプログラムでテストする方法です。たとえば、 `spam` モジュールでメッセージ出力のレベルを変える `user.spam_verbose` 変数を参照するには以下のようにします:

    import user

    verbose = bool(getattr(user, "spam_verbose", 0))

(ユーザが `spam_verbose` をファイル `.pythonrc.py` 内で定義してないことに備えて `getattr()` の3 引数形式を使っています。)

大掛かりな設定の必要があるプログラムでは、プログラム固有の設定ファイルを読む方がずっと良いです。

セキュリティやプライバシーに配慮するプログラムではこのモジュールを import しないで ください。このモジュールを使うと、ユーザーは `.pythonrc.py` に任意のコードを書くことで簡単にプログラムに侵入することができてしまいます。

汎用のモジュールではこのモジュールを import しないで ください。 import したプログラムの動作にも干渉してしまいます。

参考

`site` モジュール

  サイト毎のカスタマイズを行う機構