DjangoのBASE_DIR が何を意味しているのか知りたい

Question

settings.pyには以下のような記述があります。

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, "templates")],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

このうち、 [os.path.join(BASE_DIR, "templates")]　のBASE_DIR は何を意味しているのか知りたいです。

調べたところ、この記事に以下のような説明がありました。

1.6 の場合、settings.pyにBASE_DIRが、os.path.dirname() を利用して用意されています。

Build paths inside the project like this: os.path.join(BASE_DIR, ...)
import os
BASE_DIR = os.path.dirname(os.path.dirname(file))

これを使わない手はないですよね。

次のような定数設定に使うと、配置するディレクトリが変わるたびに書き換えの必要がなくなり楽になります。

言っている意味はわかるんですが、今度は　os.path.dirname(os.path.dirname(file))　の意味がわかりません。

公式ドキュメントも読みましたが、　os.path.dirname(os.path.dirname(file))　の意味するところが結局理解できませんでした。

どなたか、わかりやすく教えていただけないでしょうか。よろしくお願い致します。

Answer 1

djangoのstartprojectした直後の構成はこんな感じになりますよね。
BASE_DIRは端的にいえば、

.../
    mysite/ <-- ココ
        manage.py
        mysite/
            __init__.py
            settings.py <-- __file__のさす場所
            urls.py
            wsgi.py
        templates/ <-- os.path.join(BASE_DIR,  "templates")のさす場所

のパスになります。

____file____は自身のパスを表します。
ここでは'.../mysite/mysite/settings.py'となります。
os.path.dirname(path)はpathの親ディレクトリを表すパスを返します。
なので、os.path.dirname(os.path.dirname(file))は____file____の親ディレクトリの親ディレクトリのパス、すなわち'.../mysite'となります。

追記:
os.pathはpythonの標準ライブラリなので、djangoのドキュメントには詳しく書かれていないかと思います。
https://docs.python.jp/3/library/os.path.htmlを参考にしてみてください。

Comments

[mbase]

わかりやすい解説ありがとうございます！