html5cc 0.3.0__tar.gz

html5cc-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jason Lee Miller
+
+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.

html5cc-0.3.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: html5cc
+Version: 0.3.0
+Summary: A small Python module for building HTML5 documents and CSS3 stylesheets.
+Author: Jason Miller
+License: MIT
+Project-URL: Homepage, https://jasonmiller-cc.github.io/html5/
+Project-URL: Documentation, https://jasonmiller-cc.github.io/html5/
+Project-URL: Source, https://github.com/jasonmiller-cc/html5
+Project-URL: Changelog, https://github.com/jasonmiller-cc/html5/blob/main/CHANGELOG.md
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: pytest-cov>=5.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: furo>=2024.8.6; extra == "docs"
+Requires-Dist: myst-parser>=4.0; extra == "docs"
+Requires-Dist: sphinx>=7.4; extra == "docs"
+Dynamic: license-file
+
+# html5
+
+Small Python helpers for building HTML5 documents, CSS, and JavaScript assets from Python.
+
+Documentation is published on GitHub Pages at [jasonmiller-cc.github.io/html5](https://jasonmiller-cc.github.io/html5/).
+
+The package ships with HTML5 element classes, CSS node classes, JavaScript helpers, CDN helpers for Bootstrap 5 and Tailwind, optimized Google Fonts helpers, a disk writer, and semantic version metadata.
+
+## Installation
+
+`html5cc` is published to [PyPI](https://pypi.org/project/html5cc/).
+The import name is still `html5`.
+
+```bash
+pip install html5cc
+```
+
+**requirements.txt**
+
+```text
+html5cc==0.3.0
+```
+
+**pyproject.toml (uv)**
+
+```toml
+[project]
+dependencies = ["html5cc>=0.3.0"]
+```
+
+See the [Installation docs](https://jasonmiller-cc.github.io/html5/installation.html) for Poetry and other options.
+
+## Example
+
+```python
+from html5 import (
+    CSSDeclaration,
+    CSSKeyframe,
+    CSSStyleSheet,
+    Div,
+    H1,
+    HtmlDocument,
+    Img,
+    MarkupWriter,
+    bootstrap5_bundle_script,
+    bootstrap5_stylesheet,
+    google_charts_loader,
+    google_charts_package_loader,
+    google_fonts_assets,
+    inline_style,
+    tailwind_script,
+)
+
+styles = CSSStyleSheet()
+styles.add_comment("base styles")
+styles.add_import("reset.css")
+styles.add_rule("body", margin="0", font_family="system-ui")
+styles.add_rule("h1", color="#1f2937")
+styles.add_media("screen and (min-width: 40rem)", CSSDeclaration("color", "black"))
+styles.add_keyframes("fade", CSSKeyframe("from", ("opacity", 0)), CSSKeyframe("to", ("opacity", 1)))
+
+doc = (
+    HtmlDocument(title="Hello HTML5")
+    .add_head(*google_fonts_assets("Inter"))
+    .add_head(bootstrap5_stylesheet())
+    .add_head(tailwind_script())
+    .add_head(bootstrap5_bundle_script())
+    .add_head(google_charts_loader())
+    .add_body(Div(H1("Hello, world!"), Img(src="hero.png", style=inline_style(("border_radius", "8px")))))
+)
+
+print(doc.render())
+
+chart_loader = google_charts_package_loader(["corechart", "table"], callback="drawChart")
+writer = MarkupWriter()
+writer.write_html("dist/index.html", doc)
+writer.write_css("dist/site.css", styles)
+writer.write_html("dist/charts.html", HtmlDocument(title="Charts").add_head(chart_loader))
+```
+
+## JavaScript Helpers
+
+Use `javascript_link()` and `javascript_script()` for arbitrary script tags and inline code. The library also exposes `bootstrap5_bundle_script()` and Google Charts helpers so you can wire up common browser libraries without hand-building script tags.
+
+## Asset Helpers
+
+Tailwind is injected with the official Play CDN script because that is the fastest supported browser-side setup for this library. Bootstrap 5 is injected as a CSS stylesheet from jsDelivr. Google Fonts are emitted as a preconnect pair plus a CSS2 stylesheet link so browsers can establish connections early and only download the fonts you ask for.
+
+Common Tailwind class families that pair well with the helpers:
+
+- Layout: `container`, `mx-auto`, `flex`, `grid`, `gap-*`, `items-center`, `justify-between`
+- Spacing: `p-*`, `px-*`, `py-*`, `m-*`, `space-x-*`, `space-y-*`
+- Typography: `text-*`, `font-*`, `leading-*`, `tracking-*`
+- Surface: `bg-*`, `text-*`, `border-*`, `rounded-*`, `shadow-*`
+- Responsive prefixes: `sm:`, `md:`, `lg:`, `xl:`, `2xl:`
+
+Common Bootstrap 5 class families that pair well with the helpers:
+
+- Layout and grid: `container`, `container-fluid`, `row`, `col`, `g-*`, `row-cols-*`
+- Spacing and display: `m-*`, `p-*`, `d-flex`, `d-grid`, `gap-*`, `justify-content-*`, `align-items-*`
+- Typography: `lead`, `fw-bold`, `fst-italic`, `text-muted`, `text-center`, `text-nowrap`
+- Components: `btn`, `btn-primary`, `card`, `badge`, `alert`, `navbar`, `modal`
+- Responsive prefixes: `sm`, `md`, `lg`, `xl`, `xxl`
+
+Google Fonts examples:
+
+- `google_fonts_assets("Inter")`
+- `google_fonts_assets("Inter", "Open Sans")`
+- `google_fonts_assets("Roboto", weights=(400, 700), text="Hello world")`
+
+## Layout
+
+- `src/html5/document.py` contains the HTML5 document and element primitives.
+- `src/html5/elements.py` contains generated classes for standard HTML5 tags.
+- `src/html5/css.py` contains CSS node classes for comments, declarations, rules, at-rules, keyframes, inline styles, and `<style>` generation.
+- `src/html5/js.py` contains JavaScript helpers for inline scripts, external scripts, Bootstrap 5, and Google Charts.
+- `src/html5/writer.py` contains a disk writer for rendered HTML and CSS outputs.
+- `src/html5/version.py` stores the semantic version string used by packaging.
+
+## Versioning
+
+This project uses semantic versioning. The current package version is `0.3.0`, and the release history is documented in [CHANGELOG.md](CHANGELOG.md).

html5cc-0.3.0/README.md

@@ -0,0 +1,122 @@
+# html5
+
+Small Python helpers for building HTML5 documents, CSS, and JavaScript assets from Python.
+
+Documentation is published on GitHub Pages at [jasonmiller-cc.github.io/html5](https://jasonmiller-cc.github.io/html5/).
+
+The package ships with HTML5 element classes, CSS node classes, JavaScript helpers, CDN helpers for Bootstrap 5 and Tailwind, optimized Google Fonts helpers, a disk writer, and semantic version metadata.
+
+## Installation
+
+`html5cc` is published to [PyPI](https://pypi.org/project/html5cc/).
+The import name is still `html5`.
+
+```bash
+pip install html5cc
+```
+
+**requirements.txt**
+
+```text
+html5cc==0.3.0
+```
+
+**pyproject.toml (uv)**
+
+```toml
+[project]
+dependencies = ["html5cc>=0.3.0"]
+```
+
+See the [Installation docs](https://jasonmiller-cc.github.io/html5/installation.html) for Poetry and other options.
+
+## Example
+
+```python
+from html5 import (
+    CSSDeclaration,
+    CSSKeyframe,
+    CSSStyleSheet,
+    Div,
+    H1,
+    HtmlDocument,
+    Img,
+    MarkupWriter,
+    bootstrap5_bundle_script,
+    bootstrap5_stylesheet,
+    google_charts_loader,
+    google_charts_package_loader,
+    google_fonts_assets,
+    inline_style,
+    tailwind_script,
+)
+
+styles = CSSStyleSheet()
+styles.add_comment("base styles")
+styles.add_import("reset.css")
+styles.add_rule("body", margin="0", font_family="system-ui")
+styles.add_rule("h1", color="#1f2937")
+styles.add_media("screen and (min-width: 40rem)", CSSDeclaration("color", "black"))
+styles.add_keyframes("fade", CSSKeyframe("from", ("opacity", 0)), CSSKeyframe("to", ("opacity", 1)))
+
+doc = (
+    HtmlDocument(title="Hello HTML5")
+    .add_head(*google_fonts_assets("Inter"))
+    .add_head(bootstrap5_stylesheet())
+    .add_head(tailwind_script())
+    .add_head(bootstrap5_bundle_script())
+    .add_head(google_charts_loader())
+    .add_body(Div(H1("Hello, world!"), Img(src="hero.png", style=inline_style(("border_radius", "8px")))))
+)
+
+print(doc.render())
+
+chart_loader = google_charts_package_loader(["corechart", "table"], callback="drawChart")
+writer = MarkupWriter()
+writer.write_html("dist/index.html", doc)
+writer.write_css("dist/site.css", styles)
+writer.write_html("dist/charts.html", HtmlDocument(title="Charts").add_head(chart_loader))
+```
+
+## JavaScript Helpers
+
+Use `javascript_link()` and `javascript_script()` for arbitrary script tags and inline code. The library also exposes `bootstrap5_bundle_script()` and Google Charts helpers so you can wire up common browser libraries without hand-building script tags.
+
+## Asset Helpers
+
+Tailwind is injected with the official Play CDN script because that is the fastest supported browser-side setup for this library. Bootstrap 5 is injected as a CSS stylesheet from jsDelivr. Google Fonts are emitted as a preconnect pair plus a CSS2 stylesheet link so browsers can establish connections early and only download the fonts you ask for.
+
+Common Tailwind class families that pair well with the helpers:
+
+- Layout: `container`, `mx-auto`, `flex`, `grid`, `gap-*`, `items-center`, `justify-between`
+- Spacing: `p-*`, `px-*`, `py-*`, `m-*`, `space-x-*`, `space-y-*`
+- Typography: `text-*`, `font-*`, `leading-*`, `tracking-*`
+- Surface: `bg-*`, `text-*`, `border-*`, `rounded-*`, `shadow-*`
+- Responsive prefixes: `sm:`, `md:`, `lg:`, `xl:`, `2xl:`
+
+Common Bootstrap 5 class families that pair well with the helpers:
+
+- Layout and grid: `container`, `container-fluid`, `row`, `col`, `g-*`, `row-cols-*`
+- Spacing and display: `m-*`, `p-*`, `d-flex`, `d-grid`, `gap-*`, `justify-content-*`, `align-items-*`
+- Typography: `lead`, `fw-bold`, `fst-italic`, `text-muted`, `text-center`, `text-nowrap`
+- Components: `btn`, `btn-primary`, `card`, `badge`, `alert`, `navbar`, `modal`
+- Responsive prefixes: `sm`, `md`, `lg`, `xl`, `xxl`
+
+Google Fonts examples:
+
+- `google_fonts_assets("Inter")`
+- `google_fonts_assets("Inter", "Open Sans")`
+- `google_fonts_assets("Roboto", weights=(400, 700), text="Hello world")`
+
+## Layout
+
+- `src/html5/document.py` contains the HTML5 document and element primitives.
+- `src/html5/elements.py` contains generated classes for standard HTML5 tags.
+- `src/html5/css.py` contains CSS node classes for comments, declarations, rules, at-rules, keyframes, inline styles, and `<style>` generation.
+- `src/html5/js.py` contains JavaScript helpers for inline scripts, external scripts, Bootstrap 5, and Google Charts.
+- `src/html5/writer.py` contains a disk writer for rendered HTML and CSS outputs.
+- `src/html5/version.py` stores the semantic version string used by packaging.
+
+## Versioning
+
+This project uses semantic versioning. The current package version is `0.3.0`, and the release history is documented in [CHANGELOG.md](CHANGELOG.md).

html5cc-0.3.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "html5cc"
+description = "A small Python module for building HTML5 documents and CSS3 stylesheets."
+readme = "README.md"
+requires-python = ">=3.10"
+dynamic = ["version"]
+license = { text = "MIT" }
+authors = [
+  { name = "Jason Miller" }
+]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://jasonmiller-cc.github.io/html5/"
+Documentation = "https://jasonmiller-cc.github.io/html5/"
+Source = "https://github.com/jasonmiller-cc/html5"
+Changelog = "https://github.com/jasonmiller-cc/html5/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+test = [
+  "pytest>=8.0",
+  "pytest-cov>=5.0",
+]
+docs = [
+  "furo>=2024.8.6",
+  "myst-parser>=4.0",
+  "sphinx>=7.4",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.dynamic]
+version = {attr = "html5.version.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "-q --cov=html5 --cov-report=term-missing --cov-fail-under=80"
+testpaths = ["tests"]

html5cc-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

html5cc-0.3.0/src/html5/__init__.py

@@ -0,0 +1,42 @@
+"""HTML5 document and CSS3 helpers."""
+
+from .css import (
+    CSSAtRule,
+    CSSComment,
+    CSSDeclaration,
+    CSSLink,
+    CSSImportRule,
+    CSSInlineStyle,
+    CSSKeyframe,
+    CSSKeyframesRule,
+    CSSLayerRule,
+    CSSMediaRule,
+    CSSNode,
+    CSSRule,
+    CSSStyleElement,
+    CSSStyleSheet,
+    CSSSupportsRule,
+    BOOTSTRAP5_CSS_URL,
+    GOOGLE_FONTS_PRECONNECT_URL,
+    GOOGLE_FONTS_STATIC_URL,
+    TAILWIND_PLAY_CDN_URL,
+    bootstrap5_stylesheet,
+    google_fonts_assets,
+    google_fonts_url,
+    inline_style,
+    tailwind_script,
+    style_tag,
+)
+from .document import Comment, Doctype, Element, HtmlDocument, Node, Raw, Text, comment, doctype, doctype_node, element, raw, text
+from .elements import *
+from .version import __version__
+from .writer import MarkupWriter
+from .js import (
+    JSNode,
+    JSScript,
+    bootstrap5_bundle_script,
+    google_charts_loader,
+    google_charts_package_loader,
+    javascript_link,
+    javascript_script,
+)