blog-cli 0.1.0__tar.gz → 0.2.1__tar.gz

{blog_cli-0.1.0 → blog_cli-0.2.1}/PKG-INFO

@@ -1,17 +1,17 @@
 Metadata-Version: 2.4
 Name: blog-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: Agent-friendly CLI for managing a blog. Create drafts, upload media, generate time-limited preview links.
 Author: tanaka-mambinge
 License: MIT
-Project-URL: Repository, https://github.com/tanaka-mambinge/personal
-Project-URL: Issues, https://github.com/tanaka-mambinge/personal/issues
+Project-URL: Repository, https://github.com/tanaka-mambinge/personal-cli
+Project-URL: Issues, https://github.com/tanaka-mambinge/personal-cli/issues
 Keywords: blog,cli,agent,markdown,writing
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Internet :: WWW/HTTP
-Requires-Python: >=3.14
+Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.28
 Requires-Dist: typer>=0.16
@@ -35,32 +35,35 @@ Designed for use by both humans and AI agents.
 
 ## Install
 
+```bash
+pip install blog-cli
+```
+
+Or via pipx/uv:
+
 ```bash
 pipx install blog-cli
-# or
 uv tool install blog-cli
 ```
 
 For development:
 
 ```bash
-git clone https://github.com/tanaka-mambinge/personal
-cd personal/blog-cli
+git clone https://github.com/tanaka-mambinge/personal-cli
+cd personal-cli
 uv sync --extra dev
 ```
 
 ## Configure
 
-Set these env vars (e.g. in `~/.zshrc`):
+All three are required:
 
 ```bash
-export PERSONAL_SERVER_URL="https://api.personal.localhost:1355"
-export PERSONAL_API_KEY="your-api-key"
-export PERSONAL_SITE_URL="https://personal.localhost:1355"
+export PERSONAL_SERVER_URL="<your-server-url>"
+export PERSONAL_API_KEY="<your-api-key>"
+export PERSONAL_SITE_URL="<your-site-url>"
 ```
 
-Empty `PERSONAL_API_KEY` disables auth if your server has no key configured.
-
 ## Usage
 
 ### Articles

{blog_cli-0.1.0 → blog_cli-0.2.1}/README.md

@@ -6,32 +6,35 @@ Designed for use by both humans and AI agents.
 
 ## Install
 
+```bash
+pip install blog-cli
+```
+
+Or via pipx/uv:
+
 ```bash
 pipx install blog-cli
-# or
 uv tool install blog-cli
 ```
 
 For development:
 
 ```bash
-git clone https://github.com/tanaka-mambinge/personal
-cd personal/blog-cli
+git clone https://github.com/tanaka-mambinge/personal-cli
+cd personal-cli
 uv sync --extra dev
 ```
 
 ## Configure
 
-Set these env vars (e.g. in `~/.zshrc`):
+All three are required:
 
 ```bash
-export PERSONAL_SERVER_URL="https://api.personal.localhost:1355"
-export PERSONAL_API_KEY="your-api-key"
-export PERSONAL_SITE_URL="https://personal.localhost:1355"
+export PERSONAL_SERVER_URL="<your-server-url>"
+export PERSONAL_API_KEY="<your-api-key>"
+export PERSONAL_SITE_URL="<your-site-url>"
 ```
 
-Empty `PERSONAL_API_KEY` disables auth if your server has no key configured.
-
 ## Usage
 
 ### Articles

{blog_cli-0.1.0 → blog_cli-0.2.1}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "blog-cli"
-version = "0.1.0"
+version = "0.2.1"
 description = "Agent-friendly CLI for managing a blog. Create drafts, upload media, generate time-limited preview links."
 readme = "README.md"
-requires-python = ">=3.14"
+requires-python = ">=3.13"
 license = {text = "MIT"}
 authors = [{name = "tanaka-mambinge"}]
 keywords = ["blog", "cli", "agent", "markdown", "writing"]
@@ -23,8 +23,8 @@ dependencies = [
 ]
 
 [project.urls]
-Repository = "https://github.com/tanaka-mambinge/personal"
-Issues = "https://github.com/tanaka-mambinge/personal/issues"
+Repository = "https://github.com/tanaka-mambinge/personal-cli"
+Issues = "https://github.com/tanaka-mambinge/personal-cli/issues"
 
 [project.scripts]
 blog-cli = "personal_cli.cli:main"

{blog_cli-0.1.0 → blog_cli-0.2.1}/src/blog_cli.egg-info/PKG-INFO

@@ -1,17 +1,17 @@
 Metadata-Version: 2.4
 Name: blog-cli
-Version: 0.1.0
+Version: 0.2.1
 Summary: Agent-friendly CLI for managing a blog. Create drafts, upload media, generate time-limited preview links.
 Author: tanaka-mambinge
 License: MIT
-Project-URL: Repository, https://github.com/tanaka-mambinge/personal
-Project-URL: Issues, https://github.com/tanaka-mambinge/personal/issues
+Project-URL: Repository, https://github.com/tanaka-mambinge/personal-cli
+Project-URL: Issues, https://github.com/tanaka-mambinge/personal-cli/issues
 Keywords: blog,cli,agent,markdown,writing
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Internet :: WWW/HTTP
-Requires-Python: >=3.14
+Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.28
 Requires-Dist: typer>=0.16
@@ -35,32 +35,35 @@ Designed for use by both humans and AI agents.
 
 ## Install
 
+```bash
+pip install blog-cli
+```
+
+Or via pipx/uv:
+
 ```bash
 pipx install blog-cli
-# or
 uv tool install blog-cli
 ```
 
 For development:
 
 ```bash
-git clone https://github.com/tanaka-mambinge/personal
-cd personal/blog-cli
+git clone https://github.com/tanaka-mambinge/personal-cli
+cd personal-cli
 uv sync --extra dev
 ```
 
 ## Configure
 
-Set these env vars (e.g. in `~/.zshrc`):
+All three are required:
 
 ```bash
-export PERSONAL_SERVER_URL="https://api.personal.localhost:1355"
-export PERSONAL_API_KEY="your-api-key"
-export PERSONAL_SITE_URL="https://personal.localhost:1355"
+export PERSONAL_SERVER_URL="<your-server-url>"
+export PERSONAL_API_KEY="<your-api-key>"
+export PERSONAL_SITE_URL="<your-site-url>"
 ```
 
-Empty `PERSONAL_API_KEY` disables auth if your server has no key configured.
-
 ## Usage
 
 ### Articles

{blog_cli-0.1.0 → blog_cli-0.2.1}/src/personal_cli/cli.py

@@ -16,9 +16,9 @@ app.add_typer(article_app, name="article")
 app.add_typer(media_app, name="media")
 
 
-def build_client(server_url: str | None = None) -> ArticleApiClient:
-    url, api_key = get_default_config()
-    return ArticleApiClient(server_url or url, api_key=api_key)
+def build_client(server_url: str | None = None, insecure: bool = False) -> ArticleApiClient:
+    url, api_key, _ = get_default_config()
+    return ArticleApiClient(server_url or url, api_key=api_key, verify=not insecure)
 
 
 def run(coro):
@@ -30,10 +30,11 @@ def article_list(
     type_filter: str = typer.Option("all", "--type", help="all, blog, or project."),
     status: str | None = typer.Option(None, "--status", help="Filter by article status."),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         articles = run(client.list_articles(status=status, type_filter=type_filter))
         emit_result(articles, json_output=json_output)
     except CLIError as exc:
@@ -45,10 +46,11 @@ def article_list(
 def article_show(
     slug: str,
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         article = run(client.get_article(slug))
         emit_result(article, json_output=json_output)
     except CLIError as exc:
@@ -67,11 +69,12 @@ def article_create(
     markdown: str | None = typer.Option(None, "--markdown", help="Inline markdown body."),
     markdown_file: Path | None = typer.Option(None, "--markdown-file", exists=True, readable=True, dir_okay=False),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
         body = read_markdown_from_source(markdown=markdown, markdown_file=markdown_file)
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         payload = {
             "title": title,
             "description": description,
@@ -99,10 +102,11 @@ def article_update(
     markdown: str | None = typer.Option(None, "--markdown", help="Inline markdown body."),
     markdown_file: Path | None = typer.Option(None, "--markdown-file", exists=True, readable=True, dir_okay=False),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         payload: dict[str, object] = {}
         if title is not None:
             payload["title"] = title
@@ -128,10 +132,11 @@ def article_publish(
     slug: str,
     published_by: str | None = typer.Option(None, "--published-by", help="Who published the article."),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         article = run(client.publish_article(slug, {"published_by": published_by} if published_by else None))
         emit_result(article, json_output=json_output)
     except CLIError as exc:
@@ -143,10 +148,11 @@ def article_publish(
 def article_delete(
     slug: str,
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         result = run(client.delete_article(slug))
         emit_result(result, json_output=json_output)
     except CLIError as exc:
@@ -158,10 +164,11 @@ def article_delete(
 def article_unarchive(
     slug: str,
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         article = run(client.unarchive_article(slug))
         emit_result(article, json_output=json_output)
     except CLIError as exc:
@@ -175,12 +182,13 @@ def article_preview(
     ttl_hours: int = typer.Option(24, "--ttl-hours", help="Hours until the preview link expires."),
     site_url: str | None = typer.Option(None, "--site-url", help="Base URL of the personal site."),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        import os
-        resolved_site_url = site_url or os.environ.get("PERSONAL_SITE_URL", "http://localhost:3000")
-        client = build_client(server_url)
+        _, _, default_site_url = get_default_config()
+        resolved_site_url = site_url or default_site_url
+        client = build_client(server_url, insecure=insecure)
         result = run(client.generate_preview(slug, ttl_hours=ttl_hours, base_url=resolved_site_url))
         emit_result(result, json_output=json_output)
     except CLIError as exc:
@@ -188,15 +196,69 @@ def article_preview(
         raise typer.Exit(code=1) from exc
 
 
+@article_app.command("tag-list")
+@article_app.command("tags")
+def tag_list(
+    slug: str,
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    try:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.list_tags(slug))
+        emit_result(result, json_output=json_output)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@article_app.command("tag-add")
+def tag_add(
+    slug: str,
+    tag: list[str] = typer.Option(..., "--tag", help="Tag to attach. Repeat for multiple."),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    try:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.attach_tags(slug, tag))
+        emit_result(result, json_output=json_output)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@article_app.command("tag-remove")
+def tag_remove(
+    slug: str,
+    tag: list[str] = typer.Option(..., "--tag", help="Tag to remove. Repeat for multiple."),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    try:
+        client = build_client(server_url, insecure=insecure)
+        for t in tag:
+            run(client.remove_tag(slug, t))
+        result = run(client.list_tags(slug))
+        emit_result(result, json_output=json_output)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
 @media_app.command("upload")
 def media_upload(
     name: str = typer.Option(..., "--name", help="Unique name for the media (e.g. hero-image)."),
     path: Path = typer.Argument(..., exists=True, file_okay=True, dir_okay=False, readable=True),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         result = run(client.upload_media(name, path))
         emit_result(result, json_output=json_output)
     except CLIError as exc:
@@ -209,10 +271,11 @@ def media_update(
     name: str = typer.Option(..., "--name", help="Name of the media to replace."),
     path: Path = typer.Argument(..., exists=True, file_okay=True, dir_okay=False, readable=True),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         result = run(client.update_media(name, path))
         emit_result(result, json_output=json_output)
     except CLIError as exc:
@@ -224,10 +287,11 @@ def media_update(
 def media_delete(
     name: str = typer.Option(..., "--name", help="Name of the media to delete."),
     json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
     server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
 ) -> None:
     try:
-        client = build_client(server_url)
+        client = build_client(server_url, insecure=insecure)
         result = run(client.delete_media(name))
         emit_result(result, json_output=json_output)
     except CLIError as exc:

{blog_cli-0.1.0 → blog_cli-0.2.1}/src/personal_cli/client.py

@@ -20,11 +20,13 @@ class ArticleApiClient:
         api_key: str | None = None,
         transport: httpx.AsyncBaseTransport | None = None,
         timeout: float = 30.0,
+        verify: bool = True,
     ) -> None:
         self.base_url = base_url.rstrip("/")
         self.api_key = api_key
         self.transport = transport
         self.timeout = timeout
+        self.verify = verify
 
     def _headers(self) -> dict[str, str]:
         if not self.api_key:
@@ -45,6 +47,7 @@ class ArticleApiClient:
             transport=self.transport,
             timeout=self.timeout,
             headers=self._headers(),
+            verify=self.verify,
         ) as client:
             response = await client.request(method, path, json=json, params=params, files=files)
             if response.status_code >= 400:
@@ -108,7 +111,7 @@ class ArticleApiClient:
         result = await self._request_json("DELETE", f"/api/v1/media/{name}")
         return dict(result or {})
 
-    async def generate_preview(self, slug: str, *, ttl_hours: int = 24, base_url: str = "http://localhost:3000") -> dict[str, Any]:
+    async def generate_preview(self, slug: str, *, ttl_hours: int = 24, base_url: str) -> dict[str, Any]:
         result = await self._request_json(
             "POST",
             f"/api/v1/articles/{slug}/preview",
@@ -116,14 +119,30 @@ class ArticleApiClient:
         )
         return dict(result)
 
+    async def list_tags(self, slug: str) -> dict[str, Any]:
+        result = await self._request_json("GET", f"/api/v1/articles/{slug}/tags")
+        return dict(result)
+
+    async def attach_tags(self, slug: str, tags: list[str]) -> dict[str, Any]:
+        result = await self._request_json("POST", f"/api/v1/articles/{slug}/tags", json={"tags": tags})
+        return dict(result)
+
+    async def remove_tag(self, slug: str, tag: str) -> dict[str, Any]:
+        result = await self._request_json("DELETE", f"/api/v1/articles/{slug}/tags", params={"tag": tag})
+        return dict(result)
+
 
-def get_default_config() -> tuple[str, str | None]:
+def get_default_config() -> tuple[str, str | None, str]:
     import os
     _load_dotenv()
-    return (
-        os.environ.get("PERSONAL_SERVER_URL", "http://127.0.0.1:8000"),
-        os.environ.get("PERSONAL_API_KEY"),
-    )
+    server_url = os.environ.get("PERSONAL_SERVER_URL")
+    if not server_url:
+        raise CLIError("PERSONAL_SERVER_URL is not set.")
+    api_key = os.environ.get("PERSONAL_API_KEY")
+    if not api_key:
+        raise CLIError("PERSONAL_API_KEY is not set.")
+    site_url = os.environ.get("PERSONAL_SITE_URL", "")
+    return (server_url, api_key, site_url)
 
 
 def _load_dotenv() -> None:

{blog_cli-0.1.0 → blog_cli-0.2.1}/tests/test_cli.py

@@ -15,7 +15,7 @@ def runner() -> CliRunner:
 
 
 def _build_client_mock(live_server: str):
-    return lambda server_url=None: ArticleApiClient(live_server)
+    return lambda server_url=None, insecure=False: ArticleApiClient(live_server)
 
 
 def test_article_cli_smoke(monkeypatch, runner: CliRunner, live_server: str) -> None: