Merge branch 'DOCS---Ambiguous-description-in-pandas.DataFrame.to_parquet-documentation-pandas-dev#19662'

Author: giba0

pandas/core/frame.py

@@ -1678,9 +1678,10 @@ def to_parquet(self, fname, engine='auto', compression='snappy',
         fname : str
             string file path
         engine : {'auto', 'pyarrow', 'fastparquet'}, default 'auto'
-            Parquet reader library to use. If 'auto', then the option
-            'io.parquet.engine' is used. If 'auto', then the first
-            library to be installed is used.
+            Parquet library to use. If 'auto', the value from
+            ``io.parquet.engine`` is used. The default ``io.parquet.engine``
+            behavior is to try 'pyarrow', falling back to 'fastparquet' if
+            'pyarrow' is unavailable.
         compression : {'snappy', 'gzip', 'brotli', None}, default 'snappy'
             Name of the compression to use. Use ``None`` for no compression.
         kwargs
@@ -2614,7 +2615,7 @@ def _ensure_valid_index(self, value):
         if not len(self.index) and is_list_like(value):
             try:
                 value = Series(value)
-            except:
+            except ValueError:
                 raise ValueError('Cannot set a frame with no defined index '
                                  'and a value that cannot be converted to a '
                                  'Series')

pandas/io/parquet.py

@@ -236,9 +236,10 @@ def to_parquet(df, path, engine='auto', compression='snappy', **kwargs):
     path : string
         File path
     engine : {'auto', 'pyarrow', 'fastparquet'}, default 'auto'
-        Parquet reader library to use. If 'auto', then the option
-        'io.parquet.engine' is used. If 'auto', then the first
-        library to be installed is used.
+        Parquet library to use. If 'auto', the value from
+        ``io.parquet.engine`` is used. The default ``io.parquet.engine``
+        behavior is to try 'pyarrow', falling back to 'fastparquet' if
+        'pyarrow' is unavailable.
     compression : {'snappy', 'gzip', 'brotli', None}, default 'snappy'
         Name of the compression to use. Use ``None`` for no compression.
     kwargs
@@ -263,9 +264,10 @@ def read_parquet(path, engine='auto', columns=None, **kwargs):
 
         .. versionadded 0.21.1
     engine : {'auto', 'pyarrow', 'fastparquet'}, default 'auto'
-        Parquet reader library to use. If 'auto', then the option
-        'io.parquet.engine' is used. If 'auto', then the first
-        library to be installed is used.
+        Parquet library to use. If 'auto', the value from
+        ``io.parquet.engine`` is used. The default ``io.parquet.engine``
+        behavior is to try 'pyarrow', falling back to 'fastparquet' if
+        'pyarrow' is unavailable.
     kwargs are passed to the engine
 
     Returns