思うようにrender_templateでhtmlの表示ができない

Question

前提・実現したいこと

別フォルダでwebサイト関連のファイルを管理したい。
web.pyからrender_templateを使って同じディレクトリにあるtemplatesのhtmlを表示させたい。

発生している問題・エラーメッセージ

TemplateNotFoundが発生して表示されない。

[2020-09-20 00:13:10,048] ERROR in app: Exception on / [GET]
 ~
 ~
 ~
jinja2.exceptions.TemplateNotFound: index.html
127.0.0.1 - - [20/Sep/2020 00:13:10] "GET / HTTP/1.1" 500 -

該当のソースコード

main.py

from web import web
from flask import Flask

app = Flask(__name__)


@app.route("/")
def index():
    return web.index_fnc()


if __name__ == "__main__":
    app.run(port=8080)

web.py

from flask import render_template, request


def index_fnc():
    name = request.args.get("name", default="NONE", type=str)
    return render_template("index.html", name=name)

ディレクトリ

Projects
  /venv
  /web
    /web.py
    /__init__.py
    /templates
      /index.html
  /main.py

試したこと

main.pyと同じところにtemplatesを置いたら表示されました。
ドキュメント通りには従ったつもりです。

補足情報（FW/ツールのバージョンなど）

Python 3.8.6rc1
Flask 1.1.2
Werkzeug 1.0.1

Pythonを使い始めたばかりなのでわかりやすく解説してくれると助かります。

Answer 1

https://flask.palletsprojects.com/en/1.1.x/api/#flask.Flask

テンプレートの位置はFlaskの初期化パラメータtemplate_folderで指定します。

template_folder – the folder that contains the templates that should be used by the application. Defaults to 'templates' folder in the root path of the application.

デフォルトは'templates'で、アプリケーションのルートパスからの相対パスなので ルートパス/templates が使われます。

アプリケーションのルートパスは何かというとこれも初期化パラメータです。

root_path – Flask by default will automatically calculate the path to the root of the application. In certain situations this cannot be achieved (for instance if the package is a Python 3 namespace package) and needs to be manually defined.

これもデフォルトでだいたい決まります。何を基準にするかというと、初期化パラメータの第1引数です。

普通app = Flask(__name__)とするこの__name__ですね。

Flaskの初期化をパッケージの__init__.pyなどでするとそのパッケージ名が、質問のコードの様に実行するファイルですると__main__が渡ります。

パッケージ名を渡すと パッケージ名/templates をテンプレートフォルダとして使います。

__main__を渡すと実行時のカレントディレクトリを使います。そのため「main.pyと同じところにtemplatesを置いたら表示されました。」となります。

---

望みの挙動を実現する選択肢はいろいろあるのでしょうが、正直、このあたりの挙動をわざわざ指定してデフォルトから動かすことは（妥当な理由が示されない限り）おすすめしません。

Flaskインスタンスの初期化をweb/__init__.pyに移すのがいい気はします。