Metadata-Version: 2.4
Name: radiant-framework
Version: 0.3
Summary: Radiant Framework
Author-email: Yeison Cardona <yencardonaal@unal.edu.co>
Maintainer-email: Yeison Cardona <yencardonaal@unal.edu.co>
License: BSD-2-Clause
Project-URL: Download, https://github.com/dunderlab/python-radiant.framework
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: Jinja2
Requires-Dist: tornado
Requires-Dist: brython
Dynamic: license-file

# Radiant: A Pythonic Web Framework

A lightweight and Python-first framework for building web applications with Brython.

![GitHub top language](https://img.shields.io/github/languages/top/dunderlab/python-radiant_framework?)
![PyPI - License](https://img.shields.io/pypi/l/radiant-framework?)
![PyPI](https://img.shields.io/pypi/v/radiant?)
![PyPI - Status](https://img.shields.io/pypi/status/radiant-framework?)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/radiant?)
![GitHub last commit](https://img.shields.io/github/last-commit/dunderlab/python-radiant_framework?)
![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/dunderlab/python-radiant_framework?)
[![Documentation Status](https://readthedocs.org/projects/radiant-framework/badge/?version=latest)](https://radiant-framework.readthedocs.io/en/latest/?badge=latest)

## Why Radiant?

Radiant is a modern web framework that enables Python developers to build full-stack web applications without writing JavaScript. It leverages Brython to run Python code directly in the browser, providing a seamless development experience.

### Target Audience

Radiant is designed for Python developers who want to:

- Build web applications entirely in Python without JavaScript knowledge
- Create interactive web interfaces with a Pythonic approach 
- Leverage Python's simplicity and expressiveness for frontend development
- Benefit from Python's rich ecosystem of libraries and tools
- Avoid context switching between Python and JavaScript
- Develop full-stack applications with a single language
- Learn web development while staying in a familiar Python environment

Whether you're a Python enthusiast, a web developer looking for a Python-first approach, or a beginner wanting to start web development with Python, Radiant provides an intuitive framework for your needs.


## Key Features

- **Pure Python Development**: Build web applications without writing JavaScript
- **Component-Based Architecture**: Create reusable UI components in Python
- **Real-time Updates**: Built-in WebSocket support for live data updates
- **Template System**: Flexible HTML templating with Python syntax
- **State Management**: Simple state handling and reactivity
- **Browser API Integration**: Access browser features through Python interfaces
- **Modern UI Tools**: Built-in support for CSS frameworks and modern UI patterns

## Getting Started

### Prerequisites

- Python 3.7 or higher
- Basic understanding of Python
- pip package manager

### Installation

Install Radiant using pip:

~~~bash
pip install radiant-framework
~~~

### Quick Example

Here's a minimal example to get you started:



```python
from radiant.framework.server import RadiantInterfaceApp
from browser import document, html


# Define a simple application using RadiantInterfaceApp
class MinimalApp(RadiantInterfaceApp):

    def on_mount(self):
        document <= html.H1("Minimal Interface App")
        document <= html.P("This is a single-page app using Radiant.")


# Launch the app with default settings
if __name__ == "__main__":
    MinimalApp.serve()
```



Visit http://localhost:5050 to see your first Radiant application!

