Django – DTL – 変数展開

2022-03-09 / tau / コメントする

概要

Djangoのテンプレート内での変数展開は{{ 変数 }}と記述。

単純変数はそのまま内容が展開される
コレクションはリスト、タプル、辞書に応じた表現になる
コレクションの要素は[]ではなくドット(.)で添字やキーを指定
オブジェクトの属性やメソッドもドット(.)で指定

単純変数

単純変数の展開の例を以下に示す。まずview関数。

from django.shortcuts import render

def variable(request):
    context = {
        'var_float': 3.1415,
        'var_string': 'ABCDいろはに',
    }

    return render(request, 'dtldemo/variable.html', context)

from django.shortcuts import render

def variable(request):

context = {

'var_float': 3.1415,

'var_string': 'ABCDいろはに',

}

return render(request, 'dtldemo/variable.html', context)

テンプレートの変数展開部分。

    <p>単純変数</p>
    <ul>
      <li>実数値：{{ var_float }}</li>
      <li>文字列：{{ var_string }}</li>
    </ul>

<ul>

<li>実数値：{{ var_float }}</li>

<li>文字列：{{ var_string }}</li>

</ul>

ブラウザーの表示。

単純変数

実数値：3.1415
文字列：ABCDいろはに

コレクション

コレクションを参照する変数を展開すると、変数をprint文でコンソール出力した時の形式で展開される。

from django.shortcuts import render

def variable(request):
    context = {
        'var_list': ['one', 2, [3, 'three']],
        'var_tuple': ('one', 2, (3, 'three')),
        'var_dict': {'one': 1, 'two': 2, 'three': 3},
    }

    return render(request, 'dtldemo/variable.html', context)

from django.shortcuts import render

def variable(request):

context = {

'var_list': ['one', 2, [3, 'three']],

'var_tuple': ('one', 2, (3, 'three')),

'var_dict': {'one': 1, 'two': 2, 'three': 3},

}

return render(request, 'dtldemo/variable.html', context)

テンプレートの変数展開部分。

    <p>コレクション</p>
    <ul>
      <li>リスト：{{ var_list }}</li>
      <li>タプル：{{ var_tuple }}</li>
      <li>辞　書：{{ var_dict }}</li>
    </ul>

<p>コレクション</p>

<ul>

<li>タプル：{{ var_tuple }}</li>

</ul>

ブラウザーの表示。

コレクション

リスト：[‘one’, 2, [3, ‘three’]]
タプル：(‘one’, 2, (3, ‘three’))
辞　書：{‘one’: 1, ‘two’: 2, ‘three’: 3}

コレクションの要素を展開する場合、Pythonの[]と違ってドット(.)に続けて添字の数値やキーの文字列をそのまま書く。

{{ 変数.添字 }}  または  {{ 変数.キー }}

1	{{ 変数.添字 }} または {{ 変数.キー }}

多次元の場合には、次数に対応して連ねていく。

{{ 変数.1次元目.2次元目 }}

1	{{ 変数.1次元目.2次元目 }}

コレクション全体と同じ例で要素を表示したいときのテンプレートの例。

    <p>コレクションの要素</p>
    <ul>
      <li>
        リストの要素：{{ var_list.0 }}, {{ var_list.1 }},
        {{ var_list.2.0 }}, {{ var_list.2.1 }}
      </li>
      <li>
        タプルの要素：{{ var_tuple.0 }}, {{ var_tuple.1 }},
        {{ var_tuple.2.0 }}, {{ var_tuple.2.1 }}
      </li>
      <li>
        辞書の要素　：{{ var_dict.one }}, {{ var_dict.two }}, {{ var_dict.three }}
      </li>
    </ul>

<p>コレクションの要素</p>

<ul>

<li>

リストの要素：{{ var_list.0 }}, {{ var_list.1 }},

{{ var_list.2.0 }}, {{ var_list.2.1 }}

</li>

<li>

タプルの要素：{{ var_tuple.0 }}, {{ var_tuple.1 }},

{{ var_tuple.2.0 }}, {{ var_tuple.2.1 }}

</li>

<li>

辞書の要素　：{{ var_dict.one }}, {{ var_dict.two }}, {{ var_dict.three }}

</li>

</ul>

ブラウザーの表示。

コレクションの要素

リストの要素：one, 2, 3, three
タプルの要素：one, 2, 3, three
辞書の要素　：1, 2, 3

オブジェクト

クラスのインスタンスを参照する変数も展開できる。以下はviews.pyで単純なクラスを定義して、そのインスタンスをテンプレートに渡している。

from django.shortcuts import render

class BinaryOperation:
    def __init__(self, a, b):
        self.a = a
        self.b = b

    def add(self):
        return self.a + self.b

def variable(request):
    var_obj = BinaryOperation(2, 3)

    context = {
        'var_obj': var_obj,
    }

    return render(request, 'dtldemo/variable.html', context)

from django.shortcuts import render

class BinaryOperation:

def __init__(self, a, b):

self.a = a

self.b = b

def add(self):

return self.a + self.b

def variable(request):

var_obj = BinaryOperation(2, 3)

context = {

'var_obj': var_obj,

}

return render(request, 'dtldemo/variable.html', context)

テンプレートでのオブジェクトの展開は、以下の3種類となる。

オブジェクト全体を展開すると、オブジェクトが文字列にキャストされた表現となる
オブジェクトの属性は、変数と属性名をドット(.)で繋いで得られる
オブジェクトとメソッド名をドット(.)で繋ぐと、メソッドの実行結果が得られる

    <p>オブジェクト</p>
    <ul>
      <li>オブジェクト全体：{{ var_obj }}</li>
      <li>オブジェクトの属性：{{ var_obj.a }}, {{ var_obj.b }}</li>
      <li>オブジェクトのメソッド：{{ var_obj.add }}</li>
    </ul>

<p>オブジェクト</p>

<ul>

<li>オブジェクト全体：{{ var_obj }}</li>

<li>オブジェクトの属性：{{ var_obj.a }}, {{ var_obj.b }}</li>

<li>オブジェクトのメソッド：{{ var_obj.add }}</li>

</ul>

ブラウザーでの表示。

オブジェクト

オブジェクト全体：<dtldemo.views.BinaryOperation object at 0x7fdf2835ec50>
オブジェクトの属性：2, 3
オブジェクトのメソッド：5

フィルター

基本形

フィルターはテンプレート中の変数を加工するもので、Djangoによる組み込みフィルターが多数用意されている。フィルターの基本形は以下のとおり。

{{ 変数|フィルター }}

わかりやすい例としては、変数の文字列の文字数を返すlengthがある。以下のテンプレートでは、var_stringに格納されている文字列とその文字数を表示している。

文字列{{ var_string }}の文字数は{{ var_string|length }}です

1	文字列{{ var_string }}の文字数は{{ var_string\|length }}です

変数の内容が'abcd'の場合、表示は以下のようになる。

文字列abcdeの文字数は5です

1	文字列abcdeの文字数は5です

引数

フィルターには引数を持つものもある。引数はリテラルとする必要がある。

{{ 変数|フィルター:引数 }}

以下の例はaddフィルターで、元の変数の内容に引数の内容を加える。

    <p>{{ var_two|add:3 }}</p>
    <p>{{ var_string|add:'XYZ'}}</p>

1 2	<p>{{ var_two\|add:3 }}</p> <p>{{ var_string\|add:'XYZ'}}</p>

var_two=2、var_string='abcde'の場合、表示は以下のようになる。

5
abcdeXYZ

1 2	5 abcdeXYZ

チェーン

フィルターのチェーンによって、複数のフィルターを作用させることができる。

{{ 変数|フィルター[:引数]|フィルター[:引数] ... }}

以下の例では変数の文字列に文字列定数を連結した上で文字数を得ている。

{{ var_string|add:'efg'|length }}

1	{{ var_string\|add:'efg'\|length }}

var_string='abcde'の場合、結果は’8'となる。

スペースとエラー

'|'や':'の前後にスペースを入れても問題ないが、タグ({% ... %})でフィルターを使う場合にはエラーとなる場合がある。

紛らわしいので、「フィルターを使うときは間のスペースなし」と決めておく方がよい。

Django – テンプレートの基礎

2022-03-08 / tau / コメントする

概要

HTMLや埋め込まれたデータを含むテンプレートを使ったアプリケーションの基本。流れは以下の通り。

テンプレートを表示させるアプリケーションの作成と登録
テンプレートを保存するディレクトリーとテンプレートファイルの作成
テンプレートを呼び出すビュー関数の作成
ルーティング設定

ここでは以下のことを整理している。

テンプレートの配置場所
テンプレートの参照方法
テンプレート言語(DTL)の概要

プロジェクトの準備

プロジェクトディレクトリーをtemplatebasicsとし、settings.pyなどを含むサブディレクトリーをconfigとする。

$ mkdir templatebasics && cd templatebasics
$ django-admin startproject config .

1 2	$ mkdir templatebasics && cd templatebasics $ django-admin startproject config .

初期設定とサーバー起動で動作確認しておく。

アプリケーションの作成・登録

テンプレートを表示させるアプリケーションtemplatedemoを作成する。

$ python3 manage.py startapp templatedemo

1	$ python3 manage.py startapp templatedemo

そしてアプリケーションをsettings.pyのINSTALLED_APPSに追加登録する。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'templatedemo',
]

INSTALLED_APPS = [

'django.contrib.admin',

'django.contrib.auth',

'django.contrib.contenttypes',

'django.contrib.sessions',

'django.contrib.messages',

'django.contrib.staticfiles',

'templatedemo',

]

テンプレート配置

初期設定

テンプレートの配置場所はsettings.pyのTEMPLATESで設定する。

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        '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',
            ],
        },
    },
]

TEMPLATES = [

{

'BACKEND': 'django.template.backends.django.DjangoTemplates',

'DIRS': [],

'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',

]

DIRSは任意の場所・ディレクトリー名のパスを設定する。またAPP_DIRをTrueに設定すると、各アプリケーションディレクトリー下のtemplatesディレクトリーが探索される。

複数のテンプレートディレクトリーは一括して同列に扱われ、各ディレクトリーのサブディレクトリーも再帰的に探索される。

デフォルトの設定では、各アプリケーションディレクトリー下のtemplatesディレクトリーのみが対象となっている。

配置場所

ここでは、以下の場所にテンプレートディレクトリーを置いて設定していく。

2か所にテンプレートディレクトリーを配置し、いずれのファイル名ともindex.htmlとしている
プロジェクト直下のディレクトリー名は任意だが、簡明のためtemplatesとする
2つのテンプレートディレクトリーは併せて参照されるので、アプリケーション下の方は区別のためにサブディレクトリーを設けている

templatebasics/
├── config
│    ├── __init__.py
│    ├── asgi.py
│    ├── settings.py
│    ├── urls.py
│    └── wsgi.py
├── manage.py
├── templatedemo
│    ├── __init__.py
│    ├── admin.py
│    ├── apps.py
│    ├── migrations
│    │    └── __init__.py
│    ├── models.py
│    ├── [templates]  <- APP_DIRS=Trueで探索される
│    │    └── [templatedemo]
│    │          └── [index.html]
│    ├── tests.py
│    └── views.py
└── [templates] <- DIRSで設定：名前は任意
      └── [index.html]

templatebasics/

├── config

│ ├── __init__.py

│ ├── asgi.py

│ ├── settings.py

│ ├── urls.py

│ └── wsgi.py

├── manage.py

├── templatedemo

│ ├── __init__.py

│ ├── admin.py

│ ├── apps.py

│ ├── migrations

│ │ └── __init__.py

│ ├── models.py

│ ├── [templates] <- APP_DIRS=Trueで探索される

│ │ └── [templatedemo]

│ │ └── [index.html]

│ ├── tests.py

│ └── views.py

└── [templates] <- DIRSで設定：名前は任意

└── [index.html]

アプリケーション下

テンプレートディレクトリー作成

作成したアプリケーションディレクトリーtemplatedemoの下にtemplatesディレクトリーを作成し、その下に更にサブディレクトリーtemplatedemoを作成する。

テンプレートファイル作成

作成したサブディレクトリー下にindex.htmlファイルを作成して以下を記述。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>アプリケーション下</title>
  </head>
  <body>
    <h1>アプリケーション下</h1>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>アプリケーション下</title>

</head>

<body>

<h1>アプリケーション下</h1>

</body>

</html>

プロジェクト直下

settings.py編集

TEMPLATESのDIRSにプロジェクト直下のtemplatesディレクトリーを探索するよう追加。

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': ['templates'],
        'APP_DIRS': True,
        ........
    },
]

TEMPLATES = [

{

'BACKEND': 'django.template.backends.django.DjangoTemplates',

'DIRS': ['templates'],

'APP_DIRS': True,

........

]

os.pathを使う方法もありその場合はimport osが必要になるが、上記の記述でも同じ効果。

テンプレートディレクトリー作成

プロジェクトディレクトリー直下にtemplatesディレクトリーを作成する。サブディレクトリーは作成しない。

$ mkdir templates

1	$ mkdir templates

テンプレートファイル作成

作成したtemplatesディレクトリー下にindex.htmlファイルを作成して以下を記述。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>プロジェクト直下</title>
  </head>
  <body>
    <h1>プロジェクト直下</h1>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>プロジェクト直下</title>

</head>

<body>

<h1>プロジェクト直下</h1>

</body>

</html>

view関数の作成とルーティング

view関数の作成

アプリケーションディレクトリーtemplatedemoのviews.pyを編集して、view関数を定義する。

view関数でレンダリングするテンプレートを指定するため、プロジェクト直下とアプリケーションディレクトリー下2か所のテンプレートに対応する関数を記述している。要点は以下のとおり。

def 関数名(request):で定義
テンプレートを呼ぶ戻り値はrender関数
- 第1引数は受け取ったrequest
- 第2引数はテンプレートファイルのパス
テンプレートファイルのパスについて
- TEMPLATESで設定したすべてのテンプレートディレクトリー下が一括して扱われる
- テンプレートディレクトリー以下の相対パスとする

rom django.shortcuts import render

def index_project(request):
    return render(request, 'index.html')

def index_application(request):
    return render(request, 'templatedemo/index.html')

rom django.shortcuts import render

def index_project(request):

return render(request, 'index.html')

def index_application(request):

return render(request, 'templatedemo/index.html')

複数テンプレートディレクトリーが一括して扱われ、テンプレートの指定がテンプレートディレクトリーからの相対パスとなるため、サブディレクトリーを設定した意義が確認できる。

view関数のルーティング登録

これらのview関数をURLから呼び出すためurls.pyに記述を追加する。

from django.contrib import admin
from django.urls import path
from templatedemo import template_application, template_project

urlpatterns = [
    path('admin/', admin.site.urls),
    path('application', template_application)
    path('project', template_project)
]

from django.contrib import admin

from django.urls import path

from templatedemo import template_application, template_project

urlpatterns = [

path('admin/', admin.site.urls),

path('application', template_application)

path('project', template_project)

]

確認

ここで開発用Webサーバーを起動して、ブラウザーで以下の入力に対応したページが表示されるのが確認できる。

localhost:8000/project
localhost:8000/application

DTL～テンプレート言語

概要

テンプレートにはHTMLのほかに、view関数から受け取った変数を埋め込んだり、繰り返しや条件分岐による出力の変更といった制御をさせることができる。そのための言語をDTL (Django Template Language)と言う。

{{ 変数 }}：変数の内容を展開してHTMLに埋め込む
{% 文 %}：for～endforによるループやif～elif～endifによる条件分岐で出力を制御する

変数の展開

たとえばtemplatedemoアプリケーションのviews.pyで、index_application関数を以下のように変更する。

def index_application(request):
    text = 'アプリケーション下'
    return render(request, 'templatedemo/index.html', {'title': text})

def index_application(request):

text = 'アプリケーション下'

return render(request, 'templatedemo/index.html', {'title': text})

ここでは、変数textを定義して、これを'text'をキーとする辞書の値としてrender関数の第3引数に渡している。

次に、templatedemoアプリケーション下のindex.htmlテンプレートを以下のように変更する。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>{{ title }}</title>
  </head>
  <body>
    <h1>{{ title }}</h1>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>{{ title }}</title>

</head>

<body>

<h1>{{ title }}</h1>

</body>

</html>

表示結果は、ブラウザーの上部またはタブと見出しに同じ「アプリケーション下」が表示される。

このように、ビュー側で処理した結果を変数としてテンプレートに渡し、HTMLとして表示させることができる。

制御構造

先のindex_application関数を以下のように変更する。

def index_application(request):
    context = {
        'title': '浦島太郎',
        'scenes': ['亀を助ける', '玉手箱をもらう', '竜宮城に行く',
                   '浜へ帰る', '玉手箱を開けて年寄りになる'],
    }
    return render(request, 'templatedemo/index.html', context)

def index_application(request):

context = {

'title': '浦島太郎',

'scenes': ['亀を助ける', '玉手箱をもらう', '竜宮城に行く',

'浜へ帰る', '玉手箱を開けて年寄りになる'],

}

return render(request, 'templatedemo/index.html', context)

ここでは第3引数をcontextとし、この変数に2つの要素を持つ辞書を入れている。1つ目の要素はタイトル、2つ目の要素は物語のシーンを収めた配列としている。

これを受け取るindex.htmlを以下のように変更する。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <title>{{ title }}</title>
  </head>
  <body>
    <h1>{{ title }}</h1>

    <p>物語のシーン</p>
    <ol>
      {% for scene in scenes %}
        <li>{{ scene }}</li>
      {% endfor %}
    </ol>
  </body>
</html>

<!DOCTYPE html>

<head>

<title>{{ title }}</title>

</head>

<body>

<h1>{{ title }}</h1>

<p>物語のシーン</p>

<ol>

{% for scene in scenes %}

<li>{{ scene }}</li>

{% endfor %}

</ol>

</body>

</html>

scenesで渡された配列の要素を、DTLのfor～endforでループしながら取り出し、li要素として並べている。この結果、出力されたHTMLでは5つのシーンがリストとして表示される。

同じテンプレートを使って、タイトルとシーンを桃太郎やかぐや姫などと変化させることができる。

Django – テンプレートの場所

2022-03-07 / tau / コメントする

概要

Djangoのテンプレートファイルは、テンプレートディレクトリーやそのサブディレクトリーに置かれることを想定している
複数場所に配置されたテンプレートディレクトリー以下が一括して探索される
探索場所と順序はsettings.pyファイルのTEMPLATESの設定に従う
- DIRSでは任意の場所・名前でテンプレートディレクトリーを追加できる
- APP_DIRSがTrueに設定されている場合、各アプリケーションディレクトリー下のtemplatesディレクトリーが探索される
探索されたテンプレートを参照する場合、テンプレートディレクトリーからの相対パスで指定する
テンプレートディレクトリーを分散配置しても一括して検索されるため、各テンプレートディレクトリーに適切なサブディレクトリーを置いて、その下にテンプレートファイルを置くのが一般的

確認用プロジェクト

確認のためtemplatetestプロジェクトを準備し、app1、app2の2つのアプリケーションを作成する。templatesディレクトリーとそのサブディレクトリーを以下のように作成し、4つの場所に即した内容のindex.htmlファイルを置く。

templatetest/
├── app1
│    ├── templates
│    │    └── app1
│    │          └── index.html
│
├── app2
│    ├── templates
│    │    └── app2
│    │          └── index.html
│
├── config
│    ├── templates
│    │    └── subdirectory
│    │          └── index.html
│
└── templates
      └── base
            └── index.html

templatetest/

├── app1

│ ├── templates

│ │ └── app1

│ │ └── index.html

│

├── app2

│ ├── templates

│ │ └── app2

│ │ └── index.html

│

├── config

│ ├── templates

│ │ └── subdirectory

│ │ └── index.html

│

└── templates

└── base

└── index.html

各場所のindex.htmlは、title要素/bodyのp要素で以下を表示させるようにした。

App1/Under the app1 directory
App2/Under the app2 directory
Subirectory/Under the subdirectory
Base Directory/Under the base directory

そしてapp1のビューファイルで指定するテンプレート名のディレクトリー名を変更しながら、各場所のindex.htmlが読み込まれたかどうか確認する。

from django.shortcuts import render

# Create your views here.
def index(request):
    template = 'base/index.html'
    return render(request, template)

from django.shortcuts import render

# Create your views here.

def index(request):

template = 'base/index.html'

return render(request, template)

プロジェクトの完成後、template変数に設定した文字列を以下のように変更して、それぞれに対応したページが表示されるかどうかを確認する。

'base/index.html'
'subdirectory/index.html'
'app1/index.html'
'app2/index.html'

TEMPLATESの初期設定

初期状態でのTEMPLATESは以下の通り。

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        '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',
            ],
        },
    },
]

TEMPLATES = [

{

'BACKEND': 'django.template.backends.django.DjangoTemplates',

'DIRS': [],

'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',

]

このうちテンプレートの探索場所は'DIRS'と'APP_DIRS'で設定される。

なおディレクトリーの探索場所が設定されていれば、そのサブディレクトリー下も再帰的に探索される。

DIRSでの設定

プロジェクトディレクトリー直下

'DIRS'にはプロジェクト内任意の場所の、任意の名前のディレクトリーを設定できる。たとえばプロジェクトディレクトリー直下に置いたtemplatesを探索させるなら以下のように記述する。

'DIRS': ['templates'],

1	'DIRS': ['templates'],

または

import os
....
'DIRS': [os.path.join(BASE_DIR, 'templates')],

import os

....

'DIRS': [os.path.join(BASE_DIR, 'templates')],

後者の場合、settings.pyではimport osがないので追加が必要。

この設定により、'templatetest/templates/base/index.html'のレンダリングが可能になる。

サブディレクトリー下

プロジェクトの設定ファイル群があるサブディレクトリー下（この場合configディレクトリー）にあるディレクトリーを探索させるときは以下のように相対パスで設定する。

'DIRS': ['config/templates'],

1	'DIRS': ['config/templates'],

または

import os
....
'DIRS': [os.path.join(BASE_DIR, 'config/templates')],

import os

....

'DIRS': [os.path.join(BASE_DIR, 'config/templates')],

この場合もsettings.pyにimport osが必要。

この設定により、templatetest/config/subdirectory/templates/index.htmlのレンダリングが可能になる。

APP_DIRSの設定

また、'APP_DIRS'がTrueに設定されている場合は、各アプリケーションディレクトリー下にあるtemplatesディレクトリーが探索される。

デフォルトでTrueがセットされているので、アプリケーションディレクトリー下にtempratesディレクトリーがあれば全て探索される。

この例の場合、app1/templates、app2/templatesは、デフォルトの設定)のままでそれぞれのサブディレクトリーも含めて探索される。

この結果templatetest/app1/templates/app1/index.htmlとtemplatetest/app2/templates/app2/index.htmlのレンダリングが可能になる。

全てを探索させるTEMPLATESの設定

これまでの4つの場所のすべてを探索対象とするには、settings.pyのTEMPLATESを以下のように設定する。

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': ['templates', 'config/templates'],
        'APP_DIRS': True,
        ........
    },
]

TEMPLATES = [

{

'BACKEND': 'django.template.backends.django.DjangoTemplates',

'DIRS': ['templates', 'config/templates'],

'APP_DIRS': True,

........

]

この結果、以下の4つが探索可能になる。

templatetest/templates/base/index.html
templatetest/config/templates/subdirectory/index.html
templatetest/app1/templates/app1/index.html
templatetest/app2/templates/app2/index.html

templatesのサブディレクトリー

特にアプリケーションディレクトリー下にテンプレートを置く場合に、（index.htmlのように）同じ名前のファイルが重複しないよう、サブディレクトリーを設けるのが一般的。

通常、サブディレクトリー名はアプリケーションディレクトリー名と同じとする。冗長だが重複が防止され、可読性も保たれる。

project/
├── application
│    ├── templates
│    │    └── application
│    │          └── index.html

project/

├── application

│ ├── templates

│ │ └── application

│ │ └── index.html

Django – Hello! – 単純なアプリケーション

2022-03-07 / tau / コメントする

概要

特定のURLにアクセスするとブラウザーに”Hello!”とだけ表示させるプロジェクトを作成する。要点は以下の通り。

Djangoのプロジェクトは複数のアプリケーションを含むことができる
アプリケーション作成はmanage.pyのstartappオプションで実行
リクエストに対応した処理を行うview関数をviews.pyに定義
特定のURLへのアクセスが対応するview関数にルーティングされるよう、urls.pyに設定

仕様

動作は以下の通り。

URLにhttp://localhost:8000/helloを指定してリクエスト
文字列"Hello!"を返す（ブラウザーに表示される）

構造は以下の通り。

Hello表示のアプリケーションをhelloとする
リクエストに対応するview関数をsay_hello()とする
say_hello()はリクエストに対して文字列"Hello!"をレスポンスで返す

プロジェクトのスタート

まずgreetingsという名前でディレクトリーを作成し、そのディレクトリー下にプロジェクト作成。ここではサブディレクトリー名をconfigとしている。

$ mkdir greetings && cd greetings
$ django-admin startproject config .

1 2	$ mkdir greetings && cd greetings $ django-admin startproject config .

プロジェクトの構成は以下の通り。

greetings/
├── config
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── manage.py

greetings/

├── config

│ ├── __init__.py

│ ├── asgi.py

│ ├── settings.py

│ ├── urls.py

│ └── wsgi.py

└── manage.py

settings.py編集後にサーバーを起動してDjangoのwelcomeページが表示されることを確認しておく。

ここでのsettings.pyの編集内容は以下の通り。

ALLOWED_HOSTSへの追加
DATABASESのコメントアウト
言語とタイムゾーンの設定

....
ALLOWED_HOSTS = ['localhost']
....
#DATABASES = {
#    'default': {
#        'ENGINE': 'django.db.backends.sqlite3',
#        'NAME': BASE_DIR / 'db.sqlite3',
#    }
#}
....
LANGUAGE_CODE = 'ja'

TIME_ZONE = 'Asia/Tokyo'
....

....

ALLOWED_HOSTS = ['localhost']

....

#DATABASES = {

# 'default': {

# 'ENGINE': 'django.db.backends.sqlite3',

# 'NAME': BASE_DIR / 'db.sqlite3',

# }

....

LANGUAGE_CODE = 'ja'

TIME_ZONE = 'Asia/Tokyo'

....

サーバー起動はVagrantのプライベート環境下なので以下の通り。

$ python3 manage.py runserver 10.0.2.15:8000

1	$ python3 manage.py runserver 10.0.2.15:8000

ブラウザーからのアクセスはhttp://localhost:8000で。

アプリケーションの作成

アプリケーション作成は、プロジェクトディレクトリー直下（manage.pyのある場所）で以下を実行。

$ python3 manage.py startapp アプリケーション名

1	$ python3 manage.py startapp アプリケーション名

ここでは、ブラウザーに”Hello!”を表示するためのhelloアプリケーションを作成する。greetingsディレクトリー下で以下を実行。

$ python3 manage.py startapp hello

1	$ python3 manage.py startapp hello

ディレクトリー構成は以下のようになる。新たにhelloディレクトリーが追加されている。

greetings/
├── config
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── hello
│   ├── __init__.py
│   ├── admin.py
│   ├── apps.py
│   ├── migrations
│   │   └── __init__.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
└── manage.py

greetings/

├── config

│ ├── __init__.py

│ ├── asgi.py

│ ├── settings.py

│ ├── urls.py

│ └── wsgi.py

├── hello

│ ├── __init__.py

│ ├── admin.py

│ ├── apps.py

│ ├── migrations

│ │ └── __init__.py

│ ├── models.py

│ ├── tests.py

│ └── views.py

└── manage.py

settings.pyにアプリケーションを追加

プロジェクトでhelloアプリケーションを認識するため、settings.pyのINSTALLED_APPSにアプリケーション名'hello'を追加。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello',
]

INSTALLED_APPS = [

'django.contrib.admin',

'django.contrib.auth',

'django.contrib.contenttypes',

'django.contrib.sessions',

'django.contrib.messages',

'django.contrib.staticfiles',

'hello',

]

viewの作成～views.py

リクエストに対応した処理を、helloアプリケーションディレクトリー内のviews.pyファイルに記述。

単純にHTTPレスポンスで文字列を返すため、HttpResponseをインポート
view関数としてsay_hello()を定義し、文字列を返すよう記述

from django.shortcuts import render
from django.http import HttpResponse

# Create your views here.
def say_hello(request):
    return HttpResponse('Hello!');

from django.shortcuts import render

from django.http import HttpResponse

# Create your views here.

def say_hello(request):

return HttpResponse('Hello!');

ルーティング～urls.py

想定しているURLに対して定義したview関数が呼ばれるようにルーティング。プロジェクトサブディレクトリーのurls.pyファイルに記述を追加する。

say_hello()を使うためインポートが必要
urlpatternsに/helloからsay_hello()へのルーティングを定義

from django.contrib import admin
from django.urls import path
# added
from hello.views import say_hello

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello', say_hello),
]

from django.contrib import admin

from django.urls import path

# added

from hello.views import say_hello

urlpatterns = [

path('admin/', admin.site.urls),

path('hello', say_hello),

]

ブラウザーから接続

以下のURLでブラウザーに”Hello!”と表示される。

https://localhost:8000/hello

1	https://localhost:8000/hello

なお、これ以降localhost:8000のルートに接続すると404エラーとなる。

ルーティングを記述したurls.pyにホストのルートへのルーティングを追加すると、http://localhost:8000のURLに対しても”Hello!”が表示されるようになる。

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello', say_hello),
    path('', say_hello),
]

urlpatterns = [

path('admin/', admin.site.urls),

path('hello', say_hello),

path('', say_hello),

]

Django – プロジェクトの作成

2022-03-06 / tau / コメントする

概要

Djangoのプロジェクト作成はdjango-admin startprojectで行う。新規にプロジェクトディレクトリーを作成する方法と、既存のディレクトリーに作成する方法がある。

新規にプロジェクトディレクトリーを作成する方法では、プロジェクト名のみを指定する。

$ django-admin startproject [プロジェクト名]

1	$ django-admin startproject [プロジェクト名]

この場合プロジェクト名と同じディレクトリーが作成され、その下に同じ名前のサブディレクトリーとmanage.pyファイルが作成される。

プロジェクト名
├── manage.py
└── プロジェクト名

プロジェクト名

├── manage.py

└── プロジェクト名

既存のディレクトリーに作成する方法では、第1引数にサブディレクトリー、第2引数に既存のプロジェクトディレクトリーを指定する。

$ django-admin startproject [サブディレクトリー] [プロジェクトディレクトリー]

1	$ django-admin startproject [サブディレクトリー] [プロジェクトディレクトリー]

この場合、既存のプロジェクトディレクトリーの下にサブディレクトリーとmanage.pyファイルが作成される。

プロジェクトディレクトリー
├── manage.py
└── サブディレクトリー

プロジェクトディレクトリー

├── manage.py

└── サブディレクトリー

何れの場合もサブディレクトリーの内容は同じで、プロジェクト全体に関する設定ファイルなどが作成される。

manage.pyはコマンドラインで管理レベルの操作を行うためのファイル。

プロジェクト名だけを指定する場合

プロジェクト名だけを指定した場合は、その名前でディレクトリーが作成され、その下に同じ名前のサブディレクトリーとmanage.pyファイルが作成される。

$ django-admin startproject testproject

1	$ django-admin startproject testproject

もし同じ名前のディレクトリーが既に存在していた場合はエラーとなる。

$ django-admin startproject testproject
CommandError: '/home/vagrant/test/django/testproject' already exists

1 2	$ django-admin startproject testproject CommandError: '/home/vagrant/test/django/testproject' already exists

以下は新規作成されたプロジェクトディレクトリーの内容

testproject
├── manage.py
└── testproject
    ├── __init__.py
    ├── asgi.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

testproject

├── manage.py

└── testproject

├── __init__.py

├── asgi.py

├── settings.py

├── urls.py

└── wsgi.py

サブディレクトリーの下には、プロジェクト全体に関する設定ファイルが作成される。たとえばsettings.pyファイルは、プロジェクトの言語やタイムゾーン、データベースなどに関する設定を記述する。

既存のディレクトリーに作成する場合

空のプロジェクトディレクトリーを作成し、第1引数にサブディレクトリー、第2引数にプロジェクトディレクトリーを指定して実行する。

$ mkdir testproject
$ django-admin startproject project_settings testproject

1 2	$ mkdir testproject $ django-admin startproject project_settings testproject

もし指定したプロジェクトディレクトリーが存在しない場合はエラーになる。

$ django-admin startproject project_settings testproject
CommandError: Destination directory '/home/vagrant/test/django/testproject' does not exist, please create it first.

1 2	$ django-admin startproject project_settings testproject CommandError: Destination directory '/home/vagrant/test/django/testproject' does not exist, please create it first.

なお、以後の作業をプロジェクトディレクトリー内で行うことを想定して以下のように実行してもよい。

$ mkdir testproject && cd testproject
$ django-admin startproject project_settings .

1 2	$ mkdir testproject && cd testproject $ django-admin startproject project_settings .

この場合のディレクトリー構成は以下のようになる。

testproject/
├── manage.py
└── project_settings
    ├── __init__.py
    ├── asgi.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

testproject/

├── manage.py

└── project_settings

├── __init__.py

├── asgi.py

├── settings.py

├── urls.py

└── wsgi.py

Django – 初期設定とサーバー起動

2022-03-06 / tau / コメントする

概要

主な留意点は以下の通り。

DjangoのデフォルトDBMSはSQLite
言語・タイムゾーン・DB設定などはsettings.pyで記述(Laravelの.envに相当)
Vagrantなどの仮想環境の場合はサーバー起動のIPに注意
→ゲスト側でALLOW_HOSTSの設定も必要

当初に発生したエラーと対応についてはこちら。

データベースクライアントのインストール

DjangoのデフォルトではSQLiteとなっている。SQLiteの場合は一定以上のバージョンが要求される模様。

他のDBMSを使う場合、クライアントをインストールしておく必要がある。以下はMySQLを使う場合にmysqlclientをインストールした例。

$ pip3 install mysqlclient
Collecting mysqlclient
  Downloading mysqlclient-2.1.0.tar.gz (87 kB)
     |████████████████████████████████| 87 kB 340 kB/s
  Preparing metadata (setup.py) ... done
Building wheels for collected packages: mysqlclient
  Building wheel for mysqlclient (setup.py) ... done
  Created wheel for mysqlclient: filename=mysqlclient-2.1.0-cp36-cp36m-linux_x86_64.whl size=97317 sha256=d4a6c57befdfa5ba5fe7b0a35df349685443037c2be88627c79d0bd7ed4c2bdf
  Stored in directory: /home/vagrant/.cache/pip/wheels/96/0d/a8/c8cd77741e717373250fffd50cb3b8cbe7ed0a40aa3e11169c
Successfully built mysqlclient
Installing collected packages: mysqlclient
Successfully installed mysqlclient-2.1.0

$ pip3 install mysqlclient

Collecting mysqlclient

Downloading mysqlclient-2.1.0.tar.gz (87 kB)

|████████████████████████████████| 87 kB 340 kB/s

Preparing metadata (setup.py) ... done

Building wheels for collected packages: mysqlclient

Building wheel for mysqlclient (setup.py) ... done

Created wheel for mysqlclient: filename=mysqlclient-2.1.0-cp36-cp36m-linux_x86_64.whl size=97317 sha256=d4a6c57befdfa5ba5fe7b0a35df349685443037c2be88627c79d0bd7ed4c2bdf

Stored in directory: /home/vagrant/.cache/pip/wheels/96/0d/a8/c8cd77741e717373250fffd50cb3b8cbe7ed0a40aa3e11169c

Successfully built mysqlclient

Installing collected packages: mysqlclient

Successfully installed mysqlclient-2.1.0

settings.py～各種設定

言語とタイムゾーン

言語を日本語に、タイムゾーンを日本のものに設定。

#LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'ja'

#TIME_ZONE = 'UTC'
TIME_ZONE = 'Asia/Tokyo'

#LANGUAGE_CODE = 'en-us'

LANGUAGE_CODE = 'ja'

#TIME_ZONE = 'UTC'

TIME_ZONE = 'Asia/Tokyo'

データベース設定

デフォルトのSQLiteではなくMySQLを使う例

DATABASES = {
    'default': {
#        'ENGINE': 'django.db.backends.sqlite3',
#        'NAME': BASE_DIR / 'db.sqlite3',
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'データベース名',
        'USER': '接続ユーザー名',
        'PASSWORD': 'パスワード',
    }
}

DATABASES = {

'default': {

# 'ENGINE': 'django.db.backends.sqlite3',

# 'NAME': BASE_DIR / 'db.sqlite3',

'ENGINE': 'django.db.backends.mysql',

'NAME': 'データベース名',

'USER': '接続ユーザー名',

'PASSWORD': 'パスワード',

}

ホスト許可

Vagrantなど仮想環境のプライベートネットワークで接続する場合、ここに設定が必要。

# ALLOWED_HOSTS = []
ALLOWED_HOSTS = ['127.0.0.1', 'localhost']

1 2	# ALLOWED_HOSTS = [] ALLOWED_HOSTS = ['127.0.0.1', 'localhost']

Vagrantの場合

Vagrantfileの設定

ポートマッピング設定。プライベートネットワークはデフォルト。

  ........
  config.vm.network "forwarded_port", guest: 8000, host: 8000
  ........
  # config.vm.network "private_network", ip: "192.168.33.10"
  ........

........

config.vm.network "forwarded_port", guest: 8000, host: 8000

........

# config.vm.network "private_network", ip: "192.168.33.10"

........

ゲスト側IP確認

ゲスト側の仮想環境でサーバーを起動する場合のIPを確認。ホスト側では127.0.0.1にセットされている。

$ ifconfig
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.0.2.15  netmask 255.255.255.0  broadcast 10.0.2.255
        inet6 fe80::10ae:de8c:87bc:71ab  prefixlen 64  scopeid 0x20<link>
        ether 08:00:27:0e:4e:dd  txqueuelen 1000  (Ethernet)
        RX packets 7361  bytes 727729 (710.6 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 5168  bytes 2085890 (1.9 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

$ ifconfig

eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500

inet 10.0.2.15 netmask 255.255.255.0 broadcast 10.0.2.255

inet6 fe80::10ae:de8c:87bc:71ab prefixlen 64 scopeid 0x20<link>

ether 08:00:27:0e:4e:dd txqueuelen 1000 (Ethernet)

RX packets 7361 bytes 727729 (710.6 KiB)

RX errors 0 dropped 0 overruns 0 frame 0

TX packets 5168 bytes 2085890 (1.9 MiB)

TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536

inet 127.0.0.1 netmask 255.0.0.0

inet6 ::1 prefixlen 128 scopeid 0x10<host>

loop txqueuelen 1000 (Local Loopback)

RX packets 0 bytes 0 (0.0 B)

RX errors 0 dropped 0 overruns 0 frame 0

TX packets 0 bytes 0 (0.0 B)

TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

開発用Webサーバー起動

ifconfigで確認したゲスト側のIPでサーバーを起動する。

$ python manage.py runserver 10.0.2.15:8000
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
March 06, 2022 - 16:19:28
Django version 3.2.12, using settings 'djangotest.settings'
Starting development server at http://10.0.2.15:8000/
Quit the server with CONTROL-C.

$ python manage.py runserver 10.0.2.15:8000

Watching for file changes with StatReloader

Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.

Run 'python manage.py migrate' to apply them.

March 06, 2022 - 16:19:28

Django version 3.2.12, using settings 'djangotest.settings'

Starting development server at http://10.0.2.15:8000/

Quit the server with CONTROL-C.

ブラウザーで接続

ホスト側のブラウザーで、http://localhost:8000かhttp://127.0.0.1:8000で接続。

Vagrant – Django – サーバーエラー

2022-03-06 / tau / コメントする

概要

以下のような流れでエラー発生・解決した記録。データベース接続なしでとにかくDjangoのサーバー起動とアクセスを確認。

Vagrant上のCentOS7にPython3やvertualenvをインストール
仮想環境上でDjango開発用サーバーを起動
Exception発生
ひとまずデータベースを切ってサーバー起動
ブラウザーから接続できず
Vagrantfileを編集してIPアドレス変更
DisallowedHostで接続できず
settings.pyのALLOWED_HOSTを編集
無事接続

データベースを繋がずにとにかくDjangoの応答までを確認する場合、Vagrant環境では以下のように設定。

Vagrantfileでポートマッピングを設定
VMでifconfig→eth0のIPアドレスを確認
settings.pyのALLOWED_HOSTSにブラウザーでアクセスしたいホスト名、IPアドレスを追加
開発用Webサーバーをeth0のIPアドレスとマップしたポートで起動
ALLOWED_HOSTSで許可したホスト／IPアドレスとマップしたポートでアクセス

サーバー起動時エラー発生

Vagrant/CentOS7環境上にPython3、virtualenvをインストールして、仮想環境を作成。その環境下でDjangoをインストール。

とりあえずテスト用のプロジェクトを作成。

$ django-admin startproject djangotest
$ cd djangotest
$ ls
djangotest  manage.py
$ ls djangotest/djangotest/
__init__.py  asgi.py  settings.py  urls.py  wsgi.py

$ django-admin startproject djangotest

$ cd djangotest

$ ls

djangotest manage.py

$ ls djangotest/djangotest/

__init__.py asgi.py settings.py urls.py wsgi.py

プロジェクトで開発用Webサーバーを起動しようとしたところ、エラー発生。SQLiteのバージョンが低いと言っているらしい。

$ python manage.py runserver
Watching for file changes with StatReloader
Exception in thread django-main-thread:
Traceback (most recent call last):
  File "/usr/lib64/python3.6/threading.py", line 916, in _bootstrap_inner
    self.run()

........

  File "/home/vagrant/.virtualenvs/djangotest/lib/python3.6/site-packages/django/db/backends/sqlite3/base.py", line 73, in <module>
    check_sqlite_version()
  File "/home/vagrant/.virtualenvs/djangotest/lib/python3.6/site-packages/django/db/backends/sqlite3/base.py", line 69, in check_sqlite_version
    'SQLite 3.9.0 or later is required (found %s).' % Database.sqlite_version
django.core.exceptions.ImproperlyConfigured: SQLite 3.9.0 or later is required (found 3.7.17).

$ python manage.py runserver

Watching for file changes with StatReloader

Exception in thread django-main-thread:

Traceback (most recent call last):

File "/usr/lib64/python3.6/threading.py", line 916, in _bootstrap_inner

self.run()

........

File "/home/vagrant/.virtualenvs/djangotest/lib/python3.6/site-packages/django/db/backends/sqlite3/base.py", line 73, in <module>

check_sqlite_version()

File "/home/vagrant/.virtualenvs/djangotest/lib/python3.6/site-packages/django/db/backends/sqlite3/base.py", line 69, in check_sqlite_version

'SQLite 3.9.0 or later is required (found %s).' % Database.sqlite_version

django.core.exceptions.ImproperlyConfigured: SQLite 3.9.0 or later is required (found 3.7.17).

SQLiteを確認したところ、3.7と必要なバージョンより確かに低い。

$ sqlite3 --version
3.7.17 2013-05-20 00:56:22 118a3b35693b134d56ebd780123b7fd6f1497668

1 2	$ sqlite3 --version 3.7.17 2013-05-20 00:56:22 118a3b35693b134d56ebd780123b7fd6f1497668

データベース無効化で再挑戦

そもそもデータベースにはSQLiteではなくMySQLを使っている。またとりあえずの動作確認なので、データベースを設定せずにサーバーを起動してみようと考える。

Laravelでいえば.envファイルにあたる設定ファイルは、Djangoではsettings.pyらしい。その場所を探してみるとプロジェクトディレクトリーと同名のサブディレクトリーにあった。

$ sudo find / -name settings.py
/home/vagrant/test/djangotest/djangotest/settings.py

1 2	$ sudo find / -name settings.py /home/vagrant/test/djangotest/djangotest/settings.py

settings.pyの中のデータベース関係を探して、そこをすべてコメントアウトしてみる。

"""
Django settings for djangotest project.

........

# Database
# https://docs.djangoproject.com/en/3.2/ref/settings/#databases

#DATABASES = {
#    'default': {
#        'ENGINE': 'django.db.backends.sqlite3',
#        'NAME': BASE_DIR / 'db.sqlite3',
#    }
#}

........

# Default primary key field type
# https://docs.djangoproject.com/en/3.2/ref/settings/#default-auto-field

DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

"""

Django settings for djangotest project.

........

# Database

# https://docs.djangoproject.com/en/3.2/ref/settings/#databases

#DATABASES = {

# 'default': {

# 'ENGINE': 'django.db.backends.sqlite3',

# 'NAME': BASE_DIR / 'db.sqlite3',

# }

........

# Default primary key field type

# https://docs.djangoproject.com/en/3.2/ref/settings/#default-auto-field

DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

再度サーバーを起動すると、エラー無く実行された。

$ python manage.py runserver
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
March 05, 2022 - 22:38:04
Django version 3.2.12, using settings 'djangotest.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

$ python manage.py runserver

Watching for file changes with StatReloader

Performing system checks...

System check identified no issues (0 silenced).

March 05, 2022 - 22:38:04

Django version 3.2.12, using settings 'djangotest.settings'

Starting development server at http://127.0.0.1:8000/

Quit the server with CONTROL-C.

ブラウザーで接続不可

サーバーは起動されたが、ブラウザーでhttp://127.0.0.1:8000とするとアクセスできない。

このサイトにアクセスできません
127.0.0.1 で接続が拒否されました。

1 2	このサイトにアクセスできません 127.0.0.1 で接続が拒否されました。

Vagrantのプライベートネットワークに沿った設定とサーバー起動が必要なことを忘れていた。

プライベートネットワーク設定

Vagrantfileの内容を確認・編集

  # Create a forwarded port mapping which allows access to a specific port
  # within the machine from a port on the host machine. In the example below,
  # accessing "localhost:8080" will access port 80 on the guest machine.
  # NOTE: This will enable public access to the opened port
  config.vm.network "forwarded_port", guest: 80, host: 8080
  config.vm.network "forwarded_port", guest: 8000, host: 8000
  config.vm.network "forwarded_port", guest: 3000, host: 3000

  ........

  # config.vm.network "private_network", ip: "192.168.33.10"
  # コメントアウトのまま

# Create a forwarded port mapping which allows access to a specific port

# within the machine from a port on the host machine. In the example below,

# accessing "localhost:8080" will access port 80 on the guest machine.

# NOTE: This will enable public access to the opened port

config.vm.network "forwarded_port", guest: 80, host: 8080

config.vm.network "forwarded_port", guest: 8000, host: 8000

config.vm.network "forwarded_port", guest: 3000, host: 3000

........

# config.vm.network "private_network", ip: "192.168.33.10"

# コメントアウトのまま

vagrant reloadで再起動し、vagrant sshでCentOS7に入り、ポート設定を見る。

$ ifconfig
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.0.2.15  netmask 255.255.255.0  broadcast 10.0.2.255
        inet6 fe80::10ae:de8c:87bc:71ab  prefixlen 64  scopeid 0x20<link>
        ether 08:00:27:0e:4e:dd  txqueuelen 1000  (Ethernet)
        RX packets 691  bytes 74221 (72.4 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 506  bytes 76581 (74.7 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

$ ifconfig

eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500

inet 10.0.2.15 netmask 255.255.255.0 broadcast 10.0.2.255

inet6 fe80::10ae:de8c:87bc:71ab prefixlen 64 scopeid 0x20<link>

ether 08:00:27:0e:4e:dd txqueuelen 1000 (Ethernet)

RX packets 691 bytes 74221 (72.4 KiB)

RX errors 0 dropped 0 overruns 0 frame 0

TX packets 506 bytes 76581 (74.7 KiB)

TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536

inet 127.0.0.1 netmask 255.0.0.0

inet6 ::1 prefixlen 128 scopeid 0x10<host>

loop txqueuelen 1000 (Local Loopback)

RX packets 0 bytes 0 (0.0 B)

RX errors 0 dropped 0 overruns 0 frame 0

TX packets 0 bytes 0 (0.0 B)

TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

ゲスト側のVMからは10.0.20.15でサーバーを立ち上げ、ホスト側では127.0.0.1で接続する。ポートフォワーディングはホスト・ゲストとも8000

開発用Webサーバーを10.0.20.15:8000で起動。

$ python manage.py runserver 10.0.2.15:8000
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).
March 06, 2022 - 03:52:36
Django version 3.2.12, using settings 'djangotest.settings'
Starting development server at http://10.0.2.15:8000/
Quit the server with CONTROL-C.

$ python manage.py runserver 10.0.2.15:8000

Watching for file changes with StatReloader

Performing system checks...

System check identified no issues (0 silenced).

March 06, 2022 - 03:52:36

Django version 3.2.12, using settings 'djangotest.settings'

Starting development server at http://10.0.2.15:8000/

Quit the server with CONTROL-C.

Djangoで許可されない

ブラウザーでhttp://127.0.0.1:8000やhttp://localhost:8000とするが接続できない。ただしDjangoによって許可されていないらしく、ALLOWED_HOSTSを加えるよう示されている。

ALLOW_HOSTSを編集して接続

settings.pyのALLOWED_HOSTSを編集。

ALLOWED_HOSTS = []
↓
ALLOWED_HOSTS = ['127.0.0.1', 'localhost']

ALLOWED_HOSTS = []

↓

ALLOWED_HOSTS = ['127.0.0.1', 'localhost']

ブラウザーからhttp://127.0.0.1:8000あるいはhttp://localhost:8000でアクセスでき、以下のページが表示された。

CwntOS7 – Djangoのインストール

2022-03-06 / tau / コメントする

概要

Vagrant上のCentOS7にDjangoをインストール。

virtualenvの仮想環境でインストールした場合、元のシステムには影響を与えない。

手順

Python3インストール済みの環境でDjangoをインストール。特に問題なくインストール完了。

$ pip3 install Django
Collecting Django
  Downloading Django-3.2.12-py3-none-any.whl (7.9 MB)
     |████████████████████████████████| 7.9 MB 2.1 MB/s
Collecting asgiref<4,>=3.3.2
  Downloading asgiref-3.4.1-py3-none-any.whl (25 kB)
Collecting pytz
  Downloading pytz-2021.3-py2.py3-none-any.whl (503 kB)
     |████████████████████████████████| 503 kB 3.1 MB/s
Collecting sqlparse>=0.2.2
  Downloading sqlparse-0.4.2-py3-none-any.whl (42 kB)
     |████████████████████████████████| 42 kB 1.6 MB/s
Collecting typing-extensions
  Using cached typing_extensions-4.1.1-py3-none-any.whl (26 kB)
Installing collected packages: typing-extensions, sqlparse, pytz, asgiref, Django
Successfully installed Django-3.2.12 asgiref-3.4.1 pytz-2021.3 sqlparse-0.4.2 typing-extensions-4.1.1<br>

$ pip3 install Django

Collecting Django

Downloading Django-3.2.12-py3-none-any.whl (7.9 MB)

|████████████████████████████████| 7.9 MB 2.1 MB/s

Collecting asgiref<4,>=3.3.2

Downloading asgiref-3.4.1-py3-none-any.whl (25 kB)

Collecting pytz

Downloading pytz-2021.3-py2.py3-none-any.whl (503 kB)

|████████████████████████████████| 503 kB 3.1 MB/s

Collecting sqlparse>=0.2.2

Downloading sqlparse-0.4.2-py3-none-any.whl (42 kB)

|████████████████████████████████| 42 kB 1.6 MB/s

Collecting typing-extensions

Using cached typing_extensions-4.1.1-py3-none-any.whl (26 kB)

Installing collected packages: typing-extensions, sqlparse, pytz, asgiref, Django

Successfully installed Django-3.2.12 asgiref-3.4.1 pytz-2021.3 sqlparse-0.4.2 typing-extensions-4.1.1<br>

バージョンチェック。

$ python -m django --version
3.2.12

1 2	$ python -m django --version 3.2.12

Python3からもチェック。

$ python3
Python 3.6.8 (default, Nov 16 2020, 16:55:22)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import django
>>> print(django.get_version())
3.2.12

$ python3

Python 3.6.8 (default, Nov 16 2020, 16:55:22)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>> import django

>>> print(django.get_version())

3.2.12

Linux – bash – シェルプロンプトの変更

2022-03-05 / tau / コメントする

プロンプトの書式の確認

Vagrant上のCentOS7でシェルはbash。プロンプトは以下のようになっている。

[vagrant@localhost env1]$

1	[vagrant@localhost env1]$

この書式はPS1変数で設定されている。

$ echo "$PS1"
[\u@\h \W]\$

1 2	$ echo "$PS1" [\u@\h \W]\$

それぞれの意味は以下の通り。

\u：ユーザー名
\h：ホスト名
\W：カレントディレクトリー

プロンプトの変更例

`$`や`#`だけにする

プロンプトの後にスペースを入れておく。

$ export PS1='\$ '
$

1 2	$ export PS1='\$ ' $

ユーザー名と時刻にする

$ export PS1='\u-\t>'
vagrant-15:45:45>

1 2	$ export PS1='\u-\t>' vagrant-15:45:45>

一部に色を付ける

以下はユーザー名と時刻を表示して、ユーザー名を青にしている（ターミナルではvagrantが青で表示される）。

$ export PS1='\e[34m\u\e[39m-\t>'
vagrant-15:47:23>

1 2	$ export PS1='\e[34m\u\e[39m-\t>' vagrant-15:47:23>

常時設定する

~/.bashrcにexport文を加える。

プロンプト書式に使える記号

以下の記号が使える。

\d：日付
\h：ホスト名の最初のブロック
\H：ドメイン名まで含めたホスト名
\s：シェルの名前
\t：時間～24時間制
\T：時間～12時間制
\@：時間～AM/PM形式
\u：ユーザー名
\w：カレントディレクトリー
\W：カレントディレクトリーのベース名
\!：コマンドの履歴番号
\$：一般ユーザーは$、rootなら#
\\：バックスラッシュ

色の設定

色設定はエスケープシーケンスで行う。

設定開始：[ESC]+'['+[色コード]+'m'
設定解除：[ESC]+'['+'39'+'m'

色コードには前景色と背景色がある。

前景色：30～37、90～97
- 90～97は明るめの色
背景色：40～47
- 100～107は明るめの色
拡張指定：38
- 256カラーレベル：38;5;n、48 ;5;n
- RGB指定：38;2;r;g;b、48;2;r;g;b
色設定解除：39

	前景色	背景色
Black	30	40
Red	31	41
Green	32	42
Yellow	33	43
Blue	34	44
Magenta	35	45
Cyan	36	46
White	37	47

Vagrant – CentOS7 – Python3 – virtualenv

2022-03-04 / tau / コメントする

概要

Vagrant上のCentOS7で、virtualenvをインストールしてPython3の仮想環境をつくった手順の記録。

pipでvirtualenvwrapperをインストールする
sudoでインストールすると警告が出てグローバルにインストールされる

許可がなくインストールできない

pip3でvirtualenvwrapperをインストールしようとしたところ、許可がないとエラーになった。

$ pip3 install virtualenvwrapper
Collecting virtualenvwrapper
  Downloading https://files.pythonhosted.org/packages/c1/6b/2f05d73b2d2f2410b48b90d3783a0034c26afa534a4a95ad5f1178d61191/virtualenvwrapper-4.8.4.tar.gz (334kB)
    100% |████████████████████████████████| 337kB 450kB/s
Collecting virtualenv (from virtualenvwrapper)
  Downloading https://files.pythonhosted.org/packages/56/a2/3e5fdac9ecca6a3a6d2f63f7a486afd4a72728ba9f2ae83fa43f7af8ac8b/virtualenv-20.13.2-py2.py3-none-any.whl (8.7MB)
    100% |████████████████████████████████| 8.7MB 178kB/s

........

Exception:
Traceback (most recent call last):
  File "/usr/lib/python3.6/site-packages/pip/basecommand.py", line 215, in main
    status = self.run(options, args)
  File "/usr/lib/python3.6/site-packages/pip/commands/install.py", line 365, in run
    strip_file_prefix=options.strip_file_prefix,

........

  File "/usr/lib64/python3.6/os.py", line 210, in makedirs    makedirs(head, mode, exist_ok)
  File "/usr/lib64/python3.6/os.py", line 220, in makedirs
    mkdir(name, mode)
PermissionError: [Errno 13] 許可がありません: '/usr/local/lib/python3.6'

$ pip3 install virtualenvwrapper

Collecting virtualenvwrapper

Downloading https://files.pythonhosted.org/packages/c1/6b/2f05d73b2d2f2410b48b90d3783a0034c26afa534a4a95ad5f1178d61191/virtualenvwrapper-4.8.4.tar.gz (334kB)

100% |████████████████████████████████| 337kB 450kB/s

Collecting virtualenv (from virtualenvwrapper)

Downloading https://files.pythonhosted.org/packages/56/a2/3e5fdac9ecca6a3a6d2f63f7a486afd4a72728ba9f2ae83fa43f7af8ac8b/virtualenv-20.13.2-py2.py3-none-any.whl (8.7MB)

100% |████████████████████████████████| 8.7MB 178kB/s

........

Exception:

Traceback (most recent call last):

File "/usr/lib/python3.6/site-packages/pip/basecommand.py", line 215, in main

status = self.run(options, args)

File "/usr/lib/python3.6/site-packages/pip/commands/install.py", line 365, in run

strip_file_prefix=options.strip_file_prefix,

........

File "/usr/lib64/python3.6/os.py", line 210, in makedirs makedirs(head, mode, exist_ok)

File "/usr/lib64/python3.6/os.py", line 220, in makedirs

mkdir(name, mode)

PermissionError: [Errno 13] 許可がありません: '/usr/local/lib/python3.6'

ディレクトリーに書き込み権限がない。

[vagrant@localhost python]$ ls -al /usr/local/lib/
合計 0
drwxr-xr-x.  3 root root  23  3月  4 17:48 .
drwxr-xr-x. 12 root root 131  5月 13  2020 ..
drwxr-xr-x.  3 root root  27  3月  4 17:48 python3.6

[vagrant@localhost python]$ ls -al /usr/local/lib/

合計 0

drwxr-xr-x. 3 root root 23 3月 4 17:48 .

drwxr-xr-x. 12 root root 131 5月 13 2020 ..

drwxr-xr-x. 3 root root 27 3月 4 17:48 python3.6

sudoで警告が出るがインストール

以下のような警告が出るが、インストールは実行される。

WARNING: Running pip install with root privileges is generally not a good idea. Try `pip3 install –user` instead.

グローバルインストールするのに対して、--userオプションでユーザーディレクトリーへのインストールを促している。

$ sudo pip3 install virtualenvwrapper
WARNING: Running pip install with root privileges is generally not a good idea. Try `pip3 install --user` instead.
Collecting virtualenvwrapper
  Downloading https://files.pythonhosted.org/packages/c1/6b/2f05d73b2d2f2410b48b90d3783a0034c26afa534a4a95ad5f1178d61191/virtualenvwrapper-4.8.4.tar.gz (334kB)
    100% |████████████████████████████████| 337kB 157kB/s
Collecting virtualenv (from virtualenvwrapper)
  Downloading https://files.pythonhosted.org/packages/56/a2/3e5fdac9ecca6a3a6d2f63f7a486afd4a72728ba9f2ae83fa43f7af8ac8b/virtualenv-20.13.2-py2.py3-none-any.whl (8.7MB)
    100% |████████████████████████████████| 8.7MB 183kB/s

........

Installing collected packages: platformdirs, typing-extensions, zipp, importlib-metadata, filelock, six, distlib, importlib-resources, virtualenv, virtualenv-clone, pbr, stevedore, virtualenvwrapper
  Running setup.py install for virtualenvwrapper ... done
Successfully installed distlib-0.3.4 filelock-3.4.1 importlib-metadata-4.8.3 importlib-resources-5.4.0 pbr-5.8.1 platformdirs-2.4.0 six-1.16.0 stevedore-3.5.0 typing-extensions-4.1.1 virtualenv-20.13.2 virtualenv-clone-0.5.7 virtualenvwrapper-4.8.4 zipp-3.6.0

$ sudo pip3 install virtualenvwrapper

WARNING: Running pip install with root privileges is generally not a good idea. Try `pip3 install --user` instead.

Collecting virtualenvwrapper

Downloading https://files.pythonhosted.org/packages/c1/6b/2f05d73b2d2f2410b48b90d3783a0034c26afa534a4a95ad5f1178d61191/virtualenvwrapper-4.8.4.tar.gz (334kB)

100% |████████████████████████████████| 337kB 157kB/s

Collecting virtualenv (from virtualenvwrapper)

Downloading https://files.pythonhosted.org/packages/56/a2/3e5fdac9ecca6a3a6d2f63f7a486afd4a72728ba9f2ae83fa43f7af8ac8b/virtualenv-20.13.2-py2.py3-none-any.whl (8.7MB)

100% |████████████████████████████████| 8.7MB 183kB/s

........

Installing collected packages: platformdirs, typing-extensions, zipp, importlib-metadata, filelock, six, distlib, importlib-resources, virtualenv, virtualenv-clone, pbr, stevedore, virtualenvwrapper

Running setup.py install for virtualenvwrapper ... done

Successfully installed distlib-0.3.4 filelock-3.4.1 importlib-metadata-4.8.3 importlib-resources-5.4.0 pbr-5.8.1 platformdirs-2.4.0 six-1.16.0 stevedore-3.5.0 typing-extensions-4.1.1 virtualenv-20.13.2 virtualenv-clone-0.5.7 virtualenvwrapper-4.8.4 zipp-3.6.0

確認

virtualenvのバージョン確認。

$ virtualenv --version
virtualenv 20.13.2 from /usr/local/lib/python3.6/site-packages/virtualenv/__init__.py

1 2	$ virtualenv --version virtualenv 20.13.2 from /usr/local/lib/python3.6/site-packages/virtualenv/__init__.py

仮想環境構築の確認。

$ virtualenv testpython
created virtual environment CPython3.6.8.final.0-64 in 1421ms
  creator CPython3Posix(dest=/home/vagrant/test/python/testpython, clear=False, no_vcs_ignore=False, global=False)
  seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/vagrant/.local/share/virtualenv)
    added seed packages: pip==21.3.1, setuptools==59.6.0, wheel==0.37.1
  activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator

$ virtualenv testpython

created virtual environment CPython3.6.8.final.0-64 in 1421ms

creator CPython3Posix(dest=/home/vagrant/test/python/testpython, clear=False, no_vcs_ignore=False, global=False)

seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/vagrant/.local/share/virtualenv)

added seed packages: pip==21.3.1, setuptools==59.6.0, wheel==0.37.1

activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator

ディレクトリー確認。

$ ls -al
合計 0
drwxrwxr-x. 3 vagrant vagrant 24  3月  4 17:50 .
drwxrwxr-x. 5 vagrant vagrant 93  3月  4 17:49 ..
drwxrwxr-x. 5 vagrant vagrant 77  3月  4 17:50 testpython
$ ls -al testpython
合計 12
drwxrwxr-x. 5 vagrant vagrant   77  3月  4 17:50 .
drwxrwxr-x. 3 vagrant vagrant   24  3月  4 17:50 ..
-rw-rw-r--. 1 vagrant vagrant   40  3月  4 17:50 .gitignore
drwxrwxr-x. 2 vagrant vagrant 4096  3月  4 17:50 bin
drwxrwxr-x. 3 vagrant vagrant   23  3月  4 17:50 lib
drwxrwxr-x. 3 vagrant vagrant   23  3月  4 17:50 lib64
-rw-rw-r--. 1 vagrant vagrant  202  3月  4 17:50 pyvenv.cfg

$ ls -al

合計 0

drwxrwxr-x. 3 vagrant vagrant 24 3月 4 17:50 .

drwxrwxr-x. 5 vagrant vagrant 93 3月 4 17:49 ..

drwxrwxr-x. 5 vagrant vagrant 77 3月 4 17:50 testpython

$ ls -al testpython

合計 12

drwxrwxr-x. 5 vagrant vagrant 77 3月 4 17:50 .

drwxrwxr-x. 3 vagrant vagrant 24 3月 4 17:50 ..

-rw-rw-r--. 1 vagrant vagrant 40 3月 4 17:50 .gitignore

drwxrwxr-x. 2 vagrant vagrant 4096 3月 4 17:50 bin

drwxrwxr-x. 3 vagrant vagrant 23 3月 4 17:50 lib

drwxrwxr-x. 3 vagrant vagrant 23 3月 4 17:50 lib64

-rw-rw-r--. 1 vagrant vagrant 202 3月 4 17:50 pyvenv.cfg

仮想環境の有効化。

$ cd testpython/
$ source bin/activate
(testpython) $ which python3
~/test/python/testpython/bin/python3

$ cd testpython/

$ source bin/activate

(testpython) $ which python3

~/test/python/testpython/bin/python3

仮想環境の無効化と削除。

(test) $ deactivate
[vagrant@localhost test]$ which python3
/usr/bin/python3
$ rm -rf test

(test) $ deactivate

[vagrant@localhost test]$ which python3

/usr/bin/python3

$ rm -rf test

操作

基本操作

ディレクトリーを作成して仮想環境を作成。絶対パスでなければ現在のディレクトリー下に作成される。

$ virtualenv directory

仮想環境の有効化。

$ source directory/bin/activate
または
$ . directory/bin/activate

仮想環境の無効化。

(directory) $ deactivate

仮想環境の削除

$ rm -rf directory

応用

Pythonのバージョン指定

$ virtualenv -p python3.6 directory

システムのPythonパッケージ群を仮想環境からも参照

$ virtualenv --system-site-packages directory

virtualenvwrapperの利用

.bashrcの編集と再読み込み

virtualenvだけでも基本的な操作はできるが、virtualenvwrapperを利用すると便利なコマンドが使えるようになる。そのために~/.bashrcに以下の3行を加える。

export WORKON_HOME=~/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
source /usr/local/bin/virtualenvwrapper.sh

export WORKON_HOME=~/.virtualenvs

export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3

source /usr/local/bin/virtualenvwrapper.sh

.bashrcを実行して反映させる。

$ source .bashrc

1	$ source .bashrc

1行目のWORKON_HOMEで指定したディレクトリーが作成され、ここに仮想環境ごとのディレクトリーが作成される。

2行目を設定しないと以下のエラーが出る。エラーが出てもvirtualenvwrapperは利用できたが入れておく。

/usr/bin/python: No module named virtualenvwrapper
virtualenvwrapper.sh: There was a problem running the initialization hooks.

If Python could not import the module virtualenvwrapper.hook_loader,
check that virtualenvwrapper has been installed for
VIRTUALENVWRAPPER_PYTHON=/usr/bin/python and that PATH is
set properly.

/usr/bin/python: No module named virtualenvwrapper

virtualenvwrapper.sh: There was a problem running the initialization hooks.

If Python could not import the module virtualenvwrapper.hook_loader,

check that virtualenvwrapper has been installed for

VIRTUALENVWRAPPER_PYTHON=/usr/bin/python and that PATH is

set properly.

3行目はvirtualenvwrapper.shを実行させる。

.bashrcの実行後、~/.virtualenvsディレクトリーと必要なファイルが作成される。

$ ls -Al .virtualenvs/
合計 48
-rwxr-xr-x. 1 vagrant vagrant 135  3月  5 10:29 get_env_details
-rw-r--r--. 1 vagrant vagrant  96  3月  5 10:29 initialize
-rw-r--r--. 1 vagrant vagrant  73  3月  5 10:29 postactivate
-rw-r--r--. 1 vagrant vagrant  75  3月  5 10:29 postdeactivate
-rwxr-xr-x. 1 vagrant vagrant  66  3月  5 10:29 postmkproject
-rw-r--r--. 1 vagrant vagrant  73  3月  5 10:29 postmkvirtualenv
-rwxr-xr-x. 1 vagrant vagrant 110  3月  5 10:29 postrmvirtualenv
-rwxr-xr-x. 1 vagrant vagrant  99  3月  5 10:29 preactivate
-rw-r--r--. 1 vagrant vagrant  76  3月  5 10:29 predeactivate
-rwxr-xr-x. 1 vagrant vagrant  91  3月  5 10:29 premkproject
-rwxr-xr-x. 1 vagrant vagrant 130  3月  5 10:29 premkvirtualenv
-rwxr-xr-x. 1 vagrant vagrant 111  3月  5 10:29 prermvirtualenv

$ ls -Al .virtualenvs/

合計 48

-rwxr-xr-x. 1 vagrant vagrant 135 3月 5 10:29 get_env_details

-rw-r--r--. 1 vagrant vagrant 96 3月 5 10:29 initialize

-rw-r--r--. 1 vagrant vagrant 73 3月 5 10:29 postactivate

-rw-r--r--. 1 vagrant vagrant 75 3月 5 10:29 postdeactivate

-rwxr-xr-x. 1 vagrant vagrant 66 3月 5 10:29 postmkproject

-rw-r--r--. 1 vagrant vagrant 73 3月 5 10:29 postmkvirtualenv

-rwxr-xr-x. 1 vagrant vagrant 110 3月 5 10:29 postrmvirtualenv

-rwxr-xr-x. 1 vagrant vagrant 99 3月 5 10:29 preactivate

-rw-r--r--. 1 vagrant vagrant 76 3月 5 10:29 predeactivate

-rwxr-xr-x. 1 vagrant vagrant 91 3月 5 10:29 premkproject

-rwxr-xr-x. 1 vagrant vagrant 130 3月 5 10:29 premkvirtualenv

-rwxr-xr-x. 1 vagrant vagrant 111 3月 5 10:29 prermvirtualenv

確認

仮想環境を作ってみる。

$ mkvirtualenv env1
created virtual environment CPython3.6.8.final.0-64 in 224ms
  creator CPython3Posix(dest=/home/vagrant/.virtualenvs/env1, clear=False, no_vcs_ignore=False, global=False)
  seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/vagrant/.local/share/virtualenv)
    added seed packages: pip==21.3.1, setuptools==59.6.0, wheel==0.37.1
  activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator
virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/predeactivate
virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/postdeactivate
virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/preactivate
virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/postactivate
virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/get_env_details
(env1) $

$ mkvirtualenv env1

created virtual environment CPython3.6.8.final.0-64 in 224ms

creator CPython3Posix(dest=/home/vagrant/.virtualenvs/env1, clear=False, no_vcs_ignore=False, global=False)

seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/vagrant/.local/share/virtualenv)

added seed packages: pip==21.3.1, setuptools==59.6.0, wheel==0.37.1

activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator

virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/predeactivate

virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/postdeactivate

virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/preactivate

virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/postactivate

virtualenvwrapper.user_scripts creating /home/vagrant/.virtualenvs/env1/bin/get_env_details

(env1) $

python3の場所が仮想環境内になっていて、元のシステムの場所とは違う。

(env1) $ which python3
~/.virtualenvs/env1/bin/python3
(env1) $ deactivate
$ which python3
/usr/bin/python3

(env1) $ which python3

~/.virtualenvs/env1/bin/python3

(env1) $ deactivate

$ which python3

/usr/bin/python3

もう一つ仮想環境を作って、workonコマンドで見てみる。lsvirtualenvコマンドもあるが、workonコマンドとの違いがよくわからない。

$ mkvirtualenv env2
........
(env2) $ deactivate
$ workon
env1
env2

$ mkvirtualenv env2

........

(env2) $ deactivate

$ workon

env1

env2

仮想環境にモジュールをインストールしてもシステムに影響がないことを確認する。まずシステムにはNumpyモジュールがインストールされていないことを確認。

$ python3
Python 3.6.8 (default, Nov 16 2020, 16:55:22)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import numpy as np
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'numpy'

$ python3

Python 3.6.8 (default, Nov 16 2020, 16:55:22)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>> import numpy as np

Traceback (most recent call last):

File "<stdin>", line 1, in <module>

ModuleNotFoundError: No module named 'numpy'

仮想環境でもNumpyはインストールされていない。

$ workon env1
(env1) $ python3
Python 3.6.8 (default, Nov 16 2020, 16:55:22)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import numpy as np
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'numpy'

$ workon env1

(env1) $ python3

Python 3.6.8 (default, Nov 16 2020, 16:55:22)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>> import numpy as np

Traceback (most recent call last):

File "<stdin>", line 1, in <module>

ModuleNotFoundError: No module named 'numpy'

Python3をexit()で抜けて、仮想環境のコマンドラインでNumpyをインストール。

(env1) $ pip3 install numpy
Collecting numpy
  Downloading numpy-1.19.5-cp36-cp36m-manylinux2010_x86_64.whl (14.8 MB)
     |████████████████████████████████| 14.8 MB 14.8 MB/s
Installing collected packages: numpy
Successfully installed numpy-1.19.5

(env1) $ pip3 install numpy

Collecting numpy

Downloading numpy-1.19.5-cp36-cp36m-manylinux2010_x86_64.whl (14.8 MB)

|████████████████████████████████| 14.8 MB 14.8 MB/s

Installing collected packages: numpy

Successfully installed numpy-1.19.5

Python3でNumpyが使えるようになった。

(env1) $ python3
Python 3.6.8 (default, Nov 16 2020, 16:55:22)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import numpy as np
>>> np.array([1, 2, 3])
array([1, 2, 3])

(env1) $ python3

Python 3.6.8 (default, Nov 16 2020, 16:55:22)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>> import numpy as np

>>> np.array([1, 2, 3])

array([1, 2, 3])

Python3をexit()で抜けて、仮想環境からも抜ける。元の環境ではNumpyはインストールされていないことがわかる。

(env1) $ deactivate
$ python3
Python 3.6.8 (default, Nov 16 2020, 16:55:22)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import numpy as np
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'numpy'

(env1) $ deactivate

$ python3

Python 3.6.8 (default, Nov 16 2020, 16:55:22)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux

Type "help", "copyright", "credits" or "license" for more information.

>>> import numpy as np

Traceback (most recent call last):

File "<stdin>", line 1, in <module>

ModuleNotFoundError: No module named 'numpy'

virtualenvwrapperのコマンド

仮想環境の作成・有効化。WORKON_HOMEで設定したディレクトリーに作成される。

$ mkvirtualenv envname

仮想環境の無効化。

(envname) $ deactivate

仮想環境の一覧。

$ workon
または
$ lsvirtyalenv -b/-l

仮想環境の有効化。

$ workon envname

仮想環境ディレクトリーへの移動。

$ cdvirtualenv envname

仮想環境の削除。

$ rmvirtualenvname envname

概要

単純変数

コレクション

オブジェクト

フィルター

引数

チェーン

スペースとエラー

概要

プロジェクトの準備

アプリケーションの作成・登録

テンプレート配置

初期設定

配置場所

アプリケーション下

テンプレートディレクトリー作成

テンプレートファイル作成

プロジェクト直下

settings.py編集

テンプレートディレクトリー作成

テンプレートファイル作成

view関数の作成とルーティング

view関数の作成

view関数のルーティング登録

確認

DTL～テンプレート言語

概要

変数の展開

制御構造

概要

確認用プロジェクト

TEMPLATESの初期設定

DIRSでの設定

プロジェクトディレクトリー直下

サブディレクトリー下

APP_DIRSの設定

全てを探索させるTEMPLATESの設定

templatesのサブディレクトリー

概要

仕様

プロジェクトのスタート

アプリケーションの作成

settings.pyにアプリケーションを追加

viewの作成～views.py

ルーティング～urls.py

ブラウザーから接続

概要

プロジェクト名だけを指定する場合

既存のディレクトリーに作成する場合

概要

データベースクライアントのインストール

settings.py～各種設定

言語とタイムゾーン

データベース設定

ホスト許可

Vagrantの場合

Vagrantfileの設定

ゲスト側IP確認

開発用Webサーバー起動

ブラウザーで接続

概要

サーバー起動時エラー発生

データベース無効化で再挑戦

ブラウザーで接続不可

プライベートネットワーク設定

Djangoで許可されない

ALLOW_HOSTSを編集して接続

概要

手順

プロンプトの書式の確認

プロンプトの変更例

$や#だけにする

ユーザー名と時刻にする

一部に色を付ける

常時設定する

プロンプト書式に使える記号

色の設定

概要

許可がなくインストールできない

sudoで警告が出るがインストール

`$`や`#`だけにする