htmlship 0.1.2__tar.gz → 0.1.4__tar.gz

{htmlship-0.1.2 → htmlship-0.1.4}/.gitignore

@@ -221,3 +221,4 @@ __marimo__/
 tmp/
 .htmlship/
 .DS_Store
+npm/*.tgz

{htmlship-0.1.2 → htmlship-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlship
-Version: 0.1.2
+Version: 0.1.4
 Summary: Host and share HTML pages from LLMs and coding agents in one line.
 Project-URL: Homepage, https://htmlship.com
 Project-URL: Repository, https://github.com/htmlship/htmlship
@@ -50,12 +50,13 @@ HTMLShip has four surfaces:
 
 - a public Python library and CLI (`htmlship` on PyPI)
 - a Node.js CLI and MCP server (`htmlship` on npm — no install required, runs via `npx`)
-- a FastAPI service for creating, updating, deleting, and viewing HTML pastes
+- a FastAPI service for creating, updating, deleting, and viewing HTML pages
 - a stdio MCP server (the `mcp` subcommand of both CLIs) for agent clients
 
 ```bash
 # Node — runs immediately, no install
 npx htmlship publish report.html
+npx htmlship publish report.html --password "demo-pass"
 
 # Python
 pip install htmlship
@@ -64,15 +65,20 @@ pip install htmlship
 ```python
 import htmlship
 
-paste = htmlship.publish("<h1>Hello</h1>", title="Demo", expires_in=60)  # minutes
-print(paste.url)
-print(paste.owner_key)  # save this to update or delete the paste later
+page = htmlship.publish(
+    "<h1>Hello</h1>",
+    title="Demo",
+    password="demo-pass",
+    expires_in=60,  # minutes
+)
+print(page.url)
+print(page.owner_key)  # save this to update or delete the page later
 ```
 
 ```bash
-curl -X POST https://api.htmlship.com/api/v1/pastes \
+curl -X POST https://api.htmlship.com/api/v1/pages \
   -H "Content-Type: application/json" \
-  -d '{"html":"<h1>Hello</h1>","title":"Demo"}'
+  -d '{"html":"<h1>Hello</h1>","title":"Demo","password":"demo-pass"}'
 ```
 
 See [`htmlship-implementation-spec.md`](./htmlship-implementation-spec.md) for the product spec and [`DEPLOY.md`](./DEPLOY.md) for the production runbook.
@@ -84,27 +90,28 @@ The module-level helpers use `https://api.htmlship.com` by default. Override wit
 ```python
 import htmlship
 
-paste = htmlship.publish(
+page = htmlship.publish(
     "<h1>Hello</h1>",
     title="Demo",
     password="optional-password",
     expires_in=1440,  # minutes (24 hours)
 )
 
-fresh = htmlship.get(paste.slug)
-updated = htmlship.update(paste.slug, "<h1>Updated</h1>", owner_key=paste.owner_key)
-htmlship.delete(updated.slug, owner_key=paste.owner_key)
+fresh = htmlship.get(page.slug)
+updated = htmlship.update(page.slug, "<h1>Updated</h1>", owner_key=page.owner_key)
+htmlship.delete(updated.slug, owner_key=page.owner_key)
 ```
 
-`owner_key` is returned only when a paste is created. It is required for updates and deletes, and the API does not return it again from metadata calls.
+`owner_key` is returned only when a page is created. It is the publisher-only secret required for updates and deletes, and the API does not return it again from metadata calls. `password` is only a view-time gate for readers; it does not authorize mutations.
 
 ## CLI
 
-The CLI is shipped both as a Python package (`pip install htmlship`) and an npm package (`npx htmlship` or `npm i -g htmlship`). The two share the same on-disk owner-key store, so a paste created in one is editable from the other.
+The CLI is shipped both as a Python package (`pip install htmlship`) and an npm package (`npx htmlship` or `npm i -g htmlship`). The two share the same on-disk owner-key store, so a page created in one is editable from the other.
 
 ```bash
 htmlship publish report.html
 cat report.html | htmlship publish -
+htmlship publish report.html --password "demo-pass"
 htmlship publish --file report.html --title "Q4 Report" --expires-in 60
 
 htmlship get <slug>
@@ -117,10 +124,11 @@ Equivalent npx form (no install):
 
 ```bash
 npx htmlship publish report.html
+npx htmlship publish report.html --password "demo-pass"
 npx htmlship list-mine
 ```
 
-The CLI stores owner keys in `~/.htmlship/keys.json` so `update`, `delete`, and `list-mine` can work with pastes you created locally. Set `HTMLSHIP_KEYS_DIR` to use another key-store directory, and set `HTMLSHIP_API_URL` to point the CLI at a local or staging API.
+The CLI stores owner keys in `~/.htmlship/keys.json` so `update`, `delete`, and `list-mine` can work with pages you created locally. Set `HTMLSHIP_KEYS_DIR` to use another key-store directory, and set `HTMLSHIP_API_URL` to point the CLI at a local or staging API.
 
 ## API
 
@@ -130,11 +138,11 @@ Base URL: `https://api.htmlship.com`.
 | --- | --- | --- |
 | `GET` | `/health` | Health check with service version. |
 | `GET` | `/version` | Service version. |
-| `POST` | `/api/v1/pastes` | Create a paste. |
-| `GET` | `/api/v1/pastes/{slug}` | Fetch paste metadata. |
-| `PATCH` | `/api/v1/pastes/{slug}` | Replace HTML or title. Requires `X-Owner-Key`. |
-| `DELETE` | `/api/v1/pastes/{slug}` | Soft-delete a paste. Requires `X-Owner-Key`. |
-| `POST` | `/api/v1/pastes/{slug}/version` | Create a new paste linked to an existing parent slug. |
+| `POST` | `/api/v1/pages` | Create a page. |
+| `GET` | `/api/v1/pages/{slug}` | Fetch page metadata. |
+| `PATCH` | `/api/v1/pages/{slug}` | Replace HTML or title. Requires `X-Owner-Key`. |
+| `DELETE` | `/api/v1/pages/{slug}` | Soft-delete a page. Requires `X-Owner-Key`. |
+| `POST` | `/api/v1/pages/{slug}/version` | Create a new page linked to an existing parent slug. |
 
 Create payload:
 
@@ -185,7 +193,7 @@ curl "http://localhost:8000/<slug>?_host=view.htmlship.com"
 
 HTMLShip ships a stdio MCP server with three tools:
 
-- `publish_html`
+- `publish_html` (accepts optional `password`)
 - `fetch_html`
 - `update_html`
 
@@ -278,7 +286,7 @@ The server reads `.env` via Pydantic settings.
 | `DATABASE_URL` | `postgresql+asyncpg://htmlship:htmlship@localhost:5433/htmlship` | Async SQLAlchemy database URL. |
 | `PUBLIC_BASE_DOMAIN` | `htmlship.com` | Base domain used to derive host routing. |
 | `API_BASE_URL` | `https://api.htmlship.com` | Public API URL setting. |
-| `VIEW_BASE_URL` | `https://view.htmlship.com` | Public view URL used in paste responses. |
+| `VIEW_BASE_URL` | `https://view.htmlship.com` | Public view URL used in page responses. |
 | `LANDING_BASE_URL` | `https://htmlship.com` | Public landing URL. |
 | `SPACES_BUCKET` | empty | If empty, use local blob storage; otherwise use DigitalOcean Spaces/S3. |
 | `SPACES_REGION` | `nyc3` | Spaces/S3 region. |
@@ -288,13 +296,13 @@ The server reads `.env` via Pydantic settings.
 | `ENVIRONMENT` | `development` | Enables API docs outside production and secure cookies in production. |
 | `LOG_LEVEL` | `info` | Application log level. |
 | `MAX_PAYLOAD_BYTES` | `10485760` | Server-side HTML size limit. |
-| `DEFAULT_EXPIRES_IN_MINUTES` | empty | Optional default TTL (minutes) for new pastes. |
+| `DEFAULT_EXPIRES_IN_MINUTES` | empty | Optional default TTL (minutes) for new pages. |
 
 ## Architecture
 
 One FastAPI process hosts the landing page, JSON API, and view renderer. `HostRoutingMiddleware` classifies requests by host and prevents API routes from being served on the view host.
 
-Postgres stores paste metadata, owner-key/password hashes, expiry, view counts, and parent-version links. HTML bodies are stored as blobs, either in `LocalBlobStore` for development/tests or DigitalOcean Spaces in production.
+Postgres stores page metadata, owner-key/password hashes, expiry, view counts, and parent-version links. HTML bodies are stored as blobs, either in `LocalBlobStore` for development/tests or DigitalOcean Spaces in production.
 
 ## Project Layout
 

{htmlship-0.1.2 → htmlship-0.1.4}/README.md

@@ -6,12 +6,13 @@ HTMLShip has four surfaces:
 
 - a public Python library and CLI (`htmlship` on PyPI)
 - a Node.js CLI and MCP server (`htmlship` on npm — no install required, runs via `npx`)
-- a FastAPI service for creating, updating, deleting, and viewing HTML pastes
+- a FastAPI service for creating, updating, deleting, and viewing HTML pages
 - a stdio MCP server (the `mcp` subcommand of both CLIs) for agent clients
 
 ```bash
 # Node — runs immediately, no install
 npx htmlship publish report.html
+npx htmlship publish report.html --password "demo-pass"
 
 # Python
 pip install htmlship
@@ -20,15 +21,20 @@ pip install htmlship
 ```python
 import htmlship
 
-paste = htmlship.publish("<h1>Hello</h1>", title="Demo", expires_in=60)  # minutes
-print(paste.url)
-print(paste.owner_key)  # save this to update or delete the paste later
+page = htmlship.publish(
+    "<h1>Hello</h1>",
+    title="Demo",
+    password="demo-pass",
+    expires_in=60,  # minutes
+)
+print(page.url)
+print(page.owner_key)  # save this to update or delete the page later
 ```
 
 ```bash
-curl -X POST https://api.htmlship.com/api/v1/pastes \
+curl -X POST https://api.htmlship.com/api/v1/pages \
   -H "Content-Type: application/json" \
-  -d '{"html":"<h1>Hello</h1>","title":"Demo"}'
+  -d '{"html":"<h1>Hello</h1>","title":"Demo","password":"demo-pass"}'
 ```
 
 See [`htmlship-implementation-spec.md`](./htmlship-implementation-spec.md) for the product spec and [`DEPLOY.md`](./DEPLOY.md) for the production runbook.
@@ -40,27 +46,28 @@ The module-level helpers use `https://api.htmlship.com` by default. Override wit
 ```python
 import htmlship
 
-paste = htmlship.publish(
+page = htmlship.publish(
     "<h1>Hello</h1>",
     title="Demo",
     password="optional-password",
     expires_in=1440,  # minutes (24 hours)
 )
 
-fresh = htmlship.get(paste.slug)
-updated = htmlship.update(paste.slug, "<h1>Updated</h1>", owner_key=paste.owner_key)
-htmlship.delete(updated.slug, owner_key=paste.owner_key)
+fresh = htmlship.get(page.slug)
+updated = htmlship.update(page.slug, "<h1>Updated</h1>", owner_key=page.owner_key)
+htmlship.delete(updated.slug, owner_key=page.owner_key)
 ```
 
-`owner_key` is returned only when a paste is created. It is required for updates and deletes, and the API does not return it again from metadata calls.
+`owner_key` is returned only when a page is created. It is the publisher-only secret required for updates and deletes, and the API does not return it again from metadata calls. `password` is only a view-time gate for readers; it does not authorize mutations.
 
 ## CLI
 
-The CLI is shipped both as a Python package (`pip install htmlship`) and an npm package (`npx htmlship` or `npm i -g htmlship`). The two share the same on-disk owner-key store, so a paste created in one is editable from the other.
+The CLI is shipped both as a Python package (`pip install htmlship`) and an npm package (`npx htmlship` or `npm i -g htmlship`). The two share the same on-disk owner-key store, so a page created in one is editable from the other.
 
 ```bash
 htmlship publish report.html
 cat report.html | htmlship publish -
+htmlship publish report.html --password "demo-pass"
 htmlship publish --file report.html --title "Q4 Report" --expires-in 60
 
 htmlship get <slug>
@@ -73,10 +80,11 @@ Equivalent npx form (no install):
 
 ```bash
 npx htmlship publish report.html
+npx htmlship publish report.html --password "demo-pass"
 npx htmlship list-mine
 ```
 
-The CLI stores owner keys in `~/.htmlship/keys.json` so `update`, `delete`, and `list-mine` can work with pastes you created locally. Set `HTMLSHIP_KEYS_DIR` to use another key-store directory, and set `HTMLSHIP_API_URL` to point the CLI at a local or staging API.
+The CLI stores owner keys in `~/.htmlship/keys.json` so `update`, `delete`, and `list-mine` can work with pages you created locally. Set `HTMLSHIP_KEYS_DIR` to use another key-store directory, and set `HTMLSHIP_API_URL` to point the CLI at a local or staging API.
 
 ## API
 
@@ -86,11 +94,11 @@ Base URL: `https://api.htmlship.com`.
 | --- | --- | --- |
 | `GET` | `/health` | Health check with service version. |
 | `GET` | `/version` | Service version. |
-| `POST` | `/api/v1/pastes` | Create a paste. |
-| `GET` | `/api/v1/pastes/{slug}` | Fetch paste metadata. |
-| `PATCH` | `/api/v1/pastes/{slug}` | Replace HTML or title. Requires `X-Owner-Key`. |
-| `DELETE` | `/api/v1/pastes/{slug}` | Soft-delete a paste. Requires `X-Owner-Key`. |
-| `POST` | `/api/v1/pastes/{slug}/version` | Create a new paste linked to an existing parent slug. |
+| `POST` | `/api/v1/pages` | Create a page. |
+| `GET` | `/api/v1/pages/{slug}` | Fetch page metadata. |
+| `PATCH` | `/api/v1/pages/{slug}` | Replace HTML or title. Requires `X-Owner-Key`. |
+| `DELETE` | `/api/v1/pages/{slug}` | Soft-delete a page. Requires `X-Owner-Key`. |
+| `POST` | `/api/v1/pages/{slug}/version` | Create a new page linked to an existing parent slug. |
 
 Create payload:
 
@@ -141,7 +149,7 @@ curl "http://localhost:8000/<slug>?_host=view.htmlship.com"
 
 HTMLShip ships a stdio MCP server with three tools:
 
-- `publish_html`
+- `publish_html` (accepts optional `password`)
 - `fetch_html`
 - `update_html`
 
@@ -234,7 +242,7 @@ The server reads `.env` via Pydantic settings.
 | `DATABASE_URL` | `postgresql+asyncpg://htmlship:htmlship@localhost:5433/htmlship` | Async SQLAlchemy database URL. |
 | `PUBLIC_BASE_DOMAIN` | `htmlship.com` | Base domain used to derive host routing. |
 | `API_BASE_URL` | `https://api.htmlship.com` | Public API URL setting. |
-| `VIEW_BASE_URL` | `https://view.htmlship.com` | Public view URL used in paste responses. |
+| `VIEW_BASE_URL` | `https://view.htmlship.com` | Public view URL used in page responses. |
 | `LANDING_BASE_URL` | `https://htmlship.com` | Public landing URL. |
 | `SPACES_BUCKET` | empty | If empty, use local blob storage; otherwise use DigitalOcean Spaces/S3. |
 | `SPACES_REGION` | `nyc3` | Spaces/S3 region. |
@@ -244,13 +252,13 @@ The server reads `.env` via Pydantic settings.
 | `ENVIRONMENT` | `development` | Enables API docs outside production and secure cookies in production. |
 | `LOG_LEVEL` | `info` | Application log level. |
 | `MAX_PAYLOAD_BYTES` | `10485760` | Server-side HTML size limit. |
-| `DEFAULT_EXPIRES_IN_MINUTES` | empty | Optional default TTL (minutes) for new pastes. |
+| `DEFAULT_EXPIRES_IN_MINUTES` | empty | Optional default TTL (minutes) for new pages. |
 
 ## Architecture
 
 One FastAPI process hosts the landing page, JSON API, and view renderer. `HostRoutingMiddleware` classifies requests by host and prevents API routes from being served on the view host.
 
-Postgres stores paste metadata, owner-key/password hashes, expiry, view counts, and parent-version links. HTML bodies are stored as blobs, either in `LocalBlobStore` for development/tests or DigitalOcean Spaces in production.
+Postgres stores page metadata, owner-key/password hashes, expiry, view counts, and parent-version links. HTML bodies are stored as blobs, either in `LocalBlobStore` for development/tests or DigitalOcean Spaces in production.
 
 ## Project Layout
 

{htmlship-0.1.2 → htmlship-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "htmlship"
-version = "0.1.2"
+version = "0.1.4"
 description = "Host and share HTML pages from LLMs and coding agents in one line."
 readme = "README.md"
 requires-python = ">=3.12"

{htmlship-0.1.2 → htmlship-0.1.4}/src/htmlship/__init__.py

@@ -3,12 +3,12 @@
 Quick start:
 
     import htmlship
-    paste = htmlship.publish("<h1>Hello</h1>", expires_in=60)  # minutes
-    print(paste.url)
-    print(paste.owner_key)
+    page = htmlship.publish("<h1>Hello</h1>", expires_in=60)  # minutes
+    print(page.url)
+    print(page.owner_key)
 
-    paste.update("<h1>Hello, again</h1>")
-    paste.delete()
+    page.update("<h1>Hello, again</h1>")
+    page.delete()
 
 Configuration via environment:
     HTMLSHIP_API_URL   (default: https://api.htmlship.com)
@@ -25,7 +25,7 @@ from .exceptions import (
     NotFoundError,
     RateLimitError,
 )
-from .models import Paste
+from .models import Page
 
 _default_client: HTMLShipClient | None = None
 
@@ -61,7 +61,7 @@ def publish(
     expires_in: int | None = None,
     parent_slug: str | None = None,
     sandbox_mode: str = "strict",
-) -> Paste:
+) -> Page:
     """Publish HTML. ``expires_in`` is in minutes (max 10080 = 7 days)."""
     return _get_default_client().publish(
         html,
@@ -73,11 +73,11 @@ def publish(
     )
 
 
-def get(slug: str) -> Paste:
+def get(slug: str) -> Page:
     return _get_default_client().get(slug)
 
 
-def update(slug: str, html: str, *, owner_key: str, title: str | None = None) -> Paste:
+def update(slug: str, html: str, *, owner_key: str, title: str | None = None) -> Page:
     return _get_default_client().update(slug, html, owner_key=owner_key, title=title)
 
 
@@ -88,7 +88,7 @@ def delete(slug: str, *, owner_key: str) -> None:
 __all__ = [
     "__version__",
     "HTMLShipClient",
-    "Paste",
+    "Page",
     "HTMLShipError",
     "NotFoundError",
     "AuthError",

htmlship-0.1.4/src/htmlship/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.4"

{htmlship-0.1.2 → htmlship-0.1.4}/src/htmlship/cli.py

@@ -111,7 +111,7 @@ def main(ctx: click.Context, api_url: str | None) -> None:
 @click.argument("source", required=False)
 @click.option("--file", "-f", "file_", type=click.Path(exists=True, dir_okay=False), help="HTML file path.")
 @click.option("--title", default=None, help="Optional title.")
-@click.option("--password", default=None, help="Password-protect the paste.")
+@click.option("--password", default=None, help="Password-protect the page.")
 @click.option(
     "--expires-in",
     type=int,
@@ -142,7 +142,7 @@ def publish(
     html = _read_html(source, file_)
     client = _make_client(ctx.obj["api_url"])
     try:
-        paste = client.publish(
+        page = client.publish(
             html,
             title=title,
             password=password,
@@ -153,18 +153,18 @@ def publish(
     finally:
         client.close()
 
-    _remember(paste.slug, paste.owner_key or "", paste.url, title)
+    _remember(page.slug, page.owner_key or "", page.url, title)
 
     if quiet:
-        click.echo(paste.url)
+        click.echo(page.url)
         return
 
-    click.echo(paste.url)
-    click.echo(f"slug:      {paste.slug}", err=True)
-    click.echo(f"owner_key: {paste.owner_key}  (saved to {KEYS_FILE})", err=True)
-    if paste.expires_at:
-        click.echo(f"expires:   {paste.expires_at.isoformat()}", err=True)
-    if not no_clipboard and _try_clipboard(paste.url):
+    click.echo(page.url)
+    click.echo(f"slug:      {page.slug}", err=True)
+    click.echo(f"owner_key: {page.owner_key}  (saved to {KEYS_FILE})", err=True)
+    if page.expires_at:
+        click.echo(f"expires:   {page.expires_at.isoformat()}", err=True)
+    if not no_clipboard and _try_clipboard(page.url):
         click.echo("(URL copied to clipboard)", err=True)
 
 
@@ -172,12 +172,12 @@ def publish(
 @click.argument("slug")
 @click.pass_context
 def get(ctx: click.Context, slug: str) -> None:
-    """Show metadata for a paste."""
+    """Show metadata for a page."""
     client = _make_client(ctx.obj["api_url"])
     try:
-        paste = client.get(slug)
+        page = client.get(slug)
     except NotFoundError as exc:
-        raise click.ClickException(f"paste '{slug}' not found") from exc
+        raise click.ClickException(f"page '{slug}' not found") from exc
     except HTMLShipError as exc:
         raise click.ClickException(str(exc)) from exc
     finally:
@@ -185,16 +185,16 @@ def get(ctx: click.Context, slug: str) -> None:
 
     click.echo(json.dumps(
         {
-            "slug": paste.slug,
-            "url": paste.url,
-            "title": paste.title,
-            "view_count": paste.view_count,
-            "size_bytes": paste.size_bytes,
-            "has_password": paste.has_password,
-            "parent_slug": paste.parent_slug,
-            "expires_at": paste.expires_at.isoformat() if paste.expires_at else None,
-            "created_at": paste.created_at.isoformat() if paste.created_at else None,
-            "updated_at": paste.updated_at.isoformat() if paste.updated_at else None,
+            "slug": page.slug,
+            "url": page.url,
+            "title": page.title,
+            "view_count": page.view_count,
+            "size_bytes": page.size_bytes,
+            "has_password": page.has_password,
+            "parent_slug": page.parent_slug,
+            "expires_at": page.expires_at.isoformat() if page.expires_at else None,
+            "created_at": page.created_at.isoformat() if page.created_at else None,
+            "updated_at": page.updated_at.isoformat() if page.updated_at else None,
         },
         indent=2,
     ))
@@ -215,7 +215,7 @@ def update(
     title: str | None,
     owner_key: str | None,
 ) -> None:
-    """Replace HTML for an existing paste."""
+    """Replace HTML for an existing page."""
     html = _read_html(source, file_)
     key = owner_key or _lookup_owner_key(slug)
     if not key:
@@ -224,13 +224,13 @@ def update(
         )
     client = _make_client(ctx.obj["api_url"])
     try:
-        paste = client.update(slug, html, owner_key=key, title=title)
+        page = client.update(slug, html, owner_key=key, title=title)
     except HTMLShipError as exc:
         raise click.ClickException(str(exc)) from exc
     finally:
         client.close()
 
-    click.echo(paste.url)
+    click.echo(page.url)
 
 
 @main.command()
@@ -239,14 +239,14 @@ def update(
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation.")
 @click.pass_context
 def delete(ctx: click.Context, slug: str, owner_key: str | None, yes: bool) -> None:
-    """Soft-delete a paste."""
+    """Soft-delete a page."""
     key = owner_key or _lookup_owner_key(slug)
     if not key:
         raise click.ClickException(
             f"no owner key for '{slug}' in {KEYS_FILE}; pass --owner-key explicitly"
         )
     if not yes:
-        click.confirm(f"Delete paste '{slug}'?", abort=True)
+        click.confirm(f"Delete page '{slug}'?", abort=True)
     client = _make_client(ctx.obj["api_url"])
     try:
         client.delete(slug, owner_key=key)
@@ -262,10 +262,10 @@ def delete(ctx: click.Context, slug: str, owner_key: str | None, yes: bool) -> N
 @click.option("--limit", type=int, default=20, show_default=True)
 @click.pass_context
 def list_mine(ctx: click.Context, limit: int) -> None:
-    """List pastes whose owner keys are saved locally."""
+    """List pages whose owner keys are saved locally."""
     keys = _load_keys()
     if not keys:
-        click.echo(f"No saved pastes in {KEYS_FILE}.")
+        click.echo(f"No saved pages in {KEYS_FILE}.")
         return
     items = sorted(keys.items(), key=lambda kv: kv[1].get("saved_at", ""), reverse=True)[:limit]
 
@@ -274,13 +274,13 @@ def list_mine(ctx: click.Context, limit: int) -> None:
         rows = []
         for slug, info in items:
             try:
-                paste = client.get(slug)
-                size = f"{paste.size_bytes}B"
-                views = paste.view_count
-                title = paste.title or info.get("title") or ""
+                page = client.get(slug)
+                size = f"{page.size_bytes}B"
+                views = page.view_count
+                title = page.title or info.get("title") or ""
                 status = "ok"
             except NotFoundError:
-                paste = None
+                page = None
                 size = "—"
                 views = "—"
                 title = info.get("title") or ""

{htmlship-0.1.2 → htmlship-0.1.4}/src/htmlship/client.py

@@ -8,7 +8,7 @@ import httpx
 
 from ._version import __version__
 from .exceptions import APIError, AuthError, HTMLShipError, NotFoundError, RateLimitError
-from .models import Paste
+from .models import Page
 
 DEFAULT_API_URL = "https://api.htmlship.com"
 DEFAULT_TIMEOUT = 30.0
@@ -65,10 +65,10 @@ class HTMLShipClient:
         expires_in: int | None = None,
         parent_slug: str | None = None,
         sandbox_mode: str = "strict",
-    ) -> Paste:
-        """Create a paste. ``expires_in`` is in minutes (max 10080 = 7 days).
+    ) -> Page:
+        """Create a page. ``expires_in`` is in minutes (max 10080 = 7 days).
 
-        Returns a Paste with owner_key set.
+        Returns a Page with owner_key set.
         """
         body: dict[str, Any] = {"html": html, "sandbox_mode": sandbox_mode}
         if title is not None:
@@ -79,9 +79,9 @@ class HTMLShipClient:
             body["expires_in"] = expires_in
         if parent_slug is not None:
             body["parent_slug"] = parent_slug
-        r = self._http.post("/api/v1/pastes", json=body)
+        r = self._http.post("/api/v1/pages", json=body)
         data = self._handle(r)
-        return Paste(
+        return Page(
             slug=data["slug"],
             url=data["url"],
             owner_key=data["owner_key"],
@@ -90,11 +90,11 @@ class HTMLShipClient:
             _client=self,
         )
 
-    def get(self, slug: str) -> Paste:
-        """Fetch metadata for a paste. owner_key is None on the returned object."""
-        r = self._http.get(f"/api/v1/pastes/{slug}")
+    def get(self, slug: str) -> Page:
+        """Fetch metadata for a page. owner_key is None on the returned object."""
+        r = self._http.get(f"/api/v1/pages/{slug}")
         data = self._handle(r)
-        return Paste(
+        return Page(
             slug=data["slug"],
             url=data["url"],
             owner_key=None,
@@ -116,17 +116,17 @@ class HTMLShipClient:
         *,
         owner_key: str,
         title: str | None = None,
-    ) -> Paste:
+    ) -> Page:
         body: dict[str, Any] = {"html": html}
         if title is not None:
             body["title"] = title
         r = self._http.patch(
-            f"/api/v1/pastes/{slug}",
+            f"/api/v1/pages/{slug}",
             json=body,
             headers={"X-Owner-Key": owner_key},
         )
         data = self._handle(r)
-        return Paste(
+        return Page(
             slug=data["slug"],
             url=data["url"],
             owner_key=owner_key,
@@ -137,7 +137,7 @@ class HTMLShipClient:
 
     def delete(self, slug: str, *, owner_key: str) -> None:
         r = self._http.delete(
-            f"/api/v1/pastes/{slug}",
+            f"/api/v1/pages/{slug}",
             headers={"X-Owner-Key": owner_key},
         )
         self._handle(r, expect_no_body=True)
@@ -150,7 +150,7 @@ class HTMLShipClient:
         title: str | None = None,
         password: str | None = None,
         expires_in: int | None = None,
-    ) -> Paste:
+    ) -> Page:
         body: dict[str, Any] = {"html": html, "sandbox_mode": "strict"}
         if title is not None:
             body["title"] = title
@@ -158,9 +158,9 @@ class HTMLShipClient:
             body["password"] = password
         if expires_in is not None:
             body["expires_in"] = expires_in
-        r = self._http.post(f"/api/v1/pastes/{parent_slug}/version", json=body)
+        r = self._http.post(f"/api/v1/pages/{parent_slug}/version", json=body)
         data = self._handle(r)
-        return Paste(
+        return Page(
             slug=data["slug"],
             url=data["url"],
             owner_key=data["owner_key"],

{htmlship-0.1.2 → htmlship-0.1.4}/src/htmlship/exceptions.py

@@ -6,7 +6,7 @@ class HTMLShipError(Exception):
 
 
 class NotFoundError(HTMLShipError):
-    """Returned when a paste does not exist or has expired."""
+    """Returned when a page does not exist or has expired."""
 
 
 class AuthError(HTMLShipError):