PyBlade

PyBlade is a lightweight, reactive template engine for Python. It brings reusable UI components and server-driven interactivity to your web apps using Python and HTML, without requiring a frontend framework.

[!WARNING] Beta: PyBlade is still experimental. APIs may change between releases and it is not yet recommended for production applications.

Installation

Install PyBlade from PyPI:

pip install pyblade

PyBlade integrates into your existing Python web application rather than replacing your application framework.

CLI

PyBlade includes a CLI for common development tasks:

pyblade init
pyblade serve
pyblade make:template
pyblade make:component
pyblade make:livecomponent

To see the available commands and options, run pyblade --help or pyblade <COMMAND> --help.

See the CLI documentation for more details.

Templates

PyBlade templates are regular .html files with additional syntax for layouts, conditions, loops, and components.

Layouts

@extends('layouts.base')

@block('content')
    <h1>Hello, {{ user.name }}!</h1>
@endblock

Conditions

@if(user.is_authenticated)
    <p>Welcome back, {{ user.name }}.</p>
@else
    <p>Please sign in.</p>
@endif

Loops

@for(post in posts)
    <article>
        <h2>{{ post.title }}</h2>
    </article>
@empty
    <p>No posts found.</p>
@endfor

Components

Reusable components as well as live components can be rendered directly from templates:

<pb-user-profile :user="user" />

They can also be invoked with the component directive:

@component('user-profile', {'user': user})

Framework Integration

PyBlade is designed to work with Python web frameworks and can be introduced into an existing application.

Only django is fully supported for now, we will add other frameworks support incrementally.

Editor Support

PyBlade IntelliSense for VS Code provides:

• Syntax highlighting
• Snippets
• Directive completion
• Component completion

Additional editor integrations are planned.

Project Status

PyBlade is currently in beta.

The template engine, component system, CLI, Live Components, and framework integrations are actively evolving. APIs and conventions may change before the first stable release.

If you want to follow the project, report a bug, request a feature, or share feedback, visit the GitHub repository or PyBlade Feedback.

Contributing

Contributions are welcome, including bug reports, fixes, documentation, examples, editor tooling, and new ideas.

Before contributing, please read:

• Contributing Guide
• Code of Conduct
• Security Policy

You can also contribute to the wider PyBlade ecosystem:

• PyBlade Documentation, the source for docs.pyblade.com

• PyBlade IntelliSense for VS Code

• PyBlade IntelliSense for Sublime Text

• PyBlade IntelliSense for JetBrains IDEs

• PyBlade IntelliSense for Atom

If you discover a security vulnerability, please follow the Security Policy instead of opening a public issue.

Acknowledgements

PyBlade's template syntax is inspired by Laravel Blade, while its Live Components are inspired by Livewire.

PyBlade builds on ideas and work from the Python, Django, and Laravel communities.

Special thanks to Michael Dimchuk for graciously releasing the PyBlade name on PyPI for this project.

License

PyBlade is licensed under the BSD 3-Clause License.