venv added, updated

myenv/lib/python3.12/site-packages/influxdb_client/client/warnings.py

@@ -0,0 +1,52 @@
+"""The warnings message definition."""
+import warnings
+
+
+class MissingPivotFunction(UserWarning):
+    """User warning about missing pivot() function."""
+
+    @staticmethod
+    def print_warning(query: str):
+        """Print warning about missing pivot() function and how to deal with that."""
+        if 'fieldsAsCols' in query or 'pivot' in query:
+            return
+
+        message = f"""The query doesn't contains the pivot() function.
+
+The result will not be shaped to optimal processing by pandas.DataFrame. Use the pivot() function by:
+
+    {query} |> pivot(rowKey:["_time"], columnKey: ["_field"], valueColumn: "_value")
+
+You can disable this warning by:
+    import warnings
+    from influxdb_client.client.warnings import MissingPivotFunction
+
+    warnings.simplefilter("ignore", MissingPivotFunction)
+
+For more info see:
+    - https://docs.influxdata.com/resources/videos/pivots-in-flux/
+    - https://docs.influxdata.com/flux/latest/stdlib/universe/pivot/
+    - https://docs.influxdata.com/flux/latest/stdlib/influxdata/influxdb/schema/fieldsascols/
+"""
+        warnings.warn(message, MissingPivotFunction)
+
+
+class CloudOnlyWarning(UserWarning):
+    """User warning about availability only on the InfluxDB Cloud."""
+
+    @staticmethod
+    def print_warning(api_name: str, doc_url: str):
+        """Print warning about availability only on the InfluxDB Cloud."""
+        message = f"""The '{api_name}' is available only on the InfluxDB Cloud.
+
+For more info see:
+    - {doc_url}
+    - https://docs.influxdata.com/influxdb/cloud/
+
+You can disable this warning by:
+    import warnings
+    from influxdb_client.client.warnings import CloudOnlyWarning
+
+    warnings.simplefilter("ignore", CloudOnlyWarning)
+"""
+        warnings.warn(message, CloudOnlyWarning)