Commit77163a1

committed

Deploy preview for PR 1123 🛫

1 parentebe0a44 commit77163a1Copy full SHA for 77163a1

File tree

556 files changed

+645

-584

lines changed

pr-preview/pr-1123

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

556 files changed

+645

-584

lines changed

`‎pr-preview/pr-1123/_sources/c-api/memory.rst.txt`

Lines changed: 4 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -656,6 +656,10 @@ This allocator is disabled if Python is configured with the`
`656`	`656`	:option:`--without-pymalloc` option. It can also be disabled at runtime using
`657`	`657`	the :envvar:`PYTHONMALLOC` environment variable (ex: ``PYTHONMALLOC=malloc``).
`658`	`658`
	`659`	`+Typically, it makes sense to disable the pymalloc allocator when building`
	`660`	+Python with AddressSanitizer (:option:`--with-address-sanitizer`) which helps
	`661`	`+uncover low level bugs within the C code.`
	`662`	`+`
`659`	`663`	`Customize pymalloc Arena Allocator`
`660`	`664`	`----------------------------------`
`661`	`665`

`‎pr-preview/pr-1123/_sources/library/tarfile.rst.txt`

Lines changed: 28 additions & 12 deletions

Original file line number	Diff line number	Diff line change
`@@ -1304,6 +1304,9 @@ Command-line options`
`1304`	`1304`	`Examples`
`1305`	`1305`	`--------`
`1306`	`1306`
	`1307`	`+Reading examples`
	`1308`	`+~~~~~~~~~~~~~~~~~~~`
	`1309`	`+`
`1307`	`1310`	`How to extract an entire tar archive to the current working directory::`
`1308`	`1311`
`1309`	`1312`	`import tarfile`
`@@ -1326,6 +1329,23 @@ a generator function instead of a list::`
`1326`	`1329`	`tar.extractall(members=py_files(tar))`
`1327`	`1330`	`tar.close()`
`1328`	`1331`
	`1332`	`+How to read a gzip compressed tar archive and display some member information::`
	`1333`	`+`
	`1334`	`+ import tarfile`
	`1335`	`+ tar = tarfile.open("sample.tar.gz", "r:gz")`
	`1336`	`+ for tarinfo in tar:`
	`1337`	`+ print(tarinfo.name, "is", tarinfo.size, "bytes in size and is ", end="")`
	`1338`	`+ if tarinfo.isreg():`
	`1339`	`+ print("a regular file.")`
	`1340`	`+ elif tarinfo.isdir():`
	`1341`	`+ print("a directory.")`
	`1342`	`+ else:`
	`1343`	`+ print("something else.")`
	`1344`	`+ tar.close()`
	`1345`	`+`
	`1346`	`+Writing examples`
	`1347`	`+~~~~~~~~~~~~~~~~`
	`1348`	`+`
`1329`	`1349`	`How to create an uncompressed tar archive from a list of filenames::`
`1330`	`1350`
`1331`	`1351`	`import tarfile`
@@ -1341,19 +1361,15 @@ The same example using the :keyword:`with` statement::
`1341`	`1361`	`for name in ["foo", "bar", "quux"]:`
`1342`	`1362`	`tar.add(name)`
`1343`	`1363`
`1344`		`-How to read a gzip compressed tar archive and display some member information::`
	`1364`	`+How to create and write an archive to stdout using`
	`1365`	+:data:`sys.stdout.buffer <sys.stdout>` in the fileobj parameter
	`1366`	+in:meth:`TarFile.add`::
`1345`	`1367`
`1346`		`- import tarfile`
`1347`		`- tar = tarfile.open("sample.tar.gz", "r:gz")`
`1348`		`- for tarinfo in tar:`
`1349`		`- print(tarinfo.name, "is", tarinfo.size, "bytes in size and is ", end="")`
`1350`		`- if tarinfo.isreg():`
`1351`		`- print("a regular file.")`
`1352`		`- elif tarinfo.isdir():`
`1353`		`- print("a directory.")`
`1354`		`- else:`
`1355`		`- print("something else.")`
`1356`		`- tar.close()`
	`1368`	`+ import sys`
	`1369`	`+ import tarfile`
	`1370`	`+ with tarfile.open("sample.tar.gz", "w\|gz", fileobj=sys.stdout.buffer) as tar:`
	`1371`	`+ for name in ["foo", "bar", "quux"]:`
	`1372`	`+ tar.add(name)`
`1357`	`1373`
`1358`	`1374`	`How to create an archive and reset the user information using the filter`
`1359`	`1375`	parameter in:meth:`TarFile.add`::