pyweft 0.2.0__tar.gz → 0.2.1__tar.gz

{pyweft-0.2.0 → pyweft-0.2.1}/CHANGELOG.md

@@ -8,6 +8,11 @@ releasing moves them under the new version (see [RELEASING.md](RELEASING.md)).
 
 ## Unreleased
 
+## 0.2.1
+
+- The PyPI page installs from PyPI, and its links to the guide and the
+  toolkit work there.
+
 ## 0.2.0
 
 The first release. (It starts at 0.2.0 because an earlier, unrelated

{pyweft-0.2.0 → pyweft-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyweft
-Version: 0.2.0
+Version: 0.2.1
 Summary: A UI framework for Python: XML templates, Python code-behind, one render core for web, desktop and mobile.
 Project-URL: Homepage, https://github.com/prassanthn/PyWeft
 Project-URL: Documentation, https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md
@@ -56,7 +56,7 @@ is plain Python fields, and the page updates itself after every event.
 
 > **Status:** a working proof of concept. Web apps and desktop apps (run
 > locally or built into a program to hand out) work today. APIs may still
-> change. Not on PyPI yet, so you install from GitHub (below).
+> change.
 
 ## Quick start
 
@@ -64,7 +64,7 @@ You need Python 3.10 or newer. With [uv](https://docs.astral.sh/uv/):
 
 ```bash
 uv init myproject && cd myproject
-uv add git+https://github.com/prassanthn/PyWeft.git
+uv add pyweft
 uv run pyweft new myapp
 uv run pyweft run myapp
 ```
@@ -76,7 +76,7 @@ time, cached after that); then it comes alive.
 With pip instead:
 
 ```bash
-pip install git+https://github.com/prassanthn/PyWeft.git
+pip install pyweft
 pyweft new myapp
 pyweft run myapp
 ```
@@ -130,13 +130,13 @@ height = 800
 
 ## Ready-made controls (no HTML or CSS needed)
 
-[`pyweft-ui`](packages/pyweft-ui/README.md) gives you styled, accessible
+[`pyweft-ui`](https://github.com/prassanthn/PyWeft/blob/main/packages/pyweft-ui/README.md) gives you styled, accessible
 controls as components: buttons, text fields, selects, checkboxes, switches,
 cards, tabs, sortable tables, dialogs, alerts, toasts, layout and light/dark
 themes.
 
 ```bash
-uv add "pyweft-ui @ git+https://github.com/prassanthn/PyWeft.git#subdirectory=packages/pyweft-ui"
+uv add pyweft-ui
 ```
 
 Add `"pyweft-ui"` to the `dependencies` list in `myapp/pyproject.toml`, then
@@ -217,20 +217,20 @@ To see every control live, clone this repository and run
 
 | You want to | Read |
 |---|---|
-| Learn the basics: state, templates, events | [Getting started](docs/getting-started.md), sections 1–3 |
-| Run code when a component appears, updates or goes away | [Lifecycle](docs/getting-started.md#lifecycle-when-your-code-runs) |
-| Split an app into components, use slots | [Composing components](docs/getting-started.md#4-composing-components) |
-| Build an app with several pages | [Pages and navigation](docs/getting-started.md#pages-and-navigation) |
-| Handle forms and keyboard input | [Binding form controls](docs/getting-started.md#binding-form-controls), [event modifiers](docs/getting-started.md#event-modifiers) |
-| Load data, run async code, do heavy work | [Async handlers](docs/getting-started.md#async-handlers-and-background-work), [`run_in_background`](docs/getting-started.md#heavy-work-run_in_background) |
-| Style with Tailwind or Bootstrap | [Using CSS frameworks](docs/getting-started.md#using-css-frameworks) |
-| Build screens with the ready-made controls | [pyweft-ui guide](packages/pyweft-ui/docs/guide.md), then the [reference](packages/pyweft-ui/README.md) |
-| Deploy your app | [Building for deployment](docs/getting-started.md#building-for-deployment) |
-| Run it as a desktop app | [A desktop app](docs/getting-started.md#a-desktop-app-pyweft-run---desktop) |
-| Hand out a desktop app (`.exe`, `.app`) | [Handing out a desktop app](docs/getting-started.md#handing-out-a-desktop-app-pyweft-build---desktop) |
-| Open and save files, ask for confirmation | [Files and dialogs](docs/getting-started.md#files-and-dialogs) |
-| Name the app, give it an icon | [The app's title and icon](docs/getting-started.md#the-apps-title-and-icon) |
-| Test components without a browser | [Using the engine from plain Python](docs/getting-started.md#6-using-the-engine-from-plain-python) |
+| Learn the basics: state, templates, events | [Getting started](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md), sections 1–3 |
+| Run code when a component appears, updates or goes away | [Lifecycle](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#lifecycle-when-your-code-runs) |
+| Split an app into components, use slots | [Composing components](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#4-composing-components) |
+| Build an app with several pages | [Pages and navigation](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#pages-and-navigation) |
+| Handle forms and keyboard input | [Binding form controls](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#binding-form-controls), [event modifiers](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#event-modifiers) |
+| Load data, run async code, do heavy work | [Async handlers](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#async-handlers-and-background-work), [`run_in_background`](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#heavy-work-run_in_background) |
+| Style with Tailwind or Bootstrap | [Using CSS frameworks](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#using-css-frameworks) |
+| Build screens with the ready-made controls | [pyweft-ui guide](https://github.com/prassanthn/PyWeft/blob/main/packages/pyweft-ui/docs/guide.md), then the [reference](https://github.com/prassanthn/PyWeft/blob/main/packages/pyweft-ui/README.md) |
+| Deploy your app | [Building for deployment](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#building-for-deployment) |
+| Run it as a desktop app | [A desktop app](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#a-desktop-app-pyweft-run---desktop) |
+| Hand out a desktop app (`.exe`, `.app`) | [Handing out a desktop app](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#handing-out-a-desktop-app-pyweft-build---desktop) |
+| Open and save files, ask for confirmation | [Files and dialogs](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#files-and-dialogs) |
+| Name the app, give it an icon | [The app's title and icon](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#the-apps-title-and-icon) |
+| Test components without a browser | [Using the engine from plain Python](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#6-using-the-engine-from-plain-python) |
 
 `examples/todo/` is a small complete app, and `examples/shop/` one with
 pages; run them from a clone with `uv run pyweft run examples/todo`.
@@ -279,8 +279,8 @@ uv run pyweft run packages/pyweft-ui/gallery  # every control
 
 With pip: `pip install -e ".[dev]"` and `pip install -e packages/pyweft-ui`.
 
-Releases go to PyPI by pushing a version tag; [RELEASING.md](RELEASING.md)
-has the steps, and [CHANGELOG.md](CHANGELOG.md) what each release changed.
+Releases go to PyPI by pushing a version tag; [RELEASING.md](https://github.com/prassanthn/PyWeft/blob/main/RELEASING.md)
+has the steps, and [CHANGELOG.md](https://github.com/prassanthn/PyWeft/blob/main/CHANGELOG.md) what each release changed.
 
 ```
 src/pyweft/           the framework (zero runtime dependencies)
@@ -311,9 +311,9 @@ handlers and Web Worker background work; file and confirmation dialogs on
 both targets; the app's title and icon, and window settings; scoped styles
 and CSS framework support; the `pyweft` CLI with hot reload, static builds
 and pre-rendered first screens; `pyweft-ui` with 22 keyboard-accessible
-controls and a gallery.
+controls and a gallery; both released on PyPI.
 
-**Next:** publishing `pyweft` and `pyweft-ui` to PyPI; more controls (menus,
+**Next:** more controls (menus,
 a date picker, form validation); installers (`.msi`, `.dmg`) and code
 signing for desktop apps.
 
@@ -321,4 +321,4 @@ signing for desktop apps.
 
 ## License
 
-MIT. See [LICENSE](LICENSE).
+MIT. See [LICENSE](https://github.com/prassanthn/PyWeft/blob/main/LICENSE).

{pyweft-0.2.0 → pyweft-0.2.1}/README.md

@@ -27,7 +27,7 @@ is plain Python fields, and the page updates itself after every event.
 
 > **Status:** a working proof of concept. Web apps and desktop apps (run
 > locally or built into a program to hand out) work today. APIs may still
-> change. Not on PyPI yet, so you install from GitHub (below).
+> change.
 
 ## Quick start
 
@@ -35,7 +35,7 @@ You need Python 3.10 or newer. With [uv](https://docs.astral.sh/uv/):
 
 ```bash
 uv init myproject && cd myproject
-uv add git+https://github.com/prassanthn/PyWeft.git
+uv add pyweft
 uv run pyweft new myapp
 uv run pyweft run myapp
 ```
@@ -47,7 +47,7 @@ time, cached after that); then it comes alive.
 With pip instead:
 
 ```bash
-pip install git+https://github.com/prassanthn/PyWeft.git
+pip install pyweft
 pyweft new myapp
 pyweft run myapp
 ```
@@ -101,13 +101,13 @@ height = 800
 
 ## Ready-made controls (no HTML or CSS needed)
 
-[`pyweft-ui`](packages/pyweft-ui/README.md) gives you styled, accessible
+[`pyweft-ui`](https://github.com/prassanthn/PyWeft/blob/main/packages/pyweft-ui/README.md) gives you styled, accessible
 controls as components: buttons, text fields, selects, checkboxes, switches,
 cards, tabs, sortable tables, dialogs, alerts, toasts, layout and light/dark
 themes.
 
 ```bash
-uv add "pyweft-ui @ git+https://github.com/prassanthn/PyWeft.git#subdirectory=packages/pyweft-ui"
+uv add pyweft-ui
 ```
 
 Add `"pyweft-ui"` to the `dependencies` list in `myapp/pyproject.toml`, then
@@ -188,20 +188,20 @@ To see every control live, clone this repository and run
 
 | You want to | Read |
 |---|---|
-| Learn the basics: state, templates, events | [Getting started](docs/getting-started.md), sections 1–3 |
-| Run code when a component appears, updates or goes away | [Lifecycle](docs/getting-started.md#lifecycle-when-your-code-runs) |
-| Split an app into components, use slots | [Composing components](docs/getting-started.md#4-composing-components) |
-| Build an app with several pages | [Pages and navigation](docs/getting-started.md#pages-and-navigation) |
-| Handle forms and keyboard input | [Binding form controls](docs/getting-started.md#binding-form-controls), [event modifiers](docs/getting-started.md#event-modifiers) |
-| Load data, run async code, do heavy work | [Async handlers](docs/getting-started.md#async-handlers-and-background-work), [`run_in_background`](docs/getting-started.md#heavy-work-run_in_background) |
-| Style with Tailwind or Bootstrap | [Using CSS frameworks](docs/getting-started.md#using-css-frameworks) |
-| Build screens with the ready-made controls | [pyweft-ui guide](packages/pyweft-ui/docs/guide.md), then the [reference](packages/pyweft-ui/README.md) |
-| Deploy your app | [Building for deployment](docs/getting-started.md#building-for-deployment) |
-| Run it as a desktop app | [A desktop app](docs/getting-started.md#a-desktop-app-pyweft-run---desktop) |
-| Hand out a desktop app (`.exe`, `.app`) | [Handing out a desktop app](docs/getting-started.md#handing-out-a-desktop-app-pyweft-build---desktop) |
-| Open and save files, ask for confirmation | [Files and dialogs](docs/getting-started.md#files-and-dialogs) |
-| Name the app, give it an icon | [The app's title and icon](docs/getting-started.md#the-apps-title-and-icon) |
-| Test components without a browser | [Using the engine from plain Python](docs/getting-started.md#6-using-the-engine-from-plain-python) |
+| Learn the basics: state, templates, events | [Getting started](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md), sections 1–3 |
+| Run code when a component appears, updates or goes away | [Lifecycle](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#lifecycle-when-your-code-runs) |
+| Split an app into components, use slots | [Composing components](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#4-composing-components) |
+| Build an app with several pages | [Pages and navigation](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#pages-and-navigation) |
+| Handle forms and keyboard input | [Binding form controls](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#binding-form-controls), [event modifiers](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#event-modifiers) |
+| Load data, run async code, do heavy work | [Async handlers](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#async-handlers-and-background-work), [`run_in_background`](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#heavy-work-run_in_background) |
+| Style with Tailwind or Bootstrap | [Using CSS frameworks](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#using-css-frameworks) |
+| Build screens with the ready-made controls | [pyweft-ui guide](https://github.com/prassanthn/PyWeft/blob/main/packages/pyweft-ui/docs/guide.md), then the [reference](https://github.com/prassanthn/PyWeft/blob/main/packages/pyweft-ui/README.md) |
+| Deploy your app | [Building for deployment](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#building-for-deployment) |
+| Run it as a desktop app | [A desktop app](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#a-desktop-app-pyweft-run---desktop) |
+| Hand out a desktop app (`.exe`, `.app`) | [Handing out a desktop app](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#handing-out-a-desktop-app-pyweft-build---desktop) |
+| Open and save files, ask for confirmation | [Files and dialogs](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#files-and-dialogs) |
+| Name the app, give it an icon | [The app's title and icon](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#the-apps-title-and-icon) |
+| Test components without a browser | [Using the engine from plain Python](https://github.com/prassanthn/PyWeft/blob/main/docs/getting-started.md#6-using-the-engine-from-plain-python) |
 
 `examples/todo/` is a small complete app, and `examples/shop/` one with
 pages; run them from a clone with `uv run pyweft run examples/todo`.
@@ -250,8 +250,8 @@ uv run pyweft run packages/pyweft-ui/gallery  # every control
 
 With pip: `pip install -e ".[dev]"` and `pip install -e packages/pyweft-ui`.
 
-Releases go to PyPI by pushing a version tag; [RELEASING.md](RELEASING.md)
-has the steps, and [CHANGELOG.md](CHANGELOG.md) what each release changed.
+Releases go to PyPI by pushing a version tag; [RELEASING.md](https://github.com/prassanthn/PyWeft/blob/main/RELEASING.md)
+has the steps, and [CHANGELOG.md](https://github.com/prassanthn/PyWeft/blob/main/CHANGELOG.md) what each release changed.
 
 ```
 src/pyweft/           the framework (zero runtime dependencies)
@@ -282,9 +282,9 @@ handlers and Web Worker background work; file and confirmation dialogs on
 both targets; the app's title and icon, and window settings; scoped styles
 and CSS framework support; the `pyweft` CLI with hot reload, static builds
 and pre-rendered first screens; `pyweft-ui` with 22 keyboard-accessible
-controls and a gallery.
+controls and a gallery; both released on PyPI.
 
-**Next:** publishing `pyweft` and `pyweft-ui` to PyPI; more controls (menus,
+**Next:** more controls (menus,
 a date picker, form validation); installers (`.msi`, `.dmg`) and code
 signing for desktop apps.
 
@@ -292,4 +292,4 @@ signing for desktop apps.
 
 ## License
 
-MIT. See [LICENSE](LICENSE).
+MIT. See [LICENSE](https://github.com/prassanthn/PyWeft/blob/main/LICENSE).

{pyweft-0.2.0 → pyweft-0.2.1}/docs/getting-started.md

@@ -62,18 +62,17 @@ later mobile: only the transport differs.
 
 ## 1. Install
 
-PyWeft is not on PyPI yet, so install it straight from GitHub. With uv:
+With uv:
 
 ```bash
 uv init myproject && cd myproject
-uv add git+https://github.com/prassanthn/PyWeft.git
+uv add pyweft
 uv run pyweft new myapp
 uv run pyweft run myapp
 ```
 
-With pip, the equivalent is
-`pip install git+https://github.com/prassanthn/PyWeft.git`, then `pyweft new`
-and `pyweft run` directly.
+With pip, the equivalent is `pip install pyweft`, then `pyweft new` and
+`pyweft run` directly.
 
 To hack on the framework itself, clone it and install in editable mode:
 
@@ -1729,15 +1728,13 @@ reference; and the gallery shows every control live:
 uv run pyweft run packages/pyweft-ui/gallery
 ```
 
-It is not on PyPI yet. Install it from GitHub into the same environment as
-PyWeft:
+Install it into the same environment as PyWeft:
 
 ```bash
-uv add "pyweft-ui @ git+https://github.com/prassanthn/PyWeft.git#subdirectory=packages/pyweft-ui"
+uv add pyweft-ui
 ```
 
-(with pip: `pip install "git+https://github.com/prassanthn/PyWeft.git#subdirectory=packages/pyweft-ui"`),
-then add `"pyweft-ui"` to the `dependencies` in your app's own
+(with pip: `pip install pyweft-ui`), then add `"pyweft-ui"` to the `dependencies` in your app's own
 `pyproject.toml`. PyWeft ships it to the browser for you (see "Components
 from packages"). Inside a clone of this repository, `uv sync` already
 installs it.

{pyweft-0.2.0 → pyweft-0.2.1}/src/pyweft/__init__.py

@@ -24,7 +24,7 @@ from .store import Store
 from .styles import collect_styles, scope_css
 from .vdom import Element, Node, Text, to_dicts
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 __all__ = [
     "Component",