Excel skip blank lines

doc/source/whatsnew/v1.3.0.rst

@@ -414,6 +414,7 @@ I/O
 - :meth:`read_sql` returned an empty generator if ``chunksize`` was no-zero and the query returned no results. Now returns a generator with a single empty dataframe (:issue:`34411`)
 - Bug in :func:`read_hdf` returning unexpected records when filtering on categorical string columns using ``where`` parameter (:issue:`39189`)
 - Bug in :func:`read_sas` raising ``ValueError`` when ``datetimes`` were null (:issue:`39725`)
+- Bug in :func:`read_excel` not accepting ``skip_blank_lines`` argument (:issue:`39808`)
 
 Period
 ^^^^^^

pandas/io/excel/_base.py

@@ -204,6 +204,9 @@
     Detect missing value markers (empty strings and the value of na_values). In
     data without any NAs, passing na_filter=False can improve the performance
     of reading a large file.
+skip_blank_lines : bool, default True
+    If True, skip over blank lines in single-column spreadsheets rather than
+    interpreting as NaN values.
 verbose : bool, default False
     Indicate number of NA values placed in non-numeric columns.
 parse_dates : bool, list-like, or dict, default False
@@ -352,6 +355,7 @@ def read_excel(
     na_values=None,
     keep_default_na=True,
     na_filter=True,
+    skip_blank_lines=True,
     verbose=False,
     parse_dates=False,
     date_parser=None,
@@ -390,6 +394,7 @@ def read_excel(
             na_values=na_values,
             keep_default_na=keep_default_na,
             na_filter=na_filter,
+            skip_blank_lines=skip_blank_lines,
             verbose=verbose,
             parse_dates=parse_dates,
             date_parser=date_parser,
@@ -486,6 +491,7 @@ def parse(
         skiprows=None,
         nrows=None,
         na_values=None,
+        skip_blank_lines=True,
         verbose=False,
         parse_dates=False,
         date_parser=None,
@@ -598,6 +604,7 @@ def parse(
                     skiprows=skiprows,
                     nrows=nrows,
                     na_values=na_values,
+                    skip_blank_lines=skip_blank_lines,
                     parse_dates=parse_dates,
                     date_parser=date_parser,
                     thousands=thousands,
@@ -1166,6 +1173,7 @@ def parse(
         skiprows=None,
         nrows=None,
         na_values=None,
+        skip_blank_lines=True,
         parse_dates=False,
         date_parser=None,
         thousands=None,
@@ -1199,6 +1207,7 @@ def parse(
             skiprows=skiprows,
             nrows=nrows,
             na_values=na_values,
+            skip_blank_lines=skip_blank_lines,
             parse_dates=parse_dates,
             date_parser=date_parser,
             thousands=thousands,

pandas/tests/io/excel/test_readers.py

@@ -1185,6 +1185,20 @@ def test_no_header_with_list_index_col(self, read_ext):
         )
         tm.assert_frame_equal(expected, result)
 
+    def test_one_col_skip_blank_line(self, read_ext):
+        file_name = "one_col_blank_line" + read_ext
+        data = [0.5, 1, 2]
+        expected = DataFrame(data, columns=["numbers"])
+        result = pd.read_excel(file_name)
+        tm.assert_frame_equal(expected, result)
+
+    def test_one_col_noskip_blank_line(self, read_ext):
+        file_name = "one_col_blank_line" + read_ext
+        data = [0.5, np.nan, 1, 2]
+        expected = DataFrame(data, columns=["numbers"])
+        result = pd.read_excel(file_name, skip_blank_lines=False)
+        tm.assert_frame_equal(expected, result)
+
 
 class TestExcelFileRead:
     @pytest.fixture(autouse=True)