메뉴
Adds integration of the Chameleon template language to Flask and Quart. Use when writing Python code that uses the chameleon_flask package.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/mikeckennedy/chameleon-flask --skill chameleon-flask명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | chameleon-flask |
| description | Adds integration of the Chameleon template language to Flask and Quart. Use when writing Python code that uses the chameleon_flask package. |
| license | MIT |
| compatibility | Requires Python >=3.10. |
Adds integration of the Chameleon template language to Flask and Quart.
pip install chameleon-flask
| Need | Use |
|---|---|
| Render a Chameleon template from a Flask/Quart view | @chameleon_flask.template('home/index.pt') on the view function |
| Return a friendly 404 page from a view | chameleon_flask.not_found() |
| Build a rendered Response outside a decorated view | chameleon_flask.response(template_file, **model) |
| Get rendered HTML as a plain string | chameleon_flask.engine.render(template_file, **model) |
| Use Alpine.js/Vue shorthand attributes in templates | global_init(..., restricted_namespace=False) |
Set up the Chameleon template engine once at app startup.
global_init: Initialize the Chameleon template engineengine.clearRender templates from Flask/Quart view functions (sync or async) and return friendly 404s.
template: Decorate a Flask or Quart view method to render a Chameleon templatenot_found: Abort the current view and render a friendly 404 pageRender a template to a Response or raw HTML without the decorator.
response: Render a Chameleon template directly to a flask.Responseengine.renderErrors raised by the engine. Importable from chameleon_flask directly or from chameleon_flask.exceptions.
FlaskChameleonException: Base exception for all chameleon-flask errorsFlaskChameleonNotFoundException: Raised by not_found() to signal that a view should render a 404 pageA complete, minimal app — engine init, a decorated view, and the template it renders. The @template path is always relative to the folder passed to global_init().
# app.py
from pathlib import Path
import flask
import chameleon_flask
app = flask.Flask(__name__)
# Init once at startup, BEFORE any decorated view is defined.
templates = Path(__file__).resolve().parent / 'templates'
chameleon_flask.global_init(str(templates), auto_reload=True) # auto_reload for dev only
@app.get('/')
@chameleon_flask.template('home/index.pt') # route decorator OUTERMOST, @template just above the function
def index():
return {'title': 'Home', 'items': ['a', 'b', 'c']} # dict == the template model
<!-- templates/home/index.pt -->
<!DOCTYPE html>
<html lang="en">
<body>
<h1>${title}</h1>
<ul>
<li tal:repeat="item items">${item}</li>
</ul>
</body>
</html>
Chameleon templates are valid XML/HTML where directives live in tal:, metal:, and i18n: attributes. There is no {% ... %} or {{ ... }} — do not use Jinja/Django syntax. Interpolation uses ${ ... } and may contain arbitrary Python expressions.
<!-- Interpolation: any Python expression inside ${ } -->
<h1>Hello, ${user.name.title()}!</h1>
<p>You have ${len(items)} item(s).</p>
<!-- Loop -->
<li tal:repeat="item items">${item.name} — ${item.price}</li>
<!-- The repeat variable exposes index/number/even/odd/first/last -->
<li tal:repeat="item items" tal:attributes="class 'odd' if repeat.item.odd else 'even'">
${repeat.item.number}. ${item}
</li>
<!-- Condition (element is omitted entirely when falsy) -->
<div tal:condition="user">Welcome back, ${user.name}.</div>
<div tal:condition="not user">Please sign in.</div>
<!-- Set element content / replace whole element -->
<span tal:content="message">placeholder shown only in a browser preview</span>
<span tal:replace="formatted_date">2024-01-01</span>
<!-- Set attributes (semicolon-separated); escaping is automatic -->
< =>${item.name}
Total: ${total}
Escaping is on by default (${expr} is HTML-escaped). Use structure: to emit already-safe HTML without escaping: <div tal:content="structure: raw_html"></div>.
METAL is how Chameleon does template inheritance / partials — the equivalent of Jinja's {% extends %}/{% block %}.
<!-- templates/shared/layout.pt -->
<html metal:define-macro="layout">
<head><title>${title}</title></head>
<body>
<main metal:define-slot="content">default content</main>
</body>
</html>
<!-- templates/home/index.pt -->
<div metal:use-macro="load: ../shared/layout.pt">
<div metal:fill-slot="content">
<h1>${title}</h1>
</div>
</div>
With an explicit path (@template('catalog/item.pt')) the string is resolved relative to the global_init() folder. With the bare form (@template or @template()) the path is derived once at decoration time as {last segment of module}/{function_name}.html, falling back to .pt if the .html file does not exist on disk.
my_app/
├── app.py # global_init() here, before views are imported/defined
├── views/
│ └── home.py # def index(...) -> bare @template looks for home/index.html|.pt
├── templates/
│ ├── home/index.pt
│ ├── errors/404.pt # default target of not_found()
│ └── shared/layout.pt # METAL macros
└── static/
The same decorator API works for both frameworks and for both sync and async views — async is detected automatically, so no separate import or flag is needed. The library never imports Quart; it recognizes Quart responses through the shared werkzeug response base class.
# Works identically whether app is flask.Flask(__name__) or quart.Quart(__name__)
@app.get('/')
@chameleon_flask.template('home/index.pt')
async def index():
return {'items': await load_items()}
restricted_namespace=True (the default) makes Chameleon reject non-TAL/METAL/i18n namespaced attributes, which includes Alpine.js/Vue shorthand like @click, :class, and x-data. Initialize with restricted_namespace=False to allow them, then use the shorthand normally in templates.
chameleon_flask.global_init(str(templates), restricted_namespace=False)
<div x-data="{ open: false }">
<button @click="open = !open">Toggle</button>
<div :class="{ hidden: !open }">Content</div>
</div>
Every page on the documentation site has a plain-Markdown twin: swap the .html extension for .md to get token-efficient source without the site chrome. For example https://mkennedy.codes/docs/chameleon-flask/reference/template.html is also available at https://mkennedy.codes/docs/chameleon-flask/reference/template.md. Prefer the .md form when reading these docs programmatically.