PyCharm 2021.1 ヘルプ

ステップ 4. 最初の Django プロジェクトを作成して実行する

始める前に

次の前提条件が満たされていることを確認してください。

このチュートリアルは、次の前提で作成されています。

  • Python 3.4.1.

  • Django 1.x（Django 1.10 より後）

  • このチュートリアルで使用されている例は、Django のドキュメント(英語)で使用されている例と似ています。サンプルプロジェクトはこちら(英語)からダウンロードできます。

新しいプロジェクトを作成する

実際、新しいプロジェクトはすべて同じ方法で作成されます: ウェルカム画面のクイックスタートエリアで新規プロジェクトボタンをクリックしてください:

Welcome screen

すでに開いているプロジェクトがある場合は、メインメニューからファイル | 新規プロジェクト... を選択して新しいプロジェクトを作成します。

次に、目的のプロジェクトタイプ（ここでは Django）を選択します。プロジェクト名と場所を指定します。

Python のベストプラクティスは、各プロジェクトの virtualenv を作成することです。これを行うには、Python インタープリター: 新規 Virtualenv 環境ノードを展開し、新しい仮想環境の作成に使用するツールを選択します。Virtualenv ツールを選択し、新しい仮想環境に使用する場所とベースインタープリターを指定しましょう。必要に応じて、以下の 2 つのチェックボックスを選択します。

次に、詳細設定ノードを展開し、Django 関連の設定を指定します。アプリケーション名フィールドで、アプリケーション名を指定します（ここでは polls です）。

selecting a project type

作成をクリックします - Django プロジェクトが準備完了です。

プロジェクトの構造を探る

前述したように、基本的にはスタブプロジェクトの準備ができています。これにはフレームワーク固有のファイルとディレクトリが含まれています。Pyramid でも Google App Engine でも、サポートされている種類のプロジェクトを作成した場合も同様です。

新しいプロジェクトの構造がプロジェクトツールウィンドウでどのように見えるかを見てみましょう。

プロジェクトツールウィンドウのプロジェクトビュー

このビューはデフォルトで表示されます。Django 固有のプロジェクト構造が表示されます。polls と mysite ディレクトリ、 manage.py と settings.py ファイルも表示されます。

このビューでは、.idea ディレクトリは表示されません。

Project view

プロジェクトツールウィンドウのプロジェクトファイルビュー

何らかの理由で .idea ディレクトリの内容を表示したい場合は、ビュープロジェクトファイルを選択してください。: ご覧のとおり、このビューはプロジェクトのルートにあるため、同じディレクトリとファイルと .idea ディレクトリを表示します。

Project files

プロジェクトビューに戻りましょう。

プロジェクトビューでは何が表示されますか？

  • mysite ディレクトリはプロジェクトのコンテナーです。プロジェクトビューでは太字で表示されます。

  • manage.py : これは Django プロジェクトと対話できるコマンドラインユーティリティです。詳細は、Django のドキュメント(英語)を参照してください。

  • ネストされたディレクトリ mysite は、プロジェクトの実際の Python パッケージです。

  • mysite/__init__.py : この空のファイルは Python に、このディレクトリを Python パッケージとみなすべきであることを伝えます。

  • mysite/settings.py : このファイルには、Django プロジェクトの構成(英語)が含まれています。

  • mysite/urls.py : このファイルには Django プロジェクトの URL 宣言(英語)が含まれています。

  • mysite/wsgi.py : このファイルは、プロジェクトに対応する WSGI 互換 Web サーバーのエントリポイントを定義します。詳細は WSGI を使用してデプロイする方法(英語)を参照してください。

  • ネストされたディレクトリ polls には、Django アプリケーションの開発に必要なすべてのファイルが含まれています（この時点では、これらのファイルは空です）。

    • 繰り返しますが、polls/_init_.py は、このディレクトリを Python パッケージと見なす必要があることを Python に通知します。

    • polls/models.py : このファイルでは、アプリケーションのモデルを作成します。

    • polls/views.py : このファイルでは、ビューを作成します。

  • templates ディレクトリは現在空です。テンプレートファイルが含まれている必要があります。

  • ネストされたディレクトリ migrations には、現在はパッケージファイル _init_.py のみが含まれていますが、将来、モデルに加えた変更（フィールドの追加、モデルの削除など）をデータベーススキーマに伝達するために使用されます。ここで移行の説明を読んでください(英語)。

Django アプリケーションは必要に応じていくつでも作成できます。アプリケーションをプロジェクトに追加するには、manage.py ユーティリティの startapp タスクを実行します（ツール | manage.py タスクの実行、次にコンソールに startapp と入力します）。

データベースの設定

次に、プロジェクトスタブの準備ができたら、微調整を行います。 settings.py を編集するために開きます。それを行うには、プロジェクトツールウィンドウでファイルを選択し、F4 を押します。ファイルがエディターの独自のタブで開きます。

アプリケーションで使用する予定のデータベースを指定します。この目的のために、DATABASES 変数を見つけます: Ctrl+F をクリックして、検索フィールドに探している文字列を型してください。次に、'ENGINE' の行で、ドットの後にデータベース管理システムの名前を追加します。(コメントの後に指定したものはどれでも使用できますが、最初は sqlite3 から始めます。)

'NAME' 行には、まだ存在しない場合でも、目的のデータベースの名前を入力します。

Define database

Django サーバーの起動

sqlite3 を選択したため、他の値（ユーザー資格情報、ポート、ホスト）を定義する必要はありません。設定が正しいかどうかを確認しましょう。これは非常に簡単に行うことができます。manage.py ユーティリティの runserver タスクを起動するだけです: Ctrl+Alt+R を押して、manage.py コンソールにタスク名を入力します。

Running manage.py in the console

推奨リンクをたどり、次のページを参照してください:

Preview the page

モデルの作成

次に、ファイル models.py を編集するために開いて、import 文がすでにそこにあることに注意してください。次に下記のコードを入力します。

from django.db import models # the following lines added: import datetime from django.utils import timezone class Question(models.Model): question_text = models.CharField(max_length=200) pub_date = models.DateTimeField('date published') def __str__(self): return self.question_text def was_published_recently(self): now = timezone.now() return now - datetime.timedelta(days=1) <= self.pub_date <= now was_published_recently.admin_order_field = 'pub_date' was_published_recently.boolean = True was_published_recently.short_description = 'Published recently?' class Choice(models.Model): question = models.ForeignKey(Question, on_delete=models.DO_NOTHING,) choice_text = models.CharField(max_length=200) votes = models.IntegerField(default=0) def __str__(self): return self.choice_text

実際には、コピーペーストが可能ですが、タイピングがお勧めです。これは、PyCharm のコード補完が実際に動作していることを確認できます。

Using code competion

データベースの作成

新しいモデル用のテーブルを作成する必要があります。この目的のために、manage.py コンソールを呼び出すためにマジック Ctrl+Alt+R ショートカットを使います。最初に実行するコマンドは makemigrations polls です。

executing makemigrations

Django に 2 つの新しいモデル、Choice と Question が作成され、マイグレーションが作成されたことを通知しました。

migration

次に、プロンプトの後に以下のコマンドを入力します。

sqlmigrate polls 0001
executing sqlmigrate pools 0001

最後に、migrate コマンドを実行して、実際にデータベースにこれらのテーブルを作成します。

creating tables in the database

管理機能の実行

まず、スーパーユーザーを作成してください。これを行うには、manage.py コンソールで createsuperuser コマンドを入力し、自分のメールアドレスとパスワードを指定します。

creating a superuser

サイト管理を有効にすることにしたため、PyCharm はすでにファイル urls.py の対応する行のコメントを外しています。

編集のために polls ディレクトリの admin.py ファイルを開き、すでに存在する次のコードを参照してください:

from django.contrib import admin

ただし、管理サイトの編集機能を有効にする必要があります。

実行 / デバッグ構成の準備

これで管理者ページに移動する準備が整いました。Django サーバーを実行し、ブラウザーにアクセスし、アドレスバーに URL 全体を入力することは可能ですが、PyCharm を使用すると簡単な方法があります。あらかじめ設定された Django サーバーの実行構成を少し変更して使用します。

この実行 / デバッグ構成を編集用に開くには、メインツールバーで実行 / デバッグ構成セレクターをクリックしてから、実行構成の編集を選択します（またはメインメニューから実行 | 実行構成の編集を選択します）。

Editing Run/Debug configuration

実行 / デバッグ構成ダイアログで、この実行 / デバッグ構成に名前（ここでは mysite ）を付け、デフォルトブラウザーでアプリケーションの実行を有効にし（チェックボックスブラウザーの実行を選択）、デフォルトで開くサイトのページを指定します（ここではこのページです）。 http://127.0.0.1:8000/admin/）:

setting the default web page

管理サイトの起動

アプリケーションを起動するには、Shift+F10 を押すか、メインツールバーの run をクリックして、標準の Django サイトログインページを開きます。

login page

ログインすると、管理ページが表示されます。認証と認可 (グループとユーザー) セクションがありますが、投票は使用できません。なぜそうなるのでしょうか？

Question オブジェクトには管理インターフェースがあることを管理者に伝える必要があります。そのためには、ファイル polls/admin.py を編集用に開き（プロジェクトビューで選択して F4 を押します）、次のコードを入力します。

from django.contrib import admin from .models import Question #this line added admin.site.register(Question)#this line added

もう一度コード補完に注意してください:

code completion

ページをリフレッシュし、質問が表示された投票セクションが表示されていることを確認します。

site administration page

いくつかの質問を作成するには、追加をクリックします。

admin.py の編集

しかし、それぞれの質問にはいくつかの選択肢がありますが、選択肢はまだありません。再度、ファイル polls/admin.py を編集するために開き、次のように変更します。

from django.contrib import admin from .models import Choice, Question class ChoiceInline(admin.TabularInline): model = Choice extra = 3 class QuestionAdmin(admin.ModelAdmin): fieldsets = [ (None, {'fields': ['question_text']}), ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}), ] inlines = [ChoiceInline] admin.site.register(Question, QuestionAdmin)

今すぐ質問を変更するページを見てください:

Change question page

ビューの作成

polls/views.py ファイルを編集用に開き、次の Python コードを入力します。

from django.http import HttpResponse def index(request): return HttpResponse("Hello, world. You're at the polls index.")

次に、urls.py という名前の新しいファイルを polls ディレクトリに追加し、次のコードを入力します。

from django.conf.urls import url from . import views urlpatterns = [ url(r'^$', views.index, name='index'), ]

次に、ファイル mysite/urls.py（PyCharm がすでに作成している）を編集し、インデックスページの URL を追加します。次のコードで終わるべきです:

from django.conf.urls import include, url from django.contrib import admin urlpatterns = [ url(r'^polls/', include('polls.urls')), #this line added url(r'^admin/', admin.site.urls), ]

ページ 127.0.0.1:8000/polls/ を開いて楽しみましょう:

start page

次に、より多くのビューを追加しましょう。再度、polls/views.py ファイルに次のコードを追加します。

def detail(request, question_id): return HttpResponse("You're looking at question %s." % question_id) def results(request, question_id): response = "You're looking at the results of question %s." return HttpResponse(response % question_id) def vote(request, question_id): return HttpResponse("You're voting on question %s." % question_id)

次の url() 呼び出しを追加して、これらの新しいビューを polls.urls モジュールに配線します。

from django.conf.urls import url from . import views urlpatterns = [ url(r'^$', views.index, name='index'), # ex: /polls/5/ url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'), # ex: /polls/5/results/ url(r'^(?P<question_id>[0-9]+)/results/$', views.results, name='results'), # ex: /polls/5/vote/ url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'), ]

ブラウザーで対応するページを開くと、次のように表示されます。

application pages

Django テンプレートの作成

ご覧のとおり、これらのページのデザインはビューにハードコードされています。読みやすくするために、対応する Python コードを編集する必要があります。次に、Python からの出力の視覚的表現を分離しましょう。そうするために、テンプレートを作成しましょう。

ファイル polls/views.py を編集するために開き、その内容を次のコードに置き換えます。

from django.http import HttpResponse, HttpResponseRedirect from django.shortcuts import get_object_or_404, render from django.urls import reverse from .models import Question, Choice def index(request): latest_question_list = Question.objects.order_by('-pub_date')[:5] context = {'latest_question_list': latest_question_list} return render(request, 'polls/index.html', context) def detail(request, question_id): question = get_object_or_404(Question, pk=question_id) return render(request, 'polls/detail.html', {'question': question}) def results(request, question_id): question = get_object_or_404(Question, pk=question_id) return render(request, 'polls/results.html', {'question': question}) def vote(request, question_id): question = get_object_or_404(Question, pk=question_id) try: selected_choice = question.choice_set.get(pk=request.POST['choice']) except (KeyError, Choice.DoesNotExist): return render(request, 'polls/detail.html', { 'question': question, 'error_message': "You didn't select a choice.", }) else: selected_choice.votes += 1 selected_choice.save() return HttpResponseRedirect(reverse('polls:results', args=(question.id,)))

インポートステートメントの作成に役立つインポートアシスタントに注意してください。

最初に気付くのは、index.html ページへの未解決の参照です。

view.py code

PyCharm はクイックフィックスを提案します: バルブをクリックするか Alt+Enter を押すと、対応するテンプレートファイルが templates フォルダーに作成されます（PyCharm はこのテンプレートが存在するはずのディレクトリ polls も作成します）。

creating a template

これまでのところ、ファイル index.html は空です。次のコードを追加します。

{% load staticfiles %} <link rel="stylesheet" type="text/css" href="{% static 'polls/style.css' %}" /> {% if latest_question_list %} <ul> {% for question in latest_question_list %} <li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li> {% endfor %} </ul> {% else %} <p>No polls are available.</p> {% endif %}

テンプレートファイルのコード補完に注意してください。例: 開始 {% を入力すると、PyCharm は対応する終了 %} を自動的に追加し、将来の入力位置にキャレットを配置します。HTML タグでは、コード補完も使用できます。

ファイル views.py および index.html のそれぞれのガターに表示されるアイコン html type および python type に注意してください。

viewing html and python code

これらのアイコンを使用すると、ビューメソッドとそのテンプレート間をすぐに移動できます。この種のナビゲーションの詳細については、テンプレートとビュー間を移動するおよびパート 6. Django 固有のナビゲーションの記事を参照してください。

スタイルシートの使用

ビューファイル index.html を見ると分かるように、スタイルシートへの参照があり、未解決です。

この参照を次のように解決します。

  1. ディレクトリを作成します。これを行うには、プロジェクトビューで、Python パッケージ polls を選択し、Alt+Insert を押します。

    表示されるポップアップメニューでディレクトリを選択し、ディレクトリ構造 static/polls の名前を指定します。

  2. 次に、このディレクトリにスタイルシートを作成します。これを行うには、最も内側のディレクトリ polls を選択し、Alt+Insert を押し、オプションスタイルシートを選択して、表示されるダイアログで style を入力します。

  3. 好みに応じて、作成されたスタイルシートにいくつかのコンテンツを提供します。例: 緑色の質問の箇条書きリストが表示されます。

    li a { color: green; }

完成 !

次に、利用可能な投票のリストを確認しましょう。私たちの管理サイトはすでに稼働しています。投票のリスト（インデックスページ）を含むページにアクセスする最も簡単な方法は URL を指定することです: /admin/ の代わりにブラウザーのアドレスバーに /polls/ と入力してください:

polls

テスト…

PyCharm がアプリケーションのテストを簡素化する方法を見てみましょう。

polls ディレクトリにはすでに tests.py ファイルがあります。今は、このファイルは空です。もちろん、この特定のファイルに新しいテストを配置することをお勧めします。例: 投票が空でないことを確認します。

import datetime from django.urls import reverse from django.test import TestCase from django.utils import timezone from .models import Question def create_question(question_text, days): time = timezone.now() + datetime.timedelta(days=days) return Question.objects.create(question_text=question_text, pub_date=time) class QuestionViewTests(TestCase): def test_index_view_with_no_questions(self): """ If no questions exist, an appropriate message should be displayed. """ response = self.client.get(reverse('index')) self.assertEqual(response.status_code, 200) self.assertContains(response, "No polls are available.") self.assertQuerysetEqual(response.context['latest_question_list'], [])

このテストを実行するには、エディターでファイル tests.py の背景を右クリックするか、オプション実行を選択するか、または Ctrl+Shift+F10 を押します。PyCharm は、UnitTest（デフォルトのテストランナーとして定義されている）を実行するか、Django テストを実行するかの 2 つのオプションを提案します。

テスト結果は、実行ツールウィンドウのテストランナータブに表示されます。

running tests

要約

この簡単なチュートリアルは終了しました。簡単に Django アプリケーションを作成して起動しました。PyCharm の助けを借りて何をしてきたのかを繰り返しましょう。

  • Django プロジェクトとアプリケーションが作成されました

  • Django サーバーが開始

  • データベースが構成されている

  • 作成されたモデル、ビュー、テンプレート

  • アプリケーションが起動しました

  • 作成、実行されたテスト

ステップ 3. 最初の Python アプリケーションをテストする ユーザー補助機能

関連ページ：

パッケージのインストール、アンインストール、アップグレード | PyCharm

PyCharm は、特定の Python インタープリターの Python パッケージをインストール、アンインストール、アップグレードする方法を提供します。デフォルトでは、PyCharm は pip を使用してプロジェクトパッケージを管理します。Conda 環境では、conda パッケージマネージャーを使用できます。PyCharm では、Python パッケージツールウィンドウおよび Python インタープリター設定 / 環境設定でパッケージをプレビューおよび管理できます。Python パッケ...

ウェルカム画面 | PyCharm

PyCharm は、プロジェクトが開かれていないときにウェルカム画面を表示します。例: PyCharm を初めて実行するとき、またはプロジェクトの唯一の開いているインスタンスを閉じるとき。この画面から、新しいプロジェクトを作成したり、PyCharm Edu でパスの学習を開始したり、インポートしたり、開いたり、バージョン管理から既存のプロジェクトをチェックアウトしたりできます。カスタマイズタブを使用して作業環境を構成し、プラグインタブを使用して IDE プラグインを管理します。PyCharm を学ぶ...

プロジェクトツールウィンドウ | PyCharm

プロジェクトツールウィンドウでは、様々な視点からプロジェクトを見て、新しいアイテム（ディレクトリ、ファイル、クラスなど）の作成、エディターでのファイルのオープン、必要なコードフラグメントへのナビゲートなど、様々なタスクを実行することができます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。また、ビューには、作成されたスクラッチファイル、データベースコンソール、および拡張スクリプトを管理できるスクラッチ...

実行 / デバッグ構成: Django サーバー | PyCharm

このダイアログを使用して、Django サーバーの実行 / デバッグ構成を作成します。：ホストこのテキストボックスに、使用するホスト名を指定します。ポートこのテキストボックスに、サーバーを起動するポート番号を指定します。追加オプションこのテキストボックスで、django-admin.py ユーティリティのオプションを指定します。詳細については、django-admin.py および manage.py のドキュメントを参照してください。ブラウザーの実行 Django アプリケーションをデフォルトのブラウザー...

インテンションアクション | PyCharm

エディターで作業するときに、PyCharm はコードを分析し、コードを最適化する方法を検索し、潜在的な問題と実際の問題を検出します。IDE がコードを変更する方法を見つけるとすぐに、エディターの現在の行の横に黄色いバルブアイコンが表示されます。このアイコンをクリックすると、このコード単位で使用可能なインテンションアクションを表示できます。インテンションアクションは、警告から最適化の提案まで、幅広い状況をカバーします。インテンションの完全なリストを表示し、設定 / 環境設定ダイアログでカスタマイ...

コード補完 | PyCharm

このセクションでは、コーディングプロセスのスピードアップを可能にするコンテキスト対応コード補完のさまざまなテクニックについて説明します。基本補完：基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を完成させるのに役立ちます。コード補完を呼び出すと、PyCharm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します（提案にはライブテンプレートも含まれます）。基本コード補完がフィールド、パラメーター、または変数宣言の一部に適用されている場合、PyCha...