kd-cli 2.1.2__tar.gz → 2.1.4__tar.gz

{kd_cli-2.1.2/kd_cli.egg-info → kd_cli-2.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kd-cli
-Version: 2.1.2
+Version: 2.1.4
 Summary: Knowledge Dispatcher for issue trackers and knowledge bases
 Author: Sergiy Gladkyy
 License-Expression: MIT

{kd_cli-2.1.2 → kd_cli-2.1.4}/kd/api/http.py

@@ -61,7 +61,7 @@ class HttpClient:
         if fields:
             all_params["fields"] = fields
         response = self._request("GET", path, params=all_params)
-        return response.json()
+        return self._decode_json(response)
 
     def post(
         self,
@@ -77,7 +77,7 @@ class HttpClient:
         response = self._request("POST", path, json=json, params=all_params or None)
         if response.status_code == 204 or not response.content:
             return {}
-        return response.json()
+        return self._decode_json(response)
 
     def post_file(
         self,
@@ -99,7 +99,7 @@ class HttpClient:
         )
         if response.status_code == 204 or not response.content:
             return {}
-        return response.json()
+        return self._decode_json(response)
 
     def get_bytes(
         self,
@@ -168,6 +168,28 @@ class HttpClient:
         self._raise_for_status(last_response)
         raise AssertionError("unreachable")  # pragma: no cover
 
+    @staticmethod
+    def _decode_json(response: httpx.Response) -> Any:
+        """Decode a 2xx response as JSON, guarding against non-JSON bodies.
+
+        A misconfigured base URL (e.g. trailing slash producing ``//api/...``)
+        can yield a 200 HTML page from YouTrack's web UI. Surface that as a
+        clear APIError instead of letting ``JSONDecodeError`` bubble up.
+        """
+        content_type = response.headers.get("content-type", "")
+        if "json" not in content_type.lower():
+            url = str(response.request.url) if response.request else "<unknown>"
+            raise APIError(
+                response.status_code,
+                (
+                    f"Expected JSON response but got '{content_type or 'unknown'}' "
+                    f"from {url}. Check the 'url' in your connection config — "
+                    "a trailing slash or a non-YouTrack host can produce this."
+                ),
+                response.text[:500],
+            )
+        return response.json()
+
     @staticmethod
     def _extract_message(body: str) -> str:
         """Extract a human-readable message from a YouTrack error response.

{kd_cli-2.1.2 → kd_cli-2.1.4}/kd/connection.py

@@ -13,7 +13,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any, Literal
 
-from pydantic import BaseModel, Field, model_validator
+from pydantic import BaseModel, Field, field_validator, model_validator
 
 from kd.auth import resolve_connection_token
 from kd.exceptions import ConfigError
@@ -82,6 +82,11 @@ class ConnectionConfig(BaseModel):
         description="Version targeting (target + mode)",
     )
 
+    @field_validator("url", mode="after")
+    @classmethod
+    def _normalize_url(cls, value: str) -> str:
+        return value.rstrip("/")
+
     @model_validator(mode="after")
     def _require_auth_source(self) -> ConnectionConfig:
         if not self.token_cmd and not self.token_env:

{kd_cli-2.1.2 → kd_cli-2.1.4}/kd/resources/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to kd-cli are recorded here. The project follows [Semantic V
 
 ## [Unreleased]
 
+## [2.1.4] — 2026-04-15
+
+### Fixed
+- Connection `url` with a trailing slash no longer produces opaque `JSONDecodeError`. URLs are now normalized on load (`https://host/` → `https://host`), and the HTTP layer guards against non-JSON 2xx responses — a misconfigured URL that lands on YouTrack's HTML web UI now raises a clear `APIError` naming the URL and content type (KDCLI-67).
+
+### Documentation
+- `docs/how-to/012-install-how-to.md` now walks through obtaining a YouTrack API token (Profile → Account Security → New token) and clarifies that the `token_env` name is user-configurable. The configuration how-to cross-links to it (KDCLI-68).
+
+## [2.1.3] — 2026-04-15
+
+### Fixed
+- `sync-changelog` CI job now correctly publishes `CHANGELOG.md` on its first run against `kd-cli`. The 2.1.2 release exposed a guard that ignored untracked files, so the initial sync was a no-op and the PyPI Changelog link 404'd until this release (KDCLI-65).
+
 ## [2.1.2] — 2026-04-15
 
 ### Changed

{kd_cli-2.1.2 → kd_cli-2.1.4/kd_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kd-cli
-Version: 2.1.2
+Version: 2.1.4
 Summary: Knowledge Dispatcher for issue trackers and knowledge bases
 Author: Sergiy Gladkyy
 License-Expression: MIT

{kd_cli-2.1.2 → kd_cli-2.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kd-cli"
-version = "2.1.2"
+version = "2.1.4"
 description = "Knowledge Dispatcher for issue trackers and knowledge bases"
 readme = "README.md"
 requires-python = ">=3.11"