1
3

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

【Django】プロジェクト構成を「設定」「ユーザ管理」「アプリケーション」の3つに分ける

Last updated at Posted at 2021-11-08

#はじめに
Djangoプロジェクトの構成を綺麗にするために,多くの方がベストプラクティスを考え公開しています.私も自身が所属する研究室内でプロジェクトの引き継ぎを行う必要があるので,「何がどこで動いているか」をわかりやすくできないか日々模索しています...
今回の記事では私なりに考えて,良いかもと感じたDjangoプロジェクトの構成を紹介・提案します.

#結論
Djangoプロジェクトの構成を**「設定」「ユーザ管理」「その他のアプリケーション」の3つに分けます.**これによって管理がしやすくなると思います.
「設定」のディレクトリ名が_configとなっているのは特殊ですが,このディレクトリ名のおかげで設定ディレクトリが常に一番上に表示されて探す手間が省けます.(あくまで私の1アイデアであり,一般的な名前の付け方ではありません)

.
├── _config  # 設定
├── account   # ユーザ管理
└── apps     # その他アプリケーション群
    ├── app1
    ├── app2
    └── app3

#実装手順
この記事のプロジェクト構成を取り入れようと考えてくださる方に向けて実装手順を記載致します.

##環境
macOS Catalina 10.15.7
Python: 3.8.5
Django: 3.2.8

##1.設定ディレクトリ「_config」を作成する
この手順は,Djangoプロジェクトの開発状況によって変わりますので,それぞれについて手順を示します.
###初めからDjangoのプロジェクトを開発する場合

$ mkdir <projectName>
$ cd <projectName>
$ django-admin.py startproject _config .

###開発中のDjangoプロジェクトに反映する場合

プロジェクト構成
.
└── <settingDirName> → _config # ディレクトリ名を変更
./manage.py
- os.environ.setdefault('DJANGO_SETTINGS_MODULE', '<settingDirName>.settings')
+ os.environ.setdefault('DJANGO_SETTINGS_MODULE', '_config.settings')
./_config/settings.py
- ROOT_URLCONF = '<settingDirName>.urls'
+ ROOT_URLCONF = '_config.urls'
- WSGI_APPLICATION = '<settingDirName>.wsgi.application'
+ WSGI_APPLICATION = '_config.wsgi.application'
./config/asgi.py
- os.environ.setdefault('DJANGO_SETTINGS_MODULE', '<settingDirName>.settings')
+ os.environ.setdefault('DJANGO_SETTINGS_MODULE', '_config.settings')
./config/wsgi.py
- os.environ.setdefault('DJANGO_SETTINGS_MODULE', '<settingDirName>.settings')
+ os.environ.setdefault('DJANGO_SETTINGS_MODULE', '_config.settings')

##2.ユーザ管理ディレクトリ「account」を作成する
今回の記事ではあくまで**「プロジェクト構成の実装方法」のみ**を示しています.
ユーザ管理ディレクトリを作成したのち,カスタムユーザを作りたい方はこちらの記事がわかりやすいので,ご覧下さい.(むしろ,プロジェクト構成だけ作ってもあまり意味ないので上記の記事を参考にしっかりカスタムユーザを作成することを推奨します.)

$ mkdir account
$ python manage.py startapp account
./_config/settings.py
INSTALLED_APPS = [
    ...
+   'account.apps.AccountConfig',
    ...
]

+ AUTH_USER_MODEL = 'account.User'

##3.「apps」ディレクトリ内にアプリケーションを作成する
ここでは「apps」ディレクトリ内に「example」アプリケーションを作成する例を示します.
まず,exampleディレクトリを作成してから,startappコマンドを実行しましょう.
ここで,startappコマンドに注意が必要です.通常ではpython manage.py startapp <アプリケーション名>が一般的に使われているコマンドだと思いますが,Djangoプロジェクトのルート直下より深いディレクトリ内にアプリケーションを作成する場合は下記のようなコマンドを実行します.

$ mkdir apps
$ mkdir apps/example
$ python manage.py startapp example apps/example

次に,アプリケーションの登録を行えば完了です.

./example/apps.py
from django.apps import AppConfig

class ExampleConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'apps.example' #先頭にapps(アプリケーション群が入ったディレクトリの名前)をつける
./_config/settings.py
INSTALLED_APPS = [
    ...
+   'apps.example.apps.ExampleConfig',
    ...
]

##実装結果
上記の手順で,このようなDjangoプロジェクト構成ができました.

.
├── _config  # 設定
├── account   # ユーザ管理
└── apps     # その他アプリケーション群
    └── example # 今回作成したアプリケーション

#まとめ
今回の記事では,私なりのDjangoプロジェクトの構成を紹介・提案しました.私の提案の応用としてappsディレクトリ内でさらにアプリケーションを分類したディレクトリを作成することも考えられますね.(あまりプロジェクトが深くなりすぎると逆にわかりにくくなるのでいい塩梅にする必要がありますが..)
Djangoプロジェクトのベストプラクティスは,この記事の主題である「プロジェクト構成」だけでなくView,Model,Templateなど様々なところで発揮されることで「誰でもわかりやすく,引き継ぎもしやすい」ものにできると思います.
みなさんも是非,ご自身が開発・実装をされる中で「このやりかた便利かも!」と感じたものを共有してください.(私が興味ありますのでw)
今回の記事は以上です.ありがとうございました!

※ご意見や疑問点などお待ちしております!

#参考
【Django】設定ディレクトリをわかりやすく・みつけやすく
Djangoではカスタムユーザを作るべきらしい
【Django】ディレクトリ構成のプラクティス + 注意点
INSTALLED_APPSにAppConfigのサブクラスを設定してみた

1
3
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
3

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?