Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / devtools / amd64 / html / python / lib / tar-examples.html
CommitLineData
920dae64
AT
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html>
3<head>
4<link rel="STYLESHEET" href="lib.css" type='text/css' />
5<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
6<link rel='start' href='../index.html' title='Python Documentation Index' />
7<link rel="first" href="lib.html" title='Python Library Reference' />
8<link rel='contents' href='contents.html' title="Contents" />
9<link rel='index' href='genindex.html' title='Index' />
10<link rel='last' href='about.html' title='About this document...' />
11<link rel='help' href='about.html' title='About this document...' />
12<link rel="prev" href="tarinfo-objects.html" />
13<link rel="parent" href="module-tarfile.html" />
14<link rel="next" href="module-readline.html" />
15<meta name='aesop' content='information' />
16<title>7.19.3 Examples </title>
17</head>
18<body>
19<DIV CLASS="navigation">
20<div id='top-navigation-panel' xml:id='top-navigation-panel'>
21<table align="center" width="100%" cellpadding="0" cellspacing="2">
22<tr>
23<td class='online-navigation'><a rel="prev" title="7.19.2 TarInfo Objects"
24 href="tarinfo-objects.html"><img src='../icons/previous.png'
25 border='0' height='32' alt='Previous Page' width='32' /></A></td>
26<td class='online-navigation'><a rel="parent" title="7.19 tarfile "
27 href="module-tarfile.html"><img src='../icons/up.png'
28 border='0' height='32' alt='Up One Level' width='32' /></A></td>
29<td class='online-navigation'><a rel="next" title="7.20 readline "
30 href="module-readline.html"><img src='../icons/next.png'
31 border='0' height='32' alt='Next Page' width='32' /></A></td>
32<td align="center" width="100%">Python Library Reference</td>
33<td class='online-navigation'><a rel="contents" title="Table of Contents"
34 href="contents.html"><img src='../icons/contents.png'
35 border='0' height='32' alt='Contents' width='32' /></A></td>
36<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
37 border='0' height='32' alt='Module Index' width='32' /></a></td>
38<td class='online-navigation'><a rel="index" title="Index"
39 href="genindex.html"><img src='../icons/index.png'
40 border='0' height='32' alt='Index' width='32' /></A></td>
41</tr></table>
42<div class='online-navigation'>
43<b class="navlabel">Previous:</b>
44<a class="sectref" rel="prev" href="tarinfo-objects.html">7.19.2 TarInfo Objects</A>
45<b class="navlabel">Up:</b>
46<a class="sectref" rel="parent" href="module-tarfile.html">7.19 tarfile </A>
47<b class="navlabel">Next:</b>
48<a class="sectref" rel="next" href="module-readline.html">7.20 readline </A>
49</div>
50<hr /></div>
51</DIV>
52<!--End of Navigation Panel-->
53
54<H2><A NAME="SECTION0091930000000000000000"></A><A NAME="tar-examples"></A>
55<BR>
567.19.3 Examples
57</H2>
58
59<P>
60How to create an uncompressed tar archive from a list of filenames:
61<div class="verbatim"><pre>
62import tarfile
63tar = tarfile.open("sample.tar", "w")
64for name in ["foo", "bar", "quux"]:
65 tar.add(name)
66tar.close()
67</pre></div>
68
69<P>
70How to read a gzip compressed tar archive and display some member information:
71<div class="verbatim"><pre>
72import tarfile
73tar = tarfile.open("sample.tar.gz", "r:gz")
74for tarinfo in tar:
75 print tarinfo.name, "is", tarinfo.size, "bytes in size and is",
76 if tarinfo.isreg():
77 print "a regular file."
78 elif tarinfo.isdir():
79 print "a directory."
80 else:
81 print "something else."
82tar.close()
83</pre></div>
84
85<P>
86How to create a tar archive with faked information:
87<div class="verbatim"><pre>
88import tarfile
89tar = tarfile.open("sample.tar.gz", "w:gz")
90for name in namelist:
91 tarinfo = tar.gettarinfo(name, "fakeproj-1.0/" + name)
92 tarinfo.uid = 123
93 tarinfo.gid = 456
94 tarinfo.uname = "johndoe"
95 tarinfo.gname = "fake"
96 tar.addfile(tarinfo, file(name))
97tar.close()
98</pre></div>
99
100<P>
101The <em>only</em> way to extract an uncompressed tar stream from
102<code>sys.stdin</code>:
103<div class="verbatim"><pre>
104import sys
105import tarfile
106tar = tarfile.open(mode="r|", fileobj=sys.stdin)
107for tarinfo in tar:
108 tar.extract(tarinfo)
109tar.close()
110</pre></div>
111
112<DIV CLASS="navigation">
113<div class='online-navigation'>
114<p></p><hr />
115<table align="center" width="100%" cellpadding="0" cellspacing="2">
116<tr>
117<td class='online-navigation'><a rel="prev" title="7.19.2 TarInfo Objects"
118 href="tarinfo-objects.html"><img src='../icons/previous.png'
119 border='0' height='32' alt='Previous Page' width='32' /></A></td>
120<td class='online-navigation'><a rel="parent" title="7.19 tarfile "
121 href="module-tarfile.html"><img src='../icons/up.png'
122 border='0' height='32' alt='Up One Level' width='32' /></A></td>
123<td class='online-navigation'><a rel="next" title="7.20 readline "
124 href="module-readline.html"><img src='../icons/next.png'
125 border='0' height='32' alt='Next Page' width='32' /></A></td>
126<td align="center" width="100%">Python Library Reference</td>
127<td class='online-navigation'><a rel="contents" title="Table of Contents"
128 href="contents.html"><img src='../icons/contents.png'
129 border='0' height='32' alt='Contents' width='32' /></A></td>
130<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
131 border='0' height='32' alt='Module Index' width='32' /></a></td>
132<td class='online-navigation'><a rel="index" title="Index"
133 href="genindex.html"><img src='../icons/index.png'
134 border='0' height='32' alt='Index' width='32' /></A></td>
135</tr></table>
136<div class='online-navigation'>
137<b class="navlabel">Previous:</b>
138<a class="sectref" rel="prev" href="tarinfo-objects.html">7.19.2 TarInfo Objects</A>
139<b class="navlabel">Up:</b>
140<a class="sectref" rel="parent" href="module-tarfile.html">7.19 tarfile </A>
141<b class="navlabel">Next:</b>
142<a class="sectref" rel="next" href="module-readline.html">7.20 readline </A>
143</div>
144</div>
145<hr />
146<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
147</DIV>
148<!--End of Navigation Panel-->
149<ADDRESS>
150See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
151</ADDRESS>
152</BODY>
153</HTML>