python · AA-Turner · Jul 20, 2025 · Jul 14, 2024 · Jul 14, 2024 · Jul 14, 2024
@@ -1346,6 +1346,16 @@ parameter in :meth:`TarFile.add`::
     tar.add("foo", filter=reset)
     tar.close()
 
+How to create and write the archive to stdout using
+:data:`sys.stdout.buffer <sys.stdout>` in the *fileobj* parameter
+in :meth:`TarFile.add`::
+
+    import tarfile
+    import sys
+    files = ["foo.txt", "bar.txt", "quux.txt"]
+    with tarfile.open("sample.tar.gz", "w|gz", fileobj=sys.stdout.buffer) as tar:
+        for file in files:
+            tar.add(file)
 
 .. _tar-formats:
 

diff --git a/Misc/NEWS.d/next/Documentation/2024-07-14-16-12-31.gh-issue-86608.di8ggz.rst b/Misc/NEWS.d/next/Documentation/2024-07-14-16-12-31.gh-issue-86608.di8ggz.rst
@@ -0,0 +1 @@
+Add an example on how to write a tarfile to stdout.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Add an example on how to write a tarfile to stdout.