devrev-Python-SDK 3.1.0__tar.gz → 3.2.0__tar.gz

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devrev-Python-SDK
-Version: 3.1.0
+Version: 3.2.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
@@ -505,6 +505,57 @@ export_result = client.works.export(
 )
 ```
 
+### Managing Parts
+
+```python
+from devrev.models.parts import PartsCreateRequest, PartsMoveRequest, PartType
+
+# Create a feature under a capability
+feature = client.parts.create(PartsCreateRequest(
+    name="Bulk import",
+    type=PartType.FEATURE,
+    parent_part=["don:core:dvrv-us-1:devo/1:part/1"],
+))
+
+# Move (re-parent) a part under a new parent part
+#
+# The DevRev REST API only accepts `parent_part` on parts.create (not
+# parts.update), so move() implements a recreate-and-relink workaround: it
+# creates a new same-type part under the new parent (preserving name,
+# description, owners and tags), relinks work items (applies_to_part) and child
+# parts onto the new part, then deletes the original source part.
+#
+# CAVEAT: a real move is NOT an in-place update. It produces a NEW part id and
+# DELETES the original part. Update any references you hold to the old id.
+
+# Dry run first: returns the plan, mutates nothing.
+plan = client.parts.move(PartsMoveRequest(
+    id=feature.id,
+    new_parent_part="don:core:dvrv-us-1:devo/1:part/2",
+    dry_run=True,
+))
+print(plan.plan.work_items_to_relink)       # work items that would be relinked
+print(plan.plan.child_parts_to_reparent)    # child parts that would be re-parented
+print(plan.plan.will_delete_source)         # True -> the source part will be deleted
+assert plan.source_deleted is False         # nothing was changed by the dry run
+
+# Real move: creates the new part, relinks dependents, deletes the source.
+result = client.parts.move(PartsMoveRequest(
+    id=feature.id,
+    new_parent_part="don:core:dvrv-us-1:devo/1:part/2",
+))
+print(result.new_part_id)        # the NEW part id (the source id is now deleted)
+print(result.relinked_work_items)
+print(result.reparented_children)
+print(result.source_deleted)     # True
+```
+
+> **Note**: `move` requires the parts service be accessed via the client
+> (`client.parts`) because it coordinates with the works service to relink work
+> items. Via the MCP server, this is the `devrev_parts_move` tool, which is
+> gated behind `MCP_ENABLE_DESTRUCTIVE_TOOLS=true` (it creates and deletes
+> parts).
+
 ### Articles and Knowledge Base
 
 ```python
@@ -995,7 +1046,7 @@ All settings are configurable via environment variables (prefix `MCP_`):
 | Users | 5 | dev list/get, rev list/get/create |
 | Conversations | 6 | list, get, create, update, delete, export |
 | Articles | 6 | list, get, create, update, delete, count |
-| Parts | 5 | list, get, create, update, delete |
+| Parts | 6 | list, get, create, update, delete, move |
 | Tags | 5 | list, get, create, update, delete |
 | Groups | 8 | list, get, create, update, delete, add/remove member, count |
 | Timeline | 5 | list, get, create, update, delete |
@@ -1028,13 +1079,13 @@ py-devrev/
 │       ├── __main__.py         # CLI entry point
 │       ├── server.py           # FastMCP server setup & lifecycle
 │       ├── config.py           # MCPServerConfig (pydantic-settings)
-│       ├── tools/              # 78 MCP tools across 15 categories
+│       ├── tools/              # 79 MCP tools across 15 categories
 │       │   ├── works.py        # Works: list, get, create, update, delete, count, search
 │       │   ├── accounts.py     # Accounts: list, get, create, update, delete, merge
 │       │   ├── users.py        # Users: list/get dev users, list/get rev users, whoami
 │       │   ├── conversations.py # Conversations: list, get, create, update, delete, export
 │       │   ├── articles.py     # Articles: list, get, create, update, delete, count
-│       │   ├── parts.py        # Parts: list, get, create, update, delete
+│       │   ├── parts.py        # Parts: list, get, create, update, delete, move
 │       │   ├── tags.py         # Tags: list, get, create, update, delete
 │       │   ├── groups.py       # Groups: CRUD + member management + count
 │       │   ├── timeline.py     # Timeline: list, get, create, update, delete

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/README.md

@@ -430,6 +430,57 @@ export_result = client.works.export(
 )
 ```
 
+### Managing Parts
+
+```python
+from devrev.models.parts import PartsCreateRequest, PartsMoveRequest, PartType
+
+# Create a feature under a capability
+feature = client.parts.create(PartsCreateRequest(
+    name="Bulk import",
+    type=PartType.FEATURE,
+    parent_part=["don:core:dvrv-us-1:devo/1:part/1"],
+))
+
+# Move (re-parent) a part under a new parent part
+#
+# The DevRev REST API only accepts `parent_part` on parts.create (not
+# parts.update), so move() implements a recreate-and-relink workaround: it
+# creates a new same-type part under the new parent (preserving name,
+# description, owners and tags), relinks work items (applies_to_part) and child
+# parts onto the new part, then deletes the original source part.
+#
+# CAVEAT: a real move is NOT an in-place update. It produces a NEW part id and
+# DELETES the original part. Update any references you hold to the old id.
+
+# Dry run first: returns the plan, mutates nothing.
+plan = client.parts.move(PartsMoveRequest(
+    id=feature.id,
+    new_parent_part="don:core:dvrv-us-1:devo/1:part/2",
+    dry_run=True,
+))
+print(plan.plan.work_items_to_relink)       # work items that would be relinked
+print(plan.plan.child_parts_to_reparent)    # child parts that would be re-parented
+print(plan.plan.will_delete_source)         # True -> the source part will be deleted
+assert plan.source_deleted is False         # nothing was changed by the dry run
+
+# Real move: creates the new part, relinks dependents, deletes the source.
+result = client.parts.move(PartsMoveRequest(
+    id=feature.id,
+    new_parent_part="don:core:dvrv-us-1:devo/1:part/2",
+))
+print(result.new_part_id)        # the NEW part id (the source id is now deleted)
+print(result.relinked_work_items)
+print(result.reparented_children)
+print(result.source_deleted)     # True
+```
+
+> **Note**: `move` requires the parts service be accessed via the client
+> (`client.parts`) because it coordinates with the works service to relink work
+> items. Via the MCP server, this is the `devrev_parts_move` tool, which is
+> gated behind `MCP_ENABLE_DESTRUCTIVE_TOOLS=true` (it creates and deletes
+> parts).
+
 ### Articles and Knowledge Base
 
 ```python
@@ -920,7 +971,7 @@ All settings are configurable via environment variables (prefix `MCP_`):
 | Users | 5 | dev list/get, rev list/get/create |
 | Conversations | 6 | list, get, create, update, delete, export |
 | Articles | 6 | list, get, create, update, delete, count |
-| Parts | 5 | list, get, create, update, delete |
+| Parts | 6 | list, get, create, update, delete, move |
 | Tags | 5 | list, get, create, update, delete |
 | Groups | 8 | list, get, create, update, delete, add/remove member, count |
 | Timeline | 5 | list, get, create, update, delete |
@@ -953,13 +1004,13 @@ py-devrev/
 │       ├── __main__.py         # CLI entry point
 │       ├── server.py           # FastMCP server setup & lifecycle
 │       ├── config.py           # MCPServerConfig (pydantic-settings)
-│       ├── tools/              # 78 MCP tools across 15 categories
+│       ├── tools/              # 79 MCP tools across 15 categories
 │       │   ├── works.py        # Works: list, get, create, update, delete, count, search
 │       │   ├── accounts.py     # Accounts: list, get, create, update, delete, merge
 │       │   ├── users.py        # Users: list/get dev users, list/get rev users, whoami
 │       │   ├── conversations.py # Conversations: list, get, create, update, delete, export
 │       │   ├── articles.py     # Articles: list, get, create, update, delete, count
-│       │   ├── parts.py        # Parts: list, get, create, update, delete
+│       │   ├── parts.py        # Parts: list, get, create, update, delete, move
 │       │   ├── tags.py         # Tags: list, get, create, update, delete
 │       │   ├── groups.py       # Groups: CRUD + member management + count
 │       │   ├── timeline.py     # Timeline: list, get, create, update, delete

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/docs/api/services/webhooks.md

@@ -35,7 +35,7 @@ import os
 
 response = client.webhooks.create(
     url="https://your-server.com/webhooks/devrev",
-    event_types=["work.created", "work.updated"],
+    event_types=["work_created", "work_updated"],
     secret=os.environ["WEBHOOK_SECRET"],  # Never hardcode!
 )
 print(f"Created: {response.webhook.id}")
@@ -46,7 +46,7 @@ print(f"Created: {response.webhook.id}")
 ```python
 response = client.webhooks.update(
     id="don:integration:dvrv-us-1:devo/1:webhook/123",
-    event_types=["work.created", "work.updated", "work.deleted"],
+    event_types=["work_created", "work_updated", "work_deleted"],
 )
 ```
 

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/docs/changelog.md

@@ -13,6 +13,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+## [3.1.1] - 2026-06-16
+
+### Changed
+
+- **Webhook event-type examples reconciled to underscore form** (CSS-1042) —
+  Pre-existing examples and docs that used the dotted DevRev webhook
+  event-type form (`work.created`) now use the canonical underscore form
+  (`work_created`, `work_updated`, `work_deleted`, `conversation_created`),
+  matching the form DevRev sends in webhook payloads and the form already used
+  by the README, SDK docs, and the webhooks MCP advisory. This corrects a
+  latent bug in the Google Cloud Functions example, whose handler compared the
+  incoming payload `type` against dotted strings that never matched.
+  Docs/examples only; no SDK or MCP behavior change.
+
 ## [3.1.0] - 2026-06-16
 
 ### Added

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/docs/examples/advanced.md

@@ -123,11 +123,11 @@ class WebhookHandler:
 # Usage example
 webhook = WebhookHandler(secret="your-webhook-secret")
 
-@webhook.on("work.created")
+@webhook.on("work_created")
 def handle_work_created(data):
     print(f"New work item: {data['work']['title']}")
 
-@webhook.on("work.updated")
+@webhook.on("work_updated")
 def handle_work_updated(data):
     print(f"Work updated: {data['work']['id']}")
 ```

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/docs/examples/integrations.md

@@ -121,7 +121,7 @@ def handle_webhook(request: Request):
     data = request.get_json()
     event_type = data.get("type")
     
-    if event_type == "work.created":
+    if event_type == "work_created":
         work = data.get("work", {})
         print(f"New work item: {work.get('title')}")
         

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/examples/integrations/cloud_functions/main.py

@@ -41,17 +41,17 @@ def handle_webhook(request: Request) -> tuple[dict[str, Any], int]:
     print(f"Received webhook: {event_type}")
 
     # Process different event types
-    if event_type == "work.created":
+    if event_type == "work_created":
         work = data.get("work", {})
         print(f"New work item created: {work.get('title')}")
         # Add your processing logic here
 
-    elif event_type == "work.updated":
+    elif event_type == "work_updated":
         work = data.get("work", {})
         print(f"Work item updated: {work.get('id')}")
         # Add your processing logic here
 
-    elif event_type == "conversation.created":
+    elif event_type == "conversation_created":
         conv = data.get("conversation", {})
         print(f"New conversation: {conv.get('id')}")
         # Add your processing logic here

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/pyproject.toml

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

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/src/devrev/client.py

@@ -160,7 +160,7 @@ class DevRevClient:
         self._dev_users = DevUsersService(self._http)
         self._groups = GroupsService(self._http)
         self._links = LinksService(self._http)
-        self._parts = PartsService(self._http)
+        self._parts = PartsService(self._http, parent_client=self)
         self._rev_orgs = RevOrgsService(self._http)
         self._rev_users = RevUsersService(self._http)
         self._slas = SlasService(self._http)
@@ -488,7 +488,7 @@ class AsyncDevRevClient:
         self._dev_users = AsyncDevUsersService(self._http)
         self._groups = AsyncGroupsService(self._http)
         self._links = AsyncLinksService(self._http)
-        self._parts = AsyncPartsService(self._http)
+        self._parts = AsyncPartsService(self._http, parent_client=self)
         self._rev_orgs = AsyncRevOrgsService(self._http)
         self._rev_users = AsyncRevUsersService(self._http)
         self._slas = AsyncSlasService(self._http)

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/src/devrev/models/__init__.py

@@ -217,6 +217,7 @@ from devrev.models.notifications import (
     NotificationsSendResponse,
 )
 from devrev.models.parts import (
+    ParentPartFilter,
     Part,
     PartsCreateRequest,
     PartsCreateResponse,
@@ -226,6 +227,9 @@ from devrev.models.parts import (
     PartsGetResponse,
     PartsListRequest,
     PartsListResponse,
+    PartsMovePlan,
+    PartsMoveRequest,
+    PartsMoveResult,
     PartSummary,
     PartsUpdateRequest,
     PartsUpdateResponse,
@@ -669,6 +673,7 @@ __all__ = [
     "NotificationsSendRequest",
     "NotificationsSendResponse",
     # Parts
+    "ParentPartFilter",
     "Part",
     "PartSummary",
     "PartType",
@@ -682,6 +687,9 @@ __all__ = [
     "PartsUpdateResponse",
     "PartsDeleteRequest",
     "PartsDeleteResponse",
+    "PartsMoveRequest",
+    "PartsMovePlan",
+    "PartsMoveResult",
     # Preferences
     "Preferences",
     "PreferencesGetRequest",

{devrev_python_sdk-3.1.0 → devrev_python_sdk-3.2.0}/src/devrev/models/parts.py

@@ -11,6 +11,7 @@ from devrev.models.base import (
     DevRevBaseModel,
     DevRevResponseModel,
     PaginatedResponse,
+    TagWithValue,
     UserSummary,
 )
 
@@ -33,6 +34,7 @@ class Part(DevRevResponseModel):
     type: PartType | None = Field(default=None, description="Part type")
     description: str | None = Field(default=None, description="Description")
     owned_by: list[UserSummary] | None = Field(default=None, description="Owners")
+    tags: list[TagWithValue] | None = Field(default=None, description="Tags")
     created_date: datetime | None = Field(default=None, description="Creation date")
     modified_date: datetime | None = Field(default=None, description="Last modified")
 
@@ -87,12 +89,32 @@ class PartsDeleteRequest(DevRevBaseModel):
     id: str = Field(..., description="Part ID to delete")
 
 
+class ParentPartFilter(DevRevBaseModel):
+    """Hierarchy filter for ``parts.list`` to fetch parts under given parents.
+
+    Mirrors the DevRev ``parent_part`` query filter. ``parts`` lists the parent
+    part IDs to fetch the hierarchy for (required), and ``level`` optionally
+    bounds how many levels of the hierarchy to return (``level=1`` returns the
+    direct children of the given parents).
+    """
+
+    parts: list[str] = Field(
+        ..., min_length=1, description="Parent part IDs to fetch the hierarchy for"
+    )
+    level: int | None = Field(
+        default=None, ge=1, description="Number of levels of the hierarchy to fetch"
+    )
+
+
 class PartsListRequest(DevRevBaseModel):
     """Request to list parts."""
 
     cursor: str | None = Field(default=None, description="Pagination cursor")
     limit: int | None = Field(default=None, ge=1, le=100, description="Max results")
     type: list[PartType] | None = Field(default=None, description="Filter by type")
+    parent_part: ParentPartFilter | None = Field(
+        default=None, description="Filter by parent part hierarchy"
+    )
 
 
 class PartsUpdateRequest(DevRevBaseModel):
@@ -131,3 +153,75 @@ class PartsDeleteResponse(DevRevResponseModel):
     """Response from deleting a part."""
 
     pass
+
+
+class PartsMoveRequest(DevRevBaseModel):
+    """Request to move (re-parent) a part.
+
+    The DevRev REST API only accepts ``parent_part`` on ``parts.create``, not
+    ``parts.update``. This SDK-level convenience request describes a higher-level
+    "move" operation that re-parents a part by recreating it under a new parent
+    and relinking its dependents. It is NOT a direct DevRev API request body.
+    """
+
+    id: str = Field(..., description="ID of the part to move (re-parent)")
+    new_parent_part: str = Field(
+        ..., description="Target parent part ID under which the part should be moved"
+    )
+    dry_run: bool = Field(
+        default=False,
+        description="If True, compute and return the move plan without executing it",
+    )
+
+
+class PartsMovePlan(DevRevResponseModel):
+    """Plan describing what a part move (re-parent) would do.
+
+    Computed before (or instead of, for a dry run) executing a move so callers
+    can review the dependents that will be relinked or re-parented.
+    """
+
+    source_part_id: str = Field(..., description="ID of the part to be moved")
+    source_part_type: str | None = Field(
+        default=None, description="Type of the source part (product, capability, etc.)"
+    )
+    new_parent_part: str = Field(
+        ..., description="Target parent part ID the source will be moved under"
+    )
+    work_items_to_relink: list[str] = Field(
+        default_factory=list,
+        description="IDs of work items currently applies_to the source part that will be relinked",
+    )
+    child_parts_to_reparent: list[str] = Field(
+        default_factory=list,
+        description="IDs of child parts of the source that will be re-parented",
+    )
+    will_delete_source: bool = Field(
+        default=False,
+        description="Whether the original source part will be deleted after the move",
+    )
+
+
+class PartsMoveResult(DevRevResponseModel):
+    """Outcome of an executed (or dry-run) part move (re-parent) operation."""
+
+    new_part_id: str = Field(..., description="ID of the newly created part under the new parent")
+    source_part_id: str = Field(..., description="ID of the original source part that was moved")
+    relinked_work_items: list[str] = Field(
+        default_factory=list,
+        description="IDs of work items that were relinked from the source to the new part",
+    )
+    reparented_children: list[str] = Field(
+        default_factory=list,
+        description="IDs of child parts that were re-parented under the new part",
+    )
+    source_deleted: bool = Field(
+        default=False, description="Whether the original source part was deleted"
+    )
+    dry_run: bool = Field(
+        default=False,
+        description="Whether this result describes a dry run (no changes were applied)",
+    )
+    plan: PartsMovePlan = Field(
+        ..., description="The move plan that was computed for this operation"
+    )