create-hayate 0.1.0__tar.gz

create_hayate-0.1.0/LICENSE

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

create_hayate-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: create-hayate
+Version: 0.1.0
+Summary: Scaffold a hayate project that is tested from minute one: uvx create-hayate my-app
+Keywords: hayate,scaffolding,project-template,cli
+Author: Yusuke Hayashi
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.12
+Project-URL: Repository, https://github.com/hayatepy/create-hayate
+Description-Content-Type: text/markdown
+
+# create-hayate
+
+Project scaffolding for [hayate](https://github.com/hayatepy/hayate) —
+`uvx create-hayate my-app` and you have a running, tested project in minutes.
+
+```sh
+uvx create-hayate my-app --template workers
+cd my-app
+uv run pytest        # green out of the box
+uv run pywrangler dev
+```
+
+## Templates
+
+| Name | What you get | Serve with |
+|---|---|---|
+| `api` (default) | TODO API + tests that call the app core directly | `uv run uvicorn app:app --reload` |
+| `workers` | The same app on Cloudflare Python Workers | `uv run pywrangler dev` / `deploy` |
+
+`lambda`, `mcp`, and `auth` templates follow as those packages ship.
+
+## Design
+
+- **Zero-dependency CLI** (stdlib only: argparse + `string.Template`), templates
+  bundled in the package — no network fetch, works offline, version-pinned.
+- Templates mirror the upstream `examples/` style, and CI generates every
+  template and runs its test suite, so they can't rot.
+- One question at most (the template); `--no-input` for scripts and CI.
+
+The internal design memo (Japanese, per project convention) lives in
+[DESIGN.md](DESIGN.md).
+
+## License
+
+MIT

create_hayate-0.1.0/README.md

@@ -0,0 +1,35 @@
+# create-hayate
+
+Project scaffolding for [hayate](https://github.com/hayatepy/hayate) —
+`uvx create-hayate my-app` and you have a running, tested project in minutes.
+
+```sh
+uvx create-hayate my-app --template workers
+cd my-app
+uv run pytest        # green out of the box
+uv run pywrangler dev
+```
+
+## Templates
+
+| Name | What you get | Serve with |
+|---|---|---|
+| `api` (default) | TODO API + tests that call the app core directly | `uv run uvicorn app:app --reload` |
+| `workers` | The same app on Cloudflare Python Workers | `uv run pywrangler dev` / `deploy` |
+
+`lambda`, `mcp`, and `auth` templates follow as those packages ship.
+
+## Design
+
+- **Zero-dependency CLI** (stdlib only: argparse + `string.Template`), templates
+  bundled in the package — no network fetch, works offline, version-pinned.
+- Templates mirror the upstream `examples/` style, and CI generates every
+  template and runs its test suite, so they can't rot.
+- One question at most (the template); `--no-input` for scripts and CI.
+
+The internal design memo (Japanese, per project convention) lives in
+[DESIGN.md](DESIGN.md).
+
+## License
+
+MIT

create_hayate-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["uv_build>=0.9,<1"]
+build-backend = "uv_build"
+
+[project]
+name = "create-hayate"
+version = "0.1.0"
+description = "Scaffold a hayate project that is tested from minute one: uvx create-hayate my-app"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Yusuke Hayashi" }]
+keywords = ["hayate", "scaffolding", "project-template", "cli"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Code Generators",
+]
+dependencies = []
+
+[project.scripts]
+create-hayate = "create_hayate.cli:main"
+
+[project.urls]
+Repository = "https://github.com/hayatepy/create-hayate"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.3",
+  "ruff>=0.9",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+extend-exclude = ["src/create_hayate/templates"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "RUF"]

create_hayate-0.1.0/src/create_hayate/__init__.py

@@ -0,0 +1,3 @@
+"""create-hayate: scaffold a hayate project from a bundled template."""
+
+__version__ = "0.1.0"

create_hayate-0.1.0/src/create_hayate/__main__.py

@@ -0,0 +1,6 @@
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

create_hayate-0.1.0/src/create_hayate/cli.py

@@ -0,0 +1,112 @@
+"""The whole CLI. Zero dependencies by design: argparse + shutil + string.Template.
+
+Template trees live in ``templates/<name>/`` inside this package and are copied
+file by file through ``string.Template`` (``$project_name`` is the only
+variable). Keeping the machinery this small is a feature — see DESIGN.md.
+"""
+
+from __future__ import annotations
+
+import argparse
+import re
+import shutil
+import sys
+from importlib.resources import files
+from pathlib import Path
+from string import Template
+
+TEMPLATES: dict[str, str] = {
+    "api": "TODO API + pytest, served by uvicorn",
+    "workers": "the same app on Cloudflare Python Workers",
+}
+DEFAULT_TEMPLATE = "api"
+
+# One name serves as directory, distribution, and Workers service name,
+# so enforce the strictest of the three.
+_NAME_RE = re.compile(r"^[a-z][a-z0-9-]*$")
+
+# Bundled name -> generated name. Build backends drop dotfiles from wheels,
+# so dotfiles are bundled without the leading dot.
+_RENAMES = {"gitignore": ".gitignore"}
+
+_SKIP_DIRS = {"__pycache__"}
+
+
+def _render_tree(src, dest: Path, variables: dict[str, str]) -> None:
+    dest.mkdir(parents=True, exist_ok=True)
+    for entry in src.iterdir():
+        if entry.name in _SKIP_DIRS:
+            continue
+        target = dest / _RENAMES.get(entry.name, entry.name)
+        if entry.is_dir():
+            _render_tree(entry, target, variables)
+        else:
+            text = entry.read_text(encoding="utf-8")
+            target.write_text(Template(text).substitute(variables), encoding="utf-8", newline="\n")
+
+
+def _choose_template() -> str:
+    names = list(TEMPLATES)
+    print("Which template?")
+    for i, name in enumerate(names, start=1):
+        print(f"  {i}) {name:<8}- {TEMPLATES[name]}")
+    while True:
+        try:
+            raw = input(f"Choose 1-{len(names)} [1]: ").strip()
+        except EOFError:
+            return DEFAULT_TEMPLATE
+        if not raw:
+            return names[0]
+        if raw in TEMPLATES:
+            return raw
+        if raw.isdigit() and 1 <= int(raw) <= len(names):
+            return names[int(raw) - 1]
+        print(f"Please answer 1-{len(names)} or a template name.")
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="create-hayate",
+        description="Scaffold a hayate project that is tested from minute one.",
+    )
+    parser.add_argument("name", help="project name; a directory of this name is created")
+    parser.add_argument(
+        "--template",
+        choices=tuple(TEMPLATES),
+        help="project template (prompted interactively when omitted)",
+    )
+    parser.add_argument(
+        "--no-input",
+        action="store_true",
+        help=f"never prompt; --template or the default ({DEFAULT_TEMPLATE}) is used",
+    )
+    args = parser.parse_args(argv)
+
+    if not _NAME_RE.match(args.name):
+        parser.error(
+            f"invalid project name {args.name!r}: use lowercase letters, digits, and"
+            " hyphens, starting with a letter (the name doubles as the Workers"
+            " service name)"
+        )
+    dest = Path.cwd() / args.name
+    if dest.exists():
+        parser.error(f"{dest} already exists")
+
+    template = args.template
+    if template is None:
+        interactive = not args.no_input and sys.stdin is not None and sys.stdin.isatty()
+        template = _choose_template() if interactive else DEFAULT_TEMPLATE
+
+    src = files("create_hayate").joinpath("templates", template)
+    try:
+        _render_tree(src, dest, {"project_name": args.name})
+    except BaseException:
+        shutil.rmtree(dest, ignore_errors=True)
+        raise
+
+    serve = "uv run uvicorn app:app --reload" if template == "api" else "uv run pywrangler dev"
+    print(f"\nCreated {args.name}/ from the {template} template. Next:\n")
+    print(f"  cd {args.name}")
+    print("  uv run pytest")
+    print(f"  {serve}")
+    return 0

create_hayate-0.1.0/src/create_hayate/templates/api/README.md

@@ -0,0 +1,26 @@
+# $project_name
+
+A TODO API built with [hayate](https://github.com/hayatepy/hayate) —
+web-standards-first, zero dependencies, tested without a server.
+
+## Test
+
+```sh
+uv run pytest
+```
+
+Tests call the app core directly (`await app.request(...)`); there is no test
+client or server to boot.
+
+## Serve
+
+```sh
+uv run uvicorn app:app --reload
+```
+
+Then:
+
+```sh
+curl -X POST localhost:8000/todos -H 'content-type: application/json' -d '{"title": "try hayate"}'
+curl localhost:8000/todos
+```

create_hayate-0.1.0/src/create_hayate/templates/api/app.py

@@ -0,0 +1,49 @@
+"""$project_name: a TODO API on hayate.
+
+Request/Response follow WHATWG Fetch semantics, so this app is a pure
+``fetch(Request) -> Response`` core: any ASGI server runs it, and the same
+file works on Cloudflare Python Workers unchanged.
+"""
+
+from hayate import Context, Hayate, HTTPException
+
+app = Hayate()
+
+TODOS: dict[str, dict] = {}
+_serial = 0
+
+
+def _next_id() -> str:
+    global _serial
+    _serial += 1
+    return str(_serial)
+
+
+@app.get("/todos")
+async def list_todos(c: Context):
+    return c.json(list(TODOS.values()))
+
+
+@app.post("/todos")
+async def create_todo(c: Context):
+    data = await c.req.json()
+    if not isinstance(data, dict) or not isinstance(data.get("title"), str):
+        raise HTTPException(400, title="Body must be a JSON object with a string 'title'")
+    todo = {"id": _next_id(), "title": data["title"], "done": False}
+    TODOS[todo["id"]] = todo
+    return c.json(todo, status=201)
+
+
+@app.get("/todos/:id")
+async def show_todo(c: Context):
+    todo = TODOS.get(c.req.param("id"))
+    if todo is None:
+        raise HTTPException(404, title="Todo not found")
+    return c.json(todo)
+
+
+@app.delete("/todos/:id")
+async def delete_todo(c: Context):
+    if TODOS.pop(c.req.param("id"), None) is None:
+        raise HTTPException(404, title="Todo not found")
+    return c.body(None, status=204)

create_hayate-0.1.0/src/create_hayate/templates/api/gitignore

@@ -0,0 +1,3 @@
+.venv/
+__pycache__/
+.pytest_cache/

create_hayate-0.1.0/src/create_hayate/templates/api/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "$project_name"
+version = "0.1.0"
+requires-python = ">=3.12"
+dependencies = ["hayate>=0.6.0"]
+
+[dependency-groups]
+dev = [
+  "pytest>=8.3",
+  "pytest-asyncio>=0.25",
+  "uvicorn>=0.30",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["."]

create_hayate-0.1.0/src/create_hayate/templates/api/tests/test_app.py

@@ -0,0 +1,28 @@
+"""Tests hit the app core directly: no server, no test client, no sockets."""
+
+from app import app
+
+
+async def test_crud_roundtrip():
+    res = await app.request("/todos", method="POST", json={"title": "ship it"})
+    assert res.status == 201
+    todo = await res.json()
+    assert todo["title"] == "ship it"
+    assert todo["done"] is False
+
+    res = await app.request(f"/todos/{todo['id']}")
+    assert res.status == 200
+
+    res = await app.request("/todos")
+    assert any(t["id"] == todo["id"] for t in await res.json())
+
+    res = await app.request(f"/todos/{todo['id']}", method="DELETE")
+    assert res.status == 204
+
+    res = await app.request(f"/todos/{todo['id']}")
+    assert res.status == 404
+
+
+async def test_create_requires_string_title():
+    res = await app.request("/todos", method="POST", json={"title": 42})
+    assert res.status == 400

create_hayate-0.1.0/src/create_hayate/templates/workers/README.md

@@ -0,0 +1,33 @@
+# $project_name
+
+A TODO API built with [hayate](https://github.com/hayatepy/hayate), deployed
+to [Cloudflare Python Workers](https://developers.cloudflare.com/workers/languages/python/).
+The app core is runtime-agnostic — the same `app.py` runs on any ASGI server too.
+
+## Test
+
+```sh
+uv run pytest
+```
+
+Tests call the app core directly (`await app.request(...)`); no server or
+workerd needed.
+
+## Develop locally
+
+```sh
+uv run pywrangler dev
+```
+
+Then:
+
+```sh
+curl -X POST localhost:8787/todos -H 'content-type: application/json' -d '{"title": "try hayate"}'
+curl localhost:8787/todos
+```
+
+## Deploy
+
+```sh
+uv run pywrangler deploy
+```

create_hayate-0.1.0/src/create_hayate/templates/workers/app.py

@@ -0,0 +1,49 @@
+"""$project_name: a TODO API on hayate.
+
+Request/Response follow WHATWG Fetch semantics, so this app is a pure
+``fetch(Request) -> Response`` core: any ASGI server runs it, and the same
+file works on Cloudflare Python Workers unchanged.
+"""
+
+from hayate import Context, Hayate, HTTPException
+
+app = Hayate()
+
+TODOS: dict[str, dict] = {}
+_serial = 0
+
+
+def _next_id() -> str:
+    global _serial
+    _serial += 1
+    return str(_serial)
+
+
+@app.get("/todos")
+async def list_todos(c: Context):
+    return c.json(list(TODOS.values()))
+
+
+@app.post("/todos")
+async def create_todo(c: Context):
+    data = await c.req.json()
+    if not isinstance(data, dict) or not isinstance(data.get("title"), str):
+        raise HTTPException(400, title="Body must be a JSON object with a string 'title'")
+    todo = {"id": _next_id(), "title": data["title"], "done": False}
+    TODOS[todo["id"]] = todo
+    return c.json(todo, status=201)
+
+
+@app.get("/todos/:id")
+async def show_todo(c: Context):
+    todo = TODOS.get(c.req.param("id"))
+    if todo is None:
+        raise HTTPException(404, title="Todo not found")
+    return c.json(todo)
+
+
+@app.delete("/todos/:id")
+async def delete_todo(c: Context):
+    if TODOS.pop(c.req.param("id"), None) is None:
+        raise HTTPException(404, title="Todo not found")
+    return c.body(None, status=204)

create_hayate-0.1.0/src/create_hayate/templates/workers/entry.py

@@ -0,0 +1,6 @@
+"""Cloudflare Python Workers entry: the same app, exposed through the adapter."""
+
+from app import app
+from hayate.adapters.workers import to_workers
+
+Default = to_workers(app)

create_hayate-0.1.0/src/create_hayate/templates/workers/gitignore

@@ -0,0 +1,6 @@
+.venv/
+.venv-workers/
+python_modules/
+__pycache__/
+.pytest_cache/
+.wrangler/

create_hayate-0.1.0/src/create_hayate/templates/workers/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "$project_name"
+version = "0.1.0"
+requires-python = ">=3.12"
+dependencies = ["hayate>=0.6.0"]
+
+[dependency-groups]
+dev = [
+  "pytest>=8.3",
+  "pytest-asyncio>=0.25",
+  "workers-py",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["."]

create_hayate-0.1.0/src/create_hayate/templates/workers/tests/test_app.py

@@ -0,0 +1,28 @@
+"""Tests hit the app core directly: no server, no test client, no sockets."""
+
+from app import app
+
+
+async def test_crud_roundtrip():
+    res = await app.request("/todos", method="POST", json={"title": "ship it"})
+    assert res.status == 201
+    todo = await res.json()
+    assert todo["title"] == "ship it"
+    assert todo["done"] is False
+
+    res = await app.request(f"/todos/{todo['id']}")
+    assert res.status == 200
+
+    res = await app.request("/todos")
+    assert any(t["id"] == todo["id"] for t in await res.json())
+
+    res = await app.request(f"/todos/{todo['id']}", method="DELETE")
+    assert res.status == 204
+
+    res = await app.request(f"/todos/{todo['id']}")
+    assert res.status == 404
+
+
+async def test_create_requires_string_title():
+    res = await app.request("/todos", method="POST", json={"title": 42})
+    assert res.status == 400

create_hayate-0.1.0/src/create_hayate/templates/workers/wrangler.toml

@@ -0,0 +1,4 @@
+name = "$project_name"
+main = "entry.py"
+compatibility_date = "2026-07-01"
+compatibility_flags = ["python_workers"]