Metadata-Version: 2.5
Name: kotway
Version: 0.1.5
Summary: Build web apps in Python.
Project-URL: Homepage, https://github.com/SKbarbon/kotway
Project-URL: Repository, https://github.com/SKbarbon/kotway
Project-URL: Issues, https://github.com/SKbarbon/kotway/issues
Author-email: SKbarbon <no@suchthing.com>
License: MIT License
        
        Copyright (c) 2026 SKbarbon
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: flask
Requires-Dist: flask-cors
Requires-Dist: pydantic
Description-Content-Type: text/markdown

# kotway
kotway is a framework that allows building web applications in Python only without prior experience in web frontend development.

## Peak 👁️🐽👁️
Let's peak to an example app. It's VERY NOT simple and complex:

```python
import kotway

def main (page: kotway.Page):
    page.add(
        kotway.Text("Hello, kotway!")
    )

kotway.App(main).run()
```
**I lied 🤭. Confetti 🎊!!!**, You made A WEB APP 🤯!

## Capabilities
Cleans your room, watch movies with you, and--
Wait, opps spoilers 😁.

### ONLY Python 👻
Yup. Everything else is a ghost. Build EVERYTHING in your web app using JUST Python. No html, no javascript, just our cute python.

### You choose the publishing 🛩️
Kotway supports BOTH server-driven UI and static websites.

You can make your web app runs its logic on your server, while only the UI is running on the client.

But also, you can choose to publish your app as a static website. And YES, it means python running on the browser!!!

### Flexibility and extensibility 💪
kotway is SUPER flexible. You can modify nearly everything inside it!

You can customize web root, the look, stylesheets, add your own controls, access any property..

And since it rely on native web tech, the UI is as fast as the browser.

## Installation 🧑‍🏫
To install `kotway` library, run this on your terminal:

1. Create a virtual environment (optional)
```shell
python -m venv venv
```

2. Install `kotway` using pip
```shell
pip install kotway
```

## Docs 🦆
I love ducks 🦆, but let's talk about docs.

I'm trying my best to cover everything. Until we have a real docs page, all documentation will be here: [CLICK ME, LES GO🐎!](https://github.com/SKbarbon/kotway/tree/main/docs)

## Note
The library is still a baby. A lot of features are coming, and if you encounter ANY issue please submit an issue here: [Issues page](https://github.com/SKbarbon/kotway/issues)

Or if you just wanna ask a question or talk about kotway, you can go [Here](https://github.com/SKbarbon/kotway/discussions).

Contributions are welcome.