From a7c371f802d31e13b1d88e522a8e946d8904c626 Mon Sep 17 00:00:00 2001 From: Joeperdefloep Date: Sat, 26 Jun 2021 12:15:09 +0200 Subject: [PATCH 1/6] DOC: create folders in to_csv #24306 --- pandas/core/generic.py | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/pandas/core/generic.py b/pandas/core/generic.py index adc722e770cff..07660c4a8d8a8 100644 --- a/pandas/core/generic.py +++ b/pandas/core/generic.py @@ -3450,6 +3450,17 @@ def to_csv( ... archive_name='out.csv') # doctest: +SKIP >>> df.to_csv('out.zip', index=False, ... compression=compression_opts) # doctest: +SKIP + + Create 'out.csv' in a new folder 'folder/subfolder/' + + >>> import os + >>> os.mkdir('folder/subfolder', parents=True, exists_ok=True) + >>> df.to_csv('out.csv') + + >>> from pathlib import Path + >>> filepath = Path('folder/subfolder/out.csv') + >>> filepath.parent.mkdir(parents=True, exist_ok=True) + >>> df_to_csv(filepath) """ df = self if isinstance(self, ABCDataFrame) else self.to_frame() From cd0956eab78d5f2dde44476788cac1cd313bf75c Mon Sep 17 00:00:00 2001 From: Joeperdefloep Date: Tue, 7 Sep 2021 09:58:49 +0200 Subject: [PATCH 2/6] resolved comments --- pandas/core/generic.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pandas/core/generic.py b/pandas/core/generic.py index 34a6f5b1fb861..2b5c069546f5b 100644 --- a/pandas/core/generic.py +++ b/pandas/core/generic.py @@ -3454,13 +3454,13 @@ def to_csv( Create 'out.csv' in a new folder 'folder/subfolder/' >>> import os - >>> os.mkdir('folder/subfolder', parents=True, exists_ok=True) - >>> df.to_csv('out.csv') + >>> os.makedirs('folder/subfolder', exist_ok=True) + >>> df.to_csv('folder/subfolder/out.csv') >>> from pathlib import Path >>> filepath = Path('folder/subfolder/out.csv') >>> filepath.parent.mkdir(parents=True, exist_ok=True) - >>> df_to_csv(filepath) + >>> df.to_csv(filepath) """ df = self if isinstance(self, ABCDataFrame) else self.to_frame() From 380a51a57cee7f8d69ca31a702bad443695fbc62 Mon Sep 17 00:00:00 2001 From: Joeperdefloep Date: Tue, 7 Sep 2021 10:19:55 +0200 Subject: [PATCH 3/6] added links to external docs --- pandas/core/generic.py | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/pandas/core/generic.py b/pandas/core/generic.py index 2b5c069546f5b..4933c8388455b 100644 --- a/pandas/core/generic.py +++ b/pandas/core/generic.py @@ -3451,16 +3451,19 @@ def to_csv( >>> df.to_csv('out.zip', index=False, ... compression=compression_opts) # doctest: +SKIP - Create 'out.csv' in a new folder 'folder/subfolder/' - - >>> import os - >>> os.makedirs('folder/subfolder', exist_ok=True) - >>> df.to_csv('folder/subfolder/out.csv') + To write a csv file to a new folder or nested folder you will first + need to create it using either `Pathlib + ` + or `os `: >>> from pathlib import Path >>> filepath = Path('folder/subfolder/out.csv') >>> filepath.parent.mkdir(parents=True, exist_ok=True) >>> df.to_csv(filepath) + + >>> import os + >>> os.makedirs('folder/subfolder', exist_ok=True) + >>> df.to_csv('folder/subfolder/out.csv') """ df = self if isinstance(self, ABCDataFrame) else self.to_frame() From eb512dc0f589c0ef7c29b4f97d321b1aea5ba916 Mon Sep 17 00:00:00 2001 From: Joeperdefloep Date: Tue, 7 Sep 2021 10:40:45 +0200 Subject: [PATCH 4/6] fixed links --- file.xlsx | 0 pandas/core/generic.py | 6 +++--- 2 files changed, 3 insertions(+), 3 deletions(-) create mode 100644 file.xlsx diff --git a/file.xlsx b/file.xlsx new file mode 100644 index 0000000000000..e69de29bb2d1d diff --git a/pandas/core/generic.py b/pandas/core/generic.py index 4933c8388455b..9c89eaa133bb3 100644 --- a/pandas/core/generic.py +++ b/pandas/core/generic.py @@ -3452,9 +3452,9 @@ def to_csv( ... compression=compression_opts) # doctest: +SKIP To write a csv file to a new folder or nested folder you will first - need to create it using either `Pathlib - ` - or `os `: + need to create it using either Pathlib_ or os_. + .. _Pathlib: https://docs.python.org/3/library/pathlib.html#pathlib.Path.mkdir + .. _os: https://docs.python.org/2/library/os.html#os.makedirs> >>> from pathlib import Path >>> filepath = Path('folder/subfolder/out.csv') From 3fa4fb75ddd1c3eabd176039b56300213904d790 Mon Sep 17 00:00:00 2001 From: Joeperdefloep Date: Wed, 8 Sep 2021 10:47:47 +0200 Subject: [PATCH 5/6] DOC: GH42250 removed links to external docs --- pandas/core/generic.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/pandas/core/generic.py b/pandas/core/generic.py index 9c89eaa133bb3..b697739b6166e 100644 --- a/pandas/core/generic.py +++ b/pandas/core/generic.py @@ -3452,9 +3452,7 @@ def to_csv( ... compression=compression_opts) # doctest: +SKIP To write a csv file to a new folder or nested folder you will first - need to create it using either Pathlib_ or os_. - .. _Pathlib: https://docs.python.org/3/library/pathlib.html#pathlib.Path.mkdir - .. _os: https://docs.python.org/2/library/os.html#os.makedirs> + need to create it using either Pathlib or os: >>> from pathlib import Path >>> filepath = Path('folder/subfolder/out.csv') From 5619b0893a12c302799ecfb3bb2e7d7469ee27c1 Mon Sep 17 00:00:00 2001 From: Joeperdefloep Date: Thu, 16 Sep 2021 22:35:03 +0200 Subject: [PATCH 6/6] DOC: GH42250 rm file.xlsx --- file.xlsx | 0 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 file.xlsx diff --git a/file.xlsx b/file.xlsx deleted file mode 100644 index e69de29bb2d1d..0000000000000