Django模板语言实时解释器（django-template-repl）技术文档

1. 安装指南

首先，将django-template-repl添加到您的Django项目的settings.INSTALLED_APPS中。

INSTALLED_APPS = [
    # ...
    'template_repl',
    # ...
]

确保在添加应用后运行数据库迁移命令，以应用任何必要的数据库更新。

python manage.py migrate

2. 项目的使用说明

django-template-repl 是一个用于Django模板语言的实时解释器（REPL），类似于CPython的shell，但它解释的是模板代码而不是Python代码。可以通过管理命令或模板标签来调用它。

管理命令使用

通过以下命令启动模板shell：

python manage.py templateshell

如果你想要以特定位置的上下文来启动shell，可以使用-u选项并传入URL：

python manage.py templateshell -u /admin/foo/bar/

你也可以使用-c选项直接提供上下文：

python manage.py templateshell -c "{'foo': 'FOO', 'bar': True}"

然后在shell中编写模板代码：

>>> {% if bar %}
... {{ foo }}
... {% endif %}
FOO
>>>

此外，templateshell管理命令还支持--pdb选项，它允许你将上下文加载到命名空间并启动PDB调试器shell。该选项可以与-u（--url）和-c（--context）选项一起使用，并提供一个vars列表显示上下文变量的名称。

python manage.py templateshell -u /admin/ --pdb

模板标签使用

你也可以在模板中使用repl标签来创建一个REPL，它将采用调用模板的上下文：

{% load repl %}{% repl %}

如果你需要启动一个真实的PDB shell，可以通过给标签传递一个pdb参数来实现，它将上下文加载到PDB命名空间：

{% load repl %}{% repl pdb %}

3. 项目API使用文档

本项目主要是通过Django管理命令和模板标签进行操作，没有提供独立的API接口。

4. 项目安装方式

本项目可以通过以下两种方式进行安装：

通过PyPI安装

使用pip工具直接从Python包索引（PyPI）安装：

pip install django-template-repl

确保在安装后，将django-template-repl添加到你的Django项目的INSTALLED_APPS中，并运行数据库迁移。

通过源代码安装

从GitHub克隆项目代码到本地，然后通过pip安装：

git clone https://github.com/yourusername/django-template-repl.git
cd django-template-repl
pip install .

同样，别忘了将应用添加到INSTALLED_APPS并执行数据库迁移。