tivelweb 0.1.0__tar.gz

tivelweb-0.1.0/LICENSE

@@ -0,0 +1,7 @@
+MIT License
+
+Copyright (c) 2026 tivalsdeveloper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies, subject to including this notice.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

tivelweb-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: tivelweb
+Version: 0.1.0
+Summary: Build responsive static websites using friendly Python code.
+Author: tivalsdeveloper
+License: MIT
+Project-URL: Homepage, https://github.com/tivalsdeveloper-oss/tivelweb
+Project-URL: Repository, https://github.com/tivalsdeveloper-oss/tivelweb
+Project-URL: Issues, https://github.com/tivalsdeveloper-oss/tivelweb/issues
+Keywords: website,static-site-generator,html,python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# TivelWeb
+
+TivelWeb is a lightweight Python library for building responsive static websites without writing all the HTML and CSS yourself.
+
+## Install locally
+
+```bash
+cd tivelweb
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Build your first website
+
+```python
+from tivelweb import Site, hero, section
+
+site = Site("My Website", theme_color="#6c5ce7")
+home = site.page("Home", description="My first Python website")
+home.add(hero("Welcome", "This website was built using Python.", "Learn more", "#about"))
+home.add(section("About", "TivelWeb generates fast static HTML."))
+site.build()
+```
+
+Run the file, then preview the generated `dist` folder:
+
+```bash
+python app.py
+tivelweb serve dist
+```
+
+Open `http://127.0.0.1:8000`.
+
+## Commands
+
+```bash
+tivelweb new mywebsite
+cd mywebsite
+python app.py
+tivelweb serve dist
+```
+
+## Features
+
+- Responsive pages and navigation
+- Hero, section, card, button, and image components
+- Multiple pages
+- Custom theme colors
+- Static asset copying
+- Built-in local preview server
+- No runtime dependencies
+
+## Test
+
+```bash
+python -m unittest discover -s tests
+```
+
+## License
+
+MIT
+

tivelweb-0.1.0/README.md

@@ -0,0 +1,63 @@
+# TivelWeb
+
+TivelWeb is a lightweight Python library for building responsive static websites without writing all the HTML and CSS yourself.
+
+## Install locally
+
+```bash
+cd tivelweb
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Build your first website
+
+```python
+from tivelweb import Site, hero, section
+
+site = Site("My Website", theme_color="#6c5ce7")
+home = site.page("Home", description="My first Python website")
+home.add(hero("Welcome", "This website was built using Python.", "Learn more", "#about"))
+home.add(section("About", "TivelWeb generates fast static HTML."))
+site.build()
+```
+
+Run the file, then preview the generated `dist` folder:
+
+```bash
+python app.py
+tivelweb serve dist
+```
+
+Open `http://127.0.0.1:8000`.
+
+## Commands
+
+```bash
+tivelweb new mywebsite
+cd mywebsite
+python app.py
+tivelweb serve dist
+```
+
+## Features
+
+- Responsive pages and navigation
+- Hero, section, card, button, and image components
+- Multiple pages
+- Custom theme colors
+- Static asset copying
+- Built-in local preview server
+- No runtime dependencies
+
+## Test
+
+```bash
+python -m unittest discover -s tests
+```
+
+## License
+
+MIT
+

tivelweb-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tivelweb"
+version = "0.1.0"
+description = "Build responsive static websites using friendly Python code."
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "tivalsdeveloper"}]
+keywords = ["website", "static-site-generator", "html", "python"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/tivalsdeveloper-oss/tivelweb"
+Repository = "https://github.com/tivalsdeveloper-oss/tivelweb"
+Issues = "https://github.com/tivalsdeveloper-oss/tivelweb/issues"
+
+[project.scripts]
+tivelweb = "tivelweb.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

tivelweb-0.1.0/setup.cfg

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

tivelweb-0.1.0/src/tivelweb/__init__.py

@@ -0,0 +1,8 @@
+"""TivelWeb public API."""
+
+from .components import button, card, hero, image, section
+from .site import Page, Site
+
+__all__ = ["Site", "Page", "hero", "section", "card", "button", "image"]
+__version__ = "0.1.0"
+

tivelweb-0.1.0/src/tivelweb/cli.py

@@ -0,0 +1,37 @@
+"""TivelWeb command line interface."""
+
+import argparse
+from http.server import ThreadingHTTPServer, SimpleHTTPRequestHandler
+from pathlib import Path
+import os
+
+
+STARTER = '''from tivelweb import Site, hero, section
+
+site = Site("My Website")
+home = site.page("Home", description="My first TivelWeb website")
+home.add(hero("Built with Python", "A fast responsive website.", "Get started", "#about"))
+home.add(section("About", "Edit app.py to make this website yours."))
+print(f"Website built at: {site.build()}")
+'''
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="tivelweb")
+    sub = parser.add_subparsers(dest="command", required=True)
+    new = sub.add_parser("new", help="create a starter project")
+    new.add_argument("name")
+    serve = sub.add_parser("serve", help="preview a built website")
+    serve.add_argument("directory", nargs="?", default="dist")
+    serve.add_argument("--port", type=int, default=8000)
+    args = parser.parse_args()
+    if args.command == "new":
+        folder = Path(args.name)
+        folder.mkdir(parents=True, exist_ok=True)
+        (folder / "app.py").write_text(STARTER, encoding="utf-8")
+        print(f"Created {folder.resolve()}")
+    else:
+        os.chdir(args.directory)
+        print(f"Serving http://127.0.0.1:{args.port} — press Ctrl+C to stop")
+        ThreadingHTTPServer(("127.0.0.1", args.port), SimpleHTTPRequestHandler).serve_forever()
+

tivelweb-0.1.0/src/tivelweb/components.py

@@ -0,0 +1,35 @@
+"""Safe, reusable HTML components."""
+
+from html import escape
+
+
+def _text(value: object) -> str:
+    return escape(str(value), quote=True)
+
+
+def button(label: str, href: str = "#", style: str = "primary") -> str:
+    return f'<a class="btn btn-{_text(style)}" href="{_text(href)}">{_text(label)}</a>'
+
+
+def image(src: str, alt: str = "", class_name: str = "") -> str:
+    return f'<img src="{_text(src)}" alt="{_text(alt)}" class="{_text(class_name)}" loading="lazy">'
+
+
+def hero(title: str, subtitle: str = "", action: str = "", action_url: str = "#") -> str:
+    action_html = button(action, action_url) if action else ""
+    return (
+        '<section class="hero"><div class="container">'
+        f'<h1>{_text(title)}</h1><p>{_text(subtitle)}</p>{action_html}'
+        '</div></section>'
+    )
+
+
+def section(title: str, content: str, *, raw: bool = False) -> str:
+    body = content if raw else f"<p>{_text(content)}</p>"
+    return f'<section class="section"><div class="container"><h2>{_text(title)}</h2>{body}</div></section>'
+
+
+def card(title: str, content: str, link: str = "", link_text: str = "Learn more") -> str:
+    link_html = button(link_text, link, "secondary") if link else ""
+    return f'<article class="card"><h3>{_text(title)}</h3><p>{_text(content)}</p>{link_html}</article>'
+

tivelweb-0.1.0/src/tivelweb/site.py

@@ -0,0 +1,67 @@
+"""Website and page builders."""
+
+from dataclasses import dataclass, field
+from html import escape
+from pathlib import Path
+import shutil
+
+
+DEFAULT_CSS = """:root{--primary:#6c5ce7;--dark:#151522;--light:#f7f7fb;--text:#29293d;--radius:18px}*{box-sizing:border-box}body{margin:0;font-family:system-ui,-apple-system,sans-serif;color:var(--text);background:var(--light);line-height:1.65}a{color:inherit}.container{width:min(1100px,92%);margin:auto}.navbar{background:var(--dark);color:white;padding:1rem 0}.navbar .container{display:flex;justify-content:space-between;align-items:center;gap:1rem}.brand{font-size:1.25rem;font-weight:800;text-decoration:none}.nav-links{display:flex;gap:1rem;flex-wrap:wrap}.nav-links a{text-decoration:none}.hero{padding:6rem 0;text-align:center;background:linear-gradient(135deg,#151522,#6c5ce7);color:white}.hero h1{font-size:clamp(2.4rem,7vw,5rem);line-height:1.05;margin:0}.hero p{font-size:1.2rem;opacity:.9}.section{padding:4rem 0}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(230px,1fr));gap:1.25rem}.card{background:white;padding:1.5rem;border-radius:var(--radius);box-shadow:0 12px 35px #1d1d3512}.btn{display:inline-block;padding:.75rem 1.1rem;border-radius:999px;text-decoration:none;font-weight:700;margin-top:.5rem}.btn-primary{background:white;color:var(--primary)}.btn-secondary{background:var(--primary);color:white}.footer{padding:2rem;background:var(--dark);color:#ccc;text-align:center}@media(max-width:600px){.navbar .container{align-items:flex-start;flex-direction:column}.hero{padding:4rem 0}}"""
+
+
+@dataclass
+class Page:
+    title: str
+    path: str = "index.html"
+    description: str = ""
+    content: list[str] = field(default_factory=list)
+
+    def add(self, html: str) -> "Page":
+        self.content.append(html)
+        return self
+
+
+class Site:
+    def __init__(self, name: str, *, theme_color: str = "#6c5ce7", output: str = "dist"):
+        self.name = name
+        self.theme_color = theme_color
+        self.output = Path(output)
+        self.pages: list[Page] = []
+        self.assets: list[tuple[Path, str]] = []
+
+    def page(self, title: str, path: str = "index.html", description: str = "") -> Page:
+        page = Page(title, path, description)
+        self.pages.append(page)
+        return page
+
+    def add_asset(self, source: str, destination: str = "assets") -> "Site":
+        self.assets.append((Path(source), destination))
+        return self
+
+    def _render(self, page: Page) -> str:
+        links = "".join(
+            f'<a href="/{escape(p.path, quote=True)}">{escape(p.title)}</a>' for p in self.pages
+        )
+        body = "\n".join(page.content)
+        css = DEFAULT_CSS.replace("#6c5ce7", self.theme_color)
+        return f"""<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>{escape(page.title)} | {escape(self.name)}</title><meta name="description" content="{escape(page.description, quote=True)}">
+<style>{css}</style></head><body>
+<nav class="navbar"><div class="container"><a class="brand" href="/">{escape(self.name)}</a><div class="nav-links">{links}</div></div></nav>
+<main>{body}</main><footer class="footer">Powered by tivalsdeveloper</footer></body></html>"""
+
+    def build(self, clean: bool = True) -> Path:
+        if clean and self.output.exists():
+            shutil.rmtree(self.output)
+        self.output.mkdir(parents=True, exist_ok=True)
+        for page in self.pages:
+            target = self.output / page.path
+            target.parent.mkdir(parents=True, exist_ok=True)
+            target.write_text(self._render(page), encoding="utf-8")
+        for source, destination in self.assets:
+            target = self.output / destination / source.name
+            target.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(source, target)
+        return self.output.resolve()
+

tivelweb-0.1.0/src/tivelweb.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: tivelweb
+Version: 0.1.0
+Summary: Build responsive static websites using friendly Python code.
+Author: tivalsdeveloper
+License: MIT
+Project-URL: Homepage, https://github.com/tivalsdeveloper-oss/tivelweb
+Project-URL: Repository, https://github.com/tivalsdeveloper-oss/tivelweb
+Project-URL: Issues, https://github.com/tivalsdeveloper-oss/tivelweb/issues
+Keywords: website,static-site-generator,html,python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# TivelWeb
+
+TivelWeb is a lightweight Python library for building responsive static websites without writing all the HTML and CSS yourself.
+
+## Install locally
+
+```bash
+cd tivelweb
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Build your first website
+
+```python
+from tivelweb import Site, hero, section
+
+site = Site("My Website", theme_color="#6c5ce7")
+home = site.page("Home", description="My first Python website")
+home.add(hero("Welcome", "This website was built using Python.", "Learn more", "#about"))
+home.add(section("About", "TivelWeb generates fast static HTML."))
+site.build()
+```
+
+Run the file, then preview the generated `dist` folder:
+
+```bash
+python app.py
+tivelweb serve dist
+```
+
+Open `http://127.0.0.1:8000`.
+
+## Commands
+
+```bash
+tivelweb new mywebsite
+cd mywebsite
+python app.py
+tivelweb serve dist
+```
+
+## Features
+
+- Responsive pages and navigation
+- Hero, section, card, button, and image components
+- Multiple pages
+- Custom theme colors
+- Static asset copying
+- Built-in local preview server
+- No runtime dependencies
+
+## Test
+
+```bash
+python -m unittest discover -s tests
+```
+
+## License
+
+MIT
+

tivelweb-0.1.0/src/tivelweb.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/tivelweb/__init__.py
+src/tivelweb/cli.py
+src/tivelweb/components.py
+src/tivelweb/site.py
+src/tivelweb.egg-info/PKG-INFO
+src/tivelweb.egg-info/SOURCES.txt
+src/tivelweb.egg-info/dependency_links.txt
+src/tivelweb.egg-info/entry_points.txt
+src/tivelweb.egg-info/top_level.txt
+tests/test_tivelweb.py

tivelweb-0.1.0/src/tivelweb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tivelweb-0.1.0/src/tivelweb.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tivelweb = tivelweb.cli:main

tivelweb-0.1.0/src/tivelweb.egg-info/top_level.txt

@@ -0,0 +1 @@
+tivelweb

tivelweb-0.1.0/tests/test_tivelweb.py

@@ -0,0 +1,21 @@
+from pathlib import Path
+from tempfile import TemporaryDirectory
+import unittest
+
+from tivelweb import Site, hero
+
+
+class SiteTests(unittest.TestCase):
+    def test_builds_page(self):
+        with TemporaryDirectory() as folder:
+            site = Site("Test", output=folder)
+            site.page("Home").add(hero("Hello"))
+            site.build()
+            html = (Path(folder) / "index.html").read_text()
+            self.assertIn("Hello", html)
+            self.assertIn("Powered by tivalsdeveloper", html)
+
+
+if __name__ == "__main__":
+    unittest.main()
+