Metadata-Version: 2.1
Name: Flask-HTML
Version: 1.1.2
Summary: HTML generator for Flask applications. Make your HTML code more readable and easier to maintain.
Home-page: https://github.com/Odya-LLC/flask_html
Author: odya
Author-email: mmuhtor@gmail.com
License: MIT
Platform: 3.6
Platform: 3.7
Platform: 3.8
Platform: 3.9
Platform: 3.10
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: Flask


# Flask-HTML
![Flask](https://img.shields.io/static/v1?label=under&message=Development&color=yellow&logo=flask)
![GitHub top language](https://img.shields.io/github/languages/top/Odya-LLC/flask_html)
![LICENCE](https://img.shields.io/github/license/Odya-LLC/flask_html)
![Odya](https://img.shields.io/static/v1?label=Developed_by&message=Odya&color=green&logo=python)



HTML generator for Flask applications. Make your HTML code more readable and easier to maintain.
## Installation
```bash
pip install flask_html
```

## Usage
```python
from flask_html import Page, Head
from flask_html.core import Style
from flask_html.tags import Body, Div, P
from flask import request
@app.route('/')
def index():
    head = Head('Title', ['link to css'],['link to js'], [{"meta_property": "value"}])
    page = Page(head)
    body = Body(page, styles=Style(color="red", padding_top="15px"),classes=['class1', 'class2'], id='body_id',elements=[
        Div(styles=Style(margin="10px"), classes=['class1', 'class2'], id='div_id', elements=[
            P(styles=Style(color="blue"), classes=['class1', 'class2'], id='p_id', elements=[
                "Hello World"
            ])
        ])
    ])
    return page.render(body, request)
```

## Elements

### Example of Div elements
```python
"""Div HTML element

Args:
    styles (Style, optional): Inline css styles. Defaults to None.
    classes (List[str], optional): List of class names. Defaults to [].
    id (str, optional): Unique ID. Defaults to None.
    elements (List[object], optional): List of child elements. Defaults to [].
    props (Dict[str, str], optional): Additional tag properties. Defaults to {}.
"""
Div(styles=None, classes=[], id=None, elements=[], props={})
```
## To Do

 - [x] All HTML tags
 - [x] Inline CSS
 - [x] Classes
 - [x] ID
 - [x] Child elements
 - [x] Additional tag properties
 - [x] JS
 - [x] Meta tags
 - [x] Link tags
 - [x] Title
 - [x] Head
 - [x] Body
 - [x] Page
 - [x] Element event listeners
 - [ ] DOM manipulation
 - [ ] More examples

## License
This project is licensed under the MIT License (see the `LICENSE` file for details).
