devrev-Python-SDK 2.8.1__tar.gz → 2.9.0__tar.gz

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devrev-Python-SDK
-Version: 2.8.1
+Version: 2.9.0
 Summary: A modern, type-safe Python SDK for the DevRev API
 Project-URL: Homepage, https://github.com/mgmonteleone/py-dev-rev
 Project-URL: Documentation, https://github.com/mgmonteleone/py-dev-rev
@@ -517,6 +517,7 @@ article = client.articles.create_with_content(
     owned_by=["don:identity:dvrv-us-1:devo/1:devu/1"],
     description="Quick start guide for new users",  # Optional metadata
     status=ArticleStatus.PUBLISHED,
+    applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123"],  # Optional: associate with parts
 )
 
 # Get article with content
@@ -538,6 +539,12 @@ client.articles.update_with_content(
     status=ArticleStatus.ARCHIVED,
 )
 
+# Update with part associations
+client.articles.update_with_content(
+    id=article.id,
+    applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123", "don:core:dvrv-us-1:devo/1:part/456"],
+)
+
 # List published articles (metadata only)
 published = client.articles.list(limit=20)
 for article in published:

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/README.md

@@ -442,6 +442,7 @@ article = client.articles.create_with_content(
     owned_by=["don:identity:dvrv-us-1:devo/1:devu/1"],
     description="Quick start guide for new users",  # Optional metadata
     status=ArticleStatus.PUBLISHED,
+    applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123"],  # Optional: associate with parts
 )
 
 # Get article with content
@@ -463,6 +464,12 @@ client.articles.update_with_content(
     status=ArticleStatus.ARCHIVED,
 )
 
+# Update with part associations
+client.articles.update_with_content(
+    id=article.id,
+    applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123", "don:core:dvrv-us-1:devo/1:part/456"],
+)
+
 # List published articles (metadata only)
 published = client.articles.list(limit=20)
 for article in published:

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/docs/api/services/articles.md

@@ -93,6 +93,7 @@ article = client.articles.create_with_content(
     description="Short summary for search/listing",  # Optional metadata
     status=ArticleStatus.PUBLISHED,  # Optional: draft, published, archived
     content_format="text/html",  # Optional: default is text/html
+    applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123"],  # Optional: associate with parts
 )
 print(f"Created article with content: {article.id}")
 ```
@@ -181,6 +182,12 @@ updated_article = client.articles.update_with_content(
     id="don:core:dvrv-us-1:devo/1:article/123",
     content="<h1>New Content</h1>",
 )
+
+# Update with part associations
+updated_article = client.articles.update_with_content(
+    id="don:core:dvrv-us-1:devo/1:article/123",
+    applies_to_parts=["don:core:dvrv-us-1:devo/1:part/123", "don:core:dvrv-us-1:devo/1:part/456"],
+)
 ```
 
 ### Async Usage

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/docs/changelog.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.9.0] - 2026-03-09
+
+### Added
+
+- **Article Part Association** (#171) — Added `applies_to_parts` parameter to MCP `articles_create` and `articles_update` tools, and SDK `update_with_content` method for native article-to-part association
+
 ## [2.8.1] - 2026-03-06
 
 ### Fixed

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/docs/mcp/tools-reference.md

@@ -56,6 +56,7 @@ Tools are the primary way AI assistants interact with DevRev. Each tool maps to
 - **Unified Content Management**: Create and update articles with automatic artifact handling
 - **Optional Content Loading**: Use `include_content=true` in `get` to fetch article body
 - **Clear Parameters**: `content` for article body, `description` for metadata summary
+- **Part Association**: Use `applies_to_parts` to natively associate articles with products, capabilities, features, or enhancements
 
 ### Conversations
 

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "devrev-Python-SDK"
-version = "2.8.1"
+version = "2.9.0"
 description = "A modern, type-safe Python SDK for the DevRev API"
 readme = "README.md"
 requires-python = ">=3.11"

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/src/devrev/services/articles.py

@@ -21,6 +21,7 @@ from devrev.models.articles import (
     ArticlesListResponse,
     ArticleStatus,
     ArticlesUpdateRequest,
+    ArticlesUpdateRequestAppliesToParts,
     ArticlesUpdateResponse,
     ArticleType,
     ArticleWithContent,
@@ -437,6 +438,7 @@ class ArticlesService(BaseService):
         content: str | None = None,
         description: str | None = None,
         status: ArticleStatus | None = None,
+        applies_to_parts: builtins.list[str] | None = None,
     ) -> Article:
         """Update article metadata and/or content.
 
@@ -451,6 +453,7 @@ class ArticlesService(BaseService):
             content: Optional new article body content
             description: Optional new metadata description
             status: Optional new status
+            applies_to_parts: Optional list of part IDs to associate with
 
         Returns:
             Updated article
@@ -478,6 +481,12 @@ class ArticlesService(BaseService):
             ...     title="New Title",
             ...     content="<html>New content...</html>"
             ... )
+            >>>
+            >>> # Update applies_to_parts
+            >>> article = client.articles.update_with_content(
+            ...     "ART-123",
+            ...     applies_to_parts=["don:core:...:capability/6"]
+            ... )
         """
         if not self._parent_client:
             raise DevRevError(
@@ -489,13 +498,25 @@ class ArticlesService(BaseService):
         if content is not None:
             self.update_content(id, content)
 
+        # Build applies_to_parts wrapper if provided
+        applies_to_parts_req = None
+        if applies_to_parts is not None:
+            applies_to_parts_req = ArticlesUpdateRequestAppliesToParts(set=applies_to_parts)
+
         # Update metadata if any metadata fields provided
-        if title is not None or description is not None or status is not None:
+        has_metadata = (
+            title is not None
+            or description is not None
+            or status is not None
+            or applies_to_parts is not None
+        )
+        if has_metadata:
             update_req = ArticlesUpdateRequest(
                 id=id,
                 title=title,
                 description=description,
                 status=status,
+                applies_to_parts=applies_to_parts_req,
             )
             return self.update(update_req)
 
@@ -822,6 +843,7 @@ class AsyncArticlesService(AsyncBaseService):
         content: str | None = None,
         description: str | None = None,
         status: ArticleStatus | None = None,
+        applies_to_parts: builtins.list[str] | None = None,
     ) -> Article:
         """Update article metadata and/or content (async).
 
@@ -836,6 +858,7 @@ class AsyncArticlesService(AsyncBaseService):
             content: Optional new article body content
             description: Optional new metadata description
             status: Optional new status
+            applies_to_parts: Optional list of part IDs to associate with
 
         Returns:
             Updated article
@@ -853,13 +876,25 @@ class AsyncArticlesService(AsyncBaseService):
         if content is not None:
             await self.update_content(id, content)
 
+        # Build applies_to_parts wrapper if provided
+        applies_to_parts_req = None
+        if applies_to_parts is not None:
+            applies_to_parts_req = ArticlesUpdateRequestAppliesToParts(set=applies_to_parts)
+
         # Update metadata if any metadata fields provided
-        if title is not None or description is not None or status is not None:
+        has_metadata = (
+            title is not None
+            or description is not None
+            or status is not None
+            or applies_to_parts is not None
+        )
+        if has_metadata:
             update_req = ArticlesUpdateRequest(
                 id=id,
                 title=title,
                 description=description,
                 status=status,
+                applies_to_parts=applies_to_parts_req,
             )
             return await self.update(update_req)
 

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/src/devrev_mcp/tools/articles.py

@@ -102,6 +102,7 @@ if _config.enable_destructive_tools:
         description: str | None = None,
         status: str | None = None,
         content_format: str = "text/html",
+        applies_to_parts: list[str] | None = None,
     ) -> dict[str, Any]:
         """Create a new article with content.
 
@@ -113,6 +114,8 @@ if _config.enable_destructive_tools:
             description: Optional short metadata description (NOT the article body).
             status: Optional article status (draft, published, archived).
             content_format: Content MIME type (default: text/html).
+            applies_to_parts: Optional list of part IDs (products, capabilities,
+                features, enhancements) to associate the article with.
 
         Returns:
             Dictionary containing the created article details.
@@ -139,6 +142,7 @@ if _config.enable_destructive_tools:
                 description=description,
                 status=article_status,
                 content_format=content_format,
+                applies_to_parts=applies_to_parts,
             )
             return serialize_model(article)
         except DevRevError as e:
@@ -152,6 +156,7 @@ if _config.enable_destructive_tools:
         content: str | None = None,
         description: str | None = None,
         status: str | None = None,
+        applies_to_parts: list[str] | None = None,
     ) -> dict[str, Any]:
         """Update an existing article in DevRev.
 
@@ -162,6 +167,9 @@ if _config.enable_destructive_tools:
             content: Optional new article body content.
             description: Optional new metadata description (NOT the article body).
             status: Optional new status (draft, published, archived).
+            applies_to_parts: Optional list of part IDs (products, capabilities,
+                features, enhancements) to associate the article with.
+                Pass an empty list to remove all associations.
 
         Returns:
             Dictionary containing the updated article details.
@@ -187,6 +195,7 @@ if _config.enable_destructive_tools:
                 content=content,
                 description=description,
                 status=article_status,
+                applies_to_parts=applies_to_parts,
             )
             return serialize_model(article)
         except DevRevError as e:

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/tests/unit/mcp/conftest.py

@@ -110,7 +110,9 @@ def mock_client():
     client.articles.list = AsyncMock()
     client.articles.get = AsyncMock()
     client.articles.create = AsyncMock()
+    client.articles.create_with_content = AsyncMock()
     client.articles.update = AsyncMock()
+    client.articles.update_with_content = AsyncMock()
     client.articles.delete = AsyncMock()
     client.articles.count = AsyncMock()
 

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/tests/unit/mcp/test_tools_articles.py

@@ -154,6 +154,34 @@ class TestArticlesCreateTool:
                 owned_by=["don:identity:dvrv-us-1:devo/test:devu/1"],
             )
 
+    @pytest.mark.asyncio
+    async def test_create_with_applies_to_parts(self, mock_ctx, mock_client):
+        """Test creating an article with applies_to_parts."""
+        mock_article = _make_mock_article(
+            title="Article with Parts",
+            description="Content with parts",
+        )
+        mock_client.articles.create_with_content.return_value = mock_article
+
+        result = await devrev_articles_create(
+            mock_ctx,
+            title="Article with Parts",
+            content="Content with parts",
+            owned_by=["don:identity:dvrv-us-1:devo/test:devu/1"],
+            applies_to_parts=[
+                "don:core:dvrv-us-1:devo/1:product/1",
+                "don:core:dvrv-us-1:devo/1:capability/2",
+            ],
+        )
+
+        assert result["title"] == "Article with Parts"
+        # Verify applies_to_parts was passed to SDK
+        call_args = mock_client.articles.create_with_content.call_args
+        assert call_args[1]["applies_to_parts"] == [
+            "don:core:dvrv-us-1:devo/1:product/1",
+            "don:core:dvrv-us-1:devo/1:capability/2",
+        ]
+
 
 class TestArticlesUpdateTool:
     """Tests for devrev_articles_update tool."""
@@ -186,6 +214,28 @@ class TestArticlesUpdateTool:
         with pytest.raises(RuntimeError, match="Article not found"):
             await devrev_articles_update(mock_ctx, id="nonexistent", title="New")
 
+    @pytest.mark.asyncio
+    async def test_update_with_applies_to_parts(self, mock_ctx, mock_client):
+        """Test updating an article with applies_to_parts."""
+        mock_article = _make_mock_article(
+            id="article-1",
+            title="Updated Article",
+            status="published",
+        )
+        mock_client.articles.update_with_content.return_value = mock_article
+
+        result = await devrev_articles_update(
+            mock_ctx,
+            id="article-1",
+            title="Updated Article",
+            applies_to_parts=["don:core:dvrv-us-1:devo/1:feature/3"],
+        )
+
+        assert result["title"] == "Updated Article"
+        # Verify applies_to_parts was passed to SDK
+        call_args = mock_client.articles.update_with_content.call_args
+        assert call_args[1]["applies_to_parts"] == ["don:core:dvrv-us-1:devo/1:feature/3"]
+
 
 class TestArticlesDeleteTool:
     """Tests for devrev_articles_delete tool."""

{devrev_python_sdk-2.8.1 → devrev_python_sdk-2.9.0}/tests/unit/test_articles_unified.py

@@ -776,6 +776,86 @@ class TestUpdateWithContent:
         with pytest.raises(DevRevError, match="update_with_content requires parent client"):
             articles_service_no_parent.update_with_content("article-123", title="New")
 
+    def test_update_with_content_applies_to_parts_only(
+        self,
+        articles_service: ArticlesService,
+        mock_article: Article,
+        mock_http_client: MagicMock,
+    ) -> None:
+        """Test updating only applies_to_parts."""
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_http_client.post.return_value = mock_response
+
+        result = articles_service.update_with_content(
+            "article-123",
+            applies_to_parts=["don:core:dvrv-us-1:devo/1:product/1"],
+        )
+
+        assert result.id == "article-123"
+        # Verify update was called with applies_to_parts wrapped in set
+        post_call = mock_http_client.post.call_args
+        assert "articles.update" in post_call[0][0]
+        data = post_call[1]["data"]
+        assert "applies_to_parts" in data
+        assert data["applies_to_parts"]["set"] == ["don:core:dvrv-us-1:devo/1:product/1"]
+
+    def test_update_with_content_applies_to_parts_with_metadata(
+        self,
+        articles_service: ArticlesService,
+        mock_article: Article,
+        mock_http_client: MagicMock,
+    ) -> None:
+        """Test updating applies_to_parts along with other metadata."""
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_http_client.post.return_value = mock_response
+
+        result = articles_service.update_with_content(
+            "article-123",
+            title="New Title",
+            description="New description",
+            applies_to_parts=[
+                "don:core:dvrv-us-1:devo/1:capability/2",
+                "don:core:dvrv-us-1:devo/1:feature/3",
+            ],
+        )
+
+        assert result.id == "article-123"
+        # Verify all metadata was passed including applies_to_parts
+        post_call = mock_http_client.post.call_args
+        data = post_call[1]["data"]
+        assert data["title"] == "New Title"
+        assert data["description"] == "New description"
+        assert "applies_to_parts" in data
+        assert data["applies_to_parts"]["set"] == [
+            "don:core:dvrv-us-1:devo/1:capability/2",
+            "don:core:dvrv-us-1:devo/1:feature/3",
+        ]
+
+    def test_update_with_content_applies_to_parts_empty_list(
+        self,
+        articles_service: ArticlesService,
+        mock_article: Article,
+        mock_http_client: MagicMock,
+    ) -> None:
+        """Test updating with empty applies_to_parts list to remove all associations."""
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_http_client.post.return_value = mock_response
+
+        result = articles_service.update_with_content(
+            "article-123",
+            applies_to_parts=[],
+        )
+
+        assert result.id == "article-123"
+        # Verify empty list is passed to clear associations
+        post_call = mock_http_client.post.call_args
+        data = post_call[1]["data"]
+        assert "applies_to_parts" in data
+        assert data["applies_to_parts"]["set"] == []
+
 
 # ============================================================================
 # Async Tests
@@ -1363,3 +1443,86 @@ class TestUpdateWithContentAsync:
                 "article-123",
                 title="New",
             )
+
+    @pytest.mark.asyncio
+    async def test_async_update_with_content_applies_to_parts_only(
+        self,
+        async_articles_service: AsyncArticlesService,
+        mock_article: Article,
+        mock_async_http_client: MagicMock,
+    ) -> None:
+        """Test async updating only applies_to_parts."""
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_async_http_client.post.return_value = mock_response
+
+        result = await async_articles_service.update_with_content(
+            "article-123",
+            applies_to_parts=["don:core:dvrv-us-1:devo/1:product/1"],
+        )
+
+        assert result.id == "article-123"
+        # Verify update was called with applies_to_parts wrapped in set
+        post_call = mock_async_http_client.post.call_args
+        assert "articles.update" in post_call[0][0]
+        data = post_call[1]["data"]
+        assert "applies_to_parts" in data
+        assert data["applies_to_parts"]["set"] == ["don:core:dvrv-us-1:devo/1:product/1"]
+
+    @pytest.mark.asyncio
+    async def test_async_update_with_content_applies_to_parts_with_metadata(
+        self,
+        async_articles_service: AsyncArticlesService,
+        mock_article: Article,
+        mock_async_http_client: MagicMock,
+    ) -> None:
+        """Test async updating applies_to_parts along with other metadata."""
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_async_http_client.post.return_value = mock_response
+
+        result = await async_articles_service.update_with_content(
+            "article-123",
+            title="New Title",
+            description="New description",
+            applies_to_parts=[
+                "don:core:dvrv-us-1:devo/1:capability/2",
+                "don:core:dvrv-us-1:devo/1:feature/3",
+            ],
+        )
+
+        assert result.id == "article-123"
+        # Verify all metadata was passed including applies_to_parts
+        post_call = mock_async_http_client.post.call_args
+        data = post_call[1]["data"]
+        assert data["title"] == "New Title"
+        assert data["description"] == "New description"
+        assert "applies_to_parts" in data
+        assert data["applies_to_parts"]["set"] == [
+            "don:core:dvrv-us-1:devo/1:capability/2",
+            "don:core:dvrv-us-1:devo/1:feature/3",
+        ]
+
+    @pytest.mark.asyncio
+    async def test_async_update_with_content_applies_to_parts_empty_list(
+        self,
+        async_articles_service: AsyncArticlesService,
+        mock_article: Article,
+        mock_async_http_client: MagicMock,
+    ) -> None:
+        """Test async updating with empty applies_to_parts list to remove all associations."""
+        mock_response = MagicMock()
+        mock_response.json.return_value = {"article": mock_article.model_dump(mode="json")}
+        mock_async_http_client.post.return_value = mock_response
+
+        result = await async_articles_service.update_with_content(
+            "article-123",
+            applies_to_parts=[],
+        )
+
+        assert result.id == "article-123"
+        # Verify empty list is passed to clear associations
+        post_call = mock_async_http_client.post.call_args
+        data = post_call[1]["data"]
+        assert "applies_to_parts" in data
+        assert data["applies_to_parts"]["set"] == []