pyhttp-app 2.0.1.post1__tar.gz → 2.0.3__tar.gz

{pyhttp_app-2.0.1.post1/pyhttp_app.egg-info → pyhttp_app-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyhttp-app
-Version: 2.0.1.post1
+Version: 2.0.3
 Summary: Local API client and alternative to Postman: collection runner, Postman-compatible scripts, mock servers and an MCP server
 Author-email: pyhttp Dev Team <dev@pyhttp.com>
 License: # pyhttp Free License 1.1
@@ -171,7 +171,10 @@ only on `127.0.0.1`.
 - **Named bodies**: a request can hold many bodies, each with its own name
   (for example `valid user`, `missing email`). Search bodies by name or content,
   and tick the ones to send. **Send** hits the request once per checked body and
-  saves every output to a run folder, with the body name in the file names.
+  saves every output to a run folder, with the body name in the file names. The
+  ➤ next to a body sends just that body, without touching the checkboxes
+  (Ctrl/Cmd+Shift+Enter does the same for the body in the editor); its ⋯ menu
+  duplicates, reorders or deletes a body without opening it.
 - **Search** across name, description, URL, tags and body names; filter by tag chips.
 - **Monitors** (topbar → Monitors): picked requests are sent again every N
   minutes while the app is open. A check fails when a request errors, answers
@@ -283,6 +286,28 @@ only on `127.0.0.1`.
 - No Node, no Electron, no build step to run it. Python 3.10+ only (the editor is a
   prebuilt CodeMirror bundle checked into the repo).
 
+## Projects
+
+A project is a separate workspace: its own requests, folders, environments, variables,
+history, cookies, run outputs, mocks and monitors. Click the project name in the top bar to
+switch, create, rename or delete one. Everything you had before projects existed is the
+*Default* project and stays where it was; each new project lives in its own folder under
+the data directory (`projects/<id>/pyhttp.db` and `projects/<id>/outputs`). App settings
+(theme, proxy, fonts…) are copied into a new project so it does not start bare. The CLI
+runner uses the active project, or `pyhttp run --project "Shop API" …` for another one;
+`pyhttp mcp --project …` serves one project to an MCP client.
+
+From a terminal: `pyhttp projects` lists them, `pyhttp projects create NAME [--use]`,
+`use NAME`, `rename OLD NEW` and `delete NAME` manage them. `pyhttp doctor` checks every
+project's database (integrity, row counts), reports run output sizes and orphan folders,
+and `pyhttp doctor --clean-outputs 30` deletes run folders older than 30 days.
+
+**Export ▾ → pyhttp JSON** writes the whole project (collection, environments, variables,
+mocks, monitors) to one file that imports into another project or machine; monitors and
+"send this request first" links are kept. **Export ▾ → Documentation** writes the
+collection as Markdown: folders, requests, parameters, headers (credential-looking values
+masked), auth, example bodies and tests.
+
 ## Mock servers
 
 An API you need does not exist yet, or you want it to fail on demand. Open
@@ -338,8 +363,11 @@ pyhttp
 ```
 
 On Linux, install the GTK webview bindings first (see *Linux* below) or use
-`pyhttp --browser`. `brew install pyhttp2/pyhttp/pyhttp-app` installs the
-same package through Homebrew (macOS and Linux, Intel and ARM).
+`pyhttp --browser`. `brew install pyhttp2/pyhttp/pyhttp` installs the
+same package through Homebrew (macOS and Linux, Intel and ARM; the tap is
+[pyhttp2/homebrew-pyhttp](https://github.com/pyhttp2/homebrew-pyhttp)) — or tap
+once with `brew tap pyhttp2/pyhttp`, after which plain `brew install pyhttp`,
+`brew upgrade pyhttp` and `brew install --cask pyhttp` all work.
 
 **Windows**: double-click `run.bat`. The window opens without a console.
 WebView2 ships with Windows 10/11.
@@ -446,7 +474,7 @@ Packaged builds bundle Python and every dependency, so users just double-click.
 |---|---|---|
 | Windows 10/11 | `pyhttp-<version>-windows-x64-setup.exe`: installer (per user, no admin rights, into `%LOCALAPPDATA%\Programs\pyhttp`, Start menu entry, optional desktop icon, uninstaller in *Apps*) | `%APPDATA%\pyhttp` |
 | Windows 10/11 | `pyhttp-<version>-windows-x64.exe`: portable, one file, no install | `%APPDATA%\pyhttp` |
-| macOS 11+ | `brew tap pyhttp2/pyhttp https://github.com/pyhttp2/pyhttp-releases && brew install --cask pyhttp2/pyhttp/pyhttp`, or `pyhttp-<version>-macos-arm64.dmg` (drag pyhttp to Applications) | `~/Library/Application Support/pyhttp` |
+| macOS 11+ | `brew install --cask pyhttp2/pyhttp/pyhttp`, or `pyhttp-<version>-macos-arm64.dmg` (drag pyhttp to Applications) | `~/Library/Application Support/pyhttp` |
 | Ubuntu 22.04+, Debian 12+ | `sudo apt install ./pyhttp-<version>-linux-amd64.deb`: installs to `/usr/lib/pyhttp`, adds `pyhttp` to the PATH and an app-menu entry; uses the distro's GTK and WebKitGTK (pulled in as dependencies) | `~/.local/share/pyhttp` |
 
 Running from source keeps using `./data`. In the packaged app, output that would
@@ -507,10 +535,14 @@ python packaging/bump.py 0.1.2
 ```
 
 That sets `__version__`, commits, creates the tag `v0.1.2` and pushes both. The
-tag run publishes the installer, the portable `.exe`, the `.dmg`, `SHA256SUMS.txt`,
-the license files and the Homebrew cask to the public
-[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases) repository (needs the
-`RELEASE_TOKEN` secret). The Windows runner installs Inno Setup with Chocolatey when
+tag run publishes the installer, the portable `.exe`, the `.dmg`, `SHA256SUMS.txt`
+and the license files to this repository's Releases page, uploads `pyhttp-app` to
+PyPI (secret `PYPI_API_TOKEN`), updates the Homebrew tap
+([homebrew-pyhttp](https://github.com/pyhttp2/homebrew-pyhttp): cask + formula)
+and mirrors everything to
+[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases) so installs from
+before the move keep updating (the mirror and taps need the `RELEASE_TOKEN`
+secret, a fine-grained PAT with Contents: write on those two repositories). The Windows runner installs Inno Setup with Chocolatey when
 it is not already there. The in-app updater refuses a release without `SHA256SUMS.txt`,
 so keep that step in the workflow. A tag whose version differs from `__version__` is refused,
 because the release name, file names and the in-app update check all come from
@@ -572,8 +604,10 @@ is not allowed, and the name and logo stay with the project. The source code is
 published on PyPI as [`pyhttp-app`](https://pypi.org/project/pyhttp-app/)
 so it can be inspected and installed with pip; you may modify your own copy but
 not distribute the changes. The packaged installer, `.exe`, `.dmg` and `.deb`
-builds are published from the public
-[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases) repository.
+builds are published on this repository's
+[Releases](https://github.com/pyhttp2/pyhttp/releases) page and mirrored to
+[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases), the old home,
+so installs from before the move keep updating.
 Bundled open-source components are listed in
 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
 

{pyhttp_app-2.0.1.post1 → pyhttp_app-2.0.3}/README.md

@@ -22,7 +22,10 @@ only on `127.0.0.1`.
 - **Named bodies**: a request can hold many bodies, each with its own name
   (for example `valid user`, `missing email`). Search bodies by name or content,
   and tick the ones to send. **Send** hits the request once per checked body and
-  saves every output to a run folder, with the body name in the file names.
+  saves every output to a run folder, with the body name in the file names. The
+  ➤ next to a body sends just that body, without touching the checkboxes
+  (Ctrl/Cmd+Shift+Enter does the same for the body in the editor); its ⋯ menu
+  duplicates, reorders or deletes a body without opening it.
 - **Search** across name, description, URL, tags and body names; filter by tag chips.
 - **Monitors** (topbar → Monitors): picked requests are sent again every N
   minutes while the app is open. A check fails when a request errors, answers
@@ -134,6 +137,28 @@ only on `127.0.0.1`.
 - No Node, no Electron, no build step to run it. Python 3.10+ only (the editor is a
   prebuilt CodeMirror bundle checked into the repo).
 
+## Projects
+
+A project is a separate workspace: its own requests, folders, environments, variables,
+history, cookies, run outputs, mocks and monitors. Click the project name in the top bar to
+switch, create, rename or delete one. Everything you had before projects existed is the
+*Default* project and stays where it was; each new project lives in its own folder under
+the data directory (`projects/<id>/pyhttp.db` and `projects/<id>/outputs`). App settings
+(theme, proxy, fonts…) are copied into a new project so it does not start bare. The CLI
+runner uses the active project, or `pyhttp run --project "Shop API" …` for another one;
+`pyhttp mcp --project …` serves one project to an MCP client.
+
+From a terminal: `pyhttp projects` lists them, `pyhttp projects create NAME [--use]`,
+`use NAME`, `rename OLD NEW` and `delete NAME` manage them. `pyhttp doctor` checks every
+project's database (integrity, row counts), reports run output sizes and orphan folders,
+and `pyhttp doctor --clean-outputs 30` deletes run folders older than 30 days.
+
+**Export ▾ → pyhttp JSON** writes the whole project (collection, environments, variables,
+mocks, monitors) to one file that imports into another project or machine; monitors and
+"send this request first" links are kept. **Export ▾ → Documentation** writes the
+collection as Markdown: folders, requests, parameters, headers (credential-looking values
+masked), auth, example bodies and tests.
+
 ## Mock servers
 
 An API you need does not exist yet, or you want it to fail on demand. Open
@@ -189,8 +214,11 @@ pyhttp
 ```
 
 On Linux, install the GTK webview bindings first (see *Linux* below) or use
-`pyhttp --browser`. `brew install pyhttp2/pyhttp/pyhttp-app` installs the
-same package through Homebrew (macOS and Linux, Intel and ARM).
+`pyhttp --browser`. `brew install pyhttp2/pyhttp/pyhttp` installs the
+same package through Homebrew (macOS and Linux, Intel and ARM; the tap is
+[pyhttp2/homebrew-pyhttp](https://github.com/pyhttp2/homebrew-pyhttp)) — or tap
+once with `brew tap pyhttp2/pyhttp`, after which plain `brew install pyhttp`,
+`brew upgrade pyhttp` and `brew install --cask pyhttp` all work.
 
 **Windows**: double-click `run.bat`. The window opens without a console.
 WebView2 ships with Windows 10/11.
@@ -297,7 +325,7 @@ Packaged builds bundle Python and every dependency, so users just double-click.
 |---|---|---|
 | Windows 10/11 | `pyhttp-<version>-windows-x64-setup.exe`: installer (per user, no admin rights, into `%LOCALAPPDATA%\Programs\pyhttp`, Start menu entry, optional desktop icon, uninstaller in *Apps*) | `%APPDATA%\pyhttp` |
 | Windows 10/11 | `pyhttp-<version>-windows-x64.exe`: portable, one file, no install | `%APPDATA%\pyhttp` |
-| macOS 11+ | `brew tap pyhttp2/pyhttp https://github.com/pyhttp2/pyhttp-releases && brew install --cask pyhttp2/pyhttp/pyhttp`, or `pyhttp-<version>-macos-arm64.dmg` (drag pyhttp to Applications) | `~/Library/Application Support/pyhttp` |
+| macOS 11+ | `brew install --cask pyhttp2/pyhttp/pyhttp`, or `pyhttp-<version>-macos-arm64.dmg` (drag pyhttp to Applications) | `~/Library/Application Support/pyhttp` |
 | Ubuntu 22.04+, Debian 12+ | `sudo apt install ./pyhttp-<version>-linux-amd64.deb`: installs to `/usr/lib/pyhttp`, adds `pyhttp` to the PATH and an app-menu entry; uses the distro's GTK and WebKitGTK (pulled in as dependencies) | `~/.local/share/pyhttp` |
 
 Running from source keeps using `./data`. In the packaged app, output that would
@@ -358,10 +386,14 @@ python packaging/bump.py 0.1.2
 ```
 
 That sets `__version__`, commits, creates the tag `v0.1.2` and pushes both. The
-tag run publishes the installer, the portable `.exe`, the `.dmg`, `SHA256SUMS.txt`,
-the license files and the Homebrew cask to the public
-[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases) repository (needs the
-`RELEASE_TOKEN` secret). The Windows runner installs Inno Setup with Chocolatey when
+tag run publishes the installer, the portable `.exe`, the `.dmg`, `SHA256SUMS.txt`
+and the license files to this repository's Releases page, uploads `pyhttp-app` to
+PyPI (secret `PYPI_API_TOKEN`), updates the Homebrew tap
+([homebrew-pyhttp](https://github.com/pyhttp2/homebrew-pyhttp): cask + formula)
+and mirrors everything to
+[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases) so installs from
+before the move keep updating (the mirror and taps need the `RELEASE_TOKEN`
+secret, a fine-grained PAT with Contents: write on those two repositories). The Windows runner installs Inno Setup with Chocolatey when
 it is not already there. The in-app updater refuses a release without `SHA256SUMS.txt`,
 so keep that step in the workflow. A tag whose version differs from `__version__` is refused,
 because the release name, file names and the in-app update check all come from
@@ -423,8 +455,10 @@ is not allowed, and the name and logo stay with the project. The source code is
 published on PyPI as [`pyhttp-app`](https://pypi.org/project/pyhttp-app/)
 so it can be inspected and installed with pip; you may modify your own copy but
 not distribute the changes. The packaged installer, `.exe`, `.dmg` and `.deb`
-builds are published from the public
-[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases) repository.
+builds are published on this repository's
+[Releases](https://github.com/pyhttp2/pyhttp/releases) page and mirrored to
+[pyhttp-releases](https://github.com/pyhttp2/pyhttp-releases), the old home,
+so installs from before the move keep updating.
 Bundled open-source components are listed in
 [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
 

{pyhttp_app-2.0.1.post1 → pyhttp_app-2.0.3}/pyhttp/__init__.py

@@ -1,6 +1,6 @@
 """pyhttp - a local API client and alternative to Postman, with a collection runner."""
 
-__version__ = "2.0.1.post1"
+__version__ = "2.0.3"
 # sent with every request unless the user sets their own in Settings; the convention is "product/version (+url)"
 USER_AGENT = f"pyhttp/{__version__}"
 __license__ = "pyhttp Free License 1.0 (free for everyone; source not distributed)"

{pyhttp_app-2.0.1.post1 → pyhttp_app-2.0.3}/pyhttp/__main__.py

@@ -189,8 +189,12 @@ def main() -> None:
         from . import mcp
         mcp.main(sys.argv[2:], DEFAULT_DATA_DIR)
         return
+    if len(sys.argv) > 1 and sys.argv[1] in ("projects", "doctor"):
+        from . import tools
+        fn = tools.projects_main if sys.argv[1] == "projects" else tools.doctor_main
+        sys.exit(fn(sys.argv[2:], DEFAULT_DATA_DIR))
     parser = argparse.ArgumentParser(prog="pyhttp", description="Local API client (alternative to Postman)",
-                                     epilog="Headless runs for CI: pyhttp run --help")
+                                     epilog="Headless runs for CI: pyhttp run --help · workspaces: pyhttp projects --help · checks: pyhttp doctor")
     mode = parser.add_mutually_exclusive_group()
     mode.add_argument("--browser", action="store_true", help="open the UI in your web browser")
     mode.add_argument("--server", action="store_true", help="run the API server only, no UI")

{pyhttp_app-2.0.1.post1 → pyhttp_app-2.0.3}/pyhttp/app.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import asyncio
+import contextlib
 import csv
 import io
 import json
@@ -19,12 +20,12 @@ from fastapi.responses import FileResponse, HTMLResponse, JSONResponse, Streamin
 from fastapi.staticfiles import StaticFiles
 from pydantic import BaseModel, Field
 
-from . import (USER_AGENT, __version__, console, curl, db, mock, monitors, oauth2, openapi, postman, runner,
-               templating, updater)
+from . import (USER_AGENT, __version__, console, curl, db, docs, mock, monitors, oauth2, openapi, postman, projects,
+               runner, templating, updater)
 from .templating import build_context, render
 
 STATIC_DIR = Path(__file__).parent / "static"
-DEFAULT_RELEASE_REPO = "pyhttp2/pyhttp-releases"  # public repo that holds the .exe/.dmg releases
+DEFAULT_RELEASE_REPO = "pyhttp2/pyhttp"  # public repo whose Releases page holds the .exe/.dmg builds
 try:  # written by packaging/build.py so packaged apps know where their releases live
     from ._build import GITHUB_REPO as _BUILT_REPO
 except ImportError:  # pragma: no cover - source checkout
@@ -215,6 +216,8 @@ class ImportIn(BaseModel):
     environments: list[EnvIn] = Field(default_factory=list)
     requests: list[RequestIn] = Field(default_factory=list)
     variables: dict[str, str] = Field(default_factory=dict)
+    mocks: list[dict[str, Any]] = Field(default_factory=list)
+    monitors: list[dict[str, Any]] = Field(default_factory=list)
     replace: bool = False
 
 
@@ -317,8 +320,11 @@ def _version_tuple(v: str) -> tuple[int, ...]:
 
 
 def import_collection(folders: list[dict[str, Any]], requests: list[dict[str, Any]], environments: list[dict[str, Any]],
-                      variables: dict[str, str], replace: bool) -> dict[str, Any]:
-    """Create folders (parents first), requests and environments; optionally replace everything."""
+                      variables: dict[str, str], replace: bool, mocks: list[dict[str, Any]] | None = None,
+                      monitors: list[dict[str, Any]] | None = None) -> dict[str, Any]:
+    """Create folders (parents first), requests and environments; optionally replace everything.
+    A full export also carries mocks and monitors. Requests that come with their old ``id`` are
+    remapped, so monitors and "depends on" links between requests survive the round trip."""
     if replace:
         for r in db.list_requests():
             db.delete_request(r["id"])
@@ -327,6 +333,12 @@ def import_collection(folders: list[dict[str, Any]], requests: list[dict[str, An
                 db.delete_folder(f["id"])
         for e in db.list_environments():
             db.delete_environment(e["id"])
+        if mocks:
+            for m in db.list_mocks(with_routes=False):
+                db.delete_mock(m["id"])
+        if monitors:
+            for m in db.list_monitors():
+                db.delete_monitor(m["id"])
     # folders: create parents before children, remapping ids
     id_map: dict[str, str] = {}
     pending = list(folders)
@@ -346,17 +358,45 @@ def import_collection(folders: list[dict[str, Any]], requests: list[dict[str, An
                 id_map[f["id"]] = db.create_folder(f["name"])["id"]
             break
     created = []
+    req_map: dict[str, str] = {}   # id in the file -> id in this database
     for r in requests:
         data = dict(r)
         data["folder_id"] = id_map.get(r.get("folder_id") or "")
-        created.append(db.create_request(data))
+        new_r = db.create_request(data)
+        created.append(new_r)
+        if r.get("id"):
+            req_map[str(r["id"])] = new_r["id"]
+    # "send this request first" links point at ids from the file: point them at the new rows
+    for old_r, new_r in zip(requests, created):
+        dep = ((old_r.get("options") or {}).get("depends") or {}) if isinstance(old_r.get("options"), dict) else {}
+        target = req_map.get(str(dep.get("request_id") or ""))
+        if target:
+            opts = dict(new_r.get("options") or {})
+            opts["depends"] = {**dep, "request_id": target}
+            db.update_request(new_r["id"], {**new_r, "options": opts})
     for e in environments:
         db.create_environment(e["name"], e.get("variables") or [])
     if variables:
         merged = {} if replace else db.get_variables()
         merged.update(variables)
         db.set_variables(merged)
-    return {"imported": len(created), "folders": len(id_map), "environments": len(environments)}
+    n_mocks = 0
+    for m in mocks or []:
+        if isinstance(m, dict):
+            db.create_mock({k: v for k, v in m.items() if k not in ("id", "created_at", "hits")})
+            n_mocks += 1
+    n_monitors = 0
+    for m in monitors or []:
+        if not isinstance(m, dict):
+            continue
+        ids = [req_map.get(str(i), "") for i in (m.get("request_ids") or [])]
+        ids = [i for i in ids if i]
+        if ids:   # a monitor without requests to send is pointless
+            db.create_monitor({**{k: v for k, v in m.items() if k not in ("id", "created_at", "last_run_at", "last_status")},
+                               "request_ids": ids})
+            n_monitors += 1
+    return {"imported": len(created), "folders": len(id_map), "environments": len(environments),
+            "mocks": n_mocks, "monitors": n_monitors}
 
 
 def _own_origin(request: Request) -> str:
@@ -385,35 +425,117 @@ def _mock_route_payload(data: dict[str, Any]) -> dict[str, Any]:
     return data
 
 
-def create_app(data_dir: Path) -> FastAPI:
+def create_app(data_dir: Path, project: str | None = None) -> FastAPI:
+    """``project`` (an id or a name) opens that project instead of the active one, without changing
+    which one is active — the CLI uses it for ``--project``."""
     data_dir = data_dir.resolve()
     data_dir.mkdir(parents=True, exist_ok=True)
-    output_dir = data_dir / "outputs"
+    registry = projects.Registry(data_dir)
+    if project:
+        found = registry.find(project)
+        if found is None:
+            raise ValueError(f"No project called “{project}” (projects: {', '.join(p['name'] for p in registry.list())})")
+        project_id = found["id"]
+    else:
+        project_id = registry.active()
+    db_path, output_dir = registry.paths(project_id)
     output_dir.mkdir(parents=True, exist_ok=True)
-    db.init(data_dir / "pyhttp.db")
+    db.init(db_path)
     db.mark_interrupted_runs()
     manager = runner.RunManager(output_dir)
     scheduler = monitors.MonitorScheduler()
     update_cache: dict[str, Any] = {}
     self_updater = updater.Updater(data_dir)
+    current = {"id": project_id}   # the project this app instance has open
 
-    app = FastAPI(title="pyhttp", version=__version__, docs_url="/api/docs", redoc_url=None)
-
-    @app.on_event("startup")
-    async def _start_monitors() -> None:
+    @contextlib.asynccontextmanager
+    async def lifespan(_app: FastAPI):
         scheduler.start()
+        try:
+            yield
+        finally:
+            scheduler.stop()
 
-    @app.on_event("shutdown")
-    async def _stop_monitors() -> None:
-        scheduler.stop()
+    app = FastAPI(title="pyhttp", version=__version__, docs_url="/api/docs", redoc_url=None, lifespan=lifespan)
+
+    def current_project() -> dict[str, Any]:
+        return registry.get(current["id"]) or {"id": current["id"], "name": current["id"]}
+
+    def open_project(pid: str) -> None:
+        """Switch this app to another project's database and output folder."""
+        new_db, new_out = registry.paths(pid)
+        new_out.mkdir(parents=True, exist_ok=True)
+        db.switch(new_db)
+        db.mark_interrupted_runs()
+        manager.output_root = new_out
+        oauth2.forget()   # tokens belong to the project they were fetched in
+        current["id"] = pid
 
     # ------------------------------------------------------------------ meta
     @app.get("/api/meta")
     def meta() -> dict[str, Any]:
-        return {"version": __version__, "data_dir": str(data_dir), "output_dir": str(output_dir),
+        return {"version": __version__, "data_dir": str(data_dir), "output_dir": str(manager.output_root),
+                "project": current_project(),
                 "github_repo": github_repo(), "frozen": bool(getattr(sys, "frozen", False)), "platform": sys.platform,
                 "install": updater.info(), "user_agent": USER_AGENT, "python": sys.executable}
 
+    # -------------------------------------------------------------- projects
+    # A project is a separate workspace (its own database and output folder, see projects.py).
+    # Switching reopens the database under this process, so the UI reloads afterwards.
+    def projects_payload() -> dict[str, Any]:
+        return {"current": current["id"], "active": registry.active(), "projects": registry.list()}
+
+    @app.get("/api/projects")
+    def list_projects() -> dict[str, Any]:
+        return projects_payload()
+
+    @app.post("/api/projects")
+    def create_project(body: dict[str, Any]) -> dict[str, Any]:
+        """Create a project (app settings are copied in so it does not start bare) and switch to it,
+        unless ``switch`` is false."""
+        try:
+            p = registry.create(str(body.get("name") or ""))
+        except ValueError as exc:
+            raise HTTPException(400, str(exc)) from exc
+        settings = db.app_settings_rows() if body.get("copy_settings", True) else None
+        db.seed_database(registry.paths(p["id"])[0], settings)
+        if body.get("switch", True):
+            return activate_project(p["id"])
+        return {**projects_payload(), "created": p}
+
+    @app.post("/api/projects/{pid}/activate")
+    def activate_project(pid: str) -> dict[str, Any]:
+        if registry.get(pid) is None:
+            raise HTTPException(404, "Project not found")
+        if manager.any_active():
+            raise HTTPException(409, "A run is still going. Wait for it to finish or cancel it, then switch.")
+        if pid != current["id"]:
+            open_project(pid)
+        registry.set_active(pid)
+        return projects_payload()
+
+    @app.patch("/api/projects/{pid}")
+    def rename_project(pid: str, body: dict[str, Any]) -> dict[str, Any]:
+        try:
+            registry.rename(pid, str(body.get("name") or ""))
+        except KeyError as exc:
+            raise HTTPException(404, "Project not found") from exc
+        except ValueError as exc:
+            raise HTTPException(400, str(exc)) from exc
+        return projects_payload()
+
+    @app.delete("/api/projects/{pid}")
+    def delete_project(pid: str) -> dict[str, Any]:
+        if pid == current["id"]:
+            raise HTTPException(409, "Switch to another project before deleting this one")
+        try:
+            registry.delete(pid)
+        except KeyError as exc:
+            raise HTTPException(404, "Project not found") from exc
+        except ValueError as exc:
+            raise HTTPException(409, str(exc)) from exc
+        return projects_payload()
+
     @app.get("/api/update-check")
     async def update_check(force: bool = Query(False)) -> dict[str, Any]:
         """Latest GitHub release, compared with the running version (cached for an hour)."""
@@ -459,8 +581,16 @@ def create_app(data_dir: Path) -> FastAPI:
 
     # -------------------------------------------------------------- requests
     @app.get("/api/requests")
-    def list_requests(q: str = Query(""), tag: str = Query("")) -> list[dict[str, Any]]:
-        return db.list_requests(q, tag)
+    def list_requests(q: str = Query(""), tag: str = Query(""), fields: str = Query("")) -> list[dict[str, Any]]:
+        """``fields=list`` returns what the sidebar needs (no body text, scripts, headers…): a few
+        hundred requests with big bodies would otherwise be shipped on every autosave."""
+        items = db.list_requests(q, tag)
+        if fields != "list":
+            return items
+        return [{"id": r["id"], "name": r["name"], "method": r["method"], "url": r["url"], "tags": r["tags"],
+                 "folder_id": r.get("folder_id"), "position": r.get("position", 0), "body_type": r["body_type"],
+                 "bodies": [{"id": b["id"], "name": b["name"], "enabled": b["enabled"]} for b in r["bodies"]],
+                 "updated_at": r.get("updated_at")} for r in items]
 
     @app.post("/api/requests", status_code=201)
     def create_request(body: RequestIn) -> dict[str, Any]:
@@ -836,8 +966,10 @@ def create_app(data_dir: Path) -> FastAPI:
 
     # --------------------------------------------------------------- history
     @app.get("/api/history")
-    def history(q: str = Query(""), limit: int = Query(300), status: str = Query("")) -> list[dict[str, Any]]:
-        return db.list_history(limit=min(max(limit, 1), 1000), q=q, status=status)
+    def history(q: str = Query(""), limit: int = Query(300), status: str = Query(""),
+                before: float | None = Query(None)) -> list[dict[str, Any]]:
+        """Newest first. ``before`` (a timestamp from the last row shown) pages further back."""
+        return db.list_history(limit=min(max(limit, 1), 1000), q=q, status=status, before=before)
 
     @app.post("/api/history/{hid}/resend")
     async def history_resend(hid: str) -> dict[str, Any]:
@@ -938,8 +1070,9 @@ def create_app(data_dir: Path) -> FastAPI:
         return sample_data_file(requests, "json" if format == "json" else "csv")
 
     @app.get("/api/runs")
-    def list_runs() -> list[dict[str, Any]]:
-        return db.list_runs()
+    def list_runs(limit: int = Query(200), before: float | None = Query(None)) -> list[dict[str, Any]]:
+        """Newest first; ``before`` (started_at of the last row shown) pages further back."""
+        return db.list_runs(limit=min(max(limit, 1), 1000), before=before)
 
     @app.get("/api/runs/{run_id}")
     def get_run(run_id: str) -> dict[str, Any]:
@@ -1183,17 +1316,41 @@ def create_app(data_dir: Path) -> FastAPI:
 
     # --------------------------------------------------------- import/export
     def _export_payload() -> dict[str, Any]:
+        """Everything in the project: collection, environments, variables, mocks and monitors.
+        Request ids are kept so monitors and "depends on" links can be remapped on import."""
         reqs = []
         for r in db.list_requests():
-            reqs.append({k: v for k, v in r.items() if k not in ("id", "created_at", "updated_at")})
+            reqs.append({k: v for k, v in r.items() if k not in ("created_at", "updated_at")})
         envs = [{"name": e["name"], "variables": e["variables"]} for e in db.list_environments()]
-        return {"pyhttp_version": __version__, "folders": db.list_folders(), "environments": envs,
-                "requests": reqs, "variables": db.get_variables()}
+        mocks = []
+        for m in db.list_mocks():
+            routes = [{k: v for k, v in rt.items() if k not in ("id", "server_id", "hits", "position")} for rt in m.get("routes") or []]
+            mocks.append({**{k: v for k, v in m.items() if k not in ("id", "created_at", "hits", "routes")}, "routes": routes})
+        mons = [{k: v for k, v in m.items() if k not in ("id", "created_at", "last_run_at", "last_status")} for m in db.list_monitors()]
+        return {"pyhttp_version": __version__, "project": current_project()["name"], "folders": db.list_folders(),
+                "environments": envs, "requests": reqs, "variables": db.get_variables(), "mocks": mocks, "monitors": mons}
 
     @app.get("/api/export")
     def export_all() -> dict[str, Any]:
         return _export_payload()
 
+    @app.get("/api/export/docs")
+    def export_docs(folder_id: str = Query(""), name: str = Query("")) -> dict[str, Any]:
+        """The collection (or one folder) as Markdown documentation."""
+        folders = db.list_folders()
+        requests = db.list_requests()
+        title = name or current_project()["name"] or "API"
+        if folder_id:
+            keep = db.folder_descendants(folder_id)
+            root = db.get_folder(folder_id)
+            title = name or (root["name"] if root else title)
+            folders = [{**f, "parent_id": None} if f.get("parent_id") == folder_id else f
+                       for f in folders if f["id"] in keep and f["id"] != folder_id]
+            requests = [{**r, "folder_id": None} if r.get("folder_id") == folder_id else r
+                        for r in requests if r.get("folder_id") in keep]
+        md = docs.to_markdown(title, folders, requests, db.get_variables(), db.list_environments())
+        return {"filename": re.sub(r"[^\w.-]+", "_", title).strip("_") + ".md", "markdown": md}
+
     @app.get("/api/export/postman")
     def export_postman(folder_id: str = Query(""), name: str = Query("")) -> dict[str, Any]:
         """A Postman v2.1 collection (optionally just one folder) plus environments."""
@@ -1215,7 +1372,8 @@ def create_app(data_dir: Path) -> FastAPI:
     @app.post("/api/import")
     def import_all(body: ImportIn) -> dict[str, Any]:
         return import_collection([f.model_dump() for f in body.folders], [r.model_dump() for r in body.requests],
-                          [e.model_dump() for e in body.environments], body.variables, body.replace)
+                                 [e.model_dump() for e in body.environments], body.variables, body.replace,
+                                 mocks=body.mocks, monitors=body.monitors)
 
     @app.post("/api/import/detect")
     def import_detect(body: dict[str, Any]) -> dict[str, Any]:
@@ -1238,7 +1396,8 @@ def create_app(data_dir: Path) -> FastAPI:
                     "folders": len(conv["folders"]), "entries": len(data["log"]["entries"])}
         if isinstance(data, dict) and ("requests" in data or "folders" in data):
             return {"kind": "pyhttp", "requests": len(data.get("requests") or []), "folders": len(data.get("folders") or []),
-                    "environments": len(data.get("environments") or [])}
+                    "environments": len(data.get("environments") or []), "mocks": len(data.get("mocks") or []),
+                    "monitors": len(data.get("monitors") or []), "project": data.get("project") or ""}
         if isinstance(data, list):
             return {"kind": "pyhttp", "requests": len(data), "folders": 0, "environments": 0}
         return {"kind": "unknown"}
@@ -1318,13 +1477,20 @@ def create_app(data_dir: Path) -> FastAPI:
             response.headers["Cache-Control"] = "no-store"
         return response
 
+    index_cache: dict[str, Any] = {}
+
     @app.get("/", include_in_schema=False)
     def index() -> HTMLResponse:
-        # script/style URLs get ?v=<version> so every release loads fresh files
-        html = (STATIC_DIR / "index.html").read_text(encoding="utf-8")
-        html = re.sub(r'((?:src|href)="/static/[^"?]+)"', rf'\1?v={__version__}"', html)
-        html = html.replace("<html lang=\"en\">", f"<html lang=\"en\" data-version=\"{__version__}\">", 1)
-        return HTMLResponse(html)
+        # script/style URLs get ?v=<version> so every release loads fresh files; the rewritten page is
+        # cached per file mtime (every reload hits this route, and the regex pass is not free)
+        src = STATIC_DIR / "index.html"
+        mtime = src.stat().st_mtime
+        if index_cache.get("mtime") != mtime:
+            html = src.read_text(encoding="utf-8")
+            html = re.sub(r'((?:src|href)="/static/[^"?]+)"', rf'\1?v={__version__}"', html)
+            html = html.replace("<html lang=\"en\">", f"<html lang=\"en\" data-version=\"{__version__}\">", 1)
+            index_cache.update({"mtime": mtime, "html": html})
+        return HTMLResponse(index_cache["html"])
 
     @app.exception_handler(ValueError)
     def value_error(_request: Any, exc: ValueError) -> JSONResponse: