Metadata-Version: 2.4
Name: webloom
Version: 0.2.0
Summary: Webloom: Python-first HTML/CSS DSL with optional Django integration
Author: maksi
License-Expression: MIT
Project-URL: Homepage, https://pypi.org/project/webloom/
Project-URL: Documentation, https://pypi.org/project/webloom/
Keywords: webloom,python,html,css,django,ui,dsl
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: django
Requires-Dist: Django>=5.0; extra == "django"
Dynamic: license-file

# 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](CONTRIBUTING.md).

## License

MIT, see [LICENSE](LICENSE).
