pycarlo 0.12.330__tar.gz → 0.12.332__tar.gz

{pycarlo-0.12.330 → pycarlo-0.12.332}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pycarlo
-Version: 0.12.330
+Version: 0.12.332
 Summary: Monte Carlo's Python SDK
 Home-page: https://www.montecarlodata.com/
 Author: Monte Carlo Data, Inc

{pycarlo-0.12.330 → pycarlo-0.12.332}/pycarlo/lib/schema.json

@@ -6449,6 +6449,67 @@
                 "ofType": null
               }
             },
+            {
+              "args": [
+                {
+                  "defaultValue": null,
+                  "description": "SQL query to parse",
+                  "name": "query",
+                  "type": {
+                    "kind": "NON_NULL",
+                    "name": null,
+                    "ofType": {
+                      "kind": "SCALAR",
+                      "name": "String",
+                      "ofType": null
+                    }
+                  }
+                },
+                {
+                  "defaultValue": null,
+                  "description": "Candidate log_types (push resource_type values) to try, 1..15 entries.",
+                  "name": "logTypes",
+                  "type": {
+                    "kind": "NON_NULL",
+                    "name": null,
+                    "ofType": {
+                      "kind": "LIST",
+                      "name": null,
+                      "ofType": {
+                        "kind": "NON_NULL",
+                        "name": null,
+                        "ofType": {
+                          "kind": "SCALAR",
+                          "name": "String",
+                          "ofType": null
+                        }
+                      }
+                    }
+                  }
+                }
+              ],
+              "deprecationReason": null,
+              "description": "(experimental) For each candidate log_type, returns the sources and destination Monte Carlo's SQL parser would extract from the query. Useful for push-ingestion customers comparing extraction across log_types before committing to one for POST /ingest/v1/querylogs \u2014 pick the one whose lineage matches your real data flow. The alias 'generic' maps to the transactional-db dialect for warehouses that do not have a dedicated parser. Parser behavior mirrors production push ingestion: Rust SQL parser first, Java Presto parser fallback on Rust error or timeout. So the lineage shown here is a faithful preview of what downstream OpenSearch will index for the same payload \u2014 not a dialect-strictness check. If every log_type returns the same lineage for a query, that's genuine 'any of these will work' news; if they diverge, you pick the one whose extraction matches your intent. Scope note: this is a pre-decision discovery tool. It does not perform MCON resolution \u2014 use ``parseQuery`` with a chosen ``resourceId`` for that, once a log_type has been picked.",
+              "isDeprecated": false,
+              "name": "parseQueryForLogTypes",
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "LIST",
+                  "name": null,
+                  "ofType": {
+                    "kind": "NON_NULL",
+                    "name": null,
+                    "ofType": {
+                      "kind": "OBJECT",
+                      "name": "LogTypeParseResult",
+                      "ofType": null
+                    }
+                  }
+                }
+              }
+            },
             {
               "args": [
                 {
@@ -127672,6 +127733,101 @@
           "name": "SqlParsedTable",
           "possibleTypes": null
         },
+        {
+          "description": null,
+          "enumValues": null,
+          "fields": [
+            {
+              "args": [],
+              "deprecationReason": null,
+              "description": "The candidate log_type this result corresponds to, echoed from the input (e.g. 'snowflake', 'bigquery', 'generic').",
+              "isDeprecated": false,
+              "name": "logType",
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "String",
+                  "ofType": null
+                }
+              }
+            },
+            {
+              "args": [],
+              "deprecationReason": null,
+              "description": "Parsed query sources for this log_type. ``mcon`` is always null here \u2014 this API does not perform table resolution. Call ``parseQuery`` with a chosen ``resourceId`` once the right dialect has been identified to get MCONs.",
+              "isDeprecated": false,
+              "name": "sources",
+              "type": {
+                "kind": "LIST",
+                "name": null,
+                "ofType": {
+                  "kind": "NON_NULL",
+                  "name": null,
+                  "ofType": {
+                    "kind": "OBJECT",
+                    "name": "SqlParsedTable",
+                    "ofType": null
+                  }
+                }
+              }
+            },
+            {
+              "args": [],
+              "deprecationReason": null,
+              "description": "Parsed query destination for this log_type. ``mcon`` is always null here \u2014 see the note on ``sources``.",
+              "isDeprecated": false,
+              "name": "destination",
+              "type": {
+                "kind": "OBJECT",
+                "name": "SqlParsedTable",
+                "ofType": null
+              }
+            },
+            {
+              "args": [],
+              "deprecationReason": null,
+              "description": "SQL parser errors for this log_type",
+              "isDeprecated": false,
+              "name": "errors",
+              "type": {
+                "kind": "LIST",
+                "name": null,
+                "ofType": {
+                  "kind": "NON_NULL",
+                  "name": null,
+                  "ofType": {
+                    "kind": "SCALAR",
+                    "name": "String",
+                    "ofType": null
+                  }
+                }
+              }
+            },
+            {
+              "args": [],
+              "deprecationReason": null,
+              "description": "True when the parser returned no errors and at least one source or a destination was parsed for this log_type.",
+              "isDeprecated": false,
+              "name": "success",
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Boolean",
+                  "ofType": null
+                }
+              }
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [],
+          "kind": "OBJECT",
+          "name": "LogTypeParseResult",
+          "possibleTypes": null
+        },
         {
           "description": "Describes the result of pinging a data collector.",
           "enumValues": null,
@@ -155950,6 +156106,16 @@
                 "ofType": null
               }
             },
+            {
+              "defaultValue": null,
+              "description": "Return only findings whose parent finding has this UUID.",
+              "name": "parentFindingUuid",
+              "type": {
+                "kind": "SCALAR",
+                "name": "UUID",
+                "ofType": null
+              }
+            },
             {
               "defaultValue": null,
               "description": null,
@@ -155989,6 +156155,16 @@
                 "name": "DateTime",
                 "ofType": null
               }
+            },
+            {
+              "defaultValue": null,
+              "description": "Order of results by detection_time. Defaults to DESC (newest first).",
+              "name": "detectionTimeOrder",
+              "type": {
+                "kind": "ENUM",
+                "name": "FindingSortDirection",
+                "ofType": null
+              }
             }
           ],
           "interfaces": null,
@@ -155996,6 +156172,29 @@
           "name": "FindingFilterInput",
           "possibleTypes": null
         },
+        {
+          "description": null,
+          "enumValues": [
+            {
+              "deprecationReason": null,
+              "description": null,
+              "isDeprecated": false,
+              "name": "ASC"
+            },
+            {
+              "deprecationReason": null,
+              "description": null,
+              "isDeprecated": false,
+              "name": "DESC"
+            }
+          ],
+          "fields": null,
+          "inputFields": null,
+          "interfaces": null,
+          "kind": "ENUM",
+          "name": "FindingSortDirection",
+          "possibleTypes": null
+        },
         {
           "description": null,
           "enumValues": null,

{pycarlo-0.12.330 → pycarlo-0.12.332}/pycarlo/lib/schema.py

@@ -3487,6 +3487,17 @@ class FindingSeverity(pycarlo.lib.types.Enum):
     __choices__ = ("CRITICAL", "INFO", "WARNING")
 
 
+class FindingSortDirection(pycarlo.lib.types.Enum):
+    """Enumeration Choices:
+
+    * `ASC`None
+    * `DESC`None
+    """
+
+    __schema__ = schema
+    __choices__ = ("ASC", "DESC")
+
+
 class FindingStatus(pycarlo.lib.types.Enum):
     """Enumeration Choices:
 
@@ -9619,10 +9630,12 @@ class FindingFilterInput(sgqlc.types.Input):
         "agentic_scope_uuids",
         "use_cases",
         "asset_mcon",
+        "parent_finding_uuid",
         "search_query",
         "needs_attention",
         "detection_time_start",
         "detection_time_end",
+        "detection_time_order",
     )
     finding_types = sgqlc.types.Field(
         sgqlc.types.list_of(sgqlc.types.non_null(FindingType)), graphql_name="findingTypes"
@@ -9650,6 +9663,9 @@ class FindingFilterInput(sgqlc.types.Input):
 
     asset_mcon = sgqlc.types.Field(String, graphql_name="assetMcon")
 
+    parent_finding_uuid = sgqlc.types.Field(UUID, graphql_name="parentFindingUuid")
+    """Return only findings whose parent finding has this UUID."""
+
     search_query = sgqlc.types.Field(String, graphql_name="searchQuery")
 
     needs_attention = sgqlc.types.Field(Boolean, graphql_name="needsAttention")
@@ -9658,6 +9674,13 @@ class FindingFilterInput(sgqlc.types.Input):
 
     detection_time_end = sgqlc.types.Field(DateTime, graphql_name="detectionTimeEnd")
 
+    detection_time_order = sgqlc.types.Field(
+        FindingSortDirection, graphql_name="detectionTimeOrder"
+    )
+    """Order of results by detection_time. Defaults to DESC (newest
+    first).
+    """
+
 
 class FreshnessAutomatedAlertConditionInput(sgqlc.types.Input):
     __schema__ = schema
@@ -31203,6 +31226,39 @@ class ListTagsOutput(sgqlc.types.Type):
     """Tags list."""
 
 
+class LogTypeParseResult(sgqlc.types.Type):
+    __schema__ = schema
+    __field_names__ = ("log_type", "sources", "destination", "errors", "success")
+    log_type = sgqlc.types.Field(sgqlc.types.non_null(String), graphql_name="logType")
+    """The candidate log_type this result corresponds to, echoed from the
+    input (e.g. 'snowflake', 'bigquery', 'generic').
+    """
+
+    sources = sgqlc.types.Field(
+        sgqlc.types.list_of(sgqlc.types.non_null("SqlParsedTable")), graphql_name="sources"
+    )
+    """Parsed query sources for this log_type. ``mcon`` is always null
+    here — this API does not perform table resolution. Call
+    ``parseQuery`` with a chosen ``resourceId`` once the right dialect
+    has been identified to get MCONs.
+    """
+
+    destination = sgqlc.types.Field("SqlParsedTable", graphql_name="destination")
+    """Parsed query destination for this log_type. ``mcon`` is always
+    null here — see the note on ``sources``.
+    """
+
+    errors = sgqlc.types.Field(
+        sgqlc.types.list_of(sgqlc.types.non_null(String)), graphql_name="errors"
+    )
+    """SQL parser errors for this log_type"""
+
+    success = sgqlc.types.Field(sgqlc.types.non_null(Boolean), graphql_name="success")
+    """True when the parser returned no errors and at least one source or
+    a destination was parsed for this log_type.
+    """
+
+
 class LoginDetails(sgqlc.types.Type):
     """Login information"""
 
@@ -56328,6 +56384,7 @@ class Query(sgqlc.types.Type):
         "get_domains_for_mcons",
         "get_data_product_dry_run_counts",
         "parse_query",
+        "parse_query_for_log_types",
         "ping_data_collector",
         "get_notebook",
         "get_notebooks",
@@ -60420,6 +60477,53 @@ class Query(sgqlc.types.Type):
     * `schema` (`String`): Name of schema to use for table resolution
     """
 
+    parse_query_for_log_types = sgqlc.types.Field(
+        sgqlc.types.non_null(sgqlc.types.list_of(sgqlc.types.non_null(LogTypeParseResult))),
+        graphql_name="parseQueryForLogTypes",
+        args=sgqlc.types.ArgDict(
+            (
+                (
+                    "query",
+                    sgqlc.types.Arg(
+                        sgqlc.types.non_null(String), graphql_name="query", default=None
+                    ),
+                ),
+                (
+                    "log_types",
+                    sgqlc.types.Arg(
+                        sgqlc.types.non_null(sgqlc.types.list_of(sgqlc.types.non_null(String))),
+                        graphql_name="logTypes",
+                        default=None,
+                    ),
+                ),
+            )
+        ),
+    )
+    """(experimental) For each candidate log_type, returns the sources
+    and destination Monte Carlo's SQL parser would extract from the
+    query. Useful for push-ingestion customers comparing extraction
+    across log_types before committing to one for POST
+    /ingest/v1/querylogs — pick the one whose lineage matches your
+    real data flow. The alias 'generic' maps to the transactional-db
+    dialect for warehouses that do not have a dedicated parser. Parser
+    behavior mirrors production push ingestion: Rust SQL parser first,
+    Java Presto parser fallback on Rust error or timeout. So the
+    lineage shown here is a faithful preview of what downstream
+    OpenSearch will index for the same payload — not a dialect-
+    strictness check. If every log_type returns the same lineage for a
+    query, that's genuine 'any of these will work' news; if they
+    diverge, you pick the one whose extraction matches your intent.
+    Scope note: this is a pre-decision discovery tool. It does not
+    perform MCON resolution — use ``parseQuery`` with a chosen
+    ``resourceId`` for that, once a log_type has been picked.
+
+    Arguments:
+
+    * `query` (`String!`): SQL query to parse
+    * `log_types` (`[String!]!`): Candidate log_types (push
+      resource_type values) to try, 1..15 entries.
+    """
+
     ping_data_collector = sgqlc.types.Field(
         DcPingResponse,
         graphql_name="pingDataCollector",

{pycarlo-0.12.330 → pycarlo-0.12.332}/pycarlo.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pycarlo
-Version: 0.12.330
+Version: 0.12.332
 Summary: Monte Carlo's Python SDK
 Home-page: https://www.montecarlodata.com/
 Author: Monte Carlo Data, Inc

{pycarlo-0.12.330 → pycarlo-0.12.332}/tests/data/schema_original.py

@@ -3486,6 +3486,17 @@ class FindingSeverity(sgqlc.types.Enum):
     __choices__ = ("CRITICAL", "INFO", "WARNING")
 
 
+class FindingSortDirection(sgqlc.types.Enum):
+    """Enumeration Choices:
+
+    * `ASC`None
+    * `DESC`None
+    """
+
+    __schema__ = schema
+    __choices__ = ("ASC", "DESC")
+
+
 class FindingStatus(sgqlc.types.Enum):
     """Enumeration Choices:
 
@@ -9618,10 +9629,12 @@ class FindingFilterInput(sgqlc.types.Input):
         "agentic_scope_uuids",
         "use_cases",
         "asset_mcon",
+        "parent_finding_uuid",
         "search_query",
         "needs_attention",
         "detection_time_start",
         "detection_time_end",
+        "detection_time_order",
     )
     finding_types = sgqlc.types.Field(
         sgqlc.types.list_of(sgqlc.types.non_null(FindingType)), graphql_name="findingTypes"
@@ -9649,6 +9662,9 @@ class FindingFilterInput(sgqlc.types.Input):
 
     asset_mcon = sgqlc.types.Field(String, graphql_name="assetMcon")
 
+    parent_finding_uuid = sgqlc.types.Field(UUID, graphql_name="parentFindingUuid")
+    """Return only findings whose parent finding has this UUID."""
+
     search_query = sgqlc.types.Field(String, graphql_name="searchQuery")
 
     needs_attention = sgqlc.types.Field(Boolean, graphql_name="needsAttention")
@@ -9657,6 +9673,13 @@ class FindingFilterInput(sgqlc.types.Input):
 
     detection_time_end = sgqlc.types.Field(DateTime, graphql_name="detectionTimeEnd")
 
+    detection_time_order = sgqlc.types.Field(
+        FindingSortDirection, graphql_name="detectionTimeOrder"
+    )
+    """Order of results by detection_time. Defaults to DESC (newest
+    first).
+    """
+
 
 class FreshnessAutomatedAlertConditionInput(sgqlc.types.Input):
     __schema__ = schema
@@ -31202,6 +31225,39 @@ class ListTagsOutput(sgqlc.types.Type):
     """Tags list."""
 
 
+class LogTypeParseResult(sgqlc.types.Type):
+    __schema__ = schema
+    __field_names__ = ("log_type", "sources", "destination", "errors", "success")
+    log_type = sgqlc.types.Field(sgqlc.types.non_null(String), graphql_name="logType")
+    """The candidate log_type this result corresponds to, echoed from the
+    input (e.g. 'snowflake', 'bigquery', 'generic').
+    """
+
+    sources = sgqlc.types.Field(
+        sgqlc.types.list_of(sgqlc.types.non_null("SqlParsedTable")), graphql_name="sources"
+    )
+    """Parsed query sources for this log_type. ``mcon`` is always null
+    here — this API does not perform table resolution. Call
+    ``parseQuery`` with a chosen ``resourceId`` once the right dialect
+    has been identified to get MCONs.
+    """
+
+    destination = sgqlc.types.Field("SqlParsedTable", graphql_name="destination")
+    """Parsed query destination for this log_type. ``mcon`` is always
+    null here — see the note on ``sources``.
+    """
+
+    errors = sgqlc.types.Field(
+        sgqlc.types.list_of(sgqlc.types.non_null(String)), graphql_name="errors"
+    )
+    """SQL parser errors for this log_type"""
+
+    success = sgqlc.types.Field(sgqlc.types.non_null(Boolean), graphql_name="success")
+    """True when the parser returned no errors and at least one source or
+    a destination was parsed for this log_type.
+    """
+
+
 class LoginDetails(sgqlc.types.Type):
     """Login information"""
 
@@ -56327,6 +56383,7 @@ class Query(sgqlc.types.Type):
         "get_domains_for_mcons",
         "get_data_product_dry_run_counts",
         "parse_query",
+        "parse_query_for_log_types",
         "ping_data_collector",
         "get_notebook",
         "get_notebooks",
@@ -60419,6 +60476,53 @@ class Query(sgqlc.types.Type):
     * `schema` (`String`): Name of schema to use for table resolution
     """
 
+    parse_query_for_log_types = sgqlc.types.Field(
+        sgqlc.types.non_null(sgqlc.types.list_of(sgqlc.types.non_null(LogTypeParseResult))),
+        graphql_name="parseQueryForLogTypes",
+        args=sgqlc.types.ArgDict(
+            (
+                (
+                    "query",
+                    sgqlc.types.Arg(
+                        sgqlc.types.non_null(String), graphql_name="query", default=None
+                    ),
+                ),
+                (
+                    "log_types",
+                    sgqlc.types.Arg(
+                        sgqlc.types.non_null(sgqlc.types.list_of(sgqlc.types.non_null(String))),
+                        graphql_name="logTypes",
+                        default=None,
+                    ),
+                ),
+            )
+        ),
+    )
+    """(experimental) For each candidate log_type, returns the sources
+    and destination Monte Carlo's SQL parser would extract from the
+    query. Useful for push-ingestion customers comparing extraction
+    across log_types before committing to one for POST
+    /ingest/v1/querylogs — pick the one whose lineage matches your
+    real data flow. The alias 'generic' maps to the transactional-db
+    dialect for warehouses that do not have a dedicated parser. Parser
+    behavior mirrors production push ingestion: Rust SQL parser first,
+    Java Presto parser fallback on Rust error or timeout. So the
+    lineage shown here is a faithful preview of what downstream
+    OpenSearch will index for the same payload — not a dialect-
+    strictness check. If every log_type returns the same lineage for a
+    query, that's genuine 'any of these will work' news; if they
+    diverge, you pick the one whose extraction matches your intent.
+    Scope note: this is a pre-decision discovery tool. It does not
+    perform MCON resolution — use ``parseQuery`` with a chosen
+    ``resourceId`` for that, once a log_type has been picked.
+
+    Arguments:
+
+    * `query` (`String!`): SQL query to parse
+    * `log_types` (`[String!]!`): Candidate log_types (push
+      resource_type values) to try, 1..15 entries.
+    """
+
     ping_data_collector = sgqlc.types.Field(
         DcPingResponse,
         graphql_name="pingDataCollector",