jusu 0.1.1

Build HTML pages in Python — simple, readable, and beginner-friendly.

JUSU

JUSU is a tiny Python library to build HTML pages using a simple, readable plain-English style API. It is made for beginners, educators, and quick prototyping.

Quick usage:

from JUSU import Div, H1, P, Button, Img

page = Div(
	H1("Welcome to JUSU"),
	P("A tiny HTML builder."),
	Button("Click me", onclick="alert('Hello')", cls="btn"),
	Img(src="https://via.placeholder.com/150", alt="demo"),
	cls="container"
)
page.render_to_file("jusu_demo.html")

Run tests:

python -m pytest

Install:

pip install -e .

License: MIT

Course: A beginner-friendly course (text + interactive notebooks) is available in the course/ directory — authored by Francis Jusu.

Bundling & CLI

• Tag.bundle(...) / Tag.bundle_export(...) — produce an HTML file and CSS file (and optionally a ZIP archive) for a component.
• jusu bundle (CLI) — bundle a component by import path (see docs/bundling.md).

NPM assets

A minimal npm package jusu-assets is available in this repository (under package_assets/) containing optional CSS and tiny JS helpers. See docs/npm.md for instructions on running a local dry-run and publishing to npm.

Publish to TestPyPI (recommended first):

1. Create an account on https://test.pypi.org/ and generate an API token.
2. Set the API token as environment variables, for example (Powershell):

$Env:TWINE_USERNAME = "__token__"
$Env:TWINE_PASSWORD = "pypi-AgENdGVzdC..."

3. Build and upload to TestPyPI:

python -m build -o dist
python -m twine check dist/*
python -m twine upload --repository testpypi dist/*

Publish to PyPI (after verifying TestPyPI):

python -m twine upload dist/*

If you prefer to specify the username and token directly instead of environment variables, pass --username and --password to twine upload, but environment variables are more secure.

JUSU