htmlforge 0.0.1__tar.gz

htmlforge-0.0.1/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.venv/
+*.html

htmlforge-0.0.1/LICENSE

@@ -0,0 +1 @@
+Mozilla Public License Version 2.0

htmlforge-0.0.1/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.5
+Name: htmlforge
+Version: 0.0.1
+Summary: Build web pages with Python, export to HTML with a single command
+Project-URL: Homepage, https://github.com/htmlforge/htmlforge
+Author: htmlforge contributors
+License-Expression: MPL-2.0
+License-File: LICENSE
+Keywords: builder,html,page,static-site,web
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# htmlforge
+
+Build web pages with Python, export to HTML with a single command — like manim generates videos.
+
+```
+manim   scene.py MyScene  →  mp4
+htmlforge    page.py  MyPage   →  html
+```
+
+## Installation
+
+```bash
+pip install htmlforge
+```
+
+Development install:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+### 1. Write a Python page script `mysite.py`
+
+```python
+from htmlforge import Doc
+
+page = Doc("My Site")
+
+# Generate styles with Python code (no CSS needed!)
+page.style("body", background="#f5f5f5", font_family="sans-serif")
+page.style(".py-card", border_radius="12px", box_shadow="0 2px 8px rgba(0,0,0,.1)")
+
+# Build the page
+page.heading("Welcome to My Site")
+page.text("Built with **htmlforge**, supports *Markdown* syntax")
+
+page.card("Features",
+    "40+ HTML components",
+    "Generate styles with Python code",
+    "Export HTML with one command",
+)
+
+page.table(
+    ["Feature", "Description"],
+    [
+        ["Components", "40+ HTML components"],
+        ["Built-in theme", "Works out of the box"],
+        ["CLI tools", "render / serve / watch"],
+    ],
+)
+
+page.button("Click me", on_click="alert('Hello!')", color="#4CAF50")
+```
+
+### 2. Run the command to export HTML
+
+```bash
+# Basic render
+htmlforge render mysite.py
+
+# Specify output directory
+htmlforge render mysite.py -o build
+
+# Render and start a local server
+htmlforge render mysite.py -s
+
+# Watch for file changes and auto-rebuild
+htmlforge render mysite.py -w
+
+# Render a specific page (when file has multiple pages)
+htmlforge render mysite.py MyPage
+```
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `htmlforge render <file.py>` | Render all pages to `dist/` |
+| `htmlforge render <file.py> -o <dir>` | Specify output directory |
+| `htmlforge render <file.py> <page>` | Render only the specified page |
+| `htmlforge render <file.py> -s` | Start HTTP server after render |
+| `htmlforge render <file.py> -s -p 3000` | Specify server port |
+| `htmlforge render <file.py> -w` | Watch for changes and auto-rebuild |
+
+## Doc API — Ultra Simple
+
+`Doc` is a high-level API designed for Python programmers who don't know HTML. It comes with a built-in theme — no CSS required to build great-looking pages.
+
+```python
+from htmlforge import Doc
+
+page = Doc("Title")
+
+# Generate styles with Python kwargs (no CSS strings!)
+page.style("body", background="linear-gradient(135deg, #667eea, #764ba2)", color="white")
+page.style("h1", font_size="3rem", text_align="center")
+page.style(".py-card", background="rgba(255,255,255,.15)", backdrop_filter="blur(10px)")
+
+# Content (supports **Markdown** syntax)
+page.heading("Hello World")
+page.text("Supports **bold**, *italic*, `code`, [links](url)")
+
+page.card("Card Title", "Card content, **supports Markdown**")
+page.list(["Item A", "Item B", "Item C"])
+page.table(["Col 1", "Col 2"], [["a", "b"], ["c", "d"]])
+page.button("Button", on_click="alert('hi')", color="#e74c3c")
+page.input("Type here...", name="name")
+page.select(["Option A", "Option B", "Option C"])
+page.code("print('hello')", lang="python")
+page.details("Collapsible", "Hidden content...")
+page.nav(("Home", "/"), ("About", "/about"))
+page.divider()
+
+# Layout
+page.row(Doc.make_card("A"), Doc.make_card("B"), Doc.make_card("C"))
+```
+
+## Page API — Fine-grained Control
+
+Use `Page` + the component system when you need more control:
+
+```python
+from htmlforge import Page, H1, P, Div, Table, Button
+
+page = Page("Title", lang="en")
+page.add_css("body { font-family: sans-serif; }")
+page.add(
+    H1("Welcome"),
+    P("Hello World"),
+    Div(class_="card").add(
+        H1("Features", level=2),
+        P("Content..."),
+    ),
+)
+```
+
+### Element — Chainable API
+
+```python
+div = Div(id="main", class_="wrapper")
+div.add(H1("Title"), P("Content"))          # Add child elements
+div.css(color="red", font_size="16px")      # Set inline styles (camelCase → kebab-case)
+div.attr("data-id", "123")                  # Set attributes
+html = div.render()                          # → HTML string
+```
+
+### Components
+
+| Category | Components |
+|---|---|
+| **Structure** | `Div`, `Section`, `Header`, `Footer`, `Nav`, `Main`, `Article`, `Aside`, `Span`, `Container` |
+| **Text** | `H1`-`H6`, `P`, `Strong`, `Em`, `Blockquote`, `Code`, `Pre`, `Small`, `Mark` |
+| **Links/Media** | `Link`, `Img`, `Video`, `Audio`, `Iframe`, `Canvas` |
+| **Lists** | `Ul`, `Ol`, `Li`, `List` |
+| **Tables** | `Table`, `Thead`, `Tbody`, `Tr`, `Th`, `Td`, `Caption` |
+| **Forms** | `Form`, `Input`, `Textarea`, `Select`, `Option`, `Checkbox`, `Radio`, `Label`, `Button` |
+| **Other** | `Hr`, `Br`, `Text`, `Progress`, `Details`, `Summary` |
+
+## Example: Multi-page Site
+
+```python
+# site.py
+from htmlforge import Doc
+
+home = Doc("Home")
+home.heading("Home")
+home.text("Welcome to the home page")
+
+about = Doc("About")
+about.heading("About Us")
+about.text("This is the about page")
+
+blog = Doc("Blog")
+blog.heading("Blog")
+blog.text("Latest posts...")
+```
+
+```bash
+htmlforge render site.py
+# → dist/home.html, dist/about.html, dist/blog.html
+```
+
+## License
+
+[MPL-2.0](LICENSE)

htmlforge-0.0.1/README.md

@@ -0,0 +1,187 @@
+# htmlforge
+
+Build web pages with Python, export to HTML with a single command — like manim generates videos.
+
+```
+manim   scene.py MyScene  →  mp4
+htmlforge    page.py  MyPage   →  html
+```
+
+## Installation
+
+```bash
+pip install htmlforge
+```
+
+Development install:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+### 1. Write a Python page script `mysite.py`
+
+```python
+from htmlforge import Doc
+
+page = Doc("My Site")
+
+# Generate styles with Python code (no CSS needed!)
+page.style("body", background="#f5f5f5", font_family="sans-serif")
+page.style(".py-card", border_radius="12px", box_shadow="0 2px 8px rgba(0,0,0,.1)")
+
+# Build the page
+page.heading("Welcome to My Site")
+page.text("Built with **htmlforge**, supports *Markdown* syntax")
+
+page.card("Features",
+    "40+ HTML components",
+    "Generate styles with Python code",
+    "Export HTML with one command",
+)
+
+page.table(
+    ["Feature", "Description"],
+    [
+        ["Components", "40+ HTML components"],
+        ["Built-in theme", "Works out of the box"],
+        ["CLI tools", "render / serve / watch"],
+    ],
+)
+
+page.button("Click me", on_click="alert('Hello!')", color="#4CAF50")
+```
+
+### 2. Run the command to export HTML
+
+```bash
+# Basic render
+htmlforge render mysite.py
+
+# Specify output directory
+htmlforge render mysite.py -o build
+
+# Render and start a local server
+htmlforge render mysite.py -s
+
+# Watch for file changes and auto-rebuild
+htmlforge render mysite.py -w
+
+# Render a specific page (when file has multiple pages)
+htmlforge render mysite.py MyPage
+```
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `htmlforge render <file.py>` | Render all pages to `dist/` |
+| `htmlforge render <file.py> -o <dir>` | Specify output directory |
+| `htmlforge render <file.py> <page>` | Render only the specified page |
+| `htmlforge render <file.py> -s` | Start HTTP server after render |
+| `htmlforge render <file.py> -s -p 3000` | Specify server port |
+| `htmlforge render <file.py> -w` | Watch for changes and auto-rebuild |
+
+## Doc API — Ultra Simple
+
+`Doc` is a high-level API designed for Python programmers who don't know HTML. It comes with a built-in theme — no CSS required to build great-looking pages.
+
+```python
+from htmlforge import Doc
+
+page = Doc("Title")
+
+# Generate styles with Python kwargs (no CSS strings!)
+page.style("body", background="linear-gradient(135deg, #667eea, #764ba2)", color="white")
+page.style("h1", font_size="3rem", text_align="center")
+page.style(".py-card", background="rgba(255,255,255,.15)", backdrop_filter="blur(10px)")
+
+# Content (supports **Markdown** syntax)
+page.heading("Hello World")
+page.text("Supports **bold**, *italic*, `code`, [links](url)")
+
+page.card("Card Title", "Card content, **supports Markdown**")
+page.list(["Item A", "Item B", "Item C"])
+page.table(["Col 1", "Col 2"], [["a", "b"], ["c", "d"]])
+page.button("Button", on_click="alert('hi')", color="#e74c3c")
+page.input("Type here...", name="name")
+page.select(["Option A", "Option B", "Option C"])
+page.code("print('hello')", lang="python")
+page.details("Collapsible", "Hidden content...")
+page.nav(("Home", "/"), ("About", "/about"))
+page.divider()
+
+# Layout
+page.row(Doc.make_card("A"), Doc.make_card("B"), Doc.make_card("C"))
+```
+
+## Page API — Fine-grained Control
+
+Use `Page` + the component system when you need more control:
+
+```python
+from htmlforge import Page, H1, P, Div, Table, Button
+
+page = Page("Title", lang="en")
+page.add_css("body { font-family: sans-serif; }")
+page.add(
+    H1("Welcome"),
+    P("Hello World"),
+    Div(class_="card").add(
+        H1("Features", level=2),
+        P("Content..."),
+    ),
+)
+```
+
+### Element — Chainable API
+
+```python
+div = Div(id="main", class_="wrapper")
+div.add(H1("Title"), P("Content"))          # Add child elements
+div.css(color="red", font_size="16px")      # Set inline styles (camelCase → kebab-case)
+div.attr("data-id", "123")                  # Set attributes
+html = div.render()                          # → HTML string
+```
+
+### Components
+
+| Category | Components |
+|---|---|
+| **Structure** | `Div`, `Section`, `Header`, `Footer`, `Nav`, `Main`, `Article`, `Aside`, `Span`, `Container` |
+| **Text** | `H1`-`H6`, `P`, `Strong`, `Em`, `Blockquote`, `Code`, `Pre`, `Small`, `Mark` |
+| **Links/Media** | `Link`, `Img`, `Video`, `Audio`, `Iframe`, `Canvas` |
+| **Lists** | `Ul`, `Ol`, `Li`, `List` |
+| **Tables** | `Table`, `Thead`, `Tbody`, `Tr`, `Th`, `Td`, `Caption` |
+| **Forms** | `Form`, `Input`, `Textarea`, `Select`, `Option`, `Checkbox`, `Radio`, `Label`, `Button` |
+| **Other** | `Hr`, `Br`, `Text`, `Progress`, `Details`, `Summary` |
+
+## Example: Multi-page Site
+
+```python
+# site.py
+from htmlforge import Doc
+
+home = Doc("Home")
+home.heading("Home")
+home.text("Welcome to the home page")
+
+about = Doc("About")
+about.heading("About Us")
+about.text("This is the about page")
+
+blog = Doc("Blog")
+blog.heading("Blog")
+blog.text("Latest posts...")
+```
+
+```bash
+htmlforge render site.py
+# → dist/home.html, dist/about.html, dist/blog.html
+```
+
+## License
+
+[MPL-2.0](LICENSE)

htmlforge-0.0.1/demo.py

@@ -0,0 +1,58 @@
+"""Demo: 用 htmlforge 构建一个示例页面."""
+import sys
+sys.path.insert(0, r"E:\py\____My Lib\htmlforge\src")
+
+from htmlforge import Page, H1, H2, P, Div, Table, Button, Img, List, Code, Pre
+
+page = Page("htmlforge Demo")
+
+page.add_css("""
+    body { font-family: 'Segoe UI', sans-serif; max-width: 800px; margin: 2rem auto; padding: 0 1rem; color: #333; }
+    .hero { text-align: center; padding: 2rem; background: linear-gradient(135deg, #667eea, #764ba2); color: white; border-radius: 12px; margin-bottom: 2rem; }
+    .card { border: 1px solid #e0e0e0; border-radius: 8px; padding: 1.5rem; margin: 1rem 0; }
+    table { width: 100%; border-collapse: collapse; }
+    th, td { padding: 8px 12px; border: 1px solid #ddd; text-align: left; }
+    th { background: #f5f5f5; }
+    .btn { background: #4CAF50; color: white; padding: 10px 20px; border: none; border-radius: 6px; cursor: pointer; font-size: 16px; }
+""")
+
+# Hero 区域
+page.add(
+    Div(class_="hero").add(
+        H1("htmlforge"),
+        P("用 Python 写网页，一条命令导出 HTML"),
+    ),
+)
+
+# 功能卡片
+page.add(
+    Div(class_="card").add(
+        H2("为什么用 htmlforge?"),
+        List([
+            "零外部依赖，纯 Python 实现",
+            "40+ HTML 组件，覆盖所有常用标签",
+            "链式调用 API，写起来很舒服",
+            "类 manim 的 CLI 工具",
+        ]),
+    ),
+)
+
+# 对比表格
+page.add(
+    Div(class_="card").add(
+        H2("对比"),
+        Table(
+            headers=["", "manim", "htmlforge"],
+            rows=[
+                ["写什么", "Python 代码", "Python 代码"],
+                ["输出什么", "MP4 视频", "HTML 网页"],
+                ["\u547d\u4ee4", "manim scene.py", "htmlforge page.py"],
+            ],
+        ),
+    ),
+)
+
+# 按钮
+page.add(
+    Button("试试点击", onclick="alert('Hello from htmlforge!')", class_="btn"),
+)

htmlforge-0.0.1/demo_simple.py

@@ -0,0 +1,87 @@
+"""htmlforge Doc 综合演示 — 完全不需要 HTML 知识."""
+import sys
+sys.path.insert(0, r"E:\py\____My Lib\htmlforge\src")
+
+from htmlforge import Doc
+
+page = Doc("htmlforge 演示")
+
+# ---- 导航栏 ----
+page.nav(("首页", "#"), ("文档", "#"), ("关于", "#"))
+
+# ---- 标题 ----
+page.heading("欢迎来到 htmlforge")
+page.text("用 **Python** 写网页，一条命令导出 HTML。`零 HTML 知识`也能做到！")
+
+# ---- 特性卡片 ----
+page.heading("核心特性", 2)
+
+page.card("零依赖", "不需要安装任何第三方库，纯 Python 实现")
+page.card("内置主题", "自动自带一套简洁现代的样式，开箱即用")
+page.card("Markdown 文本", "支持 **加粗**、*斜体*、`代码`、[链接](url)")
+
+# ---- 三列布局 ----
+page.heading("布局展示", 2)
+
+page.row(
+    Doc.make_card("Python", "写你最擅长的语言"),
+    Doc.make_card("导出", "一条命令变成 HTML"),
+    Doc.make_card("部署", "放到任何静态托管"),
+)
+
+# ---- 表格 ----
+page.heading("命令对比", 2)
+
+page.table(
+    ["工具", "输入", "输出", "命令"],
+    [
+        ["manim", "Python 代码", "MP4 视频", "manim scene.py"],
+        ["htmlforge", "Python 代码", "HTML 网页", "htmlforge page.py"],
+    ],
+)
+
+# ---- 列表 ----
+page.heading("组件一览", 2)
+
+page.list([
+    "标题、段落、链接、图片",
+    "按钮、输入框、下拉框、文本区域",
+    "表格、列表、代码块",
+    "卡片、网格、折叠面板",
+    "导航栏、分隔线",
+])
+
+# ---- 代码块 ----
+page.heading("代码示例", 2)
+
+page.code("""\
+from htmlforge import Doc
+
+page = Doc("Hello")
+page.heading("World")
+page.text("Easy!")
+""", lang="python")
+
+# ---- 交互 ----
+page.heading("试试看", 2)
+
+page.button("点我弹窗", on_click="alert('Hello from htmlforge!')")
+page.button("红色按钮", color="#e74c3c")
+page.button("蓝色按钮", color="#3498db")
+
+# ---- 表单 ----
+page.heading("表单示例", 2)
+
+page.input("你的名字", name="name")
+page.input("你的邮箱", type="email", name="email")
+page.textarea("留言内容...", rows="3")
+page.select(["Python", "JavaScript", "Rust", "Go"])
+
+# ---- 折叠面板 ----
+page.details("常见问题：htmlforge 需要什么基础？",
+             "只需要会 Python！不需要了解 HTML 和 CSS。")
+page.details("能自定义样式吗？",
+             "当然可以！用 `page.add_css()` 添加自定义 CSS。")
+
+page.divider()
+page.text("*用 [htmlforge](https://github.com) 构建 — Made with Python*")

htmlforge-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "htmlforge"
+version = "0.0.1"
+description = "Build web pages with Python, export to HTML with a single command"
+readme = "README.md"
+license = "MPL-2.0"
+requires-python = ">=3.9"
+keywords = ["html", "web", "page", "builder", "static-site"]
+authors = [
+    { name = "htmlforge contributors" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Text Processing :: Markup :: HTML",
+]
+dependencies = []
+
+[project.scripts]
+htmlforge = "htmlforge.cli:render"
+
+[project.urls]
+Homepage = "https://github.com/htmlforge/htmlforge"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/htmlforge"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

htmlforge-0.0.1/src/htmlforge/__init__.py

@@ -0,0 +1,27 @@
+"""htmlforge — Build web pages with Python, export to HTML."""
+
+__version__ = "0.0.1"
+
+from htmlforge.simple import Doc
+
+from htmlforge.core import (
+    # Base
+    Element, Page,
+    # Structural
+    Div, Section, Header, Footer, Nav, Main, Article, Aside, Span, Container,
+    # Text
+    H1, H2, H3, H4, H5, H6, P, Strong, Em, Blockquote,
+    Code, Pre, Small, Mark, Sub, Sup,
+    Text, Link,
+    # Lists
+    Ul, Ol, Li, List,
+    # Media
+    Img, Video, Audio, Source, Iframe, Canvas,
+    # Table
+    Table, Thead, Tbody, Tr, Th, Td, Caption,
+    # Forms
+    Form, Input, Textarea, Select, Option,
+    Checkbox, Radio, Label, Button,
+    # Misc
+    Hr, Br, Meta, Progress, Details, Summary,
+)

htmlforge-0.0.1/src/htmlforge/__main__.py

@@ -0,0 +1,5 @@
+"""Allow ``python -m htmlforge`` to invoke the CLI."""
+
+from htmlforge.cli import render
+
+render()