webloom 0.1.1

Webloom: Python-first HTML/CSS DSL with optional Django integration

Webloom

Webloom is a Python-first library for building and rendering web pages. It lets you describe page structure and styles with Python classes and render readable HTML output.

Installation

Core package:

pip install webloom

Optional Django integration:

pip install webloom[django]

How to Work with Webloom

1. Build page structure from class-based elements.
2. Keep styles in reusable Python style objects.
3. Compose full documents through the page layer.
4. Render HTML on the fly for server-side responses.
5. Use optional Django integration when you need class-based views and template hooks.

Recommended Workflow

1. Separate content and styles into different Python modules.
2. Keep pages modular (for example by route or domain section).
3. Reuse style objects across pages to keep visual consistency.
4. Treat rendering as a server concern (HTML generated at request time).
5. Move framework-specific logic (Django) into integration modules.

Package Scope

• webloom: public API surface.
• webloom_core: rendering and element system.
• webloom_django: optional integration for Django.

Documentation for Contributors

Architecture, internal design, quality checks, and release flow are in CONTRIBUTING.md.

License

MIT, see LICENSE.