bigeye-cli 0.7.4__tar.gz → 0.8.0__tar.gz

bigeye_cli-0.7.4/bigeye_cli/CLI_DOCS.md → bigeye_cli-0.8.0/PKG-INFO

@@ -1,5 +1,24 @@
+Metadata-Version: 2.1
+Name: bigeye-cli
+Version: 0.8.0
+Summary: Bigeye CLI offers developer tools for maintaining your developer workspace.
+Home-page: https://docs.bigeye.com/docs
+License: Proprietary
+Author: Bigeye
+Author-email: support@bigeye.com
+Requires-Python: >=3.11.0,<4.0.0
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: PyGithub (>=1.59.1,<2.0.0)
+Requires-Dist: bigeye-sdk (>=0.10.0,<0.11.0)
+Requires-Dist: click (>=8.1.8,<9.0.0)
+Requires-Dist: rich (>=14.1.0,<15.0.0)
+Description-Content-Type: text/markdown
+
 # **Bigeye CLI**
-Version: 0.7.4
+Version: 0.8.0
 ## Installation
 
 **Setting up your local/build environment**  
@@ -716,6 +735,7 @@ $ bigeye catalog [OPTIONS] COMMAND [ARGS]...
 * `ingest-dbt-core-run-info`: Ingest manifest.json and run_results.json...
 * `track-schema-changes`: Track schema changes for sources on demand...
 * `sync-custom-repository`: Sync a custom repository from a YAML file.
+* `custom-repo`: Import and export custom repositories as...
 
 ## `bigeye catalog regen-autometrics`
 
@@ -1268,6 +1288,102 @@ $ bigeye catalog sync-custom-repository [OPTIONS]
 * `-ip, --input_path TEXT`: The path to the CUSTOM_REPOSITORY_CONFIGURATION file (Required)
 * `--help`: Show this message and exit.
 
+## `bigeye catalog custom-repo`
+
+Import and export custom repositories as Excel (.xlsx) workbooks.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `init`: Generate a blank custom repository...
+* `import`: Import a custom repository from an Excel...
+* `export`: Export a custom repository to an Excel...
+* `delete`: Entirely delete a custom repository,...
+
+### `bigeye catalog custom-repo init`
+
+Generate a blank custom repository workbook (branded, with the Instructions
+sheet and dropdowns) for you to populate, then import with `custom-repo import`.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo init [OPTIONS]
+```
+
+**Options**:
+
+* `-o, --output TEXT`: Output .xlsx path for the blank template.  [default: custom_repo_template.xlsx]
+* `--force`: Overwrite the output file if it already exists.
+* `--help`: Show this message and exit.
+
+### `bigeye catalog custom-repo import`
+
+Import a custom repository from an Excel workbook.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo import [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `-f, --file TEXT`: Path to the custom repository .xlsx workbook.  [required]
+* `--cleanup-stale`: Delete nodes/edges present in Bigeye but missing from the sheet. Off by default.
+* `--help`: Show this message and exit.
+
+### `bigeye catalog custom-repo export`
+
+Export a custom repository to an Excel workbook.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo export [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--repo-name TEXT`: Display name of the custom repository to export.  [required]
+* `-o, --output TEXT`: Output .xlsx path. Defaults to &lt;repo-name&gt;.xlsx in the current directory.
+* `--help`: Show this message and exit.
+
+### `bigeye catalog custom-repo delete`
+
+Entirely delete a custom repository, including its nodes, edges, node types,
+and integration type.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo delete [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--repo-name TEXT`: Display name of the custom repository to delete.  [required]
+* `-y, --yes`: Skip the confirmation prompt.
+* `--help`: Show this message and exit.
+
 # `bigeye metric`
 
 Metric Commands for Bigeye CLI
@@ -1773,6 +1889,8 @@ $ bigeye lineage [OPTIONS] COMMAND [ARGS]...
 * `create-relation`: Create a lineage relationship for 2 entities
 * `delete-relation`: Deletes a single relationship based on...
 * `infer-relations`: Given an upstream and downstream path,...
+* `export-graphs`: Bulk-export lineage graphs for a list of...
+* `export-end-to-end`: Export complete end-to-end lineage paths...
 
 ## `bigeye lineage create-node`
 
@@ -1874,3 +1992,57 @@ $ bigeye lineage infer-relations [OPTIONS]
 * `-purge, --purge_lineage`: Purge all lineage edges.
 * `--help`: Show this message and exit.
 
+## `bigeye lineage export-graphs`
+
+Bulk-export lineage graphs for a list of FQNs into a single zip.
+
+Reads fully-qualified catalog names from a CSV, downloads each one&#x27;s lineage graph,
+and writes one folder per FQN (nodes/edges/attributes) plus a top-level manifest of
+successes and failures.
+
+**Usage**:
+
+```console
+$ bigeye lineage export-graphs [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--fqns-file TEXT`: Path to a CSV with a single column of fully-qualified catalog names.  [required]
+* `--direction [upstream|downstream|both]`: Direction to traverse: upstream, downstream, or both.  [default: both]
+* `--content [all|nodes|edges|attributes]`: What each per-graph report contains: all, nodes, edges, or attributes.  [default: all]
+* `--include-etl / --no-include-etl`: Include or exclude ETL operator nodes. Defaults to including them.  [default: include-etl]
+* `-o, --output TEXT`: Output .zip path. Defaults to lineage_graphs.zip in the current directory.
+* `--help`: Show this message and exit.
+
+## `bigeye lineage export-end-to-end`
+
+Export complete end-to-end lineage paths for one or more roots into a CSV.
+
+Each row is one full lineage path and each Hop_* column is one object along it;
+the CSV widens to the longest path discovered. Only lineage edges become hops,
+collapsed to the chosen (or root-inferred) granularity — column/field hops roll
+up to their containing table/object (warehouse tables, ETL targets, BI objects).
+
+**Usage**:
+
+```console
+$ bigeye lineage export-end-to-end [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--root TEXT`: A starting point: a schema/table/column warehouse FQN or a custom node identifier. Repeatable to trace several roots into one CSV.  [required]
+* `--direction [upstream|downstream|both]`: Direction to trace: upstream, downstream, or both.  [default: both]
+* `--granularity [schema|table|column]`: Hop level: schema, table, or column. Defaults to each root&#x27;s own level.
+* `--max-paths INTEGER`: Per-root cap on enumerated paths. Truncation is logged, never silent.  [default: 10000]
+* `-o, --output TEXT`: Output .csv path. Defaults to end_to_end_&lt;root&gt;.csv in the current directory.
+* `--help`: Show this message and exit.
+
+

bigeye_cli-0.7.4/PKG-INFO → bigeye_cli-0.8.0/bigeye_cli/CLI_DOCS.md

@@ -1,24 +1,5 @@
-Metadata-Version: 2.1
-Name: bigeye-cli
-Version: 0.7.4
-Summary: Bigeye CLI offers developer tools for maintaining your developer workspace.
-Home-page: https://docs.bigeye.com/docs
-License: Proprietary
-Author: Bigeye
-Author-email: support@bigeye.com
-Requires-Python: >=3.11.0,<4.0.0
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: PyGithub (>=1.59.1,<2.0.0)
-Requires-Dist: bigeye-sdk (>=0.8.0,<0.9.0)
-Requires-Dist: click (>=8.1.8,<9.0.0)
-Requires-Dist: rich (>=14.1.0,<15.0.0)
-Description-Content-Type: text/markdown
-
 # **Bigeye CLI**
-Version: 0.7.4
+Version: 0.8.0
 ## Installation
 
 **Setting up your local/build environment**  
@@ -735,6 +716,7 @@ $ bigeye catalog [OPTIONS] COMMAND [ARGS]...
 * `ingest-dbt-core-run-info`: Ingest manifest.json and run_results.json...
 * `track-schema-changes`: Track schema changes for sources on demand...
 * `sync-custom-repository`: Sync a custom repository from a YAML file.
+* `custom-repo`: Import and export custom repositories as...
 
 ## `bigeye catalog regen-autometrics`
 
@@ -1287,6 +1269,102 @@ $ bigeye catalog sync-custom-repository [OPTIONS]
 * `-ip, --input_path TEXT`: The path to the CUSTOM_REPOSITORY_CONFIGURATION file (Required)
 * `--help`: Show this message and exit.
 
+## `bigeye catalog custom-repo`
+
+Import and export custom repositories as Excel (.xlsx) workbooks.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `init`: Generate a blank custom repository...
+* `import`: Import a custom repository from an Excel...
+* `export`: Export a custom repository to an Excel...
+* `delete`: Entirely delete a custom repository,...
+
+### `bigeye catalog custom-repo init`
+
+Generate a blank custom repository workbook (branded, with the Instructions
+sheet and dropdowns) for you to populate, then import with `custom-repo import`.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo init [OPTIONS]
+```
+
+**Options**:
+
+* `-o, --output TEXT`: Output .xlsx path for the blank template.  [default: custom_repo_template.xlsx]
+* `--force`: Overwrite the output file if it already exists.
+* `--help`: Show this message and exit.
+
+### `bigeye catalog custom-repo import`
+
+Import a custom repository from an Excel workbook.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo import [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `-f, --file TEXT`: Path to the custom repository .xlsx workbook.  [required]
+* `--cleanup-stale`: Delete nodes/edges present in Bigeye but missing from the sheet. Off by default.
+* `--help`: Show this message and exit.
+
+### `bigeye catalog custom-repo export`
+
+Export a custom repository to an Excel workbook.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo export [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--repo-name TEXT`: Display name of the custom repository to export.  [required]
+* `-o, --output TEXT`: Output .xlsx path. Defaults to &lt;repo-name&gt;.xlsx in the current directory.
+* `--help`: Show this message and exit.
+
+### `bigeye catalog custom-repo delete`
+
+Entirely delete a custom repository, including its nodes, edges, node types,
+and integration type.
+
+**Usage**:
+
+```console
+$ bigeye catalog custom-repo delete [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--repo-name TEXT`: Display name of the custom repository to delete.  [required]
+* `-y, --yes`: Skip the confirmation prompt.
+* `--help`: Show this message and exit.
+
 # `bigeye metric`
 
 Metric Commands for Bigeye CLI
@@ -1792,6 +1870,8 @@ $ bigeye lineage [OPTIONS] COMMAND [ARGS]...
 * `create-relation`: Create a lineage relationship for 2 entities
 * `delete-relation`: Deletes a single relationship based on...
 * `infer-relations`: Given an upstream and downstream path,...
+* `export-graphs`: Bulk-export lineage graphs for a list of...
+* `export-end-to-end`: Export complete end-to-end lineage paths...
 
 ## `bigeye lineage create-node`
 
@@ -1893,4 +1973,56 @@ $ bigeye lineage infer-relations [OPTIONS]
 * `-purge, --purge_lineage`: Purge all lineage edges.
 * `--help`: Show this message and exit.
 
+## `bigeye lineage export-graphs`
+
+Bulk-export lineage graphs for a list of FQNs into a single zip.
+
+Reads fully-qualified catalog names from a CSV, downloads each one&#x27;s lineage graph,
+and writes one folder per FQN (nodes/edges/attributes) plus a top-level manifest of
+successes and failures.
+
+**Usage**:
+
+```console
+$ bigeye lineage export-graphs [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--fqns-file TEXT`: Path to a CSV with a single column of fully-qualified catalog names.  [required]
+* `--direction [upstream|downstream|both]`: Direction to traverse: upstream, downstream, or both.  [default: both]
+* `--content [all|nodes|edges|attributes]`: What each per-graph report contains: all, nodes, edges, or attributes.  [default: all]
+* `--include-etl / --no-include-etl`: Include or exclude ETL operator nodes. Defaults to including them.  [default: include-etl]
+* `-o, --output TEXT`: Output .zip path. Defaults to lineage_graphs.zip in the current directory.
+* `--help`: Show this message and exit.
+
+## `bigeye lineage export-end-to-end`
+
+Export complete end-to-end lineage paths for one or more roots into a CSV.
+
+Each row is one full lineage path and each Hop_* column is one object along it;
+the CSV widens to the longest path discovered. Only lineage edges become hops,
+collapsed to the chosen (or root-inferred) granularity — column/field hops roll
+up to their containing table/object (warehouse tables, ETL targets, BI objects).
+
+**Usage**:
+
+```console
+$ bigeye lineage export-end-to-end [OPTIONS]
+```
+
+**Options**:
+
+* `-b, --bigeye_conf TEXT`: Bigeye Credential File Path  [env var: BIGEYE_API_CRED_FILE]
+* `-c, --config_file TEXT`: Bigeye CLI Configuration File Path  [env var: BIGEYE_API_CONFIG_FILE]
+* `-w, --workspace TEXT`: Name of the workspace configuration.  [env var: BIGEYE_WORKSPACE; default: DEFAULT]
+* `--root TEXT`: A starting point: a schema/table/column warehouse FQN or a custom node identifier. Repeatable to trace several roots into one CSV.  [required]
+* `--direction [upstream|downstream|both]`: Direction to trace: upstream, downstream, or both.  [default: both]
+* `--granularity [schema|table|column]`: Hop level: schema, table, or column. Defaults to each root&#x27;s own level.
+* `--max-paths INTEGER`: Per-root cap on enumerated paths. Truncation is logged, never silent.  [default: 10000]
+* `-o, --output TEXT`: Output .csv path. Defaults to end_to_end_&lt;root&gt;.csv in the current directory.
+* `--help`: Show this message and exit.
 

{bigeye_cli-0.7.4 → bigeye_cli-0.8.0}/bigeye_cli/catalog/catalog_commands.py

@@ -17,6 +17,7 @@ from bigeye_cli.exceptions.exceptions import MissingArgumentException
 from bigeye_sdk.client.enum import Method
 
 from bigeye_cli import global_options
+from bigeye_cli.catalog import custom_repo_commands
 from bigeye_sdk.controller.custom_repository_controller import CustomRepositoryController
 from bigeye_sdk.functions.dbt import parse_dbt_manifest
 from bigeye_sdk.functions.file_functs import read_json_file
@@ -65,6 +66,7 @@ from bigeye_sdk.model.schema_change import SourceSchemaChange
 log = get_logger(__file__)
 
 app = typer.Typer(no_args_is_help=True, help="Catalog Commands for Bigeye CLI")
+app.add_typer(custom_repo_commands.app, name="custom-repo")
 
 """
 File should contain commands that will impact catalog, table, or schema level changes to a Bigeye workspace.  This

bigeye_cli-0.8.0/bigeye_cli/catalog/custom_repo_commands.py

@@ -0,0 +1,216 @@
+import os
+from typing import Dict, List, Optional, Tuple
+
+import typer
+
+from bigeye_cli import global_options
+from bigeye_cli.functions import cli_client_factory
+from bigeye_sdk.controller.custom_repository_controller import CustomRepositoryController
+from bigeye_sdk.log import get_logger
+from bigeye_sdk.model.custom_repository_excel import (
+    SHEET_EDGES,
+    CustomRepoWorkbook,
+    EdgeEndpointType,
+    WorkbookValidationError,
+    build_config,
+    iter_path_endpoints,
+    parse_catalog_path,
+    read_workbook,
+    validate_workbook,
+    write_workbook,
+)
+
+log = get_logger(__file__)
+
+app = typer.Typer(
+    no_args_is_help=True,
+    help="Import and export custom repositories as Excel (.xlsx) workbooks.",
+)
+
+
+def _print_errors(header: str, errors: List[WorkbookValidationError]) -> None:
+    typer.echo(f"{header} with {len(errors)} error(s):", err=True)
+    for error in errors:
+        typer.echo(f"  {error.format()}", err=True)
+
+
+def _resolve_paths(
+    wb: CustomRepoWorkbook, controller: CustomRepositoryController
+) -> Tuple[Dict[str, int], List[WorkbookValidationError]]:
+    """Resolve every catalog-path/FQN edge endpoint to a node_id, aggregating failures."""
+    resolved: Dict[str, int] = {}
+    errors: List[WorkbookValidationError] = []
+    endpoints = iter_path_endpoints(wb)
+    # Bulk-load every referenced warehouse object up front so the per-endpoint
+    # resolution below is a cache lookup rather than several API calls each.
+    controller.warm_warehouse_cache(endpoints)
+    for endpoint_type, value in endpoints:
+        if endpoint_type == EdgeEndpointType.CUSTOM.value:
+            matches = controller.resolve_catalog_path(parse_catalog_path(value))
+        else:
+            matches = controller.resolve_warehouse_fqn(endpoint_type, value)
+        if not matches:
+            errors.append(
+                WorkbookValidationError(
+                    SHEET_EDGES, "Could not resolve endpoint to a Bigeye node", value=value
+                )
+            )
+        elif len(matches) > 1:
+            errors.append(
+                WorkbookValidationError(
+                    SHEET_EDGES,
+                    f"Endpoint is ambiguous (matched node_ids {matches})",
+                    value=value,
+                )
+            )
+        else:
+            resolved[value] = matches[0]
+    return resolved, errors
+
+
+@app.command(name="init")
+def init_repo(
+    output: str = typer.Option(
+        "custom_repo_template.xlsx",
+        "--output",
+        "-o",
+        help="Output .xlsx path for the blank template.",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        help="Overwrite the output file if it already exists.",
+    ),
+):
+    """Generate a blank custom repository workbook (branded, with the Instructions
+    sheet and dropdowns) for you to populate, then import with `custom-repo import`."""
+    if os.path.exists(output) and not force:
+        typer.echo(
+            f"'{output}' already exists. Choose a different --output or pass --force to overwrite.",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    write_workbook(CustomRepoWorkbook(repo_name=""), output)
+    log.info(f"Wrote blank custom repository template to {output}")
+
+
+@app.command(name="import")
+def import_repo(
+    bigeye_conf: str = global_options.bigeye_conf,
+    config_file: str = global_options.config_file,
+    workspace: str = global_options.workspace,
+    file: str = typer.Option(
+        ..., "--file", "-f", help="Path to the custom repository .xlsx workbook."
+    ),
+    cleanup_stale: bool = typer.Option(
+        False,
+        "--cleanup-stale",
+        help="Delete nodes/edges present in Bigeye but missing from the sheet. Off by default.",
+    ),
+):
+    """Import a custom repository from an Excel workbook."""
+    client = cli_client_factory(bigeye_conf, config_file, workspace)
+    controller = CustomRepositoryController(client)
+
+    try:
+        wb = read_workbook(file)
+    except (FileNotFoundError, ValueError) as e:
+        typer.echo(f"Could not read workbook '{file}': {e}", err=True)
+        raise typer.Exit(code=1)
+
+    validation_errors = validate_workbook(wb)
+    if validation_errors:
+        _print_errors("Import validation failed", validation_errors)
+        raise typer.Exit(code=1)
+
+    path_node_ids, unresolved = _resolve_paths(wb, controller)
+    if unresolved:
+        _print_errors("Could not resolve all catalog path references", unresolved)
+        raise typer.Exit(code=1)
+
+    config = build_config(wb, path_node_ids=path_node_ids, cleanup_stale=cleanup_stale)
+    result = controller.sync_from_config(config, wait_for_completion=True)
+
+    log.info(
+        f"Sync complete for '{wb.repo_name}': {result.nodes_synced} nodes, "
+        f"{result.edges_synced} edges submitted."
+    )
+    if result.edges_dropped:
+        log.warning(f"{result.edges_dropped} edge(s) dropped during sync:")
+        for reason in result.dropped_edge_reasons:
+            log.warning(f"  - {reason}")
+
+
+@app.command(name="export")
+def export_repo(
+    bigeye_conf: str = global_options.bigeye_conf,
+    config_file: str = global_options.config_file,
+    workspace: str = global_options.workspace,
+    repo_name: str = typer.Option(
+        ..., "--repo-name", help="Display name of the custom repository to export."
+    ),
+    output: Optional[str] = typer.Option(
+        None,
+        "--output",
+        "-o",
+        help="Output .xlsx path. Defaults to <repo-name>.xlsx in the current directory.",
+    ),
+):
+    """Export a custom repository to an Excel workbook."""
+    client = cli_client_factory(bigeye_conf, config_file, workspace)
+    controller = CustomRepositoryController(client)
+
+    try:
+        wb = controller.export_repository(repo_name)
+    except ValueError as e:
+        typer.echo(str(e), err=True)
+        raise typer.Exit(code=1)
+
+    output_path = output or f"{repo_name}.xlsx"
+    write_workbook(wb, output_path)
+    log.info(
+        f"Exported repository '{repo_name}' to {output_path} "
+        f"({len(wb.nodes)} nodes, {len(wb.edges)} edges)."
+    )
+
+
+@app.command(name="delete")
+def delete_repo(
+    bigeye_conf: str = global_options.bigeye_conf,
+    config_file: str = global_options.config_file,
+    workspace: str = global_options.workspace,
+    repo_name: str = typer.Option(
+        ..., "--repo-name", help="Display name of the custom repository to delete."
+    ),
+    yes: bool = typer.Option(
+        False,
+        "--yes",
+        "-y",
+        help="Skip the confirmation prompt.",
+    ),
+):
+    """Entirely delete a custom repository, including its nodes, edges, node types,
+    and integration type."""
+    client = cli_client_factory(bigeye_conf, config_file, workspace)
+    controller = CustomRepositoryController(client)
+
+    if not yes:
+        typer.confirm(
+            f"Permanently delete custom repository '{repo_name}' and all its nodes, "
+            f"edges, node types, and integration type?",
+            abort=True,
+        )
+
+    try:
+        result = controller.delete_repository(repo_name)
+    except ValueError as e:
+        typer.echo(str(e), err=True)
+        raise typer.Exit(code=1)
+
+    summary = f"Deleted custom repository '{result.repository_name}' (id {result.repository_id})"
+    if result.integration_type_deleted:
+        summary += f", its integration type, and {result.node_types_deleted} node type(s)"
+    else:
+        summary += " (integration type retained — shared by another repository)"
+    log.info(summary + ".")

{bigeye_cli-0.7.4 → bigeye_cli-0.8.0}/bigeye_cli/lineage/lineage_commands.py

@@ -8,10 +8,23 @@ from bigeye_cli.exceptions.exceptions import InvalidEntityException
 from bigeye_cli.functions import cli_client_factory
 from bigeye_cli import global_options
 from bigeye_sdk.controller.lineage_controller import LineageController
+from bigeye_sdk.controller.lineage_custom_reporting_controller import LineageCustomReporting
 from bigeye_sdk.model.enums import MatchType
 from bigeye_sdk.log import get_logger
 from bigeye_sdk.model.lineage_facade import LineageConfigurationFile, SimpleLineageConfigurationFile, \
     LineageColumnOverride
+from bigeye_sdk.model.lineage_end_to_end import (
+    DEFAULT_MAX_PATHS,
+    EndToEndDirection,
+    Granularity,
+    default_output_filename,
+)
+from bigeye_sdk.model.lineage_graph_export import (
+    MANIFEST_FILENAME,
+    GraphContent,
+    GraphDirection,
+    read_fqns_file,
+)
 
 log = get_logger(__file__)
 
@@ -224,3 +237,135 @@ def infer_relations(
             tables=matching_tables,
             purge_lineage=purge_lineage
         )
+
+
+@app.command(name="export-graphs")
+def export_graphs(
+        bigeye_conf: str = global_options.bigeye_conf,
+        config_file: str = global_options.config_file,
+        workspace: str = global_options.workspace,
+        fqns_file: str = typer.Option(
+            ...,
+            "--fqns-file",
+            help="Path to a CSV with a single column of fully-qualified catalog names.",
+        ),
+        direction: GraphDirection = typer.Option(
+            GraphDirection.BOTH,
+            "--direction",
+            help="Direction to traverse: upstream, downstream, or both.",
+            case_sensitive=False,
+        ),
+        content: GraphContent = typer.Option(
+            GraphContent.ALL,
+            "--content",
+            help="What each per-graph report contains: all, nodes, edges, or attributes.",
+            case_sensitive=False,
+        ),
+        include_etl: bool = typer.Option(
+            True,
+            "--include-etl/--no-include-etl",
+            help="Include or exclude ETL operator nodes. Defaults to including them.",
+        ),
+        output: Optional[str] = typer.Option(
+            None,
+            "--output",
+            "-o",
+            help="Output .zip path. Defaults to lineage_graphs.zip in the current directory.",
+        ),
+):
+    """Bulk-export lineage graphs for a list of FQNs into a single zip.
+
+    Reads fully-qualified catalog names from a CSV, downloads each one's lineage graph,
+    and writes one folder per FQN (nodes/edges/attributes) plus a top-level manifest of
+    successes and failures.
+    """
+    client = cli_client_factory(bigeye_conf, config_file, workspace)
+    controller = LineageCustomReporting(client)
+
+    try:
+        fqns = read_fqns_file(fqns_file)
+    except OSError as e:
+        typer.echo(f"Could not read FQNs file '{fqns_file}': {e}", err=True)
+        raise typer.Exit(code=1)
+
+    if not fqns:
+        typer.echo(f"No FQNs found in '{fqns_file}'.", err=True)
+        raise typer.Exit(code=1)
+
+    output_path = output or "lineage_graphs.zip"
+    summary = controller.export_graphs(
+        fqns=fqns,
+        direction=direction,
+        content=content,
+        include_etl=include_etl,
+        output_path=output_path,
+    )
+
+    log.info(
+        f"Exported {len(summary.succeeded)} of {len(fqns)} lineage graph(s) to "
+        f"{output_path} ({len(summary.failed)} failed). See {MANIFEST_FILENAME} in the zip."
+    )
+    for entry in summary.failed:
+        log.warning(f"  {entry.fqn}: {entry.error}")
+
+
+@app.command(name="export-end-to-end")
+def export_end_to_end(
+        bigeye_conf: str = global_options.bigeye_conf,
+        config_file: str = global_options.config_file,
+        workspace: str = global_options.workspace,
+        root: List[str] = typer.Option(
+            ...,
+            "--root",
+            help="A starting point: a schema/table/column warehouse FQN or a custom node "
+                 "identifier. Repeatable to trace several roots into one CSV.",
+        ),
+        direction: EndToEndDirection = typer.Option(
+            EndToEndDirection.BOTH,
+            "--direction",
+            help="Direction to trace: upstream, downstream, or both.",
+            case_sensitive=False,
+        ),
+        granularity: Optional[Granularity] = typer.Option(
+            None,
+            "--granularity",
+            help="Hop level: schema, table, or column. Defaults to each root's own level.",
+            case_sensitive=False,
+        ),
+        max_paths: int = typer.Option(
+            DEFAULT_MAX_PATHS,
+            "--max-paths",
+            help="Per-root cap on enumerated paths. Truncation is logged, never silent.",
+        ),
+        output: Optional[str] = typer.Option(
+            None,
+            "--output",
+            "-o",
+            help="Output .csv path. Defaults to end_to_end_<root>.csv in the current directory.",
+        ),
+):
+    """Export complete end-to-end lineage paths for one or more roots into a CSV.
+
+    Each row is one full lineage path and each Hop_* column is one object along it;
+    the CSV widens to the longest path discovered. Only lineage edges become hops,
+    collapsed to the chosen (or root-inferred) granularity — column/field hops roll
+    up to their containing table/object (warehouse tables, ETL targets, BI objects).
+    """
+    client = cli_client_factory(bigeye_conf, config_file, workspace)
+    controller = LineageCustomReporting(client)
+
+    output_path = output or default_output_filename(root)
+    summary = controller.export_end_to_end(
+        roots=root,
+        direction=direction,
+        granularity=granularity,
+        output_path=output_path,
+        max_paths=max_paths,
+    )
+
+    log.info(
+        f"Wrote {len(summary.rows)} lineage path(s) for {len(summary.succeeded)} of "
+        f"{len(root)} root(s) to {output_path} ({len(summary.failed)} failed)."
+    )
+    for result in summary.failed:
+        log.warning(f"  {result.root}: {result.error}")

{bigeye_cli-0.7.4 → bigeye_cli-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "bigeye-cli"
-version = "0.7.4"
+version = "0.8.0"
 description = "Bigeye CLI offers developer tools for maintaining your developer workspace."
 license = "Proprietary"
 authors = ["Bigeye <support@bigeye.com>"]
@@ -19,7 +19,7 @@ bigeye = "bigeye_cli.__main__:app"
 [tool.poetry.dependencies]
 python = "^3.11.0"
 click = "^8.1.8"
-bigeye-sdk = "^0.8.0"
+bigeye-sdk = "^0.10.0"
 rich = "^14.1.0"
 PyGithub = '^1.59.1'