bbdc-cli 0.4.2__tar.gz → 0.5.0__tar.gz

{bbdc_cli-0.4.2 → bbdc_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bbdc-cli
-Version: 0.4.2
+Version: 0.5.0
 Summary: Typer CLI for Bitbucket Data Center
 Project-URL: Repository, https://github.com/marcosgalleterobbva/bb-cli
 Keywords: bitbucket,cli,typer,data-center,server
@@ -100,6 +100,7 @@ Show help:
 ```bash
 bbdc --help
 bbdc account --help
+bbdc dashboard --help
 bbdc pr --help
 ```
 
@@ -110,8 +111,11 @@ Get information about your authenticated account:
 bbdc account me
 
 # if some account endpoints are not permitted with your token,
-# account me returns partial JSON with "partial" + "errors"
-bbdc account me --json
+# account me still returns partial JSON with "partial" + "errors"
+bbdc account me
+
+# account me is JSON by default; there is no --json flag
+# (use: bbdc account me)
 
 # include user profile and settings when your slug is known
 bbdc account me --user-slug your.user --include-settings
@@ -124,6 +128,19 @@ bbdc account user --user-slug your.user
 bbdc account settings --user-slug your.user
 ```
 
+Inspect dashboard pull requests:
+
+```bash
+# pull requests where you are involved (author/reviewer/participant)
+bbdc dashboard pull-requests
+
+# filter by role/state
+bbdc dashboard pull-requests --role REVIEWER --state OPEN
+
+# return JSON
+bbdc dashboard pull-requests --json
+```
+
 List pull requests:
 
 ```bash

{bbdc_cli-0.4.2 → bbdc_cli-0.5.0}/README.md

@@ -81,6 +81,7 @@ Show help:
 ```bash
 bbdc --help
 bbdc account --help
+bbdc dashboard --help
 bbdc pr --help
 ```
 
@@ -91,8 +92,11 @@ Get information about your authenticated account:
 bbdc account me
 
 # if some account endpoints are not permitted with your token,
-# account me returns partial JSON with "partial" + "errors"
-bbdc account me --json
+# account me still returns partial JSON with "partial" + "errors"
+bbdc account me
+
+# account me is JSON by default; there is no --json flag
+# (use: bbdc account me)
 
 # include user profile and settings when your slug is known
 bbdc account me --user-slug your.user --include-settings
@@ -105,6 +109,19 @@ bbdc account user --user-slug your.user
 bbdc account settings --user-slug your.user
 ```
 
+Inspect dashboard pull requests:
+
+```bash
+# pull requests where you are involved (author/reviewer/participant)
+bbdc dashboard pull-requests
+
+# filter by role/state
+bbdc dashboard pull-requests --role REVIEWER --state OPEN
+
+# return JSON
+bbdc dashboard pull-requests --json
+```
+
 List pull requests:
 
 ```bash

{bbdc_cli-0.4.2 → bbdc_cli-0.5.0}/bbdc_cli/__main__.py

@@ -37,6 +37,7 @@ import typer
 
 app = typer.Typer(no_args_is_help=True, add_completion=False)
 account_app = typer.Typer(no_args_is_help=True, add_completion=False)
+dashboard_app = typer.Typer(no_args_is_help=True, add_completion=False)
 pr_app = typer.Typer(no_args_is_help=True, add_completion=False)
 participants_app = typer.Typer(no_args_is_help=True, add_completion=False)
 comments_app = typer.Typer(no_args_is_help=True, add_completion=False)
@@ -44,6 +45,7 @@ blockers_app = typer.Typer(no_args_is_help=True, add_completion=False)
 review_app = typer.Typer(no_args_is_help=True, add_completion=False)
 auto_merge_app = typer.Typer(no_args_is_help=True, add_completion=False)
 app.add_typer(account_app, name="account", help="Authenticated account operations")
+app.add_typer(dashboard_app, name="dashboard", help="Dashboard operations")
 app.add_typer(pr_app, name="pr", help="Pull request operations")
 pr_app.add_typer(participants_app, name="participants", help="PR participants and reviewers")
 pr_app.add_typer(comments_app, name="comments", help="PR comments")
@@ -1252,6 +1254,41 @@ def _op_pr_auto_merge_cancel(
     return {"message": f"Cancelled auto-merge for PR #{pr_id}"}
 
 
+def _op_dashboard_pull_requests(
+    bb: BitbucketClient,
+    *,
+    user: Optional[str],
+    state: Optional[str],
+    role: Optional[str],
+    participant_status: Optional[str],
+    order: Optional[str],
+    closed_since: Optional[int],
+    limit: int,
+    max_items: int,
+) -> Dict[str, Any]:
+    params: Dict[str, Any] = {}
+    if user:
+        params["user"] = user
+    if state:
+        params["state"] = state
+    if role:
+        params["role"] = role
+    if participant_status:
+        params["participantStatus"] = participant_status
+    if order:
+        params["order"] = order
+    if closed_since is not None:
+        params["closedSince"] = closed_since
+    prs = bb.paged_get(
+        "dashboard/pull-requests",
+        params=params or None,
+        limit=limit,
+        max_items=max_items,
+    )
+    who = user or "current user"
+    return {"message": f"Fetched {len(prs)} dashboard pull requests for {who}", "data": prs}
+
+
 def _op_account_recent_repos(
     bb: BitbucketClient, limit: int, max_items: int
 ) -> Dict[str, Any]:
@@ -1758,7 +1795,6 @@ def account_me(
     ),
     limit: int = typer.Option(25, help="Page size for account-related paged endpoints"),
     max_items: int = typer.Option(100, help="Max items per account-related endpoint"),
-    json_out: bool = typer.Option(False, "--json", help="Print raw JSON response"),
 ):
     """Get a consolidated snapshot of the authenticated account.
 
@@ -1773,10 +1809,58 @@ def account_me(
         limit=limit,
         max_items=max_items,
     )
+    _print_json(resp["data"])
+
+
+@dashboard_app.command("pull-requests")
+def dashboard_pull_requests(
+    user: Optional[str] = typer.Option(None, "--user", help="Involved user name; defaults to current user"),
+    state: Optional[str] = typer.Option(
+        None,
+        "--state",
+        help="OPEN, DECLINED, or MERGED. Omit to include all states.",
+    ),
+    role: Optional[str] = typer.Option(
+        None,
+        "--role",
+        help="REVIEWER, AUTHOR, or PARTICIPANT. Omit to include all roles.",
+    ),
+    participant_status: Optional[str] = typer.Option(
+        None,
+        "--participant-status",
+        help="Comma-separated list: UNAPPROVED, NEEDS_WORK, APPROVED.",
+    ),
+    order: Optional[str] = typer.Option(
+        None,
+        "--order",
+        help="OLDEST, NEWEST, DRAFT_STATUS, PARTICIPANT_STATUS, and/or CLOSED_DATE.",
+    ),
+    closed_since: Optional[int] = typer.Option(
+        None,
+        "--closed-since",
+        help="Only include PRs closed in the last N seconds.",
+    ),
+    limit: int = typer.Option(25, help="Page size"),
+    max_items: int = typer.Option(100, help="Max items to fetch across pages"),
+    json_out: bool = typer.Option(False, "--json", help="Print raw JSON instead of a table"),
+):
+    """List dashboard pull requests for a user."""
+    bb = client()
+    resp = _op_dashboard_pull_requests(
+        bb,
+        user=user,
+        state=state,
+        role=role,
+        participant_status=participant_status,
+        order=order,
+        closed_since=closed_since,
+        limit=limit,
+        max_items=max_items,
+    )
     if json_out:
         _print_json(resp["data"])
     else:
-        _print_json(resp["data"])
+        _print_prs(resp["data"])
 
 
 @pr_app.command("list")

{bbdc_cli-0.4.2 → bbdc_cli-0.5.0}/bbdc_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bbdc-cli
-Version: 0.4.2
+Version: 0.5.0
 Summary: Typer CLI for Bitbucket Data Center
 Project-URL: Repository, https://github.com/marcosgalleterobbva/bb-cli
 Keywords: bitbucket,cli,typer,data-center,server
@@ -100,6 +100,7 @@ Show help:
 ```bash
 bbdc --help
 bbdc account --help
+bbdc dashboard --help
 bbdc pr --help
 ```
 
@@ -110,8 +111,11 @@ Get information about your authenticated account:
 bbdc account me
 
 # if some account endpoints are not permitted with your token,
-# account me returns partial JSON with "partial" + "errors"
-bbdc account me --json
+# account me still returns partial JSON with "partial" + "errors"
+bbdc account me
+
+# account me is JSON by default; there is no --json flag
+# (use: bbdc account me)
 
 # include user profile and settings when your slug is known
 bbdc account me --user-slug your.user --include-settings
@@ -124,6 +128,19 @@ bbdc account user --user-slug your.user
 bbdc account settings --user-slug your.user
 ```
 
+Inspect dashboard pull requests:
+
+```bash
+# pull requests where you are involved (author/reviewer/participant)
+bbdc dashboard pull-requests
+
+# filter by role/state
+bbdc dashboard pull-requests --role REVIEWER --state OPEN
+
+# return JSON
+bbdc dashboard pull-requests --json
+```
+
 List pull requests:
 
 ```bash

{bbdc_cli-0.4.2 → bbdc_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bbdc-cli"
-version = "0.4.2"
+version = "0.5.0"
 description = "Typer CLI for Bitbucket Data Center"
 readme = "README.md"
 requires-python = ">=3.9"